clementine-agent 1.18.39 → 1.18.40

package/dist/agent/fanout-policy.d.ts

@@ -72,7 +72,21 @@ export interface PreLlmPlanOptions {
 }
 /**
  * Decide whether the user's text should bypass the main agent and run
- * directly through the planner orchestrator. Conservative by design.
+ * directly through the planner orchestrator.
+ *
+ * Threshold model: combined "evidence count" ≥ 2, where each FANOUT
+ * SIGNAL and each MULTI-TARGET ACTION VERB counts as one piece of
+ * evidence. So "research my 100 leads and email each one" gets:
+ *   - 1 fanout signal (numeric_collection: "100 leads")
+ *   - 1 multi-target verb (research my 100 leads)
+ *   = 2 → routes
+ *
+ * False-positive guards stay in front:
+ *   - intent != followup/chat
+ *   - text length ≥ 30 chars
+ *   - NOT an informational query (what/tell me/show me/...)
+ *   - at least ONE action verb (no orchestration for pure declarative
+ *     statements even if they reference multiple items)
  */
 export declare function detectPreLlmPlanIntent(text: string, opts?: PreLlmPlanOptions): PreLlmPlanDecision;
 //# sourceMappingURL=fanout-policy.d.ts.map

package/dist/agent/fanout-policy.js

@@ -172,11 +172,25 @@ const ACTION_VERB_PATTERNS = [
 ];
 /**
  * Decide whether the user's text should bypass the main agent and run
- * directly through the planner orchestrator. Conservative by design.
+ * directly through the planner orchestrator.
+ *
+ * Threshold model: combined "evidence count" ≥ 2, where each FANOUT
+ * SIGNAL and each MULTI-TARGET ACTION VERB counts as one piece of
+ * evidence. So "research my 100 leads and email each one" gets:
+ *   - 1 fanout signal (numeric_collection: "100 leads")
+ *   - 1 multi-target verb (research my 100 leads)
+ *   = 2 → routes
+ *
+ * False-positive guards stay in front:
+ *   - intent != followup/chat
+ *   - text length ≥ 30 chars
+ *   - NOT an informational query (what/tell me/show me/...)
+ *   - at least ONE action verb (no orchestration for pure declarative
+ *     statements even if they reference multiple items)
  */
 export function detectPreLlmPlanIntent(text, opts = {}) {
-    const minLength = opts.minLength ?? 40;
-    const minFanoutSignals = opts.minFanoutSignals ?? 2;
+    const minLength = opts.minLength ?? 30;
+    const minCombinedEvidence = opts.minFanoutSignals ?? 2;
     const trimmed = (text ?? '').trim();
     // Hard skips: intent says "not a task" → don't override.
     if (opts.intentType === 'followup' || opts.intentType === 'chat') {
@@ -191,7 +205,10 @@ export function detectPreLlmPlanIntent(text, opts = {}) {
     if (INFORMATIONAL_QUERY_PATTERN.test(trimmed)) {
         return { shouldRouteToPlanner: false, reason: 'informational_query', signals: [], actionVerbs: [] };
     }
-    // Action-verb match: text must contain an explicit "do X for many" verb.
+    // Action-verb match: text must contain at least one explicit
+    // multi-target verb. This blocks pure declarative statements ("100
+    // prospects are in the pipeline" — referencing many items but no
+    // ask for work).
     const matchedVerbs = [];
     for (const { pattern, reason } of ACTION_VERB_PATTERNS) {
         if (pattern.test(trimmed))
@@ -200,20 +217,25 @@ export function detectPreLlmPlanIntent(text, opts = {}) {
     if (matchedVerbs.length === 0) {
         return { shouldRouteToPlanner: false, reason: 'no_action_verb', signals: [], actionVerbs: [] };
     }
-    // Fanout signals (existing detector — covers numeric counts,
-    // collective+quantifier patterns, "for each", comprehensive research, etc.).
+    // Combined evidence: fanout signals + verb matches. Each piece of
+    // evidence independently suggests multi-step work; together they
+    // strongly do. Threshold ≥ 2 means a query with one numeric collection
+    // ("100 leads") AND one multi-target verb ("research those") routes,
+    // but a query with just a verb and no collection ("research the
+    // prospect Mark") does not.
     const fanoutReport = detectFanoutSignals(trimmed);
-    if (fanoutReport.signals.length < minFanoutSignals) {
+    const combinedEvidence = fanoutReport.signals.length + matchedVerbs.length;
+    if (combinedEvidence < minCombinedEvidence) {
         return {
             shouldRouteToPlanner: false,
-            reason: `weak_fanout_signal_count_${fanoutReport.signals.length}_below_${minFanoutSignals}`,
+            reason: `weak_evidence_${combinedEvidence}_below_${minCombinedEvidence}_(fanout=${fanoutReport.signals.length},verbs=${matchedVerbs.length})`,
             signals: fanoutReport.signals,
             actionVerbs: matchedVerbs,
         };
     }
     return {
         shouldRouteToPlanner: true,
-        reason: `fanout=${fanoutReport.signals.length}+verbs=${matchedVerbs.length}`,
+        reason: `evidence=${combinedEvidence} (fanout=${fanoutReport.signals.length},verbs=${matchedVerbs.length})`,
         signals: fanoutReport.signals,
         actionVerbs: matchedVerbs,
     };

package/dist/gateway/router.js

@@ -2608,7 +2608,15 @@ export class Gateway {
                 this.getSession(sessionKey).abortController = planAc;
                 const { PlanOrchestrator } = await import('../agent/orchestrator.js');
                 const orchestrator = new PlanOrchestrator(this.assistant);
-                const result = await orchestrator.run(taskDescription, onProgress, onApproval, undefined, planAc.signal);
+                // Make hired agents (Ross, Sasha, Nora, etc.) visible to the
+                // planner so it can `delegateTo: <slug>` for steps that match
+                // an agent's specialty. Without this the planner generates
+                // generic steps even when a specialized agent is the right
+                // choice. Empty list = solo Clementine, planner stays generic.
+                const teamAgents = this.getAgentManager()
+                    .listAll()
+                    .filter(a => a.slug !== 'clementine');
+                const result = await orchestrator.run(taskDescription, onProgress, onApproval, teamAgents.length > 0 ? teamAgents : undefined, planAc.signal);
                 scanner.refreshIntegrity();
                 this.assistant.injectContext(sessionKey, `[Plan: ${taskDescription}]`, result);
                 return result;

package/package.json

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