myaiforone 1.0.0

package/dist/openai-executor.js

@@ -0,0 +1,197 @@
+/**
+ * OpenAI-compatible executor — handles OpenAI, xAI (Grok), Groq, Together, Mistral,
+ * and any other provider that implements the OpenAI Chat Completions API.
+ *
+ * Executor format: "openai:gpt-4o", "grok:grok-3", "groq:llama-3.3-70b-versatile",
+ *                  "together:meta-llama/Llama-3.3-70B-Instruct", "mistral:mistral-large-latest"
+ */
+import { log } from "./logger.js";
+export const PROVIDERS = {
+    openai: {
+        name: "OpenAI",
+        baseUrl: "https://api.openai.com/v1",
+        keyField: "openai",
+    },
+    grok: {
+        name: "xAI (Grok)",
+        baseUrl: "https://api.x.ai/v1",
+        keyField: "xai",
+    },
+    groq: {
+        name: "Groq",
+        baseUrl: "https://api.groq.com/openai/v1",
+        keyField: "groq",
+    },
+    together: {
+        name: "Together",
+        baseUrl: "https://api.together.xyz/v1",
+        keyField: "together",
+    },
+    mistral: {
+        name: "Mistral",
+        baseUrl: "https://api.mistral.ai/v1",
+        keyField: "mistral",
+    },
+};
+// ─── Execute (non-streaming) ────────────────────────────────────
+export async function executeOpenAICompat(opts) {
+    const providerConfig = PROVIDERS[opts.provider];
+    const baseUrl = opts.baseUrl || providerConfig?.baseUrl;
+    if (!baseUrl)
+        throw new Error(`Unknown provider: ${opts.provider}`);
+    const timeout = opts.timeout || 300_000;
+    const providerName = providerConfig?.name || opts.provider;
+    log.info(`[${providerName}] Executing ${opts.model}: ${opts.message.slice(0, 200)}`);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout);
+    try {
+        const res = await fetch(`${baseUrl}/chat/completions`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Authorization": `Bearer ${opts.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: opts.model,
+                messages: [
+                    { role: "system", content: opts.systemPrompt },
+                    { role: "user", content: opts.message },
+                ],
+                temperature: opts.temperature ?? 0.7,
+                max_tokens: opts.maxTokens ?? 4096,
+                stream: false,
+            }),
+            signal: controller.signal,
+        });
+        if (!res.ok) {
+            const errText = await res.text();
+            log.error(`[${providerName}] Error ${res.status}: ${errText}`);
+            // Parse structured error if possible
+            try {
+                const errJson = JSON.parse(errText);
+                const errMsg = errJson.error?.message || errJson.message || errText;
+                throw new Error(`${providerName} API error ${res.status}: ${errMsg}`);
+            }
+            catch (e) {
+                if (e instanceof Error && e.message.startsWith(providerName))
+                    throw e;
+                throw new Error(`${providerName} API error ${res.status}: ${errText}`);
+            }
+        }
+        const data = await res.json();
+        if (data.error) {
+            throw new Error(`${providerName} error: ${data.error.message}`);
+        }
+        const response = data.choices?.[0]?.message?.content || "";
+        if (data.usage) {
+            log.debug(`[${providerName}] ${opts.model} usage: ${data.usage.prompt_tokens}+${data.usage.completion_tokens} tokens`);
+        }
+        log.info(`[${providerName}] Response from ${opts.model}: ${response.slice(0, 200)}`);
+        return response;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+// ─── Stream ─────────────────────────────────────────────────────
+export async function* streamOpenAICompat(opts) {
+    const providerConfig = PROVIDERS[opts.provider];
+    const baseUrl = opts.baseUrl || providerConfig?.baseUrl;
+    if (!baseUrl)
+        throw new Error(`Unknown provider: ${opts.provider}`);
+    const timeout = opts.timeout || 300_000;
+    const providerName = providerConfig?.name || opts.provider;
+    log.info(`[${providerName}] Streaming ${opts.model}: ${opts.message.slice(0, 200)}`);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout);
+    try {
+        const res = await fetch(`${baseUrl}/chat/completions`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Authorization": `Bearer ${opts.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: opts.model,
+                messages: [
+                    { role: "system", content: opts.systemPrompt },
+                    { role: "user", content: opts.message },
+                ],
+                temperature: opts.temperature ?? 0.7,
+                max_tokens: opts.maxTokens ?? 4096,
+                stream: true,
+            }),
+            signal: controller.signal,
+        });
+        if (!res.ok) {
+            const errText = await res.text();
+            throw new Error(`${providerName} API error ${res.status}: ${errText}`);
+        }
+        const reader = res.body?.getReader();
+        if (!reader)
+            throw new Error("No response body");
+        const decoder = new TextDecoder();
+        let buffer = "";
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split("\n");
+            buffer = lines.pop() || ""; // keep incomplete last line
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed || trimmed === "data: [DONE]")
+                    continue;
+                if (!trimmed.startsWith("data: "))
+                    continue;
+                const jsonStr = trimmed.slice(6);
+                try {
+                    const chunk = JSON.parse(jsonStr);
+                    const content = chunk.choices?.[0]?.delta?.content;
+                    if (content) {
+                        yield content;
+                    }
+                }
+                catch { /* skip unparseable lines */ }
+            }
+        }
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+// ─── Health check ───────────────────────────────────────────────
+export async function checkOpenAICompatHealth(provider, apiKey, baseUrl) {
+    const providerConfig = PROVIDERS[provider];
+    const url = baseUrl || providerConfig?.baseUrl;
+    if (!url)
+        return { ok: false, error: `Unknown provider: ${provider}` };
+    const providerName = providerConfig?.name || provider;
+    try {
+        const res = await fetch(`${url}/models`, {
+            headers: { "Authorization": `Bearer ${apiKey}` },
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (res.status === 401 || res.status === 403) {
+            return { ok: false, error: `${providerName}: Invalid API key` };
+        }
+        if (!res.ok) {
+            return { ok: false, error: `${providerName}: API returned ${res.status}` };
+        }
+        const data = await res.json();
+        const models = data.data?.map(m => m.id) || [];
+        return { ok: true, models: models.slice(0, 20) };
+    }
+    catch (err) {
+        return { ok: false, error: `${providerName}: ${err}` };
+    }
+}
+/**
+ * Resolve provider prefix to config.
+ * Returns null if the prefix is not an OpenAI-compatible provider.
+ */
+export function resolveProvider(prefix) {
+    return PROVIDERS[prefix] || null;
+}
+//# sourceMappingURL=openai-executor.js.map

package/dist/openai-executor.js.map

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

package/dist/router.d.ts

@@ -0,0 +1,11 @@
+import type { InboundMessage } from "./channels/types.js";
+import type { AgentConfig, RouteConfig, AppConfig } from "./config.js";
+export interface ResolvedRoute {
+    agentId: string;
+    agentConfig: AgentConfig;
+    route: RouteConfig;
+}
+export declare function resolveRoute(msg: InboundMessage, config: AppConfig, baseDir?: string): ResolvedRoute | null;
+export declare function isPairingAttempt(msg: InboundMessage, config: AppConfig, baseDir: string): boolean;
+export declare function pairSender(msg: InboundMessage, baseDir: string): void;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGvE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;CACpB;AAqHD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,aAAa,GAAG,IAAI,CAkEtB;AAGD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAMjG;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAMrE"}

package/dist/router.js

@@ -0,0 +1,185 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { log } from "./logger.js";
+// ─── Pairing store ───────────────────────────────────────────────────
+const pairedSenders = new Set();
+let pairingStoreLoaded = false;
+let pairingStorePath = "";
+function loadPairingStore(baseDir) {
+    if (pairingStoreLoaded)
+        return;
+    pairingStorePath = join(baseDir, "data", "paired-senders.json");
+    try {
+        if (existsSync(pairingStorePath)) {
+            const data = JSON.parse(readFileSync(pairingStorePath, "utf-8"));
+            for (const s of data)
+                pairedSenders.add(s);
+        }
+    }
+    catch { /* fresh start */ }
+    pairingStoreLoaded = true;
+}
+function savePairingStore() {
+    try {
+        mkdirSync(join(pairingStorePath, ".."), { recursive: true });
+        writeFileSync(pairingStorePath, JSON.stringify([...pairedSenders], null, 2));
+    }
+    catch (err) {
+        log.warn(`Failed to save pairing store: ${err}`);
+    }
+}
+// Key: "channel:chatId:sender" → last agent they talked to
+const stickyMap = new Map();
+const DEFAULT_STICKY_TIMEOUT_MS = 300_000; // 5 minutes
+function getStickyMode(config, channel) {
+    const channelCfg = config.channels[channel];
+    if (!channelCfg)
+        return { mode: "none", prefix: "!", timeoutMs: DEFAULT_STICKY_TIMEOUT_MS };
+    const raw = channelCfg.config.stickyRouting;
+    let mode = "prefix"; // default: prefix mode
+    if (raw === "sticky")
+        mode = "sticky";
+    else if (raw === "none")
+        mode = "none";
+    else if (raw === "prefix")
+        mode = "prefix";
+    const prefix = channelCfg.config.stickyPrefix ?? "!";
+    const timeoutMs = channelCfg.config.stickyTimeoutMs ?? DEFAULT_STICKY_TIMEOUT_MS;
+    return { mode, prefix, timeoutMs };
+}
+function getStickyAgent(msg, config) {
+    const { mode, prefix, timeoutMs } = getStickyMode(config, msg.channel);
+    if (mode === "none")
+        return null;
+    const key = `${msg.channel}:${msg.chatId}:${msg.sender}`;
+    const entry = stickyMap.get(key);
+    if (!entry)
+        return null;
+    // Check if expired
+    if (Date.now() - entry.timestamp > timeoutMs) {
+        stickyMap.delete(key);
+        return null;
+    }
+    // Prefix mode: message must start with the trigger character
+    if (mode === "prefix") {
+        const trimmed = msg.text.trim();
+        if (!trimmed.startsWith(prefix)) {
+            return null; // No prefix — don't route via sticky
+        }
+        // Strip the prefix from the message text for the agent
+        msg.text = trimmed.slice(prefix.length).trim();
+    }
+    // Verify the agent still exists
+    const agent = config.agents[entry.agentId];
+    if (!agent) {
+        stickyMap.delete(key);
+        return null;
+    }
+    // Find the matching route for this channel + chatId
+    const route = agent.routes.find(r => r.channel === msg.channel && String(r.match.value) === msg.chatId);
+    if (!route)
+        return null;
+    // Permission check
+    if (!isAllowed(msg, route))
+        return null;
+    log.debug(`Sticky routing (${mode}): ${msg.sender} → ${entry.agentId} (${Math.round((Date.now() - entry.timestamp) / 1000)}s ago)`);
+    return { agentId: entry.agentId, agentConfig: agent, route };
+}
+function setStickyAgent(msg, agentId) {
+    const key = `${msg.channel}:${msg.chatId}:${msg.sender}`;
+    stickyMap.set(key, { agentId, timestamp: Date.now() });
+}
+// ─── Route resolver ──────────────────────────────────────────────────
+export function resolveRoute(msg, config, baseDir) {
+    // Feature 4: DM pairing gate
+    if (config.service.pairingCode && baseDir) {
+        loadPairingStore(baseDir);
+        const senderKey = `${msg.channel}:${msg.sender}`;
+        if (!pairedSenders.has(senderKey)) {
+            if (msg.text.trim() === config.service.pairingCode) {
+                pairedSenders.add(senderKey);
+                savePairingStore();
+                log.info(`Paired sender: ${senderKey}`);
+                return null;
+            }
+            log.debug(`Unpaired sender ${senderKey} — ignoring`);
+            return null;
+        }
+    }
+    // Try explicit mention routing first
+    for (const [agentId, agent] of Object.entries(config.agents)) {
+        for (const route of agent.routes) {
+            if (route.channel !== msg.channel)
+                continue;
+            const matchValue = String(route.match.value);
+            if (msg.chatId !== matchValue)
+                continue;
+            if (!isAllowed(msg, route)) {
+                log.debug(`Blocked: ${msg.sender} not in allowFrom for ${agentId}`);
+                return null;
+            }
+            if (route.permissions.requireMention) {
+                if (!hasMention(msg.text, agent)) {
+                    continue;
+                }
+            }
+            // Explicit mention found — update sticky and return
+            setStickyAgent(msg, agentId);
+            return { agentId, agentConfig: agent, route };
+        }
+    }
+    // No explicit mention — try sticky routing
+    const sticky = getStickyAgent(msg, config);
+    if (sticky) {
+        // Refresh the timestamp on each sticky hit
+        setStickyAgent(msg, sticky.agentId);
+        return sticky;
+    }
+    // Fall back to default agent — only for the web channel
+    if (msg.channel === "web" && config.defaultAgent && config.agents[config.defaultAgent]) {
+        const agent = config.agents[config.defaultAgent];
+        const matchingRoute = agent.routes.find(r => r.channel === msg.channel);
+        if (matchingRoute) {
+            return {
+                agentId: config.defaultAgent,
+                agentConfig: agent,
+                route: matchingRoute,
+            };
+        }
+    }
+    log.debug(`No route for ${msg.channel}:${msg.chatId} from ${msg.senderName || msg.sender}`);
+    return null;
+}
+// Exported for pairing check in index.ts
+export function isPairingAttempt(msg, config, baseDir) {
+    if (!config.service.pairingCode)
+        return false;
+    loadPairingStore(baseDir);
+    const senderKey = `${msg.channel}:${msg.sender}`;
+    if (pairedSenders.has(senderKey))
+        return false;
+    return msg.text.trim() === config.service.pairingCode;
+}
+export function pairSender(msg, baseDir) {
+    loadPairingStore(baseDir);
+    const senderKey = `${msg.channel}:${msg.sender}`;
+    pairedSenders.add(senderKey);
+    savePairingStore();
+    log.info(`Paired sender: ${senderKey}`);
+}
+function hasMention(text, agent) {
+    const lower = text.toLowerCase();
+    if (agent.mentionAliases?.length) {
+        return agent.mentionAliases.some((alias) => lower.includes(alias.toLowerCase()));
+    }
+    return lower.includes(agent.name.toLowerCase());
+}
+function isAllowed(msg, route) {
+    const { allowFrom } = route.permissions;
+    if (!allowFrom || allowFrom.length === 0)
+        return true;
+    if (allowFrom.includes("*"))
+        return true;
+    return allowFrom.includes(msg.sender);
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAQlC,wEAAwE;AAExE,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;AACxC,IAAI,kBAAkB,GAAG,KAAK,CAAC;AAC/B,IAAI,gBAAgB,GAAG,EAAE,CAAC;AAE1B,SAAS,gBAAgB,CAAC,OAAe;IACvC,IAAI,kBAAkB;QAAE,OAAO;IAC/B,gBAAgB,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAChE,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAa,CAAC;YAC7E,KAAK,MAAM,CAAC,IAAI,IAAI;gBAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC7B,kBAAkB,GAAG,IAAI,CAAC;AAC5B,CAAC;AAED,SAAS,gBAAgB;IACvB,IAAI,CAAC;QACH,SAAS,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,aAAa,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AASD,2DAA2D;AAC3D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAuB,CAAC;AAEjD,MAAM,yBAAyB,GAAG,OAAO,CAAC,CAAC,YAAY;AAQvD,SAAS,aAAa,CAAC,MAAiB,EAAE,OAAe;IACvD,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,yBAAyB,EAAE,CAAC;IAE5F,MAAM,GAAG,GAAI,UAAU,CAAC,MAAc,CAAC,aAAa,CAAC;IACrD,IAAI,IAAI,GAAe,QAAQ,CAAC,CAAC,uBAAuB;IACxD,IAAI,GAAG,KAAK,QAAQ;QAAE,IAAI,GAAG,QAAQ,CAAC;SACjC,IAAI,GAAG,KAAK,MAAM;QAAE,IAAI,GAAG,MAAM,CAAC;SAClC,IAAI,GAAG,KAAK,QAAQ;QAAE,IAAI,GAAG,QAAQ,CAAC;IAE3C,MAAM,MAAM,GAAI,UAAU,CAAC,MAAc,CAAC,YAAY,IAAI,GAAG,CAAC;IAC9D,MAAM,SAAS,GAAI,UAAU,CAAC,MAAc,CAAC,eAAe,IAAI,yBAAyB,CAAC;IAC1F,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACrC,CAAC;AAED,SAAS,cAAc,CACrB,GAAmB,EACnB,MAAiB;IAEjB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACvE,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAEjC,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;IACzD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAEjC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,mBAAmB;IACnB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,SAAS,EAAE,CAAC;QAC7C,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6DAA6D;IAC7D,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,CAAC,qCAAqC;QACpD,CAAC;QACD,uDAAuD;QACvD,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,CAAC;IAED,gCAAgC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oDAAoD;IACpD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAC7B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,MAAM,CACvE,CAAC;IACF,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,mBAAmB;IACnB,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAExC,GAAG,CAAC,KAAK,CAAC,mBAAmB,IAAI,MAAM,GAAG,CAAC,MAAM,MAAM,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpI,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC/D,CAAC;AAED,SAAS,cAAc,CAAC,GAAmB,EAAE,OAAe;IAC1D,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;IACzD,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,wEAAwE;AAExE,MAAM,UAAU,YAAY,CAC1B,GAAmB,EACnB,MAAiB,EACjB,OAAgB;IAEhB,6BAA6B;IAC7B,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,EAAE,CAAC;QAC1C,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAE1B,MAAM,SAAS,GAAG,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACjD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;gBACnD,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBAC7B,gBAAgB,EAAE,CAAC;gBACnB,GAAG,CAAC,IAAI,CAAC,kBAAkB,SAAS,EAAE,CAAC,CAAC;gBACxC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,GAAG,CAAC,KAAK,CAAC,mBAAmB,SAAS,aAAa,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7D,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO;gBAAE,SAAS;YAE5C,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC7C,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU;gBAAE,SAAS;YAExC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;gBAC3B,GAAG,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,MAAM,yBAAyB,OAAO,EAAE,CAAC,CAAC;gBACpE,OAAO,IAAI,CAAC;YACd,CAAC;YAED,IAAI,KAAK,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;gBACrC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;oBACjC,SAAS;gBACX,CAAC;YACH,CAAC;YAED,oDAAoD;YACpD,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC7B,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAChD,CAAC;IACH,CAAC;IAED,2CAA2C;IAC3C,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC3C,IAAI,MAAM,EAAE,CAAC;QACX,2CAA2C;QAC3C,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,wDAAwD;IACxD,IAAI,GAAG,CAAC,OAAO,KAAK,KAAK,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QACvF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACjD,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC;QACxE,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,YAAY;gBAC5B,WAAW,EAAE,KAAK;gBAClB,KAAK,EAAE,aAAa;aACrB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,GAAG,CAAC,KAAK,CAAC,gBAAgB,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,SAAS,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5F,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,gBAAgB,CAAC,GAAmB,EAAE,MAAiB,EAAE,OAAe;IACtF,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IAC9C,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC1B,MAAM,SAAS,GAAG,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;IACjD,IAAI,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAmB,EAAE,OAAe;IAC7D,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC1B,MAAM,SAAS,GAAG,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;IACjD,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7B,gBAAgB,EAAE,CAAC;IACnB,GAAG,CAAC,IAAI,CAAC,kBAAkB,SAAS,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,KAAkB;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,IAAI,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,SAAS,CAAC,GAAmB,EAAE,KAAkB;IACxD,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC;IACxC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC"}

package/dist/test-message.d.ts

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

package/dist/test-message.d.ts.map

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

package/dist/test-message.js

@@ -0,0 +1,60 @@
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadConfig } from "./config.js";
+import { configureLogger, log } from "./logger.js";
+import { executeAgent } from "./executor.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const baseDir = resolve(__dirname, "..");
+async function main() {
+    const args = process.argv.slice(2);
+    let agentId = null;
+    let text = null;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === "--agent" && args[i + 1]) {
+            agentId = args[++i];
+        }
+        else if (args[i] === "--text" && args[i + 1]) {
+            text = args[++i];
+        }
+    }
+    if (!agentId || !text) {
+        console.log("Usage: npm run test-message -- --agent <agentId> --text <message>");
+        console.log('Example: npm run test-message -- --agent fic-show --text "List all episodes"');
+        process.exit(1);
+    }
+    const configPath = resolve(baseDir, "config.json");
+    const config = loadConfig(configPath);
+    configureLogger("debug");
+    const agentConfig = config.agents[agentId];
+    if (!agentConfig) {
+        console.error(`Agent "${agentId}" not found. Available: ${Object.keys(config.agents).join(", ")}`);
+        process.exit(1);
+    }
+    const msg = {
+        id: "test-" + Date.now(),
+        channel: "test",
+        chatId: "test",
+        chatType: "dm",
+        sender: "test-user",
+        text,
+        timestamp: Date.now(),
+        isFromMe: false,
+        isGroup: false,
+        raw: {},
+    };
+    const route = {
+        agentId,
+        agentConfig,
+        route: agentConfig.routes[0],
+    };
+    log.info(`Testing agent "${agentId}" with message: "${text}"`);
+    const response = await executeAgent(route, msg, baseDir);
+    console.log("\n--- Agent Response ---");
+    console.log(response);
+    console.log("--- End ---\n");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=test-message.js.map

package/dist/test-message.js.map

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

package/dist/utils/imsg-db-reader.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Direct iMessage database reader.
+ * Reads from ~/Library/Messages/chat.db to get message text from attributedBody
+ * when the text column is empty (macOS 15+ behavior).
+ */
+interface DBMessage {
+    rowid: number;
+    text: string;
+    chatId: number;
+    isFromMe: boolean;
+    sender: string;
+    createdAt: string;
+    guid: string;
+}
+/**
+ * Get recent messages from a specific chat, with attributedBody fallback.
+ */
+export declare function getRecentMessages(chatId: number, sinceRowId: number, limit?: number): DBMessage[];
+/**
+ * Get the latest ROWID for a chat (for polling).
+ */
+export declare function getLatestRowId(chatId: number): number;
+export {};
+//# sourceMappingURL=imsg-db-reader.d.ts.map

package/dist/utils/imsg-db-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imsg-db-reader.d.ts","sourceRoot":"","sources":["../../src/utils/imsg-db-reader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AA6BD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,SAAS,EAAE,CAyCrG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAUrD"}

package/dist/utils/imsg-db-reader.js

@@ -0,0 +1,92 @@
+/**
+ * Direct iMessage database reader.
+ * Reads from ~/Library/Messages/chat.db to get message text from attributedBody
+ * when the text column is empty (macOS 15+ behavior).
+ */
+import { execSync } from "node:child_process";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const DB_PATH = join(homedir(), "Library", "Messages", "chat.db");
+/**
+ * Extract plain text from NSAttributedString binary blob (NSArchiver/typedstream format).
+ * The text is stored after a \x01\x2B marker followed by a length byte, then raw UTF-8 bytes.
+ */
+function extractTextFromAttributedBody(hexData) {
+    try {
+        const buf = Buffer.from(hexData, "hex");
+        // Search for the \x01\x2B (NSArchiver string marker "+") pattern
+        for (let i = 0; i < buf.length - 2; i++) {
+            if (buf[i] === 0x01 && buf[i + 1] === 0x2b) {
+                const len = buf[i + 2];
+                if (len > 0 && i + 3 + len <= buf.length) {
+                    const text = buf.toString("utf-8", i + 3, i + 3 + len);
+                    // Sanity check: should contain at least some printable chars
+                    if (/[\x20-\x7E]/.test(text)) {
+                        return text.trim();
+                    }
+                }
+            }
+        }
+        return "";
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Get recent messages from a specific chat, with attributedBody fallback.
+ */
+export function getRecentMessages(chatId, sinceRowId, limit = 20) {
+    try {
+        const query = `
+      SELECT m.ROWID, m.text, m.is_from_me, m.handle_id,
+             datetime(m.date/1000000000 + 978307200, 'unixepoch', 'localtime') as created_at,
+             m.guid, hex(m.attributedBody) as attr_hex,
+             h.id as sender_id
+      FROM message m
+      JOIN chat_message_join cmj ON m.ROWID = cmj.message_id
+      LEFT JOIN handle h ON m.handle_id = h.ROWID
+      WHERE cmj.chat_id = ${chatId}
+        AND m.ROWID > ${sinceRowId}
+        AND m.associated_message_type = 0
+      ORDER BY m.date ASC
+      LIMIT ${limit};
+    `;
+        const result = execSync(`sqlite3 -json "${DB_PATH}" "${query.replace(/"/g, '\\"')}"`, {
+            timeout: 5000,
+            encoding: "utf-8",
+        });
+        const rows = JSON.parse(result || "[]");
+        return rows.map((row) => {
+            let text = row.text || "";
+            if (!text && row.attr_hex) {
+                text = extractTextFromAttributedBody(row.attr_hex);
+            }
+            return {
+                rowid: row.ROWID,
+                text,
+                chatId,
+                isFromMe: row.is_from_me === 1,
+                sender: row.sender_id || (row.is_from_me === 1 ? "me" : "unknown"),
+                createdAt: row.created_at,
+                guid: row.guid,
+            };
+        }).filter((m) => m.text.trim().length > 0);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get the latest ROWID for a chat (for polling).
+ */
+export function getLatestRowId(chatId) {
+    try {
+        const result = execSync(`sqlite3 "${DB_PATH}" "SELECT MAX(m.ROWID) FROM message m JOIN chat_message_join cmj ON m.ROWID = cmj.message_id WHERE cmj.chat_id = ${chatId};"`, { timeout: 5000, encoding: "utf-8" });
+        return parseInt(result.trim()) || 0;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=imsg-db-reader.js.map

package/dist/utils/imsg-db-reader.js.map

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

package/dist/utils/imsg-rpc.d.ts

@@ -0,0 +1,25 @@
+interface JsonRpcNotification {
+    jsonrpc: "2.0";
+    method: string;
+    params: unknown;
+}
+export declare class ImsgRpcClient {
+    private proc;
+    private rl;
+    private nextId;
+    private pending;
+    private notificationHandler;
+    private cliPath;
+    private stopping;
+    private restartTimer;
+    constructor(cliPath?: string);
+    start(): Promise<void>;
+    private handleLine;
+    request<T>(method: string, params?: object, timeoutMs?: number): Promise<T>;
+    onNotification(handler: (notification: JsonRpcNotification) => void): void;
+    private restart;
+    private startProcess;
+    stop(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=imsg-rpc.d.ts.map

package/dist/utils/imsg-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imsg-rpc.d.ts","sourceRoot":"","sources":["../../src/utils/imsg-rpc.ts"],"names":[],"mappings":"AAUA,UAAU,mBAAmB;IAC3B,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,mBAAmB,CAA8D;IACzF,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAA8C;gBAEtD,OAAO,SAAS;IAItB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B,OAAO,CAAC,UAAU;IAoCZ,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC;IAwBjF,cAAc,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,mBAAmB,KAAK,IAAI,GAAG,IAAI;YAI5D,OAAO;YAcP,YAAY;IAmCpB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAa5B"}