@to11ai/sdk 2.0.0-rc.1 → 2.0.0-rc.3

package/dist/client.cjs

@@ -108,7 +108,7 @@ function createClient(options = {}) {
   const getAccessToken = options.getAccessToken;
   const apiKey = getAccessToken !== undefined ? options.apiKey : pick(options.apiKey, "TO11_API_KEY");
   const projectId = pick(options.projectId, "TO11_PROJECT_ID");
-  const env = options.env;
+  const env = pick(options.env, "TO11_ENV");
   const providerApiKey = options.providerApiKey?.trim() || undefined;
   if (isBrowser && options.apiKey !== undefined) {
     throw new Error("[to11ai/sdk] Do not use `apiKey` in browser contexts — use `getAccessToken` instead.");
@@ -119,6 +119,9 @@ function createClient(options = {}) {
   if (options.projectId !== undefined && options.projectId.trim() === "") {
     throw new Error("[to11ai/sdk] `projectId` must not be an empty string — omit it or pass a valid project id.");
   }
+  if (options.env !== undefined && options.env.trim() === "") {
+    throw new Error("[to11ai/sdk] `env` must not be an empty string — omit it or pass a valid env slug.");
+  }
   if (env !== undefined && !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)}`);
   }
@@ -191,6 +194,7 @@ function createClient(options = {}) {
     resolveBehavior: (key, codedDefault) => behaviorStore.resolve(key, codedDefault),
     apiKey,
     gatewayUrl,
+    projectId,
     session: (id) => new import_context.Session(gatewayAuthContext(), id),
     conversation: (id) => clientDefaultSession().conversation(id),
     turn: () => clientDefaultSession().turn(),

package/dist/client.d.ts

@@ -17,7 +17,7 @@ export type { CacheConfig } from "./prompts/cache";
 export type { PromptResourceConfig } from "./prompts/resource";
 export { PromptResource } from "./prompts/resource";
 export type { AnthropicRenderedPrompt, OpenAiRenderedPrompt, PromptConfig, PromptMetadata, RenderResult, } from "./prompts/shape";
-export type { BlockRenderRecord, FetchedPrompt, FetchPromptOptions, RenderedChatMessage, RenderedPrompt, RenderFormat, RenderOptions, ResolvedPrompt, ResolvedPromptEnvelope, UnknownRoleMode, } from "./prompts/types";
+export type { BlockRenderRecord, RenderedChatMessage, RenderedPrompt, RenderFormat, RenderOptions, ResolvedPrompt, ResolvedPromptEnvelope, UnknownRoleMode, } from "./prompts/types";
 export { ENV_SLUG_REGEX } from "./prompts/types";
 export type { CreateRuleVersionInput, CreateRuleVersionResult, GetRuleVersionInput, GetRuleVersionResult, ListRuleReleasesInput, ListRuleReleasesResult, ListRuleVersionsInput, ListRuleVersionsResult, RollbackRuleReleaseInput, RollbackRuleReleaseResult, RuleModelBinding, RuleProviderRef, RuleRelease, RuleReleaseActorType, RuleReleaseApprovalStatus, RuleReleaseChangeKind, RuleReleaseStrategy, RuleReleaseWeight, RuleSnapshot, RuleStrategy, RuleVersion, SetRuleReleaseInput, SetRuleReleaseResult, } from "./routingRules/resource";
 export { RoutingRuleReleaseResource, RoutingRulesResource, RoutingRuleVersionResource, } from "./routingRules/resource";
@@ -57,8 +57,9 @@ export interface ClientOptions {
     projectId?: string;
     /**
      * Default serving environment for `prompts.render(slug)`, inherited by every
-     * render unless overridden per call. Validated eagerly against the
-     * project-environments slug rule (`^[a-z0-9-]{1,63}$`).
+     * render unless overridden per call. Precedence: this option → `TO11_ENV`
+     * env. Validated eagerly against the project-environments slug rule
+     * (`^[a-z0-9-]{1,63}$`).
      */
     env?: string;
     /**
@@ -126,6 +127,12 @@ export interface To11aiClient<F extends RenderFormat | undefined = undefined> {
     readonly apiKey: string | undefined;
     /** Resolved data-plane gateway URL (option → `TO11_GATEWAY_URL` → default). */
     readonly gatewayUrl: string;
+    /**
+     * Resolved project id (option → `TO11_PROJECT_ID`); `undefined` when none is
+     * configured. Read-only, for your own logging / manual headers — `prompts.*`
+     * already default to it, so you don't need to pass it back into calls.
+     */
+    readonly projectId: string | undefined;
     /** A new session (unit of work). Pass an id to group telemetry by your own id. */
     session(id?: string): Session;
     /**

package/dist/client.js

@@ -64,7 +64,7 @@ function createClient(options = {}) {
   const getAccessToken = options.getAccessToken;
   const apiKey = getAccessToken !== undefined ? options.apiKey : pick(options.apiKey, "TO11_API_KEY");
   const projectId = pick(options.projectId, "TO11_PROJECT_ID");
-  const env = options.env;
+  const env = pick(options.env, "TO11_ENV");
   const providerApiKey = options.providerApiKey?.trim() || undefined;
   if (isBrowser && options.apiKey !== undefined) {
     throw new Error("[to11ai/sdk] Do not use `apiKey` in browser contexts — use `getAccessToken` instead.");
@@ -75,6 +75,9 @@ function createClient(options = {}) {
   if (options.projectId !== undefined && options.projectId.trim() === "") {
     throw new Error("[to11ai/sdk] `projectId` must not be an empty string — omit it or pass a valid project id.");
   }
+  if (options.env !== undefined && options.env.trim() === "") {
+    throw new Error("[to11ai/sdk] `env` must not be an empty string — omit it or pass a valid env slug.");
+  }
   if (env !== undefined && !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)}`);
   }
@@ -147,6 +150,7 @@ function createClient(options = {}) {
     resolveBehavior: (key, codedDefault) => behaviorStore.resolve(key, codedDefault),
     apiKey,
     gatewayUrl,
+    projectId,
     session: (id) => new Session(gatewayAuthContext(), id),
     conversation: (id) => clientDefaultSession().conversation(id),
     turn: () => clientDefaultSession().turn(),

package/dist/context.d.ts

@@ -17,7 +17,7 @@ export interface TurnAuthContext {
 }
 /**
  * A prompt argument accepted by `turn.headers()`. Either the flat provenance
- * (a neutral `FetchedPrompt`) or a `format`-shaped result carrying it under
+ * (a neutral `RenderedPrompt`) or a `format`-shaped result carrying it under
  * `metadata` — both are accepted so the format and neutral render paths carry
  * provenance identically.
  */

package/dist/gateway.cjs

@@ -88,6 +88,9 @@ function gatewayPromptHeaders(prompt) {
   if (prompt.label.length > 0) {
     headers["x-to11-prompt-label"] = prompt.label;
   }
+  if (typeof prompt.slug === "string" && prompt.slug.length > 0) {
+    headers["x-to11-prompt-slug"] = prompt.slug;
+  }
   return headers;
 }
 function toOpenAITools(tools) {

package/dist/gateway.d.ts

@@ -42,6 +42,9 @@ export declare function gatewayAuthHeaders(options: GatewayAuthOptions): Record<
  *     release was weighted); omitted for `single`-strategy releases.
  *   - `x-to11-prompt-label` — the single label the prompt resolved through (the
  *     env slug today); omitted when empty (the gateway rejects empty values).
+ *   - `x-to11-prompt-slug` — the prompt's human-readable slug, so traces show a
+ *     readable name alongside the opaque `x-to11-prompt-id`; omitted when empty
+ *     or absent (a legacy `resolve()` result carries no slug).
  *
  * The parameter type is WIDENED to accept either the enriched `render()`
  * result or the legacy `ResolvedPrompt`. The new fields are read when present
@@ -57,6 +60,11 @@ export interface GatewayPromptProvenance {
     version: number;
     /** The single label the prompt resolved through (env slug today). */
     label: string;
+    /**
+     * The prompt's human-readable slug (the `render()`/`resolve()` input). Present
+     * on an enriched `render()` result; a legacy `ResolvedPrompt` omits it.
+     */
+    slug?: string;
     /** Present on an enriched result; a legacy `resolve()` result omits it. */
     releaseId?: string | null;
     /** Present IFF the resolved release was weighted. */

package/dist/gateway.js

@@ -39,6 +39,9 @@ function gatewayPromptHeaders(prompt) {
   if (prompt.label.length > 0) {
     headers["x-to11-prompt-label"] = prompt.label;
   }
+  if (typeof prompt.slug === "string" && prompt.slug.length > 0) {
+    headers["x-to11-prompt-slug"] = prompt.slug;
+  }
   return headers;
 }
 function toOpenAITools(tools) {

package/dist/prompts/cache.d.ts

@@ -1,4 +1,4 @@
-import type { FetchedPrompt, ResolvedPrompt } from "./types";
+import type { RenderedPrompt } from "./types";
 export interface CacheConfig {
     /** Time-to-live in seconds. Default: 300 (5 minutes) */
     ttlSeconds?: number;
@@ -6,12 +6,11 @@ export interface CacheConfig {
     maxEntries?: number;
 }
 /**
- * The cache stores either a legacy `resolve()` result or an enriched
- * `render()` result. Both are JSON-cloneable; the cache is shape-agnostic.
+ * The cache stores enriched `render()` results, which are JSON-cloneable.
  */
-export type CacheableResolved = ResolvedPrompt | FetchedPrompt;
+export type CacheableRendered = RenderedPrompt;
 /**
- * Build a canonical cache key for a resolve() call.
+ * Build a canonical base cache key from project/slug/labels/variables.
  *
  * - projectId is included to prevent cross-project cache collisions: a single
  *   PromptResource can serve multiple projects, so the same slug+labels must
@@ -38,9 +37,9 @@ export declare function buildCacheKey(projectId: string, slug: string, labels: s
  * caches as the same deterministic variant on repeat (D8); the
  * weighted-no-subject bypass is handled in the resource, not here.
  */
-export declare function buildFetchCacheKey(projectId: string, slug: string, env: string, subject?: string, variables?: Record<string, unknown>): string;
+export declare function buildRenderCacheKey(projectId: string, slug: string, env: string, subject?: string, variables?: Record<string, unknown>): string;
 /**
- * In-memory LRU cache for ResolvedPrompt objects.
+ * In-memory LRU cache for RenderedPrompt objects.
  *
  * Uses a Map (insertion-ordered) as the backing store. On every access, the
  * entry is deleted and re-inserted to maintain LRU order — oldest entries sit
@@ -51,8 +50,8 @@ export declare class PromptCache {
     private readonly maxEntries;
     private readonly store;
     constructor(config?: CacheConfig);
-    get(key: string): CacheableResolved | undefined;
-    set(key: string, value: CacheableResolved): void;
+    get(key: string): CacheableRendered | undefined;
+    set(key: string, value: CacheableRendered): void;
     delete(key: string): void;
     clear(): void;
     get size(): number;

package/dist/prompts/resource.cjs

@@ -48,17 +48,6 @@ var import_zod2 = require("../generated/zod.gen");
 var import_cache = require("./cache");
 var import_shape = require("./shape");
 var import_types = require("./types");
-var zResolvedPromptLegacy = import_zod2.zResolvedPrompt.pick({
-  promptId: true,
-  versionId: true,
-  version: true,
-  label: true,
-  contentHash: true,
-  rendered: true,
-  tools: true,
-  toolChoice: true,
-  modelConfig: true
-});
 var zResolvedPromptEnvelope = import_zod2.zResolvedPrompt.partial({ releaseId: true }).extend({ strategy: import_zod.z.enum(["single", "weighted"]).optional() });
 function unwrap(envelope) {
   if (envelope.data === null || envelope.data === undefined) {
@@ -70,12 +59,12 @@ function getProjectPromptsPath(projectId) {
   return `/v1/projects/${encodeURIComponent(projectId)}/prompts`;
 }
 function renderedToMessages(rendered) {
-  if (rendered.format === "chat") {
-    return rendered.messages;
+  if (rendered.format !== "chat") {
+    throw new Error("[to11ai/sdk] Unsupported non-chat prompt format; author the prompt as chat blocks.");
   }
-  return [{ role: "user", content: rendered.text }];
+  return rendered.messages;
 }
-function normalizeResolvedEnvelope(raw) {
+function normalizeResolvedEnvelope(raw, slug) {
   const provenance = raw;
   const result = {
     messages: renderedToMessages(raw.rendered),
@@ -86,7 +75,7 @@ function normalizeResolvedEnvelope(raw) {
     versionId: raw.versionId,
     contentHash: raw.contentHash,
     label: raw.label,
-    rendered: raw.rendered,
+    slug,
     modelConfig: provenance.modelConfig
   };
   if (raw.tools != null && raw.tools.length > 0) {
@@ -100,11 +89,11 @@ function normalizeResolvedEnvelope(raw) {
   }
   return result;
 }
-function liftFallbackToFetched(fallback) {
-  if ("messages" in fallback) {
-    return structuredClone(fallback);
+function liftFallbackToRendered(fallback, slug) {
+  if (!Array.isArray(fallback.messages)) {
+    throw new Error("[to11ai/sdk] `fallback` must be a RenderedPrompt (as returned by render()); the legacy resolve() shape is no longer supported.");
   }
-  return normalizeResolvedEnvelope(fallback);
+  return { ...structuredClone(fallback), slug: fallback.slug || slug };
 }
 function getProjectPromptPath(projectId, promptId) {
   return `${getProjectPromptsPath(projectId)}/${encodeURIComponent(promptId)}`;
@@ -152,13 +141,22 @@ class PromptResource {
     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
@@ -175,52 +173,60 @@ 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);
   }
   async render(slug, options = {}) {
-    const fetched = await this.resolveToFetched(slug, options);
-    return import_shape.shapePrompt(fetched, options.format ?? this.format, {
+    const rendered = await this.resolveToRendered(slug, options);
+    return import_shape.shapePrompt(rendered, options.format ?? this.format, {
       onUnknownRole: options.onUnknownRole ?? this.onUnknownRole
     });
   }
-  async resolveToFetched(slug, options = {}) {
+  async resolveToRendered(slug, options = {}) {
     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, ... }).");
     }
@@ -232,10 +238,10 @@ class PromptResource {
       throw new Error(`[to11ai/sdk] \`env\` must match ${import_types.ENV_SLUG_REGEX} (lowercase-kebab, 1-63 chars). Received: ${JSON.stringify(env)}`);
     }
     const { subject, variables, cache: useCache = true, fallback } = options;
-    const cacheKey = import_cache.buildFetchCacheKey(this.projectId, slug, env, subject, variables);
+    const cacheKey = import_cache.buildRenderCacheKey(this.projectId, slug, env, subject, variables);
     if (useCache) {
       const cached = this.cache.get(cacheKey);
-      if (cached && "messages" in cached)
+      if (cached)
         return structuredClone(cached);
     }
     const body = { slug, labels: [env] };
@@ -249,7 +255,7 @@ class PromptResource {
         decode: (data) => zResolvedPromptEnvelope.parse(data)
       });
       const raw = unwrap(envelope);
-      const result = normalizeResolvedEnvelope(raw);
+      const result = normalizeResolvedEnvelope(raw, slug);
       const isWeighted = raw.strategy === "weighted" || result.variantName !== undefined;
       const cacheable = !(isWeighted && subject === undefined);
       if (useCache && cacheable) {
@@ -258,61 +264,33 @@ class PromptResource {
       return result;
     } catch (err) {
       if (err instanceof import_errors.To11aiNetworkError && fallback !== undefined) {
-        return liftFallbackToFetched(fallback);
-      }
-      throw err;
-    }
-  }
-  async resolve(input) {
-    const {
-      projectId,
-      slug,
-      labels,
-      variables,
-      cache: useCache = true,
-      fallback
-    } = input;
-    const cacheKey = import_cache.buildCacheKey(projectId, slug, labels, variables);
-    if (useCache) {
-      const cached = this.cache.get(cacheKey);
-      if (cached && !("messages" in cached))
-        return structuredClone(cached);
-    }
-    try {
-      const envelope = await this.transport.request("POST", `${getProjectPromptsPath(projectId)}:resolve`, {
-        body: { slug, labels, variables },
-        decode: (data) => zResolvedPromptLegacy.parse(data)
-      });
-      const result = unwrap(envelope);
-      if (useCache) {
-        this.cache.set(cacheKey, structuredClone(result));
-      }
-      return result;
-    } catch (err) {
-      if (err instanceof import_errors.To11aiNetworkError && fallback !== undefined) {
-        return fallback;
+        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;
@@ -324,15 +302,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,9 @@
 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, ResolvePromptInput, ResolvePromptResult, UnknownRoleMode, UpdateProjectPromptLabelInput, UpdateProjectPromptLabelResult, UpdatePromptInput, UpdatePromptResult } from "./types";
+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, FetchedPrompt, FetchPromptOptions, GetProjectPromptLabelInput, GetProjectPromptLabelResult, GetPromptInput, GetPromptResult, GetPromptVersionInput, GetPromptVersionResult, ListLabelEventsInput, ListLabelEventsResult, ListProjectPromptLabelsInput, ListProjectPromptLabelsResult, ListProjectPromptLabelUsagesInput, ListProjectPromptLabelUsagesResult, ListPromptLabelsInput, ListPromptLabelsResult, ListPromptsInput, ListPromptsResult, ListPromptVersionsInput, ListPromptVersionsResult, MovePromptLabelInput, MovePromptLabelResult, PaginatedResult, PaginationInfo, PaletteToken, ProjectPromptLabel, ProjectPromptLabelUsage, Prompt, PromptFormat, PromptLabelEvent, PromptLabelPointer, PromptStatus, PromptVersion, RenderedChatMessage, RenderedPrompt, ResolvedPrompt, ResolvedPromptEnvelope, ResolvedToolCall, ResolvedToolDefinition, ResolvePromptInput, ResolvePromptResult, RowError, TextChatMessage, TextChatRole, UpdateProjectPromptLabelInput, UpdateProjectPromptLabelResult, UpdatePromptInput, UpdatePromptResult, } from "./types";
+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";
 /**
  * Init-time config for the env-aware `render()` surface (TO11-980 / S9).
  *
@@ -34,8 +34,15 @@ export declare class PromptResource<F extends RenderFormat | undefined = undefin
     constructor(transport: Transport, cacheConfig?: CacheConfig, 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>;
@@ -49,8 +56,7 @@ export declare class PromptResource<F extends RenderFormat | undefined = undefin
      * `projectId` + `env`, in one control-plane request. With a `format` (per
      * call or inherited from the client) the result is provider-shaped
      * `{ messages, config, metadata }`; without one it is the neutral
-     * `FetchedPrompt`. Resolves by the client's `env`; for label-addressed
-     * resolution see {@link PromptResource.resolve | `resolve()`}.
+     * `RenderedPrompt`. Resolves by the client's configured `env`.
      *
      * @example Render an OpenAI-shaped prompt and send it through the gateway
      * const prompt = await to11.prompts.render("weather-concierge", {
@@ -69,7 +75,7 @@ export declare class PromptResource<F extends RenderFormat | undefined = undefin
     }): Promise<AnthropicRenderedPrompt>;
     render(slug: string, options?: RenderOptions): Promise<RenderResult<F>>;
     /**
-     * Env-aware resolution → neutral `FetchedPrompt`. Carries the resolve /
+     * Env-aware resolution → neutral `RenderedPrompt`. Carries the resolve /
      * cache / offline-fallback logic; `render()` is the public shaping surface.
      *
      * - **env→label wire mapping:** the resolve route is label-based
@@ -82,17 +88,7 @@ export declare class PromptResource<F extends RenderFormat | undefined = undefin
      *   WITH a `subject`; BYPASSES the cache for weighted releases with NO
      *   `subject` (a uniform-random assignment must not be pinned for the TTL).
      */
-    private resolveToFetched;
-    /**
-     * Resolve a prompt by explicit `labels` for a given `projectId`, in one
-     * control-plane request. This is the label-addressed counterpart to
-     * {@link PromptResource.render | `render()`}, which resolves by the client's
-     * configured `env`. Reach for `resolve()` when you address prompts by label
-     * rather than by environment; it is env-agnostic, so it carries no `env` /
-     * `subject`, no enriched release/variant provenance, and no typed-env errors,
-     * and is not subject to the env-based no-silent-fallback gate.
-     */
-    resolve(input: ResolvePromptInput): Promise<ResolvePromptResult>;
+    private resolveToRendered;
     /**
      * List the project-level label registry.
      *
@@ -100,7 +96,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.
      *