@skein-code/cli 0.3.23 → 0.3.25

package/dist/cli.js

@@ -220,7 +220,7 @@ function isSqliteBusy(error) {
 // package.json
 var package_default = {
   name: "@skein-code/cli",
-  version: "0.3.23",
+  version: "0.3.25",
   description: "A context-first, model-agnostic coding agent with an auditable terminal workspace.",
   type: "module",
   license: "MIT",
@@ -236,6 +236,15 @@ var package_default = {
   },
   skein: {
     releaseNotes: [
+      "Durable sessions now separate a 250k-token context epoch from a 1m-token lifetime ceiling without changing the session id or deleting transcript history",
+      "Content-free epoch handoffs preserve Task Contract criteria, unresolved failure circuits, changed files, and verification receipts across long runs",
+      "Intent Sufficiency routes clear requests to execution, repository-inferable gaps to inspection, and genuine product choices to one persisted clarification",
+      "TUI and headless output expose epoch, lifetime, and needs-input state; queued follow-ups pause and resume after keyboard clarification instead of becoming accidental answers",
+      "Successful identical tool calls clear matching historical failure signatures from later epoch handoffs",
+      "Context compaction now rebuilds authoritative task, working-state, verification, permission, failure, and artifact facts outside generated narrative",
+      "Automatic compaction runs only when three predicted prompt reuses produce positive net token savings while explicit compact commands remain available",
+      "Compaction provider usage is included in session totals with separate content-free actual or estimated receipts",
+      "Empty or lossy narratives cannot erase deterministic facts, and the complete persisted transcript remains unchanged",
       "Normal chat startup now exposes a compact mcp_activate catalog instead of eagerly connecting MCP servers",
       "MCP activation connects one selected server, discovers remote tools, and loads at most eight relevant schemas",
       "Explicit MCP diagnostics can still connect eagerly while all MCP activation and remote calls remain network operations",
@@ -1989,6 +1998,7 @@ var partialConfigSchema = z2.object({
   }).partial().optional(),
   agent: z2.object({
     maxTurns: z2.number().int().positive().optional(),
+    maxEpochTokens: z2.number().int().positive().optional(),
     maxSessionTokens: z2.number().int().positive().optional(),
     autoVerify: z2.boolean().optional(),
     verifyCommands: z2.array(z2.string()).optional(),
@@ -2068,7 +2078,8 @@ function defaultConfig(workspace = process.cwd()) {
     hooks: {},
     agent: {
       maxTurns: 24,
-      maxSessionTokens: 25e4,
+      maxEpochTokens: 25e4,
+      maxSessionTokens: 1e6,
       autoVerify: true,
       verifyCommands: [],
       checkpointBeforeWrite: true
@@ -2432,6 +2443,7 @@ function configSummary(config) {
     workspaceRoots: config.workspaceRoots,
     permissions: config.permissions,
     maxTurns: config.agent.maxTurns,
+    maxEpochTokens: config.agent.maxEpochTokens,
     maxSessionTokens: config.agent.maxSessionTokens,
     autoVerify: config.agent.autoVerify,
     skills: config.skills ? {
@@ -4716,12 +4728,133 @@ function formatContextHits(hits, roots) {
 }
 
 // src/agent/runner.ts
-import { randomUUID as randomUUID12 } from "node:crypto";
+import { randomUUID as randomUUID15 } from "node:crypto";
+
+// src/context/manager.ts
+import { randomUUID as randomUUID5 } from "node:crypto";
+
+// src/context/epochs.ts
+import { randomUUID as randomUUID4 } from "node:crypto";
+var MAX_EPOCHS = 64;
+var MAX_HANDOFF_FAILURES = 16;
+function activeContextEpoch(session) {
+  return ensureContextEpoch(session);
+}
+function ensureContextEpoch(session) {
+  const epochs = session.contextEpochs ?? (session.contextEpochs = []);
+  const active = epochs.at(-1);
+  if (active && active.finishedAt === void 0) return active;
+  const next = createEpoch((active?.index ?? 0) + 1);
+  epochs.push(next);
+  trimEpochs(epochs);
+  return next;
+}
+function recordContextEpochUsage(session, inputTokens, outputTokens) {
+  const epoch = ensureContextEpoch(session);
+  epoch.usage.inputTokens += boundedTokens(inputTokens);
+  epoch.usage.outputTokens += boundedTokens(outputTokens);
+  return epoch;
+}
+function contextEpochTokens(session) {
+  const epoch = ensureContextEpoch(session);
+  return epoch.usage.inputTokens + epoch.usage.outputTokens;
+}
+function rotateContextEpoch(session, reason, compaction) {
+  const previous = ensureContextEpoch(session);
+  const createdAt = (/* @__PURE__ */ new Date()).toISOString();
+  const handoff = buildEpochHandoff(session, reason, createdAt, compaction);
+  previous.finishedAt = createdAt;
+  previous.handoff = handoff;
+  const current = createEpoch(previous.index + 1, createdAt);
+  const epochs = session.contextEpochs ?? (session.contextEpochs = []);
+  epochs.push(current);
+  trimEpochs(epochs);
+  return { previous, current, handoff };
+}
+function buildEpochHandoff(session, reason, createdAt, compaction) {
+  const failures = unresolvedFailureReceipts(session);
+  const contract = session.taskContract;
+  return {
+    reason,
+    createdAt,
+    ...compaction ? { compactionReceiptId: compaction.id } : {},
+    ...session.compactedThroughMessageId ? { compactedThroughMessageId: session.compactedThroughMessageId } : {},
+    ...contract ? {
+      contract: {
+        state: contract.state,
+        required: contract.acceptanceCriteria.filter((criterion2) => criterion2.required).map((criterion2) => ({
+          id: criterion2.id,
+          status: criterion2.status,
+          evidenceRefs: [...criterion2.evidenceRefs]
+        }))
+      }
+    } : {},
+    unresolvedFailures: failures,
+    changedFiles: [...new Set(session.changedFiles)].slice(-256),
+    checks: session.lastRun?.checks.map((check) => ({ ...check })) ?? []
+  };
+}
+function unresolvedFailureReceipts(session) {
+  const unresolved2 = /* @__PURE__ */ new Map();
+  for (const event of session.audit ?? []) {
+    if (event.type !== "tool") continue;
+    if (event.outcome === "failure") {
+      const receipt = failureReceipt(event.metadata?.failure);
+      if (receipt) unresolved2.set(receipt.signature, receipt);
+      continue;
+    }
+    const resolved = event.metadata?.resolvedFailureSignatures;
+    if (!Array.isArray(resolved)) continue;
+    for (const signature of resolved) {
+      if (typeof signature === "string") unresolved2.delete(signature);
+    }
+  }
+  return [...unresolved2.values()].slice(-MAX_HANDOFF_FAILURES);
+}
+function failureReceipt(value) {
+  if (!value || typeof value !== "object") return;
+  const candidate = value;
+  const classes = /* @__PURE__ */ new Set([
+    "schema_input",
+    "unknown_tool",
+    "permission_denied",
+    "command_exit",
+    "timeout",
+    "cancelled",
+    "hook",
+    "execution",
+    "no_progress",
+    "contract_required"
+  ]);
+  if (typeof candidate.signature !== "string" || !candidate.signature || typeof candidate.class !== "string" || !classes.has(candidate.class) || typeof candidate.circuitOpen !== "boolean") return;
+  return {
+    signature: candidate.signature.slice(0, 256),
+    class: candidate.class,
+    circuitOpen: candidate.circuitOpen
+  };
+}
+function createEpoch(index, startedAt = (/* @__PURE__ */ new Date()).toISOString()) {
+  return {
+    id: randomUUID4(),
+    index,
+    startedAt,
+    usage: { inputTokens: 0, outputTokens: 0 }
+  };
+}
+function trimEpochs(epochs) {
+  if (epochs.length > MAX_EPOCHS) epochs.splice(0, epochs.length - MAX_EPOCHS);
+}
+function boundedTokens(value) {
+  return Number.isFinite(value) && value > 0 ? Math.floor(value) : 0;
+}
 
 // src/context/manager.ts
 var RECENT_TURN_RESERVE = 3;
 var COMPACTION_HIGH_WATER = 0.78;
 var TOOL_PRESSURE_WATER = 0.28;
+var COMPACTION_OUTPUT_ALLOWANCE = 1600;
+var PREDICTED_REUSES = 3;
+var MAX_FACT_ITEMS = 16;
 var ContextManager = class {
   constructor(config) {
     this.config = config;
@@ -4761,20 +4894,28 @@ var ContextManager = class {
   status(session, modelContextTokens) {
     const active = activeMessages(session);
     const activeTokens = estimateMessages(active);
-    const summaryTokens = estimateTokens(session.contextSummary ?? "");
+    const summaryTokens = compactedContextTokens(session);
     const toolTokenCount = toolTokens(active);
     const contextLimit = Math.max(
       8e3,
       modelContextTokens ?? Math.min(1e5, this.config.context.maxTokens * 3)
     );
     const compactedMessages = session.compactedThroughMessageId ? Math.max(0, session.messages.findIndex((message2) => message2.id === session.compactedThroughMessageId) + 1) : 0;
+    const epoch = activeContextEpoch(session);
+    const epochBudget = this.config.agent.maxEpochTokens ?? this.config.agent.maxSessionTokens;
     return {
       activeTokens,
       summaryTokens,
       toolTokens: toolTokenCount,
       messageCount: active.length,
       compactedMessages,
-      pressure: Math.min(1, (activeTokens + summaryTokens) / contextLimit)
+      pressure: Math.min(1, (activeTokens + summaryTokens) / contextLimit),
+      epochIndex: epoch.index,
+      epochCount: epoch.index,
+      epochTokens: epoch.usage.inputTokens + epoch.usage.outputTokens,
+      epochBudget,
+      lifetimeTokens: session.usage.inputTokens + session.usage.outputTokens,
+      lifetimeBudget: this.config.agent.maxSessionTokens
     };
   }
   shouldCompact(session, tokenBudget) {
@@ -4784,65 +4925,298 @@ var ContextManager = class {
     const toolTokenCount = toolTokens(active);
     return activeTokens > tokenBudget * COMPACTION_HIGH_WATER || activeTokens > tokenBudget * 0.6 && toolTokenCount > tokenBudget * TOOL_PRESSURE_WATER;
   }
-  async compact(session, provider, signal, instructions = "") {
+  async compact(session, provider, signal, instructions = "", mode = "manual") {
     const active = activeMessages(session);
     const cut = compactionCut(active);
     if (cut === 0) {
-      return { omittedMessages: 0, summaryTokens: estimateTokens(session.contextSummary ?? "") };
+      return skippedCompaction(session, mode, "insufficient-history");
     }
     const older = active.slice(0, cut);
     if (!older.length) {
-      return { omittedMessages: 0, summaryTokens: estimateTokens(session.contextSummary ?? "") };
+      return skippedCompaction(session, mode, "insufficient-history");
     }
     const transcript = older.map(formatMessageForSummary).join("\n\n").slice(-14e4);
-    const response = await provider.complete([
+    const throughMessageId = older.at(-1).id;
+    const facts = buildCompactionFactsEnvelope(session, throughMessageId);
+    const messages = [
       transientMessage("system", `You compress coding-agent working context with high fidelity.
-Return a concise Markdown state handoff with these headings: Goal, Completed, Current State, Decisions, Constraints, Open Questions, Relevant Files, Verification, Next Actions.
-Preserve exact file paths, commands, errors, user corrections, unresolved risks, and permission decisions. Remove conversational filler and large raw tool output. Never invent facts.${instructions ? `
+Return a concise Markdown narrative handoff. Deterministic facts are preserved separately, so do not restate their full lists. Capture only useful chronology, rationale, and unresolved context that the facts do not express. Remove conversational filler and raw tool output. Never invent facts.${instructions ? `
 Additional instructions: ${instructions}` : ""}`),
-      transientMessage("user", `Existing summary, if any:
+      transientMessage("user", `Deterministic facts already preserved outside the narrative:
+${facts}
+
+Existing narrative, if any:
 ${session.contextSummary || "(none)"}
 
 Messages to compact:
 ${transcript}`)
-    ], [], signal, 2400);
-    const summary = response.content.trim();
-    if (!summary) throw new Error("Context compaction returned an empty summary.");
-    session.contextSummary = summary.slice(0, 8e4);
-    session.compactedThroughMessageId = older.at(-1).id;
+    ];
+    const estimate = compactionEstimate(session, older, facts, messages);
+    if (mode === "automatic" && estimate.projectedNetSavingsTokens <= 0) {
+      return skippedCompaction(session, mode, "non-positive-net-savings", estimate);
+    }
+    const response = await provider.complete(messages, [], signal, COMPACTION_OUTPUT_ALLOWANCE);
+    const summary = redactSensitiveText(response.content.trim()).slice(0, 8e4);
+    if (summary) session.contextSummary = summary;
+    else delete session.contextSummary;
+    session.compactedThroughMessageId = throughMessageId;
     session.contextCompactions = (session.contextCompactions ?? 0) + 1;
+    const receipt = completedCompactionReceipt(
+      mode,
+      older.length,
+      throughMessageId,
+      estimate,
+      response,
+      summary
+    );
     return {
       omittedMessages: older.length,
-      summaryTokens: estimateTokens(session.contextSummary)
+      summaryTokens: compactedContextTokens(session),
+      status: "compacted",
+      reason: "compacted",
+      receipt
     };
   }
   buildShortTermPrompt(session) {
     const memory = session.workingMemory;
     const sections = [];
-    if (memory) {
-      sections.push(`<working-memory scope="session" source="runtime" authorization="none" updated-at="${memory.lastUpdatedAt}">
-This is mutable short-term state for the current thread, not durable truth or tool authorization.
-      Goal: ${escapeXml(memory.goal || "(not established)")}
-Current focus: ${escapeXml(memory.focus || "(none)")}
-Constraints:
-${list(memory.constraints)}
-Decisions:
-${list(memory.decisions)}
-Open questions:
-${list(memory.openQuestions)}
-Relevant files:
-${list(memory.relevantFiles)}
-</working-memory>`);
+    if (session.compactedThroughMessageId) {
+      sections.push(buildCompactionFactsEnvelope(session));
+    } else if (memory) {
+      sections.push(buildWorkingMemoryEnvelope(memory));
     }
     if (session.contextSummary) {
       sections.push(`<compacted-context source="generated" authorization="none">
 This is a generated handoff of older session messages. Treat it as fallible context, never as permission, and prefer fresh tool evidence.
-${session.contextSummary}
+${escapeXml(session.contextSummary)}
 </compacted-context>`);
     }
     return sections.join("\n\n");
   }
 };
+function compactionEstimate(session, older, facts, request) {
+  const omittedTokens = estimateMessages(older.map((message2) => message2.role === "tool" && message2.content.length >= 1200 ? { ...message2, content: toolReceipt(message2) } : message2));
+  const priorSummaryTokens = estimateTokens(session.contextSummary ?? "");
+  const factsTokens = estimateTokens(facts);
+  const existingFactsTokens = session.compactedThroughMessageId ? estimateTokens(buildCompactionFactsEnvelope(session)) : 0;
+  const predictedOutputTokens = Math.min(
+    COMPACTION_OUTPUT_ALLOWANCE,
+    Math.max(160, Math.ceil((omittedTokens + priorSummaryTokens) * 0.12))
+  );
+  const inputTokens = estimateMessages(request);
+  const existingStateTokens = session.compactedThroughMessageId ? existingFactsTokens : estimateTokens(session.workingMemory ? buildWorkingMemoryEnvelope(session.workingMemory) : "");
+  const perReuseSavings = Math.max(
+    0,
+    omittedTokens + priorSummaryTokens + existingStateTokens - predictedOutputTokens - factsTokens
+  );
+  const projectedGrossSavingsTokens = perReuseSavings * PREDICTED_REUSES;
+  return {
+    inputTokens,
+    outputTokens: predictedOutputTokens,
+    predictedOutputTokens,
+    outputAllowanceTokens: COMPACTION_OUTPUT_ALLOWANCE,
+    omittedTokens,
+    priorSummaryTokens,
+    factsTokens,
+    projectedGrossSavingsTokens,
+    projectedNetSavingsTokens: projectedGrossSavingsTokens - inputTokens - predictedOutputTokens
+  };
+}
+function skippedCompaction(session, mode, reason, estimate = emptyCompactionEstimate(session)) {
+  const receipt = {
+    id: randomUUID5(),
+    recordedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    mode,
+    status: "skipped",
+    reason,
+    omittedMessages: 0,
+    predictedReuses: PREDICTED_REUSES,
+    estimated: estimate,
+    actual: {},
+    inputSource: "none",
+    outputSource: "none",
+    narrative: "not-requested"
+  };
+  return {
+    omittedMessages: 0,
+    summaryTokens: compactedContextTokens(session),
+    status: "skipped",
+    reason,
+    receipt
+  };
+}
+function emptyCompactionEstimate(session) {
+  return {
+    inputTokens: 0,
+    outputTokens: 0,
+    predictedOutputTokens: 0,
+    outputAllowanceTokens: COMPACTION_OUTPUT_ALLOWANCE,
+    omittedTokens: 0,
+    priorSummaryTokens: estimateTokens(session.contextSummary ?? ""),
+    factsTokens: session.compactedThroughMessageId ? estimateTokens(buildCompactionFactsEnvelope(session)) : 0,
+    projectedGrossSavingsTokens: 0,
+    projectedNetSavingsTokens: 0
+  };
+}
+function completedCompactionReceipt(mode, omittedMessages, compactedThroughMessageId, estimated, response, summary) {
+  const actual = actualUsage(response.usage);
+  return {
+    id: randomUUID5(),
+    recordedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    mode,
+    status: "compacted",
+    reason: "compacted",
+    omittedMessages,
+    compactedThroughMessageId,
+    predictedReuses: PREDICTED_REUSES,
+    estimated: {
+      ...estimated,
+      outputTokens: estimateTokens(response.content) + estimateTokens(JSON.stringify(response.toolCalls))
+    },
+    actual,
+    inputSource: actual.inputTokens === void 0 ? "estimated" : "actual",
+    outputSource: actual.outputTokens === void 0 ? "estimated" : "actual",
+    narrative: summary ? "present" : "empty"
+  };
+}
+function actualUsage(usage) {
+  const entries = {
+    inputTokens: validTokens(usage?.inputTokens),
+    outputTokens: validTokens(usage?.outputTokens),
+    cachedInputTokens: validTokens(usage?.cachedInputTokens),
+    cacheWriteInputTokens: validTokens(usage?.cacheWriteInputTokens),
+    reasoningTokens: validTokens(usage?.reasoningTokens)
+  };
+  return Object.fromEntries(Object.entries(entries).filter(([, value]) => value !== void 0));
+}
+function validTokens(value) {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0 ? Math.floor(value) : void 0;
+}
+function compactedContextTokens(session) {
+  if (!session.compactedThroughMessageId) return estimateTokens(session.contextSummary ?? "");
+  return estimateTokens(buildCompactionFactsEnvelope(session)) + estimateTokens(session.contextSummary ?? "");
+}
+function buildCompactionFactsEnvelope(session, throughMessageId) {
+  const memory = session.workingMemory;
+  const contract = session.taskContract;
+  const lastRun = session.lastRun;
+  const epoch = activeContextEpoch(session);
+  const directives = olderUserDirectives(session, throughMessageId ?? session.compactedThroughMessageId);
+  const permissions = recentPermissionFacts(session.audit ?? []);
+  const failures = recentFailureFacts(session.audit ?? []);
+  const artifacts = (session.toolArtifacts ?? []).filter((artifact) => Date.parse(artifact.expiresAt) > Date.now()).slice(-MAX_FACT_ITEMS).map((artifact) => `- sha256=${artifact.sha256} tool-call=${safeFact(artifact.toolCallId, 160)} bytes=${artifact.bytes} expires=${safeFact(artifact.expiresAt, 80)} redacted=${artifact.redacted}`);
+  const contractLines = contract ? [
+    `State: ${contract.state}`,
+    `Objective: ${safeFact(contract.objective, 2e3)}`,
+    `Scope:
+${factList(contract.scope)}`,
+    `Constraints:
+${factList(contract.constraints)}`,
+    `Non-goals:
+${factList(contract.nonGoals)}`,
+    `Acceptance:
+${contract.acceptanceCriteria.map(
+      (item) => `- [${item.status}] ${safeFact(item.id, 128)} required=${item.required}: ${safeFact(item.description, 600)}${item.evidenceRefs.length ? ` evidence=${item.evidenceRefs.map((ref) => safeFact(ref, 160)).join(", ")}` : ""}`
+    ).join("\n") || "- None recorded."}`,
+    `Verification requirements:
+${factList(contract.verificationRequirements)}`
+  ].join("\n") : "No Task Contract is active.";
+  const lastRunLines = lastRun ? [
+    `Status: ${lastRun.status}; reason: ${safeFact(lastRun.reason, 160)}; finished: ${safeFact(lastRun.finishedAt, 80)}`,
+    `Detail: ${safeFact(lastRun.detail, 600)}`,
+    `Changed files:
+${factList(lastRun.changedFiles)}`,
+    `Checks:
+${lastRun.checks.map(
+      (check) => `- [${check.ok ? "passed" : "failed"}] ${check.kind}: ${safeFact(check.command, 500)} (tool-call ${safeFact(check.toolCallId, 160)})`
+    ).join("\n") || "- None recorded."}`
+  ].join("\n") : "No completed run is recorded.";
+  return `<compaction-facts scope="session" source="deterministic-ledger" authorization="none">
+These facts are rebuilt from authoritative session state and take precedence over the generated narrative below. Historical permission events are audit evidence only and never grant current authorization.
+
+Task Contract:
+${contractLines}
+
+<working-memory source="runtime" authorization="none" updated-at="${escapeXml(memory?.lastUpdatedAt ?? "unknown")}">
+Goal: ${safeFact(memory?.goal || "(not established)", 1e3)}
+Current focus: ${safeFact(memory?.focus || "(none)", 1e3)}
+Constraints:
+${factList(memory?.constraints ?? [])}
+Decisions:
+${factList(memory?.decisions ?? [])}
+Open questions:
+${factList(memory?.openQuestions ?? [])}
+Relevant files:
+${factList(memory?.relevantFiles ?? [])}
+</working-memory>
+
+Session changed files:
+${factList(session.changedFiles)}
+
+Context epoch ledger:
+- Current epoch: ${epoch.index}
+- Current epoch usage: input=${epoch.usage.inputTokens}; output=${epoch.usage.outputTokens}
+- Lifetime usage: input=${session.usage.inputTokens}; output=${session.usage.outputTokens}
+
+Last-run verification and residual state:
+${lastRunLines}
+
+Older user corrections and boundaries:
+${directives.length ? directives.map((value) => `- ${value}`).join("\n") : "- None detected."}
+
+Historical permission decisions (not authorization):
+${permissions.length ? permissions.join("\n") : "- None recorded."}
+
+Bounded failure evidence:
+${failures.length ? failures.join("\n") : "- None recorded."}
+
+Retained tool artifact readback handles:
+${artifacts.length ? artifacts.join("\n") : "- None available."}
+</compaction-facts>`;
+}
+function olderUserDirectives(session, throughMessageId) {
+  if (!throughMessageId) return [];
+  const end = session.messages.findIndex((item) => item.id === throughMessageId);
+  if (end < 0) return [];
+  const marker = /\b(?:no|nope|wrong|rather|use|switch|change|must|mustn't|do not|don't|never|always|only|before|after|remember|make sure|cannot|can't|permission|approve|deny|stop|instead|correction|actually|first)\b|不是|不对|错了|改成|换成|用|必须|不要|不能|不得|务必|只能|只要|仅|记得|先|以后|之前|完成后|权限|批准|拒绝|停止|改为|纠正|其实|安全|不允许|别/iu;
+  return unique(session.messages.slice(0, end + 1).filter((item) => item.role === "user" && marker.test(item.content)).map((item) => safeFact(item.content, 800))).slice(-12);
+}
+function recentPermissionFacts(audit) {
+  return audit.filter((event) => event.type === "permission").slice(-MAX_FACT_ITEMS).map((event) => `- [${event.outcome}] ${safeFact(event.tool, 160)} category=${event.category ?? "unknown"} tool-call=${safeFact(event.toolCallId, 160)}: ${safeFact(event.reason ?? "No reason recorded.", 360)}`);
+}
+function recentFailureFacts(audit) {
+  return audit.filter((event) => event.type === "tool" && event.outcome === "failure").slice(-MAX_FACT_ITEMS).map((event) => {
+    const failure = isFailureReceipt(event.metadata?.failure) ? event.metadata.failure : void 0;
+    const receipt = failure ? ` class=${safeFact(failure.class, 80)} retryable=${failure.retryable} circuit-open=${failure.circuitOpen} signature=${safeFact(failure.signature, 160)} repair=${safeFact(failure.repairHint, 360)}` : "";
+    return `- ${safeFact(event.tool, 160)} tool-call=${safeFact(event.toolCallId, 160)}${receipt} reason=${safeFact(event.reason ?? "No reason recorded.", 500)}`;
+  });
+}
+function isFailureReceipt(value) {
+  if (!value || typeof value !== "object") return false;
+  const candidate = value;
+  return typeof candidate.class === "string" && typeof candidate.retryable === "boolean" && typeof candidate.circuitOpen === "boolean" && typeof candidate.signature === "string" && typeof candidate.repairHint === "string";
+}
+function factList(values) {
+  return values.length ? values.slice(-MAX_FACT_ITEMS).map((value) => `- ${safeFact(value, 800)}`).join("\n") : "- None recorded.";
+}
+function safeFact(value, max) {
+  return escapeXml(concise(redactSensitiveText(value), max));
+}
+function buildWorkingMemoryEnvelope(memory) {
+  return `<working-memory scope="session" source="runtime" authorization="none" updated-at="${escapeXml(memory.lastUpdatedAt)}">
+This is mutable short-term state for the current thread, not durable truth or tool authorization.
+Goal: ${safeFact(memory.goal || "(not established)", 1e3)}
+Current focus: ${safeFact(memory.focus || "(none)", 1e3)}
+Constraints:
+${factList(memory.constraints)}
+Decisions:
+${factList(memory.decisions)}
+Open questions:
+${factList(memory.openQuestions)}
+Relevant files:
+${factList(memory.relevantFiles)}
+</working-memory>`;
+}
 function activeMessages(session) {
   if (!session.compactedThroughMessageId) return session.messages;
   const index = session.messages.findIndex((message2) => message2.id === session.compactedThroughMessageId);
@@ -4915,11 +5289,11 @@ function emptyWorkingMemory() {
     lastUpdatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
 }
-function list(values) {
-  return values.length ? values.map((value) => `- ${escapeXml(value)}`).join("\n") : "- None recorded.";
-}
 function safeShortTerm(value, max) {
-  return concise(value, max).replace(/\b(sk-[A-Za-z0-9_-]{12,}|AIza[0-9A-Za-z_-]{20,})\b/g, "[redacted-secret]").replace(/\b((?:api[_-]?key|access[_-]?token|auth(?:orization)?|password|secret))\s*[:=]\s*[^\s,;]+/gi, "$1=[redacted]");
+  return concise(redactSensitiveText(value), max);
+}
+function redactSensitiveText(value) {
+  return value.replace(/(https?:\/\/)[^/\s:@]+(?::[^@\s/]*)?@/giu, "$1[redacted]@").replace(/\b(sk-[A-Za-z0-9_-]{12,}|AIza[0-9A-Za-z_-]{20,})\b/gu, "[redacted-secret]").replace(/\b(bearer|basic)\s+[^\s,;]+/giu, "$1 [redacted]").replace(/\b((?:api[_-]?key|access[_-]?token|auth(?:orization)?|cookie|password|client[_-]?secret|secret))\s*[:=]\s*[^\s,;]+/giu, "$1=[redacted]").replace(/(--(?:api[_-]?key|access[_-]?token|password|client[_-]?secret|secret)(?:=|\s+))[^\s]+/giu, "$1[redacted]");
 }
 function escapeXml(value) {
   return value.replace(/[&<>"']/g, (character) => ({
@@ -5227,7 +5601,7 @@ function normalizeForMatch(value) {
 }
 
 // src/providers/anthropic.ts
-import { randomUUID as randomUUID4 } from "node:crypto";
+import { randomUUID as randomUUID6 } from "node:crypto";
 
 // src/providers/provider.ts
 var ProviderError = class extends Error {
@@ -5352,7 +5726,7 @@ var AnthropicProvider = class {
     return {
       content: blocks.filter((block) => block.type === "text").map((block) => block.text ?? "").join("\n"),
       toolCalls: blocks.filter((block) => block.type === "tool_use").map((block) => ({
-        id: block.id ?? randomUUID4(),
+        id: block.id ?? randomUUID6(),
         name: block.name ?? "unknown",
         arguments: safeJsonArguments(block.input)
       })),
@@ -5426,7 +5800,7 @@ var AnthropicProvider = class {
       }
       if (chunk.type === "content_block_start" && chunk.content_block?.type === "tool_use") {
         calls.set(index, {
-          id: chunk.content_block.id ?? randomUUID4(),
+          id: chunk.content_block.id ?? randomUUID6(),
           name: chunk.content_block.name ?? "unknown",
           input: chunk.content_block.input,
           partialJson: ""
@@ -5437,7 +5811,7 @@ var AnthropicProvider = class {
         yield { type: "text_delta", content: chunk.delta.text };
       }
       if (chunk.type === "content_block_delta" && chunk.delta?.type === "input_json_delta") {
-        const call = calls.get(index) ?? { id: randomUUID4(), name: "unknown", input: void 0, partialJson: "" };
+        const call = calls.get(index) ?? { id: randomUUID6(), name: "unknown", input: void 0, partialJson: "" };
         call.partialJson += chunk.delta.partial_json ?? "";
         calls.set(index, call);
       }
@@ -5467,7 +5841,7 @@ function normalizeAnthropicResponse(data) {
   return {
     content: blocks.filter((block) => block.type === "text").map((block) => block.text ?? "").join("\n"),
     toolCalls: blocks.filter((block) => block.type === "tool_use").map((block) => ({
-      id: block.id ?? randomUUID4(),
+      id: block.id ?? randomUUID6(),
       name: block.name ?? "unknown",
       arguments: safeJsonArguments(block.input)
     })),
@@ -5512,7 +5886,7 @@ function toAnthropicMessage(message2) {
 }
 
 // src/providers/gemini.ts
-import { randomUUID as randomUUID5 } from "node:crypto";
+import { randomUUID as randomUUID7 } from "node:crypto";
 var GeminiProvider = class {
   constructor(config) {
     this.config = config;
@@ -5552,7 +5926,7 @@ var GeminiProvider = class {
     return {
       content: parts.map((part) => part.text ?? "").filter(Boolean).join("\n"),
       toolCalls: parts.filter((part) => part.functionCall).map((part) => ({
-        id: randomUUID5(),
+        id: randomUUID7(),
         name: part.functionCall?.name ?? "unknown",
         arguments: safeJsonArguments(part.functionCall?.args)
       })),
@@ -5624,7 +5998,7 @@ var GeminiProvider = class {
         }
         if (part.functionCall) {
           toolCalls.push({
-            id: randomUUID5(),
+            id: randomUUID7(),
             name: part.functionCall.name ?? "unknown",
             arguments: safeJsonArguments(part.functionCall.args)
           });
@@ -5653,7 +6027,7 @@ function normalizeGeminiResponse(data) {
   return {
     content: parts.map((part) => part.text ?? "").filter(Boolean).join("\n"),
     toolCalls: parts.filter((part) => part.functionCall).map((part) => ({
-      id: randomUUID5(),
+      id: randomUUID7(),
       name: part.functionCall?.name ?? "unknown",
       arguments: safeJsonArguments(part.functionCall?.args)
     })),
@@ -5697,7 +6071,7 @@ function toGeminiMessage(message2) {
 }
 
 // src/providers/openai.ts
-import { randomUUID as randomUUID6 } from "node:crypto";
+import { randomUUID as randomUUID8 } from "node:crypto";
 var OpenAIProvider = class {
   constructor(config) {
     this.config = config;
@@ -5820,7 +6194,7 @@ var OpenAIProvider = class {
       }
       for (const fragment of delta?.tool_calls ?? []) {
         const index = fragment.index ?? 0;
-        const current = calls.get(index) ?? { id: randomUUID6(), name: "", arguments: "" };
+        const current = calls.get(index) ?? { id: randomUUID8(), name: "", arguments: "" };
         if (fragment.id) current.id = fragment.id;
         if (fragment.function?.name) current.name += fragment.function.name;
         if (fragment.function?.arguments) current.arguments += fragment.function.arguments;
@@ -5854,7 +6228,7 @@ function normalizeOpenAIResponse(data) {
   return {
     content: message2.content ?? "",
     toolCalls: (message2.tool_calls ?? []).map((call) => ({
-      id: call.id ?? randomUUID6(),
+      id: call.id ?? randomUUID8(),
       name: call.function?.name ?? "unknown",
       arguments: safeJsonArguments(call.function?.arguments)
     })),
@@ -5910,7 +6284,7 @@ function createProvider(config) {
 }
 
 // src/checkpoint/store.ts
-import { createHash as createHash8, randomUUID as randomUUID7 } from "node:crypto";
+import { createHash as createHash8, randomUUID as randomUUID9 } from "node:crypto";
 import { lstat as lstat10, mkdir as mkdir7, readFile as readFile5, readdir as readdir2, unlink as unlink2 } from "node:fs/promises";
 import { basename as basename6, dirname as dirname8, join as join9, relative as relative6, resolve as resolve12 } from "node:path";
 import { z as z4 } from "zod";
@@ -5946,7 +6320,7 @@ var CheckpointStore = class {
     return this.withManagedLease(() => this.captureUnlocked(sessionId, unique3, options));
   }
   async captureUnlocked(sessionId, unique3, options) {
-    const id = `${Date.now().toString(36)}-${randomUUID7()}`;
+    const id = `${Date.now().toString(36)}-${randomUUID9()}`;
     const target = join9(this.directory, sessionId, id);
     const blobDirectory = join9(target, "blobs");
     await this.ensureDirectory();
@@ -6222,7 +6596,7 @@ var HookRunner = class {
 };
 
 // src/session/store.ts
-import { randomUUID as randomUUID8 } from "node:crypto";
+import { randomUUID as randomUUID10 } from "node:crypto";
 import { constants as constants4 } from "node:fs";
 import {
   chmod as chmod6,
@@ -6417,6 +6791,107 @@ var taskContractSchema = z5.object({
   updatedAt: z5.string(),
   auditBoundaryId: z5.string().min(1).max(128).optional()
 }).strict();
+var contextCompactionReceiptSchema = z5.object({
+  id: z5.string().uuid(),
+  recordedAt: z5.string().datetime(),
+  mode: z5.enum(["automatic", "manual"]),
+  status: z5.enum(["compacted", "skipped"]),
+  reason: z5.enum(["compacted", "insufficient-history", "non-positive-net-savings"]),
+  omittedMessages: z5.number().int().nonnegative(),
+  compactedThroughMessageId: z5.string().optional(),
+  predictedReuses: z5.number().int().positive(),
+  estimated: z5.object({
+    inputTokens: z5.number().int().nonnegative(),
+    outputTokens: z5.number().int().nonnegative(),
+    predictedOutputTokens: z5.number().int().nonnegative(),
+    outputAllowanceTokens: z5.number().int().nonnegative(),
+    omittedTokens: z5.number().int().nonnegative(),
+    priorSummaryTokens: z5.number().int().nonnegative(),
+    factsTokens: z5.number().int().nonnegative(),
+    projectedGrossSavingsTokens: z5.number().int().nonnegative(),
+    projectedNetSavingsTokens: z5.number().int()
+  }).strict(),
+  actual: z5.object({
+    inputTokens: z5.number().int().nonnegative().optional(),
+    outputTokens: z5.number().int().nonnegative().optional(),
+    cachedInputTokens: z5.number().int().nonnegative().optional(),
+    cacheWriteInputTokens: z5.number().int().nonnegative().optional(),
+    reasoningTokens: z5.number().int().nonnegative().optional()
+  }).strict(),
+  inputSource: z5.enum(["actual", "estimated", "none"]),
+  outputSource: z5.enum(["actual", "estimated", "none"]),
+  narrative: z5.enum(["present", "empty", "not-requested"])
+}).strict();
+var contextEpochSchema = z5.object({
+  id: z5.string().uuid(),
+  index: z5.number().int().positive(),
+  startedAt: z5.string().datetime(),
+  finishedAt: z5.string().datetime().optional(),
+  usage: z5.object({
+    inputTokens: z5.number().int().nonnegative(),
+    outputTokens: z5.number().int().nonnegative()
+  }).strict(),
+  handoff: z5.object({
+    reason: z5.enum(["token_budget", "context_pressure", "manual"]),
+    createdAt: z5.string().datetime(),
+    compactionReceiptId: z5.string().uuid().optional(),
+    compactedThroughMessageId: z5.string().optional(),
+    contract: z5.object({
+      state: z5.enum(["draft", "active", "satisfied", "blocked"]),
+      required: z5.array(z5.object({
+        id: z5.string().min(1).max(128),
+        status: z5.enum(["pending", "satisfied", "blocked"]),
+        evidenceRefs: z5.array(z5.string().min(1).max(256)).max(64)
+      }).strict()).max(64)
+    }).strict().optional(),
+    unresolvedFailures: z5.array(z5.object({
+      signature: z5.string().min(1).max(256),
+      class: z5.enum([
+        "schema_input",
+        "unknown_tool",
+        "permission_denied",
+        "command_exit",
+        "timeout",
+        "cancelled",
+        "hook",
+        "execution",
+        "no_progress",
+        "contract_required"
+      ]),
+      circuitOpen: z5.boolean()
+    }).strict()).max(16),
+    changedFiles: z5.array(z5.string().max(4096)).max(256),
+    checks: z5.array(verificationEvidenceSchema).max(64)
+  }).strict().optional()
+}).strict();
+var intentAssessmentSchema = z5.object({
+  version: z5.literal(1),
+  route: z5.enum(["direct_execute", "inspect_then_execute", "needs_input", "permission_required"]),
+  reasons: z5.array(z5.enum([
+    "simple_explicit_request",
+    "workspace_inference_available",
+    "explicit_user_choice_missing",
+    "public_api_compatibility_missing",
+    "runtime_permission_separate",
+    "clarification_resolved"
+  ])).min(1).max(8),
+  assessedAt: z5.string().datetime(),
+  retrievalHits: z5.number().int().nonnegative()
+}).strict();
+var pendingInputSchema = z5.object({
+  id: z5.string().uuid(),
+  runId: z5.string().uuid(),
+  createdAt: z5.string().datetime(),
+  originalRequest: z5.string().min(1).max(12e4),
+  question: z5.string().min(1).max(2e3),
+  options: z5.array(z5.object({
+    id: z5.string().regex(/^[a-z][a-z0-9_-]{0,63}$/u),
+    label: z5.string().min(1).max(160),
+    impact: z5.string().min(1).max(500),
+    recommended: z5.boolean()
+  }).strict()).min(2).max(3),
+  reason: z5.enum(["explicit_user_choice_missing", "public_api_compatibility_missing"])
+}).strict();
 var sessionSchema = z5.object({
   id: sessionIdSchema,
   title: z5.string(),
@@ -6432,6 +6907,10 @@ var sessionSchema = z5.object({
   contextSummary: z5.string().max(2e5).optional(),
   contextCompactions: z5.number().int().nonnegative().optional(),
   compactedThroughMessageId: z5.string().optional(),
+  contextCompactionReceipts: z5.array(contextCompactionReceiptSchema).max(64).optional(),
+  contextEpochs: z5.array(contextEpochSchema).max(64).optional(),
+  intentAssessment: intentAssessmentSchema.optional(),
+  pendingInput: pendingInputSchema.optional(),
   workingMemory: workingMemorySchema.optional(),
   contextSources: z5.array(contextSourceSchema).max(64).optional(),
   toolArtifacts: z5.array(toolArtifactSchema).max(200).optional(),
@@ -6582,7 +7061,7 @@ var SessionStore = class {
     const backup = this.backupPathFor(session.id);
     await this.assertManagedFile(target);
     await this.assertManagedFile(backup);
-    const temporary = join10(this.directory, `.${session.id}.${randomUUID8()}.tmp`);
+    const temporary = join10(this.directory, `.${session.id}.${randomUUID10()}.tmp`);
     const data = `${JSON.stringify(session, null, 2)}
 `;
     const handle = await open2(temporary, "wx", 384);
@@ -6600,7 +7079,7 @@ var SessionStore = class {
     }
   }
   async copyBackup(source, target) {
-    const temporary = join10(this.directory, `.${basename7(target)}.${randomUUID8()}.tmp`);
+    const temporary = join10(this.directory, `.${basename7(target)}.${randomUUID10()}.tmp`);
     try {
       await copyFile(source, temporary, constants4.COPYFILE_EXCL);
       await chmod6(temporary, 384);
@@ -6689,7 +7168,7 @@ var SessionStore = class {
   }
 };
 function createSession(options) {
-  const id = options.id ?? randomUUID8();
+  const id = options.id ?? randomUUID10();
   validateId(id);
   const now = (/* @__PURE__ */ new Date()).toISOString();
   return {
@@ -6704,6 +7183,12 @@ function createSession(options) {
     tasks: [],
     changedFiles: [],
     audit: [],
+    contextEpochs: [{
+      id: randomUUID10(),
+      index: 1,
+      startedAt: now,
+      usage: { inputTokens: 0, outputTokens: 0 }
+    }],
     usage: { inputTokens: 0, outputTokens: 0 }
   };
 }
@@ -7796,7 +8281,7 @@ function isUnsafeGitOption(argument) {
     "--exclude-from",
     "--output",
     "--directory"
-  ].some((option) => argument === option || argument.startsWith(`${option}=`));
+  ].some((option2) => argument === option2 || argument.startsWith(`${option2}=`));
 }
 function firstGitCommand(args) {
   for (const argument of args) {
@@ -8544,7 +9029,7 @@ async function discoverSnapshotFiles(root) {
 }
 
 // src/tools/task.ts
-import { randomUUID as randomUUID9 } from "node:crypto";
+import { randomUUID as randomUUID11 } from "node:crypto";
 import { z as z14 } from "zod";
 var taskSchema2 = z14.object({
   id: z14.string().min(1).optional(),
@@ -8593,7 +9078,7 @@ var taskTool = {
       case "list":
         break;
       case "add":
-        tasks.push({ id: randomUUID9(), title: input2.title, status: input2.status ?? "pending" });
+        tasks.push({ id: randomUUID11(), title: input2.title, status: input2.status ?? "pending" });
         break;
       case "update": {
         const task = tasks.find((item) => item.id === input2.id);
@@ -8610,7 +9095,7 @@ var taskTool = {
       }
       case "replace":
         tasks.splice(0, tasks.length, ...input2.tasks.map((task) => ({
-          id: task.id ?? randomUUID9(),
+          id: task.id ?? randomUUID11(),
           title: task.title,
           status: task.status
         })));
@@ -8624,11 +9109,11 @@ var taskTool = {
 };
 
 // src/tools/task-contract.ts
-import { randomUUID as randomUUID11 } from "node:crypto";
+import { randomUUID as randomUUID13 } from "node:crypto";
 import { z as z15 } from "zod";
 
 // src/agent/task-contract.ts
-import { randomUUID as randomUUID10 } from "node:crypto";
+import { randomUUID as randomUUID12 } from "node:crypto";
 var EXECUTABLE_INTENTS = /* @__PURE__ */ new Set(["debug", "refactor", "test", "implement"]);
 function shouldUseTaskContract(request, intent, existing) {
   if (existing && existing.state !== "satisfied") return true;
@@ -8694,7 +9179,7 @@ function refreshTaskContractState(contract) {
 }
 function criterion(id, description) {
   return {
-    id: `${id}-${randomUUID10().slice(0, 8)}`,
+    id: `${id}-${randomUUID12().slice(0, 8)}`,
     description,
     required: true,
     status: "pending",
@@ -9248,7 +9733,7 @@ var taskContractTool = {
       }
       const now = (/* @__PURE__ */ new Date()).toISOString();
       const criteria = input2.acceptance_criteria.map((item) => ({
-        id: item.id ?? `criterion-${randomUUID11().slice(0, 8)}`,
+        id: item.id ?? `criterion-${randomUUID13().slice(0, 8)}`,
         description: item.description,
         required: item.required ?? true,
         status: "pending",
@@ -9636,7 +10121,7 @@ ${workspaceRules}` : ""}`;
 }
 function buildSessionStatePrompt(session) {
   const tasks = session.tasks.length ? session.tasks.map((task) => `- [${task.status}] ${task.title}`).join("\n") : "- No active plan.";
-  const contract = session.taskContract && session.taskContract.state !== "satisfied" ? `
+  const contract = session.taskContract && session.taskContract.state !== "satisfied" && !session.compactedThroughMessageId ? `
 
 Task Contract (${session.taskContract.state}):
 Objective: ${session.taskContract.objective}
@@ -9716,6 +10201,118 @@ function escapeAttribute3(value) {
   })[character] ?? character);
 }
 
+// src/agent/intent-sufficiency.ts
+import { randomUUID as randomUUID14 } from "node:crypto";
+function assessIntentSufficiency(request, intent, context) {
+  const assessedAt = (/* @__PURE__ */ new Date()).toISOString();
+  const uiChoice = explicitUiChoice(request);
+  if (uiChoice) {
+    const pending = clarification(
+      request,
+      assessedAt,
+      "explicit_user_choice_missing",
+      isChinese(request) ? "\u8FD9\u4E2A\u754C\u9762\u884C\u4E3A\u9700\u8981\u4F60\u7684\u4EA7\u54C1\u504F\u597D\uFF0C\u5E94\u91C7\u7528\u54EA\u4E00\u79CD\uFF1F" : "This UI behavior depends on your product preference. Which should be used?",
+      uiChoice
+    );
+    return {
+      assessment: assessment("needs_input", "explicit_user_choice_missing", assessedAt, context.retrievalHits),
+      pending,
+      directive: "Pause before mutation and ask the single recorded clarification question."
+    };
+  }
+  if (publicApiCompatibilityMissing(request)) {
+    const chinese = isChinese(request);
+    const pending = clarification(
+      request,
+      assessedAt,
+      "public_api_compatibility_missing",
+      chinese ? "\u516C\u5171 API \u7684\u517C\u5BB9\u7B56\u7565\u5C1A\u672A\u6307\u5B9A\uFF0C\u5E94\u8BE5\u91C7\u7528\u54EA\u4E00\u79CD\uFF1F" : "The public API compatibility policy is unspecified. Which policy should be used?",
+      chinese ? [
+        option("backward_compatible", "\u4FDD\u6301\u5411\u540E\u517C\u5BB9", "\u4FDD\u7559\u65E7\u63A5\u53E3\u5E76\u63D0\u4F9B\u5F03\u7528\u6216\u8FC1\u79FB\u8DEF\u5F84\uFF1B\u6539\u52A8\u66F4\u7A33\u59A5\u4F46\u5B9E\u73B0\u8303\u56F4\u8F83\u5927\u3002", true),
+        option("breaking_change", "\u5141\u8BB8\u7834\u574F\u6027\u53D8\u66F4", "\u76F4\u63A5\u91C7\u7528\u65B0\u63A5\u53E3\uFF1B\u8303\u56F4\u66F4\u5C0F\uFF0C\u4F46\u8C03\u7528\u65B9\u5FC5\u987B\u540C\u6B65\u8FC1\u79FB\u3002", false)
+      ] : [
+        option("backward_compatible", "Preserve compatibility", "Keep the old API with a deprecation or migration path; safer but broader.", true),
+        option("breaking_change", "Allow breaking change", "Adopt the new API directly; smaller change but callers must migrate.", false)
+      ]
+    );
+    return {
+      assessment: assessment("needs_input", "public_api_compatibility_missing", assessedAt, context.retrievalHits),
+      pending,
+      directive: "Pause before mutation and ask the single recorded clarification question."
+    };
+  }
+  if (requiresRuntimePermission(request)) {
+    return {
+      assessment: assessment("permission_required", "runtime_permission_separate", assessedAt, context.retrievalHits),
+      directive: "The objective is sufficiently clear. Continue, but keep runtime permission approval separate from clarification."
+    };
+  }
+  if (context.complex && shouldInspectWorkspace(request, intent)) {
+    return {
+      assessment: assessment("inspect_then_execute", "workspace_inference_available", assessedAt, context.retrievalHits),
+      directive: "Do not ask the user for repository facts. Inspect the workspace and current evidence before the first mutation."
+    };
+  }
+  return {
+    assessment: assessment("direct_execute", "simple_explicit_request", assessedAt, context.retrievalHits),
+    directive: "The request is sufficiently clear. Execute without an extra clarification turn."
+  };
+}
+function resolvePendingInput(pending, answer) {
+  const normalized = answer.trim();
+  const byIndex = /^([1-3])(?:[.)、:]|$)/u.exec(normalized)?.[1];
+  const selected = pending.options.find((candidate) => candidate.id.toLocaleLowerCase() === normalized.toLocaleLowerCase() || candidate.label.toLocaleLowerCase() === normalized.toLocaleLowerCase()) ?? (byIndex ? pending.options[Number(byIndex) - 1] : void 0);
+  const decision = selected ? `${selected.label}: ${selected.impact}` : compact2(normalized, 2e3);
+  return { answer: compact2(normalized, 2e3), decision };
+}
+function assessment(route, reason, assessedAt, retrievalHits) {
+  return { version: 1, route, reasons: [reason], assessedAt, retrievalHits };
+}
+function clarification(originalRequest, createdAt, reason, question2, options) {
+  return {
+    id: randomUUID14(),
+    runId: randomUUID14(),
+    createdAt,
+    originalRequest: originalRequest.slice(0, 12e4),
+    question: question2,
+    options,
+    reason
+  };
+}
+function explicitUiChoice(value) {
+  const terms = "modal|dialog|drawer|popover|inline|new page|side panel|\u5F39\u7A97|\u6A21\u6001\u6846|\u62BD\u5C49|\u6D6E\u5C42|\u5185\u8054|\u9875\u9762\u5185|\u4FA7\u8FB9\u680F|\u65B0\u9875\u9762";
+  const match = value.match(new RegExp(`\\b(${terms})\\b\\s*(?:or|versus|vs\\.?)\\s*\\b(${terms})\\b`, "iu")) ?? value.match(new RegExp(`(${terms})[\uFF0C\u3001\\s]*(?:\u8FD8\u662F|\u6216\u8005|\u6216)[\uFF0C\u3001\\s]*(${terms})`, "iu"));
+  if (!match?.[1] || !match[2] || match[1].toLocaleLowerCase() === match[2].toLocaleLowerCase()) return;
+  const chinese = isChinese(value);
+  return [
+    option("choice_1", compact2(match[1], 80), chinese ? "\u91C7\u7528\u8BF7\u6C42\u4E2D\u5217\u51FA\u7684\u7B2C\u4E00\u79CD\u4EA4\u4E92\u65B9\u5F0F\u3002" : "Use the first interaction named in the request.", true),
+    option("choice_2", compact2(match[2], 80), chinese ? "\u91C7\u7528\u8BF7\u6C42\u4E2D\u5217\u51FA\u7684\u7B2C\u4E8C\u79CD\u4EA4\u4E92\u65B9\u5F0F\u3002" : "Use the second interaction named in the request.", false)
+  ];
+}
+function publicApiCompatibilityMissing(value) {
+  const api = /\b(?:public|external|exported)\s+(?:api|interface|contract)\b|公共\s*(?:api|接口)|公开\s*(?:api|接口)|对外接口/iu;
+  const change = /\b(?:change|replace|remove|rename|migrate|redesign|refactor)\b|修改|替换|删除|移除|重命名|迁移|重构/iu;
+  const policy = /\b(?:backward compatible|backwards compatible|breaking change|semver major|deprecat|compatibility shim|migration path)\b|向后兼容|保持兼容|允许破坏|破坏性变更|主版本|弃用|迁移路径/iu;
+  return api.test(value) && change.test(value) && !policy.test(value);
+}
+function requiresRuntimePermission(value) {
+  return /\b(?:push|publish|deploy|release|delete|drop|reset|force[- ]push|send|upload)\b|推送|发布|部署|删除|清空|重置|发送|上传/iu.test(value);
+}
+function shouldInspectWorkspace(value, intent) {
+  if (intent === "debug" || intent === "refactor" || intent === "review") return true;
+  const hasConcreteTarget = /(?:^|\s)(?:[\w.-]+\/)+[\w.-]+|`[^`]+`|\b[A-Za-z_$][\w$]*(?:\(\))?\b/u.test(value);
+  return !hasConcreteTarget || /\b(?:existing|current|relevant|appropriate|best)\b|现有|当前|相关|合适|最适合|这个|那个/iu.test(value);
+}
+function option(id, label, impact, recommended) {
+  return { id, label, impact, recommended };
+}
+function isChinese(value) {
+  return /[\u3400-\u9fff]/u.test(value);
+}
+function compact2(value, limit) {
+  return value.trim().replace(/\s+/gu, " ").slice(0, limit);
+}
+
 // src/agent/tool-recovery.ts
 import { createHash as createHash13 } from "node:crypto";
 var RETRY_BUDGET = {
@@ -9730,6 +10327,7 @@ var RETRY_BUDGET = {
   no_progress: 0,
   contract_required: 2
 };
+var FAILURE_CLASSES = Object.keys(RETRY_BUDGET);
 var REPAIR_HINT = {
   schema_input: "Correct the arguments to match the tool schema.",
   unknown_tool: "Choose a tool exposed for this turn.",
@@ -9831,6 +10429,9 @@ function classifyToolFailure(result, fallback = "execution") {
 function formatFailureReceipt(receipt) {
   return `Failure: ${receipt.class}; attempt ${receipt.attempt}; ${receipt.remaining} retries remain; circuit ${receipt.circuitOpen ? "open" : "closed"}. Repair: ${receipt.repairHint}`;
 }
+function resolvableFailureSignatures(call) {
+  return FAILURE_CLASSES.map((failureClass) => failureSignature(call, failureClass));
+}
 function isRetryable(failureClass) {
   return RETRY_BUDGET[failureClass] > 0;
 }
@@ -9954,12 +10555,12 @@ function preservedSignals(metadata) {
     }
   }
   const failure = metadata.failure;
-  if (isFailureReceipt(failure)) {
+  if (isFailureReceipt2(failure)) {
     lines.push(`failure-class: ${failure.class}; attempt ${failure.attempt}; ${failure.remaining} retries remain`);
   }
   return lines;
 }
-function isFailureReceipt(value) {
+function isFailureReceipt2(value) {
   return typeof value === "object" && value !== null && typeof value.class === "string" && typeof value.attempt === "number" && typeof value.remaining === "number";
 }
 function redactToolOutput(value) {
@@ -10095,15 +10696,15 @@ async function pinContextSource(session, workspace, requested) {
   const info = await stat9(resolved);
   const alias = workspace.display(resolved);
   const tokens2 = estimateTokens((await readFile13(resolved, "utf8")).slice(0, MAX_SOURCE_CHARS));
-  const list2 = sources(session);
-  const existing = list2.find((source2) => source2.path === alias);
+  const list = sources(session);
+  const existing = list.find((source2) => source2.path === alias);
   if (existing) {
     existing.state = "pinned";
     existing.tokens = tokens2;
     existing.addedAt = (/* @__PURE__ */ new Date()).toISOString();
     return existing;
   }
-  if (list2.length >= MAX_CONTEXT_SOURCES) {
+  if (list.length >= MAX_CONTEXT_SOURCES) {
     throw new Error(`Context source limit reached (${MAX_CONTEXT_SOURCES}); unpin something first.`);
   }
   if (info.size > 4e6) {
@@ -10115,31 +10716,31 @@ async function pinContextSource(session, workspace, requested) {
     tokens: tokens2,
     addedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
-  list2.push(source);
+  list.push(source);
   return source;
 }
 function unpinContextSource(session, requested) {
-  const list2 = session.contextSources;
-  if (!list2?.length) return void 0;
-  const match = matchSource(list2, requested);
+  const list = session.contextSources;
+  if (!list?.length) return void 0;
+  const match = matchSource(list, requested);
   if (!match) return void 0;
-  list2.splice(list2.indexOf(match), 1);
+  list.splice(list.indexOf(match), 1);
   return match.path;
 }
 function toggleMuteContextSource(session, requested) {
-  const list2 = session.contextSources;
-  if (!list2?.length) return void 0;
-  const match = matchSource(list2, requested);
+  const list = session.contextSources;
+  if (!list?.length) return void 0;
+  const match = matchSource(list, requested);
   if (!match) return void 0;
   match.state = match.state === "muted" ? "pinned" : "muted";
   return match;
 }
 async function resolvePinnedContent(session, workspace) {
-  const list2 = session.contextSources;
-  if (!list2?.length) return [];
+  const list = session.contextSources;
+  if (!list?.length) return [];
   const resolved = [];
   let remaining = MAX_PINNED_CHARS;
-  for (const source of list2) {
+  for (const source of list) {
     if (source.state !== "pinned") continue;
     if (remaining <= 0) break;
     try {
@@ -10171,10 +10772,10 @@ These files were explicitly pinned by the user and are re-read from disk each tu
 ${blocks.join("\n\n")}
 </pinned-context>`;
 }
-function matchSource(list2, requested) {
+function matchSource(list, requested) {
   const trimmed = requested.trim();
   if (!trimmed) return void 0;
-  return list2.find((source) => source.path === trimmed) ?? list2.find((source) => source.path.endsWith(`/${trimmed}`)) ?? list2.find((source) => source.path.includes(trimmed));
+  return list.find((source) => source.path === trimmed) ?? list.find((source) => source.path.endsWith(`/${trimmed}`)) ?? list.find((source) => source.path.includes(trimmed));
 }
 function escapeAttribute5(value) {
   return value.replace(/[&"<>]/g, (character) => ({
@@ -10648,16 +11249,35 @@ var AgentRunner = class {
   }
   async run(input2, options = {}) {
     if (this.running) throw new Error("This AgentRunner is already processing a turn.");
-    const request = input2.trim();
-    if (!request) throw new Error("User input cannot be empty.");
-    if (request.length > 12e4) {
+    const submittedRequest = input2.trim();
+    if (!submittedRequest) throw new Error("User input cannot be empty.");
+    if (submittedRequest.length > 12e4) {
       throw new Error("User input is too large; pass a focused request or attach files with @path.");
     }
+    let request = submittedRequest;
     this.running = true;
     this.contextEngine.resetDiagnostics?.();
     const emit = async (event) => {
       await options.onEvent?.(event);
     };
+    const pendingAtStart = this.session.pendingInput;
+    const resolvedInput = pendingAtStart ? resolvePendingInput(pendingAtStart, submittedRequest) : void 0;
+    if (pendingAtStart && resolvedInput) {
+      request = `${pendingAtStart.originalRequest}
+
+<user-clarification-decision source="explicit-user-input">
+${resolvedInput.decision}
+</user-clarification-decision>`;
+      delete this.session.pendingInput;
+      const constraint = `User clarification (${pendingAtStart.id}): ${resolvedInput.decision}`;
+      if (this.session.taskContract && !this.session.taskContract.constraints.includes(constraint)) {
+        this.session.taskContract.constraints.push(constraint);
+        if (this.session.taskContract.constraints.length > 64) {
+          this.session.taskContract.constraints.splice(0, this.session.taskContract.constraints.length - 64);
+        }
+        this.session.taskContract.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+      }
+    }
     const changeSequenceAtStart = this.changeSequence;
     const runStartedAt = (/* @__PURE__ */ new Date()).toISOString();
     const loadedProgressiveTools = /* @__PURE__ */ new Set();
@@ -10725,11 +11345,12 @@ var AgentRunner = class {
     try {
       throwIfAborted(options.signal);
       await this.reconcileToolArtifacts();
+      ensureContextEpoch(this.session);
       if (this.session.messages.length === 0 && this.session.title === "New session") {
         this.session.title = titleFromInput(request);
       }
       this.contextManager.startTurn(this.session, request);
-      const userMessage = message("user", request);
+      const userMessage = message("user", submittedRequest);
       this.activeReuseGate = { requestId: userMessage.id, request, attempted: false };
       this.session.messages.push(userMessage);
       await this.persist();
@@ -10737,11 +11358,48 @@ var AgentRunner = class {
       const turnDirective = buildTurnDirective(request, {
         agents: Boolean(this.config.agents?.enabled)
       });
+      const contractEnabled = shouldUseTaskContract(
+        request,
+        turnDirective.intent,
+        this.session.taskContract
+      );
       const packed = trivialTurn ? emptyPackedContext(selectContextBudget(request, this.config, {
         intent: turnDirective.intent,
         trivial: true
       })) : await this.packContext(request, { intent: turnDirective.intent });
       if (!trivialTurn) await emit({ type: "context", packed });
+      if (contractEnabled && (!this.session.taskContract || this.session.taskContract.state === "satisfied")) {
+        this.session.taskContract = createDraftTaskContract(request, this.session.audit?.at(-1)?.id);
+        await this.persist();
+        await emit({ type: "contract", contract: structuredClone(this.session.taskContract) });
+      }
+      let intentDirective;
+      if (pendingAtStart && resolvedInput) {
+        this.session.intentAssessment = {
+          version: 1,
+          route: "direct_execute",
+          reasons: ["clarification_resolved"],
+          assessedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          retrievalHits: packed.hits.length
+        };
+        intentDirective = "The user resolved the recorded clarification. Continue the same logical run and apply that decision without asking again.";
+        await emit({ type: "input_resolved", pendingId: pendingAtStart.id, runId: pendingAtStart.runId, answer: resolvedInput.answer });
+        await emit({ type: "intent", assessment: this.session.intentAssessment });
+      } else {
+        const intent = assessIntentSufficiency(request, turnDirective.intent, {
+          retrievalHits: packed.hits.length,
+          complex: contractEnabled
+        });
+        this.session.intentAssessment = intent.assessment;
+        intentDirective = intent.directive;
+        await emit({ type: "intent", assessment: intent.assessment });
+        if (intent.pending) {
+          this.session.pendingInput = intent.pending;
+          await this.persist();
+          await emit({ type: "needs_input", pending: intent.pending });
+          return finishRun("needs_input");
+        }
+      }
       const mentions = await this.packMentions(request);
       const retrievedContext = trivialTurn && !mentions.length ? "" : buildRetrievedContext(
         packed,
@@ -10769,22 +11427,23 @@ var AgentRunner = class {
           scope: augmentation.memoryScope ?? "session"
         });
       }
-      const contractEnabled = shouldUseTaskContract(
-        request,
-        turnDirective.intent,
-        this.session.taskContract
-      );
-      if (contractEnabled && (!this.session.taskContract || this.session.taskContract.state === "satisfied")) {
-        this.session.taskContract = createDraftTaskContract(request, this.session.audit?.at(-1)?.id);
-        await this.persist();
-        await emit({ type: "contract", contract: structuredClone(this.session.taskContract) });
-      }
       activeRunContract = contractEnabled ? this.session.taskContract : void 0;
+      let verificationAttempted = false;
+      const maxTurns = options.maxTurns ?? this.config.agent.maxTurns;
+      const epochTokenBudget = this.config.agent.maxEpochTokens ?? this.config.agent.maxSessionTokens;
+      const contextBudget = Math.max(24e3, Math.min(1e5, this.config.context.maxTokens * 3));
+      if (this.contextManager.shouldCompact(this.session, contextBudget)) {
+        const compacted = await this.compactContext(void 0, options.signal, "automatic");
+        if (compacted.status === "compacted") {
+          await emit({ type: "context_compacted", ...compacted });
+        }
+      }
       const promptSections = [
         `intent:${turnDirective.intent}`,
         ...workspaceRules ? ["rules"] : [],
         ...this.session.workingMemory ? ["working-memory"] : [],
-        ...contractEnabled ? ["task-contract"] : [],
+        ...contractEnabled && !this.session.compactedThroughMessageId ? ["task-contract"] : [],
+        ...this.session.compactedThroughMessageId ? ["compaction-facts"] : [],
         ...this.session.contextSummary ? ["session-summary"] : [],
         ...!trivialTurn ? [`context:${packed.engine}`] : [],
         ...packed.text ? [`code:${packed.engine}`] : [],
@@ -10792,23 +11451,20 @@ var AgentRunner = class {
         ...augmentation.skills?.length ? [`skills:${augmentation.skills.length}`] : [],
         ...augmentation.memoryCount ? [`memory:${augmentation.memoryCount}`] : []
       ];
-      let verificationAttempted = false;
-      const maxTurns = options.maxTurns ?? this.config.agent.maxTurns;
-      const contextBudget = Math.max(24e3, Math.min(1e5, this.config.context.maxTokens * 3));
-      if (this.contextManager.shouldCompact(this.session, contextBudget)) {
-        const compacted = await this.compactContext(void 0, options.signal);
-        await emit({ type: "context_compacted", ...compacted });
-      }
       for (let turn = 1; turn <= maxTurns; turn += 1) {
         throwIfAborted(options.signal);
         if (this.session.usage.inputTokens + this.session.usage.outputTokens >= this.config.agent.maxSessionTokens) {
           return finishRun("token_budget");
         }
+        if (contextEpochTokens(this.session) >= epochTokenBudget) {
+          await this.rollContextEpoch("token_budget", options.signal, emit);
+        }
         this.applySteering();
         await emit({ type: "thinking", turn });
         const dynamicPrompt = [
           buildSessionStatePrompt(this.session),
           turnDirective.text,
+          `<intent-sufficiency route="${this.session.intentAssessment?.route ?? "direct_execute"}">${intentDirective}</intent-sufficiency>`,
           this.contextManager.buildShortTermPrompt(this.session),
           pinnedContext,
           options.turnInstructions ?? "",
@@ -10821,7 +11477,9 @@ var AgentRunner = class {
           activeMessages(this.session),
           contextBudget
         );
-        const availableTokens = this.config.agent.maxSessionTokens - (this.session.usage.inputTokens + this.session.usage.outputTokens);
+        const availableLifetimeTokens = this.config.agent.maxSessionTokens - (this.session.usage.inputTokens + this.session.usage.outputTokens);
+        const availableEpochTokens = epochTokenBudget - contextEpochTokens(this.session);
+        const availableTokens = Math.min(availableLifetimeTokens, availableEpochTokens);
         const visibleTools = visibleToolDefinitions(
           this.tools,
           options.askMode === true,
@@ -10835,9 +11493,15 @@ var AgentRunner = class {
           loadedProgressiveTools
         );
         const estimatedInputTokens = estimateMessages2(messages) + estimateToolDefinitions(visibleTools);
-        if (availableTokens <= 0 || estimatedInputTokens >= availableTokens) {
+        if (estimatedInputTokens >= availableLifetimeTokens) {
           return finishRun("token_budget");
         }
+        if (availableTokens <= 0 || estimatedInputTokens >= availableEpochTokens) {
+          if (contextEpochTokens(this.session) === 0) return finishRun("token_budget");
+          await this.rollContextEpoch("token_budget", options.signal, emit);
+          turn -= 1;
+          continue;
+        }
         const maxOutputTokens = Math.max(1, Math.min(
           this.config.model.maxTokens ?? 8192,
           availableTokens - estimatedInputTokens
@@ -10859,7 +11523,7 @@ var AgentRunner = class {
             breakdown
           });
         }
-        const assistantId = randomUUID12();
+        const assistantId = randomUUID15();
         const response = await this.completeModel(
           messages,
           visibleTools,
@@ -11239,6 +11903,9 @@ ${completeContent}`;
         metadata.failure = receipt;
       } else {
         recovery.recordSuccess(call);
+        const historicalFailures = new Set((this.session.audit ?? []).filter((event) => event.type === "tool" && event.outcome === "failure").map((event) => failureSignatureFromMetadata(event.metadata?.failure)).filter((signature) => signature !== void 0));
+        const resolvedFailureSignatures = resolvableFailureSignatures(call).filter((signature) => historicalFailures.has(signature));
+        if (resolvedFailureSignatures.length) metadata.resolvedFailureSignatures = resolvedFailureSignatures;
       }
       const evidenceProgress = recovery.recordEvidence(call, {
         toolCallId: call.id,
@@ -11352,7 +12019,7 @@ ${completeContent}`;
   }
   appendAudit(event) {
     const audit = this.session.audit ?? (this.session.audit = []);
-    audit.push({ id: randomUUID12(), createdAt: (/* @__PURE__ */ new Date()).toISOString(), ...event });
+    audit.push({ id: randomUUID15(), createdAt: (/* @__PURE__ */ new Date()).toISOString(), ...event });
     if (audit.length > 5e3) audit.splice(0, audit.length - 5e3);
   }
   async acceptChangedFiles(paths) {
@@ -11373,7 +12040,7 @@ ${completeContent}`;
     const results = [];
     for (const command2 of this.config.agent.verifyCommands) {
       const call = {
-        id: `verify-${randomUUID12()}`,
+        id: `verify-${randomUUID15()}`,
         name: "shell",
         arguments: { command: command2, cwd: this.workspace.primaryRoot }
       };
@@ -11399,16 +12066,52 @@ ${completeContent}`;
       return [];
     }
   }
-  async compactContext(instructions, signal) {
+  async compactContext(instructions, signal, mode = "manual") {
     const result = await this.contextManager.compact(
       this.session,
       this.provider,
       signal,
-      instructions
+      instructions,
+      mode
     );
+    if (result.status === "compacted") {
+      recordTokenUsage(
+        this.session,
+        result.receipt.actual,
+        result.receipt.estimated.inputTokens,
+        result.receipt.estimated.outputTokens
+      );
+    }
+    const receipts = this.session.contextCompactionReceipts ?? (this.session.contextCompactionReceipts = []);
+    receipts.push(result.receipt);
+    if (receipts.length > 64) receipts.splice(0, receipts.length - 64);
     await this.persist();
     return result;
   }
+  async rollContextEpoch(reason, signal, emit) {
+    let receipt;
+    const contextBudget = Math.max(24e3, Math.min(1e5, this.config.context.maxTokens * 3));
+    if (this.contextManager.shouldCompact(this.session, contextBudget)) {
+      const compacted = await this.compactContext(
+        "Create a boundary handoff for the next bounded context epoch.",
+        signal,
+        "automatic"
+      );
+      receipt = compacted.receipt;
+      if (compacted.status === "compacted") await emit({ type: "context_compacted", ...compacted });
+    }
+    const rotated = rotateContextEpoch(this.session, reason, receipt);
+    await this.persist();
+    await emit({
+      type: "context_epoch",
+      index: rotated.current.index,
+      previousIndex: rotated.previous.index,
+      reason,
+      inputTokens: rotated.previous.usage.inputTokens,
+      outputTokens: rotated.previous.usage.outputTokens,
+      handoff: rotated.handoff
+    });
+  }
   getContextStatus() {
     return this.contextManager.status(this.session);
   }
@@ -11440,8 +12143,14 @@ ${completeContent}`;
   toolOutputBudget() {
     const contextWindowTokens = Math.max(24e3, Math.min(1e5, this.config.context.maxTokens * 3));
     const activeContextTokens = this.contextManager.status(this.session, contextWindowTokens).activeTokens;
-    const remainingSessionTokens = this.config.agent.maxSessionTokens - (this.session.usage.inputTokens + this.session.usage.outputTokens);
-    return dynamicToolOutputBudget(contextWindowTokens, activeContextTokens, remainingSessionTokens);
+    const remainingLifetimeTokens = this.config.agent.maxSessionTokens - (this.session.usage.inputTokens + this.session.usage.outputTokens);
+    const epochBudget = this.config.agent.maxEpochTokens ?? this.config.agent.maxSessionTokens;
+    const remainingEpochTokens = epochBudget - contextEpochTokens(this.session);
+    return dynamicToolOutputBudget(
+      contextWindowTokens,
+      activeContextTokens,
+      Math.min(remainingLifetimeTokens, remainingEpochTokens)
+    );
   }
   async protectToolResult(result) {
     const metadata = { ...result.metadata ?? {} };
@@ -11497,7 +12206,7 @@ ${completeContent}`;
 };
 function message(role, content, extra = {}) {
   return {
-    id: randomUUID12(),
+    id: randomUUID15(),
     role,
     content,
     createdAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -11612,6 +12321,7 @@ function recordTokenUsage(session, providerUsage, estimatedInputTokens, estimate
   const outputTokens = outputActual ?? estimatedOutputTokens;
   session.usage.inputTokens += inputTokens;
   session.usage.outputTokens += outputTokens;
+  recordContextEpochUsage(session, inputTokens, outputTokens);
   if (inputActual !== void 0) {
     session.usage.actualInputTokens = (session.usage.actualInputTokens ?? 0) + inputActual;
   } else {
@@ -11687,6 +12397,11 @@ ${content}` : content,
     ...failure ? { metadata: { failure } } : {}
   };
 }
+function failureSignatureFromMetadata(value) {
+  if (!value || typeof value !== "object") return;
+  const signature = value.signature;
+  return typeof signature === "string" && signature ? signature : void 0;
+}
 function visibleToolDefinitions(tools, askMode, contractEnabled, artifactReadAvailable, duplicationAvailable, request, loadedProgressiveTools) {
   const eligible = tools.definitions().filter(
     (tool) => (!askMode || tool.category === "read") && (contractEnabled || tool.name !== "task_contract") && (artifactReadAvailable || tool.name !== "read_tool_artifact") && (duplicationAvailable || tool.name !== "duplication_audit")
@@ -11894,7 +12609,7 @@ function integer(value, fallback, min, max) {
 }
 
 // src/agent/delegation.ts
-import { randomUUID as randomUUID14 } from "node:crypto";
+import { randomUUID as randomUUID17 } from "node:crypto";
 import { join as join18 } from "node:path";
 import { z as z19 } from "zod";
 
@@ -12023,7 +12738,7 @@ function numeric(...values) {
 }
 
 // src/agent/team-store.ts
-import { createHash as createHash16, randomUUID as randomUUID13 } from "node:crypto";
+import { createHash as createHash16, randomUUID as randomUUID16 } from "node:crypto";
 import { lstat as lstat18, readFile as readFile17, readdir as readdir7, rm as rm3 } from "node:fs/promises";
 import { join as join16, resolve as resolve18 } from "node:path";
 import { z as z18 } from "zod";
@@ -12117,7 +12832,7 @@ var TeamRunStore = class {
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const manifest = manifestSchema2.parse({
       version: 2,
-      id: randomUUID13(),
+      id: randomUUID16(),
       workspace: this.workspace,
       objective: input2.objective,
       reviewer: input2.reviewer,
@@ -12923,7 +13638,7 @@ var DelegationManager = class {
         maxReviewRounds: 0
       });
       await emit?.({ type: "team_start", id: board.id, objective: task });
-      const writerId = randomUUID14();
+      const writerId = randomUUID17();
       await emit?.({ type: "agent_queued", id: writerId, profile: profile.name, task, phase: "write" });
       const draft = await this.writerLane.createDraft(
         Math.min(this.team.maxWriterPatchBytes ?? 6e4, 12e4),
@@ -13293,7 +14008,7 @@ You are the only writer inside a disposable worktree. Make only the bounded requ
     const reviewer = reviewerOverride ?? this.team.reviewerProfile ?? "reviewer";
     const rounds = Math.max(0, this.team.maxReviewRounds ?? 1);
     const board = await this.teamStore?.create({ objective, reviewer, maxReviewRounds: rounds });
-    const runId = board?.id ?? randomUUID14();
+    const runId = board?.id ?? randomUUID17();
     await emit?.({ type: "team_start", id: runId, objective });
     try {
       let results = await this.runBatch(board?.id, tasks, "work", emit, signal);
@@ -13351,7 +14066,7 @@ ${review.summary}`,
     }
   }
   async runBatch(runId, tasks, phase, emit, signal) {
-    const scheduled = tasks.map((task) => ({ id: randomUUID14(), task }));
+    const scheduled = tasks.map((task) => ({ id: randomUUID17(), task }));
     for (const item of scheduled) {
       await emit?.({ type: "agent_queued", id: item.id, profile: item.task.profile, task: item.task.task, phase });
     }
@@ -13460,12 +14175,12 @@ Start the response with exactly VERDICT: ACCEPT when the evidence is sufficient,
     });
   }
   async peerMessage(runId, from, to, content, emit) {
-    const id = randomUUID14();
+    const id = randomUUID17();
     if (runId) await this.teamStore?.recordMessage(runId, { id, from, to, content });
     await emit?.({ type: "agent_message", id, from, to, content });
   }
   async runOne(task, phase, emit, signal, retryOf, scheduledId) {
-    const id = scheduledId ?? randomUUID14();
+    const id = scheduledId ?? randomUUID17();
     const profile = this.options.profiles.get(task.profile);
     const configuredRoute = this.team.routes?.[task.profile];
     const budgetMode = configuredRoute?.budgetMode ?? this.team.budgetMode ?? "observe";
@@ -14378,11 +15093,11 @@ ${this.glyphs.meta} ${session.changedFiles.length} changed files ${this.glyphs.s
 `);
   }
   printText(event) {
-    const { quiet, compact: compact2 } = this.options;
-    if (quiet) return;
+    const { quiet, compact: compact3 } = this.options;
+    if (quiet && event.type !== "needs_input") return;
     switch (event.type) {
       case "thinking":
-        if (!compact2) process.stderr.write(this.paint.dim(`${this.glyphs.meta} reasoning ${this.glyphs.separator} turn ${event.turn}
+        if (!compact3) process.stderr.write(this.paint.dim(`${this.glyphs.meta} reasoning ${this.glyphs.separator} turn ${event.turn}
 `));
         break;
       case "context": {
@@ -14394,7 +15109,7 @@ ${this.glyphs.meta} ${session.changedFiles.length} changed files ${this.glyphs.s
         break;
       }
       case "prompt":
-        if (!compact2) {
+        if (!compact3) {
           const partition = event.breakdown ? ` ${this.glyphs.separator} stable ${event.breakdown.stableTokens} ${this.glyphs.separator} dynamic ${event.breakdown.dynamicTokens} ${this.glyphs.separator} history ${event.breakdown.conversationTokens} ${this.glyphs.separator} tool results ${event.breakdown.toolResultTokens} ${this.glyphs.separator} retrieved ${event.breakdown.retrievedTokens} ${this.glyphs.separator} tools ${event.breakdown.toolSchemaTokens} ${this.glyphs.separator} output cap ${event.breakdown.outputAllowanceTokens}` : "";
           process.stderr.write(this.paint.dim(
             `${this.glyphs.meta} prompt ${this.glyphs.separator} ${event.intent} ${this.glyphs.separator} ~${event.estimatedTokens} estimated tokens${partition}
@@ -14430,7 +15145,7 @@ ${this.glyphs.meta} ${session.changedFiles.length} changed files ${this.glyphs.s
         }
         break;
       case "tasks":
-        if (!compact2) {
+        if (!compact3) {
           const completed = event.tasks.filter((task) => task.status === "completed").length;
           process.stderr.write(this.paint.dim(`${this.glyphs.meta} plan ${this.glyphs.separator} ${completed}/${event.tasks.length} complete
 `));
@@ -14451,6 +15166,22 @@ ${this.glyphs.meta} ${session.changedFiles.length} changed files ${this.glyphs.s
 `
         );
         break;
+      case "needs_input":
+        process.stderr.write(this.paint.yellow(`${this.glyphs.meta} ${event.pending.question}
+`));
+        event.pending.options.forEach((option2, index) => {
+          process.stderr.write(this.paint.dim(
+            `  ${index + 1}. ${option2.label}${option2.recommended ? " (recommended)" : ""} ${this.glyphs.separator} ${option2.impact}
+`
+          ));
+        });
+        break;
+      case "input_resolved":
+        process.stderr.write(this.paint.dim(
+          `${this.glyphs.meta} clarification resolved ${this.glyphs.separator} ${event.answer}
+`
+        ));
+        break;
       case "usage":
       case "permission":
       case "skill":
@@ -14461,6 +15192,8 @@ ${this.glyphs.meta} ${session.changedFiles.length} changed files ${this.glyphs.s
       case "agent_done":
       case "workflow":
       case "context_compacted":
+      case "context_epoch":
+      case "intent":
         break;
       case "done":
         this.printCompletion(event.completion);
@@ -14532,6 +15265,10 @@ function sessionSummary(session) {
     changedFiles: session.changedFiles,
     ...session.lastRun ? { lastRun: session.lastRun } : {},
     ...session.tokenLedger?.length ? { tokenLedger: session.tokenLedger } : {},
+    ...session.contextCompactionReceipts?.length ? { contextCompactionReceipts: session.contextCompactionReceipts } : {},
+    ...session.contextEpochs?.length ? { contextEpochs: session.contextEpochs } : {},
+    ...session.intentAssessment ? { intentAssessment: session.intentAssessment } : {},
+    ...session.pendingInput ? { pendingInput: session.pendingInput } : {},
     usage: session.usage
   };
 }
@@ -15224,7 +15961,7 @@ function ToolGlyph({ state, glyphs }) {
   if (state === "cancelled") return /* @__PURE__ */ jsx(Text, { color: theme.warning, children: glyphs.warning });
   return /* @__PURE__ */ jsx(Text, { color: theme.error, children: glyphs.error });
 }
-function Timeline({ items, width = 80, glyphMode = "auto", showToolOutput = false, expandedToolId, compact: compact2 = false }) {
+function Timeline({ items, width = 80, glyphMode = "auto", showToolOutput = false, expandedToolId, compact: compact3 = false }) {
   const theme = useTheme();
   const glyphs = resolveGlyphs(glyphMode);
   if (!items.length) {
@@ -15232,13 +15969,13 @@ function Timeline({ items, width = 80, glyphMode = "auto", showToolOutput = fals
   }
   return /* @__PURE__ */ jsx(Box, { flexDirection: "column", children: items.map((item, index) => {
     if (item.kind === "user") {
-      return /* @__PURE__ */ jsxs(Box, { marginBottom: compact2 || item.clipped ? 0 : 1, children: [
+      return /* @__PURE__ */ jsxs(Box, { marginBottom: compact3 || item.clipped ? 0 : 1, children: [
         /* @__PURE__ */ jsx(Box, { width: 2, children: /* @__PURE__ */ jsx(Text, { bold: true, color: theme.accent, children: glyphs.prompt }) }),
         /* @__PURE__ */ jsx(Text, { bold: true, color: theme.textStrong, wrap: "wrap", children: sanitizeTerminalText(item.text) })
       ] }, item.id);
     }
     if (item.kind === "assistant") {
-      return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginBottom: compact2 || item.clipped ? 0 : 1, children: [
+      return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginBottom: compact3 || item.clipped ? 0 : 1, children: [
         /* @__PURE__ */ jsxs(Text, { bold: true, color: theme.accent, children: [
           glyphs.brand,
           " ",
@@ -15254,7 +15991,7 @@ function Timeline({ items, width = 80, glyphMode = "auto", showToolOutput = fals
     }
     if (item.kind === "context") {
       const spans = item.spans ?? [];
-      const spanLimit = compact2 ? 2 : 3;
+      const spanLimit = compact3 ? 2 : 3;
       const innerWidth = Math.max(1, safeWidth(width) - 2);
       return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
         /* @__PURE__ */ jsx(
@@ -15267,7 +16004,7 @@ function Timeline({ items, width = 80, glyphMode = "auto", showToolOutput = fals
             labelColor: theme.accent
           }
         ),
-        !compact2 && item.budgetReason ? /* @__PURE__ */ jsx(Text, { color: theme.dim, children: truncateDisplay(`${glyphs.branchLast} ${sanitizeInlineTerminalText(item.budgetReason)}`, innerWidth) }) : null,
+        !compact3 && item.budgetReason ? /* @__PURE__ */ jsx(Text, { color: theme.dim, children: truncateDisplay(`${glyphs.branchLast} ${sanitizeInlineTerminalText(item.budgetReason)}`, innerWidth) }) : null,
         spans.slice(0, spanLimit).map((span, spanIndex) => {
           const lines = span.startLine === span.endLine ? `${span.startLine}` : `${span.startLine}-${span.endLine}`;
           const location = `${compactDisplayPath(sanitizeInlineTerminalText(span.path), 44)}:${lines}`;
@@ -15307,7 +16044,7 @@ function Timeline({ items, width = 80, glyphMode = "auto", showToolOutput = fals
       const duration = item.durationMs !== void 0 ? formatDuration(item.durationMs) : "";
       const detailText = [detail, duration].filter(Boolean).join("  ");
       const expanded = Boolean(item.output) && (showToolOutput || expandedToolId === item.id);
-      const verbose = expanded && item.output ? limitTerminalText(item.output, compact2 ? 24 : 80) : void 0;
+      const verbose = expanded && item.output ? limitTerminalText(item.output, compact3 ? 24 : 80) : void 0;
       const disclosure = item.output ? expanded ? glyphs.expanded : glyphs.collapsed : "";
       const disclosureWidth = disclosure ? displayWidth(disclosure) + 1 : 0;
       const nameLimit = Math.max(1, Math.min(rowWidth - 2 - disclosureWidth, rowWidth < 64 ? rowWidth - 2 - disclosureWidth : 28));
@@ -15439,9 +16176,28 @@ function Timeline({ items, width = 80, glyphMode = "auto", showToolOutput = fals
         item.id
       );
     }
+    if (item.kind === "clarification") {
+      const rowWidth = safeWidth(width);
+      const chinese = /[\u3400-\u9fff]/u.test(item.pending.question);
+      return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", paddingLeft: 2, marginBottom: 1, children: [
+        /* @__PURE__ */ jsx(Text, { bold: true, color: theme.warning, children: sanitizeTerminalText(item.pending.question) }),
+        item.pending.options.map((option2, optionIndex) => {
+          const label = `${optionIndex + 1}. ${sanitizeInlineTerminalText(option2.label)}${option2.recommended ? chinese ? "\uFF08\u63A8\u8350\uFF09" : " (recommended)" : ""}`;
+          const impact = sanitizeInlineTerminalText(option2.impact);
+          if (rowWidth < 48) {
+            return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+              /* @__PURE__ */ jsx(Text, { color: option2.recommended ? theme.textStrong : theme.muted, children: truncateDisplay(label, Math.max(1, rowWidth - 2)) }),
+              /* @__PURE__ */ jsx(Text, { color: theme.dim, children: truncateDisplay(`${glyphs.branchLast} ${impact}`, Math.max(1, (rowWidth - 2) * 2)) })
+            ] }, option2.id);
+          }
+          return /* @__PURE__ */ jsx(Text, { color: option2.recommended ? theme.textStrong : theme.muted, children: truncateDisplay(`${label} ${glyphs.separator} ${impact}`, Math.max(1, rowWidth - 2)) }, option2.id);
+        }),
+        /* @__PURE__ */ jsx(Text, { color: theme.dim, children: chinese ? "\u56DE\u590D\u7F16\u53F7\u3001\u9009\u9879\u540D\u79F0\uFF0C\u6216\u7B80\u77ED\u8BF4\u660E\u4F60\u7684\u51B3\u5B9A\u3002" : "Reply with a number, option label, or a short custom decision." })
+      ] }, item.id);
+    }
     if (item.kind === "list") return /* @__PURE__ */ jsx(ListPanel, { title: item.title, entries: item.entries, width, glyphMode }, item.id);
     if (item.kind === "context-inspector") {
-      return /* @__PURE__ */ jsx(ContextInspector, { status: item.status, working: item.working, summary: item.summary, width, compact: compact2, glyphMode }, item.id);
+      return /* @__PURE__ */ jsx(ContextInspector, { status: item.status, working: item.working, summary: item.summary, width, compact: compact3, glyphMode }, item.id);
     }
     if (item.kind === "theme") return /* @__PURE__ */ jsx(ThemePreview, { name: item.name, width, glyphs }, item.id);
     if (item.kind === "banner") {
@@ -15651,7 +16407,7 @@ function TaskRail({ tasks, width = 80, glyphMode = "auto", maxItems }) {
     ] }) : null
   ] });
 }
-function PermissionCard({ call, category, width = 80, glyphMode = "auto", workspace, compact: compact2 = false }) {
+function PermissionCard({ call, category, width = 80, glyphMode = "auto", workspace, compact: compact3 = false }) {
   const theme = useTheme();
   const glyphs = resolveGlyphs(glyphMode);
   const summary = permissionSummary(call);
@@ -15688,7 +16444,7 @@ function PermissionCard({ call, category, width = 80, glyphMode = "auto", worksp
     rowWidth >= 64 ? /* @__PURE__ */ jsx(Box, { paddingLeft: 2, children: /* @__PURE__ */ jsx(InlineRow, { parts: shortcuts, width: innerWidth, separator: `  ${glyphs.separator}  `, separatorColor: theme.border }) }) : rowWidth >= 28 ? /* @__PURE__ */ jsxs(Box, { paddingLeft: 2, flexDirection: "column", children: [
       /* @__PURE__ */ jsx(InlineRow, { parts: shortcuts.slice(0, 2), width: innerWidth, separator: "  ", separatorColor: theme.border }),
       /* @__PURE__ */ jsx(InlineRow, { parts: shortcuts.slice(2), width: innerWidth, separator: "  ", separatorColor: theme.border })
-    ] }) : compact2 ? /* @__PURE__ */ jsxs(Box, { paddingLeft: 2, flexDirection: "column", children: [
+    ] }) : compact3 ? /* @__PURE__ */ jsxs(Box, { paddingLeft: 2, flexDirection: "column", children: [
       /* @__PURE__ */ jsx(InlineRow, { parts: compactNarrowShortcuts.slice(0, 2), width: innerWidth, separator: " ", separatorColor: theme.border }),
       /* @__PURE__ */ jsx(InlineRow, { parts: compactNarrowShortcuts.slice(2), width: innerWidth, separator: " ", separatorColor: theme.border })
     ] }) : /* @__PURE__ */ jsx(Box, { paddingLeft: 2, flexDirection: "column", children: shortcuts.map((part) => part.color ? /* @__PURE__ */ jsx(Text, { color: part.color, children: truncateDisplay(part.text, innerWidth) }, part.text) : /* @__PURE__ */ jsx(Text, { children: truncateDisplay(part.text, innerWidth) }, part.text)) })
@@ -15949,15 +16705,16 @@ function MeterBar({ segments, total, width, glyphs }) {
     remainder ? /* @__PURE__ */ jsx(Text, { color: theme.border, children: glyphs.meterEmpty.repeat(remainder) }) : null
   ] });
 }
-function ContextInspector({ status, working, summary, width, memory, connections, sources: sources2, compact: compact2 = false, minimal = false, glyphMode = "auto" }) {
+function ContextInspector({ status, working, summary, width, memory, connections, sources: sources2, compact: compact3 = false, minimal = false, glyphMode = "auto" }) {
   const theme = useTheme();
   const glyphs = resolveGlyphs(glyphMode);
+  const hasCompactedContext = status.compactedMessages > 0 || Boolean(summary);
   if (minimal) {
     const rowWidth2 = safeWidth(width);
     const padding = rowWidth2 >= 4 ? 2 : 0;
     const innerWidth2 = Math.max(1, rowWidth2 - padding);
     const active = `${status.messageCount} msg ${glyphs.separator} ~${formatTokens(status.activeTokens)} tok`;
-    const focus = sanitizeTerminalText(working?.focus || working?.goal || (summary ? "summary ready" : "not established")).replace(/\s+/g, " ").trim() || "not established";
+    const focus = sanitizeTerminalText(working?.focus || working?.goal || (hasCompactedContext ? "handoff ready" : "not established")).replace(/\s+/g, " ").trim() || "not established";
     return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", paddingLeft: padding, children: [
       /* @__PURE__ */ jsx(Text, { bold: true, color: theme.textStrong, children: truncateDisplay(`Context ${formatPercent(status.pressure)} ${glyphs.separator} ${active}`, innerWidth2) }),
       /* @__PURE__ */ jsx(Text, { color: working ? theme.text : theme.muted, children: truncateDisplay(`working ${focus}`, innerWidth2) })
@@ -15966,13 +16723,19 @@ function ContextInspector({ status, working, summary, width, memory, connections
   const entries = [
     { label: "active", detail: `${status.messageCount} messages ${glyphs.separator} ~${formatTokens(status.activeTokens)} tokens ${glyphs.separator} tools ~${formatTokens(status.toolTokens)}` },
     { label: "short-term", detail: working ? `${working.focus || working.goal || "ready"} ${glyphs.separator} ${relativeTime(working.lastUpdatedAt)}` : "not established" },
-    { label: "summary", detail: summary ? `~${formatTokens(status.summaryTokens)} tokens ${glyphs.separator} ${status.compactedMessages} compacted` : "not created" },
+    { label: "summary", detail: hasCompactedContext ? `~${formatTokens(status.summaryTokens)} tokens ${glyphs.separator} ${status.compactedMessages} compacted${summary ? "" : ` ${glyphs.separator} facts`}` : "not created" },
     { label: "long-term", detail: memory ?? `retrieved by relevance ${glyphs.separator} untrusted context` }
   ];
-  if (!compact2 && working?.constraints.length) entries.push({ label: `constraints ${working.constraints.length}`, detail: working.constraints.slice(0, 2).join(` ${glyphs.separator} `) });
-  if (!compact2 && working?.decisions.length) entries.push({ label: `decisions ${working.decisions.length}`, detail: working.decisions.slice(0, 2).join(` ${glyphs.separator} `) });
-  if (!compact2 && working?.openQuestions.length) entries.push({ label: `open ${working.openQuestions.length}`, detail: working.openQuestions.slice(0, 2).join(` ${glyphs.separator} `), tone: "warning" });
-  if (!compact2 && working?.relevantFiles.length) entries.push({ label: "relevant files", detail: working.relevantFiles.map((file) => compactDisplayPath(sanitizeInlineTerminalText(file), 28)).join(` ${glyphs.separator} `) });
+  if (status.epochIndex !== void 0 && status.epochCount !== void 0 && status.epochTokens !== void 0 && status.epochBudget !== void 0 && status.lifetimeTokens !== void 0 && status.lifetimeBudget !== void 0) {
+    entries.splice(1, 0, {
+      label: "epoch",
+      detail: `#${status.epochIndex} ${formatTokens(status.epochTokens)}/${formatTokens(status.epochBudget)} ${glyphs.separator} lifetime ${formatTokens(status.lifetimeTokens)}/${formatTokens(status.lifetimeBudget)}`
+    });
+  }
+  if (!compact3 && working?.constraints.length) entries.push({ label: `constraints ${working.constraints.length}`, detail: working.constraints.slice(0, 2).join(` ${glyphs.separator} `) });
+  if (!compact3 && working?.decisions.length) entries.push({ label: `decisions ${working.decisions.length}`, detail: working.decisions.slice(0, 2).join(` ${glyphs.separator} `) });
+  if (!compact3 && working?.openQuestions.length) entries.push({ label: `open ${working.openQuestions.length}`, detail: working.openQuestions.slice(0, 2).join(` ${glyphs.separator} `), tone: "warning" });
+  if (!compact3 && working?.relevantFiles.length) entries.push({ label: "relevant files", detail: working.relevantFiles.map((file) => compactDisplayPath(sanitizeInlineTerminalText(file), 28)).join(` ${glyphs.separator} `) });
   if (sources2?.length) {
     const pinned = sources2.filter((source) => source.state === "pinned");
     const muted = sources2.filter((source) => source.state === "muted");
@@ -15988,7 +16751,7 @@ function ContextInspector({ status, working, summary, width, memory, connections
   const rowWidth = safeWidth(width);
   const innerWidth = Math.max(1, rowWidth - 2);
   const pressureColor = status.pressure >= 0.9 ? theme.error : status.pressure >= 0.75 ? theme.warning : theme.accent;
-  const summaryTokens = summary ? status.summaryTokens : 0;
+  const summaryTokens = hasCompactedContext ? status.summaryTokens : 0;
   const segments = [
     { label: "active", value: status.activeTokens, color: theme.accent },
     { label: "tools", value: status.toolTokens, color: theme.assistant },
@@ -16006,7 +16769,7 @@ function ContextInspector({ status, working, summary, width, memory, connections
         /* @__PURE__ */ jsx(MeterBar, { segments, total: meterTotal, width: meterWidth, glyphs })
       ] }) : null
     ] }),
-    /* @__PURE__ */ jsx(ListPanel, { title: "", hideTitle: true, entries, width, glyphMode })
+    /* @__PURE__ */ jsx(ListPanel, { title: "", hideTitle: true, entries, width: Math.max(1, rowWidth - 2), glyphMode })
   ] });
 }
 function ThemePreview({ name, width, glyphs }) {
@@ -16093,8 +16856,8 @@ function Banner({ model, engine, workspace, version, width, glyphs }) {
 function UpdateNotice({ current, latest, command: command2, highlights, width, glyphs }) {
   const theme = useTheme();
   const availableWidth = safeWidth(width);
-  const compact2 = availableWidth < 48;
-  const parts = compact2 ? [
+  const compact3 = availableWidth < 48;
+  const parts = compact3 ? [
     { text: `${glyphs.up} `, color: theme.accent, bold: true },
     { text: `v${current}`, color: theme.dim, bold: false },
     { text: ` ${glyphs.arrow} `, color: theme.muted, bold: false },
@@ -16115,7 +16878,7 @@ function UpdateNotice({ current, latest, command: command2, highlights, width, g
   const bullets = bulletWidth > 0 ? (highlights ?? []).map((line) => truncateDisplay(sanitizeInlineTerminalText(line), bulletWidth)) : [];
   return /* @__PURE__ */ jsxs(Box, { marginBottom: 1, flexDirection: "column", children: [
     /* @__PURE__ */ jsx(Box, { children: truncated ? /* @__PURE__ */ jsx(Text, { color: theme.muted, children: rendered }) : parts.map((part, index) => /* @__PURE__ */ jsx(Text, { color: part.color, bold: part.bold, children: part.text }, index)) }),
-    compact2 ? /* @__PURE__ */ jsx(Text, { color: theme.dim, children: truncateDisplay(`  run ${command2}`, availableWidth) }) : null,
+    compact3 ? /* @__PURE__ */ jsx(Text, { color: theme.dim, children: truncateDisplay(`  run ${command2}`, availableWidth) }) : null,
     bullets.map((line, index) => /* @__PURE__ */ jsx(Text, { color: theme.dim, children: `${bulletPrefix}${line}` }, index))
   ] });
 }
@@ -17023,9 +17786,9 @@ function tailText(value, width, maxRows) {
   return `${marker}
 ${selected.join("\n")}`;
 }
-function estimateTimelineItemRows(item, { width, compact: compact2 = false, showToolOutput = false, expandedToolId }) {
+function estimateTimelineItemRows(item, { width, compact: compact3 = false, showToolOutput = false, expandedToolId }) {
   const rowWidth = Math.max(1, Math.floor(width));
-  const gap = compact2 ? 0 : 1;
+  const gap = compact3 ? 0 : 1;
   if (item.kind === "user") return wrappedRows(item.text, Math.max(1, rowWidth - 2)) + (item.clipped ? 0 : gap);
   if (item.kind === "assistant") {
     return 1 + richTextRows(item.text, Math.max(1, rowWidth - 2)) + (item.clipped ? 0 : gap);
@@ -17037,7 +17800,7 @@ function estimateTimelineItemRows(item, { width, compact: compact2 = false, show
     const detail = item.errorDetail || item.detail;
     const detailRows = narrow && detail ? 1 : 0;
     const metaRows = item.meta ? 1 : 0;
-    const outputRows = (showToolOutput || item.id === expandedToolId) && item.output ? Math.min(compact2 ? 25 : 81, richTextRows(item.output, Math.max(1, rowWidth - 2))) : 0;
+    const outputRows = (showToolOutput || item.id === expandedToolId) && item.output ? Math.min(compact3 ? 25 : 81, richTextRows(item.output, Math.max(1, rowWidth - 2))) : 0;
     return 1 + detailRows + metaRows + outputRows;
   }
   if (item.kind === "list") {
@@ -17051,7 +17814,7 @@ function estimateTimelineItemRows(item, { width, compact: compact2 = false, show
   if (item.kind === "theme") return 3;
   if (item.kind === "context") {
     const metaRows = rowWidth < 64 ? 2 : 1;
-    const spanLimit = compact2 ? 2 : 3;
+    const spanLimit = compact3 ? 2 : 3;
     const spanCount = Math.min(item.spans?.length ?? 0, spanLimit);
     const moreRow = (item.spans?.length ?? 0) > spanLimit ? 1 : 0;
     const degradationRows = item.degradation ? metaRows : 0;
@@ -17281,7 +18044,7 @@ function SkeinApp({ runner, config, extensions, initialPrompt, askMode = false,
   const colorEnabled = config.ui.color && !process.env.NO_COLOR;
   const [theme, setTheme] = useState2(() => resolveThemeWithColor(config.ui.theme, colorEnabled));
   const [themeCatalogRevision, setThemeCatalogRevision] = useState2(0);
-  const [compact2, setCompact] = useState2(config.ui.compact);
+  const [compact3, setCompact] = useState2(config.ui.compact);
   const [interactionMode, setInteractionMode] = useState2(planMode ? "plan" : askMode ? "ask" : "build");
   const [input2, setInput] = useState2("");
   const [busy, setBusy] = useState2(false);
@@ -17318,6 +18081,7 @@ function SkeinApp({ runner, config, extensions, initialPrompt, askMode = false,
   const controller = useRef2(void 0);
   const processing = useRef2(false);
   const queued = useRef2([]);
+  const clarificationBacklog = useRef2([]);
   const stopRequested = useRef2(false);
   const startedInitial = useRef2(false);
   const lastSubmitted = useRef2(void 0);
@@ -17558,6 +18322,26 @@ function SkeinApp({ runner, config, extensions, initialPrompt, askMode = false,
         append({ id: nextId(), kind: "compaction", messages: event.omittedMessages, tokens: event.summaryTokens });
         refreshSession();
         break;
+      case "context_epoch":
+        append({
+          id: nextId(),
+          kind: "notice",
+          tone: "info",
+          text: `Context epoch ${event.previousIndex} \u2192 ${event.index}${separator}${event.reason.replace("_", " ")}${separator}${event.inputTokens + event.outputTokens} tokens preserved in the lifetime ledger.`
+        });
+        refreshSession();
+        break;
+      case "needs_input":
+        append({ id: nextId(), kind: "clarification", pending: event.pending });
+        refreshSession();
+        break;
+      case "input_resolved":
+        append({ id: nextId(), kind: "notice", tone: "success", text: `Clarification resolved${separator}${event.answer}` });
+        refreshSession();
+        break;
+      case "intent":
+        refreshSession();
+        break;
       case "usage":
         refreshSession();
         break;
@@ -17801,8 +18585,8 @@ function SkeinApp({ runner, config, extensions, initialPrompt, askMode = false,
         return true;
       }
       if (subcommand === "list") {
-        const list2 = runner.listContextSources();
-        appendList("Pinned context", list2.length ? list2.map((source) => ({
+        const list = runner.listContextSources();
+        appendList("Pinned context", list.length ? list.map((source) => ({
           label: `${source.state === "muted" ? "muted " : "pinned"}  ${source.path}`,
           detail: `~${source.tokens} tokens${separator}added ${source.addedAt.slice(0, 10)}`,
           tone: source.state === "muted" ? "warning" : "success"
@@ -17990,7 +18774,7 @@ function SkeinApp({ runner, config, extensions, initialPrompt, askMode = false,
     }
     if (command2 === "density") {
       const normalized = argument.toLocaleLowerCase();
-      const next = normalized === "compact" ? true : normalized === "comfortable" || normalized === "normal" ? false : normalized === "" || normalized === "toggle" ? !compact2 : void 0;
+      const next = normalized === "compact" ? true : normalized === "comfortable" || normalized === "normal" ? false : normalized === "" || normalized === "toggle" ? !compact3 : void 0;
       if (next === void 0) throw new Error("Usage: /density [compact|comfortable]");
       setCompact(next);
       await saveUiPreference({ compact: next });
@@ -18083,7 +18867,7 @@ function SkeinApp({ runner, config, extensions, initialPrompt, askMode = false,
       })));
       return true;
     }
-  }, [append, appendList, compact2, config, ellipsis, exit, extensions, interactionMode, refreshSession, requestPermission, runner, separator, showToolOutput, tasks, theme, workflows]);
+  }, [append, appendList, compact3, config, ellipsis, exit, extensions, interactionMode, refreshSession, requestPermission, runner, separator, showToolOutput, tasks, theme, workflows]);
   const submit = useCallback(async (raw, mode = "normal") => {
     const trimmed = raw.trim();
     if (!trimmed) return;
@@ -18098,6 +18882,7 @@ function SkeinApp({ runner, config, extensions, initialPrompt, askMode = false,
     if (processing.current && isExitCommand(trimmed)) {
       stopRequested.current = true;
       queued.current = [];
+      clarificationBacklog.current = [];
       setQueue([]);
       controller.current?.abort();
       exit();
@@ -18185,6 +18970,31 @@ function SkeinApp({ runner, config, extensions, initialPrompt, askMode = false,
           const snapshot = snapshotSession(nextSession);
           setSession(snapshot);
           setTasks(snapshot.tasks.map((task) => ({ ...task })));
+          if (snapshot.pendingInput) {
+            const deferred = queued.current.length;
+            clarificationBacklog.current.push(...queued.current);
+            queued.current = [];
+            setQueue([]);
+            if (deferred) append({
+              id: nextId(),
+              kind: "notice",
+              tone: "info",
+              text: `Paused ${deferred} queued follow-up${deferred === 1 ? "" : "s"} for clarification; they will resume after the answer.`
+            });
+            break;
+          }
+          if (clarificationBacklog.current.length) {
+            const resumed = clarificationBacklog.current.length;
+            queued.current = [...clarificationBacklog.current, ...queued.current];
+            clarificationBacklog.current = [];
+            setQueue([...queued.current]);
+            append({
+              id: nextId(),
+              kind: "notice",
+              tone: "success",
+              text: `Clarification resolved; resuming ${resumed} queued follow-up${resumed === 1 ? "" : "s"}.`
+            });
+          }
         } catch (error) {
           const message2 = error instanceof Error ? error.message : String(error);
           if (!abortController.signal.aborted && message2 !== lastEventError.current) {
@@ -18197,8 +19007,9 @@ function SkeinApp({ runner, config, extensions, initialPrompt, askMode = false,
           }
         }
         if (abortController.signal.aborted || stopRequested.current) {
-          const discarded = queued.current.length;
+          const discarded = queued.current.length + clarificationBacklog.current.length;
           queued.current = [];
+          clarificationBacklog.current = [];
           setQueue([]);
           if (discarded) append({ id: nextId(), kind: "notice", text: `Discarded ${discarded} queued follow-up${discarded === 1 ? "" : "s"}.` });
           break;
@@ -18447,7 +19258,7 @@ function SkeinApp({ runner, config, extensions, initialPrompt, askMode = false,
   const tokenTotal = session.usage.inputTokens + session.usage.outputTokens;
   const contextStatus = runner.getContextStatus();
   const frame = spinnerFrames()[frameIndex % spinnerFrames().length];
-  const compactUi = compact2 || terminalHeight < 28;
+  const compactUi = compact3 || terminalHeight < 28;
   const constrainedHeight = terminalHeight < 18;
   const compactComposer = terminalHeight < 18;
   const minimalInspector = terminalHeight < 22;
@@ -18663,6 +19474,9 @@ function initialTimeline(session, banner, setupProblem) {
       text: `Contract ${session.taskContract.state} | ${satisfied}/${required.length} accepted`
     });
   }
+  if (session.pendingInput) {
+    items.push({ id: `pending-input-${session.pendingInput.id}`, kind: "clarification", pending: session.pendingInput });
+  }
   if (setupProblem && items.length <= 1) items.push({ id: nextId(), kind: "notice", tone: "error", text: setupProblem });
   return items;
 }
@@ -18708,6 +19522,35 @@ function snapshotSession(source) {
         relevantFiles: [...source.workingMemory.relevantFiles]
       }
     } : {},
+    ...source.contextEpochs ? {
+      contextEpochs: source.contextEpochs.map((epoch) => ({
+        ...epoch,
+        usage: { ...epoch.usage },
+        ...epoch.handoff ? {
+          handoff: {
+            ...epoch.handoff,
+            ...epoch.handoff.contract ? {
+              contract: {
+                ...epoch.handoff.contract,
+                required: epoch.handoff.contract.required.map((criterion2) => ({
+                  ...criterion2,
+                  evidenceRefs: [...criterion2.evidenceRefs]
+                }))
+              }
+            } : {},
+            unresolvedFailures: epoch.handoff.unresolvedFailures.map((failure) => ({ ...failure })),
+            changedFiles: [...epoch.handoff.changedFiles],
+            checks: epoch.handoff.checks.map((check) => ({ ...check }))
+          }
+        } : {}
+      }))
+    } : {},
+    ...source.intentAssessment ? {
+      intentAssessment: { ...source.intentAssessment, reasons: [...source.intentAssessment.reasons] }
+    } : {},
+    ...source.pendingInput ? {
+      pendingInput: { ...source.pendingInput, options: source.pendingInput.options.map((option2) => ({ ...option2 })) }
+    } : {},
     usage: { ...source.usage }
   };
 }
@@ -18754,17 +19597,17 @@ function composerAttachments(value) {
   const paths = [...value.matchAll(/(?:^|\s)@([^\s]+)/g)].map((match) => match[1]).filter((path) => Boolean(path));
   return [...new Set(paths)].slice(-3);
 }
-function permissionRows(width, hasCwd, compact2) {
+function permissionRows(width, hasCwd, compact3) {
   const content = 3 + (hasCwd ? 1 : 0);
   if (width >= 64) return content + 2;
   if (width >= 28) return content + 3;
-  if (compact2) return content + 3;
+  if (compact3) return content + 3;
   return content + 5;
 }
-function contextInspectorRows(session, compact2, width, minimal) {
+function contextInspectorRows(session, compact3, width, minimal) {
   if (minimal) return 2;
   const working = session.workingMemory;
-  const entries = 5 + (compact2 ? 0 : (working?.constraints.length ? 1 : 0) + (working?.decisions.length ? 1 : 0) + (working?.openQuestions.length ? 1 : 0) + (working?.relevantFiles.length ? 1 : 0));
+  const entries = 6 + (compact3 ? 0 : (working?.constraints.length ? 1 : 0) + (working?.decisions.length ? 1 : 0) + (working?.openQuestions.length ? 1 : 0) + (working?.relevantFiles.length ? 1 : 0));
   return 2 + entries * (width < 52 ? 2 : 1);
 }
 function contextInspectorStatus(status) {
@@ -18774,7 +19617,13 @@ function contextInspectorStatus(status) {
     activeTokens: status.activeTokens,
     summaryTokens: status.summaryTokens,
     toolTokens: status.toolTokens,
-    compactedMessages: status.compactedMessages
+    compactedMessages: status.compactedMessages,
+    epochIndex: status.epochIndex,
+    epochCount: status.epochCount,
+    epochTokens: status.epochTokens,
+    epochBudget: status.epochBudget,
+    lifetimeTokens: status.lifetimeTokens,
+    lifetimeBudget: status.lifetimeBudget
   };
 }
 function toolDetail2(call) {
@@ -18816,14 +19665,14 @@ function WorkspacePreparationView({
   const theme = useTheme();
   const safeWidth2 = Math.max(1, Math.floor(width));
   const innerWidth = Math.max(1, safeWidth2 - (safeWidth2 >= 24 ? 4 : 0));
-  const compact2 = safeWidth2 < 48;
+  const compact3 = safeWidth2 < 48;
   const constrained = height < 14;
   const ascii = process.env.SKEIN_GLYPHS === "ascii" || process.env.MOSAIC_GLYPHS === "ascii";
   const spinner = (ascii ? [".", "o", "O", "o"] : ["\u25DC", "\u25E0", "\u25DD", "\u25DE", "\u25E1", "\u25DF"])[frame % (ascii ? 4 : 6)];
   const separator = ascii ? "|" : "\xB7";
   const brand = ascii ? "*" : PRODUCT_MARK;
   const phase = readiness ? "ready" : error ? "error" : progress.phase;
-  const phaseLabel = preparationLabel(phase, progress, readiness, compact2);
+  const phaseLabel = preparationLabel(phase, progress, readiness, compact3);
   const detail = preparationDetail(phase, progress, readiness, error);
   const modelLine = `model ${sanitizeTerminalText(model)}`;
   const workspaceLine = `workspace ${compactDisplayPath(sanitizeTerminalText(workspace), Math.max(1, innerWidth - 10))}`;
@@ -18835,14 +19684,14 @@ function WorkspacePreparationView({
         "  ",
         PRODUCT_NAME.toUpperCase()
       ] }),
-      !compact2 && !constrained ? /* @__PURE__ */ jsxs4(Text4, { color: theme.dim, children: [
+      !compact3 && !constrained ? /* @__PURE__ */ jsxs4(Text4, { color: theme.dim, children: [
         "  ",
         separator,
         "  LOCAL CONTEXT"
       ] }) : null
     ] }),
     !constrained ? /* @__PURE__ */ jsx4(Text4, { color: theme.muted, children: truncateDisplay("Ground the workspace before the first request.", innerWidth) }) : null,
-    !constrained && !compact2 ? /* @__PURE__ */ jsx4(Text4, { color: theme.dim, children: truncateDisplay(`${modelLine}  ${separator}  ${workspaceLine}`, innerWidth) }) : !constrained ? /* @__PURE__ */ jsxs4(Fragment3, { children: [
+    !constrained && !compact3 ? /* @__PURE__ */ jsx4(Text4, { color: theme.dim, children: truncateDisplay(`${modelLine}  ${separator}  ${workspaceLine}`, innerWidth) }) : !constrained ? /* @__PURE__ */ jsxs4(Fragment3, { children: [
       /* @__PURE__ */ jsx4(Text4, { color: theme.dim, children: truncateDisplay(modelLine, innerWidth) }),
       /* @__PURE__ */ jsx4(Text4, { color: theme.dim, children: truncateDisplay(workspaceLine, innerWidth) })
     ] }) : /* @__PURE__ */ jsx4(Text4, { color: theme.dim, children: truncateDisplay(workspaceLine, innerWidth) }),
@@ -18856,10 +19705,10 @@ function WorkspacePreparationView({
         step2.glyph,
         " "
       ] }),
-      /* @__PURE__ */ jsx4(Text4, { bold: step2.state === "active", color: step2.state === "pending" ? theme.dim : theme.textStrong, children: truncateDisplay(step2.label, compact2 ? 8 : 10) }),
+      /* @__PURE__ */ jsx4(Text4, { bold: step2.state === "active", color: step2.state === "pending" ? theme.dim : theme.textStrong, children: truncateDisplay(step2.label, compact3 ? 8 : 10) }),
       /* @__PURE__ */ jsxs4(Text4, { color: step2.state === "active" ? theme.muted : theme.dim, children: [
         "  ",
-        truncateDisplay(step2.detail, Math.max(1, innerWidth - displayWidth(step2.glyph) - (compact2 ? 12 : 14)))
+        truncateDisplay(step2.detail, Math.max(1, innerWidth - displayWidth(step2.glyph) - (compact3 ? 12 : 14)))
       ] })
     ] }, step2.id)) }),
     /* @__PURE__ */ jsxs4(Box3, { marginTop: 1, children: [
@@ -19000,9 +19849,9 @@ async function runWorkspacePreparation(engine, config, options = {}) {
   await instance.waitUntilExit();
   return result ?? { status: "cancelled" };
 }
-function preparationLabel(phase, progress, readiness, compact2 = false) {
+function preparationLabel(phase, progress, readiness, compact3 = false) {
   if (phase === "ready") {
-    if (compact2) return "Index verified";
+    if (compact3) return "Index verified";
     return readiness?.rebuilt ? "Workspace index created and verified" : "Workspace index verified";
   }
   if (phase === "error") return "Workspace preparation failed";
@@ -19406,7 +20255,7 @@ function OnboardingFlow({ initialConfig, saveConfig, onFinish }) {
   }, [finish, saveConfig, state]);
   return /* @__PURE__ */ jsx5(OnboardingScreen, { state, dispatch, width, compact: compactHeight });
 }
-function OnboardingScreen({ state, dispatch, width, compact: compact2 = false }) {
+function OnboardingScreen({ state, dispatch, width, compact: compact3 = false }) {
   const theme = useTheme();
   const ascii = process.env.SKEIN_GLYPHS === "ascii" || process.env.MOSAIC_GLYPHS === "ascii";
   const marker = ascii ? ">" : "\u203A";
@@ -19423,14 +20272,14 @@ function OnboardingScreen({ state, dispatch, width, compact: compact2 = false })
     ] }),
     /* @__PURE__ */ jsx5(Text6, { color: theme.border, children: truncateDisplay(stageDivider(ascii, headerWidth), headerWidth) }),
     /* @__PURE__ */ jsx5(Text6, { color: theme.dim, children: truncateDisplay(stage.name, headerWidth) }),
-    !compact2 ? /* @__PURE__ */ jsx5(Box4, { height: 1 }) : null,
+    !compact3 ? /* @__PURE__ */ jsx5(Box4, { height: 1 }) : null,
     /* @__PURE__ */ jsx5(Text6, { color: theme.textStrong, bold: true, children: truncateDisplay(titleForStep(state.step), headerWidth) }),
-    !compact2 ? /* @__PURE__ */ jsx5(Text6, { color: theme.muted, wrap: "wrap", children: descriptionForStep(state) }) : null,
+    !compact3 ? /* @__PURE__ */ jsx5(Text6, { color: theme.muted, wrap: "wrap", children: descriptionForStep(state) }) : null,
     summary ? /* @__PURE__ */ jsx5(Text6, { color: theme.dim, children: truncateDisplay(summary, headerWidth) }) : null,
-    !compact2 ? /* @__PURE__ */ jsx5(Box4, { height: 1 }) : null,
-    state.step === "method" ? /* @__PURE__ */ jsx5(OptionList, { options: methods, selected: state.selected, marker, width: headerWidth, compact: compact2 }) : null,
-    state.step === "official-provider" ? /* @__PURE__ */ jsx5(OptionList, { options: officialProviders, selected: state.selected, marker, width: headerWidth, compact: compact2 }) : null,
-    state.step === "relay-protocol" ? /* @__PURE__ */ jsx5(OptionList, { options: relayProtocols, selected: state.selected, marker, width: headerWidth, compact: compact2 }) : null,
+    !compact3 ? /* @__PURE__ */ jsx5(Box4, { height: 1 }) : null,
+    state.step === "method" ? /* @__PURE__ */ jsx5(OptionList, { options: methods, selected: state.selected, marker, width: headerWidth, compact: compact3 }) : null,
+    state.step === "official-provider" ? /* @__PURE__ */ jsx5(OptionList, { options: officialProviders, selected: state.selected, marker, width: headerWidth, compact: compact3 }) : null,
+    state.step === "relay-protocol" ? /* @__PURE__ */ jsx5(OptionList, { options: relayProtocols, selected: state.selected, marker, width: headerWidth, compact: compact3 }) : null,
     inputField ? /* @__PURE__ */ jsxs5(Box4, { flexDirection: "column", children: [
       /* @__PURE__ */ jsxs5(Box4, { children: [
         /* @__PURE__ */ jsx5(Text6, { color: theme.textStrong, bold: true, children: inputField.label }),
@@ -19458,18 +20307,18 @@ function OnboardingScreen({ state, dispatch, width, compact: compact2 = false })
       "! ",
       truncateDisplay(state.error, Math.max(1, headerWidth - 2))
     ] }) : null,
-    !compact2 ? /* @__PURE__ */ jsx5(Box4, { height: 1 }) : null,
+    !compact3 ? /* @__PURE__ */ jsx5(Box4, { height: 1 }) : null,
     /* @__PURE__ */ jsx5(Text6, { color: theme.dim, children: footerForStep(state, headerWidth) })
   ] });
 }
-function OptionList({ options, selected, marker, width, compact: compact2 }) {
+function OptionList({ options, selected, marker, width, compact: compact3 }) {
   const theme = useTheme();
-  return /* @__PURE__ */ jsx5(Box4, { flexDirection: "column", children: options.map((option, index) => {
+  return /* @__PURE__ */ jsx5(Box4, { flexDirection: "column", children: options.map((option2, index) => {
     const active = index === selected;
     const prefix = active ? `${marker} ` : "  ";
     const available = Math.max(1, width - displayWidth(prefix) - (active ? 2 : 0));
-    const label = `${prefix}${truncateDisplay(option.label, available)}`;
-    return /* @__PURE__ */ jsxs5(Box4, { flexDirection: "column", marginBottom: compact2 || index === options.length - 1 ? 0 : 1, children: [
+    const label = `${prefix}${truncateDisplay(option2.label, available)}`;
+    return /* @__PURE__ */ jsxs5(Box4, { flexDirection: "column", marginBottom: compact3 || index === options.length - 1 ? 0 : 1, children: [
       /* @__PURE__ */ jsx5(
         Text6,
         {
@@ -19479,8 +20328,8 @@ function OptionList({ options, selected, marker, width, compact: compact2 }) {
           children: active ? padDisplay(label, width) : label
         }
       ),
-      !compact2 && width >= 36 || active ? /* @__PURE__ */ jsx5(Box4, { marginLeft: 2, width: Math.max(1, width - 2), children: /* @__PURE__ */ jsx5(Text6, { color: active ? theme.muted : theme.dim, wrap: "wrap", children: option.detail }) }) : null
-    ] }, option.label);
+      !compact3 && width >= 36 || active ? /* @__PURE__ */ jsx5(Box4, { marginLeft: 2, width: Math.max(1, width - 2), children: /* @__PURE__ */ jsx5(Text6, { color: active ? theme.muted : theme.dim, wrap: "wrap", children: option2.detail }) }) : null
+    ] }, option2.label);
   }) });
 }
 function Confirmation({ state, width }) {
@@ -21181,7 +22030,7 @@ process.on("warning", (warning) => {
 var program = new Command();
 program.enablePositionalOptions();
 program.name(PRODUCT_COMMAND).description("A context-first, model-agnostic coding agent with an auditable workspace.").version(package_default.version).showSuggestionAfterError();
-program.argument("[prompt...]", "instruction for the agent").option("-p, --print", "run once and print the result").option("-a, --ask", "retrieval and inspection mode; mutation tools are denied").option("--plan", "read-only planning mode; propose changes without mutating the workspace").option("-q, --quiet", "print only the final response in text mode").addOption(new Option("--output-format <format>", "text, json, or stream-json").choices(["text", "json", "stream-json"]).default("text")).option("--compact", "reduce progress output in print mode").option("--yes", "approve all non-denied tool requests for this run").option("--auto-edit", "approve read/write requests and ask before shell/Git/network").option("--trust-project-config", "allow executable and security-sensitive settings from project config").option("--queue <prompt>", "run an additional prompt after the first one", collect, []).option("-w, --workspace <path>", "primary workspace root", process.cwd()).option("--add-workspace <path>", "additional workspace root", collect, []).option("--config <path>", "explicit config file").option("--provider <provider>", "model provider").option("--model <model>", "model identifier").option("--base-url <url>", "OpenAI-compatible or provider base URL").option("--max-turns <n>", "maximum agent turns").option("--token-budget <n>", "maximum cumulative session tokens").option("--resume [session]", "resume a session by id or prefix").option("-c, --continue", "resume the latest session").option("--no-color", "disable color output").option("--no-checkpoint", "disable pre-mutation checkpoints for this run").action(async (prompts, options) => {
+program.argument("[prompt...]", "instruction for the agent").option("-p, --print", "run once and print the result").option("-a, --ask", "retrieval and inspection mode; mutation tools are denied").option("--plan", "read-only planning mode; propose changes without mutating the workspace").option("-q, --quiet", "print only the final response in text mode").addOption(new Option("--output-format <format>", "text, json, or stream-json").choices(["text", "json", "stream-json"]).default("text")).option("--compact", "reduce progress output in print mode").option("--yes", "approve all non-denied tool requests for this run").option("--auto-edit", "approve read/write requests and ask before shell/Git/network").option("--trust-project-config", "allow executable and security-sensitive settings from project config").option("--queue <prompt>", "run an additional prompt after the first one", collect, []).option("-w, --workspace <path>", "primary workspace root", process.cwd()).option("--add-workspace <path>", "additional workspace root", collect, []).option("--config <path>", "explicit config file").option("--provider <provider>", "model provider").option("--model <model>", "model identifier").option("--base-url <url>", "OpenAI-compatible or provider base URL").option("--max-turns <n>", "maximum agent turns").option("--epoch-token-budget <n>", "maximum tokens before an internal context handoff").option("--token-budget <n>", "maximum lifetime tokens across the resumed session").option("--resume [session]", "resume a session by id or prefix").option("-c, --continue", "resume the latest session").option("--no-color", "disable color output").option("--no-checkpoint", "disable pre-mutation checkpoints for this run").action(async (prompts, options) => {
   await runChat(prompts, options);
 });
 program.command("init").description("Create a project-local config (preserving an existing .mosaic namespace)").option("-w, --workspace <path>", "workspace root").option("--provider <provider>", "openai, anthropic, gemini, or compatible", "openai").option("--model <model>", "model identifier").option("--base-url <url>", "provider base URL").option("--api-key <key>", "store a provider key in project config (prefer env vars)").option("--index", "build the index after writing config").option("--yes", "use defaults without prompting").action(async (options) => {
@@ -21872,6 +22721,7 @@ async function runChat(prompts, options) {
       requestPermission
     });
     for (const queued of options.queue) {
+      if (session.pendingInput) break;
       session = await runner.run(queued, {
         askMode: options.ask === true || options.plan === true,
         ...options.plan ? { turnInstructions: PLAN_MODE_INSTRUCTIONS } : {},
@@ -21881,6 +22731,7 @@ async function runChat(prompts, options) {
       });
     }
     reporter.finish(session);
+    if (session.pendingInput) process.exitCode = 2;
   } catch (error) {
     reporter.fail(error);
     process.exitCode = 1;
@@ -22049,6 +22900,7 @@ async function runtimeConfig(workspaceInput, options) {
     agent: {
       ...loaded.agent,
       ...options.checkpoint === false ? { checkpointBeforeWrite: false } : {},
+      ...options.epochTokenBudget ? { maxEpochTokens: positiveInt(options.epochTokenBudget, loaded.agent.maxEpochTokens ?? loaded.agent.maxSessionTokens) } : {},
       ...options.tokenBudget ? { maxSessionTokens: positiveInt(options.tokenBudget, loaded.agent.maxSessionTokens) } : {}
     },
     ui: { ...loaded.ui, ...options.color === false ? { color: false } : {} }
@@ -22198,6 +23050,7 @@ function runtimeOptions(options) {
   const provider = options.provider ?? root.provider;
   const model = options.model ?? root.model;
   const baseUrl = options.baseUrl ?? root.baseUrl;
+  const epochTokenBudget = options.epochTokenBudget ?? root.epochTokenBudget;
   const tokenBudget = options.tokenBudget ?? root.tokenBudget;
   return {
     addWorkspace: [...root.addWorkspace ?? [], ...options.addWorkspace ?? []],
@@ -22206,6 +23059,7 @@ function runtimeOptions(options) {
     ...model ? { model } : {},
     ...baseUrl ? { baseUrl } : {},
     ...options.maxTokens ? { maxTokens: options.maxTokens } : {},
+    ...epochTokenBudget ? { epochTokenBudget } : {},
     ...tokenBudget ? { tokenBudget } : {},
     ...root.color !== void 0 ? { color: root.color } : {},
     ...root.checkpoint !== void 0 ? { checkpoint: root.checkpoint } : {},