@supen-ai/cli 0.1.6

package/daemon/dist/agent-sdk/memory/filesystem.js

@@ -0,0 +1,133 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { randomUUID } from 'node:crypto';
+function ensureDir(dirPath) {
+    fs.mkdirSync(dirPath, { recursive: true });
+}
+function readStore(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return { version: 1, records: [] };
+    }
+    try {
+        const parsed = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+        if (parsed?.version === 1 && Array.isArray(parsed.records)) {
+            return parsed;
+        }
+    }
+    catch {
+        // fall through
+    }
+    return { version: 1, records: [] };
+}
+function writeStore(filePath, store) {
+    ensureDir(path.dirname(filePath));
+    fs.writeFileSync(filePath, JSON.stringify(store, null, 2));
+}
+function tokenize(value) {
+    return value
+        .toLowerCase()
+        .split(/[^a-z0-9]+/g)
+        .filter(Boolean);
+}
+function overlapScore(record, queryTokens) {
+    const recordTokens = new Set([
+        ...tokenize(record.content),
+        ...record.tags.map((tag) => tag.toLowerCase()),
+    ]);
+    let score = 0;
+    for (const token of queryTokens) {
+        if (recordTokens.has(token))
+            score += 1;
+    }
+    return score;
+}
+export function createFileMemorySubsystem(baseDir, options = {}) {
+    const recordsFile = options.recordsFile ||
+        path.join(baseDir, 'memory', 'subsystem', 'records.json');
+    const nowIso = () => new Date().toISOString();
+    const withStore = (fn) => {
+        const store = readStore(recordsFile);
+        const result = fn(store);
+        writeStore(recordsFile, store);
+        return result;
+    };
+    return {
+        async writeEphemeral(input) {
+            return withStore((store) => {
+                const record = {
+                    id: randomUUID(),
+                    scope: input.scope,
+                    tier: 'ephemeral',
+                    content: input.content,
+                    tags: input.tags ?? [],
+                    createdAt: nowIso(),
+                    updatedAt: nowIso(),
+                };
+                store.records.push(record);
+                return record;
+            });
+        },
+        async requestDurableWrite(input, approval) {
+            if (!approval?.approved) {
+                return { status: 'denied' };
+            }
+            return withStore((store) => {
+                const record = {
+                    id: randomUUID(),
+                    scope: input.scope,
+                    tier: 'durable',
+                    content: input.content,
+                    tags: input.tags ?? [],
+                    createdAt: nowIso(),
+                    updatedAt: nowIso(),
+                };
+                store.records.push(record);
+                return { status: 'committed', record };
+            });
+        },
+        async retrieve(input) {
+            const store = readStore(recordsFile);
+            const queryTokens = tokenize(input.query);
+            const includeDurable = input.includeDurable ?? true;
+            const includeEphemeral = input.includeEphemeral ?? true;
+            const limit = input.limit ?? 5;
+            return store.records
+                .filter((record) => {
+                if (record.tier === 'durable' && !includeDurable)
+                    return false;
+                if (record.tier === 'ephemeral' && !includeEphemeral)
+                    return false;
+                return true;
+            })
+                .map((record) => ({ record, score: overlapScore(record, queryTokens) }))
+                .sort((a, b) => b.score - a.score || b.record.updatedAt.localeCompare(a.record.updatedAt))
+                .slice(0, limit)
+                .map(({ record }) => record);
+        },
+        summarize(records, options) {
+            const maxChars = options?.maxChars ?? 400;
+            if (records.length === 0)
+                return '';
+            return records
+                .map((record) => `- [${record.tier}] ${record.content}`)
+                .join('\n')
+                .slice(0, maxChars);
+        },
+        async pruneEphemeral(policy) {
+            return withStore((store) => {
+                const cutoff = Date.now() - policy.maxAgeDays * 24 * 60 * 60 * 1000;
+                const before = store.records.length;
+                store.records = store.records.filter((record) => {
+                    if (record.tier !== 'ephemeral')
+                        return true;
+                    return new Date(record.updatedAt).getTime() >= cutoff;
+                });
+                return before - store.records.length;
+            });
+        },
+        async listAll() {
+            return readStore(recordsFile).records;
+        },
+    };
+}
+//# sourceMappingURL=filesystem.js.map

package/daemon/dist/agent-sdk/memory/filesystem.js.map

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

package/daemon/dist/agent-sdk/memory/subsystem.d.ts

@@ -0,0 +1,54 @@
+export type MemoryTier = 'ephemeral' | 'durable';
+export type MemoryScope = 'session' | 'task' | 'agent';
+export type MemoryRecord = {
+    id: string;
+    scope: MemoryScope;
+    tier: MemoryTier;
+    content: string;
+    tags: string[];
+    createdAt: string;
+    updatedAt: string;
+};
+export type MemoryWriteInput = {
+    scope: MemoryScope;
+    content: string;
+    tags?: string[];
+};
+export type DurableWriteApproval = {
+    approved: boolean;
+    approver?: string;
+};
+export type RetrieveInput = {
+    query: string;
+    limit?: number;
+    includeDurable?: boolean;
+    includeEphemeral?: boolean;
+};
+export type PrunePolicy = {
+    maxAgeDays: number;
+};
+export interface MemorySubsystem {
+    writeEphemeral(input: MemoryWriteInput): Promise<MemoryRecord>;
+    requestDurableWrite(input: MemoryWriteInput, approval?: DurableWriteApproval): Promise<{
+        status: 'denied' | 'committed';
+        record?: MemoryRecord;
+    }>;
+    retrieve(input: RetrieveInput): Promise<MemoryRecord[]>;
+    summarize(records: MemoryRecord[], options?: {
+        maxChars?: number;
+    }): string;
+    pruneEphemeral(policy: PrunePolicy): Promise<number>;
+    listAll(): Promise<MemoryRecord[]>;
+}
+export declare function createInMemoryMemorySubsystem(): MemorySubsystem & {
+    seed(records: MemoryRecord[]): void;
+};
+export declare function computeReclarificationDelta(input: {
+    withoutMemoryClarificationTurns: number;
+    withMemoryClarificationTurns: number;
+}): {
+    improved: boolean;
+    reduction: number;
+    reductionRatio: number;
+};
+//# sourceMappingURL=subsystem.d.ts.map

package/daemon/dist/agent-sdk/memory/subsystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subsystem.d.ts","sourceRoot":"","sources":["../../../src/agent-sdk/memory/subsystem.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AACjD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEvD,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/D,mBAAmB,CACjB,KAAK,EAAE,gBAAgB,EACvB,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,OAAO,CAAC;QAAE,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;QAAC,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;IACtE,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACxD,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;IAC5E,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,OAAO,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACpC;AAkBD,wBAAgB,6BAA6B,IAAI,eAAe,GAAG;IACjE,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;CACrC,CAiFA;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,+BAA+B,EAAE,MAAM,CAAC;IACxC,4BAA4B,EAAE,MAAM,CAAC;CACtC,GAAG;IACF,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB,CAWA"}

package/daemon/dist/agent-sdk/memory/subsystem.js

@@ -0,0 +1,106 @@
+import { randomUUID } from 'node:crypto';
+function toTokens(value) {
+    return value
+        .toLowerCase()
+        .split(/[^a-z0-9]+/g)
+        .filter(Boolean);
+}
+function scoreByOverlap(record, queryTokens) {
+    const textTokens = new Set([...toTokens(record.content), ...record.tags.map((t) => t.toLowerCase())]);
+    let score = 0;
+    for (const token of queryTokens) {
+        if (textTokens.has(token))
+            score += 1;
+    }
+    return score;
+}
+export function createInMemoryMemorySubsystem() {
+    let records = [];
+    const nowIso = () => new Date().toISOString();
+    return {
+        seed(seedRecords) {
+            records = [...seedRecords];
+        },
+        async writeEphemeral(input) {
+            const record = {
+                id: randomUUID(),
+                scope: input.scope,
+                tier: 'ephemeral',
+                content: input.content,
+                tags: input.tags ?? [],
+                createdAt: nowIso(),
+                updatedAt: nowIso(),
+            };
+            records.push(record);
+            return record;
+        },
+        async requestDurableWrite(input, approval) {
+            if (!approval?.approved) {
+                return { status: 'denied' };
+            }
+            const record = {
+                id: randomUUID(),
+                scope: input.scope,
+                tier: 'durable',
+                content: input.content,
+                tags: input.tags ?? [],
+                createdAt: nowIso(),
+                updatedAt: nowIso(),
+            };
+            records.push(record);
+            return { status: 'committed', record };
+        },
+        async retrieve(input) {
+            const queryTokens = toTokens(input.query);
+            const includeDurable = input.includeDurable ?? true;
+            const includeEphemeral = input.includeEphemeral ?? true;
+            const limit = input.limit ?? 5;
+            return records
+                .filter((record) => {
+                if (record.tier === 'durable' && !includeDurable)
+                    return false;
+                if (record.tier === 'ephemeral' && !includeEphemeral)
+                    return false;
+                return true;
+            })
+                .map((record) => ({ record, score: scoreByOverlap(record, queryTokens) }))
+                .sort((a, b) => b.score - a.score || b.record.updatedAt.localeCompare(a.record.updatedAt))
+                .slice(0, limit)
+                .map(({ record }) => record);
+        },
+        summarize(selectedRecords, options) {
+            const maxChars = options?.maxChars ?? 400;
+            if (selectedRecords.length === 0)
+                return '';
+            const summary = selectedRecords
+                .map((record) => `- [${record.tier}] ${record.content}`)
+                .join('\n');
+            return summary.slice(0, maxChars);
+        },
+        async pruneEphemeral(policy) {
+            const cutoff = Date.now() - policy.maxAgeDays * 24 * 60 * 60 * 1000;
+            const before = records.length;
+            records = records.filter((record) => {
+                if (record.tier !== 'ephemeral')
+                    return true;
+                return new Date(record.updatedAt).getTime() >= cutoff;
+            });
+            return before - records.length;
+        },
+        async listAll() {
+            return [...records];
+        },
+    };
+}
+export function computeReclarificationDelta(input) {
+    const reduction = input.withoutMemoryClarificationTurns - input.withMemoryClarificationTurns;
+    const reductionRatio = input.withoutMemoryClarificationTurns > 0
+        ? reduction / input.withoutMemoryClarificationTurns
+        : 0;
+    return {
+        improved: reduction > 0,
+        reduction,
+        reductionRatio,
+    };
+}
+//# sourceMappingURL=subsystem.js.map

package/daemon/dist/agent-sdk/memory/subsystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subsystem.js","sourceRoot":"","sources":["../../../src/agent-sdk/memory/subsystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAiDzC,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,KAAK;SACT,WAAW,EAAE;SACb,KAAK,CAAC,aAAa,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,cAAc,CAAC,MAAoB,EAAE,WAAqB;IACjE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;IACtG,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,6BAA6B;IAG3C,IAAI,OAAO,GAAmB,EAAE,CAAC;IAEjC,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE9C,OAAO;QACL,IAAI,CAAC,WAAW;YACd,OAAO,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;QAC7B,CAAC;QAED,KAAK,CAAC,cAAc,CAAC,KAAK;YACxB,MAAM,MAAM,GAAiB;gBAC3B,EAAE,EAAE,UAAU,EAAE;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;gBACtB,SAAS,EAAE,MAAM,EAAE;gBACnB,SAAS,EAAE,MAAM,EAAE;aACpB,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,CAAC,mBAAmB,CAAC,KAAK,EAAE,QAAQ;YACvC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC;gBACxB,OAAO,EAAE,MAAM,EAAE,QAAiB,EAAE,CAAC;YACvC,CAAC;YACD,MAAM,MAAM,GAAiB;gBAC3B,EAAE,EAAE,UAAU,EAAE;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;gBACtB,SAAS,EAAE,MAAM,EAAE;gBACnB,SAAS,EAAE,MAAM,EAAE;aACpB,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,OAAO,EAAE,MAAM,EAAE,WAAoB,EAAE,MAAM,EAAE,CAAC;QAClD,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,KAAK;YAClB,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1C,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,IAAI,IAAI,CAAC;YACpD,MAAM,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,IAAI,IAAI,CAAC;YACxD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;YAC/B,OAAO,OAAO;iBACX,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;gBACjB,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,cAAc;oBAAE,OAAO,KAAK,CAAC;gBAC/D,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,gBAAgB;oBAAE,OAAO,KAAK,CAAC;gBACnE,OAAO,IAAI,CAAC;YACd,CAAC,CAAC;iBACD,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;iBACzE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;iBACzF,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;iBACf,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QAED,SAAS,CAAC,eAAe,EAAE,OAAO;YAChC,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,GAAG,CAAC;YAC1C,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAC5C,MAAM,OAAO,GAAG,eAAe;iBAC5B,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC;iBACvD,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,cAAc,CAAC,MAAM;YACzB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;YACpE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC9B,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;gBAClC,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW;oBAAE,OAAO,IAAI,CAAC;gBAC7C,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,MAAM,CAAC;YACxD,CAAC,CAAC,CAAC;YACH,OAAO,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QACjC,CAAC;QAED,KAAK,CAAC,OAAO;YACX,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAG3C;IAKC,MAAM,SAAS,GAAG,KAAK,CAAC,+BAA+B,GAAG,KAAK,CAAC,4BAA4B,CAAC;IAC7F,MAAM,cAAc,GAClB,KAAK,CAAC,+BAA+B,GAAG,CAAC;QACvC,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,+BAA+B;QACnD,CAAC,CAAC,CAAC,CAAC;IACR,OAAO;QACL,QAAQ,EAAE,SAAS,GAAG,CAAC;QACvB,SAAS;QACT,cAAc;KACf,CAAC;AACJ,CAAC"}

package/daemon/dist/agent-sdk/session-events.d.ts

@@ -0,0 +1,59 @@
+import type { SupenControlCommandType, SupenControlLogEntry, SupenControlSurface, SupenEventPersistence, SupenEventVisibility, SupenFactOwner, SupenNormalizedSessionEvent, SupenSession, SupenSessionEvent, SupenSessionEventSource, SupenSessionStatus, SupenSessionEventType, SupenTurn, SupenTurnItem, SupenTurnItemType, SupenTurnStatus } from './types.js';
+export declare function createSession(input?: {
+    id?: string;
+    status?: SupenSessionStatus;
+    createdAt?: string;
+    completedAt?: string;
+    metadata?: Record<string, unknown>;
+}): SupenSession;
+export declare function createSessionEvent(input: {
+    sessionId: string;
+    turnId: string;
+    source: SupenSessionEventSource;
+    type: SupenSessionEventType;
+    owner?: SupenFactOwner;
+    persistence?: SupenEventPersistence;
+    payload?: Record<string, unknown>;
+}): SupenSessionEvent;
+export declare function normalizeSessionEvent(input: {
+    event: SupenSessionEvent;
+    visibility?: SupenEventVisibility;
+    rawEventId?: string;
+}): SupenNormalizedSessionEvent;
+export declare function createControlLogEntry(input: {
+    sessionId: string;
+    turnId?: string;
+    surface: SupenControlSurface;
+    commandType: SupenControlCommandType;
+    method?: string;
+    actor?: string;
+    correlationId?: string;
+    status?: SupenControlLogEntry['status'];
+    params?: Record<string, unknown>;
+    payload?: Record<string, unknown>;
+}): SupenControlLogEntry;
+export declare function createTurnItem(input: {
+    sessionId: string;
+    turnId: string;
+    type: SupenTurnItemType;
+    role?: 'user' | 'assistant' | 'system';
+    payload?: Record<string, unknown>;
+}): SupenTurnItem;
+export declare function createTurn(input: {
+    id?: string;
+    sessionId: string;
+    status?: SupenTurnStatus;
+    createdAt?: string;
+    completedAt?: string;
+    metadata?: Record<string, unknown>;
+}): SupenTurn;
+export declare function isTerminalSessionEvent(event: SupenSessionEvent): boolean;
+export declare function classifySessionInsight(input: {
+    summary: string;
+    successfulOutcomeCount: number;
+    repetitionCount: number;
+}): {
+    target: 'memory' | 'knowledge';
+    canonical: boolean;
+};
+//# sourceMappingURL=session-events.d.ts.map

package/daemon/dist/agent-sdk/session-events.d.ts.map

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

package/daemon/dist/agent-sdk/session-events.js

@@ -0,0 +1,104 @@
+import { randomUUID } from 'crypto';
+const RUNTIME_EVENT_TYPES = new Set([
+    'turn.started',
+    'turn.completed',
+    'turn.failed',
+    'turn.cancelled',
+    'text.delta',
+    'tool.started',
+    'tool.completed',
+    'tool.failed',
+    'artifact.emitted',
+    'warning.emitted',
+]);
+function ownerForSessionEventType(type) {
+    return RUNTIME_EVENT_TYPES.has(type) ? 'runtime' : 'supen';
+}
+function persistenceForOwner(owner) {
+    return owner === 'runtime' ? 'execution-cache' : 'control-log';
+}
+function visibilityForSessionEventType(type) {
+    if (type === 'warning.emitted')
+        return 'user';
+    return 'developer';
+}
+export function createSession(input) {
+    return {
+        id: input?.id || randomUUID(),
+        status: input?.status || 'active',
+        createdAt: input?.createdAt || new Date().toISOString(),
+        ...(input?.completedAt ? { completedAt: input.completedAt } : {}),
+        ...(input?.metadata ? { metadata: input.metadata } : {}),
+    };
+}
+export function createSessionEvent(input) {
+    const owner = input.owner || ownerForSessionEventType(input.type);
+    const persistence = input.persistence || persistenceForOwner(owner);
+    return {
+        id: randomUUID(),
+        sessionId: input.sessionId,
+        turnId: input.turnId,
+        source: input.source,
+        type: input.type,
+        timestamp: new Date().toISOString(),
+        owner,
+        persistence,
+        payload: input.payload || {},
+    };
+}
+export function normalizeSessionEvent(input) {
+    const owner = input.event.owner || ownerForSessionEventType(input.event.type);
+    return {
+        ...input.event,
+        owner,
+        persistence: input.event.persistence || persistenceForOwner(owner),
+        visibility: input.visibility || visibilityForSessionEventType(input.event.type),
+        ...(input.rawEventId ? { rawEventId: input.rawEventId } : {}),
+    };
+}
+export function createControlLogEntry(input) {
+    return {
+        id: randomUUID(),
+        sessionId: input.sessionId,
+        ...(input.turnId ? { turnId: input.turnId } : {}),
+        timestamp: new Date().toISOString(),
+        surface: input.surface,
+        commandType: input.commandType,
+        ...(input.method ? { method: input.method } : {}),
+        ...(input.actor ? { actor: input.actor } : {}),
+        ...(input.correlationId ? { correlationId: input.correlationId } : {}),
+        status: input.status || 'received',
+        ...(input.params ? { params: input.params } : {}),
+        payload: input.payload || {},
+    };
+}
+export function createTurnItem(input) {
+    return {
+        id: randomUUID(),
+        sessionId: input.sessionId,
+        turnId: input.turnId,
+        type: input.type,
+        ...(input.role ? { role: input.role } : {}),
+        payload: input.payload || {},
+    };
+}
+export function createTurn(input) {
+    return {
+        id: input.id || randomUUID(),
+        sessionId: input.sessionId,
+        status: input.status || 'started',
+        createdAt: input.createdAt || new Date().toISOString(),
+        ...(input.completedAt ? { completedAt: input.completedAt } : {}),
+        ...(input.metadata ? { metadata: input.metadata } : {}),
+    };
+}
+export function isTerminalSessionEvent(event) {
+    return event.type === 'turn.completed' || event.type === 'turn.failed' || event.type === 'turn.cancelled';
+}
+export function classifySessionInsight(input) {
+    if (input.successfulOutcomeCount > 0 || input.repetitionCount > 1) {
+        return { target: 'knowledge', canonical: true };
+    }
+    return { target: 'memory', canonical: false };
+}
+//# sourceMappingURL=session-events.js.map

package/daemon/dist/agent-sdk/session-events.js.map

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

package/daemon/dist/agent-sdk/session-manager.d.ts

@@ -0,0 +1,28 @@
+import type { BackendDriver, DriverSession, StartDriverSessionInput } from './drivers/driver.js';
+import type { SupenDriverOutput, SupenSession, SupenTurn } from './types.js';
+import type { MemorySubsystem } from './memory/subsystem.js';
+export type SessionManagerInput = StartDriverSessionInput & {
+    driverId?: string;
+};
+export type SessionManagerTurnInput = Omit<SessionManagerInput, 'sessionId' | 'turnId'> & {
+    session: SupenSession;
+    turn: SupenTurn;
+};
+export declare class SessionManager {
+    private readonly drivers;
+    private readonly memorySubsystem;
+    private readonly defaultDriverId;
+    readonly defaultDriverSelectionReason: 'preferred-cli' | 'codex-fallback' | 'first-usable-backend' | 'first-registered';
+    constructor(drivers?: Record<string, BackendDriver>, defaultDriverId?: string, memorySubsystem?: MemorySubsystem | null);
+    createSession(input: SessionManagerInput): Promise<DriverSession>;
+    createSessionForTurn(input: SessionManagerTurnInput): Promise<DriverSession>;
+    normalizeOutput(input: {
+        driverId?: string;
+        sessionId: string;
+        turnId: string;
+        output: Record<string, unknown>;
+    }): SupenDriverOutput[];
+    resolveDriverId(driverId?: string): string;
+    getMemorySubsystem(): MemorySubsystem | null;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/daemon/dist/agent-sdk/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/agent-sdk/session-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEjG,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,mBAAmB,GAAG,uBAAuB,GAAG;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;CAInB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,mBAAmB,EAAE,WAAW,GAAG,QAAQ,CAAC,GAAG;IACxF,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC;AAEF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IACzD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,QAAQ,CAAC,4BAA4B,EAAE,eAAe,GAAG,gBAAgB,GAAG,sBAAsB,GAAG,kBAAkB,CAAC;gBAGtH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACvC,eAAe,CAAC,EAAE,MAAM,EACxB,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI;IAcpC,aAAa,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IASjE,oBAAoB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC;IAQlF,eAAe,CAAC,KAAK,EAAE;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,GAAG,iBAAiB,EAAE;IAYvB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAI1C,kBAAkB,IAAI,eAAe,GAAG,IAAI;CAG7C"}

package/daemon/dist/agent-sdk/session-manager.js

@@ -0,0 +1,54 @@
+import { createDefaultDriverRegistry, resolveDriverIdAlias, resolveDefaultDriverSelection } from './drivers/registry.js';
+import { readConfigSummary } from '../core/env.js';
+export class SessionManager {
+    drivers;
+    memorySubsystem;
+    defaultDriverId;
+    defaultDriverSelectionReason;
+    constructor(drivers, defaultDriverId, memorySubsystem) {
+        this.drivers = drivers || createDefaultDriverRegistry();
+        this.memorySubsystem = memorySubsystem ?? null;
+        if (defaultDriverId) {
+            this.defaultDriverId = defaultDriverId;
+            this.defaultDriverSelectionReason = 'preferred-cli';
+        }
+        else {
+            const selection = resolveDefaultDriverSelection(process.env.SUPEN_CODING_CLI || readConfigSummary().coding_cli || 'codex', this.drivers);
+            this.defaultDriverId = selection.driverId;
+            this.defaultDriverSelectionReason = selection.reason;
+        }
+    }
+    async createSession(input) {
+        const driverId = this.resolveDriverId(input.driverId);
+        const driver = this.drivers[driverId];
+        if (!driver) {
+            throw new Error(`Unknown backend driver: ${driverId}`);
+        }
+        return driver.startSession(input);
+    }
+    async createSessionForTurn(input) {
+        return this.createSession({
+            ...input,
+            sessionId: input.session.id,
+            turnId: input.turn.id,
+        });
+    }
+    normalizeOutput(input) {
+        const driverId = this.resolveDriverId(input.driverId);
+        const driver = this.drivers[driverId];
+        if (!driver) {
+            throw new Error(`Unknown backend driver: ${driverId}`);
+        }
+        if (!driver.normalizeOutput) {
+            return [{ kind: 'raw', raw: input.output }];
+        }
+        return driver.normalizeOutput(input);
+    }
+    resolveDriverId(driverId) {
+        return resolveDriverIdAlias(driverId || this.defaultDriverId, this.drivers);
+    }
+    getMemorySubsystem() {
+        return this.memorySubsystem;
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/daemon/dist/agent-sdk/session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../../src/agent-sdk/session-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAEzH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAenD,MAAM,OAAO,cAAc;IACR,OAAO,CAAgC;IACvC,eAAe,CAAyB;IACxC,eAAe,CAAS;IAChC,4BAA4B,CAAmF;IAExH,YACE,OAAuC,EACvC,eAAwB,EACxB,eAAwC;QAExC,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,2BAA2B,EAAE,CAAC;QACxD,IAAI,CAAC,eAAe,GAAG,eAAe,IAAI,IAAI,CAAC;QAC/C,IAAI,eAAe,EAAE,CAAC;YACpB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;YACvC,IAAI,CAAC,4BAA4B,GAAG,eAAe,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,MAAM,SAAS,GAAG,6BAA6B,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,iBAAiB,EAAE,CAAC,UAAU,IAAI,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACzI,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC,QAAQ,CAAC;YAC1C,IAAI,CAAC,4BAA4B,GAAG,SAAS,CAAC,MAAM,CAAC;QACvD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAA0B;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,KAA8B;QACvD,OAAO,IAAI,CAAC,aAAa,CAAC;YACxB,GAAG,KAAK;YACR,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE;YAC3B,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED,eAAe,CAAC,KAKf;QACC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YAC5B,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,eAAe,CAAC,QAAiB;QAC/B,OAAO,oBAAoB,CAAC,QAAQ,IAAI,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9E,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;CACF"}