@rubytech/create-maxy-code 0.1.0

package/payload/platform/plugins/waitlist/mcp/dist/tools/waitlist-setup.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Set up automatic waitlist extraction as a workflow.
+ *
+ * Creates:
+ *   1. A Workflow node with 3 steps (scan → LLM extract → persist)
+ *   2. A scheduled Event that dispatches workflow-execute at the
+ *      specified interval
+ *
+ * The extraction prompt is stored in the LLM step and is visible
+ * via workflow-get and editable via workflow-update. The user can
+ * change what fields are extracted, adjust the model, or modify
+ * the prompt — all through conversation.
+ *
+ * Idempotent: if the workflow already exists, returns its details.
+ * Cleans up old-style events that pointed at the removed
+ * waitlist-extract tool.
+ */
+import { type CreatedBy } from "../../../../../lib/graph-write/dist/index.js";
+export interface WaitlistSetupParams {
+    accountId: string;
+    recurrence?: string;
+    timezone?: string;
+    createdBy: CreatedBy;
+}
+export interface WaitlistSetupResult {
+    workflowId: string;
+    eventId: string;
+    recurrence: string;
+    nextRun: string;
+    alreadyExists: boolean;
+}
+export declare function waitlistSetup(params: WaitlistSetupParams): Promise<WaitlistSetupResult>;
+//# sourceMappingURL=waitlist-setup.d.ts.map

package/payload/platform/plugins/waitlist/mcp/dist/tools/waitlist-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitlist-setup.d.ts","sourceRoot":"","sources":["../../src/tools/waitlist-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,8CAA8C,CAAC;AA0CtD,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;CACxB;AAMD,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAsP9B"}

package/payload/platform/plugins/waitlist/mcp/dist/tools/waitlist-setup.js

@@ -0,0 +1,335 @@
+/**
+ * Set up automatic waitlist extraction as a workflow.
+ *
+ * Creates:
+ *   1. A Workflow node with 3 steps (scan → LLM extract → persist)
+ *   2. A scheduled Event that dispatches workflow-execute at the
+ *      specified interval
+ *
+ * The extraction prompt is stored in the LLM step and is visible
+ * via workflow-get and editable via workflow-update. The user can
+ * change what fields are extracted, adjust the model, or modify
+ * the prompt — all through conversation.
+ *
+ * Idempotent: if the workflow already exists, returns its details.
+ * Cleans up old-style events that pointed at the removed
+ * waitlist-extract tool.
+ */
+import { randomUUID } from "node:crypto";
+import { getSession } from "../lib/neo4j.js";
+import { computeEmbedding } from "../lib/embedding.js";
+import { healBrokenPrompt, healMissingConversationDate, WORKFLOW_NAME } from "./waitlist-heal.js";
+import { writeNodeWithEdges, } from "../../../../../lib/graph-write/dist/index.js";
+import cronParser from "cron-parser";
+const { parseExpression } = cronParser;
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_RECURRENCE = "0 */4 * * *"; // Every 4 hours
+/**
+ * The extraction prompt — migrated from the former anthropic.ts Haiku call.
+ * This is the editable payload: the user sees it via workflow-get and
+ * modifies it via workflow-update to change extraction behaviour.
+ */
+const EXTRACTION_PROMPT = "You extract contact details and customer discovery intelligence from visitor chat conversations.\n\n" +
+    "Below is a JSON object containing public agent conversations. It has a `conversations` array " +
+    "where each element has a `conversationId`, a `createdAt` timestamp, and a `messages` array of user message strings. " +
+    "For each conversation that contains an email address, extract the visitor's details.\n\n" +
+    "Return ONLY a JSON array of objects. Each object must have these fields:\n" +
+    '- "email": the visitor\'s email address (required — skip conversations with no email)\n' +
+    '- "givenName": the visitor\'s first/given name, or null if unclear\n' +
+    '- "familyName": the visitor\'s last/family name, or null if unclear\n' +
+    '- "conversationId": the conversation ID from the input data\n' +
+    '- "conversationDate": the createdAt timestamp of the conversation from the input data\n' +
+    '- "businessType": what kind of business they run or work in, or null\n' +
+    '- "role": their role or position, or null\n' +
+    '- "needs": what they need or are looking for, in their own words where possible, or null\n' +
+    '- "challenges": pain points or challenges they mentioned, or null\n' +
+    '- "interests": specific features, capabilities, or topics they asked about, or null\n' +
+    '- "engagementQuality": one of "high" (asked detailed questions, shared specifics), ' +
+    '"medium" (some back-and-forth, genuine interest), or "low" (brief, noncommittal), or null\n' +
+    '- "otherSignals": any other noteworthy signal (timeline urgency, competitor mentions, referral source), or null\n\n' +
+    "Only include fields where the visitor actually revealed information. " +
+    "Return valid JSON only. No markdown, no explanation. If no conversations contain an email, return [].\n\n" +
+    "Conversations:\n{{conversations}}";
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+export async function waitlistSetup(params) {
+    const { accountId, timezone, createdBy } = params;
+    const recurrence = params.recurrence ?? DEFAULT_RECURRENCE;
+    // Resolution-trace line: accountId always comes from env (ACCOUNT_ID set by
+    // the MCP spawner); the Zod schema does not accept accountId as arg.
+    // getSession() triggers driver init first, which throws (Task 580) if
+    // NEO4J_URI is unset — the log below therefore only ever prints a validated
+    // URI, never `undefined`.
+    const session = getSession();
+    console.error(`[waitlist-setup] resolved accountId=${accountId} source=env neo4j_uri=${process.env.NEO4J_URI}`);
+    try {
+        // ------------------------------------------------------------------
+        // Clean up old-style events (actionTool: waitlist-extract)
+        // These pointed at the removed bespoke extraction tool.
+        // ------------------------------------------------------------------
+        await session.run(`MATCH (e:Event {
+        accountId: $accountId,
+        actionPlugin: 'waitlist',
+        actionTool: 'waitlist-extract'
+      })
+       DELETE e`, { accountId });
+        // ------------------------------------------------------------------
+        // Check for existing workflow
+        // ------------------------------------------------------------------
+        const existingResult = await session.run(`MATCH (w:Workflow {accountId: $accountId, name: $name})
+       WHERE w.status IN ['active', 'draft']
+       OPTIONAL MATCH (e:Event {
+         accountId: $accountId,
+         actionPlugin: 'workflows',
+         actionTool: 'workflow-execute'
+       })
+       WHERE e.eventStatus IN ['scheduled', 'due']
+         AND e.actionArgs CONTAINS w.workflowId
+       RETURN w.workflowId AS workflowId,
+              e.eventId AS eventId,
+              e.recurrence AS recurrence,
+              e.nextRun AS nextRun
+       LIMIT 1`, { accountId, name: WORKFLOW_NAME });
+        if (existingResult.records.length > 0) {
+            const existing = existingResult.records[0];
+            const workflowId = existing.get("workflowId");
+            const eventId = existing.get("eventId");
+            // Self-healing: detect broken prompt pattern and update surgically.
+            // The original prompt referenced {{conversations._raw}} which doesn't
+            // exist — waitlist-scan returns structured JSON, not {_raw: text}.
+            // Only updates if the broken pattern is present; preserves any other
+            // user customizations made via workflow-update.
+            await healBrokenPrompt(session, workflowId);
+            await healMissingConversationDate(session, workflowId);
+            // Workflow exists but no event — create one
+            if (!eventId) {
+                const newEventResult = await createScheduledEvent(session, accountId, workflowId, recurrence, timezone, createdBy);
+                return {
+                    workflowId,
+                    eventId: newEventResult.eventId,
+                    recurrence,
+                    nextRun: newEventResult.nextRun,
+                    alreadyExists: true,
+                };
+            }
+            return {
+                workflowId,
+                eventId,
+                recurrence: existing.get("recurrence"),
+                nextRun: existing.get("nextRun"),
+                alreadyExists: true,
+            };
+        }
+        // ------------------------------------------------------------------
+        // Create workflow with 3 steps
+        // ------------------------------------------------------------------
+        const workflowId = randomUUID();
+        const now = new Date().toISOString();
+        // Compute embedding for workflow discovery
+        const embeddingText = `${WORKFLOW_NAME} — scans public conversations for waitlist sign-ups, extracts contact details and discovery intelligence via LLM`;
+        const embedding = await computeEmbedding(embeddingText);
+        const workflowProps = {
+            workflowId,
+            accountId,
+            name: WORKFLOW_NAME,
+            description: "Scans public agent conversations, extracts contact details and customer discovery intelligence via LLM, " +
+                "and creates Person nodes idempotently. Edit the extraction prompt via workflow-update to change what fields are extracted.",
+            status: "active",
+            createdAt: now,
+            updatedAt: now,
+        };
+        if (embedding.length > 0) {
+            workflowProps.embedding = embedding;
+        }
+        // MERGE on {accountId, name} prevents duplicate workflows when the
+        // heartbeat reconciliation and an admin session call setup concurrently.
+        // Returns the actual workflowId — may differ from the local one if
+        // another caller created the node first.
+        const mergeResult = await session.run(`MERGE (w:Workflow {accountId: $accountId, name: $name})
+       ON CREATE SET w += $props
+       RETURN w.workflowId AS workflowId`, { accountId, name: WORKFLOW_NAME, props: workflowProps });
+        const actualWorkflowId = mergeResult.records[0]?.get("workflowId");
+        if (actualWorkflowId !== workflowId) {
+            // Race: another caller created the workflow concurrently.
+            // Return early — next cycle's existence check handles Event creation.
+            const eventResult = await createScheduledEvent(session, accountId, actualWorkflowId, recurrence, timezone, createdBy);
+            return {
+                workflowId: actualWorkflowId,
+                eventId: eventResult.eventId,
+                recurrence,
+                nextRun: eventResult.nextRun,
+                alreadyExists: true,
+            };
+        }
+        // Step 1: Scan public conversations
+        const step1Id = randomUUID();
+        await session.run(`MATCH (w:Workflow {workflowId: $workflowId})
+       CREATE (w)-[:HAS_STEP]->(s:WorkflowStep $props)`, {
+            workflowId,
+            props: {
+                stepId: step1Id,
+                workflowId,
+                accountId,
+                type: "tool",
+                plugin: "waitlist",
+                tool: "waitlist-scan",
+                params: null,
+                dependsOn: null,
+                onFailure: "abort",
+                retryLimit: null,
+                outputKey: "conversations",
+                timeout: 30,
+                position: 0,
+                label: "Scan public conversations",
+                // LLM-step fields (null for tool steps)
+                prompt: null,
+                model: null,
+                maxTokens: null,
+            },
+        });
+        // Step 2: LLM extraction
+        const step2Id = randomUUID();
+        await session.run(`MATCH (w:Workflow {workflowId: $workflowId})
+       CREATE (w)-[:HAS_STEP]->(s:WorkflowStep $props)`, {
+            workflowId,
+            props: {
+                stepId: step2Id,
+                workflowId,
+                accountId,
+                type: "llm",
+                prompt: EXTRACTION_PROMPT,
+                model: null, // Uses account's adminModel
+                maxTokens: 4096,
+                dependsOn: JSON.stringify([step1Id]),
+                onFailure: "abort",
+                retryLimit: null,
+                outputKey: "extractions",
+                timeout: 120,
+                position: 1,
+                label: "Extract contacts and discovery intelligence",
+                // Tool-step fields (null for LLM steps)
+                plugin: null,
+                tool: null,
+                params: null,
+            },
+        });
+        // Step 3: Persist extraction results
+        await session.run(`MATCH (w:Workflow {workflowId: $workflowId})
+       CREATE (w)-[:HAS_STEP]->(s:WorkflowStep $props)`, {
+            workflowId,
+            props: {
+                stepId: randomUUID(),
+                workflowId,
+                accountId,
+                type: "tool",
+                plugin: "waitlist",
+                tool: "waitlist-persist",
+                params: JSON.stringify({
+                    extractions: "{{extractions}}",
+                    conversations: "{{conversations}}",
+                }),
+                dependsOn: JSON.stringify([step2Id]),
+                onFailure: "abort",
+                retryLimit: null,
+                outputKey: "results",
+                timeout: 60,
+                position: 2,
+                label: "Create/update Person nodes from extractions",
+                // LLM-step fields (null for tool steps)
+                prompt: null,
+                model: null,
+                maxTokens: null,
+            },
+        });
+        // ------------------------------------------------------------------
+        // Create scheduled event
+        // ------------------------------------------------------------------
+        const eventResult = await createScheduledEvent(session, accountId, workflowId, recurrence, timezone, createdBy);
+        return {
+            workflowId,
+            eventId: eventResult.eventId,
+            recurrence,
+            nextRun: eventResult.nextRun,
+            alreadyExists: false,
+        };
+    }
+    finally {
+        await session.close();
+    }
+}
+// ---------------------------------------------------------------------------
+// Event creation helper
+// ---------------------------------------------------------------------------
+async function createScheduledEvent(session, accountId, workflowId, recurrence, timezone, createdBy) {
+    // Validate cron expression and compute nextRun
+    let nextRun;
+    try {
+        const interval = parseExpression(recurrence, {
+            currentDate: new Date(),
+            tz: timezone,
+        });
+        nextRun = interval.next().toISOString();
+    }
+    catch (err) {
+        throw new Error(`Invalid recurrence expression: "${recurrence}" — ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const eventId = randomUUID();
+    const now = new Date().toISOString();
+    const props = {
+        eventId,
+        accountId,
+        name: "Waitlist lead extraction",
+        description: "Executes the waitlist extraction workflow on schedule",
+        startDate: now,
+        eventStatus: "scheduled",
+        recurrence,
+        nextRun,
+        sourcePlugin: "waitlist",
+        actionPlugin: "workflows",
+        actionTool: "workflow-execute",
+        actionArgs: JSON.stringify({
+            workflowId,
+            trigger: "schedule",
+        }),
+        createdAt: now,
+        updatedAt: now,
+    };
+    if (timezone) {
+        props.timezone = timezone;
+    }
+    // Compute embedding for event discoverability
+    const embeddingText = "Event: Waitlist lead extraction — runs workflow to scan public conversations for sign-ups";
+    const embedding = await computeEmbedding(embeddingText);
+    if (embedding.length > 0) {
+        props.embedding = embedding;
+    }
+    // Write doctrine (Task 673 / Task 676): the Event must be created with
+    // at least one adjacency in the same transaction. The Event exists to
+    // trigger the Workflow it references via actionArgs — that's the
+    // semantic link. Pre-resolve the Workflow elementId; if missing, the
+    // Workflow was deleted concurrently and there's nothing to schedule.
+    const wfResult = await session.run(`MATCH (w:Workflow {workflowId: $workflowId, accountId: $accountId})
+     RETURN elementId(w) AS id LIMIT 1`, { workflowId, accountId });
+    if (wfResult.records.length === 0) {
+        throw new Error(`Write doctrine violated: cannot schedule Event — target Workflow ${workflowId} not found.`);
+    }
+    const relationships = [
+        {
+            type: "ABOUT",
+            direction: "outgoing",
+            targetNodeId: wfResult.records[0].get("id"),
+        },
+    ];
+    await writeNodeWithEdges({
+        session,
+        labels: ["Event"],
+        props,
+        relationships,
+        createdBy,
+    });
+    return { eventId, nextRun };
+}
+//# sourceMappingURL=waitlist-setup.js.map

package/payload/platform/plugins/waitlist/mcp/dist/tools/waitlist-setup.js.map

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

package/payload/platform/plugins/waitlist/mcp/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@maxy/waitlist",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "cron-parser": "^4.9.0",
+    "neo4j-driver": "^5.28.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0",
+    "vitest": "^4.1.2"
+  }
+}

package/payload/platform/plugins/waitlist/mcp/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    environment: "node",
+    include: ["src/**/__tests__/**/*.test.ts"],
+    testTimeout: 10_000,
+  },
+});

package/payload/platform/plugins/whatsapp/PLUGIN.md

@@ -0,0 +1,71 @@
+---
+name: whatsapp
+description: WhatsApp messaging channel — Baileys QR pairing, DM/group policy enforcement, inbound routing, business hours gating, outbound messaging, document sending, conversation browsing.
+tools:
+  - whatsapp-login-start
+  - whatsapp-login-wait
+  - whatsapp-status
+  - whatsapp-disconnect
+  - whatsapp-send
+  - whatsapp-send-document
+  - whatsapp-config
+  - whatsapp-activity
+  - whatsapp-conversations
+  - whatsapp-messages
+  - whatsapp-conversation-graph-state
+  - whatsapp-group-info
+metadata: {"platform":{"embed":["admin"]}}
+---
+
+# WhatsApp
+
+Activate when the user asks about WhatsApp — connecting, linking, checking status, managing accounts, DM policies, group policies, or sending messages.
+
+## What this unlocks
+
+- QR-code-based WhatsApp pairing via Baileys (linked device)
+- Multi-account support (optional, multiple linked numbers)
+- Inbound message routing (admin phone → admin agent, public → public agent)
+- Group messaging with mention gating and per-group activation
+- DM policy enforcement (open, allowlist, disabled)
+- Conversation browsing — list active conversations, read message history, inspect group metadata
+- Inbound voice note transcription (OGG Opus → text via local whisper.cpp + Haiku refinement)
+- Outbound voice note normalization (OGG Opus via ffmpeg)
+- Auto-reconnection with exponential backoff
+- Business hours gating — public messages gated by `OpeningHoursSpecification` from Neo4j, with optional after-hours auto-reply via the `afterHoursMessage` config field
+
+## Conversation Browsing
+
+Four tools for reading WhatsApp conversation context. The first two read from the in-memory ring buffer (recent inbound, ~500 per JID, ephemeral). `whatsapp-conversation-graph-state` reads the durable graph view — the writer-known cypher lives in the platform route so the agent never composes its own. `whatsapp-group-info` queries the live WhatsApp servers.
+
+| Tool | Returns |
+|------|---------|
+| `whatsapp-conversations` | JIDs with recent message activity, conversation type (group/DM), last message timestamp, message count |
+| `whatsapp-messages` | In-memory ring-buffer messages for a specific JID — sender, body, timestamp, reply context. Supports optional `limit` for most recent N messages |
+| `whatsapp-conversation-graph-state` | Persisted `:Message:WhatsAppMessage` rows attached to the `:Conversation` (sessionKey-keyed) plus the resolved `conversationId`, the cypher string, and a divergence header reporting graph-row count vs in-memory count. Use when the question is "what got persisted" — never compose the cypher manually |
+| `whatsapp-group-info` | Group metadata from WhatsApp servers — subject, description, participants with admin flags, creation date. Requires active connection |
+
+## Group access — three-way mention recognition
+
+When per-group activation is `mention`, the agent fires only if the inbound message's `mentionedJids` contains an entry equal to the connected account's identity. Three orthogonal equalities are checked: (1) **selfJid** (`<digits>:<n>@s.whatsapp.net`) extracted from creds at pair time; (2) **selfLid** (`<digits>@lid`) extracted from `creds.me.lid` when the session paired under WhatsApp's LID addressing; (3) **selfPhone** via `jidToE164` for the residual case. LID-addressed groups deliver mentions as `<self-lid>@lid` and rely on the second equality — without it, every self-@-mention silently routes to `access=blocked(mention-gating)`. Older paired sessions without a stored LID degrade to two-way matching (selfJid + selfPhone) — additive, never blocks. The boot-time `[whatsapp:lid] resolved self-lid accountId=<id> selfLid=<lid>` line confirms the resolver hit; `[whatsapp:lid] FAIL self-lid-resolution` indicates the older creds shape (predicate stays correct, just narrower).
+
+## Live persistence
+
+Every `messages.upsert` event (both `notify` and `append`, both `fromMe` directions) writes a `:Message:WhatsAppMessage` row to Neo4j attached to the sessionKey-keyed `:Conversation`. A single capture site at `platform/ui/app/lib/whatsapp/manager.ts` covers inbound, outbound (Baileys echoes agent-sent messages back through `messages.upsert` with `fromMe=true`), and owner-mirror — without touching `outbound/send.ts`. `messageId` namespace is `whatsapp-live:<waName>:<remoteJid>:<msg.key.id>` where `<waName>` is the Baileys credential dirname (e.g. `default`); distinct from the `:Section:Conversation` chunks written by the source-agnostic `conversation-archive` skill — live and archive live in disjoint label spaces. Persist failures are loud (`[whatsapp-persist] FAIL …`) and never block dispatch — silent loss is the worse failure mode.
+
+**`accountId` contract.** `n.accountId` on every `:Conversation`, `:Person`, and `:Message:WhatsAppMessage` row stamped by this plugin is the **platform-side UUID** resolved by [`resolvePlatformAccountId()`](../../ui/app/lib/whatsapp/platform-account-id.ts) from `data/accounts/<uuid>/account.json` — NOT the Baileys credential dirname (which is only used as the `messageId`/`sessionKey` namespace token). The boot-time line `[whatsapp-persist] resolved-account-id waname=<dir> uuid=<uuid>` records the resolution. Doctrine: see `.docs/neo4j.md` "Account isolation invariant" — every writer that stamps `n.accountId` must verify the value against `${DATA_ROOT}/accounts/<id>/account.json` before write. The helper loud-throws on zero or multi accounts (Phase 0 single-account invariant), aborting the WhatsApp connection start before any write can occur. The same boot-validated identity (`process.env.ACCOUNT_ID`) backs the central live floor at [`writeNodeWithEdges`](../../lib/graph-write/src/index.ts) — any write whose `accountId` differs from the spawning process's `ACCOUNT_ID` is rejected by the gate; the WhatsApp helper is the writer-side discipline, the gate is the universal floor. The env itself is stamped onto the brand systemd unit by `buildMaxyUnitFile` and re-validated at every Hono boot (`[graph-health] account-id-env present=true matches-on-disk=true`) — see `.docs/neo4j.md` "Two boot-time surfaces" (added 2026-05-07).
+
+## Skills
+
+| Skill | Purpose |
+|-------|---------|
+| [connect-whatsapp](skills/connect-whatsapp/SKILL.md) | Complete WhatsApp setup — QR pairing, admin phone registration, public agent selection |
+| [manage-whatsapp-config](skills/manage-whatsapp-config/SKILL.md) | Guided WhatsApp settings editing — messaging policies, limits, group config, acknowledgement |
+
+## References
+
+| Reference | Topics |
+|-----------|--------|
+| [channels-whatsapp.md](references/channels-whatsapp.md) | Implementation details — Baileys architecture, reconnection, voice notes, outbound policy, disconnect reasons |
+
+Config field definitions (field names, types, valid values) are available on-device via `whatsapp-config action: schema`.

package/payload/platform/plugins/whatsapp/mcp/dist/call-api.d.ts

@@ -0,0 +1,14 @@
+/**
+ * MCP tool helper that calls the WhatsApp Hono routes on localhost and
+ * surfaces structured error bodies on non-2xx responses.
+ *
+ * Why this exists separate from `index.ts`: the previous inline helper at
+ * `index.ts:36-38` discarded the response body on every non-2xx, returning
+ * only `HTTP <status>: <statusText>`. The Hono route emits validation
+ * details (e.g. `{ ok: false, error: "Unrecognized keys: mode, agent" }`)
+ * that the agent needs to self-correct. Without surfacing them, every
+ * 400 looks identical and the agent retries blindly until max-turns
+ * (Task 852 root cause).
+ */
+export declare function callApi(baseUrl: string, path: string, method?: "GET" | "POST", body?: unknown): Promise<unknown>;
+//# sourceMappingURL=call-api.d.ts.map

package/payload/platform/plugins/whatsapp/mcp/dist/call-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-api.d.ts","sourceRoot":"","sources":["../src/call-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,KAAK,GAAG,MAAe,EAC/B,IAAI,CAAC,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,CA2BlB"}

package/payload/platform/plugins/whatsapp/mcp/dist/call-api.js

@@ -0,0 +1,42 @@
+/**
+ * MCP tool helper that calls the WhatsApp Hono routes on localhost and
+ * surfaces structured error bodies on non-2xx responses.
+ *
+ * Why this exists separate from `index.ts`: the previous inline helper at
+ * `index.ts:36-38` discarded the response body on every non-2xx, returning
+ * only `HTTP <status>: <statusText>`. The Hono route emits validation
+ * details (e.g. `{ ok: false, error: "Unrecognized keys: mode, agent" }`)
+ * that the agent needs to self-correct. Without surfacing them, every
+ * 400 looks identical and the agent retries blindly until max-turns
+ * (Task 852 root cause).
+ */
+export async function callApi(baseUrl, path, method = "POST", body) {
+    const res = await fetch(`${baseUrl}${path}`, {
+        method,
+        headers: body ? { "Content-Type": "application/json" } : undefined,
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    if (res.ok)
+        return res.json();
+    const fallback = `HTTP ${res.status}: ${res.statusText} (${method} ${path})`;
+    let text;
+    try {
+        text = await res.text();
+    }
+    catch {
+        return { ok: false, error: fallback };
+    }
+    if (!text)
+        return { ok: false, error: fallback };
+    try {
+        const parsed = JSON.parse(text);
+        if (typeof parsed.error === "string" && parsed.error.trim()) {
+            return { ok: false, error: parsed.error };
+        }
+        return { ok: false, error: fallback };
+    }
+    catch {
+        return { ok: false, error: fallback };
+    }
+}
+//# sourceMappingURL=call-api.js.map

package/payload/platform/plugins/whatsapp/mcp/dist/call-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-api.js","sourceRoot":"","sources":["../src/call-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAAe,EACf,IAAY,EACZ,SAAyB,MAAM,EAC/B,IAAc;IAEd,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,GAAG,IAAI,EAAE,EAAE;QAC3C,MAAM;QACN,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,SAAS;QAClE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KAC9C,CAAC,CAAC;IAEH,IAAI,GAAG,CAAC,EAAE;QAAE,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IAE9B,MAAM,QAAQ,GAAG,QAAQ,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,UAAU,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC;IAC7E,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IACxC,CAAC;IACD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;QAC3D,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAC5D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAC5C,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IACxC,CAAC;AACH,CAAC"}

package/payload/platform/plugins/whatsapp/mcp/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * WhatsApp MCP server — exposes WhatsApp lifecycle tools to the admin agent.
+ *
+ * Tools call the platform's Hono API routes (localhost) which manage the
+ * Baileys connection lifecycle in the server process.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/payload/platform/plugins/whatsapp/mcp/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}