@adhd/agent-core-provider 2.1.0

package/src/runtime/emit-tools.d.ts

@@ -0,0 +1,91 @@
+/**
+ * FEAT-007 runtime tool emitter.
+ *
+ * Given a ToolDefinition and a lookup function that resolves its
+ * provider_tool_formats row, branches on emit_shape:
+ *
+ *   custom       → { name, description, input_schema }  (standard custom def)
+ *   server_side  → { type: <type_tag>, name }           (no input_schema — executed server-side)
+ *   unsupported  → throws UnsupportedNativeToolError     ([inv:gate-not-noop])
+ *
+ * This is the strategic replacement for agent-mcp's toAnthropicTools(), which
+ * maps every tool to the custom shape and never emits a type-tagged server-side
+ * entry ([ref:runtime-gap]). Wiring into the live provider is agent-mcp-refactor's
+ * job (plan 6); this module delivers the emitter standalone.
+ *
+ * ([def:server-side-tool], [def:unsupported-native], [inv:server-side-shape],
+ *  [inv:gate-not-noop], RUNTIME_GAPS Gap 1 + Gap 2 + Recommended Handoff #2)
+ */
+import type { ToolDefinition } from '@adhd/agent-base-types';
+import type { ToolFormat } from '../store/tool-format-store.js';
+/** Error code for unsupported native tools ([def:unsupported-native]). */
+export type UnsupportedNativeToolErrorCode = 'UNSUPPORTED_NATIVE_TOOL';
+/**
+ * Thrown when the emitter encounters a provider-native tool that this package
+ * does not yet execute (e.g. Anthropic client-executed `bash`, `computer`).
+ *
+ * The message always names the tool + provider and includes the registered note
+ * so callers know exactly what is missing — never a silent no-op.
+ * ([inv:gate-not-noop])
+ */
+export declare class UnsupportedNativeToolError extends Error {
+    readonly code: UnsupportedNativeToolErrorCode;
+    readonly toolName: string;
+    readonly providerId: string;
+    constructor(toolName: string, providerId: string, note: string | null);
+}
+/**
+ * Standard custom tool definition emitted to the provider API.
+ * Matches the Anthropic / OpenAI `{name, description, input_schema}` shape.
+ */
+export interface EmittedCustomTool {
+    name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+}
+/**
+ * Server-side type-tagged entry emitted to the Anthropic API.
+ * Has NO `input_schema` — the tool executes on Anthropic's servers.
+ * e.g. `{ type: "web_search_20250305", name: "web_search" }`
+ * ([def:server-side-tool], [inv:server-side-shape])
+ */
+export interface EmittedServerSideTool {
+    type: string;
+    name: string;
+}
+/** Discriminated union of both emitted shapes. */
+export type EmittedTool = EmittedCustomTool | EmittedServerSideTool;
+/**
+ * A function that, given (providerId, canonicalTool), returns the registered
+ * ToolFormat row or null if no row exists.  Callers typically pass
+ * `ToolFormatStore.getShape` bound to a store instance, but can supply any
+ * compatible lookup (e.g. an in-memory fixture in tests).
+ */
+export type ToolFormatLookup = (providerId: string, canonicalTool: string) => ToolFormat | null;
+/**
+ * Emit a single tool for the given provider.
+ *
+ * Branches on `emit_shape` from the tool format lookup:
+ * - `custom` (or no registered row) → `EmittedCustomTool`
+ * - `server_side`                   → `EmittedServerSideTool` (no input_schema)
+ * - `unsupported`                   → throws `UnsupportedNativeToolError`
+ *
+ * @param tool       - The canonical ToolDefinition.
+ * @param providerId - The provider id (e.g. "anthropic") used to look up the format row.
+ * @param lookup     - Format lookup, typically `store.getShape.bind(store)`.
+ * @throws {UnsupportedNativeToolError} when the tool's emit_shape is "unsupported".
+ */
+export declare function emitTool(tool: ToolDefinition, providerId: string, lookup: ToolFormatLookup): EmittedTool;
+/**
+ * Emit all tools for the given provider, applying `emitTool` to each.
+ *
+ * Throws on the first `unsupported` tool encountered so callers get an
+ * early, actionable error rather than a partially-built list.
+ *
+ * @param tools      - Array of canonical ToolDefinitions.
+ * @param providerId - Provider id used to look up format rows.
+ * @param lookup     - Format lookup, typically `store.getShape.bind(store)`.
+ * @throws {UnsupportedNativeToolError} on the first unsupported tool.
+ */
+export declare function emitToolsForProvider(tools: ToolDefinition[], providerId: string, lookup: ToolFormatLookup): EmittedTool[];
+//# sourceMappingURL=emit-tools.d.ts.map

package/src/runtime/emit-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-tools.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-core-provider/src/runtime/emit-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAM3E,0EAA0E;AAC1E,MAAM,MAAM,8BAA8B,GAAG,yBAAyB,CAAC;AAEvE;;;;;;;GAOG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAA6B;IAC1E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CAWtE;AAMD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,kDAAkD;AAClD,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG,qBAAqB,CAAC;AAMpE;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,KAClB,UAAU,GAAG,IAAI,CAAC;AAMvB;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,gBAAgB,GACvB,WAAW,CAmCb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,EAAE,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,gBAAgB,GACvB,WAAW,EAAE,CAEf"}

package/src/runtime/emit-tools.js

@@ -0,0 +1,98 @@
+/**
+ * FEAT-007 runtime tool emitter.
+ *
+ * Given a ToolDefinition and a lookup function that resolves its
+ * provider_tool_formats row, branches on emit_shape:
+ *
+ *   custom       → { name, description, input_schema }  (standard custom def)
+ *   server_side  → { type: <type_tag>, name }           (no input_schema — executed server-side)
+ *   unsupported  → throws UnsupportedNativeToolError     ([inv:gate-not-noop])
+ *
+ * This is the strategic replacement for agent-mcp's toAnthropicTools(), which
+ * maps every tool to the custom shape and never emits a type-tagged server-side
+ * entry ([ref:runtime-gap]). Wiring into the live provider is agent-mcp-refactor's
+ * job (plan 6); this module delivers the emitter standalone.
+ *
+ * ([def:server-side-tool], [def:unsupported-native], [inv:server-side-shape],
+ *  [inv:gate-not-noop], RUNTIME_GAPS Gap 1 + Gap 2 + Recommended Handoff #2)
+ */
+/**
+ * Thrown when the emitter encounters a provider-native tool that this package
+ * does not yet execute (e.g. Anthropic client-executed `bash`, `computer`).
+ *
+ * The message always names the tool + provider and includes the registered note
+ * so callers know exactly what is missing — never a silent no-op.
+ * ([inv:gate-not-noop])
+ */
+export class UnsupportedNativeToolError extends Error {
+    code = 'UNSUPPORTED_NATIVE_TOOL';
+    toolName;
+    providerId;
+    constructor(toolName, providerId, note) {
+        const detail = note
+            ? note
+            : `${toolName} on provider ${providerId} is not supported by @adhd/agent-provider`;
+        super(`Tool '${toolName}' on provider '${providerId}' cannot be emitted: ${detail}`);
+        this.name = 'UnsupportedNativeToolError';
+        this.toolName = toolName;
+        this.providerId = providerId;
+    }
+}
+// ──────────────────────────────────────────────
+// Emitter
+// ──────────────────────────────────────────────
+/**
+ * Emit a single tool for the given provider.
+ *
+ * Branches on `emit_shape` from the tool format lookup:
+ * - `custom` (or no registered row) → `EmittedCustomTool`
+ * - `server_side`                   → `EmittedServerSideTool` (no input_schema)
+ * - `unsupported`                   → throws `UnsupportedNativeToolError`
+ *
+ * @param tool       - The canonical ToolDefinition.
+ * @param providerId - The provider id (e.g. "anthropic") used to look up the format row.
+ * @param lookup     - Format lookup, typically `store.getShape.bind(store)`.
+ * @throws {UnsupportedNativeToolError} when the tool's emit_shape is "unsupported".
+ */
+export function emitTool(tool, providerId, lookup) {
+    const format = lookup(providerId, tool.name);
+    const shape = format?.emitShape ?? 'custom';
+    switch (shape) {
+        case 'server_side': {
+            // type_tag must be set for server_side rows ([inv:server-side-shape])
+            const typeTag = format?.typeTag;
+            if (!typeTag) {
+                throw new Error(`Tool format for '${tool.name}' on provider '${providerId}' is server_side but has no type_tag`);
+            }
+            // Emitted with NO input_schema — server executes it
+            return { type: typeTag, name: tool.name };
+        }
+        case 'unsupported': {
+            // Always throw — never silent no-op ([inv:gate-not-noop])
+            throw new UnsupportedNativeToolError(tool.name, providerId, format?.note ?? null);
+        }
+        default: {
+            // "custom" or no registered row → standard tool definition shape
+            return {
+                name: tool.name,
+                description: tool.description,
+                input_schema: tool.inputSchema,
+            };
+        }
+    }
+}
+/**
+ * Emit all tools for the given provider, applying `emitTool` to each.
+ *
+ * Throws on the first `unsupported` tool encountered so callers get an
+ * early, actionable error rather than a partially-built list.
+ *
+ * @param tools      - Array of canonical ToolDefinitions.
+ * @param providerId - Provider id used to look up format rows.
+ * @param lookup     - Format lookup, typically `store.getShape.bind(store)`.
+ * @throws {UnsupportedNativeToolError} on the first unsupported tool.
+ */
+export function emitToolsForProvider(tools, providerId, lookup) {
+    return tools.map((tool) => emitTool(tool, providerId, lookup));
+}
+//# sourceMappingURL=emit-tools.js.map

package/src/runtime/emit-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-tools.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-core-provider/src/runtime/emit-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAYH;;;;;;;GAOG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC1C,IAAI,GAAmC,yBAAyB,CAAC;IACjE,QAAQ,CAAS;IACjB,UAAU,CAAS;IAE5B,YAAY,QAAgB,EAAE,UAAkB,EAAE,IAAmB;QACnE,MAAM,MAAM,GAAG,IAAI;YACjB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,GAAG,QAAQ,gBAAgB,UAAU,2CAA2C,CAAC;QACrF,KAAK,CACH,SAAS,QAAQ,kBAAkB,UAAU,wBAAwB,MAAM,EAAE,CAC9E,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AA6CD,iDAAiD;AACjD,UAAU;AACV,iDAAiD;AAEjD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAoB,EACpB,UAAkB,EAClB,MAAwB;IAExB,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAc,MAAM,EAAE,SAAS,IAAI,QAAQ,CAAC;IAEvD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,sEAAsE;YACtE,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,CAAC;YAChC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CACb,oBAAoB,IAAI,CAAC,IAAI,kBAAkB,UAAU,sCAAsC,CAChG,CAAC;YACJ,CAAC;YACD,oDAAoD;YACpD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAkC,CAAC;QAC5E,CAAC;QAED,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,0DAA0D;YAC1D,MAAM,IAAI,0BAA0B,CAClC,IAAI,CAAC,IAAI,EACT,UAAU,EACV,MAAM,EAAE,IAAI,IAAI,IAAI,CACrB,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,CAAC,CAAC;YACR,iEAAiE;YACjE,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,YAAY,EAAE,IAAI,CAAC,WAAW;aACH,CAAC;QAChC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAuB,EACvB,UAAkB,EAClB,MAAwB;IAExB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AACjE,CAAC"}

package/src/seed/bindings.d.ts

@@ -0,0 +1,16 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+interface BindingSeedRow {
+    modelId: string;
+    platform: string;
+    platformModelId: string;
+}
+export declare const BINDING_ROWS: BindingSeedRow[];
+/**
+ * Seed model-platform binding rows.
+ *
+ * The composite PK is (model_id, platform) — INSERT OR IGNORE ensures a second
+ * call is a no-op (idempotency invariant — the negative-control test bites here).
+ */
+export declare function seedBindings(db: BetterSQLite3Database<Record<string, never>>): void;
+export {};
+//# sourceMappingURL=bindings.d.ts.map

package/src/seed/bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-core-provider/src/seed/bindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAoBxE,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,YAAY,EAAE,cAAc,EA4CxC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAC/C,IAAI,CAYN"}

package/src/seed/bindings.js

@@ -0,0 +1,65 @@
+import { modelPlatformBindings } from '../db/schema.js';
+export const BINDING_ROWS = [
+    // ── claude_code aliases ───────────────────
+    {
+        modelId: 'claude_sonnet_4_6',
+        platform: 'claude_code',
+        platformModelId: 'sonnet',
+    },
+    {
+        modelId: 'claude_opus_4_8',
+        platform: 'claude_code',
+        platformModelId: 'opus',
+    },
+    {
+        modelId: 'claude_haiku_4_5',
+        platform: 'claude_code',
+        platformModelId: 'haiku',
+    },
+    {
+        modelId: 'claude_fable_5',
+        platform: 'claude_code',
+        platformModelId: 'fable',
+    },
+    // ── claude_api full ids ───────────────────
+    {
+        modelId: 'claude_sonnet_4_6',
+        platform: 'claude_api',
+        platformModelId: 'claude-sonnet-4-6',
+    },
+    {
+        modelId: 'claude_opus_4_8',
+        platform: 'claude_api',
+        platformModelId: 'claude-opus-4-8',
+    },
+    {
+        modelId: 'claude_haiku_4_5',
+        platform: 'claude_api',
+        platformModelId: 'claude-haiku-4-5-20251001',
+    },
+    {
+        modelId: 'claude_fable_5',
+        platform: 'claude_api',
+        platformModelId: 'claude-fable-5',
+    },
+];
+/**
+ * Seed model-platform binding rows.
+ *
+ * The composite PK is (model_id, platform) — INSERT OR IGNORE ensures a second
+ * call is a no-op (idempotency invariant — the negative-control test bites here).
+ */
+export function seedBindings(db) {
+    for (const row of BINDING_ROWS) {
+        db.insert(modelPlatformBindings)
+            .values({
+            modelId: row.modelId,
+            platform: row.platform,
+            platformModelId: row.platformModelId,
+        })
+            // Idempotency: composite PK (model_id, platform) — ignore on conflict.
+            .onConflictDoNothing()
+            .run();
+    }
+}
+//# sourceMappingURL=bindings.js.map

package/src/seed/bindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-core-provider/src/seed/bindings.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAwBxD,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,6CAA6C;IAC7C;QACE,OAAO,EAAE,mBAAmB;QAC5B,QAAQ,EAAE,aAAa;QACvB,eAAe,EAAE,QAAQ;KAC1B;IACD;QACE,OAAO,EAAE,iBAAiB;QAC1B,QAAQ,EAAE,aAAa;QACvB,eAAe,EAAE,MAAM;KACxB;IACD;QACE,OAAO,EAAE,kBAAkB;QAC3B,QAAQ,EAAE,aAAa;QACvB,eAAe,EAAE,OAAO;KACzB;IACD;QACE,OAAO,EAAE,gBAAgB;QACzB,QAAQ,EAAE,aAAa;QACvB,eAAe,EAAE,OAAO;KACzB;IAED,6CAA6C;IAC7C;QACE,OAAO,EAAE,mBAAmB;QAC5B,QAAQ,EAAE,YAAY;QACtB,eAAe,EAAE,mBAAmB;KACrC;IACD;QACE,OAAO,EAAE,iBAAiB;QAC1B,QAAQ,EAAE,YAAY;QACtB,eAAe,EAAE,iBAAiB;KACnC;IACD;QACE,OAAO,EAAE,kBAAkB;QAC3B,QAAQ,EAAE,YAAY;QACtB,eAAe,EAAE,2BAA2B;KAC7C;IACD;QACE,OAAO,EAAE,gBAAgB;QACzB,QAAQ,EAAE,YAAY;QACtB,eAAe,EAAE,gBAAgB;KAClC;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,EAAgD;IAEhD,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC;aAC7B,MAAM,CAAC;YACN,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,eAAe,EAAE,GAAG,CAAC,eAAe;SACrC,CAAC;YACF,uEAAuE;aACtE,mBAAmB,EAAE;aACrB,GAAG,EAAE,CAAC;IACX,CAAC;AACH,CAAC"}

package/src/seed/index.d.ts

@@ -0,0 +1,13 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+/**
+ * Idempotent seeder for all agent-provider lookup tables.
+ *
+ * Safe to call on every process start.  Subsequent runs after the first are
+ * silent no-ops: each insert uses `onConflictDoNothing()` so duplicate rows
+ * are never written and counts never change.
+ */
+export declare function seed(db: BetterSQLite3Database<Record<string, never>>): void;
+export { seedProviders, SEEDED_PROVIDER_IDS } from './providers.js';
+export { seedModels, MODEL_ROWS, SEEDED_MODEL_IDS } from './models.js';
+export { seedBindings, BINDING_ROWS } from './bindings.js';
+//# sourceMappingURL=index.d.ts.map

package/src/seed/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-core-provider/src/seed/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAiBxE;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,EAAE,EAAE,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAAG,IAAI,CAI3E;AAED,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/src/seed/index.js

@@ -0,0 +1,29 @@
+import { seedBindings } from './bindings.js';
+import { seedModels } from './models.js';
+import { seedProviders } from './providers.js';
+// ──────────────────────────────────────────────
+// Unified seeder — providers, models, bindings
+//
+// Call seed(db) once to populate all lookup tables.  A second call is a no-op
+// (INSERT OR IGNORE on every table) — row counts remain identical, no version
+// drift ([inv:reopen-proves-persistence], [dod.3]).
+//
+// Ordering: providers → models → bindings (logical dependency order, though
+// there are no SQL FKs in the shared-DB topology).
+// ──────────────────────────────────────────────
+/**
+ * Idempotent seeder for all agent-provider lookup tables.
+ *
+ * Safe to call on every process start.  Subsequent runs after the first are
+ * silent no-ops: each insert uses `onConflictDoNothing()` so duplicate rows
+ * are never written and counts never change.
+ */
+export function seed(db) {
+    seedProviders(db);
+    seedModels(db);
+    seedBindings(db);
+}
+export { seedProviders, SEEDED_PROVIDER_IDS } from './providers.js';
+export { seedModels, MODEL_ROWS, SEEDED_MODEL_IDS } from './models.js';
+export { seedBindings, BINDING_ROWS } from './bindings.js';
+//# sourceMappingURL=index.js.map

package/src/seed/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-core-provider/src/seed/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,iDAAiD;AACjD,+CAA+C;AAC/C,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,oDAAoD;AACpD,EAAE;AACF,4EAA4E;AAC5E,mDAAmD;AACnD,iDAAiD;AAEjD;;;;;;GAMG;AACH,MAAM,UAAU,IAAI,CAAC,EAAgD;IACnE,aAAa,CAAC,EAAE,CAAC,CAAC;IAClB,UAAU,CAAC,EAAE,CAAC,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,CAAC;AACnB,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/src/seed/models.d.ts

@@ -0,0 +1,22 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+interface ModelSeedRow {
+    id: string;
+    contextWindow: number;
+    outputLimit: number;
+    vision: boolean;
+    promptCaching: boolean;
+    extendedThinking: boolean;
+    pricingTier: string;
+}
+export declare const MODEL_ROWS: ModelSeedRow[];
+/**
+ * Seed canonical model rows.
+ *
+ * Uses INSERT OR IGNORE so a second call is a silent no-op
+ * ([inv:reopen-proves-persistence]: counts are identical on second run).
+ */
+export declare function seedModels(db: BetterSQLite3Database<Record<string, never>>): void;
+/** Canonical model ids shipped by this seed module. */
+export declare const SEEDED_MODEL_IDS: string[];
+export {};
+//# sourceMappingURL=models.d.ts.map

package/src/seed/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-core-provider/src/seed/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAUxE,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,UAAU,EAAE,YAAY,EAqCpC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,EAAE,EAAE,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAC/C,IAAI,CAoBN;AAED,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,UAA8B,CAAC"}

package/src/seed/models.js

@@ -0,0 +1,68 @@
+import { models } from '../db/schema.js';
+export const MODEL_ROWS = [
+    {
+        id: 'claude_sonnet_4_6',
+        contextWindow: 200_000,
+        outputLimit: 8_192,
+        vision: true,
+        promptCaching: true,
+        extendedThinking: false,
+        pricingTier: 'standard',
+    },
+    {
+        id: 'claude_opus_4_8',
+        contextWindow: 200_000,
+        outputLimit: 32_000,
+        vision: true,
+        promptCaching: true,
+        extendedThinking: true,
+        pricingTier: 'premium',
+    },
+    {
+        id: 'claude_haiku_4_5',
+        contextWindow: 200_000,
+        outputLimit: 8_192,
+        vision: true,
+        promptCaching: true,
+        extendedThinking: false,
+        pricingTier: 'economy',
+    },
+    {
+        id: 'claude_fable_5',
+        contextWindow: 200_000,
+        outputLimit: 32_000,
+        vision: true,
+        promptCaching: true,
+        extendedThinking: true,
+        pricingTier: 'premium',
+    },
+];
+/**
+ * Seed canonical model rows.
+ *
+ * Uses INSERT OR IGNORE so a second call is a silent no-op
+ * ([inv:reopen-proves-persistence]: counts are identical on second run).
+ */
+export function seedModels(db) {
+    const now = new Date().toISOString();
+    for (const row of MODEL_ROWS) {
+        db.insert(models)
+            .values({
+            id: row.id,
+            contextWindow: row.contextWindow,
+            outputLimit: row.outputLimit,
+            vision: row.vision,
+            promptCaching: row.promptCaching,
+            extendedThinking: row.extendedThinking,
+            pricingTier: row.pricingTier,
+            createdAt: now,
+            updatedAt: now,
+        })
+            // Idempotency: ignore if the PK already exists.
+            .onConflictDoNothing()
+            .run();
+    }
+}
+/** Canonical model ids shipped by this seed module. */
+export const SEEDED_MODEL_IDS = MODEL_ROWS.map((r) => r.id);
+//# sourceMappingURL=models.js.map

package/src/seed/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-core-provider/src/seed/models.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAkBzC,MAAM,CAAC,MAAM,UAAU,GAAmB;IACxC;QACE,EAAE,EAAE,mBAAmB;QACvB,aAAa,EAAE,OAAO;QACtB,WAAW,EAAE,KAAK;QAClB,MAAM,EAAE,IAAI;QACZ,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,KAAK;QACvB,WAAW,EAAE,UAAU;KACxB;IACD;QACE,EAAE,EAAE,iBAAiB;QACrB,aAAa,EAAE,OAAO;QACtB,WAAW,EAAE,MAAM;QACnB,MAAM,EAAE,IAAI;QACZ,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,IAAI;QACtB,WAAW,EAAE,SAAS;KACvB;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,aAAa,EAAE,OAAO;QACtB,WAAW,EAAE,KAAK;QAClB,MAAM,EAAE,IAAI;QACZ,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,KAAK;QACvB,WAAW,EAAE,SAAS;KACvB;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,aAAa,EAAE,OAAO;QACtB,WAAW,EAAE,MAAM;QACnB,MAAM,EAAE,IAAI;QACZ,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,IAAI;QACtB,WAAW,EAAE,SAAS;KACvB;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACxB,EAAgD;IAEhD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;aACd,MAAM,CAAC;YACN,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;YACtC,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf,CAAC;YACF,gDAAgD;aAC/C,mBAAmB,EAAE;aACrB,GAAG,EAAE,CAAC;IACX,CAAC;AACH,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC"}

package/src/seed/providers.d.ts

@@ -0,0 +1,11 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+/**
+ * Seed provider rows.
+ *
+ * Uses INSERT OR IGNORE so a second call is a silent no-op
+ * ([inv:reopen-proves-persistence]: counts are identical on second run).
+ */
+export declare function seedProviders(db: BetterSQLite3Database<Record<string, never>>): void;
+/** Canonical provider ids shipped by this seed module. */
+export declare const SEEDED_PROVIDER_IDS: string[];
+//# sourceMappingURL=providers.d.ts.map

package/src/seed/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-core-provider/src/seed/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAwDxE;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAC/C,IAAI,CAkBN;AAED,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,UAAiC,CAAC"}

package/src/seed/providers.js

@@ -0,0 +1,65 @@
+import { providers } from '../db/schema.js';
+const PROVIDER_ROWS = [
+    {
+        id: 'anthropic',
+        transport: 'HTTP',
+        authPattern: 'bearer',
+        baseUrl: 'https://api.anthropic.com',
+        endpointTemplate: 'https://api.anthropic.com/v1/messages',
+    },
+    {
+        id: 'openai',
+        transport: 'HTTP',
+        authPattern: 'bearer',
+        baseUrl: 'https://api.openai.com',
+        endpointTemplate: 'https://api.openai.com/v1/chat/completions',
+    },
+    {
+        id: 'bedrock',
+        transport: 'HTTP',
+        authPattern: 'aws-sigv4',
+        baseUrl: 'https://bedrock-runtime.{region}.amazonaws.com',
+        endpointTemplate: 'https://bedrock-runtime.{region}.amazonaws.com/model/{model}/converse-stream',
+    },
+    {
+        id: 'lmstudio',
+        transport: 'HTTP',
+        authPattern: 'none',
+        baseUrl: 'http://localhost:1234',
+        endpointTemplate: 'http://localhost:1234/v1/chat/completions',
+    },
+    {
+        id: 'claudecli',
+        transport: 'stdio',
+        authPattern: 'none',
+        baseUrl: null,
+        endpointTemplate: null,
+    },
+];
+/**
+ * Seed provider rows.
+ *
+ * Uses INSERT OR IGNORE so a second call is a silent no-op
+ * ([inv:reopen-proves-persistence]: counts are identical on second run).
+ */
+export function seedProviders(db) {
+    const now = new Date().toISOString();
+    for (const row of PROVIDER_ROWS) {
+        db.insert(providers)
+            .values({
+            id: row.id,
+            transport: row.transport,
+            authPattern: row.authPattern,
+            baseUrl: row.baseUrl,
+            endpointTemplate: row.endpointTemplate,
+            createdAt: now,
+            updatedAt: now,
+        })
+            // Idempotency: ignore if the PK already exists.
+            .onConflictDoNothing()
+            .run();
+    }
+}
+/** Canonical provider ids shipped by this seed module. */
+export const SEEDED_PROVIDER_IDS = PROVIDER_ROWS.map((r) => r.id);
+//# sourceMappingURL=providers.js.map

package/src/seed/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-core-provider/src/seed/providers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAe5C,MAAM,aAAa,GAAsB;IACvC;QACE,EAAE,EAAE,WAAW;QACf,SAAS,EAAE,MAAM;QACjB,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,2BAA2B;QACpC,gBAAgB,EAAE,uCAAuC;KAC1D;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,SAAS,EAAE,MAAM;QACjB,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,wBAAwB;QACjC,gBAAgB,EAAE,4CAA4C;KAC/D;IACD;QACE,EAAE,EAAE,SAAS;QACb,SAAS,EAAE,MAAM;QACjB,WAAW,EAAE,WAAW;QACxB,OAAO,EAAE,gDAAgD;QACzD,gBAAgB,EACd,8EAA8E;KACjF;IACD;QACE,EAAE,EAAE,UAAU;QACd,SAAS,EAAE,MAAM;QACjB,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,uBAAuB;QAChC,gBAAgB,EAAE,2CAA2C;KAC9D;IACD;QACE,EAAE,EAAE,WAAW;QACf,SAAS,EAAE,OAAO;QAClB,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,IAAI;QACb,gBAAgB,EAAE,IAAI;KACvB;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,EAAgD;IAEhD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC;aACjB,MAAM,CAAC;YACN,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;YACtC,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf,CAAC;YACF,gDAAgD;aAC/C,mBAAmB,EAAE;aACrB,GAAG,EAAE,CAAC;IACX,CAAC;AACH,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC"}

package/src/store/model-store.d.ts

@@ -0,0 +1,69 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+export interface Model {
+    id: string;
+    contextWindow: number;
+    outputLimit: number;
+    vision: boolean;
+    promptCaching: boolean;
+    extendedThinking: boolean;
+    pricingTier: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ModelCreateInput {
+    id: string;
+    contextWindow: number;
+    outputLimit: number;
+    vision?: boolean;
+    promptCaching?: boolean;
+    extendedThinking?: boolean;
+    pricingTier: string;
+}
+export interface ModelPlatformBinding {
+    modelId: string;
+    platform: string;
+    platformModelId: string;
+}
+export interface ModelPlatformBindingCreateInput {
+    modelId: string;
+    platform: string;
+    platformModelId: string;
+}
+export type ModelErrorCode = 'MODEL_ALREADY_EXISTS' | 'MODEL_NOT_FOUND' | 'MODEL_BINDING_NOT_FOUND';
+export declare class ModelStoreError extends Error {
+    readonly code: ModelErrorCode;
+    constructor(code: ModelErrorCode, message: string);
+}
+export declare class ModelStore {
+    private readonly db;
+    constructor(db: BetterSQLite3Database<Record<string, never>>);
+    /**
+     * Insert a new model row.
+     * Throws MODEL_ALREADY_EXISTS if the id is taken.
+     */
+    create(input: ModelCreateInput): Model;
+    /**
+     * Read a model by id.
+     * Throws MODEL_NOT_FOUND if missing.
+     */
+    read(id: string): Model;
+    /** Return all model rows. */
+    list(): Model[];
+    private _rowToModel;
+    /**
+     * Insert a model-platform binding row.
+     * model_id is a logical key (no SQL FK — seeding order flexibility).
+     */
+    createBinding(input: ModelPlatformBindingCreateInput): ModelPlatformBinding;
+    /**
+     * Resolve a canonical model id + platform to the provider-specific string.
+     *
+     * The `WHERE platform = ?` clause is the single gating filter that makes the
+     * negative-control test bite: removing it collapses both platforms to the
+     * first binding row — keep the filter here and nowhere else.
+     *
+     * Throws MODEL_BINDING_NOT_FOUND if no row exists for (canonicalId, platform).
+     */
+    resolveModelId(canonicalId: string, platform: string): string;
+}
+//# sourceMappingURL=model-store.d.ts.map

package/src/store/model-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-store.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-core-provider/src/store/model-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAQxE,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAMD,MAAM,MAAM,cAAc,GACtB,sBAAsB,GACtB,iBAAiB,GACjB,yBAAyB,CAAC;AAE9B,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;gBAElB,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM;CAKlD;AAUD,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAGnE;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,KAAK;IAkCtC;;;OAGG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK;IAUvB,6BAA6B;IAC7B,IAAI,IAAI,KAAK,EAAE;IAQf,OAAO,CAAC,WAAW;IAoBnB;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,+BAA+B,GAAG,oBAAoB;IAiB3E;;;;;;;;OAQG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;CAqB9D"}