dexto 2.0.0-beta.0 → 2.0.0-beta.1

package/dist/cli/commands/auth/sign-in-commands.js

@@ -1,6 +1,7 @@
 // `dexto login`, `logout`, `whoami` and `accounts`: signing in to Dexto and the saved profiles.
+import { CommandFailure } from '../../failure.js';
 import { dextoAccounts } from '@dexto/agent-management';
-import { CommandFailure, UsageError } from '../../cloud/command.js';
+import { UsageError } from '../../cloud/command.js';
 const { DEFAULT_PROFILE, forgetLogin, listAccounts: readAccounts, profileNameFor, readCurrentProfile, readLogin, requireProfileName, resolveCredential, resolveProfile, writeCurrentProfile, writeLogin, } = dextoAccounts;
 export async function login(context, options) {
     const named = options.profile ?? nonEmpty(context.environment.DEXTO_PROFILE);

package/dist/cli/commands/cloud/register.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cloud/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBzC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuB3D"}
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cloud/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBzC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuB3D"}

package/dist/cli/commands/cloud/register.js

@@ -13,6 +13,8 @@ const ENGINE_WORDS = {
     publish: 'Publish a file, folder or .zip as a link anyone with it can open',
     profile: 'Show and change your Dexto profile: handle, name, bio and who can see it',
     skills: 'Push a local Skill folder into your Dexto Skills library',
+    trace: "List your run traces and show one run's trace from Dexto",
+    span: "List one run's spans from Dexto",
 };
 /**
  * These words run on the cloud command engine, which reads its own arguments and global options

package/dist/cli/commands/run/headless.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/run/headless.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,UAAU,EAIlB,MAAM,aAAa,CAAC;AAErB,OAAO,EAGH,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EAC5B,MAAM,aAAa,CAAC;AAWrB,MAAM,MAAM,iBAAiB,GAAG;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,gBAAgB,CAAC,EAAE,wBAAwB,EAAE,CAAC;CACjD,CAAC;AA0IF,wBAAsB,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAY/E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAgC/D;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC5C,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACtB,GAAG,IAAI,CAgBP;AAED,wBAAsB,kBAAkB,CACpC,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,oBAA6B,GACtC,OAAO,CAAC,iBAAiB,CAAC,CAmI5B;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAM1F;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAM/D;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAExD"}
+{"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/run/headless.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,UAAU,EAIlB,MAAM,aAAa,CAAC;AAErB,OAAO,EAGH,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EAC5B,MAAM,aAAa,CAAC;AAarB,MAAM,MAAM,iBAAiB,GAAG;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,gBAAgB,CAAC,EAAE,wBAAwB,EAAE,CAAC;CACjD,CAAC;AA+IF,wBAAsB,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAY/E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CA2C/D;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC5C,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACtB,GAAG,IAAI,CAqBP;AAED,wBAAsB,kBAAkB,CACpC,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,oBAA6B,GACtC,OAAO,CAAC,iBAAiB,CAAC,CAkK5B;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAc1F;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAM/D;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAExD"}

package/dist/cli/commands/run/headless.js

@@ -1,5 +1,7 @@
 import { isTextPart, safeStringify, } from '@dexto/core';
 import { writeHeadlessEvent, toHeadlessApprovalRequired, } from './output.js';
+import { finishedToolStep } from '@dexto/tui/tool-step';
+import { logLine, startLine, stepLine, stepLogEnabled } from './step-log.js';
 const HEADLESS_TOOL_OUTPUT_MAX_LINES = 20;
 const HEADLESS_SECTION_SEPARATOR = '========================================';
 function writeHeadlessLine(line = '') {
@@ -9,6 +11,11 @@ function writeHeadlessSeparator() {
     writeHeadlessLine(HEADLESS_SECTION_SEPARATOR);
 }
 function writeHeadlessTaggedLine(tag, message) {
+    if (stepLogEnabled()) {
+        const error = tag === 'ERROR';
+        writeHeadlessLine(logLine(tag.toLowerCase(), message, { error }));
+        return;
+    }
     writeHeadlessLine(`[${tag}] ${message}`);
 }
 function writeHeadlessTaggedBlock(tag, content) {
@@ -123,6 +130,16 @@ export async function resolveHeadlessPrompt(promptArg) {
 }
 export function printHeadlessMcpStartup(agent) {
     const serverStatuses = agent.getMcpServersWithStatus().filter((server) => server.enabled);
+    if (stepLogEnabled()) {
+        for (const server of serverStatuses) {
+            if (server.status === 'connected')
+                continue;
+            writeHeadlessLine(logLine('mcp', `${server.name} failed: ${server.error ?? server.status}`, {
+                error: true,
+            }));
+        }
+        return;
+    }
     if (serverStatuses.length === 0) {
         writeHeadlessTaggedLine('MCP', 'startup: no servers');
         return;
@@ -151,6 +168,10 @@ export function printHeadlessMcpStartup(agent) {
 export function printHeadlessRunSummary(params) {
     const { agent, sessionId, prompt, agentPath, cliVersion } = params;
     const llmConfig = agent.getCurrentLLMConfig(sessionId);
+    if (stepLogEnabled()) {
+        writeHeadlessLine(startLine(`${llmConfig.provider}/${llmConfig.model}`, sessionId));
+        return;
+    }
     writeHeadlessSeparator();
     writeHeadlessTaggedLine('RUN', `Dexto CLI v${cliVersion}`);
     writeHeadlessSeparator();
@@ -179,6 +200,10 @@ export async function executeHeadlessRun(agent, sessionId, prompt, format = 'tex
                 case 'approval:request': {
                     const required = toHeadlessApprovalRequired(event);
                     approvalRequired.push(required);
+                    if (stepLogEnabled()) {
+                        writeHeadlessLine(logLine('denied', `${'tool_name' in required ? required.tool_name : required.approval_type} · ${required.message} · approval ${required.approval_id}`, { error: false }));
+                        break;
+                    }
                     writeHeadlessTaggedLine('APPROVAL_REQUIRED', `${'tool_name' in required ? required.tool_name : required.approval_type}: ${required.message} (approval ${required.approval_id})`);
                     break;
                 }
@@ -190,6 +215,8 @@ export async function executeHeadlessRun(agent, sessionId, prompt, format = 'tex
                         startedAt: Date.now(),
                     };
                     toolCallState.set(callKey, call);
+                    if (stepLogEnabled())
+                        break;
                     writeHeadlessTaggedLine('TOOL', formatToolInvocationForHeadless(call.toolName, call.args));
                     break;
                 }
@@ -215,6 +242,27 @@ export async function executeHeadlessRun(agent, sessionId, prompt, format = 'tex
                     }
                     const toolName = matchedCall?.toolName ?? event.toolName;
                     const args = matchedCall?.args ?? {};
+                    if (stepLogEnabled()) {
+                        const display = event.sanitized?.meta.display;
+                        const { step, output } = finishedToolStep({
+                            toolName,
+                            args,
+                            success: event.success,
+                            rawResult: event.rawResult,
+                            ...(event.error !== undefined && { error: event.error }),
+                            ...(event.presentationSnapshot !== undefined && {
+                                presentationSnapshot: event.presentationSnapshot,
+                            }),
+                            ...(display !== undefined && { display }),
+                        });
+                        writeHeadlessLine(stepLine(step));
+                        for (const line of output) {
+                            writeHeadlessLine(logLine('', line, { error: true }));
+                        }
+                        if (matchedCallKey)
+                            toolCallState.delete(matchedCallKey);
+                        break;
+                    }
                     const invocation = formatToolInvocationForHeadless(toolName, args);
                     const durationText = matchedCall
                         ? ` in ${formatHeadlessDuration(Date.now() - matchedCall.startedAt)}`
@@ -279,6 +327,13 @@ export async function executeHeadlessRun(agent, sessionId, prompt, format = 'tex
     return result;
 }
 export function printHeadlessAssistantResponse(message, totalTokens) {
+    if (stepLogEnabled()) {
+        const tokens = typeof totalTokens === 'number'
+            ? `${new Intl.NumberFormat('en-US').format(totalTokens)} tokens`
+            : 'finished';
+        writeHeadlessLine(logLine('done', tokens, { error: false }));
+        return;
+    }
     writeHeadlessSeparator();
     writeHeadlessTaggedBlock('DEXTO', message);
     if (typeof totalTokens === 'number') {

package/dist/cli/commands/run/step-log.d.ts

@@ -0,0 +1,11 @@
+import type { Step } from '@dexto/tui/tool-step';
+export declare function stepLogEnabled(): boolean;
+/** A line that isn't a tool call: start, done, an error. */
+export declare function logLine(word: string, text: string, { error, at }: {
+    error: boolean;
+    at?: Date;
+}): string;
+export declare function startLine(model: string, chatId: string, at?: Date): string;
+/** One finished tool call as one line: verb, target, detail, time, state. */
+export declare function stepLine(step: Step, at?: Date): string;
+//# sourceMappingURL=step-log.d.ts.map

package/dist/cli/commands/run/step-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-log.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/run/step-log.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAMjD,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAMD,4DAA4D;AAC5D,wBAAgB,OAAO,CACnB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,EAAE,KAAK,EAAE,EAAe,EAAE,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,IAAI,CAAA;CAAE,GAC1D,MAAM,CAGR;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,GAAE,IAAiB,GAAG,MAAM,CAEtF;AASD,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,GAAE,IAAiB,GAAG,MAAM,CAWlE"}

package/dist/cli/commands/run/step-log.js

@@ -0,0 +1,42 @@
+/**
+ * The Signal log `dexto run` writes to stderr at a terminal: one time-stamped line per step, in
+ * the same words as the TUI's step rows. On until the Signal look ships only with
+ * DEXTO_PALETTE=signal; the bracketed tags stay the default until then.
+ */
+import { chalkStderr as chalk } from 'chalk';
+const VERB_CELLS = 7;
+const TARGET_CELLS = 30;
+const DETAIL_CELLS = 16;
+export function stepLogEnabled() {
+    return process.env.DEXTO_PALETTE === 'signal';
+}
+function clock(at) {
+    return chalk.dim(at.toLocaleTimeString('en-GB', { hour12: false }));
+}
+/** A line that isn't a tool call: start, done, an error. */
+export function logLine(word, text, { error, at = new Date() }) {
+    const label = word.padEnd(VERB_CELLS);
+    return `${clock(at)}  ${error ? chalk.red(label) : chalk.bold(label)} ${text}`;
+}
+export function startLine(model, chatId, at = new Date()) {
+    return logLine('start', `${model} · local · chat ${chatId}`, { error: false, at });
+}
+const STATE_WORD = {
+    ok: 'ok',
+    fail: 'fail',
+    deny: 'denied',
+    stop: 'stopped',
+};
+/** One finished tool call as one line: verb, target, detail, time, state. */
+export function stepLine(step, at = new Date()) {
+    const failed = step.state === 'fail';
+    const word = STATE_WORD[step.state] ?? step.state;
+    return [
+        `${clock(at)} `,
+        chalk.bold(step.verb.toLowerCase().padEnd(VERB_CELLS)),
+        step.target.padEnd(TARGET_CELLS),
+        (step.detail ?? '').padEnd(DETAIL_CELLS),
+        (step.time ?? '').padStart(5),
+        ` ${failed ? chalk.red(word) : chalk.dim(word)}`,
+    ].join(' ');
+}

package/dist/cli/failure.d.ts

@@ -0,0 +1,29 @@
+/** What kind of thing went wrong; each kind has an exit code an agent can branch on. */
+export type FailureKind = 'failed' | 'invalid_input' | 'needs_confirmation' | 'needs_permission' | 'needs_sign_in' | 'not_found' | 'waiting_on_person';
+export declare const EXIT_CODES: {
+    readonly failed: 1;
+    readonly invalid_input: 2;
+    readonly needs_confirmation: 4;
+    readonly needs_permission: 3;
+    readonly needs_sign_in: 3;
+    readonly not_found: 5;
+    readonly waiting_on_person: 6;
+    readonly usage: 2;
+};
+/** What each exit code means; frozen in 2.0 and shown in help. */
+export declare const EXIT_CODE_MEANINGS: {
+    readonly '0': "done";
+    readonly '1': "failed";
+    readonly '2': "usage or invalid input";
+    readonly '3': "needs sign-in or permission";
+    readonly '4': "needs confirmation: pass --yes once your person has agreed";
+    readonly '5': "not found";
+    readonly '6': "waiting on a person, such as an approval";
+};
+/** A failure that says what kind it is and, where there is one, the command that fixes it. */
+export declare class CommandFailure extends Error {
+    readonly fix: string | null;
+    readonly kind: FailureKind;
+    constructor(kind: FailureKind, message: string, fix: string | null);
+}
+//# sourceMappingURL=failure.d.ts.map

package/dist/cli/failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure.d.ts","sourceRoot":"","sources":["../../src/cli/failure.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,MAAM,WAAW,GACjB,QAAQ,GACR,eAAe,GACf,oBAAoB,GACpB,kBAAkB,GAClB,eAAe,GACf,WAAW,GACX,mBAAmB,CAAC;AAE1B,eAAO,MAAM,UAAU;;;;;;;;;CASmC,CAAC;AAE3D,kEAAkE;AAClE,eAAO,MAAM,kBAAkB;;;;;;;;CAQrB,CAAC;AAEX,8FAA8F;AAC9F,qBAAa,cAAe,SAAQ,KAAK;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;gBAEf,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAMrE"}

package/dist/cli/failure.js

@@ -0,0 +1,31 @@
+export const EXIT_CODES = {
+    failed: 1,
+    invalid_input: 2,
+    needs_confirmation: 4,
+    needs_permission: 3,
+    needs_sign_in: 3,
+    not_found: 5,
+    waiting_on_person: 6,
+    usage: 2,
+};
+/** What each exit code means; frozen in 2.0 and shown in help. */
+export const EXIT_CODE_MEANINGS = {
+    '0': 'done',
+    '1': 'failed',
+    '2': 'usage or invalid input',
+    '3': 'needs sign-in or permission',
+    '4': 'needs confirmation: pass --yes once your person has agreed',
+    '5': 'not found',
+    '6': 'waiting on a person, such as an approval',
+};
+/** A failure that says what kind it is and, where there is one, the command that fixes it. */
+export class CommandFailure extends Error {
+    fix;
+    kind;
+    constructor(kind, message, fix) {
+        super(message);
+        this.name = 'CommandFailure';
+        this.fix = fix;
+        this.kind = kind;
+    }
+}

package/dist/cli/help-json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help-json.d.ts","sourceRoot":"","sources":["../../src/cli/help-json.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAM/D;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO;;;;;;;;;;;;;;;;;EAW5C"}
+{"version":3,"file":"help-json.d.ts","sourceRoot":"","sources":["../../src/cli/help-json.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAM/D;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO;;;;;;;;;;;;;;;;;EAW5C"}

package/dist/cli/help-json.js

@@ -1,5 +1,5 @@
 // `dexto --help --json`: the commands and the frozen exit codes, for agents.
-import { EXIT_CODE_MEANINGS } from './cloud/command.js';
+import { EXIT_CODE_MEANINGS } from './failure.js';
 /** `--help` (or `-h`) with `--json`, and nothing else. */
 export function isRootJsonHelp(args) {
     return (args.length === 2 &&

package/dist/cli/import/claude-code.d.ts

@@ -0,0 +1,10 @@
+import { type ParsedChat } from './transcript.js';
+/**
+ * A Claude Code session file: one Agent SDK message per line (`type` `user` or `assistant`, with
+ * Anthropic `message.content`), plus title, `pr-link` and bookkeeping lines. Sidechain (subagent),
+ * meta and compact-summary lines are left out, as is thinking.
+ */
+export declare function parseClaudeCodeTranscript(text: string, file: string): ParsedChat | null;
+/** Where Claude Code keeps its sessions on this machine. */
+export declare function claudeCodeFolder(environment: Readonly<Record<string, string | undefined>>, homeDirectory: string): string;
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/cli/import/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/cli/import/claude-code.ts"],"names":[],"mappings":"AAIA,OAAO,EAUH,KAAK,UAAU,EAClB,MAAM,iBAAiB,CAAC;AAsCzB;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA8DvF;AAiBD,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAC5B,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EACzD,aAAa,EAAE,MAAM,GACtB,MAAM,CAKR"}

package/dist/cli/import/claude-code.js

@@ -0,0 +1,131 @@
+// Reads Claude Code session files: `$CLAUDE_CONFIG_DIR/projects/<dashed-cwd>/<session>.jsonl`.
+import path from 'node:path';
+import { createTurns, finishChat, isRecord, jsonLines, stringField, toolCallText, toolResultText, validTime, } from './transcript.js';
+/** What Claude Code writes as a `user` line but the person never typed: slash commands and their output. */
+const CLAUDE_CODE_INJECTED = /^\s*<(command-name|command-message|local-command-[a-z]+)>/u;
+/**
+ * The title Claude Code shows for a session, in this order: the person's own (`custom-title`, from
+ * renaming it), the one Claude Code generates (`ai-title`, the last one written), then a `summary`
+ * line (Claude Code before 2.1). Null when there is none, and the chat is titled by its first line.
+ */
+class ClaudeCodeTitle {
+    custom = null;
+    generated = null;
+    summary = null;
+    /** Whether the line was a title line. */
+    read(line) {
+        if (line.type === 'custom-title')
+            this.custom = stringField(line, 'customTitle');
+        else if (line.type === 'ai-title')
+            this.generated = stringField(line, 'aiTitle');
+        else if (line.type === 'summary')
+            this.summary ??= stringField(line, 'summary');
+        else
+            return false;
+        return true;
+    }
+    get title() {
+        return this.custom ?? this.generated ?? this.summary;
+    }
+}
+/** Claude Code's `pr-link` line: `{prNumber, prRepository: "owner/name", prUrl}`. */
+function pullRequest(line) {
+    const repository = stringField(line, 'prRepository');
+    const url = stringField(line, 'prUrl');
+    const number = line.prNumber;
+    if (repository === null || url === null || typeof number !== 'number')
+        return null;
+    return { number, repository, url };
+}
+/**
+ * A Claude Code session file: one Agent SDK message per line (`type` `user` or `assistant`, with
+ * Anthropic `message.content`), plus title, `pr-link` and bookkeeping lines. Sidechain (subagent),
+ * meta and compact-summary lines are left out, as is thinking.
+ */
+export function parseClaudeCodeTranscript(text, file) {
+    const turns = createTurns();
+    const title = new ClaudeCodeTitle();
+    const pullRequests = new Map();
+    let sessionId = null;
+    let cwd = null;
+    let gitBranch = null;
+    for (const line of jsonLines(text)) {
+        if (title.read(line))
+            continue;
+        if (line.type === 'pr-link') {
+            const linked = pullRequest(line);
+            if (linked !== null && !pullRequests.has(linked.url))
+                pullRequests.set(linked.url, linked);
+            continue;
+        }
+        if (line.type !== 'user' && line.type !== 'assistant')
+            continue;
+        // A compact summary is Claude Code's own recap of the turns before it, written as `user`.
+        if (line.isSidechain === true || line.isMeta === true || line.isCompactSummary === true)
+            continue;
+        const message = line.message;
+        const at = validTime(stringField(line, 'timestamp'));
+        if (!isRecord(message) || at === null)
+            continue;
+        sessionId ??= stringField(line, 'sessionId');
+        cwd ??= stringField(line, 'cwd');
+        gitBranch ??= stringField(line, 'gitBranch');
+        const content = message.content;
+        if (typeof content === 'string') {
+            if (line.type === 'assistant')
+                turns.assistant(content, at);
+            else if (!CLAUDE_CODE_INJECTED.test(content))
+                turns.user(content, at);
+            continue;
+        }
+        if (!Array.isArray(content))
+            continue;
+        for (const block of content) {
+            if (!isRecord(block))
+                continue;
+            if (block.type === 'text' && typeof block.text === 'string') {
+                if (line.type === 'assistant')
+                    turns.assistant(block.text, at);
+                else if (!CLAUDE_CODE_INJECTED.test(block.text))
+                    turns.user(block.text, at);
+            }
+            else if (block.type === 'tool_use') {
+                turns.assistant(toolCallText(stringField(block, 'name') ?? 'tool', block.input), at);
+            }
+            else if (block.type === 'tool_result') {
+                turns.assistant(toolResultText(claudeToolResultText(block.content)), at);
+            }
+            else if (block.type === 'image' && line.type === 'user') {
+                turns.user('[An image was attached here; it was not imported.]', at);
+            }
+        }
+    }
+    return finishChat({
+        cwd,
+        gitBranch,
+        id: sessionId ?? path.basename(file, '.jsonl'),
+        path: file,
+        pullRequests: [...pullRequests.values()],
+        recordedRemoteUrl: null,
+        source: 'claude-code',
+        title: title.title,
+    }, turns.done());
+}
+function claudeToolResultText(content) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .map((part) => isRecord(part) && typeof part.text === 'string'
+        ? part.text
+        : isRecord(part) && part.type === 'image'
+            ? '[image]'
+            : '')
+        .filter((part) => part !== '')
+        .join('\n');
+}
+/** Where Claude Code keeps its sessions on this machine. */
+export function claudeCodeFolder(environment, homeDirectory) {
+    return path.join(environment.CLAUDE_CONFIG_DIR ?? path.join(homeDirectory, '.claude'), 'projects');
+}

package/dist/cli/import/codex.d.ts

@@ -0,0 +1,27 @@
+import { type ParsedChat } from './transcript.js';
+/**
+ * A Codex rollout: `{timestamp, type, payload}` lines, as `codex-rs/history` writes them. The
+ * `session_meta` line names the thread and its git remote; `response_item` lines carry messages and
+ * tool calls. Developer and system messages, injected context, reasoning and compaction are left out.
+ * `titleOf` gives the title Codex keeps for a thread, or null when it keeps none.
+ */
+export declare function parseCodexRollout(text: string, file: string, titleOf: (threadId: string) => string | null): ParsedChat | null;
+/** `$CODEX_HOME`, or `~/.codex`. */
+export declare function codexHome(environment: Readonly<Record<string, string | undefined>>, homeDirectory: string): string;
+/** A row of Codex's `threads` table, as much of it as an import needs. */
+export interface CodexThread {
+    readonly cwd: string;
+    readonly id: string;
+    /** Whether its rollout file is still on disk; `codex migrate-rollouts` moves history out. */
+    readonly hasRollout: boolean;
+    /** The name the person gave it, else the title Codex gave it; null when both are blank. */
+    readonly title: string | null;
+    readonly updatedAt: string;
+}
+/**
+ * The threads Codex lists, read from its state database without writing to it; null when there is
+ * no such database. A present database that cannot be read is reported to the caller.
+ * Archived threads are left out, as their rollouts are not where sessions are read from.
+ */
+export declare function readCodexThreads(home: string): Promise<CodexThread[] | null>;
+//# sourceMappingURL=codex.d.ts.map

package/dist/cli/import/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../src/cli/import/codex.ts"],"names":[],"mappings":"AAOA,OAAO,EASH,KAAK,UAAU,EAClB,MAAM,iBAAiB,CAAC;AAMzB;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAC7C,UAAU,GAAG,IAAI,CAiEnB;AAgBD,oCAAoC;AACpC,wBAAgB,SAAS,CACrB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EACzD,aAAa,EAAE,MAAM,GACtB,MAAM,CAER;AAMD,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,6FAA6F;IAC7F,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,2FAA2F;IAC3F,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B;AAiBD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,CAsClF"}

package/dist/cli/import/codex.js

@@ -0,0 +1,148 @@
+// Reads Codex sessions: rollouts in `$CODEX_HOME/sessions/YYYY/MM/DD/`, titled from `state_5.sqlite`.
+import { access } from 'node:fs/promises';
+import path from 'node:path';
+import { z } from 'zod';
+import { createTurns, finishChat, isRecord, jsonLines, stringField, toolCallText, toolResultText, validTime, } from './transcript.js';
+/** Context Codex sends as `user` messages that the person never typed. */
+const CODEX_INJECTED = /^\s*(<environment_context>|<user_instructions>|<permissions instructions>|<turn_aborted>|# AGENTS\.md instructions)/u;
+/**
+ * A Codex rollout: `{timestamp, type, payload}` lines, as `codex-rs/history` writes them. The
+ * `session_meta` line names the thread and its git remote; `response_item` lines carry messages and
+ * tool calls. Developer and system messages, injected context, reasoning and compaction are left out.
+ * `titleOf` gives the title Codex keeps for a thread, or null when it keeps none.
+ */
+export function parseCodexRollout(text, file, titleOf) {
+    const turns = createTurns();
+    let id = null;
+    let cwd = null;
+    let gitBranch = null;
+    let remoteUrl = null;
+    for (const line of jsonLines(text)) {
+        const payload = line.payload;
+        if (!isRecord(payload))
+            continue;
+        if (line.type === 'session_meta') {
+            id ??= stringField(payload, 'id');
+            cwd ??= stringField(payload, 'cwd');
+            if (isRecord(payload.git)) {
+                gitBranch ??= stringField(payload.git, 'branch');
+                remoteUrl ??= stringField(payload.git, 'repository_url');
+            }
+            continue;
+        }
+        const at = validTime(stringField(line, 'timestamp'));
+        if (line.type !== 'response_item' || at === null)
+            continue;
+        switch (payload.type) {
+            case 'message': {
+                const said = codexContentText(payload.content);
+                if (payload.role === 'user' && !CODEX_INJECTED.test(said))
+                    turns.user(said, at);
+                if (payload.role === 'assistant')
+                    turns.assistant(said, at);
+                break;
+            }
+            case 'function_call':
+                turns.assistant(toolCallText(stringField(payload, 'name') ?? 'tool', payload.arguments ?? ''), at);
+                break;
+            case 'custom_tool_call':
+                turns.assistant(toolCallText(stringField(payload, 'name') ?? 'tool', payload.input ?? ''), at);
+                break;
+            case 'local_shell_call': {
+                const action = isRecord(payload.action) ? payload.action : {};
+                const command = Array.isArray(action.command) ? action.command : [];
+                turns.assistant(toolCallText('shell', { command }), at);
+                break;
+            }
+            case 'function_call_output':
+            case 'custom_tool_call_output':
+                turns.assistant(toolResultText(codexOutputText(payload.output)), at);
+                break;
+        }
+    }
+    const threadId = id ?? path.basename(file, '.jsonl');
+    return finishChat({
+        cwd,
+        gitBranch,
+        id: threadId,
+        path: file,
+        pullRequests: [],
+        recordedRemoteUrl: remoteUrl,
+        source: 'codex',
+        title: titleOf(threadId),
+    }, turns.done());
+}
+function codexContentText(content) {
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .map((part) => (isRecord(part) && typeof part.text === 'string' ? part.text : ''))
+        .filter((part) => part !== '')
+        .join('\n');
+}
+function codexOutputText(output) {
+    if (typeof output === 'string')
+        return output;
+    if (isRecord(output) && typeof output.content === 'string')
+        return output.content;
+    return codexContentText(output);
+}
+/** `$CODEX_HOME`, or `~/.codex`. */
+export function codexHome(environment, homeDirectory) {
+    return environment.CODEX_HOME ?? path.join(homeDirectory, '.codex');
+}
+/** The state database Codex 0.1xx keeps beside its rollouts. */
+const CODEX_STATE_DB = 'state_5.sqlite';
+const ThreadRowsSchema = z.array(z.object({
+    archived: z.number(),
+    cwd: z.string(),
+    id: z.string(),
+    name: z.string().nullable(),
+    rollout_path: z.string().nullable(),
+    title: z.string(),
+    updated_at: z.number(),
+}));
+/**
+ * The threads Codex lists, read from its state database without writing to it; null when there is
+ * no such database. A present database that cannot be read is reported to the caller.
+ * Archived threads are left out, as their rollouts are not where sessions are read from.
+ */
+export async function readCodexThreads(home) {
+    const file = path.join(home, CODEX_STATE_DB);
+    if (!(await exists(file)))
+        return null;
+    let rows;
+    try {
+        const { default: Database } = await import('better-sqlite3');
+        const db = new Database(file, { fileMustExist: true, readonly: true });
+        try {
+            rows = ThreadRowsSchema.parse(db
+                .prepare('SELECT id, rollout_path, cwd, title, name, archived, updated_at FROM threads')
+                .all());
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch (error) {
+        throw new Error(`Cannot read Codex state database; titles and migrated history are unavailable. Use --dir to read rollout files without it. ${error instanceof Error ? error.message : 'Unknown error.'}`, { cause: error });
+    }
+    const threads = [];
+    for (const row of rows) {
+        if (row.archived !== 0)
+            continue;
+        const name = row.name?.trim() ?? '';
+        const title = row.title.trim();
+        threads.push({
+            cwd: row.cwd,
+            hasRollout: row.rollout_path !== null && (await exists(row.rollout_path)),
+            id: row.id,
+            title: name !== '' ? name : title !== '' ? title : null,
+            updatedAt: new Date(row.updated_at * 1_000).toISOString(),
+        });
+    }
+    return threads;
+}
+async function exists(file) {
+    return await access(file).then(() => true, () => false);
+}

package/dist/cli/import/git.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The repository `folder` is in: the main checkout's folder, so every worktree of one repository
+ * names the same one, and its `origin` remote. Null when the folder is gone or in no repository.
+ */
+export declare function findRepository(folder: string): Promise<{
+    readonly remoteUrl: string | null;
+    readonly root: string;
+} | null>;
+type FoundRepository = ReturnType<typeof findRepository>;
+/** A lookup of `findRepository` that reads each folder once. */
+export declare function createRepositoryFinder(): (folder: string | null) => FoundRepository;
+/** `[remote "origin"] url = …` in a git config, without credentials. */
+export declare function originUrl(config: string): string | null;
+/**
+ * A remote URL with userinfo, query and fragment removed, including scp-style userinfo.
+ */
+export declare function withoutCredentials(url: string): string;
+export {};
+//# sourceMappingURL=git.d.ts.map

package/dist/cli/import/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/cli/import/git.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAsB,cAAc,CAChC,MAAM,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAW9E;AAED,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAEzD,gEAAgE;AAChE,wBAAgB,sBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,eAAe,CAWnF;AA6BD,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAavD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAatD"}