@siftd/connect-agent 0.2.33 → 0.2.34

package/dist/agent.js

@@ -5,6 +5,7 @@ import { MasterOrchestrator } from './orchestrator.js';
 import { AgentWebSocket } from './websocket.js';
 import { startHeartbeat, stopHeartbeat, getHeartbeatState } from './heartbeat.js';
 import { loadHubContext, readScratchpad } from './core/hub.js';
+import { PRODUCT_FULL_NAME } from './branding.js';
 import { startPreviewWorker, stopPreviewWorker } from './core/preview-worker.js';
 // Strip ANSI escape codes for clean output
 function stripAnsi(str) {
@@ -218,7 +219,7 @@ export async function runAgent(pollInterval = 2000) {
     const mode = orchestrator ? 'ORCHESTRATOR' : 'SIMPLE RELAY';
     const deployment = getDeploymentInfo();
     console.log('╔══════════════════════════════════════════════════╗');
-    console.log('║  Connect Agent - Master Orchestrator              ║');
+    console.log(`║  ${PRODUCT_FULL_NAME.padEnd(47)}║`);
     console.log(`║  Mode: ${mode.padEnd(41)}║`);
     console.log(`║  Deployment: ${deployment.mode.toUpperCase().padEnd(35)}║`);
     console.log('╚══════════════════════════════════════════════════╝\n');

package/dist/branding.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Lia Branding Configuration
+ *
+ * Central source of truth for product naming, paths, and URLs.
+ * Update this file to change branding across the agent.
+ */
+export declare const PRODUCT_NAME = "Lia";
+export declare const PRODUCT_FULL_NAME = "Lia by Siftd";
+export declare const COMPANY_NAME = "Siftd";
+export declare const PACKAGE_NAME = "@siftd/connect-agent";
+export declare const DOMAIN = "siftd.app";
+export declare const LIA_URL = "https://lia.siftd.app";
+export declare const HUB_URL = "https://hub.siftd.app";
+export declare const LIA_HUB_DIR = "Lia-Hub";
+export declare const SYSTEM_HUB_DIR = ".connect-hub";
+export declare const HUB_FILES: {
+    readonly AGENTS: "AGENTS.md";
+    readonly CLAUDE: "CLAUDE.md";
+    readonly LANDMARKS: "LANDMARKS.md";
+    readonly MISTAKES: "MISTAKES.md";
+    readonly SCRATCHPAD: "notebook-a/SCRATCHPAD.md";
+    readonly WORKER_LOG: "notebook-a/WORKER-LOG.md";
+    readonly OUTPUTS: "shared/outputs/";
+};
+export declare const CLI_BANNER = "\n\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557\n\u2551  Lia by Siftd                                     \u2551\n\u2551  Your AI assistant powered by Claude             \u2551\n\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D\n";
+export declare const CLI_BANNER_SLIM = "Lia Agent";
+export declare const PRODUCT_DESCRIPTION = "Refined Memory, Context-management, and tool use so you can trust your agents. Lia just knows what you want to do.";
+export declare const IDENTITY: {
+    readonly name: "Lia";
+    readonly role: "personal AI assistant";
+    readonly personality: "warm, helpful, and proactive";
+    readonly capabilities: readonly ["memory and context management", "task delegation to workers", "web search and research", "file and code operations via workers", "scheduling and reminders"];
+};
+/**
+ * Get user workspace path
+ * On VM: /data/{sanitized_email}/
+ * Local: ~/Lia-Hub/
+ */
+export declare function getUserWorkspacePath(userId?: string): string;
+/**
+ * Get hub path for current user
+ */
+export declare function getHubPath(): string;
+/**
+ * Get system hub path (legacy, for migration)
+ */
+export declare function getSystemHubPath(): string;

package/dist/branding.js

@@ -0,0 +1,80 @@
+/**
+ * Lia Branding Configuration
+ *
+ * Central source of truth for product naming, paths, and URLs.
+ * Update this file to change branding across the agent.
+ */
+// Product names
+export const PRODUCT_NAME = 'Lia';
+export const PRODUCT_FULL_NAME = 'Lia by Siftd';
+export const COMPANY_NAME = 'Siftd';
+export const PACKAGE_NAME = '@siftd/connect-agent'; // Keep for npm compatibility
+// URLs
+export const DOMAIN = 'siftd.app';
+export const LIA_URL = 'https://lia.siftd.app';
+export const HUB_URL = 'https://hub.siftd.app'; // Future
+// Hub paths (per-user workspace)
+export const LIA_HUB_DIR = 'Lia-Hub'; // ~/Lia-Hub/
+export const SYSTEM_HUB_DIR = '.connect-hub'; // ~/.connect-hub/ (legacy, read-only for migration)
+// Hub files
+export const HUB_FILES = {
+    AGENTS: 'AGENTS.md',
+    CLAUDE: 'CLAUDE.md',
+    LANDMARKS: 'LANDMARKS.md',
+    MISTAKES: 'MISTAKES.md',
+    SCRATCHPAD: 'notebook-a/SCRATCHPAD.md',
+    WORKER_LOG: 'notebook-a/WORKER-LOG.md',
+    OUTPUTS: 'shared/outputs/',
+};
+// Banner and CLI display
+export const CLI_BANNER = `
+╔══════════════════════════════════════════════════╗
+║  ${PRODUCT_FULL_NAME}                                     ║
+║  Your AI assistant powered by Claude             ║
+╚══════════════════════════════════════════════════╝
+`;
+export const CLI_BANNER_SLIM = `${PRODUCT_NAME} Agent`;
+// User-facing descriptions
+export const PRODUCT_DESCRIPTION = 'Refined Memory, Context-management, and tool use so you can trust your agents. Lia just knows what you want to do.';
+// Agent identity keywords (for SYSTEM_PROMPT)
+export const IDENTITY = {
+    name: PRODUCT_NAME,
+    role: 'personal AI assistant',
+    personality: 'warm, helpful, and proactive',
+    capabilities: [
+        'memory and context management',
+        'task delegation to workers',
+        'web search and research',
+        'file and code operations via workers',
+        'scheduling and reminders',
+    ],
+};
+/**
+ * Get user workspace path
+ * On VM: /data/{sanitized_email}/
+ * Local: ~/Lia-Hub/
+ */
+export function getUserWorkspacePath(userId) {
+    const home = process.env.HOME || '/tmp';
+    // VM mode - workspace is set via HOME env var by vm-manager
+    // The vm-manager sets HOME to /data/{email}/
+    if (process.env.CONNECT_SERVER_URL && process.env.CONNECT_USER_ID) {
+        return home; // Already set to user-specific directory
+    }
+    // Local mode - use Lia-Hub in home directory
+    return `${home}/${LIA_HUB_DIR}`;
+}
+/**
+ * Get hub path for current user
+ */
+export function getHubPath() {
+    const home = process.env.HOME || '/tmp';
+    return `${home}/${LIA_HUB_DIR}`;
+}
+/**
+ * Get system hub path (legacy, for migration)
+ */
+export function getSystemHubPath() {
+    const home = process.env.HOME || '/tmp';
+    return `${home}/${SYSTEM_HUB_DIR}`;
+}

package/dist/cli.js

@@ -5,13 +5,14 @@ import { getServerUrl, setServerUrl, setAgentToken, setUserId, setAnthropicApiKe
 import { connectWithPairingCode, checkConnection } from './api.js';
 import { runAgent } from './agent.js';
 import { ensureLiaHub, getLiaHubPaths } from './core/hub.js';
+import { PRODUCT_FULL_NAME } from './branding.js';
 program
-    .name('connect-agent')
-    .description('Local agent for Connect web app')
+    .name('lia-agent')
+    .description(`${PRODUCT_FULL_NAME} - Personal AI assistant agent`)
     .version('0.1.0');
 program
     .command('pair')
-    .description('Pair with Connect web app using a pairing code')
+    .description('Pair with Lia using a pairing code')
     .argument('<code>', 'The 6-character pairing code from the web app')
     .option('-s, --server <url>', 'Server URL', getServerUrl())
     .option('-k, --api-key <key>', 'Anthropic API key for orchestrator mode')
@@ -52,7 +53,7 @@ program
     .option('-i, --interval <ms>', 'Poll interval in milliseconds', '2000')
     .action(async (options) => {
     if (!isConfigured()) {
-        console.error('Agent not configured. Run "connect-agent pair <code>" first.');
+        console.error('Agent not configured. Run "lia-agent pair <code>" first.');
         process.exit(1);
     }
     const spinner = ora('Checking connection...').start();
@@ -76,7 +77,7 @@ program
     .command('status')
     .description('Show agent configuration status')
     .action(async () => {
-    console.log('Connect Agent Status\n');
+    console.log(`${PRODUCT_FULL_NAME} - Status\n`);
     console.log(`Config file: ${getConfigPath()}`);
     console.log(`Server URL: ${getServerUrl()}`);
     console.log(`Configured: ${isConfigured() ? 'Yes' : 'No'}`);

package/dist/heartbeat.d.ts

@@ -1,7 +1,7 @@
 /**
  * Runner Heartbeat Module
  *
- * Sends periodic heartbeats to the Connect server to maintain presence.
+ * Sends periodic heartbeats to the Lia server to maintain presence.
  * This is what makes a runner "connected" - NOT the pairing token.
  *
  * Both local and VM runners use this same module.

package/dist/heartbeat.js

@@ -1,7 +1,7 @@
 /**
  * Runner Heartbeat Module
  *
- * Sends periodic heartbeats to the Connect server to maintain presence.
+ * Sends periodic heartbeats to the Lia server to maintain presence.
  * This is what makes a runner "connected" - NOT the pairing token.
  *
  * Both local and VM runners use this same module.

package/dist/orchestrator.js

@@ -61,96 +61,59 @@ function getFileType(path) {
         return 'text';
     return 'other';
 }
-const SYSTEM_PROMPT = `You are a MASTER ORCHESTRATOR - NOT a worker. You delegate ALL file/code work to Claude Code CLI workers.
+const SYSTEM_PROMPT = `You are Lia, a personal AI assistant by Siftd. You orchestrate work through Claude Code workers while maintaining memory and context.
 
-CRITICAL IDENTITY:
-- You are the BRAIN, not the hands
-- You ORCHESTRATE workers - you don't do the work yourself
-- You REMEMBER everything using your memory tools
-- You PLAN and COORDINATE, then delegate execution
+YOUR IDENTITY:
+- Name: Lia (by Siftd)
+- Role: Personal AI assistant with memory and orchestration
+- Style: Warm, helpful, proactive - you remember things and anticipate needs
+- Architecture: You orchestrate workers (Claude Code CLI) to do file/code work
 
-STRICT TOOL USAGE RULES:
+HOW YOU WORK:
+You are the orchestrator, not the executor. You coordinate and remember while workers do the hands-on work.
 
-✅ USE bash ONLY for READ-ONLY operations:
+TOOL RULES:
+
+✅ bash - READ-ONLY operations only:
 - ls, pwd, cat, head, tail, find, which, echo, date
 - git status, git log, git diff (viewing only)
 - Checking if files/directories exist
 
-❌ NEVER use bash for:
-- Creating files (echo >, touch, mkdir)
-- Editing files (sed, awk, tee)
-- Moving/copying/deleting (mv, cp, rm)
-- Installing packages (npm install, pip install)
+❌ bash - NEVER use for:
+- Creating/editing/deleting files
+- Installing packages
 - Running builds or tests
-- ANY file modification whatsoever
 
-✅ USE delegate_to_worker or spawn_worker for:
-- Creating, editing, or deleting ANY files
+✅ delegate_to_worker / spawn_worker - ALL file operations:
+- Creating, editing, deleting files
 - Running npm/pip/cargo install
 - Building, testing, deploying
-- Complex multi-step tasks
-- ANY filesystem modification
-
-MEMORY IS MANDATORY:
-- ALWAYS use search_memory before starting work
-- ALWAYS use remember after significant actions
-- Log your orchestration decisions to memory
-- Learn from failures - remember what went wrong
-
-WORKER ORCHESTRATION:
-- spawn_worker: For parallel/background tasks (non-blocking)
-- delegate_to_worker: For sequential tasks needing full autonomy
-- ALWAYS include logging instructions in worker prompts
-- Tell workers to save their logs to /tmp/worker-{job_id}.log
+- Any filesystem modification
 
-AFTER EVERY SIGNIFICANT ACTION:
-1. Log it to memory with remember
-2. Note what worked or failed
-3. Update your understanding of the user's system
-
-WHO YOU ARE:
-Warm, helpful orchestrator. You coordinate, remember, and delegate. You're the persistent layer that makes AI feel personal - but you do it by managing workers, not by doing tasks yourself.
+MEMORY:
+- Search memory before starting work (context is valuable)
+- Remember important things after significant actions
+- Learn from failures - what went wrong, how to avoid it
 
 YOUR HUB: ~/Lia-Hub/
-You have a personal hub at ~/Lia-Hub/ for organizing your work:
-
-- **~/Lia-Hub/AGENTS.md** - Your identity and capabilities
-- **~/Lia-Hub/CLAUDE.md** - User's custom instructions (always follow these)
-- **~/Lia-Hub/LANDMARKS.md** - Current state, active projects, blockers
-- **~/Lia-Hub/MISTAKES.md** - Lessons learned (append, never delete)
-- **~/Lia-Hub/notebook-a/SCRATCHPAD.md** - Your working notes, plans, thoughts
-- **~/Lia-Hub/notebook-a/WORKER-LOG.md** - Track all workers you spawn
-- **~/Lia-Hub/shared/outputs/** - Where workers save their outputs
+- **CLAUDE.md** - User's instructions (always follow these)
+- **LANDMARKS.md** - Current state and context
+- **MISTAKES.md** - Lessons learned
+- **notebook-a/SCRATCHPAD.md** - Your working notes
+- **shared/outputs/** - Where workers save files
 
-ASSET PREVIEWS & GALLERY:
-The Connect web UI has a built-in gallery that shows worker outputs automatically.
+ASSET PREVIEWS:
+The Lia interface has a built-in gallery that shows worker outputs automatically.
 ⛔ NEVER use start_local_server or open_browser for previews
-⛔ NEVER ask workers to start servers on localhost
-⛔ NEVER open localhost URLs - they won't work for remote users
-✅ Workers write files to ~/Lia-Hub/shared/outputs/
-✅ Gallery displays assets in-app as workers complete
-✅ Use open_browser ONLY for external websites (not localhost)
+⛔ NEVER open localhost URLs - they don't work for cloud users
+✅ Workers write to ~/Lia-Hub/shared/outputs/
+✅ Gallery displays assets in-app automatically
 
-BEFORE STARTING COMPLEX WORK:
-1. Check CLAUDE.md for user instructions
-2. Read LANDMARKS.md for current context
-3. Check MISTAKES.md for lessons learned
-4. Write your plan to SCRATCHPAD.md
-5. Search memory for relevant context
+WORKFLOW:
+Before complex work: Check CLAUDE.md → Read LANDMARKS.md → Search memory
+After completing work: Update LANDMARKS.md → Remember learnings
 
-AFTER COMPLETING WORK:
-1. Update LANDMARKS.md with new state
-2. Log any mistakes to MISTAKES.md
-3. Clear completed items from SCRATCHPAD.md
-4. Remember important learnings
-
-SLASH COMMANDS:
-- /reset - Clear conversation and memory context
-- /mode - Show current mode and capabilities
-- /memory - Show memory stats
-- /help - Show available commands
-
-You ACT through workers. You REMEMBER through memory. You NEVER do file operations directly.`;
+You orchestrate through workers. You remember through memory. You never do file operations directly.`;
 export class MasterOrchestrator {
     client;
     model;
@@ -853,7 +816,7 @@ Be specific about what you want done.`,
             },
             {
                 name: 'open_browser',
-                description: 'Open a URL in the user\'s default browser. ⚠️ ONLY for external websites (https://). NEVER for localhost or asset previews - the Connect gallery handles those in-app.',
+                description: 'Open a URL in the user\'s default browser. ⚠️ ONLY for external websites (https://). NEVER for localhost or asset previews - the Lia gallery handles those in-app.',
                 input_schema: {
                     type: 'object',
                     properties: {
@@ -867,7 +830,7 @@ Be specific about what you want done.`,
             },
             {
                 name: 'start_local_server',
-                description: '⚠️ DEPRECATED for previews. The Connect gallery shows worker outputs in-app. Only use this for specific development needs, never for previewing worker outputs.',
+                description: '⚠️ DEPRECATED for previews. The Lia gallery shows worker outputs in-app. Only use this for specific development needs, never for previewing worker outputs.',
                 input_schema: {
                     type: 'object',
                     properties: {
@@ -979,7 +942,18 @@ Be specific about what you want done.`,
                     result = { success: false, output: `Unknown tool: ${toolUse.name}` };
             }
             // Anthropic API requires content to be non-empty when is_error is true
-            const content = result.output || result.error || 'Unknown error';
+            // Belt-and-suspenders: ensure content is NEVER empty
+            let content = result.output || '';
+            if (!content && result.error) {
+                content = result.error;
+            }
+            if (!content) {
+                content = result.success ? 'Tool completed successfully.' : 'Tool failed with unknown error.';
+            }
+            // Final safety check - should never trigger but prevents API errors
+            if (typeof content !== 'string' || content.length === 0) {
+                content = 'Unexpected empty result';
+            }
             results.push({
                 type: 'tool_result',
                 tool_use_id: toolUse.id,
@@ -1301,7 +1275,7 @@ Be specific about what you want done.`,
                 console.log(`[ORCHESTRATOR] Blocked localhost URL: ${url}`);
                 return {
                     success: false,
-                    output: `⛔ BLOCKED: Cannot open localhost URLs. The Connect gallery displays worker outputs in-app automatically. Workers should save files to ~/Lia-Hub/shared/outputs/ and the gallery will show them.`
+                    output: `⛔ BLOCKED: Cannot open localhost URLs. The Lia gallery displays worker outputs in-app automatically. Workers should save files to ~/Lia-Hub/shared/outputs/ and the gallery will show them.`
                 };
             }
             // Use 'open' on macOS, 'xdg-open' on Linux, 'start' on Windows
@@ -1338,7 +1312,7 @@ Be specific about what you want done.`,
                 if (existing) {
                     return {
                         success: true,
-                        output: `⚠️ Note: For previewing worker outputs, the Connect gallery shows them in-app automatically. Server already running on port ${port}.`
+                        output: `⚠️ Note: For previewing worker outputs, the Lia gallery shows them in-app automatically. Server already running on port ${port}.`
                     };
                 }
             }
@@ -1360,7 +1334,7 @@ Be specific about what you want done.`,
                 console.log(`[ORCHESTRATOR] Started server on port ${port} for ${directory}`);
                 return {
                     success: true,
-                    output: `Started HTTP server on port ${port}. ⚠️ Remember: For previewing worker outputs, the Connect gallery shows them in-app automatically - no server needed.`
+                    output: `Started HTTP server on port ${port}. ⚠️ Remember: For previewing worker outputs, the Lia gallery shows them in-app automatically - no server needed.`
                 };
             }
             catch {

package/dist/prompts/worker-system.d.ts

@@ -8,7 +8,7 @@
  * Core worker identity and rules
  * This is the foundation every worker receives
  */
-export declare const WORKER_IDENTITY = "## Worker Identity\nYou are a Claude Code CLI worker executing a delegated task.\nYou report to the Master Orchestrator.\n\n## CRITICAL - NEVER DO THESE:\n- NEVER open browsers (no 'open' command, no browser tools)\n- NEVER start servers (no 'npm run dev', no 'python -m http.server', etc.)\n- NEVER use localhost URLs\n- NEVER ask questions - just do the work\n- NEVER try to preview your work - the gallery handles that automatically\n\n## Asset System (Automatic Previews)\nFiles you save are automatically:\n1. Detected by the preview worker\n2. Thumbnailed (images) and metadata extracted\n3. Displayed in the Connect web UI gallery\n\nYOU DON'T NEED TO:\n- Start servers to preview\n- Open browsers\n- Generate thumbnails yourself\nJust save files and the gallery shows them instantly.\n\n## What You SHOULD Do:\n1. Create/edit files as needed\n2. Save outputs to the shared workspace\n3. Report file paths you create at the end\n4. Be concise and efficient";
+export declare const WORKER_IDENTITY = "## Worker Identity\nYou are a Claude Code CLI worker executing a delegated task.\nYou report to the Master Orchestrator.\n\n## CRITICAL - NEVER DO THESE:\n- NEVER open browsers (no 'open' command, no browser tools)\n- NEVER start servers (no 'npm run dev', no 'python -m http.server', etc.)\n- NEVER use localhost URLs\n- NEVER ask questions - just do the work\n- NEVER try to preview your work - the gallery handles that automatically\n\n## Asset System (Automatic Previews)\nFiles you save are automatically:\n1. Detected by the preview worker\n2. Thumbnailed (images) and metadata extracted\n3. Displayed in the Lia gallery\n\nYOU DON'T NEED TO:\n- Start servers to preview\n- Open browsers\n- Generate thumbnails yourself\nJust save files and the gallery shows them instantly.\n\n## What You SHOULD Do:\n1. Create/edit files as needed\n2. Save outputs to the shared workspace\n3. Report file paths you create at the end\n4. Be concise and efficient";
 /**
  * Output format workers should follow
  */

package/dist/prompts/worker-system.js

@@ -24,7 +24,7 @@ You report to the Master Orchestrator.
 Files you save are automatically:
 1. Detected by the preview worker
 2. Thumbnailed (images) and metadata extracted
-3. Displayed in the Connect web UI gallery
+3. Displayed in the Lia gallery
 
 YOU DON'T NEED TO:
 - Start servers to preview

package/dist/tools/web.js

@@ -113,7 +113,7 @@ export class WebTools {
             // Parse HTML if needed - basic extraction without cheerio dependency
             if (contentType.includes('text/html')) {
                 // Extract text content from HTML
-                let mainContent = text
+                const mainContent = text
                     // Remove script and style tags
                     .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, '')
                     .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, '')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@siftd/connect-agent",
-  "version": "0.2.33",
+  "version": "0.2.34",
   "description": "Master orchestrator agent - control Claude Code remotely via web",
   "type": "module",
   "main": "dist/index.js",