@to11ai/sdk 1.1.0 → 2.0.0-rc.10

package/dist/prompts/resource.cjs

@@ -42,22 +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 zResolvedPromptLegacy = import_zod2.zResolvedPrompt.pick({
-  promptId: true,
-  versionId: true,
-  version: true,
-  labels: true,
-  contentHash: true,
-  rendered: true,
-  tools: true,
-  toolChoice: true
-});
-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");
@@ -68,12 +57,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),
@@ -83,8 +72,9 @@ function normalizeResolvedEnvelope(raw) {
     promptId: raw.promptId,
     versionId: raw.versionId,
     contentHash: raw.contentHash,
-    labels: raw.labels,
-    rendered: raw.rendered
+    label: raw.label,
+    slug,
+    modelConfig: provenance.modelConfig
   };
   if (raw.tools != null && raw.tools.length > 0) {
     result.tools = raw.tools;
@@ -97,11 +87,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)}`;
@@ -136,22 +126,33 @@ function buildLabelEventsQuery(input) {
 
 class PromptResource {
   transport;
-  cache;
   projectId;
   env;
-  constructor(transport, cacheConfig, config) {
+  format;
+  onUnknownRole;
+  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
@@ -168,146 +169,111 @@ 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 fetch(slug, options = {}) {
+  async render(slug, options = {}) {
+    const rendered = await this.resolveToRendered(slug, options);
+    return import_shape.shapePrompt(rendered, options.format ?? this.format, {
+      onUnknownRole: options.onUnknownRole ?? this.onUnknownRole
+    });
+  }
+  async resolveToRendered(slug, options = {}) {
     if (this.projectId === undefined || this.projectId.trim() === "") {
-      throw new Error("[to11ai/sdk] `prompts.fetch()` requires a `projectId` on the client — pass it to createClient({ projectId, ... }).");
+      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,
-      developerRole
-    } = options;
-    const cacheKey = import_cache.buildFetchCacheKey(this.projectId, slug, env, subject, variables, developerRole);
-    if (useCache) {
-      const cached = this.cache.get(cacheKey);
-      if (cached && "messages" in cached)
-        return structuredClone(cached);
-    }
-    const body = { slug, labels: [env] };
-    if (subject !== undefined)
-      body.subject = subject;
+    const { variables, fallback } = options;
+    const body = {};
     if (variables !== undefined)
       body.variables = variables;
-    if (developerRole !== undefined)
-      body.developerRole = developerRole;
     try {
-      const envelope = await this.transport.request("POST", `${getProjectPromptsPath(this.projectId)}:resolve`, {
+      const envelope = await this.transport.request("POST", `${getProjectPromptsPath(this.projectId)}/by-slug/${encodeURIComponent(slug)}/labels/${encodeURIComponent(label)}/render`, {
         body,
         decode: (data) => zResolvedPromptEnvelope.parse(data)
       });
       const raw = unwrap(envelope);
-      const result = normalizeResolvedEnvelope(raw);
-      const isWeighted = raw.strategy === "weighted" || result.variantName !== undefined;
-      const cacheable = !(isWeighted && subject === undefined);
-      if (useCache && cacheable) {
-        this.cache.set(cacheKey, structuredClone(result));
-      }
-      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;
+      return normalizeResolvedEnvelope(raw, slug);
     } catch (err) {
-      if (err instanceof import_errors.To11aiNetworkError && fallback !== undefined) {
-        return fallback;
+      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;
@@ -319,15 +285,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,29 +1,45 @@
 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, PromptFormat, PromptLabelEvent, PromptLabelPointer, PromptStatus, PromptVersion, RenderedChatMessage, RenderedPrompt, ResolvedPrompt, ResolvedPromptEnvelope, ResolvedToolCall, ResolvedToolDefinition, ResolvePromptInput, ResolvePromptResult, RowError, TextChatMessage, TextChatRole, UpdateProjectPromptLabelInput, UpdateProjectPromptLabelResult, UpdatePromptInput, UpdatePromptResult, } from "./types";
+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 { 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 `fetch()` surface (TO11-980 / S9).
+ * Init-time config for the env-aware `render()` surface (TO11-980 / S9).
  *
  * `projectId` and `env` come from `createClient`. `projectId` is required for
- * `fetch()` (it builds the project-scoped resolve path); `env` is the default
- * serving environment inherited by every `fetch(slug)` call.
+ * `render()` (it builds the project-scoped resolve path); `env` is the default
+ * serving environment inherited by every `render(slug)` call.
  */
 export interface PromptResourceConfig {
-    /** Project the client is bound to. Required for `fetch()`; validated at createClient. */
+    /** Project the client is bound to. Required for `render()`; validated at createClient. */
     projectId?: string;
-    /** Default serving env for `fetch()`. Validated against ENV_SLUG_REGEX at createClient. */
+    /** Default serving env for `render()`. Validated against ENV_SLUG_REGEX at createClient. */
     env?: string;
+    /** Default provider shape for `render()` output. Per-call override allowed. */
+    format?: RenderFormat;
+    /**
+     * Default unknown-role policy for `render({ format })` output conversion.
+     * Per-call override allowed; defaults to `"drop"`.
+     */
+    onUnknownRole?: UnknownRoleMode;
 }
-export declare class PromptResource {
+export declare class PromptResource<F extends RenderFormat | undefined = undefined> {
     private readonly transport;
-    private readonly cache;
     private readonly projectId;
     private readonly env;
-    constructor(transport: Transport, cacheConfig?: CacheConfig, config?: PromptResourceConfig);
+    private readonly format;
+    private readonly onUnknownRole;
+    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>;
@@ -33,35 +49,40 @@ export declare class PromptResource {
     moveLabel(input: MovePromptLabelInput): Promise<MovePromptLabelResult>;
     listLabels(input: ListPromptLabelsInput): Promise<ListPromptLabelsResult>;
     /**
-     * Resolve a prompt for the client's configured `projectId` + `env`
-     * (Style-A). The ergonomic slug-first surface: env is configured once at
-     * `createClient` and inherited here, with an optional per-call override.
-     *
-     * - **env→label wire mapping (correction #3):** the resolve route is
-     *   label-based (`/v1/projects/:projectId/prompts:resolve`, body
-     *   `labels[]`); it does NOT accept a top-level `env` field. The resolved
-     *   env slug (lowercase-kebab — a valid label name) is therefore sent as
-     *   the single resolution label: body `{ slug, labels: [env], subject?,
-     *   variables? }`.
-     * - **No silent fallback (R4):** if no env is resolvable (none at init AND
-     *   none per call) this throws `EnvNotFoundError` (`reason.source =
-     *   "missing"`) 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).
+     * Resolve and (optionally) shape a prompt for the client's configured
+     * `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
+     * `RenderedPrompt`. Resolves by the client's configured `env`.
      *
-     * Prefer this over the deprecated `resolve()`.
+     * @example Render an OpenAI-shaped prompt and send it through the gateway
+     * const prompt = await to11.prompts.render("weather-concierge", {
+     *   variables: { city: "NYC" },
+     * });
+     * const res = await openai.chat.completions.create(
+     *   { ...prompt.config, messages: prompt.messages },
+     *   { headers: to11.turn().headers(prompt) },
+     * );
      */
-    fetch(slug: string, options?: FetchPromptOptions): Promise<FetchedPrompt>;
+    render(slug: string, options: RenderOptions & {
+        format: "openai";
+    }): Promise<OpenAiRenderedPrompt>;
+    render(slug: string, options: RenderOptions & {
+        format: "anthropic";
+    }): Promise<AnthropicRenderedPrompt>;
+    render(slug: string, options?: RenderOptions): Promise<RenderResult<F>>;
     /**
-     * @deprecated Use {@link PromptResource.fetch | `prompts.fetch(slug,
-     * options?)`} instead. `resolve()` is env-agnostic (no `env` / `subject`,
-     * no enriched release/variant provenance, no typed-env errors)
-     * and is retained only for back-compat. It is NOT subject to the R4
-     * no-silent-fallback env gate (it has no env concept). New code should
-     * configure `projectId` + `env` at `createClient` and call `fetch()`.
+     * Env-aware resolution → neutral `RenderedPrompt`. Carries the resolve /
+     * offline-fallback logic; `render()` is the public shaping surface.
+     *
+     * - **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.
      */
-    resolve(input: ResolvePromptInput): Promise<ResolvePromptResult>;
+    private resolveToRendered;
     /**
      * List the project-level label registry.
      *
@@ -69,7 +90,7 @@ export declare class PromptResource {
      * 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.
      *