@tinyclaw/plugin-channel-friends 1.1.0-staging.df9eaf8 → 2.0.0-dev.31dac1b

package/dist/index.js

@@ -19,13 +19,13 @@
  *
  * userId format: "friend:<username>"
  */
-import { readFileSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { logger } from '@tinyclaw/logger';
-import { InviteStore } from './store.js';
-import { createFriendsTools, FRIENDS_ENABLED_CONFIG_KEY, FRIENDS_PORT_CONFIG_KEY, FRIENDS_PLUGIN_ID, } from './tools.js';
 import { createFriendsServer } from './server.js';
+import { InviteStore } from './store.js';
+import { createFriendsTools, FRIENDS_ENABLED_CONFIG_KEY, FRIENDS_PLUGIN_ID, FRIENDS_PORT_CONFIG_KEY, } from './tools.js';
 // Resolve the directory of this source file for static asset paths
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -42,6 +42,7 @@ const friendsPlugin = {
     description: 'Invite-based web chat for friends — powered by FRIENDS.md',
     type: 'channel',
     version: '0.1.0',
+    channelPrefix: 'friend',
     getPairingTools(_secrets, configManager) {
         // Initialize the store early so pairing tools work before start()
         if (!store) {
@@ -87,6 +88,29 @@ const friendsPlugin = {
         await friendsServer.start();
         logger.info(`Friends chat available at http://${host}:${port}/chat`);
     },
+    async sendToUser(userId, message) {
+        if (!friendsServer) {
+            throw new Error('Friends server is not running');
+        }
+        // Parse username from the prefixed format "friend:<username>"
+        const username = userId.replace(/^friend:/, '');
+        if (!username) {
+            throw new Error(`Invalid Friends userId: ${userId}`);
+        }
+        const delivered = friendsServer.pushToUser(username, {
+            type: 'nudge',
+            content: message.content,
+            source: message.source,
+            priority: message.priority,
+            timestamp: new Date().toISOString(),
+        });
+        if (!delivered) {
+            logger.warn(`Friends: user "${username}" has no active push connections`);
+        }
+        else {
+            logger.info(`Friends: sent outbound message to ${userId}`);
+        }
+    },
     async stop() {
         if (friendsServer) {
             friendsServer.stop();

package/dist/server.d.ts

@@ -24,6 +24,11 @@ interface FriendsServerConfig {
 export declare function createFriendsServer(config: FriendsServerConfig): {
     start(): Promise<void>;
     stop(): void;
+    /**
+     * Push an outbound message to all connected SSE clients for a username.
+     * Returns true if at least one client received the message.
+     */
+    pushToUser(username: string, data: Record<string, unknown>): boolean;
     getPort(): number;
 };
 export {};

package/dist/server.js

@@ -66,8 +66,9 @@ function authenticateFriend(request, store) {
 }
 export function createFriendsServer(config) {
     const { port, host, store, chatHtml, onMessage, onMessageStream } = config;
-    const secure = config.secure ?? (process.env.NODE_ENV === 'production');
+    const secure = config.secure ?? process.env.NODE_ENV === 'production';
     const textEncoder = new TextEncoder();
+    const pushClients = new Map();
     let server = null;
     return {
         async start() {
@@ -168,6 +169,49 @@ export function createFriendsServer(config) {
                         store.updateNickname(friend.username, newNickname);
                         return jsonResponse({ ok: true, nickname: newNickname });
                     }
+                    // ─── Push SSE stream (outbound notifications) ──────────
+                    if (pathname === '/api/push' && request.method === 'GET') {
+                        const friend = authenticateFriend(request, store);
+                        if (!friend) {
+                            return jsonResponse({ error: 'Unauthorized' }, 401);
+                        }
+                        const username = friend.username;
+                        const stream = new ReadableStream({
+                            start(controller) {
+                                const pushClient = { controller, encoder: textEncoder };
+                                if (!pushClients.has(username)) {
+                                    pushClients.set(username, new Set());
+                                }
+                                const clients = pushClients.get(username);
+                                clients.add(pushClient);
+                                // Heartbeat to keep connection alive
+                                const heartbeat = setInterval(() => {
+                                    try {
+                                        controller.enqueue(textEncoder.encode(': heartbeat\n\n'));
+                                    }
+                                    catch {
+                                        clearInterval(heartbeat);
+                                        pushClients.get(username)?.delete(pushClient);
+                                    }
+                                }, 15_000);
+                                // Clean up on abort
+                                request.signal.addEventListener('abort', () => {
+                                    clearInterval(heartbeat);
+                                    pushClients.get(username)?.delete(pushClient);
+                                    if (pushClients.get(username)?.size === 0) {
+                                        pushClients.delete(username);
+                                    }
+                                });
+                            },
+                        });
+                        return new Response(stream, {
+                            headers: {
+                                'Content-Type': 'text/event-stream',
+                                'Cache-Control': 'no-cache',
+                                Connection: 'keep-alive',
+                            },
+                        });
+                    }
                     // ─── Chat API (message) ─────────────────────────────────
                     if (pathname === '/api/chat' && request.method === 'POST') {
                         const friend = authenticateFriend(request, store);
@@ -211,9 +255,7 @@ export function createFriendsServer(config) {
                                         if (isClosed)
                                             return;
                                         try {
-                                            const data = typeof payload === 'string'
-                                                ? payload
-                                                : JSON.stringify(payload);
+                                            const data = typeof payload === 'string' ? payload : JSON.stringify(payload);
                                             controller.enqueue(textEncoder.encode(`data: ${data}\n\n`));
                                             if (typeof payload === 'object' &&
                                                 payload &&
@@ -283,9 +325,34 @@ export function createFriendsServer(config) {
             if (server) {
                 server.stop();
                 server = null;
+                // Clean up all push clients
+                pushClients.clear();
                 logger.info('Friends chat server stopped');
             }
         },
+        /**
+         * Push an outbound message to all connected SSE clients for a username.
+         * Returns true if at least one client received the message.
+         */
+        pushToUser(username, data) {
+            const clients = pushClients.get(username);
+            if (!clients || clients.size === 0)
+                return false;
+            const payload = `data: ${JSON.stringify(data)}\n\n`;
+            const dead = [];
+            for (const pc of clients) {
+                try {
+                    pc.controller.enqueue(pc.encoder.encode(payload));
+                }
+                catch {
+                    dead.push(pc);
+                }
+            }
+            for (const dc of dead) {
+                clients.delete(dc);
+            }
+            return clients.size > 0 || dead.length < clients.size + dead.length;
+        },
         getPort() {
             return server?.port || port;
         },

package/dist/store.js

@@ -131,13 +131,19 @@ export class InviteStore {
             return null;
         const newCode = generateInviteCode();
         // New code, clear session so they must re-authenticate
-        this.db.run(`UPDATE friends SET invite_code = ?, session_token = NULL WHERE username = ?`, [newCode, sanitized]);
+        this.db.run(`UPDATE friends SET invite_code = ?, session_token = NULL WHERE username = ?`, [
+            newCode,
+            sanitized,
+        ]);
         return newCode;
     }
     /** Update a friend's nickname. */
     updateNickname(username, newNickname) {
         const sanitized = username.toLowerCase().replace(/[^a-z0-9_]/g, '_');
-        const result = this.db.run(`UPDATE friends SET nickname = ? WHERE username = ?`, [newNickname, sanitized]);
+        const result = this.db.run(`UPDATE friends SET nickname = ? WHERE username = ?`, [
+            newNickname,
+            sanitized,
+        ]);
         return result.changes > 0;
     }
     /** Touch last_seen timestamp. */
@@ -162,9 +168,7 @@ export class InviteStore {
     /** Check if a username already exists. */
     exists(username) {
         const sanitized = username.toLowerCase().replace(/[^a-z0-9_]/g, '_');
-        const row = this.db
-            .query(`SELECT 1 FROM friends WHERE username = ?`)
-            .get(sanitized);
+        const row = this.db.query(`SELECT 1 FROM friends WHERE username = ?`).get(sanitized);
         return row !== null;
     }
     rowToFriend(row) {

package/dist/tools.d.ts

@@ -7,8 +7,8 @@
  *
  * All tools are owner-only (checked by the agent loop's authority system).
  */
-import type { Tool, ConfigManagerInterface } from '@tinyclaw/types';
-import { InviteStore } from './store.js';
+import type { ConfigManagerInterface, Tool } from '@tinyclaw/types';
+import type { InviteStore } from './store.js';
 /** Config key for the enabled flag. */
 export declare const FRIENDS_ENABLED_CONFIG_KEY = "channels.friends.enabled";
 /** Config key for the plugin server port. */

package/dist/tools.js

@@ -104,7 +104,7 @@ export function createFriendsTools(store, configManager) {
         },
         {
             name: 'friends_chat_revoke',
-            description: 'Revoke a friend\'s access to the Friends Web Chat. ' +
+            description: "Revoke a friend's access to the Friends Web Chat. " +
                 'Their session and any pending invite code are invalidated immediately. ' +
                 'To restore access later, use friends_chat_reinvite.',
             parameters: {
@@ -148,13 +148,11 @@ export function createFriendsTools(store, configManager) {
                     return 'No friends registered yet. Use friends_chat_invite to invite someone.';
                 }
                 const lines = friends.map((f) => {
-                    const status = f.sessionToken
-                        ? 'active'
-                        : f.inviteCode
-                            ? 'invite pending'
-                            : 'revoked';
+                    const status = f.sessionToken ? 'active' : f.inviteCode ? 'invite pending' : 'revoked';
                     const lastSeenDate = new Date(f.lastSeen);
-                    const lastSeen = f.lastSeen && !isNaN(lastSeenDate.getTime()) ? lastSeenDate.toLocaleString() : 'Unknown';
+                    const lastSeen = f.lastSeen && !Number.isNaN(lastSeenDate.getTime())
+                        ? lastSeenDate.toLocaleString()
+                        : 'Unknown';
                     return `- **${f.nickname}** (@${f.username}) — ${status}, last seen: ${lastSeen}`;
                 });
                 return `**Registered Friends (${friends.length})**\n\n${lines.join('\n')}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinyclaw/plugin-channel-friends",
-  "version": "1.1.0-staging.df9eaf8",
+  "version": "2.0.0-dev.31dac1b",
   "description": "Friends web chat channel plugin for Tiny Claw",
   "license": "GPL-3.0",
   "author": "Waren Gonzaga",