@to11ai/sdk 0.5.0 → 0.7.0

package/src/generated/types.gen.ts

@@ -267,21 +267,37 @@ export type PromptVersion = {
     version: number;
 };
 
+export type RenderedAssistantMessage = {
+    content?: string | null;
+    role: 'assistant';
+    toolCalls?: Array<ResolvedToolCall> | null;
+};
+
+export type RenderedChatMessage = RenderedTextMessage | RenderedAssistantMessage | RenderedToolMessage;
+
 export type RenderedChatPrompt = {
     format: 'chat';
-    messages: Array<{
-        content: string;
-        role: 'system' | 'user' | 'assistant' | 'developer' | 'tool';
-    }>;
+    messages: Array<RenderedChatMessage>;
 };
 
 export type RenderedPrompt = RenderedTextPrompt | RenderedChatPrompt;
 
+export type RenderedTextMessage = {
+    content: string;
+    role: 'system' | 'user' | 'developer';
+};
+
 export type RenderedTextPrompt = {
     format: 'text';
     text: string;
 };
 
+export type RenderedToolMessage = {
+    content: string;
+    role: 'tool';
+    toolCallId: string;
+};
+
 export type ResolvedPrompt = {
     blockRenderRecord?: {
         [key: string]: 'rendered' | 'dimmed';
@@ -292,11 +308,28 @@ export type ResolvedPrompt = {
     releaseId: string;
     rendered: RenderedPrompt;
     subjectHash?: string | null;
+    tools?: Array<ResolvedToolDefinition> | null;
     variantName?: string | null;
     version: number;
     versionId: string;
 };
 
+export type ResolvedToolCall = {
+    arguments: {
+        [key: string]: unknown;
+    };
+    id: string;
+    name: string;
+};
+
+export type ResolvedToolDefinition = {
+    description?: string | null;
+    name: string;
+    parameters: {
+        [key: string]: unknown;
+    };
+};
+
 export type RuleModelBinding = {
     modelId: string;
     provider: RuleProviderRef;
@@ -9826,7 +9859,7 @@ export type ProjectAuditListProjectAuditEventsResponses = {
                 providerSlug: string | null;
                 reason: string | null;
                 resourceId: string;
-                resourceType: 'provider' | 'credential' | 'prompt' | 'rule' | 'env';
+                resourceType: 'provider' | 'credential' | 'prompt' | 'rule' | 'env' | 'role' | 'api_key' | 'project' | 'organization' | 'organization_invitation' | 'workspace' | 'data_center' | 'cost_rate';
                 scheduledAt: string | null;
                 scheduledBy: string | null;
             }>;
@@ -9873,7 +9906,7 @@ export type ProjectAuditExportExportProjectAuditEventsData = {
         provider_id?: string | null;
         credential_id?: string | null;
         actor_id?: string | null;
-        resource_type?: 'provider' | 'credential' | 'prompt' | 'rule' | 'env' | null;
+        resource_type?: 'provider' | 'credential' | 'prompt' | 'rule' | 'env' | 'role' | 'api_key' | 'project' | 'organization' | 'organization_invitation' | 'workspace' | 'data_center' | 'cost_rate' | null;
         event_type?: string | null;
         since?: string | null;
         until?: string | null;
@@ -15451,11 +15484,21 @@ export type PromptsGetPromptVersionDiffResponses = {
                 name: string;
                 op: 'add';
                 role: 'system' | 'user' | 'assistant' | 'developer' | 'tool';
+                toolCalls?: Array<{
+                    arguments: {
+                        [key: string]: unknown;
+                    };
+                    id: string;
+                    name: string;
+                }> | null;
                 toolSchema?: {
+                    content?: string | null;
                     description?: string | null;
-                    parameters: {
+                    parameters?: {
                         [key: string]: unknown;
-                    };
+                    } | null;
+                    toolCallId?: string | null;
+                    toolKind?: 'definition' | 'result' | null;
                 } | null;
             } | {
                 condition: {
@@ -15465,11 +15508,21 @@ export type PromptsGetPromptVersionDiffResponses = {
                 name: string;
                 op: 'remove';
                 role: 'system' | 'user' | 'assistant' | 'developer' | 'tool';
+                toolCalls?: Array<{
+                    arguments: {
+                        [key: string]: unknown;
+                    };
+                    id: string;
+                    name: string;
+                }> | null;
                 toolSchema?: {
+                    content?: string | null;
                     description?: string | null;
-                    parameters: {
+                    parameters?: {
                         [key: string]: unknown;
-                    };
+                    } | null;
+                    toolCallId?: string | null;
+                    toolKind?: 'definition' | 'result' | null;
                 } | null;
             } | {
                 after: string;
@@ -15497,19 +15550,42 @@ export type PromptsGetPromptVersionDiffResponses = {
                 op: 'edit_required';
             } | {
                 after: {
+                    content?: string | null;
                     description?: string | null;
-                    parameters: {
+                    parameters?: {
                         [key: string]: unknown;
-                    };
+                    } | null;
+                    toolCallId?: string | null;
+                    toolKind?: 'definition' | 'result' | null;
                 };
                 before: {
+                    content?: string | null;
                     description?: string | null;
-                    parameters: {
+                    parameters?: {
                         [key: string]: unknown;
-                    };
+                    } | null;
+                    toolCallId?: string | null;
+                    toolKind?: 'definition' | 'result' | null;
                 };
                 name: string;
                 op: 'edit_tool_schema';
+            } | {
+                after: Array<{
+                    arguments: {
+                        [key: string]: unknown;
+                    };
+                    id: string;
+                    name: string;
+                }>;
+                before: Array<{
+                    arguments: {
+                        [key: string]: unknown;
+                    };
+                    id: string;
+                    name: string;
+                }>;
+                name: string;
+                op: 'edit_tool_calls';
             } | {
                 fromIndex: number;
                 name: string;
@@ -15978,6 +16054,7 @@ export type PromptsResolvePromptData = {
         context?: {
             [key: string]: string | number | boolean;
         } | null;
+        developerRole?: 'user' | 'developer' | 'system' | null;
         labels: Array<string>;
         slug: string;
         subject?: string | null;
@@ -18477,10 +18554,13 @@ export type RoutingMetricsGetRoutingProviderMetricsResponses = {
         data: Array<{
             calls7dTotal: number;
             daily: Array<number>;
+            errorCount: number;
+            errorRate: number;
             latencyP50Ms: number | null;
             latencyP95Ms: number | null;
             providerId: string;
             requests: number;
+            spend7dUsd: number | null;
         }> | null;
         error: {
             code: string;

package/src/generated/zod.gen.ts

@@ -293,18 +293,13 @@ export const zPromptVersion = z.object({
     version: z.int().gt(0).lte(2147483647)
 });
 
-export const zRenderedChatPrompt = z.object({
-    format: z.enum(['chat']),
-    messages: z.array(z.object({
-        content: z.string(),
-        role: z.enum([
-            'system',
-            'user',
-            'assistant',
-            'developer',
-            'tool'
-        ])
-    }))
+export const zRenderedTextMessage = z.object({
+    content: z.string(),
+    role: z.enum([
+        'system',
+        'user',
+        'developer'
+    ])
 });
 
 export const zRenderedTextPrompt = z.object({
@@ -312,11 +307,46 @@ export const zRenderedTextPrompt = z.object({
     text: z.string()
 });
 
+export const zRenderedToolMessage = z.object({
+    content: z.string(),
+    role: z.enum(['tool']),
+    toolCallId: z.string()
+});
+
+export const zResolvedToolCall = z.object({
+    arguments: z.record(z.string(), z.unknown()),
+    id: z.string(),
+    name: z.string()
+});
+
+export const zRenderedAssistantMessage = z.object({
+    content: z.string().nullish(),
+    role: z.enum(['assistant']),
+    toolCalls: z.array(zResolvedToolCall).nullish()
+});
+
+export const zRenderedChatMessage = z.union([
+    zRenderedTextMessage,
+    zRenderedAssistantMessage,
+    zRenderedToolMessage
+]);
+
+export const zRenderedChatPrompt = z.object({
+    format: z.enum(['chat']),
+    messages: z.array(zRenderedChatMessage)
+});
+
 export const zRenderedPrompt = z.union([
     zRenderedTextPrompt,
     zRenderedChatPrompt
 ]);
 
+export const zResolvedToolDefinition = z.object({
+    description: z.string().nullish(),
+    name: z.string(),
+    parameters: z.record(z.string(), z.unknown())
+});
+
 export const zResolvedPrompt = z.object({
     blockRenderRecord: z.record(z.string(), z.enum(['rendered', 'dimmed'])).nullish(),
     contentHash: z.string(),
@@ -325,6 +355,7 @@ export const zResolvedPrompt = z.object({
     releaseId: z.string(),
     rendered: zRenderedPrompt,
     subjectHash: z.string().nullish(),
+    tools: z.array(zResolvedToolDefinition).nullish(),
     variantName: z.string().nullish(),
     version: z.number(),
     versionId: z.string()
@@ -5088,7 +5119,15 @@ export const zProjectAuditListProjectAuditEventsResponse = z.object({
                 'credential',
                 'prompt',
                 'rule',
-                'env'
+                'env',
+                'role',
+                'api_key',
+                'project',
+                'organization',
+                'organization_invitation',
+                'workspace',
+                'data_center',
+                'cost_rate'
             ]),
             scheduledAt: z.string().nullable(),
             scheduledBy: z.string().nullable()
@@ -5135,7 +5174,15 @@ export const zProjectAuditExportExportProjectAuditEventsQuery = z.object({
         'credential',
         'prompt',
         'rule',
-        'env'
+        'env',
+        'role',
+        'api_key',
+        'project',
+        'organization',
+        'organization_invitation',
+        'workspace',
+        'data_center',
+        'cost_rate'
     ]).nullish(),
     event_type: z.string().nullish(),
     since: z.string().nullish(),
@@ -7907,9 +7954,17 @@ export const zPromptsGetPromptVersionDiffResponse = z.object({
                     'developer',
                     'tool'
                 ]),
+                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())
+                    parameters: z.record(z.string(), z.unknown()).nullish(),
+                    toolCallId: z.string().nullish(),
+                    toolKind: z.enum(['definition', 'result']).nullish()
                 }).nullish()
             }),
             z.object({
@@ -7926,9 +7981,17 @@ export const zPromptsGetPromptVersionDiffResponse = z.object({
                     'developer',
                     'tool'
                 ]),
+                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())
+                    parameters: z.record(z.string(), z.unknown()).nullish(),
+                    toolCallId: z.string().nullish(),
+                    toolKind: z.enum(['definition', 'result']).nullish()
                 }).nullish()
             }),
             z.object({
@@ -7973,16 +8036,36 @@ export const zPromptsGetPromptVersionDiffResponse = z.object({
             }),
             z.object({
                 after: z.object({
+                    content: z.string().nullish(),
                     description: z.string().nullish(),
-                    parameters: z.record(z.string(), z.unknown())
+                    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())
+                    parameters: z.record(z.string(), z.unknown()).nullish(),
+                    toolCallId: z.string().nullish(),
+                    toolKind: z.enum(['definition', 'result']).nullish()
                 }),
                 name: z.string(),
                 op: z.enum(['edit_tool_schema'])
             }),
+            z.object({
+                after: z.array(z.object({
+                    arguments: z.record(z.string(), z.unknown()),
+                    id: z.string(),
+                    name: z.string()
+                })),
+                before: z.array(z.object({
+                    arguments: z.record(z.string(), z.unknown()),
+                    id: z.string(),
+                    name: z.string()
+                })),
+                name: z.string(),
+                op: z.enum(['edit_tool_calls'])
+            }),
             z.object({
                 fromIndex: z.number(),
                 name: z.string(),
@@ -8236,6 +8319,11 @@ export const zPromptsResolvePromptBody = z.object({
         z.number(),
         z.boolean()
     ])).nullish(),
+    developerRole: z.enum([
+        'user',
+        'developer',
+        'system'
+    ]).nullish(),
     labels: z.array(z.string().min(1).max(64).regex(/^[a-zA-Z0-9_-]+$/)).min(1).max(10),
     slug: z.string().min(1),
     subject: z.string().min(1).nullish(),
@@ -9689,10 +9777,13 @@ export const zRoutingMetricsGetRoutingProviderMetricsResponse = z.object({
     data: z.array(z.object({
         calls7dTotal: z.number(),
         daily: z.array(z.number()),
+        errorCount: z.number(),
+        errorRate: z.number(),
         latencyP50Ms: z.number().nullable(),
         latencyP95Ms: z.number().nullable(),
         providerId: z.string(),
-        requests: z.number()
+        requests: z.number(),
+        spend7dUsd: z.number().nullable()
     })).nullable(),
     error: z.object({
         code: z.string(),

package/src/prompts/cache.ts

@@ -65,11 +65,14 @@ export function buildFetchCacheKey(
 	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;
-	return `fetch|${base}|${JSON.stringify(env)}|${JSON.stringify(ctxPart)}|${JSON.stringify(subject ?? 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")}`;
 }
 
 function sortObjectKeys(obj: unknown): unknown {

package/src/prompts/resource.ts

@@ -104,6 +104,8 @@ export type {
 	RenderedPrompt,
 	ResolvedPrompt,
 	ResolvedPromptEnvelope,
+	ResolvedToolCall,
+	ResolvedToolDefinition,
 	ResolvePromptInput,
 	ResolvePromptResult,
 	RowError,
@@ -123,6 +125,7 @@ const zResolvedPromptLegacy = zResolvedPrompt.pick({
 	labels: true,
 	contentHash: true,
 	rendered: true,
+	tools: true,
 });
 
 const zResolvedPromptEnvelope = zResolvedPrompt
@@ -178,6 +181,12 @@ function normalizeResolvedEnvelope(
 		labels: raw.labels,
 		rendered: raw.rendered,
 	};
+	// `tools` is present IFF the resolved version declares tool definitions; the
+	// wire may send `null` (or omit it) — normalize both to absent so callers
+	// can `?? []` once via the converters rather than guarding `null`.
+	if (raw.tools != null && raw.tools.length > 0) {
+		result.tools = raw.tools;
+	}
 	// 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
@@ -477,6 +486,7 @@ export class PromptResource {
 			variables,
 			cache: useCache = true,
 			fallback,
+			developerRole,
 		} = options;
 
 		const cacheKey = buildFetchCacheKey(
@@ -486,6 +496,7 @@ export class PromptResource {
 			context,
 			subject,
 			variables,
+			developerRole,
 		);
 
 		if (useCache) {
@@ -500,6 +511,7 @@ export class PromptResource {
 		if (context !== undefined) body.context = context;
 		if (subject !== undefined) body.subject = subject;
 		if (variables !== undefined) body.variables = variables;
+		if (developerRole !== undefined) body.developerRole = developerRole;
 
 		try {
 			const envelope = await this.transport.request<ResolvedPromptEnvelope>(

package/src/prompts/types.ts

@@ -8,6 +8,8 @@ import type {
 	RenderedChatPrompt as GenRenderedChatPrompt,
 	RenderedPrompt as GenRenderedPrompt,
 	ResolvedPrompt as GenResolvedPrompt,
+	ResolvedToolCall as GenResolvedToolCall,
+	ResolvedToolDefinition as GenResolvedToolDefinition,
 } from "../generated/types.gen";
 
 export interface RowError {
@@ -44,9 +46,28 @@ export type RenderedChatMessage = GenRenderedChatPrompt["messages"][number];
 
 export type RenderedPrompt = GenRenderedPrompt;
 
+/**
+ * A provider-neutral tool definition (`{ name, description?, parameters }`),
+ * sourced from authored tool-definition blocks. Surfaced on the resolved
+ * contract and shaped for a provider via `toOpenAITools` / `toAnthropicTools`.
+ */
+export type ResolvedToolDefinition = GenResolvedToolDefinition;
+
+/**
+ * A structured assistant tool call (`{ id, name, arguments }`) carried inline
+ * 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"
+	| "promptId"
+	| "versionId"
+	| "version"
+	| "labels"
+	| "contentHash"
+	| "rendered"
+	| "tools"
 >;
 
 export interface PaginationInfo {
@@ -180,6 +201,12 @@ export interface FetchedPrompt {
 	contentHash: string;
 	labels: string[];
 	rendered: RenderedPrompt;
+	/**
+	 * Provider-neutral tool definitions lifted from authored tool-definition
+	 * blocks. Absent (rather than `[]`) when the resolved version declares no
+	 * tools. Shape for a provider with `toOpenAITools` / `toAnthropicTools`.
+	 */
+	tools?: ResolvedToolDefinition[];
 }
 
 export type ResolvedPromptEnvelope = GenResolvedPrompt & {
@@ -187,6 +214,14 @@ export type ResolvedPromptEnvelope = GenResolvedPrompt & {
 	strategy?: "single" | "weighted";
 };
 
+/**
+ * How an authored `developer` block is rendered. The caller controls this
+ * per-call because it knows the upstream it targets. Omitted ⇒ `"user"`
+ * (back-compatible; safe for any upstream). `"developer"` preserves the role
+ * (OpenAI); `"system"` folds it into a system message.
+ */
+export type DeveloperRole = "user" | "developer" | "system";
+
 export interface FetchPromptOptions {
 	env?: string;
 	context?: PromptContext;
@@ -194,6 +229,12 @@ export interface FetchPromptOptions {
 	variables?: Record<string, unknown>;
 	cache?: boolean;
 	fallback?: ResolvedPrompt | FetchedPrompt;
+	/**
+	 * How authored `developer` blocks render. Default `"user"`. Forwarded on the
+	 * resolve request and folded into the cache key so two calls differing only
+	 * by `developerRole` never share a cached result.
+	 */
+	developerRole?: DeveloperRole;
 }
 
 export type PaletteToken = ProjectPromptLabel["displayColor"];