npm - @rubytech/create-realagent - Versions diffs - 1.0.426 → 1.0.429 - Mend

@rubytech/create-realagent 1.0.426 → 1.0.429

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (40) hide show

package/payload/maxy/public/brand-defaults.css CHANGED Viewed

@@ -1,12 +1,12 @@
 :root {
-  /* Brand defaults — generated by bundle.js from brands/realagent/brand.json */
+  /* Brand defaults — generated by bundle.js from brands/maxy/brand.json */
   --sage: #7C8C72;
   --sage-hover: #6A7A62;
   --sage-subtle: rgba(124, 140, 114, 0.08);
   --sage-glow: rgba(124, 140, 114, 0.15);
-  --visitor-bubble: #C5A572;
+  --visitor-bubble: #E8ECF0;
   --bg: #FAFAF8;
-  --maxy-bubble: #F0EDE8;
-  --font-display: 'Playfair Display', Georgia, serif;
-  --font-body: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;
+  --maxy-bubble: #F5F2ED;
+  --font-display: 'Cormorant', Georgia, serif;
+  --font-body: 'DM Sans', -apple-system, BlinkMacSystemFont, sans-serif;
 }

package/payload/maxy/public/index.html CHANGED Viewed

@@ -3,9 +3,9 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Real Agent</title>
+  <title>Maxy</title>
   <link rel="icon" href="/favicon.ico">
-  <script type="module" crossorigin src="/assets/admin-h_MCGiva.js"></script>
+  <script type="module" crossorigin src="/assets/admin-CvVTy3NI.js"></script>
   <link rel="modulepreload" crossorigin href="/assets/ChatInput-Bkvp46jn.js">
   <link rel="stylesheet" crossorigin href="/assets/ChatInput-BcuvuN5M.css">
   <link rel="stylesheet" href="/brand-defaults.css">

package/payload/maxy/public/public.html CHANGED Viewed

@@ -3,7 +3,7 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Real Agent</title>
+  <title>Maxy</title>
   <link rel="icon" href="/favicon.ico">
   <script type="module" crossorigin src="/assets/public-CJdTPrH1.js"></script>
   <link rel="modulepreload" crossorigin href="/assets/ChatInput-Bkvp46jn.js">

package/payload/maxy/server.js CHANGED Viewed

@@ -3191,9 +3191,6 @@ async function ensureCdp() {
   }
   return waitForPort(9222, 12e3);
 }
-function killChromium() {
-  spawnSync("pkill", ["-f", "chromium"], { stdio: "pipe" });
-}
 function writeChromiumWrapper() {
   mkdirSync(BIN_DIR, { recursive: true });
   const wrapperPath = resolve2(BIN_DIR, "chromium");
@@ -3235,6 +3232,9 @@ nohup "$BIN" \\
   --ozone-platform=x11 \\
   --no-first-run \\
   --no-default-browser-check \\
+  --disable-session-crashed-bubble \\
+  --hide-crash-restore-bubble \\
+  --noerrdialogs \\
   --window-size=1280,800 \\
   --window-position=0,0 \\
   "$@" >> "$LOG" 2>&1 &
@@ -9062,6 +9062,22 @@ function checkAuthStatus() {
     return false;
   }
 }
+async function waitForAuthPage(timeoutMs = 2e4) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    try {
+      const res = await fetch("http://127.0.0.1:9222/json/list");
+      const pages = await res.json();
+      const hasContent = pages.some(
+        (p) => p.type === "page" && p.url && p.url !== "about:blank"
+      );
+      if (hasContent) return true;
+    } catch {
+    }
+    await sleep(500);
+  }
+  return false;
+}
 async function GET2() {
   return Response.json({ authenticated: checkAuthStatus() });
 }
@@ -9072,7 +9088,6 @@ async function POST9(req) {
   } catch {
   }
   if (body.action === "stop") {
-    killChromium();
     return Response.json({ stopped: true });
   }
   if (body.action === "logout") {
@@ -9084,18 +9099,23 @@ async function POST9(req) {
   }
   if (body.action === "wait") {
     const authenticated = checkAuthStatus();
-    if (authenticated) killChromium();
     return Response.json({ completed: authenticated, authenticated });
   }
+  if (body.action === "launch-browser") {
+    const vncReady2 = await ensureVnc();
+    if (!vncReady2) {
+      return Response.json({ error: "VNC display failed to start" }, { status: 500 });
+    }
+    const cdpReady = await ensureCdp();
+    return Response.json({ launched: cdpReady });
+  }
   ensureLogDir();
-  killChromium();
-  await sleep(400);
   const vncReady = await ensureVnc();
   if (!vncReady) {
     return Response.json({ error: "VNC display failed to start" }, { status: 500 });
   }
+  await ensureCdp();
   writeFileSync6(logPath("claude-auth"), "");
-  writeFileSync6(logPath("chromium"), "");
   const chromiumWrapper = writeChromiumWrapper();
   const x11Env = buildX11Env(chromiumWrapper);
   const claudeAuthLogFd = openSync(logPath("claude-auth"), "a");
@@ -9108,7 +9128,7 @@ async function POST9(req) {
   claudeProc.stdout?.on("data", onClaudeOutput);
   claudeProc.stderr?.on("data", onClaudeOutput);
   claudeProc.once("close", () => closeSync(claudeAuthLogFd));
-  await sleep(8e3);
+  await waitForAuthPage(2e4);
   return Response.json({ started: true });
 }

package/payload/platform/config/brand.json CHANGED Viewed

@@ -1,45 +1,43 @@
 {
-  "productName": "Real Agent",
-  "hostname": "realagent",
-  "serviceName": "realagent.service",
-  "installDir": "realagent",
-  "configDir": ".realagent",
-  "tagline": "Built for agents. By agents.",
-  "port": 19300,
-  "domain": "realagency.network",
+  "productName": "Maxy",
+  "hostname": "maxy",
+  "serviceName": "maxy.service",
+  "installDir": "maxy",
+  "configDir": ".maxy",
+  "tagline": "AI for Productive People",
+  "strapline": "Convenience as standard.",
+  "domain": "getmaxy.com",
   "defaultColors": {
     "primary": "#7C8C72",
     "primaryHover": "#6A7A62",
     "primarySubtle": "rgba(124, 140, 114, 0.08)",
     "primaryGlow": "rgba(124, 140, 114, 0.15)",
-    "accent": "#C5A572",
+    "accent": "#E8ECF0",
     "background": "#FAFAF8",
-    "agentBubble": "#F0EDE8"
+    "agentBubble": "#F5F2ED"
   },
   "defaultFonts": {
-    "display": "'Playfair Display', Georgia, serif",
-    "body": "'Inter', -apple-system, BlinkMacSystemFont, sans-serif"
+    "display": "'Cormorant', Georgia, serif",
+    "body": "'DM Sans', -apple-system, BlinkMacSystemFont, sans-serif"
   },
   "assets": {
-    "logo": "realagent-icon-web.png",
-    "logoMonochrome": "realagent-icon-web.png",
-    "logoRound": "realagent-icon-dark-round-web.png",
-    "favicon": "realagent-favicon-dark-32.png"
+    "logo": "maxy-monochrome.png",
+    "favicon": "favicon.ico"
   },
   "npm": {
-    "packageName": "@rubytech/create-realagent",
-    "binName": "create-realagent",
+    "packageName": "@rubytech/create-maxy",
+    "binName": "create-maxy",
     "author": "Rubytech LLC"
   },
   "plugins": {
-    "core": ["admin", "memory", "docs", "cloudflare", "anthropic", "workflows", "tasks", "business-assistant", "contacts", "scheduling"],
-    "defaultEnabled": ["email",  "sales"],
-    "available": ["deep-research","waitlist", "projects"],
-    "excluded": ["telegram"]
+    "core": ["admin", "memory", "docs", "cloudflare", "anthropic", "workflows", "tasks"],
+    "defaultEnabled": ["business-assistant", "sales", "contacts", "email", "scheduling", "projects"],
+    "available": ["telegram", "waitlist", "deep-research"],
+    "excluded": []
   }
 }

package/payload/platform/plugins/telegram/PLUGIN.md ADDED Viewed

@@ -0,0 +1,34 @@
+---
+name: telegram
+description: Guide users through connecting a Telegram bot — creating a bot via BotFather, finding user IDs, and configuring admin vs public bots.
+metadata: {"taskmaster":{"optional":true}}
+tools:
+  - message
+  - message-history
+---
+# Telegram Setup
+Walks users through connecting Telegram bots to Taskmaster. Covers bot creation, token configuration, finding numeric user IDs, and choosing between admin and public bot roles.
+## When to activate
+- User asks how to connect Telegram or set up a Telegram bot
+- User asks about BotFather, bot tokens, or Telegram integration
+- User needs to find their Telegram user ID for admin binding
+- User asks about admin vs public bot configuration
+- User is on the Setup page and asks about the Telegram section
+## What it unlocks
+- Telegram as a messaging channel — DMs and group conversations routed to the AI assistant
+- Multi-bot support — separate admin and public bots with different access policies
+- Admin routing — restrict a bot to admin-only access via numeric user ID bindings
+## References
+| Task | When to use | Reference |
+|------|-------------|-----------|
+| Guided setup | User wants help connecting Telegram | `references/setup-guide.md` |
+Load the reference and follow its instructions.

package/payload/platform/plugins/telegram/mcp/dist/index.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=index.d.ts.map

package/payload/platform/plugins/telegram/mcp/dist/index.d.ts.map ADDED Viewed

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

package/payload/platform/plugins/telegram/mcp/dist/index.js ADDED Viewed

@@ -0,0 +1,101 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { message } from "./tools/message.js";
+import { messageHistory } from "./tools/message-history.js";
+const server = new McpServer({
+    name: "maxy-messaging",
+    version: "0.1.0",
+});
+server.tool("message", "Send a message via Telegram. Supports text with HTML formatting and inline keyboards for interactive choices.", {
+    channel: z.literal("telegram").describe("Delivery channel"),
+    chatId: z
+        .union([z.string(), z.number()])
+        .describe("Telegram chat ID to send to"),
+    text: z.string().describe("Message text (HTML formatting supported)"),
+    parseMode: z
+        .enum(["HTML", "Markdown", "MarkdownV2"])
+        .optional()
+        .describe("Parse mode (default: HTML)"),
+    inlineKeyboard: z
+        .array(z.array(z.object({
+        text: z.string().describe("Button label"),
+        callbackData: z
+            .string()
+            .optional()
+            .describe("Callback data for button press"),
+        url: z.string().optional().describe("URL to open on button press"),
+    })))
+        .optional()
+        .describe("Inline keyboard rows for interactive buttons"),
+}, async (params) => {
+    try {
+        const result = await message(params);
+        if (!result.sent) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Message failed: ${result.error}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Message sent via ${result.channel} (ID: ${result.messageId})`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Send failed: ${err instanceof Error ? err.message : String(err)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+server.tool("message-history", "Query conversation history from the message log.", {
+    channel: z.string().optional().describe("Filter by channel (telegram)"),
+    chatId: z.string().optional().describe("Filter by chat ID"),
+    limit: z.number().optional().describe("Max messages to return (default 20)"),
+}, async ({ channel, chatId, limit }) => {
+    try {
+        const history = await messageHistory({ channel, chatId, limit });
+        if (history.length === 0) {
+            return {
+                content: [
+                    { type: "text", text: "No message history found." },
+                ],
+            };
+        }
+        const formatted = history
+            .map((h) => `[${h.timestamp}] ${h.channel}/${h.chatId} (${h.role}): ${h.content.slice(0, 200)}${h.content.length > 200 ? "..." : ""}`)
+            .join("\n");
+        return {
+            content: [{ type: "text", text: formatted }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `History query failed: ${err instanceof Error ? err.message : String(err)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/payload/platform/plugins/telegram/mcp/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/payload/platform/plugins/telegram/mcp/dist/lib/telegram.d.ts ADDED Viewed

@@ -0,0 +1,27 @@
+export interface TelegramSendOptions {
+    chatId: string | number;
+    text: string;
+    parseMode?: "HTML" | "Markdown" | "MarkdownV2";
+    replyMarkup?: TelegramInlineKeyboard;
+}
+export interface TelegramInlineKeyboard {
+    inline_keyboard: Array<Array<{
+        text: string;
+        callback_data?: string;
+        url?: string;
+    }>>;
+}
+export declare function sendMessage(botToken: string, options: TelegramSendOptions): Promise<{
+    ok: boolean;
+    messageId?: number;
+    error?: string;
+}>;
+export declare function setWebhook(botToken: string, webhookUrl: string): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export declare function getWebhookInfo(botToken: string): Promise<{
+    url: string;
+    pendingUpdateCount: number;
+}>;
+//# sourceMappingURL=telegram.d.ts.map

package/payload/platform/plugins/telegram/mcp/dist/lib/telegram.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/lib/telegram.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;IAC/C,WAAW,CAAC,EAAE,sBAAsB,CAAC;CACtC;AAED,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,KAAK,CACpB,KAAK,CAAC;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC,CACH,CAAC;CACH;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAyB9D;AAED,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiB1C;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,CAAC,CAWtD"}

package/payload/platform/plugins/telegram/mcp/dist/lib/telegram.js ADDED Viewed

@@ -0,0 +1,41 @@
+const TELEGRAM_API = "https://api.telegram.org";
+export async function sendMessage(botToken, options) {
+    const res = await fetch(`${TELEGRAM_API}/bot${botToken}/sendMessage`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            chat_id: options.chatId,
+            text: options.text,
+            parse_mode: options.parseMode ?? "HTML",
+            reply_markup: options.replyMarkup
+                ? JSON.stringify(options.replyMarkup)
+                : undefined,
+        }),
+    });
+    const data = (await res.json());
+    if (!data.ok) {
+        return { ok: false, error: data.description ?? "Unknown Telegram error" };
+    }
+    return { ok: true, messageId: data.result?.message_id };
+}
+export async function setWebhook(botToken, webhookUrl) {
+    const res = await fetch(`${TELEGRAM_API}/bot${botToken}/setWebhook`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ url: webhookUrl }),
+    });
+    const data = (await res.json());
+    if (!data.ok) {
+        return { ok: false, error: data.description ?? "Failed to set webhook" };
+    }
+    return { ok: true };
+}
+export async function getWebhookInfo(botToken) {
+    const res = await fetch(`${TELEGRAM_API}/bot${botToken}/getWebhookInfo`);
+    const data = (await res.json());
+    return {
+        url: data.result.url,
+        pendingUpdateCount: data.result.pending_update_count,
+    };
+}
+//# sourceMappingURL=telegram.js.map

package/payload/platform/plugins/telegram/mcp/dist/lib/telegram.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"telegram.js","sourceRoot":"","sources":["../../src/lib/telegram.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAmBhD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,OAA4B;IAE5B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,YAAY,OAAO,QAAQ,cAAc,EAAE;QACpE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,OAAO,EAAE,OAAO,CAAC,MAAM;YACvB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,UAAU,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM;YACvC,YAAY,EAAE,OAAO,CAAC,WAAW;gBAC/B,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC;gBACrC,CAAC,CAAC,SAAS;SACd,CAAC;KACH,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAI7B,CAAC;IAEF,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,IAAI,wBAAwB,EAAE,CAAC;IAC5E,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAgB,EAChB,UAAkB;IAElB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,YAAY,OAAO,QAAQ,aAAa,EAAE;QACnE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;KAC1C,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAG7B,CAAC;IAEF,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,IAAI,uBAAuB,EAAE,CAAC;IAC3E,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAgB;IAEhB,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,GAAG,YAAY,OAAO,QAAQ,iBAAiB,CAChD,CAAC;IACF,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAE7B,CAAC;IACF,OAAO;QACL,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG;QACpB,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,oBAAoB;KACrD,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/telegram/mcp/dist/tools/message-history.d.ts ADDED Viewed

@@ -0,0 +1,16 @@
+interface HistoryParams {
+    channel?: string;
+    chatId?: string;
+    accountId?: string;
+    limit?: number;
+}
+interface HistoryEntry {
+    channel: string;
+    chatId: string;
+    role: string;
+    content: string;
+    timestamp: string;
+}
+export declare function messageHistory(params: HistoryParams): Promise<HistoryEntry[]>;
+export {};
+//# sourceMappingURL=message-history.d.ts.map

package/payload/platform/plugins/telegram/mcp/dist/tools/message-history.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"message-history.d.ts","sourceRoot":"","sources":["../../src/tools/message-history.ts"],"names":[],"mappings":"AAiCA,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,YAAY;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,YAAY,EAAE,CAAC,CAyCzB"}

package/payload/platform/plugins/telegram/mcp/dist/tools/message-history.js ADDED Viewed

@@ -0,0 +1,62 @@
+import neo4j from "neo4j-driver";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+let driver = null;
+function readPassword() {
+    if (process.env.NEO4J_PASSWORD)
+        return process.env.NEO4J_PASSWORD;
+    const passwordFile = resolve(process.env.PLATFORM_ROOT ?? resolve(import.meta.dirname, "../../../.."), "config/.neo4j-password");
+    try {
+        return readFileSync(passwordFile, "utf-8").trim();
+    }
+    catch {
+        throw new Error(`Neo4j password not found. Expected at ${passwordFile} or in NEO4J_PASSWORD env var.`);
+    }
+}
+function getSession() {
+    if (!driver) {
+        const uri = process.env.NEO4J_URI ?? "bolt://localhost:7687";
+        const user = process.env.NEO4J_USER ?? "neo4j";
+        const password = readPassword();
+        driver = neo4j.driver(uri, neo4j.auth.basic(user, password));
+    }
+    return driver.session();
+}
+export async function messageHistory(params) {
+    const { channel, chatId, accountId, limit = 20 } = params;
+    const session = getSession();
+    try {
+        const conditions = ["m.accountId = $accountId"];
+        const queryParams = { accountId, limit };
+        if (channel) {
+            conditions.push("m.channel = $channel");
+            queryParams.channel = channel;
+        }
+        if (chatId) {
+            conditions.push("m.chatId = $chatId");
+            queryParams.chatId = chatId;
+        }
+        const query = `
+      MATCH (m:Communication)
+      WHERE ${conditions.join(" AND ")}
+      RETURN m
+      ORDER BY m.dateSent DESC
+      LIMIT $limit
+    `;
+        const result = await session.run(query, queryParams);
+        return result.records.map((record) => {
+            const m = record.get("m").properties;
+            return {
+                channel: m.channel,
+                chatId: m.chatId,
+                role: m.role,
+                content: m.content,
+                timestamp: m.dateSent,
+            };
+        });
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=message-history.js.map

package/payload/platform/plugins/telegram/mcp/dist/tools/message-history.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"message-history.js","sourceRoot":"","sources":["../../src/tools/message-history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC,SAAS,YAAY;IACnB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAElE,MAAM,YAAY,GAAG,OAAO,CAC1B,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EACxE,wBAAwB,CACzB,CAAC;IAEF,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,yCAAyC,YAAY,gCAAgC,CACtF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,UAAU;IACjB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,uBAAuB,CAAC;QAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC;QAC/C,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;QAChC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;AAC1B,CAAC;AAiBD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAqB;IAErB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAE1D,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,CAAC,0BAA0B,CAAC,CAAC;QAChD,MAAM,WAAW,GAA4B,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAElE,IAAI,OAAO,EAAE,CAAC;YACZ,UAAU,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YACxC,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC;QAChC,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACX,UAAU,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACtC,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC;QAC9B,CAAC;QAED,MAAM,KAAK,GAAG;;cAEJ,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;;;;KAIjC,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAErD,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACnC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC;YACrC,OAAO;gBACL,OAAO,EAAE,CAAC,CAAC,OAAiB;gBAC5B,MAAM,EAAE,CAAC,CAAC,MAAgB;gBAC1B,IAAI,EAAE,CAAC,CAAC,IAAc;gBACtB,OAAO,EAAE,CAAC,CAAC,OAAiB;gBAC5B,SAAS,EAAE,CAAC,CAAC,QAAkB;aAChC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/payload/platform/plugins/telegram/mcp/dist/tools/message.d.ts ADDED Viewed

@@ -0,0 +1,20 @@
+interface MessageParams {
+    channel: "telegram";
+    chatId: string | number;
+    text: string;
+    parseMode?: "HTML" | "Markdown" | "MarkdownV2";
+    inlineKeyboard?: Array<Array<{
+        text: string;
+        callbackData?: string;
+        url?: string;
+    }>>;
+}
+interface MessageResult {
+    sent: boolean;
+    channel: string;
+    messageId?: number;
+    error?: string;
+}
+export declare function message(params: MessageParams): Promise<MessageResult>;
+export {};
+//# sourceMappingURL=message.d.ts.map

package/payload/platform/plugins/telegram/mcp/dist/tools/message.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/tools/message.ts"],"names":[],"mappings":"AAEA,UAAU,aAAa;IACrB,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;IAC/C,cAAc,CAAC,EAAE,KAAK,CACpB,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAC7D,CAAC;CACH;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAoC3E"}

package/payload/platform/plugins/telegram/mcp/dist/tools/message.js ADDED Viewed

@@ -0,0 +1,34 @@
+import { sendMessage } from "../lib/telegram.js";
+export async function message(params) {
+    const botToken = process.env.TELEGRAM_PUBLIC_BOT_TOKEN;
+    if (!botToken) {
+        return {
+            sent: false,
+            channel: params.channel,
+            error: "TELEGRAM_PUBLIC_BOT_TOKEN not configured",
+        };
+    }
+    let replyMarkup;
+    if (params.inlineKeyboard) {
+        replyMarkup = {
+            inline_keyboard: params.inlineKeyboard.map((row) => row.map((btn) => ({
+                text: btn.text,
+                callback_data: btn.callbackData,
+                url: btn.url,
+            }))),
+        };
+    }
+    const result = await sendMessage(botToken, {
+        chatId: params.chatId,
+        text: params.text,
+        parseMode: params.parseMode,
+        replyMarkup,
+    });
+    return {
+        sent: result.ok,
+        channel: "telegram",
+        messageId: result.messageId,
+        error: result.error,
+    };
+}
+//# sourceMappingURL=message.js.map

package/payload/platform/plugins/telegram/mcp/dist/tools/message.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/tools/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA+B,MAAM,oBAAoB,CAAC;AAmB9E,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAqB;IACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;IACvD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,0CAA0C;SAClD,CAAC;IACJ,CAAC;IAED,IAAI,WAA+C,CAAC;IACpD,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,WAAW,GAAG;YACZ,eAAe,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACjD,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAChB,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,aAAa,EAAE,GAAG,CAAC,YAAY;gBAC/B,GAAG,EAAE,GAAG,CAAC,GAAG;aACb,CAAC,CAAC,CACJ;SACF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE;QACzC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW;KACZ,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,EAAE;QACf,OAAO,EAAE,UAAU;QACnB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/telegram/mcp/package.json ADDED Viewed

@@ -0,0 +1,19 @@
+{
+  "name": "@maxy/messaging",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "neo4j-driver": "^5.28.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  }
+}

package/payload/platform/plugins/telegram/references/setup-guide.md ADDED Viewed

@@ -0,0 +1,50 @@
+# Telegram Setup Guide
+## Creating a Bot
+1. Open Telegram and search for **@BotFather**
+2. Start a chat and send `/newbot`
+3. Follow the prompts — choose a display name and a username (must end in `bot`)
+4. BotFather replies with a **bot token** (a long string like `123456:ABC-DEF...`)
+5. Copy the token — you'll paste it into Taskmaster's Setup page
+## Connecting the Bot to Taskmaster
+1. Open the Taskmaster control panel (Setup page)
+2. Find the **Telegram** row and click **Connect** (or open settings if already connected)
+3. Paste the bot token from BotFather
+4. The system probes the token to verify it — you'll see the bot's username confirmed
+5. Choose whether this is an **admin bot** or a **public bot** (see below)
+6. If it's a public bot, choose a DM policy (who can message it)
+7. Click **Save & Connect**
+## Admin Bot vs Public Bot
+Each Telegram bot has an **Admin routing** toggle:
+- **Admin bot** (toggle ON): Only users with admin bindings can message this bot. Everyone else is silently denied. Messages route to the admin agent. No DM policy applies — it's admin-only by design.
+- **Public bot** (toggle OFF): DM policy applies to everyone equally, including admins. Messages route to the public agent. Use this for customer-facing bots.
+A common setup is two bots: one admin bot for the business owner, one public bot for customers.
+## Finding Your Telegram User ID
+Admin bindings require your **numeric Telegram user ID** — not your username. Usernames can be changed or claimed by someone else, so they are not safe for admin access.
+To find your user ID:
+1. Open Telegram and search for **@userinfobot**
+2. Start the chat and send `/start`
+3. The bot instantly replies with your numeric ID (e.g. `123456789`), plus your name and language
+4. Use this numeric ID when setting up admin bindings
+## DM Policy Options (Public Bots Only)
+| Policy | Behaviour |
+|--------|-----------|
+| **Respond to everyone** | Any Telegram user can message the bot and get a response |
+| **Require approval** | Unknown senders receive a pairing code; an admin must approve them |
+| **Whitelist only** | Only users in the allowlist can message the bot |
+| **Disabled** | The bot ignores all DMs |
+"Require approval" (pairing) is the default and recommended for most setups — it lets you control who talks to the bot without pre-configuring an allowlist.