@advertising-chat/mcp 0.2.1 → 0.17.3

package/bin/flow/flowValidator.js

@@ -0,0 +1,179 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFlowPayload = validateFlowPayload;
+exports.propertyPath = propertyPath;
+/**
+ * Client-side flow-creative validation: JSON Schema (ajv) + the graph
+ * invariants G1–G10 from flow-creative-spec.md §2.2.
+ *
+ * Running this *before* POSTing a creative gives the authoring model
+ * immediate, per-property errors it can self-correct from, instead of a
+ * server round trip.
+ */
+const _2020_1 = __importDefault(require("ajv/dist/2020"));
+const ajv_formats_1 = __importDefault(require("ajv-formats"));
+const flowSchema_1 = require("./flowSchema");
+const MAX_DEPTH = 6; // G5: user-visible turns
+const MAX_SPEC_BYTES = 16 * 1024; // G9
+const ajv = new _2020_1.default({ allErrors: true, strict: false });
+(0, ajv_formats_1.default)(ajv);
+const validateSchema = ajv.compile(flowSchema_1.flowSchema);
+/**
+ * Validate a flow payload against the v1 spec: JSON Schema shape first,
+ * then the graph invariants. Returns human/LLM-readable error strings.
+ */
+function validateFlowPayload(flow) {
+    const errors = [];
+    if (!validateSchema(flow)) {
+        for (const err of validateSchema.errors || []) {
+            errors.push(`flow${propertyPath(err.instancePath)}: ${err.message}`);
+        }
+        // Shape is wrong — graph checks would be noise on a malformed spec.
+        return { valid: false, errors: dedupe(errors) };
+    }
+    const spec = flow;
+    // G9: total serialized spec <= 16 KB.
+    const bytes = Buffer.byteLength(JSON.stringify(spec), 'utf8');
+    if (bytes > MAX_SPEC_BYTES) {
+        errors.push(`flow: serialized spec is ${bytes} bytes; must be <= ${MAX_SPEC_BYTES} (16 KB)`);
+    }
+    // G1: node ids unique; choice ids unique within their node.
+    const ids = new Map();
+    spec.nodes.forEach((node, i) => {
+        if (ids.has(node.id)) {
+            errors.push(`flow.nodes[${i}].id: duplicate node id '${node.id}'`);
+        }
+        ids.set(node.id, node);
+        if (node.choices) {
+            const seen = new Set();
+            node.choices.forEach((choice, j) => {
+                if (seen.has(choice.id)) {
+                    errors.push(`flow.nodes[${i}].choices[${j}].id: duplicate choice id '${choice.id}'`);
+                }
+                seen.add(choice.id);
+            });
+        }
+    });
+    // G2: entryNodeId exists and is a message node.
+    const entry = ids.get(spec.entryNodeId);
+    if (!entry) {
+        errors.push(`flow.entryNodeId: unknown node '${spec.entryNodeId}' (must reference an existing node)`);
+    }
+    else if (entry.type !== 'message') {
+        errors.push(`flow.entryNodeId: node '${spec.entryNodeId}' is a '${entry.type}' node; the entry node must be a 'message' node`);
+    }
+    // G3: every edge references an existing node id.
+    const edgesOf = (node) => {
+        const edges = [];
+        if (node.next !== undefined)
+            edges.push({ label: 'next', target: node.next });
+        node.choices?.forEach((c, j) => edges.push({ label: `choices[${j}].target`, target: c.target }));
+        node.intents?.forEach((x, j) => edges.push({ label: `intents[${j}].target`, target: x.target }));
+        if (node.noMatchTarget !== undefined) {
+            edges.push({ label: 'noMatchTarget', target: node.noMatchTarget });
+        }
+        return edges;
+    };
+    spec.nodes.forEach((node, i) => {
+        for (const edge of edgesOf(node)) {
+            if (!ids.has(edge.target)) {
+                errors.push(`flow.nodes[${i}].${edge.label}: unknown node '${edge.target}'`);
+            }
+            else if (edge.target === node.id) {
+                errors.push(`flow.nodes[${i}].${edge.label}: self-edge on '${node.id}' creates a zero-progress loop`);
+            }
+        }
+    });
+    // G7: link_out / handoff / end actions are terminal (no `next`).
+    spec.nodes.forEach((node, i) => {
+        if (node.type === 'action' &&
+            node.next !== undefined &&
+            node.action &&
+            node.action.kind !== 'conversion') {
+            errors.push(`flow.nodes[${i}].next: '${node.action.kind}' actions are terminal; 'next' is only valid after 'conversion'`);
+        }
+    });
+    // G8: disclosureText present and non-empty (schema-enforced, re-checked —
+    // policy invariant, not just shape).
+    if (!spec.metadata?.disclosureText?.trim()) {
+        errors.push('flow.metadata.disclosureText: required and must be non-empty');
+    }
+    // G10: all URLs are https:.
+    const checkHttps = (i, label, url) => {
+        if (url !== undefined && !/^https:\/\//i.test(url)) {
+            errors.push(`flow.nodes[${i}].${label}: url must use https ('${url}')`);
+        }
+    };
+    spec.nodes.forEach((node, i) => {
+        checkHttps(i, 'imageUrl', node.imageUrl);
+        checkHttps(i, 'action.url', node.action?.url);
+    });
+    if (spec.metadata?.brandLogoUrl !== undefined &&
+        !/^https:\/\//i.test(spec.metadata.brandLogoUrl)) {
+        errors.push(`flow.metadata.brandLogoUrl: url must use https ('${spec.metadata.brandLogoUrl}')`);
+    }
+    // Stop before reachability analysis if the graph edges are broken.
+    if (errors.length)
+        return { valid: false, errors: dedupe(errors) };
+    // G5 (v1): the graph must be acyclic, and every path terminates at an
+    // action node within MAX_DEPTH user-visible turns (message/choice-set
+    // presentations count; action nodes don't).
+    // G4: every node reachable from the entry node.
+    const reachable = new Set();
+    const onPath = new Set();
+    let cycle = false;
+    const walk = (id, depth) => {
+        const node = ids.get(id);
+        if (onPath.has(id)) {
+            if (!cycle) {
+                errors.push(`flow: cycle detected through node '${id}' — v1 flow graphs must be acyclic`);
+                cycle = true;
+            }
+            return;
+        }
+        reachable.add(id);
+        const turns = node.type === 'action' ? depth : depth + 1;
+        if (turns > MAX_DEPTH) {
+            errors.push(`flow: path through node '${id}' exceeds maxDepth = ${MAX_DEPTH} user-visible turns`);
+            return;
+        }
+        const edges = edgesOf(node);
+        if (edges.length === 0 && node.type !== 'action') {
+            errors.push(`flow: '${node.type}' node '${id}' has no outgoing edge — every path must terminate at an action node`);
+            return;
+        }
+        onPath.add(id);
+        for (const edge of edges) {
+            walk(edge.target, turns);
+        }
+        onPath.delete(id);
+    };
+    if (entry)
+        walk(spec.entryNodeId, 0);
+    for (const node of spec.nodes) {
+        if (!reachable.has(node.id)) {
+            errors.push(`flow: node '${node.id}' is not reachable from the entry node`);
+        }
+    }
+    return { valid: errors.length === 0, errors: dedupe(errors) };
+}
+/**
+ * An ajv instance path (JSON Pointer, `/nodes/0/text`) in the dotted style
+ * the graph checks use (`.nodes[0].text`), so every error names its property
+ * one way, as the ads service's validator does.
+ */
+function propertyPath(pointer) {
+    return pointer
+        .split('/')
+        .slice(1)
+        .map(segment => segment.replace(/~1/g, '/').replace(/~0/g, '~'))
+        .map(segment => (/^\d+$/.test(segment) ? `[${segment}]` : `.${segment}`))
+        .join('');
+}
+function dedupe(errors) {
+    return [...new Set(errors)];
+}
+//# sourceMappingURL=flowValidator.js.map

package/bin/flow/flowValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowValidator.js","sourceRoot":"","sources":["../../src/flow/flowValidator.ts"],"names":[],"mappings":";;;;;AA4DA,kDAqLC;AAOD,oCAOC;AA/PD;;;;;;;GAOG;AACH,0DAAoC;AACpC,8DAAqC;AACrC,6CAA0C;AAuC1C,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC,yBAAyB;AAC9C,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,KAAK;AAEvC,MAAM,GAAG,GAAG,IAAI,eAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5D,IAAA,qBAAU,EAAC,GAAG,CAAC,CAAC;AAChB,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC,uBAAU,CAAC,CAAC;AAE/C;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,IAAa;IAC/C,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,KAAK,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,OAAO,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,oEAAoE;QACpE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,IAAI,GAAG,IAA2B,CAAC;IAEzC,sCAAsC;IACtC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IAC9D,IAAI,KAAK,GAAG,cAAc,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CACT,4BAA4B,KAAK,sBAAsB,cAAc,UAAU,CAChF,CAAC;IACJ,CAAC;IAED,4DAA4D;IAC5D,MAAM,GAAG,GAAG,IAAI,GAAG,EAAoB,CAAC;IACxC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAC7B,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,4BAA4B,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACrE,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACvB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;YAC/B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;gBACjC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;oBACxB,MAAM,CAAC,IAAI,CACT,cAAc,CAAC,aAAa,CAAC,8BAA8B,MAAM,CAAC,EAAE,GAAG,CACxE,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACtB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,gDAAgD;IAChD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,CAAC,IAAI,CACT,mCAAmC,IAAI,CAAC,WAAW,qCAAqC,CACzF,CAAC;IACJ,CAAC;SAAM,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CACT,2BAA2B,IAAI,CAAC,WAAW,WAAW,KAAK,CAAC,IAAI,iDAAiD,CAClH,CAAC;IACJ,CAAC;IAED,iDAAiD;IACjD,MAAM,OAAO,GAAG,CAAC,IAAc,EAAuC,EAAE;QACtE,MAAM,KAAK,GAAwC,EAAE,CAAC;QACtD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YACzB,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAChE,CAAC;QACF,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAChE,CAAC;QACF,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAC7B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,MAAM,CAAC,IAAI,CACT,cAAc,CAAC,KAAK,IAAI,CAAC,KAAK,mBAAmB,IAAI,CAAC,MAAM,GAAG,CAChE,CAAC;YACJ,CAAC;iBAAM,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;gBACnC,MAAM,CAAC,IAAI,CACT,cAAc,CAAC,KAAK,IAAI,CAAC,KAAK,mBAAmB,IAAI,CAAC,EAAE,gCAAgC,CACzF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,iEAAiE;IACjE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAC7B,IACE,IAAI,CAAC,IAAI,KAAK,QAAQ;YACtB,IAAI,CAAC,IAAI,KAAK,SAAS;YACvB,IAAI,CAAC,MAAM;YACX,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,EACjC,CAAC;YACD,MAAM,CAAC,IAAI,CACT,cAAc,CAAC,YAAY,IAAI,CAAC,MAAM,CAAC,IAAI,iEAAiE,CAC7G,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,qCAAqC;IACrC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;IAC9E,CAAC;IAED,4BAA4B;IAC5B,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,KAAa,EAAE,GAAY,EAAE,EAAE;QAC5D,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,KAAK,0BAA0B,GAAG,IAAI,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAC7B,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzC,UAAU,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IACH,IACE,IAAI,CAAC,QAAQ,EAAE,YAAY,KAAK,SAAS;QACzC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAChD,CAAC;QACD,MAAM,CAAC,IAAI,CACT,oDAAoD,IAAI,CAAC,QAAQ,CAAC,YAAY,IAAI,CACnF,CAAC;IACJ,CAAC;IAED,mEAAmE;IACnE,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IAEnE,sEAAsE;IACtE,sEAAsE;IACtE,4CAA4C;IAC5C,gDAAgD;IAChD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,IAAI,KAAK,GAAG,KAAK,CAAC;IAElB,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,KAAa,EAAQ,EAAE;QAC/C,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC;QAC1B,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,CACT,sCAAsC,EAAE,oCAAoC,CAC7E,CAAC;gBACF,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;YACD,OAAO;QACT,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAElB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;QACzD,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CACT,4BAA4B,EAAE,wBAAwB,SAAS,qBAAqB,CACrF,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjD,MAAM,CAAC,IAAI,CACT,UAAU,IAAI,CAAC,IAAI,WAAW,EAAE,sEAAsE,CACvG,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC,CAAC;IAEF,IAAI,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CACT,eAAe,IAAI,CAAC,EAAE,wCAAwC,CAC/D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,OAAe;IAC1C,OAAO,OAAO;SACX,KAAK,CAAC,GAAG,CAAC;SACV,KAAK,CAAC,CAAC,CAAC;SACR,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;SAC/D,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC;SACxE,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,SAAS,MAAM,CAAC,MAAgB;IAC9B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9B,CAAC"}

package/bin/flow/flowZod.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Zod mirror of the flow-creative JSON Schema (flowSchema.ts), used in the
+ * `create_creative` / `update_creative` tool input schemas so the authoring
+ * model gets the flow structure as guidance for free. The authoritative
+ * validation (including graph invariants) is `validateFlowPayload`.
+ */
+import { z } from 'zod';
+export declare const flowNode: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"message">;
+    text: z.ZodString;
+    smsText: z.ZodOptional<z.ZodString>;
+    imageUrl: z.ZodOptional<z.ZodString>;
+    imageAltText: z.ZodOptional<z.ZodString>;
+    next: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"choice-set">;
+    prompt: z.ZodString;
+    smsPrompt: z.ZodOptional<z.ZodString>;
+    choices: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        target: z.ZodString;
+    }, z.core.$strip>>;
+    intents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        intent: z.ZodString;
+        description: z.ZodString;
+        examples: z.ZodArray<z.ZodString>;
+        target: z.ZodString;
+    }, z.core.$strip>>>;
+    noMatchTarget: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"action">;
+    text: z.ZodOptional<z.ZodString>;
+    action: z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"link_out">;
+        url: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"conversion">;
+        conversionName: z.ZodString;
+        value: z.ZodOptional<z.ZodNumber>;
+        cur: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"handoff">;
+        url: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"end">;
+    }, z.core.$strip>]>;
+    next: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+/**
+ * The flow spec: a bounded advertiser-authored conversation graph
+ * (<=12 nodes, <=6 turns deep, acyclic; see flow-creative-spec v1).
+ */
+export declare const flowPayload: z.ZodObject<{
+    specVersion: z.ZodString;
+    entryNodeId: z.ZodString;
+    metadata: z.ZodObject<{
+        advertiserName: z.ZodString;
+        disclosureText: z.ZodString;
+        brandLogoUrl: z.ZodOptional<z.ZodString>;
+        teaser: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    nodes: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"message">;
+        text: z.ZodString;
+        smsText: z.ZodOptional<z.ZodString>;
+        imageUrl: z.ZodOptional<z.ZodString>;
+        imageAltText: z.ZodOptional<z.ZodString>;
+        next: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"choice-set">;
+        prompt: z.ZodString;
+        smsPrompt: z.ZodOptional<z.ZodString>;
+        choices: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            target: z.ZodString;
+        }, z.core.$strip>>;
+        intents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            intent: z.ZodString;
+            description: z.ZodString;
+            examples: z.ZodArray<z.ZodString>;
+            target: z.ZodString;
+        }, z.core.$strip>>>;
+        noMatchTarget: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"action">;
+        text: z.ZodOptional<z.ZodString>;
+        action: z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"link_out">;
+            url: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"conversion">;
+            conversionName: z.ZodString;
+            value: z.ZodOptional<z.ZodNumber>;
+            cur: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"handoff">;
+            url: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"end">;
+        }, z.core.$strip>]>;
+        next: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">>;
+}, z.core.$strip>;
+export type FlowPayloadInput = z.infer<typeof flowPayload>;

package/bin/flow/flowZod.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flowPayload = exports.flowNode = void 0;
+/**
+ * Zod mirror of the flow-creative JSON Schema (flowSchema.ts), used in the
+ * `create_creative` / `update_creative` tool input schemas so the authoring
+ * model gets the flow structure as guidance for free. The authoritative
+ * validation (including graph invariants) is `validateFlowPayload`.
+ */
+const zod_1 = require("zod");
+const nodeId = zod_1.z
+    .string()
+    .regex(/^[a-z0-9][a-z0-9_-]{0,31}$/)
+    .describe('Node id: lowercase alphanumeric with - or _, max 32 chars.');
+const messageNode = zod_1.z.object({
+    id: nodeId,
+    type: zod_1.z.literal('message'),
+    text: zod_1.z
+        .string()
+        .min(1)
+        .max(640)
+        .describe('Advertiser-authored copy, rendered verbatim.'),
+    smsText: zod_1.z.string().max(320).optional(),
+    imageUrl: zod_1.z.string().optional().describe('https image URL.'),
+    imageAltText: zod_1.z.string().max(200).optional(),
+    next: nodeId
+        .optional()
+        .describe('Unconditional edge to the next node. Message nodes must lead ' +
+        'somewhere; terminals are action nodes.'),
+});
+const choiceSetNode = zod_1.z.object({
+    id: nodeId,
+    type: zod_1.z.literal('choice-set'),
+    prompt: zod_1.z.string().min(1).max(640),
+    smsPrompt: zod_1.z.string().max(320).optional(),
+    choices: zod_1.z
+        .array(zod_1.z.object({
+        id: nodeId,
+        label: zod_1.z.string().min(1).max(25),
+        target: nodeId,
+    }))
+        .min(1)
+        .max(4),
+    intents: zod_1.z
+        .array(zod_1.z.object({
+        intent: zod_1.z.string().regex(/^[a-z0-9_]{1,32}$/),
+        description: zod_1.z
+            .string()
+            .min(1)
+            .max(200)
+            .describe('Natural-language definition of when this NLU edge fires, ' +
+            "written for an LLM, e.g. 'The user asks about price or cost.'"),
+        examples: zod_1.z.array(zod_1.z.string().max(100)).min(1).max(5),
+        target: nodeId,
+    }))
+        .max(4)
+        .optional(),
+    noMatchTarget: nodeId
+        .optional()
+        .describe('Edge taken when free text matches no intent.'),
+});
+const flowAction = zod_1.z.union([
+    zod_1.z.object({
+        kind: zod_1.z.literal('link_out'),
+        url: zod_1.z.string().describe('https URL. Terminal action.'),
+        label: zod_1.z.string().min(1).max(25),
+    }),
+    zod_1.z.object({
+        kind: zod_1.z.literal('conversion'),
+        conversionName: zod_1.z.string().max(64),
+        value: zod_1.z.number().optional(),
+        cur: zod_1.z.string().max(3).optional(),
+    }),
+    zod_1.z.object({
+        kind: zod_1.z.literal('handoff'),
+        url: zod_1.z
+            .string()
+            .describe("https deep link to the advertiser's own conversation surface. " +
+            'Terminal action.'),
+        label: zod_1.z.string().min(1).max(25),
+    }),
+    zod_1.z.object({ kind: zod_1.z.literal('end') }),
+]);
+const actionNode = zod_1.z.object({
+    id: nodeId,
+    type: zod_1.z.literal('action'),
+    text: zod_1.z
+        .string()
+        .max(640)
+        .optional()
+        .describe('Optional closing copy rendered with the action.'),
+    action: flowAction,
+    next: nodeId
+        .optional()
+        .describe("Only valid after a 'conversion' action; link_out/handoff/end are " +
+        'terminal.'),
+});
+exports.flowNode = zod_1.z.discriminatedUnion('type', [
+    messageNode,
+    choiceSetNode,
+    actionNode,
+]);
+/**
+ * The flow spec: a bounded advertiser-authored conversation graph
+ * (<=12 nodes, <=6 turns deep, acyclic; see flow-creative-spec v1).
+ */
+exports.flowPayload = zod_1.z
+    .object({
+    specVersion: zod_1.z
+        .string()
+        .regex(/^1(\.[0-9]+)?$/)
+        .describe("Flow spec version; use '1'."),
+    entryNodeId: nodeId.describe('id of the node where execution starts; must be a message node.'),
+    metadata: zod_1.z.object({
+        advertiserName: zod_1.z.string().min(1).max(80),
+        disclosureText: zod_1.z
+            .string()
+            .min(1)
+            .max(100)
+            .describe("REQUIRED sponsorship disclosure, e.g. 'Sponsored · Acme Coffee'."),
+        brandLogoUrl: zod_1.z.string().optional(),
+        teaser: zod_1.z.string().max(120).optional(),
+        language: zod_1.z.string().optional(),
+    }),
+    nodes: zod_1.z.array(exports.flowNode).min(1).max(12),
+})
+    .describe('Advertiser-authored conversation graph (flow creative spec v1). ' +
+    'Bounded: <=12 nodes, <=4 choices/intents per choice-set, <=6 turns ' +
+    'deep, acyclic, every path ends at an action node, all URLs https.');
+//# sourceMappingURL=flowZod.js.map

package/bin/flow/flowZod.js.map

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

package/bin/format.d.ts

@@ -0,0 +1,14 @@
+/** Default upper bound on one tool result, in characters. */
+export declare const MAX_RESULT_CHARS = 100000;
+export interface ToolResult {
+    [k: string]: unknown;
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/** A successful value. Strings pass through; anything else is JSON. */
+export declare function toToolResult(value: unknown, maxChars?: number): ToolResult;
+/** A failure. API errors keep the status, route, and body, with a hint. */
+export declare function toErrorResult(err: unknown, maxChars?: number): ToolResult;

package/bin/format.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_RESULT_CHARS = void 0;
+exports.toToolResult = toToolResult;
+exports.toErrorResult = toErrorResult;
+/**
+ * Tool results as MCP content: JSON text, capped so one large list cannot
+ * crowd out the conversation.
+ */
+const client_1 = require("./client");
+/** Default upper bound on one tool result, in characters. */
+exports.MAX_RESULT_CHARS = 100_000;
+function cap(text, max) {
+    if (text.length <= max)
+        return text;
+    return `${text.slice(0, max)}\n[truncated: ${text.length - max} more characters; narrow the request]`;
+}
+/** A successful value. Strings pass through; anything else is JSON. */
+function toToolResult(value, maxChars = exports.MAX_RESULT_CHARS) {
+    const text = typeof value === 'string' ? value : JSON.stringify(value ?? null, null, 1);
+    return { content: [{ type: 'text', text: cap(text, maxChars) }] };
+}
+/** A failure. API errors keep the status, route, and body, with a hint. */
+function toErrorResult(err, maxChars = exports.MAX_RESULT_CHARS) {
+    let text;
+    if (err instanceof client_1.ApiError) {
+        text = cap(`Error ${err.status} from ${err.method} /system${err.path}.${hint(err.status)}\n${JSON.stringify(err.body ?? null)}`, maxChars);
+    }
+    else {
+        text = `Error: ${err?.message ?? String(err)}`;
+    }
+    return { content: [{ type: 'text', text }], isError: true };
+}
+function hint(status) {
+    switch (status) {
+        case 401:
+            return ' The session has expired; the user needs to sign in again.';
+        case 403:
+            return ' The user’s role does not permit this; explain that instead of retrying.';
+        case 404:
+            return ' Not found: the id may be wrong or belong to another org.';
+        case 409:
+            return ' Conflict: something still references it, or it already exists. The body says which.';
+        case 422:
+            return ' Invalid input: fix the fields the body names and retry.';
+        default:
+            return '';
+    }
+}
+//# sourceMappingURL=format.js.map

package/bin/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":";;;AAqBA,oCAOC;AAGD,sCAcC;AA7CD;;;GAGG;AACH,qCAAoC;AAEpC,6DAA6D;AAChD,QAAA,gBAAgB,GAAG,OAAO,CAAC;AAQxC,SAAS,GAAG,CAAC,IAAY,EAAE,GAAW;IACpC,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,iBAAiB,IAAI,CAAC,MAAM,GAAG,GAAG,uCAAuC,CAAC;AACxG,CAAC;AAED,uEAAuE;AACvE,SAAgB,YAAY,CAC1B,KAAc,EACd,QAAQ,GAAG,wBAAgB;IAE3B,MAAM,IAAI,GACR,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7E,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AACpE,CAAC;AAED,2EAA2E;AAC3E,SAAgB,aAAa,CAC3B,GAAY,EACZ,QAAQ,GAAG,wBAAgB;IAE3B,IAAI,IAAY,CAAC;IACjB,IAAI,GAAG,YAAY,iBAAQ,EAAE,CAAC;QAC5B,IAAI,GAAG,GAAG,CACR,SAAS,GAAG,CAAC,MAAM,SAAS,GAAG,CAAC,MAAM,WAAW,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,EACpH,QAAQ,CACT,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,UAAW,GAAa,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAC5D,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC9D,CAAC;AAED,SAAS,IAAI,CAAC,MAAc;IAC1B,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,GAAG;YACN,OAAO,4DAA4D,CAAC;QACtE,KAAK,GAAG;YACN,OAAO,0EAA0E,CAAC;QACpF,KAAK,GAAG;YACN,OAAO,2DAA2D,CAAC;QACrE,KAAK,GAAG;YACN,OAAO,sFAAsF,CAAC;QAChG,KAAK,GAAG;YACN,OAAO,0DAA0D,CAAC;QACpE;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}

package/bin/index.d.ts

@@ -1 +1,23 @@
-export { createAdKitServer, describeAd, AdKitServerOptions, SPONSORED_DISCLOSURE, } from './server';
+/**
+ * `@advertising-chat/mcp`: the Advertising.chat tool package.
+ *
+ * - The management tool table (`allTools`, `toolsByName`, `defineTool`) for
+ *   Offer Manager over `/system/offer-manager/*`, run with the user's own
+ *   login. The console copilot imports the same table and runs it in
+ *   process; `createManageServer` registers it on an `McpServer`.
+ * - `createAdKitServer`: the in-chat ads tools (`fetch_ad`, `record_event`),
+ *   run with an org API key.
+ * - `adchat-mcp` (cli.ts) wraps either in stdio.
+ */
+export { ApiError, DEFAULT_API_URL, ManageClient, ManageClientOptions, QueryParams, Surface, } from './client';
+export { DocsIndex, DEFAULT_DOCS_URL, DocPage, DocSearchHit } from './docs';
+export { MAX_RESULT_CHARS, ToolResult, toErrorResult, toToolResult, } from './format';
+export { AnyTool, CAPABILITY_REFUSALS, ROLE_ORDER, RoleFloor, ToolCapability, ToolContext, ToolDef, ToolKind, approvalSentence, defineTool, roleSatisfies, } from './tool';
+export * from './tools';
+export { ManageServerOptions, SERVER_INSTRUCTIONS, annotationsFor, createManageServer, describe, } from './server';
+export { AdKitServerOptions, createAdKitServer } from './serve';
+export { SPONSORED_DISCLOSURE, describeAd } from '@advertising-chat/sdk';
+export { CachedToken, TOKEN_CACHE_PATH, TokenProviderOptions, createTokenProvider, deviceLogin, loadCachedToken, } from './auth';
+export { FLOW_SCHEMA_ID, flowSchema } from './flow/flowSchema';
+export { FlowValidationResult, validateFlowPayload, } from './flow/flowValidator';
+export { VERSION } from './version';

package/bin/index.js

@@ -1,8 +1,69 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SPONSORED_DISCLOSURE = exports.describeAd = exports.createAdKitServer = void 0;
+exports.VERSION = exports.validateFlowPayload = exports.flowSchema = exports.FLOW_SCHEMA_ID = exports.loadCachedToken = exports.deviceLogin = exports.createTokenProvider = exports.TOKEN_CACHE_PATH = exports.describeAd = exports.SPONSORED_DISCLOSURE = exports.createAdKitServer = exports.describe = exports.createManageServer = exports.annotationsFor = exports.SERVER_INSTRUCTIONS = exports.roleSatisfies = exports.defineTool = exports.approvalSentence = exports.ROLE_ORDER = exports.CAPABILITY_REFUSALS = exports.toToolResult = exports.toErrorResult = exports.MAX_RESULT_CHARS = exports.DEFAULT_DOCS_URL = exports.DocsIndex = exports.ManageClient = exports.DEFAULT_API_URL = exports.ApiError = void 0;
+/**
+ * `@advertising-chat/mcp`: the Advertising.chat tool package.
+ *
+ * - The management tool table (`allTools`, `toolsByName`, `defineTool`) for
+ *   Offer Manager over `/system/offer-manager/*`, run with the user's own
+ *   login. The console copilot imports the same table and runs it in
+ *   process; `createManageServer` registers it on an `McpServer`.
+ * - `createAdKitServer`: the in-chat ads tools (`fetch_ad`, `record_event`),
+ *   run with an org API key.
+ * - `adchat-mcp` (cli.ts) wraps either in stdio.
+ */
+var client_1 = require("./client");
+Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return client_1.ApiError; } });
+Object.defineProperty(exports, "DEFAULT_API_URL", { enumerable: true, get: function () { return client_1.DEFAULT_API_URL; } });
+Object.defineProperty(exports, "ManageClient", { enumerable: true, get: function () { return client_1.ManageClient; } });
+var docs_1 = require("./docs");
+Object.defineProperty(exports, "DocsIndex", { enumerable: true, get: function () { return docs_1.DocsIndex; } });
+Object.defineProperty(exports, "DEFAULT_DOCS_URL", { enumerable: true, get: function () { return docs_1.DEFAULT_DOCS_URL; } });
+var format_1 = require("./format");
+Object.defineProperty(exports, "MAX_RESULT_CHARS", { enumerable: true, get: function () { return format_1.MAX_RESULT_CHARS; } });
+Object.defineProperty(exports, "toErrorResult", { enumerable: true, get: function () { return format_1.toErrorResult; } });
+Object.defineProperty(exports, "toToolResult", { enumerable: true, get: function () { return format_1.toToolResult; } });
+var tool_1 = require("./tool");
+Object.defineProperty(exports, "CAPABILITY_REFUSALS", { enumerable: true, get: function () { return tool_1.CAPABILITY_REFUSALS; } });
+Object.defineProperty(exports, "ROLE_ORDER", { enumerable: true, get: function () { return tool_1.ROLE_ORDER; } });
+Object.defineProperty(exports, "approvalSentence", { enumerable: true, get: function () { return tool_1.approvalSentence; } });
+Object.defineProperty(exports, "defineTool", { enumerable: true, get: function () { return tool_1.defineTool; } });
+Object.defineProperty(exports, "roleSatisfies", { enumerable: true, get: function () { return tool_1.roleSatisfies; } });
+__exportStar(require("./tools"), exports);
 var server_1 = require("./server");
-Object.defineProperty(exports, "createAdKitServer", { enumerable: true, get: function () { return server_1.createAdKitServer; } });
-Object.defineProperty(exports, "describeAd", { enumerable: true, get: function () { return server_1.describeAd; } });
-Object.defineProperty(exports, "SPONSORED_DISCLOSURE", { enumerable: true, get: function () { return server_1.SPONSORED_DISCLOSURE; } });
+Object.defineProperty(exports, "SERVER_INSTRUCTIONS", { enumerable: true, get: function () { return server_1.SERVER_INSTRUCTIONS; } });
+Object.defineProperty(exports, "annotationsFor", { enumerable: true, get: function () { return server_1.annotationsFor; } });
+Object.defineProperty(exports, "createManageServer", { enumerable: true, get: function () { return server_1.createManageServer; } });
+Object.defineProperty(exports, "describe", { enumerable: true, get: function () { return server_1.describe; } });
+var serve_1 = require("./serve");
+Object.defineProperty(exports, "createAdKitServer", { enumerable: true, get: function () { return serve_1.createAdKitServer; } });
+var sdk_1 = require("@advertising-chat/sdk");
+Object.defineProperty(exports, "SPONSORED_DISCLOSURE", { enumerable: true, get: function () { return sdk_1.SPONSORED_DISCLOSURE; } });
+Object.defineProperty(exports, "describeAd", { enumerable: true, get: function () { return sdk_1.describeAd; } });
+var auth_1 = require("./auth");
+Object.defineProperty(exports, "TOKEN_CACHE_PATH", { enumerable: true, get: function () { return auth_1.TOKEN_CACHE_PATH; } });
+Object.defineProperty(exports, "createTokenProvider", { enumerable: true, get: function () { return auth_1.createTokenProvider; } });
+Object.defineProperty(exports, "deviceLogin", { enumerable: true, get: function () { return auth_1.deviceLogin; } });
+Object.defineProperty(exports, "loadCachedToken", { enumerable: true, get: function () { return auth_1.loadCachedToken; } });
+var flowSchema_1 = require("./flow/flowSchema");
+Object.defineProperty(exports, "FLOW_SCHEMA_ID", { enumerable: true, get: function () { return flowSchema_1.FLOW_SCHEMA_ID; } });
+Object.defineProperty(exports, "flowSchema", { enumerable: true, get: function () { return flowSchema_1.flowSchema; } });
+var flowValidator_1 = require("./flow/flowValidator");
+Object.defineProperty(exports, "validateFlowPayload", { enumerable: true, get: function () { return flowValidator_1.validateFlowPayload; } });
+var version_1 = require("./version");
+Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return version_1.VERSION; } });
 //# sourceMappingURL=index.js.map

package/bin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAKkB;AAJhB,2GAAA,iBAAiB,OAAA;AACjB,oGAAA,UAAU,OAAA;AAEV,8GAAA,oBAAoB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;GAUG;AACH,mCAOkB;AANhB,kGAAA,QAAQ,OAAA;AACR,yGAAA,eAAe,OAAA;AACf,sGAAA,YAAY,OAAA;AAKd,+BAA4E;AAAnE,iGAAA,SAAS,OAAA;AAAE,wGAAA,gBAAgB,OAAA;AACpC,mCAKkB;AAJhB,0GAAA,gBAAgB,OAAA;AAEhB,uGAAA,aAAa,OAAA;AACb,sGAAA,YAAY,OAAA;AAEd,+BAYgB;AAVd,2GAAA,mBAAmB,OAAA;AACnB,kGAAA,UAAU,OAAA;AAMV,wGAAA,gBAAgB,OAAA;AAChB,kGAAA,UAAU,OAAA;AACV,qGAAA,aAAa,OAAA;AAEf,0CAAwB;AACxB,mCAMkB;AAJhB,6GAAA,mBAAmB,OAAA;AACnB,wGAAA,cAAc,OAAA;AACd,4GAAA,kBAAkB,OAAA;AAClB,kGAAA,QAAQ,OAAA;AAEV,iCAAgE;AAAnC,0GAAA,iBAAiB,OAAA;AAC9C,6CAAyE;AAAhE,2GAAA,oBAAoB,OAAA;AAAE,iGAAA,UAAU,OAAA;AACzC,+BAOgB;AALd,wGAAA,gBAAgB,OAAA;AAEhB,2GAAA,mBAAmB,OAAA;AACnB,mGAAA,WAAW,OAAA;AACX,uGAAA,eAAe,OAAA;AAEjB,gDAA+D;AAAtD,4GAAA,cAAc,OAAA;AAAE,wGAAA,UAAU,OAAA;AACnC,sDAG8B;AAD5B,oHAAA,mBAAmB,OAAA;AAErB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA"}