clementine-agent 1.18.2 → 1.18.4

package/dist/agent/assistant.js

@@ -13,7 +13,11 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { query as rawQuery, listSubagents, getSubagentMessages, SYSTEM_PROMPT_DYNAMIC_BOUNDARY, } from '@anthropic-ai/claude-agent-sdk';
 import pino from 'pino';
-import { BASE_DIR, PKG_DIR, VAULT_DIR, DAILY_NOTES_DIR, SOUL_FILE, AGENTS_FILE, MEMORY_FILE, AGENTS_DIR, ASSISTANT_NAME, OWNER_NAME, MODEL, MODELS, HEARTBEAT_MAX_TURNS, SEARCH_CONTEXT_LIMIT, SEARCH_RECENCY_LIMIT, SYSTEM_PROMPT_MAX_CONTEXT_CHARS, SESSION_EXCHANGE_HISTORY_SIZE, SESSION_EXCHANGE_MAX_CHARS, INJECTED_CONTEXT_MAX_CHARS, UNLEASHED_PHASE_TURNS, UNLEASHED_DEFAULT_MAX_HOURS, UNLEASHED_MAX_PHASES, PROJECTS_META_FILE, CRON_PROGRESS_DIR, CRON_REFLECTIONS_DIR, HANDOFFS_DIR, BUDGET, TASK_BUDGET_TOKENS, IDENTITY_FILE, CLAUDE_CODE_OAUTH_TOKEN, ANTHROPIC_API_KEY as CONFIG_ANTHROPIC_API_KEY, } from '../config.js';
+import { BASE_DIR, PKG_DIR, VAULT_DIR, DAILY_NOTES_DIR, SOUL_FILE, AGENTS_FILE, MEMORY_FILE, AGENTS_DIR, ASSISTANT_NAME, OWNER_NAME, MODEL, MODELS, HEARTBEAT_MAX_TURNS, SEARCH_CONTEXT_LIMIT, SEARCH_RECENCY_LIMIT, SYSTEM_PROMPT_MAX_CONTEXT_CHARS, SESSION_EXCHANGE_HISTORY_SIZE, SESSION_EXCHANGE_MAX_CHARS, INJECTED_CONTEXT_MAX_CHARS, UNLEASHED_PHASE_TURNS, UNLEASHED_DEFAULT_MAX_HOURS, UNLEASHED_MAX_PHASES, PROJECTS_META_FILE, CRON_PROGRESS_DIR, CRON_REFLECTIONS_DIR, HANDOFFS_DIR, BUDGET, TASK_BUDGET_TOKENS, IDENTITY_FILE, CLAUDE_CODE_OAUTH_TOKEN, ANTHROPIC_API_KEY as CONFIG_ANTHROPIC_API_KEY, envSnapshot, } from '../config.js';
+import { summarizeIntegrationStatus } from '../config/integrations-registry.js';
+import { loadToolPreferences, computeAvailability, buildPromptInstruction, buildComposioStatusBlock, } from '../integrations/tool-preferences.js';
+import { loadClaudeIntegrations } from './mcp-bridge.js';
+import { detectFrustrationSignals, detectRepeatedTopics } from './insight-engine.js';
 import { DEFAULT_CHANNEL_CAPABILITIES } from '../types.js';
 import { enforceToolPermissions, getSecurityPrompt, getHeartbeatSecurityPrompt, getCronSecurityPrompt, getHeartbeatDisallowedTools, logToolUse, setProfileTier, setProfileAllowedTools, setAgentDir, setSendPolicy, setInteractionSource, logAuditJsonl, } from './hooks.js';
 import { scanner } from '../security/scanner.js';
@@ -1558,8 +1562,6 @@ You have a cost budget per message — not a hard turn limit. Work until the tas
         // Integration status — changes as owner adds credentials.
         if (!isAutonomous) {
             try {
-                const { summarizeIntegrationStatus } = require('../config/integrations-registry.js');
-                const { envSnapshot } = require('../config.js');
                 const summary = summarizeIntegrationStatus(envSnapshot());
                 if (summary)
                     volatileParts.push(`## Integration Status\n\n${summary}\n\nCall \`integration_status\`, \`list_integrations\`, or \`setup_integration\` for details.`);
@@ -1578,8 +1580,6 @@ You have a cost budget per message — not a hard turn limit. Work until the tas
         // every turn regardless.
         if (!isAutonomous) {
             try {
-                const { loadToolPreferences, computeAvailability, buildPromptInstruction, buildComposioStatusBlock } = require('../integrations/tool-preferences.js');
-                const { loadClaudeIntegrations } = require('./mcp-bridge.js');
                 const composioSet = new Set(composioConnectedSlugs);
                 const cdIntegrations = loadClaudeIntegrations();
                 const cdActive = new Set(Object.values(cdIntegrations).filter(i => i.connected).map(i => i.name));
@@ -1605,7 +1605,6 @@ You have a cost budget per message — not a hard turn limit. Work until the tas
         // one signal fires — keeps the prompt clean during normal sessions.
         if (!isAutonomous) {
             try {
-                const { detectFrustrationSignals, detectRepeatedTopics } = require('./insight-engine.js');
                 const since24h = new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString();
                 const since7d = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString();
                 let recent = this.getRecentActivity(since24h, 50);

package/dist/config/effective-config.js

@@ -25,6 +25,8 @@ const SPECS = [
     { key: 'HAIKU_MODEL', group: 'models', jsonPath: 'models.haiku', default: 'claude-haiku-4-5-20251001' },
     { key: 'SONNET_MODEL', group: 'models', jsonPath: 'models.sonnet', default: 'claude-sonnet-4-6' },
     { key: 'OPUS_MODEL', group: 'models', jsonPath: 'models.opus', default: 'claude-opus-4-7' },
+    // Team routing
+    { key: 'AUTO_DELEGATE_ENABLED', group: 'team', default: false },
     // Budgets
     { key: 'BUDGET_HEARTBEAT_USD', group: 'budgets', jsonPath: 'budgets.heartbeat', default: 0.50 },
     { key: 'BUDGET_CRON_T1_USD', group: 'budgets', jsonPath: 'budgets.cronT1', default: 2.00 },

package/dist/config.d.ts

@@ -84,6 +84,7 @@ export declare const TASK_BUDGET_TOKENS: {
 };
 export declare const DEFAULT_MODEL_TIER: keyof Models;
 export declare const MODEL: string;
+export declare const AUTO_DELEGATE_ENABLED: boolean;
 export declare const DISCORD_TOKEN: string;
 export declare const DISCORD_OWNER_ID: string;
 export declare const DISCORD_WATCHED_CHANNELS: string[];

package/dist/config.js

@@ -236,6 +236,13 @@ export const TASK_BUDGET_TOKENS = {
 };
 export const DEFAULT_MODEL_TIER = (getEnvOrJson('DEFAULT_MODEL_TIER', json.models?.default, 'sonnet'));
 export const MODEL = MODELS[DEFAULT_MODEL_TIER] ?? MODELS.sonnet;
+// ── Team routing ─────────────────────────────────────────────────────
+// When false (default), the gateway never auto-delegates a Clementine-
+// owned message to a sub-agent without explicit user opt-in. High-
+// confidence routing is demoted to a soft-suggest so the user can
+// confirm ("send to Ross") or override before any handoff happens.
+// Flip via dashboard or `clementine config set AUTO_DELEGATE_ENABLED true`.
+export const AUTO_DELEGATE_ENABLED = getEnv('AUTO_DELEGATE_ENABLED', 'false').toLowerCase() === 'true';
 // ── Discord ──────────────────────────────────────────────────────────
 export const DISCORD_TOKEN = getSecret('DISCORD_TOKEN');
 export const DISCORD_OWNER_ID = getEnv('DISCORD_OWNER_ID', '0');

package/dist/gateway/router.js

@@ -10,7 +10,7 @@ import pino from 'pino';
 import { PersonalAssistant } from '../agent/assistant.js';
 import { runWithTrace, logAuditJsonl } from '../agent/hooks.js';
 import { SelfImproveLoop } from '../agent/self-improve.js';
-import { MODELS, AGENTS_DIR, TEAM_COMMS_LOG, BASE_DIR, SEEN_CHANNELS_FILE } from '../config.js';
+import { MODELS, AGENTS_DIR, TEAM_COMMS_LOG, BASE_DIR, SEEN_CHANNELS_FILE, AUTO_DELEGATE_ENABLED } from '../config.js';
 import { scanner } from '../security/scanner.js';
 import { lanes } from './lanes.js';
 import { AgentManager } from '../agent/agent-manager.js';
@@ -255,8 +255,10 @@ export class Gateway {
             const targetProfile = agents.find(a => a.slug === decision.targetAgent);
             if (!targetProfile)
                 return null;
-            // Auto-delegate at high confidence
-            if (decision.confidence >= 0.8) {
+            // Auto-delegate at high confidence — only when the user has explicitly
+            // opted in via AUTO_DELEGATE_ENABLED. Default behavior is to demote
+            // every routing to a soft-suggest so the user controls every handoff.
+            if (decision.confidence >= 0.8 && AUTO_DELEGATE_ENABLED) {
                 // Fire the team task in the background; ack immediately.
                 const ackMessage = `Routing this to **${targetProfile.name}** (${decision.reasoning.toLowerCase()}). I'll post their response back here when done.`;
                 onText?.(ackMessage).catch(() => { });
@@ -266,7 +268,32 @@ export class Gateway {
                 if (!sess.teamTaskControllers)
                     sess.teamTaskControllers = new Set();
                 sess.teamTaskControllers.add(teamAbortController);
-                this.handleTeamTask('Clementine', 'clementine', text, targetProfile, undefined, teamAbortController)
+                // Progress visibility — without this the channel goes dark from
+                // ack to final result, which can be many minutes on research-style
+                // tasks. We batch the delegated agent's tool announcements and
+                // flush every PROGRESS_INTERVAL_MS so the user sees what's
+                // happening without a token firehose.
+                const recentTools = [];
+                let progressTimer;
+                const PROGRESS_INTERVAL_MS = 30_000;
+                const dispatcher = this._dispatcher;
+                const flushProgress = () => {
+                    progressTimer = undefined;
+                    if (recentTools.length === 0)
+                        return;
+                    const tools = recentTools.slice(-5).join(', ');
+                    recentTools.length = 0;
+                    void dispatcher?.send(`_${targetProfile.name} is working — recent actions: ${tools}_`, { sessionKey, agentSlug: targetProfile.slug });
+                };
+                const onTeamProgress = (chunk) => {
+                    const m = chunk.match(/\[using ([^\]]+?)\.\.\.\]/);
+                    if (m && m[1])
+                        recentTools.push(m[1]);
+                    if (!progressTimer && recentTools.length > 0) {
+                        progressTimer = setTimeout(flushProgress, PROGRESS_INTERVAL_MS);
+                    }
+                };
+                this.handleTeamTask('Clementine', 'clementine', text, targetProfile, onTeamProgress, teamAbortController)
                     .then(response => {
                     if (!response)
                         return;
@@ -282,6 +309,10 @@ export class Gateway {
                     void this._dispatcher?.send(`**${targetProfile.name}** hit an error handling that: ${String(err).slice(0, 200)}`, { sessionKey, agentSlug: targetProfile.slug });
                 })
                     .finally(() => {
+                    if (progressTimer) {
+                        clearTimeout(progressTimer);
+                        progressTimer = undefined;
+                    }
                     const s = this.sessions.get(sessionKey);
                     s?.teamTaskControllers?.delete(teamAbortController);
                 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clementine-agent",
-  "version": "1.18.2",
+  "version": "1.18.4",
   "description": "Clementine — Personal AI Assistant (TypeScript)",
   "type": "module",
   "main": "dist/index.js",