@cortexkit/opencode-magic-context 0.42.5 → 0.43.0

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

@@ -0,0 +1,88 @@
+/**
+ * Rendering for the ctx_note read glance, the bodies-by-id view, the write
+ * footer, and the one-line note nudge.
+ *
+ * The OpenCode plugin, the Pi plugin, and the Rust module facade must emit the
+ * same bytes for the same rows, so every format decision lives here and is
+ * mirrored in `crates/mc-module/src/lib.rs`. Change one, change the other.
+ */
+/** Title clip for a glance row. */
+export declare const GLANCE_TITLE_MAX = 80;
+/** Title clip for the single line the note nudge shows. */
+export declare const NUDGE_TITLE_MAX = 60;
+/** A note untouched for this long is marked stale in the glance. */
+export declare const STALE_AFTER_MS: number;
+/** The reply for a read that has nothing to show. */
+export declare const EMPTY_READ_REPLY = "## Notes\n\nNo session notes or smart notes.";
+export interface GlanceNote {
+    id: number;
+    type: string;
+    status: string;
+    content: string;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface NoteBodySource extends GlanceNote {
+    anchorOrdinal: number | null;
+    surfaceCondition?: string | null;
+    readyReason?: string | null;
+}
+/** The timestamp a note's age is measured from: its last update, or its
+ *  creation when it has never been updated. */
+export declare function noteTouchedAt(note: Pick<GlanceNote, "createdAt" | "updatedAt">): number;
+/** Compact age: `5m`, `3h`, `2d`, `6w`. */
+export declare function formatNoteAge(touchedAt: number, nowMs: number): string;
+/** First line of the note content, clipped to `max` characters with `…`. */
+export declare function clipNoteTitle(content: string, max: number): string;
+/** One glance row: `#id · age · title`, plus `· <status>` for anything that is
+ *  not active and `· stale` when the note has not been touched for 30 days. */
+export declare function formatGlanceRow(note: GlanceNote, nowMs: number): string;
+/** Glance order: ready smart notes first, then pending smart notes, then every
+ *  other status — each group newest first. */
+export declare function orderGlanceNotes(notes: readonly GlanceNote[]): GlanceNote[];
+/** The whole glance: one row per note, then the one-line paging footer. */
+export declare function renderGlance(notes: readonly GlanceNote[], options: {
+    limit: number;
+    offset: number;
+    nowMs: number;
+}): string;
+/** Full body for one note in the bodies-by-id view: `#id`, age, status, the
+ *  content, and the `↳ @msg N` anchor when the note carries one. Smart notes
+ *  also carry the condition that parked them. */
+export declare function formatNoteBody(note: NoteBodySource, nowMs: number): string;
+/** Bodies-by-id view. Ids that are unknown or owned by someone else render the
+ *  same `not_found` line, so the reply never discloses whether an inaccessible
+ *  note exists. */
+export declare function renderNotesById(entries: ReadonlyArray<{
+    noteId: number;
+    note: NoteBodySource | null;
+}>, nowMs: number): string;
+/** The tray line appended to a write reply: how many active session notes the
+ *  writer now holds and how old the oldest one is. Empty when the tray is
+ *  empty, so a first write stays a single short line. */
+export declare function formatTraySuffix(tray: {
+    activeCount: number;
+    oldestTouchedAt: number | null;
+}, nowMs: number): string;
+/** The write reply: the saved-note line plus the tray line, so the writer sees
+ *  the backlog at the moment they add to it. */
+export declare function formatWriteReply(noteId: number, tray: {
+    activeCount: number;
+    oldestTouchedAt: number | null;
+}, nowMs: number): string;
+/**
+ * Stateless pick over a pool of `poolSize` notes: FNV-1a over the UTF-8 bytes
+ * of `${sessionId}#${counter}`. Successive nudges use successive counters, so
+ * they surface different notes, while a replayed delivery keeps the bytes it
+ * was stored with. Mirrored in Rust.
+ */
+export declare function noteNudgePickIndex(sessionId: string, counter: number, poolSize: number): number;
+/** The one-line note nudge: counts first, then one clipped title. */
+export declare function formatNoteNudge(args: {
+    readyCount: number;
+    activeCount: number;
+    oldestActiveTouchedAt: number | null;
+    shown: GlanceNote | null;
+    nowMs: number;
+}): string;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-note/render.ts"],"names":[],"mappings":"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"}

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;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;AAygBD,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;AA0BhE,OAAO,KAAK,EAAuB,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAM7F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAapD,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;AA0eD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAIxF"}

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

@@ -9,7 +9,7 @@ export interface CtxNoteArgs extends ImitatedReducedArgs {
     limit?: number;
     /** Skip this many newest notes for read — pages older ones (default 0). */
     offset?: number;
-    note_id?: number;
+    /** Exactly one id for update, one to fifty for dismiss; ignored by write and read. */
     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;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB"}
+{"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,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB"}

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

@@ -1,2 +1,2 @@
-export declare const CTX_REDUCE_DESCRIPTION = "Mark spent tagged content as discardable to reclaim context space. This is NOT an immediate delete. Use \u00A7N\u00A7 identifiers visible in the conversation. The `drop` param accepts ranges: \"3-5\", \"1,2,9\", \"1-5,8\".\n\nHow it works:\n- Marking QUEUES content for release. It stays fully visible to you until context space is actually needed \u2014 which may be as soon as the next turn if you are already under pressure, or many turns later if not. So mark spent outputs as soon as you finish with them; don't hoard the call for the end of the turn.\n- The newest tags are protected: marking one just queues it until it ages out of the recent window, so marking recent output is harmless.\n- When content is finally released it becomes a short placeholder, and re-running the tool is the only way to get it back. So mark only what you are genuinely DONE with \u2014 the test is \"have I extracted what I need from this?\", not \"is it safe / do I have time before it drops?\".\n\nMark discardable once processed: large outputs you've summarized, repeated or redundant dumps, data written to disk, status/log output that only confirmed an expected state.\nKeep: user messages, unresolved errors, raw evidence you haven't extracted yet, and outputs whose exact wording may matter later.\nNever blanket-mark large ranges (e.g. \"1-50\") \u2014 review what each tag holds first.";
+export declare const CTX_REDUCE_DESCRIPTION = "Stamp an item on your desk as no longer needed for the work ahead. Not a delete: stamping QUEUES it, the item stays fully readable until Magic Context clears stamped items in one sweep, and the newest tags are protected so stamping recent output is harmless. A cleared item goes to the archive \u2014 a recent one leaves a `[dropped \u00A7N\u00A7]` placeholder, an older one leaves nothing \u2014 and `ctx_expand(message=N)` is the way back. So the question before stamping is not \"have I finished reading this?\" but \"does this need to stay on my desk for what comes next?\" \u2014 a file you read and will keep editing stays; the grep that found it goes.\n\nStamp: file reads, search results and tool outputs the work ahead no longer needs; build/test output after you acted on it; repeated or redundant dumps; data written to disk; status/log output that only confirmed what you expected; a large block pasted inside a user message once you have used it.\nKeep: user messages (never stamp one for its directive), your own conversation text, unresolved errors, raw evidence you haven't extracted yet, and outputs whose exact wording may still matter.\n\nLook at each tag before stamping it; never blanket-stamp a range like \"1-50\". Many small targeted stamps beat one sweep. `drop` accepts \"3-5\", \"1,2,9\", \"1-5,8,12-15\".";
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-reduce/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,02CASoD,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-reduce/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,yzCAKsI,CAAC"}

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\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 CTX_SEARCH_DESCRIPTION = "Search the archive \u2014 everything that ever happened in this project, not just what is on your desk.\n\nRetrieval matches meaning and exact words and fuses them, so phrase `query` as a natural-language question that still carries the exact terms you expect in the answer (paths, symbols, config keys, error strings); a bare keyword stack finds less.\n- \"where is the opencode source code path?\"  (a location you once knew)\n- \"why did we choose SQLite over postgres?\"  (a decision and its reasons)\n- \"how does the dreamer lease work?\"  (a mechanism discussed or implemented earlier)\n- Not: \"upload client retry backoff config\"\n\nResults only contain what you CANNOT currently see \u2014 memories already in <project-memory> and the live tail are filtered out. A query that is just memory ids (`#7234`, `12, 34`) resolves them directly.\n\nSources (omit for all):\n- memory \u2014 rules, constraints, conventions; \"what's our convention for X\"\n- message \u2014 the raw conversation behind compacted history; \"did we discuss this\"; hits carry ordinals for ctx_expand(start=N-10, end=N+5)\n- git_commit \u2014 commit history; \"when did this change\" (pair with message for regression hunts)\n- note \u2014 parked follow-ups with their recorded text; \"did we leave a follow-up\"\nUse from/to to restrict every source to an inclusive UTC date range.";
 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,4tDAkBiB,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,01CAekC,CAAC;AACtE,eAAO,MAAM,wBAAwB,KAAK,CAAC"}

package/dist/tools/ctx-search/date-range.d.ts

@@ -0,0 +1,9 @@
+export interface ParsedSearchDateRange {
+    from?: number;
+    to?: number;
+}
+export declare class SearchDateRangeError extends Error {
+    readonly code = "invalid_search_date_range";
+}
+export declare function parseSearchDateRange(from: string | undefined, to: string | undefined): ParsedSearchDateRange;
+//# sourceMappingURL=date-range.d.ts.map

package/dist/tools/ctx-search/date-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-range.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-search/date-range.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,+BAA+B;CAC/C;AAmCD,wBAAgB,oBAAoB,CAChC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,EAAE,EAAE,MAAM,GAAG,SAAS,GACvB,qBAAqB,CASvB"}

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

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-search/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAqBhE,OAAO,KAAK,EAAkC,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjF,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AA4LrE,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-search/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAyBhE,OAAO,KAAK,EAAkC,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjF,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAwMrE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}

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

@@ -7,7 +7,9 @@ export type CtxSearchSource = "memory" | "message" | "git_commit" | "primer" | "
 export interface CtxSearchArgs extends ImitatedReducedArgs {
     query?: string;
     limit?: number;
-    /** Restrict search to specific sources. Omit to search all; [] searches none. */
+    from?: string;
+    to?: string;
+    /** Restrict search to specific sources. Omit or pass [] to search all. */
     sources?: CtxSearchSource[];
 }
 export interface CtxSearchToolDeps {

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-search/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E;;iEAEiE;AACjE,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEtF,MAAM,WAAW,aAAc,SAAQ,mBAAmB;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,QAAQ,CAAC;IACb,uBAAuB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E;;;;;OAKG;IACH,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,KAAK,CAAC;QACxC,OAAO,EAAE,MAAM,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,OAAO,EAAE,CAAC;KACpB,CAAC,CAAC;CACN"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-search/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E;;iEAEiE;AACjE,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEtF,MAAM,WAAW,aAAc,SAAQ,mBAAmB;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,QAAQ,CAAC;IACb,uBAAuB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E;;;;;OAKG;IACH,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,KAAK,CAAC;QACxC,OAAO,EAAE,MAAM,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,OAAO,EAAE,CAAC;KACpB,CAAC,CAAC;CACN"}

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: 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 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.";
+export declare const CTX_REDUCE_LIGHT_DESCRIPTION = "Stamp an item as no longer needed for the work ahead. Not a delete: stamping QUEUES it, the item stays readable until Magic Context clears stamped items in one sweep, newest tags are protected, and a cleared item goes to the archive (recent: a [dropped \u00A7N\u00A7] placeholder; older: removed) recoverable via ctx_expand(message=N). The question is \"does this need to stay on my desk for what comes next?\" \u2014 a file you keep editing stays, the grep that found it goes. Stamp used reads/searches/outputs, acted-on build/test output, redundant dumps, extracted pasted payloads; keep user messages, your own text, unresolved errors, raw evidence, exact wording that may matter. Look at each tag; never blanket-stamp \"1-50\". Grammar: \"3-5\", \"1,2,9\", \"1-5,8,12-15\".";
+export declare const CTX_EXPAND_LIGHT_DESCRIPTION = "Recover raw conversation behind a <session-history> heading or around a ctx_search hit: ctx_expand(start, end) returns [N] U:/A: lines (~15K-token cap; oversized ranges return the head and where to continue). verbose=true lists messages with per-part previews to pick one; message=N returns that message in full, including a tool output released with ctx_reduce. Ranges after the last compartment are your live tail, not expandable.";
+export declare const CTX_NOTE_LIGHT_DESCRIPTION = "Session notes are pending intentions: work you intend to return to, with findings attached (\"take a note\" always qualifies). Not active steps, an executing plan, or restart insurance; a record of how things stand (world-state, a design at a point in time) with nothing you intend to do about it \u2014 that goes stale silently; a fact worth keeping is memory, the rest is nothing. First line = title (<80 chars). write saves; read lists rows (note_ids for bodies); update changes one; dismiss retires 1\u201350. Dismiss a note when its work lands or is abandoned; a queue you never dismiss from stops being read. surface_condition parks it until an outside check against repo files, git, GitHub or the web holds.";
+export declare const CTX_MEMORY_LIGHT_DESCRIPTION = "Durable facts about this project, shared with every agent on it and kept for the months this work lasts; active ones are already in <project-memory> as `#id: fact`. Write one standalone fact when it must not have to be found again \u2014 a rule, an architecture fact, a constraint, a config value, a naming convention \u2014 especially what cost you turns. A pending intention with evidence is ctx_note, not memory. write (content + category); update one id (content; category optional); archive one or more ids (reason optional); merge two or more ids (content); get 1\u201320 ids in any status.";
+export declare const CTX_SEARCH_LIGHT_DESCRIPTION = "Search the archive \u2014 everything that ever happened here that is not on your desk: memories not in <project-memory>, compacted conversation, commits, notes. Phrase query as a natural-language question carrying the exact terms you expect (\"where is the opencode source code path?\", \"why did we choose SQLite over postgres?\", \"how does the dreamer lease work?\") \u2014 a keyword stack finds less. Sources (omit for all): memory (rules, conventions), message (compacted conversation; hits carry ordinals for ctx_expand), git_commit (when did this change), note (parked follow-ups). Memory ids alone (`#7234`) resolve directly. from/to restrict every source to an inclusive UTC date range.";
 //# 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,iSAAuR,CAAC;AAE/T,eAAO,MAAM,4BAA4B,6SAA6S,CAAC;AAEvV,eAAO,MAAM,4BAA4B,iVAAiV,CAAC"}
+{"version":3,"file":"light-descriptions.d.ts","sourceRoot":"","sources":["../../src/tools/light-descriptions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,8wBAAqvB,CAAC;AAE/xB,eAAO,MAAM,4BAA4B,qbAC6Y,CAAC;AAEvb,eAAO,MAAM,0BAA0B,+sBAC6pB,CAAC;AAErsB,eAAO,MAAM,4BAA4B,ylBACkiB,CAAC;AAE5kB,eAAO,MAAM,4BAA4B,4rBACooB,CAAC"}

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

@@ -0,0 +1,75 @@
+import type { PromptSurfacePreset } from "../shared/prompt-surface";
+export declare const FULL_PARAMETER_DESCRIPTIONS: {
+    readonly ctx_reduce: {
+        readonly drop: "Tag IDs to drop: \"3-5\", \"1,2,9\", \"1-5,8,12-15\".";
+    };
+    readonly ctx_expand: {
+        readonly start: "First ordinal of the range — a compartment's start, or an ordinal from a ctx_search hit.";
+        readonly end: "Last ordinal of the range, inclusive — a compartment's end.";
+        readonly verbose: "With start/end: one entry per message with ordinal and per-part preview instead of the transcript.";
+        readonly message: "Recover ONE message in full by ordinal (all text, all tool inputs and outputs). Use alone, without start/end.";
+    };
+    readonly ctx_note: {
+        readonly action: "write | read | update | dismiss. Defaults to write when content is given, else read.";
+        readonly content: "Note text for write/update: first line is the title (under 80 chars), then the detail.";
+        readonly 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.";
+        readonly filter: "Read filter: active (default: active + ready), all, pending (unsurfaced smart notes), ready, dismissed.";
+        readonly limit: "Rows per read (default 25).";
+        readonly offset: "Skip this many newest rows (default 0).";
+        readonly note_ids: "Note ids: one for update, 1–50 for dismiss, any number for read (returns full bodies). Ignored by write.";
+    };
+    readonly ctx_memory: {
+        readonly action: "write | update | archive | merge | get";
+        readonly content: "The memory text — one standalone fact (write, update, merge).";
+        readonly category: "Kind of fact (required for write; on update/merge optional, omitted keeps the current category).";
+        readonly ids: "Memory ids from <project-memory>: one for update, one or more for archive, two or more for merge, 1–20 for get.";
+        readonly limit: "Max results for list (default 10).";
+        readonly reason: "Why it is being archived (optional).";
+    };
+    readonly ctx_search: {
+        readonly query: "A natural-language question carrying the exact terms you expect in the answer.";
+        readonly limit: "Maximum results (default 10).";
+        readonly sources: "Restrict to these sources; omit for all. [] searches none.";
+        readonly from: "Earliest date, YYYY-MM-DD (inclusive).";
+        readonly to: "Latest date, YYYY-MM-DD (inclusive; default open).";
+    };
+};
+export declare const LIGHT_PARAMETER_DESCRIPTIONS: {
+    readonly ctx_reduce: {
+        readonly drop: "Tag IDs: \"3-5\", \"1,2,9\", \"1-5,8,12-15\".";
+    };
+    readonly ctx_expand: {
+        readonly start: "First ordinal — a compartment's start or a search hit.";
+        readonly end: "Last ordinal, inclusive.";
+        readonly verbose: "With start/end: one entry per message with previews instead of the transcript.";
+        readonly message: "Recover ONE message in full by ordinal; use without start/end.";
+    };
+    readonly ctx_note: {
+        readonly action: "write | read | update | dismiss (default: write with content, else read).";
+        readonly content: "Note text: first line title (<80 chars), then detail.";
+        readonly 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.";
+        readonly filter: "Read filter: active (default), all, pending, ready, dismissed.";
+        readonly limit: "Rows per read (default 25).";
+        readonly offset: "Skip newest rows (default 0).";
+        readonly note_ids: "One id for update, 1–50 for dismiss, any for read (full bodies). Ignored by write.";
+    };
+    readonly ctx_memory: {
+        readonly action: "write | update | archive | merge | get";
+        readonly content: "One standalone fact (write, update, merge).";
+        readonly category: "Kind of fact (required for write; optional on update/merge).";
+        readonly ids: "Ids from <project-memory>: one for update, 1+ for archive, 2+ for merge, 1–20 for get.";
+        readonly limit: "Max results for list (default 10).";
+        readonly reason: "Why it is archived (optional).";
+    };
+    readonly ctx_search: {
+        readonly query: "A natural-language question carrying the exact terms you expect in the answer.";
+        readonly limit: "Maximum results (default 10).";
+        readonly sources: "Restrict to these sources; omit for all.";
+        readonly from: "Earliest date, YYYY-MM-DD (inclusive).";
+        readonly to: "Latest date, YYYY-MM-DD (inclusive; default open).";
+    };
+};
+export type PromptSurfaceParameterToolId = keyof typeof FULL_PARAMETER_DESCRIPTIONS;
+export declare function parameterDescriptionsFor(toolId: string, preset: PromptSurfacePreset): Readonly<Record<string, string>> | undefined;
+export declare function applyJsonSchemaParameterDescriptions(toolId: string, input: unknown, preset: PromptSurfacePreset): void;
+//# sourceMappingURL=parameter-descriptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-descriptions.d.ts","sourceRoot":"","sources":["../../src/tools/parameter-descriptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC9B,CAAC;AAEX,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC/B,CAAC;AAEX,MAAM,MAAM,4BAA4B,GAAG,MAAM,OAAO,2BAA2B,CAAC;AAEpF,wBAAgB,wBAAwB,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,mBAAmB,GAC5B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAI9C;AAED,wBAAgB,oCAAoC,CAChD,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,mBAAmB,GAC5B,IAAI,CAWN"}