@to11ai/sdk 2.0.0-rc.5 → 2.0.0-rc.7

package/src/generated/zod.gen.ts

@@ -7479,6 +7479,45 @@ export const zPromptsBulkPromptsResponse = z.object({
     success: z.boolean()
 });
 
+export const zPromptsRenderPromptBody = z.object({
+    variables: z.record(z.string(), z.unknown()).nullish()
+});
+
+export const zPromptsRenderPromptPath = z.object({
+    projectId: z.string().min(1),
+    slug: z.string().min(1),
+    label: z.string().min(1).max(64).regex(/^[a-zA-Z0-9_-]+$/)
+});
+
+/**
+ * Success
+ */
+export const zPromptsRenderPromptResponse = z.object({
+    code: z.number(),
+    data: zResolvedPrompt.nullable(),
+    error: z.object({
+        code: z.string(),
+        details: z.unknown().nullish(),
+        message: z.string(),
+        rowErrors: z.array(z.object({
+            code: z.string(),
+            message: z.string(),
+            path: z.array(z.union([z.string(), z.number()]))
+        })).nullish()
+    }).nullable(),
+    pagination: z.object({
+        limit: z.int().gte(1).lte(100),
+        page: z.int().gte(1),
+        total: z.int().gte(0),
+        totalPages: z.int().gte(0)
+    }).nullable(),
+    sdkBehavior: z.object({
+        flags: z.record(z.string(), z.unknown()),
+        v: z.int().gte(1)
+    }).nullish(),
+    success: z.boolean()
+});
+
 export const zPromptsGetPromptDirectorySummaryPath = z.object({
     projectId: z.string().min(1)
 });
@@ -12485,6 +12524,13 @@ export const zTracesListTracesQuery = z.object({
             z.string()
         ])
     ]).nullish(),
+    promptRef: z.union([
+        z.string(),
+        z.union([
+            z.array(z.string()),
+            z.string()
+        ])
+    ]).nullish(),
     minTokens: z.string().nullish(),
     maxTokens: z.string().nullish(),
     minCost: z.string().nullish(),
@@ -12608,6 +12654,8 @@ export const zTracesListTracesResponse = z.object({
         input_tokens: z.int(),
         model: z.string(),
         output_tokens: z.int(),
+        prompt_id: z.string().nullable(),
+        prompt_version: z.string().nullable(),
         provider: z.string(),
         session_id: z.string(),
         span_count: z.int(),
@@ -12653,6 +12701,105 @@ export const zTracesListTracesResponse = z.object({
     success: z.boolean()
 });
 
+export const zTracesListTracePromptFacetsPath = z.object({
+    projectId: z.string().min(1)
+});
+
+export const zTracesListTracePromptFacetsQuery = z.object({
+    page: z.string().nullish(),
+    limit: z.string().nullish(),
+    sort: z.enum([
+        'startTime',
+        'durationMs',
+        'inputTokens',
+        'outputTokens',
+        'model',
+        'provider',
+        'toolCalls',
+        'costUsd'
+    ]).nullish(),
+    order: z.enum(['asc', 'desc']).nullish(),
+    status: z.enum([
+        'ok',
+        'error',
+        'timeout'
+    ]).nullish(),
+    provider: z.union([
+        z.string(),
+        z.union([
+            z.array(z.string()),
+            z.string()
+        ])
+    ]).nullish(),
+    model: z.union([
+        z.string(),
+        z.union([
+            z.array(z.string()),
+            z.string()
+        ])
+    ]).nullish(),
+    promptRef: z.union([
+        z.string(),
+        z.union([
+            z.array(z.string()),
+            z.string()
+        ])
+    ]).nullish(),
+    minTokens: z.string().nullish(),
+    maxTokens: z.string().nullish(),
+    minCost: z.string().nullish(),
+    maxCost: z.string().nullish(),
+    hasToolCalls: z.enum(['yes', 'no']).nullish(),
+    timePreset: z.enum([
+        '10m',
+        '30m',
+        '1h',
+        '2h',
+        '3h',
+        '8h',
+        '24h',
+        '7d',
+        '14d',
+        '28d',
+        '60d'
+    ]).nullish(),
+    startTimeFrom: z.string().nullish(),
+    startTimeTo: z.string().nullish()
+});
+
+/**
+ * Success
+ */
+export const zTracesListTracePromptFacetsResponse = z.object({
+    code: z.number(),
+    data: z.array(z.object({
+        prompt_id: z.string(),
+        prompt_version: z.string(),
+        trace_count: z.int()
+    })).nullable(),
+    error: z.object({
+        code: z.string(),
+        details: z.unknown().nullish(),
+        message: z.string(),
+        rowErrors: z.array(z.object({
+            code: z.string(),
+            message: z.string(),
+            path: z.array(z.union([z.string(), z.number()]))
+        })).nullish()
+    }).nullable(),
+    pagination: z.object({
+        limit: z.int().gte(1).lte(100),
+        page: z.int().gte(1),
+        total: z.int().gte(0),
+        totalPages: z.int().gte(0)
+    }).nullable(),
+    sdkBehavior: z.object({
+        flags: z.record(z.string(), z.unknown()),
+        v: z.int().gte(1)
+    }).nullish(),
+    success: z.boolean()
+});
+
 export const zTracesGetTraceDetailPath = z.object({
     projectId: z.string().min(1),
     traceId: z.string().min(1)

package/src/prompts/resource.ts

@@ -522,9 +522,9 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 	 * Env-aware resolution → neutral `RenderedPrompt`. Carries the resolve /
 	 * offline-fallback logic; `render()` is the public shaping surface.
 	 *
-	 * - **label wire mapping:** the resolve route is label-based
-	 *   (`/v1/projects/:projectId/prompts:resolve`, body `labels[]`); the
-	 *   resolved label is sent as the single resolution label.
+	 * - **wire mapping (TO11-2743):** posts to the path-addressed render route
+	 *   (`/v1/projects/:projectId/prompts/by-slug/:slug/labels/:label/render`),
+	 *   body `{ variables? }`. The resolved label is the single path label.
 	 * - **No silent fallback (R4):** if no label is resolvable (none per call
 	 *   AND no client `env` fallback) this throws `MissingLabelError`
 	 *   CLIENT-side, eagerly, before any transport call.
@@ -557,17 +557,18 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 			);
 		}
 
-		const { subject, variables, fallback } = options;
+		const { variables, fallback } = options;
 
-		// The resolved label is sent as the single resolution label.
-		const body: Record<string, unknown> = { slug, labels: [label] };
-		if (subject !== undefined) body.subject = subject;
+		// TO11-2743: slug + the single resolved label live in the PATH; the body
+		// carries only `variables`. Weighted-release bucketing (`subject`) is not
+		// supported by the render endpoint yet, so it's dropped from the surface.
+		const body: Record<string, unknown> = {};
 		if (variables !== undefined) body.variables = variables;
 
 		try {
 			const envelope = await this.transport.request<ResolvedPromptEnvelope>(
 				"POST",
-				`${getProjectPromptsPath(this.projectId)}:resolve`,
+				`${getProjectPromptsPath(this.projectId)}/by-slug/${encodeURIComponent(slug)}/labels/${encodeURIComponent(label)}/render`,
 				{
 					body,
 					decode: (data) =>

package/src/prompts/types.ts

@@ -236,8 +236,6 @@ export interface RenderOptions {
 	 * When omitted, falls back to the client's `env` (env is a label value).
 	 */
 	label?: string;
-	/** Stable id so a weighted release sends the same caller to the same variant. */
-	subject?: string;
 	variables?: Record<string, unknown>;
 	/** Prompt served if the API is unreachable on a network error. */
 	fallback?: RenderedPrompt;