@calliopelabs/cli 3.1.0 → 3.2.0

package/dist/session-management/actions.js

@@ -0,0 +1,78 @@
+import { realpathSync } from 'node:fs';
+import * as storage from '../storage.js';
+import { eventLink, replaySessionHistory, readSessionEvent, readToolState, installToolState, stateHash, writeConversation, MAX_SNAPSHOT_MESSAGES, SessionRecoveryError, validateMessages, toolStateHash } from '../sessions/index.js';
+import { throwIfCancelled } from '../cancellation.js';
+import { RunLog } from '../runlog.js';
+import { authorizeSessionAction } from './permissions.js';
+export function selectSession(selector, cwd) {
+    let session = storage.getSessionById(selector);
+    if (!session) {
+        const matches = storage.listSessions(10000).filter(item => item.lineage?.name === selector && item.projectPath === cwd);
+        if (matches.length !== 1)
+            throw new Error(matches.length ? 'Ambiguous branch name; use its session ID from /sessions.' : 'Session not found; use /sessions.');
+        session = matches[0];
+    }
+    if (realpathSync(session.projectPath) !== realpathSync(cwd))
+        throw new Error(`Session belongs to ${session.projectPath}; open Calliope in that project.`);
+    return session;
+}
+export async function sessionHistory(id, revision, signal) {
+    throwIfCancelled(signal);
+    const dir = storage.getSessionDirById(id);
+    if (!dir)
+        throw new Error('Session not found; use /sessions.');
+    const head = revision ? eventLink(readSessionEvent(dir, undefined, revision)) : storage.readSessionConversation(id).history;
+    if (!head)
+        throw new Error('This legacy snapshot has no recorded history yet; resume and save it first.');
+    return replaySessionHistory(dir, id, head, signal);
+}
+export async function branchSession(id, options = {}) {
+    if (options.name !== undefined && !/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,63}$/.test(options.name))
+        throw new Error('Branch names use 1–64 letters, numbers, dots, underscores or hyphens.');
+    if (options.messages) {
+        validateMessages(options.messages);
+        if (options.expectedRevision === undefined)
+            throw new Error('Branching unsaved messages requires the current saved revision.');
+    }
+    const messages = options.messages ? structuredClone(options.messages) : undefined;
+    const source = storage.getSessionById(id);
+    if (!source)
+        throw new Error('Source session not found.');
+    await authorizeSessionAction(source.projectPath, 'session_branch', { source: id, kind: options.kind ?? 'manual', path: source.projectPath }, options);
+    const replay = await sessionHistory(id, undefined, options.signal);
+    if (options.expectedRevision !== undefined && replay.snapshot.revision !== options.expectedRevision)
+        throw new SessionRecoveryError('conflict', 'another terminal saved this session; use /resume before branching.');
+    const files = readToolState(storage.getSessionDirById(id));
+    throwIfCancelled(options.signal);
+    const session = storage.createSession(source.projectPath, { activate: false, lineage: {
+            version: 1, toolStateHash: toolStateHash(files), kind: options.kind ?? 'manual', ...(options.name ? { name: options.name } : {}), sessionId: id,
+            revision: replay.snapshot.revision, stateHash: stateHash(replay.snapshot), at: new Date().toISOString(),
+        } });
+    const dir = storage.getSessionDirById(session.id);
+    const log = options.runlog ?? RunLog.open(id);
+    try {
+        installToolState(dir, files, options.signal);
+        const state = writeConversation(dir, session.id, messages ?? replay.snapshot.messages, { expectedRevision: null, status: replay.snapshot.status, signal: options.signal, cap: MAX_SNAPSHOT_MESSAGES, droppedMessages: messages && JSON.stringify(messages) !== JSON.stringify(replay.snapshot.messages) ? 0 : replay.snapshot.droppedMessages });
+        storage.updateSessionSummary(session.id, state);
+        log.policyEvent({ tool: 'session_branch', source: 'session-history', decision: 'allow', durationMs: 0,
+            reason: `kind=${options.kind ?? 'manual'} destination=${session.id} sourceRevision=${replay.snapshot.revision} revision=${state.revision} toolStateHash=${session.lineage.toolStateHash}` });
+        return { session: { ...session, messageCount: state.messages.length }, state };
+    }
+    catch (error) {
+        log.policyEvent({ tool: 'session_branch', source: 'session-history', decision: 'deny', durationMs: 0, reason: `Incomplete inactive branch preserved: ${session.id}` });
+        throw error;
+    }
+    finally {
+        await log.flush();
+    }
+}
+export function compareConversations(before, after) {
+    let commonMessages = 0;
+    while (commonMessages < Math.min(before.messages.length, after.messages.length) &&
+        JSON.stringify(before.messages[commonMessages]) === JSON.stringify(after.messages[commonMessages]))
+        commonMessages++;
+    return { version: 1, before: before.revision, after: after.revision, commonMessages,
+        removed: before.messages.slice(commonMessages), added: after.messages.slice(commonMessages),
+        status: { before: before.status, after: after.status } };
+}
+//# sourceMappingURL=actions.js.map

package/dist/session-management/actions.js.map

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

package/dist/session-management/cli.d.ts

@@ -0,0 +1,24 @@
+import { type SessionActionOptions } from './permissions.js';
+export declare const SESSION_USAGE = "calliope session list | status <id|name> | replay <id|name> [revision] | branch <id|name> [name] | diff <before> <after> | outputs <id|name> [output-id] | export <id|name> <file.json> | import <file.json> [--json]";
+export interface SessionReport {
+    version: 1;
+    type: 'session';
+    action: string;
+    localOnly: true;
+    data?: unknown;
+    error?: {
+        code: 'invalid-arguments' | 'cancelled' | 'policy-denied' | 'invalid-session' | 'operation-failed';
+        message: string;
+    };
+}
+export declare function sessionCommand(args: string[], options?: SessionActionOptions & {
+    cwd?: string;
+}): Promise<{
+    report: SessionReport;
+    exitCode: number;
+}>;
+export declare function runSessionCommand(args: string[], options?: SessionActionOptions & {
+    cwd?: string;
+    write?: (text: string) => void;
+}): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/session-management/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/session-management/cli.ts"],"names":[],"mappings":"AAQA,OAAO,EAAsB,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGjF,eAAO,MAAM,aAAa,0NAA0N,CAAC;AACrP,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,CAAC;IAC7D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,mBAAmB,GAAG,WAAW,GAAG,eAAe,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACjI;AACD,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,oBAAoB,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAgDhK;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,oBAAoB,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAU9J"}

package/dist/session-management/cli.js

@@ -0,0 +1,92 @@
+/** A separate versioned headless contract; existing audit `calliope replay` is unchanged. */
+import { parseArgs } from 'node:util';
+import { realpathSync } from 'node:fs';
+import * as storage from '../storage.js';
+import { isCancellation, throwIfCancelled } from '../cancellation.js';
+import { SessionRecoveryError, readToolOutputs } from '../sessions/index.js';
+import { branchSession, compareConversations, selectSession, sessionHistory } from './actions.js';
+import { exportSession, importSession } from './transfer.js';
+import { SessionPolicyError } from './permissions.js';
+import { conversationMarkdown } from './presentation.js';
+export const SESSION_USAGE = 'calliope session list | status <id|name> | replay <id|name> [revision] | branch <id|name> [name] | diff <before> <after> | outputs <id|name> [output-id] | export <id|name> <file.json> | import <file.json> [--json]';
+export async function sessionCommand(args, options = {}) {
+    let action = 'unknown';
+    const failure = (code, message, exitCode) => ({ exitCode,
+        report: { version: 1, type: 'session', action, localOnly: true, error: { code, message } } });
+    let positionals;
+    try {
+        ({ positionals } = parseArgs({ args, allowPositionals: true, options: { json: { type: 'boolean' } } }));
+        action = positionals[0] ?? 'list';
+        const count = positionals.length ? positionals.length - 1 : 0;
+        const arities = { list: [0], status: [1], replay: [1, 2], outputs: [1, 2], branch: [1, 2], diff: [2], export: [2], import: [1] };
+        if (!Object.hasOwn(arities, action) || !arities[action].includes(count) || positionals.some(value => value.length > 4096 || /[\x00-\x1f\x7f]/.test(value)))
+            return failure('invalid-arguments', SESSION_USAGE, 2);
+    }
+    catch {
+        return failure('invalid-arguments', SESSION_USAGE, 2);
+    }
+    try {
+        throwIfCancelled(options.signal);
+        const cwd = realpathSync(options.cwd ?? process.cwd());
+        let data;
+        if (action === 'list')
+            data = { sessions: storage.listSessions(10000).filter(session => session.projectPath === cwd) };
+        else if (action === 'import') {
+            const imported = await importSession(cwd, positionals[1], options);
+            data = { session: imported.session, revision: imported.state.revision, status: imported.state.status, messageCount: imported.state.messages.length };
+        }
+        else {
+            const session = selectSession(positionals[1], cwd);
+            if (action === 'status') {
+                const state = storage.readSessionConversation(session.id);
+                data = { session, revision: state.revision, status: state.status, messageCount: state.messages.length, droppedMessages: state.droppedMessages, history: state.history ?? null };
+            }
+            else if (action === 'outputs') {
+                const saved = readToolOutputs(storage.getSessionDirById(session.id));
+                const record = positionals[2] ? saved.records.find(record => record.id === positionals[2]) : undefined;
+                if (positionals[2] && !record)
+                    throw new Error('Tool output not retained.');
+                data = { sessionId: session.id, dropped: saved.dropped, ...(record ? { record } : { records: saved.records.map(({ content: _content, ...record }) => record) }) };
+            }
+            else if (action === 'replay') {
+                const replay = await sessionHistory(session.id, positionals[2], options.signal);
+                data = { sessionId: session.id, ...replay };
+            }
+            else if (action === 'branch') {
+                const branch = await branchSession(session.id, { ...options, name: positionals[2] });
+                data = { session: branch.session, revision: branch.state.revision };
+            }
+            else if (action === 'diff')
+                data = compareConversations(storage.readSessionConversation(session.id), storage.readSessionConversation(selectSession(positionals[2], cwd).id));
+            else
+                data = { path: await exportSession(cwd, session.id, positionals[2], options) };
+        }
+        return { report: { version: 1, type: 'session', action, localOnly: true, data }, exitCode: 0 };
+    }
+    catch (error) {
+        if (options.signal?.aborted || isCancellation(error))
+            return failure('cancelled', 'Session operation cancelled; existing history is preserved.', 130);
+        if (error instanceof SessionPolicyError)
+            return failure('policy-denied', error.message, 3);
+        if (error instanceof SessionRecoveryError)
+            return failure('invalid-session', error.message, 1);
+        // Errors from host I/O or untrusted data must not echo private payloads to CI.
+        return failure('operation-failed', 'Session operation failed; check the session ID, project, file path and audit log, then retry.', 1);
+    }
+}
+export async function runSessionCommand(args, options = {}) {
+    const { report, exitCode } = await sessionCommand(args, options);
+    const write = options.write ?? ((text) => { process.stdout.write(text); });
+    if (args.includes('--json'))
+        write(JSON.stringify(report) + '\n');
+    else if (report.error)
+        write(report.error.message + '\n');
+    else if (report.action === 'replay') {
+        const replay = report.data;
+        write(`Recorded conversation ${replay.snapshot.revision}; ${replay.events.length} events verified. No tools executed.\n${conversationMarkdown(replay.snapshot.messages)}`);
+    }
+    else
+        write(JSON.stringify(report.data, null, 2) + '\n');
+    return exitCode;
+}
+//# sourceMappingURL=cli.js.map

package/dist/session-management/cli.js.map

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

package/dist/session-management/files.d.ts

@@ -0,0 +1,5 @@
+import { type SessionActionOptions } from './permissions.js';
+export declare function readSessionTransfer(cwd: string, path: string, options?: SessionActionOptions): Promise<string>;
+/** No overwrite option: source exports remain useful rollback references. */
+export declare function writeSessionTransfer(cwd: string, path: string, content: string, options?: SessionActionOptions): Promise<string>;
+//# sourceMappingURL=files.d.ts.map

package/dist/session-management/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/session-management/files.ts"],"names":[],"mappings":"AAMA,OAAO,EAA0B,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAqBrF,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAQxH;AAED,6EAA6E;AAC7E,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B1I"}

package/dist/session-management/files.js

@@ -0,0 +1,92 @@
+/** Project-scoped, private and exclusive session transfer files. */
+import * as fs from 'node:fs';
+import { basename, dirname, isAbsolute, join, relative, resolve } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { hash, readPrivateSessionFile, MAX_BUNDLE_BYTES } from '../sessions/index.js';
+import { throwIfCancelled } from '../cancellation.js';
+import { authorizeSessionAction } from './permissions.js';
+import { RunLog } from '../runlog.js';
+function location(cwd, path) {
+    if (!path || /[\x00-\x1f\x7f]/.test(path))
+        throw new Error('Use a regular file path inside the current project.');
+    const root = fs.realpathSync(cwd), file = resolve(root, path), parent = dirname(file);
+    const rel = relative(root, file);
+    if (!rel || rel === '..' || rel.startsWith('../') || isAbsolute(rel) || fs.realpathSync(parent) !== parent)
+        throw new Error('Session transfers require a file inside the current project without symlink directories.');
+    const rootStat = fs.statSync(root), parentStat = fs.statSync(parent);
+    if (!rootStat.isDirectory() || !parentStat.isDirectory())
+        throw new Error('Session transfer parent must be a directory.');
+    const recheck = () => {
+        for (const [path, before] of [[root, rootStat], [parent, parentStat]]) {
+            const current = fs.lstatSync(path);
+            if (current.isSymbolicLink() || current.dev !== before.dev || current.ino !== before.ino || fs.realpathSync(path) !== path)
+                throw new Error('Session transfer directory changed during permission checks; retry.');
+        }
+    };
+    return { root, file, parent, recheck };
+}
+export async function readSessionTransfer(cwd, path, options = {}) {
+    throwIfCancelled(options.signal);
+    const target = location(cwd, path);
+    await authorizeSessionAction(target.root, 'read_file', { path: target.file, operation: 'session-import' }, options);
+    target.recheck();
+    throwIfCancelled(options.signal);
+    const content = readPrivateSessionFile(target.file, MAX_BUNDLE_BYTES);
+    if (content === null)
+        throw new Error('Session transfer file not found.');
+    return content;
+}
+/** No overwrite option: source exports remain useful rollback references. */
+export async function writeSessionTransfer(cwd, path, content, options = {}) {
+    throwIfCancelled(options.signal);
+    if (Buffer.byteLength(content) > MAX_BUNDLE_BYTES)
+        throw new Error('Session export exceeds the portable file budget.');
+    const target = location(cwd, path);
+    const log = options.runlog ?? RunLog.open(`session_export_${randomUUID()}`);
+    await authorizeSessionAction(target.root, 'write_file', { path: target.file, operation: 'session-export', bytes: Buffer.byteLength(content), checksum: hash(content) }, { ...options, runlog: log });
+    target.recheck();
+    throwIfCancelled(options.signal);
+    const temp = join(target.parent, `.${basename(target.file)}-${randomUUID()}.tmp`);
+    let created = false;
+    try {
+        const fd = fs.openSync(temp, 'wx', 0o600);
+        created = true;
+        try {
+            fs.writeFileSync(fd, content);
+            fs.fsyncSync(fd);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        target.recheck();
+        throwIfCancelled(options.signal);
+        fs.linkSync(temp, target.file);
+        const parentFd = fs.openSync(target.parent, 'r');
+        try {
+            fs.fsyncSync(parentFd);
+        }
+        finally {
+            fs.closeSync(parentFd);
+        }
+        log.policyEvent({ tool: 'session_export', source: 'session-history', decision: 'allow', durationMs: 0,
+            reason: `committed=${target.file} checksum=${hash(content)}` });
+        return target.file;
+    }
+    catch (error) {
+        log.policyEvent({ tool: 'session_export', source: 'session-history', decision: 'deny', durationMs: 0, reason: `Export failed; inspect destination before retrying: ${target.file}` });
+        if (options.signal?.aborted)
+            throw error;
+        throw new Error('Session export could not be saved; choose a new file and check directory permissions and free space.');
+    }
+    finally {
+        if (created) {
+            try {
+                target.recheck();
+                fs.unlinkSync(temp);
+            }
+            catch { /* Never clean files in a replaced directory. */ }
+        }
+        await log.flush();
+    }
+}
+//# sourceMappingURL=files.js.map

package/dist/session-management/files.js.map

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

package/dist/session-management/index.d.ts

@@ -0,0 +1,7 @@
+export * from './actions.js';
+export * from './transfer.js';
+export * from './permissions.js';
+export * from './files.js';
+export * from './presentation.js';
+export * from './cli.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/session-management/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session-management/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC"}

package/dist/session-management/index.js

@@ -0,0 +1,7 @@
+export * from './actions.js';
+export * from './transfer.js';
+export * from './permissions.js';
+export * from './files.js';
+export * from './presentation.js';
+export * from './cli.js';
+//# sourceMappingURL=index.js.map

package/dist/session-management/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session-management/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC"}

package/dist/session-management/permissions.d.ts

@@ -0,0 +1,12 @@
+import { type PermissionContext } from '../runtime/permissions.js';
+import { RunLog } from '../runlog.js';
+export type SessionActionOptions = Pick<PermissionContext, 'signal' | 'approve' | 'mode'> & {
+    confirmation?: PermissionContext['confirmation'];
+    runlog?: RunLog;
+};
+export declare class SessionPolicyError extends Error {
+    constructor();
+}
+/** Operation arguments contain scope and digests, never conversation or tool content. */
+export declare function authorizeSessionAction(cwd: string, name: string, args: Record<string, unknown>, options?: SessionActionOptions): Promise<void>;
+//# sourceMappingURL=permissions.d.ts.map

package/dist/session-management/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/session-management/permissions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACtF,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGtC,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC,GAAG;IAC1F,YAAY,CAAC,EAAE,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACnE,CAAC;AACF,qBAAa,kBAAmB,SAAQ,KAAK;IAAG,cAA2I;CAAE;AAE7L,yFAAyF;AACzF,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBxJ"}

package/dist/session-management/permissions.js

@@ -0,0 +1,33 @@
+import { randomUUID } from 'node:crypto';
+import { withScope } from '../scope.js';
+import { resolvePermission } from '../runtime/permissions.js';
+import { RunLog } from '../runlog.js';
+import { throwIfCancelled } from '../cancellation.js';
+export class SessionPolicyError extends Error {
+    constructor() { super('Session operation denied by policy; inspect its audit record before retrying.'); this.name = 'SessionPolicyError'; }
+}
+/** Operation arguments contain scope and digests, never conversation or tool content. */
+export async function authorizeSessionAction(cwd, name, args, options = {}) {
+    throwIfCancelled(options.signal);
+    const log = options.runlog ?? RunLog.open(`session_action_${randomUUID()}`);
+    const id = randomUUID();
+    log.toolCall({ id, name, args });
+    try {
+        const decision = await withScope(cwd, () => resolvePermission({ id, name, arguments: args }, {
+            cwd, signal: options.signal, mode: options.mode, confirmation: options.confirmation ?? 'none', approve: options.approve,
+            audit: event => log.policyEvent(event),
+        }));
+        if (decision.decision !== 'allow')
+            throw new SessionPolicyError();
+        throwIfCancelled(options.signal);
+        log.toolResult({ id, result: 'Permission allowed; operation not yet committed.', isError: false, durationMs: 0 });
+    }
+    catch (error) {
+        log.toolResult({ id, result: 'Session permission denied or cancelled.', isError: true, durationMs: 0 });
+        throw error;
+    }
+    finally {
+        await log.flush();
+    }
+}
+//# sourceMappingURL=permissions.js.map

package/dist/session-management/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/session-management/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAA0B,MAAM,2BAA2B,CAAC;AACtF,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAKtD,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAAG,gBAAgB,KAAK,CAAC,+EAA+E,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC,CAAC,CAAC;CAAE;AAE7L,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,GAAW,EAAE,IAAY,EAAE,IAA6B,EAAE,OAAO,GAAyB,EAAE;IACvI,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,kBAAkB,UAAU,EAAE,EAAE,CAAC,CAAC;IAC5E,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE;YAC3F,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO;YACvH,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC;SACvC,CAAC,CAAC,CAAC;QACJ,IAAI,QAAQ,CAAC,QAAQ,KAAK,OAAO;YAAE,MAAM,IAAI,kBAAkB,EAAE,CAAC;QAClE,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,kDAAkD,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;IACpH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,yCAAyC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;QACxG,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QAAC,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;AAClC,CAAC"}

package/dist/session-management/presentation.d.ts

@@ -0,0 +1,5 @@
+import type { Message } from '../types.js';
+/** Display only conversation channels; protocol metadata stays private and opaque. */
+export declare function messageText(message: Message): string;
+export declare function conversationMarkdown(messages: Message[]): string;
+//# sourceMappingURL=presentation.d.ts.map

package/dist/session-management/presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../src/session-management/presentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAIpD;AACD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAEhE"}

package/dist/session-management/presentation.js

@@ -0,0 +1,10 @@
+/** Display only conversation channels; protocol metadata stays private and opaque. */
+export function messageText(message) {
+    const content = typeof message.content === 'string' ? message.content : message.content.map(part => part.type === 'text' ? part.text : `[Image: ${part.mediaType}]`).join('\n');
+    const tools = message.toolCalls?.map(call => call.name).join(', ');
+    return content + (tools ? `${content ? '\n' : ''}Tool requests: ${tools}` : '');
+}
+export function conversationMarkdown(messages) {
+    return '# Calliope conversation\n\n' + messages.filter(message => message.role !== 'system').map(message => `## ${message.role}\n\n${messageText(message)}\n`).join('\n');
+}
+//# sourceMappingURL=presentation.js.map

package/dist/session-management/presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.js","sourceRoot":"","sources":["../../src/session-management/presentation.ts"],"names":[],"mappings":"AAEA,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChL,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnE,OAAO,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,kBAAkB,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAClF,CAAC;AACD,MAAM,UAAU,oBAAoB,CAAC,QAAmB;IACtD,OAAO,6BAA6B,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5K,CAAC"}

package/dist/session-management/transfer.d.ts

@@ -0,0 +1,9 @@
+import * as storage from '../storage.js';
+import { type ConversationState } from '../sessions/index.js';
+import { type SessionActionOptions } from './permissions.js';
+export declare function exportSession(cwd: string, id: string, path: string, options?: SessionActionOptions): Promise<string>;
+export declare function importSession(cwd: string, path: string, options?: SessionActionOptions): Promise<{
+    session: storage.Session;
+    state: ConversationState;
+}>;
+//# sourceMappingURL=transfer.d.ts.map

package/dist/session-management/transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../src/session-management/transfer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AACzC,OAAO,EAAwE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAIpI,OAAO,EAA0B,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGrF,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAK9H;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAkBlK"}

package/dist/session-management/transfer.js

@@ -0,0 +1,39 @@
+import { realpathSync } from 'node:fs';
+import * as storage from '../storage.js';
+import { makeBundle, readToolState, toolStateHash, parseBundle, installBundle } from '../sessions/index.js';
+import { throwIfCancelled } from '../cancellation.js';
+import { RunLog } from '../runlog.js';
+import { sessionHistory, selectSession } from './actions.js';
+import { authorizeSessionAction } from './permissions.js';
+import { readSessionTransfer, writeSessionTransfer } from './files.js';
+export async function exportSession(cwd, id, path, options = {}) {
+    const session = selectSession(id, cwd), log = options.runlog ?? RunLog.open(session.id);
+    const replay = await sessionHistory(session.id, undefined, options.signal);
+    const bundle = makeBundle(replay, readToolState(storage.getSessionDirById(session.id)));
+    return writeSessionTransfer(cwd, path, JSON.stringify(bundle) + '\n', { ...options, runlog: log });
+}
+export async function importSession(cwd, path, options = {}) {
+    const root = realpathSync(cwd), text = await readSessionTransfer(root, path, options);
+    const { bundle } = await parseBundle(text, options.signal);
+    await authorizeSessionAction(root, 'session_import', { path: root, source: bundle.source, checksum: bundle.checksum }, options);
+    throwIfCancelled(options.signal);
+    const session = storage.createSession(root, { activate: false, lineage: { version: 1, toolStateHash: toolStateHash(bundle.toolState), kind: 'import', ...bundle.source, at: new Date().toISOString() } });
+    const log = RunLog.open(session.id);
+    try {
+        const replay = await installBundle(storage.getSessionDirById(session.id), session.id, text, options.signal);
+        storage.updateSessionSummary(session.id, replay.snapshot);
+        log.policyEvent({ tool: 'session_import', source: 'session-history', decision: 'allow', durationMs: 0,
+            reason: `source=${bundle.source.sessionId} revision=${bundle.source.revision} checksum=${bundle.checksum}` });
+        return { session: { ...session, messageCount: replay.snapshot.messages.length }, state: replay.snapshot };
+    }
+    catch (error) {
+        log.policyEvent({ tool: 'session_import', source: 'session-history', decision: 'deny', durationMs: 0, reason: 'Import failed; inactive partial session preserved.' });
+        if (options.signal?.aborted)
+            throw error;
+        throw new Error(`Import failed; inactive partial session ${session.id} was preserved. Retry into a new session.`);
+    }
+    finally {
+        await log.flush();
+    }
+}
+//# sourceMappingURL=transfer.js.map

package/dist/session-management/transfer.js.map

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

package/dist/sessions/context.d.ts

@@ -0,0 +1,4 @@
+/** Pin legacy session-scoped tools to the calling runtime, including parallel turns. */
+export declare function withSession<T>(id: string, action: () => T): T;
+export declare function activeSessionId(): string | undefined;
+//# sourceMappingURL=context.d.ts.map

package/dist/sessions/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/sessions/context.ts"],"names":[],"mappings":"AAGA,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAoC;AAClG,wBAAgB,eAAe,IAAI,MAAM,GAAG,SAAS,CAA+B"}

package/dist/sessions/context.js

@@ -0,0 +1,6 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+const session = new AsyncLocalStorage();
+/** Pin legacy session-scoped tools to the calling runtime, including parallel turns. */
+export function withSession(id, action) { return session.run(id, action); }
+export function activeSessionId() { return session.getStore(); }
+//# sourceMappingURL=context.js.map

package/dist/sessions/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/sessions/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAU,CAAC;AAChD,wFAAwF;AACxF,MAAM,UAAU,WAAW,CAAI,EAAU,EAAE,MAAe,IAAO,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAClG,MAAM,UAAU,eAAe,KAAyB,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC"}

package/dist/sessions/format.d.ts

@@ -0,0 +1,38 @@
+import type { Message } from '../types.js';
+export declare const MAX_SNAPSHOT_BYTES: number;
+export declare const MAX_SNAPSHOT_MESSAGES = 10000;
+export type RecoveryStatus = 'active' | 'completed' | 'cancelled' | 'interrupted' | 'waiting_for_user';
+export interface ConversationState {
+    revision: string | null;
+    messages: Message[];
+    status: RecoveryStatus;
+    droppedMessages: number;
+    history?: {
+        id: string;
+        hash: string;
+        sessionId: string;
+    };
+}
+export interface ConversationSnapshot extends ConversationState {
+    version: 1;
+    sessionId: string;
+    revision: string;
+    updatedAt: string;
+    checksum: string;
+}
+export declare class SessionRecoveryError extends Error {
+    readonly code: 'invalid' | 'conflict' | 'locked' | 'io';
+    constructor(code: 'invalid' | 'conflict' | 'locked' | 'io', message: string);
+}
+export declare const invalid: () => SessionRecoveryError;
+export declare const hash: (text: string) => string;
+export declare const object: (v: unknown) => v is Record<string, unknown>;
+export declare const statuses: RecoveryStatus[];
+/** Keep protocol-owned JSON opaque, while rejecting lossy or unbounded values. */
+export declare function validateMessages(value: unknown): asserts value is Message[];
+/** The count is a soft boundary: retain the initial system message and whole tool groups. */
+export declare function retainMessages(messages: Message[], cap: number): Message[];
+export declare function readPrivateSessionFile(file: string, limit?: number): string | null;
+/** A session directory must be a real, immediate child of the configured store. */
+export declare function assertSessionDirectory(dir: string): void;
+//# sourceMappingURL=format.d.ts.map

package/dist/sessions/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/sessions/format.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,eAAO,MAAM,kBAAkB,QAAmB,CAAC;AACnD,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAC3C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,GAAG,kBAAkB,CAAC;AACvG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AACD,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,qBAAa,oBAAqB,SAAQ,KAAK;aACjB,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,IAAI;IAA1E,YAA4B,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,EAE1F;CACF;AACD,eAAO,MAAM,OAAO,4BAAwI,CAAC;AAC7J,eAAO,MAAM,IAAI,SAAU,MAAM,WAAoD,CAAC;AACtF,eAAO,MAAM,MAAM,MAAO,OAAO,KAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAsD,CAAC;AACtH,eAAO,MAAM,QAAQ,EAAE,cAAc,EAA4E,CAAC;AAElH,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,EAAE,CAoC3E;AAED,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,EAAE,CAO1E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAqB,GAAG,MAAM,GAAG,IAAI,CAa9F;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIxD"}