@primo-ai/core 0.1.0

package/dist/session-manager.js

@@ -0,0 +1,143 @@
+export class SessionManagerImpl {
+    storage;
+    bus;
+    constructor(storage, bus) {
+        this.storage = storage;
+        this.bus = bus;
+    }
+    async start(input, options) {
+        const sessionId = crypto.randomUUID();
+        const now = new Date().toISOString();
+        const record = {
+            sessionId,
+            parentSessionId: options?.parentSessionId,
+            createdAt: now,
+            updatedAt: now,
+            status: 'active',
+        };
+        await this.storage.updateMeta(sessionId, record);
+        this.bus.emit('agent:start', { sessionId, input });
+        return record;
+    }
+    async restore(sessionId) {
+        const events = [];
+        for await (const event of this.storage.read(sessionId)) {
+            events.push(event);
+        }
+        if (events.length === 0) {
+            throw new Error(`Session not found: ${sessionId}`);
+        }
+        let input = '';
+        let lastStep = 0;
+        const messageHistory = [];
+        let agentConfig = {};
+        let promptFragments = [];
+        let toolDeclarations = [];
+        let totalTokenUsage;
+        let lastResponse;
+        const custom = {};
+        let toolCallIdx = 0;
+        for (const event of events) {
+            const payload = event.payload;
+            if (!payload)
+                continue;
+            switch (event.type) {
+                case 'agent:start': {
+                    if (payload.input)
+                        input = payload.input;
+                    if (payload.agentConfig)
+                        agentConfig = payload.agentConfig;
+                    if (payload.promptFragments)
+                        promptFragments = payload.promptFragments;
+                    if (payload.toolDeclarations)
+                        toolDeclarations = payload.toolDeclarations;
+                    break;
+                }
+                case 'iteration:end':
+                case 'iteration.end': {
+                    lastStep = payload.step + 1;
+                    if (payload.response) {
+                        lastResponse = payload.response;
+                        const msg = { role: 'assistant', content: payload.response };
+                        messageHistory.push(msg);
+                    }
+                    if (payload.tokenUsage) {
+                        totalTokenUsage = payload.tokenUsage;
+                    }
+                    break;
+                }
+                case 'tool:before':
+                case 'tool.before': {
+                    // tool.before is a pre-execution hook event; skip — tool:after carries the result
+                    break;
+                }
+                case 'tool:after':
+                case 'tool.after': {
+                    const toolName = payload.toolName;
+                    const content = payload.error
+                        ? String(payload.error)
+                        : typeof payload.result === 'string'
+                            ? payload.result
+                            : JSON.stringify(payload.result ?? '');
+                    const msg = {
+                        role: 'tool',
+                        content,
+                        toolCallId: `restored_${toolName}_${toolCallIdx++}`,
+                        toolName,
+                    };
+                    if (payload.error)
+                        msg.error = String(payload.error);
+                    if (payload.result !== undefined)
+                        msg.result = payload.result;
+                    messageHistory.push(msg);
+                    break;
+                }
+                case 'llm:after':
+                case 'llm.after': {
+                    if (payload.tokenUsage) {
+                        const usage = payload.tokenUsage;
+                        totalTokenUsage = totalTokenUsage
+                            ? { input: totalTokenUsage.input + usage.input, output: totalTokenUsage.output + usage.output }
+                            : usage;
+                    }
+                    break;
+                }
+                case 'error': {
+                    messageHistory.push({ role: 'assistant', content: `[Error] ${String(payload.error)}` });
+                    break;
+                }
+                case 'session:suspended': {
+                    custom.suspendReason = payload.reason;
+                    break;
+                }
+                case 'stage:before':
+                case 'stage:after':
+                case 'llm:before':
+                case 'agent:end':
+                    break;
+            }
+        }
+        return {
+            request: { input, sessionId },
+            agent: { config: agentConfig, promptFragments, toolDeclarations },
+            iteration: { step: lastStep, response: lastResponse },
+            session: { messageHistory, totalTokenUsage, custom },
+        };
+    }
+    async suspend(sessionId, reason) {
+        // Emit through EventBus so SessionPersistence handles seq + write
+        this.bus.emit('session:suspended', { sessionId, reason });
+        await this.storage.updateMeta(sessionId, { status: 'suspended' });
+    }
+    async resume(sessionId, input) {
+        // Mark original session as completed
+        await this.storage.updateMeta(sessionId, { status: 'completed' });
+        // Start a new continuation session linked to the original
+        const child = await this.start(input ?? '', { parentSessionId: sessionId });
+        return child.sessionId;
+    }
+    async list(filter) {
+        return this.storage.list(filter);
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/session-manager.js.map

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

package/dist/session-persistence.d.ts

@@ -0,0 +1,13 @@
+import type { SessionStorage } from '@primo-ai/sdk';
+import type { EventBus } from './event-bus.js';
+export declare class SessionPersistence {
+    private storage;
+    private unsubs;
+    private seqCounters;
+    private writeQueues;
+    private bus;
+    constructor(bus: EventBus, storage: SessionStorage);
+    stop(): Promise<void>;
+    private onEvent;
+}
+//# sourceMappingURL=session-persistence.d.ts.map

package/dist/session-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-persistence.d.ts","sourceRoot":"","sources":["../src/session-persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAiB/C,qBAAa,kBAAkB;IAMF,OAAO,CAAC,OAAO;IAL1C,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,GAAG,CAAW;gBAEV,GAAG,EAAE,QAAQ,EAAU,OAAO,EAAE,cAAc;IAUpD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,OAAO,CAAC,OAAO;CA2BhB"}

package/dist/session-persistence.js

@@ -0,0 +1,63 @@
+import { REPLAY_SENTINEL } from './event-system.js';
+const SUBSCRIBED_EVENTS = [
+    'agent:start',
+    'stage:before',
+    'stage:after',
+    'agent:end',
+    'tool:before',
+    'tool:after',
+    'llm:before',
+    'llm:after',
+    'iteration:end',
+    'error',
+    'session:suspended',
+];
+export class SessionPersistence {
+    storage;
+    unsubs = [];
+    seqCounters = new Map();
+    writeQueues = new Map();
+    bus;
+    constructor(bus, storage) {
+        this.storage = storage;
+        this.bus = bus;
+        for (const eventType of SUBSCRIBED_EVENTS) {
+            const unsub = bus.subscribe(eventType, (data) => {
+                this.onEvent(eventType, data);
+            });
+            this.unsubs.push(unsub);
+        }
+    }
+    async stop() {
+        for (const unsub of this.unsubs)
+            unsub();
+        this.unsubs = [];
+        await Promise.all([...this.writeQueues.values()].map(p => p.catch(() => { })));
+    }
+    onEvent(eventType, data) {
+        // Skip replayed events to avoid duplicate writes
+        if (typeof data === 'object' && data !== null && REPLAY_SENTINEL in data) {
+            return;
+        }
+        const payload = data;
+        const sessionId = payload?.sessionId;
+        if (!sessionId)
+            return;
+        const seq = (this.seqCounters.get(sessionId) ?? 0) + 1;
+        this.seqCounters.set(sessionId, seq);
+        const event = {
+            seq,
+            timestamp: new Date().toISOString(),
+            type: eventType,
+            payload: data,
+        };
+        const prev = this.writeQueues.get(sessionId) ?? Promise.resolve();
+        const write = prev
+            .then(() => this.storage.append(sessionId, event))
+            .catch((err) => {
+            this.bus.emit('session:write_failed', { sessionId, error: err instanceof Error ? err.message : String(err) });
+        });
+        this.writeQueues.set(sessionId, write);
+    }
+}
+//# sourceMappingURL=session-persistence.js.map

package/dist/session-persistence.js.map

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

package/dist/session-storage.d.ts

@@ -0,0 +1,19 @@
+import type { SessionEvent, SessionRecord, SessionStorage, SessionStatus } from '@primo-ai/sdk';
+export declare class FilesystemSessionStorage implements SessionStorage {
+    private basePath;
+    constructor(basePath: string);
+    private validateSessionId;
+    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>;
+    private sessionDir;
+    private eventsPath;
+    private metaPath;
+    private readMeta;
+    private defaultRecord;
+}
+//# sourceMappingURL=session-storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-storage.d.ts","sourceRoot":"","sources":["../src/session-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAIhG,qBAAa,wBAAyB,YAAW,cAAc;IACjD,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAEpC,OAAO,CAAC,iBAAiB;IAMnB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5D,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC;IAoBrD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,aAAa,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAmB7F,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAahF,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,QAAQ;YAIF,QAAQ;IAStB,OAAO,CAAC,aAAa;CAStB"}

package/dist/session-storage.js

@@ -0,0 +1,103 @@
+import { appendFile, mkdir, readFile, readdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export class FilesystemSessionStorage {
+    basePath;
+    constructor(basePath) {
+        this.basePath = basePath;
+    }
+    validateSessionId(sessionId) {
+        if (new RegExp('[/\\\\]|\\.\\.').test(sessionId)) {
+            throw new Error(`Invalid sessionId: ${sessionId}`);
+        }
+    }
+    async append(sessionId, event) {
+        this.validateSessionId(sessionId);
+        const dir = this.sessionDir(sessionId);
+        await mkdir(dir, { recursive: true });
+        const line = JSON.stringify(event) + '\n';
+        await appendFile(this.eventsPath(sessionId), line, 'utf-8');
+    }
+    async *read(sessionId) {
+        this.validateSessionId(sessionId);
+        const filePath = this.eventsPath(sessionId);
+        let content;
+        try {
+            content = await readFile(filePath, 'utf-8');
+        }
+        catch {
+            return;
+        }
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (trimmed.length === 0)
+                continue;
+            try {
+                yield JSON.parse(trimmed);
+            }
+            catch {
+                // Skip malformed lines (e.g. truncated writes from crash)
+            }
+        }
+    }
+    async list(filter) {
+        let entries;
+        try {
+            entries = await readdir(this.basePath);
+        }
+        catch {
+            return [];
+        }
+        const records = [];
+        for (const sessionId of entries) {
+            const meta = await this.readMeta(sessionId);
+            if (!meta)
+                continue;
+            if (filter?.parentSessionId && meta.parentSessionId !== filter.parentSessionId)
+                continue;
+            if (filter?.status && meta.status !== filter.status)
+                continue;
+            records.push(meta);
+        }
+        return records;
+    }
+    async updateMeta(sessionId, meta) {
+        this.validateSessionId(sessionId);
+        const existing = await this.readMeta(sessionId);
+        const updated = {
+            ...(existing ?? this.defaultRecord(sessionId)),
+            ...meta,
+            updatedAt: new Date().toISOString(),
+        };
+        const dir = this.sessionDir(sessionId);
+        await mkdir(dir, { recursive: true });
+        await writeFile(this.metaPath(sessionId), JSON.stringify(updated), 'utf-8');
+    }
+    sessionDir(sessionId) {
+        return join(this.basePath, sessionId);
+    }
+    eventsPath(sessionId) {
+        return join(this.sessionDir(sessionId), 'events.jsonl');
+    }
+    metaPath(sessionId) {
+        return join(this.sessionDir(sessionId), 'meta.json');
+    }
+    async readMeta(sessionId) {
+        try {
+            const content = await readFile(this.metaPath(sessionId), 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    defaultRecord(sessionId) {
+        const now = new Date().toISOString();
+        return {
+            sessionId,
+            createdAt: now,
+            updatedAt: now,
+            status: 'active',
+        };
+    }
+}
+//# sourceMappingURL=session-storage.js.map

package/dist/session-storage.js.map

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

package/dist/state-machine.d.ts

@@ -0,0 +1,13 @@
+import type { AgentForgeError } from './errors.js';
+export type AgentState = 'pending' | 'running' | 'paused' | 'completed' | 'cancelled' | 'error';
+export declare class StateMachine {
+    private _current;
+    private _lastError?;
+    private listeners;
+    get current(): AgentState;
+    canTransition(to: AgentState, error?: AgentForgeError): boolean;
+    transition(to: AgentState, error?: AgentForgeError): void;
+    onTransition(cb: (from: AgentState, to: AgentState) => void): () => void;
+    private isRecoverable;
+}
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../src/state-machine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;AAWhG,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,UAAU,CAAC,CAAkB;IACrC,OAAO,CAAC,SAAS,CAAyD;IAE1E,IAAI,OAAO,IAAI,UAAU,CAExB;IAED,aAAa,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,eAAe,GAAG,OAAO;IAO/D,UAAU,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,eAAe,GAAG,IAAI;IAUzD,YAAY,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;IAQxE,OAAO,CAAC,aAAa;CAMtB"}

package/dist/state-machine.js

@@ -0,0 +1,49 @@
+const VALID_TRANSITIONS = {
+    pending: ['running'],
+    running: ['paused', 'completed', 'cancelled', 'error'],
+    paused: ['running', 'cancelled'],
+    completed: ['pending'],
+    cancelled: ['pending'],
+    error: ['pending'],
+};
+export class StateMachine {
+    _current = 'pending';
+    _lastError;
+    listeners = [];
+    get current() {
+        return this._current;
+    }
+    canTransition(to, error) {
+        if (to === 'running' && this._current === 'error') {
+            return this.isRecoverable(error ?? this._lastError);
+        }
+        return VALID_TRANSITIONS[this._current]?.includes(to) ?? false;
+    }
+    transition(to, error) {
+        if (!this.canTransition(to, error)) {
+            throw new Error(`Invalid state transition: ${this._current} -> ${to}`);
+        }
+        const from = this._current;
+        this._current = to;
+        if (to === 'error')
+            this._lastError = error;
+        for (const cb of this.listeners)
+            cb(from, to);
+    }
+    onTransition(cb) {
+        this.listeners.push(cb);
+        return () => {
+            const idx = this.listeners.indexOf(cb);
+            if (idx >= 0)
+                this.listeners.splice(idx, 1);
+        };
+    }
+    isRecoverable(error) {
+        if (!error || !error.recoverable)
+            return false;
+        const retryCount = error.retryCount ?? 0;
+        const maxRetries = error.maxRetries ?? 3;
+        return retryCount < maxRetries;
+    }
+}
+//# sourceMappingURL=state-machine.js.map

package/dist/state-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.js","sourceRoot":"","sources":["../src/state-machine.ts"],"names":[],"mappings":"AAIA,MAAM,iBAAiB,GAAqC;IAC1D,OAAO,EAAE,CAAC,SAAS,CAAC;IACpB,OAAO,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC;IACtD,MAAM,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,SAAS,EAAE,CAAC,SAAS,CAAC;IACtB,SAAS,EAAE,CAAC,SAAS,CAAC;IACtB,KAAK,EAAE,CAAC,SAAS,CAAC;CACnB,CAAC;AAEF,MAAM,OAAO,YAAY;IACf,QAAQ,GAAe,SAAS,CAAC;IACjC,UAAU,CAAmB;IAC7B,SAAS,GAAsD,EAAE,CAAC;IAE1E,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,aAAa,CAAC,EAAc,EAAE,KAAuB;QACnD,IAAI,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAClD,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC;IACjE,CAAC;IAED,UAAU,CAAC,EAAc,EAAE,KAAuB;QAChD,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,CAAC,QAAQ,OAAO,EAAE,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,EAAE,KAAK,OAAO;YAAE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAC5C,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS;YAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,YAAY,CAAC,EAA8C;QACzD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxB,OAAO,GAAG,EAAE;YACV,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACvC,IAAI,GAAG,IAAI,CAAC;gBAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC9C,CAAC,CAAC;IACJ,CAAC;IAEO,aAAa,CAAC,KAAuB;QAC3C,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;QACzC,OAAO,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;CACF"}

package/dist/storage-replay-backend.d.ts

@@ -0,0 +1,7 @@
+import type { ReplayBackend, SessionStorage, SessionEvent } from '@primo-ai/sdk';
+export declare class StorageReplayBackend implements ReplayBackend {
+    private storage;
+    constructor(storage: SessionStorage);
+    query(sessionId: string): Promise<SessionEvent[]>;
+}
+//# sourceMappingURL=storage-replay-backend.d.ts.map

package/dist/storage-replay-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-replay-backend.d.ts","sourceRoot":"","sources":["../src/storage-replay-backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEjF,qBAAa,oBAAqB,YAAW,aAAa;IAC5C,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAErC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAOxD"}

package/dist/storage-replay-backend.js

@@ -0,0 +1,14 @@
+export class StorageReplayBackend {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async query(sessionId) {
+        const events = [];
+        for await (const event of this.storage.read(sessionId)) {
+            events.push(event);
+        }
+        return events;
+    }
+}
+//# sourceMappingURL=storage-replay-backend.js.map

package/dist/storage-replay-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-replay-backend.js","sourceRoot":"","sources":["../src/storage-replay-backend.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,oBAAoB;IACX;IAApB,YAAoB,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAE/C,KAAK,CAAC,KAAK,CAAC,SAAiB;QAC3B,MAAM,MAAM,GAAmB,EAAE,CAAC;QAClC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACvD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/sub-agent.d.ts

@@ -0,0 +1,13 @@
+import type { SubAgentConfig, ToolDefinition, Tracer } from '@primo-ai/sdk';
+interface SubAgentParentContext {
+    model: string;
+    tools: ToolDefinition[];
+    eventBus?: {
+        emit: (event: string, data: unknown) => void;
+    };
+    tracer?: Tracer;
+    getSessionState?: () => Record<string, unknown>;
+}
+export declare function createSubAgentTool(config: SubAgentConfig, parent: SubAgentParentContext): ToolDefinition;
+export {};
+//# sourceMappingURL=sub-agent.d.ts.map

package/dist/sub-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent.d.ts","sourceRoot":"","sources":["../src/sub-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkC,cAAc,EAAwB,cAAc,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAKlI,UAAU,qBAAqB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,CAAC;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjD;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,qBAAqB,GAC5B,cAAc,CAsEhB"}

package/dist/sub-agent.js

@@ -0,0 +1,87 @@
+import { Agent } from './agent.js';
+export function createSubAgentTool(config, parent) {
+    const tool = {
+        name: config.name,
+        description: config.description ?? `Sub-agent: ${config.name}`,
+        inputSchema: config.inputSchema ?? {},
+        async execute(input) {
+            parent.eventBus?.emit('task:start', { name: config.name, input });
+            try {
+                const childModel = config.model ?? parent.model;
+                const childTools = config.tools ?? parent.tools;
+                const childAgent = new Agent({
+                    model: childModel,
+                    systemPrompt: config.systemPrompt,
+                    tools: childTools,
+                    maxIterations: config.maxIterations,
+                }, { tracer: parent.tracer });
+                if (config.contextPolicy === 'inherit' && parent.getSessionState) {
+                    const parentState = parent.getSessionState();
+                    childAgent.use({
+                        stage: 'prepareStep',
+                        execute: async (ctx) => {
+                            if (ctx.iteration?.step === 0) {
+                                return { ...ctx, session: mergeSessionState(ctx.session, parentState) };
+                            }
+                            return ctx;
+                        },
+                    });
+                }
+                if (config.contextPolicy === 'summary-only' && parent.getSessionState) {
+                    const parentState = parent.getSessionState();
+                    const summary = summarizeSessionState(parentState);
+                    childAgent.use({
+                        stage: 'prepareStep',
+                        execute: async (ctx) => ({
+                            ...ctx,
+                            session: { ...ctx.session, custom: { ...ctx.session.custom, parentContextSummary: summary } },
+                        }),
+                    });
+                }
+                const runResult = await childAgent.run(input.task);
+                const result = {
+                    response: runResult.response,
+                    tokenUsage: runResult.tokenUsage,
+                    sessionId: runResult.sessionId,
+                };
+                parent.eventBus?.emit('task:end', { name: config.name, result });
+                return runResult.response;
+            }
+            catch (err) {
+                const errorSummary = `Sub-agent "${config.name}" failed: ${err instanceof Error ? err.message : String(err)}`;
+                parent.eventBus?.emit('task:end', {
+                    name: config.name,
+                    error: errorSummary,
+                });
+                const wrapper = new Error(errorSummary);
+                wrapper.cause = err;
+                throw wrapper;
+            }
+        },
+    };
+    return tool;
+}
+function summarizeSessionState(state) {
+    const history = state.messageHistory;
+    if (!history || !Array.isArray(history))
+        return '';
+    return history
+        .map((m) => `${m.role}: ${m.content}`)
+        .join('\n');
+}
+function mergeSessionState(child, parent) {
+    const merged = { ...child };
+    for (const [key, parentVal] of Object.entries(parent)) {
+        if (Array.isArray(parentVal) && Array.isArray(merged[key])) {
+            const childArr = merged[key];
+            const parentLen = parentVal.length;
+            const childExtras = childArr.slice(parentLen);
+            merged[key] = [...parentVal, ...childExtras];
+        }
+        else {
+            merged[key] = parentVal;
+        }
+    }
+    return merged;
+}
+//# sourceMappingURL=sub-agent.js.map

package/dist/sub-agent.js.map

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

package/dist/task-manager.d.ts

@@ -0,0 +1,22 @@
+import type { AsyncTaskConfig, AsyncTaskHandle, AgentConfig, SubAgentResult, TaskManager as ITaskManager } from '@primo-ai/sdk';
+import type { EventBus } from './event-bus.js';
+import type { ConcurrencyController } from './concurrency-controller.js';
+export declare class TaskManagerImpl implements ITaskManager {
+    private handles;
+    private eventBus?;
+    private concurrencyController?;
+    private runAgentFn;
+    constructor(options?: {
+        eventBus?: EventBus;
+        concurrencyController?: ConcurrencyController;
+        runAgentFn?: (config: AgentConfig, input: string, signal?: AbortSignal) => Promise<SubAgentResult>;
+    });
+    launch(config: AsyncTaskConfig, prompt: string): Promise<AsyncTaskHandle>;
+    get(taskId: string): AsyncTaskHandle | undefined;
+    cancel(taskId: string): void;
+    list(filter?: {
+        parentSessionId?: string;
+    }): AsyncTaskHandle[];
+    private executeTask;
+}
+//# sourceMappingURL=task-manager.d.ts.map

package/dist/task-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-manager.d.ts","sourceRoot":"","sources":["../src/task-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAEf,WAAW,EACX,cAAc,EACd,WAAW,IAAI,YAAY,EAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AA4EzE,qBAAa,eAAgB,YAAW,YAAY;IAClD,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,qBAAqB,CAAC,CAAwB;IACtD,OAAO,CAAC,UAAU,CAIW;gBAEjB,OAAO,CAAC,EAAE;QACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;QAC9C,UAAU,CAAC,EAAE,CACX,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,cAAc,CAAC,CAAC;KAC9B;IAMK,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAwB/E,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIhD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO5B,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe,EAAE;YAYhD,WAAW;CAoE1B"}