@sprinterai/runtime 0.3.0 → 0.5.0

package/dist/tool/catalog.test.d.ts.map

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

package/dist/tool/catalog.test.js

@@ -0,0 +1,129 @@
+import { describe, expect, it, vi } from 'vitest';
+import { z } from 'zod';
+import { getAvailableTool, listAvailableTools } from './catalog.js';
+import { ToolRegistry } from './tool-registry.js';
+function createToolDefinitionStore(records) {
+    return {
+        getTool: vi.fn(async (toolId) => records.find((record) => record.id === toolId) ?? null),
+        getToolBySlug: vi.fn(async (tenantId, slug) => records.find((record) => record.tenant_id === tenantId && record.slug === slug) ?? null),
+        listTools: vi.fn(async (tenantId) => records.filter((record) => record.tenant_id === tenantId)),
+        createTool: vi.fn(),
+        updateTool: vi.fn(),
+        deleteTool: vi.fn(),
+        getAgentTools: vi.fn(async () => []),
+        assignToolToAgent: vi.fn(),
+        removeToolFromAgent: vi.fn(),
+    };
+}
+describe('tool catalog helpers', () => {
+    it('merges runtime and database tool metadata', async () => {
+        const registry = new ToolRegistry();
+        registry.register({
+            slug: 'searchEntities',
+            name: 'Search Entities',
+            description: 'Search across entities',
+            category: 'Entity',
+            icon: 'search',
+            inputSchema: z.object({ query: z.string() }),
+            execute: async () => ({ ok: true }),
+        });
+        const tools = await listAvailableTools({
+            registry,
+            toolDefinitions: createToolDefinitionStore([
+                {
+                    id: 'tool-1',
+                    tenant_id: 'tenant-1',
+                    slug: 'searchEntities',
+                    name: 'Search CRM',
+                    description: 'Tenant override',
+                    type: 'custom',
+                    source: 'database',
+                    execute_code: null,
+                    schema: { type: 'object' },
+                    icon: 'database',
+                    category: 'Sales',
+                    enabled: true,
+                    created_at: '',
+                    updated_at: '',
+                },
+            ]),
+            tenantId: 'tenant-1',
+        });
+        expect(tools).toHaveLength(1);
+        expect(tools[0]).toMatchObject({
+            slug: 'searchEntities',
+            name: 'Search CRM',
+            description: 'Tenant override',
+            category: 'Sales',
+            icon: 'database',
+            source: 'merged',
+            type: 'custom',
+        });
+        expect(tools[0].schema).toEqual({ type: 'object' });
+    });
+    it('omits disabled database-only tools by default but can fetch them directly', async () => {
+        const toolDefinitions = createToolDefinitionStore([
+            {
+                id: 'tool-2',
+                tenant_id: 'tenant-1',
+                slug: 'disabled-tool',
+                name: 'Disabled Tool',
+                description: null,
+                type: null,
+                source: 'database',
+                execute_code: null,
+                schema: null,
+                icon: null,
+                category: null,
+                enabled: false,
+                created_at: '',
+                updated_at: '',
+            },
+        ]);
+        const listed = await listAvailableTools({
+            registry: new ToolRegistry(),
+            toolDefinitions,
+            tenantId: 'tenant-1',
+        });
+        const direct = await getAvailableTool({
+            registry: new ToolRegistry(),
+            toolDefinitions,
+            tenantId: 'tenant-1',
+            slug: 'disabled-tool',
+        });
+        expect(listed).toEqual([]);
+        expect(direct).toMatchObject({
+            slug: 'disabled-tool',
+            enabled: false,
+            source: 'database',
+        });
+    });
+    it('serializes runtime tool schemas when no database override exists', async () => {
+        const registry = new ToolRegistry();
+        registry.register({
+            slug: 'double',
+            name: 'Double',
+            description: 'Double a number',
+            category: 'Math',
+            icon: 'calculator',
+            inputSchema: z.object({
+                value: z.number(),
+                includeLabel: z.boolean().optional(),
+            }),
+            execute: async () => ({ ok: true }),
+        });
+        const tool = await getAvailableTool({
+            registry,
+            slug: 'double',
+        });
+        expect(tool?.schema).toMatchObject({
+            type: 'object',
+            properties: {
+                value: { type: 'number' },
+                includeLabel: { type: 'boolean' },
+            },
+            required: ['value'],
+        });
+    });
+});
+//# sourceMappingURL=catalog.test.js.map

package/dist/tool/catalog.test.js.map

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

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

@@ -1,6 +1,6 @@
 import { describe, it, expect, beforeEach } from 'vitest';
-import { InMemoryEntityStore } from '../testing/in-memory-entity-store';
-import { createEntityTools } from './entity-tools-factory';
+import { InMemoryEntityStore } from '../testing/in-memory-entity-store.js';
+import { createEntityTools } from './entity-tools-factory.js';
 const TENANT_ID = 'test-tenant';
 function makeEntityType(slug) {
     return {

package/dist/tool/execute-registered-tool.d.ts

@@ -0,0 +1,17 @@
+import type { ToolDefinition } from '@sprinterai/core';
+import type { ExecuteToolOptions, ExecuteToolResult } from './tool-executor.js';
+import type { ToolRegistry } from './tool-registry.js';
+export interface ExecuteRegisteredToolOptions extends ExecuteToolOptions {
+    registry: ToolRegistry;
+    slug: string;
+    input: unknown;
+}
+export interface ExecuteRegisteredToolResult extends ExecuteToolResult {
+    tool: ToolDefinition | null;
+}
+/**
+ * Resolve a tool from the registry and execute it through the shared tool executor.
+ * This keeps lookup, validation, permission checks, and run recording on one path.
+ */
+export declare function executeRegisteredTool(options: ExecuteRegisteredToolOptions): Promise<ExecuteRegisteredToolResult>;
+//# sourceMappingURL=execute-registered-tool.d.ts.map

package/dist/tool/execute-registered-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-registered-tool.d.ts","sourceRoot":"","sources":["../../src/tool/execute-registered-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,WAAW,4BAA6B,SAAQ,kBAAkB;IACtE,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,2BAA4B,SAAQ,iBAAiB;IACpE,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CAmBtC"}

package/dist/tool/execute-registered-tool.js

@@ -0,0 +1,24 @@
+import { executeTool } from './tool-executor.js';
+/**
+ * Resolve a tool from the registry and execute it through the shared tool executor.
+ * This keeps lookup, validation, permission checks, and run recording on one path.
+ */
+export async function executeRegisteredTool(options) {
+    const { registry, slug, input, ...executeOptions } = options;
+    const tool = registry.get(slug);
+    if (!tool) {
+        return {
+            tool: null,
+            output: null,
+            durationMs: 0,
+            status: 'error',
+            error: `Tool not found: ${slug}`,
+        };
+    }
+    const result = await executeTool(tool, input, executeOptions);
+    return {
+        tool,
+        ...result,
+    };
+}
+//# sourceMappingURL=execute-registered-tool.js.map

package/dist/tool/execute-registered-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-registered-tool.js","sourceRoot":"","sources":["../../src/tool/execute-registered-tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAa9C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAqC;IAErC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC;IAC7D,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEhC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,IAAI;YACZ,UAAU,EAAE,CAAC;YACb,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,mBAAmB,IAAI,EAAE;SACjC,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAC9D,OAAO;QACL,IAAI;QACJ,GAAG,MAAM;KACV,CAAC;AACJ,CAAC"}

package/dist/tool/execute-registered-tool.test.d.ts

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

package/dist/tool/execute-registered-tool.test.d.ts.map

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

package/dist/tool/execute-registered-tool.test.js

@@ -0,0 +1,73 @@
+import { describe, expect, it } from 'vitest';
+import { z } from 'zod';
+import { InMemoryToolStore } from '../testing/in-memory-tool-store.js';
+import { executeRegisteredTool } from './execute-registered-tool.js';
+import { ToolRegistry } from './tool-registry.js';
+describe('executeRegisteredTool', () => {
+    it('returns an error when the tool is missing', async () => {
+        const registry = new ToolRegistry();
+        const result = await executeRegisteredTool({
+            registry,
+            slug: 'missing-tool',
+            input: {},
+        });
+        expect(result.tool).toBeNull();
+        expect(result.status).toBe('error');
+        expect(result.error).toContain('Tool not found');
+    });
+    it('executes a registered tool through the shared executor', async () => {
+        const registry = new ToolRegistry();
+        registry.register({
+            slug: 'double',
+            name: 'Double',
+            description: 'Double a number',
+            category: 'math',
+            icon: 'calculator',
+            inputSchema: z.object({ value: z.number() }),
+            execute: async (input) => {
+                const typed = input;
+                return { doubled: typed.value * 2 };
+            },
+        });
+        const result = await executeRegisteredTool({
+            registry,
+            slug: 'double',
+            input: { value: 4 },
+        });
+        expect(result.tool?.slug).toBe('double');
+        expect(result.status).toBe('success');
+        expect(result.output).toEqual({ doubled: 8 });
+    });
+    it('records runs when a tool store is provided', async () => {
+        const registry = new ToolRegistry();
+        registry.register({
+            slug: 'double',
+            name: 'Double',
+            description: 'Double a number',
+            category: 'math',
+            icon: 'calculator',
+            inputSchema: z.object({ value: z.number() }),
+            execute: async (input) => {
+                const typed = input;
+                return { doubled: typed.value * 2 };
+            },
+        });
+        const store = new InMemoryToolStore();
+        const result = await executeRegisteredTool({
+            registry,
+            slug: 'double',
+            input: { value: 5 },
+            toolStore: store,
+            tenantId: 'tenant-1',
+            userId: 'user-1',
+            source: 'web',
+        });
+        expect(result.status).toBe('success');
+        const runs = await store.getToolRuns({ toolSlug: 'double' });
+        expect(runs).toHaveLength(1);
+        expect(result.runId).toBe(runs[0].id);
+        expect(runs[0].tenant_id).toBe('tenant-1');
+        expect(runs[0].output).toEqual({ doubled: 10 });
+    });
+});
+//# sourceMappingURL=execute-registered-tool.test.js.map

package/dist/tool/execute-registered-tool.test.js.map

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

package/dist/tool/index.d.ts

@@ -1,8 +1,12 @@
-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";
+export { ToolRegistry } from "./tool-registry.js";
+export { toAITool, toAIToolSet } from "./ai-bridge.js";
+export { executeTool } from "./tool-executor.js";
+export type { ExecuteToolOptions, ExecuteToolResult } from "./tool-executor.js";
+export { executeRegisteredTool } from './execute-registered-tool.js';
+export type { ExecuteRegisteredToolOptions, ExecuteRegisteredToolResult, } from './execute-registered-tool.js';
+export { getAvailableTool, listAvailableTools } from './catalog.js';
+export type { AvailableTool, ToolCatalogOptions } from './catalog.js';
+export { createEntityTools } from "./entity-tools-factory.js";
+export { resolveAgentTools } from "./resolve-tools.js";
+export type { ResolveToolsOptions } from "./resolve-tools.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EACV,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACnE,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

@@ -1,6 +1,8 @@
-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";
+export { ToolRegistry } from "./tool-registry.js";
+export { toAITool, toAIToolSet } from "./ai-bridge.js";
+export { executeTool } from "./tool-executor.js";
+export { executeRegisteredTool } from './execute-registered-tool.js';
+export { getAvailableTool, listAvailableTools } from './catalog.js';
+export { createEntityTools } from "./entity-tools-factory.js";
+export { resolveAgentTools } from "./resolve-tools.js";
 //# sourceMappingURL=index.js.map

package/dist/tool/index.js.map

@@ -1 +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"}
+{"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,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAKlE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -1,4 +1,4 @@
-import type { AgentConfig, ToolDefinition, AppPermission } from '@sprinterai/core';
+import type { AgentConfig, ToolDefinition, AppPermission, PermissionSubject } from '@sprinterai/core';
 import type { ToolSet } from 'ai';
 /** Options for resolving tools. */
 export interface ResolveToolsOptions {
@@ -10,6 +10,8 @@ export interface ResolveToolsOptions {
     permissions?: AppPermission[];
     /** Map from tool group name to tool slugs in that group. */
     toolGroupMap?: Record<string, string[]>;
+    /** Permission subject for documentation — actual resolution happens at API layer. */
+    subject?: PermissionSubject;
 }
 /**
  * Resolve tools for an agent: apply tool groups, custom tools, and permission filtering.

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

@@ -1 +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"}
+{"version":3,"file":"resolve-tools.d.ts","sourceRoot":"","sources":["../../src/tool/resolve-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAC1B,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;IACxC,qFAAqF;IACrF,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;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

@@ -1,4 +1,4 @@
-import { toAIToolSet } from './ai-bridge';
+import { toAIToolSet } from './ai-bridge.js';
 /**
  * Resolve tools for an agent: apply tool groups, custom tools, and permission filtering.
  *

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

@@ -1 +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"}
+{"version":3,"file":"resolve-tools.js","sourceRoot":"","sources":["../../src/tool/resolve-tools.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAgB1C;;;;;;;;;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.js

@@ -1,6 +1,6 @@
 import { describe, it, expect } from 'vitest';
 import { z } from 'zod';
-import { resolveAgentTools } from './resolve-tools';
+import { resolveAgentTools } from './resolve-tools.js';
 function makeTool(slug, overrides) {
     return {
         slug,

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

@@ -1,4 +1,4 @@
-import type { ToolDefinition, ToolStore, AppPermission } from '@sprinterai/core';
+import type { ToolDefinition, ToolStore, ToolRun, AppPermission } from '@sprinterai/core';
 /** Options for tool execution. */
 export interface ExecuteToolOptions {
     /** User's permissions — if set, checks requiredPermission on the tool. */
@@ -10,7 +10,7 @@ export interface ExecuteToolOptions {
     /** User ID for recording. */
     userId?: string;
     /** Source context. */
-    source?: 'web' | 'agent' | 'api';
+    source?: ToolRun['source'];
     /** Optional chat ID for tracing. */
     chatId?: string;
     /** Optional session ID for tracing. */
@@ -22,6 +22,7 @@ export interface ExecuteToolResult {
     durationMs: number;
     status: 'success' | 'error';
     error?: string;
+    runId?: string;
 }
 /**
  * Execute a tool: validate input, check permissions, run, optionally record.

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

@@ -1 +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"}
+{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../src/tool/tool-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE1F,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,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,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;IACf,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,CAuE5B"}

package/dist/tool/tool-executor.js

@@ -35,6 +35,7 @@ export async function executeTool(tool, input, options) {
         error = err instanceof Error ? err.message : String(err);
     }
     const durationMs = Date.now() - start;
+    let runId;
     // Record if store provided
     if (options?.toolStore) {
         const runInput = typeof parseResult.data === 'object' && parseResult.data !== null
@@ -45,7 +46,7 @@ export async function executeTool(tool, input, options) {
             : output !== undefined && output !== null
                 ? { _raw: output }
                 : null;
-        await options.toolStore.recordToolRun({
+        const run = await options.toolStore.recordToolRun({
             tenant_id: options.tenantId ?? '',
             tool_slug: tool.slug,
             user_id: options.userId ?? null,
@@ -58,7 +59,8 @@ export async function executeTool(tool, input, options) {
             chat_id: options.chatId ?? null,
             session_id: options.sessionId ?? null,
         });
+        runId = run.id;
     }
-    return { output, durationMs, status, error };
+    return { output, durationMs, status, error, runId };
 }
 //# sourceMappingURL=tool-executor.js.map

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

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

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

@@ -1,7 +1,7 @@
 import { describe, it, expect } from 'vitest';
 import { z } from 'zod';
-import { InMemoryToolStore } from '../testing/in-memory-tool-store';
-import { executeTool } from './tool-executor';
+import { InMemoryToolStore } from '../testing/in-memory-tool-store.js';
+import { executeTool } from './tool-executor.js';
 function makeTool(overrides) {
     return {
         slug: 'test-tool',

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

@@ -1,6 +1,6 @@
 import { describe, it, expect, beforeEach } from 'vitest';
 import { z } from 'zod';
-import { ToolRegistry } from './tool-registry';
+import { ToolRegistry } from './tool-registry.js';
 function makeTool(slug, overrides) {
     return {
         slug,

package/dist/tool/zod-to-json-schema.d.ts

@@ -0,0 +1,7 @@
+import type { z } from 'zod';
+/**
+ * Convert a Zod schema to a plain JSON Schema object.
+ * Uses the zod-to-json-schema npm package under the hood.
+ */
+export declare function zodToJsonSchema(schema: z.ZodTypeAny): Record<string, unknown>;
+//# sourceMappingURL=zod-to-json-schema.d.ts.map

package/dist/tool/zod-to-json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-json-schema.d.ts","sourceRoot":"","sources":["../../src/tool/zod-to-json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK7E"}

package/dist/tool/zod-to-json-schema.js

@@ -0,0 +1,12 @@
+import { zodToJsonSchema as convert } from 'zod-to-json-schema';
+/**
+ * Convert a Zod schema to a plain JSON Schema object.
+ * Uses the zod-to-json-schema npm package under the hood.
+ */
+export function zodToJsonSchema(schema) {
+    const result = convert(schema, { target: 'openApi3' });
+    // Strip top-level $schema property -- consumers expect plain schema
+    const { $schema: _, ...rest } = result;
+    return rest;
+}
+//# sourceMappingURL=zod-to-json-schema.js.map

package/dist/tool/zod-to-json-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-json-schema.js","sourceRoot":"","sources":["../../src/tool/zod-to-json-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAA4B,CAAC;IAClF,oEAAoE;IACpE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACvC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/tool/zod-to-json-schema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=zod-to-json-schema.test.d.ts.map

package/dist/tool/zod-to-json-schema.test.d.ts.map

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