gsd-pi 2.75.0-dev.a44b82572 → 2.75.0-dev.e41b70b10

package/packages/pi-ai/dist/index.d.ts

@@ -4,6 +4,7 @@ export * from "./api-registry.js";
 export * from "./env-api-keys.js";
 export * from "./models/index.js";
 export { mapThinkingLevelToEffort, supportsAdaptiveThinking, } from "./providers/anthropic-shared.js";
+export * from "./providers/api-family.js";
 export * from "./providers/provider-capabilities.js";
 export * from "./providers/register-builtins.js";
 export type { ProviderSwitchReport } from "./providers/transform-messages.js";

package/packages/pi-ai/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EACN,wBAAwB,EACxB,wBAAwB,GACxB,MAAM,iCAAiC,CAAC;AACzC,cAAc,sCAAsC,CAAC;AACrD,cAAc,kCAAkC,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AACvH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,YAAY,EACX,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,sBAAsB,GACtB,MAAM,wBAAwB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EACN,wBAAwB,EACxB,wBAAwB,GACxB,MAAM,iCAAiC,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sCAAsC,CAAC;AACrD,cAAc,kCAAkC,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AACvH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,YAAY,EACX,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,sBAAsB,GACtB,MAAM,wBAAwB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC"}

package/packages/pi-ai/dist/index.js

@@ -3,6 +3,7 @@ export * from "./api-registry.js";
 export * from "./env-api-keys.js";
 export * from "./models/index.js";
 export { mapThinkingLevelToEffort, supportsAdaptiveThinking, } from "./providers/anthropic-shared.js";
+export * from "./providers/api-family.js";
 export * from "./providers/provider-capabilities.js";
 export * from "./providers/register-builtins.js";
 export { createEmptyReport, hasTransformations, transformMessagesWithReport } from "./providers/transform-messages.js";

package/packages/pi-ai/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EACN,wBAAwB,EACxB,wBAAwB,GACxB,MAAM,iCAAiC,CAAC;AACzC,cAAc,sCAAsC,CAAC;AACrD,cAAc,kCAAkC,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AACvH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AAStC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC","sourcesContent":["export type { Static, TSchema } from \"@sinclair/typebox\";\nexport { Type } from \"@sinclair/typebox\";\n\nexport * from \"./api-registry.js\";\nexport * from \"./env-api-keys.js\";\nexport * from \"./models/index.js\";\nexport {\n\tmapThinkingLevelToEffort,\n\tsupportsAdaptiveThinking,\n} from \"./providers/anthropic-shared.js\";\nexport * from \"./providers/provider-capabilities.js\";\nexport * from \"./providers/register-builtins.js\";\nexport type { ProviderSwitchReport } from \"./providers/transform-messages.js\";\nexport { createEmptyReport, hasTransformations, transformMessagesWithReport } from \"./providers/transform-messages.js\";\nexport * from \"./stream.js\";\nexport * from \"./types.js\";\nexport * from \"./utils/event-stream.js\";\nexport * from \"./utils/json-parse.js\";\nexport type {\n\tOAuthAuthInfo,\n\tOAuthCredentials,\n\tOAuthLoginCallbacks,\n\tOAuthPrompt,\n\tOAuthProviderId,\n\tOAuthProviderInterface,\n} from \"./utils/oauth/types.js\";\nexport * from \"./utils/overflow.js\";\nexport * from \"./utils/typebox-helpers.js\";\nexport * from \"./utils/repair-tool-json.js\";\nexport * from \"./utils/validation.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EACN,wBAAwB,EACxB,wBAAwB,GACxB,MAAM,iCAAiC,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sCAAsC,CAAC;AACrD,cAAc,kCAAkC,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AACvH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AAStC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC","sourcesContent":["export type { Static, TSchema } from \"@sinclair/typebox\";\nexport { Type } from \"@sinclair/typebox\";\n\nexport * from \"./api-registry.js\";\nexport * from \"./env-api-keys.js\";\nexport * from \"./models/index.js\";\nexport {\n\tmapThinkingLevelToEffort,\n\tsupportsAdaptiveThinking,\n} from \"./providers/anthropic-shared.js\";\nexport * from \"./providers/api-family.js\";\nexport * from \"./providers/provider-capabilities.js\";\nexport * from \"./providers/register-builtins.js\";\nexport type { ProviderSwitchReport } from \"./providers/transform-messages.js\";\nexport { createEmptyReport, hasTransformations, transformMessagesWithReport } from \"./providers/transform-messages.js\";\nexport * from \"./stream.js\";\nexport * from \"./types.js\";\nexport * from \"./utils/event-stream.js\";\nexport * from \"./utils/json-parse.js\";\nexport type {\n\tOAuthAuthInfo,\n\tOAuthCredentials,\n\tOAuthLoginCallbacks,\n\tOAuthPrompt,\n\tOAuthProviderId,\n\tOAuthProviderInterface,\n} from \"./utils/oauth/types.js\";\nexport * from \"./utils/overflow.js\";\nexport * from \"./utils/typebox-helpers.js\";\nexport * from \"./utils/repair-tool-json.js\";\nexport * from \"./utils/validation.js\";\n"]}

package/packages/pi-ai/dist/providers/api-family.d.ts

@@ -0,0 +1,27 @@
+/** Minimal shape — any object with an optional `api` string works. */
+type HasApi = {
+    api?: string;
+} | null | undefined;
+/**
+ * True for any transport that speaks the Anthropic Messages wire protocol:
+ * direct Anthropic, Claude Code OAuth, Anthropic-on-Vertex, Vercel AI Gateway
+ * Anthropic routes, etc.
+ *
+ * Excludes Bedrock-hosted Claude — Bedrock Converse uses a different tool
+ * schema and is matched by `isBedrockApi` instead.
+ */
+export declare function isAnthropicApi(model: HasApi): boolean;
+/**
+ * True for any transport that speaks an OpenAI-shaped wire protocol:
+ * Chat Completions, Responses, Azure-hosted Responses, Codex-hosted Responses.
+ */
+export declare function isOpenAIApi(model: HasApi): boolean;
+/**
+ * True for any transport that speaks a Google Gemini wire protocol:
+ * Generative AI REST, Gemini CLI, Vertex AI.
+ */
+export declare function isGeminiApi(model: HasApi): boolean;
+/** True for AWS Bedrock Converse transports. */
+export declare function isBedrockApi(model: HasApi): boolean;
+export {};
+//# sourceMappingURL=api-family.d.ts.map

package/packages/pi-ai/dist/providers/api-family.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-family.d.ts","sourceRoot":"","sources":["../../src/providers/api-family.ts"],"names":[],"mappings":"AAUA,sEAAsE;AACtE,KAAK,MAAM,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,CAAC;AAElD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAQlD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOlD;AAED,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD"}

package/packages/pi-ai/dist/providers/api-family.js

@@ -0,0 +1,47 @@
+// gsd-2 / pi-ai: API-shape family predicates
+//
+// Rule (see docs/dev/ADR-012-provider-id-vs-api-shape.md):
+//   Gate API-shape-dependent behavior (tool schemas, request payload shape,
+//   streaming format) on `model.api`, never on `model.provider`.
+//   `provider` is a credential/transport identifier that varies by vendor
+//   routing (e.g. `anthropic`, `claude-code`, `anthropic-vertex`,
+//   `amazon-bedrock`, `vercel-ai-gateway`) even when the wire protocol is
+//   identical.
+/**
+ * True for any transport that speaks the Anthropic Messages wire protocol:
+ * direct Anthropic, Claude Code OAuth, Anthropic-on-Vertex, Vercel AI Gateway
+ * Anthropic routes, etc.
+ *
+ * Excludes Bedrock-hosted Claude — Bedrock Converse uses a different tool
+ * schema and is matched by `isBedrockApi` instead.
+ */
+export function isAnthropicApi(model) {
+    const api = model?.api;
+    return api === "anthropic-messages" || api === "anthropic-vertex";
+}
+/**
+ * True for any transport that speaks an OpenAI-shaped wire protocol:
+ * Chat Completions, Responses, Azure-hosted Responses, Codex-hosted Responses.
+ */
+export function isOpenAIApi(model) {
+    const api = model?.api;
+    return (api === "openai-completions" ||
+        api === "openai-responses" ||
+        api === "azure-openai-responses" ||
+        api === "openai-codex-responses");
+}
+/**
+ * True for any transport that speaks a Google Gemini wire protocol:
+ * Generative AI REST, Gemini CLI, Vertex AI.
+ */
+export function isGeminiApi(model) {
+    const api = model?.api;
+    return (api === "google-generative-ai" ||
+        api === "google-gemini-cli" ||
+        api === "google-vertex");
+}
+/** True for AWS Bedrock Converse transports. */
+export function isBedrockApi(model) {
+    return model?.api === "bedrock-converse-stream";
+}
+//# sourceMappingURL=api-family.js.map

package/packages/pi-ai/dist/providers/api-family.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-family.js","sourceRoot":"","sources":["../../src/providers/api-family.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,2DAA2D;AAC3D,4EAA4E;AAC5E,iEAAiE;AACjE,0EAA0E;AAC1E,kEAAkE;AAClE,0EAA0E;AAC1E,eAAe;AAKf;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,GAAG,GAAG,KAAK,EAAE,GAAG,CAAC;IACvB,OAAO,GAAG,KAAK,oBAAoB,IAAI,GAAG,KAAK,kBAAkB,CAAC;AACpE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,GAAG,GAAG,KAAK,EAAE,GAAG,CAAC;IACvB,OAAO,CACL,GAAG,KAAK,oBAAoB;QAC5B,GAAG,KAAK,kBAAkB;QAC1B,GAAG,KAAK,wBAAwB;QAChC,GAAG,KAAK,wBAAwB,CACjC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,GAAG,GAAG,KAAK,EAAE,GAAG,CAAC;IACvB,OAAO,CACL,GAAG,KAAK,sBAAsB;QAC9B,GAAG,KAAK,mBAAmB;QAC3B,GAAG,KAAK,eAAe,CACxB,CAAC;AACJ,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK,EAAE,GAAG,KAAK,yBAAyB,CAAC;AAClD,CAAC","sourcesContent":["// gsd-2 / pi-ai: API-shape family predicates\n//\n// Rule (see docs/dev/ADR-012-provider-id-vs-api-shape.md):\n//   Gate API-shape-dependent behavior (tool schemas, request payload shape,\n//   streaming format) on `model.api`, never on `model.provider`.\n//   `provider` is a credential/transport identifier that varies by vendor\n//   routing (e.g. `anthropic`, `claude-code`, `anthropic-vertex`,\n//   `amazon-bedrock`, `vercel-ai-gateway`) even when the wire protocol is\n//   identical.\n\n/** Minimal shape — any object with an optional `api` string works. */\ntype HasApi = { api?: string } | null | undefined;\n\n/**\n * True for any transport that speaks the Anthropic Messages wire protocol:\n * direct Anthropic, Claude Code OAuth, Anthropic-on-Vertex, Vercel AI Gateway\n * Anthropic routes, etc.\n *\n * Excludes Bedrock-hosted Claude — Bedrock Converse uses a different tool\n * schema and is matched by `isBedrockApi` instead.\n */\nexport function isAnthropicApi(model: HasApi): boolean {\n  const api = model?.api;\n  return api === \"anthropic-messages\" || api === \"anthropic-vertex\";\n}\n\n/**\n * True for any transport that speaks an OpenAI-shaped wire protocol:\n * Chat Completions, Responses, Azure-hosted Responses, Codex-hosted Responses.\n */\nexport function isOpenAIApi(model: HasApi): boolean {\n  const api = model?.api;\n  return (\n    api === \"openai-completions\" ||\n    api === \"openai-responses\" ||\n    api === \"azure-openai-responses\" ||\n    api === \"openai-codex-responses\"\n  );\n}\n\n/**\n * True for any transport that speaks a Google Gemini wire protocol:\n * Generative AI REST, Gemini CLI, Vertex AI.\n */\nexport function isGeminiApi(model: HasApi): boolean {\n  const api = model?.api;\n  return (\n    api === \"google-generative-ai\" ||\n    api === \"google-gemini-cli\" ||\n    api === \"google-vertex\"\n  );\n}\n\n/** True for AWS Bedrock Converse transports. */\nexport function isBedrockApi(model: HasApi): boolean {\n  return model?.api === \"bedrock-converse-stream\";\n}\n"]}

package/packages/pi-ai/dist/providers/api-family.test.d.ts

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

package/packages/pi-ai/dist/providers/api-family.test.d.ts.map

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

package/packages/pi-ai/dist/providers/api-family.test.js

@@ -0,0 +1,101 @@
+// gsd-2 / pi-ai: api-family predicate tests
+import { describe, test } from "node:test";
+import assert from "node:assert/strict";
+import { isAnthropicApi, isBedrockApi, isGeminiApi, isOpenAIApi, } from "./api-family.js";
+// Every api value registered via registerApiProvider() in register-builtins.ts.
+// Keep in sync with that file — the expectations below assert every api is
+// classified by exactly one family (except mistral, which is its own family
+// and belongs to none of the helpers).
+const ALL_REGISTERED_APIS = [
+    "anthropic-messages",
+    "anthropic-vertex",
+    "openai-completions",
+    "openai-responses",
+    "azure-openai-responses",
+    "openai-codex-responses",
+    "google-generative-ai",
+    "google-gemini-cli",
+    "google-vertex",
+    "bedrock-converse-stream",
+    "mistral-conversations",
+];
+describe("isAnthropicApi", () => {
+    test("matches anthropic-messages and anthropic-vertex", () => {
+        assert.equal(isAnthropicApi({ api: "anthropic-messages" }), true);
+        assert.equal(isAnthropicApi({ api: "anthropic-vertex" }), true);
+    });
+    test("excludes bedrock-converse-stream (different tool schema)", () => {
+        assert.equal(isAnthropicApi({ api: "bedrock-converse-stream" }), false);
+    });
+    test("excludes every non-Anthropic registered api", () => {
+        const nonAnthropic = ALL_REGISTERED_APIS.filter((a) => a !== "anthropic-messages" && a !== "anthropic-vertex");
+        for (const api of nonAnthropic) {
+            assert.equal(isAnthropicApi({ api }), false, `api=${api}`);
+        }
+    });
+    test("tolerates null/undefined/missing api", () => {
+        assert.equal(isAnthropicApi(null), false);
+        assert.equal(isAnthropicApi(undefined), false);
+        assert.equal(isAnthropicApi({}), false);
+        assert.equal(isAnthropicApi({ api: "" }), false);
+    });
+});
+describe("isOpenAIApi", () => {
+    test("matches all OpenAI-shaped apis", () => {
+        for (const api of [
+            "openai-completions",
+            "openai-responses",
+            "azure-openai-responses",
+            "openai-codex-responses",
+        ]) {
+            assert.equal(isOpenAIApi({ api }), true, `api=${api}`);
+        }
+    });
+    test("excludes every non-OpenAI registered api", () => {
+        const nonOpenAI = ALL_REGISTERED_APIS.filter((a) => a !== "openai-completions" &&
+            a !== "openai-responses" &&
+            a !== "azure-openai-responses" &&
+            a !== "openai-codex-responses");
+        for (const api of nonOpenAI) {
+            assert.equal(isOpenAIApi({ api }), false, `api=${api}`);
+        }
+    });
+});
+describe("isGeminiApi", () => {
+    test("matches all Gemini-shaped apis", () => {
+        for (const api of ["google-generative-ai", "google-gemini-cli", "google-vertex"]) {
+            assert.equal(isGeminiApi({ api }), true, `api=${api}`);
+        }
+    });
+    test("excludes every non-Gemini registered api", () => {
+        const nonGemini = ALL_REGISTERED_APIS.filter((a) => a !== "google-generative-ai" &&
+            a !== "google-gemini-cli" &&
+            a !== "google-vertex");
+        for (const api of nonGemini) {
+            assert.equal(isGeminiApi({ api }), false, `api=${api}`);
+        }
+    });
+});
+describe("isBedrockApi", () => {
+    test("matches only bedrock-converse-stream", () => {
+        assert.equal(isBedrockApi({ api: "bedrock-converse-stream" }), true);
+        for (const api of ALL_REGISTERED_APIS.filter((a) => a !== "bedrock-converse-stream")) {
+            assert.equal(isBedrockApi({ api }), false, `api=${api}`);
+        }
+    });
+});
+describe("api-family exclusivity", () => {
+    test("every registered api belongs to exactly one family (or mistral = none)", () => {
+        for (const api of ALL_REGISTERED_APIS) {
+            const matches = [
+                isAnthropicApi({ api }),
+                isOpenAIApi({ api }),
+                isGeminiApi({ api }),
+                isBedrockApi({ api }),
+            ].filter(Boolean).length;
+            const expected = api === "mistral-conversations" ? 0 : 1;
+            assert.equal(matches, expected, `api=${api} matched ${matches} families (expected ${expected})`);
+        }
+    });
+});
+//# sourceMappingURL=api-family.test.js.map

package/packages/pi-ai/dist/providers/api-family.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-family.test.js","sourceRoot":"","sources":["../../src/providers/api-family.test.ts"],"names":[],"mappings":"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","sourcesContent":["// gsd-2 / pi-ai: api-family predicate tests\nimport { describe, test } from \"node:test\";\nimport assert from \"node:assert/strict\";\n\nimport {\n  isAnthropicApi,\n  isBedrockApi,\n  isGeminiApi,\n  isOpenAIApi,\n} from \"./api-family.js\";\n\n// Every api value registered via registerApiProvider() in register-builtins.ts.\n// Keep in sync with that file — the expectations below assert every api is\n// classified by exactly one family (except mistral, which is its own family\n// and belongs to none of the helpers).\nconst ALL_REGISTERED_APIS = [\n  \"anthropic-messages\",\n  \"anthropic-vertex\",\n  \"openai-completions\",\n  \"openai-responses\",\n  \"azure-openai-responses\",\n  \"openai-codex-responses\",\n  \"google-generative-ai\",\n  \"google-gemini-cli\",\n  \"google-vertex\",\n  \"bedrock-converse-stream\",\n  \"mistral-conversations\",\n] as const;\n\ndescribe(\"isAnthropicApi\", () => {\n  test(\"matches anthropic-messages and anthropic-vertex\", () => {\n    assert.equal(isAnthropicApi({ api: \"anthropic-messages\" }), true);\n    assert.equal(isAnthropicApi({ api: \"anthropic-vertex\" }), true);\n  });\n\n  test(\"excludes bedrock-converse-stream (different tool schema)\", () => {\n    assert.equal(isAnthropicApi({ api: \"bedrock-converse-stream\" }), false);\n  });\n\n  test(\"excludes every non-Anthropic registered api\", () => {\n    const nonAnthropic = ALL_REGISTERED_APIS.filter(\n      (a) => a !== \"anthropic-messages\" && a !== \"anthropic-vertex\",\n    );\n    for (const api of nonAnthropic) {\n      assert.equal(isAnthropicApi({ api }), false, `api=${api}`);\n    }\n  });\n\n  test(\"tolerates null/undefined/missing api\", () => {\n    assert.equal(isAnthropicApi(null), false);\n    assert.equal(isAnthropicApi(undefined), false);\n    assert.equal(isAnthropicApi({}), false);\n    assert.equal(isAnthropicApi({ api: \"\" }), false);\n  });\n});\n\ndescribe(\"isOpenAIApi\", () => {\n  test(\"matches all OpenAI-shaped apis\", () => {\n    for (const api of [\n      \"openai-completions\",\n      \"openai-responses\",\n      \"azure-openai-responses\",\n      \"openai-codex-responses\",\n    ]) {\n      assert.equal(isOpenAIApi({ api }), true, `api=${api}`);\n    }\n  });\n\n  test(\"excludes every non-OpenAI registered api\", () => {\n    const nonOpenAI = ALL_REGISTERED_APIS.filter(\n      (a) =>\n        a !== \"openai-completions\" &&\n        a !== \"openai-responses\" &&\n        a !== \"azure-openai-responses\" &&\n        a !== \"openai-codex-responses\",\n    );\n    for (const api of nonOpenAI) {\n      assert.equal(isOpenAIApi({ api }), false, `api=${api}`);\n    }\n  });\n});\n\ndescribe(\"isGeminiApi\", () => {\n  test(\"matches all Gemini-shaped apis\", () => {\n    for (const api of [\"google-generative-ai\", \"google-gemini-cli\", \"google-vertex\"]) {\n      assert.equal(isGeminiApi({ api }), true, `api=${api}`);\n    }\n  });\n\n  test(\"excludes every non-Gemini registered api\", () => {\n    const nonGemini = ALL_REGISTERED_APIS.filter(\n      (a) =>\n        a !== \"google-generative-ai\" &&\n        a !== \"google-gemini-cli\" &&\n        a !== \"google-vertex\",\n    );\n    for (const api of nonGemini) {\n      assert.equal(isGeminiApi({ api }), false, `api=${api}`);\n    }\n  });\n});\n\ndescribe(\"isBedrockApi\", () => {\n  test(\"matches only bedrock-converse-stream\", () => {\n    assert.equal(isBedrockApi({ api: \"bedrock-converse-stream\" }), true);\n    for (const api of ALL_REGISTERED_APIS.filter((a) => a !== \"bedrock-converse-stream\")) {\n      assert.equal(isBedrockApi({ api }), false, `api=${api}`);\n    }\n  });\n});\n\ndescribe(\"api-family exclusivity\", () => {\n  test(\"every registered api belongs to exactly one family (or mistral = none)\", () => {\n    for (const api of ALL_REGISTERED_APIS) {\n      const matches = [\n        isAnthropicApi({ api }),\n        isOpenAIApi({ api }),\n        isGeminiApi({ api }),\n        isBedrockApi({ api }),\n      ].filter(Boolean).length;\n      const expected = api === \"mistral-conversations\" ? 0 : 1;\n      assert.equal(\n        matches,\n        expected,\n        `api=${api} matched ${matches} families (expected ${expected})`,\n      );\n    }\n  });\n});\n"]}

package/packages/pi-ai/src/index.ts

@@ -8,6 +8,7 @@ export {
 	mapThinkingLevelToEffort,
 	supportsAdaptiveThinking,
 } from "./providers/anthropic-shared.js";
+export * from "./providers/api-family.js";
 export * from "./providers/provider-capabilities.js";
 export * from "./providers/register-builtins.js";
 export type { ProviderSwitchReport } from "./providers/transform-messages.js";

package/packages/pi-ai/src/providers/api-family.test.ts

@@ -0,0 +1,129 @@
+// gsd-2 / pi-ai: api-family predicate tests
+import { describe, test } from "node:test";
+import assert from "node:assert/strict";
+
+import {
+  isAnthropicApi,
+  isBedrockApi,
+  isGeminiApi,
+  isOpenAIApi,
+} from "./api-family.js";
+
+// Every api value registered via registerApiProvider() in register-builtins.ts.
+// Keep in sync with that file — the expectations below assert every api is
+// classified by exactly one family (except mistral, which is its own family
+// and belongs to none of the helpers).
+const ALL_REGISTERED_APIS = [
+  "anthropic-messages",
+  "anthropic-vertex",
+  "openai-completions",
+  "openai-responses",
+  "azure-openai-responses",
+  "openai-codex-responses",
+  "google-generative-ai",
+  "google-gemini-cli",
+  "google-vertex",
+  "bedrock-converse-stream",
+  "mistral-conversations",
+] as const;
+
+describe("isAnthropicApi", () => {
+  test("matches anthropic-messages and anthropic-vertex", () => {
+    assert.equal(isAnthropicApi({ api: "anthropic-messages" }), true);
+    assert.equal(isAnthropicApi({ api: "anthropic-vertex" }), true);
+  });
+
+  test("excludes bedrock-converse-stream (different tool schema)", () => {
+    assert.equal(isAnthropicApi({ api: "bedrock-converse-stream" }), false);
+  });
+
+  test("excludes every non-Anthropic registered api", () => {
+    const nonAnthropic = ALL_REGISTERED_APIS.filter(
+      (a) => a !== "anthropic-messages" && a !== "anthropic-vertex",
+    );
+    for (const api of nonAnthropic) {
+      assert.equal(isAnthropicApi({ api }), false, `api=${api}`);
+    }
+  });
+
+  test("tolerates null/undefined/missing api", () => {
+    assert.equal(isAnthropicApi(null), false);
+    assert.equal(isAnthropicApi(undefined), false);
+    assert.equal(isAnthropicApi({}), false);
+    assert.equal(isAnthropicApi({ api: "" }), false);
+  });
+});
+
+describe("isOpenAIApi", () => {
+  test("matches all OpenAI-shaped apis", () => {
+    for (const api of [
+      "openai-completions",
+      "openai-responses",
+      "azure-openai-responses",
+      "openai-codex-responses",
+    ]) {
+      assert.equal(isOpenAIApi({ api }), true, `api=${api}`);
+    }
+  });
+
+  test("excludes every non-OpenAI registered api", () => {
+    const nonOpenAI = ALL_REGISTERED_APIS.filter(
+      (a) =>
+        a !== "openai-completions" &&
+        a !== "openai-responses" &&
+        a !== "azure-openai-responses" &&
+        a !== "openai-codex-responses",
+    );
+    for (const api of nonOpenAI) {
+      assert.equal(isOpenAIApi({ api }), false, `api=${api}`);
+    }
+  });
+});
+
+describe("isGeminiApi", () => {
+  test("matches all Gemini-shaped apis", () => {
+    for (const api of ["google-generative-ai", "google-gemini-cli", "google-vertex"]) {
+      assert.equal(isGeminiApi({ api }), true, `api=${api}`);
+    }
+  });
+
+  test("excludes every non-Gemini registered api", () => {
+    const nonGemini = ALL_REGISTERED_APIS.filter(
+      (a) =>
+        a !== "google-generative-ai" &&
+        a !== "google-gemini-cli" &&
+        a !== "google-vertex",
+    );
+    for (const api of nonGemini) {
+      assert.equal(isGeminiApi({ api }), false, `api=${api}`);
+    }
+  });
+});
+
+describe("isBedrockApi", () => {
+  test("matches only bedrock-converse-stream", () => {
+    assert.equal(isBedrockApi({ api: "bedrock-converse-stream" }), true);
+    for (const api of ALL_REGISTERED_APIS.filter((a) => a !== "bedrock-converse-stream")) {
+      assert.equal(isBedrockApi({ api }), false, `api=${api}`);
+    }
+  });
+});
+
+describe("api-family exclusivity", () => {
+  test("every registered api belongs to exactly one family (or mistral = none)", () => {
+    for (const api of ALL_REGISTERED_APIS) {
+      const matches = [
+        isAnthropicApi({ api }),
+        isOpenAIApi({ api }),
+        isGeminiApi({ api }),
+        isBedrockApi({ api }),
+      ].filter(Boolean).length;
+      const expected = api === "mistral-conversations" ? 0 : 1;
+      assert.equal(
+        matches,
+        expected,
+        `api=${api} matched ${matches} families (expected ${expected})`,
+      );
+    }
+  });
+});

package/packages/pi-ai/src/providers/api-family.ts

@@ -0,0 +1,57 @@
+// gsd-2 / pi-ai: API-shape family predicates
+//
+// Rule (see docs/dev/ADR-012-provider-id-vs-api-shape.md):
+//   Gate API-shape-dependent behavior (tool schemas, request payload shape,
+//   streaming format) on `model.api`, never on `model.provider`.
+//   `provider` is a credential/transport identifier that varies by vendor
+//   routing (e.g. `anthropic`, `claude-code`, `anthropic-vertex`,
+//   `amazon-bedrock`, `vercel-ai-gateway`) even when the wire protocol is
+//   identical.
+
+/** Minimal shape — any object with an optional `api` string works. */
+type HasApi = { api?: string } | null | undefined;
+
+/**
+ * True for any transport that speaks the Anthropic Messages wire protocol:
+ * direct Anthropic, Claude Code OAuth, Anthropic-on-Vertex, Vercel AI Gateway
+ * Anthropic routes, etc.
+ *
+ * Excludes Bedrock-hosted Claude — Bedrock Converse uses a different tool
+ * schema and is matched by `isBedrockApi` instead.
+ */
+export function isAnthropicApi(model: HasApi): boolean {
+  const api = model?.api;
+  return api === "anthropic-messages" || api === "anthropic-vertex";
+}
+
+/**
+ * True for any transport that speaks an OpenAI-shaped wire protocol:
+ * Chat Completions, Responses, Azure-hosted Responses, Codex-hosted Responses.
+ */
+export function isOpenAIApi(model: HasApi): boolean {
+  const api = model?.api;
+  return (
+    api === "openai-completions" ||
+    api === "openai-responses" ||
+    api === "azure-openai-responses" ||
+    api === "openai-codex-responses"
+  );
+}
+
+/**
+ * True for any transport that speaks a Google Gemini wire protocol:
+ * Generative AI REST, Gemini CLI, Vertex AI.
+ */
+export function isGeminiApi(model: HasApi): boolean {
+  const api = model?.api;
+  return (
+    api === "google-generative-ai" ||
+    api === "google-gemini-cli" ||
+    api === "google-vertex"
+  );
+}
+
+/** True for AWS Bedrock Converse transports. */
+export function isBedrockApi(model: HasApi): boolean {
+  return model?.api === "bedrock-converse-stream";
+}