@anychat-ai/mcp 0.1.0

package/dist/tools/capabilities.js

@@ -0,0 +1,325 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.capabilityTools = void 0;
+const zod_1 = require("zod");
+const tool_1 = require("../tool");
+/**
+ * Capabilities tool group — tool bindings, OAuth-runtime tool status,
+ * outreach config + preview, outreach links, and knowledge documents.
+ *
+ * Every tool is a 1:1 projection of a `/v1` route (API reference:
+ * "Tool bindings", "OAuth-runtime tools", "Outreach", "Outreach links";
+ * knowledge documents are the two read routes under
+ * `/knowledge/documents`, guarded by `knowledge:read`).
+ *
+ * Deliberately NOT here:
+ * - `POST …/tools/{toolId}/oauth/start` — the grant completes in the
+ *   operator's browser; hosts can't drive that flow from a tool.
+ * - Sending outreach — there is no `/v1` send route (sends are a console /
+ *   gateway operation), so nothing to project.
+ * - Human escalation — no dedicated route; it's the identity contact
+ *   fields (`contactEmail`, `contactPhone`, `websiteUrl`,
+ *   `contactAvailability`), edited via the identity tools.
+ */
+const agentId = zod_1.z
+    .string()
+    .describe('Agent id (URL-safe slug, e.g. agent-acme-bot-pj7r2qx4)');
+const toolId = zod_1.z
+    .string()
+    .describe('Qualified catalog tool id, e.g. "@anychat/tool.custom-http-webhook", or the id of one of the agent\'s custom tools. Passed raw — the tool URL-encodes it.');
+const bindingsBase = (agent) => `/agents/${encodeURIComponent(agent)}/tool-bindings`;
+const bindingPath = (agent, tool) => `${bindingsBase(agent)}/${encodeURIComponent(tool)}`;
+const oauthPath = (agent, tool, action) => `/agents/${encodeURIComponent(agent)}/tools/${encodeURIComponent(tool)}/oauth/${action}`;
+const outreachPath = (agent) => `/agents/${encodeURIComponent(agent)}/outreach`;
+const outreachLinksPath = (agent) => `/agents/${encodeURIComponent(agent)}/outreach-links`;
+const knowledgeDocsPath = (agent) => `/agents/${encodeURIComponent(agent)}/knowledge/documents`;
+/**
+ * Tool-binding `config`: shape is defined by the catalog tool's
+ * `configSchema` (see the tools catalog), so it's an open record. Secret
+ * (`writeOnly`) fields: non-empty string sets/replaces, empty string
+ * clears, omitted leaves the stored secret untouched.
+ */
+const bindingConfig = zod_1.z
+    .record(zod_1.z.string(), zod_1.z.any())
+    .describe("Tool configuration object; shape per the catalog tool's configSchema (e.g. { webhookUrl, authHeader } for the Custom HTTP Webhook tool, a calendar id for Google Calendar). For write-only secret fields (API keys, webhook URLs, auth headers): send a non-empty string to set/replace, an empty string to clear, or omit to leave the stored secret untouched. Reads return { set, last4 } metadata in place of secrets.");
+const followUpStep = zod_1.z
+    .object({
+    id: zod_1.z.string().min(1).describe('Step id (non-empty string, operator-chosen)'),
+    delay: zod_1.z
+        .object({
+        value: zod_1.z.number().positive().describe('Wait since the initial outreach (> 0)'),
+        unit: zod_1.z.enum(['hours', 'days']).describe('Unit for value'),
+    })
+        .describe('How long after the outreach to send the nudge'),
+    messageTemplateId: zod_1.z
+        .string()
+        .min(1)
+        .describe("Id of one of the agent's message templates (must exist, else 404)"),
+})
+    .describe('The single automatic follow-up step');
+exports.capabilityTools = [
+    // ── Tool bindings ────────────────────────────────────────────────────
+    (0, tool_1.defineTool)({
+        name: 'list_tool_bindings',
+        title: 'List tool bindings',
+        description: "List the tools bound to an agent (integrations such as Google Calendar, Slack, Custom HTTP Webhook, or the agent's own custom tools) with each binding's config (secrets redacted to { set, last4 }), enabled flag and configStatus (complete | incomplete | invalid). Use to see which capabilities an agent has wired up before configuring or troubleshooting one. Maps to GET /v1/orgs/{org}/agents/{agent}/tool-bindings.",
+        kind: 'read',
+        scope: 'agents:read',
+        roleFloor: 'viewer',
+        input: { agentId },
+        run: async ({ client }, { agentId }) => client.get(await client.orgPath(bindingsBase(agentId))),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'get_tool_binding',
+        title: 'Get a tool binding',
+        description: 'Read one tool binding on an agent: { toolId, config (secrets redacted), enabled, configStatus }. Use to inspect how a specific integration is configured. Maps to GET /v1/orgs/{org}/agents/{agent}/tool-bindings/{toolId}.',
+        kind: 'read',
+        scope: 'agents:read',
+        roleFloor: 'viewer',
+        input: { agentId, toolId },
+        run: async ({ client }, { agentId, toolId }) => client.get(await client.orgPath(bindingPath(agentId, toolId))),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'upsert_tool_binding',
+        title: 'Create or replace a tool binding',
+        description: "Bind a catalog tool (or one of the agent's custom tools) to the agent, or replace an existing binding's config wholesale. The tool must exist in the catalog (see the tools catalog for its configSchema) — unknown tools are rejected with 404. Returns the saved binding with configStatus. Use update_tool_binding to merge a partial change instead. Maps to PUT /v1/orgs/{org}/agents/{agent}/tool-bindings/{toolId}.",
+        kind: 'write',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        input: {
+            agentId,
+            toolId,
+            config: bindingConfig,
+            enabled: zod_1.z
+                .boolean()
+                .optional()
+                .describe('Whether the agent may use the tool (default: keep the existing value, or true for a new binding)'),
+        },
+        run: async ({ client }, { agentId, toolId, config, enabled }) => client.put(await client.orgPath(bindingPath(agentId, toolId)), {
+            config,
+            ...(enabled !== undefined ? { enabled } : {}),
+        }),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'update_tool_binding',
+        title: 'Update a tool binding (merge)',
+        description: "Merge changes into an existing tool binding's config (fields you omit are left as they are). The binding must already exist (else 404). Returns the saved binding with configStatus. Maps to PATCH /v1/orgs/{org}/agents/{agent}/tool-bindings/{toolId}.",
+        kind: 'write',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        input: {
+            agentId,
+            toolId,
+            config: bindingConfig.optional(),
+            enabled: zod_1.z
+                .boolean()
+                .optional()
+                .describe('Set the enabled flag as part of the same update'),
+        },
+        run: async ({ client }, { agentId, toolId, config, enabled }) => client.patch(await client.orgPath(bindingPath(agentId, toolId)), {
+            ...(config !== undefined ? { config } : {}),
+            ...(enabled !== undefined ? { enabled } : {}),
+        }),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'set_tool_binding_enabled',
+        title: 'Enable or disable a tool binding',
+        description: 'Turn a bound tool on or off for the agent without touching its config — a disabled binding keeps its configuration and any stored secrets. Returns the updated binding. Maps to POST /v1/orgs/{org}/agents/{agent}/tool-bindings/{toolId}/_enable (enabled: true) or …/_disable (enabled: false).',
+        kind: 'write',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        input: {
+            agentId,
+            toolId,
+            enabled: zod_1.z.boolean().describe('true → _enable, false → _disable'),
+        },
+        run: async ({ client }, { agentId, toolId, enabled }) => client.post(await client.orgPath(`${bindingPath(agentId, toolId)}/${enabled ? '_enable' : '_disable'}`)),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'delete_tool_binding',
+        title: 'Delete a tool binding',
+        description: 'Unbind a tool from the agent and clear any stored secrets for the binding (irreversible — the config and secrets are gone; the agent stops offering the tool). To merely pause a tool use set_tool_binding_enabled; to drop only an OAuth grant use disconnect_oauth. Returns { ok: true, deleted: toolId } (the API replies 204). Maps to DELETE /v1/orgs/{org}/agents/{agent}/tool-bindings/{toolId}.',
+        kind: 'destructive',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        input: { agentId, toolId },
+        run: async ({ client }, { agentId, toolId }) => {
+            await client.delete(await client.orgPath(bindingPath(agentId, toolId)));
+            return { ok: true, deleted: toolId };
+        },
+    }),
+    // ── OAuth-runtime tools ──────────────────────────────────────────────
+    (0, tool_1.defineTool)({
+        name: 'get_oauth_status',
+        title: 'Get OAuth connection status',
+        description: 'Report the OAuth credential state for an OAuth-runtime tool binding (Google Calendar, Slack, …): { state: "not-connected" | "connected" | "expired" | "revoked" | "error", connectedAt?, lastError? }. Use to check whether an integration is connected or needs the operator to reconnect. Connecting requires the operator\'s browser (the console\'s Connect button, or POST …/oauth/start) and is not exposed as a tool. Maps to GET /v1/orgs/{org}/agents/{agent}/tools/{toolId}/oauth/status.',
+        kind: 'read',
+        scope: 'agents:read',
+        roleFloor: 'viewer',
+        input: { agentId, toolId },
+        run: async ({ client }, { agentId, toolId }) => client.get(await client.orgPath(oauthPath(agentId, toolId, 'status'))),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'disconnect_oauth',
+        title: 'Disconnect an OAuth grant',
+        description: 'Revoke the OAuth grant at the provider and delete the stored credential for an OAuth-runtime tool binding. The agent immediately loses access to the connected account (e.g. the calendar) until an operator reconnects in a browser; the binding itself stays so reconnecting is one click. Confirm with the user before running. Maps to POST /v1/orgs/{org}/agents/{agent}/tools/{toolId}/oauth/disconnect.',
+        kind: 'destructive',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        input: { agentId, toolId },
+        run: async ({ client }, { agentId, toolId }) => client.post(await client.orgPath(oauthPath(agentId, toolId, 'disconnect'))),
+    }),
+    // ── Outreach config ──────────────────────────────────────────────────
+    (0, tool_1.defineTool)({
+        name: 'get_outreach_config',
+        title: 'Get outreach config',
+        description: "Read the agent's outreach configuration: greetingTemplateId (the message template used as the first message when the agent initiates a conversation) and followUps (the single automatic nudge for non-responders: enabled, steps[1], quietHours). Returns {} when nothing is configured (outreach then falls back to an LLM-composed opener). Maps to GET /v1/orgs/{org}/agents/{agent}/outreach.",
+        kind: 'read',
+        scope: 'agents:read',
+        roleFloor: 'viewer',
+        input: { agentId },
+        run: async ({ client }, { agentId }) => client.get(await client.orgPath(outreachPath(agentId))),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'replace_outreach_config',
+        title: 'Replace outreach config',
+        description: "Replace the agent's whole outreach configuration (PUT semantics: fields you omit are cleared — read it first with get_outreach_config). greetingTemplateId must be an existing message template on the agent (else 404); followUps.steps holds exactly one step (more → 422); pass {} to clear everything. Enabling follow-ups only enrolls people contacted afterwards — never existing contacts. Returns the saved config. Maps to PUT /v1/orgs/{org}/agents/{agent}/outreach.",
+        kind: 'write',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        input: {
+            agentId,
+            greetingTemplateId: zod_1.z
+                .string()
+                .optional()
+                .describe("Id of one of the agent's message templates to use as the outreach greeting; omit to fall back to an LLM-composed opener"),
+            followUps: zod_1.z
+                .object({
+                enabled: zod_1.z.boolean().describe('Master switch for automatic follow-up sending'),
+                steps: zod_1.z
+                    .array(followUpStep)
+                    .max(1)
+                    .describe('Exactly one follow-up step (or empty)'),
+                quietHours: zod_1.z
+                    .object({
+                    startHour: zod_1.z.number().int().min(0).max(23).describe('0–23, inclusive'),
+                    endHour: zod_1.z
+                        .number()
+                        .int()
+                        .min(0)
+                        .max(23)
+                        .describe('0–23, exclusive; may wrap midnight'),
+                    timezone: zod_1.z.string().min(1).describe('IANA zone, e.g. "America/Chicago"'),
+                })
+                    .optional()
+                    .describe('Suppress the automatic send during these local hours'),
+            })
+                .optional()
+                .describe('Automatic follow-up (nudge) config; omit to clear follow-ups'),
+        },
+        run: async ({ client }, { agentId, greetingTemplateId, followUps }) => client.put(await client.orgPath(outreachPath(agentId)), {
+            ...(greetingTemplateId !== undefined ? { greetingTemplateId } : {}),
+            ...(followUps !== undefined ? { followUps } : {}),
+        }),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'preview_outreach',
+        title: 'Preview outreach greeting',
+        description: 'Render the configured outreach greeting for a specific person and return what would be sent: { greeting: { renderedText, missingSlots[], blocked } }. Use to check slot substitution before sending outreach. Returns 404 when no greeting template is configured. Maps to GET /v1/orgs/{org}/agents/{agent}/outreach/preview?personId=….',
+        kind: 'read',
+        scope: 'agents:read',
+        roleFloor: 'viewer',
+        input: {
+            agentId,
+            personId: zod_1.z
+                .string()
+                .describe('Id of a Person on this agent to render the greeting against'),
+        },
+        run: async ({ client }, { agentId, personId }) => client.get(await client.orgPath(`${outreachPath(agentId)}/preview`), { personId }),
+    }),
+    // ── Outreach links ───────────────────────────────────────────────────
+    (0, tool_1.defineTool)({
+        name: 'list_outreach_links',
+        title: 'List outreach links',
+        description: "List the agent's outreach links — shareable public phone-entry pages that let a prospect start an RCS conversation with the agent. Each has { id, code, url, label, maxUses, usesRemaining, redemptionCount, expiresAt, disabled, createdAt }. Maps to GET /v1/orgs/{org}/agents/{agent}/outreach-links.",
+        kind: 'read',
+        scope: 'agents:read',
+        roleFloor: 'viewer',
+        input: { agentId },
+        run: async ({ client }, { agentId }) => client.get(await client.orgPath(outreachLinksPath(agentId))),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'create_outreach_link',
+        title: 'Create an outreach link',
+        description: "Mint a new use-limited, time-limited outreach link against one of the agent's RCS channel bindings (find the binding id with the channel tools). Returns the link including its shareable url. Validation failures return 400 with a human-readable error. Maps to POST /v1/orgs/{org}/agents/{agent}/outreach-links.",
+        kind: 'write',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        input: {
+            agentId,
+            bindingId: zod_1.z
+                .string()
+                .describe('Id of an RCS channel binding on this agent (required)'),
+            label: zod_1.z.string().optional().describe('Operator-facing note, e.g. "Trade-show QR"'),
+            maxUses: zod_1.z
+                .number()
+                .int()
+                .min(1)
+                .max(500)
+                .optional()
+                .describe('Redemption cap, 1–500 (default 25)'),
+            expiresAt: zod_1.z
+                .string()
+                .optional()
+                .describe('ISO-8601 expiry, at most 30 days out (default 14 days from now)'),
+        },
+        run: async ({ client }, { agentId, bindingId, label, maxUses, expiresAt }) => client.post(await client.orgPath(outreachLinksPath(agentId)), {
+            bindingId,
+            ...(label !== undefined ? { label } : {}),
+            ...(maxUses !== undefined ? { maxUses } : {}),
+            ...(expiresAt !== undefined ? { expiresAt } : {}),
+        }),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'update_outreach_link',
+        title: 'Pause or resume an outreach link',
+        description: "Set an outreach link's disabled flag — pause (disabled: true) or resume (false) without losing its remaining uses. This is the only mutable field. Returns the updated link. Maps to PATCH /v1/orgs/{org}/agents/{agent}/outreach-links/{id}.",
+        kind: 'write',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        input: {
+            agentId,
+            linkId: zod_1.z.string().describe('Outreach link id (from list_outreach_links)'),
+            disabled: zod_1.z.boolean().describe('true to pause the link, false to resume it'),
+        },
+        run: async ({ client }, { agentId, linkId, disabled }) => client.patch(await client.orgPath(`${outreachLinksPath(agentId)}/${encodeURIComponent(linkId)}`), { disabled }),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'delete_outreach_link',
+        title: 'Delete an outreach link',
+        description: 'Permanently remove an outreach link — anyone holding the URL can no longer use it and its redemption count is lost. Prefer update_outreach_link (disabled: true) to pause instead. Returns { ok: true, deleted: linkId } (the API replies 204). Maps to DELETE /v1/orgs/{org}/agents/{agent}/outreach-links/{id}.',
+        kind: 'destructive',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        input: {
+            agentId,
+            linkId: zod_1.z.string().describe('Outreach link id (from list_outreach_links)'),
+        },
+        run: async ({ client }, { agentId, linkId }) => {
+            await client.delete(await client.orgPath(`${outreachLinksPath(agentId)}/${encodeURIComponent(linkId)}`));
+            return { ok: true, deleted: linkId };
+        },
+    }),
+    // ── Knowledge documents (read-only) ──────────────────────────────────
+    (0, tool_1.defineTool)({
+        name: 'list_knowledge_documents',
+        title: 'List knowledge documents',
+        description: "List the documents in the agent's knowledge base (metadata only: id, fileName, mimeType, title, status, uploadedAt, createdAt, updatedAt — never the extracted text). Use to see what the agent can draw on for answers. Uploading and deleting documents is console-only today. Maps to GET /v1/orgs/{org}/agents/{agent}/knowledge/documents.",
+        kind: 'read',
+        scope: 'knowledge:read',
+        roleFloor: 'viewer',
+        input: { agentId },
+        run: async ({ client }, { agentId }) => client.get(await client.orgPath(knowledgeDocsPath(agentId))),
+    }),
+];
+//# sourceMappingURL=capabilities.js.map

package/dist/tools/capabilities.js.map

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

package/dist/tools/channels.d.ts

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

package/dist/tools/channels.js

@@ -0,0 +1,208 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.channelTools = void 0;
+const zod_1 = require("zod");
+const tool_1 = require("../tool");
+/**
+ * Channels — the bindings that wire an agent to the messaging channels its
+ * users live on. Mirrors the "Channels" section of the API reference:
+ * `/v1/orgs/{org}/agents/{agent}/channels`.
+ *
+ * Vocabulary (keep it operator-facing): a *channel* is what the user sees
+ * (rcs, appleMessages, whatsapp, sms, webchat, …); the *provider* serving it
+ * is an implementation detail. A binding is either **managed** (Anychat picks
+ * the provider and runs provisioning — a human-actioned sysop queue for rich
+ * channels, days to weeks) or **unmanaged** (the operator brings their own
+ * provider account and credentials; `auth` is write-only and never read back).
+ * One live binding per channel per agent; webchat is created automatically
+ * with every agent. Provisioning progress is read off the binding itself
+ * (`status`, `statusDetail`, `events`) — there is no separate provisioning
+ * route.
+ */
+const CHANNEL_NAMES = [
+    'rcs',
+    'appleMessages',
+    'whatsapp',
+    'sms',
+    'webchat',
+    'viber',
+    'instagram',
+    'slack',
+    'poe',
+];
+const PROVIDERS = [
+    'googleRbm',
+    'webexRcs',
+    'webexAmb',
+    'twilio',
+    'whatsappCloud',
+    'viber',
+    'slack',
+    'poe',
+];
+const channelName = zod_1.z
+    .enum(CHANNEL_NAMES)
+    .describe('Public channel name. rcs | appleMessages (Apple Messages for Business) | whatsapp | sms | webchat | viber | instagram | slack | poe.');
+const deliverySchema = zod_1.z
+    .object({
+    minMessageDelayMs: zod_1.z
+        .number()
+        .int()
+        .min(250)
+        .max(3000)
+        .optional()
+        .describe('Minimum gap in ms (250–3000) between consecutive agent messages to one user on this channel. Paces multi-bubble replies and keeps ordering on providers that do not guarantee it. Omit for no pacing.'),
+})
+    .describe('Delivery pacing (any binding mode).');
+const complianceSchema = zod_1.z
+    .object({
+    enabled: zod_1.z
+        .boolean()
+        .describe('Turn carrier compliance on/off (default off). When on, Anychat sends a one-time disclaimer per messaging relationship and deterministically handles STOP/UNSUBSCRIBE/CANCEL/END/QUIT (opt-out), HELP (brand contact reply from identity) and START (re-subscribe). Leave off if the provider already auto-handles opt-out keywords (e.g. Twilio Advanced Opt-Out) to avoid double confirmations.'),
+    disclaimerText: zod_1.z
+        .string()
+        .max(1000)
+        .optional()
+        .describe('Override for the conversation-start disclaimer (max 1000 chars). Omit for the stock operator text.'),
+})
+    .describe('Carrier compliance block — RCS and SMS bindings only.');
+const agentIdField = zod_1.z
+    .string()
+    .describe('Agent id (URL-safe slug, e.g. agent-acme-bot-pj7r2qx4).');
+const bindingIdField = zod_1.z
+    .string()
+    .describe('Channel binding id, as returned by list_channels / get_channel.');
+function bindingPath(agentId, bindingId) {
+    const base = `/agents/${encodeURIComponent(agentId)}/channels`;
+    return bindingId ? `${base}/${encodeURIComponent(bindingId)}` : base;
+}
+exports.channelTools = [
+    (0, tool_1.defineTool)({
+        name: 'list_channels',
+        title: 'List channel bindings',
+        description: 'List the channel bindings of an agent — one per connected channel (rcs, appleMessages, whatsapp, sms, webchat, …) with mode (managed = Anychat provisions; unmanaged = operator-supplied provider account), status (Requested | Provisioning | ActionRequired | Active | Failed | Disabled), statusDetail, lifecycle events, and delivery/compliance settings. Use it to see what an agent is reachable on and to follow provisioning progress; credentials are never returned. Maps to GET /v1/orgs/{org}/agents/{agent}/channels (returns { data: ChannelBinding[] }, not paginated).',
+        kind: 'read',
+        scope: 'agents:read',
+        roleFloor: 'viewer',
+        input: { agentId: agentIdField },
+        run: async ({ client }, { agentId }) => client.get(await client.orgPath(bindingPath(agentId))),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'get_channel',
+        title: 'Get a channel binding',
+        description: 'Fetch one channel binding by id, including its provisioning status, statusDetail (what is blocking an ActionRequired/Failed binding), oldest-first lifecycle events, routingId (display-only provider id), the business inputs filed with a managed request, and delivery/compliance settings. Poll this to follow a managed provisioning request. Never returns credentials. Maps to GET /v1/orgs/{org}/agents/{agent}/channels/{bindingId}.',
+        kind: 'read',
+        scope: 'agents:read',
+        roleFloor: 'viewer',
+        input: { agentId: agentIdField, bindingId: bindingIdField },
+        run: async ({ client }, { agentId, bindingId }) => client.get(await client.orgPath(bindingPath(agentId, bindingId))),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'request_channel',
+        title: 'Request a managed channel',
+        description: 'File a MANAGED channel request: name the channel and supply the business inputs its setup form asks for (brand name, banner, business category, 10DLC registration info, …; the form comes from the `channels` catalog, GET /v1/catalogs/channels/{channel}). Anychat picks the provider and runs the carrier/Apple/Meta provisioning workflow — a request that humans act on and that takes days to weeks for rich channels, so confirm with the operator before calling. Returns 201 with status "Requested" (or "Active" for instantly-provisioned channels); follow progress with get_channel. 409 if the channel is already bound; 400 if the channel has no managed mode (slack, viber, poe are unmanaged-only — use bind_channel). Never pass credentials here. Maps to POST /v1/orgs/{org}/agents/{agent}/channels with mode "managed".',
+        kind: 'destructive',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        input: {
+            agentId: agentIdField,
+            channel: channelName,
+            inputs: zod_1.z
+                .record(zod_1.z.string(), zod_1.z.any())
+                .optional()
+                .describe('Business/identity fields per the channel\'s managed setup form (e.g. { "brandName": "Acme Health", "bannerUrl": "https://…", "businessCategory": "Health & Wellness" }). Keys and required flags come from the `channels` catalog; several are seeded from the agent identity if omitted.'),
+        },
+        run: async ({ client }, { agentId, channel, inputs }) => client.post(await client.orgPath(bindingPath(agentId)), {
+            channel,
+            mode: 'managed',
+            ...(inputs !== undefined ? { inputs } : {}),
+        }),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'bind_channel',
+        title: 'Bind an unmanaged channel (bring your own provider)',
+        description: 'Create an UNMANAGED channel binding using the operator\'s own provider account: name the channel, the provider serving it, and the provider\'s credential form. `auth` is WRITE-ONLY — accepted here and on update_channel for rotation, never returned by any read. Provider per channel: rcs → googleRbm | webexRcs; appleMessages → webexAmb; whatsapp → whatsappCloud; sms → twilio; slack → slack; viber → viber; poe → poe (credential field keys and required flags come from the `channels` catalog, GET /v1/catalogs/channels/{channel}). Unmanaged bindings go straight to status "Active". 409 if the channel is already bound; 400/422 if provider or required auth fields are wrong. Maps to POST /v1/orgs/{org}/agents/{agent}/channels with mode "unmanaged".',
+        kind: 'write',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        input: {
+            agentId: agentIdField,
+            channel: channelName,
+            provider: zod_1.z
+                .enum(PROVIDERS)
+                .describe("Provider whose account you are bringing. Must be one of the channel's unmanaged providers (e.g. twilio for sms, whatsappCloud for whatsapp, googleRbm or webexRcs for rcs, webexAmb for appleMessages)."),
+            auth: zod_1.z
+                .record(zod_1.z.string(), zod_1.z.any())
+                .describe('Provider credentials, WRITE-ONLY (never echoed back). Keys per the provider\'s credential form, e.g. Twilio: { "accountSid": "AC…", "authToken": "…", "messagingServiceSid": "MG…", "phoneNumber": "+1555…" }. Treat as secrets.'),
+        },
+        run: async ({ client }, { agentId, channel, provider, auth }) => client.post(await client.orgPath(bindingPath(agentId)), {
+            channel,
+            mode: 'unmanaged',
+            provider,
+            auth,
+        }),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'update_channel',
+        title: 'Update a channel binding',
+        description: 'Update settings on a channel binding: `delivery` (message pacing, any mode), `compliance` (carrier compliance, RCS/SMS only), and/or `auth` (rotate credentials — unmanaged bindings only; write-only, never returned). Supply at least one field; pass null for delivery or compliance to clear that block. Out-of-range pacing → 400; compliance on a non-carrier channel → 400; auth on a managed binding → 400. Returns the updated binding. Maps to PATCH /v1/orgs/{org}/agents/{agent}/channels/{bindingId}.',
+        kind: 'write',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        input: {
+            agentId: agentIdField,
+            bindingId: bindingIdField,
+            delivery: deliverySchema
+                .nullable()
+                .optional()
+                .describe('Delivery pacing settings; null clears pacing; omit to leave unchanged.'),
+            compliance: complianceSchema
+                .nullable()
+                .optional()
+                .describe('Carrier compliance settings (rcs/sms only); null clears the block; omit to leave unchanged.'),
+            auth: zod_1.z
+                .record(zod_1.z.string(), zod_1.z.any())
+                .optional()
+                .describe("Replacement provider credentials for an UNMANAGED binding (rotation). WRITE-ONLY — never returned. Keys per the provider's credential form. Omit to leave unchanged."),
+        },
+        run: async ({ client }, { agentId, bindingId, delivery, compliance, auth }) => client.patch(await client.orgPath(bindingPath(agentId, bindingId)), {
+            ...(delivery !== undefined ? { delivery } : {}),
+            ...(compliance !== undefined ? { compliance } : {}),
+            ...(auth !== undefined ? { auth } : {}),
+        }),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'disable_channel',
+        title: 'Disable a channel binding',
+        description: 'Temporarily take a channel offline for this agent: the binding moves to status "Disabled" and stops carrying traffic, but is kept (credentials, provisioning, carrier verification intact) so enable_channel can restore it in one step. Prefer this over delete_channel for a pause. Returns the updated binding. Maps to POST /v1/orgs/{org}/agents/{agent}/channels/{bindingId}/_disable.',
+        kind: 'write',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        input: { agentId: agentIdField, bindingId: bindingIdField },
+        run: async ({ client }, { agentId, bindingId }) => client.post(`${await client.orgPath(bindingPath(agentId, bindingId))}/_disable`),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'enable_channel',
+        title: 'Enable a channel binding',
+        description: 'Re-enable a previously disabled channel binding so it carries traffic again (status back to "Active"). Returns the updated binding. Maps to POST /v1/orgs/{org}/agents/{agent}/channels/{bindingId}/_enable.',
+        kind: 'write',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        input: { agentId: agentIdField, bindingId: bindingIdField },
+        run: async ({ client }, { agentId, bindingId }) => client.post(`${await client.orgPath(bindingPath(agentId, bindingId))}/_enable`),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'delete_channel',
+        title: 'Delete a channel binding',
+        description: 'Remove a channel binding from the agent — cancels a pending managed request or releases a live channel (the agent stops being reachable there; unmanaged credentials are discarded; managed RCS is archived rather than deleted so a later re-request restores the same carrier-verified agent). Irreversible for most channels — use disable_channel for a pause. Returns the removed binding. Maps to DELETE /v1/orgs/{org}/agents/{agent}/channels/{bindingId}.',
+        kind: 'destructive',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        input: { agentId: agentIdField, bindingId: bindingIdField },
+        run: async ({ client }, { agentId, bindingId }) => {
+            const removed = await client.delete(await client.orgPath(bindingPath(agentId, bindingId)));
+            return removed ?? { ok: true, deleted: bindingId };
+        },
+    }),
+];
+//# sourceMappingURL=channels.js.map

package/dist/tools/channels.js.map

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

package/dist/tools/definition.d.ts

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