@primo-ai/core 0.1.0

package/dist/plugin-manager.js

@@ -0,0 +1,148 @@
+import { resolve, relative, isAbsolute } from 'node:path';
+import { EventSystem } from './event-system.js';
+import { HookManager } from './hook-manager.js';
+import { HarnessAPIImpl } from './harness.js';
+function validatePluginPath(filePath) {
+    if (/^(@[a-zA-Z0-9_-]+\/)?[a-zA-Z0-9_-]+$/.test(filePath)) {
+        return { valid: true };
+    }
+    const root = resolve(process.cwd());
+    const resolved = resolve(root, filePath);
+    const rel = relative(root, resolved);
+    if (rel.startsWith('..') || isAbsolute(rel)) {
+        return { valid: false, reason: `Plugin path "${filePath}" resolves outside project root` };
+    }
+    return { valid: true };
+}
+export class PluginManager {
+    runner;
+    registry;
+    contextBuilder;
+    _eventSystem = new EventSystem();
+    hookManager;
+    _harnessInstances = [];
+    resourceInstances = new Map();
+    errors = [];
+    stageMutator;
+    get eventBus() {
+        return this._eventSystem.bus;
+    }
+    get eventSystem() {
+        return this._eventSystem;
+    }
+    constructor(runner, registry, contextBuilder) {
+        this.runner = runner;
+        this.registry = registry;
+        this.contextBuilder = contextBuilder;
+        this.hookManager = new HookManager(this.eventBus);
+        registry.setHookManager(this.hookManager);
+    }
+    async loadPlugin(filePath) {
+        const validation = validatePluginPath(filePath);
+        if (!validation.valid) {
+            this.errors.push({ source: filePath, error: new Error(validation.reason) });
+            return;
+        }
+        try {
+            const module = await import(filePath);
+            const factory = module.default ?? module;
+            if (typeof factory !== 'function') {
+                throw new Error(`Plugin at "${filePath}" does not export a factory function`);
+            }
+            this.initializePlugin(factory);
+        }
+        catch (err) {
+            this.errors.push({
+                source: filePath,
+                error: err instanceof Error ? err : new Error(String(err)),
+            });
+        }
+    }
+    initializePlugin(factory) {
+        const api = this.createHarnessAPI();
+        factory(api);
+    }
+    async loadPluginsFromConfig(config) {
+        const plugins = config.plugins ?? [];
+        for (const { path } of plugins) {
+            await this.loadPlugin(path);
+        }
+    }
+    getCommand(name) {
+        for (const h of this._harnessInstances) {
+            const cmd = h.getCommands().get(name);
+            if (cmd)
+                return cmd;
+        }
+        return undefined;
+    }
+    getErrors() {
+        return this.errors;
+    }
+    setStageMutator(mutator) {
+        this.stageMutator = mutator;
+    }
+    freezeHarnessInstances() {
+        for (const h of this._harnessInstances)
+            h.freeze();
+    }
+    emitEvent(eventType, ...args) {
+        this.eventBus.emit(eventType, args[0]);
+    }
+    async initializeAll() {
+        const allResources = this._harnessInstances.flatMap(h => h.getResources());
+        for (const resource of allResources) {
+            try {
+                const instance = await resource.start();
+                this.resourceInstances.set(resource.id, instance);
+            }
+            catch (err) {
+                this.errors.push({
+                    source: `resource:${resource.id}`,
+                    error: err instanceof Error ? err : new Error(String(err)),
+                });
+            }
+        }
+    }
+    _shutdown = false;
+    async shutdown() {
+        if (this._shutdown)
+            return;
+        this._shutdown = true;
+        const allResources = this._harnessInstances.flatMap(h => h.getResources());
+        for (const resource of [...allResources].reverse()) {
+            const instance = this.resourceInstances.get(resource.id);
+            try {
+                await resource.stop(instance);
+            }
+            catch (err) {
+                this.errors.push({
+                    source: `resource:${resource.id}`,
+                    error: err instanceof Error ? err : new Error(String(err)),
+                });
+            }
+        }
+        this.resourceInstances.clear();
+        for (const h of this._harnessInstances) {
+            for (const unsub of h.getUnsubFns())
+                unsub();
+        }
+        this._harnessInstances = [];
+    }
+    createHarnessAPI() {
+        const impl = new HarnessAPIImpl({
+            runner: this.runner,
+            registry: this.registry,
+            hookManager: this.hookManager,
+            eventSystem: this._eventSystem,
+            eventBus: this.eventBus,
+            contextBuilder: this.contextBuilder,
+            emitEvent: (eventType, data) => this.emitEvent(eventType, data),
+            registerProvider: (_name, _factory) => { },
+            mutateStages: (mutation) => this.stageMutator?.(mutation),
+        });
+        this._harnessInstances.push(impl);
+        return impl;
+    }
+}
+//# sourceMappingURL=plugin-manager.js.map

package/dist/plugin-manager.js.map

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

package/dist/processors/build-context.d.ts

@@ -0,0 +1,3 @@
+import type { Processor } from '@primo-ai/sdk';
+export declare const buildContextExtensionPoint: Processor;
+//# sourceMappingURL=build-context.d.ts.map

package/dist/processors/build-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-context.d.ts","sourceRoot":"","sources":["../../src/processors/build-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,eAAO,MAAM,0BAA0B,EAAE,SAGxC,CAAC"}

package/dist/processors/build-context.js

@@ -0,0 +1,5 @@
+export const buildContextExtensionPoint = {
+    stage: 'buildContext',
+    execute: async (ctx) => ctx,
+};
+//# sourceMappingURL=build-context.js.map

package/dist/processors/build-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-context.js","sourceRoot":"","sources":["../../src/processors/build-context.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,0BAA0B,GAAc;IACnD,KAAK,EAAE,cAAc;IACrB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG;CAC5B,CAAC"}

package/dist/processors/evaluate-iteration.d.ts

@@ -0,0 +1,13 @@
+import type { Processor } from '@primo-ai/sdk';
+import type { EventBus } from '../event-bus.js';
+export interface EvaluateIterationDeps {
+    eventBus?: EventBus;
+    /** Maximum total tokens before stopping the loop. Defaults to 100_000. */
+    maxTotalTokens?: number;
+}
+export declare function createEvaluateIterationProcessor(deps?: EvaluateIterationDeps): Processor;
+/**
+ * @deprecated Use `createEvaluateIterationProcessor({ eventBus })` for full functionality.
+ */
+export declare const evaluateIterationProcessor: Processor;
+//# sourceMappingURL=evaluate-iteration.d.ts.map

package/dist/processors/evaluate-iteration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-iteration.d.ts","sourceRoot":"","sources":["../../src/processors/evaluate-iteration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAgD,MAAM,eAAe,CAAC;AAC7F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAqBD,wBAAgB,gCAAgC,CAAC,IAAI,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAuMxF;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAA8C,CAAC"}

package/dist/processors/evaluate-iteration.js

@@ -0,0 +1,196 @@
+function collectCalledToolNames(history, pendingToolCalls) {
+    const called = new Set();
+    for (const msg of history) {
+        if (msg.role === 'assistant' && 'toolCalls' in msg && msg.toolCalls) {
+            for (const tc of msg.toolCalls) {
+                called.add(tc.name);
+            }
+        }
+    }
+    if (pendingToolCalls) {
+        for (const tc of pendingToolCalls) {
+            called.add(tc.name);
+        }
+    }
+    return called;
+}
+const REQUIRED_TOOLS_MAX_RETRIES = 3;
+export function createEvaluateIterationProcessor(deps) {
+    const eventBus = deps?.eventBus;
+    const maxTotalTokens = deps?.maxTotalTokens ?? 100_000;
+    let warnedUnknownTools = false;
+    const failCounts = {};
+    return {
+        stage: 'evaluateIteration',
+        execute: async (ctx) => {
+            const prevTotal = ctx.session.totalTokenUsage ?? { input: 0, output: 0 };
+            const iterUsage = ctx.iteration.tokenUsage ?? { input: 0, output: 0 };
+            const totalTokenUsage = {
+                input: prevTotal.input + iterUsage.input,
+                output: prevTotal.output + iterUsage.output,
+            };
+            const totalTokens = totalTokenUsage.input + totalTokenUsage.output;
+            const requiredTools = ctx.agent.config.requiredTools;
+            if (totalTokens > maxTotalTokens) {
+                ctx.iteration.span?.setAttribute('token.overflow', true);
+                ctx.iteration.span?.setAttribute('token.total', totalTokens);
+                // Emit unsatisfied if required tools are not all called
+                if (requiredTools && requiredTools.length > 0) {
+                    const calledTools = collectCalledToolNames(ctx.session.messageHistory ?? [], ctx.iteration.pendingToolCalls);
+                    const uncalled = requiredTools.filter(name => !calledTools.has(name));
+                    if (uncalled.length > 0) {
+                        eventBus?.emit('required_tools:unsatisfied', {
+                            uncalled,
+                            reason: 'token_overflow',
+                            step: ctx.iteration.step,
+                            sessionId: ctx.request.sessionId,
+                        });
+                    }
+                }
+                return {
+                    ...ctx,
+                    iteration: {
+                        ...ctx.iteration,
+                        loopDirective: { action: 'stop' },
+                    },
+                    session: {
+                        ...ctx.session,
+                        totalTokenUsage,
+                    },
+                };
+            }
+            if (requiredTools && requiredTools.length > 0) {
+                if (!warnedUnknownTools) {
+                    const registeredNames = new Set(ctx.agent.toolDeclarations.map(t => t.name));
+                    const unknown = requiredTools.filter(name => !registeredNames.has(name));
+                    if (unknown.length > 0) {
+                        eventBus?.emit('required_tools:unknown', {
+                            unknown,
+                            registered: [...registeredNames],
+                            step: ctx.iteration.step,
+                            sessionId: ctx.request.sessionId,
+                        });
+                        ctx.iteration.span?.setAttribute('required_tools.unknown', unknown.join(','));
+                    }
+                    warnedUnknownTools = true;
+                }
+                const calledTools = collectCalledToolNames(ctx.session.messageHistory ?? [], ctx.iteration.pendingToolCalls);
+                const uncalled = requiredTools.filter(name => !calledTools.has(name));
+                if (uncalled.length > 0) {
+                    for (const name of uncalled) {
+                        failCounts[name] = (failCounts[name] ?? 0) + 1;
+                    }
+                    for (const name of requiredTools) {
+                        if (calledTools.has(name))
+                            failCounts[name] = 0;
+                    }
+                    const exhausted = uncalled.filter(name => (failCounts[name] ?? 0) >= REQUIRED_TOOLS_MAX_RETRIES);
+                    ctx.iteration.span?.setAttribute('required_tools.incomplete', true);
+                    ctx.iteration.span?.setAttribute('required_tools.uncalled', uncalled.join(','));
+                    if (exhausted.length > 0) {
+                        const exhaustedMsg = `Required tools exhausted after ${REQUIRED_TOOLS_MAX_RETRIES} retries: ${exhausted.join(', ')}. Halting loop.`;
+                        eventBus?.emit('required_tools:exhausted', {
+                            exhausted,
+                            failCounts: { ...failCounts },
+                            step: ctx.iteration.step,
+                            sessionId: ctx.request.sessionId,
+                        });
+                        ctx.iteration.span?.setAttribute('required_tools.exhausted', exhausted.join(','));
+                        const policy = ctx.agent.config.requiredToolPolicy ?? 'advise';
+                        if (policy === 'enforce') {
+                            // Inject synthetic tool calls for exhausted uncalled tools and continue the loop
+                            const syntheticCalls = exhausted.map((name, i) => ({
+                                id: `required-${i}`,
+                                name,
+                                args: {},
+                            }));
+                            eventBus?.emit('required_tools:enforced', {
+                                tools: exhausted,
+                                syntheticCalls,
+                                step: ctx.iteration.step,
+                                sessionId: ctx.request.sessionId,
+                            });
+                            ctx.iteration.span?.setAttribute('required_tools.enforced', exhausted.join(','));
+                            return {
+                                ...ctx,
+                                iteration: {
+                                    ...ctx.iteration,
+                                    loopDirective: { action: 'continue' },
+                                    pendingToolCalls: syntheticCalls,
+                                },
+                                session: {
+                                    ...ctx.session,
+                                    totalTokenUsage,
+                                },
+                            };
+                        }
+                        // Default 'advise' behavior: stop with error message
+                        return {
+                            ...ctx,
+                            agent: {
+                                ...ctx.agent,
+                                promptFragments: [
+                                    ...ctx.agent.promptFragments,
+                                    `[system] ${exhaustedMsg}`,
+                                ],
+                            },
+                            iteration: {
+                                ...ctx.iteration,
+                                loopDirective: { action: 'stop' },
+                                response: exhaustedMsg,
+                            },
+                            session: {
+                                ...ctx.session,
+                                totalTokenUsage,
+                            },
+                        };
+                    }
+                    eventBus?.emit('required_tools:incomplete', {
+                        uncalled,
+                        called: [...calledTools],
+                        step: ctx.iteration.step,
+                        sessionId: ctx.request.sessionId,
+                    });
+                    return {
+                        ...ctx,
+                        agent: {
+                            ...ctx.agent,
+                            promptFragments: [
+                                ...ctx.agent.promptFragments,
+                                `[system] Required tools not yet called: ${uncalled.join(', ')}. Please call them before finishing.`,
+                            ],
+                        },
+                        iteration: {
+                            ...ctx.iteration,
+                            loopDirective: { action: 'continue' },
+                        },
+                        session: {
+                            ...ctx.session,
+                            totalTokenUsage,
+                        },
+                    };
+                }
+            }
+            const hasToolResults = (ctx.iteration.toolResults?.length ?? 0) > 0;
+            const directive = hasToolResults
+                ? { action: 'continue' }
+                : { action: 'stop' };
+            return {
+                ...ctx,
+                iteration: {
+                    ...ctx.iteration,
+                    loopDirective: directive,
+                },
+                session: {
+                    ...ctx.session,
+                    totalTokenUsage,
+                },
+            };
+        },
+    };
+}
+/**
+ * @deprecated Use `createEvaluateIterationProcessor({ eventBus })` for full functionality.
+ */
+export const evaluateIterationProcessor = createEvaluateIterationProcessor();
+//# sourceMappingURL=evaluate-iteration.js.map

package/dist/processors/evaluate-iteration.js.map

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

package/dist/processors/execute-tools.d.ts

@@ -0,0 +1,4 @@
+import type { Processor } from '@primo-ai/sdk';
+import type { ToolRegistry } from '../tool-registry.js';
+export declare function createExecuteToolsProcessor(registry: ToolRegistry): Processor;
+//# sourceMappingURL=execute-tools.d.ts.map

package/dist/processors/execute-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-tools.d.ts","sourceRoot":"","sources":["../../src/processors/execute-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAuB,MAAM,eAAe,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,CAkE7E"}

package/dist/processors/execute-tools.js

@@ -0,0 +1,69 @@
+import { SpanAttributeKeys, SpanType } from '@primo-ai/sdk';
+export function createExecuteToolsProcessor(registry) {
+    return {
+        stage: 'executeTools',
+        execute: async (ctx) => {
+            const toolCalls = ctx.iteration.pendingToolCalls;
+            if (!toolCalls || toolCalls.length === 0) {
+                return ctx;
+            }
+            const toolResults = [];
+            for (const tc of toolCalls) {
+                const toolSpan = ctx.iteration.span?.startChild(SpanType.TOOL_EXECUTE);
+                toolSpan?.setAttribute(SpanAttributeKeys.TOOL_NAME, tc.name);
+                try {
+                    const result = await registry.executeTool(tc.name, tc.args, {
+                        toolCallId: tc.id,
+                        span: toolSpan ?? ctx.iteration.span,
+                        sessionId: ctx.request.sessionId,
+                    });
+                    const outputSize = typeof result.output === 'string'
+                        ? result.output.length
+                        : JSON.stringify(result.output ?? '').length;
+                    toolSpan?.setAttribute(SpanAttributeKeys.TOOL_RESULT_SIZE, outputSize);
+                    toolResults.push({ ...result, toolCallId: tc.id });
+                }
+                finally {
+                    toolSpan?.end();
+                }
+            }
+            const toolMessages = toolResults.map((tr) => {
+                let content = tr.error ?? (typeof tr.output === 'string' ? tr.output : JSON.stringify(tr.output));
+                if (tr.validationError && !tr.error) {
+                    content = `[Warning: ${tr.validationError}]\n${content}`;
+                }
+                const msg = {
+                    role: 'tool',
+                    content,
+                    toolCallId: tr.toolCallId,
+                    toolName: tr.name,
+                    result: tr.output,
+                    error: tr.error,
+                };
+                const ext = msg;
+                if (tr.mutated)
+                    ext.mutated = true;
+                if (tr.truncated)
+                    ext.truncated = true;
+                if (tr.validationError)
+                    ext.validationError = tr.validationError;
+                return msg;
+            });
+            const history = [...(ctx.session.messageHistory ?? [])];
+            history.push(...toolMessages);
+            return {
+                ...ctx,
+                iteration: {
+                    ...ctx.iteration,
+                    pendingToolCalls: undefined,
+                    toolResults,
+                },
+                session: {
+                    ...ctx.session,
+                    messageHistory: history,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=execute-tools.js.map

package/dist/processors/execute-tools.js.map

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

package/dist/processors/gate-tool.d.ts

@@ -0,0 +1,3 @@
+import type { Processor } from '@primo-ai/sdk';
+export declare const gateToolExtensionPoint: Processor;
+//# sourceMappingURL=gate-tool.d.ts.map

package/dist/processors/gate-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-tool.d.ts","sourceRoot":"","sources":["../../src/processors/gate-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,eAAO,MAAM,sBAAsB,EAAE,SAIpC,CAAC"}

package/dist/processors/gate-tool.js

@@ -0,0 +1,6 @@
+export const gateToolExtensionPoint = {
+    stage: 'gateTool',
+    execute: async (ctx) => ctx,
+    isNoOp: true,
+};
+//# sourceMappingURL=gate-tool.js.map

package/dist/processors/gate-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-tool.js","sourceRoot":"","sources":["../../src/processors/gate-tool.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAc;IAC/C,KAAK,EAAE,UAAU;IACjB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG;IAC3B,MAAM,EAAE,IAAI;CACb,CAAC"}

package/dist/processors/index.d.ts

@@ -0,0 +1,10 @@
+export { processInputProcessor } from './process-input.js';
+export { buildContextExtensionPoint } from './build-context.js';
+export { prepareStepExtensionPoint } from './prepare-step.js';
+export { createInvokeLLMProcessor, type InvokeLLMDeps } from './invoke-llm.js';
+export { processStepOutputProcessor } from './process-step-output.js';
+export { gateToolExtensionPoint } from './gate-tool.js';
+export { createExecuteToolsProcessor } from './execute-tools.js';
+export { createEvaluateIterationProcessor, evaluateIterationProcessor } from './evaluate-iteration.js';
+export { processOutputProcessor } from './process-output.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/processors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,gCAAgC,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACvG,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/processors/index.js

@@ -0,0 +1,10 @@
+export { processInputProcessor } from './process-input.js';
+export { buildContextExtensionPoint } from './build-context.js';
+export { prepareStepExtensionPoint } from './prepare-step.js';
+export { createInvokeLLMProcessor } from './invoke-llm.js';
+export { processStepOutputProcessor } from './process-step-output.js';
+export { gateToolExtensionPoint } from './gate-tool.js';
+export { createExecuteToolsProcessor } from './execute-tools.js';
+export { createEvaluateIterationProcessor, evaluateIterationProcessor } from './evaluate-iteration.js';
+export { processOutputProcessor } from './process-output.js';
+//# sourceMappingURL=index.js.map

package/dist/processors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/processors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAsB,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,gCAAgC,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACvG,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/processors/invoke-llm.d.ts

@@ -0,0 +1,13 @@
+import type { Processor } from '@primo-ai/sdk';
+import type { LLMInvoker } from '../llm-invoker.js';
+import type { ToolRegistry } from '../tool-registry.js';
+import type { HookManager } from '../hook-manager.js';
+export declare function validateLlmHookOutput(hookMessages: unknown, original: unknown[]): unknown[];
+export interface InvokeLLMDeps {
+    getLLM: (systemPrompt?: string) => Promise<LLMInvoker>;
+    registry: ToolRegistry;
+    hookManager: HookManager;
+    modelString: string;
+}
+export declare function createInvokeLLMProcessor(deps: InvokeLLMDeps): Processor;
+//# sourceMappingURL=invoke-llm.d.ts.map

package/dist/processors/invoke-llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke-llm.d.ts","sourceRoot":"","sources":["../../src/processors/invoke-llm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA4B,SAAS,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AActD,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAG3F;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACvD,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAiFD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CA4DvE"}