gsd-pi 2.68.0 → 2.68.1-dev.58193fa

package/packages/pi-ai/dist/providers/provider-capabilities.js

@@ -0,0 +1,173 @@
+// GSD-2 — Provider Capabilities Registry (ADR-005 Phase 1)
+// Declarative registry of what each API provider supports, consolidating
+// scattered knowledge from *-shared.ts files into a queryable data structure.
+// ─── Registry ───────────────────────────────────────────────────────────────
+/**
+ * Built-in provider capability profiles.
+ *
+ * Sources (consolidated from scattered *-shared.ts files):
+ * - anthropic-shared.ts: normalizeToolCallId (64-char, [a-zA-Z0-9_-])
+ * - openai-responses-shared.ts: ID normalization (64-char, fc_ prefix), image-in-tool-result workaround
+ * - google-shared.ts: sanitizeSchemaForGoogle (patternProperties, const), requiresToolCallId
+ * - mistral.ts: MISTRAL_TOOL_CALL_ID_LENGTH = 9
+ * - amazon-bedrock.ts: normalizeToolCallId (64-char, [a-zA-Z0-9_-])
+ */
+export const PROVIDER_CAPABILITIES = {
+    "anthropic-messages": {
+        toolCalling: true,
+        maxTools: 0,
+        imageToolResults: true,
+        structuredOutput: true,
+        toolCallIdFormat: { maxLength: 64, allowedChars: /^[a-zA-Z0-9_-]+$/ },
+        thinkingPersistence: "full",
+        unsupportedSchemaFeatures: [],
+    },
+    "anthropic-vertex": {
+        toolCalling: true,
+        maxTools: 0,
+        imageToolResults: true,
+        structuredOutput: true,
+        toolCallIdFormat: { maxLength: 64, allowedChars: /^[a-zA-Z0-9_-]+$/ },
+        thinkingPersistence: "full",
+        unsupportedSchemaFeatures: [],
+    },
+    "openai-responses": {
+        toolCalling: true,
+        maxTools: 0,
+        imageToolResults: false, // images sent as separate user message, not in tool result
+        structuredOutput: true,
+        toolCallIdFormat: { maxLength: 512, allowedChars: /^.+$/ },
+        thinkingPersistence: "text-only",
+        unsupportedSchemaFeatures: [],
+    },
+    "azure-openai-responses": {
+        toolCalling: true,
+        maxTools: 0,
+        imageToolResults: false,
+        structuredOutput: true,
+        toolCallIdFormat: { maxLength: 512, allowedChars: /^.+$/ },
+        thinkingPersistence: "text-only",
+        unsupportedSchemaFeatures: [],
+    },
+    "openai-codex-responses": {
+        toolCalling: true,
+        maxTools: 0,
+        imageToolResults: false,
+        structuredOutput: true,
+        toolCallIdFormat: { maxLength: 64, allowedChars: /^[a-zA-Z0-9_-]+$/ },
+        thinkingPersistence: "text-only",
+        unsupportedSchemaFeatures: [],
+    },
+    "openai-completions": {
+        toolCalling: true,
+        maxTools: 0,
+        imageToolResults: false,
+        structuredOutput: true,
+        toolCallIdFormat: { maxLength: 64, allowedChars: /^[a-zA-Z0-9_-]+$/ },
+        thinkingPersistence: "text-only",
+        unsupportedSchemaFeatures: [],
+    },
+    "google-generative-ai": {
+        toolCalling: true,
+        maxTools: 0,
+        imageToolResults: true,
+        structuredOutput: true,
+        toolCallIdFormat: { maxLength: 64, allowedChars: /^[a-zA-Z0-9_-]+$/ },
+        thinkingPersistence: "text-only",
+        unsupportedSchemaFeatures: ["patternProperties", "const"],
+    },
+    "google-gemini-cli": {
+        toolCalling: true,
+        maxTools: 0,
+        imageToolResults: true,
+        structuredOutput: true,
+        toolCallIdFormat: { maxLength: 64, allowedChars: /^[a-zA-Z0-9_-]+$/ },
+        thinkingPersistence: "text-only",
+        unsupportedSchemaFeatures: ["patternProperties", "const"],
+    },
+    "google-vertex": {
+        toolCalling: true,
+        maxTools: 0,
+        imageToolResults: true,
+        structuredOutput: true,
+        toolCallIdFormat: { maxLength: 64, allowedChars: /^[a-zA-Z0-9_-]+$/ },
+        thinkingPersistence: "text-only",
+        unsupportedSchemaFeatures: ["patternProperties", "const"],
+    },
+    "mistral-conversations": {
+        toolCalling: true,
+        maxTools: 0,
+        imageToolResults: false,
+        structuredOutput: true,
+        toolCallIdFormat: { maxLength: 9, allowedChars: /^[a-zA-Z0-9]+$/ },
+        thinkingPersistence: "none",
+        unsupportedSchemaFeatures: [],
+    },
+    "bedrock-converse-stream": {
+        toolCalling: true,
+        maxTools: 0,
+        imageToolResults: true, // Bedrock supports image content blocks in tool results
+        structuredOutput: true,
+        toolCallIdFormat: { maxLength: 64, allowedChars: /^[a-zA-Z0-9_-]+$/ },
+        thinkingPersistence: "text-only",
+        unsupportedSchemaFeatures: [],
+    },
+    "ollama-chat": {
+        toolCalling: true,
+        maxTools: 0,
+        imageToolResults: false,
+        structuredOutput: false,
+        toolCallIdFormat: { maxLength: 64, allowedChars: /^[a-zA-Z0-9_-]+$/ },
+        thinkingPersistence: "none",
+        unsupportedSchemaFeatures: [],
+    },
+};
+// ─── Default (permissive) profile for unknown providers ─────────────────────
+const DEFAULT_CAPABILITIES = {
+    toolCalling: true,
+    maxTools: 0,
+    imageToolResults: true,
+    structuredOutput: true,
+    toolCallIdFormat: { maxLength: 512, allowedChars: /^.+$/ },
+    thinkingPersistence: "text-only",
+    unsupportedSchemaFeatures: [],
+};
+// ─── Public API ─────────────────────────────────────────────────────────────
+/**
+ * Get capabilities for a provider API. Returns a permissive default for
+ * unknown providers (preserving existing behavior per ADR-005 principle 5).
+ */
+export function getProviderCapabilities(api) {
+    return PROVIDER_CAPABILITIES[api] ?? DEFAULT_CAPABILITIES;
+}
+/**
+ * Check if a provider supports all required schema features.
+ * Returns the list of unsupported features (empty if all supported).
+ */
+export function getUnsupportedFeatures(api, requiredFeatures) {
+    const caps = getProviderCapabilities(api);
+    return requiredFeatures.filter(f => caps.unsupportedSchemaFeatures.includes(f));
+}
+/**
+ * Deep-merge user-provided capability overrides with built-in defaults.
+ * Partial overrides merge with the built-in profile for the given API.
+ */
+export function mergeCapabilityOverrides(api, overrides) {
+    const base = getProviderCapabilities(api);
+    return {
+        ...base,
+        ...overrides,
+        toolCallIdFormat: overrides.toolCallIdFormat
+            ? { ...base.toolCallIdFormat, ...overrides.toolCallIdFormat }
+            : base.toolCallIdFormat,
+    };
+}
+/**
+ * Get all registered API names in the capability registry.
+ * Used by lint rules to verify all providers in register-builtins.ts
+ * have corresponding capability entries.
+ */
+export function getRegisteredApis() {
+    return Object.keys(PROVIDER_CAPABILITIES);
+}
+//# sourceMappingURL=provider-capabilities.js.map

package/packages/pi-ai/dist/providers/provider-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-capabilities.js","sourceRoot":"","sources":["../../src/providers/provider-capabilities.ts"],"names":[],"mappings":"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","sourcesContent":["// GSD-2 — Provider Capabilities Registry (ADR-005 Phase 1)\n// Declarative registry of what each API provider supports, consolidating\n// scattered knowledge from *-shared.ts files into a queryable data structure.\n\nimport type { Api } from \"../types.js\";\n\n// ─── Types ──────────────────────────────────────────────────────────────────\n\n/**\n * Declarative capability profile for an API provider.\n * Used by the model router to filter incompatible models and by the tool\n * system to adjust tool sets per provider.\n */\nexport interface ProviderCapabilities {\n  /** Whether models from this provider support tool/function calling */\n  toolCalling: boolean;\n  /** Maximum number of tools the provider handles well (0 = unlimited) */\n  maxTools: number;\n  /** Whether tool results can contain images */\n  imageToolResults: boolean;\n  /** Whether the provider supports structured JSON output */\n  structuredOutput: boolean;\n  /** Tool call ID format constraints */\n  toolCallIdFormat: {\n    maxLength: number;\n    allowedChars: RegExp;\n  };\n  /** Whether thinking/reasoning blocks are preserved cross-turn */\n  thinkingPersistence: \"full\" | \"text-only\" | \"none\";\n  /** Schema features NOT supported (tools using these get filtered) */\n  unsupportedSchemaFeatures: string[];\n}\n\n// ─── Registry ───────────────────────────────────────────────────────────────\n\n/**\n * Built-in provider capability profiles.\n *\n * Sources (consolidated from scattered *-shared.ts files):\n * - anthropic-shared.ts: normalizeToolCallId (64-char, [a-zA-Z0-9_-])\n * - openai-responses-shared.ts: ID normalization (64-char, fc_ prefix), image-in-tool-result workaround\n * - google-shared.ts: sanitizeSchemaForGoogle (patternProperties, const), requiresToolCallId\n * - mistral.ts: MISTRAL_TOOL_CALL_ID_LENGTH = 9\n * - amazon-bedrock.ts: normalizeToolCallId (64-char, [a-zA-Z0-9_-])\n */\nexport const PROVIDER_CAPABILITIES: Record<string, ProviderCapabilities> = {\n  \"anthropic-messages\": {\n    toolCalling: true,\n    maxTools: 0,\n    imageToolResults: true,\n    structuredOutput: true,\n    toolCallIdFormat: { maxLength: 64, allowedChars: /^[a-zA-Z0-9_-]+$/ },\n    thinkingPersistence: \"full\",\n    unsupportedSchemaFeatures: [],\n  },\n  \"anthropic-vertex\": {\n    toolCalling: true,\n    maxTools: 0,\n    imageToolResults: true,\n    structuredOutput: true,\n    toolCallIdFormat: { maxLength: 64, allowedChars: /^[a-zA-Z0-9_-]+$/ },\n    thinkingPersistence: \"full\",\n    unsupportedSchemaFeatures: [],\n  },\n  \"openai-responses\": {\n    toolCalling: true,\n    maxTools: 0,\n    imageToolResults: false,  // images sent as separate user message, not in tool result\n    structuredOutput: true,\n    toolCallIdFormat: { maxLength: 512, allowedChars: /^.+$/ },\n    thinkingPersistence: \"text-only\",\n    unsupportedSchemaFeatures: [],\n  },\n  \"azure-openai-responses\": {\n    toolCalling: true,\n    maxTools: 0,\n    imageToolResults: false,\n    structuredOutput: true,\n    toolCallIdFormat: { maxLength: 512, allowedChars: /^.+$/ },\n    thinkingPersistence: \"text-only\",\n    unsupportedSchemaFeatures: [],\n  },\n  \"openai-codex-responses\": {\n    toolCalling: true,\n    maxTools: 0,\n    imageToolResults: false,\n    structuredOutput: true,\n    toolCallIdFormat: { maxLength: 64, allowedChars: /^[a-zA-Z0-9_-]+$/ },\n    thinkingPersistence: \"text-only\",\n    unsupportedSchemaFeatures: [],\n  },\n  \"openai-completions\": {\n    toolCalling: true,\n    maxTools: 0,\n    imageToolResults: false,\n    structuredOutput: true,\n    toolCallIdFormat: { maxLength: 64, allowedChars: /^[a-zA-Z0-9_-]+$/ },\n    thinkingPersistence: \"text-only\",\n    unsupportedSchemaFeatures: [],\n  },\n  \"google-generative-ai\": {\n    toolCalling: true,\n    maxTools: 0,\n    imageToolResults: true,\n    structuredOutput: true,\n    toolCallIdFormat: { maxLength: 64, allowedChars: /^[a-zA-Z0-9_-]+$/ },\n    thinkingPersistence: \"text-only\",\n    unsupportedSchemaFeatures: [\"patternProperties\", \"const\"],\n  },\n  \"google-gemini-cli\": {\n    toolCalling: true,\n    maxTools: 0,\n    imageToolResults: true,\n    structuredOutput: true,\n    toolCallIdFormat: { maxLength: 64, allowedChars: /^[a-zA-Z0-9_-]+$/ },\n    thinkingPersistence: \"text-only\",\n    unsupportedSchemaFeatures: [\"patternProperties\", \"const\"],\n  },\n  \"google-vertex\": {\n    toolCalling: true,\n    maxTools: 0,\n    imageToolResults: true,\n    structuredOutput: true,\n    toolCallIdFormat: { maxLength: 64, allowedChars: /^[a-zA-Z0-9_-]+$/ },\n    thinkingPersistence: \"text-only\",\n    unsupportedSchemaFeatures: [\"patternProperties\", \"const\"],\n  },\n  \"mistral-conversations\": {\n    toolCalling: true,\n    maxTools: 0,\n    imageToolResults: false,\n    structuredOutput: true,\n    toolCallIdFormat: { maxLength: 9, allowedChars: /^[a-zA-Z0-9]+$/ },\n    thinkingPersistence: \"none\",\n    unsupportedSchemaFeatures: [],\n  },\n  \"bedrock-converse-stream\": {\n    toolCalling: true,\n    maxTools: 0,\n    imageToolResults: true,  // Bedrock supports image content blocks in tool results\n    structuredOutput: true,\n    toolCallIdFormat: { maxLength: 64, allowedChars: /^[a-zA-Z0-9_-]+$/ },\n    thinkingPersistence: \"text-only\",\n    unsupportedSchemaFeatures: [],\n  },\n  \"ollama-chat\": {\n    toolCalling: true,\n    maxTools: 0,\n    imageToolResults: false,\n    structuredOutput: false,\n    toolCallIdFormat: { maxLength: 64, allowedChars: /^[a-zA-Z0-9_-]+$/ },\n    thinkingPersistence: \"none\",\n    unsupportedSchemaFeatures: [],\n  },\n};\n\n// ─── Default (permissive) profile for unknown providers ─────────────────────\n\nconst DEFAULT_CAPABILITIES: ProviderCapabilities = {\n  toolCalling: true,\n  maxTools: 0,\n  imageToolResults: true,\n  structuredOutput: true,\n  toolCallIdFormat: { maxLength: 512, allowedChars: /^.+$/ },\n  thinkingPersistence: \"text-only\",\n  unsupportedSchemaFeatures: [],\n};\n\n// ─── Public API ─────────────────────────────────────────────────────────────\n\n/**\n * Get capabilities for a provider API. Returns a permissive default for\n * unknown providers (preserving existing behavior per ADR-005 principle 5).\n */\nexport function getProviderCapabilities(api: string): ProviderCapabilities {\n  return PROVIDER_CAPABILITIES[api] ?? DEFAULT_CAPABILITIES;\n}\n\n/**\n * Check if a provider supports all required schema features.\n * Returns the list of unsupported features (empty if all supported).\n */\nexport function getUnsupportedFeatures(api: string, requiredFeatures: string[]): string[] {\n  const caps = getProviderCapabilities(api);\n  return requiredFeatures.filter(f => caps.unsupportedSchemaFeatures.includes(f));\n}\n\n/**\n * Deep-merge user-provided capability overrides with built-in defaults.\n * Partial overrides merge with the built-in profile for the given API.\n */\nexport function mergeCapabilityOverrides(\n  api: string,\n  overrides: Partial<Omit<ProviderCapabilities, \"toolCallIdFormat\">> & {\n    toolCallIdFormat?: Partial<ProviderCapabilities[\"toolCallIdFormat\"]>;\n  },\n): ProviderCapabilities {\n  const base = getProviderCapabilities(api);\n  return {\n    ...base,\n    ...overrides,\n    toolCallIdFormat: overrides.toolCallIdFormat\n      ? { ...base.toolCallIdFormat, ...overrides.toolCallIdFormat }\n      : base.toolCallIdFormat,\n  };\n}\n\n/**\n * Get all registered API names in the capability registry.\n * Used by lint rules to verify all providers in register-builtins.ts\n * have corresponding capability entries.\n */\nexport function getRegisteredApis(): string[] {\n  return Object.keys(PROVIDER_CAPABILITIES);\n}\n"]}

package/packages/pi-ai/dist/providers/provider-capabilities.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider-capabilities.test.d.ts.map

package/packages/pi-ai/dist/providers/provider-capabilities.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-capabilities.test.d.ts","sourceRoot":"","sources":["../../src/providers/provider-capabilities.test.ts"],"names":[],"mappings":""}

package/packages/pi-ai/dist/providers/provider-capabilities.test.js

@@ -0,0 +1,132 @@
+// GSD-2 — Provider Capabilities Registry Tests (ADR-005 Phase 1)
+import { describe, test } from "node:test";
+import assert from "node:assert/strict";
+import { PROVIDER_CAPABILITIES, getProviderCapabilities, getUnsupportedFeatures, mergeCapabilityOverrides, getRegisteredApis, } from "./provider-capabilities.js";
+// ─── Registry Completeness ──────────────────────────────────────────────────
+describe("PROVIDER_CAPABILITIES registry", () => {
+    const EXPECTED_APIS = [
+        "anthropic-messages",
+        "anthropic-vertex",
+        "openai-responses",
+        "azure-openai-responses",
+        "openai-codex-responses",
+        "openai-completions",
+        "google-generative-ai",
+        "google-gemini-cli",
+        "google-vertex",
+        "mistral-conversations",
+        "bedrock-converse-stream",
+        "ollama-chat",
+    ];
+    test("covers all expected API providers", () => {
+        for (const api of EXPECTED_APIS) {
+            assert.ok(PROVIDER_CAPABILITIES[api], `Missing capability entry for API: ${api}`);
+        }
+    });
+    test("getRegisteredApis returns all entries", () => {
+        const registered = getRegisteredApis();
+        for (const api of EXPECTED_APIS) {
+            assert.ok(registered.includes(api), `getRegisteredApis missing: ${api}`);
+        }
+    });
+    test("all entries have required fields", () => {
+        for (const [api, caps] of Object.entries(PROVIDER_CAPABILITIES)) {
+            assert.equal(typeof caps.toolCalling, "boolean", `${api}.toolCalling`);
+            assert.equal(typeof caps.maxTools, "number", `${api}.maxTools`);
+            assert.equal(typeof caps.imageToolResults, "boolean", `${api}.imageToolResults`);
+            assert.equal(typeof caps.structuredOutput, "boolean", `${api}.structuredOutput`);
+            assert.ok(caps.toolCallIdFormat, `${api}.toolCallIdFormat`);
+            assert.equal(typeof caps.toolCallIdFormat.maxLength, "number", `${api}.toolCallIdFormat.maxLength`);
+            assert.ok(caps.toolCallIdFormat.allowedChars instanceof RegExp, `${api}.toolCallIdFormat.allowedChars`);
+            assert.ok(["full", "text-only", "none"].includes(caps.thinkingPersistence), `${api}.thinkingPersistence is "${caps.thinkingPersistence}"`);
+            assert.ok(Array.isArray(caps.unsupportedSchemaFeatures), `${api}.unsupportedSchemaFeatures`);
+        }
+    });
+});
+// ─── Provider-specific Values ───────────────────────────────────────────────
+describe("provider-specific capabilities", () => {
+    test("Anthropic supports full thinking persistence", () => {
+        assert.equal(PROVIDER_CAPABILITIES["anthropic-messages"].thinkingPersistence, "full");
+    });
+    test("Anthropic supports image tool results", () => {
+        assert.equal(PROVIDER_CAPABILITIES["anthropic-messages"].imageToolResults, true);
+    });
+    test("Anthropic tool call ID is 64 chars max", () => {
+        assert.equal(PROVIDER_CAPABILITIES["anthropic-messages"].toolCallIdFormat.maxLength, 64);
+    });
+    test("Mistral tool call ID is 9 chars max", () => {
+        assert.equal(PROVIDER_CAPABILITIES["mistral-conversations"].toolCallIdFormat.maxLength, 9);
+    });
+    test("Mistral has no thinking persistence", () => {
+        assert.equal(PROVIDER_CAPABILITIES["mistral-conversations"].thinkingPersistence, "none");
+    });
+    test("Google does not support patternProperties", () => {
+        assert.ok(PROVIDER_CAPABILITIES["google-generative-ai"].unsupportedSchemaFeatures.includes("patternProperties"));
+    });
+    test("Google does not support const", () => {
+        assert.ok(PROVIDER_CAPABILITIES["google-generative-ai"].unsupportedSchemaFeatures.includes("const"));
+    });
+    test("OpenAI Responses does not support image tool results", () => {
+        assert.equal(PROVIDER_CAPABILITIES["openai-responses"].imageToolResults, false);
+    });
+    test("OpenAI Responses has text-only thinking persistence", () => {
+        assert.equal(PROVIDER_CAPABILITIES["openai-responses"].thinkingPersistence, "text-only");
+    });
+});
+// ─── getProviderCapabilities ────────────────────────────────────────────────
+describe("getProviderCapabilities", () => {
+    test("returns known provider capabilities", () => {
+        const caps = getProviderCapabilities("anthropic-messages");
+        assert.equal(caps.toolCalling, true);
+        assert.equal(caps.thinkingPersistence, "full");
+    });
+    test("returns permissive defaults for unknown providers", () => {
+        const caps = getProviderCapabilities("unknown-provider-xyz");
+        assert.equal(caps.toolCalling, true);
+        assert.equal(caps.imageToolResults, true);
+        assert.deepEqual(caps.unsupportedSchemaFeatures, []);
+    });
+});
+// ─── getUnsupportedFeatures ─────────────────────────────────────────────────
+describe("getUnsupportedFeatures", () => {
+    test("returns unsupported features for Google", () => {
+        const unsupported = getUnsupportedFeatures("google-generative-ai", ["patternProperties", "const"]);
+        assert.deepEqual(unsupported, ["patternProperties", "const"]);
+    });
+    test("returns empty for Anthropic with any features", () => {
+        const unsupported = getUnsupportedFeatures("anthropic-messages", ["patternProperties", "const"]);
+        assert.deepEqual(unsupported, []);
+    });
+    test("returns empty for unknown provider", () => {
+        const unsupported = getUnsupportedFeatures("unknown-xyz", ["patternProperties"]);
+        assert.deepEqual(unsupported, []);
+    });
+});
+// ─── mergeCapabilityOverrides ───────────────────────────────────────────────
+describe("mergeCapabilityOverrides", () => {
+    test("overrides individual fields", () => {
+        const merged = mergeCapabilityOverrides("openai-responses", {
+            imageToolResults: true,
+        });
+        assert.equal(merged.imageToolResults, true);
+        // Non-overridden fields preserved
+        assert.equal(merged.toolCalling, true);
+        assert.equal(merged.thinkingPersistence, "text-only");
+    });
+    test("deep-merges toolCallIdFormat", () => {
+        const merged = mergeCapabilityOverrides("anthropic-messages", {
+            toolCallIdFormat: { maxLength: 128 },
+        });
+        assert.equal(merged.toolCallIdFormat.maxLength, 128);
+        // allowedChars preserved from base
+        assert.ok(merged.toolCallIdFormat.allowedChars instanceof RegExp);
+    });
+    test("uses permissive defaults for unknown provider", () => {
+        const merged = mergeCapabilityOverrides("unknown-xyz", {
+            imageToolResults: false,
+        });
+        assert.equal(merged.imageToolResults, false);
+        assert.equal(merged.toolCalling, true); // from default
+    });
+});
+//# sourceMappingURL=provider-capabilities.test.js.map

package/packages/pi-ai/dist/providers/provider-capabilities.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-capabilities.test.js","sourceRoot":"","sources":["../../src/providers/provider-capabilities.test.ts"],"names":[],"mappings":"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","sourcesContent":["// GSD-2 — Provider Capabilities Registry Tests (ADR-005 Phase 1)\nimport { describe, test } from \"node:test\";\nimport assert from \"node:assert/strict\";\n\nimport {\n  PROVIDER_CAPABILITIES,\n  getProviderCapabilities,\n  getUnsupportedFeatures,\n  mergeCapabilityOverrides,\n  getRegisteredApis,\n} from \"./provider-capabilities.js\";\n\n// ─── Registry Completeness ──────────────────────────────────────────────────\n\ndescribe(\"PROVIDER_CAPABILITIES registry\", () => {\n  const EXPECTED_APIS = [\n    \"anthropic-messages\",\n    \"anthropic-vertex\",\n    \"openai-responses\",\n    \"azure-openai-responses\",\n    \"openai-codex-responses\",\n    \"openai-completions\",\n    \"google-generative-ai\",\n    \"google-gemini-cli\",\n    \"google-vertex\",\n    \"mistral-conversations\",\n    \"bedrock-converse-stream\",\n    \"ollama-chat\",\n  ];\n\n  test(\"covers all expected API providers\", () => {\n    for (const api of EXPECTED_APIS) {\n      assert.ok(\n        PROVIDER_CAPABILITIES[api],\n        `Missing capability entry for API: ${api}`,\n      );\n    }\n  });\n\n  test(\"getRegisteredApis returns all entries\", () => {\n    const registered = getRegisteredApis();\n    for (const api of EXPECTED_APIS) {\n      assert.ok(registered.includes(api), `getRegisteredApis missing: ${api}`);\n    }\n  });\n\n  test(\"all entries have required fields\", () => {\n    for (const [api, caps] of Object.entries(PROVIDER_CAPABILITIES)) {\n      assert.equal(typeof caps.toolCalling, \"boolean\", `${api}.toolCalling`);\n      assert.equal(typeof caps.maxTools, \"number\", `${api}.maxTools`);\n      assert.equal(typeof caps.imageToolResults, \"boolean\", `${api}.imageToolResults`);\n      assert.equal(typeof caps.structuredOutput, \"boolean\", `${api}.structuredOutput`);\n      assert.ok(caps.toolCallIdFormat, `${api}.toolCallIdFormat`);\n      assert.equal(typeof caps.toolCallIdFormat.maxLength, \"number\", `${api}.toolCallIdFormat.maxLength`);\n      assert.ok(caps.toolCallIdFormat.allowedChars instanceof RegExp, `${api}.toolCallIdFormat.allowedChars`);\n      assert.ok(\n        [\"full\", \"text-only\", \"none\"].includes(caps.thinkingPersistence),\n        `${api}.thinkingPersistence is \"${caps.thinkingPersistence}\"`,\n      );\n      assert.ok(Array.isArray(caps.unsupportedSchemaFeatures), `${api}.unsupportedSchemaFeatures`);\n    }\n  });\n});\n\n// ─── Provider-specific Values ───────────────────────────────────────────────\n\ndescribe(\"provider-specific capabilities\", () => {\n  test(\"Anthropic supports full thinking persistence\", () => {\n    assert.equal(PROVIDER_CAPABILITIES[\"anthropic-messages\"].thinkingPersistence, \"full\");\n  });\n\n  test(\"Anthropic supports image tool results\", () => {\n    assert.equal(PROVIDER_CAPABILITIES[\"anthropic-messages\"].imageToolResults, true);\n  });\n\n  test(\"Anthropic tool call ID is 64 chars max\", () => {\n    assert.equal(PROVIDER_CAPABILITIES[\"anthropic-messages\"].toolCallIdFormat.maxLength, 64);\n  });\n\n  test(\"Mistral tool call ID is 9 chars max\", () => {\n    assert.equal(PROVIDER_CAPABILITIES[\"mistral-conversations\"].toolCallIdFormat.maxLength, 9);\n  });\n\n  test(\"Mistral has no thinking persistence\", () => {\n    assert.equal(PROVIDER_CAPABILITIES[\"mistral-conversations\"].thinkingPersistence, \"none\");\n  });\n\n  test(\"Google does not support patternProperties\", () => {\n    assert.ok(\n      PROVIDER_CAPABILITIES[\"google-generative-ai\"].unsupportedSchemaFeatures.includes(\"patternProperties\"),\n    );\n  });\n\n  test(\"Google does not support const\", () => {\n    assert.ok(\n      PROVIDER_CAPABILITIES[\"google-generative-ai\"].unsupportedSchemaFeatures.includes(\"const\"),\n    );\n  });\n\n  test(\"OpenAI Responses does not support image tool results\", () => {\n    assert.equal(PROVIDER_CAPABILITIES[\"openai-responses\"].imageToolResults, false);\n  });\n\n  test(\"OpenAI Responses has text-only thinking persistence\", () => {\n    assert.equal(PROVIDER_CAPABILITIES[\"openai-responses\"].thinkingPersistence, \"text-only\");\n  });\n});\n\n// ─── getProviderCapabilities ────────────────────────────────────────────────\n\ndescribe(\"getProviderCapabilities\", () => {\n  test(\"returns known provider capabilities\", () => {\n    const caps = getProviderCapabilities(\"anthropic-messages\");\n    assert.equal(caps.toolCalling, true);\n    assert.equal(caps.thinkingPersistence, \"full\");\n  });\n\n  test(\"returns permissive defaults for unknown providers\", () => {\n    const caps = getProviderCapabilities(\"unknown-provider-xyz\");\n    assert.equal(caps.toolCalling, true);\n    assert.equal(caps.imageToolResults, true);\n    assert.deepEqual(caps.unsupportedSchemaFeatures, []);\n  });\n});\n\n// ─── getUnsupportedFeatures ─────────────────────────────────────────────────\n\ndescribe(\"getUnsupportedFeatures\", () => {\n  test(\"returns unsupported features for Google\", () => {\n    const unsupported = getUnsupportedFeatures(\"google-generative-ai\", [\"patternProperties\", \"const\"]);\n    assert.deepEqual(unsupported, [\"patternProperties\", \"const\"]);\n  });\n\n  test(\"returns empty for Anthropic with any features\", () => {\n    const unsupported = getUnsupportedFeatures(\"anthropic-messages\", [\"patternProperties\", \"const\"]);\n    assert.deepEqual(unsupported, []);\n  });\n\n  test(\"returns empty for unknown provider\", () => {\n    const unsupported = getUnsupportedFeatures(\"unknown-xyz\", [\"patternProperties\"]);\n    assert.deepEqual(unsupported, []);\n  });\n});\n\n// ─── mergeCapabilityOverrides ───────────────────────────────────────────────\n\ndescribe(\"mergeCapabilityOverrides\", () => {\n  test(\"overrides individual fields\", () => {\n    const merged = mergeCapabilityOverrides(\"openai-responses\", {\n      imageToolResults: true,\n    });\n    assert.equal(merged.imageToolResults, true);\n    // Non-overridden fields preserved\n    assert.equal(merged.toolCalling, true);\n    assert.equal(merged.thinkingPersistence, \"text-only\");\n  });\n\n  test(\"deep-merges toolCallIdFormat\", () => {\n    const merged = mergeCapabilityOverrides(\"anthropic-messages\", {\n      toolCallIdFormat: { maxLength: 128 },\n    });\n    assert.equal(merged.toolCallIdFormat.maxLength, 128);\n    // allowedChars preserved from base\n    assert.ok(merged.toolCallIdFormat.allowedChars instanceof RegExp);\n  });\n\n  test(\"uses permissive defaults for unknown provider\", () => {\n    const merged = mergeCapabilityOverrides(\"unknown-xyz\", {\n      imageToolResults: false,\n    });\n    assert.equal(merged.imageToolResults, false);\n    assert.equal(merged.toolCalling, true); // from default\n  });\n});\n"]}

package/packages/pi-ai/dist/providers/transform-messages-report.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transform-messages-report.test.d.ts.map

package/packages/pi-ai/dist/providers/transform-messages-report.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-messages-report.test.d.ts","sourceRoot":"","sources":["../../src/providers/transform-messages-report.test.ts"],"names":[],"mappings":""}

package/packages/pi-ai/dist/providers/transform-messages-report.test.js

@@ -0,0 +1,172 @@
+// GSD-2 — ProviderSwitchReport Tests (ADR-005 Phase 3)
+import { describe, test } from "node:test";
+import assert from "node:assert/strict";
+import { transformMessages, createEmptyReport, hasTransformations } from "./transform-messages.js";
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function makeModel(overrides = {}) {
+    return {
+        id: "claude-sonnet-4-6",
+        name: "Claude Sonnet 4.6",
+        api: "anthropic-messages",
+        provider: "anthropic",
+        baseUrl: "",
+        reasoning: false,
+        input: ["text", "image"],
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+        contextWindow: 200000,
+        maxTokens: 8192,
+        ...overrides,
+    };
+}
+function makeAssistantMsg(overrides = {}) {
+    return {
+        role: "assistant",
+        content: [],
+        api: "anthropic-messages",
+        provider: "anthropic",
+        model: "claude-sonnet-4-6",
+        usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0, cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 } },
+        stopReason: "stop",
+        timestamp: Date.now(),
+        ...overrides,
+    };
+}
+// ─── createEmptyReport / hasTransformations ─────────────────────────────────
+describe("createEmptyReport", () => {
+    test("creates report with zero counters", () => {
+        const report = createEmptyReport("anthropic-messages", "openai-responses");
+        assert.equal(report.fromApi, "anthropic-messages");
+        assert.equal(report.toApi, "openai-responses");
+        assert.equal(report.thinkingBlocksDropped, 0);
+        assert.equal(report.thinkingBlocksDowngraded, 0);
+        assert.equal(report.toolCallIdsRemapped, 0);
+        assert.equal(report.syntheticToolResultsInserted, 0);
+        assert.equal(report.thoughtSignaturesDropped, 0);
+    });
+});
+describe("hasTransformations", () => {
+    test("returns false for empty report", () => {
+        const report = createEmptyReport("a", "b");
+        assert.equal(hasTransformations(report), false);
+    });
+    test("returns true when any counter is non-zero", () => {
+        const report = createEmptyReport("a", "b");
+        report.thinkingBlocksDropped = 1;
+        assert.equal(hasTransformations(report), true);
+    });
+});
+// ─── Report Tracking in transformMessages ───────────────────────────────────
+describe("transformMessages with report tracking", () => {
+    test("tracks thinking blocks dropped for redacted cross-model", () => {
+        const model = makeModel({ id: "gpt-5", api: "openai-responses", provider: "openai" });
+        const messages = [
+            makeAssistantMsg({
+                content: [
+                    { type: "thinking", thinking: "", redacted: true },
+                    { type: "text", text: "Hello" },
+                ],
+            }),
+        ];
+        const report = createEmptyReport("anthropic-messages", "openai-responses");
+        transformMessages(messages, model, undefined, report);
+        assert.equal(report.thinkingBlocksDropped, 1);
+    });
+    test("tracks thinking blocks downgraded to plain text", () => {
+        const model = makeModel({ id: "gpt-5", api: "openai-responses", provider: "openai" });
+        const messages = [
+            makeAssistantMsg({
+                content: [
+                    { type: "thinking", thinking: "Let me think about this..." },
+                    { type: "text", text: "Here is my answer" },
+                ],
+            }),
+        ];
+        const report = createEmptyReport("anthropic-messages", "openai-responses");
+        transformMessages(messages, model, undefined, report);
+        assert.equal(report.thinkingBlocksDowngraded, 1);
+    });
+    test("tracks tool call IDs remapped", () => {
+        const model = makeModel({ id: "claude-sonnet-4-6", api: "anthropic-messages", provider: "anthropic" });
+        const toolCall = {
+            type: "toolCall",
+            id: "original-long-id-that-needs-normalization|with-special-chars",
+            name: "bash",
+            arguments: { command: "ls" },
+        };
+        const messages = [
+            makeAssistantMsg({
+                provider: "openai",
+                api: "openai-responses",
+                model: "gpt-5",
+                content: [toolCall],
+            }),
+        ];
+        const normalizer = (id) => id.replace(/[^a-zA-Z0-9_-]/g, "_").slice(0, 64);
+        const report = createEmptyReport("openai-responses", "anthropic-messages");
+        transformMessages(messages, model, normalizer, report);
+        assert.equal(report.toolCallIdsRemapped, 1);
+    });
+    test("tracks thought signatures dropped", () => {
+        const model = makeModel({ id: "claude-sonnet-4-6", api: "anthropic-messages", provider: "anthropic" });
+        const toolCall = {
+            type: "toolCall",
+            id: "tc_001",
+            name: "bash",
+            arguments: { command: "ls" },
+            thoughtSignature: "some-opaque-signature",
+        };
+        const messages = [
+            makeAssistantMsg({
+                provider: "google",
+                api: "google-generative-ai",
+                model: "gemini-2.5-pro",
+                content: [toolCall],
+            }),
+        ];
+        const report = createEmptyReport("google-generative-ai", "anthropic-messages");
+        transformMessages(messages, model, undefined, report);
+        assert.equal(report.thoughtSignaturesDropped, 1);
+    });
+    test("tracks synthetic tool results inserted", () => {
+        const model = makeModel();
+        const toolCall = {
+            type: "toolCall",
+            id: "tc_orphan",
+            name: "bash",
+            arguments: { command: "ls" },
+        };
+        // Assistant message with tool call followed by another assistant (no tool result)
+        const messages = [
+            makeAssistantMsg({ content: [toolCall, { type: "text", text: "Using bash" }] }),
+            makeAssistantMsg({ content: [{ type: "text", text: "Next message" }] }),
+        ];
+        const report = createEmptyReport("anthropic-messages", "anthropic-messages");
+        transformMessages(messages, model, undefined, report);
+        assert.equal(report.syntheticToolResultsInserted, 1);
+    });
+    test("does not count transformations for same-model messages", () => {
+        const model = makeModel();
+        const messages = [
+            makeAssistantMsg({
+                content: [
+                    { type: "thinking", thinking: "Let me think..." },
+                    { type: "text", text: "Answer" },
+                ],
+            }),
+        ];
+        const report = createEmptyReport("anthropic-messages", "anthropic-messages");
+        transformMessages(messages, model, undefined, report);
+        assert.equal(report.thinkingBlocksDowngraded, 0);
+        assert.equal(report.thinkingBlocksDropped, 0);
+    });
+    test("works without report parameter (backward compatible)", () => {
+        const model = makeModel();
+        const messages = [
+            makeAssistantMsg({ content: [{ type: "text", text: "Hello" }] }),
+        ];
+        // Should not throw
+        const result = transformMessages(messages, model);
+        assert.ok(Array.isArray(result));
+    });
+});
+//# sourceMappingURL=transform-messages-report.test.js.map

package/packages/pi-ai/dist/providers/transform-messages-report.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-messages-report.test.js","sourceRoot":"","sources":["../../src/providers/transform-messages-report.test.ts"],"names":[],"mappings":"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","sourcesContent":["// GSD-2 — ProviderSwitchReport Tests (ADR-005 Phase 3)\nimport { describe, test } from \"node:test\";\nimport assert from \"node:assert/strict\";\n\nimport { transformMessages, createEmptyReport, hasTransformations } from \"./transform-messages.js\";\nimport type { ProviderSwitchReport } from \"./transform-messages.js\";\nimport type { Message, Model, AssistantMessage, ToolCall } from \"../types.js\";\n\n// ─── Helpers ────────────────────────────────────────────────────────────────\n\nfunction makeModel(overrides: Partial<Model<any>> = {}): Model<any> {\n  return {\n    id: \"claude-sonnet-4-6\",\n    name: \"Claude Sonnet 4.6\",\n    api: \"anthropic-messages\",\n    provider: \"anthropic\",\n    baseUrl: \"\",\n    reasoning: false,\n    input: [\"text\", \"image\"],\n    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },\n    contextWindow: 200000,\n    maxTokens: 8192,\n    ...overrides,\n  } as Model<any>;\n}\n\nfunction makeAssistantMsg(overrides: Partial<AssistantMessage> = {}): AssistantMessage {\n  return {\n    role: \"assistant\",\n    content: [],\n    api: \"anthropic-messages\",\n    provider: \"anthropic\",\n    model: \"claude-sonnet-4-6\",\n    usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0, cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 } },\n    stopReason: \"stop\",\n    timestamp: Date.now(),\n    ...overrides,\n  };\n}\n\n// ─── createEmptyReport / hasTransformations ─────────────────────────────────\n\ndescribe(\"createEmptyReport\", () => {\n  test(\"creates report with zero counters\", () => {\n    const report = createEmptyReport(\"anthropic-messages\", \"openai-responses\");\n    assert.equal(report.fromApi, \"anthropic-messages\");\n    assert.equal(report.toApi, \"openai-responses\");\n    assert.equal(report.thinkingBlocksDropped, 0);\n    assert.equal(report.thinkingBlocksDowngraded, 0);\n    assert.equal(report.toolCallIdsRemapped, 0);\n    assert.equal(report.syntheticToolResultsInserted, 0);\n    assert.equal(report.thoughtSignaturesDropped, 0);\n  });\n});\n\ndescribe(\"hasTransformations\", () => {\n  test(\"returns false for empty report\", () => {\n    const report = createEmptyReport(\"a\", \"b\");\n    assert.equal(hasTransformations(report), false);\n  });\n\n  test(\"returns true when any counter is non-zero\", () => {\n    const report = createEmptyReport(\"a\", \"b\");\n    report.thinkingBlocksDropped = 1;\n    assert.equal(hasTransformations(report), true);\n  });\n});\n\n// ─── Report Tracking in transformMessages ───────────────────────────────────\n\ndescribe(\"transformMessages with report tracking\", () => {\n  test(\"tracks thinking blocks dropped for redacted cross-model\", () => {\n    const model = makeModel({ id: \"gpt-5\", api: \"openai-responses\", provider: \"openai\" });\n    const messages: Message[] = [\n      makeAssistantMsg({\n        content: [\n          { type: \"thinking\", thinking: \"\", redacted: true },\n          { type: \"text\", text: \"Hello\" },\n        ],\n      }),\n    ];\n    const report = createEmptyReport(\"anthropic-messages\", \"openai-responses\");\n    transformMessages(messages, model, undefined, report);\n    assert.equal(report.thinkingBlocksDropped, 1);\n  });\n\n  test(\"tracks thinking blocks downgraded to plain text\", () => {\n    const model = makeModel({ id: \"gpt-5\", api: \"openai-responses\", provider: \"openai\" });\n    const messages: Message[] = [\n      makeAssistantMsg({\n        content: [\n          { type: \"thinking\", thinking: \"Let me think about this...\" },\n          { type: \"text\", text: \"Here is my answer\" },\n        ],\n      }),\n    ];\n    const report = createEmptyReport(\"anthropic-messages\", \"openai-responses\");\n    transformMessages(messages, model, undefined, report);\n    assert.equal(report.thinkingBlocksDowngraded, 1);\n  });\n\n  test(\"tracks tool call IDs remapped\", () => {\n    const model = makeModel({ id: \"claude-sonnet-4-6\", api: \"anthropic-messages\", provider: \"anthropic\" });\n    const toolCall: ToolCall = {\n      type: \"toolCall\",\n      id: \"original-long-id-that-needs-normalization|with-special-chars\",\n      name: \"bash\",\n      arguments: { command: \"ls\" },\n    };\n    const messages: Message[] = [\n      makeAssistantMsg({\n        provider: \"openai\",\n        api: \"openai-responses\",\n        model: \"gpt-5\",\n        content: [toolCall],\n      }),\n    ];\n    const normalizer = (id: string) => id.replace(/[^a-zA-Z0-9_-]/g, \"_\").slice(0, 64);\n    const report = createEmptyReport(\"openai-responses\", \"anthropic-messages\");\n    transformMessages(messages, model, normalizer, report);\n    assert.equal(report.toolCallIdsRemapped, 1);\n  });\n\n  test(\"tracks thought signatures dropped\", () => {\n    const model = makeModel({ id: \"claude-sonnet-4-6\", api: \"anthropic-messages\", provider: \"anthropic\" });\n    const toolCall: ToolCall = {\n      type: \"toolCall\",\n      id: \"tc_001\",\n      name: \"bash\",\n      arguments: { command: \"ls\" },\n      thoughtSignature: \"some-opaque-signature\",\n    };\n    const messages: Message[] = [\n      makeAssistantMsg({\n        provider: \"google\",\n        api: \"google-generative-ai\",\n        model: \"gemini-2.5-pro\",\n        content: [toolCall],\n      }),\n    ];\n    const report = createEmptyReport(\"google-generative-ai\", \"anthropic-messages\");\n    transformMessages(messages, model, undefined, report);\n    assert.equal(report.thoughtSignaturesDropped, 1);\n  });\n\n  test(\"tracks synthetic tool results inserted\", () => {\n    const model = makeModel();\n    const toolCall: ToolCall = {\n      type: \"toolCall\",\n      id: \"tc_orphan\",\n      name: \"bash\",\n      arguments: { command: \"ls\" },\n    };\n    // Assistant message with tool call followed by another assistant (no tool result)\n    const messages: Message[] = [\n      makeAssistantMsg({ content: [toolCall, { type: \"text\", text: \"Using bash\" }] }),\n      makeAssistantMsg({ content: [{ type: \"text\", text: \"Next message\" }] }),\n    ];\n    const report = createEmptyReport(\"anthropic-messages\", \"anthropic-messages\");\n    transformMessages(messages, model, undefined, report);\n    assert.equal(report.syntheticToolResultsInserted, 1);\n  });\n\n  test(\"does not count transformations for same-model messages\", () => {\n    const model = makeModel();\n    const messages: Message[] = [\n      makeAssistantMsg({\n        content: [\n          { type: \"thinking\", thinking: \"Let me think...\" },\n          { type: \"text\", text: \"Answer\" },\n        ],\n      }),\n    ];\n    const report = createEmptyReport(\"anthropic-messages\", \"anthropic-messages\");\n    transformMessages(messages, model, undefined, report);\n    assert.equal(report.thinkingBlocksDowngraded, 0);\n    assert.equal(report.thinkingBlocksDropped, 0);\n  });\n\n  test(\"works without report parameter (backward compatible)\", () => {\n    const model = makeModel();\n    const messages: Message[] = [\n      makeAssistantMsg({ content: [{ type: \"text\", text: \"Hello\" }] }),\n    ];\n    // Should not throw\n    const result = transformMessages(messages, model);\n    assert.ok(Array.isArray(result));\n  });\n});\n"]}

package/packages/pi-ai/dist/providers/transform-messages.d.ts

@@ -1,8 +1,41 @@
 import type { Api, AssistantMessage, Message, Model } from "../types.js";
+/**
+ * Report of context transformations during a cross-provider switch (ADR-005 Phase 3).
+ * Tracks what was lost or downgraded when replaying conversation history to a different provider.
+ */
+export interface ProviderSwitchReport {
+    /** API of the messages being transformed from */
+    fromApi: string;
+    /** API of the target model */
+    toApi: string;
+    /** Number of thinking blocks completely dropped (redacted/encrypted, cross-model) */
+    thinkingBlocksDropped: number;
+    /** Number of thinking blocks downgraded from structured to plain text */
+    thinkingBlocksDowngraded: number;
+    /** Number of tool call IDs that were remapped/normalized */
+    toolCallIdsRemapped: number;
+    /** Number of synthetic tool results inserted for orphaned tool calls */
+    syntheticToolResultsInserted: number;
+    /** Number of thought signatures dropped (Google-specific opaque context) */
+    thoughtSignaturesDropped: number;
+}
+/**
+ * Create an empty provider switch report.
+ */
+export declare function createEmptyReport(fromApi: string, toApi: string): ProviderSwitchReport;
+/**
+ * Check if a provider switch report has any non-zero transformations.
+ */
+export declare function hasTransformations(report: ProviderSwitchReport): boolean;
+/**
+ * Create a report, run transformMessages, and log if non-empty.
+ * Convenience wrapper for provider adapters (ADR-005).
+ */
+export declare function transformMessagesWithReport<TApi extends Api>(messages: Message[], model: Model<TApi>, normalizeToolCallId?: (id: string, model: Model<TApi>, source: AssistantMessage) => string, sourceApi?: string): Message[];
 /**
  * Normalize tool call ID for cross-provider compatibility.
  * OpenAI Responses API generates IDs that are 450+ chars with special characters like `|`.
  * Anthropic APIs require IDs matching ^[a-zA-Z0-9_-]+$ (max 64 chars).
  */
-export declare function transformMessages<TApi extends Api>(messages: Message[], model: Model<TApi>, normalizeToolCallId?: (id: string, model: Model<TApi>, source: AssistantMessage) => string): Message[];
+export declare function transformMessages<TApi extends Api>(messages: Message[], model: Model<TApi>, normalizeToolCallId?: (id: string, model: Model<TApi>, source: AssistantMessage) => string, report?: ProviderSwitchReport): Message[];
 //# sourceMappingURL=transform-messages.d.ts.map

package/packages/pi-ai/dist/providers/transform-messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform-messages.d.ts","sourceRoot":"","sources":["../../src/providers/transform-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,KAAK,EAA+B,MAAM,aAAa,CAAC;AAEtG;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,SAAS,GAAG,EACjD,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,mBAAmB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,gBAAgB,KAAK,MAAM,GACxF,OAAO,EAAE,CAgKX"}
+{"version":3,"file":"transform-messages.d.ts","sourceRoot":"","sources":["../../src/providers/transform-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,KAAK,EAA+B,MAAM,aAAa,CAAC;AAEtG;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACpC,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,qBAAqB,EAAE,MAAM,CAAC;IAC9B,yEAAyE;IACzE,wBAAwB,EAAE,MAAM,CAAC;IACjC,4DAA4D;IAC5D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wEAAwE;IACxE,4BAA4B,EAAE,MAAM,CAAC;IACrC,4EAA4E;IAC5E,wBAAwB,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAUtF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAQxE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,SAAS,GAAG,EAC3D,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,mBAAmB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,gBAAgB,KAAK,MAAM,EAC1F,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,EAAE,CAOX;AAiBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,SAAS,GAAG,EACjD,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,mBAAmB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,gBAAgB,KAAK,MAAM,EAC1F,MAAM,CAAC,EAAE,oBAAoB,GAC3B,OAAO,EAAE,CA0KX"}