@codetreker/daynight 0.21.9 → 0.21.11

package/dist/commands/worker/diagnostics.js

@@ -0,0 +1,56 @@
+import { appendFile, mkdir } from "node:fs/promises";
+import path from "node:path";
+export const createWorkerDiagnostics = async (options) => {
+    await mkdir(options.paths.logsDirectory, { recursive: true, mode: 0o700 });
+    const filename = path.join(options.paths.logsDirectory, `worker-${new Date().toISOString().slice(0, 10)}.jsonl`);
+    const redact = (value) => {
+        let result = value;
+        for (const secret of options.secrets === undefined ? [] : options.secrets) {
+            if (secret.length !== 0)
+                for (const representation of new Set([secret, encodeURIComponent(secret)]))
+                    result = result.replaceAll(representation, "[redacted]");
+        }
+        return result.replace(/\b(Bearer\s+)[^\s"']+/gi, "$1[redacted]").replace(/\b(https?:\/\/)[^\s/@]+:[^\s/@]+@/gi, "$1[redacted]@");
+    };
+    const describeError = (value, depth = 0) => {
+        if (value instanceof Error)
+            return {
+                name: value.name, message: redact(value.message),
+                ...(value.cause === undefined || depth >= 6 ? {} : { cause: describeError(value.cause, depth + 1) }),
+                ...(value instanceof AggregateError && depth < 6 ? { errors: value.errors.map((error) => describeError(error, depth + 1)) } : {}),
+            };
+        return redact(String(value));
+    };
+    let pending = Promise.resolve();
+    let failed;
+    const emit = (event) => {
+        const task = event.task;
+        const record = {
+            timestamp: new Date().toISOString(), workerId: options.workerId, platform: options.platform,
+            kind: event.kind, message: redact(event.message),
+            ...(task === undefined ? {} : {
+                serverOrigin: task.serverOrigin, projectId: task.projectId, taskId: task.taskId, claimId: task.claimId,
+                status: task.status, repositoryPath: task.repositoryPath, agent: task.configuration?.agent,
+                recovery: task.recovery, cleanup: task.cleanup,
+            }),
+            ...(event.error === undefined ? {} : { error: describeError(event.error) }),
+        };
+        const serialized = JSON.stringify(record, (_key, value) => typeof value === "string" ? redact(value) : value);
+        if (failed === undefined)
+            pending = pending.then(() => appendFile(filename, `${serialized}\n`, { mode: 0o600 })).catch((cause) => { failed = cause; });
+        try {
+            options.log?.(`${record.timestamp} ${record.kind}${task === undefined ? "" : ` ${task.projectId}/${task.taskId}/${task.claimId} ${task.status}`} ${record.message}${event.error === undefined ? "" : ` ${JSON.stringify(describeError(event.error))}`}\n`);
+        }
+        catch (cause) {
+            if (failed === undefined)
+                failed = cause;
+        }
+    };
+    return {
+        emit,
+        flush: async () => { await pending; if (failed !== undefined)
+            throw failed; },
+        filename,
+    };
+};
+//# sourceMappingURL=diagnostics.js.map

package/dist/commands/worker/diagnostics.js.map

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

package/dist/commands/worker/execution.d.ts

@@ -0,0 +1,41 @@
+import type { Operation } from "../../api/operation.js";
+import type { TaskPlatform, WorkerAgent } from "../../api/types.js";
+import type { HerdrExecutionContext, HerdrOwnedWorkspace, HerdrTaskBinding, WorkerHerdrAdapter } from "./herdr.js";
+import type { WorkerStore } from "./store.js";
+import type { LocalTask } from "./types.js";
+import type { createWorkerGitManager } from "./worktrees.js";
+export type WorkerEvent = {
+    kind: string;
+    message: string;
+    task?: LocalTask;
+    error?: unknown;
+};
+export type WorkerGitManager = ReturnType<typeof createWorkerGitManager>;
+export type ExecutionDependencies = {
+    store: WorkerStore;
+    git: WorkerGitManager;
+    herdr: WorkerHerdrAdapter;
+    platform: TaskPlatform;
+    buildPrompt: (task: LocalTask, platform: TaskPlatform) => string;
+    emit: (event: WorkerEvent) => void;
+    now: () => number;
+};
+export declare const isWorkerCancellation: (error: unknown, signal: AbortSignal) => boolean;
+export declare const workerOperation: <T>(action: (operation: Operation) => Promise<T>, signal?: AbortSignal, totalMs?: number) => Promise<T>;
+export declare const executionContext: (task: LocalTask, agent?: WorkerAgent) => HerdrExecutionContext;
+export declare const taskBinding: (task: LocalTask) => HerdrTaskBinding | null;
+export declare const ownedWorkspace: (task: LocalTask, resources: readonly HerdrOwnedWorkspace[]) => HerdrOwnedWorkspace | undefined;
+export declare const actualTaskPane: (task: LocalTask, resources: readonly HerdrOwnedWorkspace[]) => {
+    binding: HerdrTaskBinding;
+    cwd: string | null;
+    kind: WorkerAgent | null;
+    status: string;
+    launchPending: boolean;
+    interactiveReady: boolean;
+    nativeSession: import("./herdr.js").HerdrNativeReference | null;
+    stateChangeSeq: number | null;
+    completionSeq: number | null;
+} | undefined;
+export declare const createExecutionDriver: (deps: ExecutionDependencies) => {
+    advance: (input: LocalTask, resources: readonly HerdrOwnedWorkspace[], signal?: AbortSignal) => Promise<LocalTask>;
+};

package/dist/commands/worker/execution.js

@@ -0,0 +1,255 @@
+import path from "node:path";
+import { createOperation, OperationError } from "../../api/operation.js";
+import { HerdrAgentActionError } from "./herdr.js";
+import { buildHerdrAgentArguments } from "./herdr/arguments.js";
+export const isWorkerCancellation = (error, signal) => {
+    if (!signal.aborted)
+        return false;
+    if (error instanceof AggregateError && error.errors.some((failure) => !isWorkerCancellation(failure, signal)))
+        return false;
+    return error === signal.reason ||
+        (error instanceof OperationError && error.kind === "cancelled" && error.cause === signal.reason) ||
+        (error instanceof Error && error.cause !== undefined && isWorkerCancellation(error.cause, signal));
+};
+export const workerOperation = async (action, signal, totalMs = 120_000) => {
+    const operation = createOperation({ ...(signal === undefined ? {} : { signal }), limits: { totalMs } });
+    try {
+        return await action(operation);
+    }
+    finally {
+        operation.dispose();
+    }
+};
+export const executionContext = (task, agent) => {
+    const selected = task.configuration?.agent ?? agent;
+    if (selected === undefined)
+        throw new Error("The original native agent kind is unavailable; the execution was retained.");
+    return { serverOrigin: task.serverOrigin, projectId: task.projectId, taskId: task.taskId, claimId: task.claimId, worktreeId: task.worktreeId,
+        cwd: task.resources.worktree?.worktreePath ?? path.join(task.repositoryPath, ".worktrees", "daynight", task.taskId), agent: selected };
+};
+export const taskBinding = (task) => {
+    const binding = task.resources.herdr;
+    const terminalId = task.nativeExecution?.terminalId;
+    return binding === null || terminalId === null || terminalId === undefined ? null : { ...binding, terminalId };
+};
+export const ownedWorkspace = (task, resources) => resources.find(({ owner }) => owner.serverOrigin === task.serverOrigin && owner.projectId === task.projectId && owner.taskId === task.taskId && owner.claimId === task.claimId && owner.worktreeId === task.worktreeId);
+export const actualTaskPane = (task, resources) => {
+    const workspace = ownedWorkspace(task, resources);
+    if (workspace === undefined)
+        return undefined;
+    const binding = task.resources.herdr;
+    if (binding !== null && workspace.workspaceId === binding.workspaceId)
+        return workspace.panes.find((pane) => pane.binding.paneId === binding.paneId);
+    if (workspace.panes.length !== 1)
+        throw new Error("The original task workspace has ambiguous panes; it was retained.");
+    return workspace.panes[0];
+};
+const sameBinding = (left, right) => left.session === right.session && left.workspaceId === right.workspaceId && left.paneId === right.paneId && left.terminalId === right.terminalId;
+const live = (observation) => observation.kind !== null || observation.launchPending || observation.interactiveReady;
+export const createExecutionDriver = (deps) => {
+    const refresh = (task) => {
+        const current = deps.store.getTask(task);
+        if (current === null)
+            throw new Error("The local execution record disappeared.");
+        return current;
+    };
+    const rememberStop = async (task, binding, signal) => {
+        if (task.nativeExecution?.stopObservation !== null && task.nativeExecution?.stopObservation !== undefined)
+            return;
+        try {
+            const observation = await workerOperation((operation) => deps.herdr.tasks.captureStop(executionContext(task), binding, operation), signal);
+            deps.store.recordStopObservation(task, observation, deps.now());
+        }
+        catch (error) {
+            deps.emit({ kind: "stop-observation-unavailable", task, message: "Original native process identities are not yet available; cold recovery remains fenced.", error });
+        }
+    };
+    const rememberNative = (task, nativeSession) => nativeSession === null ? refresh(task) : deps.store.bindNativeSession(task, { source: "herdr", sessionId: nativeSession.sessionId }, deps.now());
+    const prepareWorkspace = async (task, signal) => {
+        deps.store.markWorkspaceSubmitting(task, deps.now());
+        try {
+            return await workerOperation((operation) => deps.herdr.tasks.prepareWorkspace(executionContext(task), operation), signal);
+        }
+        catch (error) {
+            if (error instanceof HerdrAgentActionError && error.action === "workspace.create" && error.submission !== "unknown")
+                deps.store.recordWorkspaceNotSubmitted(task, error.submission === "rejected" ? { definiteRejection: true } : { notSubmitted: true }, deps.now());
+            throw error;
+        }
+    };
+    const rebind = async (task, actual, signal) => {
+        const original = taskBinding(task);
+        if (original === null)
+            throw new Error("The original Herdr terminal identity is unavailable; recovery was paused.");
+        const context = executionContext(task);
+        if (task.nativeExecution?.workspaceSubmission === "unknown" && actual === null)
+            throw new HerdrAgentActionError("The original replacement workspace request has an unknown outcome; absence does not authorize another creation.", "workspace.create", "unknown");
+        const evidence = task.nativeExecution?.stopObservation;
+        if (task.nativeExecution?.launchSubmission === "never-submitted") {
+            if (actual !== null)
+                await workerOperation((operation) => deps.herdr.tasks.confirmEmptyPane(context, actual, operation), signal);
+        }
+        else {
+            if (evidence === null || evidence === undefined)
+                throw new Error("The original persisted native stop observation is missing; recovery cannot infer that the agent stopped.");
+            if (actual === null)
+                await workerOperation((operation) => deps.herdr.tasks.confirmMissingWorkspaceStopped(context, original, evidence, operation), signal);
+            else if (sameBinding(original, actual))
+                await workerOperation((operation) => deps.herdr.tasks.confirmStopped(context, original, evidence, operation), signal);
+            else if (original.workspaceId !== actual.workspaceId || original.paneId !== actual.paneId)
+                await workerOperation((operation) => deps.herdr.tasks.confirmReplacedStop(context, original, actual, evidence, operation), signal);
+            else
+                await workerOperation((operation) => deps.herdr.tasks.confirmRestoredStop(context, original, actual, evidence, operation), signal);
+        }
+        if (task.nativeExecution?.workspaceSubmission === "unknown") {
+            // The exact observed replacement establishes the previous create outcome. Its
+            // environment receipt is unavailable, so a subsequent empty-pane rebind replaces it.
+            return deps.store.rebindHerdrExecution(task, original, actual, null, { originalAgentStopped: true, oldWorkspaceClosed: true }, deps.now());
+        }
+        await workerOperation((operation) => deps.herdr.tasks.closeWorkspace(context, actual === null ? original : actual, { agentStopped: true }, operation), signal);
+        const prepared = await prepareWorkspace(task, signal);
+        return deps.store.rebindHerdrExecution(task, original, prepared.binding, prepared.workspaceEvidence, { originalAgentStopped: true, oldWorkspaceClosed: true }, deps.now());
+    };
+    return {
+        advance: async (input, resources, signal) => {
+            let task = refresh(input);
+            if (task.cleanup !== null || task.control !== null)
+                throw new Error("Cleanup or source management prevents ordinary execution.");
+            if (task.configuration === null)
+                throw new Error("The original frozen execution configuration is missing; restore it before retrying.");
+            if (task.recovery.pauseReason !== null && !task.recovery.retryAuthorized && (task.resources.worktree === null || task.resources.herdr === null))
+                return task;
+            if (task.status !== "active")
+                throw new Error("Only an active execution may prepare resources.");
+            const original = actualTaskPane(task, resources);
+            if (task.resources.nativeSession === null && task.nativeExecution?.launchSubmission !== "never-submitted") {
+                if (original === undefined || (!live(original) && original.nativeSession === null))
+                    throw new Error("The original native session ID is missing; recover its exact history identity before preparing replacement resources.");
+                if (original.nativeSession !== null && task.resources.herdr !== null)
+                    task = rememberNative(task, original.nativeSession);
+            }
+            if (task.resources.worktree === null) {
+                const binding = task.nativeExecution?.launchSubmission === "never-submitted"
+                    ? await workerOperation((operation) => deps.git.prepareWorktree(task, operation), signal, 180_000)
+                    : await workerOperation((operation) => deps.git.findWorktree(task, operation), signal);
+                if (binding === null)
+                    throw new Error("The original native launch provenance and owned worktree are unavailable; a fresh worktree cannot substitute for recovery.");
+                task = deps.store.bindWorktree(task, binding, deps.now());
+            }
+            else
+                await workerOperation((operation) => deps.git.verifyWorktree(task, operation), signal);
+            const actual = actualTaskPane(task, resources);
+            if (actual?.nativeSession !== undefined && actual.nativeSession !== null && task.resources.nativeSession !== null && actual.nativeSession.sessionId !== task.resources.nativeSession.sessionId)
+                throw new Error("The actual native history differs from the original execution; its resources were retained.");
+            let binding = taskBinding(task);
+            if (binding === null) {
+                if (task.resources.herdr !== null)
+                    throw new Error("The original Herdr terminal identity is missing; an existing binding cannot be guessed.");
+                if (actual !== undefined) {
+                    task = deps.store.bindHerdrExecution(task, actual.binding, null, deps.now());
+                    binding = actual.binding;
+                }
+                else {
+                    if (task.nativeExecution?.workspaceSubmission === "unknown")
+                        throw new HerdrAgentActionError("The original workspace creation has an unknown outcome; the absent snapshot does not authorize replay.", "workspace.create", "unknown");
+                    const prepared = await prepareWorkspace(task, signal);
+                    task = deps.store.bindHerdrExecution(task, prepared.binding, prepared.workspaceEvidence, deps.now());
+                    binding = prepared.binding;
+                }
+            }
+            else if ((actual !== undefined && !sameBinding(binding, actual.binding)) || ownedWorkspace(task, resources) === undefined) {
+                if (task.recovery.pauseReason !== null && !task.recovery.retryAuthorized)
+                    return task;
+                if (task.nativeExecution?.workspaceSubmission === "unknown" && actual === undefined)
+                    throw new HerdrAgentActionError("The original replacement workspace request is unresolved; the absent snapshot cannot authorize replay.", "workspace.create", "unknown");
+                if (task.nativeExecution?.launchSubmission !== "never-submitted" && task.nativeExecution?.workspaceSubmission !== "unknown") {
+                    if (task.resources.nativeSession === null)
+                        throw new Error("The original native history identity is unavailable; missing Herdr resources do not authorize a new conversation.");
+                    task = deps.store.beginRecovery(task, deps.now());
+                }
+                task = await rebind(task, actual?.binding ?? null, signal);
+                binding = taskBinding(task);
+            }
+            const context = executionContext(task);
+            const before = await workerOperation((operation) => deps.herdr.tasks.observe(context, binding, operation), signal);
+            task = rememberNative(task, before.nativeSession);
+            if (live(before)) {
+                await rememberStop(task, binding, signal);
+                task = refresh(task);
+                const native = task.nativeExecution;
+                if (native?.launchSubmission === "acknowledged" && native.promptSubmission === "not-submitted" && native.launchEvidence !== null && before.status !== "blocked" && (task.recovery.pauseReason === null || task.recovery.retryAuthorized)) {
+                    if (task.recovery.retryAuthorized)
+                        task = deps.store.beginRecovery(task, deps.now());
+                    const originalNativeId = task.resources.nativeSession?.sessionId;
+                    const resumedArgv = originalNativeId === undefined ? null : [context.agent, ...buildHerdrAgentArguments(task.configuration, originalNativeId)];
+                    const resumeSessionId = resumedArgv !== null && native.launchEvidence.argv.length === resumedArgv.length && native.launchEvidence.argv.every((argument, index) => argument === resumedArgv[index]) ? originalNativeId : undefined;
+                    const prompt = deps.buildPrompt(task, deps.platform);
+                    deps.store.markNativePromptSubmitting(task, deps.now());
+                    try {
+                        const outcome = await workerOperation((operation) => deps.herdr.tasks.start(context, binding, { configuration: task.configuration, prompt, initialPromptNotSubmitted: true, launchEvidence: native.launchEvidence, workspaceEvidence: native.workspaceEvidence,
+                            ...(resumeSessionId === undefined ? {} : { resumeSessionId }) }, operation), signal);
+                        if (outcome.kind === "rebind-required")
+                            throw new Error(`The original deferred startup input is fenced: ${outcome.reason}.`);
+                        deps.store.recordNativeStartOutcome(task, { ...(outcome.launchEvidence === null ? {} : { launchEvidence: outcome.launchEvidence }), promptSubmission: outcome.promptSubmission }, deps.now());
+                        task = rememberNative(task, outcome.observation.nativeSession);
+                    }
+                    catch (error) {
+                        if (error instanceof HerdrAgentActionError)
+                            deps.store.recordNativeStartOutcome(task, { ...(error.launchEvidence === null ? {} : { launchEvidence: error.launchEvidence }), promptSubmission: error.promptSubmission === null ? "unknown" : error.promptSubmission }, deps.now());
+                        throw error;
+                    }
+                }
+                deps.emit({ kind: before.status === "blocked" ? "waiting" : "reconnected", task: refresh(task), message: before.status === "blocked" ? "The original agent is waiting for input; attach to its private Herdr session." : "Observed the original live agent without replaying its startup input." });
+                return refresh(task);
+            }
+            if (task.recovery.pauseReason !== null && !task.recovery.retryAuthorized)
+                return task;
+            const native = task.nativeExecution;
+            if (native === null)
+                throw new Error("The original native launch provenance is missing; a new launch would be unsafe.");
+            if (native.launchSubmission !== "never-submitted") {
+                if (task.resources.nativeSession === null)
+                    throw new Error("The original launch may have been submitted but its native history identity is unavailable; no second agent was started.");
+                deps.store.beginRecovery(task, deps.now());
+                task = refresh(task);
+                task = await rebind(task, binding, signal);
+                binding = taskBinding(task);
+            }
+            else if (native.workspaceEvidence === null) {
+                task = await rebind(task, binding, signal);
+                binding = taskBinding(task);
+            }
+            if (task.nativeExecution.workspaceEvidence === null) {
+                task = await rebind(task, binding, signal);
+                binding = taskBinding(task);
+            }
+            if (task.recovery.retryAuthorized)
+                task = deps.store.beginRecovery(task, deps.now());
+            const prompt = deps.buildPrompt(task, deps.platform);
+            deps.store.markNativeLaunchSubmitting(task, deps.now());
+            try {
+                const outcome = await workerOperation((operation) => deps.herdr.tasks.start(executionContext(task), binding, { configuration: task.configuration, prompt,
+                    workspaceEvidence: task.nativeExecution.workspaceEvidence, ...(task.resources.nativeSession === null ? {} : { resumeSessionId: task.resources.nativeSession.sessionId }) }, operation), signal);
+                if (outcome.kind === "rebind-required")
+                    throw new Error(`The native launch was fenced: ${outcome.reason}.`);
+                if (outcome.kind === "reconnected")
+                    throw new Error("An unexpected live agent was observed during a fresh launch; its input was retained.");
+                deps.store.recordNativeStartOutcome(task, { ...(outcome.launchEvidence === null ? {} : { launchEvidence: outcome.launchEvidence }), promptSubmission: outcome.promptSubmission }, deps.now());
+                task = rememberNative(task, outcome.observation.nativeSession);
+                await rememberStop(task, binding, signal);
+                deps.emit({ kind: outcome.kind === "waiting" ? "waiting" : "started", task: refresh(task), message: task.resources.nativeSession === null ? "Native launch acknowledged; waiting for the original agent." : "Managed startup input submitted to the original native conversation." });
+                return refresh(task);
+            }
+            catch (error) {
+                if (error instanceof HerdrAgentActionError) {
+                    if (error.action === "agent.start" && error.submission !== "unknown" && error.launchEvidence === null && task.nativeExecution?.launchSubmission === "never-submitted") {
+                        deps.store.recordNativeLaunchNotSubmitted(task, error.submission === "rejected" ? { definiteRejection: true } : { notSubmitted: true }, deps.now());
+                    }
+                    else
+                        deps.store.recordNativeStartOutcome(task, { ...(error.launchEvidence === null ? {} : { launchEvidence: error.launchEvidence }), promptSubmission: error.promptSubmission === null ? "unknown" : error.promptSubmission }, deps.now());
+                }
+                throw error;
+            }
+        },
+    };
+};
+//# sourceMappingURL=execution.js.map

package/dist/commands/worker/execution.js.map

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

package/dist/commands/worker/herdr/agents.d.ts

@@ -0,0 +1,185 @@
+import type { Operation } from "../../../api/operation.js";
+import type { WorkerAgent } from "../../../api/types.js";
+import type { HerdrAgentConfiguration } from "./arguments.js";
+import type { HerdrRpcClient } from "./rpc.js";
+export type { HerdrAgentConfiguration } from "./arguments.js";
+export { buildHerdrAgentArguments, validateHerdrAgentArguments } from "./arguments.js";
+export type HerdrExecutionContext = {
+    serverOrigin: string;
+    projectId: string;
+    taskId: string;
+    claimId: string;
+    worktreeId: string;
+    cwd: string;
+    agent: WorkerAgent;
+};
+export type HerdrExecutionOwner = Pick<HerdrExecutionContext, "serverOrigin" | "projectId" | "taskId" | "claimId" | "worktreeId">;
+export type HerdrTaskBinding = {
+    session: string;
+    workspaceId: string;
+    paneId: string;
+    terminalId: string;
+};
+export type HerdrWorkspaceEvidence = {
+    binding: HerdrTaskBinding;
+    ownerLabel: string;
+    environment: HerdrWorkspaceEnvironment;
+};
+export type HerdrPreparedWorkspace = {
+    binding: HerdrTaskBinding;
+    workspaceEvidence: HerdrWorkspaceEvidence | null;
+};
+export type HerdrLaunchEvidence = {
+    binding: HerdrTaskBinding;
+    ownerLabel: string;
+    agent: WorkerAgent;
+    argv: readonly string[];
+    referenceBaseline: "empty";
+    workspaceEvidence: HerdrWorkspaceEvidence;
+};
+export type HerdrNativeReference = {
+    source: string;
+    agent: WorkerAgent;
+    sessionId: string;
+};
+export type HerdrAgentObservation = {
+    binding: HerdrTaskBinding;
+    kind: string | null;
+    name: string | null;
+    status: string;
+    launchPending: boolean;
+    interactiveReady: boolean;
+    nativeSession: HerdrNativeReference | null;
+    stateChangeSeq: number | null;
+    completionSeq: number | null;
+};
+export type HerdrStopObservation = {
+    binding: HerdrTaskBinding;
+    ownerLabel: string;
+    agent: WorkerAgent;
+    nativeSessionId: string | null;
+    shellPid: number;
+    processIds: readonly number[];
+    observedAt: number;
+};
+export type HerdrOwnedWorkspace = {
+    owner: HerdrExecutionOwner;
+    workspaceId: string;
+    panes: {
+        binding: HerdrTaskBinding;
+        cwd: string | null;
+        kind: WorkerAgent | null;
+        status: string;
+        launchPending: boolean;
+        interactiveReady: boolean;
+        nativeSession: HerdrNativeReference | null;
+        stateChangeSeq: number | null;
+        completionSeq: number | null;
+    }[];
+};
+export type HerdrAgentPreflight = {
+    verifyStart(input: {
+        context: HerdrExecutionContext;
+        configuration: HerdrAgentConfiguration;
+        resumeSessionId?: string;
+    }, operation: Operation): Promise<unknown>;
+};
+export type HerdrWorkspaceEnvironment = Readonly<{
+    XDG_CONFIG_HOME: string;
+    XDG_STATE_HOME: string;
+}>;
+export declare const herdrExecutionLabel: (context: HerdrExecutionContext) => string;
+export declare const herdrExecutionAgentName: (context: HerdrExecutionContext) => string;
+export declare const parseHerdrExecutionLabel: (label: string) => HerdrExecutionOwner | null;
+export declare class HerdrAgentActionError extends Error {
+    readonly action: string;
+    readonly submission: "not-submitted" | "rejected" | "unknown";
+    readonly promptSubmission: "not-submitted" | "submitted" | "unknown" | null;
+    readonly launchEvidence: HerdrLaunchEvidence | null;
+    constructor(message: string, action: string, submission: "not-submitted" | "rejected" | "unknown", options?: ErrorOptions & {
+        promptSubmission?: "not-submitted" | "submitted" | "unknown";
+        launchEvidence?: HerdrLaunchEvidence;
+    });
+}
+export declare const createHerdrAgentManager: (options: {
+    rpc: HerdrRpcClient;
+    session: string;
+    preflight: HerdrAgentPreflight;
+    workspaceEnvironment: HerdrWorkspaceEnvironment;
+    processExecuting?: (pid: number) => Promise<boolean>;
+    pollIntervalMs?: number;
+}) => {
+    listResources: (operation: Operation) => Promise<HerdrOwnedWorkspace[]>;
+    prepareWorkspace: (context: HerdrExecutionContext, operation: Operation) => Promise<HerdrPreparedWorkspace>;
+    observe: (context: HerdrExecutionContext, binding: HerdrTaskBinding, operation: Operation) => Promise<HerdrAgentObservation>;
+    start: (context: HerdrExecutionContext, binding: HerdrTaskBinding, input: {
+        configuration: HerdrAgentConfiguration;
+        prompt: string;
+        resumeSessionId?: string;
+        initialPromptNotSubmitted?: true;
+        launchEvidence?: HerdrLaunchEvidence;
+        workspaceEvidence?: HerdrWorkspaceEvidence | null;
+    }, operation: Operation) => Promise<{
+        kind: "rebind-required";
+        reason: "retained-native-reference" | "unverified-launch" | "unverified-workspace-environment";
+        observation: HerdrAgentObservation;
+        promptSubmission: "not-submitted";
+        launchEvidence: null;
+    } | {
+        kind: "reconnected";
+        observation: HerdrAgentObservation;
+        promptSubmission: "not-submitted";
+        launchEvidence: null;
+    } | {
+        kind: "waiting";
+        observation: HerdrAgentObservation;
+        promptSubmission: "not-submitted";
+        launchEvidence: HerdrLaunchEvidence | null;
+    } | {
+        kind: "started";
+        observation: HerdrAgentObservation;
+        promptSubmission: "submitted";
+        launchEvidence: HerdrLaunchEvidence | null;
+    } | {
+        kind: "waiting";
+        observation: HerdrAgentObservation;
+        promptSubmission: "submitted";
+        launchEvidence: HerdrLaunchEvidence | null;
+    }>;
+    submitPrompt: (context: HerdrExecutionContext, binding: HerdrTaskBinding, prompt: string, operation: Operation) => Promise<{
+        submission: "submitted";
+        observation: HerdrAgentObservation;
+    }>;
+    captureStop: (context: HerdrExecutionContext, binding: HerdrTaskBinding, operation: Operation) => Promise<HerdrStopObservation>;
+    requestGracefulStop: (context: HerdrExecutionContext, binding: HerdrTaskBinding, operation: Operation) => Promise<{
+        submission: "submitted";
+        observation: HerdrAgentObservation;
+    }>;
+    confirmEmptyPane: (context: HerdrExecutionContext, binding: HerdrTaskBinding, operation: Operation) => Promise<{
+        noNativeProcess: true;
+    }>;
+    confirmStopped: (context: HerdrExecutionContext, binding: HerdrTaskBinding, evidence: HerdrStopObservation, operation: Operation) => Promise<{
+        agentStopped: true;
+    }>;
+    confirmMissingWorkspaceStopped: (context: HerdrExecutionContext, originalBinding: HerdrTaskBinding, evidence: HerdrStopObservation, operation: Operation) => Promise<{
+        agentStopped: true;
+    }>;
+    confirmRestoredStop: (context: HerdrExecutionContext, originalBinding: HerdrTaskBinding, restoredBinding: HerdrTaskBinding, evidence: HerdrStopObservation, operation: Operation) => Promise<{
+        agentStopped: true;
+        binding: HerdrTaskBinding;
+    }>;
+    confirmReplacedStop: (context: HerdrExecutionContext, originalBinding: HerdrTaskBinding, replacementBinding: HerdrTaskBinding, evidence: HerdrStopObservation, operation: Operation) => Promise<{
+        agentStopped: true;
+        binding: HerdrTaskBinding;
+    }>;
+    forceStop: (context: HerdrExecutionContext, binding: HerdrTaskBinding, evidence: HerdrStopObservation, operation: Operation) => Promise<{
+        agentStopped: true;
+        originalPaneClosed: true;
+    }>;
+    closeWorkspace: (context: HerdrExecutionContext, binding: HerdrTaskBinding, proof: {
+        agentStopped: true;
+    }, operation: Operation) => Promise<{
+        workspaceClosed: true;
+    }>;
+};
+export type HerdrAgentManager = ReturnType<typeof createHerdrAgentManager>;