@growthub/cli 0.6.0 → 0.6.1

package/dist/runtime/cms-capability-registry/index.js

@@ -0,0 +1,183 @@
+/**
+ * CMS Capability Registry Client
+ *
+ * Treats the CMS-backed node/tool definitions as a first-class registry for
+ * the CLI/runtime. This layer lets agents discover:
+ *   - which core node primitives exist
+ *   - which are available to the authenticated user/org
+ *   - how they bind into pipelines
+ *   - what execution shape they require
+ *
+ * Data source:
+ *   - Hosted registry endpoint via HostedExecutionClient
+ *
+ * The registry does NOT reimplement CMS semantics — it exposes them as
+ * CLI/runtime-friendly node records.
+ */
+import { createHostedExecutionClient, } from "../hosted-execution-client/index.js";
+import { readSession, isSessionExpired } from "../../auth/session-store.js";
+import { listHostedWorkflows, fetchHostedWorkflow } from "../../auth/hosted-client.js";
+export { CAPABILITY_FAMILIES } from "./types.js";
+// ---------------------------------------------------------------------------
+// Normalize hosted records to CmsCapabilityNode
+// ---------------------------------------------------------------------------
+function toCapabilityNode(record) {
+    const familyMap = {
+        video: "video",
+        image: "image",
+        slides: "slides",
+        text: "text",
+        data: "data",
+        ops: "ops",
+        research: "research",
+        vision: "vision",
+    };
+    const metadata = (record.metadata ?? {});
+    const executionTokens = (metadata.executionTokens ?? metadata.execution_tokens ?? {});
+    const inputTemplate = (executionTokens.input_template ?? metadata.input_template ?? {});
+    const outputMapping = (executionTokens.output_mapping ?? metadata.output_mapping ?? {});
+    const toolName = typeof executionTokens.tool_name === "string"
+        ? executionTokens.tool_name
+        : typeof metadata.tool_name === "string"
+            ? metadata.tool_name
+            : record.slug;
+    const executionStrategy = typeof (metadata.executionStrategy ?? metadata.execution_strategy) === "string"
+        ? (metadata.executionStrategy ?? metadata.execution_strategy)
+        : "direct";
+    return {
+        slug: record.slug,
+        displayName: record.displayName,
+        icon: typeof metadata.icon === "string" ? metadata.icon : "",
+        family: familyMap[record.family] ?? "ops",
+        category: typeof metadata.category === "string" ? metadata.category : "automation",
+        nodeType: (typeof metadata.nodeType === "string" ? metadata.nodeType : "tool_execution"),
+        executionKind: record.executionKind,
+        executionBinding: { type: "mcp_tool_call", strategy: executionStrategy },
+        executionTokens: {
+            tool_name: toolName,
+            input_template: inputTemplate,
+            output_mapping: outputMapping,
+        },
+        requiredBindings: record.requiredBindings,
+        outputTypes: record.outputTypes,
+        enabled: record.enabled,
+        experimental: Boolean(metadata.experimental),
+        visibility: (typeof metadata.visibility === "string" ? metadata.visibility : "authenticated"),
+        description: typeof metadata.description === "string" ? metadata.description : undefined,
+        manifestMetadata: metadata,
+    };
+}
+function inferFamilyFromSlug(slug) {
+    const normalized = slug.toLowerCase();
+    if (normalized.includes("video"))
+        return "video";
+    if (normalized.includes("image"))
+        return "image";
+    if (normalized.includes("slide"))
+        return "slides";
+    if (normalized.includes("research"))
+        return "research";
+    if (normalized.includes("vision"))
+        return "vision";
+    if (normalized.includes("text") || normalized.includes("llm"))
+        return "text";
+    if (normalized.includes("data"))
+        return "data";
+    return "ops";
+}
+async function deriveCapabilitiesFromHostedWorkflows() {
+    const session = readSession();
+    if (!session || isSessionExpired(session))
+        return [];
+    const list = await listHostedWorkflows(session);
+    const workflows = list?.workflows ?? [];
+    if (workflows.length === 0)
+        return [];
+    const bySlug = new Map();
+    for (const workflow of workflows.slice(0, 50)) {
+        const detail = await fetchHostedWorkflow(session, workflow.workflowId);
+        const nodes = Array.isArray(detail?.latestVersion?.config?.nodes)
+            ? detail?.latestVersion?.config?.nodes
+            : [];
+        for (const node of nodes) {
+            if (node.type !== "cmsNode")
+                continue;
+            const data = (node.data ?? {});
+            const slug = typeof data.slug === "string" ? data.slug : null;
+            if (!slug)
+                continue;
+            const inputs = (data.inputs ?? {});
+            if (!bySlug.has(slug)) {
+                bySlug.set(slug, {
+                    slug,
+                    family: inferFamilyFromSlug(slug),
+                    displayName: slug,
+                    executionKind: "hosted-execute",
+                    requiredBindings: [],
+                    outputTypes: [],
+                    enabled: true,
+                    metadata: {
+                        input_template: inputs,
+                        output_mapping: {},
+                        tool_name: slug,
+                        source: "derived-from-hosted-workflows",
+                    },
+                });
+            }
+        }
+    }
+    return [...bySlug.values()];
+}
+// ---------------------------------------------------------------------------
+// Query filter
+// ---------------------------------------------------------------------------
+function matchesQuery(node, query) {
+    if (query.enabledOnly !== false && !node.enabled)
+        return false;
+    if (query.family && node.family !== query.family)
+        return false;
+    if (query.executionKind && node.executionKind !== query.executionKind)
+        return false;
+    if (query.outputType && !node.outputTypes.includes(query.outputType))
+        return false;
+    if (query.slug && !node.slug.includes(query.slug))
+        return false;
+    if (query.search) {
+        const term = query.search.toLowerCase();
+        const haystack = `${node.slug} ${node.displayName} ${node.description ?? ""} ${node.category}`.toLowerCase();
+        if (!haystack.includes(term))
+            return false;
+    }
+    return true;
+}
+export function createCmsCapabilityRegistryClient() {
+    return {
+        async listCapabilities(query) {
+            const executionClient = createHostedExecutionClient();
+            let hostedRecords = await executionClient.getHostedCapabilities();
+            if (hostedRecords.length === 0) {
+                hostedRecords = await deriveCapabilitiesFromHostedWorkflows();
+            }
+            if (hostedRecords.length === 0) {
+                throw new Error("Hosted capability registry returned zero nodes. No local fallback is enabled.");
+            }
+            const nodes = hostedRecords.map(toCapabilityNode);
+            const enabledCount = nodes.filter((n) => n.enabled).length;
+            const filtered = query ? nodes.filter((n) => matchesQuery(n, query)) : nodes;
+            return {
+                nodes: filtered,
+                meta: {
+                    total: nodes.length,
+                    enabledCount,
+                    fetchedAt: new Date().toISOString(),
+                    source: "hosted",
+                },
+            };
+        },
+        async getCapability(slug) {
+            const { nodes } = await this.listCapabilities({ slug, enabledOnly: false });
+            return nodes.find((n) => n.slug === slug) ?? null;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/runtime/cms-capability-registry/index.js.map

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

package/dist/runtime/cms-capability-registry/types.d.ts

@@ -0,0 +1,109 @@
+/**
+ * CMS Capability Registry — Type Definitions
+ *
+ * First-class registry types for CMS-backed node primitives.
+ * These mirror the real production `workflow_node` content_type from the
+ * hosted CMS so the CLI can discover, inspect, and use them as starter
+ * templates for dynamic pipeline assembly.
+ */
+export type CapabilityFamily = "video" | "image" | "slides" | "text" | "data" | "ops" | "research" | "vision";
+export declare const CAPABILITY_FAMILIES: readonly CapabilityFamily[];
+export type CapabilityExecutionKind = "hosted-execute" | "provider-assembly" | "local-only";
+export type CmsNodeType = "tool_execution" | "cms_workflow";
+export type CmsVisibility = "public" | "authenticated" | "admin";
+export interface CmsExecutionBinding {
+    type: "mcp_tool_call";
+    strategy: "direct" | "sequential-with-persistence" | "async_operation";
+    timeoutMs?: number;
+    max_retries?: number;
+    polling_interval?: number;
+}
+export interface CmsExecutionTokens {
+    tool_name: string;
+    input_template: Record<string, unknown>;
+    output_mapping: Record<string, unknown>;
+    endpoint_config?: {
+        env_var?: string;
+        endpoint_type?: string;
+    };
+    migration_version?: string;
+}
+export interface CmsCapabilityNode {
+    /** Unique slug identifying this capability (e.g. "video-generation", "llm-text-generation"). */
+    slug: string;
+    /** Human-readable display name. */
+    displayName: string;
+    /** Icon emoji for the node. */
+    icon: string;
+    /** Capability family classification. */
+    family: CapabilityFamily;
+    /** CMS category (e.g. "automation", "media_generation"). */
+    category: string;
+    /** CMS node type. */
+    nodeType: CmsNodeType;
+    /** How this node executes. */
+    executionKind: CapabilityExecutionKind;
+    /** Execution binding configuration. */
+    executionBinding: CmsExecutionBinding;
+    /** Execution tokens with input template and output mapping. */
+    executionTokens: CmsExecutionTokens;
+    /** Binding keys required before execution (provider keys, connection refs). */
+    requiredBindings: string[];
+    /** Output artifact types this node can produce. */
+    outputTypes: string[];
+    /** Whether this node is enabled for the current user/org. */
+    enabled: boolean;
+    /** Whether this is experimental. */
+    experimental: boolean;
+    /** Visibility level. */
+    visibility: CmsVisibility;
+    /** Optional description. */
+    description?: string;
+    /** Opaque CMS metadata forwarded from the registry. */
+    manifestMetadata?: Record<string, unknown>;
+}
+export interface CmsConnectorNode {
+    /** Unique slug. */
+    slug: string;
+    /** Display name. */
+    displayName: string;
+    /** Icon path or emoji. */
+    icon: string;
+    /** Auth type (e.g. "oauth_first_party", "api_token"). */
+    authType: string;
+    /** Tool slugs owned by this connector. */
+    tools: string[];
+    /** Description. */
+    description?: string;
+    /** Long description. */
+    longDescription?: string;
+    /** Whether this connector is active. */
+    enabled: boolean;
+    /** Provider identifier. */
+    mcpProvider: string;
+}
+export interface CapabilityQuery {
+    /** Filter by family. */
+    family?: CapabilityFamily;
+    /** Filter by slug substring (fuzzy). */
+    slug?: string;
+    /** Filter by execution kind. */
+    executionKind?: CapabilityExecutionKind;
+    /** Filter by output type. */
+    outputType?: string;
+    /** Only return enabled capabilities. Defaults to true. */
+    enabledOnly?: boolean;
+    /** Text search across slug, displayName, description. */
+    search?: string;
+}
+export interface CapabilityRegistryMeta {
+    /** Total capabilities in the registry. */
+    total: number;
+    /** Number of capabilities enabled for the current user. */
+    enabledCount: number;
+    /** ISO timestamp of registry data freshness. */
+    fetchedAt: string;
+    /** Source of the data. */
+    source: "hosted";
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/cms-capability-registry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/cms-capability-registry/types.ts"],"names":[],"mappings":"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"}

package/dist/runtime/cms-capability-registry/types.js

@@ -0,0 +1,19 @@
+/**
+ * CMS Capability Registry — Type Definitions
+ *
+ * First-class registry types for CMS-backed node primitives.
+ * These mirror the real production `workflow_node` content_type from the
+ * hosted CMS so the CLI can discover, inspect, and use them as starter
+ * templates for dynamic pipeline assembly.
+ */
+export const CAPABILITY_FAMILIES = [
+    "video",
+    "image",
+    "slides",
+    "text",
+    "data",
+    "ops",
+    "research",
+    "vision",
+];
+//# sourceMappingURL=types.js.map

package/dist/runtime/cms-capability-registry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/runtime/cms-capability-registry/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,CAAC,MAAM,mBAAmB,GAAgC;IAC9D,OAAO;IACP,OAAO;IACP,QAAQ;IACR,MAAM;IACN,MAAM;IACN,KAAK;IACL,UAAU;IACV,QAAQ;CACA,CAAC"}

package/dist/runtime/cms-node-contracts/compile.d.ts

@@ -0,0 +1,6 @@
+import type { CompiledHostedWorkflowConfig, PipelineLike } from "./types.js";
+export declare function inferWorkflowName(pipeline: PipelineLike): string;
+export declare function compileToHostedWorkflowConfig(pipeline: PipelineLike, opts?: {
+    workflowName?: string;
+}): CompiledHostedWorkflowConfig;
+//# sourceMappingURL=compile.d.ts.map

package/dist/runtime/cms-node-contracts/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../src/runtime/cms-node-contracts/compile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAMhE;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,YAAY,EACtB,IAAI,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,4BAA4B,CAuD9B"}

package/dist/runtime/cms-node-contracts/compile.js

@@ -0,0 +1,57 @@
+export function inferWorkflowName(pipeline) {
+    const metadataName = pipeline.metadata?.workflowName;
+    if (typeof metadataName === "string" && metadataName.trim().length > 0) {
+        return metadataName.trim();
+    }
+    return pipeline.pipelineId?.trim() || `${pipeline.nodes[0]?.slug ?? "workflow"} workflow`;
+}
+export function compileToHostedWorkflowConfig(pipeline, opts) {
+    const cmsNodes = pipeline.nodes.map((node, index) => ({
+        id: node.id,
+        type: "cmsNode",
+        position: { x: (index + 1) * 300, y: 0 },
+        data: {
+            slug: node.slug,
+            inputs: node.bindings,
+        },
+    }));
+    const edges = [];
+    for (const node of pipeline.nodes) {
+        const upstreamNodeIds = node.upstreamNodeIds ?? [];
+        if (upstreamNodeIds.length === 0) {
+            edges.push({
+                id: `e-start-1-${node.id}`,
+                source: "start-1",
+                target: node.id,
+            });
+            continue;
+        }
+        for (const upstreamNodeId of upstreamNodeIds) {
+            edges.push({
+                id: `e-${upstreamNodeId}-${node.id}`,
+                source: upstreamNodeId,
+                target: node.id,
+            });
+        }
+    }
+    const upstreamSources = new Set(pipeline.nodes.flatMap((node) => node.upstreamNodeIds ?? []));
+    for (const node of pipeline.nodes) {
+        if (!upstreamSources.has(node.id)) {
+            edges.push({
+                id: `e-${node.id}-end-1`,
+                source: node.id,
+                target: "end-1",
+            });
+        }
+    }
+    return {
+        name: opts?.workflowName ?? inferWorkflowName(pipeline),
+        nodes: [
+            { id: "start-1", type: "start", position: { x: 0, y: 0 }, data: {} },
+            ...cmsNodes,
+            { id: "end-1", type: "end", position: { x: (cmsNodes.length + 1) * 300, y: 0 }, data: {} },
+        ],
+        edges,
+    };
+}
+//# sourceMappingURL=compile.js.map

package/dist/runtime/cms-node-contracts/compile.js.map

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

package/dist/runtime/cms-node-contracts/index.d.ts

@@ -0,0 +1,6 @@
+export type { NodeInputFieldContract, NodeOutputFieldContract, NodeContractSummary, NormalizedBindings, ContractValidationResult, PipelineLike, PipelineLikeNode, CompiledHostedWorkflowConfig, PreExecutionSummary, PreExecutionNodeSummary, PreExecutionSummaryInput, } from "./types.js";
+export { introspectNodeContract, humanizeFieldKey, } from "./introspect.js";
+export { normalizeNodeBindings, validateNodeBindings, } from "./normalize.js";
+export { inferWorkflowName, compileToHostedWorkflowConfig, } from "./compile.js";
+export { renderContractCard, buildPreExecutionSummary, renderPreExecutionSummary, renderPreSaveReview, } from "./presenter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/cms-node-contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/cms-node-contracts/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,YAAY,EACZ,gBAAgB,EAChB,4BAA4B,EAC5B,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,6BAA6B,GAC9B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/runtime/cms-node-contracts/index.js

@@ -0,0 +1,5 @@
+export { introspectNodeContract, humanizeFieldKey, } from "./introspect.js";
+export { normalizeNodeBindings, validateNodeBindings, } from "./normalize.js";
+export { inferWorkflowName, compileToHostedWorkflowConfig, } from "./compile.js";
+export { renderContractCard, buildPreExecutionSummary, renderPreExecutionSummary, renderPreSaveReview, } from "./presenter.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/cms-node-contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/cms-node-contracts/index.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,6BAA6B,GAC9B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/runtime/cms-node-contracts/introspect.d.ts

@@ -0,0 +1,5 @@
+import type { CmsCapabilityNode } from "../cms-capability-registry/index.js";
+import type { NodeContractSummary } from "./types.js";
+export declare function humanizeFieldKey(key: string): string;
+export declare function introspectNodeContract(node: CmsCapabilityNode): NodeContractSummary;
+//# sourceMappingURL=introspect.d.ts.map

package/dist/runtime/cms-node-contracts/introspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../../../src/runtime/cms-node-contracts/introspect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,KAAK,EAEV,mBAAmB,EAGpB,MAAM,YAAY,CAAC;AAmBpB,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,iBAAiB,GAAG,mBAAmB,CAiCnF"}

package/dist/runtime/cms-node-contracts/introspect.js

@@ -0,0 +1,61 @@
+function toFieldType(value) {
+    if (Array.isArray(value))
+        return "array";
+    if (typeof value === "string")
+        return "string";
+    if (typeof value === "number")
+        return "number";
+    if (typeof value === "boolean")
+        return "boolean";
+    if (value && typeof value === "object")
+        return "object";
+    return "unknown";
+}
+function outputTypeFromSchema(value) {
+    if (typeof value === "string")
+        return value;
+    if (value && typeof value === "object" && typeof value.type === "string") {
+        return value.type;
+    }
+    return toFieldType(value);
+}
+export function humanizeFieldKey(key) {
+    return key
+        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+        .replace(/[_-]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .replace(/^\w/, (c) => c.toUpperCase());
+}
+export function introspectNodeContract(node) {
+    const inputTemplate = node.executionTokens.input_template ?? {};
+    const outputMapping = node.executionTokens.output_mapping ?? {};
+    const inputs = Object.entries(inputTemplate).map(([key, value]) => {
+        const required = value === "" || value === null || value === undefined;
+        return {
+            key,
+            label: humanizeFieldKey(key),
+            type: toFieldType(value),
+            required,
+            defaultValue: value,
+        };
+    });
+    const outputs = Object.entries(outputMapping).map(([key, value]) => ({
+        key,
+        type: outputTypeFromSchema(value),
+        required: false,
+    }));
+    return {
+        slug: node.slug,
+        displayName: node.displayName,
+        family: node.family,
+        nodeType: node.nodeType,
+        executionKind: node.executionKind,
+        executionStrategy: node.executionBinding.strategy,
+        requiredBindings: node.requiredBindings ?? [],
+        outputTypes: node.outputTypes ?? [],
+        inputs,
+        outputs,
+    };
+}
+//# sourceMappingURL=introspect.js.map

package/dist/runtime/cms-node-contracts/introspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.js","sourceRoot":"","sources":["../../../src/runtime/cms-node-contracts/introspect.ts"],"names":[],"mappings":"AAQA,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/C,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACxD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACjG,OAAQ,KAA0B,CAAC,IAAI,CAAC;IAC1C,CAAC;IACD,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,GAAG;SACP,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE;SACN,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAuB;IAC5D,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC,cAAc,IAAI,EAAE,CAAC;IAChE,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC,cAAc,IAAI,EAAE,CAAC;IAEhE,MAAM,MAAM,GAA6B,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC1F,MAAM,QAAQ,GAAG,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;QACvE,OAAO;YACL,GAAG;YACH,KAAK,EAAE,gBAAgB,CAAC,GAAG,CAAC;YAC5B,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC;YACxB,QAAQ;YACR,YAAY,EAAE,KAAK;SACpB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAA8B,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9F,GAAG;QACH,IAAI,EAAE,oBAAoB,CAAC,KAAK,CAAC;QACjC,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,iBAAiB,EAAE,IAAI,CAAC,gBAAgB,CAAC,QAAQ;QACjD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,EAAE;QAC7C,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;QACnC,MAAM;QACN,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/runtime/cms-node-contracts/normalize.d.ts

@@ -0,0 +1,5 @@
+import type { CmsCapabilityNode } from "../cms-capability-registry/index.js";
+import type { ContractValidationResult, NormalizedBindings } from "./types.js";
+export declare function normalizeNodeBindings(rawBindings: Record<string, unknown> | undefined, node: CmsCapabilityNode): NormalizedBindings;
+export declare function validateNodeBindings(normalizedBindings: Record<string, unknown>, node: CmsCapabilityNode): ContractValidationResult;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/runtime/cms-node-contracts/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/runtime/cms-node-contracts/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAG7E,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAiDpB,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAChD,IAAI,EAAE,iBAAiB,GACtB,kBAAkB,CAiCpB;AAED,wBAAgB,oBAAoB,CAClC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3C,IAAI,EAAE,iBAAiB,GACtB,wBAAwB,CAkC1B"}

package/dist/runtime/cms-node-contracts/normalize.js

@@ -0,0 +1,112 @@
+import { isPlaceholderString } from "../hosted-execution-client/index.js";
+import { introspectNodeContract } from "./introspect.js";
+function sanitizeValue(value) {
+    if (typeof value === "string") {
+        return isPlaceholderString(value) ? "" : value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry) => sanitizeValue(entry));
+    }
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, sanitizeValue(entry)]));
+    }
+    return value;
+}
+function coerceValue(value, templateValue) {
+    if (templateValue === undefined)
+        return value;
+    if (typeof templateValue === "number") {
+        if (typeof value === "number")
+            return value;
+        if (typeof value === "string" && value.trim().length > 0 && !Number.isNaN(Number(value))) {
+            return Number(value);
+        }
+        return templateValue;
+    }
+    if (typeof templateValue === "boolean") {
+        if (typeof value === "boolean")
+            return value;
+        if (typeof value === "string") {
+            if (value.toLowerCase() === "true")
+                return true;
+            if (value.toLowerCase() === "false")
+                return false;
+        }
+        return templateValue;
+    }
+    if (Array.isArray(templateValue)) {
+        return Array.isArray(value) ? value : templateValue;
+    }
+    if (templateValue && typeof templateValue === "object") {
+        if (value && typeof value === "object" && !Array.isArray(value))
+            return value;
+        return templateValue;
+    }
+    return value;
+}
+export function normalizeNodeBindings(rawBindings, node) {
+    const template = node.executionTokens.input_template ?? {};
+    const incoming = rawBindings ?? {};
+    const merged = {};
+    let providedCount = 0;
+    let defaultedCount = 0;
+    let normalizedCount = 0;
+    for (const [key, templateValue] of Object.entries(template)) {
+        const hasIncoming = Object.prototype.hasOwnProperty.call(incoming, key);
+        const rawValue = hasIncoming ? incoming[key] : templateValue;
+        const sanitized = sanitizeValue(rawValue);
+        const coerced = coerceValue(sanitized, templateValue);
+        merged[key] = coerced;
+        if (hasIncoming)
+            providedCount += 1;
+        if (!hasIncoming)
+            defaultedCount += 1;
+        if (sanitized !== rawValue || coerced !== sanitized)
+            normalizedCount += 1;
+    }
+    for (const [key, value] of Object.entries(incoming)) {
+        if (!(key in merged)) {
+            merged[key] = sanitizeValue(value);
+            providedCount += 1;
+        }
+    }
+    return {
+        bindings: merged,
+        providedCount,
+        defaultedCount,
+        normalizedCount,
+    };
+}
+export function validateNodeBindings(normalizedBindings, node) {
+    const contract = introspectNodeContract(node);
+    const missingRequiredInputs = [];
+    const missingRequiredBindings = [];
+    for (const input of contract.inputs) {
+        if (!input.required)
+            continue;
+        const value = normalizedBindings[input.key];
+        if (value === undefined || value === null || value === "") {
+            missingRequiredInputs.push(input.key);
+        }
+    }
+    for (const key of contract.requiredBindings) {
+        const value = normalizedBindings[key];
+        if (value === undefined || value === null || value === "") {
+            missingRequiredBindings.push(key);
+        }
+    }
+    const warnings = [];
+    if (missingRequiredBindings.length > 0) {
+        warnings.push(`Missing required bindings: ${missingRequiredBindings.join(", ")}`);
+    }
+    if (missingRequiredInputs.length > 0) {
+        warnings.push(`Missing required inputs: ${missingRequiredInputs.join(", ")}`);
+    }
+    return {
+        valid: missingRequiredBindings.length === 0 && missingRequiredInputs.length === 0,
+        missingRequiredInputs,
+        missingRequiredBindings,
+        warnings,
+    };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/runtime/cms-node-contracts/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/runtime/cms-node-contracts/normalize.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAMzD,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACjD,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CACzE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,KAAc,EAAE,aAAsB;IACzD,IAAI,aAAa,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAE9C,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACtC,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACzF,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,OAAO,aAAa,KAAK,SAAS,EAAE,CAAC;QACvC,IAAI,OAAO,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM;gBAAE,OAAO,IAAI,CAAC;YAChD,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO;gBAAE,OAAO,KAAK,CAAC;QACpD,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC;IACtD,CAAC;IAED,IAAI,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACvD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC9E,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,WAAgD,EAChD,IAAuB;IAEvB,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,cAAc,IAAI,EAAE,CAAC;IAC3D,MAAM,QAAQ,GAAG,WAAW,IAAI,EAAE,CAAC;IACnC,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,KAAK,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5D,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;QAC7D,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACtD,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;QAEtB,IAAI,WAAW;YAAE,aAAa,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,WAAW;YAAE,cAAc,IAAI,CAAC,CAAC;QACtC,IAAI,SAAS,KAAK,QAAQ,IAAI,OAAO,KAAK,SAAS;YAAE,eAAe,IAAI,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YACnC,aAAa,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,MAAM;QAChB,aAAa;QACb,cAAc;QACd,eAAe;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,kBAA2C,EAC3C,IAAuB;IAEvB,MAAM,QAAQ,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,qBAAqB,GAAa,EAAE,CAAC;IAC3C,MAAM,uBAAuB,GAAa,EAAE,CAAC;IAE7C,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,CAAC,QAAQ;YAAE,SAAS;QAC9B,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC1D,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC1D,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,uBAAuB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,8BAA8B,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,4BAA4B,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,OAAO;QACL,KAAK,EAAE,uBAAuB,CAAC,MAAM,KAAK,CAAC,IAAI,qBAAqB,CAAC,MAAM,KAAK,CAAC;QACjF,qBAAqB;QACrB,uBAAuB;QACvB,QAAQ;KACT,CAAC;AACJ,CAAC"}