@avantf/dsh-mem 0.7.0 → 0.8.0

package/lib/interface-version.json

@@ -1,4 +1,4 @@
 {
-  "baseVersion": "0.5.2",
+  "baseVersion": "0.5.3",
   "interfaceVersion": 4
 }

package/lib/types/client/index.d.ts

@@ -24,12 +24,12 @@ interface ClientContext {
 /** Client cordis-plugin name shown in boot diagnostics. */
 export declare const name = "avantf-mem-client";
 /**
- * Services required to render the two tabs. `remote` (not `remote.avantfMem`)
+ * Services required to render the tab. `remote` (not `remote.avantfMem`)
  * on purpose: a missing namespace must not leave this entry pending, because
  * the client boot rejects the whole tree when any entry is pending.
  */
 export declare const inject: string[];
-/** Contribute the two `conversation.view` tabs, mounting this package's Remote namespace first. */
+/** Contribute the `conversation.view` tab, mounting this package's Remote namespace first. */
 export declare function apply(ctx: ClientContext): Promise<void>;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/lib/types/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAwGA,wDAAwD;AACxD,UAAU,aAAa;IACrB,KAAK,EAAE;QACL,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;QAChD,QAAQ,CACN,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,MAAM,CAAA;SAAE,EACzE,SAAS,EAAE,MAAM,OAAO,GACvB,IAAI,CAAA;KACR,CAAA;IACD,MAAM,EAAE;QACN,wEAAwE;QACxE,MAAM,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;KAC5D,CAAA;IACD;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3B;AA8kDD,2DAA2D;AAC3D,eAAO,MAAM,IAAI,sBAAsB,CAAA;AAEvC;;;;GAIG;AACH,eAAO,MAAM,MAAM,UAAsB,CAAA;AAEzC,mGAAmG;AACnG,wBAAsB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC7D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AA6DA,wDAAwD;AACxD,UAAU,aAAa;IACrB,KAAK,EAAE;QACL,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;QAChD,QAAQ,CACN,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,MAAM,CAAA;SAAE,EACzE,SAAS,EAAE,MAAM,OAAO,GACvB,IAAI,CAAA;KACR,CAAA;IACD,MAAM,EAAE;QACN,wEAAwE;QACxE,MAAM,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;KAC5D,CAAA;IACD;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3B;AAgqCD,2DAA2D;AAC3D,eAAO,MAAM,IAAI,sBAAsB,CAAA;AAEvC;;;;GAIG;AACH,eAAO,MAAM,MAAM,UAAsB,CAAA;AAEzC,8FAA8F;AAC9F,wBAAsB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B7D"}

package/lib/types/client/paging.d.ts

@@ -1,9 +1,9 @@
 /**
- * Page merging for the two list tabs.
+ * Page merging for the fact list.
  *
  * Kept out of `client/index.ts` so it can be tested without a DOM (the same reason `summarize.ts`
- * lives on its own): these two functions are where page drift is handled, and page drift is the
- * kind of bug that only shows up as a React key warning plus a row nobody can scroll to.
+ * lives on its own): this is where page drift is handled, and page drift is the kind of bug that
+ * only shows up as a React key warning plus a row nobody can scroll to.
  *
  * @module client/paging
  */
@@ -18,13 +18,4 @@
 export declare function mergePage<T extends {
     fact_id: number;
 }>(previous: T[], page: T[]): T[];
-/**
- * Append one page of documents, dropping ids already present.
- *
- * Same window shift as `mergePage`: `kb.list` pages by `OFFSET` over `updated_at DESC`, which also
- * has second precision, and a document ingested between two requests repeats a row.
- */
-export declare function mergeDocs<T extends {
-    doc_id: number;
-}>(previous: T[], page: T[]): T[];
 //# sourceMappingURL=paging.d.ts.map

package/lib/types/client/paging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paging.d.ts","sourceRoot":"","sources":["../../../src/client/paging.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAEtF;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAErF"}
+{"version":3,"file":"paging.d.ts","sourceRoot":"","sources":["../../../src/client/paging.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAEtF"}

package/lib/types/client/summarize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../../src/client/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA6BH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAoChD"}
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../../src/client/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA6BH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA+BhD"}

package/lib/types/envinit-bootstrap.d.ts

@@ -3,7 +3,7 @@
  * @module bootstrap
  */
 /** The bootstrap version; the resolved framework must satisfy {@link supportedRange}. */
-export declare const VERSION = "0.5.2";
+export declare const VERSION = "0.5.3";
 /**
  * The framework interval this bootstrap can launch.
  *

package/lib/types/envinit.d.ts

@@ -6,7 +6,6 @@ type EnvinitModule = typeof import('@avantf/dsh-plugin-base');
  * The item ids. `resolve()` / `onSettled` are keyed by them, so the DSH plugin compares against these
  * names rather than re-spelling literals.
  */
-export declare const PANDOC_ITEM = "mem:pandoc";
 export declare const MODEL_ITEM = "mem:model";
 /** The logging surface this module needs — `AvantfLogger` satisfies it. */
 interface EnvinitLogger {
@@ -17,13 +16,10 @@ interface EnvinitLogger {
 /**
  * What the engine resolved from its config, handed to {@link EnvinitRuntime.provisionResources}.
  *
- * `pandoc` is "this build needs it": when `tools.auto_install` is off the item is NOT declared, so the
- * framework never fetches something the operator disabled per feature. The model is declared either
- * way (unless the runtime reads its models elsewhere), because WHEN it is off is a DOWNLOAD question,
- * not a declaration question — see {@link ResourcePlan.modelAutoDownload}.
+ * The model is declared whether or not downloads are allowed, because WHEN it is off is a DOWNLOAD
+ * question, not a declaration question — see {@link ResourcePlan.modelAutoDownload}.
  */
 export interface ResourcePlan {
-    readonly pandoc: boolean;
     /** `tools.mirror` — URL templates tried before the official source, for archive downloads. */
     readonly archiveMirrors: readonly string[];
     /**

package/lib/types/envinit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"envinit.d.ts","sourceRoot":"","sources":["../../src/envinit.ts"],"names":[],"mappings":"AAoDA,OAAO,KAAK,EAAiB,oBAAoB,EAAe,MAAM,yBAAyB,CAAA;AAG/F,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAA;AAKvB,4FAA4F;AAC5F,KAAK,aAAa,GAAG,cAAc,yBAAyB,CAAC,CAAA;AAK7D;;;GAGG;AACH,eAAO,MAAM,WAAW,eAAe,CAAA;AACvC,eAAO,MAAM,UAAU,cAAc,CAAA;AAmDrC,2EAA2E;AAC3E,UAAU,aAAa;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,8FAA8F;IAC9F,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1C;;;;;;;;OAQG;IACH,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAA;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EACV;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GACvF,SAAS,CAAA;CACd;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE;IACR,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB,EACD,UAAU,EAAE,MAAM,GACjB,YAAY,CAAC,OAAO,CAAC,CAQvB;AAOD,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,SAAS,CAAA;IACvC,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2FAA2F;IAC3F,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAA;IAC1C,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACnE;;;;;;OAMG;IACH,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,IAAI,CAAA;IAC9F,wEAAwE;IACxE,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,uCAAuC;AACvC,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,aAAa,CAAA;IAC5B,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,mHAAmH;IACnH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAA;IAClC,0FAA0F;IAC1F,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAA;CACrC;AA8ID;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAEjG"}
+{"version":3,"file":"envinit.d.ts","sourceRoot":"","sources":["../../src/envinit.ts"],"names":[],"mappings":"AAiDA,OAAO,KAAK,EAAiB,oBAAoB,EAAe,MAAM,yBAAyB,CAAA;AAG/F,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAA;AAKvB,4FAA4F;AAC5F,KAAK,aAAa,GAAG,cAAc,yBAAyB,CAAC,CAAA;AAK7D;;;GAGG;AACH,eAAO,MAAM,UAAU,cAAc,CAAA;AAmDrC,2EAA2E;AAC3E,UAAU,aAAa;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,8FAA8F;IAC9F,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1C;;;;;;;;OAQG;IACH,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAA;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EACV;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GACvF,SAAS,CAAA;CACd;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE;IACR,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB,EACD,UAAU,EAAE,MAAM,GACjB,YAAY,CAAC,OAAO,CAAC,CAQvB;AAOD,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,SAAS,CAAA;IACvC,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2FAA2F;IAC3F,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAA;IAC1C,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACnE;;;;;;OAMG;IACH,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,IAAI,CAAA;IAC9F,wEAAwE;IACxE,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,uCAAuC;AACvC,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,aAAa,CAAA;IAC5B,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,mHAAmH;IACnH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAA;IAClC,0FAA0F;IAC1F,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAA;CACrC;AA8GD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAEjG"}

package/lib/types/hints.d.ts

@@ -1,41 +1,45 @@
-import type { RelevanceHit } from '../engine/mem/index.js';
 /**
- * The plugin's CONDITIONAL hint: ONE line, contributed only when either store already holds
- * something relevant to the message the user just sent (DESIGN §12).
+ * The plugin's CONDITIONAL hint: ONE line, injected as its own user message only when memory already
+ * holds something relevant to the message the user just sent (DESIGN §12).
  *
- * These are deliberately NOT part of the always-on usage sections. A usage section says WHEN a
- * store is worth consulting and therefore has to be paid for on every step of every session; this
- * says "there is something here, right now", which is only true sometimes. The two layers compose:
- * the section is the fallback for the paraphrase the lexical probe misses, and the hint is the
- * concrete nudge for the case it catches.
+ * It is deliberately NOT part of the always-on usage section. A usage section says WHEN memory is
+ * worth consulting and therefore has to be paid for on every step of every session; this says
+ * "there is something here, right now", which is only true sometimes. The two layers compose: the
+ * section is the fallback for what the probe misses, and the hint is the concrete nudge for the case
+ * it catches.
  *
- * ONE LINE FOR BOTH STORES, and it names ONE tool. `kb_query` is a cross-store retrieval (document
- * chunks AND memory facts), so a single line covers whichever store matched. Per-store lines used
- * to name two tools, which invited two overlapping calls — the memory facts came back twice, once
- * from `mem_recall` and again inside `kb_query`'s fused result — and made every memory↔knowledge
- * transition a fresh snapshot append. `mem_recall` remains the tool for the memory-only actions
- * (chain / probe / reason / contradict); the always-on memory usage section is where that is said.
+ * ONE LINE, naming ONE tool: `mem_recall` is the entry point for every retrieval action (search /
+ * search / titles and the built-in relation stage), so a single sentence covers whichever one the model
+ * needs.
  *
- * WHY THE LINE NAMES THE PLUGIN. This text is injected as runtime context, and the harness
- * materialises that as a USER-role snapshot in the conversation (`dsh-agent-loop`'s
- * `runtimeContext.project`). Without an author, a line like "记忆里有相关内容" reads as something
- * the user said. The `[avantf-mem]` prefix is what keeps the provenance honest.
+ * WHY THE LINE NAMES THE PLUGIN. The hint is injected as a USER-role message (`index.ts`'s
+ * `agent/pre-step` listener), and the harness shows such a message in the trace as coming from the
+ * user. Without an author, a line like "记忆里有相关内容" reads as something the user said. The
+ * `[avantf-mem]` prefix is what keeps the provenance honest.
  */
-export declare const RELEVANCE_HINT = "[avantf-mem] \u8BB0\u5FC6\u6216\u77E5\u8BC6\u5E93\u91CC\u6709\u4E0E\u4E0A\u6761\u7528\u6237\u6D88\u606F\u76F8\u5173\u7684\u5185\u5BB9\uFF1B\u9700\u8981\u65F6\u7528 `kb_query` \u68C0\u7D22\u3002";
+export declare const RELEVANCE_HINT = "[avantf-mem] \u8BB0\u5FC6\u91CC\u6709\u4E0E\u4E0A\u6761\u7528\u6237\u6D88\u606F\u76F8\u5173\u7684\u5185\u5BB9\uFF1B\u9700\u8981\u65F6\u7528 `mem_recall` \u68C0\u7D22\u3002";
 /**
- * Map one answer to the contribution, as text.
+ * The text of the messages THIS STEP newly claimed from the user, or `''` when it claimed none.
  *
- * An empty string is the "contribute nothing" value: `renderContextSections` drops empty text, so
- * "nothing found" costs no tokens at all.
+ * This is the whole deduplication rule of the hint, and it is STRUCTURAL rather than remembered:
+ * `inbox.claim()` empties the pending queue, so a turn's second and later steps are handed no new
+ * user message and this returns `''`. "One injection per user message" is therefore a consequence
+ * of how the step is fed, not of state this plugin keeps — which is also why a restart, a resume,
+ * or a discarded inbox entry cannot leave a stale verdict behind.
+ *
+ * Only `source.kind === 'user'` moves the verdict. The step's messages also carry this plugin's own
+ * wake-ups, other plugins' notices (`kind: 'plugin:*'`), sub-agent relays and the runtime-context
+ * snapshot; probing those would let a "任务 n1 已结束" wake rewrite a hint that claims to be about
+ * the user's last message.
  */
-export declare function hintText(hit: RelevanceHit): string;
+export declare function freshUserText(messages: readonly unknown[]): string;
 /**
  * The plain text of an inbox message, or `''` when it carries none.
  *
  * `dsh-agent-loop`'s own extractor returns `undefined` unless the message is exactly ONE text
  * block; a steered or multi-part message would then silently produce no hint. Concatenating the
  * text blocks keeps the probe working for those, and non-text blocks (images) are simply skipped —
- * the probe is lexical, so it has nothing to say about them anyway.
+ * with no text there is nothing for either the lexical or the semantic probe to judge.
  */
 export declare function messageText(message: unknown): string;
 //# sourceMappingURL=hints.d.ts.map

package/lib/types/hints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hints.d.ts","sourceRoot":"","sources":["../../src/hints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAO,MAAM,cAAc,sMAC8B,CAAA;AAEzD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAElD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAUpD"}
+{"version":3,"file":"hints.d.ts","sourceRoot":"","sources":["../../src/hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,eAAO,MAAM,cAAc,gLAC4B,CAAA;AAEvD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAMlE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAUpD"}

package/lib/types/index.d.ts

@@ -15,12 +15,28 @@
  */
 import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
+import { type ContextFormed } from '@deepseek-ai/dsh-llm';
 import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
-import { type AvantfRuntime, type KnowledgeStore, type MemoryStore, type StoreResult } from '../engine/mem/index.js';
-import { type BrowseListing, type OpenOutcome, type RecallResult, type RemoteEnvelope, type SourceClassification } from '../engine/mem-contract/index.js';
+import { type AvantfRuntime, type MemoryStore, type RecallHitsResult, type StoreResult } from '../engine/mem/index.js';
+import { type RemoteEnvelope } from '../engine/mem-contract/index.js';
+/**
+ * The hint's own message source kind, declared where the hint is produced.
+ *
+ * `MessageSourceMap` is merge-extensible on purpose: `kind` answers WHO produced a message, and
+ * every producer owns its own value (there is no shared `plugin` catch-all). Declaring it here is
+ * also what lets `createUserMessage` accept the source without a cast, and what makes the trace row
+ * after a restart name `mem-hint` instead of an opaque unknown producer.
+ */
+declare module '@deepseek-ai/dsh-llm' {
+    interface MessageSourceMap {
+        'mem-hint': {
+            kind: 'mem-hint';
+        } & ContextFormed;
+    }
+}
 export declare const name = "avantf-mem";
 export { inject } from './inject.js';
-export { KNOWLEDGE_PROMPT_SECTION, MEMORY_PROMPT_SECTION } from './prompt.js';
+export { MEMORY_PROMPT_SECTION } from './prompt.js';
 export { registerSemanticBackend, registerVectorStore, type SemanticBackend, type VectorStore, } from '../engine/mem/index.js';
 export interface Config {
     mode?: 'cordis' | 'mcp';
@@ -29,7 +45,7 @@ export interface Config {
 export declare const Config: z<Config>;
 type WireArgs = Record<string, unknown>;
 /**
- * Pass-through gateway mirroring the five agent tools. Every payload is
+ * Pass-through gateway mirroring the three agent tools. Every payload is
  * re-validated with the contract zod union before dispatch (same guarantee the
  * tools give the model), and results are wrapped in the contract's
  * `{ok:true,value}` / `{ok:false,error,violations}` RemoteEnvelope the client decodes.
@@ -59,43 +75,8 @@ export declare class AvantfMemGateway extends TypertRemoteService {
      * here stops compiling instead of quietly misdescribing the wire.
      */
     remember(args: WireArgs): Promise<RemoteEnvelope<StoreResult<MemoryStore, 'add'>>>;
-    recall(args: WireArgs): Promise<RemoteEnvelope<StoreResult<MemoryStore, 'search'>>>;
+    recall(args: WireArgs): Promise<RemoteEnvelope<RecallHitsResult>>;
     admin(args: WireArgs): Promise<RemoteEnvelope<StoreResult<MemoryStore, 'list'>>>;
-    /**
-     * The one method that keeps `unknown`, and deliberately: its payload is whichever of the seven
-     * corpus actions the caller asked for (a page, one document, an ingest report, a conflict report, a
-     * reindex plan …), so there is no single engine type to name. The engine's `KbDispatch` spells all
-     * seven out; the client names its expectation at each call site (`callRemote<…>(…)`).
-     */
-    kb(args: WireArgs): Promise<RemoteEnvelope<unknown>>;
-    query(args: WireArgs): Promise<RemoteEnvelope<RecallResult>>;
-    /**
-     * UI-only: what IS this string? Answered against the ingestion boundary, so the UI can label the
-     * input and pick the right `kb_manage` action (URL → fetch, file → ingest, directory → import,
-     * text → ingest the string itself, missing → refuse and say why).
-     */
-    classifySource(args: WireArgs): Promise<RemoteEnvelope<SourceClassification>>;
-    /** UI-only: one directory listing for the 选择 picker (same boundary as ingestion). */
-    browseDir(args: WireArgs): Promise<RemoteEnvelope<BrowseListing>>;
-    /**
-     * UI-only: the 知识页 domain picker's options — the configured `knowledge.domains` allowlist
-     * together with the domains the library already holds — plus whether the allowlist is active
-     * (non-empty). The host is the only side that knows either half.
-     */
-    kbDomains(_args: WireArgs): Promise<RemoteEnvelope<StoreResult<KnowledgeStore, 'domainCatalog'>>>;
-    /**
-     * UI-only: add one 知识域 to the store config's `domains` allowlist AND to the live set, so the
-     * 知识 tab's 「+」 works without a restart. No agent tool mirrors this on purpose — the model must
-     * stay bounded by the configured list, while the user can widen it.
-     */
-    kbAddDomain(args: WireArgs): Promise<RemoteEnvelope<StoreResult<KnowledgeStore, 'addDomain'>>>;
-    /**
-     * UI-only: hand one managed document file — or the directory that holds it — to the user's
-     * editor. No agent tool mirrors this, so it carries its own envelope instead of going through
-     * `dispatchToolKey`; the path is resolved from `doc_id` here, so nothing the client sends is
-     * trusted.
-     */
-    openDoc(args: WireArgs): Promise<RemoteEnvelope<OpenOutcome>>;
 }
 export declare function apply(ctx: Context, config: Config): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AASlD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,OAAO,EAAE,mBAAmB,EAAU,MAAM,kCAAkC,CAAA;AAE9E,OAAO,EASL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,EAEhB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAgBL,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,KAAK,YAAY,EACjB,KAAK,cAAc,EAEnB,KAAK,oBAAoB,EAG1B,MAAM,sBAAsB,CAAA;AAsB7B,eAAO,MAAM,IAAI,eAAe,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAQ7E,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAA;AAEpB,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AACD,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAO3B,CAAA;AAkCF,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAmBvC;;;;;;;;;;GAUG;AACH,qBAAa,gBAAiB,SAAQ,mBAAmB;IACvD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;gBACtB,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,aAAa;IAK3C;;;;;;;;;OASG;YACW,IAAI;IAclB;;;;OAIG;IAEH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;IAMlF,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IAMnF,KAAK,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IAKhF;;;;;OAKG;IAEH,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAOpD,KAAK,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;IAI5D;;;;OAIG;IAEG,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC;IAUnF,qFAAqF;IAE/E,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;IAUvE;;;;OAIG;IAEG,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC;IAQvG;;;;OAIG;IAEG,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC;IAUpG;;;;;OAKG;IAEG,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;CAiBpE;AAmHD,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgavE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAQlD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAE5E,OAAO,EAAE,mBAAmB,EAAU,MAAM,kCAAkC,CAAA;AAE9E,OAAO,EASL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAcL,KAAK,cAAc,EAIpB,MAAM,sBAAsB,CAAA;AAgB7B;;;;;;;GAOG;AACH,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,gBAAgB;QACxB,UAAU,EAAE;YAAE,IAAI,EAAE,UAAU,CAAA;SAAE,GAAG,aAAa,CAAA;KACjD;CACF;AAED,eAAO,MAAM,IAAI,eAAe,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAQnD,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAA;AAEpB,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AACD,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAO3B,CAAA;AA+BF,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAmBvC;;;;;;;;;;GAUG;AACH,qBAAa,gBAAiB,SAAQ,mBAAmB;IACvD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;gBACtB,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,aAAa;IAK3C;;;;;;;;;OASG;YACW,IAAI;IAclB;;;;OAIG;IAEH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;IAMlF,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;IAMjE,KAAK,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;CAKjF;AAmGD,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyZvE"}

package/lib/types/inject.d.ts

@@ -6,8 +6,9 @@
  * `test/provision.spec.ts`, which asserts that every service cordis WAITS for has a contract in
  * `SERVICE_CONTRACTS`.
  *
- * `systemPrompt` is here because the plugin contributes three usage sections and two conditional
- * hints (see `prompt.ts`). Each service gates `apply`: without `tools`/`typert` there is nothing to
+ * `systemPrompt` is here because the plugin contributes three usage sections (see `prompt.ts`).
+ * The conditional hint is NOT one of them: it is a single user message injected by `agent/pre-step`,
+ * which needs no service. Each service gates `apply`: without `tools`/`typert` there is nothing to
  * register, and without the prompt registry the guidance has nowhere to land.
  */
 export declare const inject: string[];

package/lib/types/inject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../../src/inject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,MAAM,UAAsC,CAAA"}
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../../src/inject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,MAAM,UAAsC,CAAA"}

package/lib/types/interface_gate.d.ts

@@ -17,7 +17,7 @@
  * `@module` line below differs. Everything here is the consumption contract and the ONE verdict→decision
  * mapping; nothing in it is plugin-specific by construction. What IS plugin-specific (which text the
  * prompt layer falls back to, which resources take the legacy path) belongs in that plugin's own
- * `envinit.ts`, never here. `base/plugin-base/test/interface_consumers.spec.ts` pins the three
+ * `envinit.ts`, never here. `base/test/interface_consumers.spec.ts` pins the three
  * copies against each other, so a divergence is a red test instead of three shims that drifted.
  *
  * The loader SKELETON every startup shares lives here too: the once-per-process cache

package/lib/types/prompt.d.ts

@@ -1,7 +1,7 @@
 import type { PromptSection } from '@deepseek-ai/dsh-system-prompt';
 import type { LoadedPromptText, PromptFileSpec } from '@avantf/dsh-plugin-base';
 /**
- * The three system-prompt sections this plugin contributes (DESIGN §10).
+ * The one system-prompt section this plugin contributes (DESIGN §10).
  *
  * The TEXTS are user-editable: each section's body lives in its own `.md` under the shared family
  * prompt directory `<data_home>/prompts` (`PROMPT_FILES` maps file → section), and the constants
@@ -13,20 +13,11 @@ import type { LoadedPromptText, PromptFileSpec } from '@avantf/dsh-plugin-base';
  * release, not a plugin rebuild. When the base is unavailable the built-in defaults below are used
  * and nothing is written to disk.
  *
- * They exist for something a tool description cannot carry: a description says what a call DOES,
- * never when to reach for it unprompted, and the default behaviour is to wait until asked. So each
- * says only WHEN its store is worth writing or reading. Neither says anything about how memory is
- * retained — that stays out of every model-facing string, held to the contract's
- * `RETENTION_VOCABULARY`, the same list the tool descriptions are held to.
- *
- * The knowledge one is the section whose ABSENCE was measured: a user had just ingested
- * 《Cgroup v2 技术综述》(which answers "cgroup v2 的内存保护" at score 1.0) and asked about it in a
- * session whose prompt named only the memory tools, so the model never looked. A tool description
- * cannot fix that by itself — `kb_query`'s says what the call does and even leads with 记忆 facts,
- * which reads as a memory tool — and the model cannot know the library is relevant to a question
- * without being told to check it. Hence the "先检索一次再作答" nudge, plus the explicit
- * "你看不到库里有什么" clause: the thing that made the miss invisible is that nothing in the
- * prompt acknowledged the store existed at all.
+ * It exists for something a tool description cannot carry: a description says what a call DOES,
+ * never when to reach for it unprompted, and the default behaviour is to wait until asked. So it
+ * says only WHEN memory is worth writing or reading. It says nothing about how memory is retained —
+ * that stays out of every model-facing string, held to the contract's `RETENTION_VOCABULARY`, the
+ * same list the tool descriptions are held to.
  *
  * `order` 3000/3010 are third-party slots: after the harness's per-tool guidance block (1000–2900)
  * and before its toolset-level guidance (5000). They are not repository-owned placements, so they
@@ -41,39 +32,24 @@ import type { LoadedPromptText, PromptFileSpec } from '@avantf/dsh-plugin-base';
  * `update` plus the verification basis; and `recall` output is not written straight back as a new
  * fact. Because the FILE version wins over this built-in fallback, users who already customised
  * `mem-memory-usage.md` do NOT get them automatically — the upgrade note in
- * `docs/PENDING-RELEASE-NOTES.md` carries the pasteable text for exactly that case.
+ * `CHANGELOG/unreleased.md` carries the pasteable text for exactly that case.
  *
  * Kept in its own module — not in `index.ts` — so the text can be read and checked without the
  * plugin entry's `@deepseek-ai/*` runtime imports, which resolve only in a harness workspace.
  */
-export declare const MEMORY_PROMPT_SECTION: {
-    readonly name: "avantf:memory-usage";
-    readonly order: 3000;
-    readonly text: string;
-};
 /**
- * WHEN to consult the document knowledge base. See the module comment for why this is a separate
- * section rather than a clause inside the memory one: the two stores answer different questions,
- * and a session that needs the knowledge base may have no memory question at all.
- */
-export declare const KNOWLEDGE_PROMPT_SECTION: {
-    readonly name: "avantf:knowledge-usage";
-    readonly order: 3010;
-    readonly text: string;
-};
-/**
- * HOW to change a document that is already in the library.
+ * WHEN and WHAT to remember — now in the memory's own two LAYERS (JOURNAL_NOTES_REDESIGN N9).
  *
- * A separate section because it is a different job from the one above, and because the first
- * section is already at 382 of its 400-character budget. It exists to prevent a measured failure:
- * asked to "update the knowledge base", a model called the old all-in-one tool with a NEW title and
- * silently created a sibling document (《… · 补遗》) while the original stayed behind — two
- * overlapping documents, and the reader left to reconcile them. Changing a document is a FILE EDIT,
- * so the section has to name the file tools and warn about the one that destroys the frontmatter.
+ * The section no longer asks the model to classify by TOPIC (the eight values and their fallback are
+ * gone): it names the two layers, says when each applies, and says the only relationship between
+ * them that matters — a note is distilled FROM journal entries once the fact is stable, and it cites
+ * the entry it came from with `source_ref`. Everything else (the P-04 hygiene clauses, "do not
+ * record transient chatter", the 400-character budget asserted by `prompt_section.spec.ts`) is
+ * unchanged.
  */
-export declare const KB_EDIT_PROMPT_SECTION: {
-    readonly name: "avantf:kb-edit";
-    readonly order: 3020;
+export declare const MEMORY_PROMPT_SECTION: {
+    readonly name: "avantf:memory-usage";
+    readonly order: 3000;
     readonly text: string;
 };
 /**

package/lib/types/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAEnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,eAAO,MAAM,qBAAqB;;;;CAYA,CAAA;AAElC;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;CAOH,CAAA;AAElC;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB;;;;CAMD,CAAA;AAElC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,QAAQ,CAAA;AAErC,gGAAgG;AAChG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,kGAAkG;IAClG,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAC5D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,eAAe,EAIlD,CAAA;AAED,qGAAqG;AACrG,wBAAgB,eAAe,IAAI,cAAc,EAAE,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,aAAa,EAAE,CAOxF;AAED,0FAA0F;AAC1F,eAAO,MAAM,kBAAkB,MAAM,CAAA;AAKrC;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,EAAE,CAmB/E"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAEnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB;;;;CAgBA,CAAA;AAElC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,QAAQ,CAAA;AAErC,gGAAgG;AAChG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,kGAAkG;IAClG,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAC5D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,eAAe,EAElD,CAAA;AAED,qGAAqG;AACrG,wBAAgB,eAAe,IAAI,cAAc,EAAE,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,aAAa,EAAE,CAOxF;AAED,0FAA0F;AAC1F,eAAO,MAAM,kBAAkB,MAAM,CAAA;AAKrC;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,EAAE,CAmB/E"}

package/lib/types/provision.d.ts

@@ -48,6 +48,9 @@ export declare const SERVICE_CONTRACTS: readonly ServiceContract[];
  * A listener for a name the host no longer emits registers happily and then never runs: the house
  * hints would simply stop appearing. Nothing inside a plugin can prove the host still emits a name,
  * so the list is a known limit the gate records and the running dsh version is the operator's signal.
+ *
+ * `agent/pre-step` is the one the hint rides on: without it the always-on usage sections still
+ * stand, but no per-message nudge ever appears.
  */
 export declare const REQUIRED_EVENTS: readonly string[];
 /** Packages released in lockstep with dsh; their version says which dsh is running. */

package/lib/types/provision.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provision.d.ts","sourceRoot":"","sources":["../../src/provision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACZ,UAAU,EACV,aAAa,EACb,eAAe,EAChB,MAAM,yBAAyB,CAAA;AAIhC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,CAAA;AAE7C,wEAAwE;AACxE,MAAM,MAAM,YAAY,GAAG,cAAc,yBAAyB,CAAC,CAAA;AAEnE,mFAAmF;AACnF,eAAO,MAAM,cAAc,4BAA4B,CAAA;AAEvD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EAMvD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAA6C,CAAA;AAE1F,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAAmE,CAAA;AAKjH,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,+FAA+F;IAC/F,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;CACxC;AAED,0BAA0B;AAC1B,UAAU,SAAS;IACjB,kGAAkG;IAClG,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAChC;AAED,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE/C;AAED,2EAA2E;AAC3E,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAMzE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAyBrE;AAoBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,aAAa,EACrB,IAAI,GAAE,UAAwB,GAC7B,SAAS,CAMX;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,aAAa,GACpB,IAAI,CAaN;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAC/B,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAQ1C"}
+{"version":3,"file":"provision.d.ts","sourceRoot":"","sources":["../../src/provision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACZ,UAAU,EACV,aAAa,EACb,eAAe,EAChB,MAAM,yBAAyB,CAAA;AAIhC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,CAAA;AAE7C,wEAAwE;AACxE,MAAM,MAAM,YAAY,GAAG,cAAc,yBAAyB,CAAC,CAAA;AAEnE,mFAAmF;AACnF,eAAO,MAAM,cAAc,4BAA4B,CAAA;AAEvD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EAQvD,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAAuC,CAAA;AAEpF,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAI7C,CAAA;AAKD,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,+FAA+F;IAC/F,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;CACxC;AAED,0BAA0B;AAC1B,UAAU,SAAS;IACjB,kGAAkG;IAClG,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAChC;AAED,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE/C;AAED,2EAA2E;AAC3E,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAMzE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAyBrE;AAoBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,aAAa,EACrB,IAAI,GAAE,UAAwB,GAC7B,SAAS,CAMX;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,aAAa,GACpB,IAAI,CAaN;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAC/B,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAQ1C"}

package/lib/types/remote.d.ts

@@ -19,8 +19,8 @@ export declare const clientContribution: TypertRemoteContribution;
  *
  * WHY THE ENVELOPE AND NOT ONE METHOD'S PAYLOAD. Mission's `snapshot` is the panel's one entry point,
  * so its marker rides that payload. mem has no such method: the 记忆 tab opens with `admin.list` and
- * the 知识 tab with `kb.list`/`kb.domains`, either can be first, and neither is mandatory. The one
- * object EVERY answer shares is the application envelope, so the revision rides there — same
+ * may then call `recall` or `remember`, any order. The one object EVERY answer shares is the
+ * application envelope, so the revision rides there — same
  * guarantee, stamped in the one place every method already goes through (`wireOk`/`wireErr`).
  *
  * BUMP RULE. Bump on every added/removed `@Remote` method — the number tracks the SET of methods the
@@ -36,16 +36,23 @@ export declare const clientContribution: TypertRemoteContribution;
  * marker", never as a decode failure — the answer is still readable.
  *
  * Revision history:
- * - 1: the first marker. The face at this point is the ten methods in `descriptors`
- *   (remember / recall / admin / kb / query + openDoc / classifySource / browseDir / kbDomains /
- *   kbAddDomain), all of which predate the marker — so nothing is gated on revision 1; the mechanism
- *   exists for the NEXT method.
+ * - 1: the first marker. The face at that point was ten methods (the three tool-backed ones plus the
+ *   knowledge-base UI methods, all removed in revision 4), all of which predate the marker — so
+ *   nothing is gated on revision 1; the mechanism exists for the NEXT method.
  * - 2: the rerank capability was removed (0.5.0). This changed NO `@Remote` method, but it removed the
  *   `rerank_used` / `rerank_fallback` / `rerank_truncated` fields from the retrieval-health payload
  *   that `admin.stats` answers — fields the client half dereferenced. A rebuilt client talking to an
  *   old host (or the reverse) therefore has to be reported as skew, not silently render `NaN`.
+ * - 3: the memory has two layers (`kind: journal | note`) instead of eight categories. `remember` /
+ *   `recall` / `admin` accept `kind` in place of `category`, and a fact view carries `kind` in place of
+ *   `category` — a removed payload field the client half dereferenced (the fact list rendered it), so
+ *   this is a skew between halves, not a silent field rename.
+ * - 4: the document knowledge base moved to its own plugin. The face lost `kb`, `query`, `openDoc`,
+ *   `classifySource`, `browseDir`, `kbDomains` and `kbAddDomain`, and `admin.vectors_fix` lost its
+ *   `store` field — so a rebuilt client MUST NOT call them against an older host, and this number is
+ *   the reason it can tell.
  */
-export declare const WIRE_VERSION = 2;
+export declare const WIRE_VERSION = 4;
 /**
  * The successful application envelope, with the wire revision stamped on.
  *

package/lib/types/remote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/remote.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EACV,oBAAoB,EAGpB,wBAAwB,EACzB,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAA;AAGhF,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AA6E/D,eAAO,MAAM,WAAW,EAAE,SAAS,oBAAoB,EAiItD,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,EAAE,wBAGhC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,eAAO,MAAM,YAAY,IAAI,CAAA;AAE7B;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,SAAS,CAEnE;AA8BD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBA0C9B,CAAA"}
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/remote.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,oBAAoB,EAGpB,wBAAwB,EACzB,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAA;AAGhF,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AA8F/D,eAAO,MAAM,WAAW,EAAE,SAAS,oBAAoB,EAwFtD,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,EAAE,wBAGhC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,eAAO,MAAM,YAAY,IAAI,CAAA;AAE7B;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,SAAS,CAEnE;AA8BD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBA0C9B,CAAA"}

package/lib/types/tool_schema.d.ts

@@ -5,6 +5,10 @@ type ParamSpec = {
     required?: true;
     enum?: readonly string[];
     items?: ParamSpec;
+    /** DSH's schema compiler requires this explicitly on every nested object. */
+    additionalProperties?: boolean;
+    /** Nested object fields; DSH rejects every key when this is missing. */
+    properties?: Record<string, ParamSpec>;
 };
 /** Nearest `description` on a schema (wrappers included — the converter already unwrapped them). */
 export declare function schemaDescription(schema: unknown): string | undefined;

package/lib/types/tool_schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool_schema.d.ts","sourceRoot":"","sources":["../../src/tool_schema.ts"],"names":[],"mappings":"AAgBA,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAE5E,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAA;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,IAAI,CAAA;IACf,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB,CAAA;AA+BD,oGAAoG;AACpG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGrE;AAqBD,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAEpD;AAOD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAiDzE"}
+{"version":3,"file":"tool_schema.d.ts","sourceRoot":"","sources":["../../src/tool_schema.ts"],"names":[],"mappings":"AAgBA,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAE5E,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAA;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,IAAI,CAAA;IACf,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,6EAA6E;IAC7E,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CACvC,CAAA;AA+BD,oGAAoG;AACpG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGrE;AAkCD,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAEpD;AAOD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAiDzE"}

package/lib/types/vectorMigration.d.ts

@@ -9,11 +9,9 @@
  * degraded to lexical+entity with no error anywhere — the stores' open-time warning now says so, and
  * this module is what repairs it without the operator having to know `vectors --fix` exists.
  *
- * The FLOW lives in the engine, once, for both stores (`@avantf/mem`'s `store/vector_repair.ts`:
- * batch size, event-loop yield, stop / resume / no-progress rules, the `semantic.auto_migrate`
- * decision and the four store-named log kinds). It is driven for BOTH stores — memory and knowledge
- * — in one pass, because one embedding space is configured for the whole runtime: the knowledge
- * store used to be left behind, silently, with only a manual `kb_reindex` able to fix it.
+ * The FLOW lives in the engine (`@avantf/mem`'s `store/vector_repair.ts`: batch size, event-loop
+ * yield, stop / resume / no-progress rules, the `semantic.auto_migrate` decision and the store-named
+ * log kinds).
  *
  * This module owns only the process LIFECYCLE: one start, one stop, and "never an unhandled
  * rejection". It sits BEHIND the startup gate (`awaitStartupGate`, see index.ts): the model warm and
@@ -27,7 +25,7 @@ import { type AvantfRuntime } from '../engine/mem/index.js';
 import type { AvantfLogger } from '../engine/mem-contract/index.js';
 export interface VectorMigrationHandle {
     /**
-     * Run one migration pass. Quiet no-op when both stores are already current, when a pass is already
+     * Run one migration pass. Quiet no-op when the store is already current, when a pass is already
      * running, or after {@link stop}. Failures never escape: they are logged and left for the next
      * heartbeat to retry.
      */
@@ -44,5 +42,5 @@ export declare function createVectorMigration(opts: {
     isActive: () => boolean;
     /** Rows per batch; the engine's `DEFAULT_VECTOR_MIGRATION_BATCH` when omitted. */
     batchSize?: number;
-}): VectorMigrationHandle;
+}): Promise<VectorMigrationHandle>;
 //# sourceMappingURL=vectorMigration.d.ts.map

package/lib/types/vectorMigration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vectorMigration.d.ts","sourceRoot":"","sources":["../../src/vectorMigration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAExD,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAA;IACb,wFAAwF;IACxF,IAAI,IAAI,IAAI,CAAA;IACZ,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,EAAE,EAAE,aAAa,CAAA;IACjB,MAAM,EAAE,YAAY,CAAA;IACpB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,OAAO,CAAA;IACvB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,qBAAqB,CAiCxB"}
+{"version":3,"file":"vectorMigration.d.ts","sourceRoot":"","sources":["../../src/vectorMigration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAExD,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAA;IACb,wFAAwF;IACxF,IAAI,IAAI,IAAI,CAAA;IACZ,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,EAAE,EAAE,aAAa,CAAA;IACjB,MAAM,EAAE,YAAY,CAAA;IACpB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,OAAO,CAAA;IACvB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAiCjC"}