@to11ai/sdk 2.1.0-rc → 2.1.0-rc.2

package/src/projectEnvironments/resource.ts

@@ -1,8 +1,8 @@
 // ---------------------------------------------------------------------------
 // ProjectEnvironmentResource — fluent SDK surface for project environments.
 // ---------------------------------------------------------------------------
-// Spec: docs/product-specs/2026-05-14-environments-registry.md
-// Plan: docs/exec-plans/active/2026-05-14-env-registry-plan.md §S21
+// Spec: docs/archive-2026-08/specs/2026-05-14-environments-registry.md
+// Plan: docs/archive-2026-08/plans/active/2026-05-14-env-registry-plan.md §S21
 //
 // Mirrors `PromptResource` in shape so existing call-site intuition
 // transfers: each method takes a flat input object, unwraps the API

package/src/prompts/resource.ts

@@ -138,13 +138,22 @@ function getProjectPromptsPath(projectId: string): string {
  * first-class case: a non-chat payload throws rather than being silently
  * coerced (a text prompt is sugar for a single-block chat and is being removed
  * from the API).
+ *
+ * a SKILL cannot arrive here in practice — the platform excludes
+ * skills from `GET …/prompts` unless a caller asks for them, so a consumer
+ * that never asked never learns a skill's slug, and the render response for
+ * one carries no `rendered` field for the closed generated schema to accept.
+ * The guard stays anyway, because it is why a mistake fails loudly rather than
+ * quietly, and it now says something TRUE for the case it would catch:
+ * advising a maintainer to "author the prompt as chat blocks" is impossible
+ * for a skill and would send them to change content that is already correct.
  */
 function renderedToMessages(
 	rendered: ResolvedPrompt["rendered"],
 ): RenderedChatMessage[] {
 	if (rendered.format !== "chat") {
 		throw new Error(
-			"[to11ai/sdk] Unsupported non-chat prompt format; author the prompt as chat blocks.",
+			`[to11ai/sdk] unsupported prompt format \`${rendered.format}\`: only \`chat\` resolves to messages`,
 		);
 	}
 	return rendered.messages;
@@ -156,8 +165,6 @@ function renderedToMessages(
  * - `messages` is derived from the `rendered` chat payload.
  * - `releaseId` is ALWAYS a key: a string when the server sends one, else
  *   explicit `null` (R5 `string | null`).
- * - `variantName` is present IFF the server sent one (i.e. weighted release);
- *   absent for `single` — never `null`/`""`.
  * - `blockRenderRecord` defaults to `{}` when the server omitted it.
  */
 function normalizeResolvedEnvelope(
@@ -193,17 +200,6 @@ function normalizeResolvedEnvelope(
 	if (raw.toolChoice != null) {
 		result.toolChoice = raw.toolChoice;
 	}
-	// Set `variantName` only when it is a non-empty string, so the key is
-	// genuinely absent for `single`-strategy releases (R5: present IFF weighted —
-	// never `null`, never `""`). A `null`/`""` from the wire is normalized to
-	// absent, which also keeps the D8 `variantName !== undefined` weighted
-	// inference honest (Cursor).
-	if (
-		typeof provenance.variantName === "string" &&
-		provenance.variantName.length > 0
-	) {
-		result.variantName = provenance.variantName;
-	}
 	return result;
 }
 
@@ -560,8 +556,7 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 		const { variables, fallback } = options;
 
 		// TO11-2743: slug + the single resolved label live in the PATH; the body
-		// carries only `variables`. Weighted-release bucketing (`subject`) is not
-		// supported by the render endpoint yet, so it's dropped from the surface.
+		// carries only `variables`.
 		const body: Record<string, unknown> = {};
 		if (variables !== undefined) body.variables = variables;
 
@@ -655,7 +650,7 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 	 * Note on `description` semantics: `undefined` means "do not change" —
 	 * the SDK omits the field from the body in that case. Pass
 	 * `description: ""` (empty string) or `description: null` to explicitly
-	 * clear it (the server normalises both).
+	 * clear it (the server normalizes both).
 	 */
 	async updateProjectLabel(
 		input: UpdateProjectPromptLabelInput,

package/src/prompts/shape.ts

@@ -2,7 +2,7 @@
  * Format-at-load shaping: turn a neutral `RenderedPrompt` into a provider-shaped
  * `{ messages, config, metadata }` result the caller spreads into their own
  * provider `create()` call. Header-only — this only reshapes data, it never
- * sends a request. See docs/product-specs/2026-07-14-to11-2691-sdk-simpler-setup.md.
+ * sends a request. See docs/archive-2026-08/specs/2026-07-14-to11-2691-sdk-simpler-setup.md.
  */
 
 import {
@@ -44,7 +44,6 @@ export interface PromptMetadata {
 	label: string;
 	/** The prompt's human-readable slug — surfaced as `x-to11-prompt-slug`. */
 	slug: string;
-	variantName?: string;
 }
 
 /** OpenAI-shaped render result: spread `{ ...config, messages }` into create(). */
@@ -94,8 +93,6 @@ function toMetadata(prompt: RenderedPrompt): PromptMetadata {
 		label: prompt.label,
 		slug: prompt.slug,
 	};
-	if (prompt.variantName !== undefined)
-		metadata.variantName = prompt.variantName;
 	return metadata;
 }
 

package/src/prompts/types.ts

@@ -187,7 +187,6 @@ export interface RenderedPrompt {
 	messages: RenderedChatMessage[];
 	version: number;
 	releaseId: string | null;
-	variantName?: string;
 	blockRenderRecord: BlockRenderRecord;
 	promptId: string;
 	versionId: string;

package/src/traceparent.ts

@@ -16,7 +16,7 @@
  *      trace/span ids in `traceparent`. We return `null` (caller omits).
  *
  * @see https://www.w3.org/TR/trace-context/ for the wire format.
- * @see docs/product-specs/2026-05-20-to11-1016-sdk-traceparent-propagation.md
+ * @see docs/archive-2026-08/specs/2026-05-20-to11-1016-sdk-traceparent-propagation.md
  */
 
 // NOTE: deliberately NO top-level `import ... from "node:module"`. With the

package/src/transport.ts

@@ -53,23 +53,12 @@ const PROMPT_NOT_FOUND_DETAILS_CODES = new Set([
 ]);
 
 /**
- * Prompt-resolution policy violation codes (S5 / TO11-976). The generic
- * `POLICY_VIOLATION` plus the concrete `ENV_POLICY_*` family the server
- * emits. Any of these maps to `PromptPolicyViolationError`. This set is
- * matched on `details.code` BEFORE the generic `401 || 403 → auth` guard so a
- * 403 policy violation is not swallowed as an auth error (D3, AC6).
+ * Prompt-resolution policy violation codes. `POLICY_VIOLATION` maps to
+ * `PromptPolicyViolationError`. This set is matched on `details.code` BEFORE
+ * the generic `401 || 403 → auth` guard so a 403 policy violation is not
+ * swallowed as an auth error (D3, AC6).
  */
-const PROMPT_POLICY_VIOLATION_DETAILS_CODES = new Set([
-	"POLICY_VIOLATION",
-	"ENV_POLICY_REQUIRED_SOURCE_ENV",
-	"ENV_POLICY_MINIMUM_DWELL_TIME",
-	"ENV_POLICY_NO_ROLLBACK_IN_SOURCE",
-	"ENV_POLICY_REQUIRES_APPROVAL",
-	"ENV_POLICY_SEPARATION_OF_DUTIES",
-	"ENV_POLICY_SOURCE_ENV_UNAVAILABLE",
-	"ENV_POLICY_ENV_NOT_FOUND",
-	"ENV_POLICY_INVALID_CONFIG",
-]);
+const PROMPT_POLICY_VIOLATION_DETAILS_CODES = new Set(["POLICY_VIOLATION"]);
 
 /**
  * Map a prompt-resolution envelope (keyed on `details.code`) to a typed S9