myaiforone 1.0.0

package/dist/whatsapp-chats.d.ts

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

package/dist/whatsapp-chats.d.ts.map

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

package/dist/whatsapp-chats.js

@@ -0,0 +1,76 @@
+import { makeWASocket, useMultiFileAuthState, fetchLatestBaileysVersion, makeCacheableSignalKeyStore, } from "@whiskeysockets/baileys";
+import qrcode from "qrcode-terminal";
+import { mkdirSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const authDir = resolve(__dirname, "..", "data", "whatsapp-auth");
+mkdirSync(authDir, { recursive: true });
+const silentLogger = {
+    level: "silent",
+    child: () => silentLogger,
+    trace: () => { },
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+    fatal: () => { },
+};
+async function discover() {
+    const { state, saveCreds } = await useMultiFileAuthState(authDir);
+    const { version } = await fetchLatestBaileysVersion();
+    const sock = makeWASocket({
+        auth: {
+            creds: state.creds,
+            keys: makeCacheableSignalKeyStore(state.keys, silentLogger),
+        },
+        version,
+        logger: silentLogger,
+        printQRInTerminal: false,
+        browser: ["channelToAgentToClaude", "Desktop", "1.0.0"],
+        syncFullHistory: false,
+        markOnlineOnConnect: false,
+    });
+    sock.ev.on("creds.update", saveCreds);
+    sock.ev.on("connection.update", (update) => {
+        if (update.qr) {
+            console.log("\nScan this QR code with WhatsApp:\n");
+            qrcode.generate(update.qr, { small: true });
+        }
+        if (update.connection === "open") {
+            console.log("\nConnected! Now send a message in the WhatsApp chat you want to use.");
+            console.log("(Send from your phone — any message will do)\n");
+        }
+        if (update.connection === "close") {
+            // Don't exit on close during reconnect
+        }
+    });
+    sock.ev.on("messages.upsert", (upsert) => {
+        for (const msg of upsert.messages) {
+            if (msg.key.remoteJid === "status@broadcast")
+                continue;
+            if (!msg.key.remoteJid)
+                continue;
+            const text = msg.message?.conversation ||
+                msg.message?.extendedTextMessage?.text ||
+                msg.message?.imageMessage?.caption ||
+                "(media/no text)";
+            const isGroup = msg.key.remoteJid.endsWith("@g.us");
+            console.log("=== MESSAGE FOUND ===");
+            console.log(`  JID:     ${msg.key.remoteJid}`);
+            console.log(`  Type:    ${isGroup ? "GROUP" : "DM"}`);
+            console.log(`  From:    ${msg.key.fromMe ? "you" : (msg.key.participant || msg.key.remoteJid)}`);
+            console.log(`  Name:    ${msg.pushName || "(unknown)"}`);
+            console.log(`  Text:    ${String(text).slice(0, 100)}`);
+            console.log("=====================\n");
+        }
+    });
+}
+console.log("WhatsApp Chat Discovery");
+console.log("If already linked, will connect automatically.");
+console.log("If not linked, scan the QR code.\n");
+discover().catch((err) => {
+    console.error("Error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=whatsapp-chats.js.map

package/dist/whatsapp-chats.js.map

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

package/dist/whatsapp-login.d.ts

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

package/dist/whatsapp-login.d.ts.map

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

package/dist/whatsapp-login.js

@@ -0,0 +1,90 @@
+import { makeWASocket, useMultiFileAuthState, fetchLatestBaileysVersion, makeCacheableSignalKeyStore, DisconnectReason, } from "@whiskeysockets/baileys";
+import qrcode from "qrcode-terminal";
+import { mkdirSync, rmSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const authDir = resolve(__dirname, "..", "data", "whatsapp-auth");
+let qrCount = 0;
+function connectSocket() {
+    return new Promise(async (res) => {
+        mkdirSync(authDir, { recursive: true });
+        const { state, saveCreds } = await useMultiFileAuthState(authDir);
+        const { version } = await fetchLatestBaileysVersion();
+        console.log(`Connecting... (Baileys ${version.join(".")})`);
+        const sock = makeWASocket({
+            auth: {
+                creds: state.creds,
+                keys: makeCacheableSignalKeyStore(state.keys, silentLogger),
+            },
+            version,
+            logger: silentLogger,
+            printQRInTerminal: false,
+            browser: ["channelToAgentToClaude", "Desktop", "1.0.0"],
+            syncFullHistory: false,
+            markOnlineOnConnect: false,
+        });
+        sock.ev.on("creds.update", saveCreds);
+        sock.ev.on("connection.update", (update) => {
+            const { connection, lastDisconnect, qr } = update;
+            if (qr) {
+                qrCount++;
+                console.log(`\n--- QR Code #${qrCount} (scan quickly!) ---\n`);
+                qrcode.generate(qr, { small: true });
+                console.log("\nWaiting for scan...");
+            }
+            if (connection === "open") {
+                console.log(`\n✓ Connected as ${sock.user?.name ?? sock.user?.id}`);
+                console.log(`Credentials saved to: ${authDir}`);
+                console.log("\nWhatsApp is linked! You can now restart the service.");
+                setTimeout(() => res("done"), 3000);
+            }
+            if (connection === "close") {
+                const reason = lastDisconnect?.error?.output?.statusCode;
+                console.log(`Connection closed (reason: ${reason})`);
+                if (reason === DisconnectReason.loggedOut) {
+                    console.log("Logged out — clearing creds and retrying...");
+                    rmSync(authDir, { recursive: true, force: true });
+                    res("restart");
+                }
+                else if (reason === DisconnectReason.restartRequired || reason === 515) {
+                    console.log("WhatsApp requested restart — reconnecting...\n");
+                    res("restart");
+                }
+                else {
+                    console.error(`Unexpected disconnect (${reason}). Retrying...\n`);
+                    res("restart");
+                }
+            }
+        });
+    });
+}
+const silentLogger = {
+    level: "silent",
+    child: () => silentLogger,
+    trace: () => { },
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+    fatal: () => { },
+};
+async function login() {
+    console.log("WhatsApp Login — Scan the QR code with your phone");
+    console.log("WhatsApp > Settings > Linked Devices > Link a Device\n");
+    const maxAttempts = 5;
+    for (let i = 0; i < maxAttempts; i++) {
+        const result = await connectSocket();
+        if (result === "done") {
+            process.exit(0);
+        }
+        console.log(`Attempt ${i + 2} of ${maxAttempts}...`);
+    }
+    console.error("Max reconnection attempts reached. Please try again.");
+    process.exit(1);
+}
+login().catch((err) => {
+    console.error("Login failed:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=whatsapp-login.js.map

package/dist/whatsapp-login.js.map

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

package/dist/wiki-sync.d.ts

@@ -0,0 +1,21 @@
+import type { AppConfig, McpServerConfig } from "./config.js";
+export interface WikiSyncResult {
+    id: string;
+    agentId: string;
+    triggeredBy: string;
+    triggeredAt: string;
+    completedAt: string;
+    durationMs: number;
+    summary: string;
+    status: "success" | "error";
+}
+export declare function executeWikiSync(agentId: string, agent: AppConfig["agents"][string], baseDir: string, mcpRegistry?: Record<string, McpServerConfig>, claudeAccounts?: Record<string, string>, globalDefaults?: {
+    skills?: string[];
+    mcps?: string[];
+    prompts?: string[];
+    promptTrigger?: string;
+}, triggeredBy?: string): Promise<WikiSyncResult>;
+export declare function getWikiSyncHistory(agentHome: string, limit?: number): WikiSyncResult[];
+export declare function startWikiSync(config: AppConfig, baseDir: string, mcpRegistry?: Record<string, McpServerConfig>): void;
+export declare function stopWikiSync(): void;
+//# sourceMappingURL=wiki-sync.d.ts.map

package/dist/wiki-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-sync.d.ts","sourceRoot":"","sources":["../src/wiki-sync.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAQ9D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;CAC7B;AAqCD,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,EAClC,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAC7C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,cAAc,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,EACnG,WAAW,GAAE,MAAiB,GAC7B,OAAO,CAAC,cAAc,CAAC,CAwDzB;AAcD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,cAAc,EAAE,CAoB1F;AAID,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAC5C,IAAI,CA4BN;AAED,wBAAgB,YAAY,IAAI,IAAI,CAKnC"}

package/dist/wiki-sync.js

@@ -0,0 +1,147 @@
+import { existsSync, readFileSync, appendFileSync, mkdirSync } from "node:fs";
+import { join, resolve } from "node:path";
+import * as cron from "node-cron";
+import { executeAgent } from "./executor.js";
+import { log } from "./logger.js";
+// ─── Scheduled Tasks ────────────────────────────────────────────────
+const scheduledTasks = [];
+// ─── Build the sync prompt ──────────────────────────────────────────
+function buildWikiSyncPrompt(memoryDir) {
+    const contextPath = join(memoryDir, "context.md");
+    const learnedPath = join(memoryDir, "learned.md");
+    const hasLearned = existsSync(learnedPath);
+    const hasContext = existsSync(contextPath);
+    if (!hasLearned) {
+        return `[WIKI SYNC]\nNo learned.md file found — nothing to sync. Wiki sync complete.\n[END WIKI SYNC]`;
+    }
+    return `[WIKI SYNC]
+You are performing a scheduled wiki sync. Your job:
+
+1. Read \`${learnedPath}\` — this contains facts the agent learned from conversations
+2. Read \`${contextPath}\` — this is the curated knowledge base
+3. For each entry in learned.md:
+   - If it's a NEW fact not in context.md → add it to the appropriate section in context.md
+   - If it CONTRADICTS something in context.md → update context.md with the correction, adding a note like "(Updated [date] — corrected per [source])"
+   - If it's ALREADY in context.md → skip it
+4. After merging, clear the processed entries from learned.md (leave any that you couldn't verify or that need human review, with a note explaining why)
+5. Summarize what you merged, what you skipped, and what needs human review
+
+Be conservative — only merge facts you're confident about. Flag anything uncertain for human review.
+[END WIKI SYNC]`;
+}
+// ─── Execute Wiki Sync ──────────────────────────────────────────────
+export async function executeWikiSync(agentId, agent, baseDir, mcpRegistry, claudeAccounts, globalDefaults, triggeredBy = "manual") {
+    const memoryDir = resolve(baseDir, agent.memoryDir.replace(/^~/, process.env.HOME || ""));
+    const prompt = buildWikiSyncPrompt(memoryDir);
+    const syntheticMsg = {
+        id: `wiki-sync-${agentId}-${Date.now()}`,
+        channel: "wiki-sync",
+        chatId: `wiki-sync-${agentId}`,
+        chatType: "group",
+        sender: "wiki-sync-runner",
+        senderName: "WikiSync",
+        text: prompt,
+        timestamp: Date.now(),
+        isFromMe: false,
+        isGroup: true,
+        raw: { type: "wiki-sync", agentId },
+    };
+    const route = {
+        agentId,
+        agentConfig: agent,
+        route: agent.routes[0],
+    };
+    const startTime = Date.now();
+    const triggeredAt = new Date(startTime).toISOString();
+    let status = "success";
+    let summary = "";
+    try {
+        const response = await executeAgent(route, syntheticMsg, baseDir, mcpRegistry, claudeAccounts, globalDefaults);
+        summary = response;
+    }
+    catch (err) {
+        status = "error";
+        summary = String(err);
+        log.error(`Wiki sync failed for ${agentId}: ${err}`);
+    }
+    const endTime = Date.now();
+    const result = {
+        id: `ws-${agentId}-${startTime}`,
+        agentId,
+        triggeredBy,
+        triggeredAt,
+        completedAt: new Date(endTime).toISOString(),
+        durationMs: endTime - startTime,
+        summary,
+        status,
+    };
+    // Persist result
+    saveWikiSyncResult(agent, baseDir, result);
+    log.info(`Wiki sync completed: ${agentId} (${result.durationMs}ms, ${status})`);
+    return result;
+}
+// ─── Persistence ────────────────────────────────────────────────────
+function saveWikiSyncResult(agent, baseDir, result) {
+    const agentHome = agent.agentHome || resolve(baseDir, agent.memoryDir, "..");
+    const dir = join(agentHome.replace(/^~/, process.env.HOME || ""), "wiki-sync");
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const today = new Date().toISOString().split("T")[0];
+    const logFile = join(dir, `log-${today}.jsonl`);
+    appendFileSync(logFile, JSON.stringify(result) + "\n");
+}
+export function getWikiSyncHistory(agentHome, limit = 20) {
+    const dir = join(agentHome.replace(/^~/, process.env.HOME || ""), "wiki-sync");
+    if (!existsSync(dir))
+        return [];
+    const results = [];
+    try {
+        const files = require("fs").readdirSync(dir)
+            .filter((f) => f.startsWith("log-") && f.endsWith(".jsonl"))
+            .sort()
+            .reverse();
+        for (const file of files) {
+            const lines = readFileSync(join(dir, file), "utf-8").split("\n").filter(Boolean);
+            for (const line of lines.reverse()) {
+                try {
+                    results.push(JSON.parse(line));
+                }
+                catch { /* skip */ }
+                if (results.length >= limit)
+                    return results;
+            }
+        }
+    }
+    catch { /* ignore */ }
+    return results;
+}
+// ─── Startup / Shutdown ─────────────────────────────────────────────
+export function startWikiSync(config, baseDir, mcpRegistry) {
+    for (const [agentId, agent] of Object.entries(config.agents)) {
+        if (!agent.wiki || !agent.wikiSync?.enabled)
+            continue;
+        const schedule = agent.wikiSync.schedule;
+        if (!cron.validate(schedule)) {
+            log.warn(`Invalid wikiSync cron for ${agentId}: "${schedule}"`);
+            continue;
+        }
+        const task = cron.schedule(schedule, async () => {
+            log.info(`Wiki sync triggered: ${agentId}`);
+            try {
+                await executeWikiSync(agentId, agent, baseDir, mcpRegistry, config.service?.claudeAccounts, { skills: config.defaultSkills, mcps: config.defaultMcps, prompts: config.defaultPrompts, promptTrigger: config.promptTrigger }, "cron");
+            }
+            catch (err) {
+                log.error(`Wiki sync cron error for ${agentId}: ${err}`);
+            }
+        });
+        scheduledTasks.push(task);
+        log.info(`Wiki sync scheduled: ${agentId} → "${schedule}"`);
+    }
+}
+export function stopWikiSync() {
+    for (const task of scheduledTasks) {
+        task.stop();
+    }
+    scheduledTasks.length = 0;
+}
+//# sourceMappingURL=wiki-sync.js.map

package/dist/wiki-sync.js.map

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

package/docs/AddNewAgentGuide.md

@@ -0,0 +1,100 @@
+# Adding a New Agent
+
+## 1. Create the agent directory
+
+```bash
+cp -r agents/_template agents/my-agent
+```
+
+This gives you:
+```
+agents/my-agent/
+  CLAUDE.md        # System prompt — the agent's personality and instructions
+  agent.json       # Metadata (id, name, description)
+  memory/          # Conversation logs and context (auto-managed)
+```
+
+## 2. Write the agent's system prompt
+
+Edit `agents/my-agent/CLAUDE.md` with:
+- What the agent does
+- What tools/MCPs it has access to
+- Response style (keep short for text message channels)
+- Any rules or guardrails
+
+## 3. Add the agent to `config.json`
+
+```json
+"agents": {
+  "my-agent": {
+    "name": "My Agent",
+    "description": "What this agent does",
+    "workspace": "~/path/to/project",
+    "claudeMd": "./agents/my-agent/CLAUDE.md",
+    "memoryDir": "./agents/my-agent/memory",
+    "mentionAliases": ["@myagent"],
+    "autoCommit": false,
+    "allowedTools": ["Read", "Glob", "Grep"],
+    "routes": [
+      {
+        "channel": "imessage",
+        "match": { "type": "chat_id", "value": 67 },
+        "permissions": {
+          "allowFrom": ["*"],
+          "requireMention": true
+        }
+      },
+      {
+        "channel": "slack",
+        "match": { "type": "channel_id", "value": "YOUR_CHANNEL_ID" },
+        "permissions": {
+          "allowFrom": ["*"],
+          "requireMention": true
+        }
+      }
+    ]
+  }
+}
+```
+
+### Key fields
+
+| Field | Description |
+|-------|-------------|
+| `workspace` | Directory where `claude -p` runs. The agent can read/edit files here. |
+| `claudeMd` | Path to the agent's system prompt (relative to project root). |
+| `memoryDir` | Where conversation logs are stored (relative to project root). |
+| `mentionAliases` | How users invoke this agent in group chats (e.g. `@myagent`). |
+| `autoCommit` | If `true`, auto-commits and pushes any workspace changes after each response. |
+| `allowedTools` | Claude Code tools the agent can use. Add MCPs separately (see below). |
+| `mcps` | Optional. Array of MCP server names from the top-level `mcps` registry. See [AddNewMcpGuide.md](./AddNewMcpGuide.md). |
+| `executor` | Optional. Override the platform default executor for this agent: `"claude"` (default) or `"ollama:<model>"` (e.g. `"ollama:gemma2"`). Requires `multiModelEnabled: true` in service config. |
+| `routes` | Which channels + chat IDs this agent listens on. Multiple agents can share a channel if they have different `mentionAliases`. |
+
+### Route matching
+
+The router checks agents in config order. For each agent:
+1. Channel must match
+2. Chat ID must match
+3. If `requireMention: true`, message must contain one of the agent's `mentionAliases`
+
+Multiple agents can share the same channel + chat ID — they're differentiated by mention alias.
+
+## 4. Rebuild and restart
+
+```bash
+npm run build
+launchctl unload ~/Library/LaunchAgents/com.agenticledger.channelToAgentToClaude.plist
+launchctl load ~/Library/LaunchAgents/com.agenticledger.channelToAgentToClaude.plist
+```
+
+## 5. Discover chat IDs
+
+```bash
+# iMessage
+imsg chats --limit 20 --json
+
+# Slack — check channel ID in Slack UI (right-click channel → View channel details → bottom)
+
+# WhatsApp — enable whatsapp, send a message, check logs for JID
+```

package/docs/AddNewMcpGuide.md

@@ -0,0 +1,72 @@
+# Adding a New MCP Server
+
+## 1. Add the MCP definition to `config.json`
+
+Under the top-level `"mcps"` object, add a new entry:
+
+### Stdio MCP (local process)
+```json
+"mcps": {
+  "my-new-mcp": {
+    "type": "stdio",
+    "command": "node",
+    "args": ["~/path/to/mcp-server/dist/index.js"],
+    "env": {
+      "API_URL": "https://your-api.example.com",
+      "API_KEY": "your-key"
+    }
+  }
+}
+```
+
+### HTTP MCP (remote server)
+```json
+"mcps": {
+  "my-http-mcp": {
+    "type": "http",
+    "url": "https://your-mcp-server.example.com/mcp",
+    "headers": {
+      "Authorization": "Bearer your-token"
+    }
+  }
+}
+```
+
+## 2. Assign the MCP to an agent
+
+In the agent's config within `config.json`, add the MCP name to its `mcps` array:
+
+```json
+"my-agent": {
+  "mcps": ["my-new-mcp"],
+  ...
+}
+```
+
+The executor automatically:
+- Generates a temp `.mcp.json` config file per invocation
+- Passes `--mcp-config <path> --strict-mcp-config` to `claude -p`
+- Adds `mcp__<server-name>__*` to `--allowedTools` so the agent can call all tools on that MCP
+- Cleans up temp files after execution
+
+## 3. Rebuild and restart
+
+```bash
+npm run build
+launchctl unload ~/Library/LaunchAgents/com.agenticledger.channelToAgentToClaude.plist
+launchctl load ~/Library/LaunchAgents/com.agenticledger.channelToAgentToClaude.plist
+```
+
+## Config validation
+
+On startup, `loadConfig()` validates:
+- Each MCP definition has required fields (`command` for stdio, `url` for http/sse)
+- Each agent's `mcps` references exist in the top-level `mcps` registry
+- MCP type is one of: `stdio`, `http`, `sse`
+
+## MCP reference repos
+
+- **Stdio pattern**: https://github.com/agenticledger/financeMCPsLive
+- **HTTP (Bearer auth)**: https://github.com/agenticledger/smartsheets-mcp-http
+- **HTTP (OAuth + API key)**: https://github.com/agenticledger/qbo-mcp-http
+- **Expose stdio as HTTP**: Use `/opMCPExpose` to wrap any stdio MCP as a Streamable HTTP server