@vibe-agent-toolkit/resources 0.1.34 → 0.1.36

package/dist/schema-uri-walker.js

@@ -0,0 +1,154 @@
+/**
+ * Pure schema/data traversal that captures every string value sitting at a
+ * JSON Schema position whose `format` is in the URI family.
+ *
+ * Handles:
+ *  - `properties` (recursion)
+ *  - `items` (single-schema and tuple)
+ *  - `oneOf` / `anyOf` / `allOf` (every branch walked) AND sibling keywords
+ *    in the same node (JSON Schema AND semantics)
+ *  - `$ref` (resolved against schema root via JSON Pointer; cycle-protected)
+ *  - `definitions` and `$defs` as ref targets
+ *
+ * Does NOT handle (intentional, see spec §"Non-Goals"):
+ *  - `if`/`then`/`else`, `dependentSchemas`
+ *  - `patternProperties`, schema-form `additionalProperties`
+ *  - `prefixItems` (JSON Schema 2020-12)
+ *
+ * Captures are deduplicated by `(pointer, value)` before return so that
+ * multiple matching composite branches don't produce duplicate issues.
+ *
+ * No I/O. No side effects.
+ */
+import { decodeJsonPointerSegment, encodeJsonPointerSegment, formatJsonPointerAsDotted } from './utils.js';
+const URI_FAMILY_FORMATS = new Set([
+    'uri-reference',
+    'uri',
+    'iri-reference',
+    'iri',
+]);
+/**
+ * Walk a frontmatter document against a JSON Schema and return every value
+ * whose schema position has a URI-family `format` keyword.
+ */
+export function walkFrontmatterUriReferences(data, schema) {
+    if (data === undefined || data === null)
+        return [];
+    const captures = [];
+    walk(data, schema, schema, [], new Set(), captures);
+    return dedupe(captures);
+}
+function walkComposites(data, node, root, pointerSegments, visitedRefs, captures) {
+    for (const branchList of [node.oneOf, node.anyOf, node.allOf]) {
+        if (Array.isArray(branchList)) {
+            for (const branch of branchList) {
+                walk(data, branch, root, pointerSegments, visitedRefs, captures);
+            }
+        }
+    }
+}
+function walkProperties(data, node, root, pointerSegments, visitedRefs, captures) {
+    if (!node.properties || data === null || typeof data !== 'object' || Array.isArray(data))
+        return;
+    const dataObj = data;
+    for (const [key, propSchema] of Object.entries(node.properties)) {
+        if (key in dataObj) {
+            walk(dataObj[key], propSchema, root, [...pointerSegments, encodeJsonPointerSegment(key)], visitedRefs, captures);
+        }
+    }
+}
+function walkItems(data, node, root, pointerSegments, visitedRefs, captures) {
+    if (!node.items || !Array.isArray(data))
+        return;
+    if (Array.isArray(node.items)) {
+        const tupleSchemas = node.items;
+        for (const [i, itemValue] of data.entries()) {
+            if (i >= tupleSchemas.length)
+                break;
+            walk(itemValue, tupleSchemas[i], root, [...pointerSegments, String(i)], visitedRefs, captures);
+        }
+    }
+    else {
+        for (const [i, itemValue] of data.entries()) {
+            walk(itemValue, node.items, root, [...pointerSegments, String(i)], visitedRefs, captures);
+        }
+    }
+}
+function walk(data, node, root, pointerSegments, visitedRefs, captures) {
+    if (!node || typeof node !== 'object')
+        return;
+    // Resolve $ref against schema root. Cycle protection: skip if already on the
+    // recursion stack. Pop after recursion.
+    if (typeof node.$ref === 'string') {
+        if (visitedRefs.has(node.$ref))
+            return;
+        const resolved = resolveRef(node.$ref, root);
+        if (!resolved)
+            return;
+        visitedRefs.add(node.$ref);
+        walk(data, resolved, root, pointerSegments, visitedRefs, captures);
+        visitedRefs.delete(node.$ref);
+        return;
+    }
+    // Composite schemas: walk every branch. CRITICAL: do NOT short-circuit;
+    // sibling `properties`/`items` are AND-combined with the composite.
+    walkComposites(data, node, root, pointerSegments, visitedRefs, captures);
+    // URI-family format leaf
+    if (typeof node.format === 'string' &&
+        URI_FAMILY_FORMATS.has(node.format) &&
+        typeof data === 'string') {
+        const pointer = pointerSegments.length === 0 ? '' : '/' + pointerSegments.join('/');
+        captures.push({
+            value: data,
+            pointer,
+            dottedPath: formatJsonPointerAsDotted(pointer),
+            format: node.format,
+        });
+        // Fall through — schemas with both `format` and sibling object/array
+        // structure are unusual but possible; let recursion proceed.
+    }
+    // Object recursion
+    walkProperties(data, node, root, pointerSegments, visitedRefs, captures);
+    // Array recursion
+    walkItems(data, node, root, pointerSegments, visitedRefs, captures);
+    // Intentionally NOT handled: if/then/else, dependentSchemas, patternProperties,
+    // schema-form additionalProperties, prefixItems (2020-12). See spec §"Non-Goals".
+}
+/**
+ * Resolve a local $ref (e.g., "#/$defs/Foo") against the schema root using a
+ * generic JSON Pointer walk. Returns null for unresolvable refs or non-local
+ * refs (no cross-file support in v1).
+ */
+function resolveRef(ref, root) {
+    if (!ref.startsWith('#/'))
+        return null;
+    // eslint-disable-next-line local/no-hardcoded-path-split -- RFC 6901 JSON Pointer segment splitting, not a file path
+    const segments = ref.slice(2).split('/').map(decodeJsonPointerSegment);
+    let cursor = root;
+    for (const seg of segments) {
+        if (cursor === null || typeof cursor !== 'object')
+            return null;
+        cursor = cursor[seg];
+        if (cursor === undefined)
+            return null;
+    }
+    return cursor ?? null;
+}
+/**
+ * Remove duplicate captures by (pointer, value). Multiple matching branches
+ * of `oneOf`/`anyOf`/`allOf` can produce duplicates; users should see one
+ * issue per field, not one per branch.
+ */
+function dedupe(captures) {
+    const seen = new Set();
+    const out = [];
+    for (const c of captures) {
+        const key = c.pointer + ' ' + c.value;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(c);
+    }
+    return out;
+}
+//# sourceMappingURL=schema-uri-walker.js.map

package/dist/schema-uri-walker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-uri-walker.js","sourceRoot":"","sources":["../src/schema-uri-walker.ts"],"names":[],"mappings":"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"}