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

package/dist/client.cjs

@@ -194,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

@@ -127,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

@@ -150,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/prompts/resource.cjs

@@ -141,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
@@ -164,42 +173,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);
   }
@@ -252,24 +269,28 @@ class PromptResource {
       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 +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

@@ -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>;
@@ -89,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.
      *

package/dist/prompts/resource.js

@@ -98,13 +98,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
@@ -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);
   }
@@ -209,24 +226,28 @@ class PromptResource {
       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 +259,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/types.d.ts

@@ -50,7 +50,7 @@ export interface PaginatedResult<T> {
     pagination: PaginationInfo;
 }
 export interface CreatePromptInput {
-    projectId: string;
+    projectId?: string;
     name: string;
     slug: string;
     description?: string;
@@ -58,7 +58,7 @@ export interface CreatePromptInput {
 }
 export type CreatePromptResult = Prompt;
 export interface ListPromptsInput {
-    projectId: string;
+    projectId?: string;
     status?: PromptStatus;
     sortBy?: "createdAt" | "updatedAt" | "name";
     tags?: string;
@@ -67,12 +67,12 @@ export interface ListPromptsInput {
 }
 export type ListPromptsResult = Prompt;
 export interface GetPromptInput {
-    projectId: string;
+    projectId?: string;
     promptId: string;
 }
 export type GetPromptResult = Prompt;
 export interface UpdatePromptInput {
-    projectId: string;
+    projectId?: string;
     promptId: string;
     name?: string;
     description?: string | null;
@@ -80,12 +80,12 @@ export interface UpdatePromptInput {
 }
 export type UpdatePromptResult = Prompt;
 export interface ArchivePromptInput {
-    projectId: string;
+    projectId?: string;
     promptId: string;
 }
 export type ArchivePromptResult = Prompt;
 export interface CreatePromptVersionInput {
-    projectId: string;
+    projectId?: string;
     promptId: string;
     format: PromptFormat;
     templateJson: unknown;
@@ -95,18 +95,18 @@ export interface CreatePromptVersionInput {
 }
 export type CreatePromptVersionResult = PromptVersion;
 export interface ListPromptVersionsInput {
-    projectId: string;
+    projectId?: string;
     promptId: string;
 }
 export type ListPromptVersionsResult = PromptVersion[];
 export interface GetPromptVersionInput {
-    projectId: string;
+    projectId?: string;
     promptId: string;
     versionNumber: number;
 }
 export type GetPromptVersionResult = PromptVersion;
 export interface MovePromptLabelInput {
-    projectId: string;
+    projectId?: string;
     promptId: string;
     label: string;
     versionId: string;
@@ -114,7 +114,7 @@ export interface MovePromptLabelInput {
 }
 export type MovePromptLabelResult = PromptLabelPointer;
 export interface ListPromptLabelsInput {
-    projectId: string;
+    projectId?: string;
     promptId: string;
 }
 export type ListPromptLabelsResult = PromptLabelPointer[];
@@ -192,13 +192,13 @@ export type ProjectPromptLabel = GenProjectPromptLabel;
 export type ProjectPromptLabelUsage = GenProjectPromptLabelUsage;
 export type PromptLabelEvent = GenPromptLabelEvent;
 export interface ListProjectPromptLabelsInput {
-    projectId: string;
+    projectId?: string;
     /** Set true to include archived (soft-deleted) entries. Default: false. */
     includeArchived?: boolean;
 }
 export type ListProjectPromptLabelsResult = ProjectPromptLabel[];
 export interface CreateProjectPromptLabelInput {
-    projectId: string;
+    projectId?: string;
     label: string;
     isDefault?: boolean;
     description?: string;
@@ -206,12 +206,12 @@ export interface CreateProjectPromptLabelInput {
 }
 export type CreateProjectPromptLabelResult = ProjectPromptLabel;
 export interface GetProjectPromptLabelInput {
-    projectId: string;
+    projectId?: string;
     label: string;
 }
 export type GetProjectPromptLabelResult = ProjectPromptLabel;
 export interface UpdateProjectPromptLabelInput {
-    projectId: string;
+    projectId?: string;
     label: string;
     isDefault?: boolean;
     description?: string | null;
@@ -219,18 +219,18 @@ export interface UpdateProjectPromptLabelInput {
 }
 export type UpdateProjectPromptLabelResult = ProjectPromptLabel;
 export interface DeleteProjectPromptLabelInput {
-    projectId: string;
+    projectId?: string;
     label: string;
 }
 export type DeleteProjectPromptLabelResult = ProjectPromptLabel;
 export interface ListProjectPromptLabelUsagesInput {
-    projectId: string;
+    projectId?: string;
     label: string;
 }
 export type ListProjectPromptLabelUsagesResult = ProjectPromptLabelUsage[];
 export type ListLabelEventsInput = {
     scope: "label";
-    projectId: string;
+    projectId?: string;
     promptId: string;
     label: string;
     page?: number;
@@ -239,7 +239,7 @@ export type ListLabelEventsInput = {
     until?: string;
 } | {
     scope: "prompt";
-    projectId: string;
+    projectId?: string;
     promptId: string;
     label?: string;
     page?: number;
@@ -248,7 +248,7 @@ export type ListLabelEventsInput = {
     until?: string;
 } | {
     scope: "project";
-    projectId: string;
+    projectId?: string;
     promptId?: string;
     label?: string;
     page?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@to11ai/sdk",
-	"version": "2.0.0-rc.2",
+	"version": "2.0.0-rc.3",
 	"license": "MPL-2.0",
 	"repository": {
 		"type": "git",

package/src/client.ts

@@ -245,6 +245,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;
 	/**
@@ -529,6 +535,7 @@ export function createClient<
 			behaviorStore.resolve(key, codedDefault),
 		apiKey,
 		gatewayUrl,
+		projectId,
 		session: (id) => new Session(gatewayAuthContext(), id),
 		conversation: (id) => clientDefaultSession().conversation(id),
 		turn: () => clientDefaultSession().turn(),

package/src/prompts/resource.ts

@@ -315,10 +315,29 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 		this.onUnknownRole = config?.onUnknownRole;
 	}
 
+	/**
+	 * 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(perCall?: string): string {
+		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, ... }).",
+			);
+		}
+		// Trim so a whitespace-padded per-call id normalizes like the client-bound
+		// one (resolved via `pick()`), instead of reaching the wire untrimmed.
+		return projectId.trim();
+	}
+
 	// ─── Create ──────────────────────────────────────────────────────────────
 
 	async create(input: CreatePromptInput): Promise<CreatePromptResult> {
-		const { projectId, ...body } = input;
+		const { projectId: perCallProjectId, ...body } = input;
+		const projectId = this.resolveProjectId(perCallProjectId);
 		const envelope = await this.transport.request<CreatePromptResult>(
 			"POST",
 			getProjectPromptsPath(projectId),
@@ -330,9 +349,10 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 	// ─── List ─────────────────────────────────────────────────────────────────
 
 	async list(
-		input: ListPromptsInput,
+		input: ListPromptsInput = {},
 	): Promise<PaginatedResult<ListPromptsResult>> {
-		const { projectId, ...queryRest } = input;
+		const { projectId: perCallProjectId, ...queryRest } = input;
+		const projectId = this.resolveProjectId(perCallProjectId);
 		const envelope = await this.transport.request<
 			| ListPromptsResult[]
 			| {
@@ -364,7 +384,8 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 	// ─── Get ──────────────────────────────────────────────────────────────────
 
 	async get(input: GetPromptInput): Promise<GetPromptResult> {
-		const { projectId, promptId } = input;
+		const { projectId: perCallProjectId, promptId } = input;
+		const projectId = this.resolveProjectId(perCallProjectId);
 		const envelope = await this.transport.request<GetPromptResult>(
 			"GET",
 			getProjectPromptPath(projectId, promptId),
@@ -375,7 +396,8 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 	// ─── Update ───────────────────────────────────────────────────────────────
 
 	async update(input: UpdatePromptInput): Promise<UpdatePromptResult> {
-		const { projectId, promptId, ...body } = input;
+		const { projectId: perCallProjectId, promptId, ...body } = input;
+		const projectId = this.resolveProjectId(perCallProjectId);
 		const envelope = await this.transport.request<UpdatePromptResult>(
 			"PATCH",
 			getProjectPromptPath(projectId, promptId),
@@ -387,7 +409,8 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 	// ─── Archive ──────────────────────────────────────────────────────────────
 
 	async archive(input: ArchivePromptInput): Promise<ArchivePromptResult> {
-		const { projectId, promptId } = input;
+		const { projectId: perCallProjectId, promptId } = input;
+		const projectId = this.resolveProjectId(perCallProjectId);
 		const envelope = await this.transport.request<ArchivePromptResult>(
 			"DELETE",
 			getProjectPromptPath(projectId, promptId),
@@ -400,7 +423,8 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 	async createVersion(
 		input: CreatePromptVersionInput,
 	): Promise<CreatePromptVersionResult> {
-		const { projectId, promptId, ...body } = input;
+		const { projectId: perCallProjectId, promptId, ...body } = input;
+		const projectId = this.resolveProjectId(perCallProjectId);
 		const envelope = await this.transport.request<CreatePromptVersionResult>(
 			"POST",
 			`${getProjectPromptPath(projectId, promptId)}/versions`,
@@ -414,7 +438,8 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 	async listVersions(
 		input: ListPromptVersionsInput,
 	): Promise<ListPromptVersionsResult> {
-		const { projectId, promptId } = input;
+		const { projectId: perCallProjectId, promptId } = input;
+		const projectId = this.resolveProjectId(perCallProjectId);
 		const envelope = await this.transport.request<ListPromptVersionsResult>(
 			"GET",
 			`${getProjectPromptPath(projectId, promptId)}/versions`,
@@ -427,7 +452,8 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 	async getVersion(
 		input: GetPromptVersionInput,
 	): Promise<GetPromptVersionResult> {
-		const { projectId, promptId, versionNumber } = input;
+		const { projectId: perCallProjectId, promptId, versionNumber } = input;
+		const projectId = this.resolveProjectId(perCallProjectId);
 		const envelope = await this.transport.request<GetPromptVersionResult>(
 			"GET",
 			`${getProjectPromptPath(projectId, promptId)}/versions/${encodeURIComponent(String(versionNumber))}`,
@@ -438,7 +464,8 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 	// ─── Move Label ───────────────────────────────────────────────────────────
 
 	async moveLabel(input: MovePromptLabelInput): Promise<MovePromptLabelResult> {
-		const { projectId, promptId, label, ...body } = input;
+		const { projectId: perCallProjectId, promptId, label, ...body } = input;
+		const projectId = this.resolveProjectId(perCallProjectId);
 		const envelope = await this.transport.request<MovePromptLabelResult>(
 			"PUT",
 			`${getProjectPromptPath(projectId, promptId)}/labels/${encodeURIComponent(label)}`,
@@ -452,7 +479,8 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 	async listLabels(
 		input: ListPromptLabelsInput,
 	): Promise<ListPromptLabelsResult> {
-		const { projectId, promptId } = input;
+		const { projectId: perCallProjectId, promptId } = input;
+		const projectId = this.resolveProjectId(perCallProjectId);
 		const envelope = await this.transport.request<ListPromptLabelsResult>(
 			"GET",
 			`${getProjectPromptPath(projectId, promptId)}/labels`,
@@ -611,9 +639,10 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 	 * affordances). Gated on `prompt:read` server-side.
 	 */
 	async listProjectLabels(
-		input: ListProjectPromptLabelsInput,
+		input: ListProjectPromptLabelsInput = {},
 	): Promise<ListProjectPromptLabelsResult> {
-		const { projectId, includeArchived } = input;
+		const { projectId: perCallProjectId, includeArchived } = input;
+		const projectId = this.resolveProjectId(perCallProjectId);
 		const envelope =
 			await this.transport.request<ListProjectPromptLabelsResult>(
 				"GET",
@@ -635,7 +664,8 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 	async createProjectLabel(
 		input: CreateProjectPromptLabelInput,
 	): Promise<CreateProjectPromptLabelResult> {
-		const { projectId, ...body } = input;
+		const { projectId: perCallProjectId, ...body } = input;
+		const projectId = this.resolveProjectId(perCallProjectId);
 		const envelope =
 			await this.transport.request<CreateProjectPromptLabelResult>(
 				"POST",
@@ -648,9 +678,10 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 	async getProjectLabel(
 		input: GetProjectPromptLabelInput,
 	): Promise<GetProjectPromptLabelResult> {
+		const projectId = this.resolveProjectId(input.projectId);
 		const envelope = await this.transport.request<GetProjectPromptLabelResult>(
 			"GET",
-			getProjectPromptLabelPath(input.projectId, input.label),
+			getProjectPromptLabelPath(projectId, input.label),
 		);
 		return unwrap(envelope);
 	}
@@ -666,7 +697,8 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 	async updateProjectLabel(
 		input: UpdateProjectPromptLabelInput,
 	): Promise<UpdateProjectPromptLabelResult> {
-		const { projectId, label, ...rest } = input;
+		const { projectId: perCallProjectId, label, ...rest } = input;
+		const projectId = this.resolveProjectId(perCallProjectId);
 		const body: Record<string, unknown> = {};
 		if (rest.isDefault !== undefined) body.isDefault = rest.isDefault;
 		if (rest.description !== undefined) body.description = rest.description;
@@ -692,10 +724,11 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 	async deleteProjectLabel(
 		input: DeleteProjectPromptLabelInput,
 	): Promise<DeleteProjectPromptLabelResult> {
+		const projectId = this.resolveProjectId(input.projectId);
 		const envelope =
 			await this.transport.request<DeleteProjectPromptLabelResult>(
 				"DELETE",
-				getProjectPromptLabelPath(input.projectId, input.label),
+				getProjectPromptLabelPath(projectId, input.label),
 			);
 		return unwrap(envelope);
 	}
@@ -714,7 +747,7 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 		const envelope =
 			await this.transport.request<ListProjectPromptLabelUsagesResult>(
 				"GET",
-				`${getProjectPromptLabelPath(input.projectId, input.label)}/usages`,
+				`${getProjectPromptLabelPath(this.resolveProjectId(input.projectId), input.label)}/usages`,
 			);
 		return unwrap(envelope);
 	}
@@ -739,7 +772,9 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 	async listLabelEvents(
 		input: ListLabelEventsInput,
 	): Promise<ListLabelEventsResult> {
-		const projectSeg = encodeURIComponent(input.projectId);
+		const projectSeg = encodeURIComponent(
+			this.resolveProjectId(input.projectId),
+		);
 		let path: string;
 		switch (input.scope) {
 			case "label":

package/src/prompts/types.ts

@@ -86,7 +86,7 @@ export interface PaginatedResult<T> {
 }
 
 export interface CreatePromptInput {
-	projectId: string;
+	projectId?: string;
 	name: string;
 	slug: string;
 	description?: string;
@@ -96,7 +96,7 @@ export interface CreatePromptInput {
 export type CreatePromptResult = Prompt;
 
 export interface ListPromptsInput {
-	projectId: string;
+	projectId?: string;
 	status?: PromptStatus;
 	sortBy?: "createdAt" | "updatedAt" | "name";
 	tags?: string;
@@ -107,14 +107,14 @@ export interface ListPromptsInput {
 export type ListPromptsResult = Prompt;
 
 export interface GetPromptInput {
-	projectId: string;
+	projectId?: string;
 	promptId: string;
 }
 
 export type GetPromptResult = Prompt;
 
 export interface UpdatePromptInput {
-	projectId: string;
+	projectId?: string;
 	promptId: string;
 	name?: string;
 	description?: string | null;
@@ -124,14 +124,14 @@ export interface UpdatePromptInput {
 export type UpdatePromptResult = Prompt;
 
 export interface ArchivePromptInput {
-	projectId: string;
+	projectId?: string;
 	promptId: string;
 }
 
 export type ArchivePromptResult = Prompt;
 
 export interface CreatePromptVersionInput {
-	projectId: string;
+	projectId?: string;
 	promptId: string;
 	format: PromptFormat;
 	templateJson: unknown;
@@ -143,14 +143,14 @@ export interface CreatePromptVersionInput {
 export type CreatePromptVersionResult = PromptVersion;
 
 export interface ListPromptVersionsInput {
-	projectId: string;
+	projectId?: string;
 	promptId: string;
 }
 
 export type ListPromptVersionsResult = PromptVersion[];
 
 export interface GetPromptVersionInput {
-	projectId: string;
+	projectId?: string;
 	promptId: string;
 	versionNumber: number;
 }
@@ -158,7 +158,7 @@ export interface GetPromptVersionInput {
 export type GetPromptVersionResult = PromptVersion;
 
 export interface MovePromptLabelInput {
-	projectId: string;
+	projectId?: string;
 	promptId: string;
 	label: string;
 	versionId: string;
@@ -168,7 +168,7 @@ export interface MovePromptLabelInput {
 export type MovePromptLabelResult = PromptLabelPointer;
 
 export interface ListPromptLabelsInput {
-	projectId: string;
+	projectId?: string;
 	promptId: string;
 }
 
@@ -257,7 +257,7 @@ export type ProjectPromptLabelUsage = GenProjectPromptLabelUsage;
 export type PromptLabelEvent = GenPromptLabelEvent;
 
 export interface ListProjectPromptLabelsInput {
-	projectId: string;
+	projectId?: string;
 	/** Set true to include archived (soft-deleted) entries. Default: false. */
 	includeArchived?: boolean;
 }
@@ -265,7 +265,7 @@ export interface ListProjectPromptLabelsInput {
 export type ListProjectPromptLabelsResult = ProjectPromptLabel[];
 
 export interface CreateProjectPromptLabelInput {
-	projectId: string;
+	projectId?: string;
 	label: string;
 	isDefault?: boolean;
 	description?: string;
@@ -275,14 +275,14 @@ export interface CreateProjectPromptLabelInput {
 export type CreateProjectPromptLabelResult = ProjectPromptLabel;
 
 export interface GetProjectPromptLabelInput {
-	projectId: string;
+	projectId?: string;
 	label: string;
 }
 
 export type GetProjectPromptLabelResult = ProjectPromptLabel;
 
 export interface UpdateProjectPromptLabelInput {
-	projectId: string;
+	projectId?: string;
 	label: string;
 	isDefault?: boolean;
 	description?: string | null;
@@ -292,14 +292,14 @@ export interface UpdateProjectPromptLabelInput {
 export type UpdateProjectPromptLabelResult = ProjectPromptLabel;
 
 export interface DeleteProjectPromptLabelInput {
-	projectId: string;
+	projectId?: string;
 	label: string;
 }
 
 export type DeleteProjectPromptLabelResult = ProjectPromptLabel;
 
 export interface ListProjectPromptLabelUsagesInput {
-	projectId: string;
+	projectId?: string;
 	label: string;
 }
 
@@ -308,7 +308,7 @@ export type ListProjectPromptLabelUsagesResult = ProjectPromptLabelUsage[];
 export type ListLabelEventsInput =
 	| {
 			scope: "label";
-			projectId: string;
+			projectId?: string;
 			promptId: string;
 			label: string;
 			page?: number;
@@ -318,7 +318,7 @@ export type ListLabelEventsInput =
 	  }
 	| {
 			scope: "prompt";
-			projectId: string;
+			projectId?: string;
 			promptId: string;
 			label?: string;
 			page?: number;
@@ -328,7 +328,7 @@ export type ListLabelEventsInput =
 	  }
 	| {
 			scope: "project";
-			projectId: string;
+			projectId?: string;
 			promptId?: string;
 			label?: string;
 			page?: number;