@templatical/ai-kit 0.51.1 → 0.52.0

package/dist/{shared-BuhccY6c.js.map → shared-DOEVSpBX.js.map}

@@ -1 +1 @@
-{"version":3,"file":"shared-BuhccY6c.js","names":[],"sources":["../src/adapters/shared.ts"],"sourcesContent":["import { SdkError, ThrottledError } from \"@templatical/types\";\nimport { parseRetryAfter } from \"../client/errors\";\nimport type { AiModelToolCall } from \"../server/model\";\nimport { AI_ERROR_MESSAGES } from \"../wire\";\n\n/** The content an adapter stored as `{ adapter, content }` state, if it's this adapter's. */\nexport function ownState<T>(state: unknown, adapter: string): T[] | undefined {\n  if (typeof state !== \"object\" || state === null) return undefined;\n  const tagged = state as { adapter?: unknown; content?: unknown };\n  return tagged.adapter === adapter && Array.isArray(tagged.content)\n    ? (tagged.content as T[])\n    : undefined;\n}\n\n/** A tool call's arguments as an object (`{}` when the string isn't a JSON object). */\nexport function toolInput(\n  input: AiModelToolCall[\"input\"],\n): Record<string, unknown> {\n  if (typeof input !== \"string\") return input;\n  try {\n    const parsed: unknown = JSON.parse(input);\n    return typeof parsed === \"object\" &&\n      parsed !== null &&\n      !Array.isArray(parsed)\n      ? (parsed as Record<string, unknown>)\n      : {};\n  } catch {\n    return {};\n  }\n}\n\n/** A tool call's arguments as a JSON string. */\nexport function toolArguments(input: AiModelToolCall[\"input\"]): string {\n  return typeof input === \"string\" ? input : JSON.stringify(input);\n}\n\n/** A Blob's bytes as base64, with web APIs only (the kit is isomorphic). */\nexport async function blobBase64(blob: Blob): Promise<string> {\n  const bytes = new Uint8Array(await blob.arrayBuffer());\n  let binary = \"\";\n  for (let start = 0; start < bytes.length; start += 0x8000) {\n    binary += String.fromCharCode(...bytes.subarray(start, start + 0x8000));\n  }\n  return btoa(binary);\n}\n\n/** The model refused or a content filter stopped it. */\nexport function refused(): SdkError {\n  return new SdkError(\n    AI_ERROR_MESSAGES.ai_provider_error,\n    502,\n    \"ai_provider_error\",\n  );\n}\n\n/** The output hit the token limit while a tool call was being written. */\nexport function cutOff(): SdkError {\n  return new SdkError(\n    AI_ERROR_MESSAGES.ai_output_invalid,\n    422,\n    \"ai_output_invalid\",\n  );\n}\n\nfunction retryAfterHeader(headers: unknown): string | null {\n  if (typeof Headers !== \"undefined\" && headers instanceof Headers)\n    return headers.get(\"retry-after\");\n  if (typeof headers !== \"object\" || headers === null) return null;\n  for (const [name, value] of Object.entries(headers)) {\n    if (name.toLowerCase() === \"retry-after\" && typeof value === \"string\")\n      return value;\n  }\n  return null;\n}\n\n/**\n * A provider's 429 (after the client's own retries) as the kit's\n * `ThrottledError`; anything else unchanged, so it keeps its own details.\n * Reads the provider SDKs' `status`/`headers` and the AI SDK's\n * `statusCode`/`responseHeaders`, unwrapping a retry error's `lastError`.\n */\nexport function providerError(error: unknown): unknown {\n  if (typeof error !== \"object\" || error === null) return error;\n  const failure = ((error as { lastError?: unknown }).lastError ?? error) as {\n    status?: unknown;\n    statusCode?: unknown;\n    headers?: unknown;\n    responseHeaders?: unknown;\n  };\n  if ((failure.status ?? failure.statusCode) !== 429) return error;\n  return new ThrottledError(\n    AI_ERROR_MESSAGES.rate_limited,\n    parseRetryAfter(\n      retryAfterHeader(failure.headers ?? failure.responseHeaders),\n    ),\n  );\n}\n"],"mappings":";;;;;AAMA,SAAgB,SAAY,OAAgB,SAAkC;CAC5E,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,KAAA;CACxD,MAAM,SAAS;CACf,OAAO,OAAO,YAAY,WAAW,MAAM,QAAQ,OAAO,OAAO,IAC5D,OAAO,UACR,KAAA;AACN;;AAGA,SAAgB,UACd,OACyB;CACzB,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,IAAI;EACF,MAAM,SAAkB,KAAK,MAAM,KAAK;EACxC,OAAO,OAAO,WAAW,YACvB,WAAW,QACX,CAAC,MAAM,QAAQ,MAAM,IAClB,SACD,CAAC;CACP,QAAQ;EACN,OAAO,CAAC;CACV;AACF;;AAGA,SAAgB,cAAc,OAAyC;CACrE,OAAO,OAAO,UAAU,WAAW,QAAQ,KAAK,UAAU,KAAK;AACjE;;AAGA,eAAsB,WAAW,MAA6B;CAC5D,MAAM,QAAQ,IAAI,WAAW,MAAM,KAAK,YAAY,CAAC;CACrD,IAAI,SAAS;CACb,KAAK,IAAI,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS,OACjD,UAAU,OAAO,aAAa,GAAG,MAAM,SAAS,OAAO,QAAQ,KAAM,CAAC;CAExE,OAAO,KAAK,MAAM;AACpB;;AAGA,SAAgB,UAAoB;CAClC,OAAO,IAAI,SACT,kBAAkB,mBAClB,KACA,mBACF;AACF;;AAGA,SAAgB,SAAmB;CACjC,OAAO,IAAI,SACT,kBAAkB,mBAClB,KACA,mBACF;AACF;AAEA,SAAS,iBAAiB,SAAiC;CACzD,IAAI,OAAO,YAAY,eAAe,mBAAmB,SACvD,OAAO,QAAQ,IAAI,aAAa;CAClC,IAAI,OAAO,YAAY,YAAY,YAAY,MAAM,OAAO;CAC5D,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,OAAO,GAChD,IAAI,KAAK,YAAY,MAAM,iBAAiB,OAAO,UAAU,UAC3D,OAAO;CAEX,OAAO;AACT;;;;;;;AAQA,SAAgB,cAAc,OAAyB;CACrD,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,UAAY,MAAkC,aAAa;CAMjE,KAAK,QAAQ,UAAU,QAAQ,gBAAgB,KAAK,OAAO;CAC3D,OAAO,IAAI,eACT,kBAAkB,cAClB,gBACE,iBAAiB,QAAQ,WAAW,QAAQ,eAAe,CAC7D,CACF;AACF"}
+{"version":3,"file":"shared-DOEVSpBX.js","names":[],"sources":["../src/adapters/shared.ts"],"sourcesContent":["import { SdkError, ThrottledError } from \"@templatical/types\";\nimport { parseRetryAfter } from \"../client/errors\";\nimport type { AiModelToolCall } from \"../server/model\";\nimport { AI_ERROR_MESSAGES } from \"../wire\";\n\n/** The content an adapter stored as `{ adapter, content }` state, if it's this adapter's. */\nexport function ownState<T>(state: unknown, adapter: string): T[] | undefined {\n  if (typeof state !== \"object\" || state === null) return undefined;\n  const tagged = state as { adapter?: unknown; content?: unknown };\n  return tagged.adapter === adapter && Array.isArray(tagged.content)\n    ? (tagged.content as T[])\n    : undefined;\n}\n\n/** A tool call's arguments as an object (`{}` when the string isn't a JSON object). */\nexport function toolInput(\n  input: AiModelToolCall[\"input\"],\n): Record<string, unknown> {\n  if (typeof input !== \"string\") return input;\n  try {\n    const parsed: unknown = JSON.parse(input);\n    return typeof parsed === \"object\" &&\n      parsed !== null &&\n      !Array.isArray(parsed)\n      ? (parsed as Record<string, unknown>)\n      : {};\n  } catch {\n    return {};\n  }\n}\n\n/** A tool call's arguments as a JSON string. */\nexport function toolArguments(input: AiModelToolCall[\"input\"]): string {\n  return typeof input === \"string\" ? input : JSON.stringify(input);\n}\n\n/** A Blob's bytes as base64, with web APIs only (the kit is isomorphic). */\nexport async function blobBase64(blob: Blob): Promise<string> {\n  const bytes = new Uint8Array(await blob.arrayBuffer());\n  let binary = \"\";\n  for (let start = 0; start < bytes.length; start += 0x8000) {\n    binary += String.fromCharCode(...bytes.subarray(start, start + 0x8000));\n  }\n  return btoa(binary);\n}\n\n/** The model refused or a content filter stopped it. */\nexport function refused(): SdkError {\n  return new SdkError(\n    AI_ERROR_MESSAGES.ai_provider_error,\n    502,\n    \"ai_provider_error\",\n  );\n}\n\n/** The output hit the token limit while a tool call was being written. */\nexport function cutOff(): SdkError {\n  return new SdkError(\n    AI_ERROR_MESSAGES.ai_output_invalid,\n    422,\n    \"ai_output_invalid\",\n  );\n}\n\nfunction retryAfterHeader(headers: unknown): string | null {\n  if (typeof Headers !== \"undefined\" && headers instanceof Headers)\n    return headers.get(\"retry-after\");\n  if (typeof headers !== \"object\" || headers === null) return null;\n  for (const [name, value] of Object.entries(headers)) {\n    if (name.toLowerCase() === \"retry-after\" && typeof value === \"string\")\n      return value;\n  }\n  return null;\n}\n\n/**\n * A provider's 429 (after the client's own retries) as the kit's\n * `ThrottledError`; anything else unchanged, so it keeps its own details.\n * Reads the provider SDKs' `status`/`headers` and the AI SDK's\n * `statusCode`/`responseHeaders`, unwrapping a retry error's `lastError`.\n */\nexport function providerError(error: unknown): unknown {\n  if (typeof error !== \"object\" || error === null) return error;\n  const failure = ((error as { lastError?: unknown }).lastError ?? error) as {\n    status?: unknown;\n    statusCode?: unknown;\n    headers?: unknown;\n    responseHeaders?: unknown;\n  };\n  if ((failure.status ?? failure.statusCode) !== 429) return error;\n  return new ThrottledError(\n    AI_ERROR_MESSAGES.rate_limited,\n    parseRetryAfter(\n      retryAfterHeader(failure.headers ?? failure.responseHeaders),\n    ),\n  );\n}\n"],"mappings":";;;;;AAMA,SAAgB,SAAY,OAAgB,SAAkC;CAC5E,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,KAAA;CACxD,MAAM,SAAS;CACf,OAAO,OAAO,YAAY,WAAW,MAAM,QAAQ,OAAO,OAAO,IAC5D,OAAO,UACR,KAAA;AACN;;AAGA,SAAgB,UACd,OACyB;CACzB,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,IAAI;EACF,MAAM,SAAkB,KAAK,MAAM,KAAK;EACxC,OAAO,OAAO,WAAW,YACvB,WAAW,QACX,CAAC,MAAM,QAAQ,MAAM,IAClB,SACD,CAAC;CACP,QAAQ;EACN,OAAO,CAAC;CACV;AACF;;AAGA,SAAgB,cAAc,OAAyC;CACrE,OAAO,OAAO,UAAU,WAAW,QAAQ,KAAK,UAAU,KAAK;AACjE;;AAGA,eAAsB,WAAW,MAA6B;CAC5D,MAAM,QAAQ,IAAI,WAAW,MAAM,KAAK,YAAY,CAAC;CACrD,IAAI,SAAS;CACb,KAAK,IAAI,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS,OACjD,UAAU,OAAO,aAAa,GAAG,MAAM,SAAS,OAAO,QAAQ,KAAM,CAAC;CAExE,OAAO,KAAK,MAAM;AACpB;;AAGA,SAAgB,UAAoB;CAClC,OAAO,IAAI,SACT,kBAAkB,mBAClB,KACA,mBACF;AACF;;AAGA,SAAgB,SAAmB;CACjC,OAAO,IAAI,SACT,kBAAkB,mBAClB,KACA,mBACF;AACF;AAEA,SAAS,iBAAiB,SAAiC;CACzD,IAAI,OAAO,YAAY,eAAe,mBAAmB,SACvD,OAAO,QAAQ,IAAI,aAAa;CAClC,IAAI,OAAO,YAAY,YAAY,YAAY,MAAM,OAAO;CAC5D,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,OAAO,GAChD,IAAI,KAAK,YAAY,MAAM,iBAAiB,OAAO,UAAU,UAC3D,OAAO;CAEX,OAAO;AACT;;;;;;;AAQA,SAAgB,cAAc,OAAyB;CACrD,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,UAAY,MAAkC,aAAa;CAMjE,KAAK,QAAQ,UAAU,QAAQ,gBAAgB,KAAK,OAAO;CAC3D,OAAO,IAAI,eACT,kBAAkB,cAClB,gBACE,iBAAiB,QAAQ,WAAW,QAAQ,eAAe,CAC7D,CACF;AACF"}

package/dist/testing/index.d.ts

@@ -1,8 +1,7 @@
-import { t as AiModelAdapter } from "../model-xJvGTfLB.js";
-import { t as HttpAiFeatures } from "../http-provider-Cb41NXd5.js";
-import { C as AiWireEvent } from "../wire-Cv7Fk-7n.js";
+import { t as AiModelAdapter } from "../model-VqqOlLS2.js";
+import { t as HttpAiFeatures } from "../http-provider-B5riig95.js";
+import { C as AiWireEvent } from "../wire-BJ4-EWvR.js";
 import { AiAltTextRequest, AiAppliedBatch, AiChatAttachment, AiChatRequest, AiFixFinding, AiFixRequest, AiMergeTags, AiOperationsResult, AiProvider, AiRewriteRequest, AiTurnHandlers, Operation, TemplateContent } from "@templatical/types";
-//#region src/testing/conformance.d.ts
 interface AiConformanceCheck {
   name: string;
   ok: boolean;
@@ -30,8 +29,6 @@ interface AiConformanceOptions {
  * once against a stand-in editor that applies `operations` with the engine.
  */
 export declare function runAiProviderConformance(provider: AiProvider, options?: AiConformanceOptions): Promise<AiConformanceReport>;
-//#endregion
-//#region src/testing/wire-conformance.d.ts
 interface AiWireConformanceOptions {
   baseUrl: string;
   features?: HttpAiFeatures;
@@ -49,8 +46,6 @@ interface AiWireConformanceOptions {
  * JSON error. For a backend in any language; run it from Node (no CORS).
  */
 export declare function runAiWireConformance(options: AiWireConformanceOptions): Promise<AiConformanceReport>;
-//#endregion
-//#region src/testing/mock-provider.d.ts
 /** A wire event to play, or a pause. */
 type AiRecordedEvent = AiWireEvent | {
   delayMs: number;
@@ -83,16 +78,12 @@ interface AiMockScript {
  * after settlement.
  */
 export declare function createMockAiProvider(script: AiMockScript): AiProvider;
-//#endregion
-//#region src/testing/recordings.d.ts
 /**
  * Scripted turns for any template: the playground's AI scene and the
  * conformance suite's self-test play them. Chat answers "dark", "title" and
  * "fail" specially and otherwise adds a closing paragraph.
  */
 export declare const AI_RECORDINGS: AiMockScript;
-//#endregion
-//#region src/testing/eval-set.d.ts
 type AiEvalCheck = {
   type: "applied" | "notApplied";
 } | {
@@ -248,8 +239,6 @@ export declare function evalAltTextWith(model: AiModelAdapter, options?: {
 export declare function evalTurnWith(model: AiModelAdapter, options?: {
   maxSteps?: number;
 }): (input: AiEvalTurnInput) => Promise<AiEvalTurnOutput>;
-//#endregion
-//#region src/testing/stand-in-editor.d.ts
 /** The editor the suites drive: `onOperations` applies with the engine. */
 interface StandInEditor {
   content: TemplateContent;
@@ -272,6 +261,5 @@ interface StandInEditor {
   };
 }
 export declare function createStandInEditor(content: TemplateContent, mergeTags?: AiMergeTags): StandInEditor;
-//#endregion
 export type { AiConformanceCheck, AiConformanceOptions, AiConformanceReport, AiEvalAltCheck, AiEvalAltTextInput, AiEvalCase, AiEvalCheck, AiEvalReport, AiEvalTurnInput, AiEvalTurnOutput, AiMockScript, AiRecordedEvent, AiRecordedTurn, AiRecording, AiWireConformanceOptions, StandInEditor };
 //# sourceMappingURL=index.d.ts.map

package/dist/testing/index.js

@@ -1,12 +1,11 @@
-import { l as aiRoutePath, o as AI_SESSION_HEADER, s as AI_WIRE_HEADER, t as AI_ERROR_MESSAGES, u as matchAiRoute } from "../wire-B6AF_UGT.js";
-import { n as errorFromEvent } from "../errors-DWshWx18.js";
-import { n as createHttpAiProviderWithFetch } from "../http-provider-Cx2ZcLRB.js";
-import { g as buildChatRequest, h as buildAltTextRequest, i as checkAltTextAnswer, o as runEditingTurn, p as walkBlocks, r as checkAltText, t as buildAltTextRepairRequest, v as buildFixRequest } from "../checks-DvLD3892.js";
+import { l as aiRoutePath, o as AI_SESSION_HEADER, s as AI_WIRE_HEADER, t as AI_ERROR_MESSAGES, u as matchAiRoute } from "../wire-cYO4W7GH.js";
+import { n as errorFromEvent } from "../errors-BtORdtK2.js";
+import { n as createHttpAiProviderWithFetch } from "../http-provider-DLJYM4l8.js";
+import { g as buildChatRequest, h as buildAltTextRequest, i as checkAltTextAnswer, o as runEditingTurn, p as walkBlocks, r as checkAltText, t as buildAltTextRepairRequest, v as buildFixRequest } from "../checks-B-TtaywP.js";
 import { CollaborationConflict, OperationError, SdkError, applyOperations, createButtonBlock, createParagraphBlock, createTitleBlock, invertOperations, safeClone } from "@templatical/types";
-//#region package.json
-var version = "0.51.1";
-//#endregion
-//#region eval/cases.json
+// package.json
+var version = "0.52.0";
+// eval/cases.json
 var cases_default = [
 	{
 		"name": "button text",
@@ -652,8 +651,7 @@ var cases_default = [
 		]
 	}
 ];
-//#endregion
-//#region eval/empty.json
+// eval/empty.json
 var empty_default = {
 	blocks: [],
 	settings: {
@@ -665,8 +663,7 @@ var empty_default = {
 		"locale": "en"
 	}
 };
-//#endregion
-//#region eval/domain-mismatch.json
+// eval/domain-mismatch.json
 var domain_mismatch_default = {
 	blocks: [{
 		"id": "domain-link",
@@ -688,8 +685,7 @@ var domain_mismatch_default = {
 		"locale": "en"
 	}
 };
-//#endregion
-//#region eval/low-text.json
+// eval/low-text.json
 var low_text_default = {
 	blocks: [{
 		"id": "mug-image",
@@ -724,8 +720,7 @@ var low_text_default = {
 		"locale": "en"
 	}
 };
-//#endregion
-//#region eval/injection.json
+// eval/injection.json
 var injection_default = {
 	blocks: [
 		{
@@ -867,8 +862,7 @@ var injection_default = {
 		"locale": "en"
 	}
 };
-//#endregion
-//#region eval/promo.json
+// eval/promo.json
 var promo_default = {
 	blocks: [
 		{
@@ -999,8 +993,7 @@ var promo_default = {
 		"locale": "de"
 	}
 };
-//#endregion
-//#region eval/welcome.json
+// eval/welcome.json
 var welcome_default = {
 	blocks: [
 		{
@@ -1131,8 +1124,7 @@ var welcome_default = {
 		"locale": "en"
 	}
 };
-//#endregion
-//#region src/testing/eval-set.ts
+// src/testing/eval-set.ts
 /** The cases of S7's test set (`eval/cases.json`). An omitted kind means edit. */
 const AI_EVAL_CASES = cases_default;
 const AI_EVAL_TEMPLATES = {
@@ -1428,8 +1420,7 @@ function evalTurnWith(model, options = {}) {
 		};
 	};
 }
-//#endregion
-//#region src/testing/checks.ts
+// src/testing/checks.ts
 const KNOWN_CODES = /* @__PURE__ */ new Set([
 	"feature_unavailable",
 	"limit_reached",
@@ -1463,8 +1454,7 @@ function messageProblem(message) {
 	if (!m || typeof m.id !== "string" || !["user", "assistant"].includes(m.role) || !["chat", "fix"].includes(m.kind) || typeof m.text !== "string" || m.attachments !== void 0 && (!Array.isArray(m.attachments) || !m.attachments.every((a) => a && typeof a.name === "string" && ["image", "pdf"].includes(a.kind))) || !Array.isArray(m.batches) || typeof m.undone !== "boolean" || typeof m.createdAt !== "string" || !m.batches.every((batch) => typeof batch.batchId === "string" && (batch.revision === null || Number.isInteger(batch.revision)) && Number.isInteger(batch.operationCount))) return `malformed message: ${JSON.stringify(message)}`;
 	return null;
 }
-//#endregion
-//#region src/testing/stand-in-editor.ts
+// src/testing/stand-in-editor.ts
 function createStandInEditor(content, mergeTags = {
 	syntax: "liquid",
 	tags: []
@@ -1519,8 +1509,7 @@ function createStandInEditor(content, mergeTags = {
 	};
 	return editor;
 }
-//#endregion
-//#region src/testing/conformance.ts
+// src/testing/conformance.ts
 const FEATURES = [
 	"chat",
 	"fixFinding",
@@ -1898,8 +1887,7 @@ async function runAiProviderConformance(provider, options = {}) {
 		checks
 	};
 }
-//#endregion
-//#region src/testing/wire-conformance.ts
+// src/testing/wire-conformance.ts
 /**
 * The provider suite over the wire, through `createHttpAiProvider`, plus the
 * wire's own rules: every response carries `Templatical-AI-Wire: 1`, streams
@@ -2077,8 +2065,7 @@ async function runAiWireConformance(options) {
 		checks: all
 	};
 }
-//#endregion
-//#region src/testing/mock-provider.ts
+// src/testing/mock-provider.ts
 function stopped(signal) {
 	const reason = signal.reason;
 	return reason instanceof Error && reason.name === "AbortError" ? reason : new DOMException("The AI request was stopped.", "AbortError");
@@ -2271,8 +2258,7 @@ function createMockAiProvider(script) {
 		} } : {}
 	};
 }
-//#endregion
-//#region src/testing/recordings.ts
+// src/testing/recordings.ts
 const text = (value) => ({
 	type: "text",
 	text: value
@@ -2439,7 +2425,6 @@ const AI_RECORDINGS = {
 		];
 	}
 };
-//#endregion
 export { AI_CONFORMANCE_ALT_TEXT_IMAGE_URL, AI_EVAL_CASES, AI_EVAL_MERGE_TAGS, AI_EVAL_TEMPLATES, AI_RECORDINGS, checkEvalCase, createMockAiProvider, createStandInEditor, evalAltTextWith, evalTurnWith, runAiEvalSet, runAiProviderConformance, runAiWireConformance };
 
 //# sourceMappingURL=index.js.map