@adhd/agent-store-tools 2.1.0

package/src/seed/tools.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Canonical tool seed data.
+ *
+ * Source of truth: docs/plan/agent-registry/SEED_DATA.md §6 — Tool Registry table.
+ *
+ * Each row is a canonical, platform-independent agent capability.
+ * The type FK references tool_types.slug — all types must be seeded first.
+ */
+export interface ToolSeedRow {
+    name: string;
+    type: string;
+    description: string;
+    requiresApproval: boolean;
+    isDestructive: boolean;
+}
+/** All 15 canonical tools shipped with the registry. */
+export declare const TOOL_SEEDS: ToolSeedRow[];
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-store-tools/src/seed/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wDAAwD;AACxD,eAAO,MAAM,UAAU,EAAE,WAAW,EA0GnC,CAAC"}

package/src/seed/tools.js

@@ -0,0 +1,117 @@
+/**
+ * Canonical tool seed data.
+ *
+ * Source of truth: docs/plan/agent-registry/SEED_DATA.md §6 — Tool Registry table.
+ *
+ * Each row is a canonical, platform-independent agent capability.
+ * The type FK references tool_types.slug — all types must be seeded first.
+ */
+/** All 15 canonical tools shipped with the registry. */
+export const TOOL_SEEDS = [
+    {
+        name: 'file_read',
+        type: 'io',
+        description: 'Read file contents from the filesystem',
+        requiresApproval: false,
+        isDestructive: false,
+    },
+    {
+        name: 'file_write',
+        type: 'io',
+        description: 'Write or overwrite a file',
+        requiresApproval: false,
+        isDestructive: true,
+    },
+    {
+        name: 'file_edit',
+        type: 'io',
+        description: 'Apply targeted string replacements to a file',
+        requiresApproval: false,
+        isDestructive: true,
+    },
+    {
+        name: 'file_glob',
+        type: 'io',
+        description: 'Find files matching a glob pattern',
+        requiresApproval: false,
+        isDestructive: false,
+    },
+    {
+        name: 'file_grep',
+        type: 'io',
+        description: 'Search file contents with regex',
+        requiresApproval: false,
+        isDestructive: false,
+    },
+    {
+        name: 'shell_exec',
+        type: 'compute',
+        description: 'Execute a shell command',
+        requiresApproval: true,
+        isDestructive: true,
+    },
+    {
+        name: 'web_fetch',
+        type: 'network',
+        description: 'Fetch content from a URL',
+        requiresApproval: false,
+        isDestructive: false,
+    },
+    {
+        name: 'web_search',
+        type: 'network',
+        description: 'Run a web search query',
+        requiresApproval: false,
+        isDestructive: false,
+    },
+    {
+        name: 'mcp_list_resources',
+        type: 'memory',
+        description: 'List available MCP server resources',
+        requiresApproval: false,
+        isDestructive: false,
+    },
+    {
+        name: 'mcp_read_resource',
+        type: 'memory',
+        description: 'Read a specific MCP resource by URI',
+        requiresApproval: false,
+        isDestructive: false,
+    },
+    {
+        name: 'mcp_wait',
+        type: 'meta',
+        description: 'Block until MCP servers are ready',
+        requiresApproval: false,
+        isDestructive: false,
+    },
+    {
+        name: 'human_input',
+        type: 'ui',
+        description: 'Request input from the human operator',
+        requiresApproval: false,
+        isDestructive: false,
+    },
+    {
+        name: 'process_monitor',
+        type: 'compute',
+        description: 'Monitor a background process for output',
+        requiresApproval: false,
+        isDestructive: false,
+    },
+    {
+        name: 'code_analysis',
+        type: 'lsp',
+        description: 'LSP diagnostics, definitions, hover info',
+        requiresApproval: false,
+        isDestructive: false,
+    },
+    {
+        name: 'notebook_edit',
+        type: 'notebook',
+        description: 'Edit a Jupyter notebook cell',
+        requiresApproval: false,
+        isDestructive: true,
+    },
+];
+//# sourceMappingURL=tools.js.map

package/src/seed/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-store-tools/src/seed/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,wDAAwD;AACxD,MAAM,CAAC,MAAM,UAAU,GAAkB;IACvC;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,wCAAwC;QACrD,gBAAgB,EAAE,KAAK;QACvB,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,2BAA2B;QACxC,gBAAgB,EAAE,KAAK;QACvB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,8CAA8C;QAC3D,gBAAgB,EAAE,KAAK;QACvB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,oCAAoC;QACjD,gBAAgB,EAAE,KAAK;QACvB,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,iCAAiC;QAC9C,gBAAgB,EAAE,KAAK;QACvB,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,yBAAyB;QACtC,gBAAgB,EAAE,IAAI;QACtB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,0BAA0B;QACvC,gBAAgB,EAAE,KAAK;QACvB,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,wBAAwB;QACrC,gBAAgB,EAAE,KAAK;QACvB,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,qCAAqC;QAClD,gBAAgB,EAAE,KAAK;QACvB,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,qCAAqC;QAClD,gBAAgB,EAAE,KAAK;QACvB,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,mCAAmC;QAChD,gBAAgB,EAAE,KAAK;QACvB,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,uCAAuC;QACpD,gBAAgB,EAAE,KAAK;QACvB,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,yCAAyC;QACtD,gBAAgB,EAAE,KAAK;QACvB,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,0CAA0C;QACvD,gBAAgB,EAAE,KAAK;QACvB,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,8BAA8B;QAC3C,gBAAgB,EAAE,KAAK;QACvB,aAAa,EAAE,IAAI;KACpB;CACF,CAAC"}

package/src/store/agent-tool-store.d.ts

@@ -0,0 +1,63 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+/**
+ * The permission level granted to an agent for a canonical tool.
+ *
+ * Plain text value — NOT a SQL enum ([inv:lookup-not-enum]).
+ * Allowed values: full | read_only | restricted.
+ */
+export type PermissionLevel = 'full' | 'read_only' | 'restricted';
+/**
+ * One agent_tools junction row: an agent_slug granted access to a tool_name
+ * at a typed permission level, with an optional context_condition.
+ *
+ * agent_slug is a LOGICAL key into agent-registry's `agents` table — it is
+ * NOT a SQLite FK ([inv:no-cross-pkg-fk]). The linkage is resolved at compile
+ * time by @adhd/agent-engine-compiler. Accepts any string slug, even one with no
+ * matching row in the agents table (there is no such table in this package).
+ */
+export interface AgentToolGrant {
+    agentSlug: string;
+    toolName: string;
+    permission: PermissionLevel;
+    /** null means the grant always applies. */
+    contextCondition: Record<string, unknown> | null;
+}
+/** Input for granting a tool to an agent. */
+export interface AgentToolGrantInput {
+    agentSlug: string;
+    toolName: string;
+    permission: PermissionLevel;
+    /** Omit or pass null to mean "always applies". */
+    contextCondition?: Record<string, unknown> | null;
+}
+export type AgentToolStoreErrorCode = 'GRANT_ALREADY_EXISTS' | 'GRANT_NOT_FOUND';
+export declare class AgentToolStoreError extends Error {
+    readonly code: AgentToolStoreErrorCode;
+    constructor(code: AgentToolStoreErrorCode, message: string);
+}
+export declare class AgentToolStore {
+    private readonly db;
+    constructor(db: BetterSQLite3Database<Record<string, never>>);
+    /**
+     * Grant a canonical tool to an agent at a typed permission level.
+     *
+     * agent_slug is a LOGICAL reference — no FK check is performed against any
+     * agents table ([inv:no-cross-pkg-fk]). Any string is accepted.
+     *
+     * Throws GRANT_ALREADY_EXISTS if the (agent_slug, tool_name) pair exists.
+     */
+    grant(input: AgentToolGrantInput): AgentToolGrant;
+    /**
+     * Return all grants for a given agent slug.
+     *
+     * Returns an empty array if no grants exist (or if the slug has never
+     * been granted any tool — agent_slug carries no FK constraint).
+     */
+    listForAgent(agentSlug: string): AgentToolGrant[];
+    /**
+     * Revoke a tool grant from an agent.
+     * Throws GRANT_NOT_FOUND if the (agent_slug, tool_name) pair does not exist.
+     */
+    revoke(agentSlug: string, toolName: string): void;
+}
+//# sourceMappingURL=agent-tool-store.d.ts.map

package/src/store/agent-tool-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tool-store.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-store-tools/src/store/agent-tool-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAQxE;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,CAAC;AAElE;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,eAAe,CAAC;IAC5B,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAClD;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,eAAe,CAAC;IAC5B,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACnD;AAMD,MAAM,MAAM,uBAAuB,GAC/B,sBAAsB,GACtB,iBAAiB,CAAC;AAEtB,qBAAa,mBAAoB,SAAQ,KAAK;aAChB,IAAI,EAAE,uBAAuB;gBAA7B,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,MAAM;CAI3E;AAcD,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAGnE;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc;IAwCjD;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE;IAejD;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CA6BlD"}

package/src/store/agent-tool-store.js

@@ -0,0 +1,100 @@
+import { and, eq } from 'drizzle-orm';
+import { agentToolsTable } from '../db/schema.js';
+export class AgentToolStoreError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'AgentToolStoreError';
+    }
+}
+// ──────────────────────────────────────────────
+// AgentToolStore
+//
+// Thin Drizzle queries over agent_tools.
+// Mirrors the pattern in entrypoint/agent-mcp's AgentStore (agent-cache-store pattern).
+// Constructor accepts a BetterSQLite3Database so tests can inject their own
+// connection without touching the production singleton in client.ts.
+//
+// CRITICAL: grant() persists the `permission` argument verbatim. Do not
+// hardcode a default — the [dod.3] negative-control breaks on exactly this.
+// ──────────────────────────────────────────────
+export class AgentToolStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Grant a canonical tool to an agent at a typed permission level.
+     *
+     * agent_slug is a LOGICAL reference — no FK check is performed against any
+     * agents table ([inv:no-cross-pkg-fk]). Any string is accepted.
+     *
+     * Throws GRANT_ALREADY_EXISTS if the (agent_slug, tool_name) pair exists.
+     */
+    grant(input) {
+        const existing = this.db
+            .select()
+            .from(agentToolsTable)
+            .where(and(eq(agentToolsTable.agentSlug, input.agentSlug), eq(agentToolsTable.toolName, input.toolName)))
+            .get();
+        if (existing) {
+            throw new AgentToolStoreError('GRANT_ALREADY_EXISTS', `Grant for agent '${input.agentSlug}' on tool '${input.toolName}' already exists`);
+        }
+        const grant = {
+            agentSlug: input.agentSlug,
+            toolName: input.toolName,
+            // Persist verbatim — CRITICAL for [dod.3] negative-control
+            permission: input.permission,
+            contextCondition: input.contextCondition ?? null,
+        };
+        this.db
+            .insert(agentToolsTable)
+            .values({
+            agentSlug: grant.agentSlug,
+            toolName: grant.toolName,
+            permission: grant.permission,
+            contextCondition: grant.contextCondition,
+        })
+            .run();
+        return grant;
+    }
+    /**
+     * Return all grants for a given agent slug.
+     *
+     * Returns an empty array if no grants exist (or if the slug has never
+     * been granted any tool — agent_slug carries no FK constraint).
+     */
+    listForAgent(agentSlug) {
+        const rows = this.db
+            .select()
+            .from(agentToolsTable)
+            .where(eq(agentToolsTable.agentSlug, agentSlug))
+            .all();
+        return rows.map((row) => ({
+            agentSlug: row.agentSlug,
+            toolName: row.toolName,
+            permission: row.permission,
+            contextCondition: row.contextCondition,
+        }));
+    }
+    /**
+     * Revoke a tool grant from an agent.
+     * Throws GRANT_NOT_FOUND if the (agent_slug, tool_name) pair does not exist.
+     */
+    revoke(agentSlug, toolName) {
+        const existing = this.db
+            .select()
+            .from(agentToolsTable)
+            .where(and(eq(agentToolsTable.agentSlug, agentSlug), eq(agentToolsTable.toolName, toolName)))
+            .get();
+        if (!existing) {
+            throw new AgentToolStoreError('GRANT_NOT_FOUND', `Grant for agent '${agentSlug}' on tool '${toolName}' not found`);
+        }
+        this.db
+            .delete(agentToolsTable)
+            .where(and(eq(agentToolsTable.agentSlug, agentSlug), eq(agentToolsTable.toolName, toolName)))
+            .run();
+    }
+}
+//# sourceMappingURL=agent-tool-store.js.map

package/src/store/agent-tool-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tool-store.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-store-tools/src/store/agent-tool-store.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,75 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+/** A runtime environment a canonical tool can be deployed to. */
+export interface Platform {
+    id: string;
+    name: string;
+    /** One of: yaml_frontmatter | json_object | none */
+    headerFormat: string;
+    supportsToolSelection: boolean;
+}
+/** Input for seeding a platform row. */
+export interface PlatformSeedInput {
+    id: string;
+    name: string;
+    headerFormat: string;
+    supportsToolSelection?: boolean;
+}
+/**
+ * The per-platform alias for a canonical tool.
+ *
+ * availability is one of: available | restricted | unavailable | requires_permission
+ */
+export interface ToolPlatformBinding {
+    toolName: string;
+    platformId: string;
+    platformToolName: string;
+    availability: string;
+    requiresMcp: boolean;
+    invocationNote: string | null;
+}
+/** Input for inserting a tool-platform binding row. */
+export interface BindingCreateInput {
+    toolName: string;
+    platformId: string;
+    platformToolName: string;
+    availability: string;
+    requiresMcp?: boolean;
+    invocationNote?: string | null;
+}
+export type BindingStoreErrorCode = 'BINDING_NOT_FOUND' | 'PLATFORM_NOT_FOUND' | 'BINDING_ALREADY_EXISTS';
+export declare class BindingStoreError extends Error {
+    readonly code: BindingStoreErrorCode;
+    constructor(code: BindingStoreErrorCode, message: string);
+}
+export declare class BindingStore {
+    private readonly db;
+    constructor(db: BetterSQLite3Database<Record<string, never>>);
+    /** Seed or upsert a platform row. Idempotent via onConflictDoNothing. */
+    seedPlatform(input: PlatformSeedInput): void;
+    /** Read a platform by id. Throws PLATFORM_NOT_FOUND if absent. */
+    readPlatform(id: string): Platform;
+    /** List all seeded platforms. */
+    listPlatforms(): Platform[];
+    /**
+     * Insert a tool-platform binding.
+     * Throws BINDING_ALREADY_EXISTS if the (toolName, platformId) PK is taken.
+     */
+    createBinding(input: BindingCreateInput): ToolPlatformBinding;
+    /**
+     * [def:resolve] — The keystone primitive.
+     *
+     * Returns the platform_tool_name for (canonicalToolName, platformId),
+     * or throws BINDING_NOT_FOUND if no binding exists for that exact pair.
+     *
+     * MUST filter on BOTH tool_name AND platform_id — the [dod.1] negative-
+     * control breaks this function by ignoring the platform argument, which
+     * would return the wrong alias when multiple bindings exist for a tool.
+     */
+    resolve(canonicalToolName: string, platformId: string): string;
+    /**
+     * List all bindings for a given platform.
+     * Used by @adhd/agent-engine-compiler to build the platform's tools: header.
+     */
+    listForPlatform(platformId: string): ToolPlatformBinding[];
+}
+//# sourceMappingURL=binding-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binding-store.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-store-tools/src/store/binding-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAQxE,iEAAiE;AACjE,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAMD,MAAM,MAAM,qBAAqB,GAC7B,mBAAmB,GACnB,oBAAoB,GACpB,wBAAwB,CAAC;AAE7B,qBAAa,iBAAkB,SAAQ,KAAK;aACd,IAAI,EAAE,qBAAqB;gBAA3B,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM;CAIzE;AAWD,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAKnE,yEAAyE;IACzE,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAa5C,kEAAkE;IAClE,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ;IAsBlC,iCAAiC;IACjC,aAAa,IAAI,QAAQ,EAAE;IAe3B;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB;IA2C7D;;;;;;;;;OASG;IACH,OAAO,CAAC,iBAAiB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAsB9D;;;OAGG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,mBAAmB,EAAE;CAe3D"}

package/src/store/binding-store.js

@@ -0,0 +1,144 @@
+import { and, eq } from 'drizzle-orm';
+import { platformsTable, toolPlatformBindingsTable } from '../db/schema.js';
+export class BindingStoreError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'BindingStoreError';
+    }
+}
+// ──────────────────────────────────────────────
+// BindingStore
+//
+// Thin Drizzle queries over platforms and tool_platform_bindings.
+// Mirrors the pattern in entrypoint/agent-mcp's AgentStore (agent-cache-store pattern).
+// Constructor accepts a BetterSQLite3Database so tests can inject their own
+// connection without touching the production singleton in client.ts.
+// ──────────────────────────────────────────────
+export class BindingStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    // ── platforms ─────────────────────────────
+    /** Seed or upsert a platform row. Idempotent via onConflictDoNothing. */
+    seedPlatform(input) {
+        this.db
+            .insert(platformsTable)
+            .values({
+            id: input.id,
+            name: input.name,
+            headerFormat: input.headerFormat,
+            supportsToolSelection: input.supportsToolSelection ?? false,
+        })
+            .onConflictDoNothing()
+            .run();
+    }
+    /** Read a platform by id. Throws PLATFORM_NOT_FOUND if absent. */
+    readPlatform(id) {
+        const row = this.db
+            .select()
+            .from(platformsTable)
+            .where(eq(platformsTable.id, id))
+            .get();
+        if (!row) {
+            throw new BindingStoreError('PLATFORM_NOT_FOUND', `Platform '${id}' not found`);
+        }
+        return {
+            id: row.id,
+            name: row.name,
+            headerFormat: row.headerFormat,
+            supportsToolSelection: row.supportsToolSelection,
+        };
+    }
+    /** List all seeded platforms. */
+    listPlatforms() {
+        return this.db
+            .select()
+            .from(platformsTable)
+            .all()
+            .map((row) => ({
+            id: row.id,
+            name: row.name,
+            headerFormat: row.headerFormat,
+            supportsToolSelection: row.supportsToolSelection,
+        }));
+    }
+    // ── tool_platform_bindings ────────────────
+    /**
+     * Insert a tool-platform binding.
+     * Throws BINDING_ALREADY_EXISTS if the (toolName, platformId) PK is taken.
+     */
+    createBinding(input) {
+        const existing = this.db
+            .select()
+            .from(toolPlatformBindingsTable)
+            .where(and(eq(toolPlatformBindingsTable.toolName, input.toolName), eq(toolPlatformBindingsTable.platformId, input.platformId)))
+            .get();
+        if (existing) {
+            throw new BindingStoreError('BINDING_ALREADY_EXISTS', `Binding for ('${input.toolName}', '${input.platformId}') already exists`);
+        }
+        const binding = {
+            toolName: input.toolName,
+            platformId: input.platformId,
+            platformToolName: input.platformToolName,
+            availability: input.availability,
+            requiresMcp: input.requiresMcp ?? false,
+            invocationNote: input.invocationNote ?? null,
+        };
+        this.db
+            .insert(toolPlatformBindingsTable)
+            .values({
+            toolName: binding.toolName,
+            platformId: binding.platformId,
+            platformToolName: binding.platformToolName,
+            availability: binding.availability,
+            requiresMcp: binding.requiresMcp,
+            invocationNote: binding.invocationNote,
+        })
+            .run();
+        return binding;
+    }
+    /**
+     * [def:resolve] — The keystone primitive.
+     *
+     * Returns the platform_tool_name for (canonicalToolName, platformId),
+     * or throws BINDING_NOT_FOUND if no binding exists for that exact pair.
+     *
+     * MUST filter on BOTH tool_name AND platform_id — the [dod.1] negative-
+     * control breaks this function by ignoring the platform argument, which
+     * would return the wrong alias when multiple bindings exist for a tool.
+     */
+    resolve(canonicalToolName, platformId) {
+        const row = this.db
+            .select()
+            .from(toolPlatformBindingsTable)
+            .where(and(eq(toolPlatformBindingsTable.toolName, canonicalToolName), eq(toolPlatformBindingsTable.platformId, platformId)))
+            .get();
+        if (!row) {
+            throw new BindingStoreError('BINDING_NOT_FOUND', `No binding found for tool '${canonicalToolName}' on platform '${platformId}'`);
+        }
+        return row.platformToolName;
+    }
+    /**
+     * List all bindings for a given platform.
+     * Used by @adhd/agent-engine-compiler to build the platform's tools: header.
+     */
+    listForPlatform(platformId) {
+        return this.db
+            .select()
+            .from(toolPlatformBindingsTable)
+            .where(eq(toolPlatformBindingsTable.platformId, platformId))
+            .all()
+            .map((row) => ({
+            toolName: row.toolName,
+            platformId: row.platformId,
+            platformToolName: row.platformToolName,
+            availability: row.availability,
+            requiresMcp: row.requiresMcp,
+            invocationNote: row.invocationNote,
+        }));
+    }
+}
+//# sourceMappingURL=binding-store.js.map

package/src/store/binding-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-store.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-store-tools/src/store/binding-store.ts"],"names":[],"mappings":"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"}

package/src/store/mcp-server-store.d.ts

@@ -0,0 +1,46 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+/**
+ * An MCP server registration row.
+ *
+ * transport is one of: stdio | SSE | HTTP (plain text, not an enum).
+ * providedToolIds is a JSON array of canonical tool names — logical references
+ * resolved at compile time; no SQLite FK ([inv:no-cross-pkg-fk]).
+ * configSchema is a JSON-Schema object for this server's configuration.
+ */
+export interface McpServer {
+    id: string;
+    transport: string;
+    name: string;
+    providedToolIds: string[];
+    configSchema: Record<string, unknown>;
+}
+/** Input for registering an MCP server. */
+export interface McpServerCreateInput {
+    id: string;
+    transport: string;
+    name: string;
+    providedToolIds?: string[];
+    configSchema?: Record<string, unknown>;
+}
+export type McpServerStoreErrorCode = 'MCP_SERVER_ALREADY_EXISTS' | 'MCP_SERVER_NOT_FOUND';
+export declare class McpServerStoreError extends Error {
+    readonly code: McpServerStoreErrorCode;
+    constructor(code: McpServerStoreErrorCode, message: string);
+}
+export declare class McpServerStore {
+    private readonly db;
+    constructor(db: BetterSQLite3Database<Record<string, never>>);
+    /**
+     * Register an MCP server.
+     * Throws MCP_SERVER_ALREADY_EXISTS if the id PK already exists.
+     */
+    create(input: McpServerCreateInput): McpServer;
+    /**
+     * Read an MCP server by id.
+     * Throws MCP_SERVER_NOT_FOUND if absent.
+     */
+    read(id: string): McpServer;
+    /** List all registered MCP servers. */
+    list(): McpServer[];
+}
+//# sourceMappingURL=mcp-server-store.d.ts.map

package/src/store/mcp-server-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server-store.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-store-tools/src/store/mcp-server-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAQxE;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,2CAA2C;AAC3C,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAMD,MAAM,MAAM,uBAAuB,GAC/B,2BAA2B,GAC3B,sBAAsB,CAAC;AAE3B,qBAAa,mBAAoB,SAAQ,KAAK;aAChB,IAAI,EAAE,uBAAuB;gBAA7B,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,MAAM;CAI3E;AAWD,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAGnE;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,SAAS;IAoC9C;;;OAGG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS;IAuB3B,uCAAuC;IACvC,IAAI,IAAI,SAAS,EAAE;CAUpB"}