@cortexkit/opencode-magic-context 0.49.23 → 0.49.25

package/dist/{index-11gzxvf4.js → index-y6xpzjzr.js}

@@ -163,12 +163,13 @@ import {
   DREAM_TASK_PROMOTION_DEFAULTS
 } from "./index-nxrsns5x.js";
 import {
+  areRustHistorianSyntheticParts2,
   isRawCompactionSummaryInfo2,
   extractInMemoryMessageViews2,
   buildInMemoryTailRawMessages2,
   RawOrdinalsNotReady2,
   runSessionWarmupWorker
-} from "./index-jfem3dgz.js";
+} from "./index-7tdtpqrg.js";
 import {
   openCodeDbExists,
   withReadOnlySessionDb,
@@ -176,9 +177,10 @@ import {
   latestPersistedMessageForRecovery,
   latestRealUserTurnIdFromOpenCodeDb,
   findLastAssistantModelFromOpenCodeDb
-} from "./index-ksq50rg0.js";
+} from "./index-c9zrgcnt.js";
 import {
   expandToolPart,
+  askAnswerLines,
   takeCoveredInstructionRows,
   cloneKeepingCoveredInstructionMarks,
   estimateTrueRawMessageTokens,
@@ -300,10 +302,11 @@ import {
   readRawSessionMessageById2,
   readSessionChunk2,
   readRawSessionSeedTail2
-} from "./index-mnhcdfxg.js";
+} from "./index-yrrsp47d.js";
 import {
+  BoundedSessionMap,
   getMeasuredToolDefinitionTokens
-} from "./index-j76ah6d7.js";
+} from "./index-cfaet9cg.js";
 import {
   isFailClosedBlockingError,
   shouldBypassFailClosedBlock,
@@ -317,7 +320,7 @@ import {
   runSqliteOptimize,
   openDatabase,
   openCurrentDatabase
-} from "./index-a9zvn5fe.js";
+} from "./index-q7ywt6xt.js";
 import {
   registerOwnRpcServerInstance,
   rpcPortDir,
@@ -512,7 +515,7 @@ import {
   snapRangeToCompartments,
   getActiveCompartmentRun,
   startCompartmentAgent
-} from "./index-y76rhsnr.js";
+} from "./index-0s8454t2.js";
 import {
   embedPauseBySession,
   embedRunStateBySession,
@@ -540,7 +543,7 @@ import {
   embedSessionCompartmentChunks2,
   getEmbeddingCoverageStatus2,
   getAutoEmbeddingSessionCoverage2
-} from "./index-zy67whjr.js";
+} from "./index-z05n7702.js";
 import {
   SubcClient,
   connectionFileExists,
@@ -550,7 +553,6 @@ import {
   SynapseEmbeddingProvider
 } from "./index-wfybj1dw.js";
 import {
-  BoundedSessionMap,
   LkgRecoveryFenceError,
   lkgServedArrayDigest,
   takeLkgRecoveryLockSweepPage,
@@ -571,7 +573,7 @@ import {
   indexSingleMessage2,
   indexMessagesAfterOrdinal2,
   sweepOrphanedOpenCodeMessageIndexesCooperatively2
-} from "./index-mnnkgq0q.js";
+} from "./index-awcftgmx.js";
 import {
   renderUserFacingFailure,
   userFacingFailureCode,
@@ -615,7 +617,7 @@ import {
   readGitFileChangeTimesSince,
   verificationFileExists,
   normalizeVerificationFiles
-} from "./index-3svaejkh.js";
+} from "./index-z928hmnp.js";
 import {
   registerNotificationSink2,
   pushNotification2,
@@ -635,7 +637,7 @@ import {
 } from "./index-4dhv7mqz.js";
 import {
   cosineSimilarity
-} from "./index-rxqr723x.js";
+} from "./index-t6j3qxnd.js";
 import {
   computeCueContentHash,
   hasMuralCueColumns,
@@ -681,17 +683,17 @@ import {
   resolveMemoriesByIdsForSearch2,
   unifiedSearch2,
   formatSearchResults2
-} from "./index-syaazvy2.js";
+} from "./index-n18sch77.js";
 import {
   flushIgnoredMessages2,
   clearIgnoredMessages2,
   observeIgnoredNotificationEvent2,
   sendStatusNotification2
-} from "./index-66eby7hx.js";
+} from "./index-jcr6pe7z.js";
 import {
   setRecompStarting2,
   setRecompTerminal2
-} from "./index-ffzhwfzy.js";
+} from "./index-zzrzjnx5.js";
 import {
   makeToolCompositeKey,
   searchMessageHistoryOffThread,
@@ -752,7 +754,7 @@ import {
   abortSessionFailClosed2,
   evaluateEmergencyFailClosed2,
   runPostTransformPhase2
-} from "./index-1kbznkft.js";
+} from "./index-axjgxeww.js";
 import {
   ANNOUNCEMENT_VERSION2,
   ANNOUNCEMENT_FEATURES2,
@@ -765,7 +767,7 @@ import {
 } from "./index-fmsr7v69.js";
 import {
   renderSearchArchiveOffThread2
-} from "./index-j32jj2t8.js";
+} from "./index-bhyksfyy.js";
 import {
   COMPACTION_ENABLED_PATH,
   isDreamerRunnable,
@@ -7795,7 +7797,10 @@ function orientationRenderer(capTokens) {
       sawMessage = true;
       const out = [];
       if (msg.role === "user" && hasMeaningfulUserText2(msg.parts)) {
-        const text = extractTexts2(msg.parts).map((t) => cleanUserText2(t)).map(normalizeText).filter((t) => t.length > 0).join(" / ");
+        const rawTexts = extractTexts2(msg.parts);
+        const parts = rawTexts.map((t) => cleanUserText2(t)).map(normalizeText).filter((t) => t.length > 0);
+        parts.push(...rawTexts.flatMap((t) => askAnswerLines(t)).map(normalizeText));
+        const text = parts.filter((t) => t.length > 0).join(" / ");
         if (text)
           out.push(`U: ${text}`);
       }
@@ -15761,7 +15766,7 @@ function buildSidebarSnapshot(db, sessionId, directory, liveSessionState, inject
       if (model) {
         activeProviderID = model.providerID;
         activeModelID = model.modelID;
-        measuredToolDefTokens = getMeasuredToolDefinitionTokens(model.providerID, model.modelID, agent) ?? 0;
+        measuredToolDefTokens = getMeasuredToolDefinitionTokens(model.providerID, model.modelID, agent, sessionId) ?? 0;
       }
     }
     const contextLimit = typeof moduleContextLimit === "number" && moduleContextLimit > 0 ? moduleContextLimit : activeProviderID && activeModelID ? resolveContextLimit(activeProviderID, activeModelID, {
@@ -16475,8 +16480,8 @@ function registerRpcHandlers(rpcServer, args) {
     const db = readDatabase();
     if (!db)
       return { ok: false, error: "db unavailable" };
-    const { runManagedRecomp } = await importPluginModule(() => import("./recomp-orchestrator-hbm53jj5.js"));
-    const { sendIgnoredMessage } = await importPluginModule(() => import("./send-session-notification-gqzkz7da.js"));
+    const { runManagedRecomp } = await importPluginModule(() => import("./recomp-orchestrator-qwqeskhq.js"));
+    const { sendIgnoredMessage } = await importPluginModule(() => import("./send-session-notification-ygj4mja0.js"));
     log2(`[rpc] recomp requested for session ${sessionId}`);
     if (!args.client && !args.hiddenCompletionExecutor) {
       return {
@@ -16560,7 +16565,7 @@ function registerRpcHandlers(rpcServer, args) {
     const db = readDatabase();
     if (!db)
       return { ok: false, error: "db unavailable" };
-    const { runManagedWrapup } = await importPluginModule(() => import("./wrapup-orchestrator-5vpcd1zx.js"));
+    const { runManagedWrapup } = await importPluginModule(() => import("./wrapup-orchestrator-f642w8n3.js"));
     const model = liveSessionState.liveModelBySession.get(sessionId);
     const contextLimit = model ? resolveContextLimit(model.providerID, model.modelID, { db, sessionID: sessionId }) : 128000;
     const ctx = {
@@ -18259,7 +18264,8 @@ function measureLkgReplayRequest(args) {
       systemPromptTokens: args.systemPromptTokens,
       providerID: args.model?.providerID,
       modelID: args.model?.modelID,
-      agentName: args.agentName
+      agentName: args.agentName,
+      sessionId: args.sessionId
     })
   });
 }
@@ -18990,8 +18996,7 @@ function encodeOpenCodeMessagesToCk(messages) {
     const createdAtMs = typeof time.created === "number" ? time.created : typeof info.time_created === "number" ? info.time_created : typeof info.timeCreated === "number" ? info.timeCreated : undefined;
     const completedAtMs = typeof time.completed === "number" ? time.completed : typeof info.time_completed === "number" ? info.time_completed : typeof info.timeCompleted === "number" ? info.timeCompleted : undefined;
     const parts = Array.isArray(raw.parts) ? raw.parts : [];
-    const syntheticParts = parts.filter((part) => part === null || typeof part !== "object" || part.type !== "compaction");
-    const synthetic = syntheticParts.length > 0 && syntheticParts.every((part) => part !== null && typeof part === "object" && (part.synthetic === true || part.syntheticTodoMarker === true));
+    const synthetic = areRustHistorianSyntheticParts2(parts);
     const content = [];
     const recoveryToolTitles = {};
     const userAnswerBlocks = [];
@@ -22149,7 +22154,8 @@ function createRustModeTransform(deps, options) {
             systemPromptTokens: sessionMeta.systemPromptTokens,
             providerID: model?.providerID,
             modelID: model?.modelID,
-            agentName: deps.getNotificationParams?.(sessionId)?.agent
+            agentName: deps.getNotificationParams?.(sessionId)?.agent,
+            sessionId
           })
         });
         if (measure.fit !== "under") {
@@ -22720,7 +22726,8 @@ function createRustModeTransform(deps, options) {
         systemPromptTokens: sessionMeta.systemPromptTokens,
         providerID: model?.providerID,
         modelID: model?.modelID,
-        agentName: deps.getNotificationParams?.(sessionId)?.agent
+        agentName: deps.getNotificationParams?.(sessionId)?.agent,
+        sessionId
       }) : undefined;
       const renderIdentityFields = {
         modelKey: modelKey ?? null,
@@ -23252,6 +23259,7 @@ function createRustModeTransform(deps, options) {
             providerID: model?.providerID,
             modelID: model?.modelID,
             agentName: deps.getNotificationParams?.(sessionId)?.agent,
+            sessionId,
             systemPromptHash: sessionMeta.systemPromptHash
           }, resolvedWindowGeometry?.usableHard ?? resolvedContextLimit);
           const refusal = outgoingContextRefusal(servedFinalWireEstimate, resolvedWindowGeometry?.usableHard ?? resolvedContextLimit, protectedToolTokenCount(getActiveTagsBySession2(deps.db, sessionId), deps.protectedTools, resolveDecisionCalibration(model?.providerID, model?.modelID))) ?? (signedThinkingReset ? signedTurnContextRefusal(servedFinalWireEstimate, resolvedWindowGeometry?.usableHard ?? resolvedContextLimit) : undefined);
@@ -23487,6 +23495,7 @@ function createRustModeTransform(deps, options) {
         providerID: model?.providerID,
         modelID: model?.modelID,
         agentName: deps.getNotificationParams?.(sessionId)?.agent,
+        sessionId,
         systemPromptHash: sessionMeta.systemPromptHash
       });
       captureOpencodeReasoningBudgetStatus(sessionId, output.messages, resolveKeepReasoningTokens(deps.keepReasoningTokens, modelKey ?? undefined), isPrefixBoundThinkingModel(model?.providerID, model?.modelID));
@@ -23750,6 +23759,27 @@ function createRustModeTransform(deps, options) {
   return adapter;
 }
 
+// src/hooks/magic-context/signed-thinking-fit-snapshot.ts
+function takeSignedThinkingFitSnapshot(args) {
+  let snapshot = null;
+  if (args.held && !args.compactionOff) {
+    try {
+      snapshot = cloneKeepingCoveredInstructionMarks(args.entryOrder);
+    } catch (error) {
+      sessionLog2(args.sessionId, `signed thinking fit: could not copy the pass input (${error instanceof Error ? error.message : String(error)}); an over-window held request will be refused rather than retried`);
+    }
+  }
+  snapshotObserver?.({
+    sessionId: args.sessionId,
+    held: args.held,
+    activeAnthropicThinkingTurn: args.activeAnthropicThinkingTurn,
+    compactionOff: args.compactionOff,
+    snapshot
+  });
+  return snapshot;
+}
+var snapshotObserver;
+
 // src/hooks/magic-context/signed-thinking-hold.ts
 var HEAVY_REASONING_TOKENS = 1500;
 var HEAVY_REASONING_WINDOW_STEPS = 15;
@@ -24370,7 +24400,7 @@ function createTransform(deps) {
     const startTime = performance.now();
     const historianRun = deps.resolveHistorianRun?.();
     const messages = output.messages;
-    const originalForThinkingFit = messages.some((message) => message.parts.some((part) => isRecord(part) && ["reasoning", "thinking", "redacted_thinking"].includes(String(part.type)))) ? cloneKeepingCoveredInstructionMarks(messages) : null;
+    const entryOrderForThinkingFit = messages.slice();
     const coveredHostInstructions = takeCoveredInstructionRows(messages);
     const passOutcome = createPassOutcome();
     const tSessionId = performance.now();
@@ -24724,7 +24754,8 @@ function createTransform(deps) {
           systemPromptTokens: sessionMeta.systemPromptTokens,
           providerID: modelForBudget?.providerID,
           modelID: modelForBudget?.modelID,
-          agentName: runNotificationParams(sessionId)?.agent
+          agentName: runNotificationParams(sessionId)?.agent,
+          sessionId
         });
         const incomingTokens = incoming.messageTokens.conversation + incoming.messageTokens.toolCall;
         if (unmanagedOverWindowCarried || isClearlyOverWindow(incomingTokens, resolvedContextLimit)) {
@@ -24770,6 +24801,13 @@ function createTransform(deps) {
     }) : null;
     activeThinkingPrefixHold = signedThinkingPrefixBound && (compactionOff || signedThinkingHold?.held === true);
     freezeM0M1 ||= activeThinkingPrefixHold;
+    const originalForThinkingFit = takeSignedThinkingFitSnapshot({
+      sessionId,
+      entryOrder: entryOrderForThinkingFit,
+      held: activeThinkingPrefixHold,
+      activeAnthropicThinkingTurn: activeThinkingTurn,
+      compactionOff
+    });
     const prefixHoldLogKey = signedThinkingHold ? `${currentTurnId}:${signedThinkingHold.reason}:${signedThinkingHold.heavyStepsBack ?? "none"}` : freezeM0M1 ? `${currentTurnId}:directory` : null;
     if (prefixHoldLogKey !== null && prefixHoldLogTurnIds.get(sessionId) !== prefixHoldLogKey) {
       prefixHoldLogTurnIds.set(sessionId, prefixHoldLogKey);
@@ -25261,7 +25299,8 @@ Historian previously failed ${historianFailureState.failureCount} time(s), so Ma
           systemPromptTokens: sessionMeta.systemPromptTokens,
           providerID: modelForBudget?.providerID,
           modelID: modelForBudget?.modelID,
-          agentName: notificationParams.agent
+          agentName: notificationParams.agent,
+          sessionId
         });
       } catch (error) {
         sessionLog2(sessionId, `transform: wire-estimate pressure fallback unavailable: ${getErrorMessage(error)}`);
@@ -25429,6 +25468,7 @@ Historian previously failed ${historianFailureState.failureCount} time(s), so Ma
           providerID: modelForBudget?.providerID,
           modelID: modelForBudget?.modelID,
           agentName: notificationParams.agent,
+          sessionId,
           systemPromptHash: sessionMeta.systemPromptHash
         }, boundaryContextLimit);
       } catch {
@@ -25443,13 +25483,15 @@ Historian previously failed ${historianFailureState.failureCount} time(s), so Ma
         providerID: modelForBudget?.providerID,
         modelID: modelForBudget?.modelID,
         agentName: notificationParams.agent,
+        sessionId,
         systemPromptHash: sessionMeta.systemPromptHash
       }, boundaryContextLimit) : undefined);
       if (finalWireEstimate) {
         sessionLog2(sessionId, `transform: final-wire telemetry estimate=${finalWireEstimate.tokens} trusted=${finalWireEstimate.trusted} conversation=${finalWireEstimate.messageTokens.conversation} tools=${finalWireEstimate.messageTokens.toolCall} system=${finalWireEstimate.systemTokens} toolDefinitions=${finalWireEstimate.toolDefinitionTokens ?? "unknown"} tail=${finalWireTail}`);
       }
       if ((finalWireEstimate?.refusalGrade || finalWireEstimate?.refusalBasis === "byte-bound" && finalWireEstimate.refusalTokens !== undefined) && boundaryContextLimit > 0 && (finalWireEstimate.refusalTokens ?? finalWireEstimate.tokens) > boundaryContextLimit) {
-        if (!thinkingFitRetries.has(sessionId) && activeThinkingPrefixHold && originalForThinkingFit && hasActiveAnthropicThinkingTurn(messages, resolvedProviderID, modelForBudget?.modelID)) {
+        const signedFitRetryWanted = !thinkingFitRetries.has(sessionId) && activeThinkingPrefixHold && hasActiveAnthropicThinkingTurn(messages, resolvedProviderID, modelForBudget?.modelID);
+        if (signedFitRetryWanted && originalForThinkingFit) {
           thinkingFitRetries.add(sessionId);
           requestPendingMaterialization(deps.pendingMaterializationSessions, sessionId, "fit_retry");
           messages.splice(0, messages.length, ...originalForThinkingFit);
@@ -25460,7 +25502,10 @@ Historian previously failed ${historianFailureState.failureCount} time(s), so Ma
           }
           return;
         }
-        if (thinkingFitRetries.has(sessionId) || postTransformResult.thinkingReleasedForFit || signedFitPreviouslyRefused) {
+        if (signedFitRetryWanted) {
+          sessionLog2(sessionId, "signed thinking fit: the held request is over the window and no copy of the pass input exists to retry from; refusing it");
+        }
+        if (signedFitRetryWanted || thinkingFitRetries.has(sessionId) || postTransformResult.thinkingReleasedForFit || signedFitPreviouslyRefused) {
           if (!signedFitPreviouslyRefused && !addMergedReasoningStrippedIds(db, sessionId, [SIGNED_FIT_REFUSED_MARKER]))
             throw contextRefusalError("Cannot persist the signed-fit refusal");
           throw contextRefusalError("The request remains over the model window after stripping signed thinking and reclaiming context");
@@ -25472,7 +25517,8 @@ Historian previously failed ${historianFailureState.failureCount} time(s), so Ma
           systemPromptTokens: sessionMeta.systemPromptTokens,
           providerID: modelForBudget?.providerID,
           modelID: modelForBudget?.modelID,
-          agentName: notificationParams.agent
+          agentName: notificationParams.agent,
+          sessionId
         });
         if (untrimmed.tokens > boundaryContextLimit) {
           sessionLog2(sessionId, `history boundary unresolved: prefix trim refused and the untrimmed request estimate ${untrimmed.tokens} (trusted=${untrimmed.trusted}) exceeds the context limit ${boundaryContextLimit}; not sending it`);
@@ -25485,7 +25531,8 @@ Historian previously failed ${historianFailureState.failureCount} time(s), so Ma
           systemPromptTokens: sessionMeta.systemPromptTokens,
           providerID: modelForBudget?.providerID,
           modelID: modelForBudget?.modelID,
-          agentName: notificationParams.agent
+          agentName: notificationParams.agent,
+          sessionId
         });
         const servedTokens = served.toolDefinitionsMeasured ? served.rawTokens ?? served.tokens : Math.max(0, sessionMeta.systemPromptTokens) + served.messageTokens.conversation + served.messageTokens.toolCall;
         if (!Number.isFinite(servedTokens) || servedTokens > unmanagedOverWindowPass.limit) {
@@ -25563,7 +25610,8 @@ Historian previously failed ${historianFailureState.failureCount} time(s), so Ma
             systemPromptTokens: sessionMeta.systemPromptTokens,
             providerID: modelForBudget?.providerID,
             modelID: modelForBudget?.modelID,
-            agentName: notificationParams.agent
+            agentName: notificationParams.agent,
+            sessionId
           });
         } catch (error) {
           sessionLog2(sessionId, "degraded pass size guard could not estimate:", error);
@@ -25779,6 +25827,7 @@ Historian previously failed ${historianFailureState.failureCount} time(s), so Ma
         providerID: modelForBudget?.providerID,
         modelID: modelForBudget?.modelID,
         agentName: notificationParams.agent,
+        sessionId,
         systemPromptHash: sessionMeta.systemPromptHash
       });
   };
@@ -27619,10 +27668,10 @@ function updateMemoryContentInCurrentTransaction(db, memory, content, normalized
   invalidateMemory2(memory.projectPath, memory.id);
 }
 var ctxMemoryArgsShape = {
-  action: tool2.schema.enum([...CTX_MEMORY_ACTIONS]).optional().describe("write | update | archive | merge | get"),
-  content: tool2.schema.string().optional().describe("The memory text — one standalone fact (write, update, merge)."),
-  category: tool2.schema.enum([...V2_MEMORY_CATEGORIES]).optional().describe("Kind of fact (required for write; on update/merge optional, omitted keeps the current category)."),
-  ids: tool2.schema.array(tool2.schema.number()).optional().describe("Memory ids from <project-memory>: one for update, one or more for archive, two or more for merge, 1–20 for get."),
+  action: tool2.schema.enum([...CTX_MEMORY_ACTIONS]).describe("write | update | archive | merge | get"),
+  content: tool2.schema.string().describe("The memory text — one standalone fact (write, update, merge)."),
+  category: tool2.schema.enum([...V2_MEMORY_CATEGORIES]).describe("Kind of fact (required for write; on update/merge, pass the memory's current category to keep it)."),
+  ids: tool2.schema.array(tool2.schema.number()).describe("Memory ids from <project-memory>: one for update, one or more for archive, two or more for merge, 1–20 for get."),
   reason: tool2.schema.string().optional().describe("Why it is being archived (optional).")
 };
 var ctxMemoryListArgsShape = {
@@ -28603,13 +28652,13 @@ function writeTray(db, sessionId) {
   return { activeCount: active.length, oldestTouchedAt: oldest };
 }
 var ctxNoteArgsShape = {
-  action: tool3.schema.enum(["write", "read", "dismiss", "update"]).optional().describe("write | read | update | dismiss. Defaults to write when content is given, else read."),
-  content: tool3.schema.string().optional().describe("Note text for write/update: first line is the title (under 80 chars), then the detail."),
+  action: tool3.schema.enum(["write", "read", "dismiss", "update"]).describe("write | read | update | dismiss."),
+  content: tool3.schema.string().describe("Note text for write/update: first line is the title (under 80 chars), then the detail."),
   surface_condition: tool3.schema.string().optional().describe("Makes this a smart note: a condition an outside checker can verify on its own, periodically — repository state, releases, web pages, anything it can look up — never something only this conversation knows. The note is parked until the condition holds."),
   filter: tool3.schema.enum(["all", "active", "pending", "ready", "dismissed"]).optional().describe("Read filter: all, active, pending (unsurfaced smart notes), ready, dismissed. Omitted, it shows active session notes plus every current smart note (pending included); active shows only notes whose stored status is active."),
   limit: tool3.schema.number().optional().describe("Rows per read (default 25)."),
   offset: tool3.schema.number().optional().describe("Skip this many newest rows (default 0)."),
-  note_ids: tool3.schema.array(tool3.schema.number().int().min(1)).min(1).max(50).optional().describe("Note ids: one for update, 1–50 for dismiss or read (read returns full bodies). Ignored by write.")
+  note_ids: tool3.schema.array(tool3.schema.number().int().min(1)).max(50).describe("Note ids: one for update, 1–50 for dismiss, or 1–50 to read those notes in full. Write and a plain read take an empty list.")
 };
 var ctxNoteArgsSchema = tool3.schema.object(ctxNoteArgsShape).passthrough();
 function formatDismissResults(results) {
@@ -28657,7 +28706,8 @@ function createCtxNoteTool(deps) {
       }
       const sessionId = toolContext.sessionID;
       const action = args.action ?? (args.content?.trim() ? "write" : "read");
-      const noteIds = action === "dismiss" || action === "update" || action === "read" && args.note_ids !== undefined ? parseNoteIds(action, args.note_ids) : undefined;
+      const targetedReadIds = action === "read" && Array.isArray(args.note_ids) && args.note_ids.length === 0 ? undefined : args.note_ids;
+      const noteIds = action === "dismiss" || action === "update" || action === "read" && targetedReadIds !== undefined ? parseNoteIds(action, targetedReadIds) : undefined;
       if (typeof noteIds === "string")
         return noteIds;
       const wakePlaneActive = action === "write" && Boolean(args.surface_condition?.trim()) && await wakePlaneStatus() === "present";
@@ -29214,18 +29264,18 @@ var FULL_PARAMETER_DESCRIPTIONS = {
     message: "Message ordinal from a <session-history> heading or a ctx_search hit, not a tag number. Returns that one message in full. Use alone."
   },
   ctx_note: {
-    action: "write | read | update | dismiss. Defaults to write when content is given, else read.",
+    action: "write | read | update | dismiss.",
     content: "Note text for write/update: first line is the title (under 80 chars), then the detail.",
     surface_condition: "Makes this a smart note: a condition an outside checker can verify on its own, periodically — repository state, releases, web pages, anything it can look up — never something only this conversation knows. The note is parked until the condition holds.",
     filter: "Read filter: all, active, pending (unsurfaced smart notes), ready, dismissed. Omitted, it shows active session notes plus every current smart note (pending included); active shows only notes whose stored status is active.",
     limit: "Rows per read (default 25).",
     offset: "Skip this many newest rows (default 0).",
-    note_ids: "Note ids: one for update, 1–50 for dismiss or read (read returns full bodies). Ignored by write."
+    note_ids: "Note ids: one for update, 1–50 for dismiss, or 1–50 to read those notes in full. Write and a plain read take an empty list."
   },
   ctx_memory: {
     action: "write | update | archive | merge | get",
     content: "The memory text — one standalone fact (write, update, merge).",
-    category: "Kind of fact (required for write; on update/merge optional, omitted keeps the current category).",
+    category: "Kind of fact (required for write; on update/merge, pass the memory's current category to keep it).",
     ids: "Memory ids from <project-memory>: one for update, one or more for archive, two or more for merge, 1–20 for get.",
     reason: "Why it is being archived (optional)."
   },
@@ -29249,18 +29299,18 @@ var LIGHT_PARAMETER_DESCRIPTIONS = {
     message: "Message ordinal from a <session-history> heading or a ctx_search hit, not a tag number. Returns that one message in full. Use alone."
   },
   ctx_note: {
-    action: "write | read | update | dismiss (default: write with content, else read).",
+    action: "write | read | update | dismiss.",
     content: "Note text: first line title (<80 chars), then detail.",
     surface_condition: "A condition an outside checker can verify on its own, periodically (repository, releases, web — anything it can look up); never something only this conversation knows.",
     filter: "Read filter: all, active, pending, ready, dismissed. Omitted: active notes plus every current smart note (pending included); active: only active-status notes.",
     limit: "Rows per read (default 25).",
     offset: "Skip newest rows (default 0).",
-    note_ids: "One id for update, 1–50 for dismiss or read (full bodies). Ignored by write."
+    note_ids: "One id for update, 1–50 for dismiss, or 1–50 to read those notes in full. Write and a plain read take an empty list."
   },
   ctx_memory: {
     action: "write | update | archive | merge | get",
     content: "One standalone fact (write, update, merge).",
-    category: "Kind of fact (required for write; optional on update/merge).",
+    category: "Kind of fact (required for write; on update/merge pass the current category to keep it).",
     ids: "Ids from <project-memory>: one for update, 1+ for archive, 2+ for merge, 1–20 for get.",
     reason: "Why it is archived (optional)."
   },