@iowarp/clio-coder 0.5.0 → 0.5.2

package/dist/{chunk-OQ2EOAHA.js → chunk-PF36KOGI.js}

@@ -2,7 +2,7 @@ import { createRequire as __clioCreateRequire } from "node:module"; const requir
 import {
   createTaskBoardStore,
   taskBoardCounts
-} from "./chunk-NDPF2N2L.js";
+} from "./chunk-7DW7CJW2.js";
 import {
   CONFIRMED_SCOPE,
   READONLY_SCOPE,
@@ -20,7 +20,7 @@ import {
   parseWorkerContextProvenance,
   routePriorForLatencyClass,
   sameRouteIdentity
-} from "./chunk-T33IYTZM.js";
+} from "./chunk-SAASVMIY.js";
 import {
   isLoadableExtension
 } from "./chunk-OH3YYA3B.js";
@@ -41,17 +41,17 @@ import {
   TOOL_PROFILE_NAMES,
   applyToolProfile,
   isToolProfileName
-} from "./chunk-XZWSP67B.js";
+} from "./chunk-5APYAXCB.js";
 import {
   deriveExecutionRole,
   isExecutionRole,
   requestExecutionRole
-} from "./chunk-BRCOSE7O.js";
+} from "./chunk-SZUO5BSE.js";
 import {
   McpError,
   createMcpStdioClient,
   resolveMcpServers
-} from "./chunk-55RMDDFM.js";
+} from "./chunk-PGQG7ZMW.js";
 import {
   isDispatchIntent,
   resolveDispatchPathScope
@@ -59,16 +59,20 @@ import {
 import {
   clioDocsToolSurface,
   clioLibraryToolSurface
-} from "./chunk-TDGYTWM6.js";
+} from "./chunk-F4I3H56H.js";
 import {
   contextToolSurface
-} from "./chunk-CTFPFW3H.js";
+} from "./chunk-Q6FRR3AQ.js";
 import {
   gatewayCapabilityKind,
   toolPlacement,
   toolSpecPlacement,
   withGatewayForCapabilities
-} from "./chunk-DE2LU267.js";
+} from "./chunk-KKAJGT3B.js";
+import {
+  distinctiveTokens,
+  normalize
+} from "./chunk-H7REJ7L5.js";
 import {
   runScriptToolSurface
 } from "./chunk-YYLCPDCC.js";
@@ -79,24 +83,24 @@ import {
   networkToolsDisabled,
   webFetchToolSurface,
   webReadToolSurface
-} from "./chunk-KBUTSJSR.js";
+} from "./chunk-4XBYHXGK.js";
 import {
   detectSupportedImageMimeType,
   prepareBoundedImage,
   verifyToolSurface
-} from "./chunk-YBUECLAF.js";
+} from "./chunk-YEJQDODA.js";
 import {
   gitTool
-} from "./chunk-CRHPCPZP.js";
+} from "./chunk-4KC4CHKJ.js";
 import {
   DATA_OBSERVATION_SELF_CAP_BYTES,
   GATEWAY_FIND_SELF_CAP_BYTES,
   dataToolSurface,
   prepareDataAdmissionArguments
-} from "./chunk-FFYTC2KQ.js";
+} from "./chunk-MNABNEBX.js";
 import {
   codeNavToolSurface
-} from "./chunk-UJD5MPP6.js";
+} from "./chunk-FLNXQQ5B.js";
 import {
   compileGlobRegex,
   fallbackIgnoredDirs,
@@ -123,11 +127,11 @@ import {
   toolResultContextText,
   toolResultDigestFor,
   writeToolOffload
-} from "./chunk-OPD7GL6F.js";
+} from "./chunk-H6FQVNZC.js";
 import {
   createSafetyPolicyEngine,
   formatModelRejection
-} from "./chunk-733ZBT5P.js";
+} from "./chunk-E74MJF6G.js";
 import {
   DEFAULT_MAX_LINES,
   splitLinesForCounting,
@@ -157,7 +161,7 @@ import {
 } from "./chunk-W53XSRQE.js";
 import {
   ceilChars
-} from "./chunk-6W75D37F.js";
+} from "./chunk-53P775GE.js";
 import {
   StringEnum,
   validateEngineToolArguments
@@ -166,16 +170,8 @@ import {
   incompleteInstallationAdvice
 } from "./chunk-HMN2C6YL.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,
-  SKILL_SUGGESTION_PREFIX,
-  decisionRef,
-  evaluateSkillToolSurface,
-  skillActivationFromToolDetails
-} from "./chunk-I4Y4WKZR.js";
+  decisionRef
+} from "./chunk-F6KCJO3U.js";
 import {
   DEFAULT_AUTONOMY_EXPOSURE,
   DEFAULT_AUTONOMY_LEVEL,
@@ -184,6 +180,16 @@ import {
   isAutonomyLevel,
   mapAutonomy
 } from "./chunk-UZVYEF57.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,
+  SKILL_SUGGESTION_PREFIX,
+  evaluateSkillToolSurface,
+  skillActivationFromToolDetails
+} from "./chunk-MMZMM6SW.js";
 import {
   assertSafeId
 } from "./chunk-UHW5V7HC.js";
@@ -195,18 +201,18 @@ import {
   parseAgentLedgerBody,
   parseResultSummaryMaxBytes,
   toolSignatureOf
-} from "./chunk-LNOXCGN2.js";
+} from "./chunk-7UFDIOBT.js";
 import {
   extensionContentDigestWithCapture
 } from "./chunk-BJH6WFIB.js";
 import {
   classify,
   webFetchIsOutward
-} from "./chunk-VYRQHORQ.js";
+} from "./chunk-NMQSO6Z6.js";
 import {
   detectValidationCommand,
   protectedArtifactMutationBlockReason
-} from "./chunk-P4GNZPXO.js";
+} from "./chunk-OYUS3UZP.js";
 import {
   asDirectoryPathBoundary,
   pathBoundaryCovers,
@@ -231,7 +237,7 @@ import {
   isBuiltinToolName,
   isMcpToolName,
   mcpToolName
-} from "./chunk-V4XJWDHR.js";
+} from "./chunk-6UKFRTXI.js";
 import {
   THINKING_LEVELS
 } from "./chunk-QZTTRSJE.js";
@@ -5497,51 +5503,6 @@ import { randomUUID as randomUUID2 } from "node:crypto";
 init_esm_shims();
 import { existsSync, readFileSync as readFileSync2 } from "node:fs";
 import path3 from "node:path";
-var TOKEN_STOPWORDS = /* @__PURE__ */ new Set([
-  "the",
-  "a",
-  "an",
-  "and",
-  "or",
-  "for",
-  "with",
-  "this",
-  "that",
-  "when",
-  "what",
-  "how",
-  "into",
-  "from",
-  "use",
-  "used",
-  "using",
-  "one",
-  "not",
-  "skill",
-  "skills",
-  "clio",
-  "please",
-  "can",
-  "you",
-  "should",
-  "would",
-  "about",
-  "need",
-  "want",
-  "help",
-  "make",
-  "file",
-  "files",
-  "code"
-]);
-function normalize(text) {
-  return text.toLowerCase().replace(/[^\p{L}\p{N}\s]/gu, " ").replace(/\s+/g, " ").trim();
-}
-function distinctiveTokens(text) {
-  return new Set(
-    normalize(text).split(" ").filter((token) => token.length >= 4 && !TOKEN_STOPWORDS.has(token))
-  );
-}
 var TRIGGER_SCORE = 4;
 var TOKEN_FIRE_THRESHOLD = 3;
 function scorePromotionEntry(userText, entry) {
@@ -6557,6 +6518,155 @@ function nonNegativeFinite(value) {
 // src/domains/middleware/memory-intervention.ts
 init_esm_shims();
 import { createHash as createHash3 } from "node:crypto";
+
+// src/domains/memory/commit-state.ts
+init_esm_shims();
+
+// src/domains/memory/restoration.ts
+init_esm_shims();
+var PREFIX = "Memory: remembered execution context (unverified; current instructions take precedence).\n";
+function renderMemoryRestoration(input) {
+  const hasCurrentState = input.currentState !== null && input.currentState.text.trim().length > 0;
+  const source = [
+    ...!hasCurrentState && input.bank.status !== null ? [input.bank.status] : [],
+    ...input.bank.knowledge,
+    ...input.bank.procedural
+  ].sort((a, b) => {
+    const status = Number(b.kind === "status") - Number(a.kind === "status");
+    return status || b.lastTouchedAt.localeCompare(a.lastTouchedAt) || a.id.localeCompare(b.id);
+  });
+  const groups = /* @__PURE__ */ new Map();
+  for (const entry of source) {
+    const content = entry.content.replace(/\s+/gu, " ").trim();
+    const group = groups.get(content);
+    if (group) {
+      if (!group.ids.includes(entry.id)) group.ids.push(entry.id);
+      group.kinds.add(entry.kind);
+    } else groups.set(content, { ids: [entry.id], kinds: /* @__PURE__ */ new Set([entry.kind]), content: entry.content });
+  }
+  const lines = [];
+  const cited = [];
+  const omitted = hasCurrentState && input.bank.status !== null ? [input.bank.status.id] : [];
+  const validBudget = Number.isFinite(input.maxTokens) && input.maxTokens > 0;
+  for (const [content, group] of groups) {
+    const kinds = [...group.kinds].sort().map((kind) => kind === "status" ? "historical status" : `remembered ${kind}`).join("/");
+    const line = `- ${group.ids.map((id) => `[${id}]`).join(" ")} ${kinds}: ${JSON.stringify(group.content)}`;
+    const candidate = PREFIX + [...lines, line].join("\n");
+    if (!validBudget || content.length === 0 || ceilChars(candidate.length) > input.maxTokens) {
+      omitted.push(...group.ids);
+      continue;
+    }
+    lines.push(line);
+    cited.push(...group.ids);
+  }
+  const message = lines.length > 0 ? PREFIX + lines.join("\n") : "";
+  return Object.freeze({
+    message,
+    tokens: ceilChars(message.length),
+    citedEntryIds: Object.freeze(cited),
+    omittedEntryIds: Object.freeze(omitted)
+  });
+}
+
+// src/domains/memory/commit-state.ts
+var MemoryCommitState = class {
+  #scope;
+  #generation;
+  #commitEpoch = 0;
+  #disposed = false;
+  #seen = /* @__PURE__ */ new Map();
+  #pending = null;
+  #issued = null;
+  constructor(scope, generation) {
+    assertScope(scope);
+    assertGeneration(generation);
+    this.#scope = copyScope(scope);
+    this.#generation = generation;
+  }
+  capture() {
+    return Object.freeze({ generation: this.#generation, commitEpoch: this.#commitEpoch });
+  }
+  isCurrent(stamp, scope) {
+    return !this.#disposed && this.#matches(scope, stamp.generation) && stamp.commitEpoch === this.#commitEpoch;
+  }
+  notifyContextCommitted(input, generation) {
+    if (this.#disposed) return "disposed";
+    if (!this.#matches(input, generation)) {
+      return generation === this.#generation && this.#seen.has(input.commitId) ? "conflict" : "stale";
+    }
+    if (input.commitId.trim().length === 0) throw new Error("memory commit identity must be nonblank");
+    const previous = this.#seen.get(input.commitId);
+    if (previous !== void 0) return previous === input.outcome ? "duplicate" : "conflict";
+    if (this.#commitEpoch === Number.MAX_SAFE_INTEGER) throw new Error("memory commit epoch exhausted");
+    this.#seen.set(input.commitId, input.outcome);
+    this.#commitEpoch += 1;
+    this.#pending = input.commitId;
+    this.#issued = null;
+    return "accepted";
+  }
+  prepareRestoration(input) {
+    if (this.#disposed || !this.#matches(input.scope, input.generation) || this.#pending === null) return null;
+    const rendered = renderMemoryRestoration(input);
+    this.#issued = Object.freeze({
+      ...rendered,
+      commitId: this.#pending,
+      scope: this.#scope,
+      authority: this.capture()
+    });
+    return this.#issued;
+  }
+  /** Host calls only after installing the exact offered bytes into its admitted context. */
+  acknowledgeRestoration(offer, scope, generation) {
+    if (this.#disposed || offer !== this.#issued || !this.#matches(scope, generation) || !this.isCurrent(offer.authority, offer.scope))
+      return false;
+    this.#pending = null;
+    this.#issued = null;
+    return true;
+  }
+  /** Caller supplies a strictly newer generation; no bank reset and no new commit epoch. */
+  cancel(generation) {
+    if (this.#disposed || !validGeneration(generation) || generation <= this.#generation) return false;
+    this.#generation = generation;
+    this.#issued = null;
+    return true;
+  }
+  /** Navigation is explicit even when returning to the same session/branch identity. */
+  reset(scope, generation) {
+    if (this.#disposed || !validGeneration(generation) || generation <= this.#generation) return false;
+    assertScope(scope);
+    this.#scope = copyScope(scope);
+    this.#generation = generation;
+    this.#commitEpoch = 0;
+    this.#seen.clear();
+    this.#pending = null;
+    this.#issued = null;
+    return true;
+  }
+  dispose() {
+    this.#disposed = true;
+    this.#seen.clear();
+    this.#pending = null;
+    this.#issued = null;
+  }
+  #matches(scope, generation) {
+    return generation === this.#generation && scope.sessionId === this.#scope.sessionId && scope.branchAnchorTurnId === this.#scope.branchAnchorTurnId;
+  }
+};
+function validGeneration(value) {
+  return Number.isSafeInteger(value) && value >= 0;
+}
+function assertGeneration(value) {
+  if (!validGeneration(value)) throw new Error("memory generation must be a nonnegative safe integer");
+}
+function assertScope(scope) {
+  if (scope.sessionId.trim().length === 0 || scope.branchAnchorTurnId !== null && scope.branchAnchorTurnId.trim().length === 0)
+    throw new Error("memory scope identities must be nonblank");
+}
+function copyScope(scope) {
+  return Object.freeze({ sessionId: scope.sessionId, branchAnchorTurnId: scope.branchAnchorTurnId });
+}
+
+// src/domains/middleware/memory-intervention.ts
 var MEMORY_INTERVENTION_REGISTRATION_ID = "observer.memory-intervention";
 var MEMORY_INTERVENTION_DEFAULT_WINDOW_STEPS = 8;
 var MEMORY_INTERVENTION_DEFAULT_MAX_TOKENS = 2e3;
@@ -6567,6 +6677,16 @@ var CALL_DESCRIPTION_MAX_CHARS = 180;
 var NO_EFFECTS3 = [];
 function createMemoryInterventionRegistration(deps) {
   let generation = 0;
+  let commitState = null;
+  let commitScope = null;
+  let commitBridgeEnabled = false;
+  const captureContentGuard = () => {
+    const capturedGeneration = generation;
+    const owner = commitState;
+    const scope = commitScope;
+    const stamp = owner?.capture();
+    return () => !disposed && generation === capturedGeneration && commitState === owner && (!owner || !!stamp && !!scope && owner.isCurrent(stamp, scope));
+  };
   let generationController = new AbortController();
   let observedSessionId;
   let disposed = false;
@@ -6594,6 +6714,34 @@ function createMemoryInterventionRegistration(deps) {
   let annotatedSinceTurnEnd = false;
   let consecutiveLlmTimeouts = 0;
   return {
+    bindCommitScope(scope) {
+      commitBridgeEnabled = true;
+      if (commitScope?.sessionId === scope.sessionId && commitScope.branchAnchorTurnId === scope.branchAnchorTurnId && commitState)
+        return;
+      if (commitState) reset();
+      commitScope = { ...scope };
+      commitState = new MemoryCommitState(scope, generation);
+      observedSessionId = scope.sessionId;
+    },
+    notifyContextCommitted(input) {
+      commitState?.notifyContextCommitted(input, generation);
+    },
+    prepareRestoration(currentState, maxTokens) {
+      if (!commitScope || !settings().enabled) return null;
+      return commitState?.prepareRestoration({
+        scope: commitScope,
+        generation,
+        bank: deps.bank.snapshot(),
+        currentState,
+        maxTokens: Math.min(maxTokens, settings().maxTokens)
+      }) ?? null;
+    },
+    acknowledgeRestoration(offer) {
+      if (!commitScope || !commitState?.acknowledgeRestoration(offer, commitScope, generation)) return false;
+      deps.bank.recordInjection(offer.citedEntryIds);
+      return true;
+    },
+    isContentCurrent: captureContentGuard,
     reset,
     dispose() {
       disposed = true;
@@ -6637,7 +6785,7 @@ function createMemoryInterventionRegistration(deps) {
           }
           case "on_compaction":
             if (input.metadata?.stage === "working_set_recall") return NO_EFFECTS3;
-            reactivateAfterCompaction = true;
+            if (!commitBridgeEnabled) reactivateAfterCompaction = true;
             return NO_EFFECTS3;
           case "turn_start": {
             if (input.text?.trim()) currentTask = shortText(input.text, 2e3);
@@ -6711,17 +6859,18 @@ function createMemoryInterventionRegistration(deps) {
       ) ?? false);
       rulesInjectedSincePromptedStep = false;
       const stepGeneration = generation;
+      const contentCurrent = captureContentGuard();
       promptedStepInFlight = true;
       outstandingStep = runPromptedStep({
         deterministicTrigger: triggers.some((trigger) => trigger !== "interval"),
         suppressIntervention: rulesAlreadySpoke,
         triggerReasons: triggers
       }).then((result) => {
-        if (stepGeneration !== generation || disposed) return;
+        if (!contentCurrent()) return;
         if (rulesAlreadySpoke && result.decision === "silent") lastDecision = "injected";
         if (result.reminder === null) return;
         lastInjectedMessage = result.reminder;
-        deps.onDeferredReminder?.(result.reminder);
+        deps.onDeferredReminder?.(result.reminder, contentCurrent);
       }).catch(() => {
       }).finally(() => {
         if (stepGeneration === generation) promptedStepInFlight = false;
@@ -6746,6 +6895,7 @@ function createMemoryInterventionRegistration(deps) {
     if (!promptedStepInFlight && pendingTriggers.size === 0 && toolStep <= lastTurnEndStep) return;
     const tier = promptedStepInFlight ? promptedStepTier : "rules";
     generation += 1;
+    commitState?.cancel(generation);
     generationController.abort();
     generationController = new AbortController();
     promptedStepInFlight = false;
@@ -6760,6 +6910,9 @@ function createMemoryInterventionRegistration(deps) {
     emitTelemetry(["turn_end"], tier, "silent", "scope_changed", 0, 0, 0, process.hrtime.bigint());
   }
   function reset() {
+    commitState?.dispose();
+    commitState = null;
+    commitScope = null;
     generation += 1;
     generationController.abort();
     generationController = new AbortController();
@@ -6816,7 +6969,8 @@ function createMemoryInterventionRegistration(deps) {
     });
     const live = settings();
     const stepGeneration = generation;
-    const isCurrent = () => !disposed && stepGeneration === generation;
+    const isCurrent = captureContentGuard();
+    const isUsageCurrent = () => !disposed && stepGeneration === generation;
     const usageSink = deps.captureStepUsage?.();
     if (disposed || !live.enabled) {
       const result = silent("no_client");
@@ -6849,7 +7003,7 @@ function createMemoryInterventionRegistration(deps) {
             isCurrent,
             signal: generationController.signal,
             onStepUsage: (usage) => {
-              if (usageSink) usageSink(usage, isCurrent());
+              if (usageSink) usageSink(usage, isUsageCurrent());
               else deps.onStepUsage?.(usage);
             },
             task: input.task?.trim() || currentTask,
@@ -6860,7 +7014,11 @@ function createMemoryInterventionRegistration(deps) {
             ...input.suppressIntervention === void 0 ? {} : { suppressIntervention: input.suppressIntervention },
             previousReminder: lastInjectedMessage,
             timeoutMs,
-            ...deps.onEnvelope === void 0 ? {} : { onEnvelope: deps.onEnvelope }
+            ...deps.onEnvelope === void 0 ? {} : {
+              onEnvelope: (envelope) => {
+                if (isCurrent()) deps.onEnvelope?.(envelope);
+              }
+            }
           });
           const remainingMs = () => Math.floor(live.timeoutMs - Number(process.hrtime.bigint() - started) / 1e6);
           const initialTimeoutMs = remainingMs();
@@ -6894,17 +7052,18 @@ function createMemoryInterventionRegistration(deps) {
       }
     } catch (error) {
       promptedResult = silent("client_error");
-      deps.onEnvelope?.({
-        systemPrompt: "",
-        userPrompt: "",
-        response: "",
-        decision: "silent",
-        reason: "client_error",
-        bankOperations: 0,
-        droppedOperations: 0,
-        reminder: null,
-        error: error instanceof Error ? error.message : "resolving the background model client failed"
-      });
+      if (isCurrent())
+        deps.onEnvelope?.({
+          systemPrompt: "",
+          userPrompt: "",
+          response: "",
+          decision: "silent",
+          reason: "client_error",
+          bankOperations: 0,
+          droppedOperations: 0,
+          reminder: null,
+          error: error instanceof Error ? error.message : "resolving the background model client failed"
+        });
     }
     if (!isCurrent()) return { ...promptedResult, reminder: null, effects: NO_EFFECTS3 };
     if (promptedResult.reason === "endpoint_busy") telemetryDecision = "dropped";
@@ -7011,17 +7170,23 @@ function createMemoryInterventionRegistration(deps) {
     };
     trajectory.push(step);
     if (trajectory.length > live.windowSteps) trajectory.splice(0, trajectory.length - live.windowSteps);
+    if (input.metadata?.resultKind === "ok") {
+      failures.delete(step.operationFingerprint);
+      annotatedThisTurn.delete(step.operationFingerprint);
+      if (lastInjectedOperationFingerprint === step.operationFingerprint) lastInjectedOperationFingerprint = null;
+    }
     if (outcome !== "error") return NO_EFFECTS3;
     rememberFailure(step);
     return annotateRepeatedFailure(step);
   }
   function annotateRepeatedFailure(step) {
     if (annotatedThisTurn.has(step.operationFingerprint)) return NO_EFFECTS3;
+    const failure = failures.get(step.operationFingerprint);
+    if (failure === void 0) return NO_EFFECTS3;
     const occurrences = trajectory.filter(
-      (candidate) => candidate.outcome === "error" && candidate.operationFingerprint === step.operationFingerprint
+      (candidate) => candidate.outcome === "error" && candidate.operationFingerprint === step.operationFingerprint && candidate.step >= failure.firstStep
     ).length;
-    const failure = failures.get(step.operationFingerprint);
-    if (occurrences < 2 || failure === void 0) return NO_EFFECTS3;
+    if (occurrences < 2) return NO_EFFECTS3;
     const message = boundedReminder(
       `Memory: [${failure.entryId}] you already tried ${failure.callDescription} at step ${failure.firstStep} and it failed with ${failure.errorDigest}. Change the approach rather than repeating it.`,
       settings().maxTokens
@@ -7071,11 +7236,12 @@ function createMemoryInterventionRegistration(deps) {
         if (step === void 0 || step.outcome !== "error" || step.step <= lastTurnEndStep || step.operationFingerprint === lastInjectedOperationFingerprint) {
           continue;
         }
+        const failure = failures.get(step.operationFingerprint);
+        if (failure === void 0 || step.step < failure.firstStep) continue;
         const occurrences = trajectory.filter(
-          (candidate) => candidate.outcome === "error" && candidate.operationFingerprint === step.operationFingerprint
+          (candidate) => candidate.outcome === "error" && candidate.operationFingerprint === step.operationFingerprint && candidate.step >= failure.firstStep
         ).length;
-        const failure = failures.get(step.operationFingerprint);
-        if (occurrences < 2 || failure === void 0) continue;
+        if (occurrences < 2) continue;
         const message = boundedReminder(
           `Memory: [${failure.entryId}] you already tried ${failure.callDescription} at step ${failure.firstStep} and it failed with ${failure.errorDigest}.`,
           settings().maxTokens
@@ -8506,7 +8672,9 @@ function resolveSessionTools(runtime, toolRegistry, invokeOptions, telemetry) {
     supportsImages: runtime.runtimeResolution.capabilityDecisions.vision === true
   });
   if (telemetry) input.telemetry = telemetry;
-  return resolveAgentTools(input);
+  return resolveAgentTools(input).filter(
+    (tool) => tool.name !== ToolNames.SelfCompact || !runtime.runtimeResolution.runtime.externalAgentLoop
+  );
 }
 
 // src/tools/core-bootstrap.ts
@@ -9578,6 +9746,14 @@ var TOOL_METADATA = {
     costLatency: "local_fast",
     promptHint: "Use code_nav with source=workspace (default) for project code and source=clio for Clio's shipped code map; modes: symbol, path, entries, outline, deps, dependents, wiki (workspace only)."
   },
+  [ToolNames.SelfCompact]: {
+    objective: "Save an exact assistant handoff and reduce native session context.",
+    uiLabel: "Compact",
+    retrySafety: "not_retry_safe",
+    resultSizePolicy: { kind: "exact", maxBytes: 2048 },
+    costLatency: "local_fast",
+    promptHint: 'Use self_compact alone at a safe boundary. Preserve decisions, evidence, paths, and next actions in note_to_self. Inspect context(scope="budget") for current pressure; recovery belongs to the operator.'
+  },
   [ToolNames.Context]: {
     objective: "Return workspace, effective configuration, skill, or recall context.",
     uiLabel: "Context",
@@ -11261,7 +11437,7 @@ var evidenceTool = {
     try {
       const dataDir = clioDataDir();
       if (mode === "list") {
-        const { evidenceInventorySnapshot } = await import("./inventory-OEGIL6PY.js");
+        const { evidenceInventorySnapshot } = await import("./inventory-3JUGLVJI.js");
         return boundedResult(await evidenceInventorySnapshot(Date.now, dataDir));
       }
       const id = mode === "inspect" ? args.id : args.runId;
@@ -11269,8 +11445,8 @@ var evidenceTool = {
         return { kind: "error", message: `evidence: ${mode} requires ${mode === "inspect" ? "id" : "runId"}` };
       }
       assertSafeId(id, mode === "inspect" ? "evidence" : "run");
-      const { buildEvidence, EvidenceNotFoundError, inspectEvidence, loadEvidenceGateDecisions } = await import("./evidence-JVECPI3F.js");
-      const { evidenceDetailSnapshot } = await import("./detail-RHJOTGN4.js");
+      const { buildEvidence, EvidenceNotFoundError, inspectEvidence, loadEvidenceGateDecisions } = await import("./evidence-NJRE3R5H.js");
+      const { evidenceDetailSnapshot } = await import("./detail-YZPHFEVJ.js");
       let evidenceId = mode === "run" ? `run-${id}` : id;
       let inspected;
       try {
@@ -13337,6 +13513,7 @@ var TOOL_PLANES = {
   [ToolNames.Find]: { plane: "observe", actionClass: "read", executionMode: "parallel" },
   [ToolNames.Ls]: { plane: "observe", actionClass: "read", executionMode: "parallel" },
   [ToolNames.CodeNav]: { plane: "observe", actionClass: "read", executionMode: "parallel" },
+  [ToolNames.SelfCompact]: { plane: "orchestrate", actionClass: "read", executionMode: "sequential" },
   [ToolNames.Context]: { plane: "observe", actionClass: "read", executionMode: "parallel" },
   [ToolNames.CredentialPresent]: { plane: "observe", actionClass: "read", executionMode: "parallel" },
   // clio_docs and clio_library are the bundled-documentation and recipe-catalog
@@ -13452,6 +13629,7 @@ function validateBuiltinToolPolicy(specs, options = {}) {
   const includeLedgerTools = options.includeLedgerTools ?? false;
   const includeNetworkTools = options.includeNetworkTools ?? true;
   const required = new Set(Object.values(ToolNames));
+  required.delete(ToolNames.SelfCompact);
   for (const tool of [...required]) {
     if (!includeSessionTools && SESSION_BOUND_TOOLS.has(tool)) required.delete(tool);
     if (!includeDispatchTools && DISPATCH_BOUND_TOOLS.has(tool)) required.delete(tool);
@@ -13593,7 +13771,7 @@ function createTasksTool(deps) {
   };
   return {
     name: ToolNames.Tasks,
-    description: "Session task board. plan declares a titled board (replaces any prior board); add appends tasks; pick moves one operator task uN onto the board; start marks one task active (the current focus); done completes a task (started or still pending) and requires note as the evidence the work actually finished; block parks it with a required reason; drop cancels it; list shows the board. For operator handoff, pick the intended uN and use its linked tN; CLI hand does not pick it. Never pick unrelated tasks. Before claiming completion, list: the linked row must be completed and the operator task done on the same session/board link; report IDs and states. Work that did not happen is blocked or dropped, never done. A self-created plan is not operator authorization. For proposal-only work, plan/add with initialStatus=blocked and note naming the pending operator decision; wait for an explicit operator go-ahead before start or implementation. A skill-install choice does not grant that go-ahead.",
+    description: "Session task board. plan declares a titled board (replaces any prior board); add appends tasks; pick moves one operator task uN onto the board; start marks one task active (the current focus); done completes a task (started or still pending) and requires note as the evidence the work actually finished; block parks it with a required reason; drop cancels it; list shows the board. For operator handoff, pick the intended uN before work and use its linked tN; CLI hand alone does not pick it. Never pick unrelated tasks. Before claiming completion, list: the linked row must be completed and the operator task done on the same session/board link; report IDs and states. Work that did not happen is blocked or dropped, never done. A self-created plan is not operator authorization. For proposal-only work, plan/add with initialStatus=blocked and note naming the pending operator decision; wait for an explicit operator go-ahead before start or implementation. A skill-install choice does not grant that go-ahead.",
     parameters: typebox_exports.Object({
       action: StringEnum(TASKS_ACTIONS, { description: "Board action." }),
       title: typebox_exports.Optional(typebox_exports.String({ description: "Board title (plan)." })),
@@ -13835,13 +14013,13 @@ function registerCoreTools(registry, deps = {}) {
   if (includeNetworkTools) {
     registry.register({
       ...builtin(
-        lazyTool(webReadToolSurface, async () => (await import("./web-fetch-PVZNMBOB.js")).webReadTool),
+        lazyTool(webReadToolSurface, async () => (await import("./web-fetch-LRAGYU6Y.js")).webReadTool),
         { path: "src/tools/web-fetch.ts", scope: "core" }
       )
     });
     registry.register({
       ...builtin(
-        lazyTool(webFetchToolSurface, async () => (await import("./web-fetch-PVZNMBOB.js")).webFetchTool),
+        lazyTool(webFetchToolSurface, async () => (await import("./web-fetch-LRAGYU6Y.js")).webFetchTool),
         { path: "src/tools/web-fetch.ts", scope: "core" }
       )
     });
@@ -13851,7 +14029,7 @@ function registerCoreTools(registry, deps = {}) {
   });
   registry.register({
     ...builtin(
-      lazyTool(verifyToolSurface, async () => (await import("./verify-R6QQCCEB.js")).verifyTool),
+      lazyTool(verifyToolSurface, async () => (await import("./verify-242UFYTP.js")).verifyTool),
       { path: "src/tools/verify/index.ts", scope: "core" }
     )
   });
@@ -13872,18 +14050,19 @@ function registerCoreTools(registry, deps = {}) {
           ...dataToolSurface,
           prepareAdmissionArguments: (args) => prepareDataAdmissionArguments(args, getWorkspaceRoot())
         },
-        async () => (await import("./data-tool-JJPBGMQJ.js")).createDataTool({ getCwd: getWorkspaceRoot })
+        async () => (await import("./data-tool-EKD7DFHG.js")).createDataTool({ getCwd: getWorkspaceRoot })
       ),
       { path: "src/tools/gateway/data-tool.ts", scope: "core" }
     )
   });
   registry.register({
     ...builtin(
-      lazyTool(codeNavToolSurface, async () => (await import("./code-nav-4X3OI6DK.js")).codeNavTool),
+      lazyTool(codeNavToolSurface, async () => (await import("./code-nav-XPM3MY5I.js")).codeNavTool),
       { path: "src/tools/codewiki/code-nav.ts", scope: "core" }
     )
   });
   const skillToolDeps = {
+    ...deps.getContextBudget ? { getContextBudget: deps.getContextBudget } : {},
     ...deps.getSettings ? { getSettings: deps.getSettings } : {},
     ...deps.workerRecall ? { workerRecall: deps.workerRecall } : {},
     getCwd: () => deps.session?.current()?.cwd ?? process.cwd(),
@@ -13915,7 +14094,7 @@ function registerCoreTools(registry, deps = {}) {
   registry.register({
     ...builtin(
       lazyTool(contextToolSurface, async () => {
-        const { createContextTool } = await import("./context-NNLBES2Y.js");
+        const { createContextTool } = await import("./context-O6DIWCF6.js");
         if (!session) return createContextTool(skillToolDeps);
         const { probeWorkspace } = await import("./workspace-DZ7JADBG.js");
         return createContextTool({
@@ -13951,7 +14130,7 @@ function registerCoreTools(registry, deps = {}) {
   });
   registry.register({
     ...builtin(
-      lazyTool(clioDocsToolSurface, async () => (await import("./clio-context-tools-GR4OHFSO.js")).createClioDocsTool()),
+      lazyTool(clioDocsToolSurface, async () => (await import("./clio-context-tools-OHJXYX4R.js")).createClioDocsTool()),
       { path: "src/tools/gateway/clio-context-tools.ts", scope: "core" }
     )
   });
@@ -13959,7 +14138,7 @@ function registerCoreTools(registry, deps = {}) {
     ...builtin(
       lazyTool(
         clioLibraryToolSurface,
-        async () => (await import("./clio-context-tools-GR4OHFSO.js")).createClioLibraryTool({
+        async () => (await import("./clio-context-tools-OHJXYX4R.js")).createClioLibraryTool({
           getCwd: skillToolDeps.getCwd,
           ...deps.skillMarketplace !== void 0 ? { skillMarketplace: deps.skillMarketplace } : {},
           ...deps.getSkillLoaderOptions ? { getSkillLoaderOptions: deps.getSkillLoaderOptions } : {}
@@ -14396,4 +14575,4 @@ export {
   createWorkerToolRegistry,
   attestedToolSignature
 };
-//# sourceMappingURL=chunk-OQ2EOAHA.js.map
+//# sourceMappingURL=chunk-PF36KOGI.js.map