iosm-cli 0.2.13 → 0.2.14

package/dist/core/subagent-background-runs.js

@@ -0,0 +1,275 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync, } from "node:fs";
+import { join, resolve } from "node:path";
+const BACKGROUND_DIR_SEGMENTS = [".iosm", "subagents", "background"];
+const runningControllers = new Map();
+function isStatus(value) {
+    return value === "queued" || value === "running" || value === "done" || value === "error" || value === "cancelled";
+}
+function isTerminalStatus(status) {
+    return status === "done" || status === "error" || status === "cancelled";
+}
+function getRootKey(rootCwd) {
+    return resolve(rootCwd).toLowerCase();
+}
+function getBackgroundDir(rootCwd) {
+    return join(resolve(rootCwd), ...BACKGROUND_DIR_SEGMENTS);
+}
+function getMetaPath(rootCwd, runId) {
+    return join(getBackgroundDir(rootCwd), `${runId}.json`);
+}
+export function getSubagentBackgroundRunLogPath(rootCwd, runId) {
+    return join(getBackgroundDir(rootCwd), `${runId}.log`);
+}
+function parseRecord(metaPath) {
+    try {
+        const parsed = JSON.parse(readFileSync(metaPath, "utf8"));
+        if (typeof parsed.runId !== "string" ||
+            !isStatus(parsed.status) ||
+            typeof parsed.createdAt !== "string" ||
+            typeof parsed.description !== "string" ||
+            typeof parsed.profile !== "string" ||
+            typeof parsed.cwd !== "string") {
+            return undefined;
+        }
+        const runId = parsed.runId.trim();
+        if (!runId)
+            return undefined;
+        return {
+            runId,
+            status: parsed.status,
+            createdAt: parsed.createdAt,
+            startedAt: typeof parsed.startedAt === "string" ? parsed.startedAt : undefined,
+            finishedAt: typeof parsed.finishedAt === "string" ? parsed.finishedAt : undefined,
+            description: parsed.description,
+            profile: parsed.profile,
+            cwd: parsed.cwd,
+            agent: typeof parsed.agent === "string" && parsed.agent.trim().length > 0 ? parsed.agent : undefined,
+            model: typeof parsed.model === "string" && parsed.model.trim().length > 0 ? parsed.model : undefined,
+            error: typeof parsed.error === "string" && parsed.error.trim().length > 0 ? parsed.error : undefined,
+            transcriptPath: typeof parsed.transcriptPath === "string" && parsed.transcriptPath.trim().length > 0
+                ? parsed.transcriptPath
+                : undefined,
+            requestedStopAt: typeof parsed.requestedStopAt === "string" && parsed.requestedStopAt.trim().length > 0
+                ? parsed.requestedStopAt
+                : undefined,
+            logPath: typeof parsed.logPath === "string" && parsed.logPath.trim().length > 0
+                ? parsed.logPath
+                : metaPath.replace(/\.json$/i, ".log"),
+            metaPath,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+export function getSubagentBackgroundRun(rootCwd, runId) {
+    const normalizedRunId = runId.trim();
+    if (!normalizedRunId)
+        return undefined;
+    const metaPath = getMetaPath(rootCwd, normalizedRunId);
+    if (!existsSync(metaPath))
+        return undefined;
+    return parseRecord(metaPath);
+}
+export function listSubagentBackgroundRuns(rootCwd, limit = 20) {
+    const dir = getBackgroundDir(rootCwd);
+    if (!existsSync(dir))
+        return [];
+    const files = readdirSync(dir)
+        .filter((name) => name.toLowerCase().endsWith(".json"))
+        .map((name) => join(dir, name))
+        .sort((a, b) => b.localeCompare(a))
+        .slice(0, Math.max(1, limit));
+    const records = [];
+    for (const file of files) {
+        const parsed = parseRecord(file);
+        if (parsed)
+            records.push(parsed);
+    }
+    records.sort((left, right) => {
+        const byTime = right.createdAt.localeCompare(left.createdAt);
+        if (byTime !== 0)
+            return byTime;
+        return right.runId.localeCompare(left.runId);
+    });
+    return records;
+}
+export function writeSubagentBackgroundRunStatus(rootCwd, input) {
+    try {
+        const normalizedRunId = input.runId.trim();
+        if (!normalizedRunId)
+            return undefined;
+        const dir = getBackgroundDir(rootCwd);
+        mkdirSync(dir, { recursive: true });
+        const existing = getSubagentBackgroundRun(rootCwd, normalizedRunId);
+        const metaPath = getMetaPath(rootCwd, normalizedRunId);
+        const logPath = (input.logPath?.trim() || existing?.logPath || getSubagentBackgroundRunLogPath(rootCwd, normalizedRunId)).trim();
+        const payload = {
+            runId: normalizedRunId,
+            status: input.status,
+            createdAt: input.createdAt,
+            startedAt: input.startedAt,
+            finishedAt: input.finishedAt,
+            description: input.description,
+            profile: input.profile,
+            cwd: input.cwd,
+            agent: input.agent,
+            model: input.model,
+            error: input.error,
+            transcriptPath: input.transcriptPath,
+            requestedStopAt: input.requestedStopAt ?? existing?.requestedStopAt,
+            logPath,
+        };
+        writeFileSync(metaPath, `${JSON.stringify(payload, null, 2)}\n`, "utf8");
+        return metaPath;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function appendSubagentBackgroundRunLog(rootCwd, runId, message) {
+    try {
+        const normalizedRunId = runId.trim();
+        if (!normalizedRunId)
+            return undefined;
+        const dir = getBackgroundDir(rootCwd);
+        mkdirSync(dir, { recursive: true });
+        const logPath = getSubagentBackgroundRunLogPath(rootCwd, normalizedRunId);
+        const line = `[${new Date().toISOString()}] ${message}\n`;
+        appendFileSync(logPath, line, "utf8");
+        return logPath;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function readSubagentBackgroundRunLogTail(rootCwd, runId, lines = 120) {
+    const record = getSubagentBackgroundRun(rootCwd, runId);
+    if (!record)
+        return undefined;
+    const maxLines = Math.max(1, Math.min(1000, Math.floor(lines)));
+    if (!existsSync(record.logPath))
+        return "";
+    try {
+        const content = readFileSync(record.logPath, "utf8");
+        const entries = content.split(/\r?\n/);
+        while (entries.length > 0 && entries[entries.length - 1] === "") {
+            entries.pop();
+        }
+        return entries.slice(-maxLines).join("\n");
+    }
+    catch {
+        return "";
+    }
+}
+export function registerSubagentBackgroundRunController(rootCwd, runId, controller) {
+    const normalizedRunId = runId.trim();
+    if (!normalizedRunId)
+        return;
+    const rootKey = getRootKey(rootCwd);
+    const byRun = runningControllers.get(rootKey) ?? new Map();
+    byRun.set(normalizedRunId, controller);
+    runningControllers.set(rootKey, byRun);
+}
+export function unregisterSubagentBackgroundRunController(rootCwd, runId) {
+    const normalizedRunId = runId.trim();
+    if (!normalizedRunId)
+        return;
+    const rootKey = getRootKey(rootCwd);
+    const byRun = runningControllers.get(rootKey);
+    if (!byRun)
+        return;
+    byRun.delete(normalizedRunId);
+    if (byRun.size === 0) {
+        runningControllers.delete(rootKey);
+    }
+}
+function getController(rootCwd, runId) {
+    const rootKey = getRootKey(rootCwd);
+    const byRun = runningControllers.get(rootKey);
+    if (!byRun)
+        return undefined;
+    return byRun.get(runId.trim());
+}
+export function requestStopSubagentBackgroundRun(rootCwd, runId) {
+    const normalizedRunId = runId.trim();
+    if (!normalizedRunId)
+        return undefined;
+    const current = getSubagentBackgroundRun(rootCwd, normalizedRunId);
+    if (!current)
+        return undefined;
+    if (!isTerminalStatus(current.status)) {
+        const requestedStopAt = new Date().toISOString();
+        writeSubagentBackgroundRunStatus(rootCwd, {
+            runId: current.runId,
+            status: current.status,
+            createdAt: current.createdAt,
+            startedAt: current.startedAt,
+            finishedAt: current.finishedAt,
+            description: current.description,
+            profile: current.profile,
+            cwd: current.cwd,
+            agent: current.agent,
+            model: current.model,
+            error: current.error,
+            transcriptPath: current.transcriptPath,
+            requestedStopAt,
+            logPath: current.logPath,
+        });
+        appendSubagentBackgroundRunLog(rootCwd, normalizedRunId, "stop requested");
+    }
+    const controller = getController(rootCwd, normalizedRunId);
+    controller?.abort();
+    return getSubagentBackgroundRun(rootCwd, normalizedRunId);
+}
+export function requestStopAllSubagentBackgroundRuns(rootCwd) {
+    const records = listSubagentBackgroundRuns(rootCwd, 500).filter((record) => !isTerminalStatus(record.status));
+    const requestedIds = [];
+    for (const record of records) {
+        const updated = requestStopSubagentBackgroundRun(rootCwd, record.runId);
+        if (updated)
+            requestedIds.push(updated.runId);
+    }
+    return {
+        requested: requestedIds.length,
+        requestedIds,
+    };
+}
+export function pruneSubagentBackgroundRuns(rootCwd, olderThanHours = 24) {
+    const thresholdHours = Number.isFinite(olderThanHours) ? Math.max(1, Math.floor(olderThanHours)) : 24;
+    const thresholdMs = thresholdHours * 60 * 60 * 1000;
+    const nowMs = Date.now();
+    const records = listSubagentBackgroundRuns(rootCwd, 1000);
+    const removedIds = [];
+    let skippedRunning = 0;
+    let skippedRecent = 0;
+    for (const record of records) {
+        if (!isTerminalStatus(record.status)) {
+            skippedRunning += 1;
+            continue;
+        }
+        const anchor = Date.parse(record.finishedAt ?? record.createdAt);
+        if (!Number.isFinite(anchor) || nowMs - anchor < thresholdMs) {
+            skippedRecent += 1;
+            continue;
+        }
+        try {
+            rmSync(record.metaPath, { force: true });
+            if (record.logPath && existsSync(record.logPath)) {
+                rmSync(record.logPath, { force: true });
+            }
+            removedIds.push(record.runId);
+        }
+        catch {
+            // best effort
+        }
+    }
+    return {
+        removed: removedIds.length,
+        removedIds,
+        skippedRunning,
+        skippedRecent,
+        thresholdHours,
+    };
+}
+//# sourceMappingURL=subagent-background-runs.js.map

package/dist/core/subagent-background-runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-background-runs.js","sourceRoot":"","sources":["../../src/core/subagent-background-runs.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tappendFileSync,\n\texistsSync,\n\tmkdirSync,\n\treadFileSync,\n\treaddirSync,\n\trmSync,\n\twriteFileSync,\n} from \"node:fs\";\nimport { join, resolve } from \"node:path\";\n\nexport type SubagentBackgroundRunStatus = \"queued\" | \"running\" | \"done\" | \"error\" | \"cancelled\";\n\nexport interface SubagentBackgroundRunRecord {\n\trunId: string;\n\tstatus: SubagentBackgroundRunStatus;\n\tcreatedAt: string;\n\tstartedAt?: string;\n\tfinishedAt?: string;\n\tdescription: string;\n\tprofile: string;\n\tcwd: string;\n\tagent?: string;\n\tmodel?: string;\n\terror?: string;\n\ttranscriptPath?: string;\n\trequestedStopAt?: string;\n\tlogPath: string;\n\tmetaPath: string;\n}\n\nexport interface WriteSubagentBackgroundRunStatusInput {\n\trunId: string;\n\tstatus: SubagentBackgroundRunStatus;\n\tcreatedAt: string;\n\tstartedAt?: string;\n\tfinishedAt?: string;\n\tdescription: string;\n\tprofile: string;\n\tcwd: string;\n\tagent?: string;\n\tmodel?: string;\n\terror?: string;\n\ttranscriptPath?: string;\n\trequestedStopAt?: string;\n\tlogPath?: string;\n}\n\nexport interface PruneSubagentBackgroundRunsResult {\n\tremoved: number;\n\tremovedIds: string[];\n\tskippedRunning: number;\n\tskippedRecent: number;\n\tthresholdHours: number;\n}\n\nconst BACKGROUND_DIR_SEGMENTS = [\".iosm\", \"subagents\", \"background\"] as const;\n\nconst runningControllers = new Map<string, Map<string, AbortController>>();\n\nfunction isStatus(value: unknown): value is SubagentBackgroundRunStatus {\n\treturn value === \"queued\" || value === \"running\" || value === \"done\" || value === \"error\" || value === \"cancelled\";\n}\n\nfunction isTerminalStatus(status: SubagentBackgroundRunStatus): boolean {\n\treturn status === \"done\" || status === \"error\" || status === \"cancelled\";\n}\n\nfunction getRootKey(rootCwd: string): string {\n\treturn resolve(rootCwd).toLowerCase();\n}\n\nfunction getBackgroundDir(rootCwd: string): string {\n\treturn join(resolve(rootCwd), ...BACKGROUND_DIR_SEGMENTS);\n}\n\nfunction getMetaPath(rootCwd: string, runId: string): string {\n\treturn join(getBackgroundDir(rootCwd), `${runId}.json`);\n}\n\nexport function getSubagentBackgroundRunLogPath(rootCwd: string, runId: string): string {\n\treturn join(getBackgroundDir(rootCwd), `${runId}.log`);\n}\n\nfunction parseRecord(metaPath: string): SubagentBackgroundRunRecord | undefined {\n\ttry {\n\t\tconst parsed = JSON.parse(readFileSync(metaPath, \"utf8\")) as Partial<SubagentBackgroundRunRecord>;\n\t\tif (\n\t\t\ttypeof parsed.runId !== \"string\" ||\n\t\t\t!isStatus(parsed.status) ||\n\t\t\ttypeof parsed.createdAt !== \"string\" ||\n\t\t\ttypeof parsed.description !== \"string\" ||\n\t\t\ttypeof parsed.profile !== \"string\" ||\n\t\t\ttypeof parsed.cwd !== \"string\"\n\t\t) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst runId = parsed.runId.trim();\n\t\tif (!runId) return undefined;\n\t\treturn {\n\t\t\trunId,\n\t\t\tstatus: parsed.status,\n\t\t\tcreatedAt: parsed.createdAt,\n\t\t\tstartedAt: typeof parsed.startedAt === \"string\" ? parsed.startedAt : undefined,\n\t\t\tfinishedAt: typeof parsed.finishedAt === \"string\" ? parsed.finishedAt : undefined,\n\t\t\tdescription: parsed.description,\n\t\t\tprofile: parsed.profile,\n\t\t\tcwd: parsed.cwd,\n\t\t\tagent: typeof parsed.agent === \"string\" && parsed.agent.trim().length > 0 ? parsed.agent : undefined,\n\t\t\tmodel: typeof parsed.model === \"string\" && parsed.model.trim().length > 0 ? parsed.model : undefined,\n\t\t\terror: typeof parsed.error === \"string\" && parsed.error.trim().length > 0 ? parsed.error : undefined,\n\t\t\ttranscriptPath:\n\t\t\t\ttypeof parsed.transcriptPath === \"string\" && parsed.transcriptPath.trim().length > 0\n\t\t\t\t\t? parsed.transcriptPath\n\t\t\t\t\t: undefined,\n\t\t\trequestedStopAt:\n\t\t\t\ttypeof parsed.requestedStopAt === \"string\" && parsed.requestedStopAt.trim().length > 0\n\t\t\t\t\t? parsed.requestedStopAt\n\t\t\t\t\t: undefined,\n\t\t\tlogPath:\n\t\t\t\ttypeof parsed.logPath === \"string\" && parsed.logPath.trim().length > 0\n\t\t\t\t\t? parsed.logPath\n\t\t\t\t\t: metaPath.replace(/\\.json$/i, \".log\"),\n\t\t\tmetaPath,\n\t\t};\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nexport function getSubagentBackgroundRun(rootCwd: string, runId: string): SubagentBackgroundRunRecord | undefined {\n\tconst normalizedRunId = runId.trim();\n\tif (!normalizedRunId) return undefined;\n\tconst metaPath = getMetaPath(rootCwd, normalizedRunId);\n\tif (!existsSync(metaPath)) return undefined;\n\treturn parseRecord(metaPath);\n}\n\nexport function listSubagentBackgroundRuns(rootCwd: string, limit = 20): SubagentBackgroundRunRecord[] {\n\tconst dir = getBackgroundDir(rootCwd);\n\tif (!existsSync(dir)) return [];\n\tconst files = readdirSync(dir)\n\t\t.filter((name) => name.toLowerCase().endsWith(\".json\"))\n\t\t.map((name) => join(dir, name))\n\t\t.sort((a, b) => b.localeCompare(a))\n\t\t.slice(0, Math.max(1, limit));\n\n\tconst records: SubagentBackgroundRunRecord[] = [];\n\tfor (const file of files) {\n\t\tconst parsed = parseRecord(file);\n\t\tif (parsed) records.push(parsed);\n\t}\n\trecords.sort((left, right) => {\n\t\tconst byTime = right.createdAt.localeCompare(left.createdAt);\n\t\tif (byTime !== 0) return byTime;\n\t\treturn right.runId.localeCompare(left.runId);\n\t});\n\treturn records;\n}\n\nexport function writeSubagentBackgroundRunStatus(\n\trootCwd: string,\n\tinput: WriteSubagentBackgroundRunStatusInput,\n): string | undefined {\n\ttry {\n\t\tconst normalizedRunId = input.runId.trim();\n\t\tif (!normalizedRunId) return undefined;\n\t\tconst dir = getBackgroundDir(rootCwd);\n\t\tmkdirSync(dir, { recursive: true });\n\t\tconst existing = getSubagentBackgroundRun(rootCwd, normalizedRunId);\n\t\tconst metaPath = getMetaPath(rootCwd, normalizedRunId);\n\t\tconst logPath = (input.logPath?.trim() || existing?.logPath || getSubagentBackgroundRunLogPath(rootCwd, normalizedRunId)).trim();\n\t\tconst payload = {\n\t\t\trunId: normalizedRunId,\n\t\t\tstatus: input.status,\n\t\t\tcreatedAt: input.createdAt,\n\t\t\tstartedAt: input.startedAt,\n\t\t\tfinishedAt: input.finishedAt,\n\t\t\tdescription: input.description,\n\t\t\tprofile: input.profile,\n\t\t\tcwd: input.cwd,\n\t\t\tagent: input.agent,\n\t\t\tmodel: input.model,\n\t\t\terror: input.error,\n\t\t\ttranscriptPath: input.transcriptPath,\n\t\t\trequestedStopAt: input.requestedStopAt ?? existing?.requestedStopAt,\n\t\t\tlogPath,\n\t\t};\n\t\twriteFileSync(metaPath, `${JSON.stringify(payload, null, 2)}\\n`, \"utf8\");\n\t\treturn metaPath;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nexport function appendSubagentBackgroundRunLog(rootCwd: string, runId: string, message: string): string | undefined {\n\ttry {\n\t\tconst normalizedRunId = runId.trim();\n\t\tif (!normalizedRunId) return undefined;\n\t\tconst dir = getBackgroundDir(rootCwd);\n\t\tmkdirSync(dir, { recursive: true });\n\t\tconst logPath = getSubagentBackgroundRunLogPath(rootCwd, normalizedRunId);\n\t\tconst line = `[${new Date().toISOString()}] ${message}\\n`;\n\t\tappendFileSync(logPath, line, \"utf8\");\n\t\treturn logPath;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nexport function readSubagentBackgroundRunLogTail(rootCwd: string, runId: string, lines = 120): string | undefined {\n\tconst record = getSubagentBackgroundRun(rootCwd, runId);\n\tif (!record) return undefined;\n\tconst maxLines = Math.max(1, Math.min(1000, Math.floor(lines)));\n\tif (!existsSync(record.logPath)) return \"\";\n\ttry {\n\t\tconst content = readFileSync(record.logPath, \"utf8\");\n\t\tconst entries = content.split(/\\r?\\n/);\n\t\twhile (entries.length > 0 && entries[entries.length - 1] === \"\") {\n\t\t\tentries.pop();\n\t\t}\n\t\treturn entries.slice(-maxLines).join(\"\\n\");\n\t} catch {\n\t\treturn \"\";\n\t}\n}\n\nexport function registerSubagentBackgroundRunController(rootCwd: string, runId: string, controller: AbortController): void {\n\tconst normalizedRunId = runId.trim();\n\tif (!normalizedRunId) return;\n\tconst rootKey = getRootKey(rootCwd);\n\tconst byRun = runningControllers.get(rootKey) ?? new Map<string, AbortController>();\n\tbyRun.set(normalizedRunId, controller);\n\trunningControllers.set(rootKey, byRun);\n}\n\nexport function unregisterSubagentBackgroundRunController(rootCwd: string, runId: string): void {\n\tconst normalizedRunId = runId.trim();\n\tif (!normalizedRunId) return;\n\tconst rootKey = getRootKey(rootCwd);\n\tconst byRun = runningControllers.get(rootKey);\n\tif (!byRun) return;\n\tbyRun.delete(normalizedRunId);\n\tif (byRun.size === 0) {\n\t\trunningControllers.delete(rootKey);\n\t}\n}\n\nfunction getController(rootCwd: string, runId: string): AbortController | undefined {\n\tconst rootKey = getRootKey(rootCwd);\n\tconst byRun = runningControllers.get(rootKey);\n\tif (!byRun) return undefined;\n\treturn byRun.get(runId.trim());\n}\n\nexport function requestStopSubagentBackgroundRun(\n\trootCwd: string,\n\trunId: string,\n): SubagentBackgroundRunRecord | undefined {\n\tconst normalizedRunId = runId.trim();\n\tif (!normalizedRunId) return undefined;\n\tconst current = getSubagentBackgroundRun(rootCwd, normalizedRunId);\n\tif (!current) return undefined;\n\tif (!isTerminalStatus(current.status)) {\n\t\tconst requestedStopAt = new Date().toISOString();\n\t\twriteSubagentBackgroundRunStatus(rootCwd, {\n\t\t\trunId: current.runId,\n\t\t\tstatus: current.status,\n\t\t\tcreatedAt: current.createdAt,\n\t\t\tstartedAt: current.startedAt,\n\t\t\tfinishedAt: current.finishedAt,\n\t\t\tdescription: current.description,\n\t\t\tprofile: current.profile,\n\t\t\tcwd: current.cwd,\n\t\t\tagent: current.agent,\n\t\t\tmodel: current.model,\n\t\t\terror: current.error,\n\t\t\ttranscriptPath: current.transcriptPath,\n\t\t\trequestedStopAt,\n\t\t\tlogPath: current.logPath,\n\t\t});\n\t\tappendSubagentBackgroundRunLog(rootCwd, normalizedRunId, \"stop requested\");\n\t}\n\tconst controller = getController(rootCwd, normalizedRunId);\n\tcontroller?.abort();\n\treturn getSubagentBackgroundRun(rootCwd, normalizedRunId);\n}\n\nexport function requestStopAllSubagentBackgroundRuns(rootCwd: string): {\n\trequested: number;\n\trequestedIds: string[];\n} {\n\tconst records = listSubagentBackgroundRuns(rootCwd, 500).filter((record) => !isTerminalStatus(record.status));\n\tconst requestedIds: string[] = [];\n\tfor (const record of records) {\n\t\tconst updated = requestStopSubagentBackgroundRun(rootCwd, record.runId);\n\t\tif (updated) requestedIds.push(updated.runId);\n\t}\n\treturn {\n\t\trequested: requestedIds.length,\n\t\trequestedIds,\n\t};\n}\n\nexport function pruneSubagentBackgroundRuns(\n\trootCwd: string,\n\tolderThanHours = 24,\n): PruneSubagentBackgroundRunsResult {\n\tconst thresholdHours = Number.isFinite(olderThanHours) ? Math.max(1, Math.floor(olderThanHours)) : 24;\n\tconst thresholdMs = thresholdHours * 60 * 60 * 1000;\n\tconst nowMs = Date.now();\n\tconst records = listSubagentBackgroundRuns(rootCwd, 1000);\n\tconst removedIds: string[] = [];\n\tlet skippedRunning = 0;\n\tlet skippedRecent = 0;\n\n\tfor (const record of records) {\n\t\tif (!isTerminalStatus(record.status)) {\n\t\t\tskippedRunning += 1;\n\t\t\tcontinue;\n\t\t}\n\t\tconst anchor = Date.parse(record.finishedAt ?? record.createdAt);\n\t\tif (!Number.isFinite(anchor) || nowMs - anchor < thresholdMs) {\n\t\t\tskippedRecent += 1;\n\t\t\tcontinue;\n\t\t}\n\t\ttry {\n\t\t\trmSync(record.metaPath, { force: true });\n\t\t\tif (record.logPath && existsSync(record.logPath)) {\n\t\t\t\trmSync(record.logPath, { force: true });\n\t\t\t}\n\t\t\tremovedIds.push(record.runId);\n\t\t} catch {\n\t\t\t// best effort\n\t\t}\n\t}\n\n\treturn {\n\t\tremoved: removedIds.length,\n\t\tremovedIds,\n\t\tskippedRunning,\n\t\tskippedRecent,\n\t\tthresholdHours,\n\t};\n}\n"]}

package/dist/core/tools/task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../src/core/tools/task.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAKN,KAAK,YAAY,EACjB,MAAM,6BAA6B,CAAC;AAcrC,OAAO,EAEN,KAAK,mBAAmB,EAGxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAkD,KAAK,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhH;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE;QACP,gBAAgB,EAAE,MAAM,CAAC;QACzB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,iBAAiB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACF,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;AAErF,MAAM,MAAM,0BAA0B,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnF,MAAM,WAAW,wBAAwB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,0BAA0B,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,EAAE,qBAAqB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,wBAAwB,EAAE,CAAC;CAC3C;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAClD,KAAK,OAAO,CAAC,MAAM,GAAG,iBAAiB,CAAC,CAAC;AAE1C,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;EAsFd,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAEtD,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,YAAY,CAAC,EAAE;QACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,yBAAyB,CAAC,EAAE,MAAM,CAAC;QACnC,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC/B,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,wBAAwB,GAAG,SAAS,CAAC;IAC/E,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;IACpC,4BAA4B,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,2GAA2G;IAC3G,qBAAqB,CAAC,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;IAChD,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;IAC1C,2FAA2F;IAC3F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6GAA6G;IAC7G,kBAAkB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAC9C;AAsoCD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,eAAe,GACvB,SAAS,CAAC,OAAO,UAAU,CAAC,CAopE9B"}
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../src/core/tools/task.ts"],"names":[],"mappings":"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"}

package/dist/core/tools/task.js

@@ -7,6 +7,7 @@ import { buildRetrospectiveDirective, classifyFailureCause, formatFailureCauseCo
 import { MAX_ORCHESTRATION_AGENTS, MAX_ORCHESTRATION_PARALLEL, MAX_SUBAGENT_DELEGATE_PARALLEL, MAX_SUBAGENT_DELEGATION_DEPTH, MAX_SUBAGENT_DELEGATIONS_PER_TASK, } from "../orchestration-limits.js";
 import { AGENT_PROFILES, isReadOnlyProfileName, isValidProfileName, } from "../agent-profiles.js";
 import { readSharedMemory, summarizeSharedMemoryUsage, writeSharedMemory, } from "../shared-memory.js";
+import { appendSubagentBackgroundRunLog, registerSubagentBackgroundRunController, unregisterSubagentBackgroundRunController, writeSubagentBackgroundRunStatus, } from "../subagent-background-runs.js";
 import { normalizeAndFilterToolNames, normalizeToolName } from "../subagents.js";
 const taskSchema = Type.Object({
     description: Type.Optional(Type.String({
@@ -959,18 +960,6 @@ function persistSubagentTranscript(input) {
         return undefined;
     }
 }
-function writeBackgroundRunStatus(rootCwd, status) {
-    try {
-        const dir = path.join(rootCwd, ".iosm", "subagents", "background");
-        mkdirSync(dir, { recursive: true });
-        const filePath = path.join(dir, `${status.runId}.json`);
-        writeFileSync(filePath, `${JSON.stringify(status, null, 2)}\n`, "utf8");
-        return filePath;
-    }
-    catch {
-        return undefined;
-    }
-}
 function gitResult(args, cwd) {
     const result = spawnSync("git", args, {
         cwd,
@@ -1048,6 +1037,7 @@ export function createTaskTool(cwd, runner, options) {
             customAgentsSnippet,
         parameters: taskSchema,
         execute: async (_toolCallId, { description: rawDescription, task: rawTask, args: rawArgs, prompt: rawPrompt, agent: agentName, profile, cwd: targetCwd, lock_key: lockKey, run_id: orchestrationRunId, task_id: orchestrationTaskId, model: requestedModel, background, isolation, delegate_parallel_hint: delegateParallelHint, }, _signal, onUpdate) => {
+            let runtimeAbortSignal = _signal;
             const updateTrackedTaskStatus = (status) => {
                 if (!orchestrationRunId || !orchestrationTaskId)
                     return;
@@ -1059,7 +1049,7 @@ export function createTaskTool(cwd, runner, options) {
                 });
             };
             const throwIfAborted = () => {
-                if (_signal?.aborted) {
+                if (runtimeAbortSignal?.aborted) {
                     updateTrackedTaskStatus("cancelled");
                     throw new Error("Operation aborted");
                 }
@@ -1281,7 +1271,7 @@ export function createTaskTool(cwd, runner, options) {
                                 cwd,
                                 runId: orchestrationRunId,
                                 taskId: orchestrationTaskId,
-                                signal: _signal,
+                                signal: runtimeAbortSignal,
                                 onWaiting: (waiting) => {
                                     emitProgress({
                                         kind: "subagent_progress",
@@ -1294,7 +1284,7 @@ export function createTaskTool(cwd, runner, options) {
                             });
                         }
                         catch (error) {
-                            if (_signal?.aborted || isAbortError(error)) {
+                            if (runtimeAbortSignal?.aborted || isAbortError(error)) {
                                 updateTrackedTaskStatus("cancelled");
                                 throw new Error("Operation aborted");
                             }
@@ -1388,7 +1378,7 @@ export function createTaskTool(cwd, runner, options) {
                                 value: payload,
                                 scope: "run",
                                 mode: "set",
-                            }, _signal);
+                            }, runtimeAbortSignal);
                         }
                         catch (error) {
                             const message = error instanceof Error ? error.message : String(error);
@@ -1417,7 +1407,7 @@ export function createTaskTool(cwd, runner, options) {
                                 value: payload,
                                 scope: "run",
                                 mode: "set",
-                            }, _signal);
+                            }, runtimeAbortSignal);
                         }
                         catch (error) {
                             const message = error instanceof Error ? error.message : String(error);
@@ -1437,7 +1427,7 @@ export function createTaskTool(cwd, runner, options) {
                                         scope: "run",
                                         key,
                                         includeValues: true,
-                                    }, _signal);
+                                    }, runtimeAbortSignal);
                                     const current = snapshot.items[0];
                                     if (!current) {
                                         await writeSharedMemory(rootSharedMemoryContext, {
@@ -1449,7 +1439,7 @@ export function createTaskTool(cwd, runner, options) {
                                             }),
                                             scope: "run",
                                             mode: "set",
-                                        }, _signal);
+                                        }, runtimeAbortSignal);
                                         lastError = undefined;
                                         break;
                                     }
@@ -1482,7 +1472,7 @@ export function createTaskTool(cwd, runner, options) {
                                         scope: "run",
                                         mode: "set",
                                         ifVersion: current.version,
-                                    }, _signal);
+                                    }, runtimeAbortSignal);
                                     lastError = undefined;
                                     break;
                                 }
@@ -1516,7 +1506,7 @@ export function createTaskTool(cwd, runner, options) {
                                         cwd: subagentCwd,
                                         modelOverride: effectiveModelOverride,
                                         sharedMemoryContext: rootSharedMemoryContext,
-                                        signal: _signal,
+                                        signal: runtimeAbortSignal,
                                         onProgress: (progress) => emitProgress(progress),
                                     });
                                     throwIfAborted();
@@ -1555,7 +1545,7 @@ export function createTaskTool(cwd, runner, options) {
                                     });
                                 }
                                 catch (error) {
-                                    if (_signal?.aborted || isAbortError(error)) {
+                                    if (runtimeAbortSignal?.aborted || isAbortError(error)) {
                                         throw new Error("Operation aborted");
                                     }
                                     const message = error instanceof Error ? error.message : String(error);
@@ -1857,7 +1847,7 @@ export function createTaskTool(cwd, runner, options) {
                                         cwd: nestedCwd,
                                         modelOverride: nestedModelOverride,
                                         sharedMemoryContext: nestedSharedMemoryContext,
-                                        signal: _signal,
+                                        signal: runtimeAbortSignal,
                                         onProgress: (progress) => {
                                             emitProgress({
                                                 kind: "subagent_progress",
@@ -2105,7 +2095,7 @@ export function createTaskTool(cwd, runner, options) {
                                                 cwd: childCwd,
                                                 modelOverride: childModelOverride,
                                                 sharedMemoryContext: childSharedMemoryContext,
-                                                signal: _signal,
+                                                signal: runtimeAbortSignal,
                                                 onProgress: (progress) => {
                                                     emitProgress({
                                                         kind: "subagent_progress",
@@ -2157,7 +2147,7 @@ export function createTaskTool(cwd, runner, options) {
                                             });
                                         }
                                         catch (error) {
-                                            if (_signal?.aborted || isAbortError(error)) {
+                                            if (runtimeAbortSignal?.aborted || isAbortError(error)) {
                                                 throw new Error("Operation aborted");
                                             }
                                             const message = error instanceof Error ? error.message : String(error);
@@ -2299,7 +2289,7 @@ export function createTaskTool(cwd, runner, options) {
                             }
                             catch (error) {
                                 const message = error instanceof Error ? error.message : String(error);
-                                if (_signal?.aborted || isAbortError(error)) {
+                                if (runtimeAbortSignal?.aborted || isAbortError(error)) {
                                     throw new Error("Operation aborted");
                                 }
                                 const classified = error && typeof error === "object" && "failureCause" in error
@@ -2375,7 +2365,7 @@ export function createTaskTool(cwd, runner, options) {
                     }
                     catch (error) {
                         const message = error instanceof Error ? error.message : String(error);
-                        if (_signal?.aborted || isAbortError(error)) {
+                        if (runtimeAbortSignal?.aborted || isAbortError(error)) {
                             recordFailureCause("aborted");
                             const hasFailureCauses = Object.keys(failureCauses).length > 0;
                             const details = {
@@ -2494,7 +2484,7 @@ export function createTaskTool(cwd, runner, options) {
                                 value: summaryPayload,
                                 scope: "run",
                                 mode: "set",
-                            }, _signal);
+                            }, runtimeAbortSignal);
                             sharedMemorySummaryKey = summaryWrite.key;
                         }
                         catch (error) {
@@ -2511,7 +2501,7 @@ export function createTaskTool(cwd, runner, options) {
                                 rootCwd: cwd,
                                 runId: sharedMemoryRunId,
                                 taskId: sharedMemoryTaskId,
-                            }, _signal);
+                            }, runtimeAbortSignal);
                             if (delegatedTasks > 1 && usage.currentTaskDelegateWrites === 0) {
                                 delegationWarnings.push("No shared_memory writes detected from delegates in this task. Cross-stream coordination may be weak; use stable keys (findings/<stream>, risks/<stream>, plan/<stream>).");
                             }
@@ -2541,7 +2531,7 @@ export function createTaskTool(cwd, runner, options) {
                                 prefix: "claims/",
                                 includeValues: true,
                                 limit: Math.max(40, delegatedTasks * 8),
-                            }, _signal);
+                            }, runtimeAbortSignal);
                             const collisions = [];
                             for (const item of claims.items) {
                                 if (!item.value)
@@ -2587,7 +2577,7 @@ export function createTaskTool(cwd, runner, options) {
                                 prefix: findingsPrefix,
                                 includeValues: true,
                                 limit: Math.max(20, delegatedTasks * 4),
-                            }, _signal);
+                            }, runtimeAbortSignal);
                             const examples = findings.items.slice(0, 6).map((item) => {
                                 let excerpt = "";
                                 if (item.value) {
@@ -2742,7 +2732,11 @@ export function createTaskTool(cwd, runner, options) {
             };
             if (runInBackground) {
                 const now = new Date().toISOString();
-                const queuedStatusPath = writeBackgroundRunStatus(cwd, {
+                const backgroundAbortController = new AbortController();
+                runtimeAbortSignal = backgroundAbortController.signal;
+                registerSubagentBackgroundRunController(cwd, runId, backgroundAbortController);
+                const logPath = appendSubagentBackgroundRunLog(cwd, runId, `queued · profile=${effectiveProfile} · cwd=${requestedSubagentCwd}`);
+                const queuedStatusPath = writeSubagentBackgroundRunStatus(cwd, {
                     runId,
                     status: "queued",
                     createdAt: now,
@@ -2751,9 +2745,10 @@ export function createTaskTool(cwd, runner, options) {
                     cwd: requestedSubagentCwd,
                     agent: customSubagent?.name,
                     model: effectiveModelOverride,
+                    logPath,
                 });
                 void (async () => {
-                    writeBackgroundRunStatus(cwd, {
+                    writeSubagentBackgroundRunStatus(cwd, {
                         runId,
                         status: "running",
                         createdAt: now,
@@ -2763,10 +2758,12 @@ export function createTaskTool(cwd, runner, options) {
                         cwd: requestedSubagentCwd,
                         agent: customSubagent?.name,
                         model: effectiveModelOverride,
+                        logPath,
                     });
+                    appendSubagentBackgroundRunLog(cwd, runId, "running");
                     try {
                         const result = await executeSubagent();
-                        writeBackgroundRunStatus(cwd, {
+                        writeSubagentBackgroundRunStatus(cwd, {
                             runId,
                             status: "done",
                             createdAt: now,
@@ -2777,11 +2774,13 @@ export function createTaskTool(cwd, runner, options) {
                             agent: customSubagent?.name,
                             model: effectiveModelOverride,
                             transcriptPath: result.details.transcriptPath,
+                            logPath,
                         });
+                        appendSubagentBackgroundRunLog(cwd, runId, `done · transcript=${result.details.transcriptPath ?? "-"}`);
                     }
                     catch (error) {
                         const aborted = isAbortError(error);
-                        writeBackgroundRunStatus(cwd, {
+                        writeSubagentBackgroundRunStatus(cwd, {
                             runId,
                             status: aborted ? "cancelled" : "error",
                             createdAt: now,
@@ -2792,7 +2791,12 @@ export function createTaskTool(cwd, runner, options) {
                             agent: customSubagent?.name,
                             model: effectiveModelOverride,
                             error: error instanceof Error ? error.message : String(error),
+                            logPath,
                         });
+                        appendSubagentBackgroundRunLog(cwd, runId, `${aborted ? "cancelled" : "error"} · ${error instanceof Error ? error.message : String(error)}`);
+                    }
+                    finally {
+                        unregisterSubagentBackgroundRunController(cwd, runId);
                     }
                 })();
                 return {