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

package/src/prompts/resource.ts

@@ -1,9 +1,10 @@
-import { z } from "zod";
-import { EnvNotFoundError, To11aiNetworkError } from "../errors";
+import {
+	MissingLabelError,
+	To11aiApiError,
+	To11aiNetworkError,
+} from "../errors";
 import { zResolvedPrompt } from "../generated/zod.gen";
 import type { ApiEnvelope, Transport } from "../transport";
-import type { CacheConfig } from "./cache";
-import { buildRenderCacheKey, PromptCache } from "./cache";
 import type {
 	AnthropicRenderedPrompt,
 	OpenAiRenderedPrompt,
@@ -56,13 +57,12 @@ import type {
 } from "./types";
 import { ENV_SLUG_REGEX } from "./types";
 
-// Re-export CacheConfig so callers can import from this module
-export type { CacheConfig } from "./cache";
 export type {
 	ArchivePromptInput,
 	ArchivePromptResult,
 	BlockRenderRecord,
 	ChatMessage,
+	ChatRole,
 	CreateProjectPromptLabelInput,
 	CreateProjectPromptLabelResult,
 	CreatePromptInput,
@@ -111,8 +111,6 @@ export type {
 	ResolvedToolCall,
 	ResolvedToolDefinition,
 	RowError,
-	TextChatMessage,
-	TextChatRole,
 	UnknownRoleMode,
 	UpdateProjectPromptLabelInput,
 	UpdateProjectPromptLabelResult,
@@ -120,9 +118,7 @@ export type {
 	UpdatePromptResult,
 } from "./types";
 
-const zResolvedPromptEnvelope = zResolvedPrompt
-	.partial({ releaseId: true })
-	.extend({ strategy: z.enum(["single", "weighted"]).optional() });
+const zResolvedPromptEnvelope = zResolvedPrompt.partial({ releaseId: true });
 
 function unwrap<T>(envelope: ApiEnvelope<T>): T {
 	if (envelope.data === null || envelope.data === undefined) {
@@ -293,7 +289,6 @@ export interface PromptResourceConfig {
 
 export class PromptResource<F extends RenderFormat | undefined = undefined> {
 	private readonly transport: Transport;
-	private readonly cache: PromptCache;
 	private readonly projectId: string | undefined;
 	private readonly env: string | undefined;
 	private readonly format: RenderFormat | undefined;
@@ -301,24 +296,41 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 
 	constructor(
 		transport: Transport,
-		cacheConfig?: CacheConfig,
 		// `format` is bound to the class generic `F` (not the wider `RenderFormat`)
 		// so the constructed default shape cannot disagree with what `render()`'s
 		// return type (`RenderResult<F>`) promises.
 		config?: Omit<PromptResourceConfig, "format"> & { format?: F },
 	) {
 		this.transport = transport;
-		this.cache = new PromptCache(cacheConfig);
 		this.projectId = config?.projectId;
 		this.env = config?.env;
 		this.format = config?.format;
 		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 +342,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 +377,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 +389,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 +402,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 +416,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 +431,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 +445,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 +457,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 +472,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`,
@@ -499,17 +520,14 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 
 	/**
 	 * Env-aware resolution → neutral `RenderedPrompt`. Carries the resolve /
-	 * cache / offline-fallback logic; `render()` is the public shaping surface.
+	 * offline-fallback logic; `render()` is the public shaping surface.
 	 *
-	 * - **env→label wire mapping:** the resolve route is label-based
+	 * - **label wire mapping:** the resolve route is label-based
 	 *   (`/v1/projects/:projectId/prompts:resolve`, body `labels[]`); the
-	 *   resolved env slug is sent as the single resolution label.
-	 * - **No silent fallback (R4):** if no env is resolvable (none at init AND
-	 *   none per call) this throws `EnvNotFoundError` CLIENT-side, eagerly,
-	 *   before any transport call.
-	 * - **Cache (D8):** caches `single`-strategy releases and weighted releases
-	 *   WITH a `subject`; BYPASSES the cache for weighted releases with NO
-	 *   `subject` (a uniform-random assignment must not be pinned for the TTL).
+	 *   resolved label is sent as the single resolution label.
+	 * - **No silent fallback (R4):** if no label is resolvable (none per call
+	 *   AND no client `env` fallback) this throws `MissingLabelError`
+	 *   CLIENT-side, eagerly, before any transport call.
 	 */
 	private async resolveToRendered(
 		slug: string,
@@ -521,41 +539,28 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 			);
 		}
 
-		// R2 precedence: per-call env > init-time env. No third source.
-		const env = options.env ?? this.env;
+		// R2 precedence: per-call label > client `env` fallback. No third source.
+		const label = options.label ?? this.env;
 
-		// R4 / AC4: no env resolvable → throw eagerly, ZERO transport calls.
-		if (env === undefined) {
-			throw EnvNotFoundError.missing();
+		// R4 / AC4: no label resolvable → throw eagerly, ZERO transport calls.
+		if (label === undefined) {
+			throw new MissingLabelError();
 		}
 
-		// Validate the RESOLVED env (per-call OR init). createClient validates the
-		// init-time env, but PromptResource has a public constructor that can
-		// bypass createClient, so re-validate here so a malformed env (e.g.
-		// "Prod") never reaches the wire as a resolution label (CodeRabbit).
-		if (!ENV_SLUG_REGEX.test(env)) {
+		// Validate the RESOLVED label (per-call OR the client `env` fallback).
+		// createClient validates the init-time env, but PromptResource has a
+		// public constructor that can bypass createClient, so re-validate here so
+		// a malformed label (e.g. "Prod") never reaches the wire (CodeRabbit).
+		if (!ENV_SLUG_REGEX.test(label)) {
 			throw new Error(
-				`[to11ai/sdk] \`env\` must match ${ENV_SLUG_REGEX} (lowercase-kebab, 1-63 chars). Received: ${JSON.stringify(env)}`,
+				`[to11ai/sdk] \`label\` must match ${ENV_SLUG_REGEX} (lowercase-kebab, 1-63 chars). Received: ${JSON.stringify(label)}`,
 			);
 		}
 
-		const { subject, variables, cache: useCache = true, fallback } = options;
+		const { subject, variables, fallback } = options;
 
-		const cacheKey = buildRenderCacheKey(
-			this.projectId,
-			slug,
-			env,
-			subject,
-			variables,
-		);
-
-		if (useCache) {
-			const cached = this.cache.get(cacheKey);
-			if (cached) return structuredClone(cached);
-		}
-
-		// env→label mapping: the env slug is the single resolution label.
-		const body: Record<string, unknown> = { slug, labels: [env] };
+		// The resolved label is sent as the single resolution label.
+		const body: Record<string, unknown> = { slug, labels: [label] };
 		if (subject !== undefined) body.subject = subject;
 		if (variables !== undefined) body.variables = variables;
 
@@ -570,31 +575,16 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 				},
 			);
 			const raw = unwrap(envelope);
-			const result = normalizeResolvedEnvelope(raw, slug);
-
-			// D8: bypass the cache for a weighted release with NO subject —
-			// caching a uniform-random assignment would pin one variant for the
-			// whole TTL. Cache `single` releases and `subject`-keyed weighted
-			// releases (deterministic, safe to cache). Weighted-ness is inferred
-			// from `strategy === "weighted"` OR the presence of `variantName`
-			// (which the server stamps iff weighted) — so a result that carries a
-			// variant but omits `strategy` is still correctly bypassed rather than
-			// pinning one random variant for the TTL (Cursor / Greptile).
-			const isWeighted =
-				raw.strategy === "weighted" || result.variantName !== undefined;
-			const cacheable = !(isWeighted && subject === undefined);
-			if (useCache && cacheable) {
-				this.cache.set(cacheKey, structuredClone(result));
-			}
-
-			return result;
+			return normalizeResolvedEnvelope(raw, slug);
 		} catch (err) {
-			// D7: offline fallback is consulted ONLY on a network outage with an
-			// empty cache. A server `ENV_NOT_FOUND` is a typed application error
-			// (not a To11aiNetworkError), so it bypasses this branch. R4's
-			// client-eager throw already happened above the try, so there is no
-			// network error to trigger it on the env-missing path.
-			if (err instanceof To11aiNetworkError && fallback !== undefined) {
+			// Serve the offline fallback on a TRANSIENT outage — a network error
+			// or a 5xx from the control plane. A typed 4xx (not-found / policy /
+			// validation) is a real application error and is NOT masked. The
+			// client-eager MissingLabelError already threw above the try.
+			const transient =
+				err instanceof To11aiNetworkError ||
+				(err instanceof To11aiApiError && err.statusCode >= 500);
+			if (transient && fallback !== undefined) {
 				return liftFallbackToRendered(fallback, slug);
 			}
 			throw err;
@@ -611,9 +601,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 +626,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 +640,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 +659,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 +686,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 +709,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 +734,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/shape.ts

@@ -135,7 +135,7 @@ export function shapeAnthropic(
 	return result;
 }
 
-/** Shape a fetched prompt for `format`, or return it neutral when unset. */
+/** Shape a rendered prompt for `format`, or return it neutral when unset. */
 export function shapePrompt(
 	prompt: RenderedPrompt,
 	format: RenderFormat | undefined,

package/src/prompts/types.ts

@@ -23,16 +23,14 @@ export type PromptVersion = GenPromptVersion;
 export type PromptFormat = PromptVersion["format"];
 export type PromptLabelPointer = GenPromptLabelPointer;
 
-export type TextChatRole = "system" | "user" | "assistant" | "developer";
+export type ChatRole = "system" | "user" | "assistant" | "developer";
 
-export interface TextChatMessage {
-	role: TextChatRole;
+export interface ChatMessage {
+	role: ChatRole;
 	content: string;
 	disabled?: boolean;
 }
 
-export type ChatMessage = TextChatMessage;
-
 export type RenderedChatMessage = GenRenderedChatPrompt["messages"][number];
 
 /** Provider shape for `prompts.render()` output. Omit for the neutral result. */
@@ -86,7 +84,7 @@ export interface PaginatedResult<T> {
 }
 
 export interface CreatePromptInput {
-	projectId: string;
+	projectId?: string;
 	name: string;
 	slug: string;
 	description?: string;
@@ -96,7 +94,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 +105,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 +122,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 +141,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 +156,7 @@ export interface GetPromptVersionInput {
 export type GetPromptVersionResult = PromptVersion;
 
 export interface MovePromptLabelInput {
-	projectId: string;
+	projectId?: string;
 	promptId: string;
 	label: string;
 	versionId: string;
@@ -168,12 +166,19 @@ export interface MovePromptLabelInput {
 export type MovePromptLabelResult = PromptLabelPointer;
 
 export interface ListPromptLabelsInput {
-	projectId: string;
+	projectId?: string;
 	promptId: string;
 }
 
 export type ListPromptLabelsResult = PromptLabelPointer[];
 
+/**
+ * Slug rule for a `render()` label — lowercase-kebab, 1-63 chars. Env slugs are
+ * a special case of a label value, so labels are held to the same strict rule
+ * (no uppercase, no underscores): a label is a routing key, and case-insensitive
+ * routing keys invite silent "production" vs "Production" mismatches. Intentionally
+ * strict — do not loosen.
+ */
 export const ENV_SLUG_REGEX = /^[a-z0-9-]{1,63}$/;
 
 export type BlockRenderRecord = Record<string, "rendered" | "dimmed">;
@@ -223,20 +228,18 @@ export interface RenderedPrompt {
 	toolChoice?: NonNullable<ResolvedPrompt["toolChoice"]>;
 }
 
-export type ResolvedPromptEnvelope = GenResolvedPrompt & {
-	/** Active release strategy. Used to decide weighted-no-subject cache bypass (D8). */
-	strategy?: "single" | "weighted";
-};
+export type ResolvedPromptEnvelope = GenResolvedPrompt;
 
 export interface RenderOptions {
-	/** Serving environment for this call; overrides the client default. */
-	env?: string;
+	/**
+	 * Label to resolve this call's prompt version; overrides the client default.
+	 * When omitted, falls back to the client's `env` (env is a label value).
+	 */
+	label?: string;
 	/** Stable id so a weighted release sends the same caller to the same variant. */
 	subject?: string;
 	variables?: Record<string, unknown>;
-	/** Set false to bypass the LRU cache for this call. Default: true */
-	cache?: boolean;
-	/** Prompt served if the API is unreachable on a network error and cache is empty. */
+	/** Prompt served if the API is unreachable on a network error. */
 	fallback?: RenderedPrompt;
 	/** Provider shape for this call's output; overrides the client default. */
 	format?: RenderFormat;
@@ -257,7 +260,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 +268,7 @@ export interface ListProjectPromptLabelsInput {
 export type ListProjectPromptLabelsResult = ProjectPromptLabel[];
 
 export interface CreateProjectPromptLabelInput {
-	projectId: string;
+	projectId?: string;
 	label: string;
 	isDefault?: boolean;
 	description?: string;
@@ -275,14 +278,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 +295,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 +311,7 @@ export type ListProjectPromptLabelUsagesResult = ProjectPromptLabelUsage[];
 export type ListLabelEventsInput =
 	| {
 			scope: "label";
-			projectId: string;
+			projectId?: string;
 			promptId: string;
 			label: string;
 			page?: number;
@@ -318,7 +321,7 @@ export type ListLabelEventsInput =
 	  }
 	| {
 			scope: "prompt";
-			projectId: string;
+			projectId?: string;
 			promptId: string;
 			label?: string;
 			page?: number;
@@ -328,7 +331,7 @@ export type ListLabelEventsInput =
 	  }
 	| {
 			scope: "project";
-			projectId: string;
+			projectId?: string;
 			promptId?: string;
 			label?: string;
 			page?: number;