toolcraft 0.0.781 → 0.0.783

package/composition.json

@@ -138,7 +138,7 @@
     },
     {
       "name": "toolcraft",
-      "version": "0.0.781",
+      "version": "0.0.783",
       "license": "MIT"
     },
     {
@@ -148,7 +148,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.781",
+      "version": "0.0.783",
       "license": "MIT"
     },
     {

package/dist/composition.json

@@ -138,7 +138,7 @@
     },
     {
       "name": "toolcraft",
-      "version": "0.0.781",
+      "version": "0.0.783",
       "license": "MIT"
     },
     {
@@ -148,7 +148,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.781",
+      "version": "0.0.783",
       "license": "MIT"
     },
     {

package/node_modules/@poe-code/xml-ast/README.md

@@ -35,3 +35,10 @@ For validation or root-name detection, pass `retainTree: false` to `parseXmlStre
 Use `streamElements: { matches, consume }` to process selected complete subtrees asynchronously. Matching non-root elements are detached from their parent; nested matches remain inside the selected ancestor. `consume(element, parent, before?)` runs in source order and is awaited before the next 512-unit parse window. The producer closes on consumer failure. This mode requires normal tree/content retention and retains each selected subtree until consumption; individual large subtrees and XML tokens still need their own storage strategy.
 
 Set `streamElements.captureBefore: true` to detach preceding sibling content when each subtree is selected and receive it as `before`. This preserves text, CDATA, comments and sibling order even when multiple subtrees share one parse window. The remaining trailing content stays in the parent. Store both `before` and the subtree when you need to reconstruct the original mixed content.
+
+`parseXmlStream` also accepts `events` with `retainTree: false` to consume ordered
+open, content and close events without constructing a document tree. Each parser
+window awaits the consumer before advancing. Event elements contain names,
+attributes and namespace metadata; individual XML tokens and open ancestry still
+remain resident. This mode lets a caller own document storage independently of
+the codec. Consumer failures propagate unchanged and close the input iterator.

package/node_modules/@poe-code/xml-ast/dist/index.d.ts

@@ -42,4 +42,4 @@ export interface XmlLimits {
 }
 export declare function parseXmlSteps(input: string, limits?: XmlLimits): Generator<number, XmlElement, void>;
 export declare function parseXml(input: string, limits?: XmlLimits): XmlElement;
-export { parseXmlStream, type XmlStreamLimits } from "./stream.js";
+export { parseXmlStream, type XmlStreamLimits, type XmlStreamEvent } from "./stream.js";

package/node_modules/@poe-code/xml-ast/dist/stream.d.ts

@@ -1,7 +1,20 @@
 import type { XmlContent, XmlElement, XmlLimits, XmlName } from "./index.js";
+export type XmlStreamEvent = {
+    readonly type: "open" | "close";
+    readonly element: XmlElement;
+    readonly parent: XmlElement | undefined;
+} | {
+    readonly type: "content";
+    readonly content: Exclude<XmlContent, XmlElement>;
+    readonly parent: XmlElement | undefined;
+};
 export interface XmlStreamLimits extends XmlLimits {
     /** Validate the full document but return only its root name, without a retained tree. */
     readonly retainTree?: boolean;
+    /** Ordered node events, awaited after each parser window. Requires retainTree:
+     * false; elements carry metadata without child/content arrays. Individual XML
+     * tokens remain resident until the underlying parser completes them. */
+    readonly events?: (event: XmlStreamEvent) => void | Promise<void>;
     /** Detach selected non-root subtrees and await their consumer before parsing
      * the next 512-unit window. By default nested matches belong to the selected ancestor. */
     readonly streamElements?: {

package/node_modules/@poe-code/xml-ast/dist/stream.js

@@ -16,6 +16,11 @@ export async function parseXmlStream(source, limits = {}, checkpoint) {
     }
     function charge(key, value = 1) { counters[key] += value; bound(key, counters[key]); }
     const retainContent = limits.retainContent !== false, tree = limits.retainTree !== false, retain = tree && retainContent;
+    const events = limits.events;
+    if (events && tree)
+        throw new TypeError("XML events require retainTree: false");
+    const describe = retain || !!events;
+    const queued = [];
     const streaming = limits.streamElements;
     if (streaming && !retain)
         throw new TypeError("XML subtree streaming requires retained content and tree mode");
@@ -28,7 +33,7 @@ export async function parseXmlStream(source, limits = {}, checkpoint) {
     const parser = new SaxesParser({ xmlns: true, defaultXMLVersion: "1.0", forceXMLVersion: true });
     parser.on("error", error => { throw new SyntaxError(`Invalid XML: ${error.message}`); });
     parser.on("doctype", () => { throw new SyntaxError("Invalid XML: DTD and entity declarations are forbidden"); });
-    let prefix = "", capturing = retain;
+    let prefix = "", capturing = describe;
     parser.on("xmldecl", value => {
         const encoding = value.encoding?.toUpperCase();
         if (value.version !== "1.0" || encoding !== undefined &&
@@ -36,7 +41,7 @@ export async function parseXmlStream(source, limits = {}, checkpoint) {
                 limits.expectedEncoding !== undefined && encoding !== limits.expectedEncoding &&
                     !(encoding === "UTF-16" && ["UTF-16LE", "UTF-16BE"].includes(limits.expectedEncoding))))
             throw new SyntaxError("Invalid XML: unsupported XML declaration");
-        if (retain)
+        if (describe)
             declaration = prefix.slice(0, prefix.indexOf("?>") + 2);
         prefix = "";
         capturing = false;
@@ -72,11 +77,11 @@ export async function parseXmlStream(source, limits = {}, checkpoint) {
                 parent.element.text = '';
             }
         }
-        charge("maxContentNodes", 1 + (retainContent ? attrs.length : 0));
+        charge("maxContentNodes", 1 + (retainContent || events ? attrs.length : 0));
         const element = { kind: "element", ...name, children: [], content: [], text: "",
-            attributes: retain ? attrs.map(attr => ({ name: attr.name, localName: attr.local, namespace: attr.uri, value: attr.value })) : [],
-            namespaces: retain ? namespaces : emptyNamespaces,
-            ...(!root && retain ? { prolog, epilog, ...(declaration === undefined ? {} : { declaration }) } : {}) };
+            attributes: describe ? attrs.map(attr => ({ name: attr.name, localName: attr.local, namespace: attr.uri, value: attr.value })) : [],
+            namespaces: describe ? namespaces : emptyNamespaces,
+            ...(!root && describe ? { prolog, epilog, ...(declaration === undefined ? {} : { declaration }) } : {}) };
         if (parent && tree && !selected) {
             parent.element.children.push(element);
             if (retain)
@@ -85,9 +90,13 @@ export async function parseXmlStream(source, limits = {}, checkpoint) {
         else if (!parent)
             root = element;
         stack.push({ element, namespaces, selected, before });
+        if (events)
+            queued.push({ type: "open", element, parent: parent?.element });
     });
     parser.on("closetag", () => {
         const frame = stack.pop();
+        if (events)
+            queued.push({ type: "close", element: frame.element, parent: stack.at(-1)?.element });
         if (frame.selected) {
             completed.push({ element: frame.element, parent: stack.at(-1).element, before: frame.before });
             selectedCount--;
@@ -99,11 +108,18 @@ export async function parseXmlStream(source, limits = {}, checkpoint) {
             await streaming.consume(entry.element, entry.parent, entry.before);
         }
         completed.length = 0;
+        for (const event of queued) {
+            await checkpoint?.(0);
+            await events(event);
+        }
+        queued.length = 0;
     }
     function append(content) {
         charge("maxTextLength", content.text.length);
         charge("maxContentNodes");
         const parent = stack.at(-1)?.element;
+        if (events)
+            queued.push({ type: "content", content, parent });
         if (tree && parent && (content.kind === "text" || content.kind === "cdata"))
             parent.text += content.text;
         if (retain)
@@ -148,14 +164,14 @@ export async function parseXmlStream(source, limits = {}, checkpoint) {
         for (let i = 0; i < text.length; i += 512) {
             await checkpoint?.(0);
             write(text.slice(i, i + 512));
-            if (completed.length)
+            if (completed.length || queued.length)
                 await drain();
             await checkpoint?.(Math.min(512, text.length - i));
         }
     }
     await checkpoint?.(0);
     parser.close();
-    if (completed.length)
+    if (completed.length || queued.length)
         await drain();
     if (!root)
         throw new SyntaxError("Invalid XML: incomplete document");

package/node_modules/tiny-stdio-mcp-server/dist/composition.json

@@ -8,7 +8,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.781",
+      "version": "0.0.783",
       "license": "MIT"
     }
   ]

package/node_modules/toolcraft-schema/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft-schema",
-  "version": "0.0.781",
+  "version": "0.0.783",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft",
-  "version": "0.0.781",
+  "version": "0.0.783",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
@@ -177,7 +177,7 @@
     "saxes"
   ],
   "optionalDependencies": {
-    "toolcraft-schema": "0.0.781",
+    "toolcraft-schema": "0.0.783",
     "toolcraft-design": "*",
     "@poe-code/frontmatter": "*",
     "@poe-code/agent-mcp-config": "*",