toolcraft 0.0.789 → 0.0.791

package/composition.json

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

package/dist/composition.json

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

package/node_modules/@poe-code/safe-fs/dist/core.d.ts

@@ -9,7 +9,7 @@ export * from "./fs/webdav/index.js";
 export * from "./bridge/index.js";
 export * from "./python/index.js";
 export { parseXml, parseXmlSteps, parseXmlSourceSteps, normalizeXmlChunks, parseXmlStream, XmlLimitError } from "./xml.js";
-export type { XmlName, XmlAttribute, XmlContent, XmlElement, XmlLimits } from "./xml.js";
+export type { XmlName, XmlAttribute, XmlContent, XmlElement, XmlLimits, XmlParserFrame, XmlFrameRequest } from "./xml.js";
 export * from "./contracts/object.js";
 export { ObjectAuthority } from "./fs/object-authority.js";
 export * from "./fs/s3/index.js";

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

@@ -54,3 +54,28 @@ limits)`: numbers are work checkpoints; read requests specify UTF-16 `offset` an
 iterator. The source must already be validated and normalized. This supports the
 same repairs and events without a complete source string; tokens and open ancestry
 still remain resident. Close the iterator and backing on errors or cancellation.
+
+For tree-free external parsing, set `storeFrames: true` alongside `retainTree: false`.
+The iterator also yields `frameOperation` requests: `push` saves the supplied frame,
+`pop` removes the latest frame, and `peek` needs its `frame` filled with the saved
+metadata. Keep the host stack in bounded backing storage. The parser caches one
+current frame; individual frame metadata and namespace scopes still have their own
+size cost. The default string and stream APIs retain their existing ancestry behavior.
+
+Pass `undefined` as the source length to parse incrementally. Such read requests
+have `streaming: true` and request at most 512 UTF-16 units. Return any nonempty
+prefix available without pulling more input; set `complete: true` only when that
+read reaches EOF (an empty EOF read is valid). Earlier offsets may be requested
+again, so retain source spans in caller-backed storage. With `normalizeXmlChunks`,
+pass `true` as the second argument to flush at input-chunk boundaries and preserve
+early parser failures. The string parser and known-length protocol are unchanged.
+
+With `retainTree: false`, `parseXmlSourceSteps` accepts `fragmentContent: true`
+to emit text, CDATA, comment and processing-instruction bodies in at most 512 UTF-16 units without splitting surrogate
+pairs. Content events with `continuation: true` belong to the preceding logical
+node; store their bodies separately and retain one node identity. Yielded steps
+let the host await each fragment before parsing more. Text validation and entity
+decoding replay bounded source windows before publishing a logical node, retaining
+its diagnostic and limit ordering. Numeric entity references are decoded without
+materializing the token. Names, attribute values, namespace scopes and XML
+declarations still require their own memory budget.

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

@@ -1,3 +1,3 @@
 export declare function validCharacter(point: number): boolean;
 /** Validate scalar values and normalize XML line endings in fixed windows. */
-export declare function normalizeXmlChunks(source: AsyncIterable<string> | Iterable<string>): AsyncGenerator<string>;
+export declare function normalizeXmlChunks(source: AsyncIterable<string> | Iterable<string>, flushChunks?: boolean): AsyncGenerator<string>;

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

@@ -5,7 +5,7 @@ export function validCharacter(point) {
         || (point >= 0x10000 && point <= 0x10ffff);
 }
 /** Validate scalar values and normalize XML line endings in fixed windows. */
-export async function* normalizeXmlChunks(source) {
+export async function* normalizeXmlChunks(source, flushChunks = false) {
     let first = true, afterCR = false, high = 0, output = '';
     for await (const chunk of source) {
         for (let index = 0; index < chunk.length; index++) {
@@ -41,6 +41,10 @@ export async function* normalizeXmlChunks(source) {
                 output = '';
             }
         }
+        if (flushChunks && output) {
+            yield output;
+            output = '';
+        }
     }
     if (high)
         throw new SyntaxError('Invalid XML: invalid character');

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

@@ -0,0 +1,28 @@
+import type { XmlContent, XmlElement } from './index.js';
+export interface XmlParserFrame {
+    element: XmlElement;
+    content: XmlContent[] | undefined;
+    name: string;
+    namespaces: Map<string, string>;
+}
+export type XmlFrameRequest = {
+    readonly frameOperation: 'push';
+    readonly frame: XmlParserFrame;
+} | {
+    readonly frameOperation: 'pop';
+} | {
+    readonly frameOperation: 'peek';
+    frame?: XmlParserFrame;
+};
+/** External mode caches only the current frame. The host owns the linked stack. */
+export declare class XmlFrames {
+    private readonly external;
+    private readonly frames;
+    private depth;
+    private current;
+    constructor(external: boolean);
+    get length(): number;
+    peek(): Generator<XmlFrameRequest, XmlParserFrame | undefined, void>;
+    push(frame: XmlParserFrame): Generator<XmlFrameRequest, void, void>;
+    pop(): Generator<XmlFrameRequest, XmlParserFrame | undefined, void>;
+}

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

@@ -0,0 +1,45 @@
+/** External mode caches only the current frame. The host owns the linked stack. */
+export class XmlFrames {
+    external;
+    frames = [];
+    depth = 0;
+    current;
+    constructor(external) {
+        this.external = external;
+    }
+    get length() { return this.external ? this.depth : this.frames.length; }
+    *peek() {
+        if (!this.external)
+            return this.frames.at(-1);
+        if (!this.depth)
+            return undefined;
+        if (!this.current) {
+            const request = { frameOperation: 'peek' };
+            yield request;
+            if (!request.frame)
+                throw new TypeError('Incomplete XML frame read');
+            this.current = request.frame;
+        }
+        return this.current;
+    }
+    *push(frame) {
+        if (!this.external) {
+            this.frames.push(frame);
+            return;
+        }
+        yield { frameOperation: 'push', frame };
+        this.current = frame;
+        this.depth++;
+    }
+    *pop() {
+        if (!this.external)
+            return this.frames.pop();
+        if (!this.depth)
+            return undefined;
+        const frame = yield* this.peek();
+        yield { frameOperation: 'pop' };
+        this.depth--;
+        this.current = undefined;
+        return frame;
+    }
+}

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

@@ -1,3 +1,5 @@
+import { type XmlFrameRequest } from "./frames.js";
+export type { XmlParserFrame, XmlFrameRequest } from "./frames.js";
 export { normalizeXmlChunks } from "./characters.js";
 import { type XmlSourceStep } from "./source.js";
 export type { XmlSourceRead, XmlSourceStep } from "./source.js";
@@ -51,8 +53,19 @@ export interface XmlStepLimits extends XmlLimits {
      * false. Drive the step iterator to await external consumers between windows. */
     readonly events?: (event: XmlStreamEvent) => void;
 }
+export interface XmlSourceLimits extends XmlStepLimits {
+    /** Emit content bodies in bounded fragments, marking continuations of the same logical
+     * node. Requires retainTree: false; consumers must preserve fragment identity. */
+    readonly fragmentContent?: boolean;
+    /** Store active parser frames through host-serviced requests. Requires retainTree: false. */
+    readonly storeFrames?: boolean;
+}
+export type XmlParseStep = XmlSourceStep | XmlFrameRequest;
 /** Parse a validated, BOM-free, line-normalized UTF-16 source via bounded read requests. */
-export declare function parseXmlSourceSteps(length: number, limits?: XmlStepLimits): Generator<XmlSourceStep, XmlElement, void>;
+export declare function parseXmlSourceSteps(length: number | undefined, limits?: XmlStepLimits & {
+    readonly storeFrames?: false;
+}): Generator<XmlSourceStep, XmlElement, void>;
+export declare function parseXmlSourceSteps(length: number | undefined, limits: XmlSourceLimits): Generator<XmlParseStep, XmlElement, void>;
 export declare function parseXmlSteps(input: string, limits?: XmlStepLimits): Generator<number, XmlElement, void>;
 export declare function parseXml(input: string, limits?: XmlLimits): XmlElement;
 export { parseXmlStream, type XmlStreamLimits, type XmlStreamEvent } from "./stream.js";

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

@@ -1,3 +1,4 @@
+import { XmlFrames } from "./frames.js";
 import { validCharacter } from "./characters.js";
 export { normalizeXmlChunks } from "./characters.js";
 import { XmlSource } from "./source.js";
@@ -66,6 +67,95 @@ function qualifiedNameSync(name, cache) {
     }
     return parts;
 }
+function* entity(source, start, end, recover) {
+    // Inspect only a bounded prefix, even for arbitrarily long numeric references.
+    const prefix = typeof source === "string" ? source.slice(start, Math.min(end, start + 4))
+        : yield* source.slice(start, Math.min(end, start + 4));
+    const predefined = { amp: "&", lt: "<", gt: ">", quot: '"', apos: "'" };
+    if (end - start <= 4 && Object.hasOwn(predefined, prefix))
+        return predefined[prefix];
+    const hexadecimal = prefix.startsWith("#x"), digits = start + (hexadecimal ? 2 : 1);
+    if (!prefix.startsWith("#") || digits >= end) {
+        if (!recover)
+            invalid("undeclared entity");
+        recover("undeclared entity");
+        return "";
+    }
+    let point = 0;
+    for (let index = digits; index < end; index++) {
+        const code = typeof source === "string" ? source.charCodeAt(index) : yield* source.charCodeAt(index);
+        const digit = code >= 48 && code <= 57 ? code - 48 : hexadecimal && code >= 65 && code <= 70 ? code - 55
+            : hexadecimal && code >= 97 && code <= 102 ? code - 87 : -1;
+        if (digit < 0)
+            invalid("undeclared entity");
+        point = point * (hexadecimal ? 16 : 10) + digit;
+        if (point > 0x10ffff)
+            invalid("invalid character reference");
+        if ((index - digits + 1) % 512 === 0)
+            yield 512;
+    }
+    if ((end - digits) % 512)
+        yield (end - digits) % 512;
+    if (!validCharacter(point))
+        invalid("invalid character reference");
+    return String.fromCodePoint(point);
+}
+/** Decoded text fragments; source read/work requests remain host-serviced. */
+function* textParts(source, start, end, decode, recover) {
+    let cursor = start;
+    while (cursor < end) {
+        let finish = Math.min(end, cursor + 512);
+        if (finish < end) {
+            const last = yield* source.charCodeAt(finish - 1);
+            if (last >= 0xd800 && last <= 0xdbff)
+                finish--;
+        }
+        const raw = yield* source.slice(cursor, finish);
+        const found = decode ? raw.indexOf("&") : -1;
+        if (found < 0) {
+            yield raw;
+            yield raw.length;
+            cursor = finish;
+            continue;
+        }
+        const amp = cursor + found;
+        if (found) {
+            yield raw.slice(0, found);
+            yield found;
+        }
+        const semicolon = yield* source.indexOf(";", amp + 1, end);
+        if (semicolon < 0) {
+            if (!recover)
+                invalid("unterminated entity");
+            recover("unterminated entity");
+            cursor = amp + 1;
+            decode = false;
+            continue;
+        }
+        const part = yield* entity(source, amp + 1, semicolon, recover);
+        if (part)
+            yield part;
+        yield 1;
+        cursor = semicolon + 1;
+    }
+}
+function* textFragments(source, start, end, decode, recover) {
+    let pending = "";
+    for (const part of textParts(source, start, end, decode, recover)) {
+        if (typeof part !== "string") {
+            yield part;
+            continue;
+        }
+        pending += part;
+        while (pending.length >= 512) {
+            const last = pending.charCodeAt(511), width = last >= 0xd800 && last <= 0xdbff ? 511 : 512;
+            yield pending.slice(0, width);
+            pending = pending.slice(width);
+        }
+    }
+    if (pending)
+        yield pending;
+}
 function* entities(text, recover) {
     let result = "";
     let offset = 0;
@@ -81,39 +171,7 @@ function* entities(text, recover) {
             recover("unterminated entity");
             return result + text.slice(start + 1);
         }
-        const entity = text.slice(start + 1, end);
-        const predefined = { amp: "&", lt: "<", gt: ">", quot: '"', apos: "'" };
-        if (Object.hasOwn(predefined, entity))
-            result += predefined[entity];
-        else {
-            const hexadecimal = entity.startsWith("#x");
-            const digits = entity.slice(hexadecimal ? 2 : 1);
-            if (!entity.startsWith("#") || !digits.length) {
-                if (!recover)
-                    invalid("undeclared entity");
-                recover("undeclared entity");
-                offset = end + 1;
-                continue;
-            }
-            let point = 0;
-            for (let index = 0; index < digits.length; index++) {
-                const code = digits.charCodeAt(index);
-                const digit = code >= 48 && code <= 57 ? code - 48 : hexadecimal && code >= 65 && code <= 70 ? code - 55
-                    : hexadecimal && code >= 97 && code <= 102 ? code - 87 : -1;
-                if (digit < 0)
-                    invalid("undeclared entity");
-                point = point * (hexadecimal ? 16 : 10) + digit;
-                if (point > 0x10ffff)
-                    invalid("invalid character reference");
-                if ((index + 1) % 512 === 0)
-                    yield 512;
-            }
-            if (digits.length % 512)
-                yield digits.length % 512;
-            if (!validCharacter(point))
-                invalid("invalid character reference");
-            result += String.fromCodePoint(point);
-        }
+        result += yield* entity(text, start + 1, end, recover);
         offset = end + 1;
     }
     return result;
@@ -189,9 +247,12 @@ function validateLimits(limits) {
     if (limits.events && limits.retainTree !== false)
         throw new TypeError("XML events require retainTree: false");
 }
-/** Parse a validated, BOM-free, line-normalized UTF-16 source via bounded read requests. */
 export function* parseXmlSourceSteps(length, limits = {}) {
     validateLimits(limits);
+    if (limits.storeFrames && limits.retainTree !== false)
+        throw new TypeError("Stored XML frames require retainTree: false");
+    if (limits.fragmentContent && limits.retainTree !== false)
+        throw new TypeError("XML content fragments require retainTree: false");
     const source = new XmlSource(length);
     const maxDepth = limits.maxDepth ?? Infinity;
     const maxNodes = limits.maxNodes ?? Infinity;
@@ -212,7 +273,7 @@ export function* parseXmlSourceSteps(length, limits = {}) {
             throw new XmlLimitError("maxTextLength", "XML text limit exceeded");
         textLength += text.length;
     };
-    const stack = [];
+    const stack = new XmlFrames(limits.storeFrames === true);
     let root;
     const prolog = [];
     const epilog = [];
@@ -230,7 +291,7 @@ export function* parseXmlSourceSteps(length, limits = {}) {
     let pendingWork = 0;
     const skipWhitespace = function* () {
         const start = offset;
-        while (offset < source.length) {
+        while (yield* source.has(offset)) {
             const c = (yield* source.charCodeAt(offset));
             if (c !== 32 && c !== 9 && c !== 10 && c !== 13)
                 break;
@@ -245,7 +306,7 @@ export function* parseXmlSourceSteps(length, limits = {}) {
     };
     const scanName = function* () {
         const start = offset;
-        while (offset < source.length) {
+        while (yield* source.has(offset)) {
             const c = (yield* source.charCodeAt(offset));
             if (c === 32 || c === 9 || c === 13 || c === 10 || c === 47 || c === 61 || c === 62 || c === 63)
                 break;
@@ -265,7 +326,34 @@ export function* parseXmlSourceSteps(length, limits = {}) {
         const [prefix, localName] = qualifiedNameSync(name, qualifiedNames);
         return [name, prefix, localName];
     };
-    while (offset < source.length) {
+    const rawContent = function* (kind, start, end, parent, target = "") {
+        if (end - start > maxTextLength - textLength)
+            throw new XmlLimitError("maxTextLength", "XML text limit exceeded");
+        textLength += end - start;
+        admitContent();
+        let cursor = start, continuation = false;
+        do {
+            let finish = limits.fragmentContent ? Math.min(end, cursor + 512) : end;
+            if (finish < end) {
+                const last = yield* source.charCodeAt(finish - 1);
+                if (last >= 0xd800 && last <= 0xdbff)
+                    finish--;
+            }
+            const text = yield* source.slice(cursor, finish);
+            const content = kind === "processing-instruction" ? { kind, target, text } : { kind, text };
+            if (kind === "cdata" && retainTree)
+                parent.element.text += text;
+            if (retain)
+                (parent?.content ?? (root ? epilog : prolog)).push(content);
+            limits.events?.({ type: "content", content, parent: parent?.element,
+                ...(continuation ? { continuation: true } : {}) });
+            if (limits.fragmentContent)
+                yield Math.max(1, text.length);
+            continuation = true;
+            cursor = finish;
+        } while (cursor < end);
+    };
+    while (yield* source.has(offset)) {
         pendingWork += 1;
         if (pendingWork >= 512) {
             while (pendingWork >= 512) {
@@ -276,6 +364,49 @@ export function* parseXmlSourceSteps(length, limits = {}) {
         if ((yield* source.charCodeAt(offset)) !== 60) {
             const next = (yield* source.indexOf("<", offset));
             const endPos = next < 0 ? source.length : next;
+            if (limits.fragmentContent) {
+                if ((yield* source.indexOf("]]>", offset, endPos)) >= 0)
+                    invalid("CDATA terminator in text");
+                const parent = yield* stack.peek();
+                let size = 0, outsideText = false;
+                // Validate before emitting any part of the logical node. This preserves
+                // entity/recovery diagnostics and limit precedence without retaining it.
+                for (const part of textFragments(source, offset, endPos, !!parent, limits.recover)) {
+                    if (typeof part !== "string") {
+                        yield part;
+                        continue;
+                    }
+                    size += part.length;
+                    if (!parent)
+                        for (const character of part) {
+                            if (!" \t\r\n".includes(character))
+                                outsideText = true;
+                        }
+                }
+                if (size > maxTextLength - textLength)
+                    throw new XmlLimitError("maxTextLength", "XML text limit exceeded");
+                textLength += size;
+                if (outsideText)
+                    invalid("text outside the root");
+                if (size) {
+                    admitContent();
+                    if (limits.events) {
+                        let continuation = false;
+                        for (const part of textFragments(source, offset, endPos, !!parent, limits.recover ? () => { } : undefined)) {
+                            if (typeof part !== "string") {
+                                yield part;
+                                continue;
+                            }
+                            limits.events({ type: "content", content: { kind: "text", text: part }, parent: parent?.element,
+                                ...(continuation ? { continuation: true } : {}) });
+                            continuation = true;
+                            yield 1;
+                        }
+                    }
+                }
+                offset = endPos;
+                continue;
+            }
             const text = (yield* source.slice(offset, endPos));
             pendingWork += (endPos - offset) + text.length;
             while (pendingWork >= 512) {
@@ -290,7 +421,7 @@ export function* parseXmlSourceSteps(length, limits = {}) {
                 pendingWork -= 512;
             }
             admitText(resolved);
-            const parent = stack.at(-1);
+            const parent = (yield* stack.peek());
             if (parent) {
                 if (retainTree)
                     parent.element.text += resolved;
@@ -327,17 +458,10 @@ export function* parseXmlSourceSteps(length, limits = {}) {
         }
         else if ((yield* source.startsWith("<!--", offset))) {
             const end = yield* find(source, "-->", offset + 4);
-            const text = end < 0 ? "" : yield* source.slice(offset + 4, end);
-            if (end < 0 || (yield* find(text, "--", 0)) >= 0 || text.endsWith("-")) {
+            if (end < 0 || (yield* source.indexOf("--", offset + 4, end)) >= 0
+                || (end > offset + 4 && (yield* source.charCodeAt(end - 1)) === 45))
                 invalid("malformed comment");
-            }
-            const parent = stack.at(-1);
-            admitText(text);
-            admitContent();
-            if (retain) {
-                (parent?.content ?? (root ? epilog : prolog)).push({ kind: "comment", text });
-            }
-            limits.events?.({ type: "content", content: { kind: "comment", text }, parent: parent?.element });
+            yield* rawContent("comment", offset + 4, end, yield* stack.peek());
             offset = end + 3;
         }
         else if ((yield* source.startsWith("<![CDATA[", offset))) {
@@ -346,15 +470,7 @@ export function* parseXmlSourceSteps(length, limits = {}) {
             const end = yield* find(source, "]]>", offset + 9);
             if (end < 0)
                 invalid("unterminated CDATA");
-            const cdataText = (yield* source.slice(offset + 9, end));
-            admitText(cdataText);
-            const parent = stack.at(-1);
-            if (retainTree)
-                parent.element.text += cdataText;
-            admitContent();
-            if (retain)
-                parent.content.push({ kind: "cdata", text: cdataText });
-            limits.events?.({ type: "content", content: { kind: "cdata", text: cdataText }, parent: parent.element });
+            yield* rawContent("cdata", offset + 9, end, yield* stack.peek());
             offset = end + 3;
         }
         else if ((yield* source.startsWith("<?", offset))) {
@@ -368,34 +484,31 @@ export function* parseXmlSourceSteps(length, limits = {}) {
             const end = yield* find(source, "?>", offset);
             if (end < 0)
                 invalid("unterminated processing instruction");
-            const content = (yield* source.slice(offset, end));
             if (target.length === 3 && target.toLowerCase() === "xml") {
+                const content = yield* source.slice(offset, end);
                 if (start !== 0 || target !== "xml"
-                    || !(yield* validDeclaration(content, limits.expectedEncoding))) {
+                    || !(yield* validDeclaration(content, limits.expectedEncoding)))
                     invalid("unsupported XML declaration");
-                }
                 if (retainContent)
-                    declaration = (yield* source.slice(start, end + 2));
+                    declaration = yield* source.slice(start, end + 2);
             }
-            else if (content && !" \t\n\r".includes(content[0]))
-                invalid("invalid processing instruction");
-            if (!(target.length === 3 && target.toLowerCase() === "xml")) {
-                const parent = stack.at(-1);
-                let wsStart = 0;
-                while (wsStart < content.length && " \t\n\r".includes(content[wsStart]))
-                    wsStart++;
-                pendingWork += wsStart;
+            else {
+                if (offset < end && !" \t\n\r".includes(yield* source.slice(offset, offset + 1)))
+                    invalid("invalid processing instruction");
+                let body = offset;
+                while (body < end && " \t\n\r".includes(yield* source.slice(body, body + 1))) {
+                    body++;
+                    pendingWork++;
+                    if (pendingWork >= 512) {
+                        yield 512;
+                        pendingWork -= 512;
+                    }
+                }
                 while (pendingWork >= 512) {
                     yield 512;
                     pendingWork -= 512;
                 }
-                const text = content.slice(wsStart);
-                admitText(text);
-                admitContent();
-                if (retain) {
-                    (parent?.content ?? (root ? epilog : prolog)).push({ kind: "processing-instruction", target, text });
-                }
-                limits.events?.({ type: "content", content: { kind: "processing-instruction", target, text }, parent: parent?.element });
+                yield* rawContent("processing-instruction", body, end, yield* stack.peek(), target);
             }
             offset = end + 2;
         }
@@ -410,14 +523,14 @@ export function* parseXmlSourceSteps(length, limits = {}) {
                 yield 512;
                 pendingWork -= 512;
             }
-            const closed = (yield* source.slice(offset++, offset)) === ">" ? stack.pop() : undefined;
+            const closed = (yield* source.slice(offset++, offset)) === ">" ? (yield* stack.pop()) : undefined;
             if (closed?.name !== name) {
                 if (!limits.recover)
                     invalid("mismatched closing tag");
                 limits.recover("mismatched closing tag");
             }
             if (closed)
-                limits.events?.({ type: "close", element: closed.element, parent: stack.at(-1)?.element });
+                limits.events?.({ type: "close", element: closed.element, parent: (yield* stack.peek())?.element });
         }
         else {
             offset++;
@@ -436,7 +549,7 @@ export function* parseXmlSourceSteps(length, limits = {}) {
             }
             let attributes;
             const attrMeta = [];
-            let namespaces = stack.at(-1)?.namespaces ?? new Map([["xml", xmlNamespace]]);
+            let namespaces = (yield* stack.peek())?.namespaces ?? new Map([["xml", xmlNamespace]]);
             let ownsNamespaces = stack.length === 0;
             while (!repeated) {
                 const ws = (yield* skipWhitespace());
@@ -543,7 +656,7 @@ export function* parseXmlSourceSteps(length, limits = {}) {
             if (stack.length + 1 > maxDepth)
                 throw new XmlLimitError("maxDepth", "XML resource limit exceeded");
             const namespace = namespaces.get(prefix) ?? "";
-            limits.onElement?.({ name, namespace, localName }, stack.at(-1)?.element, stack.length + 1);
+            limits.onElement?.({ name, namespace, localName }, (yield* stack.peek())?.element, stack.length + 1);
             admitContent();
             const retainedAttributes = [];
             if (retainContent && attributes) {
@@ -562,7 +675,7 @@ export function* parseXmlSourceSteps(length, limits = {}) {
             }
             const content = retain ? [] : undefined;
             const element = { kind: "element", name, namespace, localName, children: [], text: "", content: content ?? emptyContent, attributes: retainContent ? retainedAttributes : emptyAttributes, namespaces: retainContent ? namespaces : emptyNamespaces, ...(root === undefined && retainContent ? { prolog, epilog, ...(declaration === undefined ? {} : { declaration }) } : {}) };
-            const parent = stack.at(-1);
+            const parent = (yield* stack.peek());
             if (parent) {
                 if (retainTree) {
                     parent.element.children.push(element);
@@ -587,7 +700,7 @@ export function* parseXmlSourceSteps(length, limits = {}) {
                 previousEmpty = { suffix: name + "/>", name, prefix, localName };
             limits.events?.({ type: "open", element, parent: parent?.element });
             if (!empty)
-                stack.push({ element, content, name, namespaces });
+                yield* stack.push({ element, content, name, namespaces });
             else
                 limits.events?.({ type: "close", element, parent: parent?.element });
         }
@@ -603,8 +716,8 @@ export function* parseXmlSourceSteps(length, limits = {}) {
             invalid("incomplete document");
         limits.recover("incomplete document");
         while (stack.length) {
-            const closed = stack.pop();
-            limits.events?.({ type: "close", element: closed.element, parent: stack.at(-1)?.element });
+            const closed = (yield* stack.pop());
+            limits.events?.({ type: "close", element: closed.element, parent: (yield* stack.peek())?.element });
             yield 1;
         }
     }

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

@@ -1,18 +1,24 @@
-/** Fill value with exactly the requested UTF-16 span before advancing the parser. */
+/** Fill value before advancing. Streaming reads may be short; mark complete at EOF. */
 export interface XmlSourceRead {
     readonly offset: number;
     readonly length: number;
+    readonly streaming?: boolean;
     value?: string;
+    complete?: boolean;
 }
 export type XmlSourceStep = number | XmlSourceRead;
 /** One fixed window; individual returned tokens still have their own size cost. */
 export declare class XmlSource {
-    readonly length: number;
     private window;
     private start;
-    constructor(length: number);
+    private end;
+    private readonly streaming;
+    constructor(length: number | undefined);
+    get length(): number;
+    private load;
+    has(offset: number): Generator<XmlSourceStep, boolean, void>;
     slice(start: number, end?: number): Generator<XmlSourceStep, string, void>;
     charCodeAt(offset: number): Generator<XmlSourceStep, number, void>;
     startsWith(value: string, offset: number): Generator<XmlSourceStep, boolean, void>;
-    indexOf(value: string, offset: number): Generator<XmlSourceStep, number, void>;
+    indexOf(value: string, offset: number, end?: number): Generator<XmlSourceStep, number, void>;
 }

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

@@ -1,27 +1,44 @@
 /** One fixed window; individual returned tokens still have their own size cost. */
 export class XmlSource {
-    length;
     window = '';
     start = -1;
+    end;
+    streaming;
     constructor(length) {
-        this.length = length;
-        if (!Number.isSafeInteger(length) || length < 0)
-            throw new RangeError("Invalid XML source length");
+        if (length !== undefined && (!Number.isSafeInteger(length) || length < 0))
+            throw new RangeError('Invalid XML source length');
+        this.streaming = length === undefined;
+        this.end = length ?? Infinity;
+    }
+    get length() { return this.end; }
+    *load(offset) {
+        if (offset >= this.end || offset >= this.start && offset < this.start + this.window.length)
+            return;
+        const start = this.streaming ? offset : Math.floor(offset / 4096) * 4096;
+        const request = { offset: start, length: Math.min(this.streaming ? 512 : 4096, this.end - start),
+            ...(this.streaming ? { streaming: true } : {}) };
+        yield request;
+        if (typeof request.value !== 'string' || request.value.length > request.length ||
+            (!this.streaming && request.value.length !== request.length) ||
+            (!request.value.length && !request.complete && this.streaming))
+            throw new TypeError('Incomplete XML source read');
+        if (this.streaming && request.complete)
+            this.end = start + request.value.length;
+        this.window = request.value;
+        this.start = start;
+    }
+    *has(offset) {
+        yield* this.load(offset);
+        return offset < this.end;
     }
     *slice(start, end = this.length) {
         start = start < 0 ? Math.max(0, this.length + start) : Math.min(start, this.length);
         end = end < 0 ? Math.max(0, this.length + end) : Math.min(end, this.length);
         let result = '';
-        while (start < end) {
-            if (start < this.start || start >= this.start + this.window.length) {
-                const offset = Math.floor(start / 4096) * 4096;
-                const read = { offset, length: Math.min(4096, this.length - offset) };
-                yield read;
-                if (typeof read.value !== 'string' || read.value.length !== read.length)
-                    throw new TypeError('Incomplete XML source read');
-                this.window = read.value;
-                this.start = offset;
-            }
+        while (start < Math.min(end, this.length)) {
+            yield* this.load(start);
+            if (start >= this.end)
+                break;
             const stop = Math.min(end, this.start + this.window.length);
             result += this.window.slice(start - this.start, stop - this.start);
             start = stop;
@@ -32,15 +49,22 @@ export class XmlSource {
         return (yield* this.slice(offset, offset + 1)).charCodeAt(0);
     }
     *startsWith(value, offset) {
-        return (yield* this.slice(offset, offset + value.length)) === value;
+        for (let index = 0; index < value.length; index++) {
+            if ((yield* this.charCodeAt(offset + index)) !== value.charCodeAt(index))
+                return false;
+        }
+        return true;
     }
-    *indexOf(value, offset) {
-        while (offset < this.length) {
-            const end = Math.min(this.length, offset + 4096 + value.length - 1);
-            const found = (yield* this.slice(offset, end)).indexOf(value);
+    *indexOf(value, offset, end = Infinity) {
+        let tail = '';
+        while (offset < end && (yield* this.has(offset))) {
+            const stop = Math.min(end, this.start + this.window.length);
+            const part = tail + this.window.slice(offset - this.start, stop - this.start);
+            const found = part.indexOf(value);
             if (found >= 0)
-                return offset + found;
-            offset += 4096;
+                return offset - tail.length + found;
+            tail = value.length > 1 ? part.slice(-(value.length - 1)) : '';
+            offset = stop;
         }
         return -1;
     }

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

@@ -5,6 +5,7 @@ export type XmlStreamEvent = {
     readonly parent: XmlElement | undefined;
 } | {
     readonly type: "content";
+    readonly continuation?: boolean;
     readonly content: Exclude<XmlContent, XmlElement>;
     readonly parent: XmlElement | undefined;
 };

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

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

package/node_modules/toolcraft-schema/package.json

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

package/package.json

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