skein-cli 0.1.0-alpha.1

package/dist/commands/trace.js.map

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

package/dist/commands/view.d.ts

@@ -0,0 +1,13 @@
+import type { Command } from 'commander';
+import { type SessionRow } from '../conv/search.js';
+import type { Memory } from '../schema/memory.js';
+import type { ConvEvent } from '../schema/conv.js';
+/** One-line label for a captured session in the picker. */
+export declare function formatSessionLabel(s: SessionRow): string;
+/** One-line label for a memory in the picker. */
+export declare function formatMemoryLabel(m: Memory): string;
+/** Render a captured session's events into a readable transcript string. */
+export declare function renderSessionTranscript(events: readonly ConvEvent[]): string;
+/** Render the detail view of a single memory. */
+export declare function renderMemoryDetail(m: Memory): string;
+export declare function registerView(program: Command): void;

package/dist/commands/view.js

@@ -0,0 +1,184 @@
+import { promises as fs } from 'node:fs';
+import { select } from '@inquirer/prompts';
+import chalk from 'chalk';
+import { listAllSessions } from '../conv/search.js';
+import { readMemories } from '../memory/store.js';
+import { box, kvTable } from '../ui/index.js';
+import { log } from '../util/log.js';
+const BACK = '__back__';
+const QUIT = '__quit__';
+function shortDate(iso) {
+    if (!iso)
+        return '—';
+    return iso.slice(0, 10);
+}
+function truncate(text, max) {
+    const oneLine = text.replace(/\s+/g, ' ').trim();
+    return oneLine.length > max ? `${oneLine.slice(0, max - 1)}…` : oneLine;
+}
+/** One-line label for a captured session in the picker. */
+export function formatSessionLabel(s) {
+    const title = s.title ? truncate(s.title, 48) : chalk.dim('(untitled)');
+    const model = s.model ? `/${s.model}` : '';
+    const meta = chalk.dim(`${shortDate(s.startedAt)} · ${s.tool}${model} · ${s.messageCount} msg`);
+    return `${title}  ${meta}`;
+}
+/** One-line label for a memory in the picker. */
+export function formatMemoryLabel(m) {
+    const tags = m.tags.length ? chalk.dim(` [${m.tags.slice(0, 3).join(', ')}]`) : '';
+    const meta = chalk.dim(`${shortDate(m.updatedAt)} · ${m.scope} · ${m.provenance.sourceTool}`);
+    return `${truncate(m.fact, 56)}${tags}  ${meta}`;
+}
+function roleLabel(role) {
+    if (role === 'user')
+        return chalk.cyan('▸ user');
+    if (role === 'assistant')
+        return chalk.green('▸ assistant');
+    return chalk.yellow(`▸ ${role}`);
+}
+/** Render a captured session's events into a readable transcript string. */
+export function renderSessionTranscript(events) {
+    const lines = [];
+    for (const e of events) {
+        if (e.type !== 'message')
+            continue;
+        const parts = [];
+        for (const block of e.content) {
+            if (block.type === 'text')
+                parts.push(block.text);
+            else if (block.type === 'thinking')
+                parts.push(chalk.dim(`(thinking) ${block.thinking}`));
+            else if (block.type === 'tool_use')
+                parts.push(chalk.magenta(`🔧 ${block.name}`));
+            else if (block.type === 'tool_result') {
+                const body = typeof block.content === 'string' ? block.content : JSON.stringify(block.content);
+                parts.push(chalk.dim(`↳ ${truncate(body, 200)}`));
+            }
+        }
+        const body = parts.join('\n').trim();
+        if (!body)
+            continue;
+        lines.push(`${roleLabel(e.role)}  ${chalk.dim(e.ts.slice(11, 19))}`);
+        lines.push(body);
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd() || chalk.dim('(no renderable messages)');
+}
+/** Render the detail view of a single memory. */
+export function renderMemoryDetail(m) {
+    return kvTable([
+        { label: 'Id', value: chalk.dim(m.id) },
+        { label: 'Scope', value: m.scope },
+        { label: 'Source', value: chalk.dim(m.provenance.sourceTool) },
+        { label: 'Tags', value: m.tags.length ? m.tags.join(', ') : chalk.dim('—') },
+        { label: 'Updated', value: chalk.dim(shortDate(m.updatedAt)) },
+    ]);
+}
+async function readSessionEvents(path) {
+    const raw = await fs.readFile(path, 'utf8');
+    const out = [];
+    for (const line of raw.split('\n')) {
+        if (!line.trim())
+            continue;
+        try {
+            out.push(JSON.parse(line));
+        }
+        catch {
+            // skip malformed lines
+        }
+    }
+    return out;
+}
+async function browseConversations() {
+    const sessions = await listAllSessions();
+    if (sessions.length === 0) {
+        log.info('No captured conversations yet. Run `skein wrap <tool>` or `skein conv watch`.');
+        return;
+    }
+    while (true) {
+        const choice = await select({
+            message: `Conversations (${sessions.length})`,
+            pageSize: 15,
+            choices: [
+                ...sessions.map(s => ({ name: formatSessionLabel(s), value: s.id })),
+                { name: chalk.dim('← back'), value: BACK },
+            ],
+        });
+        if (choice === BACK)
+            return;
+        const session = sessions.find(s => s.id === choice);
+        if (!session)
+            continue;
+        const events = await readSessionEvents(session.path);
+        console.log(box(renderSessionTranscript(events), session.title ?? session.id));
+    }
+}
+async function browseMemory() {
+    const memories = (await readMemories()).sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+    if (memories.length === 0) {
+        log.info('No captured memory yet. Run `skein memory capture --tool <tool>`.');
+        return;
+    }
+    while (true) {
+        const choice = await select({
+            message: `Memory (${memories.length})`,
+            pageSize: 15,
+            choices: [
+                ...memories.map(m => ({ name: formatMemoryLabel(m), value: m.id })),
+                { name: chalk.dim('← back'), value: BACK },
+            ],
+        });
+        if (choice === BACK)
+            return;
+        const memory = memories.find(m => m.id === choice);
+        if (!memory)
+            continue;
+        console.log(box(renderMemoryDetail(memory), 'Memory'));
+        console.log(box(memory.fact, 'Fact'));
+    }
+}
+/** Non-interactive fallback when stdout isn't a TTY (pipes, CI). */
+async function printSummary() {
+    const [sessions, memories] = await Promise.all([listAllSessions(), readMemories()]);
+    console.log(box(kvTable([
+        { label: 'Conversations', value: chalk.green(String(sessions.length)) },
+        { label: 'Memories', value: chalk.green(String(memories.length)) },
+    ]), 'skein view'));
+    console.log(chalk.dim('Run in an interactive terminal to browse and drill in.'));
+}
+export function registerView(program) {
+    program
+        .command('view')
+        .description('interactively browse captured conversations and memory')
+        .action(async () => {
+        if (!process.stdout.isTTY) {
+            await printSummary();
+            return;
+        }
+        try {
+            while (true) {
+                const top = await select({
+                    message: 'What do you want to explore?',
+                    choices: [
+                        { name: '💬 Conversations', value: 'conv' },
+                        { name: '🧠 Memory', value: 'memory' },
+                        { name: chalk.dim('Quit'), value: QUIT },
+                    ],
+                });
+                if (top === QUIT)
+                    return;
+                if (top === 'conv')
+                    await browseConversations();
+                else if (top === 'memory')
+                    await browseMemory();
+            }
+        }
+        catch (err) {
+            // Ctrl-C / ESC throw ExitPromptError — treat as a clean exit.
+            if (err instanceof Error && err.name === 'ExitPromptError')
+                return;
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=view.js.map

package/dist/commands/view.js.map

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

package/dist/commands/watch.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+/**
+ * Registers `skein conv watch` as a subcommand of `conv`. Invoked from
+ * src/commands/conv.ts so it sits alongside list/search/stats etc.
+ */
+export declare function registerConvWatch(conv: Command): void;

package/dist/commands/watch.js

@@ -0,0 +1,61 @@
+import chalk from 'chalk';
+import { Watcher } from '../conv/watcher.js';
+import { box, kvTable } from '../ui/index.js';
+import { spinner } from '../ui/spinner.js';
+import { log } from '../util/log.js';
+import { getToolPaths } from '../util/paths.js';
+/**
+ * Registers `skein conv watch` as a subcommand of `conv`. Invoked from
+ * src/commands/conv.ts so it sits alongside list/search/stats etc.
+ */
+export function registerConvWatch(conv) {
+    conv
+        .command('watch')
+        .description('long-running daemon that streams new conversation events from disk')
+        .option('--tool <tool>', 'restrict to one source (claude-code, codex, opencode, aider)')
+        .option('--project <path>', 'project path (used by aider source)')
+        .option('--interval <ms>', 'poll interval in milliseconds', '1000')
+        .action(async (opts) => {
+        const paths = getToolPaths();
+        const sources = opts.tool ? [opts.tool] : undefined;
+        const watcher = new Watcher({
+            homeDir: paths.homeDir,
+            ...(sources ? { sources } : {}),
+            ...(opts.project ? { projectPath: opts.project } : {}),
+            intervalMs: Number(opts.interval),
+        });
+        const s = spinner(`Watching ${chalk.cyan(opts.tool ?? 'all sources')} — Ctrl+C to stop`);
+        await watcher.start();
+        const onStop = async (signal) => {
+            s.stop();
+            await watcher.stop();
+            const tallies = watcher.tallies();
+            const total = tallies.reduce((acc, t) => acc + t.events, 0);
+            console.log('');
+            console.log(box(kvTable([
+                { label: 'Signal', value: chalk.dim(signal) },
+                {
+                    label: 'Sources',
+                    value: tallies.map(t => t.source).join(', ') || chalk.dim('(none active)'),
+                },
+                ...tallies.map(t => ({
+                    label: `   ${t.source}`,
+                    value: chalk.green(`${t.events} event${t.events === 1 ? '' : 's'}`),
+                })),
+                { label: 'Total events', value: chalk.green(String(total)) },
+            ]), 'Watcher stopped'));
+            log.info(chalk.dim(`Streams flushed to ${paths.skeinDir}/conv/sessions/`));
+            process.exit(0);
+        };
+        process.on('SIGINT', () => void onStop('SIGINT'));
+        process.on('SIGTERM', () => void onStop('SIGTERM'));
+        // Periodically refresh the spinner text so the user sees live progress.
+        const heartbeat = setInterval(() => {
+            const tallies = watcher.tallies();
+            const total = tallies.reduce((acc, t) => acc + t.events, 0);
+            s.update(`Watching ${chalk.cyan(opts.tool ?? 'all sources')} — ${chalk.green(`${total} event${total === 1 ? '' : 's'}`)} captured (Ctrl+C to stop)`);
+        }, 1_500);
+        heartbeat.unref?.();
+    });
+}
+//# sourceMappingURL=watch.js.map

package/dist/commands/watch.js.map

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

package/dist/commands/wrap.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerWrap(program: Command): void;

package/dist/commands/wrap.js

@@ -0,0 +1,131 @@
+import { spawn } from 'node:child_process';
+import { createWriteStream } from 'node:fs';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import chalk from 'chalk';
+import { startProxy } from '../proxy/http.js';
+import { ensureDir } from '../util/fs.js';
+import { log } from '../util/log.js';
+import { getToolPaths, SKEIN_SUBDIRS } from '../util/paths.js';
+import { CONV_SCHEMA } from '../version.js';
+import { box, kvTable } from '../ui/index.js';
+export function registerWrap(program) {
+    program
+        .command('wrap')
+        .description('Run a tool behind the Skein LLM proxy and capture every API turn')
+        .argument('<command...>', 'command and args to launch (e.g. claude, codex, aider)')
+        .option('--tool <name>', 'tool name to record in skein-conv events', 'unknown')
+        .option('--title <title>', 'optional session title')
+        .allowUnknownOption(true)
+        .action(async (commandParts, opts) => {
+        const sessionId = randomUUID();
+        const startedAt = new Date().toISOString();
+        const paths = getToolPaths();
+        const sessionPath = await prepareSessionFile(paths.skeinDir, sessionId, startedAt);
+        const stream = createWriteStream(sessionPath, { flags: 'w' });
+        let eventCount = 0;
+        const writeEvent = (event) => new Promise((resolve, reject) => {
+            stream.write(`${JSON.stringify(event)}\n`, err => (err ? reject(err) : resolve()));
+        });
+        const title = opts.title ?? commandParts.join(' ');
+        // Provider/model/effort are only known once the proxy sees live traffic,
+        // so session.start is written lazily with the first turn's harness metadata.
+        const sessionMeta = {};
+        let sessionStarted = false;
+        const ensureSessionStart = async () => {
+            if (sessionStarted)
+                return;
+            sessionStarted = true;
+            await writeEvent({
+                type: 'session.start',
+                id: sessionId,
+                tool: opts.tool,
+                title,
+                project: process.cwd(),
+                ...(sessionMeta.provider ? { provider: sessionMeta.provider } : {}),
+                ...(sessionMeta.model ? { model: sessionMeta.model } : {}),
+                ...(sessionMeta.effort ? { effort: sessionMeta.effort } : {}),
+                schema: CONV_SCHEMA,
+                ts: startedAt,
+            });
+        };
+        const proxy = await startProxy({
+            sessionId,
+            tool: opts.tool,
+            project: process.cwd(),
+            onTurnMeta(meta) {
+                if (meta.provider && !sessionMeta.provider)
+                    sessionMeta.provider = meta.provider;
+                if (meta.model && !sessionMeta.model)
+                    sessionMeta.model = meta.model;
+                if (meta.effort && !sessionMeta.effort)
+                    sessionMeta.effort = meta.effort;
+            },
+            async onEvent(event) {
+                await ensureSessionStart();
+                eventCount++;
+                await writeEvent(event);
+            },
+        });
+        const [cmd, ...cmdArgs] = commandParts;
+        if (!cmd) {
+            log.error('No command given to wrap');
+            await proxy.close();
+            stream.end();
+            process.exit(2);
+        }
+        console.log(box(kvTable([
+            { label: 'Tool', value: chalk.cyan(opts.tool) },
+            { label: 'Command', value: chalk.dim(commandParts.join(' ')) },
+            { label: 'Proxy', value: chalk.dim(proxy.url) },
+            { label: 'Session', value: chalk.dim(sessionId) },
+            { label: 'Recording to', value: chalk.dim(sessionPath) },
+        ]), 'skein wrap'));
+        const child = spawn(cmd, cmdArgs, {
+            stdio: 'inherit',
+            env: {
+                ...process.env,
+                ANTHROPIC_BASE_URL: proxy.url,
+                OPENAI_BASE_URL: proxy.url,
+                OPENAI_API_BASE: proxy.url,
+                SKEIN_PROXY_URL: proxy.url,
+                SKEIN_SESSION_ID: sessionId,
+                SKEIN_WRAP_TOOL: opts.tool,
+            },
+        });
+        const exitCode = await new Promise(resolve => {
+            child.on('exit', code => resolve(code ?? 0));
+            child.on('error', err => {
+                log.error(`Wrapped command failed to start: ${err.message}`);
+                resolve(127);
+            });
+            const forward = (signal) => () => child.kill(signal);
+            process.once('SIGINT', forward('SIGINT'));
+            process.once('SIGTERM', forward('SIGTERM'));
+        });
+        await ensureSessionStart();
+        await writeEvent({ type: 'session.end', session: sessionId, ts: new Date().toISOString() });
+        await new Promise(resolve => stream.end(resolve));
+        await proxy.close();
+        console.log('');
+        console.log(box(kvTable([
+            { label: 'Exit code', value: String(exitCode) },
+            { label: 'Events recorded', value: chalk.green(String(eventCount)) },
+            { label: 'Session file', value: chalk.dim(sessionPath) },
+        ]), 'Capture complete'));
+        process.exit(exitCode);
+    });
+}
+async function prepareSessionFile(skeinDir, sessionId, startedAt) {
+    const monthSlug = monthFromIso(startedAt);
+    const dir = join(skeinDir, SKEIN_SUBDIRS.convSessions, monthSlug);
+    await ensureDir(dir);
+    return join(dir, `${sessionId}.jsonl`);
+}
+function monthFromIso(iso) {
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime()))
+        return 'unknown';
+    return `${d.getUTCFullYear()}/${String(d.getUTCMonth() + 1).padStart(2, '0')}`;
+}
+//# sourceMappingURL=wrap.js.map

package/dist/commands/wrap.js.map

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

package/dist/conv/chatgpt-import.d.ts

@@ -0,0 +1,33 @@
+import { Buffer } from 'node:buffer';
+/**
+ * Importer for OpenAI ChatGPT account-data exports.
+ *
+ * The export ZIP holds (among other artefacts) `conversations.json` — an
+ * array of conversation objects. Each conversation has:
+ *
+ *   - title           : string
+ *   - create_time     : number (epoch seconds)
+ *   - mapping         : record of nodeId → { id, parent, children[], message? }
+ *   - default_model_slug? : string
+ *   - current_node    : id of the leaf in the active branch
+ *
+ * Each node holds a `message` with `author.role`, `content.parts[]` (or
+ * `content.text`), `create_time`, and `metadata.model_slug`. To
+ * reconstruct chronological turns we walk parent→children starting from
+ * the root and emit each non-empty message as a Skein event.
+ */
+export interface ImportZipOptions {
+    zipPath?: string;
+    zipBuffer?: Buffer;
+    /** Optional tool name override (default: "chatgpt"). */
+    tool?: string;
+    /** Optional cap on how many conversations to import. */
+    limit?: number;
+}
+export interface ImportZipResult {
+    conversationsSeen: number;
+    sessionsWritten: number;
+    eventsWritten: number;
+    sessionIds: string[];
+}
+export declare function importChatgptZip(opts: ImportZipOptions): Promise<ImportZipResult>;

package/dist/conv/chatgpt-import.js

@@ -0,0 +1,145 @@
+import { findEntriesByExt, findEntry, parseZip, readZipFile } from './zip.js';
+import { JsonlSink } from './sink.js';
+export async function importChatgptZip(opts) {
+    const entries = await loadEntries(opts);
+    const conversations = readConversationsJson(entries);
+    const sink = new JsonlSink();
+    let conversationsSeen = 0;
+    let sessionsWritten = 0;
+    let eventsWritten = 0;
+    const sessionIds = [];
+    try {
+        for (const conv of conversations) {
+            conversationsSeen += 1;
+            if (opts.limit !== undefined && conversationsSeen > opts.limit)
+                break;
+            const turns = walkMapping(conv);
+            if (turns.length === 0)
+                continue;
+            const startedAt = conv.create_time
+                ? new Date(conv.create_time * 1000).toISOString()
+                : (turns[0]?.ts ?? new Date().toISOString());
+            const sessionId = `chatgpt-${conv.id ?? conv.conversation_id ?? slug(conv.title ?? 'untitled')}`;
+            const model = conv.default_model_slug ?? conv.model_slug ?? turns[0]?.model;
+            await sink.openSession(sessionId, {
+                tool: opts.tool ?? 'chatgpt',
+                ...(model ? { model } : {}),
+                title: conv.title ?? 'Untitled chat',
+                startedAt,
+            });
+            let seq = 0;
+            for (const turn of turns) {
+                seq += 1;
+                await sink.write(sessionId, {
+                    type: 'message',
+                    session: sessionId,
+                    seq,
+                    role: turn.role,
+                    content: turn.content,
+                    ts: turn.ts,
+                });
+                eventsWritten += 1;
+            }
+            await sink.write(sessionId, { type: 'session.end', session: sessionId, ts: startedAt });
+            sessionsWritten += 1;
+            sessionIds.push(sessionId);
+        }
+    }
+    finally {
+        await sink.closeAll();
+    }
+    return { conversationsSeen, sessionsWritten, eventsWritten, sessionIds };
+}
+async function loadEntries(opts) {
+    if (opts.zipBuffer)
+        return parseZip(opts.zipBuffer);
+    if (opts.zipPath)
+        return readZipFile(opts.zipPath);
+    throw new Error('importChatgptZip: pass either zipBuffer or zipPath');
+}
+function readConversationsJson(entries) {
+    const direct = findEntry(entries, 'conversations.json');
+    if (direct)
+        return parseConversations(direct.body.toString('utf8'));
+    const nested = findEntriesByExt(entries, 'conversations.json');
+    if (nested.length > 0 && nested[0])
+        return parseConversations(nested[0].body.toString('utf8'));
+    throw new Error('importChatgptZip: conversations.json not found in archive');
+}
+function parseConversations(raw) {
+    const parsed = JSON.parse(raw);
+    if (Array.isArray(parsed))
+        return parsed;
+    return parsed?.conversations ?? [];
+}
+function walkMapping(conv) {
+    const mapping = conv.mapping ?? {};
+    const roots = Object.values(mapping).filter(n => !n.parent);
+    const ordered = [];
+    const visit = (node) => {
+        if (!node)
+            return;
+        ordered.push(node);
+        for (const childId of node.children ?? [])
+            visit(mapping[childId]);
+    };
+    for (const root of roots)
+        visit(root);
+    const turns = [];
+    for (const node of ordered) {
+        const message = node.message;
+        if (!message)
+            continue;
+        const role = mapRole(message.author?.role);
+        if (!role)
+            continue;
+        const text = extractText(message.content);
+        if (!text)
+            continue;
+        turns.push({
+            role,
+            content: [{ type: 'text', text }],
+            ts: message.create_time
+                ? new Date(message.create_time * 1000).toISOString()
+                : new Date().toISOString(),
+            ...(message.metadata?.model_slug ? { model: message.metadata.model_slug } : {}),
+        });
+    }
+    return turns;
+}
+function mapRole(raw) {
+    if (raw === 'user')
+        return 'user';
+    if (raw === 'assistant')
+        return 'assistant';
+    if (raw === 'system' || raw === 'tool')
+        return 'system';
+    return undefined;
+}
+function extractText(content) {
+    if (!content)
+        return undefined;
+    if (typeof content.text === 'string')
+        return content.text.trim() || undefined;
+    const parts = content.parts ?? [];
+    const text = parts
+        .map(p => {
+        if (typeof p === 'string')
+            return p;
+        if (p && typeof p === 'object' && 'text' in p) {
+            return String(p['text'] ?? '');
+        }
+        return '';
+    })
+        .join('\n')
+        .trim();
+    return text.length > 0 ? text : undefined;
+}
+function slug(input) {
+    return input
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 32);
+}
+//# sourceMappingURL=chatgpt-import.js.map

package/dist/conv/chatgpt-import.js.map

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