@runcore-sh/runcore 0.1.2

package/dist/capabilities/types.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Capability Registry — Core types.
+ *
+ * A "capability" is something the system can do, expressed as one of three patterns:
+ *
+ *   1. **Action block** — The LLM emits a tagged JSON block in its response
+ *      (e.g. [CALENDAR_ACTION]{...}[/CALENDAR_ACTION]). The registry parses
+ *      the block and calls execute(). Calendar, email, and docs use this pattern.
+ *
+ *   2. **Context provider** — The system injects data INTO the LLM's context
+ *      before it responds (e.g. web search results, today's calendar, inbox
+ *      summary). No action blocks — the capability decides whether to inject
+ *      and returns content for the system prompt.
+ *
+ *   3. **Meta capability** — Structural/control-flow blocks the LLM emits that
+ *      affect orchestration rather than calling an external API (e.g.
+ *      AGENT_REQUEST blocks that spawn sub-agents). Parsed like action blocks
+ *      but processed with custom logic rather than a simple execute().
+ *
+ * The `pattern` field is the discriminant for the union type.
+ */
+/** Origin of the LLM call — determines actionLabel and prompt phrasing. */
+export type ActionOrigin = "chat" | "email" | "autonomous";
+/** Context passed to execute() and prompt generators. */
+export interface ActionContext {
+    origin: ActionOrigin;
+    /** Human-readable name of the paired user (for prompt personalization). */
+    name?: string;
+    sessionId?: string;
+    /** Per-request hints for context providers (e.g. { detectedUrl: true }). */
+    hints?: Record<string, unknown>;
+}
+/** A single parsed action block extracted from an LLM response. */
+export interface ParsedActionBlock {
+    /** Which capability owns this block (e.g. "calendar", "email", "docs"). */
+    capabilityId: string;
+    /** The tag name used in the response (e.g. "CALENDAR_ACTION"). */
+    tag: string;
+    /** Raw JSON string from inside the block. */
+    rawJson: string;
+    /** Parsed payload (or null if JSON was invalid). */
+    payload: Record<string, unknown> | null;
+}
+/** Result of executing a single action block. */
+export interface ActionExecutionResult {
+    capabilityId: string;
+    ok: boolean;
+    message: string;
+    /** Optional structured data returned by the action (e.g. board view issues). */
+    data?: unknown;
+}
+/** The three capability patterns. */
+export type CapabilityPattern = "action" | "context" | "meta";
+/**
+ * Fields shared by all capability patterns.
+ */
+interface BaseCapability {
+    /** Unique id (e.g. "calendar", "email", "web-search"). */
+    id: string;
+    /** Discriminant — determines which fields are available. */
+    pattern: CapabilityPattern;
+    /** Keywords that signal this capability is relevant to a message. */
+    keywords: string[];
+    /**
+     * Generate prompt instructions for this capability.
+     * Called by getPromptInstructions() — can vary by origin.
+     */
+    getPromptInstructions(ctx: ActionContext): string;
+    /**
+     * Optional origin-specific prompt override.
+     * If provided, replaces getPromptInstructions for that origin.
+     */
+    getPromptOverride?(origin: ActionOrigin): string | null;
+}
+/**
+ * Action block capability — the LLM emits tagged JSON that gets parsed and executed.
+ * Used by: calendar, email, docs.
+ */
+export interface ActionBlockCapability extends BaseCapability {
+    pattern: "action";
+    /** The tag name in LLM responses, WITHOUT brackets (e.g. "CALENDAR_ACTION"). */
+    tag: string;
+    /**
+     * Execute a single parsed action block.
+     * Returns a result indicating success/failure.
+     */
+    execute(payload: Record<string, unknown>, ctx: ActionContext): Promise<ActionExecutionResult>;
+}
+/**
+ * Content returned by a context provider for injection into the LLM prompt.
+ */
+export interface ContextInjection {
+    /** Label for the injected section (e.g. "Web search results"). */
+    label: string;
+    /** The content to inject. */
+    content: string;
+}
+/**
+ * Context provider capability — injects data into the LLM's context before
+ * it responds. The system calls shouldInject() to check relevance, then
+ * getContext() to retrieve the content.
+ * Used by: web search, calendar data, gmail inbox.
+ */
+export interface ContextProviderCapability extends BaseCapability {
+    pattern: "context";
+    /**
+     * Should this provider inject context for the given message?
+     * Can be async (e.g. to classify the message with a small model).
+     */
+    shouldInject(message: string, ctx: ActionContext): Promise<boolean> | boolean;
+    /**
+     * Retrieve context content to inject into the prompt.
+     * Returns null if nothing to inject (e.g. search returned no results).
+     */
+    getContext(message: string, ctx: ActionContext): Promise<ContextInjection | null>;
+}
+/**
+ * Result of processing meta capability blocks.
+ */
+export interface MetaExecutionResult {
+    capabilityId: string;
+    blocksProcessed: number;
+    results: Array<{
+        ok: boolean;
+        message: string;
+    }>;
+}
+/**
+ * Meta capability — structural/control-flow blocks that affect orchestration.
+ * Parsed like action blocks (tagged JSON) but processed with custom logic
+ * rather than a simple execute().
+ * Used by: AGENT_REQUEST (spawns sub-agents).
+ */
+export interface MetaCapability extends BaseCapability {
+    pattern: "meta";
+    /** The tag name in LLM responses, WITHOUT brackets (e.g. "AGENT_REQUEST"). */
+    tag: string;
+    /**
+     * Process all matched blocks for this meta capability.
+     * Unlike action blocks which are executed one-by-one, meta capabilities
+     * receive all their blocks at once for batch/orchestration logic.
+     */
+    processBlocks(blocks: ParsedActionBlock[], ctx: ActionContext): Promise<MetaExecutionResult>;
+}
+/**
+ * A capability definition — the single source of truth for one capability.
+ * Discriminated union on `pattern`.
+ */
+export type CapabilityDefinition = ActionBlockCapability | ContextProviderCapability | MetaCapability;
+/** Check if a capability uses the action block pattern. */
+export declare function isActionBlock(def: CapabilityDefinition): def is ActionBlockCapability;
+/** Check if a capability is a context provider. */
+export declare function isContextProvider(def: CapabilityDefinition): def is ContextProviderCapability;
+/** Check if a capability is a meta capability. */
+export declare function isMetaCapability(def: CapabilityDefinition): def is MetaCapability;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/capabilities/types.d.ts.map

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

package/dist/capabilities/types.js

@@ -0,0 +1,35 @@
+/**
+ * Capability Registry — Core types.
+ *
+ * A "capability" is something the system can do, expressed as one of three patterns:
+ *
+ *   1. **Action block** — The LLM emits a tagged JSON block in its response
+ *      (e.g. [CALENDAR_ACTION]{...}[/CALENDAR_ACTION]). The registry parses
+ *      the block and calls execute(). Calendar, email, and docs use this pattern.
+ *
+ *   2. **Context provider** — The system injects data INTO the LLM's context
+ *      before it responds (e.g. web search results, today's calendar, inbox
+ *      summary). No action blocks — the capability decides whether to inject
+ *      and returns content for the system prompt.
+ *
+ *   3. **Meta capability** — Structural/control-flow blocks the LLM emits that
+ *      affect orchestration rather than calling an external API (e.g.
+ *      AGENT_REQUEST blocks that spawn sub-agents). Parsed like action blocks
+ *      but processed with custom logic rather than a simple execute().
+ *
+ * The `pattern` field is the discriminant for the union type.
+ */
+// ─── Type guards ────────────────────────────────────────────────────────────
+/** Check if a capability uses the action block pattern. */
+export function isActionBlock(def) {
+    return def.pattern === "action";
+}
+/** Check if a capability is a context provider. */
+export function isContextProvider(def) {
+    return def.pattern === "context";
+}
+/** Check if a capability is a meta capability. */
+export function isMetaCapability(def) {
+    return def.pattern === "meta";
+}
+//# sourceMappingURL=types.js.map

package/dist/capabilities/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/capabilities/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAwKH,+EAA+E;AAE/E,2DAA2D;AAC3D,MAAM,UAAU,aAAa,CAAC,GAAyB;IACrD,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC;AAClC,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,iBAAiB,CAAC,GAAyB;IACzD,OAAO,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC;AACnC,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,gBAAgB,CAAC,GAAyB;IACxD,OAAO,GAAG,CAAC,OAAO,KAAK,MAAM,CAAC;AAChC,CAAC"}

package/dist/channels/whatsapp.d.ts

@@ -0,0 +1,88 @@
+/**
+ * WhatsApp messaging client via Twilio API.
+ * Raw fetch, no SDK. Follows src/twilio/call.ts + src/slack/client.ts patterns.
+ *
+ * Credentials read from process.env (hydrated by vault):
+ * - TWILIO_ACCOUNT_SID
+ * - TWILIO_AUTH_TOKEN
+ * - TWILIO_PHONE_NUMBER (WhatsApp-enabled sender)
+ *
+ * Never throws in public methods — returns { ok, data?, error? }.
+ */
+export interface WhatsAppMessage {
+    sid: string;
+    from: string;
+    to: string;
+    body: string;
+    status: string;
+    direction: "inbound" | "outbound";
+    timestamp: string;
+}
+export interface WhatsAppContact {
+    phone: string;
+    name?: string;
+    lastMessageAt?: string;
+}
+export interface SendResult {
+    ok: boolean;
+    sid?: string;
+    message: string;
+}
+export interface MessageHistoryEntry {
+    sid: string;
+    from: string;
+    to: string;
+    body: string;
+    direction: "inbound" | "outbound";
+    timestamp: string;
+}
+/**
+ * Get or create the singleton WhatsApp client.
+ * Returns null if Twilio credentials are not configured.
+ */
+export declare function getClient(): WhatsAppClient | null;
+/**
+ * Check if WhatsApp is configured (all required vault keys present).
+ */
+export declare function isWhatsAppConfigured(): boolean;
+export declare class WhatsAppClient {
+    lastErrorMessage: string | null;
+    private get accountSid();
+    private get authToken();
+    private get fromNumber();
+    private get auth();
+    /**
+     * Send a WhatsApp message via Twilio API.
+     * Phone numbers must include country code (e.g., +1234567890).
+     */
+    sendMessage(to: string, body: string): Promise<SendResult>;
+    /**
+     * List all known WhatsApp contacts.
+     */
+    listContacts(): Promise<WhatsAppContact[]>;
+    /**
+     * Add or update a contact.
+     */
+    upsertContact(contact: WhatsAppContact): Promise<void>;
+    /**
+     * Remove a contact by phone number.
+     */
+    removeContact(phone: string): Promise<boolean>;
+    /**
+     * Append a message to the JSONL history file.
+     */
+    appendHistory(entry: MessageHistoryEntry): Promise<void>;
+    /**
+     * Get message history, optionally filtered by phone number.
+     * Returns most recent messages first.
+     */
+    getHistory(opts?: {
+        phone?: string;
+        limit?: number;
+    }): Promise<MessageHistoryEntry[]>;
+    getHealth(): {
+        available: boolean;
+        lastError: string | null;
+    };
+}
+//# sourceMappingURL=whatsapp.d.ts.map

package/dist/channels/whatsapp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp.d.ts","sourceRoot":"","sources":["../../src/channels/whatsapp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,GAAG,UAAU,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,GAAG,UAAU,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAmBD;;;GAGG;AACH,wBAAgB,SAAS,IAAI,cAAc,GAAG,IAAI,CAQjD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAID,qBAAa,cAAc;IACzB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEvC,OAAO,KAAK,UAAU,GAAsD;IAC5E,OAAO,KAAK,SAAS,GAAqD;IAC1E,OAAO,KAAK,UAAU,GAAuD;IAC7E,OAAO,KAAK,IAAI,GAEf;IAID;;;OAGG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA6DhE;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAUhD;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5D;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWpD;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9D;;;OAGG;IACG,UAAU,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA+B3F,SAAS,IAAI;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;CAM9D"}

package/dist/channels/whatsapp.js

@@ -0,0 +1,200 @@
+/**
+ * WhatsApp messaging client via Twilio API.
+ * Raw fetch, no SDK. Follows src/twilio/call.ts + src/slack/client.ts patterns.
+ *
+ * Credentials read from process.env (hydrated by vault):
+ * - TWILIO_ACCOUNT_SID
+ * - TWILIO_AUTH_TOKEN
+ * - TWILIO_PHONE_NUMBER (WhatsApp-enabled sender)
+ *
+ * Never throws in public methods — returns { ok, data?, error? }.
+ */
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { logActivity } from "../activity/log.js";
+// ── Constants ────────────────────────────────────────────────────────────────
+const REQUIRED_VARS = [
+    "TWILIO_ACCOUNT_SID",
+    "TWILIO_AUTH_TOKEN",
+    "TWILIO_PHONE_NUMBER",
+];
+const HISTORY_DIR = "brain/channels/whatsapp";
+const HISTORY_FILE = "messages.jsonl";
+const CONTACTS_FILE = "contacts.json";
+// ── Lazy singleton ───────────────────────────────────────────────────────────
+let _client = null;
+let _lastSid = "";
+/**
+ * Get or create the singleton WhatsApp client.
+ * Returns null if Twilio credentials are not configured.
+ */
+export function getClient() {
+    const sid = process.env.TWILIO_ACCOUNT_SID;
+    if (!sid)
+        return null;
+    if (sid !== _lastSid) {
+        _client = new WhatsAppClient();
+        _lastSid = sid;
+    }
+    return _client;
+}
+/**
+ * Check if WhatsApp is configured (all required vault keys present).
+ */
+export function isWhatsAppConfigured() {
+    return REQUIRED_VARS.every((v) => !!process.env[v]);
+}
+// ── Client class ─────────────────────────────────────────────────────────────
+export class WhatsAppClient {
+    lastErrorMessage = null;
+    get accountSid() { return process.env.TWILIO_ACCOUNT_SID; }
+    get authToken() { return process.env.TWILIO_AUTH_TOKEN; }
+    get fromNumber() { return process.env.TWILIO_PHONE_NUMBER; }
+    get auth() {
+        return Buffer.from(`${this.accountSid}:${this.authToken}`).toString("base64");
+    }
+    // ── Send message ─────────────────────────────────────────────────────────
+    /**
+     * Send a WhatsApp message via Twilio API.
+     * Phone numbers must include country code (e.g., +1234567890).
+     */
+    async sendMessage(to, body) {
+        try {
+            const missing = REQUIRED_VARS.filter((v) => !process.env[v]);
+            if (missing.length > 0) {
+                return { ok: false, message: `Missing vault keys: ${missing.join(", ")}` };
+            }
+            const url = `https://api.twilio.com/2010-04-01/Accounts/${this.accountSid}/Messages.json`;
+            const params = new URLSearchParams({
+                From: `whatsapp:${this.fromNumber}`,
+                To: `whatsapp:${to}`,
+                Body: body,
+            });
+            const res = await fetch(url, {
+                method: "POST",
+                headers: {
+                    Authorization: `Basic ${this.auth}`,
+                    "Content-Type": "application/x-www-form-urlencoded",
+                },
+                body: params.toString(),
+                signal: AbortSignal.timeout(15_000),
+            });
+            if (!res.ok) {
+                const errBody = await res.text();
+                this.lastErrorMessage = `Twilio error (${res.status}): ${errBody}`;
+                return { ok: false, message: this.lastErrorMessage };
+            }
+            const data = (await res.json());
+            // Store outbound message in history
+            await this.appendHistory({
+                sid: data.sid ?? "",
+                from: this.fromNumber,
+                to,
+                body,
+                direction: "outbound",
+                timestamp: new Date().toISOString(),
+            });
+            // Update contact
+            await this.upsertContact({ phone: to, lastMessageAt: new Date().toISOString() });
+            logActivity({
+                source: "whatsapp",
+                summary: `WhatsApp sent to ${to}: "${body.slice(0, 60)}"`,
+                detail: `sid=${data.sid}`,
+            });
+            this.lastErrorMessage = null;
+            return { ok: true, sid: data.sid, message: `Message sent to ${to}` };
+        }
+        catch (err) {
+            this.lastErrorMessage = err.message;
+            return { ok: false, message: `Send failed: ${err.message}` };
+        }
+    }
+    // ── Contact management ───────────────────────────────────────────────────
+    /**
+     * List all known WhatsApp contacts.
+     */
+    async listContacts() {
+        try {
+            const filePath = join(HISTORY_DIR, CONTACTS_FILE);
+            const raw = await readFile(filePath, "utf-8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Add or update a contact.
+     */
+    async upsertContact(contact) {
+        const contacts = await this.listContacts();
+        const idx = contacts.findIndex((c) => c.phone === contact.phone);
+        if (idx >= 0) {
+            contacts[idx] = { ...contacts[idx], ...contact };
+        }
+        else {
+            contacts.push(contact);
+        }
+        await mkdir(HISTORY_DIR, { recursive: true });
+        await writeFile(join(HISTORY_DIR, CONTACTS_FILE), JSON.stringify(contacts, null, 2));
+    }
+    /**
+     * Remove a contact by phone number.
+     */
+    async removeContact(phone) {
+        const contacts = await this.listContacts();
+        const filtered = contacts.filter((c) => c.phone !== phone);
+        if (filtered.length === contacts.length)
+            return false;
+        await mkdir(HISTORY_DIR, { recursive: true });
+        await writeFile(join(HISTORY_DIR, CONTACTS_FILE), JSON.stringify(filtered, null, 2));
+        return true;
+    }
+    // ── Message history ──────────────────────────────────────────────────────
+    /**
+     * Append a message to the JSONL history file.
+     */
+    async appendHistory(entry) {
+        await mkdir(HISTORY_DIR, { recursive: true });
+        const line = JSON.stringify(entry) + "\n";
+        const filePath = join(HISTORY_DIR, HISTORY_FILE);
+        // Append-only — matches brain/memory JSONL pattern
+        const { appendFile } = await import("node:fs/promises");
+        await appendFile(filePath, line);
+    }
+    /**
+     * Get message history, optionally filtered by phone number.
+     * Returns most recent messages first.
+     */
+    async getHistory(opts) {
+        try {
+            const filePath = join(HISTORY_DIR, HISTORY_FILE);
+            const raw = await readFile(filePath, "utf-8");
+            let entries = raw
+                .trim()
+                .split("\n")
+                .filter(Boolean)
+                .map((line) => JSON.parse(line));
+            if (opts?.phone) {
+                entries = entries.filter((e) => e.from === opts.phone || e.to === opts.phone);
+            }
+            // Most recent first
+            entries.reverse();
+            if (opts?.limit && opts.limit > 0) {
+                entries = entries.slice(0, opts.limit);
+            }
+            return entries;
+        }
+        catch {
+            return [];
+        }
+    }
+    // ── Health ───────────────────────────────────────────────────────────────
+    getHealth() {
+        return {
+            available: isWhatsAppConfigured(),
+            lastError: this.lastErrorMessage,
+        };
+    }
+}
+//# sourceMappingURL=whatsapp.js.map

package/dist/channels/whatsapp.js.map

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

package/dist/cli/backup.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CLI commands for manual brain backup and restore operations.
+ * Usage: npx tsx src/cli/backup.ts <command> [options]
+ *
+ * Commands:
+ *   backup              Run a backup now
+ *   restore <id>        Restore from a specific backup
+ *   list                List available backups
+ *   verify <id>         Verify a backup's integrity
+ *   status              Show backup service status
+ */
+export {};
+//# sourceMappingURL=backup.d.ts.map

package/dist/cli/backup.d.ts.map

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