@super-coding/cli 0.0.0-stage → 0.1.0

package/dist/daemon/run-skills.js

@@ -0,0 +1,148 @@
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, join, relative, sep } from "node:path";
+const MANIFEST = join(".super-coding", "managed-skills.json");
+const SLUG = /^[a-z0-9][a-z0-9._-]{0,63}$/i;
+function skillRoot(agent) {
+    if (agent === "claude-code")
+        return ".claude/skills";
+    if (agent === "cursor")
+        return ".cursor/skills";
+    return ".agents/skills";
+}
+function isSafeSlug(slug) {
+    return SLUG.test(slug) && !slug.includes("..");
+}
+function frontmatterName(content) {
+    const block = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    const name = block?.[1].match(/^name:\s*(.+)$/m)?.[1]?.trim().replace(/^["']|["']$/g, "");
+    return name || undefined;
+}
+function modelInvocationDisabled(content) {
+    const block = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (!block)
+        return false;
+    return /^disable-model-invocation:\s*true\s*$/im.test(block[1]);
+}
+function preferredSlug(skill) {
+    if (isSafeSlug(skill.name))
+        return skill.name;
+    const fromFile = frontmatterName(skill.content);
+    if (fromFile && isSafeSlug(fromFile))
+        return fromFile;
+    const id = skill.id.replace(/[^a-z0-9]/gi, "").slice(0, 8).toLowerCase();
+    return `skill-${id || "x"}`;
+}
+function allocateSlugs(skills) {
+    const taken = new Set();
+    return skills.map((skill) => {
+        const base = preferredSlug(skill);
+        let slug = base;
+        for (let n = 2; taken.has(slug.toLowerCase()); n += 1) {
+            if (n > 100)
+                throw new Error(`skill slug exhausted: ${base}`);
+            const suffix = `-${n}`;
+            slug = `${base.slice(0, Math.max(1, 64 - suffix.length))}${suffix}`;
+        }
+        taken.add(slug.toLowerCase());
+        return slug;
+    });
+}
+function yamlScalar(value) {
+    if (/[:#\n"'&*!?|>%@`]|^\s|\s$/.test(value))
+        return JSON.stringify(value);
+    return value;
+}
+function safeSkillFilePath(path) {
+    const p = path.trim();
+    if (!p || p.length > 240 || p === "SKILL.md")
+        return null;
+    if (p.startsWith("/") || p.includes("\\") || /[\u0000-\u001f]/.test(p))
+        return null;
+    const parts = p.split("/");
+    if (parts.some((part) => !part || part === "." || part === ".."))
+        return null;
+    return p;
+}
+function isInside(root, dest) {
+    const rel = relative(root, dest);
+    return rel !== "" && !isAbsolute(rel) && rel !== ".." && !rel.startsWith(`..${sep}`);
+}
+function skillDocument(skill, slug) {
+    const content = skill.content.replace(/^\uFEFF/, "");
+    if (/^---\r?\n/.test(content))
+        return content.endsWith("\n") ? content : `${content}\n`;
+    const description = skill.description?.trim();
+    const head = [
+        "---",
+        `name: ${yamlScalar(slug)}`,
+        ...(description ? [`description: ${yamlScalar(description)}`] : []),
+        "---",
+        "",
+    ].join("\n");
+    return content ? `${head}${content.endsWith("\n") ? content : `${content}\n`}` : head;
+}
+async function readManifest(path) {
+    try {
+        const parsed = JSON.parse(await readFile(path, "utf8"));
+        return Array.isArray(parsed.slugs) ? parsed.slugs.filter((slug) => typeof slug === "string") : [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 把本轮 skill 写进会话目录里执行器自己的 skills 目录，并清掉上一轮已取消关联的目录。
+ * 返回要写进提示词的名单（disable-model-invocation 的仍落盘，但不进名单）。
+ */
+export async function syncRunSkills(workdir, agent, skills) {
+    const rootRel = skillRoot(agent);
+    const root = join(workdir, ...rootRel.split("/"));
+    const previous = await readManifest(join(workdir, MANIFEST));
+    const slugs = allocateSlugs(skills);
+    const next = new Set(slugs.map((slug) => slug.toLowerCase()));
+    for (const slug of previous) {
+        if (!isSafeSlug(slug) || next.has(slug.toLowerCase()))
+            continue;
+        await rm(join(root, slug), { recursive: true, force: true });
+    }
+    const visible = [];
+    for (let i = 0; i < skills.length; i += 1) {
+        const skill = skills[i];
+        const slug = slugs[i];
+        const dir = join(root, slug);
+        await rm(dir, { recursive: true, force: true });
+        await mkdir(dir, { recursive: true });
+        await writeFile(join(dir, "SKILL.md"), skillDocument(skill, slug));
+        for (const file of skill.files ?? []) {
+            const rel = safeSkillFilePath(file.path);
+            if (!rel)
+                continue;
+            const dest = join(dir, ...rel.split("/"));
+            if (!isInside(dir, dest))
+                continue;
+            await mkdir(dirname(dest), { recursive: true });
+            await writeFile(dest, file.content ?? "");
+        }
+        if (!modelInvocationDisabled(skill.content)) {
+            visible.push({
+                slug,
+                ...(skill.description ? { description: skill.description } : {}),
+                relativePath: `${rootRel}/${slug}/SKILL.md`,
+            });
+        }
+    }
+    await mkdir(join(workdir, ".super-coding"), { recursive: true });
+    await writeFile(join(workdir, MANIFEST), JSON.stringify({ slugs }) + "\n");
+    return visible;
+}
+/** 只列名称和路径。正文在 SKILL.md 里，由执行器自己读。 */
+export function promptWithSkills(prompt, skills) {
+    if (skills.length === 0)
+        return prompt;
+    const lines = skills.map((skill) => {
+        const description = skill.description ? `：${skill.description}` : "";
+        return `- ${skill.slug}${description}（${skill.relativePath}）`;
+    });
+    const index = `可用技能：\n${lines.join("\n")}`;
+    return prompt ? `${prompt}\n\n${index}` : index;
+}

package/dist/daemon/services/agent-config.js

@@ -0,0 +1 @@
+export {};

package/dist/daemon/services/claude-provider.js

@@ -0,0 +1,126 @@
+import { mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { RpcException } from "../rpc.js";
+import { isValidName, readJson, writeJsonAtomic } from "./json-file.js";
+import { maskMcpServers, mergeMcpSecrets } from "./mcp-secrets.js";
+const asStr = (v) => (typeof v === "string" ? v : undefined);
+/** 从 SKILL.md frontmatter 提取 description */
+const skillDescription = (content) => content.match(/^description:\s*(.+)$/m)?.[1]?.trim();
+/**
+ * claude-code 配置面：
+ * - config → ~/.claude/settings.json（model / permissions.defaultMode）
+ * - skill  → ~/.claude/skills/<name>/SKILL.md
+ * - mcp    → ~/.claude.json 的 mcpServers
+ * - memory → global: ~/.claude/CLAUDE.md；project: <cwd>/CLAUDE.md
+ */
+export class ClaudeConfigProvider {
+    home;
+    agent_id = "claude-code";
+    available_models = ["default", "sonnet", "opus", "haiku"];
+    constructor(home = homedir()) {
+        this.home = home;
+    }
+    settingsPath() {
+        return join(this.home, ".claude", "settings.json");
+    }
+    mcpPath() {
+        return join(this.home, ".claude.json");
+    }
+    skillsDir() {
+        return join(this.home, ".claude", "skills");
+    }
+    memoryPath(scope, cwd) {
+        return scope === "global"
+            ? join(this.home, ".claude", "CLAUDE.md")
+            : join(cwd ?? process.cwd(), "CLAUDE.md");
+    }
+    async getConfig() {
+        const j = await readJson(this.settingsPath());
+        return { model: asStr(j?.model), permission_mode: asStr(j?.permissions?.defaultMode) };
+    }
+    async setConfig(patch) {
+        const j = (await readJson(this.settingsPath())) ?? {};
+        if (patch.model !== undefined)
+            j.model = patch.model;
+        if (patch.permission_mode !== undefined) {
+            const permissions = j.permissions ?? {};
+            permissions.defaultMode = patch.permission_mode;
+            j.permissions = permissions;
+        }
+        await writeJsonAtomic(this.settingsPath(), j);
+        return this.getConfig();
+    }
+    async listSkills() {
+        let entries;
+        try {
+            entries = await readdir(this.skillsDir());
+        }
+        catch {
+            return [];
+        }
+        const skills = [];
+        for (const name of entries) {
+            try {
+                const content = await readFile(join(this.skillsDir(), name, "SKILL.md"), "utf8");
+                skills.push({ name, description: skillDescription(content) });
+            }
+            catch {
+                // 无 SKILL.md 的目录跳过
+            }
+        }
+        return skills;
+    }
+    async installSkill(name, content) {
+        if (!isValidName(name))
+            throw new RpcException("bad_params", `invalid skill name: ${name}`);
+        const dir = join(this.skillsDir(), name);
+        await mkdir(dir, { recursive: true });
+        await writeFile(join(dir, "SKILL.md"), content);
+    }
+    async removeSkill(name) {
+        if (!isValidName(name))
+            throw new RpcException("bad_params", `invalid skill name: ${name}`);
+        await rm(join(this.skillsDir(), name), { recursive: true, force: true });
+    }
+    async listMcp() {
+        const j = await readJson(this.mcpPath());
+        // env/headers 的值可能是 API Key：对外只回键名（脱敏后仍可重建配置）
+        return maskMcpServers(j?.mcpServers ?? {});
+    }
+    async addMcp(name, spec) {
+        if (!isValidName(name))
+            throw new RpcException("bad_params", `invalid mcp name: ${name}`);
+        const j = (await readJson(this.mcpPath())) ?? {};
+        const servers = (j.mcpServers ?? {});
+        // 前端编辑后回写：值为掩码的密钥沿用旧值，不把 *** 落盘
+        servers[name] = mergeMcpSecrets(spec, servers[name]);
+        j.mcpServers = servers;
+        await writeJsonAtomic(this.mcpPath(), j);
+    }
+    async removeMcp(name) {
+        const j = await readJson(this.mcpPath());
+        const servers = j?.mcpServers;
+        if (!servers || !(name in servers))
+            return;
+        delete servers[name];
+        await writeJsonAtomic(this.mcpPath(), j);
+    }
+    async getMemory(scope, cwd) {
+        const path = this.memoryPath(scope, cwd);
+        let content = "";
+        try {
+            content = await readFile(path, "utf8");
+        }
+        catch {
+            // 文件不存在按空内容
+        }
+        return { path, content };
+    }
+    async putMemory(scope, content, cwd) {
+        const path = this.memoryPath(scope, cwd);
+        await mkdir(join(path, ".."), { recursive: true });
+        await writeFile(path, content);
+        return { path };
+    }
+}

package/dist/daemon/services/cursor-provider.js

@@ -0,0 +1,94 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { RpcException } from "../rpc.js";
+import { isValidName, readJson, writeJsonAtomic } from "./json-file.js";
+import { maskMcpServers, mergeMcpSecrets } from "./mcp-secrets.js";
+/**
+ * cursor 配置面：
+ * - config → daemon 自有 ~/.super-coding/agent-config.json（cursor 无持久设置文件，作为 spawn 默认 --model）
+ * - skill  → 不支持（.cursor/rules 无 skill 概念），unsupported
+ * - mcp    → ~/.cursor/mcp.json 的 mcpServers
+ * - memory → global: ~/.cursor/rules/super-coding.mdc；project: <cwd>/.cursor/rules/super-coding.mdc
+ */
+export class CursorConfigProvider {
+    home;
+    agent_id = "cursor";
+    available_models = ["auto"];
+    constructor(home = homedir()) {
+        this.home = home;
+    }
+    daemonConfigPath() {
+        return join(this.home, ".super-coding", "agent-config.json");
+    }
+    mcpPath() {
+        return join(this.home, ".cursor", "mcp.json");
+    }
+    memoryPath(scope, cwd) {
+        return scope === "global"
+            ? join(this.home, ".cursor", "rules", "super-coding.mdc")
+            : join(cwd ?? process.cwd(), ".cursor", "rules", "super-coding.mdc");
+    }
+    async getConfig() {
+        const j = await readJson(this.daemonConfigPath());
+        return j?.cursor ?? {};
+    }
+    async setConfig(patch) {
+        const j = (await readJson(this.daemonConfigPath())) ?? {};
+        j.cursor = { ...j.cursor, ...patch };
+        await writeJsonAtomic(this.daemonConfigPath(), j);
+        return this.getConfig();
+    }
+    unsupported() {
+        throw new RpcException("unsupported", "cursor 不支持 skill 管理");
+    }
+    async listSkills() {
+        this.unsupported();
+    }
+    async installSkill() {
+        this.unsupported();
+    }
+    async removeSkill() {
+        this.unsupported();
+    }
+    async listMcp() {
+        const j = await readJson(this.mcpPath());
+        // env/headers 的值可能是 API Key：对外只回键名
+        return maskMcpServers(j?.mcpServers ?? {});
+    }
+    async addMcp(name, spec) {
+        if (!isValidName(name))
+            throw new RpcException("bad_params", `invalid mcp name: ${name}`);
+        const j = (await readJson(this.mcpPath())) ?? {};
+        const servers = j.mcpServers ?? {};
+        // 掩码项沿用旧值，避免把 *** 写进配置
+        servers[name] = mergeMcpSecrets(spec, servers[name]);
+        j.mcpServers = servers;
+        await writeJsonAtomic(this.mcpPath(), j);
+    }
+    async removeMcp(name) {
+        const j = await readJson(this.mcpPath());
+        const servers = j?.mcpServers;
+        if (!servers || !(name in servers))
+            return;
+        delete servers[name];
+        await writeJsonAtomic(this.mcpPath(), j);
+    }
+    async getMemory(scope, cwd) {
+        const path = this.memoryPath(scope, cwd);
+        let content = "";
+        try {
+            content = await readFile(path, "utf8");
+        }
+        catch {
+            // 文件不存在按空内容
+        }
+        return { path, content };
+    }
+    async putMemory(scope, content, cwd) {
+        const path = this.memoryPath(scope, cwd);
+        await mkdir(join(path, ".."), { recursive: true });
+        await writeFile(path, content);
+        return { path };
+    }
+}

package/dist/daemon/services/json-file.js

@@ -0,0 +1,21 @@
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import { dirname } from "node:path";
+/** 读 JSON 文件；不存在/解析失败返回 null */
+export async function readJson(path) {
+    try {
+        return JSON.parse(await readFile(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+/** 原子写 JSON：先写临时文件再 rename，避免半截文件损坏配置 */
+export async function writeJsonAtomic(path, data) {
+    await mkdir(dirname(path), { recursive: true });
+    const tmp = `${path}.${randomUUID()}.tmp`;
+    await writeFile(tmp, JSON.stringify(data, null, 2) + "\n");
+    await rename(tmp, path);
+}
+/** 名称白名单（防路径穿越）：小写字母/数字/中划线/下划线/点 */
+export const isValidName = (name) => /^[a-z0-9][a-z0-9._-]{0,63}$/i.test(name) && !name.includes("..");

package/dist/daemon/services/log-buffer.js

@@ -0,0 +1,43 @@
+/** daemon 日志环形缓冲：tee console 输出，供 log:tail RPC 远程查看 */
+import { appendFileSync } from "node:fs";
+export class LogBuffer {
+    capacity;
+    lines = [];
+    constructor(capacity = 500) {
+        this.capacity = capacity;
+    }
+    write(line) {
+        this.lines.push(line);
+        if (this.lines.length > this.capacity) {
+            this.lines.splice(0, this.lines.length - this.capacity);
+        }
+    }
+    tail(limit = 100) {
+        return this.lines.slice(-Math.max(1, Math.min(limit, this.capacity)));
+    }
+    /**
+     * 接管 console.log/warn/error：原样输出 + 落缓冲；logPath 存在且非后台派生
+     * （SC_DAEMON_LOG_VIA_STDIO 未置位）时同时 append 到日志文件——后台模式 stdio
+     * 已重定向到同一文件，env 门控避免双写；前台（TTY/管道）统一落盘。
+     */
+    instrumentConsole(logPath) {
+        const toFile = logPath && !process.env.SC_DAEMON_LOG_VIA_STDIO ? (line) => {
+            try {
+                appendFileSync(logPath, line + "\n");
+            }
+            catch {
+                /* 日志文件不可写不影响运行 */
+            }
+        } : undefined;
+        const fmt = (args) => args.map((a) => (typeof a === "string" ? a : JSON.stringify(a))).join(" ");
+        for (const level of ["log", "warn", "error"]) {
+            const orig = console[level].bind(console);
+            console[level] = (...args) => {
+                const line = fmt(args);
+                this.write(line);
+                toFile?.(line);
+                orig(...args);
+            };
+        }
+    }
+}

package/dist/daemon/services/mcp-secrets.js

@@ -0,0 +1,36 @@
+export const MCP_SECRET_MASK = "***";
+const maskRecord = (record) => record ? Object.fromEntries(Object.keys(record).map((key) => [key, MCP_SECRET_MASK])) : undefined;
+/** 单个 server 的对外视图：env/headers 只保留键名 */
+export function maskMcpSpec(spec) {
+    const env = maskRecord(spec.env);
+    const headers = maskRecord(spec.headers);
+    return {
+        ...spec,
+        ...(env ? { env } : {}),
+        ...(headers ? { headers } : {}),
+    };
+}
+/** 整表脱敏（mcp:list 回包） */
+export function maskMcpServers(servers) {
+    return Object.fromEntries(Object.entries(servers).map(([name, spec]) => [name, maskMcpSpec(spec)]));
+}
+/** 掩码项回填旧值：新值不是掩码就按新值写（支持真正改密钥） */
+function mergeRecord(next, prev) {
+    if (!next)
+        return undefined;
+    const merged = {};
+    for (const [key, value] of Object.entries(next)) {
+        merged[key] = value === MCP_SECRET_MASK ? (prev?.[key] ?? value) : value;
+    }
+    return merged;
+}
+/** 写回前还原被脱敏的密钥（mcp:add 的 spec 可能来自 list 的编辑结果） */
+export function mergeMcpSecrets(next, prev) {
+    const env = mergeRecord(next.env, prev?.env);
+    const headers = mergeRecord(next.headers, prev?.headers);
+    return {
+        ...next,
+        ...(env ? { env } : {}),
+        ...(headers ? { headers } : {}),
+    };
+}

package/dist/daemon/session/store.js

@@ -0,0 +1,137 @@
+import { DatabaseSync } from "node:sqlite";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { mkdirSync } from "node:fs";
+const DEFAULT_DB = join(homedir(), ".super-coding", "runs.db");
+/**
+ * daemon 本地持久化：任务与事件流。
+ * seq 按 run 单调递增（从 1 开始）——server 断线重连后按 (run_id, last_seq) 增量补发。
+ */
+export class RunStore {
+    db;
+    constructor(dbPath) {
+        const path = dbPath ?? DEFAULT_DB;
+        if (path !== ":memory:") {
+            mkdirSync(join(path, ".."), { recursive: true });
+        }
+        this.db = new DatabaseSync(path);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS runs(
+        run_id TEXT PRIMARY KEY,
+        agent TEXT,
+        cwd TEXT,
+        status TEXT DEFAULT 'running',
+        native_session_id TEXT,
+        createdAt INTEGER,
+        server_seq INTEGER NOT NULL DEFAULT 0
+      );
+      CREATE TABLE IF NOT EXISTS events(
+        run_id TEXT,
+        seq INTEGER,
+        event TEXT,
+        PRIMARY KEY(run_id, seq)
+      );
+    `);
+        // 旧 runs.db 原地升级：新增列都要幂等补齐（老库没有这些列时 SELECT 会直接报错）
+        const columns = this.db.prepare("PRAGMA table_info(runs)").all();
+        const has = (name) => columns.some((c) => c.name === name);
+        if (!has("server_seq")) {
+            this.db.exec("ALTER TABLE runs ADD COLUMN server_seq INTEGER NOT NULL DEFAULT 0");
+        }
+        if (!has("business_agent_id")) {
+            this.db.exec("ALTER TABLE runs ADD COLUMN business_agent_id TEXT");
+        }
+        if (!has("agent_slug")) {
+            this.db.exec("ALTER TABLE runs ADD COLUMN agent_slug TEXT");
+        }
+    }
+    createRun(t) {
+        this.db
+            .prepare("INSERT INTO runs(run_id, agent, cwd, native_session_id, business_agent_id, agent_slug, createdAt)"
+            + " VALUES(?,?,?,?,?,?,?)")
+            .run(t.run_id, t.agent, t.cwd, t.native_session_id ?? null, t.business_agent_id ?? null, t.agent_slug ?? null, Date.now());
+    }
+    /** 在事务内分配下一个 seq 并写入事件，返回分配的 seq */
+    appendEvent(run_id, event) {
+        this.db.exec("BEGIN");
+        try {
+            const row = this.db
+                .prepare("SELECT COALESCE(MAX(seq), 0) + 1 AS seq FROM events WHERE run_id = ?")
+                .get(run_id);
+            this.db
+                .prepare("INSERT INTO events(run_id, seq, event) VALUES(?,?,?)")
+                .run(run_id, row.seq, JSON.stringify(event));
+            this.db.exec("COMMIT");
+            return row.seq;
+        }
+        catch (err) {
+            this.db.exec("ROLLBACK");
+            throw err;
+        }
+    }
+    eventsAfter(run_id, afterSeq) {
+        const rows = this.db
+            .prepare("SELECT seq, event FROM events WHERE run_id = ? AND seq > ? ORDER BY seq ASC")
+            .all(run_id, afterSeq);
+        return rows.map((r) => ({ seq: r.seq, event: JSON.parse(r.event) }));
+    }
+    /** 只以 CES 返回的水位确认为准，单调推进；发送成功不代表已持久化 */
+    acknowledge(run_id, lastSeq) {
+        if (!Number.isInteger(lastSeq) || lastSeq < 0)
+            return;
+        this.db.prepare("UPDATE runs SET server_seq = MAX(server_seq, ?) WHERE run_id = ?").run(lastSeq, run_id);
+    }
+    /** 本地有事件但 CES 尚未确认的全部运行，终态也包含在内 */
+    pendingSync() {
+        return this.db.prepare(`
+      WITH progress AS (
+        SELECT runs.run_id, runs.createdAt, runs.server_seq,
+          COALESCE(MAX(events.seq), 0) AS local_seq
+        FROM runs LEFT JOIN events ON events.run_id = runs.run_id
+        GROUP BY runs.run_id, runs.createdAt, runs.server_seq
+      )
+      SELECT run_id, local_seq, server_seq FROM progress
+      WHERE local_seq > server_seq
+      ORDER BY createdAt ASC, run_id ASC
+    `).all();
+    }
+    setStatus(run_id, status) {
+        this.db.prepare("UPDATE runs SET status = ? WHERE run_id = ?").run(status, run_id);
+    }
+    setNativeSessionId(run_id, id) {
+        this.db.prepare("UPDATE runs SET native_session_id = ? WHERE run_id = ?").run(id, run_id);
+    }
+    /** resume 续会话复用目录：按 (agent, 原生会话 id) 取最早任务的执行目录（防跨 agent 撞 id） */
+    findCwdByNativeSession(native_session_id, agent) {
+        const row = this.db
+            .prepare("SELECT cwd FROM runs WHERE native_session_id = ? AND agent = ? ORDER BY createdAt ASC, rowid ASC LIMIT 1")
+            .get(native_session_id, agent);
+        return row?.cwd ?? null;
+    }
+    /** 续聊校验：按 (agent, 原生会话 id) 取最早一条运行（用于 agent 绑定一致性检查） */
+    findRunByNativeSession(native_session_id, agent) {
+        const row = this.db
+            .prepare("SELECT run_id, agent, cwd, status, native_session_id, business_agent_id, agent_slug, createdAt, server_seq"
+            + " FROM runs WHERE native_session_id = ? AND agent = ? ORDER BY createdAt ASC, rowid ASC LIMIT 1")
+            .get(native_session_id, agent);
+        return row ?? null;
+    }
+    getRun(run_id) {
+        const row = this.db
+            .prepare("SELECT run_id, agent, cwd, status, native_session_id, business_agent_id, agent_slug, createdAt, server_seq"
+            + " FROM runs WHERE run_id = ?")
+            .get(run_id);
+        return row ?? null;
+    }
+    /** 全部任务（新→旧），可按 status 过滤 */
+    listRuns(status) {
+        const sql = "SELECT run_id, agent, cwd, status, native_session_id, business_agent_id, agent_slug, createdAt, server_seq FROM runs"
+            + (status ? " WHERE status = ?" : "")
+            + " ORDER BY createdAt DESC";
+        const rows = (status ? this.db.prepare(sql).all(status) : this.db.prepare(sql).all());
+        return rows;
+    }
+    close() {
+        this.db.close();
+    }
+}