@sprinterai/runtime 0.2.0

package/dist/memory/memory-prompt.js

@@ -0,0 +1,29 @@
+/**
+ * Build a prompt section from loaded memories.
+ *
+ * Formats memories as a bullet list for injection into the system prompt.
+ * Returns a PromptSection that can be composed with other sections.
+ */
+export function buildMemoryPrompt(userMemories, semanticMemories) {
+    const parts = [];
+    if (userMemories.length > 0) {
+        parts.push('### User Preferences & Corrections');
+        for (const mem of userMemories) {
+            parts.push(`- ${mem.content}`);
+        }
+    }
+    if (semanticMemories.length > 0) {
+        parts.push('### Relevant Past Context');
+        for (const mem of semanticMemories) {
+            parts.push(`- ${mem.content}`);
+        }
+    }
+    if (parts.length === 0)
+        return null;
+    return {
+        label: 'Memory',
+        content: parts.join('\n'),
+        priority: 50,
+    };
+}
+//# sourceMappingURL=memory-prompt.js.map

package/dist/memory/memory-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-prompt.js","sourceRoot":"","sources":["../../src/memory/memory-prompt.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,YAA0B,EAC1B,gBAA8B;IAE9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QACjD,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QACzB,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC"}

package/dist/module/create-runtime.d.ts

@@ -0,0 +1,65 @@
+import type { SprinterModule, EntityStore, AgentStore, ChatStore, TenantStore, ToolStore, TaskStore, MemoryStore, ToolDefinition, AgentDefinition, AppPermission } from '@sprinterai/core';
+import type { LanguageModel } from 'ai';
+import { AgentRegistry } from '../agent/agent-registry';
+import type { ResolvedAgent } from '../agent/agent-resolver';
+import type { ChatHandler, ChatHandlerConfig } from '../chat/chat-handler';
+import { ToolRegistry } from '../tool/tool-registry';
+import type { LoadedModules } from './module-loader';
+/** Stores that the runtime needs. */
+export interface RuntimeStores {
+    entity: EntityStore;
+    agent: AgentStore;
+    chat: ChatStore;
+    tenant: TenantStore;
+    tool: ToolStore;
+    task: TaskStore;
+    memory: MemoryStore;
+}
+/** Configuration for creating a platform runtime. */
+export interface PlatformRuntimeConfig {
+    /** Modules to load. */
+    modules: SprinterModule[];
+    /** Store implementations. */
+    stores: RuntimeStores;
+    /** Default tenant ID for entity tools. */
+    tenantId: string;
+    /** Model resolver: model ID string -> LanguageModel instance. */
+    resolveModel: (modelId: string) => LanguageModel;
+    /** Default agent slug for chat. */
+    defaultAgentSlug?: string;
+    /** Tool group to tool slugs mapping. */
+    toolGroupMap?: Record<string, string[]>;
+    /** Additional tools not from modules. */
+    extraTools?: ToolDefinition[];
+    /** Additional agents not from modules. */
+    extraAgents?: AgentDefinition[];
+}
+/** The composed platform runtime. */
+export interface PlatformRuntime {
+    /** All stores. */
+    stores: RuntimeStores;
+    /** Tool registry with all registered tools. */
+    toolRegistry: ToolRegistry;
+    /** Agent registry with all registered agents. */
+    agentRegistry: AgentRegistry;
+    /** Loaded module data. */
+    modules: LoadedModules;
+    /** Resolve an agent by slug. */
+    resolveAgent: (slug: string) => Promise<ResolvedAgent>;
+    /** Resolve tools for an agent. */
+    resolveTools: (agentSlug: string, permissions?: AppPermission[]) => Promise<{
+        tools: ToolDefinition[];
+        toolSet: Record<string, unknown>;
+    }>;
+    /** Create a chat handler. */
+    createChatHandler: (overrides?: Partial<ChatHandlerConfig>) => ChatHandler;
+}
+/**
+ * Create a fully composed platform runtime from modules and config.
+ *
+ * This is the main entry point for bootstrapping the platform.
+ * It loads modules, registers tools and agents, and provides
+ * high-level operations.
+ */
+export declare function createPlatformRuntime(config: PlatformRuntimeConfig): PlatformRuntime;
+//# sourceMappingURL=create-runtime.d.ts.map

package/dist/module/create-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-runtime.d.ts","sourceRoot":"","sources":["../../src/module/create-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,SAAS,EACT,WAAW,EACX,cAAc,EACd,eAAe,EACf,aAAa,EACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG3E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,uBAAuB;IACvB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,6BAA6B;IAC7B,MAAM,EAAE,aAAa,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,aAAa,CAAC;IACjD,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,yCAAyC;IACzC,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;CACjC;AAED,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,+CAA+C;IAC/C,YAAY,EAAE,YAAY,CAAC;IAC3B,iDAAiD;IACjD,aAAa,EAAE,aAAa,CAAC;IAC7B,0BAA0B;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,gCAAgC;IAChC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACvD,kCAAkC;IAClC,YAAY,EAAE,CACZ,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,aAAa,EAAE,KAC1B,OAAO,CAAC;QAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAC5E,6BAA6B;IAC7B,iBAAiB,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,WAAW,CAAC;CAC5E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CAoEpF"}

package/dist/module/create-runtime.js

@@ -0,0 +1,75 @@
+import { AgentRegistry } from '../agent/agent-registry';
+import { resolveAgent } from '../agent/agent-resolver';
+import { createChatRouteHandler } from '../chat/chat-handler';
+import { createEntityTools } from '../tool/entity-tools-factory';
+import { resolveAgentTools } from '../tool/resolve-tools';
+import { ToolRegistry } from '../tool/tool-registry';
+import { loadModules } from './module-loader';
+/**
+ * Create a fully composed platform runtime from modules and config.
+ *
+ * This is the main entry point for bootstrapping the platform.
+ * It loads modules, registers tools and agents, and provides
+ * high-level operations.
+ */
+export function createPlatformRuntime(config) {
+    // Load and merge modules
+    const loaded = loadModules(config.modules);
+    // Build tool registry
+    const toolRegistry = new ToolRegistry();
+    // Register entity tools
+    const entityTools = createEntityTools(config.stores.entity, config.tenantId);
+    toolRegistry.registerAll(entityTools);
+    // Register module tools
+    toolRegistry.registerAll(loaded.tools);
+    // Register extra tools
+    if (config.extraTools) {
+        toolRegistry.registerAll(config.extraTools);
+    }
+    // Build agent registry
+    const agentRegistry = new AgentRegistry();
+    agentRegistry.registerAll(loaded.agents);
+    if (config.extraAgents) {
+        agentRegistry.registerAll(config.extraAgents);
+    }
+    return {
+        stores: config.stores,
+        toolRegistry,
+        agentRegistry,
+        modules: loaded,
+        async resolveAgent(slug) {
+            return resolveAgent(slug, {
+                agentRegistry,
+                agentStore: config.stores.agent,
+            });
+        },
+        async resolveTools(slug, permissions) {
+            const agent = await resolveAgent(slug, {
+                agentRegistry,
+                agentStore: config.stores.agent,
+            });
+            return resolveAgentTools({
+                allTools: toolRegistry.getAll(),
+                agentConfig: agent.config,
+                permissions,
+                toolGroupMap: config.toolGroupMap,
+            });
+        },
+        createChatHandler(overrides) {
+            return createChatRouteHandler({
+                stores: {
+                    agent: config.stores.agent,
+                    entity: config.stores.entity,
+                    chat: config.stores.chat,
+                    tenant: config.stores.tenant,
+                    memory: config.stores.memory,
+                },
+                defaultAgentSlug: config.defaultAgentSlug ?? 'assistant',
+                resolveModel: config.resolveModel,
+                agentRegistry,
+                ...overrides,
+            });
+        },
+    };
+}
+//# sourceMappingURL=create-runtime.js.map

package/dist/module/create-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-runtime.js","sourceRoot":"","sources":["../../src/module/create-runtime.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAuD9C;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA6B;IACjE,yBAAyB;IACzB,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE3C,sBAAsB;IACtB,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;IAExC,wBAAwB;IACxB,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7E,YAAY,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAEtC,wBAAwB;IACxB,YAAY,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEvC,uBAAuB;IACvB,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,YAAY,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED,uBAAuB;IACvB,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;IAC1C,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAChD,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,YAAY;QACZ,aAAa;QACb,OAAO,EAAE,MAAM;QAEf,KAAK,CAAC,YAAY,CAAC,IAAY;YAC7B,OAAO,YAAY,CAAC,IAAI,EAAE;gBACxB,aAAa;gBACb,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK;aAChC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,WAA6B;YAC5D,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE;gBACrC,aAAa;gBACb,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK;aAChC,CAAC,CAAC;YACH,OAAO,iBAAiB,CAAC;gBACvB,QAAQ,EAAE,YAAY,CAAC,MAAM,EAAE;gBAC/B,WAAW,EAAE,KAAK,CAAC,MAAM;gBACzB,WAAW;gBACX,YAAY,EAAE,MAAM,CAAC,YAAY;aAClC,CAAC,CAAC;QACL,CAAC;QAED,iBAAiB,CAAC,SAAsC;YACtD,OAAO,sBAAsB,CAAC;gBAC5B,MAAM,EAAE;oBACN,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK;oBAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;oBAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI;oBACxB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;oBAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;iBAC7B;gBACD,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,WAAW;gBACxD,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,aAAa;gBACb,GAAG,SAAS;aACb,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/module/create-runtime.test.d.ts

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

package/dist/module/create-runtime.test.d.ts.map

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

package/dist/module/create-runtime.test.js

@@ -0,0 +1,144 @@
+import { describe, it, expect, vi } from 'vitest';
+import { z } from 'zod';
+import { InMemoryAgentStore } from '../testing/in-memory-agent-store';
+import { InMemoryChatStore } from '../testing/in-memory-chat-store';
+import { InMemoryEntityStore } from '../testing/in-memory-entity-store';
+import { InMemoryMemoryStore } from '../testing/in-memory-memory-store';
+import { InMemoryTaskStore } from '../testing/in-memory-task-store';
+import { InMemoryTenantStore } from '../testing/in-memory-tenant-store';
+import { InMemoryToolStore } from '../testing/in-memory-tool-store';
+import { createPlatformRuntime } from './create-runtime';
+// Mock AI SDK
+vi.mock('ai', () => ({
+    streamText: vi.fn(() => ({
+        textStream: (async function* () {
+            yield 'Hello';
+        })(),
+    })),
+    generateText: vi.fn(),
+    stepCountIs: vi.fn((n) => ({ type: 'step-count', count: n })),
+    tool: vi.fn((config) => ({
+        type: 'function',
+        ...config,
+    })),
+}));
+function makeTool(slug) {
+    return {
+        slug,
+        name: slug,
+        description: slug,
+        category: 'test',
+        icon: 'wrench',
+        inputSchema: z.object({}),
+        execute: async () => ({}),
+    };
+}
+function makeStores() {
+    return {
+        entity: new InMemoryEntityStore(),
+        agent: new InMemoryAgentStore(),
+        chat: new InMemoryChatStore(),
+        tenant: new InMemoryTenantStore(),
+        tool: new InMemoryToolStore(),
+        task: new InMemoryTaskStore(),
+        memory: new InMemoryMemoryStore(),
+    };
+}
+const mockModel = { modelId: 'test' };
+describe('createPlatformRuntime', () => {
+    it('creates a runtime with modules loaded', () => {
+        const module = {
+            name: 'test-module',
+            agents: [
+                {
+                    id: 'analyst',
+                    name: 'Analyst',
+                    description: '',
+                    icon: '',
+                    systemPrompt: '',
+                    toolGroups: [],
+                    customTools: [],
+                },
+            ],
+            tools: [makeTool('customTool')],
+        };
+        const runtime = createPlatformRuntime({
+            modules: [module],
+            stores: makeStores(),
+            tenantId: 't1',
+            resolveModel: () => mockModel,
+        });
+        expect(runtime.modules.moduleOrder).toEqual(['test-module']);
+        expect(runtime.agentRegistry.has('analyst')).toBe(true);
+        // Entity tools (8) + module tool (1) = 9
+        expect(runtime.toolRegistry.has('searchEntities')).toBe(true);
+        expect(runtime.toolRegistry.has('customTool')).toBe(true);
+    });
+    it('resolves agents through the runtime', async () => {
+        const runtime = createPlatformRuntime({
+            modules: [
+                {
+                    name: 'test',
+                    agents: [
+                        {
+                            id: 'bot',
+                            name: 'Bot',
+                            description: 'A bot',
+                            icon: 'bot',
+                            systemPrompt: 'You are a bot',
+                        },
+                    ],
+                },
+            ],
+            stores: makeStores(),
+            tenantId: 't1',
+            resolveModel: () => mockModel,
+        });
+        const agent = await runtime.resolveAgent('bot');
+        expect(agent.id).toBe('bot');
+        expect(agent.source).toBe('code');
+    });
+    it('falls back to default agent for unknown slug', async () => {
+        const runtime = createPlatformRuntime({
+            modules: [{ name: 'empty' }],
+            stores: makeStores(),
+            tenantId: 't1',
+            resolveModel: () => mockModel,
+        });
+        const agent = await runtime.resolveAgent('nonexistent');
+        expect(agent.source).toBe('default');
+    });
+    it('registers extra tools and agents', () => {
+        const runtime = createPlatformRuntime({
+            modules: [{ name: 'base' }],
+            stores: makeStores(),
+            tenantId: 't1',
+            resolveModel: () => mockModel,
+            extraTools: [makeTool('extraTool')],
+            extraAgents: [
+                {
+                    id: 'extra-agent',
+                    name: 'Extra',
+                    description: '',
+                    icon: '',
+                    systemPrompt: '',
+                },
+            ],
+        });
+        expect(runtime.toolRegistry.has('extraTool')).toBe(true);
+        expect(runtime.agentRegistry.has('extra-agent')).toBe(true);
+    });
+    it('creates a chat handler', () => {
+        const runtime = createPlatformRuntime({
+            modules: [{ name: 'test' }],
+            stores: makeStores(),
+            tenantId: 't1',
+            resolveModel: () => mockModel,
+            defaultAgentSlug: 'assistant',
+        });
+        const handler = runtime.createChatHandler();
+        expect(handler).toBeDefined();
+        expect(typeof handler.handle).toBe('function');
+    });
+});
+//# sourceMappingURL=create-runtime.test.js.map

package/dist/module/create-runtime.test.js.map

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

package/dist/module/index.d.ts

@@ -0,0 +1,5 @@
+export { loadModules } from "./module-loader";
+export type { LoadedModules } from "./module-loader";
+export { createPlatformRuntime } from "./create-runtime";
+export type { PlatformRuntimeConfig, PlatformRuntime, RuntimeStores, } from "./create-runtime";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/module/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,aAAa,GACd,MAAM,kBAAkB,CAAC"}

package/dist/module/index.js

@@ -0,0 +1,3 @@
+export { loadModules } from "./module-loader";
+export { createPlatformRuntime } from "./create-runtime";
+//# sourceMappingURL=index.js.map

package/dist/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/module/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/module/module-loader.d.ts

@@ -0,0 +1,32 @@
+import type { SprinterModule, AgentDefinition, ToolDefinition } from "@sprinterai/core";
+/** The merged result of loading multiple modules. */
+export interface LoadedModules {
+    /** All entity type definitions from all modules. */
+    entityTypes: Array<{
+        slug: string;
+        name: string;
+        description?: string;
+        icon?: string;
+        color?: string;
+        schema: Record<string, unknown>;
+        config?: Record<string, unknown>;
+        /** Which module provided this entity type. */
+        sourceModule: string;
+    }>;
+    /** All agent definitions from all modules. */
+    agents: AgentDefinition[];
+    /** All tool definitions from all modules. */
+    tools: ToolDefinition[];
+    /** Module names in load order. */
+    moduleOrder: string[];
+}
+/**
+ * Load and merge multiple SprinterModules.
+ *
+ * - Validates each module has a name
+ * - Checks all dependencies are satisfied
+ * - Merges entity types, agents, and tools (last-registered wins on slug collision)
+ * - Returns the merged result
+ */
+export declare function loadModules(modules: SprinterModule[]): LoadedModules;
+//# sourceMappingURL=module-loader.d.ts.map

package/dist/module/module-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-loader.d.ts","sourceRoot":"","sources":["../../src/module/module-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACf,MAAM,kBAAkB,CAAC;AAE1B,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,WAAW,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,8CAA8C;QAC9C,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,8CAA8C;IAC9C,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,6CAA6C;IAC7C,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,kCAAkC;IAClC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,aAAa,CAmFpE"}

package/dist/module/module-loader.js

@@ -0,0 +1,123 @@
+/**
+ * Load and merge multiple SprinterModules.
+ *
+ * - Validates each module has a name
+ * - Checks all dependencies are satisfied
+ * - Merges entity types, agents, and tools (last-registered wins on slug collision)
+ * - Returns the merged result
+ */
+export function loadModules(modules) {
+    // Validate modules
+    for (const mod of modules) {
+        if (!mod.name) {
+            throw new Error("Module must have a name");
+        }
+    }
+    // Check for duplicate names
+    const names = modules.map((m) => m.name);
+    const dupes = names.filter((n, i) => names.indexOf(n) !== i);
+    if (dupes.length > 0) {
+        throw new Error(`Duplicate module names: ${[...new Set(dupes)].join(", ")}`);
+    }
+    // Check dependencies
+    const available = new Set(names);
+    for (const mod of modules) {
+        for (const dep of mod.dependencies ?? []) {
+            if (!available.has(dep)) {
+                throw new Error(`Module "${mod.name}" depends on "${dep}", which is not loaded`);
+            }
+        }
+    }
+    // Topological sort by dependencies for load order
+    const sorted = topologicalSort(modules);
+    // Merge everything
+    const entityTypes = [];
+    const agents = [];
+    const tools = [];
+    const seenEntitySlugs = new Map();
+    const seenAgentIds = new Map();
+    const seenToolSlugs = new Map();
+    for (const mod of sorted) {
+        // Entity types
+        for (const et of mod.entityTypes ?? []) {
+            const existing = seenEntitySlugs.get(et.slug);
+            const entry = { ...et, sourceModule: mod.name };
+            if (existing !== undefined) {
+                entityTypes[existing] = entry;
+            }
+            else {
+                seenEntitySlugs.set(et.slug, entityTypes.length);
+                entityTypes.push(entry);
+            }
+        }
+        // Agents
+        for (const agent of mod.agents ?? []) {
+            const existing = seenAgentIds.get(agent.id);
+            if (existing !== undefined) {
+                agents[existing] = agent;
+            }
+            else {
+                seenAgentIds.set(agent.id, agents.length);
+                agents.push(agent);
+            }
+        }
+        // Tools
+        for (const tool of mod.tools ?? []) {
+            const existing = seenToolSlugs.get(tool.slug);
+            if (existing !== undefined) {
+                tools[existing] = tool;
+            }
+            else {
+                seenToolSlugs.set(tool.slug, tools.length);
+                tools.push(tool);
+            }
+        }
+    }
+    return {
+        entityTypes,
+        agents,
+        tools,
+        moduleOrder: sorted.map((m) => m.name),
+    };
+}
+/**
+ * Simple topological sort using Kahn's algorithm.
+ * Modules with no dependencies come first.
+ */
+function topologicalSort(modules) {
+    const byName = new Map();
+    const inDegree = new Map();
+    const dependents = new Map();
+    for (const mod of modules) {
+        byName.set(mod.name, mod);
+        inDegree.set(mod.name, 0);
+        dependents.set(mod.name, []);
+    }
+    for (const mod of modules) {
+        for (const dep of mod.dependencies ?? []) {
+            inDegree.set(mod.name, (inDegree.get(mod.name) ?? 0) + 1);
+            dependents.get(dep)?.push(mod.name);
+        }
+    }
+    const queue = [];
+    for (const [name, degree] of inDegree) {
+        if (degree === 0)
+            queue.push(name);
+    }
+    const result = [];
+    while (queue.length > 0) {
+        const name = queue.shift();
+        result.push(byName.get(name));
+        for (const dep of dependents.get(name) ?? []) {
+            const newDegree = (inDegree.get(dep) ?? 1) - 1;
+            inDegree.set(dep, newDegree);
+            if (newDegree === 0)
+                queue.push(dep);
+        }
+    }
+    if (result.length !== modules.length) {
+        throw new Error("Circular dependency detected among modules");
+    }
+    return result;
+}
+//# sourceMappingURL=module-loader.js.map

package/dist/module/module-loader.js.map

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

package/dist/module/module-loader.test.d.ts

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

package/dist/module/module-loader.test.d.ts.map

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

package/dist/module/module-loader.test.js

@@ -0,0 +1,96 @@
+import { describe, it, expect } from 'vitest';
+import { z } from 'zod';
+import { loadModules } from './module-loader';
+function makeModule(name, overrides) {
+    return { name, ...overrides };
+}
+function makeTool(slug) {
+    return {
+        slug,
+        name: slug,
+        description: slug,
+        category: 'test',
+        icon: 'wrench',
+        inputSchema: z.object({}),
+        execute: async () => ({}),
+    };
+}
+describe('loadModules', () => {
+    it('loads a single module', () => {
+        const result = loadModules([
+            makeModule('core', {
+                entityTypes: [{ slug: 'company', name: 'Company', schema: {} }],
+                agents: [
+                    {
+                        id: 'analyst',
+                        name: 'Analyst',
+                        description: '',
+                        icon: '',
+                        systemPrompt: '',
+                    },
+                ],
+                tools: [makeTool('search')],
+            }),
+        ]);
+        expect(result.moduleOrder).toEqual(['core']);
+        expect(result.entityTypes).toHaveLength(1);
+        expect(result.entityTypes[0].sourceModule).toBe('core');
+        expect(result.agents).toHaveLength(1);
+        expect(result.tools).toHaveLength(1);
+    });
+    it('merges multiple modules', () => {
+        const result = loadModules([
+            makeModule('base', {
+                entityTypes: [{ slug: 'company', name: 'Company', schema: {} }],
+            }),
+            makeModule('ext', {
+                entityTypes: [{ slug: 'person', name: 'Person', schema: {} }],
+            }),
+        ]);
+        expect(result.entityTypes).toHaveLength(2);
+        expect(result.moduleOrder).toEqual(['base', 'ext']);
+    });
+    it('respects dependency order', () => {
+        const result = loadModules([makeModule('ui', { dependencies: ['core'] }), makeModule('core')]);
+        expect(result.moduleOrder).toEqual(['core', 'ui']);
+    });
+    it('throws on missing dependency', () => {
+        expect(() => loadModules([makeModule('ext', { dependencies: ['missing'] })])).toThrow('depends on "missing"');
+    });
+    it('throws on duplicate module names', () => {
+        expect(() => loadModules([makeModule('a'), makeModule('a')])).toThrow('Duplicate module names');
+    });
+    it('throws on circular dependencies', () => {
+        expect(() => loadModules([
+            makeModule('a', { dependencies: ['b'] }),
+            makeModule('b', { dependencies: ['a'] }),
+        ])).toThrow('Circular dependency');
+    });
+    it('later module overrides entity types with same slug', () => {
+        const result = loadModules([
+            makeModule('base', {
+                entityTypes: [{ slug: 'company', name: 'Original', schema: {} }],
+            }),
+            makeModule('override', {
+                entityTypes: [{ slug: 'company', name: 'Overridden', schema: {} }],
+            }),
+        ]);
+        expect(result.entityTypes).toHaveLength(1);
+        expect(result.entityTypes[0].name).toBe('Overridden');
+        expect(result.entityTypes[0].sourceModule).toBe('override');
+    });
+    it('later module overrides tools with same slug', () => {
+        const result = loadModules([
+            makeModule('base', { tools: [makeTool('search')] }),
+            makeModule('ext', { tools: [makeTool('search')] }),
+        ]);
+        expect(result.tools).toHaveLength(1);
+    });
+    it('handles empty modules', () => {
+        const result = loadModules([makeModule('empty')]);
+        expect(result.entityTypes).toHaveLength(0);
+        expect(result.agents).toHaveLength(0);
+        expect(result.tools).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=module-loader.test.js.map

package/dist/module/module-loader.test.js.map

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