life-pulse 2.2.2 → 2.3.1

package/dist/installer.js

@@ -19,7 +19,6 @@ import { join } from 'path';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
 import { execSync } from 'child_process';
 import { createInterface } from 'readline';
-import chalk from 'chalk';
 import { runPermissionFlow, hasRequiredPermissions } from './permissions.js';
 import { discoverPlatforms, savePlatforms } from './platforms.js';
 import { runDiscovery, formatDiscoveryReport } from './icloud-discovery.js';
@@ -29,9 +28,10 @@ import { updateAutoKnowledge } from './knowledge.js';
 import { scanForSkills } from './skill-loader.js';
 import { hasTailscale, getHostname as getTailscaleHostname, startFunnel } from './tunnel.js';
 import { startGateway } from './sms-gateway.js';
-import { renderCRMList, renderBrief, Spinner, GRN, DIM, HD, MID, RED } from './tui.js';
+import { renderCRMList, renderBrief, Spinner, DIM, HD, MID } from './tui.js';
 import { saveContactSummaries } from './intelligence.js';
 import { startSession } from './session-progress.js';
+import * as rply from './rply-client.js';
 const BASE = join(homedir(), '.life-pulse');
 const STATE_PATH = join(BASE, 'install-state.json');
 function loadState() {
@@ -61,9 +61,8 @@ function isDone(state, step) {
 }
 // ─── TUI Helpers ────────────────────────────────────────────────
 function stepHeader(num, title, done) {
-    const icon = done ? GRN('✓') : chalk.bold.hex('#7AA2F7')(`${num}`);
     const label = done ? DIM(title) : HD(title);
-    console.log(`\n  ${icon}  ${label}`);
+    console.log(`\n  ${label}`);
 }
 async function prompt(question) {
     const rl = createInterface({ input: process.stdin, output: process.stdout });
@@ -74,14 +73,24 @@ async function prompt(question) {
         });
     });
 }
+// ─── Platform Hints ─────────────────────────────────────────────
+const PLATFORM_HINTS = {
+    slack: 'sign into slack.com in Safari',
+    x: 'sign into x.com in Safari',
+    email: 'sign into gmail.com in Safari',
+    instagram: 'sign into instagram.com in Safari',
+    linkedin: 'sign into linkedin.com in Safari',
+    whatsApp: 'sign into web.whatsapp.com in Safari',
+    telegram: 'sign into web.telegram.org in Safari',
+};
+function platformHint(platform) {
+    return PLATFORM_HINTS[platform] || '';
+}
 // ─── Main Installer Flow ────────────────────────────────────────
 export async function runInstaller(apiKey) {
     const state = loadState();
     const spinner = process.stdin.isTTY ? new Spinner() : undefined;
     console.log();
-    console.log(chalk.bold.hex('#7AA2F7')('  life-pulse'));
-    console.log(DIM('  personal AI operating system'));
-    console.log();
     // ── Step 1: Pre-flight ──
     stepHeader(1, 'Pre-flight', isDone(state, 'preflight'));
     if (!isDone(state, 'preflight')) {
@@ -107,15 +116,15 @@ export async function runInstaller(apiKey) {
                 process.env.ANTHROPIC_API_KEY = key;
                 apiKey = key;
                 state.apiKeySet = true;
-                console.log(GRN('    API key saved'));
+                console.log(DIM('    API key saved'));
             }
             else {
-                console.log(RED('    no API key — some features will be limited'));
+                console.log(DIM('    no API key — some features will be limited'));
             }
         }
         else {
             state.apiKeySet = true;
-            console.log(GRN('    API key configured'));
+            console.log(DIM('    API key configured'));
         }
         markDone(state, 'preflight');
     }
@@ -125,13 +134,13 @@ export async function runInstaller(apiKey) {
         if (process.stdin.isTTY) {
             const allGranted = await runPermissionFlow();
             if (allGranted) {
-                console.log(GRN('    all permissions granted'));
+                console.log(DIM('    all permissions granted'));
             }
             else if (hasRequiredPermissions()) {
                 console.log(DIM('    required permissions granted (some optional skipped)'));
             }
             else {
-                console.log(RED('    some required permissions missing — re-run to retry'));
+                console.log(HD('    some required permissions missing — re-run to retry'));
             }
         }
         markDone(state, 'permissions');
@@ -139,9 +148,9 @@ export async function runInstaller(apiKey) {
     // ── Step 3: Discovery ──
     stepHeader(3, 'Discovery', isDone(state, 'discovery'));
     if (!isDone(state, 'discovery')) {
-        spinner?.start('scanning platforms');
+        spinner?.start('learning your world');
         const platformProfile = discoverPlatforms();
-        spinner?.update('scanning iCloud');
+        spinner?.update('looking deeper');
         const discoveredApps = runDiscovery();
         spinner?.stop();
         if (discoveredApps.length) {
@@ -162,23 +171,45 @@ export async function runInstaller(apiKey) {
         if (skills.active.length) {
             console.log(DIM(`    ${skills.active.length} skills activated`));
         }
+        // RPLY platform connectivity
+        const rplyStatus = await rply.status();
+        if (rplyStatus) {
+            const active = rplyStatus.platforms.filter(p => p.is_available && p.is_enabled);
+            const inactive = rplyStatus.platforms.filter(p => !p.is_available || !p.is_enabled);
+            console.log();
+            for (const p of active) {
+                console.log(`    ${HD(p.display_name)}`);
+            }
+            for (const p of inactive) {
+                const hint = platformHint(p.platform);
+                console.log(`    ${DIM('○')} ${DIM(p.display_name)}${hint ? '  ' + DIM(hint) : ''}`);
+            }
+            if (inactive.length) {
+                console.log();
+                console.log(DIM('    sign into these to connect them'));
+                console.log(DIM('    run setup again after'));
+            }
+        }
+        else {
+            console.log(DIM('    iMessage only — more platforms available'));
+        }
         savePlatforms(platformProfile);
         markDone(state, 'discovery');
     }
     // ── Step 4: CRM Build ──
     stepHeader(4, 'Relationship Map', isDone(state, 'crm'));
     if (!isDone(state, 'crm')) {
-        spinner?.start('scanning messages');
-        const crm = buildCRM();
+        spinner?.start('reading the room');
+        const crm = await buildCRM();
         spinner?.stop();
         if (crm.threads.length) {
             renderCRMList(crm.threads);
             // Knowledge base generation
-            const knowledgeCount = updateAutoKnowledge(crm);
+            const knowledgeCount = await updateAutoKnowledge(crm);
             console.log(DIM(`    ${knowledgeCount} contact knowledge bases created`));
             // Enrichment
             if (apiKey) {
-                spinner?.start('reading the room');
+                spinner?.start('understanding the room');
                 let brief = '';
                 const enriched = [];
                 for await (const t of streamEnrichedCRM(crm, apiKey, {
@@ -200,7 +231,7 @@ export async function runInstaller(apiKey) {
     // ── Step 5: Archetype ──
     stepHeader(5, 'Archetype', isDone(state, 'archetype'));
     if (!isDone(state, 'archetype') && apiKey) {
-        spinner?.start('generating archetype');
+        spinner?.start('figuring out who you are');
         try {
             const platforms = discoverPlatforms(); // re-read (may have been saved)
             const archetype = await generateArchetype(platforms, apiKey);
@@ -213,48 +244,40 @@ export async function runInstaller(apiKey) {
         }
         catch (err) {
             spinner?.stop();
-            console.log(RED(`    archetype generation failed: ${err instanceof Error ? err.message : String(err)}`));
+            console.log(DIM(`    archetype generation failed: ${err instanceof Error ? err.message : String(err)}`));
         }
         markDone(state, 'archetype');
     }
-    // ── Step 6: Messaging Gateway (Tailscale → rply-mac-server) ──
-    stepHeader(6, 'Messaging Gateway', isDone(state, 'phone'));
+    // ── Step 6: Messaging ──
+    stepHeader(6, 'Messaging', isDone(state, 'phone'));
     if (!isDone(state, 'phone')) {
-        // Start the inbound gateway (rply-mac-server pushes messages here)
         if (apiKey) {
             const gw = startGateway(apiKey);
-            console.log(GRN(`    gateway listening on :${gw.port}`));
-            // Stop after installer finishes (daemon will restart it)
             setTimeout(() => gw.stop(), 60_000);
         }
-        // Tailscale — required for rply-mac-server to reach this Mac
         if (hasTailscale()) {
             const hostname = getTailscaleHostname();
             if (hostname) {
                 state.funnelUrl = `http://${hostname}:19877`;
-                console.log(GRN(`    Tailscale: ${hostname}`));
-                console.log(DIM(`    rply-mac-server → ${state.funnelUrl}/inbound`));
-                // Optionally expose via Funnel for HTTPS
-                spinner?.start('setting up tunnel');
+                spinner?.start('opening the connection');
                 const funnelUrl = startFunnel(19877);
                 spinner?.stop();
-                if (funnelUrl) {
+                if (funnelUrl)
                     state.funnelUrl = funnelUrl;
-                    console.log(GRN(`    Funnel: ${funnelUrl}/inbound`));
-                }
+                console.log(DIM('    connected'));
             }
             else {
-                console.log(RED('    Tailscale installed but no hostname — check tailscale status'));
+                console.log(HD('    network connection incomplete — run setup again'));
             }
         }
         else {
-            console.log(RED('    Tailscale not installed — rply-mac-server cannot reach this Mac'));
-            console.log(DIM('    install: https://tailscale.com/download/mac'));
+            console.log(HD('    missing network layer — messages won\'t reach this machine'));
+            console.log(DIM('    tailscale.com/download'));
         }
         markDone(state, 'phone');
     }
     // ── Step 7: Daemon Install ──
-    stepHeader(7, 'Daemon', isDone(state, 'daemon'));
+    stepHeader(7, 'Background', isDone(state, 'daemon'));
     if (!isDone(state, 'daemon')) {
         const logDir = join(homedir(), 'Library/Logs/life-pulse');
         const agentsDir = join(homedir(), 'Library/LaunchAgents');
@@ -320,35 +343,31 @@ export async function runInstaller(apiKey) {
             execSync('launchctl load ~/Library/LaunchAgents/com.life-pulse.daemon.plist', {
                 stdio: 'pipe', timeout: 5000,
             });
-            console.log(GRN('    daemon installed and started'));
-        }
-        catch {
-            console.log(DIM('    plists written — load manually:'));
-            console.log(DIM('    launchctl load ~/Library/LaunchAgents/com.life-pulse.daemon.plist'));
         }
+        catch { }
         // Load morning
         try {
             execSync('launchctl load ~/Library/LaunchAgents/com.life-pulse.morning.plist', {
                 stdio: 'pipe', timeout: 5000,
             });
-            console.log(GRN('    morning brief: 7:30 AM daily'));
-        }
-        catch {
-            console.log(DIM('    launchctl load ~/Library/LaunchAgents/com.life-pulse.morning.plist'));
         }
+        catch { }
+        console.log(DIM('    always on'));
+        console.log(DIM('    morning brief at 7:30 AM'));
         markDone(state, 'daemon');
     }
     // ── Step 8: First Briefing ──
     stepHeader(8, 'First Briefing', isDone(state, 'briefing'));
     if (!isDone(state, 'briefing') && apiKey && process.stdin.isTTY) {
         console.log();
-        console.log(DIM('    running your first briefing live...'));
+        console.log();
+        console.log(DIM('    let\'s see what\'s going on...'));
         console.log();
         // Start a session for the briefing
         startSession();
         // Import and run the agent directly
         const { runAgent } = await import('./agent.js');
-        const { pickCard, renderSectionHeader, renderSection, renderHandled, RED: tRED, AMB: tAMB, CYN: tCYN, MAG: tMAG } = await import('./tui.js');
+        const { pickCard, renderSectionHeader, renderSection, renderHandled, HD: tHD, DIM: tDIM, MID: tMID } = await import('./tui.js');
         const { ProgressRenderer } = await import('./progress.js');
         const renderer = new ProgressRenderer();
         renderer.start();
@@ -367,23 +386,26 @@ export async function runInstaller(apiKey) {
         if (analysis.handled?.length)
             renderHandled(analysis.handled, 5);
         if (analysis.promises?.length) {
-            renderSectionHeader('PROMISES', tRED);
+            renderSectionHeader('promises', tHD);
         }
         if (analysis.alpha?.length) {
-            renderSection('ALPHA', analysis.alpha, '★', tMAG.bold, tMAG);
+            renderSection('alpha', analysis.alpha, '·', tHD, tMID);
         }
         markDone(state, 'briefing');
     }
     // ── Summary ──
     console.log();
-    console.log(chalk.bold.hex('#7AA2F7')('  Setup complete'));
+    console.log(HD('  You\'re all set.'));
     console.log();
-    if (state.funnelUrl) {
-        console.log(HD(`  Gateway: ${state.funnelUrl}/inbound`));
-        console.log(DIM('  Configure rply-mac-server to POST here'));
+    // Show active platform count
+    const finalStatus = await rply.status();
+    if (finalStatus) {
+        const active = finalStatus.platforms.filter(p => p.is_available && p.is_enabled);
+        if (active.length) {
+            console.log(DIM(`  ${active.map(p => p.display_name).join(', ')}`));
+        }
     }
-    console.log(DIM('  Daemon running — auto-restarts on crash'));
-    console.log(DIM('  Morning brief: 7:30 AM daily'));
-    console.log(DIM('  Run --check to verify, --status for stats'));
+    console.log(DIM('  running in the background'));
+    console.log(DIM('  you\'ll hear from me at 7:30 AM'));
     console.log();
 }

package/dist/knowledge.d.ts

@@ -16,7 +16,7 @@ export declare function loadKnowledge(contactName: string): string;
 /** Get the knowledge directory for a contact (creates if needed) */
 export declare function getKnowledgeDir(contactName: string): string;
 /** Regenerate auto knowledge for all CRM contacts */
-export declare function updateAutoKnowledge(crm: CRM): number;
+export declare function updateAutoKnowledge(crm: CRM): Promise<number>;
 interface ConversationTurn {
     role: 'user' | 'assistant';
     content: string;

package/dist/knowledge.js

@@ -14,6 +14,7 @@ import { homedir } from 'os';
 import { join } from 'path';
 import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, } from 'fs';
 import { openDb, safeQuery } from './db.js';
+import * as rply from './rply-client.js';
 const BASE = join(homedir(), '.life-pulse');
 const KNOWLEDGE_DIR = join(BASE, 'knowledge');
 const CONVERSATIONS_DIR = join(BASE, 'conversations');
@@ -93,8 +94,23 @@ function writeRelationship(dir, thread) {
         lines.push(`Waiting on them since ${thread.waitingSince}`);
     writeFileSync(join(dir, 'relationship.txt'), lines.join('\n'), 'utf-8');
 }
-/** Update recent-threads.txt from iMessage DB */
-function writeRecentThreads(dir, handle) {
+/** Update recent-threads.txt — RPLY first, SQLite fallback */
+async function writeRecentThreads(dir, handle) {
+    // ── RPLY path ──
+    if (await rply.isAvailable()) {
+        const msgs = await rply.listMessages(handle, { limit: MAX_RECENT_MSGS });
+        if (msgs?.data.length) {
+            const lines = msgs.data
+                .filter(m => m.content?.type === 'text' && m.content.text)
+                .reverse() // oldest first
+                .map(m => `${m.direction === 'sent' ? '→' : '←'} ${m.content.text.slice(0, 200)}`);
+            if (lines.length) {
+                writeFileSync(join(dir, 'recent-threads.txt'), lines.join('\n'), 'utf-8');
+                return;
+            }
+        }
+    }
+    // ── SQLite fallback ──
     const db = openDb(join(homedir(), 'Library/Messages/chat.db'));
     if (!db)
         return;
@@ -116,8 +132,8 @@ function writeRecentThreads(dir, handle) {
         if (!rows.length)
             return;
         const lines = rows.reverse().map(r => {
-            const dir = r.is_from_me ? '→' : '←';
-            return `${dir} ${(r.text || '').slice(0, 200)}`;
+            const d = r.is_from_me ? '→' : '←';
+            return `${d} ${(r.text || '').slice(0, 200)}`;
         });
         writeFileSync(join(dir, 'recent-threads.txt'), lines.join('\n'), 'utf-8');
     }
@@ -126,7 +142,7 @@ function writeRecentThreads(dir, handle) {
     }
 }
 /** Regenerate auto knowledge for all CRM contacts */
-export function updateAutoKnowledge(crm) {
+export async function updateAutoKnowledge(crm) {
     mkdirSync(KNOWLEDGE_DIR, { recursive: true });
     let count = 0;
     for (const thread of crm.threads) {
@@ -134,7 +150,7 @@ export function updateAutoKnowledge(crm) {
             continue;
         const dir = getKnowledgeDir(thread.name);
         writeRelationship(dir, thread);
-        writeRecentThreads(dir, thread.handle);
+        await writeRecentThreads(dir, thread.handle);
         count++;
     }
     return count;

package/dist/message-loop.js

@@ -129,7 +129,7 @@ function fetchNewMessages() {
     }
 }
 /** Resolve a handle to a contact name */
-function resolveHandle(handle) {
+async function resolveHandle(handle) {
     try {
         const profile = buildProfile();
         const lower = handle.toLowerCase();
@@ -141,7 +141,7 @@ function resolveHandle(handle) {
     catch { }
     // Fallback: use CRM for better resolution
     try {
-        const crm = buildCRM();
+        const crm = await buildCRM();
         for (const t of crm.threads) {
             if (t.handle === handle) {
                 const tier = t.msgs30d > 50 ? 'T1' : t.msgs30d > 15 ? 'T2' : t.msgs30d > 5 ? 'T3' : 'T4';
@@ -191,7 +191,7 @@ async function pollCycle(config) {
             skippedCount++;
             continue;
         }
-        const { name, tier } = resolveHandle(msg.handle);
+        const { name, tier } = await resolveHandle(msg.handle);
         // Only respond to configured tiers
         if (!config.respondTiers.includes(tier)) {
             processed.add(msg.rowid);

package/dist/progress.js

@@ -11,30 +11,30 @@ const STRUCTURE = chalk.hex('#3B3B3B');
 const OK = chalk.hex('#98C379');
 const FAIL = chalk.hex('#E06C75');
 const LABEL = {
-    search_all_messages: 'checking messages',
-    get_conversation: 'reading thread',
-    profile_contact: 'looking up contact',
-    get_messages: 'checking messages',
-    get_unanswered_messages: 'checking unreplied texts',
-    get_screen_time: 'checking screen time',
-    get_browsing: 'checking browsing',
-    get_calls: 'checking calls',
-    scan_sources: 'scanning',
-    lookup_contact: 'looking up contact',
-    get_email_summary: 'checking email',
-    get_git_activity: 'checking projects',
-    get_recent_files: 'checking recent files',
-    get_shell_history: 'checking history',
-    get_notes: 'reading notes',
-    get_claude_history: 'checking chats',
-    get_chatgpt_history: 'checking chats',
-    get_interests_for_plans: 'checking interests',
-    get_calendar: 'checking calendar',
-    get_reminders: 'checking reminders',
-    get_notifications: 'checking notifications',
-    discover_platforms: 'scanning apps',
-    generate_archetype: 'building profile',
-    search_emails: 'searching email',
+    search_all_messages: 'reading the room',
+    get_conversation: 'listening in',
+    profile_contact: 'learning who this is',
+    get_messages: 'reading the room',
+    get_unanswered_messages: 'finding what you missed',
+    get_screen_time: 'tracking your attention',
+    get_browsing: 'retracing your steps',
+    get_calls: 'checking who called',
+    scan_sources: 'pulling threads',
+    lookup_contact: 'learning who this is',
+    get_email_summary: 'going through your inbox',
+    get_git_activity: 'seeing what you shipped',
+    get_recent_files: 'noticing what you touched',
+    get_shell_history: 'retracing your steps',
+    get_notes: 'reading your thoughts',
+    get_claude_history: 'seeing what you asked',
+    get_chatgpt_history: 'seeing what you asked',
+    get_interests_for_plans: 'understanding your world',
+    get_calendar: 'looking at your day',
+    get_reminders: 'checking what you owe yourself',
+    get_notifications: 'catching up',
+    discover_platforms: 'figuring out your world',
+    generate_archetype: 'figuring out who you are',
+    search_emails: 'digging through mail',
 };
 const MAX_VISIBLE = 4;
 export class ProgressRenderer {

package/dist/router.js

@@ -146,7 +146,7 @@ const stats = {
     lastForwarded: null,
 };
 function log(msg) {
-    process.stderr.write(`  router: ${msg}\n`);
+    process.stderr.write(`  ${msg}\n`);
 }
 // ─── Poll Cycle ───────────────────────────────────────────────
 async function poll() {

package/dist/rply-client.d.ts

@@ -0,0 +1,98 @@
+/**
+ * RPLY API client — localhost:19851
+ *
+ * Unified messaging API. When available, replaces direct SQLite access
+ * to iMessage/chat.db, removing the Full Disk Access requirement.
+ */
+export interface RPLYConversation {
+    id: string;
+    title: string;
+    platform: string;
+    last_message_date: string;
+    unread_count: number;
+    is_group_chat: boolean;
+    is_never_reply: boolean;
+    is_dismissed: boolean;
+    priority?: string;
+    participants: RPLYParticipant[];
+    reply?: RPLYReply;
+    messages_load_state: string;
+}
+export interface RPLYParticipant {
+    display_name: string;
+    full_name: string;
+    identifier: string;
+    platform: string;
+}
+export interface RPLYReply {
+    id: string;
+    text: string;
+    original_text: string;
+    classification_reason: string;
+    reply_date: string;
+    was_edited: boolean;
+}
+export interface RPLYMessage {
+    direction: 'sent' | 'received';
+    date: string;
+    content: {
+        type: string;
+        text: string;
+    };
+    id?: string;
+}
+export interface RPLYContact {
+    display_name: string;
+    full_name: string;
+    identifier: string;
+    platform: string;
+}
+export interface RPLYSearchResult {
+    message: RPLYMessage & {
+        id: string;
+    };
+    conversation_id: string;
+}
+export interface RPLYStatus {
+    conversation_count: number;
+    version: string;
+    is_loading: boolean;
+    platforms: {
+        platform: string;
+        display_name: string;
+        is_available: boolean;
+        is_enabled: boolean;
+    }[];
+}
+interface Paginated<T> {
+    data: T[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export declare function isAvailable(): Promise<boolean>;
+export declare function resetCache(): void;
+export declare function status(): Promise<RPLYStatus | null>;
+export declare function listConversations(opts?: {
+    limit?: number;
+    offset?: number;
+    category?: string;
+    platform?: string;
+}): Promise<Paginated<RPLYConversation> | null>;
+export declare function getConversation(id: string): Promise<(RPLYConversation & {
+    messages: RPLYMessage[];
+}) | null>;
+export declare function listMessages(conversationId: string, opts?: {
+    limit?: number;
+    offset?: number;
+}): Promise<Paginated<RPLYMessage> | null>;
+export declare function searchConversations(q: string): Promise<RPLYConversation[] | null>;
+export declare function searchMessages(q: string, opts?: {
+    limit?: number;
+}): Promise<RPLYSearchResult[] | null>;
+export declare function listContacts(opts?: {
+    limit?: number;
+    offset?: number;
+}): Promise<Paginated<RPLYContact> | null>;
+export declare function searchContacts(q: string): Promise<RPLYContact[] | null>;
+export {};

package/dist/rply-client.js

@@ -0,0 +1,79 @@
+/**
+ * RPLY API client — localhost:19851
+ *
+ * Unified messaging API. When available, replaces direct SQLite access
+ * to iMessage/chat.db, removing the Full Disk Access requirement.
+ */
+const BASE = 'http://localhost:19851';
+const TIMEOUT = 5_000;
+// ─── Core ────────────────────────────────────────────────────
+let _available = null;
+async function get(path) {
+    try {
+        const r = await fetch(`${BASE}${path}`, { signal: AbortSignal.timeout(TIMEOUT) });
+        if (!r.ok)
+            return null;
+        return await r.json();
+    }
+    catch {
+        return null;
+    }
+}
+export async function isAvailable() {
+    if (_available !== null)
+        return _available;
+    const s = await get('/v1/status');
+    _available = s !== null && !s.is_loading;
+    return _available;
+}
+export function resetCache() { _available = null; }
+// ─── Endpoints ───────────────────────────────────────────────
+export async function status() {
+    return get('/v1/status');
+}
+export async function listConversations(opts) {
+    const p = new URLSearchParams();
+    if (opts?.limit)
+        p.set('limit', String(opts.limit));
+    if (opts?.offset)
+        p.set('offset', String(opts.offset));
+    if (opts?.category)
+        p.set('category', opts.category);
+    if (opts?.platform)
+        p.set('platform', opts.platform);
+    const qs = p.toString();
+    return get(`/v1/conversations${qs ? '?' + qs : ''}`);
+}
+export async function getConversation(id) {
+    return get(`/v1/conversations/${encodeURIComponent(id)}`);
+}
+export async function listMessages(conversationId, opts) {
+    const p = new URLSearchParams();
+    if (opts?.limit)
+        p.set('limit', String(opts.limit));
+    if (opts?.offset)
+        p.set('offset', String(opts.offset));
+    const qs = p.toString();
+    return get(`/v1/conversations/${encodeURIComponent(conversationId)}/messages${qs ? '?' + qs : ''}`);
+}
+export async function searchConversations(q) {
+    return get(`/v1/conversations/search?q=${encodeURIComponent(q)}`);
+}
+export async function searchMessages(q, opts) {
+    const p = new URLSearchParams({ q });
+    if (opts?.limit)
+        p.set('limit', String(opts.limit));
+    return get(`/v1/messages/search?${p}`);
+}
+export async function listContacts(opts) {
+    const p = new URLSearchParams();
+    if (opts?.limit)
+        p.set('limit', String(opts.limit));
+    if (opts?.offset)
+        p.set('offset', String(opts.offset));
+    const qs = p.toString();
+    return get(`/v1/contacts${qs ? '?' + qs : ''}`);
+}
+export async function searchContacts(q) {
+    return get(`/v1/contacts/search?q=${encodeURIComponent(q)}`);
+}

package/dist/sms-gateway.js

@@ -87,7 +87,7 @@ async function handleInbound(req, res, apiKey) {
     catch (err) {
         stats.errors++;
         const msg = err instanceof Error ? err.message : String(err);
-        process.stderr.write(`  gateway: error for ${contactName}: ${msg}\n`);
+        process.stderr.write(`  couldn't reply to ${contactName}\n`);
         respond(res, 500, { error: 'conversation failed' });
     }
 }
@@ -122,7 +122,7 @@ export function startGateway(apiKey) {
         respond(res, 404, { error: 'not found' });
     });
     server.listen(GATEWAY_PORT, '0.0.0.0', () => {
-        process.stderr.write(`  gateway: listening on :${GATEWAY_PORT}\n`);
+        // silent startup — no infrastructure noise
     });
     return {
         port: GATEWAY_PORT,