@canhta/dsh-autopilot 0.1.0-alpha.1

package/lib/dispatch/git.js

@@ -0,0 +1,95 @@
+import { realpath } from 'node:fs/promises';
+const GIT_OUTPUT_LIMIT = 1024 * 1024;
+const GIT_GRACE_MS = 5_000;
+const GIT_TIMEOUT_MS = 30_000;
+export async function inspectRetainedWorktree(subprocess, run) {
+    const retainedGit = run.execution.git;
+    if (retainedGit === undefined)
+        throw new Error('the retained run has no Git checkpoint');
+    const observedRoot = await gitCommand(subprocess, run.execution.worktreePath, ['rev-parse', '--show-toplevel']);
+    const observedBranch = await gitCommand(subprocess, run.execution.worktreePath, ['rev-parse', '--abbrev-ref', 'HEAD']);
+    const observedCommonDirectory = await gitCommand(subprocess, run.execution.worktreePath, [
+        'rev-parse',
+        '--path-format=absolute',
+        '--git-common-dir',
+    ]);
+    const targetCommonDirectory = await gitCommand(subprocess, run.execution.targetRepository, [
+        'rev-parse',
+        '--path-format=absolute',
+        '--git-common-dir',
+    ]);
+    const [canonicalRoot, canonicalWorktree, canonicalCommonDirectory, canonicalTargetCommonDirectory] = await Promise.all([
+        realpath(observedRoot.trim()),
+        realpath(run.execution.worktreePath),
+        realpath(observedCommonDirectory.trim()),
+        realpath(targetCommonDirectory.trim()),
+    ]);
+    if (canonicalRoot !== canonicalWorktree ||
+        canonicalCommonDirectory !== canonicalTargetCommonDirectory ||
+        observedBranch.trim() !== run.execution.branch) {
+        throw new Error('the retained path is not the recorded managed Git worktree and branch');
+    }
+    return await inspectGit(subprocess, run.execution.worktreePath, retainedGit.baseHead);
+}
+export async function inspectGit(subprocess, worktreePath, baseHead) {
+    const head = (await gitCommand(subprocess, worktreePath, ['rev-parse', 'HEAD'])).trim();
+    const status = await gitCommand(subprocess, worktreePath, ['status', '--porcelain']);
+    return { baseHead, head, status };
+}
+export async function gitCommand(subprocess, cwd, args, callerSignal) {
+    const executable = await subprocess.resolveExecutable('git');
+    callerSignal?.throwIfAborted();
+    const timeout = AbortSignal.timeout(GIT_TIMEOUT_MS);
+    const signal = callerSignal === undefined ? timeout : AbortSignal.any([timeout, callerSignal]);
+    const handle = subprocess.spawn({
+        argv: [executable, ...args],
+        cwd,
+        stdio: {
+            stdin: 'ignore',
+            stdout: { maxBytes: GIT_OUTPUT_LIMIT },
+            stderr: { maxBytes: GIT_OUTPUT_LIMIT },
+        },
+        graceMs: GIT_GRACE_MS,
+        signal,
+    });
+    let outcome;
+    let commandError;
+    try {
+        outcome = await handle.done;
+    }
+    catch (error) {
+        commandError = error;
+    }
+    let quiescenceError;
+    try {
+        if (!(await handle.waitForExit(AbortSignal.timeout(GIT_GRACE_MS * 2)))) {
+            quiescenceError = new Error(`git ${args[0] ?? ''} left a live managed process`);
+        }
+    }
+    catch (error) {
+        quiescenceError = error;
+    }
+    if (commandError !== undefined) {
+        if (quiescenceError !== undefined) {
+            throw new AggregateError([commandError, quiescenceError], `git ${args[0] ?? ''} failed and did not quiesce`);
+        }
+        throw commandError;
+    }
+    if (quiescenceError !== undefined)
+        throw quiescenceError;
+    if (outcome === undefined)
+        throw new Error(`git ${args[0] ?? ''} produced no process outcome`);
+    const stdout = handle.collected.stdout?.readFrom(0);
+    const stderr = handle.collected.stderr?.readFrom(0);
+    if (stdout?.lossy || stderr?.lossy)
+        throw new Error(`git ${args[0] ?? ''} output exceeded its safety bound`);
+    callerSignal?.throwIfAborted();
+    if (timeout.aborted)
+        throw new Error(`git ${args.join(' ')} timed out`);
+    if (outcome.exitCode !== 0) {
+        const diagnostic = stderr?.text.trim() || stdout?.text.trim() || `exit ${String(outcome.exitCode)}`;
+        throw new Error(`git ${args.join(' ')} failed: ${diagnostic}`);
+    }
+    return stdout?.text ?? '';
+}
+//# sourceMappingURL=git.js.map

package/lib/dispatch/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/dispatch/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAI3C,MAAM,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAAA;AACpC,MAAM,YAAY,GAAG,KAAK,CAAA;AAC1B,MAAM,cAAc,GAAG,MAAM,CAAA;AAE7B,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,UAA6B,EAC7B,GAAoB;IAEpB,MAAM,WAAW,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAA;IACrC,IAAI,WAAW,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IACxF,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAA;IAC/G,MAAM,cAAc,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,CAAA;IACtH,MAAM,uBAAuB,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE;QACvF,WAAW;QACX,wBAAwB;QACxB,kBAAkB;KACnB,CAAC,CAAA;IACF,MAAM,qBAAqB,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,gBAAgB,EAAE;QACzF,WAAW;QACX,wBAAwB;QACxB,kBAAkB;KACnB,CAAC,CAAA;IACF,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,8BAA8B,CAAC,GAChG,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC7B,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC;QACpC,QAAQ,CAAC,uBAAuB,CAAC,IAAI,EAAE,CAAC;QACxC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,EAAE,CAAC;KACvC,CAAC,CAAA;IACJ,IACE,aAAa,KAAK,iBAAiB;QACnC,wBAAwB,KAAK,8BAA8B;QAC3D,cAAc,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,SAAS,CAAC,MAAM,EAC9C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAA;IAC1F,CAAC;IACD,OAAO,MAAM,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAA;AACvF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,UAA6B,EAC7B,YAAoB,EACpB,QAAgB;IAEhB,MAAM,IAAI,GAAG,CAAC,MAAM,UAAU,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IACvF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAA;IACpF,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AACnC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,UAA6B,EAC7B,GAAW,EACX,IAAuB,EACvB,YAA0B;IAE1B,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAA;IAC5D,YAAY,EAAE,cAAc,EAAE,CAAA;IAC9B,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IACnD,MAAM,MAAM,GAAG,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAA;IAC9F,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC;QAC9B,IAAI,EAAE,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;QAC3B,GAAG;QACH,KAAK,EAAE;YACL,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE;YACtC,MAAM,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE;SACvC;QACD,OAAO,EAAE,YAAY;QACrB,MAAM;KACP,CAAC,CAAA;IACF,IAAI,OAAgD,CAAA;IACpD,IAAI,YAAqB,CAAA;IACzB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAA;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,YAAY,GAAG,KAAK,CAAA;IACtB,CAAC;IACD,IAAI,eAAwB,CAAA;IAC5B,IAAI,CAAC;QACH,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,eAAe,GAAG,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,8BAA8B,CAAC,CAAA;QACjF,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,eAAe,GAAG,KAAK,CAAA;IACzB,CAAC;IACD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,IAAI,cAAc,CAAC,CAAC,YAAY,EAAE,eAAe,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,6BAA6B,CAAC,CAAA;QAC9G,CAAC;QACD,MAAM,YAAY,CAAA;IACpB,CAAC;IACD,IAAI,eAAe,KAAK,SAAS;QAAE,MAAM,eAAe,CAAA;IACxD,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,8BAA8B,CAAC,CAAA;IAC9F,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;IACnD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;IACnD,IAAI,MAAM,EAAE,KAAK,IAAI,MAAM,EAAE,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,mCAAmC,CAAC,CAAA;IAC5G,YAAY,EAAE,cAAc,EAAE,CAAA;IAC9B,IAAI,OAAO,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IACvE,IAAI,OAAO,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,QAAQ,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAA;QACnG,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,UAAU,EAAE,CAAC,CAAA;IAChE,CAAC;IACD,OAAO,MAAM,EAAE,IAAI,IAAI,EAAE,CAAA;AAC3B,CAAC"}

package/lib/dispatch/index.d.ts

@@ -0,0 +1,2 @@
+export type { DispatchResult } from './contract.js';
+export { Dispatch, default } from './service.js';

package/lib/dispatch/index.js

@@ -0,0 +1,2 @@
+export { Dispatch, default } from './service.js';
+//# sourceMappingURL=index.js.map

package/lib/dispatch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dispatch/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/lib/dispatch/report.d.ts

@@ -0,0 +1,11 @@
+import type { ExecutionOutcome, GitExecutionSnapshot, ImplementingRun, PausingRun } from '../admission.js';
+export interface ReportRecorder {
+    outcome?: ExecutionOutcome;
+    violation?: string;
+}
+export declare function createReportTool(recorder: ReportRecorder): import("@deepseek-ai/dsh-tools").ToolDefinition;
+export declare function validatedOutcome(report: ReportRecorder, git: GitExecutionSnapshot): ExecutionOutcome;
+export declare function executionPrompt(run: ImplementingRun | PausingRun): string;
+export declare function continuationPrompt(run: ImplementingRun): string;
+export declare function errorMessage(error: unknown): string;
+export declare function truncateUtf8(value: string): string;

package/lib/dispatch/report.js

@@ -0,0 +1,141 @@
+import { defineTool } from '@deepseek-ai/dsh-tools';
+const MAX_REPORT_TEXT_BYTES = 4 * 1024;
+const MAX_REPORT_EVIDENCE = 100;
+const textEncoder = new TextEncoder();
+export function createReportTool(recorder) {
+    return defineTool({
+        name: 'autopilot_report',
+        description: 'Submit the single structured terminal report for this Autopilot run.',
+        parameters: {
+            kind: { type: 'string', enum: ['verified', 'blocked', 'failed'], required: true },
+            summary: { type: 'string', required: true },
+            evidence: { type: 'array', items: { type: 'string' }, required: true },
+            gitHead: { type: 'string' },
+            gitStatus: { type: 'string' },
+            verification: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    additionalProperties: false,
+                    properties: {
+                        command: { type: 'string', required: true },
+                        status: { type: 'string', enum: ['passed', 'failed', 'skipped'], required: true },
+                        summary: { type: 'string', required: true },
+                        reason: { type: 'string' },
+                    },
+                },
+            },
+            pullRequestTitle: { type: 'string' },
+            pullRequestBody: { type: 'string' },
+        },
+        output: {
+            schema: { type: 'string', const: 'accepted' },
+            render: () => [{ type: 'text', text: 'Autopilot accepted the terminal report.' }],
+        },
+        async execute(args) {
+            if (recorder.outcome !== undefined) {
+                recorder.violation = 'the model submitted more than one terminal report';
+                throw new Error(recorder.violation);
+            }
+            if (args.summary.length === 0 || textEncoder.encode(args.summary).byteLength > MAX_REPORT_TEXT_BYTES) {
+                throw new TypeError('report summary must be non-empty and within its durable limit');
+            }
+            if (args.evidence.length > MAX_REPORT_EVIDENCE ||
+                args.evidence.some((entry) => entry.length === 0 || textEncoder.encode(entry).byteLength > MAX_REPORT_TEXT_BYTES)) {
+                throw new TypeError('report evidence must contain only bounded non-empty entries');
+            }
+            if (args.kind === 'verified') {
+                if (args.gitHead === undefined ||
+                    !/^[a-f0-9]{40,64}$/.test(args.gitHead) ||
+                    args.gitStatus === undefined ||
+                    args.verification === undefined ||
+                    args.verification.length === 0 ||
+                    args.pullRequestTitle === undefined ||
+                    args.pullRequestBody === undefined) {
+                    throw new TypeError('verified reports require exact Git facts, verification results, and a PR payload');
+                }
+                if (args.verification.length > MAX_REPORT_EVIDENCE ||
+                    args.verification.some((result) => result.command.length === 0 ||
+                        result.summary.length === 0 ||
+                        result.status === 'failed' ||
+                        (result.status === 'skipped') !== (result.reason !== undefined) ||
+                        [result.command, result.summary, result.reason]
+                            .filter((value) => value !== undefined)
+                            .some((value) => textEncoder.encode(value).byteLength > MAX_REPORT_TEXT_BYTES)) ||
+                    args.pullRequestTitle.length === 0 ||
+                    textEncoder.encode(args.pullRequestTitle).byteLength > MAX_REPORT_TEXT_BYTES ||
+                    args.pullRequestBody.length === 0 ||
+                    textEncoder.encode(args.pullRequestBody).byteLength > 32 * 1024) {
+                    throw new TypeError('verified report evidence or PR payload is invalid');
+                }
+                recorder.outcome = {
+                    kind: args.kind,
+                    summary: args.summary,
+                    evidence: [...args.evidence],
+                    reportedGit: { head: args.gitHead, status: args.gitStatus },
+                    verification: args.verification.map((result) => ({ ...result })),
+                    suggestedPullRequest: { title: args.pullRequestTitle, body: args.pullRequestBody },
+                };
+            }
+            else {
+                if (args.gitHead !== undefined ||
+                    args.gitStatus !== undefined ||
+                    args.verification !== undefined ||
+                    args.pullRequestTitle !== undefined ||
+                    args.pullRequestBody !== undefined) {
+                    throw new TypeError('blocked and failed reports must not claim verified publication facts');
+                }
+                recorder.outcome = { kind: args.kind, summary: args.summary, evidence: [...args.evidence] };
+            }
+            return 'accepted';
+        },
+    });
+}
+export function validatedOutcome(report, git) {
+    if (report.violation !== undefined) {
+        return { kind: 'failed', summary: 'The Agent violated the report contract.', evidence: [report.violation] };
+    }
+    if (report.outcome === undefined) {
+        return { kind: 'failed', summary: 'The Agent did not submit a terminal report.', evidence: [] };
+    }
+    if (report.outcome.kind === 'verified' &&
+        (report.outcome.reportedGit.head !== git.head || report.outcome.reportedGit.status !== git.status)) {
+        return {
+            kind: 'failed',
+            summary: 'The Agent reported Git facts that do not match the managed worktree.',
+            evidence: [truncateUtf8(`head=${git.head}\nstatus=${git.status}`)],
+        };
+    }
+    return report.outcome;
+}
+export function executionPrompt(run) {
+    const git = run.execution.git;
+    if (git === undefined)
+        throw new Error('the managed worktree has no durable Git facts');
+    return `Execute the approved Agent Brief below in the managed worktree. Use autopilot_report exactly once with a verified, blocked, or failed outcome before finishing. A verified report must repeat the exact final Git head and porcelain status, list each verification command/result or explicit skip reason, and supply a ready-for-review pull-request title and body.\n\nManaged Git head: ${git.head}\nManaged Git status: ${JSON.stringify(git.status)}\n\n${run.brief.content}`;
+}
+export function continuationPrompt(run) {
+    const git = run.execution.git;
+    if (git === undefined)
+        throw new Error('the managed worktree has no durable Git facts');
+    return `Continue the approved Agent Brief in this same persisted Session and managed worktree. Reconcile any interrupted operation from the prior pause before repeating a side effect. Use autopilot_report exactly once with a verified, blocked, or failed outcome before finishing. A verified report must repeat the exact final Git head and porcelain status, list each verification command/result or explicit skip reason, and supply a ready-for-review pull-request title and body.\n\nManaged Git head: ${git.head}\nManaged Git status: ${JSON.stringify(git.status)}\n\n${run.brief.content}`;
+}
+export function errorMessage(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return message || 'unknown Agent execution failure';
+}
+export function truncateUtf8(value) {
+    if (textEncoder.encode(value).byteLength <= MAX_REPORT_TEXT_BYTES)
+        return value;
+    let low = 0;
+    let high = value.length;
+    while (low < high) {
+        const middle = Math.ceil((low + high) / 2);
+        if (textEncoder.encode(value.slice(0, middle)).byteLength <= MAX_REPORT_TEXT_BYTES)
+            low = middle;
+        else
+            high = middle - 1;
+    }
+    return value.slice(0, low);
+}
+//# sourceMappingURL=report.js.map

package/lib/dispatch/report.js.map

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

package/lib/dispatch/resume.d.ts

@@ -0,0 +1,17 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { AgentHandle } from '@deepseek-ai/dsh-agent';
+import type { Workspace } from '@deepseek-ai/dsh-workspace';
+import type { ActiveResumeAuthorization, ImplementingRun, RunId } from '../admission.js';
+import { type ActiveExecution } from './execution-state.js';
+import { type ReportRecorder } from './report.js';
+import { type UsageRecorder } from './usage.js';
+export interface PreparedResume {
+    readonly run: ImplementingRun;
+    readonly active: ActiveExecution;
+    readonly handle: AgentHandle;
+    readonly usage: UsageRecorder;
+    readonly report: ReportRecorder;
+    readonly workspace: Workspace;
+    readonly baseHead: string;
+}
+export declare function preparePausedResume(ctx: Context, activeExecutions: Map<RunId, ActiveExecution>, runId: RunId, authorization: ActiveResumeAuthorization): Promise<PreparedResume>;

package/lib/dispatch/resume.js

@@ -0,0 +1,89 @@
+import { AgentCompositionUnavailableError, applyAgentPermission, assertAgentCompositionAvailable, modelSelection, mountAgentComposition, } from './composition.js';
+import { activeExecution, currentRun, isPausedActive, sameGit } from './execution-state.js';
+import { inspectRetainedWorktree } from './git.js';
+import { createReportTool, errorMessage } from './report.js';
+import { registerUsageRecorder } from './usage.js';
+export async function preparePausedResume(ctx, activeExecutions, runId, authorization) {
+    const snapshot = ctx.admission.snapshot();
+    if (snapshot.scheduler.mode !== 'enabled')
+        throw new Error('scheduler must be enabled to resume a run');
+    if (snapshot.budget.usageUncertain) {
+        throw new Error('deployment token usage is uncertain; reconcile it before resuming');
+    }
+    const paused = currentRun(snapshot, runId);
+    if (!isPausedActive(paused))
+        throw new Error(`run "${runId}" is not an allocated paused run`);
+    if (paused.execution.recovery !== undefined) {
+        throw new Error(`run "${runId}" requires explicit ${paused.execution.recovery.reason} recovery`);
+    }
+    const remainingTokens = paused.budget.capTokens - paused.budget.settledTokens;
+    if (remainingTokens <= 0)
+        throw new Error(`run "${runId}" has no retained token capacity`);
+    const continuationAllowance = Math.min(paused.budget.allowanceTokens, remainingTokens);
+    const composition = paused.execution.agent;
+    if (composition === undefined) {
+        return await rejectResumeForRecovery(ctx, paused, 'composition-unavailable', `run "${runId}" predates native DSH composition and cannot be resumed safely`);
+    }
+    try {
+        await assertAgentCompositionAvailable(ctx, composition);
+    }
+    catch (error) {
+        if (!(error instanceof AgentCompositionUnavailableError))
+            throw error;
+        return await rejectResumeForRecovery(ctx, paused, 'composition-unavailable', `run "${runId}" retained DSH composition changed or is unavailable and requires explicit recovery: ${errorMessage(error.cause ?? error)}`);
+    }
+    const persisted = await ctx.sessionPersistence.stat(paused.execution.sessionId);
+    if (persisted?.header.id !== paused.execution.sessionId || persisted.header.cwd !== paused.execution.worktreePath) {
+        return await rejectResumeForRecovery(ctx, paused, 'session-unavailable', `run "${runId}" retained Session is unavailable or incompatible and requires explicit recovery`);
+    }
+    const retainedGit = paused.execution.git;
+    if (retainedGit === undefined)
+        throw new Error(`run "${runId}" has no retained Git checkpoint`);
+    const workspace = await ctx.workspaceRegistry.resolveByPath(paused.execution.worktreePath);
+    if (workspace === undefined || !workspace.sessionIds.includes(paused.execution.sessionId)) {
+        return await rejectResumeForRecovery(ctx, paused, 'workspace-unavailable', `run "${runId}" retained workspace ownership is unavailable and requires explicit recovery`);
+    }
+    let observedGit;
+    try {
+        observedGit = await inspectRetainedWorktree(ctx.subprocess, paused);
+    }
+    catch (error) {
+        return await rejectResumeForRecovery(ctx, paused, 'worktree-mismatch', `run "${runId}" retained worktree is unavailable or incompatible and requires explicit recovery: ${errorMessage(error)}`);
+    }
+    if (!sameGit(retainedGit, observedGit)) {
+        return await rejectResumeForRecovery(ctx, paused, 'worktree-mismatch', `run "${runId}" retained Git state changed and requires explicit recovery`);
+    }
+    const usage = { usage: [], requests: 0 };
+    const report = {};
+    const selected = modelSelection(composition);
+    const handle = await ctx.agents.resume({
+        resumeSessionId: paused.execution.sessionId,
+        agentOptions: {
+            ...selected,
+            maxTokens: continuationAllowance,
+        },
+        setup: async (agentCtx) => {
+            await mountAgentComposition(ctx, agentCtx, composition);
+            registerUsageRecorder(agentCtx, paused, composition, usage);
+            agentCtx.tools.register(createReportTool(report));
+        },
+    });
+    let resumed;
+    try {
+        applyAgentPermission(ctx, handle.agent.session, composition);
+        resumed = await ctx.admission.resumeActiveRun(runId, observedGit, authorization);
+    }
+    catch (error) {
+        await handle.dispose();
+        throw error;
+    }
+    const active = activeExecution();
+    active.handle = handle;
+    activeExecutions.set(runId, active);
+    return { run: resumed, active, handle, usage, report, workspace, baseHead: retainedGit.baseHead };
+}
+async function rejectResumeForRecovery(ctx, paused, reason, message) {
+    await ctx.admission.requireActiveRecovery(paused.runId, reason);
+    throw new Error(message);
+}
+//# sourceMappingURL=resume.js.map

package/lib/dispatch/resume.js.map

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

package/lib/dispatch/service.d.ts

@@ -0,0 +1,56 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { Service } from '@deepseek-ai/cordis';
+import type { AdmissionSnapshot, PausedActiveRun, RunId } from '../admission.js';
+import type { DispatchResult } from './contract.js';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        dispatch: Dispatch;
+    }
+}
+/** Durable dispatcher composed from the Host's configured DSH Agent, preset, model, Session, and workspace services. */
+export declare class Dispatch extends Service {
+    static readonly inject: string[];
+    private readonly active;
+    private readonly starts;
+    private accepting;
+    constructor(ctx: Context);
+    [Service.init](): AsyncGenerator<() => Promise<void>, void, void>;
+    /**
+     * Claim and execute the next queued run through the Host's configured DSH preset and model, or return undefined when
+     * the queue is empty. Requires the injected DSH execution services, valid execution Settings, and Git.
+     * The method reserves durable budget before Git/model effects, owns the root Agent to quiescence, flushes its Session,
+     * records final Git facts, and settles a structured terminal outcome. Setup/model/Git failures become a failed run
+     * when the aggregate remains writable; an aggregate write failure rejects for explicit recovery. The operation
+     * accepts no caller cancellation signal.
+     */
+    dispatchNext(): Promise<DispatchResult | undefined>;
+    private prepareNext;
+    /**
+     * Atomically disable scheduler admission/dequeue, request native cancellation for every live root, and resolve only
+     * after each owned execution has reached a durable pause checkpoint. Cancellation-resistant work remains `pausing`
+     * and keeps its reservation while this operation waits. Recovered runs without a live owner remain explicit recovery.
+     */
+    disableScheduler(): Promise<AdmissionSnapshot>;
+    /**
+     * Request an operator hold for one live allocated run, cancel its native root, and resolve only after its Session and
+     * Autopilot checkpoint are durable. Queued work must use `Admission.holdQueued`; absent live ownership rejects.
+     */
+    stopRun(runId: RunId): Promise<PausedActiveRun>;
+    /**
+     * Resume one allocated pause through DSH's persisted Session path after proving the retained Session and Git worktree
+     * are still usable. The same run, Session, worktree, and branch are retained; no fallback identity is created. Tracker,
+     * scheduler, routing, Git, and budget gates are revalidated before the resumed Agent receives continuation input.
+     * Definite retained-resource failures persist an explicit recovery requirement; other preflight failures preserve the
+     * pause. The operation owns the resumed root through disposal. Caller cancellation becomes a durable operator pause
+     * before the resumed root is cancelled and drained.
+     */
+    resumeRun(runId: RunId, signal?: AbortSignal): Promise<DispatchResult>;
+    private prepareResume;
+    private executePreparedResume;
+    private pauseOwnedExecution;
+    private assertAccepting;
+    private hasRunningCapacity;
+    private assertExecutionStartReady;
+    private beginStart;
+}
+export default Dispatch;