@aigne/agent-runtime 1.12.0-beta.5

package/dist/agent-runners/orchestrator-runner.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-runner.mjs","names":[],"sources":["../../src/agent-runners/orchestrator-runner.ts"],"sourcesContent":["import type { AFSExecResult, AFSRoot } from \"@aigne/afs\";\nimport { parseAgentManifest, resolveMemberPath } from \"@aigne/afs\";\nimport { joinURL } from \"ufo\";\nimport { getRunnerForType, type RunnerContext } from \"../program/agent-runner-registry.js\";\nimport {\n  type AgentScope,\n  ensureScopeWithMounts,\n  normalizeManifestTools,\n  projectForChild,\n  resolveParentAgentScope,\n  runnerSession,\n} from \"../program/scoped-afs.js\";\nimport {\n  createInitialState,\n  deserializeState,\n  serializeState,\n  truncateHistory,\n} from \"./orchestrator-state.js\";\nimport { SCRATCH_SCOPE_ROOT } from \"./scratchpad-afs.js\";\n\nexport interface OrchestratorRunnerResult {\n  success: boolean;\n  data?: Record<string, unknown>;\n  result?: Record<string, unknown>;\n  error?: { code: string; message: string };\n  _meta?: {\n    iterations: number;\n    sub_runs: number;\n    max_iterations_hit?: boolean;\n    truncated?: number;\n    keep_recent?: number;\n  };\n}\n\ninterface PlannerOutput {\n  finished?: boolean;\n  nextTasks?: Array<{ description: string; input?: Record<string, unknown> }>;\n  parallelTasks?: boolean;\n}\n\nconst MAX_ITERATIONS_CEILING = 30;\nconst DEFAULT_KEEP_RECENT = 20;\nconst DEFAULT_MAX_TOKENS = 100_000;\n\nfunction extractPlannerOutput(raw: unknown): PlannerOutput | null {\n  if (!raw || typeof raw !== \"object\") return null;\n  const obj = raw as Record<string, unknown>;\n\n  const candidates = [obj, (obj as any).data?.result, (obj as any).result, (obj as any).data];\n  for (const c of candidates) {\n    if (!c) continue;\n    let parsed = c;\n    if (typeof parsed === \"string\") {\n      try {\n        parsed = JSON.parse(parsed);\n      } catch {\n        continue;\n      }\n    }\n    if (typeof (parsed as any)?.reply === \"string\") {\n      try {\n        parsed = JSON.parse((parsed as any).reply);\n      } catch {\n        continue;\n      }\n    }\n    if (parsed && typeof parsed === \"object\" && (\"finished\" in parsed || \"nextTasks\" in parsed)) {\n      return parsed as PlannerOutput;\n    }\n  }\n  return null;\n}\n\nfunction extractResult(raw: unknown): unknown {\n  if (!raw || typeof raw !== \"object\") return raw;\n  const obj = raw as any;\n  return obj.data?.result ?? obj.result ?? obj.data ?? obj;\n}\n\nasync function renderObjective(\n  template: string,\n  input: Record<string, unknown>,\n  manifest: { name: string; type: string },\n  mountPath: string,\n  afs: unknown,\n): Promise<string> {\n  try {\n    const mod = await import(\"@aigne/ash/src/prompt/template.js\");\n    return await mod.renderTemplate(\n      template,\n      { $input: input, $manifest: manifest, $now: new Date().toISOString() },\n      { blockletRoot: mountPath, afs: afs as any },\n    );\n  } catch {\n    return template;\n  }\n}\n\nfunction metaResult(\n  iterations: number,\n  subRuns: number,\n  maxHit?: boolean,\n): OrchestratorRunnerResult[\"_meta\"] {\n  return {\n    iterations,\n    sub_runs: subRuns,\n    max_iterations_hit: maxHit || undefined,\n  };\n}\n\nasync function dispatchSubAgent(\n  context: RunnerContext,\n  memberPath: string,\n  input: Record<string, unknown>,\n  session: string | undefined,\n  parentScope: AgentScope,\n): Promise<AFSExecResult> {\n  const runtimeMemberPath = resolveMemberPath(memberPath);\n  const agentYmlPath = joinURL(runtimeMemberPath, \"agent.yml\");\n\n  const read = await context.afs.read!(agentYmlPath);\n  const content = String((read as any)?.data?.content ?? \"\");\n  const subManifest = parseAgentManifest(content);\n\n  const subAfs = projectForChild(parentScope, {\n    memberPath,\n    childManifest: subManifest,\n    session,\n  });\n\n  const subContext: RunnerContext = {\n    afs: subAfs as unknown as AFSRoot,\n    mountPath: \"/packages\",\n    manifest: subManifest,\n    session,\n    // Phase 5 — parentSession follows the parentScope's session (canonical\n    // source), not the legacy `context.session` field.\n    parentSession: parentScope.scope.session,\n    chain: context.chain,\n  };\n\n  // Bridge the caller's payload into the sub-agent's declared inputKey.\n  // Parent orchestrator wraps payloads under its own inputKey (e.g. \"question\"),\n  // but planner/worker/completer may each declare a different inputKey\n  // (\"state\", \"execution_state\", etc.). Without this remap, sub-agent's\n  // ai-runner reads `input[subInputKey]` → undefined → task=\"\" → ash\n  // agent-run throws \"requires 'task' parameter as string\". Mirrors the\n  // B15 bridge in team-runner.\n  const parentInputKey = context.manifest.inputKey ?? \"message\";\n  const subInputKey = subManifest.inputKey ?? \"message\";\n  const bridgedInput =\n    subInputKey !== parentInputKey && input[subInputKey] === undefined\n      ? bridgeInput(input, parentInputKey, subInputKey)\n      : input;\n\n  const runner = getRunnerForType(subManifest.type);\n  return runner(bridgedInput, subContext);\n}\n\nfunction bridgeInput(\n  input: Record<string, unknown>,\n  parentInputKey: string,\n  subInputKey: string,\n): Record<string, unknown> {\n  const taskValue = input[parentInputKey] ?? input.message ?? input.task ?? input.text;\n  if (taskValue === undefined) return input;\n  const { [parentInputKey]: _drop, ...rest } = input;\n  return { ...rest, [subInputKey]: taskValue };\n}\n\nexport async function runOrchestratorAgent(\n  input: Record<string, unknown>,\n  context: RunnerContext,\n): Promise<OrchestratorRunnerResult> {\n  const { manifest, mountPath } = context;\n  // Phase 5 — session id comes from scope first, legacy context only as\n  // fallback. Downstream sub-agent dispatch derives its own session ids\n  // (e.g. `${session}-planner-${i}`) off this resolved value.\n  const session = runnerSession(context.afs, context.session);\n  // Bootstrap a scope (+ /scratch/ mount) when the caller hasn't already\n  // wrapped its AFS. The orchestrator writes its own state.yml and hook\n  // events through `ctx.afs`, so every subsequent afs.* call must hit the\n  // scope-local scratch — not the legacy /modules/memory/runs tree.\n  const scopedAfs = ensureScopeWithMounts(context.afs, {\n    session: session ?? \"root\",\n    manifestTools: normalizeManifestTools(manifest),\n    scratchRetention: manifest.scratch ? \"session\" : \"run\",\n    budget: manifest.budget,\n  }) as unknown as AFSRoot;\n  const afs = scopedAfs;\n  // Subsequent dispatchSubAgent calls must use the scoped AFS so the\n  // orchestrator's view — and any child scope derived from it — starts\n  // from the scratch-mounted root rather than the caller's raw handle.\n  // Phase 5 — the scoped context must also carry the resolved session so\n  // that nested scope.sessions stay consistent across dispatch layers.\n  const scopedContext: RunnerContext = { ...context, afs: scopedAfs, session };\n  const inputKey = manifest.inputKey ?? \"message\";\n  const sm = manifest.stateManagement ?? {};\n  const maxIter = Math.min(sm.maxIterations ?? MAX_ITERATIONS_CEILING, MAX_ITERATIONS_CEILING);\n  const keepRecent = sm.keepRecent ?? DEFAULT_KEEP_RECENT;\n  const maxTokens = sm.maxTokens ?? DEFAULT_MAX_TOKENS;\n  const concurrency = Math.min(manifest.concurrency ?? 10, 10);\n\n  // B12: Runtime AFS projects the blocklet directory at /packages; the\n  // external mountPath isn't a valid internal path after activation. Try\n  // mountPath first (works in tests + pre-activation), fall back to\n  // /packages (production post-activation).\n  const objFile = manifest.objective ?? \"objective.md\";\n  const objCandidates = [joinURL(mountPath, objFile), joinURL(\"/packages\", objFile)];\n  let objective: string | undefined;\n  let lastObjPath = objCandidates[0]!;\n  for (const candidate of objCandidates) {\n    lastObjPath = candidate;\n    try {\n      const raw = await afs.read!(candidate);\n      const content =\n        typeof raw === \"string\"\n          ? raw\n          : String((raw as any)?.data?.content ?? (raw as any)?.data ?? raw ?? \"\");\n      if (content) {\n        objective = content;\n        break;\n      }\n    } catch {\n      // Try next candidate\n    }\n  }\n  if (!objective) {\n    return {\n      success: false,\n      error: { code: \"OBJECTIVE_NOT_FOUND\", message: `Cannot read objective at ${lastObjPath}` },\n    };\n  }\n\n  objective = await renderObjective(\n    objective,\n    input,\n    { name: manifest.name, type: manifest.type },\n    mountPath,\n    afs,\n  );\n\n  // Phase 2 — state persists at the scope-local /scratch/state.yml; the\n  // scratch overlay routes the read/write to the in-memory provider that\n  // `ensureScopeWithMounts` attached above. `session` still gates *whether*\n  // to persist (tests bypass state when session is undefined).\n  const statePath = session ? joinURL(SCRATCH_SCOPE_ROOT, \"state.yml\") : null;\n  let state = createInitialState(objective);\n  if (statePath) {\n    try {\n      const raw = await afs.read!(statePath);\n      const content =\n        typeof raw === \"string\" ? raw : String((raw as any)?.data?.content ?? raw ?? \"\");\n      const loaded = deserializeState(content);\n      if (loaded) state = loaded;\n    } catch {\n      /* fresh start */\n    }\n  }\n\n  const parentScopeForSubs = resolveParentAgentScope({\n    afs: scopedAfs,\n    manifest,\n    session,\n  });\n\n  let subRuns = 0;\n  const plannerPath = manifest.planner?.path ?? null;\n  const workerPath = manifest.worker?.path ?? null;\n  const completerPath = manifest.completer?.path ?? null;\n  let lastPlanKey = \"\";\n\n  for (let i = state.iterations; i < maxIter; i++) {\n    state.iterations = i + 1;\n    state = truncateHistory(state, maxTokens, keepRecent);\n\n    let plan: PlannerOutput;\n    if (plannerPath) {\n      try {\n        const raw = await dispatchSubAgent(\n          scopedContext,\n          plannerPath,\n          {\n            [inputKey]: JSON.stringify({\n              objective: state.objective,\n              history: state.history,\n              iteration: i,\n              summaries: state.summaries,\n            }),\n          },\n          session ? `${session}-planner-${i}` : undefined,\n          parentScopeForSubs,\n        );\n        const parsed = extractPlannerOutput(raw);\n        if (!parsed) {\n          return {\n            success: false,\n            error: {\n              code: \"PLANNER_OUTPUT_INVALID\",\n              message: \"Planner must return 'finished' or 'nextTasks'\",\n            },\n            _meta: metaResult(state.iterations, subRuns),\n          };\n        }\n        plan = parsed;\n      } catch (e: any) {\n        return {\n          success: false,\n          error: { code: \"PLANNER_ERROR\", message: e.message ?? String(e) },\n          _meta: metaResult(state.iterations, subRuns),\n        };\n      }\n    } else {\n      plan =\n        state.history.length > 0\n          ? { finished: true }\n          : { nextTasks: [{ description: String(input[inputKey] ?? state.objective) }] };\n    }\n\n    if (plan.finished) break;\n\n    if (!plan.nextTasks?.length) {\n      return {\n        success: false,\n        error: {\n          code: \"PLANNER_OUTPUT_INVALID\",\n          message: \"Planner must return 'finished' or 'nextTasks'\",\n        },\n        _meta: metaResult(state.iterations, subRuns),\n      };\n    }\n\n    const planKey = JSON.stringify(plan.nextTasks.map((t) => t.description).sort());\n    if (planKey === lastPlanKey) {\n      return {\n        success: false,\n        error: {\n          code: \"CIRCULAR_PLANNER\",\n          message: \"Planner is scheduling the same tasks repeatedly\",\n        },\n        _meta: metaResult(state.iterations, subRuns),\n      };\n    }\n    lastPlanKey = planKey;\n\n    const tasks = plan.nextTasks;\n    const runWorker = async (task: (typeof tasks)[0]) => {\n      subRuns++;\n      if (!workerPath) {\n        return { description: task.description, result: null, error: \"NO_WORKER\" };\n      }\n      try {\n        const raw = await dispatchSubAgent(\n          scopedContext,\n          workerPath,\n          {\n            ...(task.input ?? {}),\n            [inputKey]: task.description,\n          },\n          session ? `${session}-w-${subRuns}` : undefined,\n          parentScopeForSubs,\n        );\n        return { description: task.description, result: extractResult(raw) };\n      } catch (e: any) {\n        return { description: task.description, result: null, error: e.message ?? String(e) };\n      }\n    };\n\n    if (plan.parallelTasks && tasks.length > 1) {\n      for (let j = 0; j < tasks.length; j += concurrency) {\n        const batch = tasks.slice(j, j + concurrency);\n        const results = await Promise.all(batch.map(runWorker));\n        for (const r of results) {\n          state.history.push({\n            iteration: i,\n            description: r.description,\n            result: r.result,\n            error: r.error,\n            ts: new Date().toISOString(),\n          });\n        }\n      }\n    } else {\n      for (const task of tasks) {\n        const r = await runWorker(task);\n        state.history.push({\n          iteration: i,\n          description: r.description,\n          result: r.result,\n          error: r.error,\n          ts: new Date().toISOString(),\n        });\n      }\n    }\n\n    if (statePath) {\n      try {\n        await afs.write!(statePath, { content: serializeState(state, keepRecent) } as any);\n      } catch {\n        /* best effort */\n      }\n    }\n  }\n\n  const maxHit = state.iterations >= maxIter;\n\n  let finalResult: unknown;\n  if (completerPath) {\n    try {\n      const raw = await dispatchSubAgent(\n        scopedContext,\n        completerPath,\n        {\n          [inputKey]: JSON.stringify({\n            objective: state.objective,\n            history: state.history,\n            iterations: state.iterations,\n            max_iterations_hit: maxHit,\n          }),\n        },\n        session ? `${session}-completer` : undefined,\n        parentScopeForSubs,\n      );\n      finalResult = extractResult(raw);\n    } catch (e: any) {\n      return {\n        success: false,\n        error: { code: \"COMPLETER_ERROR\", message: e.message ?? String(e) },\n        _meta: {\n          iterations: state.iterations,\n          sub_runs: subRuns,\n          max_iterations_hit: maxHit || undefined,\n          keep_recent: keepRecent,\n        },\n      };\n    }\n  } else {\n    const last = state.history[state.history.length - 1];\n    finalResult = last?.result ?? null;\n  }\n\n  if (statePath) {\n    try {\n      await afs.write!(statePath, { content: serializeState(state, keepRecent) } as any);\n    } catch {\n      /* best effort */\n    }\n  }\n\n  const result: OrchestratorRunnerResult = {\n    success: true,\n    data: { result: finalResult },\n    _meta: {\n      iterations: state.iterations,\n      sub_runs: subRuns,\n      max_iterations_hit: maxHit || undefined,\n      truncated: state.truncated || undefined,\n      keep_recent: keepRecent,\n    },\n  };\n\n  if (manifest.outputKey && finalResult != null) {\n    result.result = { [manifest.outputKey]: finalResult };\n  }\n\n  return result;\n}\n"],"mappings":"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"}

package/dist/agent-runners/orchestrator-state.cjs

@@ -0,0 +1,68 @@
+let js_yaml = require("js-yaml");
+
+//#region src/agent-runners/orchestrator-state.ts
+function createInitialState(objective) {
+	return {
+		objective,
+		iterations: 0,
+		history: [],
+		truncated: 0,
+		summaries: []
+	};
+}
+function estimateTokens(value) {
+	const text = typeof value === "string" ? value : JSON.stringify(value ?? "");
+	return Math.max(1, Math.ceil(text.length / 4));
+}
+function truncateHistory(state, maxTokens, keepRecent) {
+	if (state.history.length <= keepRecent) return state;
+	if (estimateTokens(state.history) <= maxTokens) return state;
+	const history = [...state.history];
+	const summaries = [...state.summaries];
+	let { truncated } = state;
+	while (history.length > keepRecent && estimateTokens(history) > maxTokens) {
+		const removed = history.shift();
+		truncated++;
+		summaries.push(`[iter ${removed.iteration}] ${removed.description}: ${removed.error ?? "ok"}`);
+	}
+	return {
+		...state,
+		history,
+		truncated,
+		summaries
+	};
+}
+function serializeState(state, keepRecent) {
+	const output = {
+		objective: state.objective,
+		iterations: state.iterations,
+		history: state.history,
+		truncated: state.truncated
+	};
+	if (keepRecent !== void 0) output.keep_recent = keepRecent;
+	if (state.summaries.length > 0) output.summaries = state.summaries;
+	return (0, js_yaml.dump)(output);
+}
+function deserializeState(yaml) {
+	if (!yaml.trim()) return null;
+	try {
+		const raw = (0, js_yaml.load)(yaml);
+		if (!raw || typeof raw !== "object") return null;
+		return {
+			objective: String(raw.objective ?? ""),
+			iterations: Number(raw.iterations ?? 0),
+			history: Array.isArray(raw.history) ? raw.history : [],
+			truncated: Number(raw.truncated ?? 0),
+			summaries: Array.isArray(raw.summaries) ? raw.summaries : []
+		};
+	} catch {
+		return null;
+	}
+}
+
+//#endregion
+exports.createInitialState = createInitialState;
+exports.deserializeState = deserializeState;
+exports.estimateTokens = estimateTokens;
+exports.serializeState = serializeState;
+exports.truncateHistory = truncateHistory;

package/dist/agent-runners/orchestrator-state.d.cts

@@ -0,0 +1,23 @@
+//#region src/agent-runners/orchestrator-state.d.ts
+interface TaskResult {
+  iteration: number;
+  description: string;
+  result: unknown;
+  error?: string;
+  ts: string;
+}
+interface OrchestratorState {
+  objective: string;
+  iterations: number;
+  history: TaskResult[];
+  truncated: number;
+  summaries: string[];
+}
+declare function createInitialState(objective: string): OrchestratorState;
+declare function estimateTokens(value: unknown): number;
+declare function truncateHistory(state: OrchestratorState, maxTokens: number, keepRecent: number): OrchestratorState;
+declare function serializeState(state: OrchestratorState, keepRecent?: number): string;
+declare function deserializeState(yaml: string): OrchestratorState | null;
+//#endregion
+export { OrchestratorState, TaskResult, createInitialState, deserializeState, estimateTokens, serializeState, truncateHistory };
+//# sourceMappingURL=orchestrator-state.d.cts.map

package/dist/agent-runners/orchestrator-state.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-state.d.cts","names":[],"sources":["../../src/agent-runners/orchestrator-state.ts"],"mappings":";UAEiB,UAAA;EACf,SAAA;EACA,WAAA;EACA,MAAA;EACA,KAAA;EACA,EAAA;AAAA;AAAA,UAGe,iBAAA;EACf,SAAA;EACA,UAAA;EACA,OAAA,EAAS,UAAA;EACT,SAAA;EACA,SAAA;AAAA;AAAA,iBAGc,kBAAA,CAAmB,SAAA,WAAoB,iBAAA;AAAA,iBAIvC,cAAA,CAAe,KAAA;AAAA,iBAKf,eAAA,CACd,KAAA,EAAO,iBAAA,EACP,SAAA,UACA,UAAA,WACC,iBAAA;AAAA,iBAiBa,cAAA,CAAe,KAAA,EAAO,iBAAA,EAAmB,UAAA;AAAA,iBAYzC,gBAAA,CAAiB,IAAA,WAAe,iBAAA"}

package/dist/agent-runners/orchestrator-state.d.mts

@@ -0,0 +1,23 @@
+//#region src/agent-runners/orchestrator-state.d.ts
+interface TaskResult {
+  iteration: number;
+  description: string;
+  result: unknown;
+  error?: string;
+  ts: string;
+}
+interface OrchestratorState {
+  objective: string;
+  iterations: number;
+  history: TaskResult[];
+  truncated: number;
+  summaries: string[];
+}
+declare function createInitialState(objective: string): OrchestratorState;
+declare function estimateTokens(value: unknown): number;
+declare function truncateHistory(state: OrchestratorState, maxTokens: number, keepRecent: number): OrchestratorState;
+declare function serializeState(state: OrchestratorState, keepRecent?: number): string;
+declare function deserializeState(yaml: string): OrchestratorState | null;
+//#endregion
+export { OrchestratorState, TaskResult, createInitialState, deserializeState, estimateTokens, serializeState, truncateHistory };
+//# sourceMappingURL=orchestrator-state.d.mts.map

package/dist/agent-runners/orchestrator-state.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-state.d.mts","names":[],"sources":["../../src/agent-runners/orchestrator-state.ts"],"mappings":";UAEiB,UAAA;EACf,SAAA;EACA,WAAA;EACA,MAAA;EACA,KAAA;EACA,EAAA;AAAA;AAAA,UAGe,iBAAA;EACf,SAAA;EACA,UAAA;EACA,OAAA,EAAS,UAAA;EACT,SAAA;EACA,SAAA;AAAA;AAAA,iBAGc,kBAAA,CAAmB,SAAA,WAAoB,iBAAA;AAAA,iBAIvC,cAAA,CAAe,KAAA;AAAA,iBAKf,eAAA,CACd,KAAA,EAAO,iBAAA,EACP,SAAA,UACA,UAAA,WACC,iBAAA;AAAA,iBAiBa,cAAA,CAAe,KAAA,EAAO,iBAAA,EAAmB,UAAA;AAAA,iBAYzC,gBAAA,CAAiB,IAAA,WAAe,iBAAA"}

package/dist/agent-runners/orchestrator-state.mjs

@@ -0,0 +1,65 @@
+import { dump, load } from "js-yaml";
+
+//#region src/agent-runners/orchestrator-state.ts
+function createInitialState(objective) {
+	return {
+		objective,
+		iterations: 0,
+		history: [],
+		truncated: 0,
+		summaries: []
+	};
+}
+function estimateTokens(value) {
+	const text = typeof value === "string" ? value : JSON.stringify(value ?? "");
+	return Math.max(1, Math.ceil(text.length / 4));
+}
+function truncateHistory(state, maxTokens, keepRecent) {
+	if (state.history.length <= keepRecent) return state;
+	if (estimateTokens(state.history) <= maxTokens) return state;
+	const history = [...state.history];
+	const summaries = [...state.summaries];
+	let { truncated } = state;
+	while (history.length > keepRecent && estimateTokens(history) > maxTokens) {
+		const removed = history.shift();
+		truncated++;
+		summaries.push(`[iter ${removed.iteration}] ${removed.description}: ${removed.error ?? "ok"}`);
+	}
+	return {
+		...state,
+		history,
+		truncated,
+		summaries
+	};
+}
+function serializeState(state, keepRecent) {
+	const output = {
+		objective: state.objective,
+		iterations: state.iterations,
+		history: state.history,
+		truncated: state.truncated
+	};
+	if (keepRecent !== void 0) output.keep_recent = keepRecent;
+	if (state.summaries.length > 0) output.summaries = state.summaries;
+	return dump(output);
+}
+function deserializeState(yaml) {
+	if (!yaml.trim()) return null;
+	try {
+		const raw = load(yaml);
+		if (!raw || typeof raw !== "object") return null;
+		return {
+			objective: String(raw.objective ?? ""),
+			iterations: Number(raw.iterations ?? 0),
+			history: Array.isArray(raw.history) ? raw.history : [],
+			truncated: Number(raw.truncated ?? 0),
+			summaries: Array.isArray(raw.summaries) ? raw.summaries : []
+		};
+	} catch {
+		return null;
+	}
+}
+
+//#endregion
+export { createInitialState, deserializeState, estimateTokens, serializeState, truncateHistory };
+//# sourceMappingURL=orchestrator-state.mjs.map

package/dist/agent-runners/orchestrator-state.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-state.mjs","names":["dumpYAML","parseYAML"],"sources":["../../src/agent-runners/orchestrator-state.ts"],"sourcesContent":["import { dump as dumpYAML, load as parseYAML } from \"js-yaml\";\n\nexport interface TaskResult {\n  iteration: number;\n  description: string;\n  result: unknown;\n  error?: string;\n  ts: string;\n}\n\nexport interface OrchestratorState {\n  objective: string;\n  iterations: number;\n  history: TaskResult[];\n  truncated: number;\n  summaries: string[];\n}\n\nexport function createInitialState(objective: string): OrchestratorState {\n  return { objective, iterations: 0, history: [], truncated: 0, summaries: [] };\n}\n\nexport function estimateTokens(value: unknown): number {\n  const text = typeof value === \"string\" ? value : JSON.stringify(value ?? \"\");\n  return Math.max(1, Math.ceil(text.length / 4));\n}\n\nexport function truncateHistory(\n  state: OrchestratorState,\n  maxTokens: number,\n  keepRecent: number,\n): OrchestratorState {\n  if (state.history.length <= keepRecent) return state;\n  if (estimateTokens(state.history) <= maxTokens) return state;\n\n  const history = [...state.history];\n  const summaries = [...state.summaries];\n  let { truncated } = state;\n\n  while (history.length > keepRecent && estimateTokens(history) > maxTokens) {\n    const removed = history.shift()!;\n    truncated++;\n    summaries.push(`[iter ${removed.iteration}] ${removed.description}: ${removed.error ?? \"ok\"}`);\n  }\n\n  return { ...state, history, truncated, summaries };\n}\n\nexport function serializeState(state: OrchestratorState, keepRecent?: number): string {\n  const output: Record<string, unknown> = {\n    objective: state.objective,\n    iterations: state.iterations,\n    history: state.history,\n    truncated: state.truncated,\n  };\n  if (keepRecent !== undefined) output.keep_recent = keepRecent;\n  if (state.summaries.length > 0) output.summaries = state.summaries;\n  return dumpYAML(output);\n}\n\nexport function deserializeState(yaml: string): OrchestratorState | null {\n  if (!yaml.trim()) return null;\n  try {\n    const raw = parseYAML(yaml) as Record<string, unknown>;\n    if (!raw || typeof raw !== \"object\") return null;\n    return {\n      objective: String(raw.objective ?? \"\"),\n      iterations: Number(raw.iterations ?? 0),\n      history: Array.isArray(raw.history) ? raw.history : [],\n      truncated: Number(raw.truncated ?? 0),\n      summaries: Array.isArray(raw.summaries) ? raw.summaries : [],\n    };\n  } catch {\n    return null;\n  }\n}\n"],"mappings":";;;AAkBA,SAAgB,mBAAmB,WAAsC;AACvE,QAAO;EAAE;EAAW,YAAY;EAAG,SAAS,EAAE;EAAE,WAAW;EAAG,WAAW,EAAE;EAAE;;AAG/E,SAAgB,eAAe,OAAwB;CACrD,MAAM,OAAO,OAAO,UAAU,WAAW,QAAQ,KAAK,UAAU,SAAS,GAAG;AAC5E,QAAO,KAAK,IAAI,GAAG,KAAK,KAAK,KAAK,SAAS,EAAE,CAAC;;AAGhD,SAAgB,gBACd,OACA,WACA,YACmB;AACnB,KAAI,MAAM,QAAQ,UAAU,WAAY,QAAO;AAC/C,KAAI,eAAe,MAAM,QAAQ,IAAI,UAAW,QAAO;CAEvD,MAAM,UAAU,CAAC,GAAG,MAAM,QAAQ;CAClC,MAAM,YAAY,CAAC,GAAG,MAAM,UAAU;CACtC,IAAI,EAAE,cAAc;AAEpB,QAAO,QAAQ,SAAS,cAAc,eAAe,QAAQ,GAAG,WAAW;EACzE,MAAM,UAAU,QAAQ,OAAO;AAC/B;AACA,YAAU,KAAK,SAAS,QAAQ,UAAU,IAAI,QAAQ,YAAY,IAAI,QAAQ,SAAS,OAAO;;AAGhG,QAAO;EAAE,GAAG;EAAO;EAAS;EAAW;EAAW;;AAGpD,SAAgB,eAAe,OAA0B,YAA6B;CACpF,MAAM,SAAkC;EACtC,WAAW,MAAM;EACjB,YAAY,MAAM;EAClB,SAAS,MAAM;EACf,WAAW,MAAM;EAClB;AACD,KAAI,eAAe,OAAW,QAAO,cAAc;AACnD,KAAI,MAAM,UAAU,SAAS,EAAG,QAAO,YAAY,MAAM;AACzD,QAAOA,KAAS,OAAO;;AAGzB,SAAgB,iBAAiB,MAAwC;AACvE,KAAI,CAAC,KAAK,MAAM,CAAE,QAAO;AACzB,KAAI;EACF,MAAM,MAAMC,KAAU,KAAK;AAC3B,MAAI,CAAC,OAAO,OAAO,QAAQ,SAAU,QAAO;AAC5C,SAAO;GACL,WAAW,OAAO,IAAI,aAAa,GAAG;GACtC,YAAY,OAAO,IAAI,cAAc,EAAE;GACvC,SAAS,MAAM,QAAQ,IAAI,QAAQ,GAAG,IAAI,UAAU,EAAE;GACtD,WAAW,OAAO,IAAI,aAAa,EAAE;GACrC,WAAW,MAAM,QAAQ,IAAI,UAAU,GAAG,IAAI,YAAY,EAAE;GAC7D;SACK;AACN,SAAO"}

package/dist/agent-runners/retry.cjs

@@ -0,0 +1,30 @@
+
+//#region src/agent-runners/retry.ts
+const defaultSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+async function withRetry(fn, config, shouldRetry, opts = {}) {
+	const maxAttempts = Math.max(0, config?.retries ?? 0) + 1;
+	const minTimeoutMs = config?.minTimeoutMs ?? 0;
+	const factor = config?.factor ?? 2;
+	const sleep = opts.sleep ?? defaultSleep;
+	let lastError;
+	let lastResult;
+	let hasResult = false;
+	for (let attempt = 0; attempt < maxAttempts; attempt++) {
+		try {
+			const result = await fn();
+			if (shouldRetry?.(result) && attempt < maxAttempts - 1) {
+				lastResult = result;
+				hasResult = true;
+			} else return result;
+		} catch (err) {
+			lastError = err;
+			if (attempt === maxAttempts - 1) throw err;
+		}
+		if (minTimeoutMs > 0 && attempt < maxAttempts - 1) await sleep(minTimeoutMs * factor ** attempt);
+	}
+	if (hasResult) return lastResult;
+	throw lastError;
+}
+
+//#endregion
+exports.withRetry = withRetry;

package/dist/agent-runners/retry.d.cts

@@ -0,0 +1,13 @@
+//#region src/agent-runners/retry.d.ts
+interface RetryConfig {
+  retries: number;
+  minTimeoutMs?: number;
+  factor?: number;
+}
+interface WithRetryOptions {
+  sleep?: (ms: number) => Promise<void>;
+}
+declare function withRetry<T>(fn: () => Promise<T>, config: RetryConfig | undefined, shouldRetry?: (result: T) => boolean, opts?: WithRetryOptions): Promise<T>;
+//#endregion
+export { RetryConfig, WithRetryOptions, withRetry };
+//# sourceMappingURL=retry.d.cts.map

package/dist/agent-runners/retry.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.cts","names":[],"sources":["../../src/agent-runners/retry.ts"],"mappings":";UAAiB,WAAA;EACf,OAAA;EACA,YAAA;EACA,MAAA;AAAA;AAAA,UAGe,gBAAA;EACf,KAAA,IAAS,EAAA,aAAe,OAAA;AAAA;AAAA,iBAMJ,SAAA,GAAA,CACpB,EAAA,QAAU,OAAA,CAAQ,CAAA,GAClB,MAAA,EAAQ,WAAA,cACR,WAAA,IAAe,MAAA,EAAQ,CAAA,cACvB,IAAA,GAAM,gBAAA,GACL,OAAA,CAAQ,CAAA"}

package/dist/agent-runners/retry.d.mts

@@ -0,0 +1,13 @@
+//#region src/agent-runners/retry.d.ts
+interface RetryConfig {
+  retries: number;
+  minTimeoutMs?: number;
+  factor?: number;
+}
+interface WithRetryOptions {
+  sleep?: (ms: number) => Promise<void>;
+}
+declare function withRetry<T>(fn: () => Promise<T>, config: RetryConfig | undefined, shouldRetry?: (result: T) => boolean, opts?: WithRetryOptions): Promise<T>;
+//#endregion
+export { RetryConfig, WithRetryOptions, withRetry };
+//# sourceMappingURL=retry.d.mts.map

package/dist/agent-runners/retry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.mts","names":[],"sources":["../../src/agent-runners/retry.ts"],"mappings":";UAAiB,WAAA;EACf,OAAA;EACA,YAAA;EACA,MAAA;AAAA;AAAA,UAGe,gBAAA;EACf,KAAA,IAAS,EAAA,aAAe,OAAA;AAAA;AAAA,iBAMJ,SAAA,GAAA,CACpB,EAAA,QAAU,OAAA,CAAQ,CAAA,GAClB,MAAA,EAAQ,WAAA,cACR,WAAA,IAAe,MAAA,EAAQ,CAAA,cACvB,IAAA,GAAM,gBAAA,GACL,OAAA,CAAQ,CAAA"}

package/dist/agent-runners/retry.mjs

@@ -0,0 +1,30 @@
+//#region src/agent-runners/retry.ts
+const defaultSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+async function withRetry(fn, config, shouldRetry, opts = {}) {
+	const maxAttempts = Math.max(0, config?.retries ?? 0) + 1;
+	const minTimeoutMs = config?.minTimeoutMs ?? 0;
+	const factor = config?.factor ?? 2;
+	const sleep = opts.sleep ?? defaultSleep;
+	let lastError;
+	let lastResult;
+	let hasResult = false;
+	for (let attempt = 0; attempt < maxAttempts; attempt++) {
+		try {
+			const result = await fn();
+			if (shouldRetry?.(result) && attempt < maxAttempts - 1) {
+				lastResult = result;
+				hasResult = true;
+			} else return result;
+		} catch (err) {
+			lastError = err;
+			if (attempt === maxAttempts - 1) throw err;
+		}
+		if (minTimeoutMs > 0 && attempt < maxAttempts - 1) await sleep(minTimeoutMs * factor ** attempt);
+	}
+	if (hasResult) return lastResult;
+	throw lastError;
+}
+
+//#endregion
+export { withRetry };
+//# sourceMappingURL=retry.mjs.map

package/dist/agent-runners/retry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.mjs","names":[],"sources":["../../src/agent-runners/retry.ts"],"sourcesContent":["export interface RetryConfig {\n  retries: number;\n  minTimeoutMs?: number;\n  factor?: number;\n}\n\nexport interface WithRetryOptions {\n  sleep?: (ms: number) => Promise<void>;\n}\n\nconst defaultSleep = (ms: number): Promise<void> =>\n  new Promise((resolve) => setTimeout(resolve, ms));\n\nexport async function withRetry<T>(\n  fn: () => Promise<T>,\n  config: RetryConfig | undefined,\n  shouldRetry?: (result: T) => boolean,\n  opts: WithRetryOptions = {},\n): Promise<T> {\n  const retries = Math.max(0, config?.retries ?? 0);\n  const maxAttempts = retries + 1;\n  const minTimeoutMs = config?.minTimeoutMs ?? 0;\n  const factor = config?.factor ?? 2;\n  const sleep = opts.sleep ?? defaultSleep;\n\n  let lastError: unknown;\n  let lastResult: T | undefined;\n  let hasResult = false;\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    try {\n      const result = await fn();\n      if (shouldRetry?.(result) && attempt < maxAttempts - 1) {\n        lastResult = result;\n        hasResult = true;\n      } else {\n        return result;\n      }\n    } catch (err) {\n      lastError = err;\n      if (attempt === maxAttempts - 1) throw err;\n    }\n\n    if (minTimeoutMs > 0 && attempt < maxAttempts - 1) {\n      const delay = minTimeoutMs * factor ** attempt;\n      await sleep(delay);\n    }\n  }\n\n  if (hasResult) return lastResult as T;\n  throw lastError;\n}\n"],"mappings":";AAUA,MAAM,gBAAgB,OACpB,IAAI,SAAS,YAAY,WAAW,SAAS,GAAG,CAAC;AAEnD,eAAsB,UACpB,IACA,QACA,aACA,OAAyB,EAAE,EACf;CAEZ,MAAM,cADU,KAAK,IAAI,GAAG,QAAQ,WAAW,EAAE,GACnB;CAC9B,MAAM,eAAe,QAAQ,gBAAgB;CAC7C,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,QAAQ,KAAK,SAAS;CAE5B,IAAI;CACJ,IAAI;CACJ,IAAI,YAAY;AAEhB,MAAK,IAAI,UAAU,GAAG,UAAU,aAAa,WAAW;AACtD,MAAI;GACF,MAAM,SAAS,MAAM,IAAI;AACzB,OAAI,cAAc,OAAO,IAAI,UAAU,cAAc,GAAG;AACtD,iBAAa;AACb,gBAAY;SAEZ,QAAO;WAEF,KAAK;AACZ,eAAY;AACZ,OAAI,YAAY,cAAc,EAAG,OAAM;;AAGzC,MAAI,eAAe,KAAK,UAAU,cAAc,EAE9C,OAAM,MADQ,eAAe,UAAU,QACrB;;AAItB,KAAI,UAAW,QAAO;AACtB,OAAM"}

package/dist/agent-runners/scratchpad-afs.cjs

@@ -0,0 +1,276 @@
+let ufo = require("ufo");
+
+//#region src/agent-runners/scratchpad-afs.ts
+/**
+* @deprecated Phase 2 migrates scratch to the scope-local `/scratch/` mount.
+* Kept only for the legacy read-path (old sessions) and removed in Phase 6.
+*/
+const MEMORY_SCRATCH_ROOT = "/modules/memory";
+/** Root path of the scope-local scratch mount created by `projectForChild`. */
+const SCRATCH_SCOPE_ROOT = "/scratch";
+function validatePathComponent(value, label) {
+	if (typeof value !== "string" || value.length === 0) throw new TypeError(`SCRATCH_INVALID_INPUT: ${label} must be a non-empty string`);
+	if (value.includes("..")) throw new Error(`SCRATCH_INVALID_INPUT: path traversal disallowed in ${label}`);
+	if (value.includes("\0")) throw new Error(`SCRATCH_INVALID_INPUT: null byte disallowed in ${label}`);
+	if (value.includes("/") || value.includes("\\")) throw new Error(`SCRATCH_INVALID_INPUT: path separator disallowed in ${label}`);
+	return value;
+}
+/**
+* Reject scratch-local paths that try to escape the `/scratch/` root or
+* smuggle control characters. Runs on every read/write/list/stat/delete
+* against the scope-local mount.
+*/
+function assertScratchPath(path) {
+	if (typeof path !== "string" || path.length === 0) throw new Error(`SCRATCH_INVALID_PATH: path must be a non-empty string`);
+	if (path.includes("\0")) throw new Error(`SCRATCH_INVALID_PATH: null byte disallowed`);
+	if (path.split("/").some((s) => s === "..")) throw new Error(`SCRATCH_INVALID_PATH: path traversal disallowed (".." segment)`);
+}
+/**
+* @deprecated Use `createScratchProvider` + the scope-local `/scratch/` mount.
+* Retained for the legacy read-path and removed in Phase 6.
+*/
+function computeScratchLayout(session, runId) {
+	const basePath = (0, ufo.joinURL)(MEMORY_SCRATCH_ROOT, "runs", validatePathComponent(session, "session"), "subruns", validatePathComponent(runId, "runId"));
+	return {
+		basePath,
+		stateYml: (0, ufo.joinURL)(basePath, "state.yml"),
+		messagesJsonl: (0, ufo.joinURL)(basePath, "messages.jsonl"),
+		eventsJsonl: (0, ufo.joinURL)(basePath, "events.jsonl"),
+		historyJsonl: (0, ufo.joinURL)(basePath, "history.jsonl")
+	};
+}
+/**
+* @deprecated Use the scope-local `/scratch/` mount (`createScratchProvider`).
+* Kept for backwards compatibility with pre-Phase-2 callers; removed in P6.
+*/
+async function provisionScratchViaAFS(afs, session, runId) {
+	if (!afs.write) throw new Error("SCRATCH_NO_WRITE: host AFS does not expose a write method");
+	const layout = computeScratchLayout(session, runId);
+	await afs.write(layout.stateYml, { content: "" });
+	await afs.write(layout.messagesJsonl, { content: "" });
+	await afs.write(layout.eventsJsonl, { content: "" });
+	await afs.write(layout.historyJsonl, { content: "" });
+	return layout;
+}
+/**
+* @deprecated Scope teardown will manage scratch lifetime once P5 lands.
+* Phase 2 keeps this helper for callers still operating on legacy sessions.
+*/
+async function teardownScratchViaAFS(afs, session, retention = "session") {
+	if (retention === "forever" || retention === "run") return;
+	const s = validatePathComponent(session, "session");
+	const anyAfs = afs;
+	if (typeof anyAfs.delete !== "function") return;
+	const sessionPath = (0, ufo.joinURL)(MEMORY_SCRATCH_ROOT, "runs", s);
+	try {
+		await anyAfs.delete(sessionPath, { recursive: true });
+	} catch {}
+}
+function normalizeScratchPath(path) {
+	assertScratchPath(path);
+	if (path === SCRATCH_SCOPE_ROOT) return SCRATCH_SCOPE_ROOT;
+	if (path.startsWith(`${SCRATCH_SCOPE_ROOT}/`)) {
+		const trimmed = path.replace(/\/+$/, "");
+		return trimmed.length < 8 ? SCRATCH_SCOPE_ROOT : trimmed;
+	}
+	throw new Error(`SCRATCH_PATH_OUT_OF_SCOPE: ${path} is not inside ${SCRATCH_SCOPE_ROOT}/`);
+}
+function isScratchPath(path) {
+	return path === SCRATCH_SCOPE_ROOT || path.startsWith(`${SCRATCH_SCOPE_ROOT}/`);
+}
+function createScratchProvider(opts) {
+	validatePathComponent(opts.session, "session");
+	if (opts.runId !== void 0) validatePathComponent(opts.runId, "runId");
+	const retention = opts.retention ?? "session";
+	const store = /* @__PURE__ */ new Map();
+	return {
+		session: opts.session,
+		runId: opts.runId,
+		retention,
+		async read(path) {
+			const norm = normalizeScratchPath(path);
+			if (!store.has(norm)) return null;
+			return {
+				data: {
+					content: store.get(norm),
+					path: norm
+				},
+				path: norm
+			};
+		},
+		async write(path, payload) {
+			const norm = normalizeScratchPath(path);
+			if (norm === SCRATCH_SCOPE_ROOT) throw new Error(`SCRATCH_INVALID_PATH: cannot write to scratch root`);
+			const content = typeof payload?.content === "string" ? payload.content : "";
+			store.set(norm, content);
+		},
+		async list(path) {
+			const norm = normalizeScratchPath(path);
+			const prefix = norm === SCRATCH_SCOPE_ROOT ? `${SCRATCH_SCOPE_ROOT}/` : `${norm}/`;
+			const files = [];
+			const dirs = /* @__PURE__ */ new Set();
+			for (const stored of store.keys()) {
+				if (!stored.startsWith(prefix)) continue;
+				const rest = stored.slice(prefix.length);
+				const slash = rest.indexOf("/");
+				if (slash === -1) {
+					const content = store.get(stored) ?? "";
+					files.push({
+						name: rest,
+						path: stored,
+						type: "file",
+						size: Buffer.byteLength(content, "utf8")
+					});
+				} else {
+					const dir = rest.slice(0, slash);
+					dirs.add(dir);
+				}
+			}
+			const list = [];
+			for (const d of dirs) list.push({
+				name: d,
+				path: `${prefix}${d}`,
+				type: "dir",
+				size: 0
+			});
+			list.push(...files);
+			return {
+				data: list,
+				list
+			};
+		},
+		async stat(path) {
+			const norm = normalizeScratchPath(path);
+			if (norm === SCRATCH_SCOPE_ROOT) return { data: {
+				path: norm,
+				size: 0,
+				type: "dir"
+			} };
+			if (store.has(norm)) {
+				const content = store.get(norm);
+				return { data: {
+					path: norm,
+					size: Buffer.byteLength(content, "utf8"),
+					type: "file"
+				} };
+			}
+			const prefix = `${norm}/`;
+			for (const k of store.keys()) if (k.startsWith(prefix)) return { data: {
+				path: norm,
+				size: 0,
+				type: "dir"
+			} };
+			return null;
+		},
+		async delete(path, options) {
+			const norm = normalizeScratchPath(path);
+			if (norm === SCRATCH_SCOPE_ROOT) {
+				if (options?.recursive) {
+					store.clear();
+					return;
+				}
+				throw new Error(`SCRATCH_INVALID_PATH: cannot delete scratch root non-recursively`);
+			}
+			if (store.has(norm)) {
+				store.delete(norm);
+				return;
+			}
+			if (options?.recursive) {
+				const prefix = `${norm}/`;
+				for (const k of Array.from(store.keys())) if (k.startsWith(prefix)) store.delete(k);
+			}
+		},
+		clear() {
+			store.clear();
+		}
+	};
+}
+/**
+* Overlay `/scratch/*` reads/writes/lists/stats/deletes onto the given AFS
+* by routing them to the scratch provider. All other paths fall through to
+* the underlying AFS via the prototype chain (Object.create).
+*
+* The overlay is stateless besides its reference to the provider — two
+* scopes with different providers never see each other's scratch.
+*/
+function attachScratchMount(afs, provider) {
+	const child = Object.create(afs);
+	Object.defineProperty(child, "read", {
+		value: async (path, options) => {
+			if (isScratchPath(path)) {
+				const result = await provider.read(path);
+				if (result) return result;
+				const err = /* @__PURE__ */ new Error(`SCRATCH_NOT_FOUND: ${path}`);
+				err.code = "NOT_FOUND";
+				throw err;
+			}
+			return afs.read.call(afs, path, options);
+		},
+		enumerable: false,
+		writable: false,
+		configurable: false
+	});
+	Object.defineProperty(child, "write", {
+		value: async (path, payload, options) => {
+			if (isScratchPath(path)) {
+				await provider.write(path, payload);
+				return {
+					success: true,
+					data: { path }
+				};
+			}
+			if (typeof afs.write !== "function") throw new Error(`SCRATCH_NO_UNDERLYING_WRITE: afs.write not available for ${path}`);
+			return afs.write.call(afs, path, payload, options);
+		},
+		enumerable: false,
+		writable: false,
+		configurable: false
+	});
+	Object.defineProperty(child, "list", {
+		value: async (path, options) => {
+			if (isScratchPath(path)) return provider.list(path);
+			return afs.list.call(afs, path, options);
+		},
+		enumerable: false,
+		writable: false,
+		configurable: false
+	});
+	Object.defineProperty(child, "stat", {
+		value: async (path, options) => {
+			if (isScratchPath(path)) {
+				const result = await provider.stat(path);
+				if (result) return result;
+				const err = /* @__PURE__ */ new Error(`SCRATCH_NOT_FOUND: ${path}`);
+				err.code = "NOT_FOUND";
+				throw err;
+			}
+			return afs.stat.call(afs, path, options);
+		},
+		enumerable: false,
+		writable: false,
+		configurable: false
+	});
+	Object.defineProperty(child, "delete", {
+		value: async (path, options) => {
+			if (isScratchPath(path)) {
+				await provider.delete(path, options);
+				return { success: true };
+			}
+			if (typeof afs.delete !== "function") return { success: false };
+			return afs.delete.call(afs, path, options);
+		},
+		enumerable: false,
+		writable: false,
+		configurable: false
+	});
+	return child;
+}
+
+//#endregion
+exports.MEMORY_SCRATCH_ROOT = MEMORY_SCRATCH_ROOT;
+exports.SCRATCH_SCOPE_ROOT = SCRATCH_SCOPE_ROOT;
+exports.attachScratchMount = attachScratchMount;
+exports.computeScratchLayout = computeScratchLayout;
+exports.createScratchProvider = createScratchProvider;
+exports.provisionScratchViaAFS = provisionScratchViaAFS;
+exports.teardownScratchViaAFS = teardownScratchViaAFS;