@ararahq/mcp 5.0.0 → 6.0.0

package/build/ui/model/campaign.js

@@ -0,0 +1,38 @@
+import { percentOf } from "./format.js";
+const STEPS = [
+    ["sentCount", "sent", "Enviadas"],
+    ["deliveredCount", "delivered", "Entregues"],
+    ["readCount", "read", "Lidas"],
+    ["clickedCount", "clicked", "Clicaram"],
+    ["replyCount", "replied", "Responderam"],
+    ["convertedCount", "converted", "Converteram"],
+];
+/** Funnel rows in order, each as count and percent of the audience. */
+export const buildFunnel = (counts) => STEPS.flatMap(([field, key, label]) => {
+    const count = counts[field];
+    if (typeof count !== "number")
+        return [];
+    return [{ key, label, count, percent: percentOf(count, counts.totalMessages) }];
+});
+export const TERMINAL_STATUSES = new Set([
+    "COMPLETED",
+    "COMPLETED_WITH_ERRORS",
+    "CANCELED",
+    "FAILED",
+]);
+export const isCampaignRunning = (status) => !TERMINAL_STATUSES.has(status.toUpperCase());
+export const humanizeCampaignStatus = (status) => {
+    const map = {
+        INGESTING: "Preparando",
+        SCHEDULED: "Agendada",
+        SENDING: "Disparando",
+        AB_TESTING: "Teste A/B",
+        COMPLETED: "Concluída",
+        COMPLETED_WITH_ERRORS: "Concluída com falhas",
+        CANCELED: "Cancelada",
+        FAILED: "Falhou",
+    };
+    return map[status.toUpperCase()] ?? status;
+};
+/** Share of the audience already sent, used for the live progress ring. */
+export const progressPercent = (counts) => percentOf(counts.sentCount + (counts.failedCount ?? 0), counts.totalMessages);

package/build/ui/model/envelope.js

@@ -0,0 +1,21 @@
+const isRecord = (value) => typeof value === "object" && value !== null;
+/** Reads the MCP structured content of any Arara tool into a typed envelope. */
+export const readEnvelope = (structuredContent) => {
+    if (!isRecord(structuredContent)) {
+        return {
+            ok: false,
+            error: { code: "EMPTY_RESULT", message: "Sem dados na resposta.", retryable: false },
+        };
+    }
+    if (structuredContent.ok === true)
+        return { ok: true, data: structuredContent.data };
+    const error = isRecord(structuredContent.error) ? structuredContent.error : {};
+    return {
+        ok: false,
+        error: {
+            code: typeof error.code === "string" ? error.code : "UNKNOWN",
+            message: typeof error.message === "string" ? error.message : "Algo deu errado.",
+            retryable: error.retryable === true,
+        },
+    };
+};

package/build/ui/model/format.js

@@ -0,0 +1,27 @@
+const BRL = new Intl.NumberFormat("pt-BR", { style: "currency", currency: "BRL" });
+const INTEGER = new Intl.NumberFormat("pt-BR");
+const PERCENT_SCALE = 100;
+export const formatBrl = (value) => BRL.format(Number.isFinite(value) ? value : 0);
+export const formatInteger = (value) => INTEGER.format(Number.isFinite(value) ? Math.round(value) : 0);
+export const percentOf = (count, total) => total > 0 ? Math.round((count / total) * PERCENT_SCALE) : 0;
+export const formatTime = (iso) => {
+    if (typeof iso !== "string")
+        return "";
+    const date = new Date(iso);
+    if (Number.isNaN(date.getTime()))
+        return "";
+    return date.toLocaleTimeString("pt-BR", { hour: "2-digit", minute: "2-digit" });
+};
+export const formatDate = (iso) => {
+    if (typeof iso !== "string")
+        return "";
+    const date = new Date(iso);
+    if (Number.isNaN(date.getTime()))
+        return "";
+    return date.toLocaleDateString("pt-BR", { day: "2-digit", month: "short" });
+};
+/** Replaces {{1}}, {{2}}... with positional values, leaving unknown slots visible. */
+export const renderTemplateBody = (body, variables) => body.replace(/\{\{(\d+)\}\}/g, (match, index) => {
+    const value = variables[Number.parseInt(index, 10) - 1];
+    return typeof value === "string" && value.length > 0 ? value : match;
+});

package/build/ui/model/status.js

@@ -0,0 +1,48 @@
+const ORDER = ["accepted", "sent", "delivered", "read"];
+const LABELS = {
+    accepted: "Aceita",
+    sent: "Enviada",
+    delivered: "Entregue",
+    read: "Lida",
+};
+const STATUS_RANK = {
+    PENDING: 0,
+    QUEUED: 0,
+    ACCEPTED: 0,
+    SENT: 1,
+    SENT_TO_PROVIDER: 1,
+    ENVIADA: 1,
+    DELIVERED: 2,
+    ENTREGUE: 2,
+    READ: 3,
+    LIDA: 3,
+};
+export const isFailedStatus = (status) => /FAIL|ERRO|REJECT|UNDELIVER/i.test(status);
+export const isTerminalStatus = (status) => isFailedStatus(status) || STATUS_RANK[status.toUpperCase()] === 3;
+/** Maps a provider status to the four visual steps of a delivery timeline. */
+export const buildTimeline = (status) => {
+    const normalized = status.toUpperCase();
+    const failed = isFailedStatus(normalized);
+    const rank = STATUS_RANK[normalized] ?? 0;
+    return ORDER.map((key, index) => {
+        if (failed)
+            return {
+                key,
+                label: LABELS[key],
+                state: index === 0 ? "done" : index === 1 ? "failed" : "pending",
+            };
+        if (index < rank)
+            return { key, label: LABELS[key], state: "done" };
+        if (index === rank)
+            return { key, label: LABELS[key], state: rank === 3 ? "done" : "current" };
+        return { key, label: LABELS[key], state: "pending" };
+    });
+};
+export const humanizeMessageStatus = (status) => {
+    if (isFailedStatus(status))
+        return "Falhou";
+    const rank = STATUS_RANK[status.toUpperCase()];
+    if (rank === undefined)
+        return status;
+    return LABELS[ORDER[rank] ?? "accepted"];
+};

package/build/ui/resources.js

@@ -0,0 +1,25 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { RESOURCE_MIME_TYPE } from "@modelcontextprotocol/ext-apps/server";
+export const UI_PANELS = {
+    campaign: "Campaign report with funnel, live progress and next actions.",
+    broadcast: "Broadcast preview with phone mockup, approval and live delivery.",
+    status: "Delivery timeline, 24h window state or template approval.",
+    conversation: "Chat thread with one person and an inline reply box.",
+};
+export const uiResourceUri = (panel) => `ui://arara/${panel}.html`;
+const FALLBACK_HTML = "<!doctype html><p>Panel not built. Run npm run build.</p>";
+export const loadPanelHtml = async (panel, dir = import.meta.dirname) => readFile(path.join(dir, `${panel}.html`), "utf8").catch(() => FALLBACK_HTML);
+export const registerUiResources = (server) => {
+    for (const [panel, description] of Object.entries(UI_PANELS)) {
+        const uri = uiResourceUri(panel);
+        server.registerResource(`ui_${panel}`, uri, {
+            title: `Arara ${panel} panel`,
+            description,
+            mimeType: RESOURCE_MIME_TYPE,
+            _meta: { ui: { prefersBorder: true } },
+        }, async () => ({
+            contents: [{ uri, mimeType: RESOURCE_MIME_TYPE, text: await loadPanelHtml(panel) }],
+        }));
+    }
+};