feat(prompts): add prompts module — CRUDL REST API + GraphQL content retrieval

[ai-pilo]

Summary

This PR adds a full prompts module to @arizeai/ax-client, following the same conventions established by datasets, experiments, and annotation_configs.

What's added

REST CRUD (v2 Prompts API):

• listPrompts — paginated list of prompts, filterable by space
• createPrompt — create a prompt with initial version (messages, provider, LLM params)
• getPrompt — fetch prompt metadata by ID
• updatePrompt — patch description and tags
• deletePrompt — remove a prompt by ID

GraphQL content retrieval (alpha):

• getPromptContent — full prompt content including messages, LLM parameters, and version history via GraphQL
• listPromptsWithContent — paginated list with full content via GraphQL

Internal:

• src/graphql/ — minimal GraphQL transport layer (graphqlFetch) for authenticated POST requests

Why two transports?

The REST v2 GET /v2/prompts/{id} endpoint returns metadata only (name, tags, timestamps). Full content — messages, LLM parameters, version history — is currently only available via GraphQL. The GraphQL functions are marked alpha and will be consolidated once the REST API is extended.

Design decisions

Decision	Rationale
Record<string, unknown> for message/param fields in PromptWithContent	LLM message structure varies significantly by provider; the OpenAPI schema is permissive; typed on input via LLMMessage/InvocationParams where we control the shape
GraphQL Relay node IDs (not REST IDs)	GraphQL requires base64-encoded Relay Global IDs; documented clearly in README and JSDoc
warnPreRelease() on all prompts functions	Entire module is new; marks all functions as subject to change until API stabilizes
No HTTP-level integration tests for REST CRUD	Consistent with existing modules (datasets, experiments) which unit-test transforms only

Module structure

Follows the established pattern:

src/prompts/
  index.ts
  listPrompts.ts / createPrompt.ts / getPrompt.ts / updatePrompt.ts / deletePrompt.ts
  getPromptContent.ts / listPromptsWithContent.ts
  transformGraphQL.ts
  utils.ts
  __tests__/
    fixtures.ts
    utils.test.ts
    getPromptContent.test.ts
    listPromptsWithContent.test.ts
    transformGraphQL.test.ts

src/graphql/
  client.ts
  index.ts
  queries/prompts.ts

Tests

• 60 tests total, all passing
• GraphQL layer: 100% statement/branch/function coverage
• New client.ts tests: 48% → 96% coverage
• Added branch coverage for datasets/utils.ts and experiments/utils.ts

Checklist

• Follows existing module conventions
• All public functions documented with JSDoc
• Types exported from src/types/index.ts
• pnpm test passes (60/60)
• pnpm run type:check passes
• CHANGELOG updated
• README updated with examples
• Version bumped 1.2.0 → 1.3.0

🤖 Generated with Claude Code

[fjcasti1]

Hey @ai-pilo , thanks for the PR. We actually support it now. Thank you!