@aiden-ade/sandbox-agent 0.1.59 → 0.1.60

package/dist/updater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updater.js","sourceRoot":"","sources":["../src/updater.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,YAAY,GAAG,+GAA+G,CAAC;AAOrI;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAsB;IACxD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC;IAC5C,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,iDAAiD,OAAO,UAAU,CAAC,CAAC;QACjF,QAAQ,CAAC,2CAA2C,OAAO,EAAE,EAAE;YAC7D,OAAO,EAAE,MAAM;YACf,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE;YAC3C,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;QACzE,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,qBAA8B;IACzD,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/B,IAAI,qBAAqB,EAAE,CAAC;QAC1B,GAAG,CAAC,yBAAyB,GAAG,qBAAqB,CAAC;IACxD,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,EAAE,EAAE,EAAE;QACrC,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,QAAQ;QACf,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE;KACpC,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,wDAAwD;IACxD,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,EAAE,GAAG,CAAC,CAAC;AACV,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const AGENT_VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,QAA4C,CAAC"}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const AGENT_VERSION = process.env.__AGENT_VERSION__ ?? "0.1.54";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,QAAQ,CAAC"}

package/dist/web-presenter.d.ts

@@ -0,0 +1,55 @@
+import type { AgentActivityEvidence, AgentConfig, AgentPresenter, AgentResult, ExitPlanModeInput, GeneratedImagePayload, SessionMediaPayload, UsageUpdate } from "./types.js";
+import type { WSClient } from "./ws-client.js";
+export declare class WebPresenter implements AgentPresenter {
+    private readonly conversationId;
+    private readonly cwd?;
+    pendingAskUserToolIds?: Set<string>;
+    private wsClient;
+    private readonly emittedGeneratedImageKeys;
+    private readonly emittedSessionMediaKeys;
+    private readonly toolNamesById;
+    private readonly toolInputsById;
+    private readonly browserRecordingPathHints;
+    private suppressSessionLifecycle;
+    private runId;
+    private backendKind;
+    private applicationProblem;
+    private terminalEmitted;
+    constructor(wsClient: WSClient, conversationId: string, cwd?: string | undefined);
+    setSuppressSessionLifecycle(suppress: boolean): void;
+    setRunContext(runId: string | undefined, backendKind?: string): void;
+    onStart(config: AgentConfig): void;
+    onLog(message: string): void;
+    onNotice(kind: string, message: string): void;
+    onAssistantText(text: string, parentToolUseId?: string | null): void;
+    onThinking(text: string, parentToolUseId?: string | null): void;
+    hasKnownToolUse(toolId: string): boolean;
+    onToolUse(tool: string, input: unknown, toolId: string, parentToolUseId?: string | null): void;
+    onToolResult(toolId: string, content: string, isError?: boolean, parentToolUseId?: string | null): void;
+    onGeneratedImage(image: GeneratedImagePayload): void;
+    private emitGeneratedImage;
+    onSessionMedia(media: SessionMediaPayload): void;
+    private emitSessionMedia;
+    onTurnComplete(content: unknown[]): void;
+    onUsageUpdate(usage: UsageUpdate): void;
+    onAskUser(id: string, questions: unknown[]): void;
+    onTodoWrite(todos: unknown[]): void;
+    onExitPlanMode(id: string, input: ExitPlanModeInput, planFilePath?: string): void;
+    onCheckpoint(id: string): void;
+    onActivity(status: string, evidence?: AgentActivityEvidence): void;
+    onOpenBrowserTab(browserId: string, url?: string): void;
+    recordRawTranscript(): void;
+    onError(message: string, isAgentError?: boolean): void;
+    onApplicationError(input: {
+        code: ApplicationProblemCode;
+        message: string;
+    }): void;
+    onComplete(result: AgentResult): void;
+    /**
+     * Manually emit session lifecycle events and close.
+     * Called after the multi-turn loop exits.
+     */
+    emitSessionEnd(result: AgentResult): Promise<void>;
+}
+import { type ApplicationProblemCode } from "@alan-ai/shared/agent";
+//# sourceMappingURL=web-presenter.d.ts.map

package/dist/web-presenter.d.ts.map

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

package/dist/web-presenter.js

@@ -0,0 +1,265 @@
+import { extractBrowserMediaPathHints, extractGeneratedImagesFromToolResult, extractSessionMediaFromToolResult, } from "./generated-images.js";
+export class WebPresenter {
+    conversationId;
+    cwd;
+    pendingAskUserToolIds;
+    wsClient;
+    emittedGeneratedImageKeys = new Set();
+    emittedSessionMediaKeys = new Set();
+    toolNamesById = new Map();
+    toolInputsById = new Map();
+    browserRecordingPathHints = new Set();
+    suppressSessionLifecycle = false;
+    runId;
+    backendKind = "unknown_cli";
+    applicationProblem;
+    terminalEmitted = false;
+    constructor(wsClient, conversationId, cwd) {
+        this.conversationId = conversationId;
+        this.cwd = cwd;
+        this.wsClient = wsClient;
+    }
+    setSuppressSessionLifecycle(suppress) {
+        this.suppressSessionLifecycle = suppress;
+    }
+    setRunContext(runId, backendKind) {
+        this.runId = runId;
+        this.backendKind = backendKind ?? "unknown_cli";
+        this.applicationProblem = undefined;
+        this.terminalEmitted = false;
+    }
+    onStart(config) {
+        this.wsClient.emitEvent({ type: "start", task: config.task, ts: Date.now() });
+    }
+    onLog(message) {
+        console.error(message);
+    }
+    onNotice(kind, message) {
+        // Non-fatal: never emits session lifecycle events or closes the client.
+        this.wsClient.emitEvent({ type: "session_notice", kind, message, ts: Date.now() });
+    }
+    onAssistantText(text, parentToolUseId) {
+        this.wsClient.emitEvent({
+            type: "text",
+            text,
+            ts: Date.now(),
+            ...(parentToolUseId ? { parentToolUseId } : {}),
+        });
+    }
+    onThinking(text, parentToolUseId) {
+        this.wsClient.emitEvent({
+            type: "thinking",
+            text,
+            ts: Date.now(),
+            ...(parentToolUseId ? { parentToolUseId } : {}),
+        });
+    }
+    hasKnownToolUse(toolId) {
+        return this.toolNamesById.has(toolId);
+    }
+    onToolUse(tool, input, toolId, parentToolUseId) {
+        this.toolNamesById.set(toolId, tool);
+        this.toolInputsById.set(toolId, input);
+        for (const path of extractBrowserMediaPathHints(undefined, this.cwd, tool, {
+            toolInput: input,
+        })) {
+            this.browserRecordingPathHints.add(path);
+        }
+        this.wsClient.emitEvent({
+            type: "tool_use",
+            id: toolId,
+            name: tool,
+            input,
+            ts: Date.now(),
+            ...(parentToolUseId ? { parentToolUseId } : {}),
+        });
+    }
+    onToolResult(toolId, content, isError, parentToolUseId) {
+        this.wsClient.emitEvent({
+            type: "tool_result",
+            id: toolId,
+            content,
+            ts: Date.now(),
+            ...(isError ? { is_error: true } : {}),
+            ...(parentToolUseId ? { parentToolUseId } : {}),
+        });
+        if (isError)
+            return;
+        const toolName = this.toolNamesById.get(toolId);
+        const toolInput = this.toolInputsById.get(toolId);
+        const options = { toolInput, pathHints: [...this.browserRecordingPathHints] };
+        for (const image of extractGeneratedImagesFromToolResult(toolId, content, this.cwd, toolName, options)) {
+            this.emitGeneratedImage(image);
+        }
+        for (const media of extractSessionMediaFromToolResult(toolId, content, this.cwd, toolName, options)) {
+            this.emitSessionMedia(media);
+            if (media.sourcePath)
+                this.browserRecordingPathHints.delete(media.sourcePath);
+        }
+    }
+    onGeneratedImage(image) {
+        this.emitGeneratedImage(image);
+    }
+    emitGeneratedImage(image) {
+        const key = image.sourceHash ?? `${image.sourcePath ?? image.id}:${image.size}`;
+        if (this.emittedGeneratedImageKeys.has(key))
+            return;
+        this.emittedGeneratedImageKeys.add(key);
+        this.wsClient.emitEvent(image);
+    }
+    onSessionMedia(media) {
+        this.emitSessionMedia(media);
+    }
+    emitSessionMedia(media) {
+        const key = media.sourceHash ?? `${media.sourcePath ?? media.id}:${media.size}`;
+        if (this.emittedSessionMediaKeys.has(key))
+            return;
+        this.emittedSessionMediaKeys.add(key);
+        this.wsClient.emitEvent(media);
+    }
+    onTurnComplete(content) {
+        this.wsClient.emitEvent({ type: "turn_complete", content, ts: Date.now() });
+    }
+    onUsageUpdate(usage) {
+        this.wsClient.emitEvent({ type: "usage", usage });
+    }
+    onAskUser(id, questions) {
+        this.wsClient.emitEvent({ type: "ask_user", id, questions });
+    }
+    onTodoWrite(todos) {
+        this.wsClient.emitEvent({ type: "todo_write", todos });
+    }
+    onExitPlanMode(id, input, planFilePath) {
+        this.wsClient.emitEvent({
+            type: "exit_plan_mode",
+            id,
+            input,
+            ...(planFilePath ? { planFilePath } : {}),
+        });
+    }
+    onCheckpoint(id) {
+        this.wsClient.emitEvent({ type: "checkpoint", id });
+    }
+    onActivity(status, evidence) {
+        this.wsClient.emitEvent({
+            type: "activity",
+            status,
+            ts: Date.now(),
+            ...(evidence ? { evidence } : {}),
+        });
+    }
+    onOpenBrowserTab(browserId, url) {
+        this.wsClient.emitEvent({ type: "open_browser_tab", browserId, ...(url ? { url } : {}) });
+    }
+    recordRawTranscript() {
+        // No-op for sandbox — raw transcripts stay in the container
+    }
+    onError(message, isAgentError = true) {
+        if (isAgentError) {
+            const problem = createCliProblem(classifyCliErrorDetailed(message, 1), {
+                harness: this.backendKind,
+                phase: "stream",
+                finality: "observation",
+                outcomeCertainty: "effect_unknown",
+                scope: {
+                    conversationId: this.conversationId,
+                    ...(this.runId ? { runId: this.runId } : {}),
+                },
+            });
+            this.wsClient.emitEvent({ type: "agent_problem_observed", problem });
+        }
+        else {
+            this.onApplicationError({
+                code: /required tools|prepare the required tools/i.test(message)
+                    ? "app.service.unavailable"
+                    : "app.internal",
+                message,
+            });
+            return;
+        }
+        this.wsClient.emitEvent({ type: "error", message, isAgentError });
+    }
+    onApplicationError(input) {
+        this.applicationProblem = createAlanProblem({
+            domain: "application",
+            code: input.code,
+            id: randomUUID(),
+            title: APPLICATION_PROBLEM_TITLES[input.code],
+            detail: input.message,
+            occurredAt: new Date().toISOString(),
+            severity: "terminal",
+            scope: {
+                conversationId: this.conversationId,
+                ...(this.runId ? { runId: this.runId } : {}),
+            },
+            recovery: APPLICATION_PROBLEM_RECOVERY[input.code],
+            origin: { component: "agent-manager-web-presenter", phase: "dispatch" },
+            transport: { kind: "internal" },
+        });
+        this.wsClient.emitEvent({ type: "application_problem", problem: this.applicationProblem });
+        this.wsClient.emitEvent({ type: "error", message: input.message, isAgentError: false });
+    }
+    onComplete(result) {
+        if (this.terminalEmitted)
+            return;
+        this.terminalEmitted = true;
+        const completedResult = !result.success && !result.problem && !this.applicationProblem
+            ? {
+                ...result,
+                problem: createCliProblem(classifyCliErrorDetailed(result.error || result.summary || "Unknown error", 1), {
+                    harness: this.backendKind,
+                    phase: "shutdown",
+                    finality: "terminal",
+                    outcomeCertainty: "effect_unknown",
+                    scope: {
+                        conversationId: this.conversationId,
+                        ...(this.runId ? { runId: this.runId } : {}),
+                    },
+                }),
+            }
+            : result;
+        this.wsClient.emitEvent({
+            type: "agent_run_finished",
+            result: completedResult,
+            ...(completedResult.problem
+                ? { failureDomain: "agent_cli", causeProblemId: completedResult.problem.id }
+                : this.applicationProblem
+                    ? {
+                        failureDomain: "application",
+                        causeProblemId: this.applicationProblem.id,
+                    }
+                    : {}),
+        });
+        // Legacy completion projection. It follows the canonical event and carries
+        // the same CLI problem when one exists, so it cannot overwrite the typed
+        // cause with an uncorrelated session_error.
+        this.wsClient.emitEvent({ type: "query_complete", result: completedResult, ts: Date.now() });
+        // In multi-turn mode (suppressSessionLifecycle=true), skip session lifecycle
+        if (this.suppressSessionLifecycle) {
+            return;
+        }
+        // Single-turn mode: also send session lifecycle event and close
+        if (result.success) {
+            this.wsClient.emitEvent({ type: "session_complete", result: completedResult });
+        }
+        this.wsClient.close();
+    }
+    /**
+     * Manually emit session lifecycle events and close.
+     * Called after the multi-turn loop exits.
+     */
+    async emitSessionEnd(result) {
+        this.onComplete(result);
+        if (this.suppressSessionLifecycle) {
+            if (result.success)
+                this.wsClient.emitEvent({ type: "session_complete", result });
+            this.wsClient.close();
+        }
+    }
+}
+import { randomUUID } from "node:crypto";
+import { classifyCliErrorDetailed, createCliProblem } from "@alan-ai/agent-core";
+// Titles and recovery policy come from the shared tables so an application
+// problem means the same thing whether the API or the agent runtime raised it.
+import { APPLICATION_PROBLEM_RECOVERY, APPLICATION_PROBLEM_TITLES, createAlanProblem, } from "@alan-ai/shared/agent";
+//# sourceMappingURL=web-presenter.js.map

package/dist/web-presenter.js.map

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

package/dist/workspace-relocation.d.ts

@@ -0,0 +1,22 @@
+export interface WorkspaceRelocationProbe {
+    childDirectories(parentPath: string, limit: number): string[];
+    gitRemoteUrl(candidatePath: string): string | null;
+}
+export declare function normalizeRepositoryIdentity(value: string): string | null;
+export declare function workspaceMatchesExpectedRepositories(input: {
+    workspacePath: string;
+    expectedRepoUrls: string[];
+    probe?: WorkspaceRelocationProbe;
+}): boolean;
+/**
+ * Search direct children of the missing workspace's parent plus parents of
+ * other user-approved Project paths. Return a result only when exactly one Git
+ * remote matches an expected repository identity across the bounded search.
+ */
+export declare function discoverRelocatedWorkspace(input: {
+    missingPath: string;
+    expectedRepoUrls: string[];
+    approvedWorkspacePaths?: string[];
+    probe?: WorkspaceRelocationProbe;
+}): string | null;
+//# sourceMappingURL=workspace-relocation.d.ts.map

package/dist/workspace-relocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-relocation.d.ts","sourceRoot":"","sources":["../src/workspace-relocation.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9D,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACpD;AAoBD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBxE;AAED,wBAAgB,oCAAoC,CAAC,KAAK,EAAE;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,wBAAwB,CAAC;CAClC,GAAG,OAAO,CAUV;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,wBAAwB,CAAC;CAClC,GAAG,MAAM,GAAG,IAAI,CA+BhB"}

package/dist/workspace-relocation.js

@@ -0,0 +1,90 @@
+import { spawnSync } from "node:child_process";
+import { readdirSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { getDaemonCliEnvironment } from "./cli-executable.js";
+const MAX_RELOCATION_CANDIDATES = 200;
+const DEFAULT_PROBE = {
+    childDirectories: (parentPath, limit) => readdirSync(parentPath, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .slice(0, limit)
+        .map((entry) => join(parentPath, entry.name)),
+    gitRemoteUrl: (candidatePath) => {
+        const result = spawnSync("git", ["-C", candidatePath, "config", "--get", "remote.origin.url"], {
+            encoding: "utf8",
+            env: getDaemonCliEnvironment(),
+            timeout: 2_000,
+        });
+        if (result.status !== 0)
+            return null;
+        const url = result.stdout.trim();
+        return url || null;
+    },
+};
+export function normalizeRepositoryIdentity(value) {
+    const trimmed = value
+        .trim()
+        .replace(/\/+$/, "")
+        .replace(/\.git$/i, "");
+    if (!trimmed)
+        return null;
+    const scp = trimmed.match(/^(?:[^@/]+@)?([^:/]+):(.+)$/);
+    if (scp && !trimmed.includes("://")) {
+        return `${scp[1]}/${scp[2]}`.toLowerCase();
+    }
+    try {
+        const url = new URL(trimmed);
+        return `${url.hostname}${url.pathname}`.replace(/\/+$/, "").toLowerCase();
+    }
+    catch {
+        return null;
+    }
+}
+export function workspaceMatchesExpectedRepositories(input) {
+    const identities = new Set(input.expectedRepoUrls
+        .map(normalizeRepositoryIdentity)
+        .filter((identity) => Boolean(identity)));
+    if (identities.size === 0)
+        return false;
+    const remote = (input.probe ?? DEFAULT_PROBE).gitRemoteUrl(resolve(input.workspacePath));
+    const identity = remote ? normalizeRepositoryIdentity(remote) : null;
+    return Boolean(identity && identities.has(identity));
+}
+/**
+ * Search direct children of the missing workspace's parent plus parents of
+ * other user-approved Project paths. Return a result only when exactly one Git
+ * remote matches an expected repository identity across the bounded search.
+ */
+export function discoverRelocatedWorkspace(input) {
+    const identities = new Set(input.expectedRepoUrls
+        .map(normalizeRepositoryIdentity)
+        .filter((identity) => Boolean(identity)));
+    if (identities.size === 0)
+        return null;
+    const searchRoots = [
+        dirname(resolve(input.missingPath)),
+        ...(input.approvedWorkspacePaths ?? []).map((path) => dirname(resolve(path))),
+    ].filter((path, index, paths) => paths.indexOf(path) === index);
+    const candidates = [];
+    for (const root of searchRoots) {
+        const remaining = MAX_RELOCATION_CANDIDATES - candidates.length;
+        if (remaining <= 0)
+            break;
+        try {
+            candidates.push(...(input.probe ?? DEFAULT_PROBE).childDirectories(root, remaining));
+        }
+        catch {
+            // An unavailable approved root must not prevent checking the others.
+        }
+    }
+    const matches = [];
+    for (const candidate of new Set(candidates.map((path) => resolve(path)))) {
+        const remote = (input.probe ?? DEFAULT_PROBE).gitRemoteUrl(candidate);
+        const identity = remote ? normalizeRepositoryIdentity(remote) : null;
+        if (identity && identities.has(identity))
+            matches.push(resolve(candidate));
+        if (matches.length > 1)
+            return null;
+    }
+    return matches[0] ?? null;
+}
+//# sourceMappingURL=workspace-relocation.js.map

package/dist/workspace-relocation.js.map

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

package/dist/workspace-run-lease.d.ts

@@ -0,0 +1,97 @@
+export declare const WORKSPACE_LEASE_CHECK_INTERVAL_MS = 1000;
+export declare const WORKSPACE_LEASE_GIT_TIMEOUT_MS: number;
+export type WorkspaceRunLeaseFailureCode = "workspace_lease_unavailable" | "workspace_lease_path_changed" | "workspace_lease_repository_changed" | "workspace_lease_branch_changed";
+export interface WorkspaceRunLeaseFailure {
+    code: WorkspaceRunLeaseFailureCode;
+    message: string;
+    workspacePath: string;
+    expectedBranch?: string;
+    actualBranch?: string;
+}
+export interface WorkspaceRunLeaseTarget {
+    workspacePath: string;
+    expectedBranch?: string;
+}
+export interface WorkspaceRunIdentity {
+    workspacePath: string;
+    workspaceIdentity: string;
+    repositoryIdentity: string;
+    worktreeIdentity: string;
+    branch: string;
+}
+export interface WorkspaceRunLeaseProbe {
+    snapshot(workspacePath: string): WorkspaceRunIdentity | null;
+    /**
+     * Whether the workspace path still exists on disk. Used to classify a null
+     * snapshot: a missing path is a genuine, fail-fast "workspace gone"; a present
+     * path whose git probe merely failed (timeout / transient error) is retryable.
+     * Optional so existing probes/tests default to "unknown" (treated as present →
+     * retryable, the safe/conservative choice).
+     */
+    pathExists?(workspacePath: string): boolean;
+}
+export declare class WorkspaceRunLease {
+    private readonly captured;
+    private readonly probe;
+    private constructor();
+    static capture(targets: WorkspaceRunLeaseTarget[], probe?: WorkspaceRunLeaseProbe): {
+        lease: WorkspaceRunLease | null;
+        failure: WorkspaceRunLeaseFailure | null;
+    };
+    /**
+     * Classify the lease state for the run monitor.
+     *
+     * - `transient: true` — a null snapshot while the workspace path still exists:
+     *   the git probe timed out or failed transiently (OS throttling / IO
+     *   contention), NOT a vanished checkout. The monitor should retry (require N
+     *   consecutive transient failures) before declaring the workspace lost.
+     * - `transient: false` — a definitive change: the path is genuinely missing
+     *   (ENOENT), or the workspace/repository/worktree/branch identity changed.
+     *   These are real and fail fast.
+     */
+    verifyDetailed(): {
+        failure: WorkspaceRunLeaseFailure | null;
+        transient: boolean;
+    };
+    verify(): WorkspaceRunLeaseFailure | null;
+}
+export interface LeaseMonitorState {
+    /** Consecutive transient (retryable) probe failures observed so far. */
+    transientStreak: number;
+    /** Wall-clock time before which the next probe is skipped (backoff). */
+    nextCheckAtMs: number;
+}
+export interface LeaseCheckPolicy {
+    /** Consecutive transient failures tolerated before the run is failed. */
+    maxTransientFailures: number;
+    backoffBaseMs: number;
+    backoffMaxMs: number;
+}
+export declare const FRESH_LEASE_MONITOR_STATE: LeaseMonitorState;
+/** Whether the monitor should probe this tick, or is still inside a backoff window. */
+export declare function isLeaseCheckDue(state: LeaseMonitorState, nowMs: number): boolean;
+/**
+ * Fold a `verifyDetailed()` result into the monitor state.
+ *
+ * - No failure → reset the streak, resume the normal cadence (`ok`).
+ * - Definitive failure → `fail` immediately (path/repo/branch changed, path gone).
+ * - Transient failure below the streak cap → `transient`: keep the run alive, bump
+ *   the streak, and back the next probe off exponentially (capped). This is what
+ *   stops a single slow/coalesced `git` probe from false-failing a healthy run.
+ * - Transient failure reaching the cap → `fail` (the workspace really is gone).
+ */
+export declare function applyLeaseCheckResult(input: {
+    state: LeaseMonitorState;
+    detailed: {
+        failure: WorkspaceRunLeaseFailure | null;
+        transient: boolean;
+    };
+    nowMs: number;
+    policy: LeaseCheckPolicy;
+}): {
+    action: "ok" | "fail" | "transient";
+    state: LeaseMonitorState;
+    failure?: WorkspaceRunLeaseFailure;
+    backoffMs?: number;
+};
+//# sourceMappingURL=workspace-run-lease.d.ts.map

package/dist/workspace-run-lease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-run-lease.d.ts","sourceRoot":"","sources":["../src/workspace-run-lease.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AAcvD,eAAO,MAAM,8BAA8B,QAG1C,CAAC;AAEF,MAAM,MAAM,4BAA4B,GACpC,6BAA6B,GAC7B,8BAA8B,GAC9B,oCAAoC,GACpC,gCAAgC,CAAC;AAErC,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAAC;IAC7D;;;;;;OAMG;IACH,UAAU,CAAC,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7C;AAiFD,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAIzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IALxB,OAAO;IAQP,MAAM,CAAC,OAAO,CACZ,OAAO,EAAE,uBAAuB,EAAE,EAClC,KAAK,GAAE,sBAAsC,GAC5C;QAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAA;KAAE;IA2BhF;;;;;;;;;;OAUG;IACH,cAAc,IAAI;QAAE,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE;IA8ClF,MAAM,IAAI,wBAAwB,GAAG,IAAI;CAiC1C;AAMD,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,eAAe,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,yBAAyB,EAAE,iBAGvC,CAAC;AAEF,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEhF;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,KAAK,EAAE,iBAAiB,CAAC;IACzB,QAAQ,EAAE;QAAE,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,gBAAgB,CAAC;CAC1B,GAAG;IACF,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,WAAW,CAAC;IACpC,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CA0BA"}