@advertising-chat/mcp 0.2.1 → 0.17.3

package/bin/flow/flowSchema.d.ts

@@ -0,0 +1,298 @@
+/**
+ * The Advertising.chat Flow Creative JSON Schema (spec v1).
+ *
+ * Source of truth: infrastructure/docs/design/flow-creative-spec.md §2.1.
+ * A flow is a small, bounded, advertiser-authored conversation graph:
+ * message nodes, tappable choices, NLU intent edges, and action nodes.
+ *
+ * CONVERGENCE CONTRACT: this file is maintained byte-for-byte identical in
+ * two repos — ads/src/ads/services/flowSchema.ts (server-side authoring
+ * validation) and adkit/packages/mcp/src/flow/flowSchema.ts
+ * (client-side pre-POST validation). The server MUST accept exactly what
+ * the client accepts; edit both copies together and treat the design doc
+ * §2.1 as the authority when they disagree.
+ */
+export declare const FLOW_SCHEMA_ID = "https://docs.advertising.chat/schemas/flow-creative-1.json";
+export declare const flowSchema: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://docs.advertising.chat/schemas/flow-creative-1.json";
+    readonly title: "Advertising.chat Flow Creative";
+    readonly type: "object";
+    readonly required: readonly ["specVersion", "entryNodeId", "metadata", "nodes"];
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly specVersion: {
+            readonly type: "string";
+            readonly pattern: "^1(\\.[0-9]+)?$";
+            readonly description: string;
+        };
+        readonly entryNodeId: {
+            readonly type: "string";
+            readonly description: "id of the node where execution starts. Must reference a message node.";
+        };
+        readonly metadata: {
+            readonly type: "object";
+            readonly required: readonly ["advertiserName", "disclosureText"];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly advertiserName: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 80;
+                };
+                readonly disclosureText: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 100;
+                    readonly description: string;
+                };
+                readonly brandLogoUrl: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                };
+                readonly teaser: {
+                    readonly type: "string";
+                    readonly maxLength: 120;
+                    readonly description: string;
+                };
+                readonly language: {
+                    readonly type: "string";
+                    readonly default: "en";
+                };
+            };
+        };
+        readonly nodes: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 12;
+            readonly items: {
+                readonly $ref: "#/$defs/node";
+            };
+        };
+    };
+    readonly $defs: {
+        readonly node: {
+            readonly oneOf: readonly [{
+                readonly $ref: "#/$defs/messageNode";
+            }, {
+                readonly $ref: "#/$defs/choiceSetNode";
+            }, {
+                readonly $ref: "#/$defs/actionNode";
+            }];
+        };
+        readonly nodeId: {
+            readonly type: "string";
+            readonly pattern: "^[a-z0-9][a-z0-9_-]{0,31}$";
+        };
+        readonly messageNode: {
+            readonly type: "object";
+            readonly required: readonly ["id", "type", "text"];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly id: {
+                    readonly $ref: "#/$defs/nodeId";
+                };
+                readonly type: {
+                    readonly const: "message";
+                };
+                readonly text: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 640;
+                    readonly description: "Advertiser-authored copy. Executors MUST render verbatim.";
+                };
+                readonly smsText: {
+                    readonly type: "string";
+                    readonly maxLength: 320;
+                    readonly description: "Optional SMS-length variant. If absent, SMS uses `text`.";
+                };
+                readonly imageUrl: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                };
+                readonly imageAltText: {
+                    readonly type: "string";
+                    readonly maxLength: 200;
+                };
+                readonly next: {
+                    readonly $ref: "#/$defs/nodeId";
+                    readonly description: string;
+                };
+            };
+        };
+        readonly choiceSetNode: {
+            readonly type: "object";
+            readonly required: readonly ["id", "type", "prompt", "choices"];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly id: {
+                    readonly $ref: "#/$defs/nodeId";
+                };
+                readonly type: {
+                    readonly const: "choice-set";
+                };
+                readonly prompt: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 640;
+                };
+                readonly smsPrompt: {
+                    readonly type: "string";
+                    readonly maxLength: 320;
+                };
+                readonly choices: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly maxItems: 4;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly required: readonly ["id", "label", "target"];
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly id: {
+                                readonly $ref: "#/$defs/nodeId";
+                            };
+                            readonly label: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 25;
+                            };
+                            readonly target: {
+                                readonly $ref: "#/$defs/nodeId";
+                            };
+                        };
+                    };
+                };
+                readonly intents: {
+                    readonly type: "array";
+                    readonly maxItems: 4;
+                    readonly description: string;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly required: readonly ["intent", "description", "examples", "target"];
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly intent: {
+                                readonly type: "string";
+                                readonly pattern: "^[a-z0-9_]{1,32}$";
+                            };
+                            readonly description: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 200;
+                                readonly description: string;
+                            };
+                            readonly examples: {
+                                readonly type: "array";
+                                readonly minItems: 1;
+                                readonly maxItems: 5;
+                                readonly items: {
+                                    readonly type: "string";
+                                    readonly maxLength: 100;
+                                };
+                            };
+                            readonly target: {
+                                readonly $ref: "#/$defs/nodeId";
+                            };
+                        };
+                    };
+                };
+                readonly noMatchTarget: {
+                    readonly $ref: "#/$defs/nodeId";
+                    readonly description: string;
+                };
+            };
+        };
+        readonly actionNode: {
+            readonly type: "object";
+            readonly required: readonly ["id", "type", "action"];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly id: {
+                    readonly $ref: "#/$defs/nodeId";
+                };
+                readonly type: {
+                    readonly const: "action";
+                };
+                readonly text: {
+                    readonly type: "string";
+                    readonly maxLength: 640;
+                    readonly description: "Optional closing copy rendered with the action.";
+                };
+                readonly action: {
+                    readonly oneOf: readonly [{
+                        readonly type: "object";
+                        readonly required: readonly ["kind", "url", "label"];
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly kind: {
+                                readonly const: "link_out";
+                            };
+                            readonly url: {
+                                readonly type: "string";
+                                readonly format: "uri";
+                            };
+                            readonly label: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 25;
+                            };
+                        };
+                    }, {
+                        readonly type: "object";
+                        readonly required: readonly ["kind", "conversionName"];
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly kind: {
+                                readonly const: "conversion";
+                            };
+                            readonly conversionName: {
+                                readonly type: "string";
+                                readonly maxLength: 64;
+                            };
+                            readonly value: {
+                                readonly type: "number";
+                            };
+                            readonly cur: {
+                                readonly type: "string";
+                                readonly maxLength: 3;
+                            };
+                        };
+                    }, {
+                        readonly type: "object";
+                        readonly required: readonly ["kind", "url", "label"];
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly kind: {
+                                readonly const: "handoff";
+                            };
+                            readonly url: {
+                                readonly type: "string";
+                                readonly format: "uri";
+                                readonly description: string;
+                            };
+                            readonly label: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 25;
+                            };
+                        };
+                    }, {
+                        readonly type: "object";
+                        readonly required: readonly ["kind"];
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly kind: {
+                                readonly const: "end";
+                            };
+                        };
+                    }];
+                };
+                readonly next: {
+                    readonly $ref: "#/$defs/nodeId";
+                    readonly description: string;
+                };
+            };
+        };
+    };
+};

package/bin/flow/flowSchema.js

@@ -0,0 +1,234 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flowSchema = exports.FLOW_SCHEMA_ID = void 0;
+/**
+ * The Advertising.chat Flow Creative JSON Schema (spec v1).
+ *
+ * Source of truth: infrastructure/docs/design/flow-creative-spec.md §2.1.
+ * A flow is a small, bounded, advertiser-authored conversation graph:
+ * message nodes, tappable choices, NLU intent edges, and action nodes.
+ *
+ * CONVERGENCE CONTRACT: this file is maintained byte-for-byte identical in
+ * two repos — ads/src/ads/services/flowSchema.ts (server-side authoring
+ * validation) and adkit/packages/mcp/src/flow/flowSchema.ts
+ * (client-side pre-POST validation). The server MUST accept exactly what
+ * the client accepts; edit both copies together and treat the design doc
+ * §2.1 as the authority when they disagree.
+ */
+exports.FLOW_SCHEMA_ID = 'https://docs.advertising.chat/schemas/flow-creative-1.json';
+exports.flowSchema = {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    $id: exports.FLOW_SCHEMA_ID,
+    title: 'Advertising.chat Flow Creative',
+    type: 'object',
+    required: ['specVersion', 'entryNodeId', 'metadata', 'nodes'],
+    additionalProperties: false,
+    properties: {
+        specVersion: {
+            type: 'string',
+            pattern: '^1(\\.[0-9]+)?$',
+            description: 'Spec major.minor. v1 executors MUST reject an unknown major and ' +
+                'MUST ignore unknown fields introduced by minors.',
+        },
+        entryNodeId: {
+            type: 'string',
+            description: 'id of the node where execution starts. Must reference a message node.',
+        },
+        metadata: {
+            type: 'object',
+            required: ['advertiserName', 'disclosureText'],
+            additionalProperties: false,
+            properties: {
+                advertiserName: { type: 'string', minLength: 1, maxLength: 80 },
+                disclosureText: {
+                    type: 'string',
+                    minLength: 1,
+                    maxLength: 100,
+                    description: 'REQUIRED. Shown/spoken before or with the entry node on every ' +
+                        "surface (e.g. 'Sponsored · Acme Coffee'). Executors MUST NOT " +
+                        'suppress it.',
+                },
+                brandLogoUrl: { type: 'string', format: 'uri' },
+                teaser: {
+                    type: 'string',
+                    maxLength: 120,
+                    description: "One-line invitation used by the web embed's collapsed state " +
+                        "and as optional SMS lead-in. Defaults to the entry node's " +
+                        'text truncated.',
+                },
+                language: { type: 'string', default: 'en' },
+            },
+        },
+        nodes: {
+            type: 'array',
+            minItems: 1,
+            maxItems: 12,
+            items: { $ref: '#/$defs/node' },
+        },
+    },
+    $defs: {
+        node: {
+            oneOf: [
+                { $ref: '#/$defs/messageNode' },
+                { $ref: '#/$defs/choiceSetNode' },
+                { $ref: '#/$defs/actionNode' },
+            ],
+        },
+        nodeId: { type: 'string', pattern: '^[a-z0-9][a-z0-9_-]{0,31}$' },
+        messageNode: {
+            type: 'object',
+            required: ['id', 'type', 'text'],
+            additionalProperties: false,
+            properties: {
+                id: { $ref: '#/$defs/nodeId' },
+                type: { const: 'message' },
+                text: {
+                    type: 'string',
+                    minLength: 1,
+                    maxLength: 640,
+                    description: 'Advertiser-authored copy. Executors MUST render verbatim.',
+                },
+                smsText: {
+                    type: 'string',
+                    maxLength: 320,
+                    description: 'Optional SMS-length variant. If absent, SMS uses `text`.',
+                },
+                imageUrl: { type: 'string', format: 'uri' },
+                imageAltText: { type: 'string', maxLength: 200 },
+                next: {
+                    $ref: '#/$defs/nodeId',
+                    description: 'Unconditional edge. Required unless this node is followed by ' +
+                        'nothing (invalid — message nodes must lead somewhere; ' +
+                        'terminals are action nodes).',
+                },
+            },
+        },
+        choiceSetNode: {
+            type: 'object',
+            required: ['id', 'type', 'prompt', 'choices'],
+            additionalProperties: false,
+            properties: {
+                id: { $ref: '#/$defs/nodeId' },
+                type: { const: 'choice-set' },
+                prompt: { type: 'string', minLength: 1, maxLength: 640 },
+                smsPrompt: { type: 'string', maxLength: 320 },
+                choices: {
+                    type: 'array',
+                    minItems: 1,
+                    maxItems: 4,
+                    items: {
+                        type: 'object',
+                        required: ['id', 'label', 'target'],
+                        additionalProperties: false,
+                        properties: {
+                            id: { $ref: '#/$defs/nodeId' },
+                            label: { type: 'string', minLength: 1, maxLength: 25 },
+                            target: { $ref: '#/$defs/nodeId' },
+                        },
+                    },
+                },
+                intents: {
+                    type: 'array',
+                    maxItems: 4,
+                    description: "NLU edges, executed by the publisher's LLM (AdKit) or by " +
+                        'keyword match on dumb channels. Advisory on SMS.',
+                    items: {
+                        type: 'object',
+                        required: ['intent', 'description', 'examples', 'target'],
+                        additionalProperties: false,
+                        properties: {
+                            intent: { type: 'string', pattern: '^[a-z0-9_]{1,32}$' },
+                            description: {
+                                type: 'string',
+                                minLength: 1,
+                                maxLength: 200,
+                                description: 'Natural-language definition of when this edge fires, ' +
+                                    "written for an LLM. e.g. 'The user asks about price, " +
+                                    "cost, or discounts.'",
+                            },
+                            examples: {
+                                type: 'array',
+                                minItems: 1,
+                                maxItems: 5,
+                                items: { type: 'string', maxLength: 100 },
+                            },
+                            target: { $ref: '#/$defs/nodeId' },
+                        },
+                    },
+                },
+                noMatchTarget: {
+                    $ref: '#/$defs/nodeId',
+                    description: 'Edge taken when free text matches no intent. If absent, ' +
+                        'executors re-present the choices once, then treat a second ' +
+                        "miss as flow_abandon(reason:'no_match').",
+                },
+            },
+        },
+        actionNode: {
+            type: 'object',
+            required: ['id', 'type', 'action'],
+            additionalProperties: false,
+            properties: {
+                id: { $ref: '#/$defs/nodeId' },
+                type: { const: 'action' },
+                text: {
+                    type: 'string',
+                    maxLength: 640,
+                    description: 'Optional closing copy rendered with the action.',
+                },
+                action: {
+                    oneOf: [
+                        {
+                            type: 'object',
+                            required: ['kind', 'url', 'label'],
+                            additionalProperties: false,
+                            properties: {
+                                kind: { const: 'link_out' },
+                                url: { type: 'string', format: 'uri' },
+                                label: { type: 'string', minLength: 1, maxLength: 25 },
+                            },
+                        },
+                        {
+                            type: 'object',
+                            required: ['kind', 'conversionName'],
+                            additionalProperties: false,
+                            properties: {
+                                kind: { const: 'conversion' },
+                                conversionName: { type: 'string', maxLength: 64 },
+                                value: { type: 'number' },
+                                cur: { type: 'string', maxLength: 3 },
+                            },
+                        },
+                        {
+                            type: 'object',
+                            required: ['kind', 'url', 'label'],
+                            additionalProperties: false,
+                            properties: {
+                                kind: { const: 'handoff' },
+                                url: {
+                                    type: 'string',
+                                    format: 'uri',
+                                    description: "Deep link to the advertiser's own conversation surface " +
+                                        '(their bot, WhatsApp, an AnyChat agent, ...).',
+                                },
+                                label: { type: 'string', minLength: 1, maxLength: 25 },
+                            },
+                        },
+                        {
+                            type: 'object',
+                            required: ['kind'],
+                            additionalProperties: false,
+                            properties: { kind: { const: 'end' } },
+                        },
+                    ],
+                },
+                next: {
+                    $ref: '#/$defs/nodeId',
+                    description: 'Optional continuation after a conversion action. link_out / ' +
+                        'handoff / end are terminal; `next` is invalid on them.',
+                },
+            },
+        },
+    },
+};
+//# sourceMappingURL=flowSchema.js.map

package/bin/flow/flowSchema.js.map

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

package/bin/flow/flowValidator.d.ts

@@ -0,0 +1,15 @@
+export interface FlowValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Validate a flow payload against the v1 spec: JSON Schema shape first,
+ * then the graph invariants. Returns human/LLM-readable error strings.
+ */
+export declare function validateFlowPayload(flow: unknown): FlowValidationResult;
+/**
+ * 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.
+ */
+export declare function propertyPath(pointer: string): string;