@to11ai/sdk 2.0.0-rc.2 → 2.0.0-rc.4

package/dist/prompts/resource.cjs

@@ -42,13 +42,11 @@ __export(exports_resource, {
   PromptResource: () => PromptResource
 });
 module.exports = __toCommonJS(exports_resource);
-var import_zod = require("zod");
 var import_errors = require("../errors");
-var import_zod2 = require("../generated/zod.gen");
-var import_cache = require("./cache");
+var import_zod = require("../generated/zod.gen");
 var import_shape = require("./shape");
 var import_types = require("./types");
-var zResolvedPromptEnvelope = import_zod2.zResolvedPrompt.partial({ releaseId: true }).extend({ strategy: import_zod.z.enum(["single", "weighted"]).optional() });
+var zResolvedPromptEnvelope = import_zod.zResolvedPrompt.partial({ releaseId: true });
 function unwrap(envelope) {
   if (envelope.data === null || envelope.data === undefined) {
     throw new Error("API returned success but data is null");
@@ -128,26 +126,33 @@ function buildLabelEventsQuery(input) {
 
 class PromptResource {
   transport;
-  cache;
   projectId;
   env;
   format;
   onUnknownRole;
-  constructor(transport, cacheConfig, config) {
+  constructor(transport, config) {
     this.transport = transport;
-    this.cache = new import_cache.PromptCache(cacheConfig);
     this.projectId = config?.projectId;
     this.env = config?.env;
     this.format = config?.format;
     this.onUnknownRole = config?.onUnknownRole;
   }
+  resolveProjectId(perCall) {
+    const projectId = perCall ?? this.projectId;
+    if (projectId === undefined || projectId.trim() === "") {
+      throw new Error("[to11ai/sdk] this call needs a `projectId` — pass it on the call or bind one via createClient({ projectId, ... }).");
+    }
+    return projectId.trim();
+  }
   async create(input) {
-    const { projectId, ...body } = input;
+    const { projectId: perCallProjectId, ...body } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("POST", getProjectPromptsPath(projectId), { body });
     return unwrap(envelope);
   }
-  async list(input) {
-    const { projectId, ...queryRest } = input;
+  async list(input = {}) {
+    const { projectId: perCallProjectId, ...queryRest } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("GET", getProjectPromptsPath(projectId), {
       query: {
         ...queryRest
@@ -164,42 +169,50 @@ class PromptResource {
     return { items, pagination };
   }
   async get(input) {
-    const { projectId, promptId } = input;
+    const { projectId: perCallProjectId, promptId } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("GET", getProjectPromptPath(projectId, promptId));
     return unwrap(envelope);
   }
   async update(input) {
-    const { projectId, promptId, ...body } = input;
+    const { projectId: perCallProjectId, promptId, ...body } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("PATCH", getProjectPromptPath(projectId, promptId), { body });
     return unwrap(envelope);
   }
   async archive(input) {
-    const { projectId, promptId } = input;
+    const { projectId: perCallProjectId, promptId } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("DELETE", getProjectPromptPath(projectId, promptId));
     return unwrap(envelope);
   }
   async createVersion(input) {
-    const { projectId, promptId, ...body } = input;
+    const { projectId: perCallProjectId, promptId, ...body } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("POST", `${getProjectPromptPath(projectId, promptId)}/versions`, { body });
     return unwrap(envelope);
   }
   async listVersions(input) {
-    const { projectId, promptId } = input;
+    const { projectId: perCallProjectId, promptId } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("GET", `${getProjectPromptPath(projectId, promptId)}/versions`);
     return unwrap(envelope);
   }
   async getVersion(input) {
-    const { projectId, promptId, versionNumber } = input;
+    const { projectId: perCallProjectId, promptId, versionNumber } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("GET", `${getProjectPromptPath(projectId, promptId)}/versions/${encodeURIComponent(String(versionNumber))}`);
     return unwrap(envelope);
   }
   async moveLabel(input) {
-    const { projectId, promptId, label, ...body } = input;
+    const { projectId: perCallProjectId, promptId, label, ...body } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("PUT", `${getProjectPromptPath(projectId, promptId)}/labels/${encodeURIComponent(label)}`, { body });
     return unwrap(envelope);
   }
   async listLabels(input) {
-    const { projectId, promptId } = input;
+    const { projectId: perCallProjectId, promptId } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("GET", `${getProjectPromptPath(projectId, promptId)}/labels`);
     return unwrap(envelope);
   }
@@ -213,21 +226,15 @@ class PromptResource {
     if (this.projectId === undefined || this.projectId.trim() === "") {
       throw new Error("[to11ai/sdk] `prompts.render()` requires a `projectId` on the client — pass it to createClient({ projectId, ... }).");
     }
-    const env = options.env ?? this.env;
-    if (env === undefined) {
-      throw import_errors.EnvNotFoundError.missing();
+    const label = options.label ?? this.env;
+    if (label === undefined) {
+      throw new import_errors.MissingLabelError;
     }
-    if (!import_types.ENV_SLUG_REGEX.test(env)) {
-      throw new Error(`[to11ai/sdk] \`env\` must match ${import_types.ENV_SLUG_REGEX} (lowercase-kebab, 1-63 chars). Received: ${JSON.stringify(env)}`);
+    if (!import_types.ENV_SLUG_REGEX.test(label)) {
+      throw new Error(`[to11ai/sdk] \`label\` must match ${import_types.ENV_SLUG_REGEX} (lowercase-kebab, 1-63 chars). Received: ${JSON.stringify(label)}`);
     }
-    const { subject, variables, cache: useCache = true, fallback } = options;
-    const cacheKey = import_cache.buildRenderCacheKey(this.projectId, slug, env, subject, variables);
-    if (useCache) {
-      const cached = this.cache.get(cacheKey);
-      if (cached)
-        return structuredClone(cached);
-    }
-    const body = { slug, labels: [env] };
+    const { subject, variables, fallback } = options;
+    const body = { slug, labels: [label] };
     if (subject !== undefined)
       body.subject = subject;
     if (variables !== undefined)
@@ -238,38 +245,37 @@ class PromptResource {
         decode: (data) => zResolvedPromptEnvelope.parse(data)
       });
       const raw = unwrap(envelope);
-      const result = normalizeResolvedEnvelope(raw, slug);
-      const isWeighted = raw.strategy === "weighted" || result.variantName !== undefined;
-      const cacheable = !(isWeighted && subject === undefined);
-      if (useCache && cacheable) {
-        this.cache.set(cacheKey, structuredClone(result));
-      }
-      return result;
+      return normalizeResolvedEnvelope(raw, slug);
     } catch (err) {
-      if (err instanceof import_errors.To11aiNetworkError && fallback !== undefined) {
+      const transient = err instanceof import_errors.To11aiNetworkError || err instanceof import_errors.To11aiApiError && err.statusCode >= 500;
+      if (transient && fallback !== undefined) {
         return liftFallbackToRendered(fallback, slug);
       }
       throw err;
     }
   }
-  async listProjectLabels(input) {
-    const { projectId, includeArchived } = input;
+  async listProjectLabels(input = {}) {
+    const { projectId: perCallProjectId, includeArchived } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("GET", getProjectPromptLabelsPath(projectId), {
       query: includeArchived ? { includeArchived: "true" } : undefined
     });
     return unwrap(envelope);
   }
   async createProjectLabel(input) {
-    const { projectId, ...body } = input;
+    const { projectId: perCallProjectId, ...body } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("POST", getProjectPromptLabelsPath(projectId), { body });
     return unwrap(envelope);
   }
   async getProjectLabel(input) {
-    const envelope = await this.transport.request("GET", getProjectPromptLabelPath(input.projectId, input.label));
+    const projectId = this.resolveProjectId(input.projectId);
+    const envelope = await this.transport.request("GET", getProjectPromptLabelPath(projectId, input.label));
     return unwrap(envelope);
   }
   async updateProjectLabel(input) {
-    const { projectId, label, ...rest } = input;
+    const { projectId: perCallProjectId, label, ...rest } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const body = {};
     if (rest.isDefault !== undefined)
       body.isDefault = rest.isDefault;
@@ -281,15 +287,16 @@ class PromptResource {
     return unwrap(envelope);
   }
   async deleteProjectLabel(input) {
-    const envelope = await this.transport.request("DELETE", getProjectPromptLabelPath(input.projectId, input.label));
+    const projectId = this.resolveProjectId(input.projectId);
+    const envelope = await this.transport.request("DELETE", getProjectPromptLabelPath(projectId, input.label));
     return unwrap(envelope);
   }
   async listProjectLabelUsages(input) {
-    const envelope = await this.transport.request("GET", `${getProjectPromptLabelPath(input.projectId, input.label)}/usages`);
+    const envelope = await this.transport.request("GET", `${getProjectPromptLabelPath(this.resolveProjectId(input.projectId), input.label)}/usages`);
     return unwrap(envelope);
   }
   async listLabelEvents(input) {
-    const projectSeg = encodeURIComponent(input.projectId);
+    const projectSeg = encodeURIComponent(this.resolveProjectId(input.projectId));
     let path;
     switch (input.scope) {
       case "label":

package/dist/prompts/resource.d.ts

@@ -1,9 +1,7 @@
 import type { Transport } from "../transport";
-import type { CacheConfig } from "./cache";
 import type { AnthropicRenderedPrompt, OpenAiRenderedPrompt, RenderResult } from "./shape";
 import type { ArchivePromptInput, ArchivePromptResult, CreateProjectPromptLabelInput, CreateProjectPromptLabelResult, CreatePromptInput, CreatePromptResult, CreatePromptVersionInput, CreatePromptVersionResult, DeleteProjectPromptLabelInput, DeleteProjectPromptLabelResult, GetProjectPromptLabelInput, GetProjectPromptLabelResult, GetPromptInput, GetPromptResult, GetPromptVersionInput, GetPromptVersionResult, ListLabelEventsInput, ListLabelEventsResult, ListProjectPromptLabelsInput, ListProjectPromptLabelsResult, ListProjectPromptLabelUsagesInput, ListProjectPromptLabelUsagesResult, ListPromptLabelsInput, ListPromptLabelsResult, ListPromptsInput, ListPromptsResult, ListPromptVersionsInput, ListPromptVersionsResult, MovePromptLabelInput, MovePromptLabelResult, PaginatedResult, RenderFormat, RenderOptions, UnknownRoleMode, 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, 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, RenderFormat, RenderOptions, ResolvedPrompt, ResolvedPromptEnvelope, ResolvedToolCall, ResolvedToolDefinition, RowError, TextChatMessage, TextChatRole, UnknownRoleMode, UpdateProjectPromptLabelInput, UpdateProjectPromptLabelResult, UpdatePromptInput, UpdatePromptResult, } from "./types";
+export type { ArchivePromptInput, ArchivePromptResult, BlockRenderRecord, ChatMessage, ChatRole, CreateProjectPromptLabelInput, CreateProjectPromptLabelResult, CreatePromptInput, CreatePromptResult, CreatePromptVersionInput, CreatePromptVersionResult, DeleteProjectPromptLabelInput, DeleteProjectPromptLabelResult, 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, RenderFormat, RenderOptions, ResolvedPrompt, ResolvedPromptEnvelope, ResolvedToolCall, ResolvedToolDefinition, RowError, UnknownRoleMode, UpdateProjectPromptLabelInput, UpdateProjectPromptLabelResult, UpdatePromptInput, UpdatePromptResult, } from "./types";
 /**
  * Init-time config for the env-aware `render()` surface (TO11-980 / S9).
  *
@@ -26,16 +24,22 @@ export interface PromptResourceConfig {
 }
 export declare class PromptResource<F extends RenderFormat | undefined = undefined> {
     private readonly transport;
-    private readonly cache;
     private readonly projectId;
     private readonly env;
     private readonly format;
     private readonly onUnknownRole;
-    constructor(transport: Transport, cacheConfig?: CacheConfig, config?: Omit<PromptResourceConfig, "format"> & {
+    constructor(transport: Transport, config?: Omit<PromptResourceConfig, "format"> & {
         format?: F;
     });
+    /**
+     * Resolve the project for a control-plane call: the per-call `projectId`
+     * wins, else the client-bound one from `createClient({ projectId })`. Throws
+     * if neither is set. Mirrors how `render()` resolves its project, so every
+     * method honors the bound `projectId` and callers need not repeat it.
+     */
+    private resolveProjectId;
     create(input: CreatePromptInput): Promise<CreatePromptResult>;
-    list(input: ListPromptsInput): Promise<PaginatedResult<ListPromptsResult>>;
+    list(input?: ListPromptsInput): Promise<PaginatedResult<ListPromptsResult>>;
     get(input: GetPromptInput): Promise<GetPromptResult>;
     update(input: UpdatePromptInput): Promise<UpdatePromptResult>;
     archive(input: ArchivePromptInput): Promise<ArchivePromptResult>;
@@ -69,17 +73,14 @@ export declare class PromptResource<F extends RenderFormat | undefined = undefin
     render(slug: string, options?: RenderOptions): Promise<RenderResult<F>>;
     /**
      * Env-aware resolution → neutral `RenderedPrompt`. Carries the resolve /
-     * cache / offline-fallback logic; `render()` is the public shaping surface.
+     * offline-fallback logic; `render()` is the public shaping surface.
      *
-     * - **env→label wire mapping:** the resolve route is label-based
+     * - **label wire mapping:** the resolve route is label-based
      *   (`/v1/projects/:projectId/prompts:resolve`, body `labels[]`); the
-     *   resolved env slug is sent as the single resolution label.
-     * - **No silent fallback (R4):** if no env is resolvable (none at init AND
-     *   none per call) this throws `EnvNotFoundError` CLIENT-side, eagerly,
-     *   before any transport call.
-     * - **Cache (D8):** caches `single`-strategy releases and weighted releases
-     *   WITH a `subject`; BYPASSES the cache for weighted releases with NO
-     *   `subject` (a uniform-random assignment must not be pinned for the TTL).
+     *   resolved label is sent as the single resolution 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.
      */
     private resolveToRendered;
     /**
@@ -89,7 +90,7 @@ export declare class PromptResource<F extends RenderFormat | undefined = undefin
      * include rows with a non-null `archivedAt` (useful for admin / history
      * affordances). Gated on `prompt:read` server-side.
      */
-    listProjectLabels(input: ListProjectPromptLabelsInput): Promise<ListProjectPromptLabelsResult>;
+    listProjectLabels(input?: ListProjectPromptLabelsInput): Promise<ListProjectPromptLabelsResult>;
     /**
      * Create a new project label.
      *

package/dist/prompts/resource.js

@@ -1,11 +1,13 @@
 // src/prompts/resource.ts
-import { z } from "zod";
-import { EnvNotFoundError, To11aiNetworkError } from "../errors";
+import {
+  MissingLabelError,
+  To11aiApiError,
+  To11aiNetworkError
+} from "../errors";
 import { zResolvedPrompt } from "../generated/zod.gen";
-import { buildRenderCacheKey, PromptCache } from "./cache";
 import { shapePrompt } from "./shape";
 import { ENV_SLUG_REGEX } from "./types";
-var zResolvedPromptEnvelope = zResolvedPrompt.partial({ releaseId: true }).extend({ strategy: z.enum(["single", "weighted"]).optional() });
+var zResolvedPromptEnvelope = zResolvedPrompt.partial({ releaseId: true });
 function unwrap(envelope) {
   if (envelope.data === null || envelope.data === undefined) {
     throw new Error("API returned success but data is null");
@@ -85,26 +87,33 @@ function buildLabelEventsQuery(input) {
 
 class PromptResource {
   transport;
-  cache;
   projectId;
   env;
   format;
   onUnknownRole;
-  constructor(transport, cacheConfig, config) {
+  constructor(transport, config) {
     this.transport = transport;
-    this.cache = new PromptCache(cacheConfig);
     this.projectId = config?.projectId;
     this.env = config?.env;
     this.format = config?.format;
     this.onUnknownRole = config?.onUnknownRole;
   }
+  resolveProjectId(perCall) {
+    const projectId = perCall ?? this.projectId;
+    if (projectId === undefined || projectId.trim() === "") {
+      throw new Error("[to11ai/sdk] this call needs a `projectId` — pass it on the call or bind one via createClient({ projectId, ... }).");
+    }
+    return projectId.trim();
+  }
   async create(input) {
-    const { projectId, ...body } = input;
+    const { projectId: perCallProjectId, ...body } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("POST", getProjectPromptsPath(projectId), { body });
     return unwrap(envelope);
   }
-  async list(input) {
-    const { projectId, ...queryRest } = input;
+  async list(input = {}) {
+    const { projectId: perCallProjectId, ...queryRest } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("GET", getProjectPromptsPath(projectId), {
       query: {
         ...queryRest
@@ -121,42 +130,50 @@ class PromptResource {
     return { items, pagination };
   }
   async get(input) {
-    const { projectId, promptId } = input;
+    const { projectId: perCallProjectId, promptId } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("GET", getProjectPromptPath(projectId, promptId));
     return unwrap(envelope);
   }
   async update(input) {
-    const { projectId, promptId, ...body } = input;
+    const { projectId: perCallProjectId, promptId, ...body } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("PATCH", getProjectPromptPath(projectId, promptId), { body });
     return unwrap(envelope);
   }
   async archive(input) {
-    const { projectId, promptId } = input;
+    const { projectId: perCallProjectId, promptId } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("DELETE", getProjectPromptPath(projectId, promptId));
     return unwrap(envelope);
   }
   async createVersion(input) {
-    const { projectId, promptId, ...body } = input;
+    const { projectId: perCallProjectId, promptId, ...body } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("POST", `${getProjectPromptPath(projectId, promptId)}/versions`, { body });
     return unwrap(envelope);
   }
   async listVersions(input) {
-    const { projectId, promptId } = input;
+    const { projectId: perCallProjectId, promptId } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("GET", `${getProjectPromptPath(projectId, promptId)}/versions`);
     return unwrap(envelope);
   }
   async getVersion(input) {
-    const { projectId, promptId, versionNumber } = input;
+    const { projectId: perCallProjectId, promptId, versionNumber } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("GET", `${getProjectPromptPath(projectId, promptId)}/versions/${encodeURIComponent(String(versionNumber))}`);
     return unwrap(envelope);
   }
   async moveLabel(input) {
-    const { projectId, promptId, label, ...body } = input;
+    const { projectId: perCallProjectId, promptId, label, ...body } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("PUT", `${getProjectPromptPath(projectId, promptId)}/labels/${encodeURIComponent(label)}`, { body });
     return unwrap(envelope);
   }
   async listLabels(input) {
-    const { projectId, promptId } = input;
+    const { projectId: perCallProjectId, promptId } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("GET", `${getProjectPromptPath(projectId, promptId)}/labels`);
     return unwrap(envelope);
   }
@@ -170,21 +187,15 @@ class PromptResource {
     if (this.projectId === undefined || this.projectId.trim() === "") {
       throw new Error("[to11ai/sdk] `prompts.render()` requires a `projectId` on the client — pass it to createClient({ projectId, ... }).");
     }
-    const env = options.env ?? this.env;
-    if (env === undefined) {
-      throw EnvNotFoundError.missing();
+    const label = options.label ?? this.env;
+    if (label === undefined) {
+      throw new MissingLabelError;
     }
-    if (!ENV_SLUG_REGEX.test(env)) {
-      throw new Error(`[to11ai/sdk] \`env\` must match ${ENV_SLUG_REGEX} (lowercase-kebab, 1-63 chars). Received: ${JSON.stringify(env)}`);
+    if (!ENV_SLUG_REGEX.test(label)) {
+      throw new Error(`[to11ai/sdk] \`label\` must match ${ENV_SLUG_REGEX} (lowercase-kebab, 1-63 chars). Received: ${JSON.stringify(label)}`);
     }
-    const { subject, variables, cache: useCache = true, fallback } = options;
-    const cacheKey = buildRenderCacheKey(this.projectId, slug, env, subject, variables);
-    if (useCache) {
-      const cached = this.cache.get(cacheKey);
-      if (cached)
-        return structuredClone(cached);
-    }
-    const body = { slug, labels: [env] };
+    const { subject, variables, fallback } = options;
+    const body = { slug, labels: [label] };
     if (subject !== undefined)
       body.subject = subject;
     if (variables !== undefined)
@@ -195,38 +206,37 @@ class PromptResource {
         decode: (data) => zResolvedPromptEnvelope.parse(data)
       });
       const raw = unwrap(envelope);
-      const result = normalizeResolvedEnvelope(raw, slug);
-      const isWeighted = raw.strategy === "weighted" || result.variantName !== undefined;
-      const cacheable = !(isWeighted && subject === undefined);
-      if (useCache && cacheable) {
-        this.cache.set(cacheKey, structuredClone(result));
-      }
-      return result;
+      return normalizeResolvedEnvelope(raw, slug);
     } catch (err) {
-      if (err instanceof To11aiNetworkError && fallback !== undefined) {
+      const transient = err instanceof To11aiNetworkError || err instanceof To11aiApiError && err.statusCode >= 500;
+      if (transient && fallback !== undefined) {
         return liftFallbackToRendered(fallback, slug);
       }
       throw err;
     }
   }
-  async listProjectLabels(input) {
-    const { projectId, includeArchived } = input;
+  async listProjectLabels(input = {}) {
+    const { projectId: perCallProjectId, includeArchived } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("GET", getProjectPromptLabelsPath(projectId), {
       query: includeArchived ? { includeArchived: "true" } : undefined
     });
     return unwrap(envelope);
   }
   async createProjectLabel(input) {
-    const { projectId, ...body } = input;
+    const { projectId: perCallProjectId, ...body } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const envelope = await this.transport.request("POST", getProjectPromptLabelsPath(projectId), { body });
     return unwrap(envelope);
   }
   async getProjectLabel(input) {
-    const envelope = await this.transport.request("GET", getProjectPromptLabelPath(input.projectId, input.label));
+    const projectId = this.resolveProjectId(input.projectId);
+    const envelope = await this.transport.request("GET", getProjectPromptLabelPath(projectId, input.label));
     return unwrap(envelope);
   }
   async updateProjectLabel(input) {
-    const { projectId, label, ...rest } = input;
+    const { projectId: perCallProjectId, label, ...rest } = input;
+    const projectId = this.resolveProjectId(perCallProjectId);
     const body = {};
     if (rest.isDefault !== undefined)
       body.isDefault = rest.isDefault;
@@ -238,15 +248,16 @@ class PromptResource {
     return unwrap(envelope);
   }
   async deleteProjectLabel(input) {
-    const envelope = await this.transport.request("DELETE", getProjectPromptLabelPath(input.projectId, input.label));
+    const projectId = this.resolveProjectId(input.projectId);
+    const envelope = await this.transport.request("DELETE", getProjectPromptLabelPath(projectId, input.label));
     return unwrap(envelope);
   }
   async listProjectLabelUsages(input) {
-    const envelope = await this.transport.request("GET", `${getProjectPromptLabelPath(input.projectId, input.label)}/usages`);
+    const envelope = await this.transport.request("GET", `${getProjectPromptLabelPath(this.resolveProjectId(input.projectId), input.label)}/usages`);
     return unwrap(envelope);
   }
   async listLabelEvents(input) {
-    const projectSeg = encodeURIComponent(input.projectId);
+    const projectSeg = encodeURIComponent(this.resolveProjectId(input.projectId));
     let path;
     switch (input.scope) {
       case "label":

package/dist/prompts/shape.d.ts

@@ -52,5 +52,5 @@ export interface AnthropicRenderedPrompt {
 export type RenderResult<F extends RenderFormat | undefined> = F extends "openai" ? OpenAiRenderedPrompt : F extends "anthropic" ? AnthropicRenderedPrompt : RenderedPrompt;
 export declare function shapeOpenAI(prompt: RenderedPrompt, options?: ConvertMessagesOptions): OpenAiRenderedPrompt;
 export declare function shapeAnthropic(prompt: RenderedPrompt, options?: ConvertMessagesOptions): AnthropicRenderedPrompt;
-/** Shape a fetched prompt for `format`, or return it neutral when unset. */
+/** Shape a rendered prompt for `format`, or return it neutral when unset. */
 export declare function shapePrompt(prompt: RenderedPrompt, format: RenderFormat | undefined, options?: ConvertMessagesOptions): RenderedPrompt | OpenAiRenderedPrompt | AnthropicRenderedPrompt;