@advertising-chat/mcp 0.2.1 → 0.17.3

package/bin/tools/network.d.ts

@@ -0,0 +1,5 @@
+/** What the agent's network enrollment means. */
+export declare const NETWORK_STATUS_MEANINGS: Record<string, string>;
+export declare const getNetworkStatus: import("../tool").AnyTool;
+export declare const setNetworkAds: import("../tool").AnyTool;
+export declare const networkTools: import("../tool").AnyTool[];

package/bin/tools/network.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.networkTools = exports.setNetworkAds = exports.getNetworkStatus = exports.NETWORK_STATUS_MEANINGS = void 0;
+/**
+ * Ads from the network, per agent: one switch that turns the network's
+ * ads on or off at chosen moments of the agent
+ * (`/system/offer-manager/application/:id/network`). Any workspace may use
+ * it; the server owns the agent's network rule and enrollment.
+ */
+const zod_1 = require("zod");
+const tool_1 = require("../tool");
+const shared_1 = require("./shared");
+/** What the agent's network enrollment means. */
+exports.NETWORK_STATUS_MEANINGS = {
+    none: 'Not enrolled: ads from the network are off for this agent.',
+    pending: 'Enrolled and waiting for approval; no network ads appear yet.',
+    approved: 'Approved: network ads can appear at the chosen moments.',
+    rejected: 'The network declined this agent; no network ads appear. Our team can say why.',
+};
+const momentRef = (m) => ({
+    id: (0, shared_1.str)(m._id) ?? (0, shared_1.str)(m.id),
+    name: m.name,
+    code: (0, shared_1.str)(m.code),
+});
+exports.getNetworkStatus = (0, tool_1.defineTool)({
+    name: 'get_network_status',
+    title: 'Ads from the network for an agent',
+    description: 'Whether ads from the network are on for one agent: `on`, the enrollment `status` (none, pending, approved, rejected) with its meaning, the `moments` where network ads may appear, and the agent’s `otherMoments`. Any workspace can show network ads. Change it with set_network_ads. Results: get_results with section network. Maps to GET /system/offer-manager/application/{id}/network.',
+    kind: 'read',
+    roleFloor: 'viewer',
+    input: { application: shared_1.application },
+    async run({ client }, { application: agent }) {
+        const [setting, app, moments] = await Promise.all([
+            client.get(`${shared_1.OM}/application/${(0, shared_1.enc)(agent)}/network`),
+            client.get(`${shared_1.OM}/application/${(0, shared_1.enc)(agent)}`),
+            client.get(`${shared_1.OM}/adunit`, { application: agent }),
+        ]);
+        const on = new Set(Array.isArray(setting?.moments) ? setting.moments : []);
+        const all = (0, shared_1.rows)(moments).map(momentRef);
+        const status = (0, shared_1.str)(setting?.networkStatus) ?? 'none';
+        return {
+            agent: { id: agent, name: app?.name },
+            on: !!setting?.enabled,
+            status,
+            meaning: exports.NETWORK_STATUS_MEANINGS[status],
+            moments: all.filter(m => m.id && on.has(m.id)),
+            otherMoments: all.filter(m => !m.id || !on.has(m.id)),
+        };
+    },
+});
+/** Moment names for ids, from the reader's result. */
+function momentNames(ids, before) {
+    const known = [
+        ...(Array.isArray(before?.moments) ? before.moments : []),
+        ...(Array.isArray(before?.otherMoments) ? before.otherMoments : []),
+    ];
+    return ids.map(id => {
+        const m = known.find(k => k.id === id);
+        return m?.name ? (0, shared_1.quoted)(m.name, '') : 'a moment';
+    });
+}
+exports.setNetworkAds = (0, tool_1.defineTool)({
+    name: 'set_network_ads',
+    title: 'Turn ads from the network on or off',
+    description: 'Turn ads from the network on or off for one agent. On needs at least one of the agent’s moments: network ads may appear there when no offer of the brand’s own is chosen. `moments` replaces the list. Off removes them from every moment. Read the current state with get_network_status first. Refused (409) for an agent the network declined. Maps to PUT /system/offer-manager/application/{id}/network.',
+    kind: 'write',
+    roleFloor: 'editor',
+    reader: 'get_network_status',
+    input: {
+        application: shared_1.application,
+        enabled: zod_1.z.boolean().describe('On or off.'),
+        moments: zod_1.z
+            .array(zod_1.z.string().regex(/^[0-9a-fA-F]{24}$/))
+            .optional()
+            .describe('Moment ids of this agent where network ads may appear; required, at least one, when turning on.'),
+    },
+    approval: (args, before) => {
+        const agent = (0, shared_1.named)('agent', before?.agent?.name);
+        if (!args.enabled)
+            return `Turn off ads from the network for ${agent}. They stop appearing at once.`;
+        const ids = args.moments ?? [];
+        const names = momentNames(ids, before);
+        const at = names.length && names.every(n => n !== 'a moment')
+            ? `at ${(0, shared_1.listWords)(names)}`
+            : `at ${ids.length === 1 ? 'one moment' : `${ids.length} moments`}`;
+        const approved = before?.status === 'pending'
+            ? ' They appear once the agent is approved for the network.'
+            : '';
+        return `${before?.on ? 'Show' : 'Turn on'} ads from the network for ${agent} ${at}.${approved}`;
+    },
+    async run({ client }, args) {
+        return client.put(`${shared_1.OM}/application/${(0, shared_1.enc)(args.application)}/network`, {
+            enabled: args.enabled,
+            moments: args.moments ?? [],
+        });
+    },
+});
+exports.networkTools = [exports.getNetworkStatus, exports.setNetworkAds];
+//# sourceMappingURL=network.js.map

package/bin/tools/network.js.map

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

package/bin/tools/offers.d.ts

@@ -0,0 +1,11 @@
+import { Doc } from './shared';
+/** An offer as the list shows it. */
+export declare function offerRow(c: Doc): Doc;
+export declare const listOffers: import("../tool").AnyTool;
+export declare const getOffer: import("../tool").AnyTool;
+export declare const createOffer: import("../tool").AnyTool;
+export declare const updateOffer: import("../tool").AnyTool;
+export declare const publishOffer: import("../tool").AnyTool;
+export declare const pauseOffer: import("../tool").AnyTool;
+export declare const deleteOffer: import("../tool").AnyTool;
+export declare const offerTools: import("../tool").AnyTool[];

package/bin/tools/offers.js

@@ -0,0 +1,239 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.offerTools = exports.deleteOffer = exports.pauseOffer = exports.publishOffer = exports.updateOffer = exports.createOffer = exports.getOffer = exports.listOffers = void 0;
+exports.offerRow = offerRow;
+/**
+ * Offers (the API's creatives): what a customer sees. Offers are an
+ * org-wide library that any agent's rules can use. Reads and publishing go
+ * through `/offers` (each offer with its status, rules, and last 7 days);
+ * the content is written on `/creative`.
+ */
+const offer_rules_1 = require("@advertising-chat/offer-rules");
+const zod_1 = require("zod");
+const flowValidator_1 = require("../flow/flowValidator");
+const flowZod_1 = require("../flow/flowZod");
+const tool_1 = require("../tool");
+const shared_1 = require("./shared");
+const FORMATS = ['Universal', 'Flow'];
+const format = zod_1.z
+    .enum(FORMATS)
+    .describe('Universal is the card (title, subtitle, image, replies), rendered for each channel: a rich card on RCS, text and a link on SMS, a card on webchat. Flow is a short scripted conversation, served only to agents that ask for flows. The payload variant must match.');
+const payload = zod_1.z
+    .object({
+    universal: zod_1.z
+        .object({
+        title: zod_1.z.string(),
+        subtitle: zod_1.z.string().optional(),
+        imageUrl: zod_1.z.string().optional(),
+        altText: zod_1.z.string().optional(),
+    })
+        .optional()
+        .describe('For Universal.'),
+    flow: flowZod_1.flowPayload
+        .optional()
+        .describe('For Flow: the conversation graph, checked against the flow spec before anything is sent.'),
+})
+    .describe('The content, in the variant that matches `format`.');
+const actions = zod_1.z
+    .array(zod_1.z.object({
+    actionType: zod_1.z.enum(['Text', 'Navigate', 'Call']),
+    text: zod_1.z.string().optional().describe('The reply or button label.'),
+    action: zod_1.z
+        .string()
+        .describe('The URL for Navigate, the number for Call, the text for Text.'),
+    role: zod_1.z
+        .enum(offer_rules_1.REPLY_ROLES)
+        .optional()
+        .describe('What tapping it means: `accept` records an acceptance of the offer, `decline` a decline. History conditions in rules count them.'),
+}))
+    .describe('Replies and buttons shown with the offer. Not for Flow.');
+const properties = zod_1.z
+    .array(zod_1.z.object({ name: zod_1.z.string(), value: zod_1.z.string() }))
+    .describe('Custom name and value pairs returned to the agent with the offer.');
+/** Client-side flow checks, so authoring errors come back before a write. */
+function checkOfferBody(body, isUpdate) {
+    const flow = body.payload?.flow;
+    if (body.format !== 'Flow' && flow === undefined)
+        return;
+    if (!isUpdate || body.format === 'Flow') {
+        if (flow === undefined)
+            throw new shared_1.ToolInputError('A Flow offer needs payload.flow.');
+    }
+    if (body.payload?.universal)
+        throw new shared_1.ToolInputError('A Flow offer carries only payload.flow, no other payload variant.');
+    if (body.actions?.length)
+        throw new shared_1.ToolInputError('A Flow offer has no top-level actions: its actions are nodes in the graph.');
+    if (flow !== undefined) {
+        const result = (0, flowValidator_1.validateFlowPayload)(flow);
+        if (!result.valid)
+            throw new shared_1.ToolInputError(`The flow is invalid; nothing was sent. Fix these and retry:\n- ${result.errors.join('\n- ')}`);
+    }
+}
+/** An offer as the list shows it. */
+function offerRow(c) {
+    return {
+        id: (0, shared_1.str)(c._id) ?? (0, shared_1.str)(c.id),
+        name: c.name,
+        format: c.format,
+        status: c.status,
+        title: (0, shared_1.str)(c.payload?.universal?.title),
+        rules: Array.isArray(c.rules) ? c.rules.length : undefined,
+        last7Days: c.last7Days,
+    };
+}
+const STATUS = 'status is draft (never published: no rule uses it yet, or none has been turned on), live (an enabled rule that uses it is within its dates), paused (published before, now off), or ended (every rule’s dates are over)';
+/** The words for an offer's fields, for approval sentences. */
+const OFFER_WORDS = {
+    name: 'name',
+    format: 'format',
+    description: 'description',
+    payload: 'content',
+    actions: 'replies and buttons',
+    properties: 'custom properties',
+};
+/** What a live offer's change means, for approval sentences. */
+function liveNote(before) {
+    return before?.status === 'live'
+        ? ' Customers see the change from the next request.'
+        : '';
+}
+exports.listOffers = (0, tool_1.defineTool)({
+    name: 'list_offers',
+    title: 'List offers',
+    description: `The workspace’s offers, each with id, name, format, ${STATUS}, the title, how many rules use it, and last7Days (shown and accepted over the last 7 days in the workspace’s time zone). Any agent’s rules can use any offer. Read one in full with get_offer. Maps to GET /system/offer-manager/offers.`,
+    kind: 'read',
+    roleFloor: 'viewer',
+    capability: 'offer-manager',
+    input: {},
+    async run({ client }) {
+        const body = await client.get(`${shared_1.OM}/offers`);
+        return (0, shared_1.rows)(body).map(offerRow);
+    },
+});
+exports.getOffer = (0, tool_1.defineTool)({
+    name: 'get_offer',
+    title: 'Get an offer',
+    description: `One offer with every field: content, replies and their roles, properties, its ${STATUS}, the rules that use it (name, agent, moments, enabled, schedule), and last7Days (shown and accepted). Maps to GET /system/offer-manager/offers/{id}.`,
+    kind: 'read',
+    roleFloor: 'viewer',
+    capability: 'offer-manager',
+    input: { id: (0, shared_1.id)('offer') },
+    async run({ client }, { id: offerId }) {
+        return client.get(`${shared_1.OM}/offers/${(0, shared_1.enc)(offerId)}`);
+    },
+});
+exports.createOffer = (0, tool_1.defineTool)({
+    name: 'create_offer',
+    title: 'Create an offer',
+    description: 'Create an offer as a draft. It appears only through a rule that uses it, so creating it changes nothing a customer sees until a rule uses it and is published. Maps to POST /system/offer-manager/creative.',
+    kind: 'write',
+    roleFloor: 'editor',
+    capability: 'offer-manager',
+    input: {
+        name: zod_1.z.string().min(1).max(200).describe('Display name.'),
+        format,
+        description: zod_1.z.string().optional(),
+        payload: payload.optional(),
+        actions: actions.optional(),
+        properties: properties.optional(),
+    },
+    approval: args => `Create the offer ${(0, shared_1.quoted)(args.name, '')} as a draft. Customers see it only once you choose who sees it and publish it.`,
+    async run({ client }, args) {
+        const body = (0, shared_1.defined)(args);
+        checkOfferBody(body, false);
+        return client.post(`${shared_1.OM}/creative`, body);
+    },
+});
+exports.updateOffer = (0, tool_1.defineTool)({
+    name: 'update_offer',
+    title: 'Update an offer',
+    description: 'Change an offer’s content. Only the fields given change; `actions` and `properties` replace the whole list. Customers see the change on the next request through any rule that uses it. Maps to PATCH /system/offer-manager/creative/{id}.',
+    kind: 'write',
+    roleFloor: 'editor',
+    reader: 'get_offer',
+    capability: 'offer-manager',
+    input: {
+        id: (0, shared_1.id)('offer'),
+        name: zod_1.z.string().min(1).max(200).optional(),
+        format: format.optional(),
+        description: zod_1.z.string().optional(),
+        payload: payload.optional(),
+        actions: actions.optional(),
+        properties: properties.optional(),
+    },
+    approval: (args, before) => {
+        const what = (0, shared_1.changedWords)(args, OFFER_WORDS);
+        const renamed = args.name && before?.name && args.name !== before.name
+            ? ` It will be called ${(0, shared_1.quoted)(args.name, '')}.`
+            : '';
+        const offer = (0, shared_1.named)('offer', before?.name ?? args.name);
+        const change = what.length
+            ? `Change the ${(0, shared_1.listWords)(what)} of ${offer}.`
+            : `Change ${offer}.`;
+        return `${change}${renamed}${liveNote(before)}`;
+    },
+    async run({ client }, args) {
+        const body = (0, shared_1.patchBody)(args);
+        checkOfferBody(body, true);
+        return client.patch(`${shared_1.OM}/creative/${(0, shared_1.enc)(args.id)}`, body);
+    },
+});
+/** `its 2 audiences`, from the offer as it stands (an audience is a rule). */
+function audiences(before) {
+    const n = Array.isArray(before?.rules) ? before.rules.length : undefined;
+    if (n === 1)
+        return 'its audience';
+    return n === undefined ? 'its audiences' : `its ${n} audiences`;
+}
+exports.publishOffer = (0, tool_1.defineTool)({
+    name: 'publish_offer',
+    title: 'Publish an offer',
+    description: 'Publish an offer: turn on every rule that uses it, so it can appear wherever those rules apply, within their dates. Refused (409) when no rule uses the offer: create one first (create_rule). Returns the offer with its new status. Maps to POST /system/offer-manager/offers/{id}/publish.',
+    kind: 'write',
+    roleFloor: 'editor',
+    reader: 'get_offer',
+    capability: 'offer-manager',
+    input: { id: (0, shared_1.id)('offer') },
+    approval: (_args, before) => `Publish ${(0, shared_1.named)('offer', before?.name)}: it starts showing to ${audiences(before)} from the next request.`,
+    async run({ client }, { id: offerId }) {
+        return client.post(`${shared_1.OM}/offers/${(0, shared_1.enc)(offerId)}/publish`);
+    },
+});
+exports.pauseOffer = (0, tool_1.defineTool)({
+    name: 'pause_offer',
+    title: 'Pause an offer',
+    description: 'Pause an offer: turn off every rule that uses it, so it stops appearing at once. Undo with publish_offer. Returns the offer with its new status. Maps to POST /system/offer-manager/offers/{id}/pause.',
+    kind: 'write',
+    roleFloor: 'editor',
+    reader: 'get_offer',
+    capability: 'offer-manager',
+    input: { id: (0, shared_1.id)('offer') },
+    approval: (_args, before) => `Pause ${(0, shared_1.named)('offer', before?.name)}: it stops showing to ${audiences(before)} at once.`,
+    async run({ client }, { id: offerId }) {
+        return client.post(`${shared_1.OM}/offers/${(0, shared_1.enc)(offerId)}/pause`);
+    },
+});
+exports.deleteOffer = (0, tool_1.defineTool)({
+    name: 'delete_offer',
+    title: 'Delete an offer',
+    description: 'Permanently delete an offer in one step: the rules that show only this offer are deleted with it, and it is taken out of rules that rotate it with other offers. Returns what was removed (`rulesDeleted`, `rulesChanged`, and `message`, a sentence to relay). To stop it for now, use pause_offer. Maps to DELETE /system/offer-manager/offers/{id}.',
+    kind: 'destructive',
+    roleFloor: 'editor',
+    reader: 'get_offer',
+    capability: 'offer-manager',
+    input: { id: (0, shared_1.id)('offer') },
+    approval: (_args, before) => `Delete ${(0, shared_1.named)('offer', before?.name)} for good, with the rules that show only it, and take it out of any rotation. This cannot be undone.`,
+    async run({ client }, { id: offerId }) {
+        return client.delete(`${shared_1.OM}/offers/${(0, shared_1.enc)(offerId)}`);
+    },
+});
+exports.offerTools = [
+    exports.listOffers,
+    exports.getOffer,
+    exports.createOffer,
+    exports.updateOffer,
+    exports.publishOffer,
+    exports.pauseOffer,
+    exports.deleteOffer,
+];
+//# sourceMappingURL=offers.js.map

package/bin/tools/offers.js.map

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

package/bin/tools/results.d.ts

@@ -0,0 +1,18 @@
+/** The `groupBy` values each section accepts. */
+export declare const RESULTS_GROUP_BY: {
+    readonly offers: readonly ["day", "offer", "moment", "channel", "agent"];
+    readonly network: readonly ["day", "moment", "channel", "agent"];
+    readonly campaigns: readonly ["day", "campaign"];
+};
+type Section = keyof typeof RESULTS_GROUP_BY;
+/**
+ * The (section, groupBy) pairs a call asks for: every section with every
+ * split it accepts. A section none of the splits fits is refused.
+ */
+export declare function resultsViews(section: Section | Section[], groupBy?: string | string[]): Array<{
+    section: Section;
+    groupBy?: string;
+}>;
+export declare const getResults: import("../tool").AnyTool;
+export declare const resultsTools: import("../tool").AnyTool[];
+export {};

package/bin/tools/results.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resultsTools = exports.getResults = exports.RESULTS_GROUP_BY = void 0;
+exports.resultsViews = resultsViews;
+/**
+ * Results: daily counts for the workspace's offers, its ads from the
+ * network, and its campaigns (`GET /system/results`). Every workspace can
+ * read them; a section the workspace does not use comes back as zeros.
+ */
+const zod_1 = require("zod");
+const tool_1 = require("../tool");
+const shared_1 = require("./shared");
+/** The `groupBy` values each section accepts. */
+exports.RESULTS_GROUP_BY = {
+    offers: ['day', 'offer', 'moment', 'channel', 'agent'],
+    network: ['day', 'moment', 'channel', 'agent'],
+    campaigns: ['day', 'campaign'],
+};
+const SECTIONS = Object.keys(exports.RESULTS_GROUP_BY);
+const GROUP_BYS = [
+    'day',
+    'offer',
+    'moment',
+    'channel',
+    'agent',
+    'campaign',
+];
+const oneOrMore = (t) => zod_1.z.union([t, zod_1.z.array(t).min(1).max(GROUP_BYS.length)]);
+const list = (v) => v === undefined ? undefined : Array.isArray(v) ? v : [v];
+/**
+ * The (section, groupBy) pairs a call asks for: every section with every
+ * split it accepts. A section none of the splits fits is refused.
+ */
+function resultsViews(section, groupBy) {
+    const sections = [...new Set(list(section))];
+    const splits = list(groupBy);
+    const views = [];
+    for (const s of sections) {
+        if (!splits) {
+            views.push({ section: s });
+            continue;
+        }
+        const fits = [...new Set(splits)].filter(g => exports.RESULTS_GROUP_BY[s].includes(g));
+        if (!fits.length)
+            throw new shared_1.ToolInputError(`${s} cannot be split by ${(0, shared_1.listWords)(splits)}; it takes ${(0, shared_1.listWords)([...exports.RESULTS_GROUP_BY[s]])}. Nothing was sent.`);
+        for (const g of fits)
+            views.push({ section: s, groupBy: g });
+    }
+    return views;
+}
+const day = (what) => zod_1.z
+    .string()
+    .regex(/^\d{4}-\d{2}-\d{2}$/, 'a date like 2026-10-01')
+    .describe(`${what}, yyyy-mm-dd in the workspace’s time zone, inclusive. The range is at most 400 days.`);
+exports.getResults = (0, tool_1.defineTool)({
+    name: 'get_results',
+    title: 'Get results',
+    description: 'Daily counts for the workspace, over a range of days in its time zone, with totals and rows. Sections and their metrics: `offers` (the brand’s own offers: requests, shown, accepted, declined, clicked, converted), `network` (ads from the network: requests offered to the network, shown, clicked), `campaigns` (the workspace’s campaigns wherever they serve: shown, clicks, conversions; conversationsStarted and cost are null until they are computed). `groupBy` splits the rows: by `day` (every day of the range, oldest first, the default), or by offer, moment, channel, or agent (offers); moment, channel, or agent (network); campaign (campaigns). Grouped rows are sorted highest first and carry a display name (`label`). A null value is not computed; offers `requests` is null by offer because requests are counted before an offer is chosen. `application` limits it to one agent; `offer` limits the offers section to one offer, and `campaign` the campaigns section to one campaign. To answer a question that needs several views (say offers by offer and by agent, and the network), ask for them in one call: `section` and `groupBy` each take a list, and you get `{ results: [...] }`, one entry (section, groupBy, totals, rows) per section with each split it accepts; one section and one split return that view alone. Metric definitions: read_doc offer-manager/results-metrics. Maps to GET /system/results.',
+    kind: 'read',
+    roleFloor: 'viewer',
+    input: {
+        section: oneOrMore(zod_1.z.enum(SECTIONS)).describe('Which results: one section, or a list of them.'),
+        from: day('First day'),
+        to: day('Last day'),
+        groupBy: oneOrMore(zod_1.z.enum(GROUP_BYS))
+            .optional()
+            .describe('How to split the rows, one or a list; the values each section accepts are listed above, and each section gets the splits it accepts. Default day.'),
+        application: shared_1.application
+            .optional()
+            .describe('Only this agent’s requests (list_applications).'),
+        offer: zod_1.z
+            .string()
+            .min(1)
+            .optional()
+            .describe('Only this offer (an id from list_offers); applies to the offers section, not with application.'),
+        campaign: zod_1.z
+            .string()
+            .min(1)
+            .optional()
+            .describe('Only this campaign (an id from list_campaigns); applies to the campaigns section, not with application.'),
+    },
+    async run({ client }, args) {
+        const views = resultsViews(args.section, args.groupBy);
+        const filters = [
+            ['offer', 'offers'],
+            ['campaign', 'campaigns'],
+        ];
+        for (const [key, section] of filters) {
+            if (args[key] === undefined)
+                continue;
+            if (args.application !== undefined)
+                throw new shared_1.ToolInputError(`${key} cannot be combined with application; pass one of them.`);
+            if (!views.some(v => v.section === section))
+                throw new shared_1.ToolInputError(`${key} applies only to the ${section} section; add it to section.`);
+        }
+        // Each filter goes only to its own section's views.
+        const query = (v) => client.get('/results', (0, shared_1.defined)({
+            ...args,
+            offer: v.section === 'offers' ? args.offer : undefined,
+            campaign: v.section === 'campaigns' ? args.campaign : undefined,
+            ...v,
+        }));
+        if (views.length === 1)
+            return query(views[0]);
+        const bodies = await Promise.all(views.map(query));
+        return {
+            results: bodies.map((b, i) => ({
+                ...b,
+                section: views[i].section,
+                groupBy: views[i].groupBy ?? 'day',
+            })),
+        };
+    },
+});
+exports.resultsTools = [exports.getResults];
+//# sourceMappingURL=results.js.map

package/bin/tools/results.js.map

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

package/bin/tools/rules.d.ts

@@ -0,0 +1,9 @@
+import { Doc } from './shared';
+/** A rule as the list shows it. */
+export declare function ruleRow(r: Doc): Doc;
+export declare const listRules: import("../tool").AnyTool;
+export declare const getRule: import("../tool").AnyTool;
+export declare const createRule: import("../tool").AnyTool;
+export declare const updateRule: import("../tool").AnyTool;
+export declare const deleteRule: import("../tool").AnyTool;
+export declare const ruleTools: import("../tool").AnyTool[];