noodleseed-cli 0.1.4

package/node_modules/@noodle-borg/compiler/dist/manifest/schema-refs.js

@@ -0,0 +1,149 @@
+import { suggestionFields } from '../suggest.js';
+import { NAME_PATTERN } from './naming.js';
+/**
+ * Resolve `$use` references in an authored JSON Schema (docs/SPEC.md "Schemas").
+ *
+ * Every `{ $use: "<name>" }` node is rewritten to a local `{ $ref: "#/$defs/<name>" }`, and the
+ * referenced definitions from `schemasMap` are bundled into the schema's `$defs` so each tool's
+ * schema document stays self-contained. Resolution is transitive (a referenced schema may itself
+ * use `$use`) and cycle-safe (definitions are bundled by `$ref`, never inlined). `$defs` keys are
+ * sorted for deterministic output, and `$defs` is only attached when at least one `$use` was
+ * resolved — so schemas without `$use` pass through byte-for-byte.
+ *
+ * `$use` must be the sole key of its object. External `$ref` rejection is handled downstream by the
+ * caller on the resolved schema (so it also scans bundled definitions).
+ */
+export function resolveSchemaUses(schema, schemasMap, path) {
+    const errors = [];
+    const usedAtRoot = new Set();
+    const rewrittenRoot = rewriteNode(schema, path, schemasMap, usedAtRoot, errors);
+    // Transitively resolve every referenced definition, guarding against cycles with `visited`.
+    const bundled = {};
+    const visited = new Set();
+    const queue = [...usedAtRoot];
+    while (queue.length > 0) {
+        const name = queue.shift();
+        if (visited.has(name))
+            continue;
+        visited.add(name);
+        const definition = schemasMap[name];
+        // `name` is only enqueued after rewriteNode confirmed it exists in schemasMap.
+        if (definition === undefined)
+            continue;
+        const usedHere = new Set();
+        bundled[name] = rewriteNode(definition, `schemas.${name}`, schemasMap, usedHere, errors);
+        for (const next of usedHere)
+            if (!visited.has(next))
+                queue.push(next);
+    }
+    if (errors.length > 0)
+        return { schema: rewrittenRoot, errors };
+    // No `$use` anywhere: pass the (structurally identical) schema through untouched.
+    if (visited.size === 0)
+        return { schema: rewrittenRoot, errors };
+    const mergedDefs = mergeDefs(rewrittenRoot, bundled, path, errors);
+    if (errors.length > 0)
+        return { schema: rewrittenRoot, errors };
+    return { schema: withDefs(rewrittenRoot, mergedDefs), errors };
+}
+/**
+ * Recursively rewrite `$use` nodes to local `$ref`s. Records each referenced name in `used` and
+ * pushes a CompileError for malformed references. Returns a new value; never mutates the input.
+ */
+function rewriteNode(value, path, schemasMap, used, errors) {
+    if (Array.isArray(value)) {
+        return value.map((item, i) => rewriteNode(item, `${path}.${i}`, schemasMap, used, errors));
+    }
+    if (value === null || typeof value !== 'object')
+        return value;
+    const obj = value;
+    if ('$use' in obj) {
+        const refPath = `${path}.$use`;
+        const target = obj.$use;
+        if (Object.keys(obj).length !== 1) {
+            errors.push({
+                code: 'invalid_schema_ref',
+                path: refPath,
+                message: '$use must be the only key in its object',
+            });
+            return value;
+        }
+        if (typeof target !== 'string') {
+            errors.push({
+                code: 'invalid_schema_ref',
+                path: refPath,
+                message: '$use must reference a schema name as a string',
+            });
+            return value;
+        }
+        if (!NAME_PATTERN.test(target)) {
+            errors.push({
+                code: 'invalid_name',
+                path: refPath,
+                message: `$use target "${target}" must use lowercase letters, numbers, and underscores`,
+            });
+            return value;
+        }
+        if (!(target in schemasMap)) {
+            errors.push({
+                code: 'unknown_schema_ref',
+                path: refPath,
+                message: `$use references schema "${target}", which is not declared in "schemas"`,
+                got: target,
+                ...suggestionFields('unknown_schema_ref', target, Object.keys(schemasMap)),
+            });
+            return value;
+        }
+        used.add(target);
+        return { $ref: `#/$defs/${target}` };
+    }
+    const out = {};
+    for (const [key, val] of Object.entries(obj)) {
+        out[key] = rewriteNode(val, `${path}.${key}`, schemasMap, used, errors);
+    }
+    return out;
+}
+/**
+ * Merge bundled definitions into any tenant-authored `$defs`, sort the keys for determinism, and
+ * reject a collision where an authored `$defs.<name>` differs from a bundled definition of the same
+ * name.
+ */
+function mergeDefs(root, bundled, path, errors) {
+    const authored = root.$defs !== null && typeof root.$defs === 'object' && !Array.isArray(root.$defs)
+        ? root.$defs
+        : {};
+    const merged = { ...authored };
+    for (const [name, definition] of Object.entries(bundled)) {
+        if (name in authored && JSON.stringify(authored[name]) !== JSON.stringify(definition)) {
+            errors.push({
+                code: 'schema_ref_conflict',
+                path: `${path}.$defs.${name}`,
+                message: `$use target "${name}" conflicts with an existing $defs entry of the same name`,
+            });
+            continue;
+        }
+        merged[name] = definition;
+    }
+    const sorted = {};
+    for (const key of Object.keys(merged).sort())
+        sorted[key] = merged[key];
+    return sorted;
+}
+/** Return a copy of `root` with `$defs` set, replacing it in place or appending it at the end. */
+function withDefs(root, defs) {
+    const out = {};
+    let placed = false;
+    for (const [key, val] of Object.entries(root)) {
+        if (key === '$defs') {
+            out[key] = defs;
+            placed = true;
+        }
+        else {
+            out[key] = val;
+        }
+    }
+    if (!placed)
+        out.$defs = defs;
+    return out;
+}
+//# sourceMappingURL=schema-refs.js.map

package/node_modules/@noodle-borg/compiler/dist/manifest/schema-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-refs.js","sourceRoot":"","sources":["../../src/manifest/schema-refs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAW3C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAkB,EAClB,UAAsB,EACtB,IAAY;IAEZ,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,CAAe,CAAC;IAE9F,4FAA4F;IAC5F,MAAM,OAAO,GAA+B,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,KAAK,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAY,CAAC;QACrC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAChC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACpC,+EAA+E;QAC/E,IAAI,UAAU,KAAK,SAAS;YAAE,SAAS;QACvC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,CACzB,UAAU,EACV,WAAW,IAAI,EAAE,EACjB,UAAU,EACV,QAAQ,EACR,MAAM,CACO,CAAC;QAChB,KAAK,MAAM,IAAI,IAAI,QAAQ;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;IAChE,kFAAkF;IAClF,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;IAEjE,MAAM,UAAU,GAAG,SAAS,CAAC,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACnE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;IAEhE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAClB,KAAc,EACd,IAAY,EACZ,UAAsB,EACtB,IAAiB,EACjB,MAAsB;IAEtB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE9D,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,GAAG,IAAI,OAAO,CAAC;QAC/B,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC;QACxB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,oBAAoB;gBAC1B,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,yCAAyC;aACnD,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,oBAAoB;gBAC1B,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,+CAA+C;aACzD,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,gBAAgB,MAAM,wDAAwD;aACxF,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,IAAI,UAAU,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,oBAAoB;gBAC1B,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,2BAA2B,MAAM,uCAAuC;gBACjF,GAAG,EAAE,MAAM;gBACX,GAAG,gBAAgB,CAAC,oBAAoB,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;aAC3E,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,WAAW,MAAM,EAAE,EAAE,CAAC;IACvC,CAAC;IAED,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,SAAS,SAAS,CAChB,IAAgB,EAChB,OAAmC,EACnC,IAAY,EACZ,MAAsB;IAEtB,MAAM,QAAQ,GACZ,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QACjF,CAAC,CAAE,IAAI,CAAC,KAAiC;QACzC,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,MAAM,GAA4B,EAAE,GAAG,QAAQ,EAAE,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,IAAI,IAAI,IAAI,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;YACtF,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,qBAAqB;gBAC3B,IAAI,EAAE,GAAG,IAAI,UAAU,IAAI,EAAE;gBAC7B,OAAO,EAAE,gBAAgB,IAAI,2DAA2D;aACzF,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC;IAC5B,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACxE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,kGAAkG;AAClG,SAAS,QAAQ,CAAC,IAAgB,EAAE,IAA6B;IAC/D,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YAChB,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QACjB,CAAC;IACH,CAAC;IACD,IAAI,CAAC,MAAM;QAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC;IAC9B,OAAO,GAAG,CAAC;AACb,CAAC"}

package/node_modules/@noodle-borg/compiler/dist/manifest/schema.d.ts

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+export declare const manifestSchema: z.ZodObject<{
+    manifestVersion: z.ZodLiteral<"0.2">;
+    server: z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodString;
+        title: z.ZodString;
+    }, z.core.$strip>;
+    connectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strip>>>;
+    schemas: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        annotations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        visibility: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            model: "model";
+            app: "app";
+        }>>>;
+        fulfilment: z.ZodObject<{
+            use: z.ZodOptional<z.ZodString>;
+            args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                if: z.ZodOptional<z.ZodString>;
+                use: z.ZodOptional<z.ZodString>;
+                args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                map: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                elicit: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            output: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    resources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        uri: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        fulfilment: z.ZodObject<{
+            use: z.ZodOptional<z.ZodString>;
+            args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                if: z.ZodOptional<z.ZodString>;
+                use: z.ZodOptional<z.ZodString>;
+                args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                map: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                elicit: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            output: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>>;
+    prompts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        arguments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        fulfilment: z.ZodObject<{
+            use: z.ZodOptional<z.ZodString>;
+            args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                if: z.ZodOptional<z.ZodString>;
+                use: z.ZodOptional<z.ZodString>;
+                args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                map: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                elicit: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            output: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>>;
+    widgets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        tool: z.ZodString;
+        html: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        csp: z.ZodOptional<z.ZodObject<{
+            connectDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            resourceDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            frameDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            baseUriDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        permissions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type Manifest = z.infer<typeof manifestSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/node_modules/@noodle-borg/compiler/dist/manifest/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/manifest/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqKxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/node_modules/@noodle-borg/compiler/dist/manifest/schema.js

@@ -0,0 +1,157 @@
+import { z } from 'zod';
+import { NAME_PATTERN } from './naming.js';
+/**
+ * Zod schema for the minimal `manifestVersion: "0.2"` subset implemented so far.
+ *
+ * This validates the manifest's *static shape*. It covers server identity, tools/resources/prompts with
+ * single-operation or flow fulfilment, the `connectors` block of named connector references that the
+ * resolution pass checks against the catalog, and the `widgets` block (MCP Apps UI resources; ADR 0022).
+ * Other optional top-level blocks (`connections`) are out of scope; unknown keys are stripped, not
+ * rejected, so the schema stays forward-compatible. See docs/SPEC.md "Manifest Reference".
+ */
+const nameSchema = z
+    .string()
+    .regex(NAME_PATTERN, 'must use lowercase letters, numbers, and underscores');
+/** A tenant-authored JSON Schema document. Validated as an object here; deep checks run in compile(). */
+const jsonSchemaSchema = z.record(z.string(), z.unknown());
+/** An expression map (`args`/`map`/`output`): field name to a raw value parsed in the compile pass. */
+const exprMapSchema = z.record(z.string(), z.unknown());
+/**
+ * A flow step. Zod validates only the static shape; the compile pass enforces "exactly one verb"
+ * (`use`/`map`/`elicit`), operation-ref well-formedness, and expression/step-reference validity so
+ * those errors carry precise dotted paths and the step union stays open to a future `compute` verb.
+ */
+const stepSchema = z.object({
+    id: nameSchema,
+    if: z.string().optional(),
+    use: z.string().optional(),
+    args: exprMapSchema.optional(),
+    map: exprMapSchema.optional(),
+    elicit: jsonSchemaSchema.optional(),
+});
+/**
+ * Fulfilment is single-operation (`use` + `args`) sugar OR a flow (`steps` + `output`). Kept
+ * deliberately loose here (all fields optional); the compile pass discriminates on `use` vs `steps`,
+ * rejecting "neither/both" as `invalid_fulfilment`, and parses every expression value.
+ */
+const fulfilmentSchema = z.object({
+    use: z.string().optional(),
+    args: exprMapSchema.optional(),
+    steps: z.array(stepSchema).optional(),
+    output: exprMapSchema.optional(),
+});
+const toolSchema = z.object({
+    name: nameSchema,
+    description: z.string().min(1),
+    inputSchema: jsonSchemaSchema,
+    outputSchema: jsonSchemaSchema.optional(),
+    annotations: z.record(z.string(), z.unknown()).optional(),
+    /**
+     * Tool-surface visibility (SEP-1865 `_meta.ui.visibility`). Default (omitted) = `['model', 'app']`:
+     * the model sees and can call it. `['app']` makes it a **UI-only helper** — hidden from `tools/list`
+     * (the model never sees it) but still callable from a widget via `callServerTool`. This is a
+     * model-surface concern, **not** an authorization boundary (the policy layer remains the gate).
+     */
+    visibility: z
+        .array(z.enum(['model', 'app']))
+        .min(1)
+        .optional(),
+    fulfilment: fulfilmentSchema,
+});
+/**
+ * An MCP resource. Like a tool, it carries a `fulfilment` (it can return a constant or call connectors);
+ * its `uri` is a fixed URI or a simple `{var}` URI template (validated in compile()). The compile pass
+ * classifies fixed vs template and emits the matcher. Resources have no input/output schema — a templated
+ * resource's extracted URI variables are the fulfilment's `input` scope.
+ */
+const resourceSchema = z.object({
+    name: nameSchema,
+    uri: z.string().min(1),
+    title: z.string().min(1).optional(),
+    description: z.string().min(1).optional(),
+    mimeType: z.string().min(1).optional(),
+    fulfilment: fulfilmentSchema,
+});
+/** A prompt argument descriptor (the `prompts/list` shape). Values arrive as strings at `prompts/get`. */
+const promptArgumentSchema = z.object({
+    name: nameSchema,
+    description: z.string().min(1).optional(),
+    required: z.boolean().optional(),
+});
+/**
+ * An MCP prompt. Carries a `fulfilment` whose `input` scope is the supplied `arguments` map; its output
+ * maps to prompt messages (see the protocol layer). `arguments` is the descriptor list for `prompts/list`.
+ */
+const promptSchema = z.object({
+    name: nameSchema,
+    title: z.string().min(1).optional(),
+    description: z.string().min(1).optional(),
+    arguments: z.array(promptArgumentSchema).optional(),
+    fulfilment: fulfilmentSchema,
+});
+const serverSchema = z.object({
+    name: nameSchema,
+    version: z.string().min(1),
+    title: z.string().min(1),
+});
+/**
+ * A CSP source token: an origin or host — optional `https?://` scheme, optional `*.` wildcard label, a
+ * host, optional `:port`. Rejects whitespace, `${…}`, and dangerous schemes (`javascript:`/`data:`) at
+ * author time. These are *host*-enforced (the iframe sandbox), but the compiler must not emit a
+ * syntactically invalid CSP source to the wire (defense-in-depth + author feedback).
+ */
+const cspDomainSchema = z
+    .string()
+    .regex(/^(https?:\/\/)?(\*\.)?[A-Za-z0-9.-]+(:\d+)?$/, 'must be an origin or host (e.g. "https://api.example.com" or "*.example.com")');
+/**
+ * CSP capability metadata for a widget's `ui://` resource. These are the standardized MCP Apps fields
+ * (SEP-1865 `_meta.ui.csp`), enforced by the host iframe sandbox — not by our runtime. Deny-by-default:
+ * a widget reaches only the origins it lists. See docs/spec/apps-and-authoring.md.
+ */
+const widgetCspSchema = z.object({
+    connectDomains: z.array(cspDomainSchema).optional(),
+    resourceDomains: z.array(cspDomainSchema).optional(),
+    frameDomains: z.array(cspDomainSchema).optional(),
+    baseUriDomains: z.array(cspDomainSchema).optional(),
+});
+/**
+ * Upper bound on a widget's inline `html` body. Rich markup + inline CSS/JS is a few KB (the shipped
+ * examples are < 3 KB); the cap bounds artifact size so a single widget cannot bloat the stored/served
+ * artifact. Counted in UTF-16 code units (~bytes for ASCII).
+ */
+const MAX_WIDGET_HTML = 256 * 1024;
+/**
+ * An MCP Apps widget (Phase 2; [ADR 0022](../decisions/0022-adopt-mcp-ui-for-apps-widgets.md)). The
+ * compiler desugars each widget into a fixed `ui://<server>/<name>` resource (mimeType
+ * `text/html;profile=mcp-app`) and stamps the linking `tool`'s `_meta.ui.resourceUri`. `html` is the
+ * self-contained widget body (the raw-`text/html` escape hatch; a declarative `screen` DSL is a later
+ * slice). `csp`/`permissions` ride on the resource's `_meta.ui` as host-enforced capability metadata.
+ */
+const widgetSchema = z.object({
+    name: nameSchema,
+    tool: nameSchema,
+    html: z.string().min(1).max(MAX_WIDGET_HTML),
+    title: z.string().min(1).optional(),
+    description: z.string().min(1).optional(),
+    csp: widgetCspSchema.optional(),
+    permissions: z.record(z.string(), z.boolean()).optional(),
+});
+/**
+ * A named connector reference: the manifest alias (the record key) points to a catalog connector
+ * `id` pinned to a `version`. Operation references (`<connector>.<operation>`) use the alias.
+ */
+const connectorRefSchema = z.object({
+    id: nameSchema,
+    version: z.string().min(1),
+});
+export const manifestSchema = z.object({
+    manifestVersion: z.literal('0.2'),
+    server: serverSchema,
+    connectors: z.record(nameSchema, connectorRefSchema).optional(),
+    schemas: z.record(nameSchema, jsonSchemaSchema).optional(),
+    tools: z.array(toolSchema).min(1),
+    resources: z.array(resourceSchema).optional(),
+    prompts: z.array(promptSchema).optional(),
+    widgets: z.array(widgetSchema).optional(),
+});
+//# sourceMappingURL=schema.js.map

package/node_modules/@noodle-borg/compiler/dist/manifest/schema.js.map

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

package/node_modules/@noodle-borg/compiler/dist/schema-export.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Emit the manifest's own contract as a JSON Schema 2020-12 document, generated natively by Zod 4.
+ * This both publishes the manifest contract and proves the Zod -> 2020-12 path end to end.
+ */
+export declare function manifestJsonSchema(): Record<string, unknown>;
+//# sourceMappingURL=schema-export.d.ts.map

package/node_modules/@noodle-borg/compiler/dist/schema-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-export.d.ts","sourceRoot":"","sources":["../src/schema-export.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE5D"}

package/node_modules/@noodle-borg/compiler/dist/schema-export.js

@@ -0,0 +1,28 @@
+import { realpathSync, writeFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { z } from 'zod';
+import { manifestSchema } from './manifest/schema.js';
+/**
+ * Emit the manifest's own contract as a JSON Schema 2020-12 document, generated natively by Zod 4.
+ * This both publishes the manifest contract and proves the Zod -> 2020-12 path end to end.
+ */
+export function manifestJsonSchema() {
+    return z.toJSONSchema(manifestSchema, { target: 'draft-2020-12' });
+}
+function isInvokedDirectly() {
+    const entry = process.argv[1];
+    if (!entry)
+        return false;
+    try {
+        return realpathSync(entry) === fileURLToPath(import.meta.url);
+    }
+    catch {
+        return false;
+    }
+}
+if (isInvokedDirectly()) {
+    const out = process.argv[2] ?? 'manifest.schema.json';
+    writeFileSync(out, `${JSON.stringify(manifestJsonSchema(), null, 2)}\n`);
+    process.stdout.write(`Wrote ${out}\n`);
+}
+//# sourceMappingURL=schema-export.js.map

package/node_modules/@noodle-borg/compiler/dist/schema-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-export.js","sourceRoot":"","sources":["../src/schema-export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,CAAC,YAAY,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,CAA4B,CAAC;AAChG,CAAC;AAED,SAAS,iBAAiB;IACxB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,KAAK,CAAC,KAAK,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,IAAI,iBAAiB,EAAE,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,sBAAsB,CAAC;IACtD,aAAa,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;AACzC,CAAC"}

package/node_modules/@noodle-borg/compiler/dist/suggest.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Generation-friendly nearest-match suggestions for compile-time reference errors.
+ *
+ * Pure and dependency-free (node builtins only). The compiler attaches `didYouMean` / `suggestions`
+ * (and a stable `docAnchor`) to resolution {@link CompileError}s so a *machine* manifest generator can
+ * self-correct typos in connector aliases, operation names, and schema references without a human in
+ * the loop. See GT-1 in docs/STATUS.md.
+ */
+/**
+ * Levenshtein edit distance between `a` and `b`, capped at `cap`: the true distance when it is
+ * `<= cap`, otherwise `cap + 1`. Single rolling DP row with a per-row early exit, so probing many
+ * far-apart candidates stays cheap. Indices stay within `[0, bl]` by construction; the `?? 0`
+ * fallbacks below only satisfy `noUncheckedIndexedAccess` and are never reached.
+ */
+export declare function boundedDistance(a: string, b: string, cap: number): number;
+/**
+ * The closest candidate to `probe` within the typo threshold, or `undefined` if none is close enough.
+ * Comparison is case-insensitive; ties break to the lexicographically smaller candidate (deterministic).
+ */
+export declare function nearestMatch(probe: string, candidates: readonly string[]): string | undefined;
+/**
+ * Up to `limit` candidates ranked by closeness to `probe` (closest first; ties lexicographic). Unlike
+ * {@link nearestMatch} this is not gated by the typo threshold — it always offers the nearest few as a
+ * candidate set a generator can choose from, even when nothing is a likely single correction.
+ */
+export declare function rankSuggestions(probe: string, candidates: readonly string[], limit?: number): string[];
+/** Optional, generation-friendly fields the compiler attaches to a resolution error. */
+export interface SuggestionFields {
+    readonly didYouMean?: string;
+    readonly suggestions?: readonly string[];
+    readonly docAnchor: string;
+}
+/** A stable, machine-readable docs anchor for an error code (e.g. `compile-errors#unknown-operation`). */
+export declare function docAnchorFor(code: string): string;
+/**
+ * Build the `didYouMean` / `suggestions` / `docAnchor` fields for a reference error against the set of
+ * known identifiers in scope. Omits `didYouMean`/`suggestions` when there is nothing to offer (e.g. no
+ * candidates declared), but always carries a stable `docAnchor`.
+ */
+export declare function suggestionFields(code: string, probe: string, candidates: readonly string[]): SuggestionFields;
+//# sourceMappingURL=suggest.d.ts.map

package/node_modules/@noodle-borg/compiler/dist/suggest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../src/suggest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAyBzE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAc7F;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE,CAcjG;AAED,wFAAwF;AACxF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,0GAA0G;AAC1G,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,gBAAgB,CAQlB"}

package/node_modules/@noodle-borg/compiler/dist/suggest.js

@@ -0,0 +1,105 @@
+/**
+ * Generation-friendly nearest-match suggestions for compile-time reference errors.
+ *
+ * Pure and dependency-free (node builtins only). The compiler attaches `didYouMean` / `suggestions`
+ * (and a stable `docAnchor`) to resolution {@link CompileError}s so a *machine* manifest generator can
+ * self-correct typos in connector aliases, operation names, and schema references without a human in
+ * the loop. See GT-1 in docs/STATUS.md.
+ */
+/** Typo tolerance for a probe of the given length: 1 for short names, up to 3 for long ones. */
+function typoThreshold(length) {
+    return Math.min(3, Math.max(1, Math.floor(length / 3)));
+}
+/**
+ * Levenshtein edit distance between `a` and `b`, capped at `cap`: the true distance when it is
+ * `<= cap`, otherwise `cap + 1`. Single rolling DP row with a per-row early exit, so probing many
+ * far-apart candidates stays cheap. Indices stay within `[0, bl]` by construction; the `?? 0`
+ * fallbacks below only satisfy `noUncheckedIndexedAccess` and are never reached.
+ */
+export function boundedDistance(a, b, cap) {
+    if (a === b)
+        return 0;
+    const al = a.length;
+    const bl = b.length;
+    if (Math.abs(al - bl) > cap)
+        return cap + 1;
+    const row = [];
+    for (let j = 0; j <= bl; j++)
+        row.push(j);
+    for (let i = 1; i <= al; i++) {
+        let diag = i - 1; // row[0] before this row overwrites it = dp[i-1][0]
+        row[0] = i;
+        let rowMin = i;
+        const ai = a.charCodeAt(i - 1);
+        for (let j = 1; j <= bl; j++) {
+            const up = row[j] ?? 0; // dp[i-1][j], before overwrite
+            const left = row[j - 1] ?? 0; // dp[i][j-1], already updated this row
+            const cost = ai === b.charCodeAt(j - 1) ? 0 : 1;
+            const v = Math.min(diag + cost, up + 1, left + 1);
+            diag = up;
+            row[j] = v;
+            if (v < rowMin)
+                rowMin = v;
+        }
+        if (rowMin > cap)
+            return cap + 1;
+    }
+    const d = row[bl] ?? cap + 1;
+    return d <= cap ? d : cap + 1;
+}
+/**
+ * The closest candidate to `probe` within the typo threshold, or `undefined` if none is close enough.
+ * Comparison is case-insensitive; ties break to the lexicographically smaller candidate (deterministic).
+ */
+export function nearestMatch(probe, candidates) {
+    const p = probe.toLowerCase();
+    const threshold = typoThreshold(probe.length);
+    let best;
+    let bestDistance = threshold + 1;
+    for (const candidate of candidates) {
+        const d = boundedDistance(p, candidate.toLowerCase(), threshold);
+        if (d > threshold)
+            continue;
+        if (d < bestDistance || (d === bestDistance && (best === undefined || candidate < best))) {
+            best = candidate;
+            bestDistance = d;
+        }
+    }
+    return best;
+}
+/**
+ * Up to `limit` candidates ranked by closeness to `probe` (closest first; ties lexicographic). Unlike
+ * {@link nearestMatch} this is not gated by the typo threshold — it always offers the nearest few as a
+ * candidate set a generator can choose from, even when nothing is a likely single correction.
+ */
+export function rankSuggestions(probe, candidates, limit = 3) {
+    const p = probe.toLowerCase();
+    return candidates
+        .map((candidate) => ({
+        candidate,
+        distance: boundedDistance(p, candidate.toLowerCase(), Math.max(p.length, candidate.length)),
+    }))
+        .sort((x, y) => x.distance - y.distance ||
+        (x.candidate < y.candidate ? -1 : x.candidate > y.candidate ? 1 : 0))
+        .slice(0, limit)
+        .map((scored) => scored.candidate);
+}
+/** A stable, machine-readable docs anchor for an error code (e.g. `compile-errors#unknown-operation`). */
+export function docAnchorFor(code) {
+    return `compile-errors#${code.replace(/_/g, '-')}`;
+}
+/**
+ * Build the `didYouMean` / `suggestions` / `docAnchor` fields for a reference error against the set of
+ * known identifiers in scope. Omits `didYouMean`/`suggestions` when there is nothing to offer (e.g. no
+ * candidates declared), but always carries a stable `docAnchor`.
+ */
+export function suggestionFields(code, probe, candidates) {
+    const didYouMean = nearestMatch(probe, candidates);
+    const suggestions = rankSuggestions(probe, candidates);
+    return {
+        ...(didYouMean !== undefined ? { didYouMean } : {}),
+        ...(suggestions.length > 0 ? { suggestions } : {}),
+        docAnchor: docAnchorFor(code),
+    };
+}
+//# sourceMappingURL=suggest.js.map

package/node_modules/@noodle-borg/compiler/dist/suggest.js.map

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