@sprinterai/runtime 0.2.0

package/dist/tool/entity-tools-factory.test.js

@@ -0,0 +1,160 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { InMemoryEntityStore } from '../testing/in-memory-entity-store';
+import { createEntityTools } from './entity-tools-factory';
+const TENANT_ID = 'test-tenant';
+function makeEntityType(slug) {
+    return {
+        id: `et-${slug}`,
+        tenant_id: TENANT_ID,
+        slug,
+        name: slug.charAt(0).toUpperCase() + slug.slice(1),
+        json_schema: null,
+        visibility: 'tenant',
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    };
+}
+describe('createEntityTools', () => {
+    let store;
+    let tools;
+    beforeEach(() => {
+        store = new InMemoryEntityStore();
+        store.seedEntityType(makeEntityType('company'));
+        store.seedEntityType(makeEntityType('person'));
+        tools = createEntityTools(store, TENANT_ID);
+    });
+    function findTool(slug) {
+        const tool = tools.find((t) => t.slug === slug);
+        if (!tool)
+            throw new Error(`Tool ${slug} not found`);
+        return tool;
+    }
+    it('creates 8 entity tools', () => {
+        expect(tools).toHaveLength(8);
+        const slugs = tools.map((t) => t.slug);
+        expect(slugs).toContain('searchEntities');
+        expect(slugs).toContain('getEntity');
+        expect(slugs).toContain('createEntity');
+        expect(slugs).toContain('updateEntity');
+        expect(slugs).toContain('deleteEntity');
+        expect(slugs).toContain('createRelation');
+        expect(slugs).toContain('listEntityTypes');
+        expect(slugs).toContain('getEntityStats');
+    });
+    it('all tools have requiredPermission set', () => {
+        for (const tool of tools) {
+            expect(tool.requiredPermission).toBeDefined();
+        }
+    });
+    it('searchEntities searches by query', async () => {
+        await store.createEntity({
+            typeSlug: 'company',
+            title: 'Acme Corp',
+            content: {},
+        });
+        await store.createEntity({
+            typeSlug: 'company',
+            title: 'Beta Inc',
+            content: {},
+        });
+        const result = await findTool('searchEntities').execute({
+            query: 'acme',
+        });
+        const entities = result;
+        expect(entities).toHaveLength(1);
+        expect(entities[0].title).toBe('Acme Corp');
+    });
+    it('getEntity returns entity by ID', async () => {
+        const created = await store.createEntity({
+            typeSlug: 'company',
+            title: 'Test Co',
+            content: {},
+        });
+        const result = await findTool('getEntity').execute({ id: created.id });
+        const entity = result;
+        expect(entity.id).toBe(created.id);
+        expect(entity.title).toBe('Test Co');
+    });
+    it('getEntity returns error for missing entity', async () => {
+        const result = await findTool('getEntity').execute({ id: 'nonexistent' });
+        expect(result).toEqual({ error: 'Entity not found: nonexistent' });
+    });
+    it('createEntity creates and returns entity', async () => {
+        const result = await findTool('createEntity').execute({
+            typeSlug: 'company',
+            title: 'New Corp',
+            content: { website: 'https://newcorp.com' },
+        });
+        const entity = result;
+        expect(entity.title).toBe('New Corp');
+        expect(entity.id).toBeDefined();
+    });
+    it('updateEntity updates entity fields', async () => {
+        const created = await store.createEntity({
+            typeSlug: 'company',
+            title: 'Old Name',
+            content: {},
+        });
+        const result = await findTool('updateEntity').execute({
+            id: created.id,
+            title: 'New Name',
+        });
+        const updated = result;
+        expect(updated.title).toBe('New Name');
+    });
+    it('deleteEntity removes entity', async () => {
+        const created = await store.createEntity({
+            typeSlug: 'company',
+            title: 'To Delete',
+            content: {},
+        });
+        await findTool('deleteEntity').execute({ id: created.id });
+        const fetched = await store.getEntity(created.id);
+        expect(fetched).toBeNull();
+    });
+    it('createRelation creates a relation', async () => {
+        const a = await store.createEntity({
+            typeSlug: 'company',
+            title: 'A',
+            content: {},
+        });
+        const b = await store.createEntity({
+            typeSlug: 'person',
+            title: 'B',
+            content: {},
+        });
+        const result = await findTool('createRelation').execute({
+            fromId: a.id,
+            toId: b.id,
+            type: 'employs',
+        });
+        expect(result).toEqual({
+            created: true,
+            from: a.id,
+            to: b.id,
+            type: 'employs',
+        });
+        expect(store.getRelations()).toHaveLength(1);
+    });
+    it('listEntityTypes returns all types', async () => {
+        const result = await findTool('listEntityTypes').execute({});
+        const types = result;
+        expect(types).toHaveLength(2);
+    });
+    it('getEntityStats returns counts', async () => {
+        await store.createEntity({
+            typeSlug: 'company',
+            title: 'A',
+            content: {},
+        });
+        await store.createEntity({
+            typeSlug: 'company',
+            title: 'B',
+            content: {},
+        });
+        const result = await findTool('getEntityStats').execute({});
+        const counts = result;
+        expect(counts['et-company']).toBe(2);
+    });
+});
+//# sourceMappingURL=entity-tools-factory.test.js.map

package/dist/tool/entity-tools-factory.test.js.map

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

package/dist/tool/index.d.ts

@@ -0,0 +1,8 @@
+export { ToolRegistry } from "./tool-registry";
+export { toAITool, toAIToolSet } from "./ai-bridge";
+export { executeTool } from "./tool-executor";
+export type { ExecuteToolOptions, ExecuteToolResult } from "./tool-executor";
+export { createEntityTools } from "./entity-tools-factory";
+export { resolveAgentTools } from "./resolve-tools";
+export type { ResolveToolsOptions } from "./resolve-tools";
+//# sourceMappingURL=index.d.ts.map

package/dist/tool/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tool/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/tool/index.js

@@ -0,0 +1,6 @@
+export { ToolRegistry } from "./tool-registry";
+export { toAITool, toAIToolSet } from "./ai-bridge";
+export { executeTool } from "./tool-executor";
+export { createEntityTools } from "./entity-tools-factory";
+export { resolveAgentTools } from "./resolve-tools";
+//# sourceMappingURL=index.js.map

package/dist/tool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tool/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/tool/resolve-tools.d.ts

@@ -0,0 +1,28 @@
+import type { AgentConfig, ToolDefinition, AppPermission } from '@sprinterai/core';
+import type { ToolSet } from 'ai';
+/** Options for resolving tools. */
+export interface ResolveToolsOptions {
+    /** All registered tools (the full registry). */
+    allTools: ToolDefinition[];
+    /** Agent config with toolGroups and customTools. */
+    agentConfig: AgentConfig;
+    /** Caller's permissions. Tools requiring missing permissions are filtered out. */
+    permissions?: AppPermission[];
+    /** Map from tool group name to tool slugs in that group. */
+    toolGroupMap?: Record<string, string[]>;
+}
+/**
+ * Resolve tools for an agent: apply tool groups, custom tools, and permission filtering.
+ *
+ * Steps:
+ * 1. Collect tool slugs from agent's toolGroups (using toolGroupMap)
+ * 2. Add agent's customTools
+ * 3. Look up each slug in allTools
+ * 4. Filter out tools that require a permission the caller doesn't have
+ * 5. Convert to AI SDK ToolSet
+ */
+export declare function resolveAgentTools(options: ResolveToolsOptions): {
+    tools: ToolDefinition[];
+    toolSet: ToolSet;
+};
+//# sourceMappingURL=resolve-tools.d.ts.map

package/dist/tool/resolve-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-tools.d.ts","sourceRoot":"","sources":["../../src/tool/resolve-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAIlC,mCAAmC;AACnC,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,oDAAoD;IACpD,WAAW,EAAE,WAAW,CAAC;IACzB,kFAAkF;IAClF,WAAW,CAAC,EAAE,aAAa,EAAE,CAAC;IAC9B,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG;IAC/D,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB,CAgDA"}

package/dist/tool/resolve-tools.js

@@ -0,0 +1,54 @@
+import { toAIToolSet } from './ai-bridge';
+/**
+ * Resolve tools for an agent: apply tool groups, custom tools, and permission filtering.
+ *
+ * Steps:
+ * 1. Collect tool slugs from agent's toolGroups (using toolGroupMap)
+ * 2. Add agent's customTools
+ * 3. Look up each slug in allTools
+ * 4. Filter out tools that require a permission the caller doesn't have
+ * 5. Convert to AI SDK ToolSet
+ */
+export function resolveAgentTools(options) {
+    const { allTools, agentConfig, permissions, toolGroupMap } = options;
+    // Build a lookup map
+    const toolMap = new Map();
+    for (const t of allTools) {
+        toolMap.set(t.slug, t);
+    }
+    // Collect slugs from tool groups
+    const slugs = new Set();
+    if (agentConfig.toolGroups && toolGroupMap) {
+        for (const group of agentConfig.toolGroups) {
+            const groupSlugs = toolGroupMap[group];
+            if (groupSlugs) {
+                for (const slug of groupSlugs) {
+                    slugs.add(slug);
+                }
+            }
+        }
+    }
+    // Add custom tool slugs
+    if (agentConfig.customTools) {
+        for (const slug of agentConfig.customTools) {
+            slugs.add(slug);
+        }
+    }
+    // Look up tools and filter by permission
+    const resolved = [];
+    for (const slug of slugs) {
+        const tool = toolMap.get(slug);
+        if (!tool)
+            continue;
+        // If permissions are provided, filter tools that require a missing permission
+        if (permissions && tool.requiredPermission && !permissions.includes(tool.requiredPermission)) {
+            continue;
+        }
+        resolved.push(tool);
+    }
+    return {
+        tools: resolved,
+        toolSet: toAIToolSet(resolved),
+    };
+}
+//# sourceMappingURL=resolve-tools.js.map

package/dist/tool/resolve-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-tools.js","sourceRoot":"","sources":["../../src/tool/resolve-tools.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAc1C;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA4B;IAI5D,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAErE,qBAAqB;IACrB,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACzB,CAAC;IAED,iCAAiC;IACjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,IAAI,WAAW,CAAC,UAAU,IAAI,YAAY,EAAE,CAAC;QAC3C,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;YAC3C,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,UAAU,EAAE,CAAC;gBACf,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;oBAC9B,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAClB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC;QAC5B,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC;YAC3C,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,8EAA8E;QAC9E,IAAI,WAAW,IAAI,IAAI,CAAC,kBAAkB,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC7F,SAAS;QACX,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC;KAC/B,CAAC;AACJ,CAAC"}

package/dist/tool/resolve-tools.test.d.ts

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

package/dist/tool/resolve-tools.test.d.ts.map

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

package/dist/tool/resolve-tools.test.js

@@ -0,0 +1,111 @@
+import { describe, it, expect } from 'vitest';
+import { z } from 'zod';
+import { resolveAgentTools } from './resolve-tools';
+function makeTool(slug, overrides) {
+    return {
+        slug,
+        name: `Tool ${slug}`,
+        description: `Desc ${slug}`,
+        category: 'test',
+        icon: 'wrench',
+        inputSchema: z.object({ q: z.string() }),
+        execute: async () => ({}),
+        ...overrides,
+    };
+}
+describe('resolveAgentTools', () => {
+    const allTools = [
+        makeTool('searchEntities', {
+            requiredPermission: 'entities.team.read',
+        }),
+        makeTool('createEntity', {
+            requiredPermission: 'entities.team.create',
+        }),
+        makeTool('deleteEntity', {
+            requiredPermission: 'entities.team.delete',
+        }),
+        makeTool('webSearch'),
+        makeTool('customCalc'),
+    ];
+    const toolGroupMap = {
+        entity: ['searchEntities', 'createEntity', 'deleteEntity'],
+        web: ['webSearch'],
+    };
+    it('resolves tools from toolGroups', () => {
+        const config = { toolGroups: ['entity'] };
+        const { tools, toolSet } = resolveAgentTools({
+            allTools,
+            agentConfig: config,
+            toolGroupMap,
+        });
+        expect(tools.map((t) => t.slug)).toEqual(expect.arrayContaining(['searchEntities', 'createEntity', 'deleteEntity']));
+        expect(Object.keys(toolSet)).toHaveLength(3);
+    });
+    it('resolves custom tools by slug', () => {
+        const config = { customTools: ['customCalc'] };
+        const { tools } = resolveAgentTools({
+            allTools,
+            agentConfig: config,
+            toolGroupMap,
+        });
+        expect(tools.map((t) => t.slug)).toEqual(['customCalc']);
+    });
+    it('merges toolGroups and customTools', () => {
+        const config = {
+            toolGroups: ['web'],
+            customTools: ['customCalc'],
+        };
+        const { tools } = resolveAgentTools({
+            allTools,
+            agentConfig: config,
+            toolGroupMap,
+        });
+        const slugs = tools.map((t) => t.slug);
+        expect(slugs).toContain('webSearch');
+        expect(slugs).toContain('customCalc');
+    });
+    it('filters tools by permissions', () => {
+        const config = { toolGroups: ['entity'] };
+        const { tools } = resolveAgentTools({
+            allTools,
+            agentConfig: config,
+            toolGroupMap,
+            permissions: ['entities.team.read'],
+        });
+        // Only searchEntities should pass (requires entities.team.read)
+        // createEntity (entities.team.create) and deleteEntity (entities.team.delete) filtered
+        expect(tools.map((t) => t.slug)).toEqual(['searchEntities']);
+    });
+    it('skips permission check when permissions not provided', () => {
+        const config = { toolGroups: ['entity'] };
+        const { tools } = resolveAgentTools({
+            allTools,
+            agentConfig: config,
+            toolGroupMap,
+        });
+        // All 3 entity tools included
+        expect(tools).toHaveLength(3);
+    });
+    it('ignores unknown slugs gracefully', () => {
+        const config = {
+            customTools: ['nonexistent', 'customCalc'],
+        };
+        const { tools } = resolveAgentTools({
+            allTools,
+            agentConfig: config,
+            toolGroupMap,
+        });
+        expect(tools.map((t) => t.slug)).toEqual(['customCalc']);
+    });
+    it('returns empty tools for empty config', () => {
+        const config = {};
+        const { tools, toolSet } = resolveAgentTools({
+            allTools,
+            agentConfig: config,
+            toolGroupMap,
+        });
+        expect(tools).toHaveLength(0);
+        expect(Object.keys(toolSet)).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=resolve-tools.test.js.map

package/dist/tool/resolve-tools.test.js.map

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

package/dist/tool/tool-executor.d.ts

@@ -0,0 +1,30 @@
+import type { ToolDefinition, ToolStore, AppPermission } from '@sprinterai/core';
+/** Options for tool execution. */
+export interface ExecuteToolOptions {
+    /** User's permissions — if set, checks requiredPermission on the tool. */
+    permissions?: AppPermission[];
+    /** Optional ToolStore to record the run. */
+    toolStore?: ToolStore;
+    /** Tenant ID for recording. */
+    tenantId?: string;
+    /** User ID for recording. */
+    userId?: string;
+    /** Source context. */
+    source?: 'web' | 'agent' | 'api';
+    /** Optional chat ID for tracing. */
+    chatId?: string;
+    /** Optional session ID for tracing. */
+    sessionId?: string;
+}
+/** Result of a tool execution. */
+export interface ExecuteToolResult {
+    output: unknown;
+    durationMs: number;
+    status: 'success' | 'error';
+    error?: string;
+}
+/**
+ * Execute a tool: validate input, check permissions, run, optionally record.
+ */
+export declare function executeTool(tool: ToolDefinition, input: unknown, options?: ExecuteToolOptions): Promise<ExecuteToolResult>;
+//# sourceMappingURL=tool-executor.d.ts.map

package/dist/tool/tool-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../src/tool/tool-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjF,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,aAAa,EAAE,CAAC;IAC9B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,MAAM,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,KAAK,CAAC;IACjC,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,kCAAkC;AAClC,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAqE5B"}

package/dist/tool/tool-executor.js

@@ -0,0 +1,64 @@
+/**
+ * Execute a tool: validate input, check permissions, run, optionally record.
+ */
+export async function executeTool(tool, input, options) {
+    // Check permission
+    if (tool.requiredPermission &&
+        options?.permissions &&
+        !options.permissions.includes(tool.requiredPermission)) {
+        return {
+            output: null,
+            durationMs: 0,
+            status: 'error',
+            error: `Permission denied: requires ${tool.requiredPermission}`,
+        };
+    }
+    // Validate input against schema
+    const parseResult = tool.inputSchema.safeParse(input);
+    if (!parseResult.success) {
+        return {
+            output: null,
+            durationMs: 0,
+            status: 'error',
+            error: `Invalid input: ${parseResult.error.message}`,
+        };
+    }
+    const start = Date.now();
+    let output = null;
+    let status = 'success';
+    let error;
+    try {
+        output = await tool.execute(parseResult.data);
+    }
+    catch (err) {
+        status = 'error';
+        error = err instanceof Error ? err.message : String(err);
+    }
+    const durationMs = Date.now() - start;
+    // Record if store provided
+    if (options?.toolStore) {
+        const runInput = typeof parseResult.data === 'object' && parseResult.data !== null
+            ? parseResult.data
+            : { _raw: parseResult.data };
+        const runOutput = typeof output === 'object' && output !== null
+            ? output
+            : output !== undefined && output !== null
+                ? { _raw: output }
+                : null;
+        await options.toolStore.recordToolRun({
+            tenant_id: options.tenantId ?? '',
+            tool_slug: tool.slug,
+            user_id: options.userId ?? null,
+            input: runInput,
+            output: runOutput,
+            status,
+            error: error ?? null,
+            duration_ms: durationMs,
+            source: options.source ?? 'api',
+            chat_id: options.chatId ?? null,
+            session_id: options.sessionId ?? null,
+        });
+    }
+    return { output, durationMs, status, error };
+}
+//# sourceMappingURL=tool-executor.js.map

package/dist/tool/tool-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.js","sourceRoot":"","sources":["../../src/tool/tool-executor.ts"],"names":[],"mappings":"AA4BA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAoB,EACpB,KAAc,EACd,OAA4B;IAE5B,mBAAmB;IACnB,IACE,IAAI,CAAC,kBAAkB;QACvB,OAAO,EAAE,WAAW;QACpB,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,EACtD,CAAC;QACD,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,UAAU,EAAE,CAAC;YACb,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,+BAA+B,IAAI,CAAC,kBAAkB,EAAE;SAChE,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,UAAU,EAAE,CAAC;YACb,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,kBAAkB,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE;SACrD,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,MAAM,GAAY,IAAI,CAAC;IAC3B,IAAI,MAAM,GAAwB,SAAS,CAAC;IAC5C,IAAI,KAAyB,CAAC;IAE9B,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,OAAO,CAAC;QACjB,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;IAEtC,2BAA2B;IAC3B,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;QACvB,MAAM,QAAQ,GACZ,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,KAAK,IAAI;YAC/D,CAAC,CAAE,WAAW,CAAC,IAAgC;YAC/C,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,SAAS,GACb,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAC3C,CAAC,CAAE,MAAkC;YACrC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI;gBACvC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE;gBAClB,CAAC,CAAC,IAAI,CAAC;QAEb,MAAM,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC;YACpC,SAAS,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;YACjC,SAAS,EAAE,IAAI,CAAC,IAAI;YACpB,OAAO,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;YAC/B,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,SAAS;YACjB,MAAM;YACN,KAAK,EAAE,KAAK,IAAI,IAAI;YACpB,WAAW,EAAE,UAAU;YACvB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;YAC/B,OAAO,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;YAC/B,UAAU,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;SACtC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC"}

package/dist/tool/tool-executor.test.d.ts

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

package/dist/tool/tool-executor.test.d.ts.map

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

package/dist/tool/tool-executor.test.js

@@ -0,0 +1,105 @@
+import { describe, it, expect } from 'vitest';
+import { z } from 'zod';
+import { InMemoryToolStore } from '../testing/in-memory-tool-store';
+import { executeTool } from './tool-executor';
+function makeTool(overrides) {
+    return {
+        slug: 'test-tool',
+        name: 'Test Tool',
+        description: 'A test tool',
+        category: 'test',
+        icon: 'wrench',
+        inputSchema: z.object({ value: z.number() }),
+        execute: async (input) => {
+            const typed = input;
+            return { doubled: typed.value * 2 };
+        },
+        ...overrides,
+    };
+}
+describe('executeTool', () => {
+    it('executes with valid input and returns result', async () => {
+        const tool = makeTool();
+        const result = await executeTool(tool, { value: 5 });
+        expect(result.status).toBe('success');
+        expect(result.output).toEqual({ doubled: 10 });
+        expect(result.durationMs).toBeGreaterThanOrEqual(0);
+    });
+    it('rejects invalid input', async () => {
+        const tool = makeTool();
+        const result = await executeTool(tool, { value: 'not-a-number' });
+        expect(result.status).toBe('error');
+        expect(result.error).toContain('Invalid input');
+        expect(result.output).toBeNull();
+    });
+    it('catches execute errors', async () => {
+        const tool = makeTool({
+            execute: async () => {
+                throw new Error('boom');
+            },
+        });
+        const result = await executeTool(tool, { value: 1 });
+        expect(result.status).toBe('error');
+        expect(result.error).toBe('boom');
+    });
+    it('checks permissions and denies when missing', async () => {
+        const tool = makeTool({
+            requiredPermission: 'entities.team.delete',
+        });
+        const result = await executeTool(tool, { value: 1 }, {
+            permissions: ['entities.team.read'],
+        });
+        expect(result.status).toBe('error');
+        expect(result.error).toContain('Permission denied');
+    });
+    it('allows execution when permission is present', async () => {
+        const tool = makeTool({
+            requiredPermission: 'entities.team.read',
+        });
+        const result = await executeTool(tool, { value: 3 }, {
+            permissions: ['entities.team.read', 'entities.team.create'],
+        });
+        expect(result.status).toBe('success');
+        expect(result.output).toEqual({ doubled: 6 });
+    });
+    it('skips permission check when no permissions provided', async () => {
+        const tool = makeTool({
+            requiredPermission: 'entities.team.delete',
+        });
+        // No permissions option = no check
+        const result = await executeTool(tool, { value: 2 });
+        expect(result.status).toBe('success');
+    });
+    it('records to ToolStore when provided', async () => {
+        const store = new InMemoryToolStore();
+        const tool = makeTool();
+        await executeTool(tool, { value: 7 }, {
+            toolStore: store,
+            tenantId: 't1',
+            userId: 'u1',
+            source: 'agent',
+            chatId: 'c1',
+        });
+        const runs = await store.getToolRuns({ toolSlug: 'test-tool' });
+        expect(runs).toHaveLength(1);
+        expect(runs[0].tool_slug).toBe('test-tool');
+        expect(runs[0].tenant_id).toBe('t1');
+        expect(runs[0].user_id).toBe('u1');
+        expect(runs[0].source).toBe('agent');
+        expect(runs[0].chat_id).toBe('c1');
+        expect(runs[0].status).toBe('success');
+    });
+    it('records errors to ToolStore', async () => {
+        const store = new InMemoryToolStore();
+        const tool = makeTool({
+            execute: async () => {
+                throw new Error('fail');
+            },
+        });
+        await executeTool(tool, { value: 1 }, { toolStore: store });
+        const runs = await store.getToolRuns({});
+        expect(runs[0].status).toBe('error');
+        expect(runs[0].error).toBe('fail');
+    });
+});
+//# sourceMappingURL=tool-executor.test.js.map

package/dist/tool/tool-executor.test.js.map

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