@advertising-chat/mcp 0.17.3 → 0.18.0

package/bin/tools/rules.js

@@ -1,318 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ruleTools = exports.deleteRule = exports.updateRule = exports.createRule = exports.getRule = exports.listRules = void 0;
-exports.ruleRow = ruleRow;
-/**
- * Rules (the API's line items): which offers appear at which moments of
- * one agent, for whom, where, when, and how often. Input schemas come from
- * `@advertising-chat/offer-rules`, the package the server validates with,
- * so a tool cannot drift from the rule model.
- */
-const offer_rules_1 = require("@advertising-chat/offer-rules");
-const zod_1 = require("zod");
-const tool_1 = require("../tool");
-const shared_1 = require("./shared");
-const R = offer_rules_1.RuleInput.shape;
-const GRAMMAR = 'A condition group is { all: [...] } or { any: [...] } with 1 to 20 items; an item is a condition or one nested group of conditions. ' +
-    "Attribute condition: { attribute, op, value? }, op one of equals, not_equals, in, not_in, gt, gte, lt, lte, between, contains, within_last, more_than_ago (days), exists, not_exists, true, false; e.g. { attribute: 'plan', op: 'equals', value: 'Unlimited' }. " +
-    'History condition: { event: shown | declined | accepted | converted, subject: this_offer | any_offer | offer:<id> | rule:<id>, within_days: 1 to 90, at_least?: 1 to 20 }. ' +
-    `Attributes must be in the agent's catalog (list_attributes), with an operator that fits their type. Grammar: ${shared_1.RULES_REFERENCE}`;
-/** The rule fields, described for a model. Schemas are offer-rules'. */
-const fields = {
-    name: R.name.describe('Display name, 1 to 200 characters.'),
-    adUnits: R.adUnits.describe('The moment ids the rule applies to, at least one, all of the rule’s agent.'),
-    creatives: R.creatives.describe('The offer ids the rule can show, in order. A house rule needs at least one; an exchange rule has none.'),
-    priority: R.priority.describe('Lower wins: 6 High, 8 Normal, 10 Low. Required on a house rule (create defaults to 8). An exchange rule is 12.'),
-    enabled: R.enabled.describe('Whether the rule serves.'),
-    audience: R.audience.describe(`Who sees the offers: customers the group matches. Absent means everyone. ${GRAMMAR}`),
-    exclusions: R.exclusions.describe("Who does not: customers the group matches are removed. Absent means no one. E.g. anyone who declined this offer in the last 30 days: { any: [{ event: 'declined', subject: 'this_offer', within_days: 30 }] }."),
-    channels: R.channels.describe(`Where: the channels the rule serves on, of ${offer_rules_1.CHANNELS.join(', ')}. Absent or empty means every channel; a restricted rule never matches a request that names no channel.`),
-    schedule: R.schedule.describe("When, in the org's time zone: start and end (YYYY-MM-DD, inclusive), daysOfWeek (mon to sun), hours { from, to } (to is exclusive; from > to runs overnight). At least one of them. Absent means always."),
-    frequency: R.frequency.describe('How often: at most `times` (1 to 20) showings of this rule to one customer per rolling `interval` of milliseconds (60000 to 7776000000). E.g. { times: 1, interval: 604800000 } is once a week. Absent means no cap.'),
-    limits: R.limits.describe('Caps on the whole rule: { limitType: impressions | percentage, value, enabled }.'),
-    fallback: R.fallback.describe('A fallback rule is considered only when no other rule qualifies.'),
-    testMode: R.testMode.describe("Marks the rule's responses isTest: true."),
-    creativeSelectionStrategy: R.creativeSelectionStrategy.describe('`sequential` shows the offers to each customer in order (needs a subscriber id); `default` picks among them.'),
-    dailyBudget: R.dailyBudget.describe('Paces the rule evenly across the UTC day. 0 or absent means unpaced.'),
-    orderType: R.orderType.describe('`house` (the default) shows the rule’s offers; `exchange` asks an ad network for one.'),
-    adNetworkCode: R.adNetworkCode.describe('Exchange rules only: the ad network asked to fill. Absent means the default network.'),
-};
-const instructions = offer_rules_1.RuleInstructions.optional().describe('The user’s words each policy field was written from, keyed by the field you set or clear (adUnits, creatives, priority, audience, exclusions, channels, schedule, frequency), e.g. { audience: "prepaid customers who hit their data limit twice in a row" }. Pass it whenever the change comes from what the user asked: the rule keeps it, and the console shows the field as written from those words. Use their request as they wrote it (with their answer to any question you asked), not your paraphrase. Not saved as part of the rule’s policy.');
-/** Fields an update clears with `null`. */
-const CLEARABLE = [
-    'audience',
-    'exclusions',
-    'channels',
-    'schedule',
-    'frequency',
-    'limits',
-    'dailyBudget',
-    'adNetworkCode',
-];
-/** The offer card's words for a rule's fields, for approval sentences. */
-const RULE_WORDS = {
-    name: 'the name',
-    creatives: 'the offers',
-    audience: 'who sees it',
-    exclusions: 'who does not',
-    adUnits: 'when (the moments)',
-    channels: 'where (the channels)',
-    frequency: 'how often',
-    schedule: 'the schedule',
-    priority: 'the priority',
-    fallback: 'whether it is a fallback',
-    limits: 'the limits',
-    dailyBudget: 'the daily pacing',
-    testMode: 'test mode',
-    creativeSelectionStrategy: 'the order of its offers',
-    orderType: 'its kind',
-    adNetworkCode: 'the ad network',
-};
-const CHANNEL_NAMES = {
-    rcs: 'RCS',
-    sms: 'SMS',
-    webchat: 'web chat',
-};
-function countWords(n, one) {
-    return n === 1 ? `one ${one}` : `${n} ${one}s`;
-}
-/**
- * What one update field becomes, as a clause, where that is short and
- * plain; undefined leaves the field to the "it also changes" list.
- */
-function ruleValueWords(key, value, before) {
-    switch (key) {
-        case 'name':
-            return `its name becomes ${(0, shared_1.quoted)(value, '')}`;
-        case 'adUnits':
-        case 'creatives': {
-            if (!Array.isArray(value))
-                return undefined;
-            const one = key === 'adUnits' ? 'moment' : 'offer';
-            const was = before?.[key];
-            if (Array.isArray(was) && was.length === value.length)
-                return value.length === 1 ? `its ${one} changes` : `its ${one}s change`;
-            const at = key === 'adUnits' ? 'at ' : '';
-            const instead = Array.isArray(was) ? ` instead of ${was.length}` : '';
-            return `it shows ${at}${countWords(value.length, one)}${instead}`;
-        }
-        case 'channels':
-            return Array.isArray(value) && value.length
-                ? `it shows only on ${(0, shared_1.listWords)(value.map(c => CHANNEL_NAMES[c] ?? String(c)))}`
-                : 'it shows on every channel';
-        case 'schedule': {
-            if (value === null)
-                return 'it runs at all times';
-            const text = (0, offer_rules_1.renderSchedule)(value).replace(/ \([^)]*\)$/, '');
-            return `it runs ${text.charAt(0).toLowerCase()}${text.slice(1)}`;
-        }
-        case 'frequency': {
-            if (value === null)
-                return 'it has no limit on how often it shows';
-            const words = (0, shared_1.frequencyWords)(value);
-            return words && `it shows ${words} to each customer`;
-        }
-        case 'priority': {
-            const label = offer_rules_1.PRIORITY_LABELS[value];
-            return label && `its priority becomes ${label}`;
-        }
-        case 'fallback':
-            return value ? 'it becomes a fallback' : 'it is no longer a fallback';
-        case 'testMode':
-            return value ? 'test mode turns on' : 'test mode turns off';
-        default:
-            return undefined;
-    }
-}
-/**
- * The change an update makes, field by field: what each becomes where
- * that is short and plain, then the rest by name ("who sees it").
- */
-function ruleChangeWords(args, before) {
-    const becomes = [];
-    const rest = [];
-    for (const [key, word] of Object.entries(RULE_WORDS)) {
-        if (args[key] === undefined)
-            continue;
-        const clause = ruleValueWords(key, args[key], before);
-        if (clause)
-            becomes.push(clause);
-        else if (!rest.includes(word))
-            rest.push(word);
-    }
-    if (!becomes.length)
-        return (0, shared_1.listWords)(rest);
-    return rest.length
-        ? `${(0, shared_1.listWords)(becomes)}; it also changes ${(0, shared_1.listWords)(rest)}`
-        : (0, shared_1.listWords)(becomes);
-}
-/** A rule as the list shows it. */
-function ruleRow(r) {
-    return {
-        id: (0, shared_1.str)(r._id) ?? (0, shared_1.str)(r.id),
-        name: r.name,
-        application: (0, shared_1.refId)(r.application),
-        enabled: r.enabled,
-        priority: r.priority,
-        fallback: r.fallback || undefined,
-        orderType: r.orderType === 'exchange' ? 'exchange' : undefined,
-        moments: Array.isArray(r.adUnits) ? r.adUnits.map(shared_1.ref) : undefined,
-        offers: Array.isArray(r.creatives) ? r.creatives.map(shared_1.ref) : undefined,
-        summary: (0, shared_1.str)(r._description?.summary),
-    };
-}
-/** What the console calls a rule: an offer's audience, or the agent's network setting. */
-function ruleKind(rule) {
-    return rule?.orderType === 'exchange' ? 'network setting' : 'audience';
-}
-exports.listRules = (0, tool_1.defineTool)({
-    name: 'list_rules',
-    title: 'List rules',
-    description: 'The org’s rules (the API calls them line items): each places offers at moments of one agent. Returns id, name, agent (application), enabled, priority, fallback, moments, offers, and the generated summary when there is one. Pass `application` to list one agent’s rules; read one rule in full with get_rule. Maps to GET /system/offer-manager/lineItem.',
-    kind: 'read',
-    roleFloor: 'viewer',
-    capability: 'offer-manager',
-    input: {
-        application: shared_1.application.optional(),
-        enabled: zod_1.z.boolean().optional().describe('Only enabled, or only disabled.'),
-        ...shared_1.listShape,
-    },
-    async run({ client }, args) {
-        const body = await client.get(`${shared_1.OM}/lineItem`, (0, shared_1.defined)(args));
-        return (0, shared_1.rows)(body).map(ruleRow);
-    },
-});
-exports.getRule = (0, tool_1.defineTool)({
-    name: 'get_rule',
-    title: 'Get a rule',
-    description: `One rule with every field: audience, exclusions, channels, schedule, frequency, limits, priority, its moments and offers, and the generated summary (\`_description\`). Field reference: ${shared_1.RULES_REFERENCE} Maps to GET /system/offer-manager/lineItem/{id}.`,
-    kind: 'read',
-    roleFloor: 'viewer',
-    capability: 'offer-manager',
-    input: { id: (0, shared_1.id)('rule') },
-    async run({ client }, { id: ruleId }) {
-        return client.get(`${shared_1.OM}/lineItem/${(0, shared_1.enc)(ruleId)}`);
-    },
-});
-exports.createRule = (0, tool_1.defineTool)({
-    name: 'create_rule',
-    title: 'Create a rule',
-    description: 'Create a rule for one agent: it places offers at the agent’s moments for the customers and situations it describes. It is created disabled unless `enabled: true` is given, so nothing serves until someone turns it on; pass true only when the user asked to launch. `application` is fixed once created, and every moment must belong to it; offers are shared across the org. A house rule (the default) needs at least one offer and a priority (default 8, Normal). An exchange rule (`orderType: exchange`) has no offers, priority 12, and an optional adNetworkCode. The input is checked against the rule model before it is sent, and again by the server. Maps to POST /system/offer-manager/lineItem.',
-    kind: 'write',
-    roleFloor: 'editor',
-    capability: 'offer-manager',
-    input: {
-        application: shared_1.application,
-        ...fields,
-        enabled: fields.enabled.optional().describe('Default false.'),
-        instructions,
-    },
-    approval: args => {
-        const name = (0, shared_1.quoted)(args.name, '');
-        const offers = Array.isArray(args.creatives) ? args.creatives.length : 0;
-        const shows = args.orderType === 'exchange'
-            ? 'asks the network for an ad'
-            : `shows ${offers === 1 ? 'one offer' : `${offers} offers`}`;
-        const moments = args.adUnits.length;
-        const where = `at ${moments === 1 ? 'one moment' : `${moments} moments`}`;
-        const who = args.audience ? 'to the customers it describes' : 'to everyone';
-        const kind = ruleKind(args);
-        return args.enabled
-            ? `Create the ${kind} ${name} and publish it now: it ${shows} ${where} ${who}, from the next request.`
-            : `Create the ${kind} ${name}, turned off: it ${shows} ${where} ${who} once it is published.`;
-    },
-    async run({ client }, args) {
-        const { instructions: words, ...rest } = (0, shared_1.defined)(args);
-        const body = { enabled: false, ...rest };
-        if (body.orderType !== 'exchange' && body.priority === undefined)
-            body.priority = 8;
-        const parsed = offer_rules_1.RuleInput.safeParse(body);
-        if (!parsed.success)
-            throw new shared_1.ToolInputError(`The rule is invalid; nothing was sent. Fix these and retry:\n${(0, shared_1.issues)(parsed.error)}`);
-        return client.post(`${shared_1.OM}/lineItem`, {
-            ...parsed.data,
-            ...(words && { instructions: words }),
-        });
-    },
-});
-const nullable = Object.fromEntries(CLEARABLE.map(k => [
-    k,
-    fields[k]
-        .unwrap()
-        .nullable()
-        .optional()
-        .describe(`${fields[k].description} Pass null to clear.`),
-]));
-exports.updateRule = (0, tool_1.defineTool)({
-    name: 'update_rule',
-    title: 'Update a rule',
-    description: `Change a rule. Only the fields given change; pass null to clear audience, exclusions, channels, schedule, frequency, limits, dailyBudget, or adNetworkCode. The change is live at once: enabling starts serving, and every field changes who sees what from the next request. The server checks the merged rule (a house rule keeps at least one offer and a priority of 6, 8, or 10). Use get_rule first so you change what is there. Reference: ${shared_1.RULES_REFERENCE} Maps to PATCH /system/offer-manager/lineItem/{id}.`,
-    kind: 'write',
-    roleFloor: 'editor',
-    reader: 'get_rule',
-    capability: 'offer-manager',
-    input: {
-        id: (0, shared_1.id)('rule'),
-        application: shared_1.applicationOfUpdate,
-        name: fields.name.optional(),
-        enabled: fields.enabled.optional(),
-        adUnits: fields.adUnits.optional(),
-        creatives: fields.creatives,
-        priority: fields.priority,
-        fallback: fields.fallback,
-        testMode: fields.testMode,
-        creativeSelectionStrategy: fields.creativeSelectionStrategy,
-        orderType: fields.orderType,
-        ...nullable,
-        instructions,
-    },
-    approval: (args, before) => {
-        const name = (0, shared_1.named)(ruleKind(before ?? args), before?.name ?? args.name);
-        const what = (0, shared_1.changedWords)(args, RULE_WORDS);
-        const change = ruleChangeWords(args, before);
-        const parts = [];
-        if (args.enabled === true)
-            parts.push(`Publish ${name}: it starts showing its offers from the next request.`);
-        if (args.enabled === false)
-            parts.push(`Pause ${name}: it stops showing its offers at once.`);
-        if (what.length) {
-            const live = args.enabled === true ||
-                (args.enabled === undefined && before?.enabled);
-            parts.push(`Change ${name}: ${change}.${live ? ' The change is live at once.' : ''}`);
-        }
-        return parts.join(' ') || `Change ${name}.`;
-    },
-    async run({ client }, args) {
-        const body = (0, shared_1.patchBody)(args, ['application', 'instructions']);
-        const given = {};
-        for (const [k, v] of Object.entries(body))
-            if (v !== null && k !== 'instructions')
-                given[k] = v;
-        const parsed = offer_rules_1.RuleUpdate.safeParse(given);
-        if (!parsed.success)
-            throw new shared_1.ToolInputError(`The change is invalid; nothing was sent. Fix these and retry:\n${(0, shared_1.issues)(parsed.error)}`);
-        return client.patch(`${shared_1.OM}/lineItem/${(0, shared_1.enc)(args.id)}`, body);
-    },
-});
-exports.deleteRule = (0, tool_1.defineTool)({
-    name: 'delete_rule',
-    title: 'Delete a rule',
-    description: 'Permanently delete a rule; its offers stop appearing through it at once. To stop it for now, use update_rule with `enabled: false` instead. Maps to DELETE /system/offer-manager/lineItem/{id}.',
-    kind: 'destructive',
-    roleFloor: 'editor',
-    reader: 'get_rule',
-    capability: 'offer-manager',
-    input: { id: (0, shared_1.id)('rule') },
-    approval: (_args, before) => `Delete ${(0, shared_1.named)(ruleKind(before), before?.name)} for good: its offers stop appearing through it at once.`,
-    async run({ client }, { id: ruleId }) {
-        return client.delete(`${shared_1.OM}/lineItem/${(0, shared_1.enc)(ruleId)}`);
-    },
-});
-exports.ruleTools = [
-    exports.listRules,
-    exports.getRule,
-    exports.createRule,
-    exports.updateRule,
-    exports.deleteRule,
-];
-//# sourceMappingURL=rules.js.map

package/bin/tools/rules.js.map

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

package/bin/tools/settings.d.ts

@@ -1,3 +0,0 @@
-export declare const getOfferLimit: import("../tool").AnyTool;
-export declare const setOfferLimit: import("../tool").AnyTool;
-export declare const settingsTools: import("../tool").AnyTool[];

package/bin/tools/settings.js

@@ -1,54 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.settingsTools = exports.setOfferLimit = exports.getOfferLimit = void 0;
-/**
- * The workspace's Offer Manager settings: the offer limit, how many of the
- * brand's offers one customer may see from each agent in a period, across
- * that agent's moments and rules (customer ids are per agent). A rule's own How often is its `frequency`.
- */
-const offer_rules_1 = require("@advertising-chat/offer-rules");
-const tool_1 = require("../tool");
-const shared_1 = require("./shared");
-/** The rendered limit as a clause: `no customer sees more than …`. */
-function clause(limit) {
-    const said = (0, offer_rules_1.renderOfferLimit)(limit);
-    return said.charAt(0).toLowerCase() + said.slice(1);
-}
-function withSentence(s) {
-    return { ...s, says: (0, offer_rules_1.renderOfferLimit)(s.offerLimit) };
-}
-exports.getOfferLimit = (0, tool_1.defineTool)({
-    name: 'get_offer_limit',
-    title: 'Get the offer limit',
-    description: 'The workspace’s offer limit: no customer sees more than `times` of the brand’s offers in any rolling `interval` (milliseconds), counted over every offer the customer was shown by the agent. `offerLimit` is null when there is no limit; `says` states it in a sentence. Ads from the network do not count and are not limited. A rule’s own How often is its `frequency`. Maps to GET /system/offer-manager/settings.',
-    kind: 'read',
-    roleFloor: 'viewer',
-    capability: 'offer-manager',
-    input: {},
-    async run({ client }) {
-        return withSentence(await client.get(`${shared_1.OM}/settings`));
-    },
-});
-exports.setOfferLimit = (0, tool_1.defineTool)({
-    name: 'set_offer_limit',
-    title: 'Set the offer limit',
-    description: 'Set or remove the workspace’s offer limit: no customer sees more than `times` of the brand’s offers in any rolling `interval`. It applies at once to every agent, counted per agent: a customer at the limit with one agent gets no further offer from that agent (ads from the network still may appear). Pass `offerLimit: null` to remove it. Use get_offer_limit first so you change what is there. Maps to PUT /system/offer-manager/settings.',
-    kind: 'write',
-    roleFloor: 'editor',
-    capability: 'offer-manager',
-    reader: 'get_offer_limit',
-    input: { offerLimit: shared_1.offerLimit.nullable() },
-    approval: ({ offerLimit: limit }, before) => {
-        const had = before?.offerLimit ? clause(before.offerLimit) : '';
-        if (!limit)
-            return had
-                ? `Remove the offer limit (now ${had}): customers can see any number of offers, paced only by each rule's How often.`
-                : "Remove the offer limit: customers can see any number of offers, paced only by each rule's How often.";
-        return `Set the offer limit: ${clause(limit)}. It counts each agent separately and applies at once; ads from the network are not limited.`;
-    },
-    async run({ client }, { offerLimit: limit }) {
-        return withSentence(await client.put(`${shared_1.OM}/settings`, { offerLimit: limit }));
-    },
-});
-exports.settingsTools = [exports.getOfferLimit, exports.setOfferLimit];
-//# sourceMappingURL=settings.js.map

package/bin/tools/settings.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/tools/settings.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,+DAAiE;AACjE,kCAAqC;AACrC,qCAA0C;AAM1C,sEAAsE;AACtE,SAAS,MAAM,CAAC,KAA6B;IAC3C,MAAM,IAAI,GAAG,IAAA,8BAAgB,EAAC,KAAK,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,YAAY,CAAC,CAAW;IAC/B,OAAO,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,IAAA,8BAAgB,EAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;AACxD,CAAC;AAEY,QAAA,aAAa,GAAG,IAAA,iBAAU,EAAC;IACtC,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EACT,0ZAA0Z;IAC5Z,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,QAAQ;IACnB,UAAU,EAAE,eAAe;IAC3B,KAAK,EAAE,EAAE;IACT,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE;QAClB,OAAO,YAAY,CAAC,MAAM,MAAM,CAAC,GAAG,CAAW,GAAG,WAAE,WAAW,CAAC,CAAC,CAAC;IACpE,CAAC;CACF,CAAC,CAAC;AAEU,QAAA,aAAa,GAAG,IAAA,iBAAU,EAAC;IACtC,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EACT,qbAAqb;IACvb,IAAI,EAAE,OAAO;IACb,SAAS,EAAE,QAAQ;IACnB,UAAU,EAAE,eAAe;IAC3B,MAAM,EAAE,iBAAiB;IACzB,KAAK,EAAE,EAAE,UAAU,EAAE,mBAAU,CAAC,QAAQ,EAAE,EAAE;IAC5C,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,GAAG,GAAG,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,IAAI,CAAC,KAAK;YACR,OAAO,GAAG;gBACR,CAAC,CAAC,+BAA+B,GAAG,iFAAiF;gBACrH,CAAC,CAAC,sGAAsG,CAAC;QAC7G,OAAO,wBAAwB,MAAM,CAAC,KAAK,CAAC,8FAA8F,CAAC;IAC7I,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE;QACzC,OAAO,YAAY,CACjB,MAAM,MAAM,CAAC,GAAG,CAAW,GAAG,WAAE,WAAW,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CACpE,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEU,QAAA,aAAa,GAAG,CAAC,qBAAa,EAAE,qBAAa,CAAC,CAAC"}

package/bin/tools/translation.d.ts

@@ -1,6 +0,0 @@
-/** The offer card fields a translation can target (design §7.1). */
-export declare const CARD_FIELDS: readonly ["offer", "whoSeesIt", "when", "where", "notShownTo", "howOften", "schedule", "priority"];
-export declare const translateRuleText: import("../tool").AnyTool;
-export declare const previewRuleImpact: import("../tool").AnyTool;
-export declare const describeRule: import("../tool").AnyTool;
-export declare const translationTools: import("../tool").AnyTool[];

package/bin/tools/translation.js

@@ -1,139 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.translationTools = exports.describeRule = exports.previewRuleImpact = exports.translateRuleText = exports.CARD_FIELDS = void 0;
-/**
- * Rules in plain language: an instruction translated into a change to one
- * rule (`translate_rule_text`), a saved rule described as its offer card
- * (`describe_rule`), and how much recent traffic a draft would match
- * (`preview_rule_impact`). All three are reads: translation proposes a
- * change and saves nothing; saving is `create_rule` or `update_rule`.
- */
-const offer_rules_1 = require("@advertising-chat/offer-rules");
-const zod_1 = require("zod");
-const tool_1 = require("../tool");
-const shared_1 = require("./shared");
-const R = offer_rules_1.RuleInput.shape;
-/** The offer card fields a translation can target (design §7.1). */
-exports.CARD_FIELDS = [
-    'offer',
-    'whoSeesIt',
-    'when',
-    'where',
-    'notShownTo',
-    'howOften',
-    'schedule',
-    'priority',
-];
-exports.translateRuleText = (0, tool_1.defineTool)({
-    name: 'translate_rule_text',
-    title: 'Translate an instruction into a rule change',
-    description: 'Turn what the user wrote in plain language into a change to one rule, checked against the agent’s catalog, moments, and the org’s offers, and read back as the offer card. Give the agent, the card field being edited (target), the instruction in the user’s words, and the rule: ruleId for a saved rule, or rule for a draft with unsaved changes. Nothing is saved. The outcome is one of: ok, with policy (fields to set), clear (fields to remove), readBack (the card after the change and which fields changed), and warnings (data the agent does not send yet, has not documented, or sends rarely): show the user the read-back and the warnings, preview_rule_impact the result, and save with update_rule (clear fields as null) or create_rule once they agree, passing instructions with the user’s words for each field the change set or cleared. clarify, with a question (message) and choices: ask the user, then translate again with the same instruction and clarifications listing every question asked so far with its answer, in order; record the instruction as the user’s words with the answers in parentheses. needs_data, when the agent does not send what the rule needs: relay the message and the note drafted for the agent’s team; add_attribute or create_moment registers what it proposes, and a rule on it matches no one until the agent sends it. unsupported, when the rule model cannot express it: say so; offer the nearest rule only if one is given, and say how it differs. If the user takes it, save it with instructions null for the fields it changed: their words describe a rule it does not quite write. Each call counts toward the workspace’s daily Assistant usage. Maps to POST /system/copilot/translate.',
-    kind: 'read',
-    roleFloor: 'viewer',
-    capability: 'offer-manager',
-    input: {
-        application: shared_1.application,
-        target: zod_1.z
-            .enum([...exports.CARD_FIELDS, 'rule'])
-            .optional()
-            .describe('The card field the instruction is about: offer, whoSeesIt (audience), when (moments), where (channels), notShownTo (exclusions), howOften (frequency), schedule, or priority. A field’s translation changes only that field. Default rule: the whole rule.'),
-        instruction: zod_1.z
-            .string()
-            .trim()
-            .min(1)
-            .max(2000)
-            .describe('What the user wrote, in their words, e.g. "prepaid customers who hit their data limit twice in a row".'),
-        clarifications: zod_1.z
-            .array(zod_1.z.strictObject({
-            question: zod_1.z.string().trim().min(1).max(500),
-            answer: zod_1.z.string().trim().min(1).max(500),
-        }))
-            .min(1)
-            .max(5)
-            .optional()
-            .describe('After one or more clarify outcomes: each question asked (its message) and the user’s answer, a choice or their own words, in the order asked. Send the same instruction as before.'),
-        ruleId: (0, shared_1.id)('rule')
-            .optional()
-            .describe('A saved rule to change. Omit with rule, or for a new rule.'),
-        rule: zod_1.z
-            .record(zod_1.z.string(), zod_1.z.unknown())
-            .optional()
-            .describe('The draft as it stands, unsaved changes included, with the fields of create_rule. Takes precedence over ruleId.'),
-    },
-    async run({ client }, args) {
-        const { rule, ...rest } = (0, shared_1.defined)(args);
-        let draft;
-        if (rule) {
-            const parsed = offer_rules_1.RuleDraft.safeParse({
-                ...rule,
-                application: rule.application ?? args.application,
-            });
-            if (!parsed.success) {
-                throw new shared_1.ToolInputError(`The draft is not valid:\n${(0, shared_1.issues)(parsed.error)}`);
-            }
-            if (parsed.data.application !== args.application) {
-                throw new shared_1.ToolInputError('The draft belongs to a different agent.');
-            }
-            draft = parsed.data;
-        }
-        const answer = await client.post('/copilot/translate', {
-            ...rest,
-            ...(draft !== undefined && { rule: draft }),
-        });
-        // Model, timing, and token counts are for the console; leave them out.
-        const { meta: _meta, ...outcome } = answer ?? {}; // eslint-disable-line @typescript-eslint/no-unused-vars
-        return outcome;
-    },
-});
-exports.previewRuleImpact = (0, tool_1.defineTool)({
-    name: 'preview_rule_impact',
-    title: 'Preview a rule’s reach',
-    description: 'Estimate how much recent traffic a draft rule would match, before saving it: the percentage of a sample of up to 5,000 requests per moment from the last 7 days, the estimated number of distinct customers, why the rest did not match, and flags with notes (small or empty sample, nothing or everything matched, approximations). Read the notes back to the user; "no one matched" or "everyone matched" usually means the instruction was misread or the data is missing. A sample_building flag means some moments had no sample yet and were left out while one is taken; say so, and preview again in about a minute for the full estimate. Send the draft as it stands; only the agent and moments are required. Maps to POST /system/offer-manager/preview.',
-    kind: 'read',
-    roleFloor: 'viewer',
-    capability: 'offer-manager',
-    input: {
-        application: shared_1.application,
-        adUnits: R.adUnits.describe('The moment ids the draft applies to.'),
-        creatives: R.creatives
-            .optional()
-            .describe('The offer ids, for conditions on this offer’s history.'),
-        audience: R.audience,
-        exclusions: R.exclusions,
-        channels: R.channels,
-        schedule: R.schedule,
-        frequency: R.frequency,
-        id: (0, shared_1.id)('rule')
-            .optional()
-            .describe('The saved rule, when previewing a change to one.'),
-    },
-    async run({ client }, args) {
-        const { id: ruleId, ...draft } = (0, shared_1.defined)(args);
-        const parsed = offer_rules_1.PreviewDraft.safeParse({
-            ...draft,
-            ...(ruleId && { _id: ruleId }),
-        });
-        if (!parsed.success) {
-            throw new shared_1.ToolInputError(`The draft is not valid:\n${(0, shared_1.issues)(parsed.error)}`);
-        }
-        return client.post(`${shared_1.OM}/preview`, { rule: parsed.data });
-    },
-});
-exports.describeRule = (0, tool_1.defineTool)({
-    name: 'describe_rule',
-    title: 'Describe a rule',
-    description: 'A saved rule in plain language: its offer card, one sentence per field (agent, offer, who sees it, when, where, not shown to, how often, schedule, priority, status), written from the rule itself with its agent, moment, offer, and attribute names, plus a policy hash that changes when what the rule does changes. Maps to GET /system/offer-manager/describe/{id}.',
-    kind: 'read',
-    roleFloor: 'viewer',
-    capability: 'offer-manager',
-    input: { id: (0, shared_1.id)('rule') },
-    async run({ client }, { id: ruleId }) {
-        return client.get(`${shared_1.OM}/describe/${(0, shared_1.enc)(ruleId)}`);
-    },
-});
-exports.translationTools = [
-    exports.translateRuleText,
-    exports.describeRule,
-    exports.previewRuleImpact,
-];
-//# sourceMappingURL=translation.js.map

package/bin/tools/translation.js.map

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