@cortexkit/opencode-magic-context 0.41.4 → 0.42.1

package/dist/shared/user-facing-codes.d.ts

@@ -0,0 +1,191 @@
+import type { EmbeddingFailureClass } from "../features/magic-context/memory/embedding-failure";
+import type { PromptFailureClass } from "./model-suggestion-retry";
+export declare const USER_FACING_FAILURES: {
+    readonly historian_unavailable: {
+        readonly code: "MC-H01";
+        readonly sentence: "History compression could not finish this turn.";
+        readonly action: "It will retry automatically.";
+    };
+    readonly recomp_unavailable: {
+        readonly code: "MC-R01";
+        readonly sentence: "History compression could not be rebuilt.";
+        readonly action: "Run /ctx-recomp again.";
+    };
+    readonly dream_provider_timeout: {
+        readonly code: "MC-D01";
+        readonly sentence: "Memory maintenance took too long to respond.";
+        readonly action: "Run /ctx-dream again.";
+    };
+    readonly dream_provider_error: {
+        readonly code: "MC-D02";
+        readonly sentence: "Memory maintenance could not reach its model.";
+        readonly action: "Check the model connection, then run /ctx-dream again.";
+    };
+    readonly dream_empty_completion: {
+        readonly code: "MC-D03";
+        readonly sentence: "Memory maintenance received no usable response.";
+        readonly action: "Run /ctx-dream again.";
+    };
+    readonly dream_no_models: {
+        readonly code: "MC-D04";
+        readonly sentence: "Memory maintenance has no model available.";
+        readonly action: "Check the model settings, then run /ctx-dream again.";
+    };
+    readonly dream_child_aborted: {
+        readonly code: "MC-D05";
+        readonly sentence: "Memory maintenance was interrupted.";
+        readonly action: "Run /ctx-dream again.";
+    };
+    readonly dream_parse_failed: {
+        readonly code: "MC-D06";
+        readonly sentence: "Memory maintenance could not use the model response.";
+        readonly action: "Run /ctx-dream again.";
+    };
+    readonly dream_unknown: {
+        readonly code: "MC-D07";
+        readonly sentence: "Memory maintenance could not finish.";
+        readonly action: "Run /ctx-dream again.";
+    };
+    readonly embedding_substitution_rejected: {
+        readonly code: "MC-E01";
+        readonly sentence: "Search indexing could not use the selected model.";
+        readonly action: "Check the embedding model setting, then run /ctx-embed start again.";
+    };
+    readonly embedding_http_error: {
+        readonly code: "MC-E02";
+        readonly sentence: "The search indexing provider refused the request.";
+        readonly action: "Check the provider connection and credentials, then run /ctx-embed start again.";
+    };
+    readonly embedding_transport_error: {
+        readonly code: "MC-E03";
+        readonly sentence: "Search indexing could not reach its provider.";
+        readonly action: "Check the connection, then run /ctx-embed start again.";
+    };
+    readonly embedding_invalid_envelope: {
+        readonly code: "MC-E04";
+        readonly sentence: "Search indexing received an unsupported response.";
+        readonly action: "Check the embedding endpoint, then run /ctx-embed start again.";
+    };
+    readonly embedding_empty_result: {
+        readonly code: "MC-E05";
+        readonly sentence: "Search indexing received no usable result.";
+        readonly action: "Run /ctx-embed start again.";
+    };
+    readonly embedding_certification_refusal: {
+        readonly code: "MC-E06";
+        readonly sentence: "Search indexing is not ready for this provider.";
+        readonly action: "Finish the provider setup, or set a fallback provider in the embedding settings, then run /ctx-embed start again.";
+    };
+    readonly embedding_credential_required: {
+        readonly code: "MC-E07";
+        readonly sentence: "Search indexing needs provider credentials.";
+        readonly action: "Sign in to the provider, then run /ctx-embed start again.";
+    };
+    readonly embedding_local_binding_missing: {
+        readonly code: "MC-E08";
+        readonly sentence: "Local search indexing is unavailable on this system.";
+        readonly action: "Run `npx @cortexkit/magic-context doctor`, then retry.";
+    };
+    readonly embedding_local_fs_unavailable: {
+        readonly code: "MC-E09";
+        readonly sentence: "Local search indexing cannot save its model files.";
+        readonly action: "Update or reinstall Magic Context, then retry.";
+    };
+    readonly embedding_local_download_failure: {
+        readonly code: "MC-E10";
+        readonly sentence: "Local search indexing could not download its model.";
+        readonly action: "Check the network connection, then retry.";
+    };
+    readonly embedding_local_runtime_error: {
+        readonly code: "MC-E11";
+        readonly sentence: "Local search indexing could not start.";
+        readonly action: "Run `npx @cortexkit/magic-context doctor`, then retry.";
+    };
+    readonly embedding_unavailable: {
+        readonly code: "MC-E12";
+        readonly sentence: "Search indexing could not finish.";
+        readonly action: "Run /ctx-embed start again.";
+    };
+    readonly status_unavailable: {
+        readonly code: "MC-S01";
+        readonly sentence: "Magic Context status is temporarily unavailable.";
+        readonly action: "Retry /ctx-status in a moment.";
+    };
+    readonly transform_update_failed: {
+        readonly code: "MC-S02";
+        readonly sentence: "The last context update did not finish.";
+        readonly action: "Send another message to retry.";
+    };
+    readonly configuration_warning: {
+        readonly code: "MC-S03";
+        readonly sentence: "Some configuration settings could not be applied.";
+        readonly action: "Fix the configuration warning shown in /ctx-status diagnostics, then restart.";
+    };
+    readonly status_log_unavailable: {
+        readonly code: "MC-S04";
+        readonly sentence: "Some diagnostic details could not be saved.";
+        readonly action: "Retry /ctx-status in a moment.";
+    };
+    readonly memory_writes_paused: {
+        readonly code: "MC-C01";
+        readonly sentence: "Memory writes are paused while the engine syncs.";
+        readonly action: "Retry in a moment.";
+    };
+    readonly memory_access_unavailable: {
+        readonly code: "MC-C02";
+        readonly sentence: "Memory access is temporarily unavailable.";
+        readonly action: "Retry in a moment.";
+    };
+    readonly note_changes_paused: {
+        readonly code: "MC-C03";
+        readonly sentence: "Note changes are paused while the engine syncs.";
+        readonly action: "Retry in a moment.";
+    };
+    readonly note_access_unavailable: {
+        readonly code: "MC-C04";
+        readonly sentence: "Notes are temporarily unavailable.";
+        readonly action: "Retry in a moment.";
+    };
+    readonly context_cleanup_paused: {
+        readonly code: "MC-C05";
+        readonly sentence: "Context cleanup is paused while the engine syncs.";
+        readonly action: "Retry in a moment.";
+    };
+    readonly partial_history_unavailable: {
+        readonly code: "MC-C06";
+        readonly sentence: "Partial history compression is not available in the current mode.";
+        readonly action: "Run /ctx-recomp without a range.";
+    };
+    readonly session_upgrade_unavailable: {
+        readonly code: "MC-C07";
+        readonly sentence: "Session upgrade is not available in the current mode.";
+        readonly action: "Run /ctx-recomp instead.";
+    };
+    readonly smart_note_conditions_unavailable: {
+        readonly code: "MC-C08";
+        readonly sentence: "Conditional notes are not available in the current mode.";
+        readonly action: "Save a regular note without a condition.";
+    };
+    readonly history_compression_paused: {
+        readonly code: "MC-C09";
+        readonly sentence: "History compression is paused while the engine syncs.";
+        readonly action: "Retry in a moment.";
+    };
+    readonly context_service_unavailable: {
+        readonly code: "MC-C10";
+        readonly sentence: "Magic Context is temporarily unavailable.";
+        readonly action: "Retry in a moment.";
+    };
+};
+export type UserFacingFailureKey = keyof typeof USER_FACING_FAILURES;
+export type UserFacingTextStyle = "markdown" | "plain";
+export declare function renderUserFacingFailure(key: UserFacingFailureKey, style?: UserFacingTextStyle): string;
+export declare function userFacingFailureCode(key: UserFacingFailureKey): string;
+export type CapabilityRefusal = "memory_write" | "memory_access" | "note_change" | "note_access" | "context_cleanup" | "partial_history" | "session_upgrade" | "smart_note_condition" | "history_compression" | "context_service";
+export declare function renderCapabilityRefusal(capability: CapabilityRefusal): string;
+export declare function capabilityRefusalCode(capability: CapabilityRefusal): string;
+export declare function renderDreamFailure(failureClass: PromptFailureClass, style?: UserFacingTextStyle): string;
+export declare function dreamFailureCode(failureClass: PromptFailureClass): string;
+export declare function renderEmbeddingFailure(failureClass: EmbeddingFailureClass, style?: UserFacingTextStyle): string;
+export declare function embeddingFailureCode(failureClass: EmbeddingFailureClass): string;
+//# sourceMappingURL=user-facing-codes.d.ts.map

package/dist/shared/user-facing-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-facing-codes.d.ts","sourceRoot":"","sources":["../../src/shared/user-facing-codes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AAChG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgLvB,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,oBAAoB,CAAC;AAErE,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,OAAO,CAAC;AAEvD,wBAAgB,uBAAuB,CACnC,GAAG,EAAE,oBAAoB,EACzB,KAAK,GAAE,mBAAgC,GACxC,MAAM,CAIR;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,CAEvE;AAED,MAAM,MAAM,iBAAiB,GACvB,cAAc,GACd,eAAe,GACf,aAAa,GACb,aAAa,GACb,iBAAiB,GACjB,iBAAiB,GACjB,iBAAiB,GACjB,sBAAsB,GACtB,qBAAqB,GACrB,iBAAiB,CAAC;AAexB,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,iBAAiB,GAAG,MAAM,CAE7E;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,iBAAiB,GAAG,MAAM,CAE3E;AA0BD,wBAAgB,kBAAkB,CAC9B,YAAY,EAAE,kBAAkB,EAChC,KAAK,GAAE,mBAAgC,GACxC,MAAM,CAER;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,kBAAkB,GAAG,MAAM,CAEzE;AAED,wBAAgB,sBAAsB,CAClC,YAAY,EAAE,qBAAqB,EACnC,KAAK,GAAE,mBAAgC,GACxC,MAAM,CAER;AAED,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,qBAAqB,GAAG,MAAM,CAEhF"}

package/dist/shared/window-geometry.d.ts

@@ -3,6 +3,12 @@ export declare const WINDOW_OVERLAY_SCHEMA = "fusiform-window-overlay/v1";
 export declare const PROMPT_WALL_MARGIN = 4096;
 export declare const PI_OUTPUT_FLOOR = 4096;
 export declare const OPENCODE_OUTPUT_CAP = 32000;
+/**
+ * Smallest context window any served model can plausibly have. Reported or
+ * inferred limits below this are placeholders (0, 1) or corrupt state, never a
+ * real window, so every denominator check shares this one floor.
+ */
+export declare const MIN_PLAUSIBLE_CONTEXT_LIMIT = 1024;
 export type WindowGeometry = "shared_upfront" | "shared_truncating" | "separate";
 export type WindowReserveSource = "output_catalog" | "output_config" | "wall_margin" | "none";
 export type WindowOverlayGrade = "provider_asserted_runtime" | "measured" | "provider_asserted_doc" | "catalog" | "unknown";
@@ -45,11 +51,14 @@ export interface ResolvedWindowOverlayFacts {
     /** Includes facts whose tagged value is explicitly unknown. */
     facts: Record<string, WindowOverlayFact>;
 }
+export type WindowLimitSource = "catalog" | "overlay" | "provider" | "detected";
 export interface WindowDerivation {
     window: number;
     reserve: number;
     reserveSource: WindowReserveSource;
     geometry: WindowGeometry;
+    windowSource: WindowLimitSource;
+    absoluteWall: number;
 }
 export interface WindowGeometryResult {
     usableSoft: number;
@@ -87,6 +96,20 @@ export declare function resolveWindowOverlayFacts(providerID: string, modelID: s
 /** Placeholder filtering is deliberately per output field, never a row-level rejection. */
 export declare function placeholderFilteredOutput(output: number | undefined, context: number | undefined): number | undefined;
 export declare function deriveWindowGeometry(providerID: string, modelID: string, catalogLimit: ModelLimit | undefined, options?: DeriveWindowGeometryOptions): WindowGeometryResult | undefined;
+export interface ProvenInputFloorResult {
+    geometry: WindowGeometryResult;
+    refused?: {
+        reading: number;
+        absoluteWall: number;
+    };
+}
+export declare function hasTrustedAbsoluteWall(geometry: WindowGeometryResult): boolean;
+/**
+ * Successful requests can disprove static catalog metadata, but cannot
+ * disprove a provider, overlay, or observed-overflow wall. A reading beyond
+ * that wall is malformed usage accounting and must not enlarge the geometry.
+ */
+export declare function applyProvenInputFloor(geometry: WindowGeometryResult, provenInputTokens: number | undefined): ProvenInputFloorResult;
 export declare function formatWindowDerivationLine(inputTokens: number, result: WindowGeometryResult): string;
 export declare function formatCompactTokens(value: number): string;
 //# sourceMappingURL=window-geometry.d.ts.map

package/dist/shared/window-geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"window-geometry.d.ts","sourceRoot":"","sources":["../../src/shared/window-geometry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"window-geometry.d.ts","sourceRoot":"","sources":["../../src/shared/window-geometry.ts"],"names":[],"mappings":"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"}

package/dist/shared/write-transaction-timing.d.ts

@@ -7,5 +7,5 @@ export declare const SLOW_WRITE_TRANSACTION_THRESHOLD_MS = 1000;
  * Log a slow write only after its COMMIT has completed. The timing diagnostic is
  * deliberately best-effort so it can never change the transaction's behavior.
  */
-export declare function logSlowWriteTransaction(site: string, startedAt: number, thresholdMs?: number): void;
+export declare function logSlowWriteTransaction(site: string, startedAt: number, thresholdMs?: number, completedAtMs?: number): void;
 //# sourceMappingURL=write-transaction-timing.d.ts.map

package/dist/shared/write-transaction-timing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-transaction-timing.d.ts","sourceRoot":"","sources":["../../src/shared/write-transaction-timing.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,mCAAmC,OAAQ,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,uBAAuB,CACnC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,SAAsC,GAClD,IAAI,CAQN"}
+{"version":3,"file":"write-transaction-timing.d.ts","sourceRoot":"","sources":["../../src/shared/write-transaction-timing.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,mCAAmC,OAAQ,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,uBAAuB,CACnC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,SAAsC,EACjD,aAAa,SAAoB,GAClC,IAAI,CAQN"}

package/dist/{storage-meta-session-dvwfw778.js → storage-meta-session-e6g0mmec.js}

@@ -6,8 +6,8 @@ import {
   retryPendingSessionCleanups2,
   retryPendingRustSessionCleanupsForProject2,
   clearSession2
-} from "./index-fz104x1j.js";
-import"./index-raatkvw5.js";
+} from "./index-jmtjh2d3.js";
+import"./index-1974jvn3.js";
 import"./index-dkv2dn46.js";
 export {
   advanceToolReclaimWatermark2 as advanceToolReclaimWatermark,

package/dist/tools/ctx-memory/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-memory/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAuDhE,OAAO,EAKH,KAAK,iBAAiB,EACzB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAs/BrE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-memory/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAuDhE,OAAO,EAKH,KAAK,iBAAiB,EACzB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAwhCrE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}

package/dist/tools/ctx-memory/verification-recording.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verification-recording.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-memory/verification-recording.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAUvE"}
+{"version":3,"file":"verification-recording.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-memory/verification-recording.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAYvE"}

package/dist/tools/ctx-note/constants.d.ts

@@ -1,2 +1,2 @@
-export declare const CTX_NOTE_DESCRIPTION = "Working notes for this session's future \u2014 reminders, follow-ups, and things to revisit later.\n\nUse a note when something matters LATER but not in the next few steps: \"revisit the retry logic after the release\", \"user wants the dashboard polish batched\", \"flaky test to investigate when touching CI\". Don't use notes for active multi-step work (use todos) or for durable project knowledge that should outlive this session (use ctx_memory). Notes resurface automatically at natural work boundaries and whenever you read them.\n\nActions:\n- write: save a note (content). Add surface_condition to make it a smart note (below).\n- read: list notes, newest first. Default: latest active session notes + ready smart notes; page older ones with limit/offset, or inspect other states with filter.\n- update / dismiss: change or retire a note by note_id.\n\nSmart notes: pass surface_condition and the note stays hidden until a background checker confirms the condition \u2014 using ONLY externally verifiable signals (GitHub state via gh, files on disk, git history, web pages). It cannot see this conversation, so the condition must be checkable from outside:\n\u2713 \"When PR #42 in cortexkit/magic-context is merged\"\n\u2713 \"When the latest release tag is >= v0.22.0\"\n\u2713 \"When packages/plugin/src/foo.ts contains a function named bar\"\n\u2717 \"When the user mentions X\" / \"when we revisit Y\" / \"after we finish this refactor\" \u2014 no external signal; write a regular note instead.\n\nExample: ctx_note(action=\"write\", content=\"Re-run the perf benchmark once the boundary rework ships\", surface_condition=\"When the latest release tag is >= v0.23.0\")";
+export declare const CTX_NOTE_DESCRIPTION = "Working notes for this session \u2014 reminders, follow-ups, and things to revisit later.\n\nUse a note when something matters LATER but not in the next few steps: \"revisit the retry logic after the release\", \"user wants the dashboard polish batched\", \"flaky test to investigate when touching CI\". Don't use notes for active work (use todos) or durable project knowledge (use ctx_memory). Notes resurface at work boundaries and when read.\n\nActions:\n- write: save a note (content). Add surface_condition to make it a smart note (below).\n- read: list notes, newest first. Default: latest active session notes + ready smart notes; page older ones with limit/offset, or inspect other states with filter.\n- update: change a note by note_id. dismiss: retire one by note_id or 1\u201350 by note_ids; provide exactly one.\n\nSmart notes: pass surface_condition and the note stays hidden until a background checker confirms the condition \u2014 using ONLY externally verifiable signals (GitHub state via gh, files on disk, git history, web pages). It cannot see this conversation, so the condition must be checkable from outside:\n\u2713 \"When PR #42 in cortexkit/magic-context is merged\"\n\u2713 \"When the latest release tag is >= v0.22.0\"\n\u2713 \"When packages/plugin/src/foo.ts contains a function named bar\"\n\u2717 \"When the user mentions X\" / \"when we revisit Y\" / \"after we finish this refactor\" \u2014 no external signal; write a regular note instead.\n\nExample: ctx_note(action=\"write\", content=\"Re-run the perf benchmark once the boundary rework ships\", surface_condition=\"When the latest release tag is >= v0.23.0\")";
 //# sourceMappingURL=constants.d.ts.map

package/dist/tools/ctx-note/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-note/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,upDAeoI,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-note/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,qnDAeoI,CAAC"}

package/dist/tools/ctx-note/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-note/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAqBhE,OAAO,KAAK,EAAuB,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAK7F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAKpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC/D,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAwdD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAIxF"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-note/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAsBhE,OAAO,KAAK,EAAuB,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAM7F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAMpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC/D,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAwgBD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAIxF"}

package/dist/tools/ctx-note/types.d.ts

@@ -10,5 +10,6 @@ export interface CtxNoteArgs extends ImitatedReducedArgs {
     /** Skip this many newest notes for read — pages older ones (default 0). */
     offset?: number;
     note_id?: number;
+    note_ids?: number[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/tools/ctx-note/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-note/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;AAErF,MAAM,WAAW,WAAY,SAAQ,mBAAmB;IACpD,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-note/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;AAErF,MAAM,WAAW,WAAY,SAAQ,mBAAmB;IACpD,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB"}

package/dist/tools/ctx-reduce/tools.d.ts

@@ -1,10 +1,19 @@
 import { type ToolDefinition } from "@opencode-ai/plugin";
+import { type ProtectionWindowResult } from "../../features/magic-context/protection-window";
 import type { RustToolBackends } from "../../plugin/rust-tool-backends";
 import type { Database } from "../../shared/sqlite";
 export { CTX_REDUCE_LIGHT_DESCRIPTION } from "../light-descriptions";
 export interface CtxReduceToolDeps {
     db: Database;
-    protectedTags: number;
+    /**
+     * Union projection form: protectedSet (tag-number set form).
+     * Coordinate space: tag-number space.
+     * Empty-window behavior: empty set means zero tool tags are protected by the window;
+     * requested drops apply immediately, and non-tool tags are never reclaim targets.
+     */
+    protectedSet?: ReadonlySet<number> | ((sessionId: string) => ReadonlySet<number>);
+    getProtectionWindow?: (sessionId: string) => ProtectionWindowResult;
+    floor?: number;
     getSessionTokens?: (sessionId: string) => number;
     rustToolBackends?: RustToolBackends;
 }

package/dist/tools/ctx-reduce/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-reduce/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAUhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAKpD,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,QAAQ,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAsND,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-reduce/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAEH,KAAK,sBAAsB,EAC9B,MAAM,gDAAgD,CAAC;AAUxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAGxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAMpD,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,QAAQ,CAAC;IACb;;;;;OAKG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAClF,mBAAmB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,sBAAsB,CAAC;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAiPD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}

package/dist/tools/ctx-search/constants.d.ts

@@ -1,4 +1,4 @@
 export declare const CTX_SEARCH_TOOL_NAME = "ctx_search";
-export declare const CTX_SEARCH_DESCRIPTION = "Your long-term recall for this project \u2014 search everything that ever happened here, not just what's currently visible.\n\nReach for it when something feels familiar but isn't in view: \"did we solve this before?\", \"what did we decide about X?\", \"when did this break?\", \"where does Y live?\". Results only contain things you CANNOT currently see \u2014 memories already shown in <project-memory> and the live conversation tail are filtered out. A query that is just one or more memory ids (e.g. `#7234` or `12, 34`) bypasses text search and resolves those ids directly.\n\nSources (omit for a broad search across all):\n- memory: curated cross-session project knowledge \u2014 rules, constraints, conventions.\n- message: the raw conversation behind your compacted history. Hits include message ordinals \u2014 expand the surrounding exchange with ctx_expand(start=N-10, end=N+5).\n- git_commit: this repository's commit history.\n- note: parked decisions, follow-ups, and dismissed notes with their recorded text.\n\nPicking sources:\n- \"when did this change / was this working before\" \u2192 [\"git_commit\", \"message\"]\n- \"did we discuss this earlier\" \u2192 [\"message\"]\n- \"did we decide something about this / leave a follow-up\" \u2192 [\"note\"]\n- \"what's our convention / rule for X\" \u2192 [\"memory\"]";
+export declare const CTX_SEARCH_DESCRIPTION = "Your long-term recall for this project \u2014 search everything that ever happened here, not just what's currently visible.\n\nRetrieval matches meaning as well as exact words and fuses them, so phrasing matters: phrase `query` as a natural-language question that still contains the exact terms you expect in the answer (paths, symbols, config keys, error strings); a bare keyword stack finds less than a question carrying the same words.\n- Good: \"where is the retry backoff for the upload client configured?\"\n- Bad: \"upload client retry backoff config\"\n\nReach for it when something feels familiar but isn't in view: \"did we solve this before?\", \"what did we decide about X?\", \"when did this break?\", \"where does Y live?\". Results only contain things you CANNOT currently see \u2014 memories already shown in <project-memory> and the live conversation tail are filtered out. A query that is just one or more memory ids (e.g. `#7234` or `12, 34`) bypasses text search and resolves those ids directly.\n\nSources (omit for a broad search across all):\n- memory: curated cross-session project knowledge \u2014 rules, constraints, conventions.\n- message: the raw conversation behind your compacted history. Hits include message ordinals \u2014 expand the surrounding exchange with ctx_expand(start=N-10, end=N+5).\n- git_commit: this repository's commit history.\n- note: parked decisions and follow-ups with their recorded text.\n\nPicking sources:\n- \"when did this change / was this working before\" \u2192 [\"git_commit\", \"message\"]\n- \"did we discuss this earlier\" \u2192 [\"message\"]\n- \"did we decide something about this / leave a follow-up\" \u2192 [\"note\"]\n- \"what's our convention / rule for X\" \u2192 [\"memory\"]";
 export declare const DEFAULT_CTX_SEARCH_LIMIT = 10;
 //# sourceMappingURL=constants.d.ts.map

package/dist/tools/ctx-search/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-search/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,eAAO,MAAM,sBAAsB,0zCAciB,CAAC;AACrD,eAAO,MAAM,wBAAwB,KAAK,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-search/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,eAAO,MAAM,sBAAsB,4tDAkBiB,CAAC;AACrD,eAAO,MAAM,wBAAwB,KAAK,CAAC"}

package/dist/tools/light-descriptions.d.ts

@@ -1,6 +1,6 @@
 export declare const CTX_REDUCE_LIGHT_DESCRIPTION = "For ctx_reduce users, mark spent \u00A7N\u00A7 outputs discardable; release is QUEUED, not immediate, so content stays visible until space is needed. Newest tags stay protected until they age out. Released content becomes a placeholder; recover it only by rerunning the source or recovery tool, so mark only genuinely finished material. Mark analyzed, redundant, persisted, or merely confirmatory outputs; keep user messages, unresolved errors, unextracted evidence, and exact wording. NEVER blanket-mark a large range: review every tag first.";
 export declare const CTX_EXPAND_LIGHT_DESCRIPTION = "For ctx_expand users, recover compacted conversation by passing a session-history heading's inclusive start/end ordinals. Results are raw [N] U:/A: transcript capped near 15K tokens; oversized ranges return the head and a continuation. Use verbose=true to list each message ordinal, part previews, and tool-output sizes; use message=N for one complete stored message and its tool exchanges. NEVER expand ranges after the last compartment because that live tail is already visible.";
-export declare const CTX_NOTE_LIGHT_DESCRIPTION = "For ctx_note users, write saves, read lists, update changes, and dismiss retires future session notes; surface_condition creates a smart note. For smart notes, NEVER use a condition tied to this conversation or an unobservable future action because the background checker can inspect only external GitHub, disk, git, or web signals.";
+export declare const CTX_NOTE_LIGHT_DESCRIPTION = "For ctx_note: write saves, read lists, update changes, dismiss retires one note_id or 1\u201350 note_ids (choose one); surface_condition makes a smart note. Smart-note conditions must be externally verifiable via GitHub, disk, git, or web\u2014not this conversation or future actions.";
 export declare const CTX_MEMORY_LIGHT_DESCRIPTION = "For ctx_memory users, write one standalone durable fact with category and content; update one ID, archive one or more IDs, merge two or more IDs, or get one to twenty numeric IDs. get reads memories in every status; list remains dreamer-only, so primary agents must NEVER assume bulk-list access.";
-export declare const CTX_SEARCH_LIGHT_DESCRIPTION = "For ctx_search users, retrieve only hidden recall: memories not already in <project-memory>, compacted messages outside the live tail, commits, and notes. Omit sources for broad search; select memory, message, git_commit, or note to target a source, or pass memory IDs to bypass text search. Message hits continue through ctx_expand.";
+export declare const CTX_SEARCH_LIGHT_DESCRIPTION = "For ctx_search users, retrieve only hidden recall: memories not in <project-memory>, compacted messages outside the live tail, commits, and notes; phrase query as a question carrying exact terms. Omit sources for broad search; select memory, message, git_commit, or note, or pass memory IDs directly. Hits expand through ctx_expand.";
 //# sourceMappingURL=light-descriptions.d.ts.map

package/dist/tools/light-descriptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"light-descriptions.d.ts","sourceRoot":"","sources":["../../src/tools/light-descriptions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,oiBAA0hB,CAAC;AAEpkB,eAAO,MAAM,4BAA4B,qeAAqe,CAAC;AAE/gB,eAAO,MAAM,0BAA0B,iVAAiV,CAAC;AAEzX,eAAO,MAAM,4BAA4B,6SAA6S,CAAC;AAEvV,eAAO,MAAM,4BAA4B,kVAAkV,CAAC"}
+{"version":3,"file":"light-descriptions.d.ts","sourceRoot":"","sources":["../../src/tools/light-descriptions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,oiBAA0hB,CAAC;AAEpkB,eAAO,MAAM,4BAA4B,qeAAqe,CAAC;AAE/gB,eAAO,MAAM,0BAA0B,iSAAuR,CAAC;AAE/T,eAAO,MAAM,4BAA4B,6SAA6S,CAAC;AAEvV,eAAO,MAAM,4BAA4B,iVAAiV,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/opencode-magic-context",
-  "version": "0.41.4",
+  "version": "0.42.1",
   "type": "module",
   "description": "OpenCode plugin for Magic Context — cross-session memory and context management",
   "main": "dist/index.js",
@@ -29,7 +29,6 @@
     "src/shared",
     "src/config",
     "src/agents",
-    "src/features/magic-context/defaults.ts",
     "src/features/magic-context/dreamer/cron.ts",
     "src/features/magic-context/dreamer/task-registry.ts",
     "README.md"
@@ -51,7 +50,7 @@
     "prepublishOnly": "bun run build && bun run build:tui"
   },
   "dependencies": {
-    "@cortexkit/subc-client": "0.4.1",
+    "@cortexkit/subc-client": "0.11.1",
     "@jitl/quickjs-singlefile-cjs-release-asyncify": "0.32.0",
     "@opencode-ai/plugin": "^1.17.11",
     "@opencode-ai/sdk": "^1.17.11",

package/src/agents/hidden-agent-registrations.ts

@@ -24,8 +24,8 @@ import { applyDisallowedTools, buildAllowOnlyPermission } from "./permissions";
 
 // Clamp a user-provided step override to the hidden-agent's built-in cap (loop
 // insurance — see buildHiddenAgentConfig). Caps live as inline literals in
-// buildHiddenAgentRegistrations (historian/sidekick=40, dreamer=150): a handful
-// of tool calls for the historian/sidekick, a real multi-step maintenance loop
+// buildHiddenAgentRegistrations (historian=40, dreamer=150): a handful
+// of tool calls for the historian, a real multi-step maintenance loop
 // for the dreamer.
 function clampHiddenAgentStepLimit(value: unknown, cap: number): number {
     return typeof value === "number" && Number.isFinite(value) ? Math.min(value, cap) : cap;
@@ -75,7 +75,7 @@ export interface HiddenAgentRegistration {
 }
 
 /**
- * Hoisted function declaration: returns the four hidden-agent registrations with
+ * Hoisted function declaration: returns the hidden-agent registrations with
  * INLINE id / allow-list / step-cap literals (see {@link HiddenAgentRegistration}
  * for why these must not come from module-level `var` consts). Prompts and
  * computed overrides are passed in by the caller; the historian disallow filter
@@ -87,10 +87,8 @@ export function buildHiddenAgentRegistrations(args: {
     historianPrompt: string | undefined;
     historianRecompPrompt?: string | undefined;
     historianEditorPrompt: string | undefined;
-    sidekickPrompt: string | undefined;
     dreamerOverrides?: Record<string, unknown>;
     historianOverrides?: Record<string, unknown>;
-    sidekickOverrides?: Record<string, unknown>;
     historianDisallowed: readonly string[];
 }): HiddenAgentRegistration[] {
     const historianAllowedTools = applyDisallowedTools(
@@ -287,16 +285,6 @@ export function buildHiddenAgentRegistrations(args: {
             maxSteps: 40,
             overrides: args.historianOverrides,
         },
-        {
-            id: "sidekick",
-            mode: "primary",
-            hidden: true,
-            description: HIDDEN_AGENT_DESCRIPTION,
-            prompt: args.sidekickPrompt,
-            allowedTools: ["ctx_search", "aft_outline", "aft_zoom"],
-            maxSteps: 40,
-            overrides: args.sidekickOverrides,
-        },
     ];
 }
 

package/src/agents/magic-context-prompt.test.ts

@@ -81,7 +81,7 @@ describe("buildMagicContextSection — subagent mode", () => {
         expect(out).toContain("## Magic Context");
         expect(out).toContain("§N§ identifiers");
         expect(out).toContain("ctx_reduce");
-        expect(out).toContain("The last 20 tags are protected");
+        expect(out).toContain("newest token-mass window");
     });
 
     it("OMITS the long-term-partner frame and primary-only guidance", () => {
@@ -95,9 +95,11 @@ describe("buildMagicContextSection — subagent mode", () => {
         expect(out).not.toContain("ctx_expand");
     });
 
-    it("threads protectedTags into the protected-count line", () => {
-        const out = buildMagicContextSection(null, 7, true, false, false, false, true);
-        expect(out).toContain("The last 7 tags are protected");
+    it("describes token-mass protection independently of a legacy count", () => {
+        const withSeven = buildMagicContextSection(null, 7, true, false, false, false, true);
+        const withTwenty = buildMagicContextSection(null, 20, true, false, false, false, true);
+        expect(withSeven).toBe(withTwenty);
+        expect(withSeven).toContain("newest token-mass window");
     });
 
     it("is much shorter than the full primary block", () => {
@@ -174,7 +176,7 @@ describe("buildMagicContextSection — caveman compression warning", () => {
     it("emits the warning when caveman is enabled and ctx_reduce is unavailable", () => {
         const out = buildMagicContextSection(
             null, // agent
-            20, // protectedTags (ignored in no-reduce path)
+            20, // legacy positional value (ignored in no-reduce path)
             false, // ctx_reduce is unavailable in this session.
             false, // dreamerEnabled
             false, // temporalAwarenessEnabled