@to11ai/sdk 2.1.0-rc.4 → 3.0.0-rc.5

package/README.md

@@ -36,7 +36,7 @@ const to11 = createClient({
   env: process.env.TO11_ENV,               // "prod", "staging", … → TO11_ENV
 });
 
-// Render a released prompt for the client's project + environment.
+// Render the prompt's `latest` version for the client's project.
 const prompt = await to11.prompts.render("welcome-message", {
   variables: { name: "Ada" },
   format: "openai", // omit for the provider-neutral result
@@ -62,7 +62,7 @@ const completion = await openai.chat.completions.create(
 | `gatewayUrl` | option → `TO11_GATEWAY_URL` | `https://gw.to11.ai` |
 | `apiKey` | option → `TO11_API_KEY` | — (throws if constructed in a browser) |
 | `projectId` | option → `TO11_PROJECT_ID` | — |
-| `env` | option → `TO11_ENV` | — (must match `^[a-z0-9-]{1,63}$`) |
+| `env` | option → `TO11_ENV` | — (gateway routing via `x-to11-env`; must match `^[a-z0-9-]{1,63}$`) |
 | `providerApiKey` | option | — (BYOK; carried by `openaiOptions()`/`anthropicOptions()`) |
 | `format` | option | — (`"openai"` \| `"anthropic"`; omit for the neutral result) |
 | `onUnknownRole` | option | `"drop"` |
@@ -74,23 +74,23 @@ The client exposes read-only accessors for the resolved values — **`to11.baseU
 
 ## Rendering prompts
 
-`prompts.render(slug, options?)` resolves the released prompt for the client's `projectId` + `env` in one request. Set `format` (on the client or per call) to get a result shaped for that provider; omit it for the provider-neutral result.
+`prompts.render(slug, options?)` resolves the prompt's `latest` version for the client's `projectId` in one request. Set `format` (on the client or per call) to get a result shaped for that provider; omit it for the provider-neutral result.
 
 ```typescript
 const prompt = await to11.prompts.render("weather-concierge", {
   variables: { city: "New York", units: "fahrenheit" },
-  // label?: label to resolve for this call (defaults to the client's env)
+  // label?: label to resolve for this call (defaults to "latest", the one label a prompt carries)
   // fallback?: a previously-rendered RenderedPrompt served on a network error
   // format?: "openai" | "anthropic"
 });
 ```
 
-- **With `format`** the result is spread-ready: `{ messages, config, metadata }` (`config` = the version's model params; `metadata` = prompt/version/release provenance).
-- **Without `format`** you get the neutral **`RenderedPrompt`**: `messages`, `tools`, `toolChoice`, `promptId`, `version`, `versionId`, `releaseId`, `contentHash`, `label`, `slug`, `blockRenderRecord`, and `modelConfig`. This is the path for providers the shaper doesn't cover (Vercel AI, LangChain) or for driving one prompt through more than one provider.
+- **With `format`** the result is spread-ready: `{ messages, config, metadata }` (`config` = the version's model params; `metadata` = prompt/version provenance).
+- **Without `format`** you get the neutral **`RenderedPrompt`**: `messages`, `tools`, `toolChoice`, `promptId`, `version`, `versionId`, `contentHash`, `label`, `slug`, `blockRenderRecord`, and `modelConfig`. This is the path for providers the shaper doesn't cover (Vercel AI, LangChain) or for driving one prompt through more than one provider.
 
 Authored `developer` blocks come back as-is; the SDK maps them per provider (OpenAI keeps `developer`; Anthropic folds `system`/`developer` into the top-level `system`). `onUnknownRole` (`"drop"` default, `"warn"`, `"error"`) controls how an unrecognized role is handled during provider conversion.
 
-> Prompts render as **chat blocks**. The pre-2.0 `resolve()` and the `text` render format have been removed — use `render()` with a `label` (the client's `env` is the default; env is just a label value).
+> Prompts render as **chat blocks**. The pre-2.0 `resolve()` and the `text` render format have been removed — use `render()`. A prompt carries one label, `latest`, which follows the newest version; the client's `env` routes gateway calls and never selects a prompt version.
 
 ## Sending through the gateway
 
@@ -117,10 +117,10 @@ const to11 = createClient({ apiKey, projectId: "proj_abc123" });
 await to11.prompts.list();                              // uses the bound projectId
 await to11.prompts.get({ promptId: "prompt_1" });
 await to11.prompts.getVersion({ promptId: "prompt_1", versionNumber: 3 });
-await to11.prompts.moveLabel({ promptId: "prompt_1", label: "production", versionId: "ver_9", reason: "promote" });
+await to11.prompts.listLabels({ promptId: "prompt_1" });   // [{ label: "latest", versionId: "ver_9", … }]
 ```
 
-Full set: `create`, `list`, `get`, `update`, `archive`, `createVersion`, `listVersions`, `getVersion`, `moveLabel`, `listLabels`, and the project-label registry (`listProjectLabels`, `createProjectLabel`, `getProjectLabel`, `updateProjectLabel`, `deleteProjectLabel`, `listProjectLabelUsages`, `listLabelEvents`). `client.projectEnvironments` exposes the project-environments registry.
+Full set: `create`, `list`, `get`, `update`, `archive`, `createVersion`, `listVersions`, `getVersion`, `listLabels`. Creating a version moves `latest`; there is no label to move by hand. `client.projectEnvironments` exposes the project-environments registry.
 
 ## Error handling
 
@@ -145,7 +145,7 @@ try {
 | `To11aiRateLimitError` | 429 (`retryAfterSeconds`) |
 | `To11aiValidationError` | 400 |
 | `To11aiNetworkError` | network failure / timeout |
-| `PromptNotFoundError` · `LabelNotFoundError` · `MissingLabelError` · `NoActiveReleaseError` · `PromptPolicyViolationError` · `PromptLabelNotRegisteredError` | typed prompt-resolution errors |
+| `PromptNotFoundError` · `LabelNotFoundError` · `PromptHasNoVersionsError` · `PromptPolicyViolationError` | typed prompt-resolution errors |
 | `UnknownRoleError` | an unrecognized message role with `onUnknownRole: "error"` |
 
 ## TypeScript types

package/dist/client.cjs

@@ -54,10 +54,8 @@ __export(exports_client, {
   PromptResource: () => import_resource4.PromptResource,
   PromptPolicyViolationError: () => import_errors.PromptPolicyViolationError,
   PromptNotFoundError: () => import_errors.PromptNotFoundError,
-  PromptLabelNotRegisteredError: () => import_errors.PromptLabelNotRegisteredError,
+  PromptHasNoVersionsError: () => import_errors.PromptHasNoVersionsError,
   ProjectEnvironmentResource: () => import_resource3.ProjectEnvironmentResource,
-  NoActiveReleaseError: () => import_errors.NoActiveReleaseError,
-  MissingLabelError: () => import_errors.MissingLabelError,
   LabelNotFoundError: () => import_errors.LabelNotFoundError,
   ENV_SLUG_REGEX: () => import_types2.ENV_SLUG_REGEX,
   Conversation: () => import_context2.Conversation
@@ -126,7 +124,6 @@ function createClient(options = {}) {
   });
   const prompts = new import_resource2.PromptResource(transport, {
     projectId,
-    env,
     format: options.format,
     onUnknownRole: options.onUnknownRole
   });

package/dist/client.d.ts

@@ -4,11 +4,11 @@ import { PromptResource } from "./prompts/resource";
 import { type RenderFormat, type UnknownRoleMode } from "./prompts/types";
 export type { TurnAuthContext } from "./context";
 export { Conversation, Session, Turn } from "./context";
-export type { NoActiveReleaseReason, PromptNotFoundReason, PromptPolicyViolationReason, } from "./errors";
-export { LabelNotFoundError, MissingLabelError, NoActiveReleaseError, PromptLabelNotRegisteredError, PromptNotFoundError, PromptPolicyViolationError, To11aiApiError, To11aiAuthError, To11aiError, To11aiNetworkError, To11aiRateLimitError, To11aiValidationError, UnknownRoleError, } from "./errors";
+export type { PromptHasNoVersionsReason, PromptNotFoundReason, PromptPolicyViolationReason, } from "./errors";
+export { LabelNotFoundError, PromptHasNoVersionsError, PromptNotFoundError, PromptPolicyViolationError, To11aiApiError, To11aiAuthError, To11aiError, To11aiNetworkError, To11aiRateLimitError, To11aiValidationError, UnknownRoleError, } from "./errors";
 export type { ConvertMessagesOptions, GatewayAuthOptions } from "./gateway";
 export { gatewayAuthHeaders, gatewayPromptHeaders } from "./gateway";
-export type { ArchiveProjectEnvironmentInput, ArchiveProjectEnvironmentResult, CreateProjectEnvironmentInput, CreateProjectEnvironmentResult, GetProjectEnvironmentInput, GetProjectEnvironmentResult, ListProjectEnvironmentsInput, ListProjectEnvironmentsResult, LivePointerCounts, ProjectEnvironment, RestoreProjectEnvironmentInput, RestoreProjectEnvironmentResult, UpdateProjectEnvironmentInput, UpdateProjectEnvironmentResult, } from "./projectEnvironments/resource";
+export type { ArchiveProjectEnvironmentInput, ArchiveProjectEnvironmentResult, CreateProjectEnvironmentInput, CreateProjectEnvironmentResult, GetProjectEnvironmentInput, GetProjectEnvironmentResult, ListProjectEnvironmentsInput, ListProjectEnvironmentsResult, ProjectEnvironment, RestoreProjectEnvironmentInput, RestoreProjectEnvironmentResult, UpdateProjectEnvironmentInput, UpdateProjectEnvironmentResult, } from "./projectEnvironments/resource";
 export { ProjectEnvironmentResource } from "./projectEnvironments/resource";
 export type { PromptResourceConfig } from "./prompts/resource";
 export { PromptResource } from "./prompts/resource";
@@ -48,10 +48,12 @@ export interface ClientOptions {
      */
     projectId?: string;
     /**
-     * Default serving environment for `prompts.render(slug)`, inherited by every
-     * render unless overridden per call. Precedence: this option → `TO11_ENV`
-     * env. Validated eagerly against the project-environments slug rule
-     * (`^[a-z0-9-]{1,63}$`).
+     * Gateway environment, sent as `x-to11-env` by `turn().headers()` and the
+     * `openaiOptions()` / `anthropicOptions()` tenant headers so the gateway
+     * routes the call. Precedence: this option → `TO11_ENV` env. Validated
+     * eagerly against the project-environments slug rule (`^[a-z0-9-]{1,63}$`).
+     * Prompts are not environment-scoped: `prompts.render()` serves `latest`
+     * regardless of `env`.
      */
     env?: string;
     /**
@@ -110,8 +112,8 @@ export interface To11aiClient<F extends RenderFormat | undefined = undefined> {
      */
     readonly projectId: string | undefined;
     /**
-     * Resolved default serving environment (option → `TO11_ENV`); `undefined`
-     * when none is configured. `prompts.render()` already defaults to it.
+     * Resolved gateway environment (option → `TO11_ENV`); `undefined` when none
+     * is configured. The gateway helpers already send it as `x-to11-env`.
      */
     readonly env: string | undefined;
     /** A new session (unit of work). Pass an id to group telemetry by your own id. */
@@ -154,7 +156,7 @@ export interface To11aiClient<F extends RenderFormat | undefined = undefined> {
  * Create a to11ai SDK client. Resolution precedence differs per option:
  *  - URLs (`baseUrl` / `gatewayUrl`) — option → env var → built-in default.
  *  - `apiKey` / `projectId` — option → env var (no default).
- *  - `env` / `format` — option only.
+ *  - `env` — option → `TO11_ENV` (gateway routing); `format` — option only.
  * Authenticate with `apiKey` (or `TO11_API_KEY`) — required, and server-side
  * only (server, CLI, backend job); constructing with `apiKey` in a browser throws.
  *

package/dist/client.js

@@ -14,9 +14,7 @@ import { Transport } from "./transport";
 import { Conversation, Session as Session2, Turn } from "./context";
 import {
   LabelNotFoundError,
-  MissingLabelError,
-  NoActiveReleaseError,
-  PromptLabelNotRegisteredError,
+  PromptHasNoVersionsError,
   PromptNotFoundError,
   PromptPolicyViolationError,
   To11aiApiError,
@@ -80,7 +78,6 @@ function createClient(options = {}) {
   });
   const prompts = new PromptResource(transport, {
     projectId,
-    env,
     format: options.format,
     onUnknownRole: options.onUnknownRole
   });
@@ -147,10 +144,8 @@ export {
   PromptResource2 as PromptResource,
   PromptPolicyViolationError,
   PromptNotFoundError,
-  PromptLabelNotRegisteredError,
+  PromptHasNoVersionsError,
   ProjectEnvironmentResource2 as ProjectEnvironmentResource,
-  NoActiveReleaseError,
-  MissingLabelError,
   LabelNotFoundError,
   ENV_SLUG_REGEX2 as ENV_SLUG_REGEX,
   Conversation

package/dist/errors.cjs

@@ -51,10 +51,8 @@ __export(exports_errors, {
   RuleNotFoundError: () => RuleNotFoundError,
   PromptPolicyViolationError: () => PromptPolicyViolationError,
   PromptNotFoundError: () => PromptNotFoundError,
-  PromptLabelNotRegisteredError: () => PromptLabelNotRegisteredError,
+  PromptHasNoVersionsError: () => PromptHasNoVersionsError,
   NoApplicableRouteError: () => NoApplicableRouteError,
-  NoActiveReleaseError: () => NoActiveReleaseError,
-  MissingLabelError: () => MissingLabelError,
   LabelNotFoundError: () => LabelNotFoundError,
   EnvNotEnabledForProviderError: () => EnvNotEnabledForProviderError
 });
@@ -147,21 +145,6 @@ class UnknownRoleError extends To11aiError {
   }
 }
 
-class PromptLabelNotRegisteredError extends To11aiApiError {
-  projectId;
-  label;
-  constructor(message, projectId, label, details) {
-    super(message, 422, "PROMPT_LABEL_NOT_REGISTERED", details !== undefined ? details : { projectId, label });
-    this.name = "PromptLabelNotRegisteredError";
-    this.projectId = projectId;
-    this.label = label;
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-  static is(err) {
-    return err instanceof PromptLabelNotRegisteredError;
-  }
-}
-
 class RuleNotFoundError extends To11aiApiError {
   ruleId;
   model;
@@ -228,8 +211,8 @@ class PromptNotFoundError extends To11aiApiError {
 
 class LabelNotFoundError extends To11aiApiError {
   label;
-  constructor(message, label, details, statusCode) {
-    super(message, statusCode, "ENV_NOT_FOUND", details);
+  constructor(message, label, details, statusCode = 404) {
+    super(message, statusCode, "LABEL_NOT_FOUND", details);
     this.name = "LabelNotFoundError";
     this.label = label;
     Object.setPrototypeOf(this, new.target.prototype);
@@ -239,27 +222,16 @@ class LabelNotFoundError extends To11aiApiError {
   }
 }
 
-class MissingLabelError extends To11aiError {
-  constructor(message = "[to11ai/sdk] No label resolvable for prompts.render(): none supplied per call, and no client env (or TO11_ENV) to fall back to. Pass `label` to render(slug, { label }) or set `env` on createClient.") {
-    super(message);
-    this.name = "MissingLabelError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-  static is(err) {
-    return err instanceof MissingLabelError;
-  }
-}
-
-class NoActiveReleaseError extends To11aiApiError {
+class PromptHasNoVersionsError extends To11aiApiError {
   reason;
   constructor(message, reason, details, statusCode = 409) {
-    super(message, statusCode, "NO_ACTIVE_RELEASE", details);
-    this.name = "NoActiveReleaseError";
+    super(message, statusCode, "PROMPT_HAS_NO_VERSIONS", details);
+    this.name = "PromptHasNoVersionsError";
     this.reason = reason;
     Object.setPrototypeOf(this, new.target.prototype);
   }
   static is(err) {
-    return err instanceof NoActiveReleaseError;
+    return err instanceof PromptHasNoVersionsError;
   }
 }
 

package/dist/errors.d.ts

@@ -68,25 +68,6 @@ export declare class UnknownRoleError extends To11aiError {
     constructor(role: string, index: number);
     static is(err: unknown): err is UnknownRoleError;
 }
-/**
- * Thrown when strict-mode rejects a label move for an unregistered label.
- *
- * The API returns 422 with `error.code === "PROMPT_LABEL_NOT_REGISTERED"`
- * when `project.enforce_label_registry = true` and the caller tries to
- * move a label that has no active entry in the project label registry.
- * The transport surfaces these as this typed subclass; existing
- * `instanceof To11aiApiError` blocks still match.
- *
- * Note: this extends `To11aiApiError` directly (not `To11aiValidationError`,
- * which hardcodes status 400). The API returns 422 for this case.
- */
-export declare class PromptLabelNotRegisteredError extends To11aiApiError {
-    readonly projectId: string;
-    readonly label: string;
-    constructor(message: string, projectId: string, label: string, details?: unknown);
-    /** Type guard helper — checks `instanceof` (not parent + errorCode string). */
-    static is(err: unknown): err is PromptLabelNotRegisteredError;
-}
 /**
  * Thrown when a rule cannot be located. Covers two variants of the same
  * named class (single class so existing `catch (err: RuleNotFoundError)`
@@ -147,22 +128,15 @@ export declare class EnvNotEnabledForProviderError extends To11aiApiError {
  * Reason payload for `PromptNotFoundError`.
  *
  * Surfaced when the server cannot resolve the prompt for the given slug
- * (`PROMPT_NOT_FOUND`) or cannot find a version matching the supplied
- * labels (`PROMPT_LABELS_NOT_FOUND`). `slug` / `projectId` are echoed from
- * the request context when the server provides them in `details`.
+ * (`PROMPT_NOT_FOUND`). `slug` / `projectId` are echoed from the request
+ * context when the server provides them in `details`.
  */
 export interface PromptNotFoundReason {
     slug?: string;
     projectId?: string;
 }
 /**
- * Thrown when a prompt cannot be resolved. Covers two server codes (single
- * class so one `catch` matches both):
- *
- *   * `PROMPT_NOT_FOUND` — no prompt exists for the requested slug.
- *   * `PROMPT_LABELS_NOT_FOUND` — the prompt exists but no version matches
- *     all the supplied labels (the `env`→label resolution found nothing).
- *
+ * Thrown when no prompt exists for the requested slug (`PROMPT_NOT_FOUND`).
  * Surfaces at HTTP 404 (the canonical code lives in `details.code`).
  */
 export declare class PromptNotFoundError extends To11aiApiError {
@@ -171,50 +145,35 @@ export declare class PromptNotFoundError extends To11aiApiError {
     static is(err: unknown): err is PromptNotFoundError;
 }
 /**
- * Thrown when the label supplied to `prompts.render()` does not resolve to an
- * existing (active) label on the server. Surfaced from the server's
- * `ENV_NOT_FOUND` code; `label` carries the rejected slug when the server
- * echoes it.
- *
- * This is distinct from `MissingLabelError`, which is raised client-side when
- * no label was supplied at all.
+ * Thrown when the label supplied to `prompts.render()` is not one the prompt
+ * carries. A prompt has exactly one label, `latest`, so any other value is
+ * rejected server-side with `LABEL_NOT_FOUND` (HTTP 404); `label` carries the
+ * rejected value when the server echoes it.
  */
 export declare class LabelNotFoundError extends To11aiApiError {
-    /** The label slug that could not be found, when the server echoes it. */
+    /** The label that could not be found, when the server echoes it. */
     readonly label?: string;
-    constructor(message: string, label: string | undefined, details: unknown, statusCode: number);
+    constructor(message: string, label: string | undefined, details?: unknown, statusCode?: number);
     static is(err: unknown): err is LabelNotFoundError;
 }
 /**
- * Thrown CLIENT-side, eagerly (before any request), when `prompts.render()` is
- * called but no label is resolvable at all: none supplied per call, and no
- * client `env` (or `TO11_ENV`) to fall back to. A usage error, not a lookup
- * failure — distinct from `LabelNotFoundError`.
- */
-export declare class MissingLabelError extends To11aiError {
-    constructor(message?: string);
-    static is(err: unknown): err is MissingLabelError;
-}
-/**
- * Reason payload for `NoActiveReleaseError`.
+ * Reason payload for `PromptHasNoVersionsError`.
  *
- * Identifies the prompt (by `slug` and/or `promptId`) and the `env` for
- * which no active release row exists.
+ * Identifies the prompt (by `slug` and/or `promptId`) that has no version yet.
  */
-export interface NoActiveReleaseReason {
+export interface PromptHasNoVersionsReason {
     slug?: string;
     promptId?: string;
-    env?: string;
 }
 /**
- * Thrown when a prompt resolves but has no active release for the requested
- * env (`NO_ACTIVE_RELEASE`). The release primitive (S3) found the prompt but
- * nothing is currently serving in that environment.
+ * Thrown when the prompt exists but has no version to serve
+ * (`PROMPT_HAS_NO_VERSIONS`, HTTP 409): `latest` has nothing to point at until
+ * the first version is created.
  */
-export declare class NoActiveReleaseError extends To11aiApiError {
-    readonly reason: NoActiveReleaseReason;
-    constructor(message: string, reason: NoActiveReleaseReason, details?: unknown, statusCode?: number);
-    static is(err: unknown): err is NoActiveReleaseError;
+export declare class PromptHasNoVersionsError extends To11aiApiError {
+    readonly reason: PromptHasNoVersionsReason;
+    constructor(message: string, reason: PromptHasNoVersionsReason, details?: unknown, statusCode?: number);
+    static is(err: unknown): err is PromptHasNoVersionsError;
 }
 /**
  * Reason payload for `PromptPolicyViolationError`.

package/dist/errors.js

@@ -86,21 +86,6 @@ class UnknownRoleError extends To11aiError {
   }
 }
 
-class PromptLabelNotRegisteredError extends To11aiApiError {
-  projectId;
-  label;
-  constructor(message, projectId, label, details) {
-    super(message, 422, "PROMPT_LABEL_NOT_REGISTERED", details !== undefined ? details : { projectId, label });
-    this.name = "PromptLabelNotRegisteredError";
-    this.projectId = projectId;
-    this.label = label;
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-  static is(err) {
-    return err instanceof PromptLabelNotRegisteredError;
-  }
-}
-
 class RuleNotFoundError extends To11aiApiError {
   ruleId;
   model;
@@ -167,8 +152,8 @@ class PromptNotFoundError extends To11aiApiError {
 
 class LabelNotFoundError extends To11aiApiError {
   label;
-  constructor(message, label, details, statusCode) {
-    super(message, statusCode, "ENV_NOT_FOUND", details);
+  constructor(message, label, details, statusCode = 404) {
+    super(message, statusCode, "LABEL_NOT_FOUND", details);
     this.name = "LabelNotFoundError";
     this.label = label;
     Object.setPrototypeOf(this, new.target.prototype);
@@ -178,27 +163,16 @@ class LabelNotFoundError extends To11aiApiError {
   }
 }
 
-class MissingLabelError extends To11aiError {
-  constructor(message = "[to11ai/sdk] No label resolvable for prompts.render(): none supplied per call, and no client env (or TO11_ENV) to fall back to. Pass `label` to render(slug, { label }) or set `env` on createClient.") {
-    super(message);
-    this.name = "MissingLabelError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-  static is(err) {
-    return err instanceof MissingLabelError;
-  }
-}
-
-class NoActiveReleaseError extends To11aiApiError {
+class PromptHasNoVersionsError extends To11aiApiError {
   reason;
   constructor(message, reason, details, statusCode = 409) {
-    super(message, statusCode, "NO_ACTIVE_RELEASE", details);
-    this.name = "NoActiveReleaseError";
+    super(message, statusCode, "PROMPT_HAS_NO_VERSIONS", details);
+    this.name = "PromptHasNoVersionsError";
     this.reason = reason;
     Object.setPrototypeOf(this, new.target.prototype);
   }
   static is(err) {
-    return err instanceof NoActiveReleaseError;
+    return err instanceof PromptHasNoVersionsError;
   }
 }
 
@@ -244,10 +218,8 @@ export {
   RuleNotFoundError,
   PromptPolicyViolationError,
   PromptNotFoundError,
-  PromptLabelNotRegisteredError,
+  PromptHasNoVersionsError,
   NoApplicableRouteError,
-  NoActiveReleaseError,
-  MissingLabelError,
   LabelNotFoundError,
   EnvNotEnabledForProviderError
 };

package/dist/gateway.cjs

@@ -85,9 +85,6 @@ function gatewayPromptHeaders(prompt) {
   if (typeof p.version === "number" && Number.isFinite(p.version)) {
     headers["x-to11-prompt-version"] = String(p.version);
   }
-  if (typeof p.releaseId === "string" && p.releaseId.length > 0) {
-    headers["x-to11-release-id"] = p.releaseId;
-  }
   if (typeof p.label === "string" && p.label.length > 0) {
     headers["x-to11-prompt-label"] = p.label;
   }

package/dist/gateway.d.ts

@@ -39,8 +39,6 @@ export declare function gatewayAuthHeaders(options: GatewayAuthOptions): Record<
  *   - `x-to11-prompt-id` — a non-empty string.
  *   - `x-to11-prompt-version` — a finite number (a non-number/NaN is dropped
  *     rather than stringified to junk like `"[object Object]"`).
- *   - `x-to11-release-id` — a non-empty `releaseId` (the offline-fallback path
- *     can carry an explicit `null`, which is omitted).
  *   - `x-to11-prompt-label` — the single label the prompt resolved through.
  *   - `x-to11-prompt-slug` — the prompt's human-readable slug.
  *
@@ -48,21 +46,19 @@ export declare function gatewayAuthHeaders(options: GatewayAuthOptions): Record<
  * a prompt-less `turn.headers()` call.
  *
  * @example
- * const result = await client.prompts.render(slug, { label: "prod" });
+ * const result = await client.prompts.render(slug);
  * const headers = gatewayPromptHeaders(result);
  */
 export interface GatewayPromptProvenance {
     promptId: string;
     version: number;
-    /** The single label the prompt resolved through (env slug today). */
+    /** The label the prompt resolved through (`latest` unless pinned). */
     label: string;
     /**
      * The prompt's human-readable slug (the `render()`/`resolve()` input). Present
      * on an enriched `render()` result; a legacy `ResolvedPrompt` omits it.
      */
     slug?: string;
-    /** Present on an enriched result; a legacy `resolve()` result omits it. */
-    releaseId?: string | null;
 }
 export declare function gatewayPromptHeaders(prompt: GatewayPromptProvenance | {
     metadata: GatewayPromptProvenance;

package/dist/gateway.js

@@ -36,9 +36,6 @@ function gatewayPromptHeaders(prompt) {
   if (typeof p.version === "number" && Number.isFinite(p.version)) {
     headers["x-to11-prompt-version"] = String(p.version);
   }
-  if (typeof p.releaseId === "string" && p.releaseId.length > 0) {
-    headers["x-to11-release-id"] = p.releaseId;
-  }
   if (typeof p.label === "string" && p.label.length > 0) {
     headers["x-to11-prompt-label"] = p.label;
   }