noodleseed-cli 0.1.4

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

@@ -0,0 +1,203 @@
+import type { CondNode, ExprNode } from '../manifest/expression.js';
+/**
+ * Version of the runtime-artifact format itself (independent of any tenant manifest version).
+ *
+ * `0.2.0` (Slice 4): `ArtifactTool.operationRef` moved into a fulfilment-centric `fulfilment` field
+ * (operation steps carry their own `operationRef`), and `args`/`output`/`map` values are emitted as
+ * parsed expression ASTs. This is a breaking shape change from `0.1.0`.
+ *
+ * `0.3.0` (Slice 21): additive — optional `resources` and `prompts` arrays (each a fulfilment-backed
+ * entity) and the matching `capabilities.resources`/`capabilities.prompts` name lists.
+ *
+ * `0.4.0` (Slice W1, Apps/widgets): additive — optional `_meta` on {@link ArtifactTool} and
+ * {@link ArtifactResource} (the MCP `_meta` extension bag), and widgets emitted as fixed `ui://` UI
+ * resources (mimeType `text/html;profile=mcp-app`) with the linking tool's `_meta.ui.resourceUri`
+ * stamped (MCP Apps; docs/decisions/0022-adopt-mcp-ui-for-apps-widgets.md). A manifest with no widgets
+ * and no `_meta` compiles to a byte-identical artifact (apart from this version string).
+ */
+export declare const ARTIFACT_SCHEMA_VERSION = "0.4.0";
+/** mimeType for an MCP Apps UI resource (SEP-1865). Widgets are served under this profile. */
+export declare const MCP_APP_MIME_TYPE = "text/html;profile=mcp-app";
+/** A JSON Schema 2020-12 document, passed through from the manifest verbatim. */
+export type JsonSchema = Record<string, unknown>;
+/**
+ * Reference to a connector operation before catalog resolution.
+ *
+ * Emitted by the `shape-only` compile path (no catalog supplied): the operation reference string
+ * `<connector>.<operation>` is parsed, but the alias is NOT resolved against a connector catalog,
+ * so the connector id, connector version, and operation signature hash required by docs/SPEC.md
+ * "Runtime Invariants" are absent.
+ */
+export interface UnresolvedOperationRef {
+    readonly resolved: false;
+    /** The connector alias as written in the operation reference (e.g. `acme`). */
+    readonly connector: string;
+    readonly operation: string;
+}
+/**
+ * Reference to a connector operation after catalog resolution.
+ *
+ * Carries every field docs/SPEC.md "Runtime Invariants" requires: the connector id, the pinned
+ * connector version, the operation name, and the operation signature hash. Produced when a
+ * {@link ConnectorCatalog} is supplied to `compile`.
+ */
+export interface ResolvedOperationRef {
+    readonly resolved: true;
+    /** The connector alias declared in the manifest `connectors` block (e.g. `acme`). */
+    readonly alias: string;
+    /** The catalog connector id the alias points to (e.g. `acme_orders`). */
+    readonly connectorId: string;
+    /** The connector version pinned by the manifest. */
+    readonly connectorVersion: string;
+    readonly operation: string;
+    /** Stable hash of the operation signature: `sha256:<hex>`. See catalog/signature.ts. */
+    readonly signatureHash: string;
+}
+export type OperationRef = UnresolvedOperationRef | ResolvedOperationRef;
+/** A map of field name to parsed value expression (used by `args`, `map`, and `output`). */
+export type ExprMap = Readonly<Record<string, ExprNode>>;
+/**
+ * A single fulfilment step (docs/SPEC.md "Fulfilment Execution"). Discriminated on `kind`; the union
+ * is designed to admit a future `compute` step (sandboxed code, docs/decisions/0004) additively.
+ */
+export type ArtifactStep = {
+    readonly id: string;
+    readonly kind: 'operation';
+    /** Parsed boolean condition; the step is skipped when it evaluates false. */
+    readonly if?: CondNode;
+    readonly operationRef: OperationRef;
+    readonly args: ExprMap;
+} | {
+    readonly id: string;
+    readonly kind: 'elicit';
+    readonly if?: CondNode;
+    /** JSON Schema for the requested input (`$use`-resolved, dialect-stamped). */
+    readonly schema: JsonSchema;
+} | {
+    readonly id: string;
+    readonly kind: 'map';
+    readonly if?: CondNode;
+    readonly value: ExprMap;
+};
+/**
+ * Normalized fulfilment for a tool. `operation` is the single-connector-call sugar; `flow` is an
+ * ordered list of steps with a final output mapping. Each operation (step or single-op) carries its
+ * own {@link OperationRef}, so a `shape-only` artifact leaves them `resolved: false`.
+ */
+export type ArtifactFulfilment = {
+    readonly kind: 'operation';
+    readonly operationRef: OperationRef;
+    readonly args: ExprMap;
+} | {
+    readonly kind: 'flow';
+    readonly steps: readonly ArtifactStep[];
+    readonly output: ExprMap;
+};
+/**
+ * MCP Apps `_meta.ui` metadata (SEP-1865 / [ADR 0022]). On a **tool**, `resourceUri` links it to its UI
+ * widget (`ui://…`). On a **UI resource**, `csp`/`permissions` are the host-enforced capability metadata
+ * (the host iframe sandbox enforces them; our runtime only emits them). Fields are independently optional.
+ */
+export interface WidgetUiMeta {
+    readonly resourceUri?: string;
+    readonly csp?: {
+        readonly connectDomains?: readonly string[] | undefined;
+        readonly resourceDomains?: readonly string[] | undefined;
+        readonly frameDomains?: readonly string[] | undefined;
+        readonly baseUriDomains?: readonly string[] | undefined;
+    };
+    readonly permissions?: Readonly<Record<string, boolean>>;
+    /**
+     * Tool-surface visibility (`['model', 'app']` by default). `['app']` = a UI-only helper tool: hidden
+     * from `tools/list` (the protocol layer filters it) but still callable from a widget. Lives on a
+     * **tool**'s `_meta.ui`, alongside `resourceUri`.
+     */
+    readonly visibility?: readonly ('model' | 'app')[];
+}
+/**
+ * The MCP `_meta` extension bag, emitted verbatim onto a tool/resource wire descriptor. Open by design
+ * (`_meta` is the spec's extension point); the typed `ui` member carries MCP Apps widget metadata.
+ */
+export interface ArtifactMeta {
+    readonly ui?: WidgetUiMeta;
+    readonly [key: string]: unknown;
+}
+export interface ArtifactTool {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: JsonSchema;
+    readonly outputSchema?: JsonSchema;
+    readonly fulfilment: ArtifactFulfilment;
+    /** MCP `_meta` (e.g. MCP Apps `{ ui: { resourceUri } }` linking the tool to its widget). */
+    readonly _meta?: ArtifactMeta;
+}
+/**
+ * A resolved resource. Carries the same normalized {@link ArtifactFulfilment} as a tool. `isTemplate`
+ * records whether `uri` is a `{var}` URI template (then `variables` lists its names, which become the
+ * fulfilment's `input` scope); a fixed resource has `isTemplate: false` and no `variables`.
+ */
+export interface ArtifactResource {
+    readonly name: string;
+    readonly uri: string;
+    readonly title?: string;
+    readonly description?: string;
+    readonly mimeType?: string;
+    readonly isTemplate: boolean;
+    readonly variables?: readonly string[];
+    readonly fulfilment: ArtifactFulfilment;
+    /** MCP `_meta` (e.g. a widget UI resource's `{ ui: { csp, permissions } }` capability metadata). */
+    readonly _meta?: ArtifactMeta;
+}
+/** A prompt argument descriptor (emitted to `prompts/list`). */
+export interface ArtifactPromptArgument {
+    readonly name: string;
+    readonly description?: string;
+    readonly required?: boolean;
+}
+/**
+ * A resolved prompt. Carries the same normalized {@link ArtifactFulfilment} as a tool; its `input` scope
+ * is the supplied `arguments` map, and its output maps to prompt messages in the protocol layer.
+ */
+export interface ArtifactPrompt {
+    readonly name: string;
+    readonly title?: string;
+    readonly description?: string;
+    readonly arguments?: readonly ArtifactPromptArgument[];
+    readonly fulfilment: ArtifactFulfilment;
+}
+export interface ArtifactServer {
+    readonly name: string;
+    readonly version: string;
+    readonly title: string;
+}
+export interface ArtifactSource {
+    readonly manifestName: string;
+    readonly manifestVersion: string;
+}
+export interface ArtifactCapabilities {
+    readonly tools: readonly string[];
+    readonly resources?: readonly string[];
+    readonly prompts?: readonly string[];
+}
+/**
+ * Normalized compiler output loaded by the execution plane.
+ *
+ * `resolution` records how far compilation got. `$use` schema references are resolved in BOTH
+ * cases (it is catalog-independent normalization):
+ * - `shape-only` — static shape validated and normalized and `$use` resolved, but connector
+ *   resolution has not run. Every `operationRef.resolved` is `false`. A runtime must refuse to serve it.
+ * - `resolved` — additionally, every connector alias was resolved against the catalog and every
+ *   `operationRef` carries its connector id, version, and signature hash (docs/SPEC.md "Runtime
+ *   Invariants").
+ */
+export interface RuntimeArtifact {
+    readonly artifactSchemaVersion: string;
+    readonly resolution: 'shape-only' | 'resolved';
+    readonly source: ArtifactSource;
+    readonly server: ArtifactServer;
+    readonly tools: readonly ArtifactTool[];
+    readonly resources?: readonly ArtifactResource[];
+    readonly prompts?: readonly ArtifactPrompt[];
+    readonly capabilities: ArtifactCapabilities;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/artifact/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAE/C,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,8BAA8B,CAAC;AAE7D,iFAAiF;AACjF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,qFAAqF;IACrF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,MAAM,YAAY,GAAG,sBAAsB,GAAG,oBAAoB,CAAC;AAEzE,4FAA4F;AAC5F,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB;IACE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;AAEN;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC3F;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAEjG;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE;QACb,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;QACxD,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;QACzD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;QACtD,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;KACzD,CAAC;IACF,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;CACpD;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,CAAC,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,oGAAoG;IACpG,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;CAC/B;AAED,gEAAgE;AAChE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;CACzC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,YAAY,GAAG,UAAU,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;CAC7C"}

package/node_modules/@noodle-borg/compiler/dist/artifact/types.js

@@ -0,0 +1,20 @@
+/**
+ * Version of the runtime-artifact format itself (independent of any tenant manifest version).
+ *
+ * `0.2.0` (Slice 4): `ArtifactTool.operationRef` moved into a fulfilment-centric `fulfilment` field
+ * (operation steps carry their own `operationRef`), and `args`/`output`/`map` values are emitted as
+ * parsed expression ASTs. This is a breaking shape change from `0.1.0`.
+ *
+ * `0.3.0` (Slice 21): additive — optional `resources` and `prompts` arrays (each a fulfilment-backed
+ * entity) and the matching `capabilities.resources`/`capabilities.prompts` name lists.
+ *
+ * `0.4.0` (Slice W1, Apps/widgets): additive — optional `_meta` on {@link ArtifactTool} and
+ * {@link ArtifactResource} (the MCP `_meta` extension bag), and widgets emitted as fixed `ui://` UI
+ * resources (mimeType `text/html;profile=mcp-app`) with the linking tool's `_meta.ui.resourceUri`
+ * stamped (MCP Apps; docs/decisions/0022-adopt-mcp-ui-for-apps-widgets.md). A manifest with no widgets
+ * and no `_meta` compiles to a byte-identical artifact (apart from this version string).
+ */
+export const ARTIFACT_SCHEMA_VERSION = '0.4.0';
+/** mimeType for an MCP Apps UI resource (SEP-1865). Widgets are served under this profile. */
+export const MCP_APP_MIME_TYPE = 'text/html;profile=mcp-app';
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/artifact/types.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAE/C,8FAA8F;AAC9F,MAAM,CAAC,MAAM,iBAAiB,GAAG,2BAA2B,CAAC"}

package/node_modules/@noodle-borg/compiler/dist/catalog/in-memory.d.ts

@@ -0,0 +1,13 @@
+import type { CatalogConnector, ConnectorCatalog } from './types.js';
+/**
+ * A {@link ConnectorCatalog} backed by an in-memory list of connectors. Suitable for tests and for
+ * compiling against a fixed, known catalog. A persistent / control-plane catalog implements the
+ * same interface and graduates to its own package when real connectors land (see the
+ * implementation log).
+ */
+export declare class InMemoryCatalog implements ConnectorCatalog {
+    private readonly byKey;
+    constructor(connectors: readonly CatalogConnector[]);
+    get(id: string, version: string): CatalogConnector | undefined;
+}
+//# sourceMappingURL=in-memory.d.ts.map

package/node_modules/@noodle-borg/compiler/dist/catalog/in-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../src/catalog/in-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAErE;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwC;gBAElD,UAAU,EAAE,SAAS,gBAAgB,EAAE;IAInD,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;CAG/D"}

package/node_modules/@noodle-borg/compiler/dist/catalog/in-memory.js

@@ -0,0 +1,19 @@
+/**
+ * A {@link ConnectorCatalog} backed by an in-memory list of connectors. Suitable for tests and for
+ * compiling against a fixed, known catalog. A persistent / control-plane catalog implements the
+ * same interface and graduates to its own package when real connectors land (see the
+ * implementation log).
+ */
+export class InMemoryCatalog {
+    byKey;
+    constructor(connectors) {
+        this.byKey = new Map(connectors.map((c) => [key(c.id, c.version), c]));
+    }
+    get(id, version) {
+        return this.byKey.get(key(id, version));
+    }
+}
+function key(id, version) {
+    return `${id}@${version}`;
+}
+//# sourceMappingURL=in-memory.js.map

package/node_modules/@noodle-borg/compiler/dist/catalog/in-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.js","sourceRoot":"","sources":["../../src/catalog/in-memory.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IACT,KAAK,CAAwC;IAE9D,YAAY,UAAuC;QACjD,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,GAAG,CAAC,EAAU,EAAE,OAAe;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1C,CAAC;CACF;AAED,SAAS,GAAG,CAAC,EAAU,EAAE,OAAe;IACtC,OAAO,GAAG,EAAE,IAAI,OAAO,EAAE,CAAC;AAC5B,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { OperationSignature } from './types.js';
+/**
+ * Compute the stable signature hash for a connector operation (docs/SPEC.md "Versioning").
+ *
+ * The hash covers the operation name and its signature (kind + input/output field lists) but NOT
+ * the connector version: two connector versions that expose the same operation signature are
+ * compatible and share a hash, while any signature change yields a new hash. Deterministic for the
+ * same inputs.
+ */
+export declare function computeSignatureHash(operation: string, signature: OperationSignature): string;
+//# sourceMappingURL=signature.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../../src/catalog/signature.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAmBrD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,GAAG,MAAM,CAG7F"}

package/node_modules/@noodle-borg/compiler/dist/catalog/signature.js

@@ -0,0 +1,31 @@
+import { createHash } from 'node:crypto';
+/**
+ * Recursively sort object keys so that semantically identical signatures serialize to identical
+ * JSON regardless of authoring key order. Arrays preserve their order (it is significant); plain
+ * objects are reordered by key. Primitives pass through.
+ */
+function canonicalize(value) {
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (value !== null && typeof value === 'object') {
+        const out = {};
+        for (const key of Object.keys(value).sort()) {
+            out[key] = canonicalize(value[key]);
+        }
+        return out;
+    }
+    return value;
+}
+/**
+ * Compute the stable signature hash for a connector operation (docs/SPEC.md "Versioning").
+ *
+ * The hash covers the operation name and its signature (kind + input/output field lists) but NOT
+ * the connector version: two connector versions that expose the same operation signature are
+ * compatible and share a hash, while any signature change yields a new hash. Deterministic for the
+ * same inputs.
+ */
+export function computeSignatureHash(operation, signature) {
+    const canonical = JSON.stringify(canonicalize({ operation, signature }));
+    return `sha256:${createHash('sha256').update(canonical).digest('hex')}`;
+}
+//# sourceMappingURL=signature.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signature.js","sourceRoot":"","sources":["../../src/catalog/signature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACzD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACvE,GAAG,CAAC,GAAG,CAAC,GAAG,YAAY,CAAE,KAAiC,CAAC,GAAG,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,SAA6B;IACnF,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;IACzE,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC1E,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * Connector catalog contract used by the compiler to resolve operation references.
+ *
+ * The catalog is the source of truth for which connectors exist, at which versions, and what
+ * operations each exposes (docs/SPEC.md "Connector SDK"). The compiler reads it; it never embeds
+ * connector implementation or credentials. This slice models the minimal surface needed to resolve
+ * an operation reference and type-check its mapped arguments; request/response mapping, auth
+ * metadata, pagination, and dynamic options are deferred to later slices.
+ */
+/** Operation kind (docs/SPEC.md "Operations"). `trigger` is out of scope for Phase 1 execution. */
+export type OperationType = 'read' | 'action';
+/** Connector kind (docs/SPEC.md "Connector Kinds"). */
+export type ConnectorKind = 'builtin' | 'catalog' | 'custom';
+/** A single field in an operation's input or output signature. */
+export interface OperationField {
+    /** JSON Schema primitive name, e.g. `string`, `number`, `boolean`, `object`. */
+    readonly type: string;
+    /** Whether the field must be supplied (input) or is always present (output). */
+    readonly required?: boolean;
+}
+/**
+ * An operation's signature: its kind plus its input and output field lists. The signature hash
+ * (catalog/signature.ts) is derived from this and determines operation compatibility
+ * (docs/SPEC.md "Versioning").
+ */
+export interface OperationSignature {
+    readonly type: OperationType;
+    readonly input: Readonly<Record<string, OperationField>>;
+    readonly output: Readonly<Record<string, OperationField>>;
+}
+/** A connector as published in the catalog at a specific version. */
+export interface CatalogConnector {
+    readonly id: string;
+    readonly version: string;
+    readonly kind: ConnectorKind;
+    readonly operations: Readonly<Record<string, OperationSignature>>;
+}
+/** Read-only lookup of connectors by catalog id and pinned version. */
+export interface ConnectorCatalog {
+    /** Return the connector with this id at this exact version, or `undefined` if absent. */
+    get(id: string, version: string): CatalogConnector | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/catalog/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,mGAAmG;AACnG,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE9C,uDAAuD;AACvD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE7D,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;CAC3D;AAED,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;CACnE;AAED,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,yFAAyF;IACzF,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;CAChE"}

package/node_modules/@noodle-borg/compiler/dist/catalog/types.js

@@ -0,0 +1,11 @@
+/**
+ * Connector catalog contract used by the compiler to resolve operation references.
+ *
+ * The catalog is the source of truth for which connectors exist, at which versions, and what
+ * operations each exposes (docs/SPEC.md "Connector SDK"). The compiler reads it; it never embeds
+ * connector implementation or credentials. This slice models the minimal surface needed to resolve
+ * an operation reference and type-check its mapped arguments; request/response mapping, auth
+ * metadata, pagination, and dynamic options are deferred to later slices.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/catalog/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

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

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import { compile } from './compile.js';
+const file = process.argv[2];
+if (!file) {
+    process.stderr.write('usage: noodle-compile <manifest.yaml>\n');
+    process.exit(2);
+}
+const result = compile(readFileSync(file, 'utf8'));
+if (result.ok) {
+    process.stdout.write(`${JSON.stringify(result.artifact, null, 2)}\n`);
+}
+else {
+    for (const err of result.errors) {
+        process.stderr.write(`[${err.code}] ${err.path || '<root>'}: ${err.message}\n`);
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;IACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AACnD,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;IACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AACxE,CAAC;KAAM,CAAC;IACN,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,QAAQ,KAAK,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,50 @@
+import type { ConnectorCatalog } from './catalog/types.js';
+import type { CompileError, CompileResult } from './errors.js';
+export interface CompileOptions {
+    /**
+     * Connector catalog used to resolve operation references. When supplied, the compiler resolves
+     * every connector alias against the catalog and emits a `resolved` artifact (docs/SPEC.md
+     * "Runtime Invariants"). When omitted, it emits a `shape-only` artifact whose operation
+     * references are left unresolved and which a runtime must refuse to serve.
+     */
+    readonly catalog?: ConnectorCatalog;
+}
+/**
+ * Compile a YAML manifest into a normalized runtime artifact.
+ *
+ * Pipeline: parse YAML -> validate static shape (Zod) -> structural passes (duplicate names,
+ * `$use` schema resolution, external `$ref` rejection, fulfilment parsing — flow steps + `${...}`
+ * expressions to AST) -> emit artifact. Expression and `$use` resolution are catalog-independent and
+ * always run. With a catalog in {@link CompileOptions}, connector resolution follows (alias/operation
+ * lookup, argument signature checks) and the artifact is `resolved`; without one it is `shape-only`
+ * (only connector resolution deferred). Returns every error it can find rather than stopping at the
+ * first. See docs/SPEC.md and docs/IMPLEMENTATION-LOG.md.
+ */
+export declare function compile(source: string, options?: CompileOptions): CompileResult;
+/** Result of {@link validateManifest}: whether the manifest conforms, and any errors found. */
+export interface ValidateResult {
+    readonly ok: boolean;
+    /** Empty when `ok` is true. The same {@link CompileError}s {@link compileManifest} would emit. */
+    readonly errors: readonly CompileError[];
+}
+/**
+ * Validate an already-materialized manifest **object** for authoring-contract conformance **without** a
+ * connector catalog: Zod shape validation plus every catalog-independent structural pass (duplicate
+ * names, `$use` resolution, external-`$ref` rejection, fulfilment + `${...}` expression parsing,
+ * URI-template classification, resource/prompt namespacing). Connector-resolution errors (unknown
+ * alias/operation, unused alias, argument signature) are **not** reported here — they require a catalog
+ * and are produced by {@link compile} / {@link compileManifest} with `{ catalog }`.
+ *
+ * This is the stable, in-process contract a *machine* manifest generator targets: an object in,
+ * structured {@link CompileError}s out (carrying GT-1's `didYouMean`/`expected`/`got` where relevant).
+ * To also parse YAML, use {@link compile}; to resolve against a catalog, pass one to
+ * {@link compileManifest}. See GT-2 in docs/STATUS.md. It is a faithful projection of
+ * `compileManifest(raw)` — the artifact is dropped, the error set is identical.
+ */
+export declare function validateManifest(raw: unknown): ValidateResult;
+/**
+ * Compile an already-materialized manifest object into the same normalized runtime artifact emitted by
+ * {@link compile}. This is the shared path for YAML manifests and TypeScript authoring SDK output.
+ */
+export declare function compileManifest(raw: unknown, options?: CompileOptions): CompileResult;
+//# sourceMappingURL=compile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAoB,gBAAgB,EAAsB,MAAM,oBAAoB,CAAC;AACjG,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAgB/D,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAqED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa,CAkBnF;AAED,+FAA+F;AAC/F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,kGAAkG;IAClG,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;CAC1C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAG7D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa,CA6TzF"}