@to11ai/sdk 2.0.0 → 2.1.0-rc.1

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;
@@ -655,7 +664,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 {

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