@to11ai/sdk 0.7.0 → 1.0.0

package/dist/client.d.ts

@@ -12,7 +12,7 @@ export { ProjectEnvironmentResource } from "./projectEnvironments/resource";
 export type { CacheConfig } from "./prompts/cache";
 export type { PromptResourceConfig } from "./prompts/resource";
 export { PromptResource } from "./prompts/resource";
-export type { BlockRenderRecord, DeveloperRole, FetchedPrompt, FetchPromptOptions, PromptContext, RenderedChatMessage, RenderedPrompt, ResolvedPrompt, ResolvedPromptEnvelope, } from "./prompts/types";
+export type { BlockRenderRecord, DeveloperRole, FetchedPrompt, FetchPromptOptions, RenderedChatMessage, RenderedPrompt, ResolvedPrompt, ResolvedPromptEnvelope, } from "./prompts/types";
 export { ENV_SLUG_REGEX } from "./prompts/types";
 export type { CreateRuleVersionInput, CreateRuleVersionResult, GetRuleVersionInput, GetRuleVersionResult, ListRuleReleasesInput, ListRuleReleasesResult, ListRuleVersionsInput, ListRuleVersionsResult, RollbackRuleReleaseInput, RollbackRuleReleaseResult, RuleModelBinding, RuleProviderRef, RuleRelease, RuleReleaseActorType, RuleReleaseApprovalStatus, RuleReleaseChangeKind, RuleReleaseStrategy, RuleReleaseWeight, RuleSnapshot, RuleStrategy, RuleVersion, SetRuleReleaseInput, SetRuleReleaseResult, } from "./routingRules/resource";
 export { RoutingRuleReleaseResource, RoutingRulesResource, RoutingRuleVersionResource, } from "./routingRules/resource";

package/dist/gateway.cjs

@@ -40,8 +40,10 @@ var __export = (target, all) => {
 var exports_gateway = {};
 __export(exports_gateway, {
   toOpenAITools: () => toOpenAITools,
+  toOpenAIToolChoice: () => toOpenAIToolChoice,
   toOpenAIMessages: () => toOpenAIMessages,
   toAnthropicTools: () => toAnthropicTools,
+  toAnthropicToolChoice: () => toAnthropicToolChoice,
   toAnthropicMessages: () => toAnthropicMessages,
   gatewayPromptHeaders: () => gatewayPromptHeaders,
   gatewayAuthHeaders: () => gatewayAuthHeaders
@@ -102,6 +104,13 @@ function toOpenAITools(tools) {
     return { type: "function", function: fn };
   });
 }
+function toOpenAIToolChoice(toolChoice) {
+  if (toolChoice == null)
+    return;
+  if (typeof toolChoice === "string")
+    return toolChoice;
+  return { type: "function", function: { name: toolChoice.name } };
+}
 function toAnthropicTools(tools) {
   if (tools == null)
     return [];
@@ -116,6 +125,17 @@ function toAnthropicTools(tools) {
     return out;
   });
 }
+function toAnthropicToolChoice(toolChoice) {
+  if (toolChoice == null)
+    return;
+  if (toolChoice === "auto")
+    return { type: "auto" };
+  if (toolChoice === "none")
+    return { type: "none" };
+  if (toolChoice === "required")
+    return { type: "any" };
+  return { type: "tool", name: toolChoice.name };
+}
 function requireToolCallId(id) {
   if (typeof id !== "string" || id.length === 0) {
     throw new Error("to11 SDK: malformed tool history — a tool call/result is missing its id (toolCallId). Author a non-empty id before converting messages.");

package/dist/gateway.d.ts

@@ -62,6 +62,13 @@ export interface OpenAITool {
         parameters: Record<string, unknown>;
     };
 }
+/** OpenAI `tool_choice` value for a Chat Completions request. */
+export type OpenAIToolChoice = "auto" | "none" | "required" | {
+    type: "function";
+    function: {
+        name: string;
+    };
+};
 /** OpenAI Chat Completions assistant `tool_calls[]` entry. */
 export interface OpenAIToolCall {
     id: string;
@@ -103,6 +110,17 @@ export interface AnthropicMessage {
     role: "user" | "assistant";
     content: string | AnthropicContentBlock[];
 }
+/** Anthropic Messages `tool_choice` value. */
+export type AnthropicToolChoice = {
+    type: "auto";
+} | {
+    type: "any";
+} | {
+    type: "none";
+} | {
+    type: "tool";
+    name: string;
+};
 /**
  * Shape resolved tool definitions for the OpenAI Chat Completions `tools`
  * field: `{ type: "function", function: { name, description?, parameters } }`.
@@ -112,9 +130,24 @@ export interface AnthropicMessage {
  *
  * @example
  * const tools = toOpenAITools(prompt.tools);
- * await openai.chat.completions.create({ model, messages, tools });
+ * const tool_choice = toOpenAIToolChoice(prompt.toolChoice);
+ * await openai.chat.completions.create({ model, messages, tools, tool_choice });
  */
 export declare function toOpenAITools(tools: ReadonlyArray<ResolvedToolDefinition> | null | undefined): OpenAITool[];
+/**
+ * Map a resolved prompt's provider-neutral `toolChoice` to the OpenAI
+ * Chat Completions `tool_choice` field.
+ *
+ * - `null` / `undefined` → `undefined` (omit the field)
+ * - `"auto"` → `"auto"`, `"none"` → `"none"`, `"required"` → `"required"`
+ * - `{ name }` → `{ type: "function", function: { name } }`
+ *
+ * @example
+ * const tools = toOpenAITools(prompt.tools);
+ * const tool_choice = toOpenAIToolChoice(prompt.toolChoice);
+ * await openai.chat.completions.create({ model, messages, tools, tool_choice });
+ */
+export declare function toOpenAIToolChoice(toolChoice: ResolvedPrompt["toolChoice"]): OpenAIToolChoice | undefined;
 /**
  * Shape resolved tool definitions for the Anthropic Messages `tools` field:
  * `{ name, description?, input_schema }` (Anthropic names the JSON Schema field
@@ -122,9 +155,26 @@ export declare function toOpenAITools(tools: ReadonlyArray<ResolvedToolDefinitio
  *
  * @example
  * const tools = toAnthropicTools(prompt.tools);
- * await anthropic.messages.create({ model, system, messages, tools });
+ * const tool_choice = toAnthropicToolChoice(prompt.toolChoice);
+ * await anthropic.messages.create({ model, system, messages, tools, tool_choice });
  */
 export declare function toAnthropicTools(tools: ReadonlyArray<ResolvedToolDefinition> | null | undefined): AnthropicTool[];
+/**
+ * Map a resolved prompt's provider-neutral `toolChoice` to the Anthropic
+ * Messages `tool_choice` field.
+ *
+ * - `null` / `undefined` → `undefined` (omit the field)
+ * - `"auto"` → `{ type: "auto" }`
+ * - `"none"` → `{ type: "none" }` (the Anthropic API supports this natively)
+ * - `"required"` → `{ type: "any" }` (Anthropic's name for "must invoke a tool")
+ * - `{ name }` → `{ type: "tool", name }`
+ *
+ * @example
+ * const tools = toAnthropicTools(prompt.tools);
+ * const tool_choice = toAnthropicToolChoice(prompt.toolChoice);
+ * await anthropic.messages.create({ model, system, messages, tools, tool_choice });
+ */
+export declare function toAnthropicToolChoice(toolChoice: ResolvedPrompt["toolChoice"]): AnthropicToolChoice | undefined;
 /**
  * Shape rendered turns for the OpenAI Chat Completions `messages` field.
  *

package/dist/gateway.js

@@ -56,6 +56,13 @@ function toOpenAITools(tools) {
     return { type: "function", function: fn };
   });
 }
+function toOpenAIToolChoice(toolChoice) {
+  if (toolChoice == null)
+    return;
+  if (typeof toolChoice === "string")
+    return toolChoice;
+  return { type: "function", function: { name: toolChoice.name } };
+}
 function toAnthropicTools(tools) {
   if (tools == null)
     return [];
@@ -70,6 +77,17 @@ function toAnthropicTools(tools) {
     return out;
   });
 }
+function toAnthropicToolChoice(toolChoice) {
+  if (toolChoice == null)
+    return;
+  if (toolChoice === "auto")
+    return { type: "auto" };
+  if (toolChoice === "none")
+    return { type: "none" };
+  if (toolChoice === "required")
+    return { type: "any" };
+  return { type: "tool", name: toolChoice.name };
+}
 function requireToolCallId(id) {
   if (typeof id !== "string" || id.length === 0) {
     throw new Error("to11 SDK: malformed tool history — a tool call/result is missing its id (toolCallId). Author a non-empty id before converting messages.");
@@ -150,8 +168,10 @@ function toAnthropicMessages(messages) {
 }
 export {
   toOpenAITools,
+  toOpenAIToolChoice,
   toOpenAIMessages,
   toAnthropicTools,
+  toAnthropicToolChoice,
   toAnthropicMessages,
   gatewayPromptHeaders,
   gatewayAuthHeaders

package/dist/generated/types.gen.d.ts

@@ -279,6 +279,9 @@ export type ResolvedPrompt = {
     releaseId: string;
     rendered: RenderedPrompt;
     subjectHash?: string | null;
+    toolChoice?: 'auto' | 'none' | 'required' | {
+        name: string;
+    } | null;
     tools?: Array<ResolvedToolDefinition> | null;
     variantName?: string | null;
     version: number;
@@ -14740,6 +14743,7 @@ export type PromptsGetPromptVersionDiffResponses = {
                 name: string;
                 op: 'add';
                 role: 'system' | 'user' | 'assistant' | 'developer' | 'tool';
+                toolCallId?: string | null;
                 toolCalls?: Array<{
                     arguments: {
                         [key: string]: unknown;
@@ -14747,15 +14751,6 @@ export type PromptsGetPromptVersionDiffResponses = {
                     id: string;
                     name: string;
                 }> | null;
-                toolSchema?: {
-                    content?: string | null;
-                    description?: string | null;
-                    parameters?: {
-                        [key: string]: unknown;
-                    } | null;
-                    toolCallId?: string | null;
-                    toolKind?: 'definition' | 'result' | null;
-                } | null;
             } | {
                 condition: {
                     kind: string;
@@ -14764,6 +14759,7 @@ export type PromptsGetPromptVersionDiffResponses = {
                 name: string;
                 op: 'remove';
                 role: 'system' | 'user' | 'assistant' | 'developer' | 'tool';
+                toolCallId?: string | null;
                 toolCalls?: Array<{
                     arguments: {
                         [key: string]: unknown;
@@ -14771,15 +14767,6 @@ export type PromptsGetPromptVersionDiffResponses = {
                     id: string;
                     name: string;
                 }> | null;
-                toolSchema?: {
-                    content?: string | null;
-                    description?: string | null;
-                    parameters?: {
-                        [key: string]: unknown;
-                    } | null;
-                    toolCallId?: string | null;
-                    toolKind?: 'definition' | 'result' | null;
-                } | null;
             } | {
                 after: string;
                 before: string;
@@ -14805,26 +14792,10 @@ export type PromptsGetPromptVersionDiffResponses = {
                 name: string;
                 op: 'edit_required';
             } | {
-                after: {
-                    content?: string | null;
-                    description?: string | null;
-                    parameters?: {
-                        [key: string]: unknown;
-                    } | null;
-                    toolCallId?: string | null;
-                    toolKind?: 'definition' | 'result' | null;
-                };
-                before: {
-                    content?: string | null;
-                    description?: string | null;
-                    parameters?: {
-                        [key: string]: unknown;
-                    } | null;
-                    toolCallId?: string | null;
-                    toolKind?: 'definition' | 'result' | null;
-                };
+                after: string;
+                before: string;
                 name: string;
-                op: 'edit_tool_schema';
+                op: 'edit_tool_call_id';
             } | {
                 after: Array<{
                     arguments: {
@@ -15285,9 +15256,6 @@ export type PromptsWithdrawPromptReviewResponses = {
 export type PromptsWithdrawPromptReviewResponse = PromptsWithdrawPromptReviewResponses[keyof PromptsWithdrawPromptReviewResponses];
 export type PromptsResolvePromptData = {
     body: {
-        context?: {
-            [key: string]: string | number | boolean;
-        } | null;
         developerRole?: 'user' | 'developer' | 'system' | null;
         labels: Array<string>;
         slug: string;

package/dist/generated/zod.gen.d.ts

@@ -489,6 +489,13 @@ export declare const zResolvedPrompt: z.ZodObject<{
         }, z.core.$strip>]>>;
     }, z.core.$strip>]>;
     subjectHash: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    toolChoice: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+        auto: "auto";
+        none: "none";
+        required: "required";
+    }>, z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strip>]>>>;
     tools: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         name: z.ZodString;
@@ -8505,21 +8512,12 @@ export declare const zPromptsGetPromptVersionDiffResponse: z.ZodObject<{
                 tool: "tool";
                 assistant: "assistant";
             }>;
+            toolCallId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             toolCalls: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
                 arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
                 id: z.ZodString;
                 name: z.ZodString;
             }, z.core.$strip>>>>;
-            toolSchema: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                parameters: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-                toolCallId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                toolKind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                    definition: "definition";
-                    result: "result";
-                }>>>;
-            }, z.core.$strip>>>;
         }, z.core.$strip>, z.ZodObject<{
             condition: z.ZodObject<{
                 kind: z.ZodString;
@@ -8536,21 +8534,12 @@ export declare const zPromptsGetPromptVersionDiffResponse: z.ZodObject<{
                 tool: "tool";
                 assistant: "assistant";
             }>;
+            toolCallId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             toolCalls: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
                 arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
                 id: z.ZodString;
                 name: z.ZodString;
             }, z.core.$strip>>>>;
-            toolSchema: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                parameters: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-                toolCallId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                toolKind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                    definition: "definition";
-                    result: "result";
-                }>>>;
-            }, z.core.$strip>>>;
         }, z.core.$strip>, z.ZodObject<{
             after: z.ZodString;
             before: z.ZodString;
@@ -8596,29 +8585,11 @@ export declare const zPromptsGetPromptVersionDiffResponse: z.ZodObject<{
                 edit_required: "edit_required";
             }>;
         }, z.core.$strip>, z.ZodObject<{
-            after: z.ZodObject<{
-                content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                parameters: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-                toolCallId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                toolKind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                    definition: "definition";
-                    result: "result";
-                }>>>;
-            }, z.core.$strip>;
-            before: z.ZodObject<{
-                content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                parameters: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-                toolCallId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                toolKind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                    definition: "definition";
-                    result: "result";
-                }>>>;
-            }, z.core.$strip>;
+            after: z.ZodString;
+            before: z.ZodString;
             name: z.ZodString;
             op: z.ZodEnum<{
-                edit_tool_schema: "edit_tool_schema";
+                edit_tool_call_id: "edit_tool_call_id";
             }>;
         }, z.core.$strip>, z.ZodObject<{
             after: z.ZodArray<z.ZodObject<{
@@ -8889,7 +8860,6 @@ export declare const zPromptsWithdrawPromptReviewResponse: z.ZodObject<{
     success: z.ZodBoolean;
 }, z.core.$strip>;
 export declare const zPromptsResolvePromptBody: z.ZodObject<{
-    context: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>>;
     developerRole: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         user: "user";
         system: "system";
@@ -8952,6 +8922,13 @@ export declare const zPromptsResolvePromptResponse: z.ZodObject<{
             }, z.core.$strip>]>>;
         }, z.core.$strip>]>;
         subjectHash: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        toolChoice: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+            auto: "auto";
+            none: "none";
+            required: "required";
+        }>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strip>]>>>;
         tools: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
             description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             name: z.ZodString;

package/dist/prompts/cache.d.ts

@@ -1,4 +1,4 @@
-import type { FetchedPrompt, PromptContext, ResolvedPrompt } from "./types";
+import type { FetchedPrompt, ResolvedPrompt } from "./types";
 export interface CacheConfig {
     /** Time-to-live in seconds. Default: 300 (5 minutes) */
     ttlSeconds?: number;
@@ -26,9 +26,9 @@ export declare function buildCacheKey(projectId: string, slug: string, labels: s
 /**
  * Build a cache key for an env-aware `fetch()` call.
  *
- * Folds in `env`, `context`, and `subject` ON TOP of the base
+ * Folds in `env` and `subject` ON TOP of the base
  * project/slug/labels/variables key so two calls that differ only by
- * env/context/subject do not return a stale cross-env / cross-cohort hit
+ * env/subject do not return a stale cross-env / cross-cohort hit
  * (spec §3 "Caching key changes"). The env slug is also forwarded as the
  * single resolution label (env→label mapping, correction #3), so it appears
  * in the `labels` segment too; including it explicitly here keeps the key
@@ -38,7 +38,7 @@ export declare function buildCacheKey(projectId: string, slug: string, labels: s
  * caches as the same deterministic variant on repeat (D8); the
  * weighted-no-subject bypass is handled in the resource, not here.
  */
-export declare function buildFetchCacheKey(projectId: string, slug: string, env: string, context?: PromptContext, subject?: string, variables?: Record<string, unknown>, developerRole?: string): string;
+export declare function buildFetchCacheKey(projectId: string, slug: string, env: string, subject?: string, variables?: Record<string, unknown>, developerRole?: string): string;
 /**
  * In-memory LRU cache for ResolvedPrompt objects.
  *

package/dist/prompts/resource.cjs

@@ -54,7 +54,8 @@ var zResolvedPromptLegacy = import_zod2.zResolvedPrompt.pick({
   labels: true,
   contentHash: true,
   rendered: true,
-  tools: true
+  tools: true,
+  toolChoice: true
 });
 var zResolvedPromptEnvelope = import_zod2.zResolvedPrompt.partial({ releaseId: true }).extend({ strategy: import_zod.z.enum(["single", "weighted"]).optional() });
 function unwrap(envelope) {
@@ -88,6 +89,9 @@ function normalizeResolvedEnvelope(raw) {
   if (raw.tools != null && raw.tools.length > 0) {
     result.tools = raw.tools;
   }
+  if (raw.toolChoice != null) {
+    result.toolChoice = raw.toolChoice;
+  }
   if (typeof provenance.variantName === "string" && provenance.variantName.length > 0) {
     result.variantName = provenance.variantName;
   }
@@ -215,22 +219,19 @@ class PromptResource {
       throw new Error(`[to11ai/sdk] \`env\` must match ${import_types.ENV_SLUG_REGEX} (lowercase-kebab, 1-63 chars). Received: ${JSON.stringify(env)}`);
     }
     const {
-      context,
       subject,
       variables,
       cache: useCache = true,
       fallback,
       developerRole
     } = options;
-    const cacheKey = import_cache.buildFetchCacheKey(this.projectId, slug, env, context, subject, variables, developerRole);
+    const cacheKey = import_cache.buildFetchCacheKey(this.projectId, slug, env, subject, variables, developerRole);
     if (useCache) {
       const cached = this.cache.get(cacheKey);
       if (cached && "messages" in cached)
         return structuredClone(cached);
     }
     const body = { slug, labels: [env] };
-    if (context !== undefined)
-      body.context = context;
     if (subject !== undefined)
       body.subject = subject;
     if (variables !== undefined)

package/dist/prompts/resource.d.ts

@@ -2,7 +2,7 @@ import type { Transport } from "../transport";
 import type { CacheConfig } from "./cache";
 import type { ArchivePromptInput, ArchivePromptResult, CreateProjectPromptLabelInput, CreateProjectPromptLabelResult, CreatePromptInput, CreatePromptResult, CreatePromptVersionInput, CreatePromptVersionResult, DeleteProjectPromptLabelInput, DeleteProjectPromptLabelResult, FetchedPrompt, FetchPromptOptions, GetProjectPromptLabelInput, GetProjectPromptLabelResult, GetPromptInput, GetPromptResult, GetPromptVersionInput, GetPromptVersionResult, ListLabelEventsInput, ListLabelEventsResult, ListProjectPromptLabelsInput, ListProjectPromptLabelsResult, ListProjectPromptLabelUsagesInput, ListProjectPromptLabelUsagesResult, ListPromptLabelsInput, ListPromptLabelsResult, ListPromptsInput, ListPromptsResult, ListPromptVersionsInput, ListPromptVersionsResult, MovePromptLabelInput, MovePromptLabelResult, PaginatedResult, ResolvePromptInput, ResolvePromptResult, UpdateProjectPromptLabelInput, UpdateProjectPromptLabelResult, UpdatePromptInput, UpdatePromptResult } from "./types";
 export type { CacheConfig } from "./cache";
-export type { ArchivePromptInput, ArchivePromptResult, BlockRenderRecord, ChatMessage, CreateProjectPromptLabelInput, CreateProjectPromptLabelResult, CreatePromptInput, CreatePromptResult, CreatePromptVersionInput, CreatePromptVersionResult, DeleteProjectPromptLabelInput, DeleteProjectPromptLabelResult, FetchedPrompt, FetchPromptOptions, GetProjectPromptLabelInput, GetProjectPromptLabelResult, GetPromptInput, GetPromptResult, GetPromptVersionInput, GetPromptVersionResult, ListLabelEventsInput, ListLabelEventsResult, ListProjectPromptLabelsInput, ListProjectPromptLabelsResult, ListProjectPromptLabelUsagesInput, ListProjectPromptLabelUsagesResult, ListPromptLabelsInput, ListPromptLabelsResult, ListPromptsInput, ListPromptsResult, ListPromptVersionsInput, ListPromptVersionsResult, MovePromptLabelInput, MovePromptLabelResult, PaginatedResult, PaginationInfo, PaletteToken, ProjectPromptLabel, ProjectPromptLabelUsage, Prompt, PromptContext, PromptFormat, PromptLabelEvent, PromptLabelPointer, PromptStatus, PromptVersion, RenderedChatMessage, RenderedPrompt, ResolvedPrompt, ResolvedPromptEnvelope, ResolvedToolCall, ResolvedToolDefinition, ResolvePromptInput, ResolvePromptResult, RowError, TextChatMessage, TextChatRole, ToolChatMessage, UpdateProjectPromptLabelInput, UpdateProjectPromptLabelResult, UpdatePromptInput, UpdatePromptResult, } from "./types";
+export type { ArchivePromptInput, ArchivePromptResult, BlockRenderRecord, ChatMessage, CreateProjectPromptLabelInput, CreateProjectPromptLabelResult, CreatePromptInput, CreatePromptResult, CreatePromptVersionInput, CreatePromptVersionResult, DeleteProjectPromptLabelInput, DeleteProjectPromptLabelResult, FetchedPrompt, FetchPromptOptions, GetProjectPromptLabelInput, GetProjectPromptLabelResult, GetPromptInput, GetPromptResult, GetPromptVersionInput, GetPromptVersionResult, ListLabelEventsInput, ListLabelEventsResult, ListProjectPromptLabelsInput, ListProjectPromptLabelsResult, ListProjectPromptLabelUsagesInput, ListProjectPromptLabelUsagesResult, ListPromptLabelsInput, ListPromptLabelsResult, ListPromptsInput, ListPromptsResult, ListPromptVersionsInput, ListPromptVersionsResult, MovePromptLabelInput, MovePromptLabelResult, PaginatedResult, PaginationInfo, PaletteToken, ProjectPromptLabel, ProjectPromptLabelUsage, Prompt, PromptFormat, PromptLabelEvent, PromptLabelPointer, PromptStatus, PromptVersion, RenderedChatMessage, RenderedPrompt, ResolvedPrompt, ResolvedPromptEnvelope, ResolvedToolCall, ResolvedToolDefinition, ResolvePromptInput, ResolvePromptResult, RowError, TextChatMessage, TextChatRole, UpdateProjectPromptLabelInput, UpdateProjectPromptLabelResult, UpdatePromptInput, UpdatePromptResult, } from "./types";
 /**
  * Init-time config for the env-aware `fetch()` surface (TO11-980 / S9).
  *
@@ -41,8 +41,8 @@ export declare class PromptResource {
      *   label-based (`/v1/projects/:projectId/prompts:resolve`, body
      *   `labels[]`); it does NOT accept a top-level `env` field. The resolved
      *   env slug (lowercase-kebab — a valid label name) is therefore sent as
-     *   the single resolution label: body `{ slug, labels: [env], context?,
-     *   subject?, variables? }`.
+     *   the single resolution label: body `{ slug, labels: [env], subject?,
+     *   variables? }`.
      * - **No silent fallback (R4):** if no env is resolvable (none at init AND
      *   none per call) this throws `EnvNotFoundError` (`reason.source =
      *   "missing"`) CLIENT-side, eagerly, before any transport call.
@@ -55,8 +55,8 @@ export declare class PromptResource {
     fetch(slug: string, options?: FetchPromptOptions): Promise<FetchedPrompt>;
     /**
      * @deprecated Use {@link PromptResource.fetch | `prompts.fetch(slug,
-     * options?)`} instead. `resolve()` is env-agnostic (no `env` / `context` /
-     * `subject`, no enriched release/variant provenance, no typed-env errors)
+     * options?)`} instead. `resolve()` is env-agnostic (no `env` / `subject`,
+     * no enriched release/variant provenance, no typed-env errors)
      * and is retained only for back-compat. It is NOT subject to the R4
      * no-silent-fallback env gate (it has no env concept). New code should
      * configure `projectId` + `env` at `createClient` and call `fetch()`.

package/dist/prompts/resource.js

@@ -11,7 +11,8 @@ var zResolvedPromptLegacy = zResolvedPrompt.pick({
   labels: true,
   contentHash: true,
   rendered: true,
-  tools: true
+  tools: true,
+  toolChoice: true
 });
 var zResolvedPromptEnvelope = zResolvedPrompt.partial({ releaseId: true }).extend({ strategy: z.enum(["single", "weighted"]).optional() });
 function unwrap(envelope) {
@@ -45,6 +46,9 @@ function normalizeResolvedEnvelope(raw) {
   if (raw.tools != null && raw.tools.length > 0) {
     result.tools = raw.tools;
   }
+  if (raw.toolChoice != null) {
+    result.toolChoice = raw.toolChoice;
+  }
   if (typeof provenance.variantName === "string" && provenance.variantName.length > 0) {
     result.variantName = provenance.variantName;
   }
@@ -172,22 +176,19 @@ class PromptResource {
       throw new Error(`[to11ai/sdk] \`env\` must match ${ENV_SLUG_REGEX} (lowercase-kebab, 1-63 chars). Received: ${JSON.stringify(env)}`);
     }
     const {
-      context,
       subject,
       variables,
       cache: useCache = true,
       fallback,
       developerRole
     } = options;
-    const cacheKey = buildFetchCacheKey(this.projectId, slug, env, context, subject, variables, developerRole);
+    const cacheKey = buildFetchCacheKey(this.projectId, slug, env, subject, variables, developerRole);
     if (useCache) {
       const cached = this.cache.get(cacheKey);
       if (cached && "messages" in cached)
         return structuredClone(cached);
     }
     const body = { slug, labels: [env] };
-    if (context !== undefined)
-      body.context = context;
     if (subject !== undefined)
       body.subject = subject;
     if (variables !== undefined)

package/dist/prompts/types.d.ts

@@ -15,14 +15,7 @@ export interface TextChatMessage {
     content: string;
     disabled?: boolean;
 }
-export interface ToolChatMessage {
-    role: "tool";
-    name: string;
-    description?: string;
-    parameters: unknown;
-    disabled?: boolean;
-}
-export type ChatMessage = TextChatMessage | ToolChatMessage;
+export type ChatMessage = TextChatMessage;
 export type RenderedChatMessage = GenRenderedChatPrompt["messages"][number];
 export type RenderedPrompt = GenRenderedPrompt;
 /**
@@ -36,7 +29,7 @@ export type ResolvedToolDefinition = GenResolvedToolDefinition;
  * on a rendered `assistant` turn (few-shot multi-tool history).
  */
 export type ResolvedToolCall = GenResolvedToolCall;
-export type ResolvedPrompt = Pick<GenResolvedPrompt, "promptId" | "versionId" | "version" | "labels" | "contentHash" | "rendered" | "tools">;
+export type ResolvedPrompt = Pick<GenResolvedPrompt, "promptId" | "versionId" | "version" | "labels" | "contentHash" | "rendered" | "tools" | "toolChoice">;
 export interface PaginationInfo {
     page: number;
     limit: number;
@@ -129,7 +122,6 @@ export interface ResolvePromptInput {
 export type ResolvePromptResult = ResolvedPrompt;
 export declare const ENV_SLUG_REGEX: RegExp;
 export type BlockRenderRecord = Record<string, "rendered" | "dimmed">;
-export type PromptContext = Record<string, string | number | boolean>;
 export interface FetchedPrompt {
     messages: RenderedChatMessage[];
     version: number;
@@ -147,6 +139,16 @@ export interface FetchedPrompt {
      * tools. Shape for a provider with `toOpenAITools` / `toAnthropicTools`.
      */
     tools?: ResolvedToolDefinition[];
+    /**
+     * Provider-neutral tool-choice directive lifted from the resolved version.
+     * Absent (rather than `null`) when the version declares none. Feed straight
+     * into `toOpenAIToolChoice` / `toAnthropicToolChoice`.
+     *
+     * `NonNullable` because `normalizeResolvedEnvelope` maps wire-`null` to absent,
+     * so a present `FetchedPrompt.toolChoice` is never `null` — callers get the
+     * key or nothing, and never have to branch on `null`.
+     */
+    toolChoice?: NonNullable<ResolvedPrompt["toolChoice"]>;
 }
 export type ResolvedPromptEnvelope = GenResolvedPrompt & {
     /** Active release strategy. Used to decide weighted-no-subject cache bypass (D8). */
@@ -161,7 +163,6 @@ export type ResolvedPromptEnvelope = GenResolvedPrompt & {
 export type DeveloperRole = "user" | "developer" | "system";
 export interface FetchPromptOptions {
     env?: string;
-    context?: PromptContext;
     subject?: string;
     variables?: Record<string, unknown>;
     cache?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@to11ai/sdk",
-	"version": "0.7.0",
+	"version": "1.0.0",
 	"license": "MPL-2.0",
 	"repository": {
 		"type": "git",

package/src/client.ts

@@ -69,7 +69,6 @@ export type {
 	DeveloperRole,
 	FetchedPrompt,
 	FetchPromptOptions,
-	PromptContext,
 	RenderedChatMessage,
 	RenderedPrompt,
 	ResolvedPrompt,

package/src/gateway.ts

@@ -138,6 +138,13 @@ export interface OpenAITool {
 	};
 }
 
+/** OpenAI `tool_choice` value for a Chat Completions request. */
+export type OpenAIToolChoice =
+	| "auto"
+	| "none"
+	| "required"
+	| { type: "function"; function: { name: string } };
+
 /** OpenAI Chat Completions assistant `tool_calls[]` entry. */
 export interface OpenAIToolCall {
 	id: string;
@@ -177,6 +184,13 @@ export interface AnthropicMessage {
 	content: string | AnthropicContentBlock[];
 }
 
+/** Anthropic Messages `tool_choice` value. */
+export type AnthropicToolChoice =
+	| { type: "auto" }
+	| { type: "any" }
+	| { type: "none" }
+	| { type: "tool"; name: string };
+
 /**
  * Shape resolved tool definitions for the OpenAI Chat Completions `tools`
  * field: `{ type: "function", function: { name, description?, parameters } }`.
@@ -186,7 +200,8 @@ export interface AnthropicMessage {
  *
  * @example
  * const tools = toOpenAITools(prompt.tools);
- * await openai.chat.completions.create({ model, messages, tools });
+ * const tool_choice = toOpenAIToolChoice(prompt.toolChoice);
+ * await openai.chat.completions.create({ model, messages, tools, tool_choice });
  */
 export function toOpenAITools(
 	tools: ReadonlyArray<ResolvedToolDefinition> | null | undefined,
@@ -204,6 +219,27 @@ export function toOpenAITools(
 	});
 }
 
+/**
+ * Map a resolved prompt's provider-neutral `toolChoice` to the OpenAI
+ * Chat Completions `tool_choice` field.
+ *
+ * - `null` / `undefined` → `undefined` (omit the field)
+ * - `"auto"` → `"auto"`, `"none"` → `"none"`, `"required"` → `"required"`
+ * - `{ name }` → `{ type: "function", function: { name } }`
+ *
+ * @example
+ * const tools = toOpenAITools(prompt.tools);
+ * const tool_choice = toOpenAIToolChoice(prompt.toolChoice);
+ * await openai.chat.completions.create({ model, messages, tools, tool_choice });
+ */
+export function toOpenAIToolChoice(
+	toolChoice: ResolvedPrompt["toolChoice"],
+): OpenAIToolChoice | undefined {
+	if (toolChoice == null) return undefined;
+	if (typeof toolChoice === "string") return toolChoice;
+	return { type: "function", function: { name: toolChoice.name } };
+}
+
 /**
  * Shape resolved tool definitions for the Anthropic Messages `tools` field:
  * `{ name, description?, input_schema }` (Anthropic names the JSON Schema field
@@ -211,7 +247,8 @@ export function toOpenAITools(
  *
  * @example
  * const tools = toAnthropicTools(prompt.tools);
- * await anthropic.messages.create({ model, system, messages, tools });
+ * const tool_choice = toAnthropicToolChoice(prompt.toolChoice);
+ * await anthropic.messages.create({ model, system, messages, tools, tool_choice });
  */
 export function toAnthropicTools(
 	tools: ReadonlyArray<ResolvedToolDefinition> | null | undefined,
@@ -229,6 +266,31 @@ export function toAnthropicTools(
 	});
 }
 
+/**
+ * Map a resolved prompt's provider-neutral `toolChoice` to the Anthropic
+ * Messages `tool_choice` field.
+ *
+ * - `null` / `undefined` → `undefined` (omit the field)
+ * - `"auto"` → `{ type: "auto" }`
+ * - `"none"` → `{ type: "none" }` (the Anthropic API supports this natively)
+ * - `"required"` → `{ type: "any" }` (Anthropic's name for "must invoke a tool")
+ * - `{ name }` → `{ type: "tool", name }`
+ *
+ * @example
+ * const tools = toAnthropicTools(prompt.tools);
+ * const tool_choice = toAnthropicToolChoice(prompt.toolChoice);
+ * await anthropic.messages.create({ model, system, messages, tools, tool_choice });
+ */
+export function toAnthropicToolChoice(
+	toolChoice: ResolvedPrompt["toolChoice"],
+): AnthropicToolChoice | undefined {
+	if (toolChoice == null) return undefined;
+	if (toolChoice === "auto") return { type: "auto" };
+	if (toolChoice === "none") return { type: "none" };
+	if (toolChoice === "required") return { type: "any" };
+	return { type: "tool", name: toolChoice.name };
+}
+
 /**
  * Guard a tool-call linkage id before it is serialized into a provider payload.
  * A missing/empty id means malformed tool history (an assistant tool call or a

package/src/generated/types.gen.ts

@@ -308,6 +308,9 @@ export type ResolvedPrompt = {
     releaseId: string;
     rendered: RenderedPrompt;
     subjectHash?: string | null;
+    toolChoice?: 'auto' | 'none' | 'required' | {
+        name: string;
+    } | null;
     tools?: Array<ResolvedToolDefinition> | null;
     variantName?: string | null;
     version: number;
@@ -15484,6 +15487,7 @@ export type PromptsGetPromptVersionDiffResponses = {
                 name: string;
                 op: 'add';
                 role: 'system' | 'user' | 'assistant' | 'developer' | 'tool';
+                toolCallId?: string | null;
                 toolCalls?: Array<{
                     arguments: {
                         [key: string]: unknown;
@@ -15491,15 +15495,6 @@ export type PromptsGetPromptVersionDiffResponses = {
                     id: string;
                     name: string;
                 }> | null;
-                toolSchema?: {
-                    content?: string | null;
-                    description?: string | null;
-                    parameters?: {
-                        [key: string]: unknown;
-                    } | null;
-                    toolCallId?: string | null;
-                    toolKind?: 'definition' | 'result' | null;
-                } | null;
             } | {
                 condition: {
                     kind: string;
@@ -15508,6 +15503,7 @@ export type PromptsGetPromptVersionDiffResponses = {
                 name: string;
                 op: 'remove';
                 role: 'system' | 'user' | 'assistant' | 'developer' | 'tool';
+                toolCallId?: string | null;
                 toolCalls?: Array<{
                     arguments: {
                         [key: string]: unknown;
@@ -15515,15 +15511,6 @@ export type PromptsGetPromptVersionDiffResponses = {
                     id: string;
                     name: string;
                 }> | null;
-                toolSchema?: {
-                    content?: string | null;
-                    description?: string | null;
-                    parameters?: {
-                        [key: string]: unknown;
-                    } | null;
-                    toolCallId?: string | null;
-                    toolKind?: 'definition' | 'result' | null;
-                } | null;
             } | {
                 after: string;
                 before: string;
@@ -15549,26 +15536,10 @@ export type PromptsGetPromptVersionDiffResponses = {
                 name: string;
                 op: 'edit_required';
             } | {
-                after: {
-                    content?: string | null;
-                    description?: string | null;
-                    parameters?: {
-                        [key: string]: unknown;
-                    } | null;
-                    toolCallId?: string | null;
-                    toolKind?: 'definition' | 'result' | null;
-                };
-                before: {
-                    content?: string | null;
-                    description?: string | null;
-                    parameters?: {
-                        [key: string]: unknown;
-                    } | null;
-                    toolCallId?: string | null;
-                    toolKind?: 'definition' | 'result' | null;
-                };
+                after: string;
+                before: string;
                 name: string;
-                op: 'edit_tool_schema';
+                op: 'edit_tool_call_id';
             } | {
                 after: Array<{
                     arguments: {
@@ -16051,9 +16022,6 @@ export type PromptsWithdrawPromptReviewResponse = PromptsWithdrawPromptReviewRes
 
 export type PromptsResolvePromptData = {
     body: {
-        context?: {
-            [key: string]: string | number | boolean;
-        } | null;
         developerRole?: 'user' | 'developer' | 'system' | null;
         labels: Array<string>;
         slug: string;

package/src/generated/zod.gen.ts

@@ -355,6 +355,16 @@ export const zResolvedPrompt = z.object({
     releaseId: z.string(),
     rendered: zRenderedPrompt,
     subjectHash: z.string().nullish(),
+    toolChoice: z.union([
+        z.enum([
+            'auto',
+            'none',
+            'required'
+        ]),
+        z.object({
+            name: z.string().min(1)
+        })
+    ]).nullish(),
     tools: z.array(zResolvedToolDefinition).nullish(),
     variantName: z.string().nullish(),
     version: z.number(),
@@ -7954,18 +7964,12 @@ export const zPromptsGetPromptVersionDiffResponse = z.object({
                     'developer',
                     'tool'
                 ]),
+                toolCallId: z.string().nullish(),
                 toolCalls: z.array(z.object({
                     arguments: z.record(z.string(), z.unknown()),
                     id: z.string(),
                     name: z.string()
-                })).nullish(),
-                toolSchema: z.object({
-                    content: z.string().nullish(),
-                    description: z.string().nullish(),
-                    parameters: z.record(z.string(), z.unknown()).nullish(),
-                    toolCallId: z.string().nullish(),
-                    toolKind: z.enum(['definition', 'result']).nullish()
-                }).nullish()
+                })).nullish()
             }),
             z.object({
                 condition: z.object({
@@ -7981,18 +7985,12 @@ export const zPromptsGetPromptVersionDiffResponse = z.object({
                     'developer',
                     'tool'
                 ]),
+                toolCallId: z.string().nullish(),
                 toolCalls: z.array(z.object({
                     arguments: z.record(z.string(), z.unknown()),
                     id: z.string(),
                     name: z.string()
-                })).nullish(),
-                toolSchema: z.object({
-                    content: z.string().nullish(),
-                    description: z.string().nullish(),
-                    parameters: z.record(z.string(), z.unknown()).nullish(),
-                    toolCallId: z.string().nullish(),
-                    toolKind: z.enum(['definition', 'result']).nullish()
-                }).nullish()
+                })).nullish()
             }),
             z.object({
                 after: z.string(),
@@ -8035,22 +8033,10 @@ export const zPromptsGetPromptVersionDiffResponse = z.object({
                 op: z.enum(['edit_required'])
             }),
             z.object({
-                after: z.object({
-                    content: z.string().nullish(),
-                    description: z.string().nullish(),
-                    parameters: z.record(z.string(), z.unknown()).nullish(),
-                    toolCallId: z.string().nullish(),
-                    toolKind: z.enum(['definition', 'result']).nullish()
-                }),
-                before: z.object({
-                    content: z.string().nullish(),
-                    description: z.string().nullish(),
-                    parameters: z.record(z.string(), z.unknown()).nullish(),
-                    toolCallId: z.string().nullish(),
-                    toolKind: z.enum(['definition', 'result']).nullish()
-                }),
+                after: z.string(),
+                before: z.string(),
                 name: z.string(),
-                op: z.enum(['edit_tool_schema'])
+                op: z.enum(['edit_tool_call_id'])
             }),
             z.object({
                 after: z.array(z.object({
@@ -8314,11 +8300,6 @@ export const zPromptsWithdrawPromptReviewResponse = z.object({
 });
 
 export const zPromptsResolvePromptBody = z.object({
-    context: z.record(z.string(), z.union([
-        z.string(),
-        z.number(),
-        z.boolean()
-    ])).nullish(),
     developerRole: z.enum([
         'user',
         'developer',

package/src/prompts/cache.ts

@@ -1,4 +1,4 @@
-import type { FetchedPrompt, PromptContext, ResolvedPrompt } from "./types";
+import type { FetchedPrompt, ResolvedPrompt } from "./types";
 
 export interface CacheConfig {
 	/** Time-to-live in seconds. Default: 300 (5 minutes) */
@@ -46,9 +46,9 @@ export function buildCacheKey(
 /**
  * Build a cache key for an env-aware `fetch()` call.
  *
- * Folds in `env`, `context`, and `subject` ON TOP of the base
+ * Folds in `env` and `subject` ON TOP of the base
  * project/slug/labels/variables key so two calls that differ only by
- * env/context/subject do not return a stale cross-env / cross-cohort hit
+ * env/subject do not return a stale cross-env / cross-cohort hit
  * (spec §3 "Caching key changes"). The env slug is also forwarded as the
  * single resolution label (env→label mapping, correction #3), so it appears
  * in the `labels` segment too; including it explicitly here keeps the key
@@ -62,17 +62,14 @@ export function buildFetchCacheKey(
 	projectId: string,
 	slug: string,
 	env: string,
-	context?: PromptContext,
 	subject?: string,
 	variables?: Record<string, unknown>,
 	developerRole?: string,
 ): string {
 	const base = buildCacheKey(projectId, slug, [env], variables);
-	const ctxPart =
-		context !== undefined ? JSON.stringify(sortObjectKeys(context)) : null;
 	// `developerRole` partitions the cache; coalesce the default so omitted and
 	// `"user"` (the documented default) share one entry, not two.
-	return `fetch|${base}|${JSON.stringify(env)}|${JSON.stringify(ctxPart)}|${JSON.stringify(subject ?? null)}|${JSON.stringify(developerRole ?? "user")}`;
+	return `fetch|${base}|${JSON.stringify(env)}|${JSON.stringify(subject ?? null)}|${JSON.stringify(developerRole ?? "user")}`;
 }
 
 function sortObjectKeys(obj: unknown): unknown {

package/src/prompts/resource.ts

@@ -94,7 +94,6 @@ export type {
 	ProjectPromptLabel,
 	ProjectPromptLabelUsage,
 	Prompt,
-	PromptContext,
 	PromptFormat,
 	PromptLabelEvent,
 	PromptLabelPointer,
@@ -111,7 +110,6 @@ export type {
 	RowError,
 	TextChatMessage,
 	TextChatRole,
-	ToolChatMessage,
 	UpdateProjectPromptLabelInput,
 	UpdateProjectPromptLabelResult,
 	UpdatePromptInput,
@@ -126,6 +124,7 @@ const zResolvedPromptLegacy = zResolvedPrompt.pick({
 	contentHash: true,
 	rendered: true,
 	tools: true,
+	toolChoice: true,
 });
 
 const zResolvedPromptEnvelope = zResolvedPrompt
@@ -187,6 +186,13 @@ function normalizeResolvedEnvelope(
 	if (raw.tools != null && raw.tools.length > 0) {
 		result.tools = raw.tools;
 	}
+	// `toolChoice` mirrors `tools`: present IFF the resolved version declares a
+	// directive. The wire may send `null` (or omit it); normalize both to absent
+	// so callers feed `toOpenAIToolChoice` / `toAnthropicToolChoice` (which map
+	// `null`/`undefined` → omit) without a separate guard.
+	if (raw.toolChoice != null) {
+		result.toolChoice = raw.toolChoice;
+	}
 	// Set `variantName` only when it is a non-empty string, so the key is
 	// genuinely absent for `single`-strategy releases (R5: present IFF weighted —
 	// never `null`, never `""`). A `null`/`""` from the wire is normalized to
@@ -441,8 +447,8 @@ export class PromptResource {
 	 *   label-based (`/v1/projects/:projectId/prompts:resolve`, body
 	 *   `labels[]`); it does NOT accept a top-level `env` field. The resolved
 	 *   env slug (lowercase-kebab — a valid label name) is therefore sent as
-	 *   the single resolution label: body `{ slug, labels: [env], context?,
-	 *   subject?, variables? }`.
+	 *   the single resolution label: body `{ slug, labels: [env], subject?,
+	 *   variables? }`.
 	 * - **No silent fallback (R4):** if no env is resolvable (none at init AND
 	 *   none per call) this throws `EnvNotFoundError` (`reason.source =
 	 *   "missing"`) CLIENT-side, eagerly, before any transport call.
@@ -481,7 +487,6 @@ export class PromptResource {
 		}
 
 		const {
-			context,
 			subject,
 			variables,
 			cache: useCache = true,
@@ -493,7 +498,6 @@ export class PromptResource {
 			this.projectId,
 			slug,
 			env,
-			context,
 			subject,
 			variables,
 			developerRole,
@@ -508,7 +512,6 @@ export class PromptResource {
 
 		// env→label mapping: the env slug is the single resolution label.
 		const body: Record<string, unknown> = { slug, labels: [env] };
-		if (context !== undefined) body.context = context;
 		if (subject !== undefined) body.subject = subject;
 		if (variables !== undefined) body.variables = variables;
 		if (developerRole !== undefined) body.developerRole = developerRole;
@@ -559,8 +562,8 @@ export class PromptResource {
 
 	/**
 	 * @deprecated Use {@link PromptResource.fetch | `prompts.fetch(slug,
-	 * options?)`} instead. `resolve()` is env-agnostic (no `env` / `context` /
-	 * `subject`, no enriched release/variant provenance, no typed-env errors)
+	 * options?)`} instead. `resolve()` is env-agnostic (no `env` / `subject`,
+	 * no enriched release/variant provenance, no typed-env errors)
 	 * and is retained only for back-compat. It is NOT subject to the R4
 	 * no-silent-fallback env gate (it has no env concept). New code should
 	 * configure `projectId` + `env` at `createClient` and call `fetch()`.

package/src/prompts/types.ts

@@ -32,15 +32,7 @@ export interface TextChatMessage {
 	disabled?: boolean;
 }
 
-export interface ToolChatMessage {
-	role: "tool";
-	name: string;
-	description?: string;
-	parameters: unknown;
-	disabled?: boolean;
-}
-
-export type ChatMessage = TextChatMessage | ToolChatMessage;
+export type ChatMessage = TextChatMessage;
 
 export type RenderedChatMessage = GenRenderedChatPrompt["messages"][number];
 
@@ -68,6 +60,7 @@ export type ResolvedPrompt = Pick<
 	| "contentHash"
 	| "rendered"
 	| "tools"
+	| "toolChoice"
 >;
 
 export interface PaginationInfo {
@@ -188,8 +181,6 @@ export const ENV_SLUG_REGEX = /^[a-z0-9-]{1,63}$/;
 
 export type BlockRenderRecord = Record<string, "rendered" | "dimmed">;
 
-export type PromptContext = Record<string, string | number | boolean>;
-
 export interface FetchedPrompt {
 	messages: RenderedChatMessage[];
 	version: number;
@@ -207,6 +198,16 @@ export interface FetchedPrompt {
 	 * tools. Shape for a provider with `toOpenAITools` / `toAnthropicTools`.
 	 */
 	tools?: ResolvedToolDefinition[];
+	/**
+	 * Provider-neutral tool-choice directive lifted from the resolved version.
+	 * Absent (rather than `null`) when the version declares none. Feed straight
+	 * into `toOpenAIToolChoice` / `toAnthropicToolChoice`.
+	 *
+	 * `NonNullable` because `normalizeResolvedEnvelope` maps wire-`null` to absent,
+	 * so a present `FetchedPrompt.toolChoice` is never `null` — callers get the
+	 * key or nothing, and never have to branch on `null`.
+	 */
+	toolChoice?: NonNullable<ResolvedPrompt["toolChoice"]>;
 }
 
 export type ResolvedPromptEnvelope = GenResolvedPrompt & {
@@ -224,7 +225,6 @@ export type DeveloperRole = "user" | "developer" | "system";
 
 export interface FetchPromptOptions {
 	env?: string;
-	context?: PromptContext;
 	subject?: string;
 	variables?: Record<string, unknown>;
 	cache?: boolean;