@to11ai/sdk 0.7.0 → 0.8.1

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

@@ -233,6 +233,7 @@ export type PromptRelease = {
 };
 export type PromptVersion = {
     changelog: string | null;
+    contextSchema: unknown;
     createdAt: string;
     createdByDisplayName: string | null;
     createdByImage: string | null;
@@ -279,6 +280,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;
@@ -14574,6 +14578,15 @@ export type PromptsCreatePromptVersionData = {
         allowBlockRemovals?: Array<string> | null;
         baseVersionId?: string | null;
         changelog?: string | null;
+        contextSchema?: {
+            properties?: {
+                [key: string]: {
+                    enum?: Array<string> | null;
+                    type?: 'string' | 'number' | 'boolean' | 'enum' | null;
+                };
+            } | null;
+            required?: Array<string> | null;
+        } | null;
         format: 'text' | 'chat';
         modelConfig?: unknown | null;
         templateJson: unknown;
@@ -14740,6 +14753,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 +14761,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 +14769,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 +14777,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 +14802,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: {

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

@@ -301,6 +301,7 @@ export declare const zPromptRelease: z.ZodObject<{
 }, z.core.$strip>;
 export declare const zPromptVersion: z.ZodObject<{
     changelog: z.ZodNullable<z.ZodString>;
+    contextSchema: z.ZodUnknown;
     createdAt: z.ZodISODateTime;
     createdByDisplayName: z.ZodNullable<z.ZodString>;
     createdByImage: z.ZodNullable<z.ZodString>;
@@ -489,6 +490,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;
@@ -8378,6 +8386,7 @@ export declare const zPromptsListPromptVersionsResponse: z.ZodObject<{
     code: z.ZodNumber;
     data: z.ZodNullable<z.ZodArray<z.ZodObject<{
         changelog: z.ZodNullable<z.ZodString>;
+        contextSchema: z.ZodUnknown;
         createdAt: z.ZodISODateTime;
         createdByDisplayName: z.ZodNullable<z.ZodString>;
         createdByImage: z.ZodNullable<z.ZodString>;
@@ -8419,6 +8428,18 @@ export declare const zPromptsCreatePromptVersionBody: z.ZodObject<{
     allowBlockRemovals: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
     baseVersionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     changelog: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    contextSchema: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        properties: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+            enum: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+            type: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                enum: "enum";
+            }>>>;
+        }, z.core.$strip>>>>;
+        required: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    }, z.core.$strip>>>;
     format: z.ZodEnum<{
         text: "text";
         chat: "chat";
@@ -8438,6 +8459,7 @@ export declare const zPromptsCreatePromptVersionResponse: z.ZodObject<{
     code: z.ZodNumber;
     data: z.ZodNullable<z.ZodObject<{
         changelog: z.ZodNullable<z.ZodString>;
+        contextSchema: z.ZodUnknown;
         createdAt: z.ZodISODateTime;
         createdByDisplayName: z.ZodNullable<z.ZodString>;
         createdByImage: z.ZodNullable<z.ZodString>;
@@ -8505,21 +8527,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 +8549,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 +8600,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<{
@@ -8678,6 +8664,7 @@ export declare const zPromptsGetPromptVersionResponse: z.ZodObject<{
     code: z.ZodNumber;
     data: z.ZodNullable<z.ZodObject<{
         changelog: z.ZodNullable<z.ZodString>;
+        contextSchema: z.ZodUnknown;
         createdAt: z.ZodISODateTime;
         createdByDisplayName: z.ZodNullable<z.ZodString>;
         createdByImage: z.ZodNullable<z.ZodString>;
@@ -8952,6 +8939,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/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;
   }

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, PromptContext, 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).
  *

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;
   }

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;
@@ -88,6 +81,7 @@ export interface CreatePromptVersionInput {
     format: PromptFormat;
     templateJson: unknown;
     variablesSchema: unknown;
+    contextSchema?: unknown;
     modelConfig?: unknown;
     changelog?: string;
 }
@@ -147,6 +141,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). */

package/package.json

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

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

@@ -254,6 +254,7 @@ export type PromptRelease = {
 
 export type PromptVersion = {
     changelog: string | null;
+    contextSchema: unknown;
     createdAt: string;
     createdByDisplayName: string | null;
     createdByImage: string | null;
@@ -308,6 +309,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;
@@ -15310,6 +15314,15 @@ export type PromptsCreatePromptVersionData = {
         allowBlockRemovals?: Array<string> | null;
         baseVersionId?: string | null;
         changelog?: string | null;
+        contextSchema?: {
+            properties?: {
+                [key: string]: {
+                    enum?: Array<string> | null;
+                    type?: 'string' | 'number' | 'boolean' | 'enum' | null;
+                };
+            } | null;
+            required?: Array<string> | null;
+        } | null;
         format: 'text' | 'chat';
         modelConfig?: unknown | null;
         templateJson: unknown;
@@ -15484,6 +15497,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 +15505,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 +15513,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 +15521,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 +15546,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: {

package/src/generated/zod.gen.ts

@@ -280,6 +280,7 @@ export const zPromptRelease = z.object({
 
 export const zPromptVersion = z.object({
     changelog: z.string().nullable(),
+    contextSchema: z.unknown(),
     createdAt: z.iso.datetime(),
     createdByDisplayName: z.string().nullable(),
     createdByImage: z.string().nullable(),
@@ -355,6 +356,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(),
@@ -7883,6 +7894,18 @@ export const zPromptsCreatePromptVersionBody = z.object({
     allowBlockRemovals: z.array(z.string()).nullish(),
     baseVersionId: z.string().nullish(),
     changelog: z.string().nullish(),
+    contextSchema: z.object({
+        properties: z.record(z.string(), z.object({
+            enum: z.array(z.string()).nullish(),
+            type: z.enum([
+                'string',
+                'number',
+                'boolean',
+                'enum'
+            ]).nullish()
+        })).nullish(),
+        required: z.array(z.string()).nullish()
+    }).nullish(),
     format: z.enum(['text', 'chat']),
     modelConfig: z.unknown().nullish(),
     templateJson: z.unknown(),
@@ -7954,18 +7977,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 +7998,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 +8046,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({

package/src/prompts/resource.ts

@@ -111,7 +111,6 @@ export type {
 	RowError,
 	TextChatMessage,
 	TextChatRole,
-	ToolChatMessage,
 	UpdateProjectPromptLabelInput,
 	UpdateProjectPromptLabelResult,
 	UpdatePromptInput,
@@ -126,6 +125,7 @@ const zResolvedPromptLegacy = zResolvedPrompt.pick({
 	contentHash: true,
 	rendered: true,
 	tools: true,
+	toolChoice: true,
 });
 
 const zResolvedPromptEnvelope = zResolvedPrompt
@@ -187,6 +187,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

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 {
@@ -133,6 +126,9 @@ export interface CreatePromptVersionInput {
 	format: PromptFormat;
 	templateJson: unknown;
 	variablesSchema: unknown;
+	// TO11-2609: server-trusted, gating-only context schema (scalar/enum keys).
+	// Optional on write; omitted → no context keys.
+	contextSchema?: unknown;
 	modelConfig?: unknown;
 	changelog?: string;
 }
@@ -207,6 +203,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 & {