@json-layout/core 2.8.2 → 2.9.0

package/types/webmcp/tools/edit-array.d.ts

@@ -6,20 +6,26 @@ export function getDescription(dataTitle: string): string;
 /**
  * @param {import('../../state/index.js').StatefulLayout} statefulLayout
  * @param {{ path: string, action: 'add'|'remove', index?: number, value?: unknown }} args
- * @returns {{ valid: boolean, itemCount: number, errors: Array<{path: string, message: string}> }}
+ * @param {import('../variants-memo.js').VariantsMemo} [variantsMemo] - a new item of a
+ * recursive schema carries the same union as the item that contains it; the memo keeps the
+ * response from printing it again
+ * @returns {{ valid: boolean, itemCount: number, index: number, itemMarkdown?: string, errors: Array<{path: string, message: string}>, otherErrors: number }}
  */
 export function execute(statefulLayout: import("../../state/index.js").StatefulLayout, args: {
     path: string;
     action: "add" | "remove";
     index?: number;
     value?: unknown;
-}): {
+}, variantsMemo?: import("../variants-memo.js").VariantsMemo): {
     valid: boolean;
     itemCount: number;
+    index: number;
+    itemMarkdown?: string;
     errors: Array<{
         path: string;
         message: string;
     }>;
+    otherErrors: number;
 };
 export namespace inputSchema {
     let type: string;
@@ -50,39 +56,4 @@ export namespace inputSchema {
     }
     let required: string[];
 }
-export namespace outputSchema {
-    let type_4: string;
-    export { type_4 as type };
-    export namespace properties_1 {
-        namespace valid {
-            let type_5: string;
-            export { type_5 as type };
-        }
-        namespace itemCount {
-            let type_6: string;
-            export { type_6 as type };
-        }
-        namespace errors {
-            let type_7: string;
-            export { type_7 as type };
-            export namespace items {
-                let type_8: string;
-                export { type_8 as type };
-                export namespace properties_2 {
-                    export namespace path_1 {
-                        let type_9: string;
-                        export { type_9 as type };
-                    }
-                    export { path_1 as path };
-                    export namespace message {
-                        let type_10: string;
-                        export { type_10 as type };
-                    }
-                }
-                export { properties_2 as properties };
-            }
-        }
-    }
-    export { properties_1 as properties };
-}
 //# sourceMappingURL=edit-array.d.ts.map

package/types/webmcp/tools/edit-array.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edit-array.d.ts","sourceRoot":"","sources":["../../../src/webmcp/tools/edit-array.js"],"names":[],"mappings":"AAgDA;;;GAGG;AACH,0CAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;;;GAIG;AACH,wCAJW,OAAO,sBAAsB,EAAE,cAAc,QAC7C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,GAAC,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACvE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;CAAE,CAqCjG"}
+{"version":3,"file":"edit-array.d.ts","sourceRoot":"","sources":["../../../src/webmcp/tools/edit-array.js"],"names":[],"mappings":"AA8BA;;;GAGG;AACH,0CAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;;;;;;GAOG;AACH,wCAPW,OAAO,sBAAsB,EAAE,cAAc,QAC7C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,GAAC,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,iBACzE,OAAO,qBAAqB,EAAE,YAAY,GAGxC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CA2E5J"}

package/types/webmcp/tools/fill-form-skill.d.ts

@@ -1,24 +1,21 @@
+/**
+ * @file fillFormSkill tool
+ */
 /**
  * @param {string} dataTitle
  * @returns {string}
  */
 export function getDescription(dataTitle: string): string;
 /**
- * Generate skill content with dataTitle injected
+ * The one path. There used to be three, chosen by counting normalized layouts and calling
+ * the result small, medium or large — a threshold nobody could justify, measuring the
+ * schema when the question was about data, and duplicated between here and index.js. Four
+ * commits in a row went to fixing contradictions between those branches, and across four
+ * recorded baselines the small and medium advice was never taken on a real form: setData
+ * was used zero times and getSchema once.
  * @param {string} dataTitle
  * @param {string} prefixName
- * @param {boolean} hasSchema
- * @param {import('../../state/index.js').StatefulLayout} statefulLayout
  * @returns {string}
  */
-export function generateSkill(dataTitle: string, prefixName: string, hasSchema: boolean, statefulLayout: import("../../state/index.js").StatefulLayout): string;
-export namespace outputSchema {
-    let type: string;
-    namespace properties {
-        namespace content {
-            let type_1: string;
-            export { type_1 as type };
-        }
-    }
-}
+export function generateSkill(dataTitle: string, prefixName: string): string;
 //# sourceMappingURL=fill-form-skill.d.ts.map

package/types/webmcp/tools/fill-form-skill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fill-form-skill.d.ts","sourceRoot":"","sources":["../../../src/webmcp/tools/fill-form-skill.js"],"names":[],"mappings":"AAWA;;;GAGG;AACH,0CAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;;;;;;GAOG;AACH,yCANW,MAAM,cACN,MAAM,aACN,OAAO,kBACP,OAAO,sBAAsB,EAAE,cAAc,GAC3C,MAAM,CAyClB"}
+{"version":3,"file":"fill-form-skill.d.ts","sourceRoot":"","sources":["../../../src/webmcp/tools/fill-form-skill.js"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,0CAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;;;;;;;;;GAUG;AACH,yCAJW,MAAM,cACN,MAAM,GACJ,MAAM,CAqBlB"}

package/types/webmcp/tools/get-data.d.ts

@@ -4,28 +4,30 @@
  */
 export function getDescription(dataTitle: string): string;
 /**
+ * Read the data, whole or at a path. Whatever it returns is the real value: an agent may
+ * forward it to an API, so nothing here is ever abbreviated. `path` exists so that
+ * wanting one field is not a reason to pull a document that can run to tens of kilobytes.
  * @param {import('../../state/index.js').StatefulLayout} statefulLayout
- * @param {{}} _args
- * @returns {{ data: unknown, valid: boolean }}
+ * @param {{ path?: string }} args
+ * @returns {{ data?: unknown, unset?: boolean, valid: boolean }}
  */
-export function execute(statefulLayout: import("../../state/index.js").StatefulLayout, _args: {}): {
-    data: unknown;
+export function execute(statefulLayout: import("../../state/index.js").StatefulLayout, args: {
+    path?: string;
+}): {
+    data?: unknown;
+    unset?: boolean;
     valid: boolean;
 };
+/** Most field paths named in a refusal before the rest are counted instead. */
+export const NAMED_FIELDS_MAX: 12;
 export namespace inputSchema {
     let type: string;
-    let properties: {};
-}
-export namespace outputSchema {
-    let type_1: string;
-    export { type_1 as type };
-    export namespace properties_1 {
-        let data: {};
-        namespace valid {
-            let type_2: string;
-            export { type_2 as type };
+    namespace properties {
+        namespace path {
+            let type_1: string;
+            export { type_1 as type };
+            export let description: string;
         }
     }
-    export { properties_1 as properties };
 }
 //# sourceMappingURL=get-data.d.ts.map

package/types/webmcp/tools/get-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-data.d.ts","sourceRoot":"","sources":["../../../src/webmcp/tools/get-data.js"],"names":[],"mappings":"AAiBA;;;GAGG;AACH,0CAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;;;GAIG;AACH,wCAJW,OAAO,sBAAsB,EAAE,cAAc,SAC7C,EAAE,GACA;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAO7C"}
+{"version":3,"file":"get-data.d.ts","sourceRoot":"","sources":["../../../src/webmcp/tools/get-data.js"],"names":[],"mappings":"AAwCA;;;GAGG;AACH,0CAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;;;;;;GAOG;AACH,wCAJW,OAAO,sBAAsB,EAAE,cAAc,QAC7C;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACf;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAkC/D;AAlFD,+EAA+E;AAC/E,+BAAgC,EAAE,CAAA"}

package/types/webmcp/tools/get-field-suggestions.d.ts

@@ -6,17 +6,19 @@ export function getDescription(dataTitle: string): string;
 /**
  * @param {import('../../state/index.js').StatefulLayout} statefulLayout
  * @param {{ path: string, query?: string }} args
- * @returns {Promise<{items: Array<{value: unknown, title: string, key?: string}>}>}
+ * @param {import('../suggestions-store.js').SuggestionsStore} [store] - memorizes the full items so that setFieldValue can apply one by index
+ * @returns {Promise<{items: Array<{value: unknown, title: string, key?: string}>, baseIndex: number}>}
  */
 export function execute(statefulLayout: import("../../state/index.js").StatefulLayout, args: {
     path: string;
     query?: string;
-}): Promise<{
+}, store?: import("../suggestions-store.js").SuggestionsStore): Promise<{
     items: Array<{
         value: unknown;
         title: string;
         key?: string;
     }>;
+    baseIndex: number;
 }>;
 export namespace inputSchema {
     let type: string;
@@ -35,32 +37,4 @@ export namespace inputSchema {
     }
     let required: string[];
 }
-export namespace outputSchema {
-    let type_3: string;
-    export { type_3 as type };
-    export namespace properties_1 {
-        namespace items {
-            let type_4: string;
-            export { type_4 as type };
-            export namespace items_1 {
-                let type_5: string;
-                export { type_5 as type };
-                export namespace properties_2 {
-                    let value: {};
-                    namespace title {
-                        let type_6: string;
-                        export { type_6 as type };
-                    }
-                    namespace key {
-                        let type_7: string;
-                        export { type_7 as type };
-                    }
-                }
-                export { properties_2 as properties };
-            }
-            export { items_1 as items };
-        }
-    }
-    export { properties_1 as properties };
-}
 //# sourceMappingURL=get-field-suggestions.d.ts.map

package/types/webmcp/tools/get-field-suggestions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-field-suggestions.d.ts","sourceRoot":"","sources":["../../../src/webmcp/tools/get-field-suggestions.js"],"names":[],"mappings":"AAsCA;;;GAGG;AACH,0CAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;;;GAIG;AACH,wCAJW,OAAO,sBAAsB,EAAE,cAAc,QAC7C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;CAAC,CAAC,CAkClF"}
+{"version":3,"file":"get-field-suggestions.d.ts","sourceRoot":"","sources":["../../../src/webmcp/tools/get-field-suggestions.js"],"names":[],"mappings":"AAqBA;;;GAGG;AACH,0CAHW,MAAM,GACJ,MAAM,CASlB;AAED;;;;;GAKG;AACH,wCALW,OAAO,sBAAsB,EAAE,cAAc,QAC7C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,UAChC,OAAO,yBAAyB,EAAE,gBAAgB,GAChD,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAC,CAAC,CAkCrG"}

package/types/webmcp/tools/set-data.d.ts

@@ -1,18 +1,25 @@
 /**
  * @param {string} dataTitle
- * @param {"small"|"medium"|"large"} [complexity]
  * @returns {string}
  */
-export function getDescription(dataTitle: string, complexity?: "small" | "medium" | "large"): string;
+export function getDescription(dataTitle: string): string;
 /**
  * @param {import('../../state/index.js').StatefulLayout} statefulLayout
- * @param {{ data: unknown }} args
- * @returns {{ valid: boolean, errors: Array<{path: string, message: string}> }}
+ * @param {{ data: unknown, merge?: boolean }} args
+ * @returns {{ valid: boolean, written: string[], removed: string[], unknownKeys: string[], visibility?: { revealed: string[], hidden: string[] }, errors: Array<{path: string, message: string}> }}
  */
 export function execute(statefulLayout: import("../../state/index.js").StatefulLayout, args: {
     data: unknown;
+    merge?: boolean;
 }): {
     valid: boolean;
+    written: string[];
+    removed: string[];
+    unknownKeys: string[];
+    visibility?: {
+        revealed: string[];
+        hidden: string[];
+    };
     errors: Array<{
         path: string;
         message: string;
@@ -24,37 +31,13 @@ export namespace inputSchema {
         namespace data {
             let description: string;
         }
-    }
-    let required: string[];
-}
-export namespace outputSchema {
-    let type_1: string;
-    export { type_1 as type };
-    export namespace properties_1 {
-        namespace valid {
-            let type_2: string;
-            export { type_2 as type };
-        }
-        namespace errors {
-            let type_3: string;
-            export { type_3 as type };
-            export namespace items {
-                let type_4: string;
-                export { type_4 as type };
-                export namespace properties_2 {
-                    namespace path {
-                        let type_5: string;
-                        export { type_5 as type };
-                    }
-                    namespace message {
-                        let type_6: string;
-                        export { type_6 as type };
-                    }
-                }
-                export { properties_2 as properties };
-            }
+        namespace merge {
+            let type_1: string;
+            export { type_1 as type };
+            let description_1: string;
+            export { description_1 as description };
         }
     }
-    export { properties_1 as properties };
+    let required: string[];
 }
 //# sourceMappingURL=set-data.d.ts.map

package/types/webmcp/tools/set-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set-data.d.ts","sourceRoot":"","sources":["../../../src/webmcp/tools/set-data.js"],"names":[],"mappings":"AAiCA;;;;GAIG;AACH,0CAJW,MAAM,eACN,OAAO,GAAC,QAAQ,GAAC,OAAO,GACtB,MAAM,CAOlB;AAED;;;;GAIG;AACH,wCAJW,OAAO,sBAAsB,EAAE,cAAc,QAC7C;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACf;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;CAAE,CAS9E"}
+{"version":3,"file":"set-data.d.ts","sourceRoot":"","sources":["../../../src/webmcp/tools/set-data.js"],"names":[],"mappings":"AAoBA;;;GAGG;AACH,0CAHW,MAAM,GACJ,MAAM,CAIlB;AA2BD;;;;GAIG;AACH,wCAJW,OAAO,sBAAsB,EAAE,cAAc,QAC7C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;CAAE,CAoDlM"}

package/types/webmcp/tools/set-field-value.d.ts

@@ -5,19 +5,29 @@
 export function getDescription(dataTitle: string): string;
 /**
  * @param {import('../../state/index.js').StatefulLayout} statefulLayout
- * @param {{ path: string, value: unknown }} args
- * @returns {{ valid: boolean, field: ReturnType<typeof projectFieldResult>, errors: Array<{path: string, message: string}> }}
+ * @param {{ path: string, value?: unknown, suggestionIndex?: number }} args
+ * @param {import('../suggestions-store.js').SuggestionsStore} [store]
+ * @param {import('../variants-memo.js').VariantsMemo} [variantsMemo] - the activated branch
+ * may nest the same union again; the memo keeps the response from printing it twice
+ * @returns {{ valid: boolean, field: ReturnType<typeof projectFieldResult>, errors: Array<{path: string, message: string}>, otherErrors: number, activatedMarkdown?: string, visibility?: { revealed: string[], hidden: string[] } }}
  */
 export function execute(statefulLayout: import("../../state/index.js").StatefulLayout, args: {
     path: string;
-    value: unknown;
-}): {
+    value?: unknown;
+    suggestionIndex?: number;
+}, store?: import("../suggestions-store.js").SuggestionsStore, variantsMemo?: import("../variants-memo.js").VariantsMemo): {
     valid: boolean;
     field: ReturnType<typeof projectFieldResult>;
     errors: Array<{
         path: string;
         message: string;
     }>;
+    otherErrors: number;
+    activatedMarkdown?: string;
+    visibility?: {
+        revealed: string[];
+        hidden: string[];
+    };
 };
 export namespace inputSchema {
     let type: string;
@@ -31,61 +41,14 @@ export namespace inputSchema {
             let description_1: string;
             export { description_1 as description };
         }
-    }
-    let required: string[];
-}
-export namespace outputSchema {
-    let type_2: string;
-    export { type_2 as type };
-    export namespace properties_1 {
-        namespace valid {
-            let type_3: string;
-            export { type_3 as type };
-        }
-        namespace field {
-            let type_4: string;
-            export { type_4 as type };
-            export namespace properties_2 {
-                export namespace path_1 {
-                    let type_5: string;
-                    export { type_5 as type };
-                }
-                export { path_1 as path };
-                export namespace type_6 {
-                    let type_7: string;
-                    export { type_7 as type };
-                }
-                export { type_6 as type };
-                export let data: {};
-                export namespace error {
-                    let type_8: string;
-                    export { type_8 as type };
-                }
-            }
-            export { properties_2 as properties };
-        }
-        namespace errors {
-            let type_9: string;
-            export { type_9 as type };
-            export namespace items {
-                let type_10: string;
-                export { type_10 as type };
-                export namespace properties_3 {
-                    export namespace path_2 {
-                        let type_11: string;
-                        export { type_11 as type };
-                    }
-                    export { path_2 as path };
-                    export namespace message {
-                        let type_12: string;
-                        export { type_12 as type };
-                    }
-                }
-                export { properties_3 as properties };
-            }
+        namespace suggestionIndex {
+            let type_2: string;
+            export { type_2 as type };
+            let description_2: string;
+            export { description_2 as description };
         }
     }
-    export { properties_1 as properties };
+    let required: string[];
 }
 import { projectFieldResult } from '../project.js';
 //# sourceMappingURL=set-field-value.d.ts.map

package/types/webmcp/tools/set-field-value.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set-field-value.d.ts","sourceRoot":"","sources":["../../../src/webmcp/tools/set-field-value.js"],"names":[],"mappings":"AA+CA;;;GAGG;AACH,0CAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;;;GAIG;AACH,wCAJW,OAAO,sBAAsB,EAAE,cAAc,QAC7C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC9B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;CAAE,CAwB5H;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCA9EiD,eAAe"}
+{"version":3,"file":"set-field-value.d.ts","sourceRoot":"","sources":["../../../src/webmcp/tools/set-field-value.js"],"names":[],"mappings":"AAyBA;;;GAGG;AACH,0CAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;;;;;;GAOG;AACH,wCAPW,OAAO,sBAAsB,EAAE,cAAc,QAC7C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,UAC3D,OAAO,yBAAyB,EAAE,gBAAgB,iBAClD,OAAO,qBAAqB,EAAE,YAAY,GAExC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CAAE,CAqDpO;;;;;;;;;;;;;;;;;;;;;;mCAxFkH,eAAe"}

package/types/webmcp/variants-memo.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @file Remembers which variant lists have already been sent to the agent.
+ *
+ * A discriminated union is a constant: the 39 branches of a portal page element are the
+ * same 39 whether they are reached at /elements/0 or at /elements/0/.../children2/0. The
+ * markdown projection used to print all of them every time one of those nodes appeared,
+ * and on a recursive schema that is most of the response — measured on the portal-page
+ * eval case, three emissions of one list were 4.45 KB of a 10.8 KB session, and the agent
+ * read it once and used it once.
+ *
+ * The memo is keyed on the SKELETON POINTER rather than the data path, which is what makes
+ * it catch recursion: every one of those nodes resolves to
+ * `page-config-simple#/$defs/element/oneOf`. It records where the list was first printed so
+ * a later response can point the agent back at it in its own transcript.
+ *
+ * It is never cleared on a write: unlike memorized suggestions, a schema's branches cannot
+ * be invalidated by editing the data. `describeState` projects into a fresh memo and merges
+ * it in afterwards, so a full read always prints every list once and stays authoritative.
+ */
+export class VariantsMemo {
+    /**
+     * first path each pointer's variant list was printed at
+     * @type {Map<string, string>}
+     */
+    _listedAt: Map<string, string>;
+    /**
+     * @param {string} pointer - skeleton pointer of the one-of-select node
+     * @returns {string | undefined} the path it was first listed at, or undefined if never
+     */
+    listedAt(pointer: string): string | undefined;
+    /**
+     * @param {string} pointer
+     * @param {string} path
+     */
+    record(pointer: string, path: string): void;
+    /**
+     * @param {VariantsMemo} other
+     */
+    merge(other: VariantsMemo): void;
+    clear(): void;
+}
+//# sourceMappingURL=variants-memo.d.ts.map

package/types/webmcp/variants-memo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variants-memo.d.ts","sourceRoot":"","sources":["../../src/webmcp/variants-memo.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH;IACE;;;OAGG;IACH,WAFU,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAER;IAErB;;;OAGG;IACH,kBAHW,MAAM,GACJ,MAAM,GAAG,SAAS,CAI9B;IAED;;;OAGG;IACH,gBAHW,MAAM,QACN,MAAM,QAIhB;IAED;;OAEG;IACH,aAFW,YAAY,QAItB;IAED,cAEC;CACF"}