@siftd/connect-agent 0.2.50 → 0.2.52

package/dist/orchestrator.d.ts

@@ -49,6 +49,7 @@ export declare class MasterOrchestrator {
     private client;
     private model;
     private maxTokens;
+    private toolMaxTokens;
     private memory;
     private contextGraph;
     private orgMemory?;
@@ -202,11 +203,13 @@ export declare class MasterOrchestrator {
     private getLocalTimeZone;
     private getTodoCalSystemPrompt;
     private getToolChoice;
+    private recordUsage;
     private withAttachments;
     private updateFileScope;
     private getTeamFilesDir;
     private getFileScopeOverrides;
     private rewriteFilesAlias;
+    private resolveFilesWritePath;
     private getFileScopeSystemNote;
     /**
      * Check if verbose mode is enabled

package/dist/orchestrator.js

@@ -6,8 +6,8 @@
  */
 import Anthropic from '@anthropic-ai/sdk';
 import { spawn, execSync } from 'child_process';
-import { existsSync, readFileSync } from 'fs';
-import { join } from 'path';
+import { existsSync, readFileSync, mkdirSync, writeFileSync, appendFileSync } from 'fs';
+import { join, resolve, dirname, sep } from 'path';
 import { AdvancedMemoryStore } from './core/memory-advanced.js';
 import { PostgresMemoryStore, isPostgresConfigured } from './core/memory-postgres.js';
 import { TaskScheduler } from './core/scheduler.js';
@@ -22,6 +22,35 @@ import { getKnowledgeForPrompt } from './genesis/index.js';
 import { loadHubContext, formatHubContext, logAction, logWorker, getSharedOutputPath } from './core/hub.js';
 import { buildWorkerPrompt } from './prompts/worker-system.js';
 import { LiaTaskQueue } from './core/task-queue.js';
+const DEFAULT_CLAUDE_MODEL = 'claude-opus-4-5-20251101';
+const DEFAULT_TOOL_MAX_TOKENS = 1024;
+function readBooleanEnv(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    return !['0', 'false', 'no', 'off'].includes(value.trim().toLowerCase());
+}
+function resolveClaudeModel() {
+    const raw = (process.env.LIA_MODEL || process.env.ANTHROPIC_MODEL || DEFAULT_CLAUDE_MODEL).trim();
+    if (!raw)
+        return DEFAULT_CLAUDE_MODEL;
+    if (readBooleanEnv(process.env.LIA_FORCE_OPUS, true) && raw !== DEFAULT_CLAUDE_MODEL) {
+        return DEFAULT_CLAUDE_MODEL;
+    }
+    return raw;
+}
+function resolveClaudeBudgetUsd() {
+    const raw = process.env.LIA_MAX_BUDGET_USD || process.env.CLAUDE_MAX_BUDGET_USD;
+    if (!raw)
+        return null;
+    const trimmed = raw.trim();
+    return trimmed ? trimmed : null;
+}
+function resolveToolMaxTokens() {
+    const raw = Number(process.env.LIA_TOOL_MAX_TOKENS);
+    if (Number.isFinite(raw) && raw >= 256)
+        return Math.min(raw, 4096);
+    return DEFAULT_TOOL_MAX_TOKENS;
+}
 /**
  * Extract file paths from worker output
  * Workers naturally mention files they create: "Created /tmp/foo.html", "Saved to /path/file"
@@ -103,7 +132,8 @@ TOOL RULES:
 - Installing packages
 - Running builds or tests
 
-✅ delegate_to_worker / spawn_worker - ALL file operations:
+✅ files_write for simple /files writes
+✅ delegate_to_worker / spawn_worker - complex file operations:
 - Creating, editing, deleting files
 - Running npm/pip/cargo install
 - Building, testing, deploying
@@ -142,6 +172,7 @@ FILES BROWSER:
 Users can type /files to open the Finder UI (cloud mode).
 When asked to browse or locate files, point them to /files.
 Refer to /files instead of internal Lia-Hub paths in responses.
+When users ask you to create or update a file in /files, use files_write.
 
 FILES SCOPES:
 - "My Files" are private to the user (default /files view)
@@ -186,7 +217,7 @@ WORKFLOW:
 Before complex work: Check CLAUDE.md → Read LANDMARKS.md → Search memory
 After completing work: Update LANDMARKS.md → Remember learnings
 
-You orchestrate through workers. You remember through memory. You never do arbitrary file operations directly (calendar_upsert_events and todo_upsert_items are the safe exceptions).`;
+You orchestrate through workers. You remember through memory. You never do arbitrary file operations directly (calendar_upsert_events, todo_upsert_items, and files_write are the safe exceptions).`;
 const TODO_CAL_SYSTEM_PROMPT_BASE = `You are Lia. Your ONLY job is to update /todo and /cal using tools.
 
 Rules:
@@ -201,6 +232,7 @@ export class MasterOrchestrator {
     client;
     model;
     maxTokens;
+    toolMaxTokens;
     memory;
     contextGraph;
     orgMemory;
@@ -242,8 +274,14 @@ export class MasterOrchestrator {
     todoUpdateCallback;
     constructor(options) {
         this.client = new Anthropic({ apiKey: options.apiKey });
-        this.model = options.model || process.env.ANTHROPIC_MODEL || 'claude-opus-4-5-20251101';
+        const requestedModel = options.model?.trim();
+        this.model = requestedModel
+            ? (readBooleanEnv(process.env.LIA_FORCE_OPUS, true) && requestedModel !== DEFAULT_CLAUDE_MODEL
+                ? DEFAULT_CLAUDE_MODEL
+                : requestedModel)
+            : resolveClaudeModel();
         this.maxTokens = options.maxTokens || 4096;
+        this.toolMaxTokens = resolveToolMaxTokens();
         this.userId = options.userId;
         this.orgId = options.orgId;
         this.orgRole = options.orgRole;
@@ -696,7 +734,7 @@ export class MasterOrchestrator {
     }
     hasCalendarMutation(message) {
         const lower = this.stripTodoSnapshot(message).toLowerCase();
-        const target = /(^|\s)\/cal\b|\/calendar\b|\bcalendar\b/.test(lower);
+        const target = /(^|\s)\/cal\b|\/calendar\b|\bcalendar\b|\bcal\b/.test(lower);
         const action = /\b(add|create|schedule|book|move|reschedule|update|change|cancel|delete|remove)\b/.test(lower);
         const query = /\b(what|show|list|open|view|see)\b/.test(lower);
         return target && action && !query;
@@ -783,10 +821,36 @@ export class MasterOrchestrator {
             return { type: 'tool', name: 'calendar_upsert_events' };
         }
         if (wantsFiles) {
-            return { type: 'tool', name: 'delegate_to_worker' };
+            return { type: 'tool', name: 'files_write' };
         }
         return undefined;
     }
+    recordUsage(response, meta) {
+        const usage = response.usage;
+        if (!usage)
+            return;
+        try {
+            const usageDir = join(getSharedOutputPath(), '.lia');
+            mkdirSync(usageDir, { recursive: true });
+            const entry = {
+                ts: new Date().toISOString(),
+                model: this.model,
+                input_tokens: usage.input_tokens,
+                output_tokens: usage.output_tokens,
+                cache_creation_input_tokens: usage.cache_creation_input_tokens,
+                cache_read_input_tokens: usage.cache_read_input_tokens,
+                tool_choice: meta.toolChoice || null,
+                iterations: meta.iterations,
+                messages: meta.messages,
+                stop_reason: response.stop_reason || null,
+                response_id: response.id || null,
+            };
+            appendFileSync(join(usageDir, 'usage.jsonl'), `${JSON.stringify(entry)}\n`, 'utf8');
+        }
+        catch (error) {
+            console.warn('[ORCHESTRATOR] Usage log failed:', error);
+        }
+    }
     withAttachments(task, context) {
         if (!this.attachmentContext)
             return { task, context };
@@ -849,6 +913,22 @@ export class MasterOrchestrator {
             return `${targetDir}${suffix}`;
         });
     }
+    resolveFilesWritePath(rawPath) {
+        const trimmed = rawPath.trim();
+        if (!trimmed)
+            throw new Error('File path is required');
+        const teamDir = this.currentFileScope === 'team' ? this.getTeamFilesDir() : null;
+        const baseDir = teamDir || getSharedOutputPath();
+        const normalized = this.rewriteFilesAlias(trimmed);
+        const relative = normalized.replace(/^\/+/, '');
+        const candidate = normalized.startsWith(baseDir) ? normalized : join(baseDir, relative);
+        const resolved = resolve(candidate);
+        const baseResolved = resolve(baseDir);
+        if (resolved !== baseResolved && !resolved.startsWith(`${baseResolved}${sep}`)) {
+            throw new Error('Invalid file path');
+        }
+        return resolved;
+    }
     getFileScopeSystemNote() {
         if (this.currentFileScope !== 'team')
             return null;
@@ -889,25 +969,6 @@ export class MasterOrchestrator {
                 this.attachmentContext = null;
             }
         }
-        const wantsFiles = this.hasFileMutation(message);
-        if (wantsFiles) {
-            this.attachmentContext = this.extractAttachmentContext(message);
-            const { task } = this.withAttachments(message);
-            const normalizedTask = this.rewriteFilesAlias(task);
-            const fileScope = this.getFileScopeOverrides();
-            const scopedTask = fileScope.instructions ? `${fileScope.instructions}\n\n${normalizedTask}` : normalizedTask;
-            try {
-                await this.delegateToWorker(scopedTask, undefined, fileScope.workingDir, fileScope.instructions);
-                return 'Working on it. Check /files shortly.';
-            }
-            catch (error) {
-                const errorMessage = error instanceof Error ? error.message : String(error);
-                return `Error: ${errorMessage}`;
-            }
-            finally {
-                this.attachmentContext = null;
-            }
-        }
         // DISABLED: Dumb regex extraction was creating garbage todos
         // Let the AI use calendar_upsert_events and todo_upsert_items tools properly
         // const quickWrite = this.tryHandleCalendarTodo(message);
@@ -1386,12 +1447,13 @@ ${hubContextStr}
         while (iterations < maxIterations) {
             iterations++;
             const toolChoice = forcedToolChoice ?? this.getToolChoice(currentMessages);
+            const requestMaxTokens = wantsTodoOrCal ? this.toolMaxTokens : this.maxTokens;
             const requestStart = Date.now();
             console.log(`[ORCHESTRATOR] Anthropic request ${iterations}/${maxIterations} (model: ${this.model})`);
             const response = await Promise.race([
                 this.client.messages.create({
                     model: this.model,
-                    max_tokens: this.maxTokens,
+                    max_tokens: requestMaxTokens,
                     system,
                     tools,
                     messages: currentMessages,
@@ -1404,6 +1466,11 @@ ${hubContextStr}
                 })
             ]);
             console.log(`[ORCHESTRATOR] Anthropic response ${iterations}/${maxIterations} in ${Date.now() - requestStart}ms`);
+            this.recordUsage(response, {
+                iterations,
+                messages: currentMessages.length,
+                toolChoice: toolChoice?.name
+            });
             // Check if done
             if (response.stop_reason === 'end_turn' || !this.hasToolUse(response.content)) {
                 if (forcedToolChoice && !retriedForcedTool) {
@@ -1412,7 +1479,9 @@ ${hubContextStr}
                     const needsNoWorkers = toolName === 'todo_upsert_items' || toolName === 'calendar_upsert_events';
                     const followup = needsNoWorkers
                         ? `You must call the ${toolName} tool now. Use the exact task/event titles and any bracketed tags exactly as provided. Do not spawn workers.`
-                        : `You must call the ${toolName} tool now. Use the user's request as the task details.`;
+                        : toolName === 'files_write'
+                            ? 'You must call the files_write tool now. Provide the file path under /files and the full content.'
+                            : `You must call the ${toolName} tool now. Use the user's request as the task details.`;
                     currentMessages = [
                         ...currentMessages,
                         { role: 'assistant', content: response.content },
@@ -1573,6 +1642,26 @@ and preserve explicit due dates and priority from the user.`,
                     required: ['items']
                 }
             },
+            {
+                name: 'files_write',
+                description: `Create or overwrite a file in /files.
+
+Only write to /files (shared outputs). Use a filename or /files/path/to/file.ext.`,
+                input_schema: {
+                    type: 'object',
+                    properties: {
+                        path: {
+                            type: 'string',
+                            description: 'Target file path (e.g. /files/report.txt or report.txt)'
+                        },
+                        content: {
+                            type: 'string',
+                            description: 'File contents to write'
+                        }
+                    },
+                    required: ['path', 'content']
+                }
+            },
             // Web tools
             {
                 name: 'web_search',
@@ -2115,6 +2204,22 @@ Unlike lia_plan (internal only), this creates a VISIBLE todo list that appears i
                             result = this.calendarTools.upsertTodoItems(taggedItems);
                         }
                         break;
+                    case 'files_write':
+                        {
+                            try {
+                                const pathValue = String(input.path || '').trim();
+                                const content = String(input.content || '');
+                                const targetPath = this.resolveFilesWritePath(pathValue);
+                                mkdirSync(dirname(targetPath), { recursive: true });
+                                writeFileSync(targetPath, content, 'utf8');
+                                result = { success: true, output: 'Saved file to /files.' };
+                            }
+                            catch (error) {
+                                const message = error instanceof Error ? error.message : String(error);
+                                result = { success: false, output: '', error: message };
+                            }
+                        }
+                        break;
                     case 'web_search':
                         result = await this.webTools.webSearch(input.query, { numResults: input.num_results });
                         break;
@@ -2310,7 +2415,9 @@ Unlike lia_plan (internal only), this creates a VISIBLE todo list that appears i
         };
         // Escape single quotes in prompt for shell safety
         const escapedPrompt = prompt.replace(/'/g, "'\\''");
-        const claudeCmd = `${this.claudePath} -p '${escapedPrompt}' --output-format text --dangerously-skip-permissions`;
+        const budget = resolveClaudeBudgetUsd();
+        const budgetArg = budget ? ` --max-budget-usd ${budget}` : '';
+        const claudeCmd = `${this.claudePath} -p '${escapedPrompt}' --output-format text --dangerously-skip-permissions --model ${this.model}${budgetArg}`;
         const isRoot = process.getuid?.() === 0;
         const shellCmd = isRoot
             ? `runuser -u lia -m -- /bin/bash -l -c "${claudeCmd.replace(/"/g, '\\"')}"`

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

@@ -12,7 +12,7 @@ export declare const WORKER_IDENTITY = "## Worker Identity\nYou are a Claude Cod
 /**
  * Output format workers should follow
  */
-export declare const WORKER_OUTPUT_FORMAT = "## Output Format\nWhen done, clearly list:\n- Files created: /path/to/file.ext\n- Files modified: /path/to/file.ext\n- Key findings: brief summary\n\nBe concise. Execute efficiently.";
+export declare const WORKER_OUTPUT_FORMAT = "## Output Format\nWhen done, clearly list:\n- Files created: /path/to/file.ext\n- Files modified: /path/to/file.ext\n- Key findings: 1-3 short bullets\n\nBe concise. Do not restate the task.";
 /**
  * Instructions for workers to contribute back to memory
  * Workers can add to orchestrator's memory using these patterns

package/dist/prompts/worker-system.js

@@ -44,9 +44,9 @@ export const WORKER_OUTPUT_FORMAT = `## Output Format
 When done, clearly list:
 - Files created: /path/to/file.ext
 - Files modified: /path/to/file.ext
-- Key findings: brief summary
+- Key findings: 1-3 short bullets
 
-Be concise. Execute efficiently.`;
+Be concise. Do not restate the task.`;
 /**
  * Instructions for workers to contribute back to memory
  * Workers can add to orchestrator's memory using these patterns
@@ -71,6 +71,15 @@ Share data with other workers:
  */
 export function getWorkerLoggingInstructions(jobId) {
     const logFile = `/tmp/worker-${jobId}-log.txt`;
+    const verbose = process.env.LIA_WORKER_VERBOSE === '1';
+    if (!verbose) {
+        return `## Progress & Logging
+- Keep output minimal; report only key steps and final results
+
+REQUIRED - Log Export:
+At the END of your work, create a final log file at: ${logFile}
+Include: job_id=${jobId}, timestamp, summary of work done, files modified, key findings.`;
+    }
     return `## Progress & Logging
 - Output findings as you go, don't wait until the end
 - Print discoveries and insights immediately as you find them

package/dist/workers/manager.js

@@ -48,6 +48,28 @@ function getFileType(ext) {
         return 'text';
     return 'other';
 }
+const DEFAULT_CLAUDE_MODEL = 'claude-opus-4-5-20251101';
+function readBooleanEnv(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    return !['0', 'false', 'no', 'off'].includes(value.trim().toLowerCase());
+}
+function resolveClaudeModel() {
+    const raw = (process.env.LIA_MODEL || process.env.ANTHROPIC_MODEL || DEFAULT_CLAUDE_MODEL).trim();
+    if (!raw)
+        return DEFAULT_CLAUDE_MODEL;
+    if (readBooleanEnv(process.env.LIA_FORCE_OPUS, true) && raw !== DEFAULT_CLAUDE_MODEL) {
+        return DEFAULT_CLAUDE_MODEL;
+    }
+    return raw;
+}
+function resolveClaudeBudgetUsd() {
+    const raw = process.env.LIA_MAX_BUDGET_USD || process.env.CLAUDE_MAX_BUDGET_USD;
+    if (!raw)
+        return null;
+    const trimmed = raw.trim();
+    return trimmed ? trimmed : null;
+}
 export class WorkerManager {
     config;
     activeWorkers = new Map();
@@ -166,22 +188,30 @@ export class WorkerManager {
         try {
             // Add checkpoint and logging instructions to prevent data loss
             const logFile = `/tmp/worker-${jobId}-log.txt`;
-            const enhancedTask = `${task}
-
-IMPORTANT - Progress & Logging:
+            const verbose = process.env.LIA_WORKER_VERBOSE === '1';
+            const loggingBlock = verbose
+                ? `IMPORTANT - Progress & Logging:
 - Output findings as you go, don't wait until the end
 - Print discoveries and insights immediately as you find them
 - Report on each file/step before moving to the next
-- Do NOT open browsers or start servers - just create files and report paths
+- Do NOT open browsers or start servers - just create files and report paths`
+                : `IMPORTANT - Progress & Logging:
+- Keep output minimal; report only key steps and final results
+- Do NOT open browsers or start servers - just create files and report paths`;
+            const enhancedTask = `${task}
+
+${loggingBlock}
 
 REQUIRED - Log Export:
 At the END of your work, create a final log file at: ${logFile}
-Include: job_id=${jobId}, timestamp, summary of work done, files modified, key findings.
-This ensures nothing is lost even if your output gets truncated.`;
+Include: job_id=${jobId}, timestamp, summary of work done, files modified, key findings.`;
             // Escape single quotes in task for shell safety
             const escapedTask = enhancedTask.replace(/'/g, "'\\''");
             // Build the claude command
-            const claudeCmd = `claude -p '${escapedTask}' --output-format text --dangerously-skip-permissions`;
+            const model = resolveClaudeModel();
+            const budget = resolveClaudeBudgetUsd();
+            const budgetArg = budget ? ` --max-budget-usd ${budget}` : '';
+            const claudeCmd = `claude -p '${escapedTask}' --output-format text --dangerously-skip-permissions --model ${model}${budgetArg}`;
             // If running as root, run workers as 'lia' user to avoid --dangerously-skip-permissions being blocked
             // The Claude CLI blocks this flag for root users as a security measure
             const isRoot = process.getuid?.() === 0;

package/package.json

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