@armadra/agent 0.3.0 → 0.5.0

package/dist/session/stats-scan.js

@@ -0,0 +1,236 @@
+/**
+ * `ama stats` 的单文件摘要（只读、按行）。[W4-D]
+ *
+ * 一个会话文件 → 若干「桶」：按（本地日期、请求来源 kind、provider、model、channel）累加。
+ * - 请求来源：assistant 消息 = `turn`；`usage` 条目用自己的 `kind`（cache_warm、permission_classify…）；
+ *   `compaction` / `branch_summary` 带的 usage 记为同名 kind（模型取最近一条 assistant 的）。
+ * - token：input（不含缓存）/ output / cacheRead / cacheWrite；费用只累加有 `usage.cost` 的请求，
+ *   `costed` 记有价请求数，展示层据此区分「有价」「部分无价」「全无价」。
+ * - 缓存三态：桶记下是否出现过 cacheRead > 0 或 cacheWrite > 0（`cacheSeen`）；汇总时同一端点
+ *   （provider/model@channel）任一桶出现过即算报告缓存，其余端点不进命中率分母（同会话层三态）。
+ * - 回合：非 `steer` 的用户消息开始一个回合，到下一个回合开始为止；回合计入首条 assistant 的桶，
+ *   耗时 = 最后一条 assistant 条目时间 − 用户消息条目时间（都是落盘时间戳）。没有 assistant 的回合不计。
+ * - 工具调用：assistant 内容里的 toolCall 块按名字计（codemode 内层调用不展开）。
+ * - 重试：`context_edit{reason:"retry"}` 计入当时最近一条 assistant 的桶；`stopReason:"error"` 计错误。
+ * - toolResult、custom、label 等行按前缀跳过、不解析；末尾半行忽略；中间坏行跳过并计数。
+ * - channel：最近一条 `model_change` 与该请求同 provider / model 时取它的 channel。
+ */
+import { forEachLine, lineType } from "./scan.js";
+const SKIP_TYPES = new Set([
+    "custom",
+    "custom_message",
+    "label",
+    "leaf",
+    "session_info",
+    "thinking_level_change",
+]);
+function pad(n) {
+    return n < 10 ? `0${n}` : String(n);
+}
+/** ISO → 本地日期；不可解析 → undefined。 */
+export function localDay(iso) {
+    if (typeof iso !== "string")
+        return undefined;
+    const ms = Date.parse(iso);
+    if (!Number.isFinite(ms))
+        return undefined;
+    const d = new Date(ms);
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+}
+const isRec = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+const num = (v) => (typeof v === "number" && Number.isFinite(v) ? v : 0);
+export function summarizeSessionFile(file) {
+    let header;
+    const buckets = new Map();
+    const tools = new Map();
+    let badLines = 0;
+    let channel;
+    let lastAssistant;
+    let lastBucket;
+    let turn;
+    const bucketOf = (day, kind, ref) => {
+        const key = `${day}\u0000${kind}\u0000${ref.provider}\u0000${ref.model}\u0000${ref.channel ?? ""}`;
+        let bucket = buckets.get(key);
+        if (bucket === undefined) {
+            bucket = {
+                day,
+                kind,
+                provider: ref.provider,
+                model: ref.model,
+                requests: 0,
+                input: 0,
+                output: 0,
+                cacheRead: 0,
+                cacheWrite: 0,
+                cost: 0,
+                costed: 0,
+                cacheSeen: false,
+                errors: 0,
+                retries: 0,
+                turns: 0,
+                turnMs: 0,
+                timedTurns: 0,
+            };
+            if (ref.channel !== undefined)
+                bucket.channel = ref.channel;
+            buckets.set(key, bucket);
+        }
+        return bucket;
+    };
+    const addUsage = (bucket, usage) => {
+        bucket.requests++;
+        if (!isRec(usage))
+            return;
+        const u = usage;
+        bucket.input += num(u.input);
+        bucket.output += num(u.output);
+        bucket.cacheRead += num(u.cacheRead);
+        bucket.cacheWrite += num(u.cacheWrite);
+        if (num(u.cacheRead) > 0 || num(u.cacheWrite) > 0)
+            bucket.cacheSeen = true;
+        if (isRec(u.cost) && typeof u.cost["total"] === "number") {
+            bucket.cost += num(u.cost["total"]);
+            bucket.costed++;
+        }
+    };
+    const refFor = (provider, model) => {
+        const ref = { provider, model };
+        if (channel?.channel !== undefined &&
+            channel.provider === provider &&
+            channel.model === model) {
+            ref.channel = channel.channel;
+        }
+        return ref;
+    };
+    const closeTurn = () => {
+        if (turn?.bucket !== undefined) {
+            turn.bucket.turns++;
+            if (turn.end !== undefined && turn.end >= turn.start) {
+                turn.bucket.turnMs += turn.end - turn.start;
+                turn.bucket.timedTurns++;
+            }
+        }
+        turn = undefined;
+    };
+    try {
+        forEachLine(file, (line, index, last) => {
+            if (index > 0) {
+                const quick = lineType(line);
+                if (quick !== undefined) {
+                    if (SKIP_TYPES.has(quick.type))
+                        return;
+                    if (quick.type === "message" && quick.role === "toolResult")
+                        return;
+                    if (quick.type === "message" && quick.role === "system")
+                        return;
+                }
+            }
+            let value;
+            try {
+                value = JSON.parse(line);
+            }
+            catch {
+                if (!last)
+                    badLines++;
+                return;
+            }
+            if (!isRec(value))
+                return;
+            if (index === 0) {
+                if (value["type"] !== "session" || typeof value["cwd"] !== "string")
+                    return false;
+                header = value;
+                return;
+            }
+            const ts = value["timestamp"];
+            const day = localDay(ts);
+            if (day === undefined)
+                return;
+            switch (value["type"]) {
+                case "model_change": {
+                    const ref = {
+                        provider: String(value["provider"]),
+                        model: String(value["modelId"]),
+                    };
+                    if (typeof value["channel"] === "string")
+                        ref.channel = value["channel"];
+                    channel = ref;
+                    return;
+                }
+                case "message": {
+                    const message = value["message"];
+                    if (!isRec(message))
+                        return;
+                    if (message["role"] === "user") {
+                        if (message["origin"] === "steer" && turn !== undefined)
+                            return;
+                        closeTurn();
+                        turn = { start: Date.parse(ts), day };
+                        return;
+                    }
+                    if (message["role"] !== "assistant")
+                        return;
+                    const ref = refFor(String(message["provider"]), String(message["model"]));
+                    lastAssistant = ref;
+                    const bucket = bucketOf(day, "turn", ref);
+                    lastBucket = bucket;
+                    addUsage(bucket, message["usage"]);
+                    if (message["stopReason"] === "error")
+                        bucket.errors++;
+                    const content = message["content"];
+                    if (Array.isArray(content)) {
+                        for (const block of content) {
+                            if (isRec(block) &&
+                                block["type"] === "toolCall" &&
+                                typeof block["name"] === "string") {
+                                const key = `${day}\u0000${block["name"]}`;
+                                tools.set(key, (tools.get(key) ?? 0) + 1);
+                            }
+                        }
+                    }
+                    if (turn !== undefined) {
+                        if (turn.bucket === undefined)
+                            turn.bucket = bucketOf(turn.day, "turn", ref);
+                        turn.end = Date.parse(ts);
+                    }
+                    return;
+                }
+                case "usage": {
+                    const ref = refFor(String(value["provider"]), String(value["model"]));
+                    addUsage(bucketOf(day, String(value["kind"] ?? "usage"), ref), value["usage"]);
+                    return;
+                }
+                case "compaction":
+                case "branch_summary": {
+                    if (value["usage"] === undefined)
+                        return;
+                    const ref = lastAssistant ?? { provider: "?", model: "?" };
+                    addUsage(bucketOf(day, value["type"], ref), value["usage"]);
+                    return;
+                }
+                case "context_edit":
+                    if (value["reason"] === "retry" && lastBucket !== undefined)
+                        lastBucket.retries++;
+                    return;
+                default:
+                    return;
+            }
+        });
+    }
+    catch {
+        return undefined;
+    }
+    closeTurn();
+    if (header === undefined)
+        return undefined;
+    return {
+        id: String(header["id"]),
+        cwd: String(header["cwd"]),
+        buckets: [...buckets.values()],
+        tools: [...tools].map(([key, count]) => {
+            const [day = "", name = ""] = key.split("\u0000");
+            return [day, name, count];
+        }),
+        badLines,
+    };
+}

package/dist/session/types.d.ts

@@ -14,6 +14,7 @@
  *   `append()` 同步：返回带 id 的条目并把叶子移到它（落盘可延迟到首条提示，§11.1 第 16 步）。
  * - （W3-C0）第三波 §1.7 / A7：新增 `usage` 条目（保温等不进上下文的请求用量，计入统计）与
  *   非条目的 `leaf` 行（`/tree` 位置落盘）；都是 v1 可选行，格式版本不升。
+ * - （W5-C0）`context_edit.reason` 加 `image_budget`（第五波 §4）；格式版本不升。
  */
 import type { ContentBlock, Message, ModelThinkingLevel, Usage } from "../ai/types.js";
 export declare const SESSION_FORMAT_VERSION: 1;
@@ -60,7 +61,8 @@ export interface BranchSummaryEntry extends EntryBase {
     usage?: Usage;
     details?: FileOpsDetails;
 }
-export type ContextEditReason = "prune" | "abort" | "retry" | "overflow" | "manual";
+/** [W5-C0] `image_budget`：单请求图片总量超预算时把旧图换成占位文本（wave5-plan §4）。 */
+export type ContextEditReason = "prune" | "abort" | "retry" | "overflow" | "manual" | "image_budget";
 /** 同一目标最新一条赢；replacement 为 null 表示从上下文剔除。 */
 export interface ContextEditEntry extends EntryBase {
     type: "context_edit";

package/dist/session/types.js

@@ -14,5 +14,6 @@
  *   `append()` 同步：返回带 id 的条目并把叶子移到它（落盘可延迟到首条提示，§11.1 第 16 步）。
  * - （W3-C0）第三波 §1.7 / A7：新增 `usage` 条目（保温等不进上下文的请求用量，计入统计）与
  *   非条目的 `leaf` 行（`/tree` 位置落盘）；都是 v1 可选行，格式版本不升。
+ * - （W5-C0）`context_edit.reason` 加 `image_budget`（第五波 §4）；格式版本不升。
  */
 export const SESSION_FORMAT_VERSION = 1;

package/dist/skills/builtin.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 内置 Skill（替代把 ama 自身文档塞进系统提示）。
+ *
+ * 系统提示里只常驻索引的一条（名字 + 一句描述，约 60 token），正文按需读取。单文件 bundle 没有
+ * docs 目录，所以正文是内联的配置速查（≤ 3 KB），会话发现时写到 `<dataDir>/builtin/<名>.md`（路径短，进前缀）
+ * （内容不变不重写），模型用 read 读、用户用 `/skill:ama-docs` 调用都走现成路径。
+ *
+ * - 排在全部用户 / 项目 Skill 之后：同名时用户的优先，内置的静默让位（不报重名 warning）。
+ * - 路径只取决于数据目录，会话开始时确定、会话内不变，不影响前缀稳定（设计 §9.1）。
+ * - 写盘失败只记 warning 并跳过该内置 Skill。
+ */
+import type { Skill } from "./discover.js";
+export declare const BUILTIN_SKILLS_DIR = "builtin";
+export interface BuiltinSkill {
+    name: string;
+    description: string;
+    body: string;
+}
+export declare const BUILTIN_SKILLS: readonly BuiltinSkill[];
+export declare function builtinSkillPath(dataDir: string, name: string): string;
+/** 是否内置 Skill（启动头的「已加载」只数用户 / 项目的）。 */
+export declare function isBuiltinSkill(skill: {
+    name: string;
+    location: string;
+}): boolean;
+export declare function builtinSkillText(skill: BuiltinSkill): string;
+/** 在已发现的 Skill 之后追加内置 Skill（同名让位给已有的）；返回新数组与 warning。 */
+export declare function withBuiltinSkills(skills: readonly Skill[], dataDir: string, builtins?: readonly BuiltinSkill[]): Promise<{
+    skills: Skill[];
+    warnings: string[];
+}>;

package/dist/skills/builtin.js

@@ -0,0 +1,109 @@
+/**
+ * 内置 Skill（替代把 ama 自身文档塞进系统提示）。
+ *
+ * 系统提示里只常驻索引的一条（名字 + 一句描述，约 60 token），正文按需读取。单文件 bundle 没有
+ * docs 目录，所以正文是内联的配置速查（≤ 3 KB），会话发现时写到 `<dataDir>/builtin/<名>.md`（路径短，进前缀）
+ * （内容不变不重写），模型用 read 读、用户用 `/skill:ama-docs` 调用都走现成路径。
+ *
+ * - 排在全部用户 / 项目 Skill 之后：同名时用户的优先，内置的静默让位（不报重名 warning）。
+ * - 路径只取决于数据目录，会话开始时确定、会话内不变，不影响前缀稳定（设计 §9.1）。
+ * - 写盘失败只记 warning 并跳过该内置 Skill。
+ */
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+export const BUILTIN_SKILLS_DIR = "builtin";
+const AMA_DOCS_BODY = `# ama quick reference
+
+ama is the coding agent running this session. Docs: https://github.com/Owlbay/armadra-agent (README.md, docs/).
+
+## Files
+- User config dir \`~/.config/ama/\` (\`AMA_CONFIG_DIR\`; Windows \`%APPDATA%\\ama\`): \`config.json\`, \`auth.json\` (keys, 0600), \`hooks.json\`, \`keybindings.json\`, \`trust.json\`, \`AGENTS.md\`, \`skills/\`, \`prompts/\`.
+- Data dir \`~/.local/share/ama/\` (\`AMA_DATA_DIR\`): \`sessions/\` (JSONL), \`models-dev.json\`.
+- Project: \`AGENTS.md\` (found upward from cwd), \`.ama/config.json\` (can only tighten), \`.ama/hooks.json\`, \`.ama/skills/\`, \`.ama/prompts/\` (need trust).
+- Merge order: defaults < user < profile < project. \`ama config show\` prints effective values and sources; \`ama config path\`, \`ama config edit\`, \`ama doctor\`.
+
+## config.json (common keys)
+\`\`\`json
+{ "version": 1, "defaultModel": "provider/model-id", "thinkingLevel": "medium",
+  "permission": { "mode": "default", "allow": ["bash(git status*)"], "deny": ["write(**/.env*)"] },
+  "tools": { "preset": "default", "default": ["+task", "-glob"] }, "providers": {} }
+\`\`\`
+Other sections have defaults: compaction, retry, codemode, hooks, ui, skills, cache, request.
+
+## Providers and models
+- Zero config: set a standard key env var (ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, DEEPSEEK_API_KEY, ...). \`OPENAI_BASE_URL\` / \`ANTHROPIC_BASE_URL\` are honored.
+- Store a key: \`ama auth set <provider>\` (reads stdin), \`ama auth list\`, \`ama auth remove <provider>\`. Never put keys in config; use \`"apiKey": "$ENV_VAR"\` or \`"!command"\`.
+- Relay / custom endpoint: \`ama providers add <name> --base-url <url> --key-env VAR --probe\`; models may set \`"api"\`: openai-completions | openai-responses | anthropic-messages | google-generative-ai.
+- \`ama models list\`, \`ama models discover <provider>\`, \`ama models check provider/model\`. Model refs are \`provider/model[@channel]\`; switch with \`--model\` or \`/model\`.
+
+## Permissions
+Modes (\`--permission-mode\`, \`permission.mode\`, \`/permission\`, Shift+Tab): plan, default (ask for writes and commands), auto-edit, auto, full-auto, allowlist. Rules like \`bash(git push*)\`, \`write(src/**)\`; \`--allow\` / \`--deny\`. Dangerous commands always ask. Unattended runs (-p, RPC) treat "ask" as deny.
+
+## Tools
+Presets (\`--tools-preset\`, \`tools.preset\`): default, minimal, codemode-only, coordinator. \`/tools\` toggles tools; \`--codemode off|on|only\`.
+
+## Sessions and rewind
+- \`-c\` continues the latest session here, \`-r [id]\` resumes; \`/resume\`, \`/new\`, \`/fork\`, \`/tree\`, \`/compact\`.
+- \`/rewind\` (or Esc Esc when idle) returns to before a user message: both, conversation only, or code only (edit/write checkpoints).
+- \`ama sessions search|show|export\`, \`ama stats\`.
+
+## Skills and hooks
+Skills: \`<dir>/<name>/SKILL.md\` with \`name\` and \`description\` frontmatter in \`~/.config/ama/skills/\` or \`.ama/skills/\`; invoke with \`/skill:<name>\`. Hooks: \`hooks.json\` runs commands on PreToolUse, PostToolUse, UserPromptSubmit, Stop and more.
+`;
+export const BUILTIN_SKILLS = Object.freeze([
+    {
+        name: "ama-docs",
+        description: "How to configure and use ama itself.",
+        body: AMA_DOCS_BODY,
+    },
+]);
+export function builtinSkillPath(dataDir, name) {
+    return join(dataDir, BUILTIN_SKILLS_DIR, `${name}.md`);
+}
+/** 是否内置 Skill（启动头的「已加载」只数用户 / 项目的）。 */
+export function isBuiltinSkill(skill) {
+    return (BUILTIN_SKILLS.some((b) => b.name === skill.name) &&
+        skill.location.endsWith(join(BUILTIN_SKILLS_DIR, `${skill.name}.md`)));
+}
+export function builtinSkillText(skill) {
+    return `---\nname: ${skill.name}\ndescription: ${skill.description}\n---\n\n${skill.body}`;
+}
+async function ensureFile(path, text) {
+    try {
+        if ((await readFile(path, "utf8")) === text)
+            return;
+    }
+    catch {
+        // 不存在：下面写
+    }
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, text, "utf8");
+}
+/** 在已发现的 Skill 之后追加内置 Skill（同名让位给已有的）；返回新数组与 warning。 */
+export async function withBuiltinSkills(skills, dataDir, builtins = BUILTIN_SKILLS) {
+    const out = [...skills];
+    const warnings = [];
+    const taken = new Set(skills.map((skill) => skill.name));
+    for (const builtin of builtins) {
+        if (taken.has(builtin.name))
+            continue;
+        const baseDir = join(dataDir, BUILTIN_SKILLS_DIR);
+        const location = builtinSkillPath(dataDir, builtin.name);
+        try {
+            await ensureFile(location, builtinSkillText(builtin));
+        }
+        catch (error) {
+            warnings.push(`内置 Skill ${builtin.name} 写入失败：${error.message}`);
+            continue;
+        }
+        out.push({
+            name: builtin.name,
+            description: builtin.description,
+            location,
+            baseDir,
+            disableModelInvocation: false,
+            scope: "builtin",
+        });
+    }
+    return { skills: out, warnings };
+}

package/dist/skills/discover.d.ts

@@ -10,7 +10,8 @@
  * frontmatter：`name`（≤ 64，`^[a-z0-9-]+$`，缺省取目录名）、`description`（必填，≤ 1024）、
  * `disable-model-invocation`、`allowed-tools`（只做提示）。
  */
-export type SkillScope = "cli" | "profile" | "config" | "user" | "project" | "ancestor";
+/** `builtin`：随 ama 分发的内置 Skill（builtin.ts），排在最后，同名让位。 */
+export type SkillScope = "cli" | "profile" | "config" | "user" | "project" | "ancestor" | "builtin";
 export interface SkillSource {
     dir: string;
     scope: SkillScope;

package/dist/skills/index-prompt.js

@@ -18,24 +18,21 @@ export function formatSkillIndex(skills, options) {
         return "";
     let how;
     if (options.hasSkillTool) {
-        how =
-            "Call the skill tool with a skill's name to load it when the task matches its description.";
+        how = "call the skill tool with its name";
     }
     else if (options.hasReadTool) {
-        how = "Use the read tool to load a skill's file when the task matches its description.";
+        how = "read its file";
     }
     else {
         return "";
     }
+    // 每个字都进缓存前缀（预算见 src/cli/prompt-budget.test.ts），说明保持一行。
     const lines = [
-        "The following skills provide specialized instructions for specific tasks.",
-        how,
-        "When a skill file references a relative path, resolve it against the skill's directory.",
-        "",
+        `Skills: when a task matches one, ${how} first; resolve its relative paths against its directory.`,
         "<available_skills>",
     ];
     for (const s of visible) {
-        lines.push("  <skill>", `    <name>${escapeXml(s.name)}</name>`, `    <description>${escapeXml(s.description)}</description>`, `    <location>${escapeXml(s.location)}</location>`, "  </skill>");
+        lines.push(`<skill name="${escapeXml(s.name)}" location="${escapeXml(s.location)}">${escapeXml(s.description)}</skill>`);
     }
     lines.push("</available_skills>");
     return lines.join("\n");

package/dist/tools/background-jobs.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 后台命令（docs/wave5-plan.md §8.3 H6，D29：不加新工具，`bash{background}` + `bash{job, action}`）。[W5-H2]
+ *
+ * - `start`：调用方（bash.ts）给出 `spawn(stdout)`——**进程只在 bash.ts 的 `spawnShell` 里创建**，
+ *   这里只拿到 ChildProcess；stdout / stderr 直接写进 `outputPath`（文件描述符交给子进程，ama 退出也不
+ *   会因管道断开而 SIGPIPE）。POSIX 自成进程组并登记（进程退出时同步 SIGKILL 残留组）。
+ * - `wait(id, timeoutMs)`：等到退出或超时；`stop(id)`：杀整棵树（SIGTERM → 宽限 → SIGKILL）；
+ *   `output(id)`：读输出文件尾部（2000 行 / 50 KB）。
+ * - 生命周期事件经 `onChange` 发出（started / exited / stopped）；`takeExited()` 取走尚未通知的已退出
+ *   任务（提醒通道 reminders.ts 据此告诉模型「后台命令 jobId 已退出（码 N）」）。
+ * - 按会话 id 登记（`jobsForSession`）；`disposeSessionJobs` 在会话 dispose 时回收进程树。
+ */
+import type { ChildProcess } from "node:child_process";
+import { type ProcessDeps } from "./process-tree.js";
+import { type TruncateResult } from "./truncate.js";
+export type JobStatus = "running" | "exited" | "stopped";
+export interface Job {
+    id: string;
+    command: string;
+    cwd: string;
+    pid?: number;
+    outputPath: string;
+    startedAt: number;
+    status: JobStatus;
+    /** 退出码（信号退出为 128 + signo）；运行中 undefined。 */
+    exitCode?: number;
+    endedAt?: number;
+}
+export interface JobStartOptions {
+    cwd: string;
+    outputPath: string;
+    /** 用给定的输出文件描述符启动进程（bash.ts 的 spawnShell）。 */
+    spawn(outputFd: number): ChildProcess;
+    processDeps?: ProcessDeps;
+}
+export type JobChange = {
+    phase: "started" | "exited" | "stopped";
+    job: Job;
+};
+/** 后台 bash 的查询形状：`{ job, action: wait | stop | output }`，不带 command。 */
+export declare function isBackgroundJobQuery(toolName: string, input: unknown): boolean;
+export declare class BackgroundJobs {
+    private readonly entries;
+    private readonly listeners;
+    private seq;
+    start(command: string, options: JobStartOptions): Job;
+    get(id: string): Job | undefined;
+    list(): Job[];
+    /** 等到退出或超时（`signal` 可提前结束等待，不杀进程）。 */
+    wait(id: string, timeoutMs: number, signal?: AbortSignal): Promise<Job | undefined>;
+    stop(id: string): Promise<Job | undefined>;
+    /** 输出文件尾部（2000 行 / 50 KB）。 */
+    output(id: string): (TruncateResult & {
+        job: Job;
+    }) | undefined;
+    /** 取走已退出、尚未通知的任务（提醒通道用；wait 已看到退出的也算已知）。 */
+    takeExited(): Job[];
+    /** 标记为已知（模型已经通过 wait / output 看到了退出）。 */
+    markSeen(id: string): void;
+    onChange(listener: (change: JobChange) => void): () => void;
+    get running(): number;
+    /** 杀掉全部仍在运行的任务（会话 dispose）。 */
+    disposeAll(): Promise<void>;
+    private notify;
+}
+/** 会话的后台任务表（按会话 id，首次使用时建）。 */
+export declare function jobsForSession(sessionId: string): BackgroundJobs;
+/** 已有的任务表（不新建）。 */
+export declare function existingJobs(sessionId: string): BackgroundJobs | undefined;
+/** 会话 dispose：杀掉该会话仍在运行的后台任务并注销。 */
+export declare function disposeSessionJobs(sessionId: string): Promise<void>;