@primo-ai/core 0.1.2 → 0.1.4

package/dist/pending-permission.js

@@ -0,0 +1,24 @@
+export class PermissionManager {
+    pending = new Map();
+    awaitDecision(permission) {
+        return new Promise((resolve) => {
+            this.pending.set(permission.permissionId, { resolve, permission });
+        });
+    }
+    resolve(permissionId, approved) {
+        const entry = this.pending.get(permissionId);
+        if (!entry)
+            throw new Error(`Permission not found: ${permissionId}`);
+        entry.resolve(approved);
+        this.pending.delete(permissionId);
+    }
+    list() {
+        return Array.from(this.pending.values()).map(e => e.permission);
+    }
+    getBySession(sessionId) {
+        return this.list().filter(p => p.sessionId === sessionId);
+    }
+    get(permissionId) {
+        return this.pending.get(permissionId)?.permission;
+    }
+}

package/dist/pipeline.d.ts

@@ -1,6 +1,6 @@
-import type { AbortSignal, PipelineContext, Processor, StageName, StreamEvent, SuspensionSignal, Tracer } from '@primo-ai/sdk';
+import type { AbortSignal, ErrorResult, PipelineContext, Processor, StageName, StreamEvent, SuspensionSignal, Tracer } from '@primo-ai/sdk';
 import type { HookManager } from './hook-manager.js';
-export type RunResult = PipelineContext | AbortSignal | SuspensionSignal;
+export type RunResult = PipelineContext | AbortSignal | SuspensionSignal | ErrorResult;
 export interface PipelineRunnerOptions {
     tracer?: Tracer;
     hookManager?: HookManager;
@@ -23,6 +23,6 @@ export declare class PipelineRunner {
     private executeStage;
     private isAbort;
     private isSuspend;
+    private isError;
     private consumeStream;
 }
-//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.js

@@ -100,6 +100,17 @@ export class PipelineRunner {
                         rootSpan.end();
                         return stageResult;
                     }
+                    if (this.isError(stageResult)) {
+                        stageSpan.end();
+                        if (this.hookManager) {
+                            try {
+                                await this.hookManager.invoke('error', { error: stageResult.error, stage: stageResult.stage }, {});
+                            }
+                            catch { /* hook error must not mask original */ }
+                        }
+                        rootSpan.end();
+                        return stageResult;
+                    }
                     ctx = stageResult;
                     ctx = await this.consumeStream(ctx);
                     // Fire llm.after after stream is consumed (response is now available)
@@ -155,6 +166,18 @@ export class PipelineRunner {
                         yield { type: 'suspended', suspensionId: stageResult.suspensionId, reason: stageResult.reason, checkpoint: stageResult.checkpoint };
                         return;
                     }
+                    if (this.isError(stageResult)) {
+                        stageSpan.end();
+                        if (this.hookManager) {
+                            try {
+                                await this.hookManager.invoke('error', { error: stageResult.error, stage: stageResult.stage }, {});
+                            }
+                            catch { /* hook error must not mask original */ }
+                        }
+                        rootSpan.end();
+                        yield { type: 'error', error: stageResult.error, stage: stageResult.stage, recoverable: stageResult.recoverable };
+                        return;
+                    }
                     ctx = stageResult;
                     const fullStream = ctx.iteration.fullStream;
                     if (fullStream) {
@@ -197,7 +220,7 @@ export class PipelineRunner {
                                 response: chunks.join('') || ctx.iteration.response || '',
                                 pendingToolCalls: toolCalls.length > 0 ? toolCalls : undefined,
                                 reasoningContent,
-                                tokenUsage: usage ?? pendingUsage,
+                                tokenUsage: usage ?? pendingUsage ?? undefined,
                                 fullStream: undefined,
                                 usagePromise: undefined,
                                 reasoningPromise: undefined,
@@ -242,7 +265,7 @@ export class PipelineRunner {
                 iteration: { ...currentCtx.iteration, span: stageSpan },
             });
             const result = await processor.execute(ctxWithSpan);
-            if ('type' in result && (result.type === 'abort' || result.type === 'suspend')) {
+            if ('type' in result && (result.type === 'abort' || result.type === 'suspend' || result.type === 'error')) {
                 return result;
             }
             currentCtx = deepFreeze({ ...result });
@@ -259,6 +282,9 @@ export class PipelineRunner {
     isSuspend(result) {
         return 'type' in result && result.type === 'suspend';
     }
+    isError(result) {
+        return 'type' in result && result.type === 'error';
+    }
     async consumeStream(ctx) {
         const fullStream = ctx.iteration.fullStream;
         if (!fullStream)
@@ -275,7 +301,7 @@ export class PipelineRunner {
                 response: result.chunks.join('') || ctx.iteration.response,
                 pendingToolCalls: result.toolCalls.length > 0 ? result.toolCalls : undefined,
                 reasoningContent,
-                tokenUsage: result.usage ?? pendingUsage,
+                tokenUsage: result.usage ?? pendingUsage ?? undefined,
                 fullStream: undefined,
                 usagePromise: undefined,
                 reasoningPromise: undefined,
@@ -283,4 +309,3 @@ export class PipelineRunner {
         });
     }
 }
-//# sourceMappingURL=pipeline.js.map

package/dist/plugin-manager.d.ts

@@ -39,4 +39,3 @@ export declare class PluginManager {
     shutdown(): Promise<void>;
     private createHarnessAPI;
 }
-//# sourceMappingURL=plugin-manager.d.ts.map

package/dist/plugin-manager.js

@@ -52,10 +52,9 @@ export class PluginManager {
             this.initializePlugin(factory);
         }
         catch (err) {
-            this.errors.push({
-                source: filePath,
-                error: err instanceof Error ? err : new Error(String(err)),
-            });
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.eventBus.emit('plugin:load_error', { source: filePath, error });
+            this.errors.push({ source: filePath, error });
         }
     }
     initializePlugin(factory) {
@@ -97,12 +96,14 @@ export class PluginManager {
                 this.resourceInstances.set(resource.id, instance);
             }
             catch (err) {
-                this.errors.push({
-                    source: `resource:${resource.id}`,
-                    error: err instanceof Error ? err : new Error(String(err)),
-                });
+                const error = err instanceof Error ? err : new Error(String(err));
+                this.eventBus.emit('plugin:resource_init_error', { source: `resource:${resource.id}`, error });
+                this.errors.push({ source: `resource:${resource.id}`, error });
             }
         }
+        if (this.errors.length > 0) {
+            throw new AggregateError(this.errors.map(e => e.error), `Plugin initialization failed for ${this.errors.length} resource(s): ${this.errors.map(e => e.source).join(', ')}`);
+        }
     }
     _shutdown = false;
     async shutdown() {
@@ -116,10 +117,9 @@ export class PluginManager {
                 await resource.stop(instance);
             }
             catch (err) {
-                this.errors.push({
-                    source: `resource:${resource.id}`,
-                    error: err instanceof Error ? err : new Error(String(err)),
-                });
+                const error = err instanceof Error ? err : new Error(String(err));
+                this.eventBus.emit('plugin:shutdown_error', { source: `resource:${resource.id}`, error });
+                this.errors.push({ source: `resource:${resource.id}`, error });
             }
         }
         this.resourceInstances.clear();
@@ -145,4 +145,3 @@ export class PluginManager {
         return impl;
     }
 }
-//# sourceMappingURL=plugin-manager.js.map

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

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

package/dist/processors/build-context.js

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

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

@@ -10,4 +10,3 @@ export declare function createEvaluateIterationProcessor(deps?: EvaluateIteratio
  * @deprecated Use `createEvaluateIterationProcessor({ eventBus })` for full functionality.
  */
 export declare const evaluateIterationProcessor: Processor;
-//# sourceMappingURL=evaluate-iteration.d.ts.map

package/dist/processors/evaluate-iteration.js

@@ -24,10 +24,14 @@ export function createEvaluateIterationProcessor(deps) {
         stage: 'evaluateIteration',
         execute: async (ctx) => {
             const prevTotal = ctx.session.totalTokenUsage ?? { input: 0, output: 0 };
-            const iterUsage = ctx.iteration.tokenUsage ?? { input: 0, output: 0 };
+            const iterUsage = ctx.iteration.tokenUsage;
+            if (!iterUsage) {
+                eventBus?.emit('token:usage_unavailable', { step: ctx.iteration.step });
+            }
+            const safeUsage = iterUsage ?? { input: 0, output: 0 };
             const totalTokenUsage = {
-                input: prevTotal.input + iterUsage.input,
-                output: prevTotal.output + iterUsage.output,
+                input: prevTotal.input + safeUsage.input,
+                output: prevTotal.output + safeUsage.output,
             };
             const totalTokens = totalTokenUsage.input + totalTokenUsage.output;
             const requiredTools = ctx.agent.config.requiredTools;
@@ -193,4 +197,3 @@ export function createEvaluateIterationProcessor(deps) {
  * @deprecated Use `createEvaluateIterationProcessor({ eventBus })` for full functionality.
  */
 export const evaluateIterationProcessor = createEvaluateIterationProcessor();
-//# sourceMappingURL=evaluate-iteration.js.map

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

@@ -1,4 +1,3 @@
 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.js

@@ -66,4 +66,3 @@ export function createExecuteToolsProcessor(registry) {
         },
     };
 }
-//# sourceMappingURL=execute-tools.js.map

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

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

package/dist/processors/gate-tool.js

@@ -3,4 +3,3 @@ export const gateToolExtensionPoint = {
     execute: async (ctx) => ctx,
     isNoOp: true,
 };
-//# sourceMappingURL=gate-tool.js.map

package/dist/processors/index.d.ts

@@ -7,4 +7,3 @@ 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.js

@@ -7,4 +7,3 @@ 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/invoke-llm.d.ts

@@ -10,4 +10,3 @@ export interface InvokeLLMDeps {
     modelString: string;
 }
 export declare function createInvokeLLMProcessor(deps: InvokeLLMDeps): Processor;
-//# sourceMappingURL=invoke-llm.d.ts.map

package/dist/processors/invoke-llm.js

@@ -135,4 +135,3 @@ export function createInvokeLLMProcessor(deps) {
         },
     };
 }
-//# sourceMappingURL=invoke-llm.js.map

package/dist/processors/prepare-step.d.ts

@@ -1,3 +1,2 @@
 import type { Processor } from '@primo-ai/sdk';
 export declare const prepareStepExtensionPoint: Processor;
-//# sourceMappingURL=prepare-step.d.ts.map

package/dist/processors/prepare-step.js

@@ -2,4 +2,3 @@ export const prepareStepExtensionPoint = {
     stage: 'prepareStep',
     execute: async (ctx) => ctx,
 };
-//# sourceMappingURL=prepare-step.js.map

package/dist/processors/process-input.d.ts

@@ -1,3 +1,2 @@
 import type { Processor } from '@primo-ai/sdk';
 export declare const processInputProcessor: Processor;
-//# sourceMappingURL=process-input.d.ts.map

package/dist/processors/process-input.js

@@ -17,4 +17,3 @@ export const processInputProcessor = {
         return { ...ctx, agent: { ...ctx.agent, config } };
     },
 };
-//# sourceMappingURL=process-input.js.map

package/dist/processors/process-output.d.ts

@@ -1,3 +1,2 @@
 import type { Processor } from '@primo-ai/sdk';
 export declare const processOutputProcessor: Processor;
-//# sourceMappingURL=process-output.d.ts.map

package/dist/processors/process-output.js

@@ -2,4 +2,3 @@ export const processOutputProcessor = {
     stage: 'processOutput',
     execute: async (ctx) => ctx,
 };
-//# sourceMappingURL=process-output.js.map

package/dist/processors/process-step-output.d.ts

@@ -1,3 +1,2 @@
 import type { Processor } from '@primo-ai/sdk';
 export declare const processStepOutputProcessor: Processor;
-//# sourceMappingURL=process-step-output.d.ts.map

package/dist/processors/process-step-output.js

@@ -20,4 +20,3 @@ export const processStepOutputProcessor = {
         };
     },
 };
-//# sourceMappingURL=process-step-output.js.map

package/dist/processors/provider-history-compat.d.ts

@@ -4,4 +4,3 @@ export declare const BUILTIN_COMPAT_RULES: CompatRule[];
 export declare function applyPreemptiveRules(messages: unknown[], modelString: string, capabilities: ProviderCapabilities, rules?: CompatRule[]): unknown[];
 /** Try reactive rules against an API error. Returns fixed history + diff, or null. */
 export declare function applyReactiveRules(history: import('@primo-ai/sdk').Message[], modelString: string, error: unknown, rules?: CompatRule[]): import('@primo-ai/sdk').CompatResult | null;
-//# sourceMappingURL=provider-history-compat.d.ts.map

package/dist/processors/provider-history-compat.js

@@ -163,4 +163,3 @@ export function applyReactiveRules(history, modelString, error, rules = BUILTIN_
     }
     return null;
 }
-//# sourceMappingURL=provider-history-compat.js.map

package/dist/provider-capabilities.d.ts

@@ -1,4 +1,3 @@
 import type { ProviderCapabilities } from '@primo-ai/sdk';
 export declare function detectProvider(modelString: string): string;
 export declare function detectCapabilities(modelString: string): ProviderCapabilities;
-//# sourceMappingURL=provider-capabilities.d.ts.map

package/dist/provider-capabilities.js

@@ -44,4 +44,3 @@ export function detectCapabilities(modelString) {
     const provider = detectProvider(modelString);
     return KNOWN[provider] ?? { ...DEFAULT };
 }
-//# sourceMappingURL=provider-capabilities.js.map

package/dist/retry.d.ts

@@ -3,4 +3,3 @@ export interface RetryOptions {
     baseDelay: number;
 }
 export declare function streamWithRetry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;
-//# sourceMappingURL=retry.d.ts.map

package/dist/retry.js

@@ -23,4 +23,3 @@ export async function streamWithRetry(fn, options) {
     }
     throw lastError;
 }
-//# sourceMappingURL=retry.js.map

package/dist/serialize.d.ts

@@ -9,4 +9,3 @@ interface SerializableContext {
 export declare function serialize(ctx: PipelineContext): SerializableContext;
 export declare function deserialize(data: SerializableContext): PipelineContext;
 export {};
-//# sourceMappingURL=serialize.d.ts.map

package/dist/serialize.js

@@ -19,4 +19,3 @@ export function deserialize(data) {
         session: data.session,
     };
 }
-//# sourceMappingURL=serialize.js.map

package/dist/session-manager.d.ts

@@ -14,4 +14,3 @@ export declare class SessionManagerImpl implements SessionManager {
         parentSessionId?: string;
     }): Promise<SessionRecord[]>;
 }
-//# sourceMappingURL=session-manager.d.ts.map

package/dist/session-manager.js

@@ -140,4 +140,3 @@ export class SessionManagerImpl {
         return this.storage.list(filter);
     }
 }
-//# sourceMappingURL=session-manager.js.map

package/dist/session-persistence.d.ts

@@ -10,4 +10,3 @@ export declare class SessionPersistence {
     stop(): Promise<void>;
     private onEvent;
 }
-//# sourceMappingURL=session-persistence.d.ts.map

package/dist/session-persistence.js

@@ -60,4 +60,3 @@ export class SessionPersistence {
         this.writeQueues.set(sessionId, write);
     }
 }
-//# sourceMappingURL=session-persistence.js.map

package/dist/session-storage-sqlite.d.ts

@@ -0,0 +1,41 @@
+import type { SessionEvent, SessionRecord, SessionStorage, SessionStatus, Message } from '@primo-ai/sdk';
+/**
+ * SqliteSessionStorage — SQLite-backed implementation of SessionStorage.
+ *
+ * Uses `better-sqlite3` as an **optional** dependency. The module is loaded
+ * dynamically so projects that only need FilesystemSessionStorage never pay
+ * the cost (or install penalty) of the native binding.
+ *
+ * Pass `:memory:` as dbPath for an in-memory database (useful for tests).
+ */
+export declare class SqliteSessionStorage implements SessionStorage {
+    private db;
+    private stmtInsertEvent;
+    private stmtSelectEvents;
+    private stmtSelectSession;
+    private stmtUpsertSession;
+    private stmtDeleteSession;
+    private stmtSelectSessionsByStatus;
+    private stmtSelectSessionsByParent;
+    private stmtSelectAllSessions;
+    private stmtNextSeq;
+    constructor(dbPath: string);
+    private initSchema;
+    private prepareStatements;
+    append(sessionId: string, event: SessionEvent): Promise<void>;
+    read(sessionId: string): AsyncIterable<SessionEvent>;
+    list(filter?: {
+        parentSessionId?: string;
+        status?: SessionStatus;
+    }): Promise<SessionRecord[]>;
+    updateMeta(sessionId: string, meta: Partial<SessionRecord>): Promise<void>;
+    get(sessionId: string): Promise<SessionRecord | undefined>;
+    delete(sessionId: string): Promise<void>;
+    getMessages(sessionId: string, options?: {
+        limit?: number;
+        before?: string;
+    }): Promise<Message[]>;
+    /** Close the underlying database connection. */
+    close(): void;
+    private rowToRecord;
+}