@iowarp/clio-coder 0.5.1 → 0.5.2

package/dist/{chunk-4WOOTKFD.js → chunk-U3FETNQB.js}

@@ -2,20 +2,31 @@ import { createRequire as __clioCreateRequire } from "node:module"; const requir
 import {
   expandPromptTemplateInput,
   loadPromptTemplates
-} from "./chunk-UX2L5CUD.js";
+} from "./chunk-AI36V3ON.js";
 import {
   expandSkillInvocationInput,
   loadSkills,
   parsePendingSkillRequests
-} from "./chunk-LAR7DX5E.js";
+} from "./chunk-B5TASTCK.js";
 import {
   frontmatterRegion,
   normalizedSkillHash,
   stripProvenanceLines
 } from "./chunk-DNCE23JJ.js";
+import {
+  lexicalMatches,
+  normalize
+} from "./chunk-H7REJ7L5.js";
 import {
   expandConfigPath
 } from "./chunk-VNBICSS2.js";
+import {
+  SKILL_INSTALL_OFFER_OPTION_NEVER,
+  SKILL_INSTALL_OFFER_OPTION_NOT_NOW,
+  SKILL_INSTALL_OFFER_OPTION_PROJECT,
+  SKILL_INSTALL_OFFER_OPTION_USER,
+  SKILL_SUGGESTION_ANCHOR
+} from "./chunk-MMZMM6SW.js";
 import {
   require_dist
 } from "./chunk-B5GGDIHT.js";
@@ -130,6 +141,306 @@ var ResourcesManifest = {
 // src/domains/resources/prompts/substitute.ts
 init_esm_shims();
 
+// src/domains/resources/skills/catalog-view.ts
+init_esm_shims();
+var LISTING_HEADER = "Available skills.";
+var SESSION_NOTE = "These skills were explicitly supplied for this session. Preserve their source; session availability does not mean Clio installed or copied them.";
+var INTEROP_NOTE = "Other-agent skill folders are discovery-only. Explicitly import into Clio before use; the trust-imports setting does not install or activate loose files.";
+var MARKETPLACE_HEADER = "Marketplace (additional skills available to install; /skill <name> offers to install):";
+var SESSION_HEADER = "Explicitly supplied session skills (not installed packages):";
+var EMPTY_WITH_MARKETPLACE = "No skills are available in Clio and no additional marketplace skills were found.";
+var EMPTY_WITHOUT_MARKETPLACE = "No skills are available in Clio.";
+var DRIFT_MARKER = " [drifted]";
+var MAX_LIMIT = 200;
+var MAX_QUERY_ECHO = 48;
+var MAX_NAME_ECHO = 64;
+var MAX_DRIFT_NAMES = 6;
+function byteLength(text) {
+  return Buffer.byteLength(text, "utf8");
+}
+function boundText(text, maxCodePoints) {
+  const points = [...text];
+  if (points.length <= maxCodePoints) return text;
+  return `${points.slice(0, maxCodePoints - 1).join("")}\u2026`;
+}
+function boundQuery(query) {
+  return boundText(query.replace(/\s+/g, " ").trim(), MAX_QUERY_ECHO);
+}
+function boundName(name) {
+  return boundText(name, MAX_NAME_ECHO);
+}
+function activationProtocolLine(modelActivation) {
+  return modelActivation ? `If one skill above matches the current task, load it now with context(scope="skills", name="<name>") and continue in the same turn; at this autonomy level you activate installed skills yourself and do not wait for the operator. Marketplace additions still require operator approval. If none match, do not mention skills.` : `If one skill above matches the current task, begin your reply with the line \`${SKILL_SUGGESTION_ANCHOR}\` (a comma-separated sequence, in order, when several compose), then continue the task in the same turn without it; only the operator can run it. If none match, do not mention skills.`;
+}
+function marketplaceOfferClause() {
+  return `When no installed skill serves the task but a marketplace skill above genuinely does, you may instead ask the operator with ask_user (mode=single_question, header "Install skill") whether to install it, offering exactly: "${SKILL_INSTALL_OFFER_OPTION_PROJECT}", "${SKILL_INSTALL_OFFER_OPTION_USER}", "${SKILL_INSTALL_OFFER_OPTION_NOT_NOW}", "${SKILL_INSTALL_OFFER_OPTION_NEVER}". The harness handles those exact offer options. An explicit operator request or approval also authorizes the documented library install CLI. After installation, refresh the inventory; distinguish installed from ready and report /library reload when required.`;
+}
+function driftNotice(names) {
+  if (names.length === 0) return "";
+  const shown = names.slice(0, MAX_DRIFT_NAMES).map(boundName);
+  const omitted = names.length - shown.length;
+  const list = omitted > 0 ? `${shown.join(", ")} and ${omitted} more` : shown.join(", ");
+  const subject = names.length === 1 ? `${list} no longer matches` : `${list} no longer match`;
+  return `Marked [drifted]: ${subject} the content hash recorded for it; the skill still loads unchanged, and /library shows the installed copy.`;
+}
+function readySkills(skills) {
+  return skills.filter((skill) => skill.source === "clio-coder" || skill.source === "plugin");
+}
+function sessionSkills(skills) {
+  return skills.filter((skill) => skill.source !== "clio-coder" && skill.source !== "plugin");
+}
+function haystackForSkill(skill) {
+  const triggers = skill.metadata.triggers;
+  const triggerText = Array.isArray(triggers) ? triggers.filter((entry) => typeof entry === "string").join(" ") : "";
+  return `${skill.name.replace(/-/g, " ")} ${skill.description} ${triggerText}`;
+}
+function haystackForMarketplace(entry) {
+  return `${entry.name.replace(/-/g, " ")} ${entry.description} ${entry.category ?? ""} ${(entry.triggers ?? []).join(" ")}`;
+}
+function haystackForPackage(record) {
+  return `${record.name.replace(/-/g, " ")} ${record.names.join(" ").replace(/-/g, " ")}`;
+}
+function buildRows(input) {
+  const drifted = input.drifted ?? /* @__PURE__ */ new Set();
+  const rows = [];
+  for (const skill of readySkills(input.skills)) {
+    const isDrifted = drifted.has(skill.name);
+    rows.push({
+      kind: "ready",
+      name: skill.name,
+      key: `ready:${skill.filePath}`,
+      drifted: isDrifted,
+      line: `- ${skill.name}${isDrifted ? DRIFT_MARKER : ""} (source: ${skill.source}; scope: ${skill.scope}): ${skill.description}`,
+      haystack: haystackForSkill(skill)
+    });
+  }
+  for (const skill of sessionSkills(input.skills)) {
+    rows.push({
+      kind: "session",
+      name: skill.name,
+      key: `session:${skill.filePath}`,
+      drifted: false,
+      line: `- ${skill.name} (source: ${skill.source}; scope: ${skill.scope}; file: ${skill.filePath}): ${skill.description}`,
+      haystack: haystackForSkill(skill)
+    });
+  }
+  for (const record of input.packages) {
+    rows.push({
+      kind: "package",
+      name: record.name,
+      key: `package:${record.scope}:${record.path}`,
+      drifted: false,
+      line: `- ${record.name} (scope: ${record.scope}; origin: ${record.origin === "catalog" ? "marketplace catalog" : record.origin}; state: ${record.state}; path: ${record.path})`,
+      haystack: haystackForPackage(record)
+    });
+  }
+  for (const entry of input.marketplace) {
+    const category = entry.category ? ` [${entry.category}]` : "";
+    rows.push({
+      kind: "marketplace",
+      name: entry.name,
+      key: `marketplace:${entry.sourceUrl}`,
+      drifted: false,
+      line: `- ${entry.name}${category}: ${entry.description}`,
+      haystack: haystackForMarketplace(entry)
+    });
+  }
+  return rows;
+}
+function selectRows(rows, query) {
+  const strict = rows.filter((row) => lexicalMatches(query, row.haystack, "all"));
+  if (strict.length > 0) return { rows: strict, mode: "all" };
+  return { rows: rows.filter((row) => lexicalMatches(query, row.haystack, "any")), mode: "any" };
+}
+function renderSections(rows, input, drift) {
+  const ready = rows.filter((row) => row.kind === "ready");
+  const session = rows.filter((row) => row.kind === "session");
+  const packages = rows.filter((row) => row.kind === "package");
+  const marketplace = rows.filter((row) => row.kind === "marketplace");
+  const lines = [LISTING_HEADER, ""];
+  lines.push(`Ready skills in Clio (${ready.length}):`);
+  if (ready.length === 0) lines.push("- none");
+  for (const row of ready) lines.push(row.line);
+  if (session.length > 0) {
+    lines.push("", SESSION_HEADER);
+    for (const row of session) lines.push(row.line);
+    lines.push(SESSION_NOTE);
+  }
+  if (packages.length > 0) {
+    lines.push("", `Installed packages providing skills (${packages.length}):`);
+    for (const row of packages) lines.push(row.line);
+  }
+  lines.push("", INTEROP_NOTE);
+  if (marketplace.length > 0) {
+    lines.push("", MARKETPLACE_HEADER);
+    for (const row of marketplace) lines.push(row.line);
+  }
+  if (drift.length > 0) lines.push("", drift);
+  lines.push("", activationProtocolLine(input.modelActivation));
+  if (marketplace.length > 0) lines.push(marketplaceOfferClause());
+  return lines.join("\n");
+}
+function clampLimit(limit, fallback) {
+  if (limit === void 0 || !Number.isFinite(limit)) return fallback;
+  return Math.max(1, Math.min(MAX_LIMIT, Math.floor(limit)));
+}
+function clampOffset(offset) {
+  if (offset === void 0 || !Number.isFinite(offset) || offset <= 0) return 0;
+  return Math.floor(offset);
+}
+function buildSkillCatalogView(input) {
+  const rawQuery = (input.query ?? "").trim();
+  const query = normalize(rawQuery).length > 0 ? rawQuery : "";
+  const emptyTerms = rawQuery.length > 0 && query.length === 0;
+  const filtered = query.length > 0;
+  const all = buildRows(input);
+  if (all.length === 0 && !filtered) {
+    return {
+      text: input.marketplaceOffered ? EMPTY_WITH_MARKETPLACE : EMPTY_WITHOUT_MARKETPLACE,
+      rows: [],
+      total: 0,
+      shown: 0,
+      nextOffset: void 0,
+      filtered: false,
+      matchMode: null,
+      budgetLimited: false,
+      driftedNames: []
+    };
+  }
+  const selected = filtered ? selectRows(all, query) : { rows: [...all], mode: null };
+  const matching = selected.rows;
+  const total = matching.length;
+  const offset = clampOffset(input.offset);
+  const limit = clampLimit(input.limit, total);
+  const window = matching.slice(offset, offset + limit);
+  const driftedNames = matching.filter((row) => row.drifted).map((row) => row.name);
+  const context = {
+    input,
+    drift: driftNotice(driftedNames),
+    filtered,
+    emptyTerms,
+    query,
+    matchMode: selected.mode,
+    total,
+    offset,
+    catalogTotal: all.length,
+    window
+  };
+  const whole = renderCandidate(context, window.length, false);
+  if (byteLength(whole) <= input.capBytes) {
+    return finishView(context, window, whole, false);
+  }
+  let low = 1;
+  let high = window.length - 1;
+  let best = -1;
+  let bestText = "";
+  while (low <= high) {
+    const mid = low + high >> 1;
+    const text = renderCandidate(context, mid, true);
+    if (byteLength(text) <= input.capBytes) {
+      best = mid;
+      bestText = text;
+      low = mid + 1;
+    } else {
+      high = mid - 1;
+    }
+  }
+  if (best >= 1) return finishView(context, window.slice(0, best), bestText, true);
+  const blocked = renderCandidate(context, 0, true);
+  if (byteLength(blocked) <= input.capBytes) {
+    return finishView(context, [], blocked, true);
+  }
+  return {
+    text: compactFallback(context),
+    rows: [],
+    total,
+    shown: 0,
+    nextOffset: void 0,
+    filtered,
+    matchMode: selected.mode,
+    budgetLimited: true,
+    driftedNames
+  };
+}
+function continuation(context, shown) {
+  const consumed = context.offset + shown;
+  if (consumed >= context.total) return { nextOffset: void 0, blocked: false };
+  if (shown === 0) return { nextOffset: context.offset + 1, blocked: true };
+  return { nextOffset: consumed, blocked: false };
+}
+function renderCandidate(context, shown, cut) {
+  const page = context.window.slice(0, shown);
+  const body = renderSections(page, context.input, context.drift);
+  const { nextOffset, blocked } = continuation(context, shown);
+  const note = pageNote({
+    filtered: context.filtered,
+    emptyTerms: context.emptyTerms,
+    query: context.query,
+    matchMode: context.matchMode,
+    total: context.total,
+    shown,
+    nextOffset,
+    budgetLimited: cut,
+    blockedRow: blocked ? context.window[0] ?? null : null,
+    catalogTotal: context.catalogTotal
+  });
+  return note.length > 0 ? `${body}
+${note}` : body;
+}
+function finishView(context, page, text, budgetLimited) {
+  const { nextOffset } = continuation(context, page.length);
+  return {
+    text,
+    rows: page.map((row) => ({ ...row })),
+    total: context.total,
+    shown: page.length,
+    nextOffset,
+    filtered: context.filtered,
+    matchMode: context.matchMode,
+    budgetLimited,
+    driftedNames: context.window.filter((row) => row.drifted).map((row) => row.name)
+  };
+}
+function compactFallback(context) {
+  const scope = context.filtered ? `${context.total} matching` : `${context.total}`;
+  return `Available skills: ${scope}. This call's budget cannot carry the listing; narrow it with context(scope="skills", query="<terms>") or raise the budget in a fresh turn.`;
+}
+function pageNote(input) {
+  const clauses = [];
+  if (input.emptyTerms) {
+    clauses.push("The query carried no searchable terms, so the full list is shown.");
+  }
+  if (input.filtered) {
+    const broadened = input.matchMode === "any" ? ", matched on any query word after no row matched them all" : "";
+    clauses.push(
+      input.total === 0 ? `No skill matches "${boundQuery(input.query)}"; ${input.catalogTotal} are available unfiltered, so drop query to list them.` : `Filtered by "${boundQuery(input.query)}"${broadened}: ${input.total} of ${input.catalogTotal} rows match.`
+    );
+  }
+  if (input.shown < input.total) {
+    clauses.push(
+      input.budgetLimited ? `Showing ${input.shown} of ${input.total} matching rows; the rest did not fit this call's budget.` : `Showing ${input.shown} of ${input.total} matching rows.`
+    );
+  }
+  if (input.blockedRow !== null) {
+    clauses.push(
+      `"${boundName(input.blockedRow.name)}" is too large to carry in this call's budget and was stepped over; open it directly with context(scope="skills", name="${boundName(input.blockedRow.name)}").`
+    );
+  }
+  if (input.nextOffset !== void 0) {
+    clauses.push(
+      input.filtered ? (
+        // Offsets index the FILTERED result set. A continuation that dropped
+        // the query would apply this cursor to the unfiltered catalog, which
+        // repeats rows and skips matches.
+        `Continue with the same query at offset=${input.nextOffset}; the offset indexes the filtered rows, so dropping query changes which rows it selects.`
+      ) : `Continue with context(scope="skills", offset=${input.nextOffset}) for the remainder.`
+    );
+  } else if (input.shown < input.total) {
+    clauses.push("The remainder cannot be carried this turn; narrow with query or continue in a follow-up turn.");
+  }
+  return clauses.join(" ");
+}
+
 // src/domains/resources/skills/evals.ts
 init_esm_shims();
 var SCENARIO_HEADING = /^##\s+([A-Z])(\d+)\s*[-:–—]\s*(.+?)\s*$/;
@@ -590,26 +901,34 @@ function loadSkillPinManifest(manifestPath) {
   return entries;
 }
 function checkSkillDrift(skill, cwd) {
-  const actual = skill.normalizedHash.toLowerCase();
+  return checkSkillDriftBatch([skill], cwd).get(skill.name) ?? null;
+}
+function checkSkillDriftBatch(skills, cwd) {
+  const reports = /* @__PURE__ */ new Map();
+  if (skills.length === 0) return reports;
   const manifestPath = resolveSkillPinManifestPath(cwd);
   const manifest = manifestPath === null ? null : loadSkillPinManifest(manifestPath);
-  const pinned = manifest?.get(skill.name);
-  if (pinned !== void 0) {
-    return {
-      verdict: pinned.sha256 === actual ? "match" : "mismatch",
-      authority: "pinned-manifest",
-      expected: pinned.sha256
-    };
-  }
-  const recorded = skill.provenance?.installedHash?.trim().toLowerCase();
-  if (recorded !== void 0 && /^[0-9a-f]{64}$/.test(recorded)) {
-    return {
-      verdict: recorded === actual ? "match" : "mismatch",
-      authority: "install-record",
-      expected: recorded
-    };
+  for (const skill of skills) {
+    const actual = skill.normalizedHash.toLowerCase();
+    const pinned = manifest?.get(skill.name);
+    if (pinned !== void 0) {
+      reports.set(skill.name, {
+        verdict: pinned.sha256 === actual ? "match" : "mismatch",
+        authority: "pinned-manifest",
+        expected: pinned.sha256
+      });
+      continue;
+    }
+    const recorded = skill.provenance?.installedHash?.trim().toLowerCase();
+    if (recorded !== void 0 && /^[0-9a-f]{64}$/.test(recorded)) {
+      reports.set(skill.name, {
+        verdict: recorded === actual ? "match" : "mismatch",
+        authority: "install-record",
+        expected: recorded
+      });
+    }
   }
-  return null;
+  return reports;
 }
 
 // src/domains/resources/index.ts
@@ -627,11 +946,13 @@ function createResourcesDomainModule(options = {}) {
 export {
   createResourcesLoader,
   ResourcesManifest,
+  buildSkillCatalogView,
   parseSkillEvals,
   parseSkillSourceSpec,
   updateSkills,
   checkSkillDrift,
+  checkSkillDriftBatch,
   ResourcesDomainModule,
   createResourcesDomainModule
 };
-//# sourceMappingURL=chunk-4WOOTKFD.js.map
+//# sourceMappingURL=chunk-U3FETNQB.js.map

package/dist/{chunk-5B3RTYAK.js → chunk-UGDSB4AN.js}

@@ -2,7 +2,7 @@ import { createRequire as __clioCreateRequire } from "node:module"; const requir
 import {
   gateDecisionsDirectory,
   verifyGateDecisionArtifact
-} from "./chunk-OV62D6KO.js";
+} from "./chunk-KQMYL5GR.js";
 import {
   clioStateDir
 } from "./chunk-CTTI7G3T.js";
@@ -120,4 +120,4 @@ export {
   GATE_TOPOLOGY_MAX_SUBJECTS,
   gateTopology
 };
-//# sourceMappingURL=chunk-5B3RTYAK.js.map
+//# sourceMappingURL=chunk-UGDSB4AN.js.map

package/dist/{chunk-VKHLUZNO.js → chunk-UZ7YBL43.js}

@@ -4,10 +4,10 @@ import {
   isRouteDecisionAgentSelection,
   isRoutingIntent,
   parseWorkerContextProvenance
-} from "./chunk-T33IYTZM.js";
+} from "./chunk-SAASVMIY.js";
 import {
   isExecutionRole
-} from "./chunk-BRCOSE7O.js";
+} from "./chunk-SZUO5BSE.js";
 import {
   init_esm_shims
 } from "./chunk-ECBHH7LU.js";
@@ -983,4 +983,4 @@ export {
   adaptGroundedEvidenceValidationStatus,
   adaptFinishContractCompletionStatus
 };
-//# sourceMappingURL=chunk-VKHLUZNO.js.map
+//# sourceMappingURL=chunk-UZ7YBL43.js.map

package/dist/{chunk-OXWRE2QJ.js → chunk-VKMSEO7Y.js}

@@ -1,13 +1,13 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   inspectEvidence
-} from "./chunk-7FHSA7VB.js";
+} from "./chunk-EQPFEDFV.js";
 import {
   trustVerdict
-} from "./chunk-OZ76TLGU.js";
+} from "./chunk-EEITU7S6.js";
 import {
   TRUST_STATUS_AXES
-} from "./chunk-VKHLUZNO.js";
+} from "./chunk-UZ7YBL43.js";
 import {
   clioDataDir
 } from "./chunk-CTTI7G3T.js";
@@ -43,4 +43,4 @@ export {
   EVIDENCE_DETAIL_MAX_RUNS,
   evidenceDetailSnapshot
 };
-//# sourceMappingURL=chunk-OXWRE2QJ.js.map
+//# sourceMappingURL=chunk-VKMSEO7Y.js.map

package/dist/{chunk-FBXTHPNZ.js → chunk-VLX5VZ35.js}

@@ -19,7 +19,7 @@ import {
 } from "./chunk-TKDRT2DF.js";
 import {
   loadSkills
-} from "./chunk-LAR7DX5E.js";
+} from "./chunk-B5TASTCK.js";
 import {
   credentialsPresent
 } from "./chunk-DVTBERFY.js";
@@ -30,10 +30,10 @@ import {
 } from "./chunk-Z4GLJ6J4.js";
 import {
   isSessionEntry
-} from "./chunk-I4Y4WKZR.js";
+} from "./chunk-F6KCJO3U.js";
 import {
   readSessionFileEntries
-} from "./chunk-EKV4UBCM.js";
+} from "./chunk-PZBQUJ2F.js";
 import {
   interopAgentKind
 } from "./chunk-5EQO5NWP.js";
@@ -360,7 +360,7 @@ async function runDoctorFleetChecks(projectRoot = process.cwd(), options = {}) {
   }
   const nodes = settings.fleet?.nodes ?? [];
   if (nodes.length === 0) return [];
-  const { recordFleetPreflight, runFleetNodePreflight } = await import("./fleet-preflight-KSIHWQAU.js");
+  const { recordFleetPreflight, runFleetNodePreflight } = await import("./fleet-preflight-44UNCC4Y.js");
   const targets = (settings.targets ?? []).map((target) => ({
     id: target.id,
     runtimeId: target.runtime,
@@ -579,4 +579,4 @@ export {
   runDoctorRuntimeChecks,
   runDoctorModelChecks
 };
-//# sourceMappingURL=chunk-FBXTHPNZ.js.map
+//# sourceMappingURL=chunk-VLX5VZ35.js.map

package/dist/{chunk-KIAUZGKF.js → chunk-WAGBMMNX.js}

@@ -7,20 +7,20 @@ import {
 import {
   openLedger,
   readFleetRun
-} from "./chunk-7FHSA7VB.js";
+} from "./chunk-EQPFEDFV.js";
 import {
   WRITE_BOUNDARY_VIOLATION_REASON
-} from "./chunk-DXSETN72.js";
+} from "./chunk-7WUGNN43.js";
 import {
   formatTrustSummaryLine
-} from "./chunk-OZ76TLGU.js";
+} from "./chunk-EEITU7S6.js";
 import {
   readRunEventJournal,
   runEventJournalPath
 } from "./chunk-UQIVHSE4.js";
 import {
   inspectRunReceiptTrustStatus
-} from "./chunk-VKHLUZNO.js";
+} from "./chunk-UZ7YBL43.js";
 import {
   sanitizeCallTargetText
 } from "./chunk-XNIZBOFV.js";
@@ -572,4 +572,4 @@ export {
   loadFleetRunViewModel,
   runFleetView
 };
-//# sourceMappingURL=chunk-KIAUZGKF.js.map
+//# sourceMappingURL=chunk-WAGBMMNX.js.map

package/dist/{chunk-BFOSV5EZ.js → chunk-WX2YCH7F.js}

@@ -1,7 +1,7 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   estimateInputTokensFromContext
-} from "./chunk-EYTLV3W3.js";
+} from "./chunk-HTWTORF7.js";
 import {
   normalizeContext,
   streamSimple
@@ -175,4 +175,4 @@ export {
   runPrewarmRound,
   recordStartupDiagnostic
 };
-//# sourceMappingURL=chunk-BFOSV5EZ.js.map
+//# sourceMappingURL=chunk-WX2YCH7F.js.map

package/dist/{chunk-SAL2SBP4.js → chunk-XBIGUILU.js}

@@ -18,10 +18,10 @@ import {
 import {
   acceptanceFromTaskFlags,
   formatUserTaskHandoff
-} from "./chunk-ISHUS7HC.js";
+} from "./chunk-JRW236JT.js";
 import {
   createWorkerProgressFold
-} from "./chunk-HOEDA42N.js";
+} from "./chunk-T7HZ7KJF.js";
 import {
   SETTINGS_SECTIONS,
   resolveSettingsSection
@@ -31,31 +31,31 @@ import {
   WORKER_OUTPUT_MAX_BYTES,
   activeDecisionRefs,
   decisionRationale
-} from "./chunk-U5QU5ZOD.js";
+} from "./chunk-XYPWFSU5.js";
 import {
   SKILL_SURFACE_CLEAR_ARG,
   parseSkillCommand
-} from "./chunk-LAR7DX5E.js";
+} from "./chunk-B5TASTCK.js";
 import {
   isLibraryKind
 } from "./chunk-NVPXXW2H.js";
 import {
   TOOL_PROFILE_NAMES,
   isToolProfileName
-} from "./chunk-XZWSP67B.js";
+} from "./chunk-5APYAXCB.js";
 import {
   requestExecutionRole
-} from "./chunk-BRCOSE7O.js";
+} from "./chunk-SZUO5BSE.js";
 import {
   truncateUtf8
 } from "./chunk-MYI32N4R.js";
 import {
   resolveModelReference
-} from "./chunk-EYTLV3W3.js";
+} from "./chunk-HTWTORF7.js";
 import {
   parseCouncilReport,
   parseOracleResult
-} from "./chunk-LNOXCGN2.js";
+} from "./chunk-7UFDIOBT.js";
 import {
   THINKING_LEVELS
 } from "./chunk-QZTTRSJE.js";
@@ -1890,9 +1890,10 @@ ${usage}` : usage);
     name: "context",
     description: "Context hub: window overlay plus compact, recall, init, refresh, and reset",
     group: "Inspect",
-    kinds: ["context-view", "compact", "context-recall", "init", "context-clear", "context-refresh"],
+    kinds: ["context-view", "compact", "context-recover", "context-recall", "init", "context-clear", "context-refresh"],
     subcommandDescriptions: {
       compact: "Compact session context",
+      recover: "Recover a paused handoff: ID reduce|deliver",
       recall: "Recall an evicted result",
       init: "Initialize project context",
       refresh: "Refresh project context",
@@ -1901,6 +1902,12 @@ ${usage}` : usage);
     args: {
       subcommands: {
         compact: { positionals: [...COMPACT_POSITIONALS] },
+        recover: {
+          positionals: [
+            { name: "handoffId", required: true },
+            { name: "action", required: true }
+          ]
+        },
         recall: { positionals: [...RECALL_POSITIONALS] },
         init: {
           flags: CONTEXT_INIT_FLAG_TABLE.flatMap(({ flag, aliases = [] }) => [flag, ...aliases].map((name) => ({ name })))
@@ -1914,6 +1921,10 @@ ${usage}` : usage);
       switch (parsed.subcommand) {
         case "compact":
           return { kind: "compact", instructions: parsed.rest };
+        case "recover": {
+          const [handoffId, action] = parsed.positionals;
+          return handoffId && (action === "reduce" || action === "deliver") ? { kind: "context-recover", handoffId, action } : { kind: "usage-error", command: "context", reason: "Use /context recover <handoffId> <reduce|deliver>" };
+        }
         case "recall":
           return { kind: "context-recall", ref: parsed.positionals[0] ?? "" };
         case "init": {
@@ -1940,6 +1951,10 @@ ${usage}` : usage);
         case "compact":
           ctx.runCompact(command.instructions);
           return;
+        case "context-recover":
+          if (ctx.runHandoffRecovery) ctx.runHandoffRecovery(command.handoffId, command.action);
+          else ctx.notice("error", "native handoff recovery is unavailable");
+          return;
         case "context-recall":
           if (ctx.runContextRecall) {
             ctx.runContextRecall(command.ref);
@@ -2793,4 +2808,4 @@ export {
   dispatchSlashCommand,
   commandReference
 };
-//# sourceMappingURL=chunk-SAL2SBP4.js.map
+//# sourceMappingURL=chunk-XBIGUILU.js.map