@elie-laloum/outpost 3.0.0 → 4.0.0

package/dist/application/sandbox-provision.js.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox-provision.js","sourceRoot":"","sources":["../../src/application/sandbox-provision.ts"],"names":[],"mappings":"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","sourcesContent":["import { stat } from \"node:fs/promises\";\nimport { join, posix } from \"node:path\";\nimport type { AgentAdapter } from \"../domain/agent.types.ts\";\nimport { invariant } from \"../domain/errors.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport { git } from \"../infrastructure/git/command.ts\";\nimport { executeProcess } from \"../infrastructure/process.ts\";\nimport { resolveVariables } from \"../infrastructure/settings.ts\";\nimport { boundedTransfers } from \"../infrastructure/transfer.ts\";\nimport { docker } from \"../providers/docker.ts\";\nimport { prepareAdapter } from \"./agent-bootstrap.ts\";\nimport { hooks } from \"./lifecycle-hooks.ts\";\nimport type { SandboxOptions } from \"./outpost.types.ts\";\nimport { seedRemote } from \"./remote-workspace.ts\";\nimport type { RemoteSync } from \"./remote-workspace.types.ts\";\nimport type { ProvisionedSandbox } from \"./sandbox-session.types.ts\";\nimport { startupFailure } from \"./startup-recovery.ts\";\nimport { workspaces } from \"./workspace-registry.ts\";\nimport { openWorkspace } from \"./workspace.ts\";\n\nexport async function provisionSandbox(\n  options: SandboxOptions,\n): Promise<ProvisionedSandbox> {\n  options.signal?.throwIfAborted();\n  const provider = options.provider ?? docker();\n  if (provider.placement === \"remote\" && !options.workspace && !options.branch)\n    options = { ...options, branch: { mode: \"integrate\" } };\n  invariant(\n    !options.workspace ||\n      (!options.repository && !options.branch && !options.copies),\n    \"A supplied workspace owns its repository, branch and copied inputs\",\n  );\n  const owned = !options.workspace;\n  invariant(\n    provider.placement !== \"remote\" ||\n      ((options.workspace?.policy ?? options.branch)?.mode !== \"current\" &&\n        (options.workspace || options.branch)),\n    \"Remote providers require a named or integration workspace\",\n  );\n  const workspace = options.workspace ?? (await openWorkspace(options));\n  const state = workspaces.get(workspace);\n  invariant(\n    state && !state.closed && !state.active,\n    \"Workspace must be open and cannot belong to another sandbox\",\n  );\n  state.active = true;\n  const lifecycle = options.hooks ?? state.hooks;\n  const stop = new AbortController();\n  const setupSignal = options.signal\n    ? AbortSignal.any([options.signal, stop.signal])\n    : stop.signal;\n  let lease: SandboxLease | undefined, sync: RemoteSync | undefined;\n  const prepared = new Map<AgentAdapter, AgentAdapter>();\n  const staging = join(\n    workspace.repository,\n    \".outpost\",\n    \"recovery\",\n    \"conversations\",\n  );\n  try {\n    const configured = await resolveVariables(\n      workspace.repository,\n      {},\n      provider.variables,\n    );\n    const name = (\n      await git(workspace.repository, [\"config\", \"--get\", \"user.name\"]).catch(\n        () => \"Outpost\",\n      )\n    ).trim();\n    const email = (\n      await git(workspace.repository, [\"config\", \"--get\", \"user.email\"]).catch(\n        () => \"outpost@localhost\",\n      )\n    ).trim();\n    const variables = {\n      GIT_AUTHOR_NAME: name,\n      GIT_COMMITTER_NAME: name,\n      GIT_AUTHOR_EMAIL: email,\n      GIT_COMMITTER_EMAIL: email,\n      ...configured,\n    };\n    lease = boundedTransfers(\n      await provider.acquire({\n        repository: workspace.repository,\n        directory: workspace.directory,\n        gitDirectories: workspace.gitDirectories,\n        variables,\n        signal: setupSignal,\n      }),\n      {\n        ...(options.limits?.copyMs\n          ? { deadlineMs: options.limits.copyMs }\n          : {}),\n      },\n    );\n    if (provider.placement === \"remote\") {\n      sync = await seedRemote(workspace, lease, {\n        ...(options.includeUncommitted ? { includeUncommitted: true } : {}),\n        ...(options.limits ? { limits: options.limits } : {}),\n        signal: setupSignal,\n      });\n      for (const path of options.copies ?? [])\n        if (\n          await stat(join(workspace.directory, path)).catch((error) => {\n            if ((error as NodeJS.ErrnoException).code === \"ENOENT\")\n              return undefined;\n            throw error;\n          })\n        )\n          await lease.upload(\n            join(workspace.directory, path),\n            posix.join(lease.root, path.replaceAll(\"\\\\\", \"/\")),\n          );\n      if (options.bootstrap !== false && options.agent)\n        prepared.set(\n          options.agent,\n          await prepareAdapter(options.agent, lease, setupSignal),\n        );\n    }\n    const initialized = await Promise.allSettled(\n      [\n        hooks(\n          lifecycle?.hostReady ?? [],\n          workspace.directory,\n          executeProcess,\n          setupSignal,\n        ),\n        hooks(\n          lifecycle?.sandboxReady ?? [],\n          lease.root,\n          lease.invoke.bind(lease),\n          setupSignal,\n          true,\n        ),\n      ].map((pending) =>\n        pending.catch((cause) => {\n          stop.abort(cause);\n          throw cause;\n        }),\n      ),\n    );\n    const failure = initialized.find((item) => item.status === \"rejected\");\n    if (failure?.status === \"rejected\") throw failure.reason;\n  } catch (cause) {\n    await startupFailure(workspace, cause, options);\n    await lease?.release().catch(() => undefined);\n    state.active = false;\n    if (owned) await workspace.close();\n    throw cause;\n  }\n\n  return {\n    options,\n    provider,\n    workspace,\n    state,\n    owned,\n    stop,\n    runtime: lease,\n    sync,\n    prepared,\n    staging,\n  };\n}\n"]}
+{"version":3,"file":"sandbox-provision.js","sourceRoot":"","sources":["../../src/application/sandbox-provision.ts"],"names":[],"mappings":"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","sourcesContent":["import { lstat } from \"node:fs/promises\";\nimport { join, posix } from \"node:path\";\nimport type { AgentAdapter } from \"../domain/agent.types.ts\";\nimport { invariant } from \"../domain/errors.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport { git } from \"../infrastructure/git/command.ts\";\nimport { executeProcess } from \"../infrastructure/process.ts\";\nimport { resolveVariables } from \"../infrastructure/settings.ts\";\nimport { registerResourceActivity } from \"../infrastructure/resource-activity.ts\";\nimport type { ResourceActivity } from \"../infrastructure/resource-activity.types.ts\";\nimport { trackedSandboxLease } from \"./sandbox-activity.ts\";\nimport { boundedTransfers } from \"../infrastructure/transfer.ts\";\nimport { docker } from \"../providers/docker.ts\";\nimport { prepareAdapter } from \"./agent-bootstrap.ts\";\nimport { hooks } from \"./lifecycle-hooks.ts\";\nimport type { SandboxOptions } from \"./outpost.types.ts\";\nimport { uploadFiles } from \"./remote-upload.ts\";\nimport { seedRemote } from \"./remote-workspace.ts\";\nimport type { RemoteSync } from \"./remote-workspace.types.ts\";\nimport type { ProvisionedSandbox } from \"./sandbox-session.types.ts\";\nimport { startupFailure } from \"./startup-recovery.ts\";\nimport { workspaces } from \"./workspace-registry.ts\";\nimport { openWorkspace } from \"./workspace.ts\";\n\nexport async function provisionSandbox(\n  options: SandboxOptions,\n): Promise<ProvisionedSandbox> {\n  options.signal?.throwIfAborted();\n  const provider = options.provider ?? docker();\n  if (provider.placement === \"remote\" && !options.workspace && !options.branch)\n    options = { ...options, branch: { mode: \"integrate\" } };\n  invariant(\n    !options.workspace ||\n      (!options.repository &&\n        !options.branch &&\n        !options.copies &&\n        !options.storageQuota),\n    \"A supplied workspace owns its repository, branch, copied inputs and storage quota\",\n  );\n  const owned = !options.workspace;\n  invariant(\n    provider.placement !== \"remote\" ||\n      ((options.workspace?.policy ?? options.branch)?.mode !== \"current\" &&\n        (options.workspace || options.branch)),\n    \"Remote providers require a named or integration workspace\",\n  );\n  const workspace = options.workspace ?? (await openWorkspace(options));\n  const state = workspaces.get(workspace);\n  invariant(\n    state && !state.closed && !state.active,\n    \"Workspace must be open and cannot belong to another sandbox\",\n  );\n  state.active = true;\n  const lifecycle = options.hooks ?? state.hooks;\n  const stop = new AbortController();\n  const setupSignal = options.signal\n    ? AbortSignal.any([options.signal, stop.signal])\n    : stop.signal;\n  let lease: SandboxLease | undefined, sync: RemoteSync | undefined;\n  let activity: ResourceActivity | undefined;\n  let acquisitionStarted = false;\n  const prepared = new Map<AgentAdapter, AgentAdapter>();\n  const staging = join(\n    workspace.repository,\n    \".outpost\",\n    \"recovery\",\n    \"conversations\",\n  );\n  try {\n    activity = await registerResourceActivity({\n      repository: workspace.repository,\n      workspace: workspace.directory,\n      provider: provider.name,\n      placement: provider.placement,\n    });\n    const configured = await resolveVariables(\n      workspace.repository,\n      {},\n      provider.variables,\n    );\n    const name = (\n      await git(workspace.repository, [\"config\", \"--get\", \"user.name\"]).catch(\n        () => \"Outpost\",\n      )\n    ).trim();\n    const email = (\n      await git(workspace.repository, [\"config\", \"--get\", \"user.email\"]).catch(\n        () => \"outpost@localhost\",\n      )\n    ).trim();\n    const variables = {\n      GIT_AUTHOR_NAME: name,\n      GIT_COMMITTER_NAME: name,\n      GIT_AUTHOR_EMAIL: email,\n      GIT_COMMITTER_EMAIL: email,\n      ...configured,\n    };\n    acquisitionStarted = true;\n    lease = boundedTransfers(\n      trackedSandboxLease(\n        await provider.acquire({\n          repository: workspace.repository,\n          directory: workspace.directory,\n          gitDirectories: workspace.gitDirectories,\n          variables,\n          signal: setupSignal,\n        }),\n        activity,\n      ),\n      {\n        ...(options.limits?.copyMs\n          ? { deadlineMs: options.limits.copyMs }\n          : {}),\n      },\n    );\n    if (provider.placement === \"remote\") {\n      sync = await seedRemote(workspace, lease, {\n        ...(options.includeUncommitted ? { includeUncommitted: true } : {}),\n        ...(options.limits ? { limits: options.limits } : {}),\n        signal: setupSignal,\n      });\n      const copiedFiles: string[] = [];\n      for (const path of options.copies ?? []) {\n        const info = await lstat(join(workspace.directory, path)).catch(\n          (error) => {\n            if ((error as NodeJS.ErrnoException).code === \"ENOENT\")\n              return undefined;\n            throw error;\n          },\n        );\n        if (!info) continue;\n        if (info.isFile() || info.isSymbolicLink()) {\n          copiedFiles.push(path.replaceAll(\"\\\\\", \"/\"));\n          continue;\n        }\n        await lease.upload(\n          join(workspace.directory, path),\n          posix.join(lease.root, path.replaceAll(\"\\\\\", \"/\")),\n          { signal: setupSignal },\n        );\n      }\n      await uploadFiles(lease, workspace.directory, [...new Set(copiedFiles)], {\n        signal: setupSignal,\n      });\n      if (options.bootstrap !== false && options.agent)\n        prepared.set(\n          options.agent,\n          await prepareAdapter(options.agent, lease, setupSignal),\n        );\n    }\n    const initialized = await Promise.allSettled(\n      [\n        hooks(\n          lifecycle?.hostReady ?? [],\n          workspace.directory,\n          executeProcess,\n          setupSignal,\n        ),\n        hooks(\n          lifecycle?.sandboxReady ?? [],\n          lease.root,\n          lease.invoke.bind(lease),\n          setupSignal,\n          true,\n        ),\n      ].map((pending) =>\n        pending.catch((cause) => {\n          stop.abort(cause);\n          throw cause;\n        }),\n      ),\n    );\n    const failure = initialized.find((item) => item.status === \"rejected\");\n    if (failure?.status === \"rejected\") throw failure.reason;\n    await activity.phase(\"ready\");\n  } catch (cause) {\n    await startupFailure(workspace, cause, options);\n    const allocationUncertain = acquisitionStarted && !lease;\n    let cleanupFailed = allocationUncertain;\n    await activity?.phase(\"closing\").catch(() => {\n      cleanupFailed = true;\n    });\n    await lease?.release().catch(() => {\n      cleanupFailed = true;\n    });\n    if (activity && !(await activity.idle())) cleanupFailed = true;\n    state.active = false;\n    if (owned)\n      await workspace.close({ preserve: cleanupFailed }).catch(() => {\n        cleanupFailed = true;\n      });\n    if (cleanupFailed)\n      await activity\n        ?.phase(allocationUncertain ? \"allocation-uncertain\" : \"cleanup-failed\")\n        .catch(() => undefined);\n    if (!cleanupFailed) await activity?.remove().catch(() => undefined);\n    throw cause;\n  }\n\n  return {\n    options,\n    provider,\n    workspace,\n    state,\n    owned,\n    stop,\n    runtime: lease,\n    activity,\n    sync,\n    prepared,\n    staging,\n  };\n}\n"]}

package/dist/application/sandbox-session.types.d.ts

@@ -1,3 +1,4 @@
+import type { ResourceActivity } from "../infrastructure/resource-activity.types.ts";
 import type { AgentAdapter } from "../domain/agent.types.ts";
 import type { SandboxLease, SandboxProvider } from "../domain/sandbox.types.ts";
 import type { LifecycleHooks } from "../domain/workspace.types.ts";
@@ -18,6 +19,7 @@ export interface ProvisionedSandbox {
     readonly owned: boolean;
     readonly stop: AbortController;
     readonly runtime: SandboxLease;
+    readonly activity: ResourceActivity;
     readonly sync: RemoteSync | undefined;
     readonly prepared: Map<AgentAdapter, AgentAdapter>;
     readonly staging: string;

package/dist/application/sandbox-session.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox-session.types.js","sourceRoot":"","sources":["../../src/application/sandbox-session.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { AgentAdapter } from \"../domain/agent.types.ts\";\nimport type { SandboxLease, SandboxProvider } from \"../domain/sandbox.types.ts\";\nimport type { LifecycleHooks } from \"../domain/workspace.types.ts\";\nimport type { WorkspaceLease } from \"../infrastructure/git/workspace.types.ts\";\nimport type { SandboxOptions, Workspace } from \"./outpost.types.ts\";\nimport type { RemoteSync } from \"./remote-workspace.types.ts\";\n\nexport interface WorkspaceState {\n  lease: WorkspaceLease;\n  active: boolean;\n  closed: boolean;\n  hooks?: LifecycleHooks;\n}\n\nexport interface ProvisionedSandbox {\n  readonly options: SandboxOptions;\n  readonly provider: SandboxProvider;\n  readonly workspace: Workspace;\n  readonly state: WorkspaceState;\n  readonly owned: boolean;\n  readonly stop: AbortController;\n  readonly runtime: SandboxLease;\n  readonly sync: RemoteSync | undefined;\n  readonly prepared: Map<AgentAdapter, AgentAdapter>;\n  readonly staging: string;\n}\n\nexport interface SelectedAgent {\n  readonly selected: AgentAdapter;\n  readonly adapter: AgentAdapter;\n  readonly executionLease: SandboxLease;\n}\n\nexport interface SandboxAgents {\n  selectAgent(\n    agent: AgentAdapter | undefined,\n    signal: AbortSignal,\n  ): Promise<SelectedAgent>;\n  restore(id: string, agent: AgentAdapter): Promise<void>;\n  remember(agent: AgentAdapter, id: string): void;\n}\n\nexport interface OperationGate {\n  run<T>(action: () => Promise<T>): Promise<T>;\n  close(): Promise<void>;\n}\n"]}
+{"version":3,"file":"sandbox-session.types.js","sourceRoot":"","sources":["../../src/application/sandbox-session.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ResourceActivity } from \"../infrastructure/resource-activity.types.ts\";\nimport type { AgentAdapter } from \"../domain/agent.types.ts\";\nimport type { SandboxLease, SandboxProvider } from \"../domain/sandbox.types.ts\";\nimport type { LifecycleHooks } from \"../domain/workspace.types.ts\";\nimport type { WorkspaceLease } from \"../infrastructure/git/workspace.types.ts\";\nimport type { SandboxOptions, Workspace } from \"./outpost.types.ts\";\nimport type { RemoteSync } from \"./remote-workspace.types.ts\";\n\nexport interface WorkspaceState {\n  lease: WorkspaceLease;\n  active: boolean;\n  closed: boolean;\n  hooks?: LifecycleHooks;\n}\n\nexport interface ProvisionedSandbox {\n  readonly options: SandboxOptions;\n  readonly provider: SandboxProvider;\n  readonly workspace: Workspace;\n  readonly state: WorkspaceState;\n  readonly owned: boolean;\n  readonly stop: AbortController;\n  readonly runtime: SandboxLease;\n  readonly activity: ResourceActivity;\n  readonly sync: RemoteSync | undefined;\n  readonly prepared: Map<AgentAdapter, AgentAdapter>;\n  readonly staging: string;\n}\n\nexport interface SelectedAgent {\n  readonly selected: AgentAdapter;\n  readonly adapter: AgentAdapter;\n  readonly executionLease: SandboxLease;\n}\n\nexport interface SandboxAgents {\n  selectAgent(\n    agent: AgentAdapter | undefined,\n    signal: AbortSignal,\n  ): Promise<SelectedAgent>;\n  restore(id: string, agent: AgentAdapter): Promise<void>;\n  remember(agent: AgentAdapter, id: string): void;\n}\n\nexport interface OperationGate {\n  run<T>(action: () => Promise<T>): Promise<T>;\n  close(): Promise<void>;\n}\n"]}

package/dist/application/sandbox.js

@@ -13,14 +13,14 @@ export async function createSandbox(options = {}) {
     const { workspace, runtime, sync, stop, state, owned } = context;
     const agents = sandboxAgents(context);
     const gate = operationGate();
-    const exclusive = gate.run;
+    const exclusive = (kind, action) => gate.run(() => context.activity.run(kind, action));
     let closing;
     const result = {
         workspace,
         root: runtime.root,
         dispatch(settings) {
             validateDispatch(settings);
-            return exclusive(() => dispatchInSandbox(context, agents, result, settings));
+            return exclusive("dispatch", () => dispatchInSandbox(context, agents, result, settings));
         },
         resume(id, settings) {
             return result.dispatch({ ...settings, continuation: { id } });
@@ -31,11 +31,11 @@ export async function createSandbox(options = {}) {
         attach(settings = {}) {
             settings.signal?.throwIfAborted();
             validateBrief(settings.brief, true);
-            return exclusive(() => attachInSandbox(context, agents, settings));
+            return exclusive("attach", () => attachInSandbox(context, agents, settings));
         },
         diagnose(settings = {}) {
             settings.signal?.throwIfAborted();
-            return exclusive(() => diagnoseSandbox(runtime, {
+            return exclusive("diagnose", () => diagnoseSandbox(runtime, {
                 ...settings,
                 provider: context.provider,
                 signal: settings.signal
@@ -45,7 +45,7 @@ export async function createSandbox(options = {}) {
         },
         command(command) {
             command.signal?.throwIfAborted();
-            return exclusive(async () => {
+            return exclusive("command", async () => {
                 try {
                     return await runtime.invoke({
                         ...command,
@@ -66,21 +66,33 @@ export async function createSandbox(options = {}) {
                 stop.abort(new OutpostError("aborted", "Sandbox closed"));
                 await gate.close();
                 let failure;
+                await context.activity.phase("closing").catch(() => undefined);
                 try {
                     await runtime.release();
                     await sync?.close();
+                    if (!(await context.activity.idle()))
+                        throw new OutpostError("provider", "Sandbox operations remain unsettled after release");
                 }
                 catch (cause) {
                     failure = cause;
                 }
                 state.active = false;
                 unregister();
-                const disposal = owned
-                    ? await workspace.close({ preserve: settings.preserve || !!failure })
-                    : {};
-                if (failure)
-                    throw failure;
-                return disposal;
+                let disposal = {};
+                try {
+                    if (owned)
+                        disposal = await workspace.close({
+                            preserve: settings.preserve || !!failure,
+                        });
+                    if (failure)
+                        throw failure;
+                    await context.activity.remove();
+                    return disposal;
+                }
+                catch (cause) {
+                    await context.activity.phase("cleanup-failed").catch(() => undefined);
+                    throw cause;
+                }
             })();
             return closing;
         },

package/dist/application/sandbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../../src/application/sandbox.ts"],"names":[],"mappings":"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","sourcesContent":["import { OutpostError } from \"../domain/errors.ts\";\nimport { validateBrief } from \"../domain/prompts.ts\";\nimport type { Disposal } from \"../domain/workspace.types.ts\";\nimport { registerCleanup } from \"../infrastructure/shutdown.ts\";\nimport { validateDispatch } from \"./dispatch-validation.ts\";\nimport { diagnoseSandbox } from \"./doctor-sandbox.ts\";\nimport { operationGate } from \"./operation-gate.ts\";\nimport type { Sandbox, SandboxOptions } from \"./outpost.types.ts\";\nimport { sandboxAgents } from \"./sandbox-agents.ts\";\nimport { attachInSandbox } from \"./sandbox-attach.ts\";\nimport { dispatchInSandbox } from \"./sandbox-dispatch.ts\";\nimport { provisionSandbox } from \"./sandbox-provision.ts\";\n\nexport async function createSandbox(\n  options: SandboxOptions = {},\n): Promise<Sandbox> {\n  const context = await provisionSandbox(options);\n  const { workspace, runtime, sync, stop, state, owned } = context;\n  const agents = sandboxAgents(context);\n  const gate = operationGate();\n  const exclusive = gate.run;\n  let closing: Promise<Disposal> | undefined;\n  const result: Sandbox = {\n    workspace,\n    root: runtime.root,\n    dispatch(settings) {\n      validateDispatch(settings);\n      return exclusive(() =>\n        dispatchInSandbox(context, agents, result, settings),\n      );\n    },\n    resume(id, settings) {\n      return result.dispatch({ ...settings, continuation: { id } });\n    },\n    fork(id, settings) {\n      return result.dispatch({ ...settings, continuation: { id, fork: true } });\n    },\n    attach(settings = {}) {\n      settings.signal?.throwIfAborted();\n      validateBrief(settings.brief, true);\n      return exclusive(() => attachInSandbox(context, agents, settings));\n    },\n    diagnose(settings = {}) {\n      settings.signal?.throwIfAborted();\n      return exclusive(() =>\n        diagnoseSandbox(runtime, {\n          ...settings,\n          provider: context.provider,\n          signal: settings.signal\n            ? AbortSignal.any([settings.signal, stop.signal])\n            : stop.signal,\n        }),\n      );\n    },\n    command(command) {\n      command.signal?.throwIfAborted();\n      return exclusive(async () => {\n        try {\n          return await runtime.invoke({\n            ...command,\n            signal: command.signal\n              ? AbortSignal.any([command.signal, stop.signal])\n              : stop.signal,\n          });\n        } finally {\n          await sync?.pull();\n        }\n      });\n    },\n    close(settings = {}) {\n      if (closing) return closing;\n      closing = (async () => {\n        stop.abort(new OutpostError(\"aborted\", \"Sandbox closed\"));\n        await gate.close();\n        let failure: unknown;\n        try {\n          await runtime.release();\n          await sync?.close();\n        } catch (cause) {\n          failure = cause;\n        }\n        state.active = false;\n\n        unregister();\n        const disposal = owned\n          ? await workspace.close({ preserve: settings.preserve || !!failure })\n          : {};\n        if (failure) throw failure;\n        return disposal;\n      })();\n      return closing;\n    },\n    async [Symbol.asyncDispose]() {\n      await result.close();\n    },\n  };\n  const unregister = registerCleanup(() => result.close({ preserve: true }));\n  return result;\n}\n"]}
+{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../../src/application/sandbox.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ResourceOperationKind } from \"../infrastructure/resource-activity.types.ts\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport { validateBrief } from \"../domain/prompts.ts\";\nimport type { Disposal } from \"../domain/workspace.types.ts\";\nimport { registerCleanup } from \"../infrastructure/shutdown.ts\";\nimport { validateDispatch } from \"./dispatch-validation.ts\";\nimport { diagnoseSandbox } from \"./doctor-sandbox.ts\";\nimport { operationGate } from \"./operation-gate.ts\";\nimport type { Sandbox, SandboxOptions } from \"./outpost.types.ts\";\nimport { sandboxAgents } from \"./sandbox-agents.ts\";\nimport { attachInSandbox } from \"./sandbox-attach.ts\";\nimport { dispatchInSandbox } from \"./sandbox-dispatch.ts\";\nimport { provisionSandbox } from \"./sandbox-provision.ts\";\n\nexport async function createSandbox(\n  options: SandboxOptions = {},\n): Promise<Sandbox> {\n  const context = await provisionSandbox(options);\n  const { workspace, runtime, sync, stop, state, owned } = context;\n  const agents = sandboxAgents(context);\n  const gate = operationGate();\n  const exclusive = <T>(\n    kind: ResourceOperationKind,\n    action: () => Promise<T>,\n  ) => gate.run(() => context.activity.run(kind, action));\n  let closing: Promise<Disposal> | undefined;\n  const result: Sandbox = {\n    workspace,\n    root: runtime.root,\n    dispatch(settings) {\n      validateDispatch(settings);\n      return exclusive(\"dispatch\", () =>\n        dispatchInSandbox(context, agents, result, settings),\n      );\n    },\n    resume(id, settings) {\n      return result.dispatch({ ...settings, continuation: { id } });\n    },\n    fork(id, settings) {\n      return result.dispatch({ ...settings, continuation: { id, fork: true } });\n    },\n    attach(settings = {}) {\n      settings.signal?.throwIfAborted();\n      validateBrief(settings.brief, true);\n      return exclusive(\"attach\", () =>\n        attachInSandbox(context, agents, settings),\n      );\n    },\n    diagnose(settings = {}) {\n      settings.signal?.throwIfAborted();\n      return exclusive(\"diagnose\", () =>\n        diagnoseSandbox(runtime, {\n          ...settings,\n          provider: context.provider,\n          signal: settings.signal\n            ? AbortSignal.any([settings.signal, stop.signal])\n            : stop.signal,\n        }),\n      );\n    },\n    command(command) {\n      command.signal?.throwIfAborted();\n      return exclusive(\"command\", async () => {\n        try {\n          return await runtime.invoke({\n            ...command,\n            signal: command.signal\n              ? AbortSignal.any([command.signal, stop.signal])\n              : stop.signal,\n          });\n        } finally {\n          await sync?.pull();\n        }\n      });\n    },\n    close(settings = {}) {\n      if (closing) return closing;\n      closing = (async () => {\n        stop.abort(new OutpostError(\"aborted\", \"Sandbox closed\"));\n        await gate.close();\n        let failure: unknown;\n        await context.activity.phase(\"closing\").catch(() => undefined);\n        try {\n          await runtime.release();\n          await sync?.close();\n          if (!(await context.activity.idle()))\n            throw new OutpostError(\n              \"provider\",\n              \"Sandbox operations remain unsettled after release\",\n            );\n        } catch (cause) {\n          failure = cause;\n        }\n        state.active = false;\n\n        unregister();\n        let disposal: Disposal = {};\n        try {\n          if (owned)\n            disposal = await workspace.close({\n              preserve: settings.preserve || !!failure,\n            });\n          if (failure) throw failure;\n          await context.activity.remove();\n          return disposal;\n        } catch (cause) {\n          await context.activity.phase(\"cleanup-failed\").catch(() => undefined);\n          throw cause;\n        }\n      })();\n      return closing;\n    },\n    async [Symbol.asyncDispose]() {\n      await result.close();\n    },\n  };\n  const unregister = registerCleanup(() => result.close({ preserve: true }));\n  return result;\n}\n"]}

package/dist/application/speculation-host.d.ts

@@ -0,0 +1,2 @@
+import type { SpeculativeHostSnapshot } from "./speculation.types.ts";
+export declare function speculativeHostSnapshot(repository: string): Promise<SpeculativeHostSnapshot>;

package/dist/application/speculation-host.js

@@ -0,0 +1,30 @@
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { git } from "../infrastructure/git/command.js";
+import { digest } from "./workspace-fingerprint.js";
+export async function speculativeHostSnapshot(repository) {
+    const temporary = await mkdtemp(join(tmpdir(), "outpost-speculation-"));
+    try {
+        const head = (await git(repository, ["rev-parse", "--verify", "HEAD^{commit}"])).trim();
+        const branch = (await git(repository, ["rev-parse", "--abbrev-ref", "HEAD"])).trim();
+        const status = await git(repository, [
+            "status",
+            "--porcelain",
+            "--untracked-files=all",
+            "--",
+            ".",
+            ":(exclude).outpost",
+        ]);
+        return {
+            head,
+            branch,
+            dirty: !!status.trim(),
+            fingerprint: await digest(repository, temporary),
+        };
+    }
+    finally {
+        await rm(temporary, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=speculation-host.js.map

package/dist/application/speculation-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speculation-host.js","sourceRoot":"","sources":["../../src/application/speculation-host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,kCAAkC,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGpD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,UAAkB;IAElB,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,sBAAsB,CAAC,CAAC,CAAC;IACxE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CACX,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAClE,CAAC,IAAI,EAAE,CAAC;QACT,MAAM,MAAM,GAAG,CACb,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,CAC7D,CAAC,IAAI,EAAE,CAAC;QACT,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,EAAE;YACnC,QAAQ;YACR,aAAa;YACb,uBAAuB;YACvB,IAAI;YACJ,GAAG;YACH,oBAAoB;SACrB,CAAC,CAAC;QACH,OAAO;YACL,IAAI;YACJ,MAAM;YACN,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;YACtB,WAAW,EAAE,MAAM,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC;SACjD,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC","sourcesContent":["import { mkdtemp, rm } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { git } from \"../infrastructure/git/command.ts\";\nimport { digest } from \"./workspace-fingerprint.ts\";\nimport type { SpeculativeHostSnapshot } from \"./speculation.types.ts\";\n\nexport async function speculativeHostSnapshot(\n  repository: string,\n): Promise<SpeculativeHostSnapshot> {\n  const temporary = await mkdtemp(join(tmpdir(), \"outpost-speculation-\"));\n  try {\n    const head = (\n      await git(repository, [\"rev-parse\", \"--verify\", \"HEAD^{commit}\"])\n    ).trim();\n    const branch = (\n      await git(repository, [\"rev-parse\", \"--abbrev-ref\", \"HEAD\"])\n    ).trim();\n    const status = await git(repository, [\n      \"status\",\n      \"--porcelain\",\n      \"--untracked-files=all\",\n      \"--\",\n      \".\",\n      \":(exclude).outpost\",\n    ]);\n    return {\n      head,\n      branch,\n      dirty: !!status.trim(),\n      fingerprint: await digest(repository, temporary),\n    };\n  } finally {\n    await rm(temporary, { recursive: true, force: true });\n  }\n}\n"]}

package/dist/application/speculation.constants.d.ts

@@ -0,0 +1,4 @@
+export declare const speculationLimits: {
+    readonly candidates: 8;
+    readonly concurrency: 2;
+};

package/dist/application/speculation.constants.js

@@ -0,0 +1,2 @@
+export const speculationLimits = { candidates: 8, concurrency: 2 };
+//# sourceMappingURL=speculation.constants.js.map

package/dist/application/speculation.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speculation.constants.js","sourceRoot":"","sources":["../../src/application/speculation.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAW,CAAC","sourcesContent":["export const speculationLimits = { candidates: 8, concurrency: 2 } as const;\n"]}

package/dist/application/speculation.d.ts

@@ -0,0 +1,2 @@
+import type { SpeculationOptions, SpeculationResult } from "./speculation.types.ts";
+export declare function speculate<T = undefined>(options: SpeculationOptions<T>): Promise<SpeculationResult<T>>;

package/dist/application/speculation.js

@@ -0,0 +1,166 @@
+import { randomUUID } from "node:crypto";
+import { invariant, recoveryDetails } from "../domain/errors.js";
+import { workflowAccounting } from "../domain/workflow/budget.js";
+import { speculativeHostSnapshot } from "./speculation-host.js";
+import { createSandbox } from "./sandbox.js";
+import { speculationLimits } from "./speculation.constants.js";
+import { taskUsage } from "./task-usage.js";
+export async function speculate(options) {
+    const { candidates } = options;
+    invariant(candidates.length > 0 && candidates.length <= speculationLimits.candidates, `Speculation requires 1 to ${speculationLimits.candidates} candidates`);
+    invariant(new Set(candidates.map((candidate) => candidate.key)).size ===
+        candidates.length &&
+        candidates.every((candidate) => /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/.test(candidate.key)), "Speculative candidate keys must be unique simple names of 1 to 64 characters");
+    const concurrency = options.concurrency ?? speculationLimits.concurrency;
+    invariant(Number.isSafeInteger(concurrency) &&
+        concurrency > 0 &&
+        concurrency <= speculationLimits.candidates, `Speculation concurrency must be 1 to ${speculationLimits.candidates}`);
+    const stop = new AbortController();
+    const signal = options.signal
+        ? AbortSignal.any([options.signal, stop.signal])
+        : stop.signal;
+    let budgetError;
+    const accounting = workflowAccounting(options.budget, (error) => {
+        budgetError = error;
+        // Attempt limits stop admissions; already admitted candidates may finish.
+        if (error.dimension !== "attempts")
+            stop.abort(error);
+    });
+    const before = await speculativeHostSnapshot(options.repository);
+    const baseline = before.head;
+    const id = randomUUID();
+    const records = candidates.map((candidate) => ({
+        key: candidate.key,
+        branch: `outpost/speculation/${id}/${candidate.key}`,
+        status: "skipped",
+    }));
+    let winner;
+    let next = 0;
+    async function worker() {
+        while (!signal.aborted && !winner && !accounting.exhausted) {
+            const index = next++;
+            const candidate = candidates[index];
+            if (!candidate)
+                return;
+            try {
+                accounting.admit();
+            }
+            catch {
+                return;
+            }
+            const initial = records[index];
+            let sandbox;
+            let result;
+            let error;
+            let accepted = false;
+            let cleanupFailed = false;
+            let retainedDirectory;
+            const usage = taskUsage({ reportUsage: (value) => accounting.report(value) }, candidate.request.observe);
+            try {
+                sandbox = await createSandbox({
+                    ...options.sandbox,
+                    repository: options.repository,
+                    provider: options.provider,
+                    branch: { mode: "named", name: initial.branch, from: baseline },
+                    agent: candidate.agent,
+                    signal,
+                });
+                signal.throwIfAborted();
+                invariant(sandbox.workspace.baseline === baseline, "Speculative workspace does not match the pinned baseline");
+                const { resume: _resume, fork: _fork, ...output } = await sandbox.dispatch({
+                    ...candidate.request,
+                    signal,
+                    observe: usage.observe,
+                });
+                result = output;
+                usage.reconcile(output.usage);
+                signal.throwIfAborted();
+                accepted = await options.validate({
+                    key: candidate.key,
+                    result,
+                    sandbox,
+                    signal,
+                });
+                signal.throwIfAborted();
+            }
+            catch (cause) {
+                error = cause;
+            }
+            if (sandbox) {
+                try {
+                    const disposal = await sandbox.close({
+                        preserve: error !== undefined,
+                    });
+                    retainedDirectory = disposal.retainedDirectory;
+                }
+                catch (cause) {
+                    cleanupFailed = true;
+                    error =
+                        error === undefined
+                            ? cause
+                            : new AggregateError([error, cause], "Speculative execution and cleanup failed");
+                    retainedDirectory = sandbox.workspace.directory;
+                }
+            }
+            const recovery = recoveryDetails(error);
+            const recoveredDirectory = typeof recovery?.directory === "string"
+                ? recovery.directory
+                : undefined;
+            const directory = sandbox?.workspace.directory ?? recoveredDirectory;
+            retainedDirectory ??= recoveredDirectory;
+            function candidateStatus() {
+                if (cleanupFailed)
+                    return "failed";
+                if (signal.aborted)
+                    return "cancelled";
+                if (error !== undefined)
+                    return "failed";
+                if (accepted && !winner)
+                    return "winner";
+                return "rejected";
+            }
+            const status = candidateStatus();
+            const record = {
+                ...initial,
+                status,
+                ...(directory ? { directory } : {}),
+                ...(retainedDirectory ? { retainedDirectory } : {}),
+                ...(result ? { result } : {}),
+                ...(error !== undefined ? { error } : {}),
+            };
+            records[index] = record;
+            if (status === "winner") {
+                winner = record;
+                stop.abort(new Error(`Speculative candidate ${candidate.key} selected`));
+            }
+        }
+    }
+    await Promise.all(Array.from({ length: Math.min(concurrency, candidates.length) }, worker));
+    function outcome() {
+        if (winner)
+            return "winner";
+        if (options.signal?.aborted)
+            return "aborted";
+        if (budgetError !== undefined)
+            return "budget-exhausted";
+        return "no-winner";
+    }
+    const status = outcome();
+    const host = await speculativeHostSnapshot(options.repository).then((after) => ({
+        before,
+        after,
+        changed: before.fingerprint !== after.fingerprint ||
+            before.branch !== after.branch,
+    }), (error) => ({ before, changed: true, error }));
+    return {
+        id,
+        baseline,
+        host,
+        status,
+        candidates: records,
+        usage: accounting.snapshot(),
+        ...(winner ? { winner } : {}),
+        ...(budgetError !== undefined ? { error: budgetError } : {}),
+    };
+}
+//# sourceMappingURL=speculation.js.map

package/dist/application/speculation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speculation.js","sourceRoot":"","sources":["../../src/application/speculation.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { invariant, recoveryDetails } from \"../domain/errors.ts\";\nimport { workflowAccounting } from \"../domain/workflow/budget.ts\";\nimport { speculativeHostSnapshot } from \"./speculation-host.ts\";\nimport type { Sandbox } from \"./outpost.types.ts\";\nimport { createSandbox } from \"./sandbox.ts\";\nimport { speculationLimits } from \"./speculation.constants.ts\";\nimport type {\n  SpeculationOptions,\n  SpeculationResult,\n  SpeculativeCandidateResult,\n  SpeculativeOutput,\n} from \"./speculation.types.ts\";\nimport { taskUsage } from \"./task-usage.ts\";\n\nexport async function speculate<T = undefined>(\n  options: SpeculationOptions<T>,\n): Promise<SpeculationResult<T>> {\n  const { candidates } = options;\n  invariant(\n    candidates.length > 0 && candidates.length <= speculationLimits.candidates,\n    `Speculation requires 1 to ${speculationLimits.candidates} candidates`,\n  );\n  invariant(\n    new Set(candidates.map((candidate) => candidate.key)).size ===\n      candidates.length &&\n      candidates.every((candidate) =>\n        /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/.test(candidate.key),\n      ),\n    \"Speculative candidate keys must be unique simple names of 1 to 64 characters\",\n  );\n  const concurrency = options.concurrency ?? speculationLimits.concurrency;\n  invariant(\n    Number.isSafeInteger(concurrency) &&\n      concurrency > 0 &&\n      concurrency <= speculationLimits.candidates,\n    `Speculation concurrency must be 1 to ${speculationLimits.candidates}`,\n  );\n  const stop = new AbortController();\n  const signal = options.signal\n    ? AbortSignal.any([options.signal, stop.signal])\n    : stop.signal;\n  let budgetError: unknown;\n  const accounting = workflowAccounting(options.budget, (error) => {\n    budgetError = error;\n    // Attempt limits stop admissions; already admitted candidates may finish.\n    if (error.dimension !== \"attempts\") stop.abort(error);\n  });\n  const before = await speculativeHostSnapshot(options.repository);\n  const baseline = before.head;\n  const id = randomUUID();\n  const records: SpeculativeCandidateResult<T>[] = candidates.map(\n    (candidate) => ({\n      key: candidate.key,\n      branch: `outpost/speculation/${id}/${candidate.key}`,\n      status: \"skipped\",\n    }),\n  );\n  let winner: SpeculativeCandidateResult<T> | undefined;\n  let next = 0;\n  async function worker(): Promise<void> {\n    while (!signal.aborted && !winner && !accounting.exhausted) {\n      const index = next++;\n      const candidate = candidates[index];\n      if (!candidate) return;\n      try {\n        accounting.admit();\n      } catch {\n        return;\n      }\n      const initial = records[index]!;\n      let sandbox: Sandbox | undefined;\n      let result: SpeculativeOutput<T> | undefined;\n      let error: unknown;\n      let accepted = false;\n      let cleanupFailed = false;\n      let retainedDirectory: string | undefined;\n      const usage = taskUsage(\n        { reportUsage: (value) => accounting.report(value) },\n        candidate.request.observe,\n      );\n      try {\n        sandbox = await createSandbox({\n          ...options.sandbox,\n          repository: options.repository,\n          provider: options.provider,\n          branch: { mode: \"named\", name: initial.branch, from: baseline },\n          agent: candidate.agent,\n          signal,\n        });\n        signal.throwIfAborted();\n        invariant(\n          sandbox.workspace.baseline === baseline,\n          \"Speculative workspace does not match the pinned baseline\",\n        );\n        const {\n          resume: _resume,\n          fork: _fork,\n          ...output\n        } = await sandbox.dispatch({\n          ...candidate.request,\n          signal,\n          observe: usage.observe,\n        });\n        result = output;\n        usage.reconcile(output.usage);\n        signal.throwIfAborted();\n        accepted = await options.validate({\n          key: candidate.key,\n          result,\n          sandbox,\n          signal,\n        });\n        signal.throwIfAborted();\n      } catch (cause) {\n        error = cause;\n      }\n      if (sandbox) {\n        try {\n          const disposal = await sandbox.close({\n            preserve: error !== undefined,\n          });\n          retainedDirectory = disposal.retainedDirectory;\n        } catch (cause) {\n          cleanupFailed = true;\n          error =\n            error === undefined\n              ? cause\n              : new AggregateError(\n                  [error, cause],\n                  \"Speculative execution and cleanup failed\",\n                );\n          retainedDirectory = sandbox.workspace.directory;\n        }\n      }\n      const recovery = recoveryDetails(error);\n      const recoveredDirectory =\n        typeof recovery?.directory === \"string\"\n          ? recovery.directory\n          : undefined;\n      const directory = sandbox?.workspace.directory ?? recoveredDirectory;\n      retainedDirectory ??= recoveredDirectory;\n      function candidateStatus(): SpeculativeCandidateResult<T>[\"status\"] {\n        if (cleanupFailed) return \"failed\";\n        if (signal.aborted) return \"cancelled\";\n        if (error !== undefined) return \"failed\";\n        if (accepted && !winner) return \"winner\";\n        return \"rejected\";\n      }\n      const status = candidateStatus();\n      const record: SpeculativeCandidateResult<T> = {\n        ...initial,\n        status,\n        ...(directory ? { directory } : {}),\n        ...(retainedDirectory ? { retainedDirectory } : {}),\n        ...(result ? { result } : {}),\n        ...(error !== undefined ? { error } : {}),\n      };\n      records[index] = record;\n      if (status === \"winner\") {\n        winner = record;\n        stop.abort(\n          new Error(`Speculative candidate ${candidate.key} selected`),\n        );\n      }\n    }\n  }\n  await Promise.all(\n    Array.from({ length: Math.min(concurrency, candidates.length) }, worker),\n  );\n  function outcome(): SpeculationResult<T>[\"status\"] {\n    if (winner) return \"winner\";\n    if (options.signal?.aborted) return \"aborted\";\n    if (budgetError !== undefined) return \"budget-exhausted\";\n    return \"no-winner\";\n  }\n  const status = outcome();\n  const host = await speculativeHostSnapshot(options.repository).then(\n    (after) => ({\n      before,\n      after,\n      changed:\n        before.fingerprint !== after.fingerprint ||\n        before.branch !== after.branch,\n    }),\n    (error: unknown) => ({ before, changed: true, error }),\n  );\n  return {\n    id,\n    baseline,\n    host,\n    status,\n    candidates: records,\n    usage: accounting.snapshot(),\n    ...(winner ? { winner } : {}),\n    ...(budgetError !== undefined ? { error: budgetError } : {}),\n  };\n}\n"]}

package/dist/application/speculation.types.d.ts

@@ -0,0 +1,56 @@
+import type { AgentAdapter } from "../domain/agent.types.ts";
+import type { WorkflowBudget, WorkflowUsage } from "../domain/workflow/budget.types.ts";
+import type { DispatchOptions } from "./execution.types.ts";
+import type { Sandbox, SandboxOptions, WarmDispatchResult } from "./outpost.types.ts";
+export interface SpeculativeCandidate<T = undefined> {
+    readonly key: string;
+    readonly agent: AgentAdapter;
+    readonly request: Omit<DispatchOptions<T>, "agent" | "signal" | "continuation">;
+}
+export type SpeculativeOutput<T> = Omit<WarmDispatchResult<T>, "resume" | "fork">;
+export interface SpeculativeValidation<T> {
+    readonly key: string;
+    readonly result: SpeculativeOutput<T>;
+    readonly sandbox: Sandbox;
+    readonly signal: AbortSignal;
+}
+export interface SpeculationOptions<T = undefined> {
+    readonly repository: string;
+    readonly provider: NonNullable<SandboxOptions["provider"]>;
+    readonly candidates: readonly SpeculativeCandidate<T>[];
+    readonly concurrency?: number;
+    readonly budget: WorkflowBudget;
+    readonly signal?: AbortSignal;
+    readonly sandbox?: Pick<SandboxOptions, "hooks" | "bootstrap" | "logging" | "limits" | "storageQuota" | "conversationHome">;
+    readonly validate: (candidate: SpeculativeValidation<T>) => boolean | Promise<boolean>;
+}
+export interface SpeculativeCandidateResult<T = undefined> {
+    readonly key: string;
+    readonly branch: string;
+    readonly status: "winner" | "rejected" | "failed" | "cancelled" | "skipped";
+    readonly directory?: string;
+    readonly retainedDirectory?: string;
+    readonly result?: SpeculativeOutput<T>;
+    readonly error?: unknown;
+}
+export interface SpeculationResult<T = undefined> {
+    readonly id: string;
+    readonly baseline: string;
+    readonly host: {
+        readonly before: SpeculativeHostSnapshot;
+        readonly after?: SpeculativeHostSnapshot;
+        readonly changed: boolean;
+        readonly error?: unknown;
+    };
+    readonly status: "winner" | "no-winner" | "aborted" | "budget-exhausted";
+    readonly winner?: SpeculativeCandidateResult<T>;
+    readonly candidates: readonly SpeculativeCandidateResult<T>[];
+    readonly usage: WorkflowUsage;
+    readonly error?: unknown;
+}
+export interface SpeculativeHostSnapshot {
+    readonly head: string;
+    readonly branch: string;
+    readonly fingerprint: string;
+    readonly dirty: boolean;
+}

package/dist/application/speculation.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=speculation.types.js.map

package/dist/application/speculation.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speculation.types.js","sourceRoot":"","sources":["../../src/application/speculation.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { AgentAdapter } from \"../domain/agent.types.ts\";\nimport type {\n  WorkflowBudget,\n  WorkflowUsage,\n} from \"../domain/workflow/budget.types.ts\";\nimport type { DispatchOptions } from \"./execution.types.ts\";\nimport type {\n  Sandbox,\n  SandboxOptions,\n  WarmDispatchResult,\n} from \"./outpost.types.ts\";\n\nexport interface SpeculativeCandidate<T = undefined> {\n  readonly key: string;\n  readonly agent: AgentAdapter;\n  readonly request: Omit<\n    DispatchOptions<T>,\n    \"agent\" | \"signal\" | \"continuation\"\n  >;\n}\n\nexport type SpeculativeOutput<T> = Omit<\n  WarmDispatchResult<T>,\n  \"resume\" | \"fork\"\n>;\n\nexport interface SpeculativeValidation<T> {\n  readonly key: string;\n  readonly result: SpeculativeOutput<T>;\n  readonly sandbox: Sandbox;\n  readonly signal: AbortSignal;\n}\n\nexport interface SpeculationOptions<T = undefined> {\n  readonly repository: string;\n  readonly provider: NonNullable<SandboxOptions[\"provider\"]>;\n  readonly candidates: readonly SpeculativeCandidate<T>[];\n  readonly concurrency?: number;\n  readonly budget: WorkflowBudget;\n  readonly signal?: AbortSignal;\n  readonly sandbox?: Pick<\n    SandboxOptions,\n    | \"hooks\"\n    | \"bootstrap\"\n    | \"logging\"\n    | \"limits\"\n    | \"storageQuota\"\n    | \"conversationHome\"\n  >;\n  readonly validate: (\n    candidate: SpeculativeValidation<T>,\n  ) => boolean | Promise<boolean>;\n}\n\nexport interface SpeculativeCandidateResult<T = undefined> {\n  readonly key: string;\n  readonly branch: string;\n  readonly status: \"winner\" | \"rejected\" | \"failed\" | \"cancelled\" | \"skipped\";\n  readonly directory?: string;\n  readonly retainedDirectory?: string;\n  readonly result?: SpeculativeOutput<T>;\n  readonly error?: unknown;\n}\n\nexport interface SpeculationResult<T = undefined> {\n  readonly id: string;\n  readonly baseline: string;\n  readonly host: {\n    readonly before: SpeculativeHostSnapshot;\n    readonly after?: SpeculativeHostSnapshot;\n    readonly changed: boolean;\n    readonly error?: unknown;\n  };\n  readonly status: \"winner\" | \"no-winner\" | \"aborted\" | \"budget-exhausted\";\n  readonly winner?: SpeculativeCandidateResult<T>;\n  readonly candidates: readonly SpeculativeCandidateResult<T>[];\n  readonly usage: WorkflowUsage;\n  readonly error?: unknown;\n}\n\nexport interface SpeculativeHostSnapshot {\n  readonly head: string;\n  readonly branch: string;\n  readonly fingerprint: string;\n  readonly dirty: boolean;\n}\n"]}

package/dist/application/storage-reservation.d.ts

@@ -0,0 +1,3 @@
+import type { StorageReservation } from "../infrastructure/storage-reservations.types.ts";
+import type { RecoveryStorageReservationOptions } from "./storage-reservation.types.ts";
+export declare function reserveRecoveryStorage(options: RecoveryStorageReservationOptions): Promise<StorageReservation>;

package/dist/application/storage-reservation.js

@@ -0,0 +1,10 @@
+import { directory } from "../infrastructure/files.js";
+import { git } from "../infrastructure/git/command.js";
+import { reserveStorage } from "../infrastructure/storage-reservations.js";
+export async function reserveRecoveryStorage(options) {
+    options.signal?.throwIfAborted();
+    const requested = await directory(options.repository);
+    const root = await directory((await git(requested, ["rev-parse", "--show-toplevel"])).trim());
+    return reserveStorage(root, options);
+}
+//# sourceMappingURL=storage-reservation.js.map

package/dist/application/storage-reservation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-reservation.js","sourceRoot":"","sources":["../../src/application/storage-reservation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,GAAG,EAAE,MAAM,kCAAkC,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAI3E,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAA0C;IAE1C,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,MAAM,SAAS,CAC1B,CAAC,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAChE,CAAC;IACF,OAAO,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC","sourcesContent":["import { directory } from \"../infrastructure/files.ts\";\nimport { git } from \"../infrastructure/git/command.ts\";\nimport { reserveStorage } from \"../infrastructure/storage-reservations.ts\";\nimport type { StorageReservation } from \"../infrastructure/storage-reservations.types.ts\";\nimport type { RecoveryStorageReservationOptions } from \"./storage-reservation.types.ts\";\n\nexport async function reserveRecoveryStorage(\n  options: RecoveryStorageReservationOptions,\n): Promise<StorageReservation> {\n  options.signal?.throwIfAborted();\n  const requested = await directory(options.repository);\n  const root = await directory(\n    (await git(requested, [\"rev-parse\", \"--show-toplevel\"])).trim(),\n  );\n  return reserveStorage(root, options);\n}\n"]}

package/dist/application/storage-reservation.types.d.ts

@@ -0,0 +1,4 @@
+import type { StorageReservationOptions } from "../infrastructure/storage-reservations.types.ts";
+export interface RecoveryStorageReservationOptions extends StorageReservationOptions {
+    readonly repository?: string;
+}

package/dist/application/storage-reservation.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=storage-reservation.types.js.map

package/dist/application/storage-reservation.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-reservation.types.js","sourceRoot":"","sources":["../../src/application/storage-reservation.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { StorageReservationOptions } from \"../infrastructure/storage-reservations.types.ts\";\n\nexport interface RecoveryStorageReservationOptions extends StorageReservationOptions {\n  readonly repository?: string;\n}\n"]}

package/dist/application/task-usage.d.ts

@@ -1,4 +1,4 @@
 import type { AgentObservation } from "../domain/agent.types.ts";
 import type { TaskContext } from "../domain/workflow.types.ts";
 import type { TaskUsageObserver } from "./task-usage.types.ts";
-export declare function taskUsage(context: TaskContext, observer: ((event: AgentObservation) => void) | undefined): TaskUsageObserver;
+export declare function taskUsage(context: Pick<TaskContext, "reportUsage">, observer: ((event: AgentObservation) => void) | undefined): TaskUsageObserver;

package/dist/application/task-usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-usage.js","sourceRoot":"","sources":["../../src/application/task-usage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1C,MAAM,UAAU,SAAS,CACvB,OAAoB,EACpB,QAAyD;IAEzD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;IACxC,IAAI,KAAK,GAAU,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACtD,SAAS,UAAU,CAAC,IAAW,EAAE,QAAe;QAC9C,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;YAC/C,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YAClD,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YAClD,YAAY,EAAE,IAAI,CAAC,GAAG,CACpB,CAAC,EACD,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,IAAI,CAAC,CAAC,CACxD;SACF,CAAC;IACJ,CAAC;IACD,SAAS,MAAM,CAAC,KAAY;QAC1B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC;YAAE,OAAO;QAC7D,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC/B,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO;QACL,OAAO,CAAC,KAAK;YACX,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI;oBACzC,KAAK,EAAE,CAAC;oBACR,MAAM,EAAE,CAAC;oBACT,MAAM,EAAE,CAAC;iBACV,CAAC;gBACF,MAAM,KAAK,GACT,KAAK,CAAC,IAAI,KAAK,OAAO;oBACpB,CAAC,CAAC,KAAK,CAAC,MAAM;oBACd,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACzC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;gBAClD,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;YACD,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,SAAS,CAAC,KAAK;YACb,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { AgentObservation, Usage } from \"../domain/agent.types.ts\";\nimport { addUsage } from \"../domain/usage.ts\";\nimport type { TaskContext } from \"../domain/workflow.types.ts\";\nimport { notify } from \"./observation.ts\";\nimport type { TaskUsageObserver } from \"./task-usage.types.ts\";\n\nexport function taskUsage(\n  context: TaskContext,\n  observer: ((event: AgentObservation) => void) | undefined,\n): TaskUsageObserver {\n  const passes = new Map<number, Usage>();\n  let total: Usage = { input: 0, cached: 0, output: 0 };\n  function difference(next: Usage, previous: Usage): Usage {\n    return {\n      input: Math.max(0, next.input - previous.input),\n      cached: Math.max(0, next.cached - previous.cached),\n      output: Math.max(0, next.output - previous.output),\n      cacheCreated: Math.max(\n        0,\n        (next.cacheCreated ?? 0) - (previous.cacheCreated ?? 0),\n      ),\n    };\n  }\n  function report(usage: Usage): void {\n    if (!Object.values(usage).some((value) => value > 0)) return;\n    total = addUsage(total, usage);\n    context.reportUsage(usage);\n  }\n  return {\n    observe(event) {\n      if (event.kind === \"usage\" || event.kind === \"summary\") {\n        const previous = passes.get(event.pass) ?? {\n          input: 0,\n          cached: 0,\n          output: 0,\n        };\n        const delta =\n          event.kind === \"usage\"\n            ? event.tokens\n            : difference(event.tokens, previous);\n        passes.set(event.pass, addUsage(previous, delta));\n        report(delta);\n      }\n      notify(observer, event);\n    },\n    reconcile(usage) {\n      report(difference(usage, total));\n    },\n  };\n}\n"]}
+{"version":3,"file":"task-usage.js","sourceRoot":"","sources":["../../src/application/task-usage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1C,MAAM,UAAU,SAAS,CACvB,OAAyC,EACzC,QAAyD;IAEzD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;IACxC,IAAI,KAAK,GAAU,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACtD,SAAS,UAAU,CAAC,IAAW,EAAE,QAAe;QAC9C,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;YAC/C,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YAClD,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YAClD,YAAY,EAAE,IAAI,CAAC,GAAG,CACpB,CAAC,EACD,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,IAAI,CAAC,CAAC,CACxD;SACF,CAAC;IACJ,CAAC;IACD,SAAS,MAAM,CAAC,KAAY;QAC1B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC;YAAE,OAAO;QAC7D,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC/B,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO;QACL,OAAO,CAAC,KAAK;YACX,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI;oBACzC,KAAK,EAAE,CAAC;oBACR,MAAM,EAAE,CAAC;oBACT,MAAM,EAAE,CAAC;iBACV,CAAC;gBACF,MAAM,KAAK,GACT,KAAK,CAAC,IAAI,KAAK,OAAO;oBACpB,CAAC,CAAC,KAAK,CAAC,MAAM;oBACd,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACzC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;gBAClD,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;YACD,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,SAAS,CAAC,KAAK;YACb,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { AgentObservation, Usage } from \"../domain/agent.types.ts\";\nimport { addUsage } from \"../domain/usage.ts\";\nimport type { TaskContext } from \"../domain/workflow.types.ts\";\nimport { notify } from \"./observation.ts\";\nimport type { TaskUsageObserver } from \"./task-usage.types.ts\";\n\nexport function taskUsage(\n  context: Pick<TaskContext, \"reportUsage\">,\n  observer: ((event: AgentObservation) => void) | undefined,\n): TaskUsageObserver {\n  const passes = new Map<number, Usage>();\n  let total: Usage = { input: 0, cached: 0, output: 0 };\n  function difference(next: Usage, previous: Usage): Usage {\n    return {\n      input: Math.max(0, next.input - previous.input),\n      cached: Math.max(0, next.cached - previous.cached),\n      output: Math.max(0, next.output - previous.output),\n      cacheCreated: Math.max(\n        0,\n        (next.cacheCreated ?? 0) - (previous.cacheCreated ?? 0),\n      ),\n    };\n  }\n  function report(usage: Usage): void {\n    if (!Object.values(usage).some((value) => value > 0)) return;\n    total = addUsage(total, usage);\n    context.reportUsage(usage);\n  }\n  return {\n    observe(event) {\n      if (event.kind === \"usage\" || event.kind === \"summary\") {\n        const previous = passes.get(event.pass) ?? {\n          input: 0,\n          cached: 0,\n          output: 0,\n        };\n        const delta =\n          event.kind === \"usage\"\n            ? event.tokens\n            : difference(event.tokens, previous);\n        passes.set(event.pass, addUsage(previous, delta));\n        report(delta);\n      }\n      notify(observer, event);\n    },\n    reconcile(usage) {\n      report(difference(usage, total));\n    },\n  };\n}\n"]}

package/dist/application/tasks.js

@@ -24,7 +24,7 @@ export function isolatedTask(options) {
     return task({
         ...definition,
         async perform(context) {
-            const options = request(context);
+            const options = await request(context);
             const usage = taskUsage(context, options.observe);
             const result = await dispatch({
                 ...options,