@iowarp/clio-coder 0.3.0 → 0.3.2

package/dist/chunk-OKGUZO2U.js

@@ -0,0 +1,34 @@
+import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  typebox_exports
+} from "./chunk-5B2AEOW5.js";
+import {
+  ToolNames
+} from "./chunk-CGKSTWHD.js";
+import {
+  StringEnum
+} from "./chunk-FCSXB6T2.js";
+import {
+  init_esm_shims
+} from "./chunk-3R73A4XB.js";
+
+// src/tools/context/surface.ts
+init_esm_shims();
+var contextToolSurface = {
+  name: ToolNames.Context,
+  description: "Environment context: scope=workspace returns the git/project snapshot, scope=docs searches Clio's bundled documentation (omit query to list the corpus), scope=skills lists installed and marketplace skills or loads an installed one by name. For repository code and the repo's generated wiki use code_nav (mode=wiki).",
+  parameters: typebox_exports.Object({
+    scope: StringEnum(["workspace", "docs", "skills"], { description: "Context source." }),
+    query: typebox_exports.Optional(typebox_exports.String({ description: "scope=docs: question or terms; omit to list the corpus." })),
+    name: typebox_exports.Optional(typebox_exports.String({ description: "scope=skills: skill name to load; omit to list." })),
+    limit: typebox_exports.Optional(typebox_exports.Number({ description: "scope=docs: max sections (default 5, max 12)." })),
+    include_tree: typebox_exports.Optional(typebox_exports.Boolean({ description: "scope=skills: list files under the skill base_dir." }))
+  }),
+  baseActionClass: "read",
+  executionMode: "parallel"
+};
+
+export {
+  contextToolSurface
+};
+//# sourceMappingURL=chunk-OKGUZO2U.js.map

package/dist/{chunk-BBUH4VAA.js → chunk-OOJYHWRB.js}

@@ -1,23 +1,52 @@
+import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   shellQuote
-} from "./chunk-GOTUR54M.js";
+} from "./chunk-TXOTCRLG.js";
+import {
+  WORKER_BULK_FRAME_MAX_BYTES,
+  WORKER_EVENT_QUEUE_MAX_FRAMES,
+  WORKER_PROTOCOL_VERSION,
+  WORKER_STDIN_FRAME_MAX_BYTES,
+  WORKER_STDIN_QUEUE_MAX_BYTES,
+  canonicalJson,
+  endpointIdentityHash,
+  isControlLine,
+  isReceiptBearingFrame,
+  parseBulkFrame,
+  parseControlFrame,
+  toolSignatureOf
+} from "./chunk-CMZWFGD2.js";
+import {
+  enableClioCompileCache,
+  workerCompileCacheEnvironment
+} from "./chunk-I4HZDVNP.js";
 import {
   atomicWrite
-} from "./chunk-UGYAX5YI.js";
+} from "./chunk-M6SHUN7Q.js";
 import {
   clioStateDir
-} from "./chunk-X3NE4WVW.js";
+} from "./chunk-BNAZZHFG.js";
+import {
+  AI_AGENT_NAME,
+  withClioAgentEnvironment
+} from "./chunk-6EJMN2Y3.js";
 import {
   readClioVersion,
   resolvePackageRoot
-} from "./chunk-DXQNI4PC.js";
+} from "./chunk-IWHMRKLL.js";
+import {
+  init_esm_shims
+} from "./chunk-3R73A4XB.js";
 
 // src/domains/dispatch/fleet-preflight.ts
+init_esm_shims();
 import { execFile } from "node:child_process";
 import { existsSync, readFileSync } from "node:fs";
 import { join as join2 } from "node:path";
+import { performance } from "node:perf_hooks";
 
 // src/domains/dispatch/route-facts.ts
+init_esm_shims();
 var ROUTE_FACT_FRESHNESS_MS = 15 * 60 * 1e3;
 function isFresh(probedAt, now, freshnessMs) {
   const at = Date.parse(probedAt);
@@ -112,344 +141,19 @@ function evaluateRouteFacts(facts, resources, requirement, options) {
 }
 
 // src/domains/dispatch/transport.ts
+init_esm_shims();
 import { spawn as spawn2 } from "node:child_process";
 
 // src/domains/dispatch/worker-spawn.ts
+init_esm_shims();
 import { spawn } from "node:child_process";
 import { join } from "node:path";
 
 // src/domains/dispatch/worker-protocol.ts
-import { createHash as createHash2 } from "node:crypto";
-
-// src/worker/protocol.ts
+init_esm_shims();
 import { createHash } from "node:crypto";
-var WORKER_PROTOCOL_VERSION = 1;
-var CONTROL_FRAME_PREFIX = "@clio-control/1 ";
-var WORKER_CONTROL_FRAME_MAX_BYTES = 16 * 1024;
-var WORKER_BULK_FRAME_MAX_BYTES = 4 * 1024 * 1024;
-var WORKER_STDIN_FRAME_MAX_BYTES = 1024 * 1024;
-var WORKER_STDIN_QUEUE_MAX_BYTES = 4 * 1024 * 1024;
-var WORKER_EVENT_QUEUE_MAX_FRAMES = 4096;
-function knownResource(value) {
-  return { known: true, value };
-}
-var UNKNOWN_RESOURCE = { known: false };
-var WORKER_RESOURCE_LABEL_MAX = 32;
-var WORKER_RESIDENT_MODEL_MAX = 64;
-var AGENT_LEDGER_SCOPE_MAX_ENTRIES = 8;
-var AGENT_LEDGER_SCOPE_ENTRY_MAX_CHARS = 200;
-var AGENT_LEDGER_INTENT_MAX_CHARS = 200;
-var AGENT_LEDGER_CLAIM_MAX_CHARS = 400;
-var AGENT_LEDGER_EVIDENCE_MAX_CHARS = 400;
-var AGENT_LEDGER_PATH_MAX_CHARS = 400;
-var AGENT_LEDGER_ENTRY_ID = /^e[1-9][0-9]*$/;
-function isAgentLedgerEntryId(value) {
-  return typeof value === "string" && AGENT_LEDGER_ENTRY_ID.test(value);
-}
-function boundedString(value, max) {
-  return typeof value === "string" && value.length > 0 && value.length <= max;
-}
-function parseAgentLedgerBody(value) {
-  if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    return { ok: false, reason: "ledger body is not an object" };
-  }
-  const record = value;
-  switch (record.kind) {
-    case "claim": {
-      const scope = record.scope;
-      if (!Array.isArray(scope) || scope.length === 0) {
-        return { ok: false, reason: "claim scope must be a non-empty array of path prefixes" };
-      }
-      if (scope.length > AGENT_LEDGER_SCOPE_MAX_ENTRIES) {
-        return { ok: false, reason: `claim scope exceeds ${AGENT_LEDGER_SCOPE_MAX_ENTRIES} entries` };
-      }
-      for (const entry of scope) {
-        if (!boundedString(entry, AGENT_LEDGER_SCOPE_ENTRY_MAX_CHARS)) {
-          return {
-            ok: false,
-            reason: `claim scope entries must be 1..${AGENT_LEDGER_SCOPE_ENTRY_MAX_CHARS} characters`
-          };
-        }
-      }
-      if (!boundedString(record.intent, AGENT_LEDGER_INTENT_MAX_CHARS)) {
-        return { ok: false, reason: `claim intent must be 1..${AGENT_LEDGER_INTENT_MAX_CHARS} characters` };
-      }
-      return { ok: true, body: { kind: "claim", scope: scope.map(String), intent: record.intent } };
-    }
-    case "finding": {
-      if (!boundedString(record.claim, AGENT_LEDGER_CLAIM_MAX_CHARS)) {
-        return { ok: false, reason: `finding claim must be 1..${AGENT_LEDGER_CLAIM_MAX_CHARS} characters` };
-      }
-      const body = {
-        kind: "finding",
-        claim: record.claim
-      };
-      if (record.path !== void 0) {
-        if (!boundedString(record.path, AGENT_LEDGER_PATH_MAX_CHARS)) {
-          return { ok: false, reason: `finding path must be 1..${AGENT_LEDGER_PATH_MAX_CHARS} characters` };
-        }
-        body.path = record.path;
-      }
-      if (record.line !== void 0) {
-        const line = record.line;
-        if (typeof line !== "number" || !Number.isSafeInteger(line) || line <= 0) {
-          return { ok: false, reason: "finding line must be a positive safe integer" };
-        }
-        body.line = line;
-      }
-      return { ok: true, body };
-    }
-    case "review": {
-      if (!isAgentLedgerEntryId(record.target)) {
-        return { ok: false, reason: "review target must be a ledger entry id such as e3" };
-      }
-      if (typeof record.passed !== "boolean") {
-        return { ok: false, reason: "review passed must be a boolean" };
-      }
-      if (!boundedString(record.evidence, AGENT_LEDGER_EVIDENCE_MAX_CHARS)) {
-        return { ok: false, reason: `review evidence must be 1..${AGENT_LEDGER_EVIDENCE_MAX_CHARS} characters` };
-      }
-      return {
-        ok: true,
-        body: { kind: "review", target: record.target, passed: record.passed, evidence: record.evidence }
-      };
-    }
-    default:
-      return { ok: false, reason: `unknown ledger entry kind ${String(record.kind)}` };
-  }
-}
-function parseAgentLedgerEntry(value) {
-  if (typeof value !== "object" || value === null || Array.isArray(value)) return null;
-  const record = value;
-  const sequence = record.sequence;
-  if (typeof sequence !== "number" || !Number.isSafeInteger(sequence) || sequence <= 0) return null;
-  if (!isAgentLedgerEntryId(record.id)) return null;
-  for (const key of ["at", "runId", "assignmentId", "agentId", "nodeId"]) {
-    if (typeof record[key] !== "string" || record[key].length === 0) return null;
-  }
-  const body = parseAgentLedgerBody(record.body);
-  if (!body.ok) return null;
-  const conflicts = record.conflictsWith;
-  if (conflicts !== void 0 && !(Array.isArray(conflicts) && conflicts.every(isAgentLedgerEntryId))) return null;
-  return {
-    id: record.id,
-    sequence,
-    at: record.at,
-    runId: record.runId,
-    assignmentId: record.assignmentId,
-    agentId: record.agentId,
-    nodeId: record.nodeId,
-    body: body.body,
-    ...conflicts === void 0 ? {} : { conflictsWith: [...conflicts] }
-  };
-}
-function sha256Hex(input) {
-  return createHash("sha256").update(input, "utf8").digest("hex");
-}
-var HEX_64 = /^[0-9a-f]{64}$/;
-function endpointIdentityHash(url) {
-  if (url === void 0 || url.trim().length === 0) return sha256Hex("clio.endpoint:none");
-  const raw = url.trim();
-  let canonical;
-  try {
-    const parsed = new URL(raw);
-    const path = parsed.pathname.replace(/\/+$/u, "");
-    canonical = `${parsed.protocol}//${parsed.hostname}:${parsed.port}${path}`;
-  } catch {
-    canonical = raw.replace(/\/+$/u, "");
-  }
-  return sha256Hex(`clio.endpoint:${canonical}`);
-}
-function workerSpecDigest(spec) {
-  return sha256Hex(`clio.workerSpec:${canonicalJson(spec)}`);
-}
-function toolSignatureOf(names) {
-  return sha256Hex(`clio.tools:${[...names].sort().join(",")}`);
-}
-function canonicalJson(value) {
-  if (value === null) return "null";
-  if (typeof value === "number") return Number.isFinite(value) ? JSON.stringify(value) : "null";
-  if (typeof value === "string" || typeof value === "boolean") return JSON.stringify(value);
-  if (Array.isArray(value))
-    return `[${value.map((entry) => entry === void 0 ? "null" : canonicalJson(entry)).join(",")}]`;
-  if (typeof value === "object") {
-    const record = value;
-    const parts = [];
-    for (const key of Object.keys(record).sort()) {
-      const child = record[key];
-      if (child === void 0) continue;
-      parts.push(`${JSON.stringify(key)}:${canonicalJson(child)}`);
-    }
-    return `{${parts.join(",")}}`;
-  }
-  return "null";
-}
-function withinFrameBudget(line, maxBytes) {
-  return Buffer.byteLength(line, "utf8") <= maxBytes;
-}
-function parseJsonObject(line, maxBytes, lane) {
-  if (!withinFrameBudget(line, maxBytes)) {
-    return { ok: false, reason: `${lane} frame exceeds ${maxBytes} bytes` };
-  }
-  let value;
-  try {
-    value = JSON.parse(line);
-  } catch {
-    return { ok: false, reason: `${lane} frame is not JSON` };
-  }
-  if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    return { ok: false, reason: `${lane} frame is not a JSON object` };
-  }
-  return { ok: true, value };
-}
-function parseBulkFrame(line) {
-  return parseJsonObject(line, WORKER_BULK_FRAME_MAX_BYTES, "bulk");
-}
-function isControlLine(line) {
-  return line.startsWith(CONTROL_FRAME_PREFIX);
-}
-function encodeControlFrame(frame) {
-  return `${CONTROL_FRAME_PREFIX}${JSON.stringify(frame)}
-`;
-}
-function readFiniteNumber(record, key) {
-  const value = record[key];
-  return typeof value === "number" && Number.isFinite(value) ? value : null;
-}
-function readResourceValue(value, validate) {
-  if (typeof value !== "object" || value === null || Array.isArray(value)) return null;
-  const record = value;
-  if (record.known === false) return { known: false };
-  if (record.known !== true || !validate(record.value)) return null;
-  return { known: true, value: record.value };
-}
-function isFiniteNumber(value) {
-  return typeof value === "number" && Number.isFinite(value) && value >= 0;
-}
-function isBoundedStringArray(value, max) {
-  return Array.isArray(value) && value.length <= max && value.every((entry) => typeof entry === "string");
-}
-function parseResourceFacts(value) {
-  if (typeof value !== "object" || value === null || Array.isArray(value)) return null;
-  const record = value;
-  if (!isBoundedStringArray(record.labels, WORKER_RESOURCE_LABEL_MAX)) return null;
-  const numeric = ["cpuCount", "totalMemoryBytes", "freeMemoryBytes", "gpuCount", "vramBytes"];
-  const parsed = { labels: [...record.labels] };
-  for (const key of numeric) {
-    const fact = readResourceValue(record[key], isFiniteNumber);
-    if (fact === null) return null;
-    parsed[key] = fact;
-  }
-  const residentModels = readResourceValue(
-    record.residentModels,
-    (raw) => isBoundedStringArray(raw, WORKER_RESIDENT_MODEL_MAX)
-  );
-  if (residentModels === null) return null;
-  parsed.residentModels = residentModels;
-  return parsed;
-}
-function parseAttestation(value) {
-  if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    return { ok: false, reason: "announce attestation is not an object" };
-  }
-  const record = value;
-  if (record.protocolVersion !== WORKER_PROTOCOL_VERSION) {
-    return { ok: false, reason: `announce protocol version ${String(record.protocolVersion)} is unsupported` };
-  }
-  const specVersion = readFiniteNumber(record, "specVersion");
-  if (specVersion === null) return { ok: false, reason: "announce specVersion must be a finite number" };
-  const pid = readFiniteNumber(record, "pid");
-  if (pid === null) return { ok: false, reason: "announce pid must be a finite number" };
-  const rawPgid = record.processGroupId;
-  if (rawPgid !== null && !(typeof rawPgid === "number" && Number.isFinite(rawPgid))) {
-    return { ok: false, reason: "announce processGroupId must be a finite number or null" };
-  }
-  for (const key of ["host", "runtimeId", "targetId", "wireModelId"]) {
-    if (typeof record[key] !== "string" || record[key].length === 0) {
-      return { ok: false, reason: `announce ${key} must be a non-empty string` };
-    }
-  }
-  for (const key of ["settingsFingerprint", "specDigest", "endpointIdentityHash", "toolSignature"]) {
-    if (typeof record[key] !== "string" || !HEX_64.test(record[key])) {
-      return { ok: false, reason: `announce ${key} must be a sha256 hex digest` };
-    }
-  }
-  const resources = parseResourceFacts(record.resources);
-  if (resources === null) return { ok: false, reason: "announce resources are missing or malformed" };
-  return {
-    ok: true,
-    value: {
-      protocolVersion: WORKER_PROTOCOL_VERSION,
-      specVersion,
-      pid,
-      processGroupId: typeof rawPgid === "number" ? rawPgid : null,
-      host: record.host,
-      settingsFingerprint: record.settingsFingerprint,
-      specDigest: record.specDigest,
-      runtimeId: record.runtimeId,
-      targetId: record.targetId,
-      endpointIdentityHash: record.endpointIdentityHash,
-      wireModelId: record.wireModelId,
-      toolSignature: record.toolSignature,
-      resources
-    }
-  };
-}
-function parseControlFrame(line) {
-  if (!isControlLine(line)) return { ok: false, reason: "control frame is missing its lane marker" };
-  const body = line.slice(CONTROL_FRAME_PREFIX.length);
-  const parsed = parseJsonObject(body, WORKER_CONTROL_FRAME_MAX_BYTES, "control");
-  if (!parsed.ok) return parsed;
-  const record = parsed.value;
-  switch (record.kind) {
-    case "announce": {
-      const attestation = parseAttestation(record.attestation);
-      if (!attestation.ok) return attestation;
-      return { ok: true, value: { kind: "announce", attestation: attestation.value } };
-    }
-    case "heartbeat": {
-      const at = readFiniteNumber(record, "at");
-      if (at === null) return { ok: false, reason: "heartbeat frame requires a finite at" };
-      return { ok: true, value: { kind: "heartbeat", at } };
-    }
-    case "cancel_ack": {
-      const at = readFiniteNumber(record, "at");
-      if (at === null) return { ok: false, reason: "cancel_ack frame requires a finite at" };
-      return { ok: true, value: { kind: "cancel_ack", at } };
-    }
-    case "ledger_post": {
-      const body2 = parseAgentLedgerBody(record.body);
-      if (!body2.ok) return { ok: false, reason: `ledger_post frame rejected: ${body2.reason}` };
-      return { ok: true, value: { kind: "ledger_post", body: body2.body } };
-    }
-    default:
-      return { ok: false, reason: `unknown control frame kind ${String(record.kind)}` };
-  }
-}
-var RECEIPT_BEARING_BULK_TYPES = /* @__PURE__ */ new Set([
-  "message_end",
-  "clio_run_outcome",
-  "clio_permission_escalated",
-  "clio_permission_resolved",
-  "clio_steer_received",
-  "clio_tool_activity",
-  "clio_skill_activation",
-  "clio_safety_decision",
-  "clio_verification",
-  "clio_usage",
-  "tool_execution_end",
-  "spawn_error"
-]);
-function isReceiptBearingFrame(value) {
-  if (typeof value !== "object" || value === null || Array.isArray(value)) return true;
-  const type = value.type;
-  if (typeof type !== "string") return true;
-  return RECEIPT_BEARING_BULK_TYPES.has(type);
-}
-
-// src/domains/dispatch/worker-protocol.ts
 function computeSettingsFingerprint(settings) {
-  return createHash2("sha256").update(`clio.settings:${canonicalJson(settings)}`, "utf8").digest("hex");
+  return createHash("sha256").update(`clio.settings:${canonicalJson(settings)}`, "utf8").digest("hex");
 }
 function verifyWorkerAttestation(attestation, approved) {
   if (attestation.protocolVersion !== WORKER_PROTOCOL_VERSION) {
@@ -494,7 +198,7 @@ function approvedIdentityForSpec(spec) {
   };
 }
 function workerSpecDigestOf(spec) {
-  return createHash2("sha256").update(`clio.workerSpec:${canonicalJson(spec)}`, "utf8").digest("hex");
+  return createHash("sha256").update(`clio.workerSpec:${canonicalJson(spec)}`, "utf8").digest("hex");
 }
 function resourceOrNull(value) {
   return value.known ? value.value : null;
@@ -599,7 +303,7 @@ function spawnWorkerProcess(command, args, spec, opts) {
   const child = spawn(command, [...args], {
     stdio: ["pipe", "pipe", "pipe"],
     cwd: opts?.cwd,
-    env: opts?.env ?? process.env,
+    env: withClioAgentEnvironment(opts?.env ?? process.env),
     // The worker leads its own process group so abort escalation covers the
     // descendants a runtime spawned, not only the immediate child.
     detached: true
@@ -903,12 +607,15 @@ function spawnWorkerProcess(command, args, spec, opts) {
 }
 function spawnNativeWorker(spec, opts) {
   const workerEntry = opts?.workerEntryPath ?? join(resolvePackageRoot(), "dist/worker/entry.js");
+  const { workerEntryPath: _entryPath, ...processOptions } = opts ?? {};
   return spawnWorkerProcess(process.execPath, ["--disable-warning=ExperimentalWarning", workerEntry], spec, {
-    ...opts?.cwd !== void 0 ? { cwd: opts.cwd } : {},
-    env: opts?.env ?? process.env,
-    ...opts?.shutdownGraceMs !== void 0 ? { shutdownGraceMs: opts.shutdownGraceMs } : {}
+    ...processOptions,
+    env: withCompileCacheEnvironment(opts?.env ?? process.env)
   });
 }
+function withCompileCacheEnvironment(env) {
+  return workerCompileCacheEnvironment(env, enableClioCompileCache());
+}
 
 // src/domains/dispatch/transport.ts
 var LOCAL_NODE_ID = "local";
@@ -921,10 +628,10 @@ function remoteEnvAssignments(node) {
   const residency = node.residency ?? "observe";
   const labels = (node.labels ?? []).map((label) => label.trim()).filter((label) => label.length > 0);
   const labelAssignment = labels.length > 0 ? ` CLIO_CODER_WORKER_LABELS=${shellQuote(labels.join(","))}` : "";
-  return `CLIO_CODER_RESIDENCY=${residency} CLIO_CODER_WORKER_PGID=$$${labelAssignment}`;
+  return `AI_AGENT=${AI_AGENT_NAME} CLIO_CODER_RESIDENCY=${residency} CLIO_CODER_WORKER_PGID=$$${labelAssignment}`;
 }
 function buildRemoteWorkerCommand(node, cwd) {
-  const entry = node.clioEntry !== void 0 && node.clioEntry.trim().length > 0 ? node.clioEntry.trim() : DEFAULT_REMOTE_CLIO_ENTRY;
+  const entry = node.clioCoderEntry !== void 0 && node.clioCoderEntry.trim().length > 0 ? node.clioCoderEntry.trim() : DEFAULT_REMOTE_CLIO_ENTRY;
   return `cd ${shellQuote(cwd)} && exec env ${remoteEnvAssignments(node)} ${entry}`;
 }
 function buildSshArgs(node, remoteCommand) {
@@ -966,15 +673,20 @@ function createSshWorkerTransport(node, opts) {
         } catch {
         }
       };
+      const { cwd: _consumedCwd, onAnnounce, onForcedKill, ...forwarded } = spawnOpts ?? {};
       return spawnWorkerProcess(sshBinary, buildSshArgs(node, buildRemoteWorkerCommand(node, cwd)), spec, {
-        // No cwd for the local ssh client; the remote command cds itself.
-        env: process.env,
         ...opts?.shutdownGraceMs !== void 0 ? { shutdownGraceMs: opts.shutdownGraceMs } : {},
+        ...forwarded,
+        env: process.env,
         onAnnounce: (attestation) => {
           remote.pid = attestation.pid;
           remote.processGroupId = attestation.processGroupId;
+          onAnnounce?.(attestation);
         },
-        onForcedKill: killRemote
+        onForcedKill: () => {
+          killRemote();
+          onForcedKill?.();
+        }
       });
     }
   };
@@ -1043,7 +755,7 @@ function routeFactVerdict(requirement, records = readFleetPreflightRecords(), op
 var PREFLIGHT_MARKER = "clio-preflight/1";
 var DEFAULT_PREFLIGHT_TIMEOUT_MS = 2e4;
 function buildPreflightScript(node, projectRoot, targets = []) {
-  const entry = node.clioEntry !== void 0 && node.clioEntry.trim().length > 0 ? node.clioEntry.trim() : "clio-coder worker";
+  const entry = node.clioCoderEntry !== void 0 && node.clioCoderEntry.trim().length > 0 ? node.clioCoderEntry.trim() : "clio-coder worker";
   const cliBase = entry.endsWith(" worker") ? entry.slice(0, -" worker".length) : null;
   const versionProbe = cliBase !== null ? `v=$(${cliBase} --version 2>/dev/null | head -n 1); if [ -n "$v" ]; then echo "clio=$v"; else echo clio=missing; fi` : `echo clio=custom-entry`;
   const lines = [
@@ -1143,9 +855,9 @@ async function runFleetNodePreflight(node, projectRoot, options) {
     resources: null
   };
   const script = buildPreflightScript(node, projectRoot, targets);
-  const probeStartedAt = Date.now();
+  const probeStartedAt = performance.now();
   const result = await runSsh(sshBinary, buildSshArgs(node, script), timeoutMs);
-  const probeDurationMs = Date.now() - probeStartedAt;
+  const probeDurationMs = Math.round(performance.now() - probeStartedAt);
   if (!result.stdout.includes(PREFLIGHT_MARKER)) {
     const stderr = result.stderr.trim().split("\n").slice(-1)[0] ?? "";
     record.detail = `unreachable (ssh exit ${result.code}${stderr.length > 0 ? `: ${stderr}` : ""})`;
@@ -1183,7 +895,7 @@ async function runFleetNodePreflight(node, projectRoot, options) {
   if (!checks.pathParity)
     failures.push(`project root ${projectRoot} missing on node (disjoint filesystems are unsupported)`);
   if (!checks.clioPresent)
-    failures.push("clio-coder not found on remote PATH (set fleet.nodes[].clioEntry or install clio-coder)");
+    failures.push("clio-coder not found on remote PATH (set fleet.nodes[].clioCoderEntry or install clio-coder)");
   else if (!checks.versionMatch) {
     failures.push(
       `clio-coder version mismatch (local ${parseSemver(localVersion) ?? localVersion}, remote ${record.remoteVersion ?? "unknown"})`
@@ -1196,19 +908,6 @@ async function runFleetNodePreflight(node, projectRoot, options) {
 }
 
 export {
-  WORKER_PROTOCOL_VERSION,
-  WORKER_STDIN_FRAME_MAX_BYTES,
-  knownResource,
-  UNKNOWN_RESOURCE,
-  WORKER_RESOURCE_LABEL_MAX,
-  parseAgentLedgerBody,
-  parseAgentLedgerEntry,
-  endpointIdentityHash,
-  workerSpecDigest,
-  toolSignatureOf,
-  canonicalJson,
-  withinFrameBudget,
-  encodeControlFrame,
   computeSettingsFingerprint,
   receiptAttestationFields,
   spawnNativeWorker,
@@ -1221,4 +920,4 @@ export {
   routeFactVerdict,
   runFleetNodePreflight
 };
-//# sourceMappingURL=chunk-BBUH4VAA.js.map
+//# sourceMappingURL=chunk-OOJYHWRB.js.map

package/dist/{chunk-D5YD55AR.js → chunk-OQ33BKR3.js}

@@ -1,9 +1,16 @@
+import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  init_esm_shims
+} from "./chunk-3R73A4XB.js";
+
 // src/core/bus-events.ts
+init_esm_shims();
 var BusChannels = {
   SessionStart: "session.start",
   SessionEnd: "session.end",
   SessionParked: "session.parked",
   SessionResumed: "session.resumed",
+  SessionTurnSwitched: "session.turn_switched",
   DomainLoaded: "domain.loaded",
   DomainFailed: "domain.failed",
   ConfigHotReload: "config.hotReload",
@@ -55,7 +62,11 @@ function isRunAbortedPayload(value) {
   return true;
 }
 
+// src/core/shared-bus.ts
+init_esm_shims();
+
 // src/core/event-bus.ts
+init_esm_shims();
 function reportListenerError(channel, error) {
   const message = error instanceof Error ? error.stack ?? error.message : String(error);
   console.error(`[clio:event-bus] Listener crashed on ${channel}: ${message}`);
@@ -113,4 +124,4 @@ export {
   isRunAbortedPayload,
   getSharedBus
 };
-//# sourceMappingURL=chunk-D5YD55AR.js.map
+//# sourceMappingURL=chunk-OQ33BKR3.js.map

package/dist/chunk-OQE5J4C6.js

@@ -0,0 +1,73 @@
+import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  canonicalizeExistingPath
+} from "./chunk-ECH6PKUQ.js";
+import {
+  init_esm_shims
+} from "./chunk-3R73A4XB.js";
+
+// src/tools/path-utils.ts
+init_esm_shims();
+import { accessSync, constants } from "node:fs";
+import { homedir } from "node:os";
+import { isAbsolute, resolve as resolvePath, sep } from "node:path";
+function toPosixPath(value) {
+  return value.split(sep).join("/");
+}
+var UNICODE_SPACES = /[\u00A0\u2000-\u200A\u202F\u205F\u3000]/g;
+var NARROW_NO_BREAK_SPACE = "\u202F";
+function normalizeUnicodeSpaces(value) {
+  return value.replace(UNICODE_SPACES, " ");
+}
+function fileExists(filePath) {
+  try {
+    accessSync(filePath, constants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function normalizeAtPrefix(filePath) {
+  return filePath.startsWith("@") ? filePath.slice(1) : filePath;
+}
+function tryMacOSScreenshotPath(filePath) {
+  return filePath.replace(/ (AM|PM)\./gi, `${NARROW_NO_BREAK_SPACE}$1.`);
+}
+function tryNfdVariant(filePath) {
+  return filePath.normalize("NFD");
+}
+function tryCurlyQuoteVariant(filePath) {
+  return filePath.replace(/'/g, "\u2019");
+}
+function expandPath(filePath) {
+  const normalized = normalizeUnicodeSpaces(normalizeAtPrefix(filePath));
+  if (normalized === "~") return homedir();
+  if (normalized.startsWith("~/")) return homedir() + normalized.slice(1);
+  return normalized;
+}
+function resolveToCwd(filePath, cwd = process.cwd()) {
+  const expanded = expandPath(filePath);
+  const resolved = isAbsolute(expanded) ? resolvePath(expanded) : resolvePath(cwd, expanded);
+  return canonicalizeExistingPath(resolved);
+}
+function resolveReadPath(filePath, cwd = process.cwd()) {
+  const resolved = resolveToCwd(filePath, cwd);
+  if (fileExists(resolved)) return resolved;
+  const amPmVariant = tryMacOSScreenshotPath(resolved);
+  if (amPmVariant !== resolved && fileExists(amPmVariant)) return amPmVariant;
+  const nfdVariant = tryNfdVariant(resolved);
+  if (nfdVariant !== resolved && fileExists(nfdVariant)) return nfdVariant;
+  const curlyVariant = tryCurlyQuoteVariant(resolved);
+  if (curlyVariant !== resolved && fileExists(curlyVariant)) return curlyVariant;
+  const nfdCurlyVariant = tryCurlyQuoteVariant(nfdVariant);
+  if (nfdCurlyVariant !== resolved && fileExists(nfdCurlyVariant)) return nfdCurlyVariant;
+  return resolved;
+}
+
+export {
+  toPosixPath,
+  expandPath,
+  resolveToCwd,
+  resolveReadPath
+};
+//# sourceMappingURL=chunk-OQE5J4C6.js.map