@router-agent/runtime 0.0.0-stage → 0.3.32

package/dist/agents/claude.d.ts

@@ -0,0 +1,51 @@
+import type { SessionSnapshot } from '../port.js';
+import type { AgentSessionReader } from './profile.js';
+/** Claude Code 默认把会话记录写在这里。 */
+export declare function defaultClaudeProjectsDir(): string;
+/** Claude Code 把 cwd 里所有非字母数字字符替换成 `-` 作为项目目录名。 */
+export declare function claudeProjectSlug(workdir: string): string;
+/**
+ * 按 workdir 找最近一次 Claude Code 会话的 id。
+ *
+ * Claude Code 的会话文件名就是 `claude --resume` 接受的 session id，
+ * 所以这里只按 mtime 取最新的 .jsonl，不解析文件内容。
+ */
+export declare function latestClaudeSessionId(workdir: string, opts?: {
+    projectsDir?: string;
+}): string | null;
+export interface ReadSessionOptions {
+    projectsDir?: string;
+    /** 只读文件尾部这么多字节，避免把几 MB 的会话全量读进内存。 */
+    maxBytes?: number;
+    /** 最多保留多少条最近活动。 */
+    maxEvents?: number;
+    /** 精确匹配会话 ID；找不到时返回 null，不退化成「最新文件」。 */
+    sessionId?: string;
+}
+/**
+ * 读取某个 workdir 对应 Claude Code 会话的最新活动。
+ *
+ * 优先用 Agent 自己的结构化会话记录，而不是终端渲染屏幕：
+ * 这里只有 assistant 文本与工具调用，没有 TUI 状态栏、spinner 和输入回显。
+ * 找不到会话（非 Claude 运行时 / 文件尚未落盘）时返回 null，调用方退回终端读取。
+ */
+export declare function readClaudeSession(workdir: string, opts?: ReadSessionOptions): SessionSnapshot | null;
+/** 某个会话的记录文件路径；找不到返回 null（不做「最新文件」兜底，避免串工单）。 */
+export declare function claudeTranscriptPath(workdir: string, sessionId: string, opts?: {
+    projectsDir?: string;
+}): string | null;
+/** 记录文件当前大小，用来只检查「注入之后新增的内容」。 */
+export declare function transcriptSize(path: string): number;
+/** 读取记录文件从 `from` 开始的内容；文件变短（重建）时从头读。 */
+export declare function readTranscriptSince(path: string, from: number): string;
+/** 工具调用的结构化摘要：只保留「工具名 + 目标」，不把完整命令 / 文件内容带进话题。 */
+export interface ToolInfo {
+    name: string;
+    target?: string;
+}
+/** 从工具名与入参里提炼结构化目标，供进展巡检生成语义摘要。 */
+export declare function describeToolInfo(name: unknown, input: unknown): ToolInfo;
+/** 把工具调用压成一行人话；不把完整命令 / 文件内容带进话题。 */
+export declare function describeToolUse(name: unknown, input: unknown): string;
+/** Claude Code 的会话记录读取器。 */
+export declare const claudeSessionReader: AgentSessionReader;

package/dist/agents/claude.js

@@ -0,0 +1,270 @@
+/**
+ * Claude Code 的会话记录读取。
+ *
+ * Claude 把每个项目的会话写在 `~/.claude/projects/<cwd 转义>/<sessionId>.jsonl`，
+ * 文件名本身就是 `claude --resume` 接受的 session id。
+ */
+import { closeSync, existsSync, openSync, readdirSync, readSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { basename, join } from 'node:path';
+/** Claude Code 默认把会话记录写在这里。 */
+export function defaultClaudeProjectsDir() {
+    return join(homedir(), '.claude', 'projects');
+}
+/** Claude Code 把 cwd 里所有非字母数字字符替换成 `-` 作为项目目录名。 */
+export function claudeProjectSlug(workdir) {
+    return workdir.replace(/[^a-zA-Z0-9]/g, '-');
+}
+/**
+ * 按 workdir 找最近一次 Claude Code 会话的 id。
+ *
+ * Claude Code 的会话文件名就是 `claude --resume` 接受的 session id，
+ * 所以这里只按 mtime 取最新的 .jsonl，不解析文件内容。
+ */
+export function latestClaudeSessionId(workdir, opts = {}) {
+    if (!workdir)
+        return null;
+    const dir = join(opts.projectsDir ?? defaultClaudeProjectsDir(), claudeProjectSlug(workdir));
+    if (!existsSync(dir))
+        return null;
+    let files;
+    try {
+        files = readdirSync(dir).filter(file => file.endsWith('.jsonl'));
+    }
+    catch {
+        return null;
+    }
+    if (files.length === 0)
+        return null;
+    let latest = null;
+    for (const file of files) {
+        let mtime = 0;
+        try {
+            mtime = statSync(join(dir, file)).mtimeMs;
+        }
+        catch {
+            // 读不到 mtime 的文件排在最后，不影响其它候选。
+        }
+        if (!latest || mtime > latest.mtime)
+            latest = { file, mtime };
+    }
+    return latest ? latest.file.slice(0, -'.jsonl'.length) : null;
+}
+/**
+ * 读取某个 workdir 对应 Claude Code 会话的最新活动。
+ *
+ * 优先用 Agent 自己的结构化会话记录，而不是终端渲染屏幕：
+ * 这里只有 assistant 文本与工具调用，没有 TUI 状态栏、spinner 和输入回显。
+ * 找不到会话（非 Claude 运行时 / 文件尚未落盘）时返回 null，调用方退回终端读取。
+ */
+export function readClaudeSession(workdir, opts = {}) {
+    if (!workdir)
+        return null;
+    const projectsDir = opts.projectsDir ?? defaultClaudeProjectsDir();
+    const dir = join(projectsDir, claudeProjectSlug(workdir));
+    if (!existsSync(dir))
+        return null;
+    let files;
+    try {
+        files = readdirSync(dir).filter(file => file.endsWith('.jsonl'));
+    }
+    catch {
+        return null;
+    }
+    if (files.length === 0)
+        return null;
+    if (opts.sessionId) {
+        const exact = files.find(file => file === `${opts.sessionId}.jsonl` || file.includes(opts.sessionId));
+        if (!exact)
+            return null;
+        files = [exact];
+    }
+    const latest = files
+        .map(file => {
+        const path = join(dir, file);
+        try {
+            return { path, mtime: statSync(path).mtimeMs };
+        }
+        catch {
+            return { path, mtime: 0 };
+        }
+    })
+        .sort((a, b) => b.mtime - a.mtime)[0];
+    const maxBytes = opts.maxBytes ?? 512 * 1024;
+    const maxEvents = opts.maxEvents ?? 40;
+    const events = [];
+    let at = '';
+    let sessionId = '';
+    for (const line of readTailLines(latest.path, maxBytes)) {
+        let record;
+        try {
+            record = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (record?.type !== 'assistant')
+            continue;
+        const timestamp = typeof record.timestamp === 'string' ? record.timestamp : '';
+        const content = record.message?.content;
+        if (!timestamp || !Array.isArray(content))
+            continue;
+        const before = events.length;
+        for (const block of content) {
+            if (!block || typeof block !== 'object')
+                continue;
+            if (block.type === 'text') {
+                const text = String(block.text ?? '').trim();
+                if (text)
+                    events.push({ at: timestamp, kind: 'text', text });
+            }
+            else if (block.type === 'tool_use') {
+                events.push({
+                    at: timestamp,
+                    kind: 'tool',
+                    text: describeToolUse(block.name, block.input),
+                    tool: describeToolInfo(block.name, block.input),
+                });
+            }
+        }
+        if (events.length > before) {
+            at = timestamp;
+            if (typeof record.sessionId === 'string')
+                sessionId = record.sessionId;
+        }
+    }
+    if (events.length === 0)
+        return null;
+    return {
+        at,
+        events: events.slice(-maxEvents),
+        ...(sessionId ? { sessionId } : {}),
+        filePath: latest.path,
+    };
+}
+/** 从文件尾部读有界的一段；首行可能被截断，直接丢弃。 */
+function readTailLines(path, maxBytes) {
+    const size = statSync(path).size;
+    const start = Math.max(0, size - maxBytes);
+    const length = size - start;
+    if (length <= 0)
+        return [];
+    const buffer = Buffer.alloc(length);
+    const fd = openSync(path, 'r');
+    try {
+        readSync(fd, buffer, 0, length, start);
+    }
+    finally {
+        closeSync(fd);
+    }
+    const lines = buffer.toString('utf8').split('\n');
+    if (start > 0)
+        lines.shift();
+    return lines.filter(line => line.trim().length > 0);
+}
+/** 某个会话的记录文件路径；找不到返回 null（不做「最新文件」兜底，避免串工单）。 */
+export function claudeTranscriptPath(workdir, sessionId, opts = {}) {
+    if (!workdir || !sessionId)
+        return null;
+    const file = join(opts.projectsDir ?? defaultClaudeProjectsDir(), claudeProjectSlug(workdir), `${sessionId}.jsonl`);
+    return existsSync(file) ? file : null;
+}
+/** 记录文件当前大小，用来只检查「注入之后新增的内容」。 */
+export function transcriptSize(path) {
+    try {
+        return statSync(path).size;
+    }
+    catch {
+        return 0;
+    }
+}
+/** 读取记录文件从 `from` 开始的内容；文件变短（重建）时从头读。 */
+export function readTranscriptSince(path, from) {
+    let size = 0;
+    try {
+        size = statSync(path).size;
+    }
+    catch {
+        return '';
+    }
+    const start = size >= from ? from : 0;
+    const length = size - start;
+    if (length <= 0)
+        return '';
+    const buffer = Buffer.alloc(length);
+    const fd = openSync(path, 'r');
+    try {
+        readSync(fd, buffer, 0, length, start);
+    }
+    finally {
+        closeSync(fd);
+    }
+    return buffer.toString('utf8');
+}
+/** 从工具名与入参里提炼结构化目标，供进展巡检生成语义摘要。 */
+export function describeToolInfo(name, input) {
+    const tool = String(name ?? 'tool');
+    const args = (input && typeof input === 'object' ? input : {});
+    const file = typeof args.file_path === 'string' ? basename(args.file_path) : '';
+    const target = (value) => {
+        const text = oneLine(value);
+        return text ? { target: text } : {};
+    };
+    switch (tool) {
+        case 'Bash':
+            return { name: 'Bash', ...target(args.description ?? args.command) };
+        case 'Read':
+        case 'Edit':
+        case 'Write':
+        case 'MultiEdit':
+        case 'NotebookEdit':
+            return { name: tool, ...(file ? { target: file } : {}) };
+        case 'Grep':
+        case 'Glob':
+            return { name: tool, ...target(args.pattern) };
+        case 'Task':
+            return { name: 'Task', ...target(args.description) };
+        default:
+            return { name: tool };
+    }
+}
+/** 把工具调用压成一行人话；不把完整命令 / 文件内容带进话题。 */
+export function describeToolUse(name, input) {
+    const info = describeToolInfo(name, input);
+    switch (info.name) {
+        case 'Bash':
+            return `Bash：${info.target ?? '执行命令'}`;
+        case 'Read':
+        case 'Edit':
+        case 'Write':
+        case 'MultiEdit':
+        case 'NotebookEdit':
+            return info.target ? `${info.name}(${info.target})` : info.name;
+        case 'Grep':
+        case 'Glob':
+            return `${info.name}(${info.target ?? '搜索'})`;
+        case 'Task':
+            return `Task：${info.target ?? '子任务'}`;
+        default:
+            return info.name;
+    }
+}
+function oneLine(value) {
+    const text = String(value ?? '').replace(/\s+/g, ' ').trim();
+    return text.length <= 160 ? text : `${text.slice(0, 160)}…`;
+}
+/** Claude Code 的会话记录读取器。 */
+export const claudeSessionReader = {
+    latestSessionId(workdir, opts) {
+        return latestClaudeSessionId(workdir, opts?.root ? { projectsDir: opts.root } : {});
+    },
+    read(workdir, opts) {
+        return readClaudeSession(workdir, {
+            ...(opts?.root ? { projectsDir: opts.root } : {}),
+            ...(opts?.maxBytes !== undefined ? { maxBytes: opts.maxBytes } : {}),
+            ...(opts?.maxEvents !== undefined ? { maxEvents: opts.maxEvents } : {}),
+            ...(opts?.sessionId ? { sessionId: opts.sessionId } : {}),
+        });
+    },
+};
+//# sourceMappingURL=claude.js.map

package/dist/agents/claude.js.map

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

package/dist/agents/codex.d.ts

@@ -0,0 +1,36 @@
+import type { SessionSnapshot } from '../port.js';
+import type { AgentSessionReader } from './profile.js';
+/** Codex 的数据根目录。 */
+export declare function defaultCodexHome(): string;
+/** 找到属于这个 workdir 的最近一次 Codex 会话。 */
+export declare function findCodexSession(workdir: string, opts?: {
+    root?: string;
+    sessionId?: string;
+}): {
+    path: string;
+    sessionId: string;
+} | null;
+/** 按 workdir 找最近一次 Codex 会话的 id。 */
+export declare function latestCodexSessionId(workdir: string, opts?: {
+    root?: string;
+}): string | null;
+/** Codex 的工具调用摘要：只留「工具名 + 目标」，不把完整命令带进话题。 */
+export interface CodexToolInfo {
+    name: string;
+    target?: string;
+}
+export declare function describeCodexToolInfo(name: unknown, args: unknown): CodexToolInfo;
+export declare function describeCodexToolUse(name: unknown, args: unknown): string;
+/**
+ * 读取某个 workdir 对应 Codex 会话的最新活动。
+ *
+ * 只取 assistant 文本与工具调用；reasoning 摘要与 usage 记录不进话题。
+ */
+export declare function readCodexSession(workdir: string, opts?: {
+    root?: string;
+    maxBytes?: number;
+    maxEvents?: number;
+    sessionId?: string;
+}): SessionSnapshot | null;
+/** Codex 的会话记录读取器。 */
+export declare const codexSessionReader: AgentSessionReader;

package/dist/agents/codex.js

@@ -0,0 +1,292 @@
+/**
+ * Codex 的会话记录读取。
+ *
+ * Codex 把每次会话写成 `~/.codex/sessions/<年>/<月>/<日>/rollout-<时间>-<uuid>.jsonl`：
+ * 目录按日期分，不像 Claude 那样按项目分，所以要靠首行的 `session_meta.cwd` 反查
+ * 「哪个会话属于这个 worktree」。
+ */
+import { closeSync, existsSync, openSync, readdirSync, readSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/** Codex 的数据根目录。 */
+export function defaultCodexHome() {
+    return join(homedir(), '.codex');
+}
+/** 最多检查多少个 rollout 文件；按 mtime 从新到旧找，超出就不再往下翻。 */
+const MAX_CANDIDATES = 300;
+/** 查找结果的短缓存：一次巡检里「找会话」与「读会话」会连着调两次。 */
+const LOOKUP_TTL_MS = 5_000;
+const lookupCache = new Map();
+function sessionsRoot(root) {
+    return join(root, 'sessions');
+}
+/** 收集 rollout 文件（年/月/日 三层目录），按 mtime 从新到旧排序。 */
+function collectRollouts(root) {
+    const base = sessionsRoot(root);
+    if (!existsSync(base))
+        return [];
+    const candidates = [];
+    let years;
+    try {
+        years = readdirSync(base);
+    }
+    catch {
+        return [];
+    }
+    for (const year of years) {
+        const yearDir = join(base, year);
+        let months;
+        try {
+            months = readdirSync(yearDir);
+        }
+        catch {
+            continue;
+        }
+        for (const month of months) {
+            const monthDir = join(yearDir, month);
+            let days;
+            try {
+                days = readdirSync(monthDir);
+            }
+            catch {
+                continue;
+            }
+            for (const day of days) {
+                const dayDir = join(monthDir, day);
+                let files;
+                try {
+                    files = readdirSync(dayDir);
+                }
+                catch {
+                    continue;
+                }
+                for (const file of files) {
+                    if (!file.endsWith('.jsonl'))
+                        continue;
+                    const path = join(dayDir, file);
+                    try {
+                        candidates.push({ path, mtime: statSync(path).mtimeMs });
+                    }
+                    catch {
+                        // 读不到 mtime 的文件排在最后。
+                    }
+                }
+            }
+        }
+    }
+    return candidates.sort((a, b) => b.mtime - a.mtime);
+}
+/** 读首行解析 session_meta。 */
+function readSessionMeta(path) {
+    let fd;
+    try {
+        fd = openSync(path, 'r');
+    }
+    catch {
+        return null;
+    }
+    try {
+        const buffer = Buffer.alloc(64 * 1024);
+        const read = readSync(fd, buffer, 0, buffer.length, 0);
+        const firstLine = buffer.toString('utf8', 0, read).split('\n')[0] ?? '';
+        const record = JSON.parse(firstLine);
+        if (record?.type !== 'session_meta')
+            return null;
+        const payload = (record.payload ?? {});
+        const sessionId = String(payload.session_id ?? payload.id ?? '');
+        const cwd = String(payload.cwd ?? '');
+        if (!sessionId || !cwd)
+            return null;
+        return { sessionId, cwd };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/** 找到属于这个 workdir 的最近一次 Codex 会话。 */
+export function findCodexSession(workdir, opts = {}) {
+    if (!workdir)
+        return null;
+    const root = opts.root ?? defaultCodexHome();
+    const cacheKey = `${root}\u0000${workdir}\u0000${opts.sessionId ?? ''}`;
+    const cached = lookupCache.get(cacheKey);
+    const now = Date.now();
+    if (cached && now - cached.at < LOOKUP_TTL_MS)
+        return cached.found;
+    const found = scanCodexSession(workdir, root, opts.sessionId);
+    lookupCache.set(cacheKey, { found, at: now });
+    return found;
+}
+/** 扫描 rollout 目录，找到 cwd 匹配且最近的一次会话。 */
+function scanCodexSession(workdir, root, sessionId) {
+    for (const candidate of collectRollouts(root).slice(0, MAX_CANDIDATES)) {
+        const meta = readSessionMeta(candidate.path);
+        if (!meta || meta.cwd !== workdir)
+            continue;
+        if (sessionId && meta.sessionId !== sessionId)
+            continue;
+        return { path: candidate.path, sessionId: meta.sessionId };
+    }
+    return null;
+}
+/** 按 workdir 找最近一次 Codex 会话的 id。 */
+export function latestCodexSessionId(workdir, opts = {}) {
+    return findCodexSession(workdir, opts)?.sessionId ?? null;
+}
+export function describeCodexToolInfo(name, args) {
+    const tool = String(name ?? 'tool');
+    const input = parseArgs(args);
+    const target = oneLine(input.cmd ?? input.command ?? input.path ?? input.file_path ?? '');
+    switch (tool) {
+        case 'exec_command':
+        case 'shell':
+        case 'local_shell':
+            return { name: tool, ...(target ? { target } : {}) };
+        case 'apply_patch':
+        case 'read_file':
+        case 'write_file':
+        case 'view_file':
+            return { name: tool, ...(target ? { target } : {}) };
+        default:
+            return { name: tool };
+    }
+}
+export function describeCodexToolUse(name, args) {
+    const info = describeCodexToolInfo(name, args);
+    return info.target ? `${info.name}(${info.target})` : info.name;
+}
+/**
+ * 读取某个 workdir 对应 Codex 会话的最新活动。
+ *
+ * 只取 assistant 文本与工具调用；reasoning 摘要与 usage 记录不进话题。
+ */
+export function readCodexSession(workdir, opts = {}) {
+    if (!workdir)
+        return null;
+    const root = opts.root ?? defaultCodexHome();
+    const found = findCodexSession(workdir, {
+        root,
+        ...(opts.sessionId ? { sessionId: opts.sessionId } : {}),
+    });
+    if (!found)
+        return null;
+    const maxBytes = opts.maxBytes ?? 512 * 1024;
+    const maxEvents = opts.maxEvents ?? 40;
+    const events = [];
+    let at = '';
+    for (const line of readTailLines(found.path, maxBytes)) {
+        let record;
+        try {
+            record = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (record?.type !== 'response_item')
+            continue;
+        const timestamp = typeof record.timestamp === 'string' ? record.timestamp : '';
+        const payload = (record.payload ?? {});
+        if (!timestamp)
+            continue;
+        if (payload.type === 'message' && payload.role === 'assistant') {
+            const content = Array.isArray(payload.content) ? payload.content : [];
+            const before = events.length;
+            for (const block of content) {
+                if (!block || typeof block !== 'object')
+                    continue;
+                if (block.type !== 'output_text')
+                    continue;
+                const text = String(block.text ?? '').trim();
+                if (text)
+                    events.push({ at: timestamp, kind: 'text', text });
+            }
+            if (events.length > before)
+                at = timestamp;
+            continue;
+        }
+        if (payload.type === 'function_call') {
+            events.push({
+                at: timestamp,
+                kind: 'tool',
+                text: describeCodexToolUse(payload.name, payload.arguments),
+                tool: describeCodexToolInfo(payload.name, payload.arguments),
+            });
+            at = timestamp;
+        }
+    }
+    if (events.length === 0)
+        return null;
+    return {
+        at,
+        events: events.slice(-maxEvents),
+        sessionId: found.sessionId,
+        filePath: found.path,
+    };
+}
+/** 从文件尾部读有界的一段；首行可能被截断，直接丢弃。 */
+function readTailLines(path, maxBytes) {
+    let size = 0;
+    try {
+        size = statSync(path).size;
+    }
+    catch {
+        return [];
+    }
+    const start = Math.max(0, size - maxBytes);
+    const length = size - start;
+    if (length <= 0)
+        return [];
+    const buffer = Buffer.alloc(length);
+    let fd;
+    try {
+        fd = openSync(path, 'r');
+    }
+    catch {
+        return [];
+    }
+    try {
+        readSync(fd, buffer, 0, length, start);
+    }
+    finally {
+        closeSync(fd);
+    }
+    const lines = buffer.toString('utf8').split('\n');
+    if (start > 0)
+        lines.shift();
+    return lines.filter(line => line.trim().length > 0);
+}
+function parseArgs(args) {
+    if (args && typeof args === 'object')
+        return args;
+    if (typeof args !== 'string')
+        return {};
+    try {
+        const parsed = JSON.parse(args);
+        return parsed && typeof parsed === 'object' ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function oneLine(value) {
+    const text = String(value ?? '').replace(/\s+/g, ' ').trim();
+    return text.length <= 160 ? text : `${text.slice(0, 160)}…`;
+}
+/** Codex 的会话记录读取器。 */
+export const codexSessionReader = {
+    latestSessionId(workdir, opts) {
+        return latestCodexSessionId(workdir, opts?.root ? { root: opts.root } : {});
+    },
+    read(workdir, opts) {
+        return readCodexSession(workdir, {
+            ...(opts?.root ? { root: opts.root } : {}),
+            ...(opts?.maxBytes !== undefined ? { maxBytes: opts.maxBytes } : {}),
+            ...(opts?.maxEvents !== undefined ? { maxEvents: opts.maxEvents } : {}),
+            ...(opts?.sessionId ? { sessionId: opts.sessionId } : {}),
+        });
+    },
+};
+//# sourceMappingURL=codex.js.map