peaks-loop-internal-runtime 0.0.1

package/dist/auto-compact-adapter.d.ts

@@ -0,0 +1,18 @@
+import type { AutoCompactEvent } from './status-protocol.js';
+export interface MarkerOpts {
+    rid: string;
+    sid: string;
+    vendorWindow: number;
+}
+export interface ScratchPayload {
+    seq: number;
+    at: number;
+    summary: string;
+    decisionsKept?: string[];
+    discardedOptions?: string[];
+}
+export declare class AutoCompactAdapter {
+    marker(opts: MarkerOpts): string;
+    parseScratchFile(p: ScratchPayload): Partial<AutoCompactEvent>;
+}
+//# sourceMappingURL=auto-compact-adapter.d.ts.map

package/dist/auto-compact-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-compact-adapter.d.ts","sourceRoot":"","sources":["../src/auto-compact-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,WAAW,UAAU;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;CAAE;AAC/E,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CACvD;AAED,qBAAa,kBAAkB;IAC7B,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAiBhC,gBAAgB,CAAC,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAG/D"}

package/dist/auto-compact-adapter.js

@@ -0,0 +1,21 @@
+export class AutoCompactAdapter {
+    marker(opts) {
+        return [
+            `<peaks-auto-compact threshold="0.85|0.95" vendor-window="${opts.vendorWindow}">`,
+            `协议：`,
+            `- 你（子进程 LLM）估算自己已用上下文 ≥ 85% vendor window`,
+            `  → 主动 compact 自己的会话：把对话历史摘要写到`,
+            `    .peaks/_runtime/${opts.sid}/detached/${opts.rid}/compact/<n>.json`,
+            `  → 把摘要 + 当前任务状态拼回 prompt 头部`,
+            `  → 调用 peaks runtime write-compact-event CLI 记录事件`,
+            `- 当 ≥ 95% → 同步 compact + 立刻通知 peaks 主进程`,
+            `  （写 status.json note: 'compact-emergency'）`,
+            `- 不要等 peaks 主进程来催；子进程 LLM 自己监控自己的 context`,
+            `- 不限费用（用户授权）—— compact 本身消耗的 token 随它去`,
+            `</peaks-auto-compact>`,
+        ].join('\n');
+    }
+    parseScratchFile(p) {
+        return { at: p.at, threshold: '0.85', tokensBefore: 0, tokensAfter: 0 };
+    }
+}

package/dist/dispatch.d.ts

@@ -0,0 +1,18 @@
+export interface DispatchInput {
+    sid: string;
+    rid: string;
+    role: 'rd' | 'qa' | 'ui' | 'txt' | 'general-purpose';
+    vendor: 'claude' | 'codex' | 'copilot';
+    userTask: string;
+    files: string[];
+    refs: string[];
+    runtimeDir: string;
+    subAgentsDir: string;
+    verbatimBlocks?: string[];
+}
+export interface DispatchResult {
+    pid: number;
+    dispatchRecordPath: string;
+}
+export declare function dispatchDetached(i: DispatchInput): Promise<DispatchResult>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,GAAC,IAAI,GAAC,IAAI,GAAC,KAAK,GAAC,iBAAiB,CAAC;IACvE,MAAM,EAAE,QAAQ,GAAC,OAAO,GAAC,SAAS,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAClD,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IACzC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AACD,MAAM,WAAW,cAAc;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;CAAE;AAE5E,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAkChF"}

package/dist/dispatch.js

@@ -0,0 +1,40 @@
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { ProcessSupervisor } from './process-supervisor.js';
+import { LifecycleOwner } from './lifecycle.js';
+import { VendorAdapterRegistry } from './vendor/registry.js';
+import { ClaudeAdapter } from './vendor/claude-adapter.js';
+import { CodexAdapter } from './vendor/codex-adapter.js';
+import { CopilotAdapter } from './vendor/copilot-adapter.js';
+import { PromptBuilder } from './prompt-builder.js';
+import { AutoCompactAdapter } from './auto-compact-adapter.js';
+export async function dispatchDetached(i) {
+    const registry = new VendorAdapterRegistry([new ClaudeAdapter(), new CodexAdapter(), new CopilotAdapter()]);
+    const adapter = registry.get(i.vendor);
+    if (!adapter)
+        throw new Error(`vendor adapter not registered: ${i.vendor}`);
+    const pb = new PromptBuilder();
+    const ac = new AutoCompactAdapter();
+    const marker = ac.marker({ rid: i.rid, sid: i.sid, vendorWindow: adapter.maxPromptBytes / 40 /* rough */ });
+    const prompt = pb.assemble({
+        rid: i.rid, role: i.role, vendor: i.vendor,
+        files: i.files, refs: i.refs, userTask: i.userTask,
+        verbatimBlocks: [marker, ...(i.verbatimBlocks ?? [])],
+    });
+    const args = adapter.headlessArgs(prompt, { autoCompactMarker: marker });
+    const dir = join(i.runtimeDir, i.rid);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, 'owner-session'), i.sid);
+    const sup = new ProcessSupervisor({ runtimeDir: i.runtimeDir });
+    const lo = new LifecycleOwner(i.runtimeDir);
+    const handle = await sup.spawn(adapter.binary, args, { detach: true, rid: i.rid });
+    lo.register(handle.pid, i.rid, i.sid);
+    // Write dispatch record (placeholder — final shape per Task 8 schema)
+    const recPath = join(i.subAgentsDir, `dispatch-${i.rid}-${Date.now()}.json`);
+    mkdirSync(i.subAgentsDir, { recursive: true });
+    writeFileSync(recPath, JSON.stringify({
+        rid: i.rid, mode: 'detached', vendor: i.vendor,
+        status: 'running', heartbeats: [], at: Date.now(),
+    }, null, 2));
+    return { pid: handle.pid, dispatchRecordPath: recPath };
+}

package/dist/guards/resource-budget.d.ts

@@ -0,0 +1,23 @@
+export interface Sample {
+    rssMb: number;
+    cpuPct: number;
+}
+export interface EnforceInput {
+    active: number;
+}
+export interface EnforceOpts {
+    maxConcurrent: number;
+}
+export declare class ResourceBudgetGuard {
+    private readonly cfg;
+    constructor(cfg: {
+        maxRssMb: number;
+        maxCpuPct: number;
+    });
+    sample(): Sample;
+    enforce(input: EnforceInput, opts: EnforceOpts): {
+        throttle: boolean;
+        kill?: string[];
+    };
+}
+//# sourceMappingURL=resource-budget.d.ts.map

package/dist/guards/resource-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-budget.d.ts","sourceRoot":"","sources":["../../src/guards/resource-budget.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;CAAE;AAC1D,MAAM,WAAW,YAAY;IAAG,MAAM,EAAE,MAAM,CAAC;CAAE;AACjD,MAAM,WAAW,WAAW;IAAG,aAAa,EAAE,MAAM,CAAC;CAAE;AAEvD,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAEzE,MAAM,IAAI,MAAM;IAQhB,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;CAIxF"}

package/dist/guards/resource-budget.js

@@ -0,0 +1,18 @@
+export class ResourceBudgetGuard {
+    cfg;
+    constructor(cfg) {
+        this.cfg = cfg;
+    }
+    sample() {
+        const m = process.memoryUsage();
+        const c = process.cpuUsage();
+        const rssMb = Math.round(m.rss / 1024 / 1024);
+        const cpuPct = Math.round(((c.user + c.system) / 1_000_000) * 100) / 100;
+        return { rssMb, cpuPct };
+    }
+    enforce(input, opts) {
+        if (input.active > opts.maxConcurrent)
+            return { throttle: true };
+        return { throttle: false };
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export declare const RUNTIME_VERSION = "4.0.19";
+export { ClaudeAdapter } from './vendor/claude-adapter.js';
+export { CodexAdapter } from './vendor/codex-adapter.js';
+export { CopilotAdapter } from './vendor/copilot-adapter.js';
+export { VendorAdapterRegistry, defaultRegistry } from './vendor/registry.js';
+export type { VendorAdapter } from './vendor/adapter.js';
+export { ProcessSupervisor } from './process-supervisor.js';
+export { LifecycleOwner } from './lifecycle.js';
+export { PromptBuilder } from './prompt-builder.js';
+export { StatusProtocol } from './status-protocol.js';
+export type { HeartbeatEntry, AutoCompactEvent } from './status-protocol.js';
+export { AutoCompactAdapter } from './auto-compact-adapter.js';
+export { ResourceBudgetGuard } from './guards/resource-budget.js';
+export { dispatchDetached } from './dispatch.js';
+export type { DispatchInput, DispatchResult } from './dispatch.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export const RUNTIME_VERSION = '4.0.19';
+export { ClaudeAdapter } from './vendor/claude-adapter.js';
+export { CodexAdapter } from './vendor/codex-adapter.js';
+export { CopilotAdapter } from './vendor/copilot-adapter.js';
+export { VendorAdapterRegistry, defaultRegistry } from './vendor/registry.js';
+export { ProcessSupervisor } from './process-supervisor.js';
+export { LifecycleOwner } from './lifecycle.js';
+export { PromptBuilder } from './prompt-builder.js';
+export { StatusProtocol } from './status-protocol.js';
+export { AutoCompactAdapter } from './auto-compact-adapter.js';
+export { ResourceBudgetGuard } from './guards/resource-budget.js';
+export { dispatchDetached } from './dispatch.js';

package/dist/lifecycle.d.ts

@@ -0,0 +1,9 @@
+export declare class LifecycleOwner {
+    private readonly runtimeDir;
+    private active;
+    constructor(runtimeDir: string);
+    register(pid: number, rid: string, ownerSession: string): void;
+    markExit(rid: string, code: number, signal?: string): Promise<void>;
+    reap(currentSessionId: string): Promise<string[]>;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAKA,qBAAa,cAAc;IAGb,OAAO,CAAC,QAAQ,CAAC,UAAU;IAFvC,OAAO,CAAC,MAAM,CAAmC;gBAEpB,UAAU,EAAE,MAAM;IAE/C,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAIxD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBnE,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAOxD"}

package/dist/lifecycle.js

@@ -0,0 +1,39 @@
+import { existsSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+export class LifecycleOwner {
+    runtimeDir;
+    active = new Map();
+    constructor(runtimeDir) {
+        this.runtimeDir = runtimeDir;
+    }
+    register(pid, rid, ownerSession) {
+        this.active.set(rid, { pid, rid, ownerSession });
+    }
+    async markExit(rid, code, signal) {
+        const dir = join(this.runtimeDir, rid);
+        if (!existsSync(dir))
+            return;
+        const exit = { code, signal, at: Date.now() };
+        writeFileSync(join(dir, 'exit.json'), JSON.stringify(exit));
+        // Archive
+        if (existsSync(join(dir, 'log.txt')))
+            renameSync(join(dir, 'log.txt'), join(dir, 'log-archive.txt'));
+        if (existsSync(join(dir, 'status.json')))
+            renameSync(join(dir, 'status.json'), join(dir, 'status-final.json'));
+        // Delete active markers
+        for (const f of ['pid', 'owner-session']) {
+            const p = join(dir, f);
+            if (existsSync(p))
+                rmSync(p);
+        }
+        this.active.delete(rid);
+    }
+    async reap(currentSessionId) {
+        const orphans = [];
+        for (const rec of this.active.values()) {
+            if (rec.ownerSession !== currentSessionId)
+                orphans.push(rec.rid);
+        }
+        return orphans; // user decides via `peaks sub-agent cleanup --orphan`
+    }
+}

package/dist/process-supervisor.d.ts

@@ -0,0 +1,19 @@
+import { ChildProcess } from 'node:child_process';
+export interface SpawnOpts {
+    detach: boolean;
+    rid: string;
+    stdio?: 'pipe' | 'ignore';
+}
+export interface SpawnHandle {
+    pid: number;
+    child: ChildProcess;
+    kill(signal?: NodeJS.Signals): void;
+}
+export declare class ProcessSupervisor {
+    private readonly cfg;
+    constructor(cfg: {
+        runtimeDir: string;
+    });
+    spawn(binary: string, args: string[], opts: SpawnOpts): Promise<SpawnHandle>;
+}
+//# sourceMappingURL=process-supervisor.d.ts.map

package/dist/process-supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-supervisor.d.ts","sourceRoot":"","sources":["../src/process-supervisor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAItE,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC3B;AACD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;CACrC;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE;IAElD,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAuBnF"}

package/dist/process-supervisor.js

@@ -0,0 +1,30 @@
+import { spawn as nodeSpawn } from 'node:child_process';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+export class ProcessSupervisor {
+    cfg;
+    constructor(cfg) {
+        this.cfg = cfg;
+    }
+    async spawn(binary, args, opts) {
+        const isWin = process.platform === 'win32';
+        const spawnOpts = {
+            detached: opts.detach,
+            stdio: opts.stdio ?? 'pipe',
+        };
+        if (isWin) {
+            spawnOpts.windowsHide = true;
+            // CREATE_NEW_PROCESS_GROUP = 0x00000200, DETACHED_PROCESS = 0x00000008
+            spawnOpts.detached = true;
+        }
+        const child = nodeSpawn(binary, args, spawnOpts);
+        const dir = join(this.cfg.runtimeDir, opts.rid);
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(join(dir, 'pid'), String(child.pid ?? ''));
+        return {
+            pid: child.pid ?? -1,
+            child,
+            kill: (signal = 'SIGTERM') => child.kill(signal),
+        };
+    }
+}

package/dist/prompt-builder.d.ts

@@ -0,0 +1,13 @@
+export interface AssembleInput {
+    rid: string;
+    role: 'rd' | 'qa' | 'ui' | 'txt' | 'general-purpose';
+    vendor: string;
+    files: string[];
+    refs: string[];
+    userTask: string;
+    verbatimBlocks?: string[];
+}
+export declare class PromptBuilder {
+    assemble(i: AssembleInput): string;
+}
+//# sourceMappingURL=prompt-builder.d.ts.map

package/dist/prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../src/prompt-builder.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,iBAAiB,CAAC;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,qBAAa,aAAa;IACxB,QAAQ,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM;CAsBnC"}

package/dist/prompt-builder.js

@@ -0,0 +1,27 @@
+const FORBIDDEN = '@@@ORCHESTRATOR_SESSION_HISTORY_BOUNDARY@@@';
+export class PromptBuilder {
+    assemble(i) {
+        if (i.userTask.includes(FORBIDDEN))
+            throw new Error('forbidden marker in user task');
+        const parts = [
+            `rid: ${i.rid}`,
+            `role: ${i.role}`,
+            `vendor: ${i.vendor}`,
+            ``,
+            `## Task`,
+            i.userTask,
+            ``,
+            `## Files (read-only)`,
+            ...i.files.map(f => `- ${f}`),
+            ``,
+            `## References`,
+            ...i.refs.map(r => `- ${r}`),
+            ``,
+            ...(i.verbatimBlocks ?? []),
+        ];
+        const out = parts.join('\n');
+        if (out.includes(FORBIDDEN))
+            throw new Error('forbidden marker leak');
+        return out;
+    }
+}

package/dist/status-protocol.d.ts

@@ -0,0 +1,19 @@
+import type { ChildStatus } from './types.js';
+export interface HeartbeatEntry {
+    progress: number;
+    note: string;
+    ts: number;
+}
+export interface AutoCompactEvent {
+    at: number;
+    threshold: '0.85' | '0.95';
+    tokensBefore: number;
+    tokensAfter: number;
+    scratchFile?: string;
+}
+export declare class StatusProtocol {
+    merge(rec: any, s: ChildStatus): any;
+    isStale(lastBeatAt: number, thresholdSec?: number): boolean;
+    appendCompactEvent(rec: any, ev: AutoCompactEvent): any;
+}
+//# sourceMappingURL=status-protocol.d.ts.map

package/dist/status-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-protocol.d.ts","sourceRoot":"","sources":["../src/status-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,cAAc;IAAG,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;CAAE;AAC/E,MAAM,WAAW,gBAAgB;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAAE;AAE9I,qBAAa,cAAc;IACzB,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,WAAW,GAAG,GAAG;IAUpC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,SAAM,GAAG,OAAO;IAGxD,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,gBAAgB,GAAG,GAAG;CAGxD"}

package/dist/status-protocol.js

@@ -0,0 +1,18 @@
+export class StatusProtocol {
+    merge(rec, s) {
+        const next = { ...rec };
+        next.heartbeats = [...(rec.heartbeats ?? []), { progress: s.progress, note: s.note, ts: s.ts }];
+        if (next.heartbeats.length > 100) {
+            next.heartbeats = next.heartbeats.slice(-100);
+            next.heartbeatsTruncated = true;
+        }
+        next.status = s.state === 'running' ? 'running' : s.state;
+        return next;
+    }
+    isStale(lastBeatAt, thresholdSec = 300) {
+        return Date.now() - lastBeatAt > thresholdSec * 1000;
+    }
+    appendCompactEvent(rec, ev) {
+        return { ...rec, autoCompactEvents: [...(rec.autoCompactEvents ?? []), ev] };
+    }
+}

package/dist/types.d.ts

@@ -0,0 +1,12 @@
+export type DetachedMode = 'in-process' | 'detached';
+export type VendorId = 'claude' | 'codex' | 'copilot';
+export interface ChildStatus {
+    rid: string;
+    vendor: VendorId;
+    progress: number;
+    state: 'running' | 'stale' | 'crashed' | 'oom-killed' | 'done' | 'spawn-failed';
+    note: string;
+    ts: number;
+    etaSec?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,UAAU,CAAC;AACrD,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AACtD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,QAAQ,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,cAAc,CAAC;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/types.js

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

package/dist/vendor/adapter.d.ts

@@ -0,0 +1,12 @@
+import type { ChildStatus } from '../types.js';
+export interface VendorAdapter {
+    readonly id: 'claude' | 'codex' | 'copilot';
+    readonly binary: string;
+    readonly maxPromptBytes: number;
+    headlessArgs(prompt: string, opts?: {
+        autoCompactMarker?: string;
+    }): string[];
+    parseStatusLine(stdout: string): ChildStatus | null;
+    detectInstalled(): Promise<boolean>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/vendor/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/vendor/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE,CAAC;IAC9E,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IACpD,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACrC"}

package/dist/vendor/adapter.js

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

package/dist/vendor/claude-adapter.d.ts

@@ -0,0 +1,13 @@
+import type { VendorAdapter } from './adapter.js';
+import type { ChildStatus } from '../types.js';
+export declare class ClaudeAdapter implements VendorAdapter {
+    readonly id: "claude";
+    readonly binary = "claude";
+    readonly maxPromptBytes: number;
+    headlessArgs(prompt: string, opts?: {
+        autoCompactMarker?: string;
+    }): string[];
+    parseStatusLine(stdout: string): ChildStatus | null;
+    detectInstalled(): Promise<boolean>;
+}
+//# sourceMappingURL=claude-adapter.d.ts.map

package/dist/vendor/claude-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-adapter.d.ts","sourceRoot":"","sources":["../../src/vendor/claude-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,qBAAa,aAAc,YAAW,aAAa;IACjD,QAAQ,CAAC,EAAE,EAAG,QAAQ,CAAU;IAChC,QAAQ,CAAC,MAAM,YAAY;IAC3B,QAAQ,CAAC,cAAc,SAAY;IAEnC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE;IAO7E,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAe7C,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;CAM1C"}

package/dist/vendor/claude-adapter.js

@@ -0,0 +1,41 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const pExecFile = promisify(execFile);
+export class ClaudeAdapter {
+    id = 'claude';
+    binary = 'claude';
+    maxPromptBytes = 8 * 1024;
+    headlessArgs(prompt, opts) {
+        const injected = opts?.autoCompactMarker
+            ? `${opts.autoCompactMarker}\n\n${prompt}`
+            : prompt;
+        return ['-p', injected, '--output-format', 'json', '--include-partial-messages'];
+    }
+    parseStatusLine(stdout) {
+        try {
+            const obj = JSON.parse(stdout);
+            if (typeof obj.progress !== 'number')
+                return null;
+            return {
+                rid: String(obj.rid ?? ''),
+                vendor: 'claude',
+                progress: obj.progress,
+                state: obj.state,
+                note: String(obj.note ?? ''),
+                ts: Number(obj.ts ?? Date.now()),
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    async detectInstalled() {
+        try {
+            const { stdout } = await pExecFile(this.binary, ['--version'], { timeout: 3000 });
+            return stdout.length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+}

package/dist/vendor/codex-adapter.d.ts

@@ -0,0 +1,11 @@
+import type { VendorAdapter } from './adapter.js';
+import type { ChildStatus } from '../types.js';
+export declare class CodexAdapter implements VendorAdapter {
+    readonly id: "codex";
+    readonly binary = "codex";
+    readonly maxPromptBytes: number;
+    headlessArgs(prompt: string): string[];
+    parseStatusLine(stdout: string): ChildStatus | null;
+    detectInstalled(): Promise<boolean>;
+}
+//# sourceMappingURL=codex-adapter.d.ts.map

package/dist/vendor/codex-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-adapter.d.ts","sourceRoot":"","sources":["../../src/vendor/codex-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,qBAAa,YAAa,YAAW,aAAa;IAChD,QAAQ,CAAC,EAAE,EAAG,OAAO,CAAU;IAC/B,QAAQ,CAAC,MAAM,WAAW;IAC1B,QAAQ,CAAC,cAAc,SAAY;IACnC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAGtC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAO7C,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;CAI1C"}

package/dist/vendor/codex-adapter.js

@@ -0,0 +1,31 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const pExecFile = promisify(execFile);
+export class CodexAdapter {
+    id = 'codex';
+    binary = 'codex';
+    maxPromptBytes = 5 * 1024;
+    headlessArgs(prompt) {
+        return ['exec', '--json', prompt];
+    }
+    parseStatusLine(stdout) {
+        try {
+            const o = JSON.parse(stdout);
+            if (typeof o.progress !== 'number')
+                return null;
+            return { rid: String(o.rid ?? ''), vendor: 'codex', progress: o.progress, state: o.state, note: String(o.note ?? ''), ts: Number(o.ts ?? Date.now()) };
+        }
+        catch {
+            return null;
+        }
+    }
+    async detectInstalled() {
+        try {
+            const { stdout } = await pExecFile(this.binary, ['--version'], { timeout: 3000 });
+            return stdout.length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+}

package/dist/vendor/copilot-adapter.d.ts

@@ -0,0 +1,11 @@
+import type { VendorAdapter } from './adapter.js';
+import type { ChildStatus } from '../types.js';
+export declare class CopilotAdapter implements VendorAdapter {
+    readonly id: "copilot";
+    readonly binary = "copilot";
+    readonly maxPromptBytes: number;
+    headlessArgs(prompt: string): string[];
+    parseStatusLine(stdout: string): ChildStatus | null;
+    detectInstalled(): Promise<boolean>;
+}
+//# sourceMappingURL=copilot-adapter.d.ts.map

package/dist/vendor/copilot-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-adapter.d.ts","sourceRoot":"","sources":["../../src/vendor/copilot-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,EAAE,EAAG,SAAS,CAAU;IACjC,QAAQ,CAAC,MAAM,aAAa;IAC5B,QAAQ,CAAC,cAAc,SAAY;IACnC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IACtC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAO7C,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;CAI1C"}

package/dist/vendor/copilot-adapter.js

@@ -0,0 +1,29 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const pExecFile = promisify(execFile);
+export class CopilotAdapter {
+    id = 'copilot';
+    binary = 'copilot';
+    maxPromptBytes = 6 * 1024;
+    headlessArgs(prompt) { return ['-p', prompt, '--output-format', 'json']; }
+    parseStatusLine(stdout) {
+        try {
+            const o = JSON.parse(stdout);
+            if (typeof o.progress !== 'number')
+                return null;
+            return { rid: String(o.rid ?? ''), vendor: 'copilot', progress: o.progress, state: o.state, note: String(o.note ?? ''), ts: Number(o.ts ?? Date.now()) };
+        }
+        catch {
+            return null;
+        }
+    }
+    async detectInstalled() {
+        try {
+            const { stdout } = await pExecFile(this.binary, ['--version'], { timeout: 3000 });
+            return stdout.length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+}

package/dist/vendor/registry.d.ts

@@ -0,0 +1,10 @@
+import type { VendorAdapter } from './adapter.js';
+export declare class VendorAdapterRegistry {
+    private map;
+    constructor(initial?: VendorAdapter[]);
+    register(a: VendorAdapter): void;
+    get(id: string): VendorAdapter | undefined;
+    list(): VendorAdapter[];
+}
+export declare const defaultRegistry: () => VendorAdapterRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/vendor/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/vendor/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAKlD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,GAAG,CAAoC;gBACnC,OAAO,GAAE,aAAa,EAAO;IAGzC,QAAQ,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI;IAChC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAC1C,IAAI,IAAI,aAAa,EAAE;CACxB;AAED,eAAO,MAAM,eAAe,6BAAmG,CAAC"}

package/dist/vendor/registry.js

@@ -0,0 +1,14 @@
+import { ClaudeAdapter } from './claude-adapter.js';
+import { CodexAdapter } from './codex-adapter.js';
+import { CopilotAdapter } from './copilot-adapter.js';
+export class VendorAdapterRegistry {
+    map = new Map();
+    constructor(initial = []) {
+        for (const a of initial)
+            this.map.set(a.id, a);
+    }
+    register(a) { this.map.set(a.id, a); }
+    get(id) { return this.map.get(id); }
+    list() { return [...this.map.values()]; }
+}
+export const defaultRegistry = () => new VendorAdapterRegistry([new ClaudeAdapter(), new CodexAdapter(), new CopilotAdapter()]);

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "peaks-loop-internal-runtime",
+  "version": "0.0.1",
+  "description": "Detached sub-agent runtime: ProcessSupervisor + LifecycleOwner + VendorAdapter (claude/codex/copilot) + G8 infinite-context auto-compact. Slice 2026-08-10.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run tests/unit/runtime"
+  },
+  "peerDependencies": {
+    "peaks-loop-shared": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "vitest": "4.1.10"
+  }
+}

package/src/auto-compact-adapter.ts

@@ -0,0 +1,30 @@
+import type { AutoCompactEvent } from './status-protocol.js';
+
+export interface MarkerOpts { rid: string; sid: string; vendorWindow: number; }
+export interface ScratchPayload {
+  seq: number; at: number; summary: string;
+  decisionsKept?: string[]; discardedOptions?: string[];
+}
+
+export class AutoCompactAdapter {
+  marker(opts: MarkerOpts): string {
+    return [
+      `<peaks-auto-compact threshold="0.85|0.95" vendor-window="${opts.vendorWindow}">`,
+      `协议：`,
+      `- 你（子进程 LLM）估算自己已用上下文 ≥ 85% vendor window`,
+      `  → 主动 compact 自己的会话：把对话历史摘要写到`,
+      `    .peaks/_runtime/${opts.sid}/detached/${opts.rid}/compact/<n>.json`,
+      `  → 把摘要 + 当前任务状态拼回 prompt 头部`,
+      `  → 调用 peaks runtime write-compact-event CLI 记录事件`,
+      `- 当 ≥ 95% → 同步 compact + 立刻通知 peaks 主进程`,
+      `  （写 status.json note: 'compact-emergency'）`,
+      `- 不要等 peaks 主进程来催；子进程 LLM 自己监控自己的 context`,
+      `- 不限费用（用户授权）—— compact 本身消耗的 token 随它去`,
+      `</peaks-auto-compact>`,
+    ].join('\n');
+  }
+
+  parseScratchFile(p: ScratchPayload): Partial<AutoCompactEvent> {
+    return { at: p.at, threshold: '0.85', tokensBefore: 0, tokensAfter: 0 };
+  }
+}

package/src/dispatch.ts

@@ -0,0 +1,57 @@
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { ProcessSupervisor } from './process-supervisor.js';
+import { LifecycleOwner } from './lifecycle.js';
+import { VendorAdapterRegistry } from './vendor/registry.js';
+import { ClaudeAdapter } from './vendor/claude-adapter.js';
+import { CodexAdapter } from './vendor/codex-adapter.js';
+import { CopilotAdapter } from './vendor/copilot-adapter.js';
+import { PromptBuilder } from './prompt-builder.js';
+import { StatusProtocol } from './status-protocol.js';
+import { AutoCompactAdapter } from './auto-compact-adapter.js';
+import { ResourceBudgetGuard } from './guards/resource-budget.js';
+
+export interface DispatchInput {
+  sid: string; rid: string; role: 'rd'|'qa'|'ui'|'txt'|'general-purpose';
+  vendor: 'claude'|'codex'|'copilot';
+  userTask: string; files: string[]; refs: string[];
+  runtimeDir: string; subAgentsDir: string;
+  verbatimBlocks?: string[];
+}
+export interface DispatchResult { pid: number; dispatchRecordPath: string; }
+
+export async function dispatchDetached(i: DispatchInput): Promise<DispatchResult> {
+  const registry = new VendorAdapterRegistry([new ClaudeAdapter(), new CodexAdapter(), new CopilotAdapter()]);
+  const adapter = registry.get(i.vendor);
+  if (!adapter) throw new Error(`vendor adapter not registered: ${i.vendor}`);
+
+  const pb = new PromptBuilder();
+  const ac = new AutoCompactAdapter();
+  const marker = ac.marker({ rid: i.rid, sid: i.sid, vendorWindow: adapter.maxPromptBytes / 40 /* rough */ });
+  const prompt = pb.assemble({
+    rid: i.rid, role: i.role, vendor: i.vendor,
+    files: i.files, refs: i.refs, userTask: i.userTask,
+    verbatimBlocks: [marker, ...(i.verbatimBlocks ?? [])],
+  });
+
+  const args = adapter.headlessArgs(prompt, { autoCompactMarker: marker });
+
+  const dir = join(i.runtimeDir, i.rid);
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(join(dir, 'owner-session'), i.sid);
+
+  const sup = new ProcessSupervisor({ runtimeDir: i.runtimeDir });
+  const lo = new LifecycleOwner(i.runtimeDir);
+  const handle = await sup.spawn(adapter.binary, args, { detach: true, rid: i.rid });
+  lo.register(handle.pid, i.rid, i.sid);
+
+  // Write dispatch record (placeholder — final shape per Task 8 schema)
+  const recPath = join(i.subAgentsDir, `dispatch-${i.rid}-${Date.now()}.json`);
+  mkdirSync(i.subAgentsDir, { recursive: true });
+  writeFileSync(recPath, JSON.stringify({
+    rid: i.rid, mode: 'detached', vendor: i.vendor,
+    status: 'running', heartbeats: [], at: Date.now(),
+  }, null, 2));
+
+  return { pid: handle.pid, dispatchRecordPath: recPath };
+}

package/src/guards/resource-budget.ts

@@ -0,0 +1,20 @@
+export interface Sample { rssMb: number; cpuPct: number; }
+export interface EnforceInput { active: number; }
+export interface EnforceOpts { maxConcurrent: number; }
+
+export class ResourceBudgetGuard {
+  constructor(private readonly cfg: { maxRssMb: number; maxCpuPct: number }) {}
+
+  sample(): Sample {
+    const m = process.memoryUsage();
+    const c = process.cpuUsage();
+    const rssMb = Math.round(m.rss / 1024 / 1024);
+    const cpuPct = Math.round(((c.user + c.system) / 1_000_000) * 100) / 100;
+    return { rssMb, cpuPct };
+  }
+
+  enforce(input: EnforceInput, opts: EnforceOpts): { throttle: boolean; kill?: string[] } {
+    if (input.active > opts.maxConcurrent) return { throttle: true };
+    return { throttle: false };
+  }
+}

package/src/index.ts

@@ -0,0 +1,24 @@
+// API contract: RUNTIME_VERSION tracks peaks-loop root version (4.0.x).
+// This is what consumers (sub-agents dispatched by peaks-code) check at
+// runtime to verify protocol compatibility.
+export const RUNTIME_VERSION = '4.0.20';
+
+// npm version: independent 0.0.x SemVer. Runtime is its own package
+// (peaks-loop-internal-runtime@NPM_VERSION) on the registry; bumps
+// per peaks release notes when its public surface actually changes
+// (not per root version bump).
+export const RUNTIME_NPM_VERSION = '0.0.1';
+export { ClaudeAdapter } from './vendor/claude-adapter.js';
+export { CodexAdapter } from './vendor/codex-adapter.js';
+export { CopilotAdapter } from './vendor/copilot-adapter.js';
+export { VendorAdapterRegistry, defaultRegistry } from './vendor/registry.js';
+export type { VendorAdapter } from './vendor/adapter.js';
+export { ProcessSupervisor } from './process-supervisor.js';
+export { LifecycleOwner } from './lifecycle.js';
+export { PromptBuilder } from './prompt-builder.js';
+export { StatusProtocol } from './status-protocol.js';
+export type { HeartbeatEntry, AutoCompactEvent } from './status-protocol.js';
+export { AutoCompactAdapter } from './auto-compact-adapter.js';
+export { ResourceBudgetGuard } from './guards/resource-budget.js';
+export { dispatchDetached } from './dispatch.js';
+export type { DispatchInput, DispatchResult } from './dispatch.js';

package/src/lifecycle.ts

@@ -0,0 +1,40 @@
+import { existsSync, mkdirSync, readdirSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+interface ActiveRecord { pid: number; rid: string; ownerSession: string; }
+
+export class LifecycleOwner {
+  private active = new Map<string, ActiveRecord>();
+
+  constructor(private readonly runtimeDir: string) {}
+
+  register(pid: number, rid: string, ownerSession: string): void {
+    this.active.set(rid, { pid, rid, ownerSession });
+  }
+
+  async markExit(rid: string, code: number, signal?: string): Promise<void> {
+    const dir = join(this.runtimeDir, rid);
+    if (!existsSync(dir)) return;
+    const exit = { code, signal, at: Date.now() };
+    writeFileSync(join(dir, 'exit.json'), JSON.stringify(exit));
+
+    // Archive
+    if (existsSync(join(dir, 'log.txt'))) renameSync(join(dir, 'log.txt'), join(dir, 'log-archive.txt'));
+    if (existsSync(join(dir, 'status.json'))) renameSync(join(dir, 'status.json'), join(dir, 'status-final.json'));
+
+    // Delete active markers
+    for (const f of ['pid', 'owner-session']) {
+      const p = join(dir, f);
+      if (existsSync(p)) rmSync(p);
+    }
+    this.active.delete(rid);
+  }
+
+  async reap(currentSessionId: string): Promise<string[]> {
+    const orphans: string[] = [];
+    for (const rec of this.active.values()) {
+      if (rec.ownerSession !== currentSessionId) orphans.push(rec.rid);
+    }
+    return orphans; // user decides via `peaks sub-agent cleanup --orphan`
+  }
+}

package/src/process-supervisor.ts

@@ -0,0 +1,42 @@
+import { spawn as nodeSpawn, ChildProcess } from 'node:child_process';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+
+export interface SpawnOpts {
+  detach: boolean;
+  rid: string;
+  stdio?: 'pipe' | 'ignore';
+}
+export interface SpawnHandle {
+  pid: number;
+  child: ChildProcess;
+  kill(signal?: NodeJS.Signals): void;
+}
+
+export class ProcessSupervisor {
+  constructor(private readonly cfg: { runtimeDir: string }) {}
+
+  async spawn(binary: string, args: string[], opts: SpawnOpts): Promise<SpawnHandle> {
+    const isWin = process.platform === 'win32';
+    const spawnOpts: any = {
+      detached: opts.detach,
+      stdio: opts.stdio ?? 'pipe',
+    };
+    if (isWin) {
+      spawnOpts.windowsHide = true;
+      // CREATE_NEW_PROCESS_GROUP = 0x00000200, DETACHED_PROCESS = 0x00000008
+      spawnOpts.detached = true;
+    }
+
+    const child = nodeSpawn(binary, args, spawnOpts);
+    const dir = join(this.cfg.runtimeDir, opts.rid);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, 'pid'), String(child.pid ?? ''));
+
+    return {
+      pid: child.pid ?? -1,
+      child,
+      kill: (signal: NodeJS.Signals = 'SIGTERM') => child.kill(signal),
+    };
+  }
+}

package/src/prompt-builder.ts

@@ -0,0 +1,36 @@
+const FORBIDDEN = '@@@ORCHESTRATOR_SESSION_HISTORY_BOUNDARY@@@';
+
+export interface AssembleInput {
+  rid: string;
+  role: 'rd' | 'qa' | 'ui' | 'txt' | 'general-purpose';
+  vendor: string;
+  files: string[];
+  refs: string[];
+  userTask: string;
+  verbatimBlocks?: string[];
+}
+
+export class PromptBuilder {
+  assemble(i: AssembleInput): string {
+    if (i.userTask.includes(FORBIDDEN)) throw new Error('forbidden marker in user task');
+    const parts = [
+      `rid: ${i.rid}`,
+      `role: ${i.role}`,
+      `vendor: ${i.vendor}`,
+      ``,
+      `## Task`,
+      i.userTask,
+      ``,
+      `## Files (read-only)`,
+      ...i.files.map(f => `- ${f}`),
+      ``,
+      `## References`,
+      ...i.refs.map(r => `- ${r}`),
+      ``,
+      ...(i.verbatimBlocks ?? []),
+    ];
+    const out = parts.join('\n');
+    if (out.includes(FORBIDDEN)) throw new Error('forbidden marker leak');
+    return out;
+  }
+}

package/src/status-protocol.ts

@@ -0,0 +1,23 @@
+import type { ChildStatus } from './types.js';
+
+export interface HeartbeatEntry { progress: number; note: string; ts: number; }
+export interface AutoCompactEvent { at: number; threshold: '0.85' | '0.95'; tokensBefore: number; tokensAfter: number; scratchFile?: string; }
+
+export class StatusProtocol {
+  merge(rec: any, s: ChildStatus): any {
+    const next = { ...rec };
+    next.heartbeats = [...(rec.heartbeats ?? []), { progress: s.progress, note: s.note, ts: s.ts }];
+    if (next.heartbeats.length > 100) {
+      next.heartbeats = next.heartbeats.slice(-100);
+      next.heartbeatsTruncated = true;
+    }
+    next.status = s.state === 'running' ? 'running' : s.state;
+    return next;
+  }
+  isStale(lastBeatAt: number, thresholdSec = 300): boolean {
+    return Date.now() - lastBeatAt > thresholdSec * 1000;
+  }
+  appendCompactEvent(rec: any, ev: AutoCompactEvent): any {
+    return { ...rec, autoCompactEvents: [...(rec.autoCompactEvents ?? []), ev] };
+  }
+}

package/src/types.ts

@@ -0,0 +1,11 @@
+export type DetachedMode = 'in-process' | 'detached';
+export type VendorId = 'claude' | 'codex' | 'copilot';
+export interface ChildStatus {
+  rid: string;
+  vendor: VendorId;
+  progress: number;
+  state: 'running' | 'stale' | 'crashed' | 'oom-killed' | 'done' | 'spawn-failed';
+  note: string;
+  ts: number;
+  etaSec?: number;
+}

package/src/vendor/adapter.ts

@@ -0,0 +1,10 @@
+import type { ChildStatus } from '../types.js';
+
+export interface VendorAdapter {
+  readonly id: 'claude' | 'codex' | 'copilot';
+  readonly binary: string;
+  readonly maxPromptBytes: number;
+  headlessArgs(prompt: string, opts?: { autoCompactMarker?: string }): string[];
+  parseStatusLine(stdout: string): ChildStatus | null;
+  detectInstalled(): Promise<boolean>;
+}

package/src/vendor/claude-adapter.ts

@@ -0,0 +1,41 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import type { VendorAdapter } from './adapter.js';
+import type { ChildStatus } from '../types.js';
+
+const pExecFile = promisify(execFile);
+
+export class ClaudeAdapter implements VendorAdapter {
+  readonly id = 'claude' as const;
+  readonly binary = 'claude';
+  readonly maxPromptBytes = 8 * 1024;
+
+  headlessArgs(prompt: string, opts?: { autoCompactMarker?: string }): string[] {
+    const injected = opts?.autoCompactMarker
+      ? `${opts.autoCompactMarker}\n\n${prompt}`
+      : prompt;
+    return ['-p', injected, '--output-format', 'json', '--include-partial-messages'];
+  }
+
+  parseStatusLine(stdout: string): ChildStatus | null {
+    try {
+      const obj = JSON.parse(stdout);
+      if (typeof obj.progress !== 'number') return null;
+      return {
+        rid: String(obj.rid ?? ''),
+        vendor: 'claude',
+        progress: obj.progress,
+        state: obj.state,
+        note: String(obj.note ?? ''),
+        ts: Number(obj.ts ?? Date.now()),
+      };
+    } catch { return null; }
+  }
+
+  async detectInstalled(): Promise<boolean> {
+    try {
+      const { stdout } = await pExecFile(this.binary, ['--version'], { timeout: 3000 });
+      return stdout.length > 0;
+    } catch { return false; }
+  }
+}

package/src/vendor/codex-adapter.ts

@@ -0,0 +1,25 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import type { VendorAdapter } from './adapter.js';
+import type { ChildStatus } from '../types.js';
+const pExecFile = promisify(execFile);
+
+export class CodexAdapter implements VendorAdapter {
+  readonly id = 'codex' as const;
+  readonly binary = 'codex';
+  readonly maxPromptBytes = 5 * 1024;
+  headlessArgs(prompt: string): string[] {
+    return ['exec', '--json', prompt];
+  }
+  parseStatusLine(stdout: string): ChildStatus | null {
+    try {
+      const o = JSON.parse(stdout);
+      if (typeof o.progress !== 'number') return null;
+      return { rid: String(o.rid ?? ''), vendor: 'codex', progress: o.progress, state: o.state, note: String(o.note ?? ''), ts: Number(o.ts ?? Date.now()) };
+    } catch { return null; }
+  }
+  async detectInstalled(): Promise<boolean> {
+    try { const { stdout } = await pExecFile(this.binary, ['--version'], { timeout: 3000 }); return stdout.length > 0; }
+    catch { return false; }
+  }
+}

package/src/vendor/copilot-adapter.ts

@@ -0,0 +1,23 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import type { VendorAdapter } from './adapter.js';
+import type { ChildStatus } from '../types.js';
+const pExecFile = promisify(execFile);
+
+export class CopilotAdapter implements VendorAdapter {
+  readonly id = 'copilot' as const;
+  readonly binary = 'copilot';
+  readonly maxPromptBytes = 6 * 1024;
+  headlessArgs(prompt: string): string[] { return ['-p', prompt, '--output-format', 'json']; }
+  parseStatusLine(stdout: string): ChildStatus | null {
+    try {
+      const o = JSON.parse(stdout);
+      if (typeof o.progress !== 'number') return null;
+      return { rid: String(o.rid ?? ''), vendor: 'copilot', progress: o.progress, state: o.state, note: String(o.note ?? ''), ts: Number(o.ts ?? Date.now()) };
+    } catch { return null; }
+  }
+  async detectInstalled(): Promise<boolean> {
+    try { const { stdout } = await pExecFile(this.binary, ['--version'], { timeout: 3000 }); return stdout.length > 0; }
+    catch { return false; }
+  }
+}

package/src/vendor/registry.ts

@@ -0,0 +1,16 @@
+import type { VendorAdapter } from './adapter.js';
+import { ClaudeAdapter } from './claude-adapter.js';
+import { CodexAdapter } from './codex-adapter.js';
+import { CopilotAdapter } from './copilot-adapter.js';
+
+export class VendorAdapterRegistry {
+  private map = new Map<string, VendorAdapter>();
+  constructor(initial: VendorAdapter[] = []) {
+    for (const a of initial) this.map.set(a.id, a);
+  }
+  register(a: VendorAdapter): void { this.map.set(a.id, a); }
+  get(id: string): VendorAdapter | undefined { return this.map.get(id); }
+  list(): VendorAdapter[] { return [...this.map.values()]; }
+}
+
+export const defaultRegistry = () => new VendorAdapterRegistry([new ClaudeAdapter(), new CodexAdapter(), new CopilotAdapter()]);

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true
+  },
+  "include": ["src/**/*"]
+}