@poping/yome 0.0.4 → 0.0.6

package/dist/mesh/partykit-client.js

@@ -0,0 +1,195 @@
+// PartyKit WebSocket client.
+//
+// Port of Yome/Shared/Sync/PartyKitClient.swift to Node. Behaviour
+// matches the Swift client one-for-one so the Cloud sees no difference
+// between a macOS device, an iOS device, and a Linux box:
+//
+//   - URL shape: wss://{host}/parties/main/{roomId}?type=...&userId=...
+//                 &deviceId=...&token=...&locale=...
+//   - Keep-alive: WS ping every 30s; receive-loop drives `isConnected`.
+//   - Reconnect: exponential backoff capped at 30s, max 10 attempts,
+//                resets on successful receive.
+//   - All inbound messages emit `onMessage(text)`.
+//
+// Differs from Swift in:
+//   - Uses `ws` npm package (works on Node ≥18 without DOM).
+//   - Token is fetched lazily via the TicketCache so reconnects
+//     after the ticket expires automatically mint a new one.
+import WebSocket from 'ws';
+export class PartyKitClient {
+    opts;
+    ws = null;
+    isConnected = false;
+    reconnectAttempts = 0;
+    maxReconnectAttempts = 10;
+    reconnectTimer = null;
+    pingTimer = null;
+    intentionalClose = false;
+    listeners = new Set();
+    onConnectCb = null;
+    onDisconnectCb = null;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    onMessage(cb) {
+        this.listeners.add(cb);
+        return () => this.listeners.delete(cb);
+    }
+    onConnect(cb) { this.onConnectCb = cb; }
+    onDisconnect(cb) { this.onDisconnectCb = cb; }
+    async connect() {
+        this.intentionalClose = false;
+        this.reconnectAttempts = 0;
+        await this.establish();
+    }
+    disconnect() {
+        this.intentionalClose = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = null;
+        }
+        if (this.ws) {
+            try {
+                this.ws.close(1000, 'client-shutdown');
+            }
+            catch { /* ignore */ }
+            this.ws = null;
+        }
+        this.isConnected = false;
+    }
+    /** Throws if not connected. Caller chooses to await or fire-and-forget. */
+    async send(frame) {
+        const ws = this.ws;
+        if (!ws || ws.readyState !== WebSocket.OPEN) {
+            throw new Error('PartyKit not connected');
+        }
+        const text = typeof frame === 'string' ? frame : JSON.stringify(frame);
+        return new Promise((resolve, reject) => {
+            ws.send(text, (err) => err ? reject(err) : resolve());
+        });
+    }
+    get connected() {
+        return this.isConnected;
+    }
+    log(level, msg, meta) {
+        if (this.opts.log) {
+            this.opts.log(level, msg, meta);
+            return;
+        }
+        const line = meta ? `${msg} ${JSON.stringify(meta)}` : msg;
+        if (level === 'error')
+            console.error(`[mesh] ${line}`);
+        else if (level === 'warn')
+            console.warn(`[mesh] ${line}`);
+        else
+            console.log(`[mesh] ${line}`);
+    }
+    async establish() {
+        let ticket;
+        try {
+            ticket = await this.opts.ticketCache.get();
+        }
+        catch (err) {
+            this.log('error', 'Ticket mint failed; will retry', { err: err.message });
+            this.scheduleReconnect();
+            return;
+        }
+        const host = this.opts.partykitHostOverride ?? ticket.partykit_host;
+        const room = this.opts.roomIdOverride ?? ticket.userId;
+        const type = this.opts.clientType ?? 'desktop';
+        const locale = this.opts.locale ?? 'zh';
+        const url = `wss://${host}/parties/main/${encodeURIComponent(room)}` +
+            `?type=${encodeURIComponent(type)}` +
+            `&userId=${encodeURIComponent(ticket.userId)}` +
+            `&deviceId=${encodeURIComponent(ticket.deviceId)}` +
+            `&token=${encodeURIComponent(ticket.ws_token)}` +
+            `&locale=${encodeURIComponent(locale)}`;
+        const ws = this.opts.wsFactory ? this.opts.wsFactory(url) : new WebSocket(url);
+        this.ws = ws;
+        ws.on('open', () => {
+            this.log('info', 'WS open', { host, room });
+            this.isConnected = true;
+            this.reconnectAttempts = 0;
+            this.startPing();
+            this.onConnectCb?.();
+        });
+        ws.on('message', (raw) => {
+            // Per protocol the server always sends text frames; tolerate
+            // binary just in case (decode as utf-8).
+            const text = typeof raw === 'string'
+                ? raw
+                : Buffer.isBuffer(raw)
+                    ? raw.toString('utf-8')
+                    : Buffer.from(raw).toString('utf-8');
+            for (const cb of this.listeners) {
+                try {
+                    cb(text);
+                }
+                catch (err) {
+                    this.log('error', 'listener threw', { err: err.message });
+                }
+            }
+        });
+        ws.on('close', (code, reasonBuf) => {
+            this.log('warn', 'WS close', { code, reason: reasonBuf?.toString() ?? '' });
+            this.cleanupSocket();
+            if (!this.intentionalClose) {
+                // 4001 = invalid token (see Server/party/yome.ts). Invalidate the
+                // ticket cache before reconnecting so we re-mint a fresh one.
+                if (code === 4001)
+                    this.opts.ticketCache.invalidate();
+                this.scheduleReconnect();
+            }
+        });
+        ws.on('error', (err) => {
+            this.log('error', 'WS error', { err: err.message });
+            // Don't tear down here; the 'close' handler runs on its own and
+            // owns the reconnect path. ws guarantees 'close' fires after 'error'.
+        });
+    }
+    startPing() {
+        if (this.pingTimer)
+            clearInterval(this.pingTimer);
+        this.pingTimer = setInterval(() => {
+            const ws = this.ws;
+            if (!ws || ws.readyState !== WebSocket.OPEN)
+                return;
+            try {
+                ws.ping();
+            }
+            catch { /* ignore */ }
+        }, 30_000);
+    }
+    cleanupSocket() {
+        const wasConnected = this.isConnected;
+        this.isConnected = false;
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = null;
+        }
+        this.ws = null;
+        if (wasConnected)
+            this.onDisconnectCb?.();
+    }
+    scheduleReconnect() {
+        if (this.reconnectTimer)
+            return;
+        if (this.reconnectAttempts >= this.maxReconnectAttempts) {
+            this.log('error', 'Max reconnect attempts reached; giving up');
+            return;
+        }
+        this.reconnectAttempts += 1;
+        const delaySec = Math.min(Math.pow(2, this.reconnectAttempts), 30);
+        this.log('info', `Reconnecting in ${delaySec}s (attempt ${this.reconnectAttempts})`);
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            // Async fire-and-forget; errors flow back into ws 'error'/'close'.
+            void this.establish();
+        }, delaySec * 1000);
+    }
+}
+//# sourceMappingURL=partykit-client.js.map

package/dist/mesh/partykit-client.js.map

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

package/dist/mesh/rpc-handler.d.ts

@@ -0,0 +1,28 @@
+import type { PartyKitClient } from './partykit-client.js';
+export interface RpcHandlerOpts {
+    log?: (level: 'info' | 'warn' | 'error', msg: string, meta?: Record<string, unknown>) => void;
+}
+export declare class RpcHandler {
+    private client;
+    private opts;
+    private detach;
+    constructor(client: PartyKitClient, opts?: RpcHandlerOpts);
+    start(): void;
+    stop(): void;
+    private handleRequest;
+    private dispatch;
+    /**
+     * `bash exec --cmd="..."` or any other action where args.cmd is the
+     * shell line. We deliberately only honour --cmd (not raw `command`)
+     * to match the existing domain-RPC parser shape that other domains
+     * use; if cmd is absent we fall back to req.command.
+     */
+    private handleBash;
+    /**
+     * `fs <action> --path=... --content=...` minimal port of the same
+     * actions the macOS FileBridge exposes (Server/agent/commands/fsCommands.ts
+     * lists the canonical action set). Stage A: cat / ls / mkdir / write.
+     */
+    private handleFs;
+    private log;
+}

package/dist/mesh/rpc-handler.js

@@ -0,0 +1,201 @@
+// Dispatch incoming rpc:cal-request frames to local Linux tools and
+// send the result back as rpc:cal-response.
+//
+// Mirror of the macOS path in Yome/YomeApp.swift::BridgeMessage.request,
+// which routes by `parsed.domain` to a per-domain bridge. Here on Linux:
+//
+//   domain=bash → spawn /bin/sh and stream output
+//   domain=fs   → file system operations (mkdir / ls / cat / write)
+//
+// Stage A intentionally ships only 'bash' + 'fs' to prove the pipe.
+// Other domains (git / docker / k8s / systemd / pkg / log / svc / net)
+// are advertised as capabilities but currently return a friendly
+// "not implemented yet" so the Cloud agent can fall back gracefully.
+import { spawn } from 'child_process';
+import { promises as fsp } from 'fs';
+import { join, resolve as resolvePath, isAbsolute } from 'path';
+const BASH_TIMEOUT_MS = 60_000;
+const MAX_STDOUT_CHARS = 64_000;
+export class RpcHandler {
+    client;
+    opts;
+    detach = null;
+    constructor(client, opts = {}) {
+        this.client = client;
+        this.opts = opts;
+    }
+    start() {
+        this.detach = this.client.onMessage((frame) => {
+            let parsed;
+            try {
+                parsed = JSON.parse(frame);
+            }
+            catch {
+                return;
+            }
+            const obj = parsed;
+            if (obj?.type !== 'rpc:cal-request')
+                return;
+            const req = obj;
+            // Don't await: each RPC handled independently so a slow bash
+            // command doesn't block the receive loop.
+            void this.handleRequest(req);
+        });
+    }
+    stop() {
+        this.detach?.();
+        this.detach = null;
+    }
+    async handleRequest(req) {
+        this.log('info', 'rpc:cal-request', {
+            requestId: req.requestId, command: req.command, domain: req.parsed?.domain,
+        });
+        let result;
+        try {
+            result = await this.dispatch(req);
+        }
+        catch (err) {
+            result = { stdout: '', stderr: `[handler] ${err.message}`, exitCode: 1 };
+        }
+        // Cap stdout to avoid blowing past WS frame limits.
+        if (result.stdout.length > MAX_STDOUT_CHARS) {
+            result.stdout = result.stdout.slice(0, MAX_STDOUT_CHARS) + `\n[stdout capped at ${MAX_STDOUT_CHARS} chars]`;
+        }
+        const response = {
+            type: 'rpc:cal-response',
+            requestId: req.requestId,
+            stdout: result.stdout,
+            stderr: result.stderr,
+            exitCode: result.exitCode,
+        };
+        try {
+            await this.client.send(response);
+        }
+        catch (err) {
+            this.log('error', 'failed to send rpc response', { err: err.message });
+        }
+    }
+    async dispatch(req) {
+        const domain = req.parsed?.domain;
+        switch (domain) {
+            case 'bash':
+                return this.handleBash(req);
+            case 'fs':
+                return this.handleFs(req);
+            // Capabilities we advertise but haven't implemented yet:
+            case 'git':
+            case 'docker':
+            case 'k8s':
+            case 'systemd':
+            case 'pkg':
+            case 'log':
+            case 'net':
+            case 'svc':
+                return {
+                    stdout: '',
+                    stderr: `[mesh] domain '${domain}' not implemented on linux cli yet — falling back to bash via Cloud agent`,
+                    exitCode: 127,
+                };
+            default:
+                return {
+                    stdout: '',
+                    stderr: `[mesh] unknown domain: ${domain}`,
+                    exitCode: 127,
+                };
+        }
+    }
+    /**
+     * `bash exec --cmd="..."` or any other action where args.cmd is the
+     * shell line. We deliberately only honour --cmd (not raw `command`)
+     * to match the existing domain-RPC parser shape that other domains
+     * use; if cmd is absent we fall back to req.command.
+     */
+    handleBash(req) {
+        const shellLine = req.parsed?.args?.cmd ?? req.command ?? '';
+        if (!shellLine.trim()) {
+            return Promise.resolve({ stdout: '', stderr: '[bash] empty command', exitCode: 2 });
+        }
+        return new Promise((resolveP) => {
+            const proc = spawn('sh', ['-c', shellLine], { stdio: ['ignore', 'pipe', 'pipe'] });
+            let stdout = '';
+            let stderr = '';
+            let killed = false;
+            const timer = setTimeout(() => {
+                killed = true;
+                try {
+                    proc.kill('SIGTERM');
+                }
+                catch { /* ignore */ }
+            }, BASH_TIMEOUT_MS);
+            proc.stdout.on('data', (b) => { stdout += b.toString('utf-8'); });
+            proc.stderr.on('data', (b) => { stderr += b.toString('utf-8'); });
+            proc.on('close', (code) => {
+                clearTimeout(timer);
+                if (killed) {
+                    resolveP({ stdout, stderr: `[bash] timed out after ${BASH_TIMEOUT_MS / 1000}s`, exitCode: 124 });
+                }
+                else {
+                    resolveP({ stdout, stderr, exitCode: code ?? 1 });
+                }
+            });
+            proc.on('error', (err) => {
+                clearTimeout(timer);
+                resolveP({ stdout: '', stderr: `[bash] spawn error: ${err.message}`, exitCode: 1 });
+            });
+        });
+    }
+    /**
+     * `fs <action> --path=... --content=...` minimal port of the same
+     * actions the macOS FileBridge exposes (Server/agent/commands/fsCommands.ts
+     * lists the canonical action set). Stage A: cat / ls / mkdir / write.
+     */
+    async handleFs(req) {
+        const action = req.parsed?.action ?? '';
+        const args = req.parsed?.args ?? {};
+        const path = typeof args.path === 'string' ? args.path : '';
+        const safeJoinedPath = path && isAbsolute(path) ? path : resolvePath(process.cwd(), path);
+        try {
+            switch (action) {
+                case 'cat':
+                case 'read': {
+                    const content = await fsp.readFile(safeJoinedPath, 'utf-8');
+                    return { stdout: content, stderr: '', exitCode: 0 };
+                }
+                case 'ls': {
+                    const entries = await fsp.readdir(safeJoinedPath, { withFileTypes: true });
+                    const lines = entries.map((e) => `${e.isDirectory() ? 'd' : '-'} ${e.name}`);
+                    return { stdout: lines.join('\n'), stderr: '', exitCode: 0 };
+                }
+                case 'mkdir': {
+                    await fsp.mkdir(safeJoinedPath, { recursive: true });
+                    return { stdout: `created ${safeJoinedPath}`, stderr: '', exitCode: 0 };
+                }
+                case 'write': {
+                    const content = typeof args.content === 'string' ? args.content : '';
+                    await fsp.mkdir(join(safeJoinedPath, '..'), { recursive: true });
+                    await fsp.writeFile(safeJoinedPath, content, 'utf-8');
+                    return { stdout: `wrote ${content.length} bytes to ${safeJoinedPath}`, stderr: '', exitCode: 0 };
+                }
+                default:
+                    return { stdout: '', stderr: `[fs] unknown action: ${action}`, exitCode: 127 };
+            }
+        }
+        catch (err) {
+            return { stdout: '', stderr: `[fs] ${err.message}`, exitCode: 1 };
+        }
+    }
+    log(level, msg, meta) {
+        if (this.opts.log) {
+            this.opts.log(level, msg, meta);
+            return;
+        }
+        const line = meta ? `${msg} ${JSON.stringify(meta)}` : msg;
+        if (level === 'error')
+            console.error(`[rpc] ${line}`);
+        else if (level === 'warn')
+            console.warn(`[rpc] ${line}`);
+        else
+            console.log(`[rpc] ${line}`);
+    }
+}
+//# sourceMappingURL=rpc-handler.js.map

package/dist/mesh/rpc-handler.js.map

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

package/dist/mesh/thread-stream.d.ts

@@ -0,0 +1,109 @@
+import type { PartyKitClient } from './partykit-client.js';
+export type ThreadEvent = {
+    type: 'thread:sync';
+    threadId: string;
+} | {
+    type: 'thread:created';
+    threadId: string;
+    title?: string;
+} | {
+    type: 'thread:user-message';
+    threadId: string;
+    content: string;
+    imageURLs?: string[];
+} | {
+    type: 'agent:start';
+    runId: string;
+    agentType?: string;
+    sessionId?: string;
+    threadId?: string;
+} | {
+    type: 'agent:user-message';
+    runId: string;
+    content: string;
+    threadId?: string;
+} | {
+    type: 'agent:text-delta';
+    runId: string;
+    delta: string;
+    agentType?: string;
+    threadId?: string;
+} | {
+    type: 'agent:text-done';
+    runId: string;
+    fullText?: string;
+    threadId?: string;
+} | {
+    type: 'agent:tool-use';
+    runId: string;
+    toolUseId: string;
+    name: string;
+    input: Record<string, unknown>;
+    threadId?: string;
+} | {
+    type: 'agent:tool-result';
+    runId: string;
+    toolUseId: string;
+    exitCode: number;
+    result?: string;
+    threadId?: string;
+} | {
+    type: 'agent:done';
+    runId: string;
+    threadId?: string;
+} | {
+    type: 'agent:error';
+    runId: string;
+    message: string;
+    threadId?: string;
+} | {
+    type: 'agent:retry';
+    runId: string;
+    attempt?: number;
+    threadId?: string;
+} | {
+    type: 'agent:quota-exceeded';
+    runId: string;
+    reason: string;
+    threadId?: string;
+} | {
+    type: 'device-updated';
+    devices: Array<Record<string, unknown>>;
+} | {
+    type: string;
+    [k: string]: unknown;
+};
+export type ThreadEventHandler = (event: ThreadEvent) => void;
+export interface ThreadStreamOpts {
+    client: PartyKitClient;
+    /** Initial thread id (if resuming). Otherwise the first `thread:sync` wins. */
+    initialThreadId?: string;
+    log?: (level: 'info' | 'warn' | 'error', msg: string, meta?: Record<string, unknown>) => void;
+}
+export declare class ThreadStream {
+    private readonly client;
+    private readonly handlers;
+    private currentThreadId;
+    private unsubscribe;
+    private readonly log;
+    constructor(opts: ThreadStreamOpts);
+    /** Begin dispatching ws frames to subscribers. Safe to call multiple times. */
+    start(): void;
+    stop(): void;
+    /** Subscribe to all thread/agent events. Returns an unsubscribe fn. */
+    on(handler: ThreadEventHandler): () => void;
+    get threadId(): string | undefined;
+    /**
+     * Send a chat message as if it were typed in iOS / macOS Yome.app.
+     * The server treats the connection's authenticated userId as the
+     * sender; no extra identity bookkeeping needed here.
+     *
+     * If we don't yet have a threadId, omit it: the server will create or
+     * resolve the default thread, then broadcast `thread:sync` which we
+     * latch onto in handleFrame.
+     */
+    sendUserMessage(content: string, opts?: {
+        threadTitle?: string;
+    }): Promise<void>;
+    private handleFrame;
+}

package/dist/mesh/thread-stream.js

@@ -0,0 +1,110 @@
+// Thread event stream — typed wrapper over PartyKitClient for the TUI.
+//
+// PartyKit broadcasts the canonical thread/agent event protocol (see
+// Server/party/yome.ts handleUserMessage + YomeAgentRuntime). This
+// module is the read/write surface the TUI uses to participate as a
+// thin client, identical to how iOS / macOS Yome.app participate:
+//
+//   incoming (subscribe):
+//     thread:sync            { threadId }
+//     thread:created         { threadId, title }
+//     thread:user-message    { threadId, content, imageURLs?, ... }
+//     agent:start            { runId, agentType, sessionId? }
+//     agent:user-message     { runId, content }
+//     agent:text-delta       { runId, delta, agentType }
+//     agent:text-done        { runId, fullText? }
+//     agent:tool-use         { runId, toolUseId, name, input }
+//     agent:tool-result      { runId, toolUseId, exitCode, result? }
+//     agent:done             { runId }
+//     agent:error            { runId, message }
+//     agent:retry            { runId, attempt }
+//     agent:quota-exceeded   { runId, reason, ... }
+//     device-updated         { devices: [...] }
+//
+//   outgoing (publish):
+//     { type: 'message', content, threadId?, ... }   // user types a line
+//
+// The cli stays Stage A's bash/fs RPC executor _while also_ being a
+// chat client — both directions share the same WS via PartyKitClient,
+// because that's exactly how iOS Yome.app does it.
+export class ThreadStream {
+    client;
+    handlers = new Set();
+    currentThreadId;
+    unsubscribe = null;
+    log;
+    constructor(opts) {
+        this.client = opts.client;
+        this.currentThreadId = opts.initialThreadId;
+        this.log = opts.log ?? (() => { });
+    }
+    /** Begin dispatching ws frames to subscribers. Safe to call multiple times. */
+    start() {
+        if (this.unsubscribe)
+            return;
+        this.unsubscribe = this.client.onMessage((frame) => this.handleFrame(frame));
+    }
+    stop() {
+        this.unsubscribe?.();
+        this.unsubscribe = null;
+        this.handlers.clear();
+    }
+    /** Subscribe to all thread/agent events. Returns an unsubscribe fn. */
+    on(handler) {
+        this.handlers.add(handler);
+        return () => this.handlers.delete(handler);
+    }
+    get threadId() {
+        return this.currentThreadId;
+    }
+    /**
+     * Send a chat message as if it were typed in iOS / macOS Yome.app.
+     * The server treats the connection's authenticated userId as the
+     * sender; no extra identity bookkeeping needed here.
+     *
+     * If we don't yet have a threadId, omit it: the server will create or
+     * resolve the default thread, then broadcast `thread:sync` which we
+     * latch onto in handleFrame.
+     */
+    async sendUserMessage(content, opts) {
+        const frame = {
+            type: 'message',
+            content,
+        };
+        if (this.currentThreadId)
+            frame.threadId = this.currentThreadId;
+        if (opts?.threadTitle)
+            frame.threadTitle = opts.threadTitle;
+        await this.client.send(frame);
+    }
+    handleFrame(text) {
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            // Non-JSON frames (e.g. ping/pong text) — ignore.
+            return;
+        }
+        if (!parsed || typeof parsed !== 'object' || typeof parsed.type !== 'string')
+            return;
+        // Latch threadId from the first authoritative server frame so the
+        // next user message round-trips cleanly even before the user
+        // explicitly switches threads.
+        if (parsed.type === 'thread:sync' && typeof parsed.threadId === 'string') {
+            this.currentThreadId = parsed.threadId;
+        }
+        if (parsed.type === 'thread:created' && !this.currentThreadId && typeof parsed.threadId === 'string') {
+            this.currentThreadId = parsed.threadId;
+        }
+        for (const h of this.handlers) {
+            try {
+                h(parsed);
+            }
+            catch (err) {
+                this.log('error', 'ThreadStream handler threw', { err: err.message });
+            }
+        }
+    }
+}
+//# sourceMappingURL=thread-stream.js.map