@avantf/dsh-mem 0.3.1 → 0.4.0

package/lib/interface-version.json

@@ -1,4 +1,4 @@
 {
-  "baseVersion": "0.3.1",
-  "interfaceVersion": 1
+  "baseVersion": "0.4.0",
+  "interfaceVersion": 3
 }

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

@@ -7,11 +7,12 @@
  * `restricted` mirrors "the allowlist is non-empty" — then the control is a closed `<select>` and
  * a new domain is a config change, not a second spelling of an existing one. An explicitly empty
  * allowlist means no restriction, so the control stays a free input.
+ *
+ * `DomainCatalog` itself is the CONTRACT's type (type-only import, erased from the bundle): the
+ * host store's `domainCatalog()` return and this picker name the same declaration, so the shape
+ * cannot be copied wrong on one half.
  */
-export interface DomainCatalog {
-    domains: string[];
-    restricted: boolean;
-}
+import type { DomainCatalog } from '../../engine/mem-contract/index.js';
 /** One `<option>`: `value` is what the form sends, `label` is what the user reads. */
 export interface DomainOption {
     value: string;

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

@@ -1 +1 @@
-{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../../src/client/domains.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,sFAAsF;AACtF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAG/F;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,QAAQ,GAAG,OAAO,CAElF;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjC,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,CAOvF"}
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../../src/client/domains.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD,sFAAsF;AACtF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAG/F;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,QAAQ,GAAG,OAAO,CAElF;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjC,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,CAOvF"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAoGA,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;AAm7CD,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":"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;AA8gDD,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"}

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

@@ -10,7 +10,7 @@
  * The confirm text is capped at 8 documents: a directory import that collides with the whole
  * library must produce a readable question, not a wall. The counts say what the rest are.
  */
-import type { KbConflictReport } from '@avantf/mem-contract';
+import type { KbConflictReport } from '../../engine/mem-contract/index.js';
 /**
  * The host's collision report, or `null` for any other payload.
  *

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

@@ -0,0 +1,36 @@
+/**
+ * The version-skew note for a host's reported revision, or `undefined` when the two halves agree.
+ *
+ * A NOTE, not a throw: an unrecognized revision usually still carries the fields the panels render,
+ * and blanking them is exactly the degradation the marker exists to avoid. `hostWire` is read off
+ * the DECODED envelope (`unwrapRemoteEnvelope`), so `undefined` means "an older host that predates
+ * the marker", never a decode failure.
+ */
+export declare function hostSkew(hostWire: unknown): string | undefined;
+/**
+ * Whether a host reporting `hostWire` can have registered a method introduced at `required`.
+ *
+ * `undefined` is "no revision observed yet", and is reported as NOT supported by this predicate —
+ * the caller decides whether "unknown" means "refuse" (see the gate in `client/index.ts`, which only
+ * refuses when it has actually SEEN an older revision).
+ */
+export declare function hostSupports(hostWire: number | undefined, required: number): boolean;
+/**
+ * The sentence for a call this client refuses to SEND because the host's REPORTED revision predates
+ * the method.
+ *
+ * The call is never sent, so this must not read as a transport failure: the host's own revision says
+ * the method does not exist, and the remedy (restart dsh web) is specific. Only called with a known
+ * revision — an unobserved one is sent and diagnosed by {@link transportHint} instead.
+ */
+export declare function staleHostText(hostWire: number, required: number, what: string): string;
+/**
+ * Name a transport failure that is really a VERSION SKEW.
+ *
+ * A gateway answers a method the host never published with an HTTP 404, which reads exactly like
+ * "the record or the file is gone". The sentence therefore names the missing REGISTRATION (an older
+ * host, or one never restarted) rather than only repeating the transport text; anything that is not
+ * a 404 is returned verbatim, because then the transport's own words are the useful ones.
+ */
+export declare function transportHint(cause: unknown): string;
+//# sourceMappingURL=wire.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../../src/client/wire.ts"],"names":[],"mappings":"AAkBA;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAQ9D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpF;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtF;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKpD"}

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.3.1";
+export declare const VERSION = "0.4.0";
 /**
  * The framework interval this bootstrap can launch.
  *
@@ -13,7 +13,8 @@ export declare const VERSION = "0.3.1";
  * compatibility promise — `>=0.3.0 <1.0.0` admits every 0.x base this generation of plugins can
  * consume, and stops at the major that invented a new interface generation. The interface itself is
  * the separate, runtime axis: a base inside this interval whose `INTERFACE_VERSION` differs is judged
- * by the base's own gate (INTERFACE.md §1, §3), which degrades rather than refusing.
+ * by the base's own gate (INTERFACE.md §1, §3) — an OLDER base degrades, a NEWER one is `ok` + a
+ * warning (generations are additive), and neither ever refuses the mount.
  */
 export declare const supportedRange = ">=0.3.0 <1.0.0";
 /** Sink for the warnings that replace a throw. */

package/lib/types/envinit.d.ts

@@ -8,25 +8,8 @@ type EnvinitModule = typeof import('@avantf/dsh-plugin-base');
  */
 export declare const PANDOC_ITEM = "mem:pandoc";
 export declare const MODEL_ITEM = "mem:model";
-/**
- * The default ONNX embedding repository — the one `semantic.local_model` defaults to and the one
- * {@link MODEL_FILES} describes. A DIFFERENT repo is a different file set, which is why the item
- * omits `spec.files` for it (see {@link managedModelSpec}).
- */
-export declare const DEFAULT_MODEL_REPO = "Xenova/bge-small-zh-v1.5";
-/**
- * The files the local embedding runtime actually requests for the DEFAULT ONNX model.
- *
- * Measured, not guessed: with an empty cache, `@huggingface/transformers@4.x` resolving
- * `feature-extraction` for `Xenova/bge-small-zh-v1.5` fetches exactly these four — `config.json`,
- * `tokenizer.json`, `tokenizer_config.json` and the fp32 `onnx/model.onnx`. The repo ALSO carries
- * `special_tokens_map.json`, `vocab.txt` and seven other ONNX quantisations the default run never
- * opens; declaring them would download hundreds of megabytes of dead weight. The list stays narrow
- * to what is read.
- */
-export declare const MODEL_FILES: readonly string[];
 /** The logging surface this module needs — `AvantfLogger` satisfies it. */
-export interface EnvinitLogger {
+interface EnvinitLogger {
     info(message: string): void;
     warn(message: string): void;
     error(message: string): void;
@@ -118,7 +101,7 @@ export interface EnvinitRuntime {
     dispose(): void;
 }
 /** Options for {@link loadEnvinit}. */
-export interface EnvinitLoadOptions {
+interface EnvinitLoadOptions {
     readonly log?: EnvinitLogger;
     /** The family root; default `$AVANTF_HOME`, else `~/.avantf/env` (framework DESIGN §6.3). */
     readonly home?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"envinit.d.ts","sourceRoot":"","sources":["../../src/envinit.ts"],"names":[],"mappings":"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"}
+{"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;AAiDrC,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;;;;;;;;;;;;;;;;GAgBG;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;AA6HD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAkBvG"}

package/lib/types/hints.d.ts

@@ -1,4 +1,4 @@
-import type { RelevanceHit } from '@avantf/mem';
+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).

package/lib/types/index.d.ts

@@ -16,12 +16,12 @@
 import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
-import { type AvantfRuntime, type KnowledgeStore, type MemoryStore, type StoreResult } from '@avantf/mem';
-import { type BrowseListing, type RecallResult, type RemoteEnvelope, type SourceClassification } from '@avantf/mem-contract';
-import { type OpenOutcome } from './open.js';
+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';
 export declare const name = "avantf-mem";
 export { inject } from './inject.js';
 export { KNOWLEDGE_PROMPT_SECTION, MEMORY_PROMPT_SECTION } from './prompt.js';
+export { registerSemanticBackend, registerReranker, registerVectorStore, type Reranker, type SemanticBackend, type VectorStore, } from '../engine/mem/index.js';
 export interface Config {
     mode?: 'cordis' | 'mcp';
     dataHome?: string;
@@ -33,6 +33,11 @@ type WireArgs = Record<string, unknown>;
  * 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.
+ *
+ * Every envelope — success and failure, tool-backed and UI-only — is built through `wireOk`/`wireErr`
+ * so it carries this build's `WIRE_VERSION`. That is what lets a freshly reloaded browser half tell
+ * whether the host process predates a method it is about to call, instead of reading the gateway's
+ * 404 as "the record is gone" (see `remote.ts`).
  */
 export declare class AvantfMemGateway extends TypertRemoteService {
     private readonly rt;

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;AAQlD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,OAAO,EAAE,mBAAmB,EAAU,MAAM,kCAAkC,CAAA;AAE9E,OAAO,EAOL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,EAEhB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAcL,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,cAAc,EAEnB,KAAK,oBAAoB,EAG1B,MAAM,sBAAsB,CAAA;AAc7B,OAAO,EAAoB,KAAK,WAAW,EAAmB,MAAM,WAAW,CAAA;AAI/E,eAAO,MAAM,IAAI,eAAe,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAE7E,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;AAkDF,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAOvC;;;;;GAKG;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;AAiID,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiWvE"}
+{"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;AAExC,OAAO,EAAE,mBAAmB,EAAU,MAAM,kCAAkC,CAAA;AAE9E,OAAO,EAQL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,EAEhB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAeL,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,KAAK,YAAY,EACjB,KAAK,cAAc,EAEnB,KAAK,oBAAoB,EAG1B,MAAM,sBAAsB,CAAA;AAoB7B,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,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,QAAQ,EACb,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;AA6CF,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAOvC;;;;;;;;;;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;AAiID,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4WvE"}

package/lib/types/open.d.ts

@@ -1,12 +1,4 @@
-/** Which of the two things a document row can open. */
-export type OpenTarget = 'file' | 'dir';
-/** What was launched, for the UI's status line. */
-export interface OpenOutcome {
-    path: string;
-    target: OpenTarget;
-    /** The command that was actually used (`code`, `explorer.exe`, …). */
-    opener: string;
-}
+import type { OpenOutcome, OpenTarget } from '../engine/mem-contract/index.js';
 /**
  * The file names one command can have on PATH.
  *
@@ -14,14 +6,72 @@ export interface OpenOutcome {
  * bare name silently loses the editor and falls back to the OS default application. `PATHEXT` is
  * what the shell itself uses; the default list is the fallback when it is not exported.
  */
-export declare function commandFileNames(command: string, platform?: NodeJS.Platform): string[];
+export declare function commandFileNames(command: string, platform?: NodeJS.Platform, pathext?: string | undefined): string[];
+/**
+ * The file name of `command` that actually exists on `env.PATH`, or `undefined`.
+ *
+ * Returning the NAME (not a boolean) is what lets the launcher see `code.cmd` and know it holds a
+ * batch shim. `[win]` — the win32 form is asserted from Linux with an injected platform/env.
+ */
+export declare function resolveOnPath(command: string, platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv): string | undefined;
+/** True for a Windows batch shim — the one shape Node will not spawn without a shell. */
+export declare function isWindowsBatchShim(command: string, platform?: NodeJS.Platform): boolean;
+/** Why a launch failed: the editor is not here (fall through) or the launch was refused (report). */
+type LaunchFailure = 'missing' | 'refused';
+/**
+ * Classify a synchronous spawn failure.
+ *
+ * `ENOENT` means the command is not there after all — the documented priority order just moves on,
+ * with no warning. Everything else (the `EINVAL` a `.cmd` gets without a shell, `EACCES`, a bad
+ * argument) is a wiring defect, and swallowing it is exactly how "open in VS Code" disappeared.
+ */
+export declare function classifyLaunchFailure(error: unknown): LaunchFailure;
+/** The options the launch hands to `spawn`. */
+export interface LaunchOptions {
+    detached: boolean;
+    stdio: 'ignore';
+    /** Required on Windows for a `.cmd`/`.bat` shim (CVE-2024-27980 forbids a shell-less spawn). */
+    shell?: boolean;
+}
+/** What to hand to `spawn` for one candidate. */
+interface LaunchPlan {
+    command: string;
+    args: string[];
+    options: LaunchOptions;
+}
+/** The slice of `child_process.spawn` this module uses — narrow so a test can inject a fake. */
+export type SpawnLike = (command: string, args: string[], options: LaunchOptions) => {
+    unref: () => void;
+};
+/**
+ * The concrete spawn shape for one candidate on `platform`.
+ *
+ * TWO Windows-only rules, both from the same root cause (CVE-2024-27980): a `.cmd`/`.bat` shim is
+ * spawned through `shell: true`; and the last-resort fallback is `cmd /c start`, whose quoted path
+ * must follow its own title argument or cmd treats the path AS the title. The plan is pure and
+ * takes the platform, so the win32 shapes are asserted on Linux (`[win]`, real-machine re-check
+ * still owed).
+ */
+export declare function launchPlan(command: string, arg: string, platform?: NodeJS.Platform): LaunchPlan;
+/** Where a refused launch is reported; injectable so both failure paths are assertable. */
+type WarnSink = (message: string) => void;
+/** Host facts and side effects a caller (or a test) may replace. */
+interface OpenDeps {
+    platform?: NodeJS.Platform;
+    env?: NodeJS.ProcessEnv;
+    spawn?: SpawnLike;
+    /** Defaults to `console.warn` (stderr): a refused launch must leave a trace. */
+    warn?: WarnSink;
+}
 /**
  * Launch the configured/detected tool on one document path.
  *
  * @param documentPath - the managed `.md` path.
  * @param target - `file` opens the document, `dir` opens the directory that holds it.
  * @param configured - `knowledge.open.editor` from config (empty ⇒ auto-detect).
+ * @param deps - platform / env / spawn / warning sink, for tests.
  * @throws when no candidate is available or every one of them fails to start.
  */
-export declare function openDocumentPath(documentPath: string, target: OpenTarget, configured: string): OpenOutcome;
+export declare function openDocumentPath(documentPath: string, target: OpenTarget, configured: string, deps?: OpenDeps): OpenOutcome;
+export {};
 //# sourceMappingURL=open.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../src/open.ts"],"names":[],"mappings":"AAuBA,uDAAuD;AACvD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,CAAA;AAEvC,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;IAClB,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,MAAM,EAAE,CAIxG;AA+DD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CA0B1G"}
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../src/open.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEnE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,OAAO,GAAE,MAAM,GAAG,SAAkC,GACnD,MAAM,EAAE,CAIV;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,SAAS,CAepB;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,OAAO,CAEzG;AAED,qGAAqG;AACrG,KAAK,aAAa,GAAG,SAAS,GAAG,SAAS,CAAA;AAE1C;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAEnE;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAA;IACjB,KAAK,EAAE,QAAQ,CAAA;IACf,gGAAgG;IAChG,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,iDAAiD;AACjD,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,EAAE,aAAa,CAAA;CACvB;AAED,gGAAgG;AAChG,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,KAAK;IAAE,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAAA;AAgB1G;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,UAAU,CAajH;AAgED,2FAA2F;AAC3F,KAAK,QAAQ,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;AAEzC,oEAAoE;AACpE,UAAU,QAAQ;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,gFAAgF;IAChF,IAAI,CAAC,EAAE,QAAQ,CAAA;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,QAAa,GAClB,WAAW,CAiDb"}

package/lib/types/prompt.d.ts

@@ -69,6 +69,19 @@ export declare const KB_EDIT_PROMPT_SECTION: {
     readonly order: 3020;
     readonly text: string;
 };
+/**
+ * This plugin's file-name prefix inside the SHARED family prompt directory — the `mem` in
+ * `mem-*.md`.
+ *
+ * It is handed to the base's `PromptFiles` as its `namespace` (interface v3), which then REFUSES to
+ * read or write any spec whose `file` is not `<namespace>-…` or is not a bare file name: the
+ * `mem-*` / `mission-*` split used to be a convention with no machine check, so a mistyped prefix
+ * could silently read or overwrite another plugin's user-edited file. The value is the SAME token
+ * {@link PROMPT_FILES} names its files with — one source for both, so the two cannot drift — and it
+ * is OPTIONAL at the base: a caller that omits it (or a base older than v3) gets the pre-v3
+ * behaviour, which is why passing it never degrades a mount.
+ */
+export declare const PROMPT_NAMESPACE = "mem";
 /** One section and the file its text may be edited in; the file name is the loader's handle. */
 export interface PromptFileEntry {
     readonly file: string;
@@ -82,10 +95,15 @@ export interface PromptFileEntry {
  * directory (`<data_home>/prompts`, see {@link PromptFiles}).
  *
  * Every avantf plugin writes its prompts into that one directory and owns a prefix — `mem-*` here,
- * `work-*` in the work engine — so a deployment can find and diff all of its model-facing text in
+ * `mission-*` in the mission engine — so a deployment can find and diff all of its model-facing text in
  * one place without any plugin having to guess which files belong to it. This manifest is that
  * ownership: a `.md` it does not list is ignored (never read, never written, never deleted).
  *
+ * Since interface v3 the prefix is machine-checked, not a convention: every `file` below is a bare
+ * name starting with `mem-`, and the loader is built with `namespace: 'mem'`
+ * ({@link PROMPT_NAMESPACE}), so the base refuses — with a warning, without touching disk — any spec
+ * that names a file outside this plugin's prefix.
+ *
  * The FILE owns the text; the CODE keeps the identity. Mapping a file name to a section HERE is what
  * makes that true: no edit to the directory can move a section to a different point in the prompt
  * (order) or change the name the harness dedupes on — and no file another plugin owns can be

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,qBAAqB;;;;CAOA,CAAA;AAElC;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;CAOH,CAAA;AAElC;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB;;;;CAMD,CAAA;AAElC,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;;;;;;;;;;;;;;;;GAgBG;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,qBAAqB;;;;CAWA,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"}

package/lib/types/provision.d.ts

@@ -63,7 +63,7 @@ export interface CompatRuntime {
     readonly schemaNames: readonly string[];
 }
 /** The gate's outcome. */
-export interface CompatRun {
+interface CompatRun {
     /** The verdict `apply` branches on. Plain data — the engine's provisioning guard reads it too. */
     readonly verdict: CompatVerdict;
 }

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,MAAM,WAAW,SAAS;IACxB,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;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,aAAa,EACrB,IAAI,GAAE,UAAwB,GAC7B,SAAS,CAqBX;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,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;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,aAAa,EACrB,IAAI,GAAE,UAAwB,GAC7B,SAAS,CAqBX;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/reconcile.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Corpus reconciliation: the throttled "did anything under `knowledge.docs.dir` change?" sweep behind
+ * `tools/result`.
+ *
+ * WHY IT IS ITS OWN MODULE. The plugin reaches the corpus through tool calls, so a finished tool call
+ * is the moment to ask the question — and the answer is cheap (`corpusDrift()` is one `stat` per
+ * document, reading nothing), which is what makes it affordable after EVERY tool result. Two things
+ * about it are easy to get wrong and are pinned by `test/reconcile.spec.ts` instead of by a mounted
+ * plugin: the THROTTLE (with a trailing run — skipping alone would drop the LAST edit, the one that
+ * matters) and the STOP rule (an in-flight pass must not keep writing after the plugin unmounted and
+ * its databases closed). `index.ts` is the assembly hub; this is the rule.
+ *
+ * @module @avantf/dsh-mem/reconcile
+ */
+/** The corpus surface a reconciler drives — structural, so a test can hand it a fake. */
+interface ReconcileCorpus {
+    /** Re-ingest changed documents; `{}` is the full sweep that also reports corpus-level changes. */
+    sync(options: {
+        docId?: number;
+    }): Promise<unknown>;
+    /**
+     * One `stat` per document; no file is read. ASYNC because it is a per-document walk that yields
+     * the event loop every batch (see `KnowledgeStore.corpusDrift`), so it is another `await`
+     * boundary at which `stop()` is honoured.
+     */
+    corpusDrift(): Promise<{
+        changed: number[];
+        missing: number[];
+        fileSetChanged: boolean;
+    }>;
+}
+/** What {@link createCorpusReconciler} needs from its caller. */
+export interface ReconcileDeps {
+    corpus: ReconcileCorpus;
+    /** Minimum spacing between non-full checks (ms). */
+    minIntervalMs: number;
+    /** Called for a failed pass. The reconciler NEVER rethrows: a sync failure must not break the host. */
+    onError(error: unknown): void;
+    /** Clock seam (defaults to `Date.now`). */
+    now?(): number;
+    /** Timer seam (defaults to the global `setTimeout`); the handle is `unref`ed when it supports it. */
+    schedule?(fn: () => void, ms: number): ReturnType<typeof setTimeout>;
+    /** Timer-cancellation seam (defaults to the global `clearTimeout`). */
+    cancel?(handle: ReturnType<typeof setTimeout>): void;
+}
+/** The handle `index.ts` wires into an effect: request a check, and stop it on unmount. */
+interface CorpusReconciler {
+    /** Run one check — `full` bypasses the throttle and takes the baseline after the sweep. */
+    request(full: boolean): Promise<void>;
+    /**
+     * Stop permanently: no further pass starts, a scheduled trailing check is cancelled, and a pass
+     * already in flight exits at its next `await` boundary without touching the corpus again.
+     */
+    stop(): void;
+    /** Whether a pass is currently in flight (diagnostics and the unmount test). */
+    readonly running: boolean;
+}
+/**
+ * Build the reconciler. All state is closed over here, so a fresh mount gets a fresh one — the
+ * plugin can be unmounted and mounted again in one process.
+ */
+export declare function createCorpusReconciler(deps: ReconcileDeps): CorpusReconciler;
+export {};
+//# sourceMappingURL=reconcile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/reconcile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,yFAAyF;AACzF,UAAU,eAAe;IACvB,kGAAkG;IAClG,IAAI,CAAC,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACnD;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAC1F;AAED,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,eAAe,CAAA;IACvB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAA;IACrB,uGAAuG;IACvG,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IAC7B,2CAA2C;IAC3C,GAAG,CAAC,IAAI,MAAM,CAAA;IACd,qGAAqG;IACrG,QAAQ,CAAC,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAA;IACpE,uEAAuE;IACvE,MAAM,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAA;CACrD;AAED,2FAA2F;AAC3F,UAAU,gBAAgB;IACxB,2FAA2F;IAC3F,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC;;;OAGG;IACH,IAAI,IAAI,IAAI,CAAA;IACZ,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,gBAAgB,CA8E5E"}

package/lib/types/remote.d.ts

@@ -1,8 +1,61 @@
 import type { InvocationDescriptor, TypertRemoteContribution } from '@deepseek-ai/dsh-typert-protocol';
 import type { TypertContribution } from '@deepseek-ai/dsh-typert-registry/types';
+import type { RemoteErr, RemoteOk } from '../engine/mem-contract/index.js';
 export declare const descriptors: readonly InvocationDescriptor[];
 /** Client face: mounted by the client half through `ctx.remote.$mount()`. */
 export declare const clientContribution: TypertRemoteContribution;
+/**
+ * The revision of the Remote FACE `descriptors` publishes.
+ *
+ * WHY THIS EXISTS. The two halves of this plugin do not update together: the browser bundle is
+ * re-read on every page load, the host half only when `dsh web` starts. So a rebuilt client
+ * routinely talks to a host process loaded before a method existed, and the gateway answers an
+ * unpublished method with an HTTP 404 — which reads exactly like "the record or the file is gone",
+ * the two things it does NOT mean. Mission paid this tuition with a measured 404
+ * (`SNAPSHOT_WIRE_VERSION`); mem has the same skew with no marker at all. The host now stamps this
+ * number onto every application envelope (see `wireOk`/`wireErr`), and the client half reads it back
+ * (contract's `unwrapRemoteEnvelope`) so it can refuse to SEND a call the host cannot have, and say
+ * "restart dsh web" instead of surfacing a bare 404.
+ *
+ * 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
+ * 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
+ * face publishes, not the shape of one payload. Do NOT bump for a new optional FIELD: a
+ * `.default(...)`-carrying schema (and the `acceptsUndefined` parameters) already absorb that across
+ * the gap. When you add a method, also declare `export const <NAME>_WIRE_VERSION = <new value>`
+ * beside this constant and gate the client call on it (`client/wire.ts` `hostSupports` /
+ * `staleHostText`), exactly as mission's `EXECUTOR_LOOKUP_WIRE_VERSION` does.
+ *
+ * ABSENT MEANS OLD. An old host sends no `wire` at all; the client must treat that as "older than the
+ * 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.
+ */
+export declare const WIRE_VERSION = 1;
+/**
+ * The successful application envelope, with the wire revision stamped on.
+ *
+ * A helper rather than a literal at each return site (the shared `call` covers the five tool-backed
+ * methods; the five UI-only methods return directly): "every answer carries the marker" is then a
+ * property of the code, not of six copies staying in step. The result is structurally the contract's
+ * `RemoteOk`.
+ */
+export declare function wireOk<T>(value: T): RemoteOk<T>;
+/**
+ * The failed application envelope, with the wire revision stamped on.
+ *
+ * Takes the failure body already built (`{ok:false, error}` / validation's `{ok:false,error,violations}`)
+ * so the message and violations keep coming from their existing single sources.
+ */
+export declare function wireErr(failure: Omit<RemoteErr, 'wire'>): RemoteErr;
 /**
  * Host face: registered by the host half through `ctx.typert.register()`.
  *

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;AA6EhF,eAAO,MAAM,WAAW,EAAE,SAAS,oBAAoB,EAqGtD,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,EAAE,wBAGhC,CAAA;AA8BD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBA0C9B,CAAA"}
+{"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,EA2GtD,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,EAAE,wBAGhC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;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;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBA0C9B,CAAA"}

package/lib/types/render.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The ONE model-facing output boundary of the eight mem tools (`TOOL_SPECS`; `kb_manage` is
+ * `KB_TOOL`, the internal engine API the UI/CLI dispatch through, and is not part of the model
+ * surface).
+ *
+ * `output.render` is what the DSH tool runner calls to turn a result value into the text block the
+ * model reads, so this is the last code of ours the payload passes through before `JSON.stringify`.
+ * The recursion is there because the value can contain data this process did not just write: a row
+ * from a database an older build (or a different driver) filled, or a string derived by the
+ * tokenizer. `JSON.stringify` emits a lone surrogate as the escape `"\ud800"`, which JavaScript
+ * parses back but a strict parser rejects — repairing every string first means the text block is
+ * always strictly parseable, whatever the payload's provenance.
+ *
+ * The repair itself is NOT this module's: `toWellFormedDeep` resolves to the loaded base kit's
+ * implementation when the mount adopted it, and to `@avantf/mem-contract`'s mirror otherwise (see
+ * that module's note and `index.ts`'s `adoptWellFormed` call).
+ *
+ * Extracted from `index.ts` so the boundary is testable without the DSH harness: this module only
+ * type-imports the peer type, which is erased at transpile (see `vitest.config.ts`).
+ *
+ * @module plugin/render
+ */
+import type { JsonValue } from '@deepseek-ai/dsh-util-values';
+/** The tool output spec registered on every mem tool. */
+export declare const OUTPUT: {
+    readonly schema: {
+        readonly type: "object";
+        readonly additionalProperties: true;
+    };
+    readonly render: (_args: unknown, value: JsonValue) => {
+        type: "text";
+        text: string;
+    }[];
+};
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAG7D,yDAAyD;AACzD,eAAO,MAAM,MAAM;;;;;6BAED,OAAO,SAAS,SAAS,KAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;CAGpE,CAAA"}

package/lib/types/tool_schema.d.ts

@@ -1,25 +1,14 @@
-import { type ToolSpec } from '@avantf/mem-contract';
-export type ParamSpec = {
+import { type ToolSpec } from '../engine/mem-contract/index.js';
+type ParamSpec = {
     type: 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object';
     description?: string;
     required?: true;
     enum?: readonly string[];
     items?: ParamSpec;
 };
-/** The slice of zod v4's `def` this derivation reads (structure only, never type tags). */
-export interface ZodDef {
-    type?: string;
-    shape?: Record<string, unknown>;
-    options?: unknown[];
-    /** A literal's / enum's values; v4 keeps them in an array. */
-    values?: unknown;
-}
-export declare function zodDef(schema: unknown): ZodDef;
 /** Nearest `description` on a schema (wrappers included — the converter already unwrapped them). */
 export declare function schemaDescription(schema: unknown): string | undefined;
 export declare function zodToSpec(schema: unknown): ParamSpec;
-/** Materialize one zod object branch's fields, or undefined for a non-object. */
-export declare function branchShape(schema: unknown): Record<string, unknown> | undefined;
 /**
  * Flatten a tool input schema into DSH's implicit parameter map. A discriminated
  * union contributes one required `action` enum plus the merged field set (fields
@@ -37,4 +26,5 @@ export declare function branchShape(schema: unknown): Record<string, unknown> |
  * descriptions, which is what keeps them in agreement field for field.
  */
 export declare function flattenToolSpec(spec: ToolSpec): Record<string, ParamSpec>;
+export {};
 //# sourceMappingURL=tool_schema.d.ts.map

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,MAAM,MAAM,SAAS,GAAG;IACtB,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;AAED,2FAA2F;AAC3F,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACnB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAE9C;AAkBD,oGAAoG;AACpG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGrE;AAqBD,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAEpD;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAEhF;AAED;;;;;;;;;;;;;;;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;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"}