@zhin.js/agent 1.1.30 → 1.1.32

package/lib/detached-task/runner.js

@@ -0,0 +1,334 @@
+import { AgentStepStatus, createStepId } from '@zhin.js/ai/agent-step-checkpoint';
+import { getLogger, formatCompact } from '@zhin.js/logger';
+import { TurnProgressReporter } from '../core/progress-reporter.js';
+import { KeyedMutex } from '../utils/keyed-mutex.js';
+import { DEFAULT_DETACHED_TASK_CONFIG, DetachedTaskTransitionError, TERMINAL_DETACHED_TASK_STATUSES, canTransitionDetachedTask, } from './types.js';
+const logger = getLogger('DetachedTask');
+/** Thrown inside a step when a side effect may or may not have happened before a crash. */
+export class DetachedTaskOutcomeUnknownError extends Error {
+    taskId;
+    idempotencyKey;
+    constructor(taskId, idempotencyKey) {
+        super(`Detached task ${taskId}: outcome of side effect "${idempotencyKey}" is unknown after restart; not re-running it`);
+        this.taskId = taskId;
+        this.idempotencyKey = idempotencyKey;
+        this.name = 'DetachedTaskOutcomeUnknownError';
+    }
+}
+class DetachedTaskSuspend extends Error {
+    to;
+    reason;
+    constructor(to, reason) {
+        super(`suspend:${to}`);
+        this.to = to;
+        this.reason = reason;
+    }
+}
+function deepFreeze(value) {
+    if (value && typeof value === 'object' && !Object.isFrozen(value)) {
+        Object.freeze(value);
+        for (const v of Object.values(value))
+            deepFreeze(v);
+    }
+    return value;
+}
+function defaultTaskId() {
+    return `tsk_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+}
+export class DetachedTaskRunner {
+    #deps;
+    #config;
+    #now;
+    /** Serializes every read-modify-write of one task record (steer vs checkpoint vs transition). */
+    #writes = new KeyedMutex();
+    #active = new Map();
+    constructor(deps) {
+        this.#deps = deps;
+        this.#config = { ...DEFAULT_DETACHED_TASK_CONFIG, ...deps.config };
+        this.#now = deps.now ?? Date.now;
+    }
+    async create(input) {
+        if (!this.#deps.executors[input.kind])
+            throw new Error(`Unknown detached task kind: ${input.kind}`);
+        const now = this.#now();
+        const record = {
+            version: 1,
+            taskId: input.taskId ?? (this.#deps.createTaskId ?? defaultTaskId)(),
+            kind: input.kind,
+            goal: input.goal,
+            sessionId: input.sessionId,
+            createdBy: input.createdBy,
+            status: 'queued',
+            // Copy so later mutation of the creating turn's policy cannot leak in.
+            policy: deepFreeze(structuredClone(input.policy ?? {})),
+            delivery: input.delivery,
+            approval: input.approval,
+            steps: [],
+            effects: {},
+            attempts: 0,
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.#deps.store.save(record);
+        return record;
+    }
+    get(taskId) {
+        return this.#deps.store.load(taskId);
+    }
+    list() {
+        return this.#deps.store.list();
+    }
+    /** Start a queued task in the background; resolves with the final/suspended record. */
+    start(taskId) {
+        const active = this.#active.get(taskId);
+        if (active)
+            return active.done;
+        const controller = new AbortController();
+        const done = this.#run(taskId, controller.signal).finally(() => this.#active.delete(taskId));
+        this.#active.set(taskId, { controller, done });
+        return done;
+    }
+    /**
+     * After a process restart: re-queue tasks left `running`/`queued` and resume
+     * them from their last checkpoint. Tasks over `maxResumeAttempts` fail.
+     */
+    async recover() {
+        const runs = [];
+        for (const task of await this.#deps.store.list()) {
+            if (task.status !== 'running' && task.status !== 'queued')
+                continue;
+            if (this.#active.has(task.taskId))
+                continue;
+            let record = task;
+            if (record.status === 'running')
+                record = await this.#transition(record, 'queued');
+            if (record.attempts >= this.#config.maxResumeAttempts) {
+                record = await this.#transition(await this.#transition(record, 'running'), 'failed', {
+                    error: `已重启恢复 ${record.attempts} 次仍未完成，任务已停止。`,
+                });
+                await this.#notify(record.delivery, `后台任务失败：${record.error}`, record);
+                continue;
+            }
+            runs.push(this.start(record.taskId));
+        }
+        return runs;
+    }
+    /** Resume a task waiting for approval. */
+    async approve(taskId) {
+        const record = await this.#require(taskId);
+        if (record.status !== 'waiting_approval')
+            throw new DetachedTaskTransitionError(taskId, record.status, 'running');
+        await this.#transition(record, 'queued');
+        return this.start(taskId);
+    }
+    /** Re-queue a paused task and start it. */
+    async resume(taskId) {
+        const record = await this.#require(taskId);
+        await this.#transition(record, 'queued');
+        return this.start(taskId);
+    }
+    /** Queue a steering message; it is applied at the task's next step boundary. */
+    async steer(taskId, text) {
+        return this.#writes.run(taskId, async () => {
+            const record = await this.#require(taskId);
+            if (TERMINAL_DETACHED_TASK_STATUSES.has(record.status)) {
+                throw new DetachedTaskTransitionError(taskId, record.status, record.status);
+            }
+            const next = {
+                ...record,
+                pendingSteering: [...(record.pendingSteering ?? []), text],
+                updatedAt: this.#now(),
+            };
+            await this.#deps.store.save(next);
+            return next;
+        });
+    }
+    async cancel(taskId) {
+        const active = this.#active.get(taskId);
+        if (active) {
+            active.controller.abort(new Error('cancelled'));
+            // Don't hang on an executor that ignores the signal; step() refuses new steps after abort.
+            let timer;
+            await Promise.race([
+                active.done.catch(() => undefined),
+                new Promise((resolve) => { timer = setTimeout(resolve, this.#config.cancelGraceMs); }),
+            ]);
+            clearTimeout(timer);
+        }
+        const record = await this.#require(taskId);
+        if (record.status === 'cancelled')
+            return record;
+        return this.#transition(record, 'cancelled');
+    }
+    async #run(taskId, signal) {
+        let record = await this.#require(taskId);
+        const executor = this.#deps.executors[record.kind];
+        if (!executor)
+            throw new Error(`Unknown detached task kind: ${record.kind}`);
+        record = await this.#transition(record, 'running', { attempts: record.attempts + 1 });
+        const resumedSteps = record.steps;
+        let cursor = 0;
+        const reporter = new TurnProgressReporter({
+            sink: (text) => this.#notify(record.delivery, text, record, true),
+            minIntervalMs: this.#config.progressIntervalMs,
+            maxUpdates: this.#config.maxProgressUpdates,
+            summarize: async () => this.#deps.summarize?.(record),
+            now: this.#now,
+        });
+        const save = (patch) => this.#writes.run(taskId, async () => {
+            // steer() writes pendingSteering concurrently; under the lock, re-read it so it is never clobbered.
+            const pendingSteering = 'pendingSteering' in patch
+                ? patch.pendingSteering
+                : (await this.#deps.store.load(taskId))?.pendingSteering ?? record.pendingSteering;
+            record = { ...record, ...patch, pendingSteering, updatedAt: this.#now() };
+            await this.#deps.store.save(record);
+        });
+        const steeringReturnedAt = new Set();
+        const context = {
+            taskId,
+            goal: record.goal,
+            policy: deepFreeze(structuredClone(record.policy)),
+            signal,
+            state: record.state,
+            completedSteps: resumedSteps,
+            step: async (tool, run, options = {}) => {
+                signal.throwIfAborted();
+                const index = cursor++;
+                const replay = record.steps[index];
+                if (replay) {
+                    if (replay.tool !== tool) {
+                        throw new Error(`Detached task ${taskId}: step ${index} replay mismatch (${replay.tool} != ${tool})`);
+                    }
+                    return replay.result;
+                }
+                if (index >= this.#config.maxSteps)
+                    throw new Error(`已超过最大步数 ${this.#config.maxSteps}`);
+                const key = options.idempotencyKey;
+                const startedAt = this.#now();
+                if (key) {
+                    const effect = record.effects[key];
+                    if (effect?.status === 'committed')
+                        return this.#checkpoint(record, save, index, tool, effect.result, startedAt, key);
+                    if (effect) {
+                        await save({ effects: { ...record.effects, [key]: { ...effect, status: 'outcome_unknown' } } });
+                        throw new DetachedTaskOutcomeUnknownError(taskId, key);
+                    }
+                    await save({ effects: { ...record.effects, [key]: { key, tool, status: 'executing', startedAt } } });
+                }
+                const result = await run();
+                if (key) {
+                    await save({
+                        effects: { ...record.effects, [key]: { key, tool, status: 'committed', result, startedAt, finishedAt: this.#now() } },
+                    });
+                }
+                return this.#checkpoint(record, save, index, tool, result, startedAt, key);
+            },
+            saveState: (state) => save({ state }),
+            takeSteering: async () => {
+                const atStep = cursor;
+                // Logged steering for a boundary is handed out once per run: replayed after a restart,
+                // never duplicated when the executor asks twice at the same live boundary.
+                const logged = steeringReturnedAt.has(atStep)
+                    ? []
+                    : (record.steeringLog ?? []).filter((s) => s.atStep === atStep);
+                steeringReturnedAt.add(atStep);
+                // Replay: this boundary was already reached before a restart.
+                if (atStep < record.steps.length)
+                    return logged.map((s) => s.text);
+                // Read-and-clear atomically so a concurrent steer() is either taken now or kept for later.
+                const pending = await this.#writes.run(taskId, async () => {
+                    const taken = (await this.#deps.store.load(taskId))?.pendingSteering ?? [];
+                    if (taken.length === 0)
+                        return taken;
+                    const at = this.#now();
+                    record = {
+                        ...record,
+                        pendingSteering: [],
+                        steeringLog: [...(record.steeringLog ?? []), ...taken.map((text) => ({ atStep, text, at }))],
+                        updatedAt: at,
+                    };
+                    await this.#deps.store.save(record);
+                    return taken;
+                });
+                return [...logged.map((s) => s.text), ...pending];
+            },
+            progress: (interimText) => reporter.report('progress', { steps: record.steps.length, interimText }),
+            awaitApproval: (reason) => {
+                throw new DetachedTaskSuspend('waiting_approval', reason);
+            },
+        };
+        try {
+            const { summary } = await executor.run(context);
+            record = await this.#transition(record, 'done', { summary });
+            await this.#notify(record.delivery, `✅ 后台任务完成：${summary}`, record);
+        }
+        catch (error) {
+            if (error instanceof DetachedTaskSuspend) {
+                record = await this.#transition(record, error.to, {});
+                if (error.to === 'waiting_approval') {
+                    await this.#notify(record.approval ?? record.delivery, `后台任务需要确认：${error.reason ?? ''}`.trim(), record);
+                }
+            }
+            else if (signal.aborted) {
+                // cancel() performs the transition.
+            }
+            else {
+                const message = error instanceof Error ? error.message : String(error);
+                const target = error instanceof DetachedTaskOutcomeUnknownError ? 'waiting_approval' : 'failed';
+                record = await this.#transition(record, target, { error: message });
+                const text = target === 'waiting_approval'
+                    ? '后台任务在重启前可能已执行过一个有副作用的操作，结果无法确认；为避免重复执行，任务已暂停，请确认后再继续。'
+                    : `后台任务失败：${message}`;
+                await this.#notify(target === 'waiting_approval' ? record.approval ?? record.delivery : record.delivery, text, record);
+            }
+        }
+        logger.info(formatCompact({ op: 'detached_task', task: taskId, status: record.status, steps: record.steps.length }));
+        return record;
+    }
+    async #checkpoint(record, save, index, tool, result, startedAt, idempotencyKey) {
+        const step = {
+            index,
+            tool,
+            result,
+            idempotencyKey,
+            stepId: createStepId(),
+            turnId: record.taskId,
+            status: AgentStepStatus.COMPLETED,
+            startedAt,
+            completedAt: this.#now(),
+        };
+        await save({ steps: [...record.steps, step] });
+        return result;
+    }
+    async #require(taskId) {
+        const record = await this.#deps.store.load(taskId);
+        if (!record)
+            throw new Error(`Unknown detached task: ${taskId}`);
+        return record;
+    }
+    async #transition(record, to, patch = {}) {
+        const allowed = canTransitionDetachedTask(record.status, to);
+        if (!allowed || TERMINAL_DETACHED_TASK_STATUSES.has(record.status)) {
+            throw new DetachedTaskTransitionError(record.taskId, record.status, to);
+        }
+        return this.#writes.run(record.taskId, async () => {
+            const latest = (await this.#deps.store.load(record.taskId)) ?? record;
+            const next = { ...latest, ...patch, status: to, updatedAt: this.#now() };
+            await this.#deps.store.save(next);
+            return next;
+        });
+    }
+    async #notify(channel, text, task, rethrow = false) {
+        if (!this.#deps.deliver)
+            return;
+        try {
+            await this.#deps.deliver(channel, text, task);
+        }
+        catch (error) {
+            logger.warn(formatCompact({ op: 'detached_task_deliver_failed', task: task.taskId, error: String(error) }));
+            if (rethrow)
+                throw error;
+        }
+    }
+}
+//# sourceMappingURL=runner.js.map

package/lib/detached-task/runner.js.map

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

package/lib/detached-task/store.d.ts

@@ -0,0 +1,21 @@
+import type { DetachedTaskRecord } from './types.js';
+export interface DetachedTaskStore {
+    load(taskId: string): Promise<DetachedTaskRecord | undefined>;
+    save(record: DetachedTaskRecord): Promise<void>;
+    list(): Promise<readonly DetachedTaskRecord[]>;
+}
+export declare class InMemoryDetachedTaskStore implements DetachedTaskStore {
+    #private;
+    load(taskId: string): Promise<DetachedTaskRecord | undefined>;
+    save(record: DetachedTaskRecord): Promise<void>;
+    list(): Promise<DetachedTaskRecord[]>;
+}
+/** One JSON file per task, written atomically (temp file + rename). */
+export declare class FileDetachedTaskStore implements DetachedTaskStore {
+    private readonly root;
+    constructor(root: string);
+    load(taskId: string): Promise<DetachedTaskRecord | undefined>;
+    save(record: DetachedTaskRecord): Promise<void>;
+    list(): Promise<readonly DetachedTaskRecord[]>;
+}
+//# sourceMappingURL=store.d.ts.map

package/lib/detached-task/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/detached-task/store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,IAAI,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAC;CAChD;AAMD,qBAAa,yBAA0B,YAAW,iBAAiB;;IAE3D,IAAI,CAAC,MAAM,EAAE,MAAM;IAInB,IAAI,CAAC,MAAM,EAAE,kBAAkB;IAG/B,IAAI;CAGX;AAMD,uEAAuE;AACvE,qBAAa,qBAAsB,YAAW,iBAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IAEnC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAS7D,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/C,IAAI,IAAI,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC;CAcrD"}

package/lib/detached-task/store.js

@@ -0,0 +1,63 @@
+import { mkdir, readdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { randomUUID } from 'node:crypto';
+import { join } from 'node:path';
+function clone(value) {
+    return structuredClone(value);
+}
+export class InMemoryDetachedTaskStore {
+    #records = new Map();
+    async load(taskId) {
+        const r = this.#records.get(taskId);
+        return r && clone(r);
+    }
+    async save(record) {
+        this.#records.set(record.taskId, clone(record));
+    }
+    async list() {
+        return [...this.#records.values()].map(clone);
+    }
+}
+function fileName(taskId) {
+    return `${Buffer.from(taskId, 'utf8').toString('base64url')}.json`;
+}
+/** One JSON file per task, written atomically (temp file + rename). */
+export class FileDetachedTaskStore {
+    root;
+    constructor(root) {
+        this.root = root;
+    }
+    async load(taskId) {
+        try {
+            return JSON.parse(await readFile(join(this.root, fileName(taskId)), 'utf8'));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return undefined;
+            throw error;
+        }
+    }
+    async save(record) {
+        await mkdir(this.root, { recursive: true });
+        const target = join(this.root, fileName(record.taskId));
+        const temp = `${target}.${randomUUID()}.tmp`;
+        await writeFile(temp, JSON.stringify(record), 'utf8');
+        await rename(temp, target);
+    }
+    async list() {
+        let names;
+        try {
+            names = await readdir(this.root);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        }
+        const out = [];
+        for (const name of names.filter(n => n.endsWith('.json'))) {
+            out.push(JSON.parse(await readFile(join(this.root, name), 'utf8')));
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=store.js.map

package/lib/detached-task/store.js.map

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

package/lib/detached-task/token.d.ts

@@ -0,0 +1,8 @@
+import type { DetachedTaskRunner } from './runner.js';
+/**
+ * A plugin that owns detached-task executors provides its runner under this
+ * token. The IM ingress then routes `/tasks`, `/task …` and interjections to
+ * it. No provider means detached tasks are off and ingress is unchanged.
+ */
+export declare const detachedTaskRunnerToken: import("@zhin.js/plugin-runtime").Token<DetachedTaskRunner>;
+//# sourceMappingURL=token.d.ts.map

package/lib/detached-task/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/detached-task/token.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,6DAGnC,CAAC"}

package/lib/detached-task/token.js

@@ -0,0 +1,8 @@
+import { createToken } from '@zhin.js/plugin-runtime';
+/**
+ * A plugin that owns detached-task executors provides its runner under this
+ * token. The IM ingress then routes `/tasks`, `/task …` and interjections to
+ * it. No provider means detached tasks are off and ingress is unchanged.
+ */
+export const detachedTaskRunnerToken = createToken('zhin.agent.detached-task-runner', 'Detached background task runner (#731/#732)');
+//# sourceMappingURL=token.js.map

package/lib/detached-task/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/detached-task/token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,WAAW,CAChD,iCAAiC,EACjC,6CAA6C,CAC9C,CAAC"}

package/lib/detached-task/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Detached tasks (#731, roadmap P5 M5.1–M5.3): background work with its own
+ * taskId, a persisted state machine, a frozen permission snapshot, step
+ * checkpoints and idempotency keys for side-effecting tool calls.
+ */
+import type { AgentStepCheckpoint } from '@zhin.js/ai/agent-step-checkpoint';
+import type { ToolInvocationPolicy } from '@zhin.js/tool';
+export declare const DetachedTaskStatus: {
+    readonly QUEUED: "queued";
+    readonly RUNNING: "running";
+    readonly WAITING_APPROVAL: "waiting_approval";
+    readonly PAUSED: "paused";
+    readonly DONE: "done";
+    readonly FAILED: "failed";
+    readonly CANCELLED: "cancelled";
+};
+export type DetachedTaskStatusName = (typeof DetachedTaskStatus)[keyof typeof DetachedTaskStatus];
+export declare const TERMINAL_DETACHED_TASK_STATUSES: ReadonlySet<DetachedTaskStatusName>;
+/** Allowed transitions. Terminal states never move again. */
+export declare const DETACHED_TASK_TRANSITIONS: Readonly<Record<DetachedTaskStatusName, readonly DetachedTaskStatusName[]>>;
+export declare class DetachedTaskTransitionError extends Error {
+    readonly taskId: string;
+    readonly from: DetachedTaskStatusName;
+    readonly to: DetachedTaskStatusName;
+    constructor(taskId: string, from: DetachedTaskStatusName, to: DetachedTaskStatusName);
+}
+export declare function canTransitionDetachedTask(from: DetachedTaskStatusName, to: DetachedTaskStatusName): boolean;
+/** Permission snapshot frozen when the task is created; resume never widens it. */
+export type DetachedTaskPolicy = Readonly<Pick<ToolInvocationPolicy, 'shell' | 'filesystem'>>;
+/** Where progress/results go, and where approval requests go. Opaque to the runner. */
+export interface DetachedTaskChannel {
+    readonly adapter?: string;
+    readonly endpointId?: string;
+    readonly sceneId?: string;
+    readonly sceneType?: string;
+}
+/** A completed tool call recorded after each step (M5.2). */
+export interface DetachedTaskStep extends AgentStepCheckpoint {
+    readonly index: number;
+    readonly tool: string;
+    readonly result: unknown;
+    readonly idempotencyKey?: string;
+}
+export interface DetachedTaskSteering {
+    /** Number of steps completed when the steering was applied. */
+    readonly atStep: number;
+    readonly text: string;
+    readonly at: number;
+}
+export type DetachedTaskEffectStatus = 'executing' | 'committed' | 'outcome_unknown';
+/** Effect ledger entry for a side-effecting call, keyed by its idempotency key. */
+export interface DetachedTaskEffect {
+    readonly key: string;
+    readonly tool: string;
+    readonly status: DetachedTaskEffectStatus;
+    readonly result?: unknown;
+    readonly startedAt: number;
+    readonly finishedAt?: number;
+}
+export interface DetachedTaskRecord {
+    readonly version: 1;
+    readonly taskId: string;
+    /** Executor kind, used to pick the executor again after a restart. */
+    readonly kind: string;
+    readonly goal: string;
+    readonly sessionId?: string;
+    /** Principal that created the task; only they (or a master) may stop or redirect it. */
+    readonly createdBy?: string;
+    /** Steering messages queued by the user, applied at the next step boundary (#732). */
+    readonly pendingSteering?: readonly string[];
+    /** Steering already applied, keyed by the step boundary it was applied at (replayed on resume). */
+    readonly steeringLog?: readonly DetachedTaskSteering[];
+    readonly status: DetachedTaskStatusName;
+    readonly policy: DetachedTaskPolicy;
+    readonly delivery?: DetachedTaskChannel;
+    readonly approval?: DetachedTaskChannel;
+    readonly steps: readonly DetachedTaskStep[];
+    readonly effects: Readonly<Record<string, DetachedTaskEffect>>;
+    /** Free-form executor state saved with each checkpoint (e.g. a cursor). */
+    readonly state?: unknown;
+    readonly summary?: string;
+    readonly error?: string;
+    readonly attempts: number;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+}
+/**
+ * Conservative defaults. Background tasks are opt-in: nothing creates one
+ * unless a caller does so explicitly.
+ */
+export interface DetachedTaskConfig {
+    /** Minimum gap between progress pushes (ms). Default 60 000. */
+    readonly progressIntervalMs?: number;
+    /** Max progress pushes per task run. Default 10. */
+    readonly maxProgressUpdates?: number;
+    /** Max steps (tool calls) before the task fails as runaway. Default 50. */
+    readonly maxSteps?: number;
+    /** Max automatic resumes after a restart before failing. Default 3. */
+    readonly maxResumeAttempts?: number;
+    /** How long cancel waits for the running executor to settle (ms). Default 5 000. */
+    readonly cancelGraceMs?: number;
+}
+export declare const DEFAULT_DETACHED_TASK_CONFIG: Readonly<Required<DetachedTaskConfig>>;
+//# sourceMappingURL=types.d.ts.map

package/lib/detached-task/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/detached-task/types.ts"],"names":[],"mappings":"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"}

package/lib/detached-task/types.js

@@ -0,0 +1,43 @@
+export const DetachedTaskStatus = {
+    QUEUED: 'queued',
+    RUNNING: 'running',
+    WAITING_APPROVAL: 'waiting_approval',
+    PAUSED: 'paused',
+    DONE: 'done',
+    FAILED: 'failed',
+    CANCELLED: 'cancelled',
+};
+export const TERMINAL_DETACHED_TASK_STATUSES = new Set(['done', 'failed', 'cancelled']);
+/** Allowed transitions. Terminal states never move again. */
+export const DETACHED_TASK_TRANSITIONS = Object.freeze({
+    queued: ['running', 'cancelled'],
+    running: ['waiting_approval', 'paused', 'done', 'failed', 'cancelled', 'queued'],
+    waiting_approval: ['queued', 'running', 'failed', 'cancelled'],
+    paused: ['queued', 'cancelled'],
+    done: [],
+    failed: [],
+    cancelled: [],
+});
+export class DetachedTaskTransitionError extends Error {
+    taskId;
+    from;
+    to;
+    constructor(taskId, from, to) {
+        super(`Detached task ${taskId}: illegal transition ${from} -> ${to}`);
+        this.taskId = taskId;
+        this.from = from;
+        this.to = to;
+        this.name = 'DetachedTaskTransitionError';
+    }
+}
+export function canTransitionDetachedTask(from, to) {
+    return DETACHED_TASK_TRANSITIONS[from].includes(to);
+}
+export const DEFAULT_DETACHED_TASK_CONFIG = Object.freeze({
+    progressIntervalMs: 60_000,
+    maxProgressUpdates: 10,
+    maxSteps: 50,
+    maxResumeAttempts: 3,
+    cancelGraceMs: 5_000,
+});
+//# sourceMappingURL=types.js.map

package/lib/detached-task/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/detached-task/types.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,gBAAgB,EAAE,kBAAkB;IACpC,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;CACd,CAAC;AAIX,MAAM,CAAC,MAAM,+BAA+B,GAAwC,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;AAE7H,6DAA6D;AAC7D,MAAM,CAAC,MAAM,yBAAyB,GAAgF,MAAM,CAAC,MAAM,CAAC;IAClI,MAAM,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,OAAO,EAAE,CAAC,kBAAkB,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;IAChF,gBAAgB,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC;IAC9D,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,IAAI,EAAE,EAAE;IACR,MAAM,EAAE,EAAE;IACV,SAAS,EAAE,EAAE;CACd,CAAC,CAAC;AAEH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAC/B;IAAyB;IAAuC;IAArF,YAAqB,MAAc,EAAW,IAA4B,EAAW,EAA0B;QAC7G,KAAK,CAAC,iBAAiB,MAAM,wBAAwB,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC;QADnD,WAAM,GAAN,MAAM,CAAQ;QAAW,SAAI,GAAJ,IAAI,CAAwB;QAAW,OAAE,GAAF,EAAE,CAAwB;QAE7G,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AAED,MAAM,UAAU,yBAAyB,CAAC,IAA4B,EAAE,EAA0B;IAChG,OAAO,yBAAyB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACtD,CAAC;AAqFD,MAAM,CAAC,MAAM,4BAA4B,GAA2C,MAAM,CAAC,MAAM,CAAC;IAChG,kBAAkB,EAAE,MAAM;IAC1B,kBAAkB,EAAE,EAAE;IACtB,QAAQ,EAAE,EAAE;IACZ,iBAAiB,EAAE,CAAC;IACpB,aAAa,EAAE,KAAK;CACrB,CAAC,CAAC"}