nestor-sh 2.7.1 → 2.9.0

package/dist/nestor.mjs

@@ -6567,18 +6567,51 @@ var init_store = __esm({
       }
       /**
        * Search missions by objective text (LIKE query).
+       * Supports optional filters for type, status, date range.
+       * Returns results sorted by relevance (title matches ranked higher).
        */
-      searchMissions(query, limit = 5) {
-        const pattern = `%${query}%`;
-        const rows = queryAll(
-          this.db,
-          `SELECT * FROM missions
-       WHERE objective LIKE ? OR title LIKE ?
-       ORDER BY created_at DESC
-       LIMIT ?`,
-          [pattern, pattern, limit]
-        );
-        return rows.map((row) => this.rowToMission(row));
+      searchMissions(query, opts) {
+        let sql = "SELECT * FROM missions WHERE 1=1";
+        const params = [];
+        if (query) {
+          sql += " AND (title LIKE ? OR objective LIKE ? OR findings LIKE ?)";
+          const q = `%${query}%`;
+          params.push(q, q, q);
+        }
+        if (opts?.type) {
+          sql += " AND type = ?";
+          params.push(opts.type);
+        }
+        if (opts?.status) {
+          sql += " AND status = ?";
+          params.push(opts.status);
+        }
+        if (opts?.from) {
+          sql += " AND created_at >= ?";
+          params.push(new Date(opts.from).getTime());
+        }
+        if (opts?.to) {
+          sql += " AND created_at <= ?";
+          params.push(new Date(opts.to).getTime());
+        }
+        sql += " ORDER BY created_at DESC";
+        sql += ` LIMIT ${opts?.limit || 20}`;
+        const rows = queryAll(this.db, sql, params);
+        const missions = rows.map((row) => this.rowToMission(row));
+        if (query) {
+          const lowerQ = query.toLowerCase();
+          missions.sort((a, b) => {
+            const aInTitle = a.title.toLowerCase().includes(lowerQ) ? 1 : 0;
+            const bInTitle = b.title.toLowerCase().includes(lowerQ) ? 1 : 0;
+            if (aInTitle !== bInTitle) return bInTitle - aInTitle;
+            return b.createdAt - a.createdAt;
+          });
+        }
+        return missions.map((m) => ({
+          ...m,
+          findingCount: Array.isArray(m.findings) ? m.findings.length : 0,
+          qualityScore: m.evaluation && typeof m.evaluation === "object" && "overall" in m.evaluation ? m.evaluation.overall : null
+        }));
       }
       /**
        * List all missions, optionally filtered by tenant.
@@ -6589,6 +6622,44 @@ var init_store = __esm({
         const rows = queryAll(this.db, sql, params);
         return rows.map((row) => this.rowToMission(row));
       }
+      /**
+       * Get aggregate mission statistics.
+       */
+      getMissionStats(tenantId) {
+        const baseSql = tenantId ? "SELECT * FROM missions WHERE tenant_id = ?" : "SELECT * FROM missions";
+        const params = tenantId ? [tenantId] : [];
+        const rows = queryAll(this.db, baseSql, params);
+        const missions = rows.map((row) => this.rowToMission(row));
+        const byType = {};
+        const byStatus = {};
+        let totalCost = 0;
+        let totalFindings = 0;
+        let qualitySum = 0;
+        let qualityCount = 0;
+        for (const m of missions) {
+          byType[m.type] = (byType[m.type] || 0) + 1;
+          byStatus[m.status] = (byStatus[m.status] || 0) + 1;
+          totalCost += m.spentUsd || 0;
+          totalFindings += Array.isArray(m.findings) ? m.findings.length : 0;
+          if (m.evaluation && typeof m.evaluation === "object" && "overall" in m.evaluation) {
+            const overall = m.evaluation.overall;
+            if (typeof overall === "number") {
+              qualitySum += overall;
+              qualityCount++;
+            }
+          }
+        }
+        const topCategories = Object.entries(byType).sort((a, b) => b[1] - a[1]).map(([cat]) => cat);
+        return {
+          total: missions.length,
+          byType,
+          byStatus,
+          totalCost: Math.round(totalCost * 100) / 100,
+          totalFindings,
+          avgQuality: qualityCount > 0 ? Math.round(qualitySum / qualityCount * 100) / 100 : 0,
+          topCategories
+        };
+      }
       /**
        * Search findings across all missions (LIKE query).
        */
@@ -11430,7 +11501,7 @@ var SERVER_VERSION, startTime;
 var init_health = __esm({
   "../server/src/routes/health.ts"() {
     "use strict";
-    SERVER_VERSION = "2.7.1";
+    SERVER_VERSION = "2.9.0";
     startTime = Date.now();
   }
 });
@@ -12843,7 +12914,7 @@ var init_system = __esm({
     init_error_handler();
     init_broadcaster();
     init_approval_service();
-    SERVER_VERSION2 = "2.7.1";
+    SERVER_VERSION2 = "2.9.0";
     startTime2 = Date.now();
     UpdateConfigSchema = z9.object({
       server: z9.object({
@@ -20273,7 +20344,7 @@ function isNativeAvailable() {
   return nativeModule !== null;
 }
 function getNativeVersion() {
-  return nativeModule ? "2.7.1" : null;
+  return nativeModule ? "2.9.0" : null;
 }
 function validateSsrf(url, allowPrivate = false) {
   if (nativeModule) {
@@ -102139,8 +102210,8 @@ function findChromePath() {
     for (const p8 of paths) {
       if (p8) {
         try {
-          const { existsSync: existsSync26 } = __require("node:fs");
-          if (existsSync26(p8)) return p8;
+          const { existsSync: existsSync27 } = __require("node:fs");
+          if (existsSync27(p8)) return p8;
         } catch {
         }
       }
@@ -102155,8 +102226,8 @@ function findChromePath() {
     ];
     for (const p8 of paths) {
       try {
-        const { existsSync: existsSync26 } = __require("node:fs");
-        if (existsSync26(p8)) return p8;
+        const { existsSync: existsSync27 } = __require("node:fs");
+        if (existsSync27(p8)) return p8;
       } catch {
       }
     }
@@ -102171,8 +102242,8 @@ function findChromePath() {
   ];
   for (const p8 of linuxPaths) {
     try {
-      const { existsSync: existsSync26 } = __require("node:fs");
-      if (existsSync26(p8)) return p8;
+      const { existsSync: existsSync27 } = __require("node:fs");
+      if (existsSync27(p8)) return p8;
     } catch {
     }
   }
@@ -103436,6 +103507,114 @@ var init_meta_tool_factory = __esm({
   }
 });
 
+// ../agent/src/memory/layered-memory.ts
+var LayeredMemory, EpisodicLayer, SemanticLayer;
+var init_layered_memory = __esm({
+  "../agent/src/memory/layered-memory.ts"() {
+    "use strict";
+    LayeredMemory = class {
+      constructor(store) {
+        this.store = store;
+        this.layers = [
+          new EpisodicLayer(store),
+          new SemanticLayer(store)
+        ];
+      }
+      layers = [];
+      /** Query all layers and merge results by relevance */
+      async query(input, limit = 10) {
+        const allResults = [];
+        for (const layer of this.layers) {
+          try {
+            const results = await layer.query(input, limit);
+            allResults.push(...results);
+          } catch {
+          }
+        }
+        return allResults.sort((a, b) => b.relevance - a.relevance).slice(0, limit);
+      }
+      /** Get stats about each memory layer */
+      stats() {
+        return [
+          { name: "Working", type: "working", count: 0 },
+          // managed externally
+          { name: "Episodic", type: "episodic", count: this.getEpisodicCount() },
+          { name: "Semantic", type: "semantic", count: this.getSemanticCount() }
+        ];
+      }
+      getEpisodicCount() {
+        try {
+          const missions = this.store.listMissions("default");
+          return missions.length;
+        } catch {
+          return 0;
+        }
+      }
+      getSemanticCount() {
+        try {
+          const stats = this.store.getKgStats();
+          return stats.totalEntities + stats.totalFacts;
+        } catch {
+          return 0;
+        }
+      }
+    };
+    EpisodicLayer = class {
+      constructor(store) {
+        this.store = store;
+      }
+      name = "Episodic";
+      type = "episodic";
+      async query(input, limit = 5) {
+        try {
+          const missions = this.store.searchMissions(input, { limit });
+          return missions.map((m) => ({
+            content: `Mission "${m.title}" (${m.type}, ${m.status}): ${(m.objective ?? "").substring(0, 200)}. ${m.findingCount} findings, score: ${m.qualityScore ?? "N/A"}`,
+            source: `mission:${m.id}`,
+            layer: "episodic",
+            relevance: 0.6,
+            timestamp: m.createdAt
+          }));
+        } catch {
+          return [];
+        }
+      }
+    };
+    SemanticLayer = class {
+      constructor(store) {
+        this.store = store;
+      }
+      name = "Semantic";
+      type = "semantic";
+      async query(input, limit = 5) {
+        const results = [];
+        try {
+          const entities = this.store.searchKgEntities(input);
+          for (const e of entities.slice(0, limit)) {
+            results.push({
+              content: `Entity: ${e.canonicalName} (${e.type})${e.aliases?.length ? ` \u2014 aliases: ${e.aliases.join(", ")}` : ""}`,
+              source: `kg:entity:${e.id}`,
+              layer: "semantic",
+              relevance: 0.7
+            });
+          }
+          const facts = this.store.getKgFacts(input.substring(0, 50));
+          for (const f of facts.slice(0, limit)) {
+            results.push({
+              content: `Fact: ${f.predicate} \u2192 ${f.object.substring(0, 150)} (confidence: ${f.confidence})`,
+              source: `kg:fact:${f.sourceMissionId ?? "unknown"}`,
+              layer: "semantic",
+              relevance: 0.8 * (f.confidence || 0.5)
+            });
+          }
+        } catch {
+        }
+        return results;
+      }
+    };
+  }
+});
+
 // ../agent/src/tools/system-tools.ts
 import { z as z28 } from "zod";
 import { randomUUID as randomUUID23 } from "node:crypto";
@@ -103827,11 +104006,130 @@ ${summary}`, isError: false };
       }
     }
   });
+  const searchMissionsSchema = z28.object({
+    query: z28.string().describe("Search query (searches titles, objectives, findings)"),
+    type: z28.string().optional().describe("Filter by mission type (osint, research, code, audit, creation, analysis)"),
+    limit: z28.number().optional().describe("Max results (default: 5)")
+  });
+  registry.register({
+    name: "nestor_search_missions",
+    description: "Search past missions by topic, type, or content. Returns matching missions with their findings count and quality scores. Use this to find relevant past work before starting a new mission.",
+    inputSchema: searchMissionsSchema,
+    handler: async (input, _ctx) => {
+      const args2 = input;
+      try {
+        const results = store.searchMissions(args2.query, {
+          type: args2.type,
+          limit: args2.limit || 5
+        });
+        if (results.length === 0) {
+          return { output: `No missions found matching "${args2.query}".`, isError: false };
+        }
+        const summary = results.map((m) => {
+          const quality = m.qualityScore !== null ? ` \u2014 quality: ${(m.qualityScore * 100).toFixed(0)}%` : "";
+          return `\u2022 [${m.status}] ${m.title} (${m.type}) \u2014 ${m.findingCount} findings, $${m.spentUsd.toFixed(4)}${quality}
+  ID: ${m.id}
+  Objective: ${m.objective.substring(0, 200)}`;
+        }).join("\n\n");
+        return {
+          output: `Found ${results.length} mission(s) matching "${args2.query}":
+
+${summary}`,
+          isError: false
+        };
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { output: `Error searching missions: ${msg}`, isError: true };
+      }
+    }
+  });
+  registry.register({
+    name: "nestor_get_mission_report",
+    description: "Get the full report of a specific past mission by ID. Returns the markdown report, evaluation scores, and key findings.",
+    inputSchema: missionIdSchema,
+    handler: async (input, _ctx) => {
+      const args2 = input;
+      try {
+        const mission = store.getMission(args2.missionId);
+        if (!mission) {
+          return { output: `Mission "${args2.missionId}" not found.`, isError: true };
+        }
+        let output = `# Mission: ${mission.title}
+`;
+        output += `Type: ${mission.type} | Status: ${mission.status}
+`;
+        output += `Objective: ${mission.objective}
+`;
+        output += `Cost: $${mission.spentUsd.toFixed(4)} | Findings: ${Array.isArray(mission.findings) ? mission.findings.length : 0}
+`;
+        if (mission.evaluation && typeof mission.evaluation === "object") {
+          const eval_ = mission.evaluation;
+          output += `
+## Evaluation
+`;
+          if (typeof eval_.overall === "number") output += `Overall: ${(eval_.overall * 100).toFixed(0)}%
+`;
+          if (typeof eval_.completeness === "number") output += `Completeness: ${(eval_.completeness * 100).toFixed(0)}%
+`;
+          if (typeof eval_.accuracy === "number") output += `Accuracy: ${(eval_.accuracy * 100).toFixed(0)}%
+`;
+          if (typeof eval_.depth === "number") output += `Depth: ${(eval_.depth * 100).toFixed(0)}%
+`;
+          if (typeof eval_.relevance === "number") output += `Relevance: ${(eval_.relevance * 100).toFixed(0)}%
+`;
+        }
+        if (mission.report) {
+          output += `
+## Report
+${mission.report}`;
+        } else {
+          output += `
+## Findings Summary
+`;
+          const findings = Array.isArray(mission.findings) ? mission.findings : [];
+          for (const f of findings.slice(0, 20)) {
+            const finding = f;
+            output += `- [${finding.type || "finding"}] ${finding.title || "Untitled"}: ${String(finding.content || "").substring(0, 300)}
+`;
+          }
+          if (findings.length > 20) {
+            output += `
+... and ${findings.length - 20} more findings.`;
+          }
+        }
+        return { output, isError: false };
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { output: `Error getting mission report: ${msg}`, isError: true };
+      }
+    }
+  });
+  registry.register({
+    name: "nestor_query_memory",
+    description: "Query all memory layers (episodic: past missions, semantic: knowledge graph) for relevant information. Returns merged results sorted by relevance.",
+    inputSchema: queryMemorySchema,
+    handler: async (input, _ctx) => {
+      const args2 = input;
+      try {
+        const memory = new LayeredMemory(store);
+        const results = await memory.query(String(args2.query), 10);
+        const layerStats = memory.stats();
+        return {
+          output: JSON.stringify({ results, layers: layerStats }, null, 2),
+          isError: false
+        };
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { output: `Memory query failed: ${msg}`, isError: true };
+      }
+    }
+  });
 }
-var emptySchema, createAgentSchema, runAgentSchema, deleteAgentSchema, createWorkflowSchema, searchMemorySchema, storeMemorySchema, createGuardrailSchema, createMissionSchema, missionIdSchema;
+var emptySchema, createAgentSchema, runAgentSchema, deleteAgentSchema, createWorkflowSchema, searchMemorySchema, storeMemorySchema, createGuardrailSchema, createMissionSchema, missionIdSchema, queryMemorySchema;
 var init_system_tools = __esm({
   "../agent/src/tools/system-tools.ts"() {
     "use strict";
+    init_layered_memory();
     emptySchema = z28.object({}).passthrough();
     createAgentSchema = z28.object({
       name: z28.string().describe("Agent name"),
@@ -103879,6 +104177,9 @@ var init_system_tools = __esm({
     missionIdSchema = z28.object({
       missionId: z28.string().describe("The mission ID")
     });
+    queryMemorySchema = z28.object({
+      query: z28.string().describe("Natural language query to search across all memory layers (episodic: past missions, semantic: knowledge graph)")
+    });
   }
 });
 
@@ -107896,6 +108197,7 @@ var init_memory = __esm({
     init_vector_store();
     init_persistent_vector_store();
     init_embedding_provider();
+    init_layered_memory();
     AgentMemory = class {
       constructor(store, agentId) {
         this.store = store;
@@ -108365,6 +108667,217 @@ ${e.reasoning}${ctx}`;
   }
 });
 
+// ../agent/src/safety/context-rotator.ts
+var ContextRotator;
+var init_context_rotator = __esm({
+  "../agent/src/safety/context-rotator.ts"() {
+    "use strict";
+    ContextRotator = class {
+      cfg;
+      messageCount = 0;
+      estimatedTokens = 0;
+      constructor(config2 = {}) {
+        this.cfg = {
+          maxMessages: config2.maxMessages ?? 50,
+          maxTokensEstimate: config2.maxTokensEstimate ?? 1e5,
+          charsPerToken: config2.charsPerToken ?? 4,
+          recentToKeep: config2.recentToKeep ?? 10
+        };
+      }
+      // ── Recording ───────────────────────────────────────────────────────
+      /** Record a message added to context. */
+      recordMessage(content) {
+        this.messageCount++;
+        this.estimatedTokens += Math.ceil(content.length / this.cfg.charsPerToken);
+      }
+      // ── Checking ────────────────────────────────────────────────────────
+      /** Check if context should be rotated. */
+      shouldRotate() {
+        if (this.messageCount >= this.cfg.maxMessages) {
+          return {
+            rotate: true,
+            reason: `${this.messageCount} messages (limit: ${this.cfg.maxMessages})`
+          };
+        }
+        if (this.estimatedTokens >= this.cfg.maxTokensEstimate) {
+          return {
+            rotate: true,
+            reason: `~${this.estimatedTokens} tokens (limit: ${this.cfg.maxTokensEstimate})`
+          };
+        }
+        return { rotate: false };
+      }
+      // ── Rotation helpers ────────────────────────────────────────────────
+      /**
+       * Build a compact summary for context rotation.
+       *
+       * Strategy:
+       * - Preserve the system message verbatim
+       * - Summarize the middle messages into a compact block
+       * - Keep the last N recent messages verbatim
+       *
+       * Returns the summary text to inject as a single assistant message
+       * between the system prompt and the recent messages.
+       */
+      buildRotationSummary(messages) {
+        const keepCount = this.cfg.recentToKeep;
+        const system = messages.find((m) => m.role === "system");
+        const nonSystem = messages.filter((m) => m.role !== "system");
+        const recent = nonSystem.slice(-keepCount);
+        const middle = nonSystem.slice(0, Math.max(0, nonSystem.length - keepCount));
+        const parts = [];
+        if (system) {
+          parts.push("[System prompt preserved]");
+        }
+        if (middle.length > 0) {
+          const toolCalls = middle.filter(
+            (m) => m.content.includes("tool_use") || m.content.includes("function_call") || m.content.includes("tool_result")
+          ).length;
+          const findings = middle.filter(
+            (m) => m.content.includes("finding") || m.content.includes("result") || m.content.includes("discovered")
+          ).length;
+          const errors = middle.filter(
+            (m) => m.content.includes("error") || m.content.includes("failed")
+          ).length;
+          parts.push(
+            `[${middle.length} earlier messages summarized: ${toolCalls} tool interactions, ${findings} results/findings, ${errors} errors]`
+          );
+        }
+        parts.push(`[${recent.length} recent messages preserved below]`);
+        return parts.join("\n");
+      }
+      // ── Lifecycle ───────────────────────────────────────────────────────
+      /** Reset counters after rotation. */
+      reset() {
+        this.messageCount = 0;
+        this.estimatedTokens = 0;
+      }
+      /** Get current stats (useful for logging/telemetry). */
+      getStats() {
+        return {
+          messageCount: this.messageCount,
+          estimatedTokens: this.estimatedTokens
+        };
+      }
+    };
+  }
+});
+
+// ../agent/src/safety/stuck-detector.ts
+var StuckDetector;
+var init_stuck_detector = __esm({
+  "../agent/src/safety/stuck-detector.ts"() {
+    "use strict";
+    StuckDetector = class {
+      cfg;
+      toolCallHistory = [];
+      findingsCount = 0;
+      iterationsWithoutProgress = 0;
+      consecutiveErrors = 0;
+      startTime = Date.now();
+      constructor(config2 = {}) {
+        this.cfg = {
+          maxRepeatedCalls: config2.maxRepeatedCalls ?? 3,
+          maxIterationsWithoutProgress: config2.maxIterationsWithoutProgress ?? 5,
+          maxConsecutiveErrors: config2.maxConsecutiveErrors ?? 3,
+          maxSubObjectiveTimeMs: config2.maxSubObjectiveTimeMs ?? 3e5
+        };
+      }
+      // ── Recording ───────────────────────────────────────────────────────
+      /** Record a tool call for pattern detection. */
+      recordToolCall(name, args2) {
+        this.toolCallHistory.push({
+          name,
+          args: JSON.stringify(args2),
+          timestamp: Date.now()
+        });
+      }
+      /** Record a tool result (success or error). */
+      recordResult(isError) {
+        if (isError) {
+          this.consecutiveErrors++;
+        } else {
+          this.consecutiveErrors = 0;
+        }
+      }
+      /** Update findings count — call after each iteration of the agent loop. */
+      updateProgress(currentFindings) {
+        if (currentFindings > this.findingsCount) {
+          this.findingsCount = currentFindings;
+          this.iterationsWithoutProgress = 0;
+        } else {
+          this.iterationsWithoutProgress++;
+        }
+      }
+      // ── Checking ────────────────────────────────────────────────────────
+      /** Check if the agent appears stuck. */
+      check() {
+        const elapsed = Date.now() - this.startTime;
+        if (elapsed > this.cfg.maxSubObjectiveTimeMs) {
+          return {
+            isStuck: true,
+            reason: "timeout",
+            details: `Sub-objective exceeded ${this.cfg.maxSubObjectiveTimeMs}ms (elapsed: ${elapsed}ms)`,
+            suggestedAction: "skip"
+          };
+        }
+        const windowSize = this.cfg.maxRepeatedCalls;
+        if (this.toolCallHistory.length >= windowSize) {
+          const recent = this.toolCallHistory.slice(-windowSize);
+          const first2 = recent[0];
+          const allSame = recent.every(
+            (c) => c.name === first2.name && c.args === first2.args
+          );
+          if (allSame) {
+            return {
+              isStuck: true,
+              reason: "repeated_calls",
+              details: `Tool "${first2.name}" called ${windowSize}x with identical args`,
+              suggestedAction: "retry_different"
+            };
+          }
+        }
+        if (this.iterationsWithoutProgress >= this.cfg.maxIterationsWithoutProgress) {
+          return {
+            isStuck: true,
+            reason: "no_progress",
+            details: `${this.iterationsWithoutProgress} iterations without new findings`,
+            suggestedAction: "escalate_model"
+          };
+        }
+        if (this.consecutiveErrors >= this.cfg.maxConsecutiveErrors) {
+          return {
+            isStuck: true,
+            reason: "error_loop",
+            details: `${this.consecutiveErrors} consecutive tool errors`,
+            suggestedAction: "retry_different"
+          };
+        }
+        return { isStuck: false };
+      }
+      // ── Lifecycle ───────────────────────────────────────────────────────
+      /** Reset all state for reuse (e.g., new sub-objective). */
+      reset() {
+        this.toolCallHistory = [];
+        this.findingsCount = 0;
+        this.iterationsWithoutProgress = 0;
+        this.consecutiveErrors = 0;
+        this.startTime = Date.now();
+      }
+      /** Get a diagnostic snapshot (useful for logging/telemetry). */
+      getSnapshot() {
+        return {
+          totalCalls: this.toolCallHistory.length,
+          consecutiveErrors: this.consecutiveErrors,
+          iterationsWithoutProgress: this.iterationsWithoutProgress,
+          findingsCount: this.findingsCount,
+          elapsedMs: Date.now() - this.startTime
+        };
+      }
+    };
+  }
+});
+
 // ../agent/src/runtime.ts
 function estimateCost(model, inputTokens, outputTokens) {
   let costs = COST_PER_1M_TOKENS[model];
@@ -108432,6 +108945,8 @@ var init_runtime = __esm({
     init_hot_swap();
     init_auto_downgrade();
     init_reason_logger();
+    init_context_rotator();
+    init_stuck_detector();
     COST_PER_1M_TOKENS = {
       "claude-sonnet-4-20250514": { input: 3, output: 15 },
       "claude-3-5-sonnet": { input: 3, output: 15 },
@@ -108466,6 +108981,10 @@ var init_runtime = __esm({
       autoDowngrade = null;
       /** Explainability: logs the agent's reasoning at each step. */
       reasonLogger = new ReasonLogger();
+      /** Context rotator for fresh-context pattern (Ralph methodology). */
+      contextRotator;
+      /** Stuck detector for loop/stall detection. */
+      stuckDetector;
       constructor(config2) {
         this.config = config2;
         this.hotSwap = new HotSwapAdapter(config2.adapter);
@@ -108550,6 +109069,8 @@ var init_runtime = __esm({
           workspaceContext,
           errorCorrections
         });
+        this.contextRotator = new ContextRotator(config2.contextRotation);
+        this.stuckDetector = new StuckDetector(config2.stuckDetection);
       }
       /**
        * Run the agent loop for a given task.
@@ -108577,6 +109098,9 @@ var init_runtime = __esm({
         let lastOutput = "";
         let exitReason = "completed";
         let error;
+        let consecutiveStucks = 0;
+        this.contextRotator.reset();
+        this.stuckDetector.reset();
         if (this.config.dryRun) {
           this.dryRunInterceptor = new DryRunInterceptor();
         } else {
@@ -108901,8 +109425,51 @@ ${this.config.orgChartContext}` : this.config.orgChartContext;
                 }
               ]);
               messages.push(...toolResultMessages);
+              this.stuckDetector.recordToolCall(toolCall.name, toolCall.arguments);
+              this.stuckDetector.recordResult(result2.isError ?? false);
+              const stuckCheck = this.stuckDetector.check();
+              if (stuckCheck.isStuck) {
+                this.log.warn("Agent stuck detected", {
+                  reason: stuckCheck.reason,
+                  suggestion: stuckCheck.suggestedAction
+                });
+                messages.push({
+                  role: "user",
+                  content: `[System] You appear to be stuck (${stuckCheck.reason}). ${stuckCheck.suggestedAction === "retry_different" ? "Try a completely different approach." : stuckCheck.suggestedAction === "skip" ? "Skip this and move to the next task." : stuckCheck.suggestedAction === "escalate_model" ? "This task may require deeper analysis." : "Consider aborting this approach."}`
+                });
+                if (stuckCheck.reason === "timeout" || consecutiveStucks >= 2) {
+                  exitReason = "error";
+                  error = `Agent stuck: ${stuckCheck.reason} \u2014 ${stuckCheck.details ?? ""}`;
+                  break;
+                }
+                consecutiveStucks++;
+              } else {
+                consecutiveStucks = 0;
+              }
             }
             if (exitReason === "aborted") break;
+            if (exitReason === "error") break;
+            this.contextRotator.recordMessage(response.content);
+            const rotationCheck = this.contextRotator.shouldRotate();
+            if (rotationCheck.rotate) {
+              const summary = this.contextRotator.buildRotationSummary(messages);
+              const systemMsg = messages[0];
+              const recent = messages.slice(-3);
+              messages.length = 0;
+              messages.push(
+                systemMsg,
+                {
+                  role: "user",
+                  content: `[Context rotation \u2014 previous messages summarized]
+${summary}
+
+Continue from where you left off.`
+                },
+                ...recent
+              );
+              this.contextRotator.reset();
+              this.log.info("Context rotated", { reason: rotationCheck.reason });
+            }
           }
           if (iterations >= maxIterations && exitReason === "completed") {
             exitReason = "max_iterations";
@@ -109144,6 +109711,9 @@ ${this.config.orgChartContext}` : this.config.orgChartContext;
         let consecutiveFailures = 0;
         let lastFailedToolName = "";
         const MAX_CONSECUTIVE_FAILURES = 3;
+        let consecutiveStucks = 0;
+        this.contextRotator.reset();
+        this.stuckDetector.reset();
         const messages = this.contextBuilder.buildMessages(
           task.prompt,
           this.config.initialMessages
@@ -109421,8 +109991,51 @@ ${this.config.orgChartContext}` : this.config.orgChartContext;
                 }
               ]);
               messages.push(...toolResultMessages);
+              this.stuckDetector.recordToolCall(toolCall.name, toolCall.arguments);
+              this.stuckDetector.recordResult(result.isError ?? false);
+              const stuckCheck = this.stuckDetector.check();
+              if (stuckCheck.isStuck) {
+                this.log.warn("Agent stuck detected (streaming)", {
+                  reason: stuckCheck.reason,
+                  suggestion: stuckCheck.suggestedAction
+                });
+                messages.push({
+                  role: "user",
+                  content: `[System] You appear to be stuck (${stuckCheck.reason}). ${stuckCheck.suggestedAction === "retry_different" ? "Try a completely different approach." : stuckCheck.suggestedAction === "skip" ? "Skip this and move to the next task." : stuckCheck.suggestedAction === "escalate_model" ? "This task may require deeper analysis." : "Consider aborting this approach."}`
+                });
+                if (stuckCheck.reason === "timeout" || consecutiveStucks >= 2) {
+                  exitReason = "error";
+                  error = `Agent stuck: ${stuckCheck.reason} \u2014 ${stuckCheck.details ?? ""}`;
+                  break;
+                }
+                consecutiveStucks++;
+              } else {
+                consecutiveStucks = 0;
+              }
             }
             if (exitReason === "aborted") break;
+            if (exitReason === "error") break;
+            this.contextRotator.recordMessage(response.content);
+            const rotationCheck = this.contextRotator.shouldRotate();
+            if (rotationCheck.rotate) {
+              const summary = this.contextRotator.buildRotationSummary(messages);
+              const systemMsg = messages[0];
+              const recent = messages.slice(-3);
+              messages.length = 0;
+              messages.push(
+                systemMsg,
+                {
+                  role: "user",
+                  content: `[Context rotation \u2014 previous messages summarized]
+${summary}
+
+Continue from where you left off.`
+                },
+                ...recent
+              );
+              this.contextRotator.reset();
+              this.log.info("Context rotated (streaming)", { reason: rotationCheck.reason });
+            }
           }
           if (iterations >= maxIterations && exitReason === "completed") {
             exitReason = "max_iterations";
@@ -114276,121 +114889,6 @@ var init_knowledge = __esm({
   }
 });
 
-// ../agent/src/safety/stuck-detector.ts
-var StuckDetector;
-var init_stuck_detector = __esm({
-  "../agent/src/safety/stuck-detector.ts"() {
-    "use strict";
-    StuckDetector = class {
-      cfg;
-      toolCallHistory = [];
-      findingsCount = 0;
-      iterationsWithoutProgress = 0;
-      consecutiveErrors = 0;
-      startTime = Date.now();
-      constructor(config2 = {}) {
-        this.cfg = {
-          maxRepeatedCalls: config2.maxRepeatedCalls ?? 3,
-          maxIterationsWithoutProgress: config2.maxIterationsWithoutProgress ?? 5,
-          maxConsecutiveErrors: config2.maxConsecutiveErrors ?? 3,
-          maxSubObjectiveTimeMs: config2.maxSubObjectiveTimeMs ?? 3e5
-        };
-      }
-      // ── Recording ───────────────────────────────────────────────────────
-      /** Record a tool call for pattern detection. */
-      recordToolCall(name, args2) {
-        this.toolCallHistory.push({
-          name,
-          args: JSON.stringify(args2),
-          timestamp: Date.now()
-        });
-      }
-      /** Record a tool result (success or error). */
-      recordResult(isError) {
-        if (isError) {
-          this.consecutiveErrors++;
-        } else {
-          this.consecutiveErrors = 0;
-        }
-      }
-      /** Update findings count — call after each iteration of the agent loop. */
-      updateProgress(currentFindings) {
-        if (currentFindings > this.findingsCount) {
-          this.findingsCount = currentFindings;
-          this.iterationsWithoutProgress = 0;
-        } else {
-          this.iterationsWithoutProgress++;
-        }
-      }
-      // ── Checking ────────────────────────────────────────────────────────
-      /** Check if the agent appears stuck. */
-      check() {
-        const elapsed = Date.now() - this.startTime;
-        if (elapsed > this.cfg.maxSubObjectiveTimeMs) {
-          return {
-            isStuck: true,
-            reason: "timeout",
-            details: `Sub-objective exceeded ${this.cfg.maxSubObjectiveTimeMs}ms (elapsed: ${elapsed}ms)`,
-            suggestedAction: "skip"
-          };
-        }
-        const windowSize = this.cfg.maxRepeatedCalls;
-        if (this.toolCallHistory.length >= windowSize) {
-          const recent = this.toolCallHistory.slice(-windowSize);
-          const first2 = recent[0];
-          const allSame = recent.every(
-            (c) => c.name === first2.name && c.args === first2.args
-          );
-          if (allSame) {
-            return {
-              isStuck: true,
-              reason: "repeated_calls",
-              details: `Tool "${first2.name}" called ${windowSize}x with identical args`,
-              suggestedAction: "retry_different"
-            };
-          }
-        }
-        if (this.iterationsWithoutProgress >= this.cfg.maxIterationsWithoutProgress) {
-          return {
-            isStuck: true,
-            reason: "no_progress",
-            details: `${this.iterationsWithoutProgress} iterations without new findings`,
-            suggestedAction: "escalate_model"
-          };
-        }
-        if (this.consecutiveErrors >= this.cfg.maxConsecutiveErrors) {
-          return {
-            isStuck: true,
-            reason: "error_loop",
-            details: `${this.consecutiveErrors} consecutive tool errors`,
-            suggestedAction: "retry_different"
-          };
-        }
-        return { isStuck: false };
-      }
-      // ── Lifecycle ───────────────────────────────────────────────────────
-      /** Reset all state for reuse (e.g., new sub-objective). */
-      reset() {
-        this.toolCallHistory = [];
-        this.findingsCount = 0;
-        this.iterationsWithoutProgress = 0;
-        this.consecutiveErrors = 0;
-        this.startTime = Date.now();
-      }
-      /** Get a diagnostic snapshot (useful for logging/telemetry). */
-      getSnapshot() {
-        return {
-          totalCalls: this.toolCallHistory.length,
-          consecutiveErrors: this.consecutiveErrors,
-          iterationsWithoutProgress: this.iterationsWithoutProgress,
-          findingsCount: this.findingsCount,
-          elapsedMs: Date.now() - this.startTime
-        };
-      }
-    };
-  }
-});
-
 // ../agent/src/safety/circuit-breaker.ts
 var CircuitBreaker;
 var init_circuit_breaker = __esm({
@@ -114512,98 +115010,278 @@ var init_circuit_breaker = __esm({
   }
 });
 
-// ../agent/src/safety/context-rotator.ts
-var ContextRotator;
-var init_context_rotator = __esm({
-  "../agent/src/safety/context-rotator.ts"() {
+// ../agent/src/safety/question-detector.ts
+var QuestionDetector;
+var init_question_detector = __esm({
+  "../agent/src/safety/question-detector.ts"() {
     "use strict";
-    ContextRotator = class {
-      cfg;
-      messageCount = 0;
-      estimatedTokens = 0;
-      constructor(config2 = {}) {
-        this.cfg = {
-          maxMessages: config2.maxMessages ?? 50,
-          maxTokensEstimate: config2.maxTokensEstimate ?? 1e5,
-          charsPerToken: config2.charsPerToken ?? 4,
-          recentToKeep: config2.recentToKeep ?? 10
-        };
-      }
-      // ── Recording ───────────────────────────────────────────────────────
-      /** Record a message added to context. */
-      recordMessage(content) {
-        this.messageCount++;
-        this.estimatedTokens += Math.ceil(content.length / this.cfg.charsPerToken);
+    QuestionDetector = class {
+      questionCount = 0;
+      maxQuestionsBeforeCorrection;
+      constructor(opts) {
+        this.maxQuestionsBeforeCorrection = opts?.maxQuestions ?? 2;
       }
-      // ── Checking ────────────────────────────────────────────────────────
-      /** Check if context should be rotated. */
-      shouldRotate() {
-        if (this.messageCount >= this.cfg.maxMessages) {
-          return {
-            rotate: true,
-            reason: `${this.messageCount} messages (limit: ${this.cfg.maxMessages})`
-          };
+      /**
+       * Analyze an assistant message for question patterns.
+       * Returns detection result with optional correction prompt.
+       */
+      detect(assistantMessage) {
+        const questions = this.extractQuestions(assistantMessage);
+        if (questions.length === 0) {
+          this.questionCount = 0;
+          return { isQuestion: false, questions: [] };
         }
-        if (this.estimatedTokens >= this.cfg.maxTokensEstimate) {
+        this.questionCount++;
+        if (this.questionCount >= this.maxQuestionsBeforeCorrection) {
           return {
-            rotate: true,
-            reason: `~${this.estimatedTokens} tokens (limit: ${this.cfg.maxTokensEstimate})`
+            isQuestion: true,
+            questions,
+            correctionPrompt: this.buildCorrectionPrompt(questions)
           };
         }
-        return { rotate: false };
+        return { isQuestion: true, questions };
+      }
+      extractQuestions(text7) {
+        const questions = [];
+        const questionLines = text7.split("\n").filter((line) => {
+          const trimmed = line.trim();
+          return trimmed.endsWith("?") && trimmed.length > 10;
+        });
+        questions.push(...questionLines.map((q) => q.trim()));
+        const indirectPatterns = [
+          /(?:could you|would you|can you|do you want|should I|shall I|do you prefer|which (?:one|option)|please (?:confirm|specify|clarify|tell me|let me know))/gi,
+          /(?:voulez-vous|souhaitez-vous|préférez-vous|dois-je|faut-il|quel(?:le)? (?:est|sont)|pouvez-vous (?:me dire|confirmer|préciser))/gi
+        ];
+        for (const pattern of indirectPatterns) {
+          const matches = text7.match(pattern);
+          if (matches) {
+            questions.push(...matches.map((m) => m.trim()));
+          }
+        }
+        return questions;
+      }
+      buildCorrectionPrompt(questions) {
+        return `[System \u2014 Autonomous Mode Correction]
+You are in AUTONOMOUS mode. Do NOT ask questions \u2014 take action instead.
+
+You asked: ${questions.slice(0, 3).map((q) => `"${q}"`).join(", ")}
+
+Instead of asking:
+- Make a reasonable decision based on available information
+- If multiple options exist, choose the most common/safe one
+- If information is missing, use your tools to find it (web_search, file_read, etc.)
+- If truly blocked, document what you need and move on to the next task
+
+DO NOT ask any more questions. Take action now.`;
+      }
+      /** Reset counter */
+      reset() {
+        this.questionCount = 0;
+      }
+    };
+  }
+});
+
+// ../agent/src/safety/completion-detector.ts
+var CompletionDetector;
+var init_completion_detector = __esm({
+  "../agent/src/safety/completion-detector.ts"() {
+    "use strict";
+    CompletionDetector = class {
+      noToolCallStreak = 0;
+      minNoToolStreak;
+      constructor(opts) {
+        this.minNoToolStreak = opts?.minNoToolStreak ?? 2;
       }
-      // ── Rotation helpers ────────────────────────────────────────────────
       /**
-       * Build a compact summary for context rotation.
-       *
-       * Strategy:
-       * - Preserve the system message verbatim
-       * - Summarize the middle messages into a compact block
-       * - Keep the last N recent messages verbatim
-       *
-       * Returns the summary text to inject as a single assistant message
-       * between the system prompt and the recent messages.
+       * Check if the agent has truly completed its task.
+       * Requires both heuristic indicators and an explicit signal.
        */
-      buildRotationSummary(messages) {
-        const keepCount = this.cfg.recentToKeep;
-        const system = messages.find((m) => m.role === "system");
-        const nonSystem = messages.filter((m) => m.role !== "system");
-        const recent = nonSystem.slice(-keepCount);
-        const middle = nonSystem.slice(0, Math.max(0, nonSystem.length - keepCount));
-        const parts = [];
-        if (system) {
-          parts.push("[System prompt preserved]");
-        }
-        if (middle.length > 0) {
-          const toolCalls = middle.filter(
-            (m) => m.content.includes("tool_use") || m.content.includes("function_call") || m.content.includes("tool_result")
-          ).length;
-          const findings = middle.filter(
-            (m) => m.content.includes("finding") || m.content.includes("result") || m.content.includes("discovered")
-          ).length;
-          const errors = middle.filter(
-            (m) => m.content.includes("error") || m.content.includes("failed")
-          ).length;
-          parts.push(
-            `[${middle.length} earlier messages summarized: ${toolCalls} tool interactions, ${findings} results/findings, ${errors} errors]`
-          );
+      check(assistantMessage, hadToolCalls) {
+        if (hadToolCalls) {
+          this.noToolCallStreak = 0;
+        } else {
+          this.noToolCallStreak++;
         }
-        parts.push(`[${recent.length} recent messages preserved below]`);
-        return parts.join("\n");
+        const heuristicScore = this.computeHeuristic(assistantMessage, hadToolCalls);
+        const hasExplicitSignal = this.hasExplicitCompletionSignal(assistantMessage);
+        const isComplete = heuristicScore >= 0.7 && hasExplicitSignal;
+        return {
+          isComplete,
+          heuristicScore,
+          hasExplicitSignal,
+          reason: isComplete ? "Both heuristic and explicit signals indicate completion" : !hasExplicitSignal ? "No explicit completion signal found" : `Heuristic score too low (${heuristicScore.toFixed(2)})`
+        };
+      }
+      computeHeuristic(message, hadToolCalls) {
+        let score = 0;
+        if (!hadToolCalls) score += 0.3;
+        if (this.noToolCallStreak >= this.minNoToolStreak) score += 0.3;
+        const conclusionPatterns = [
+          /(?:in summary|en résumé|to summarize|pour résumer|in conclusion|en conclusion)/i,
+          /(?:here are the (?:results|findings)|voici les (?:résultats|conclusions))/i,
+          /(?:the (?:task|mission|objective|work) is (?:complete|done|finished))/i,
+          /(?:la (?:tâche|mission) est (?:terminée|complète|finie))/i,
+          /(?:I have (?:completed|finished|done)|j'ai (?:terminé|fini|complété))/i
+        ];
+        const conclusionMatches = conclusionPatterns.filter((p8) => p8.test(message)).length;
+        score += Math.min(conclusionMatches * 0.15, 0.4);
+        return Math.min(score, 1);
+      }
+      hasExplicitCompletionSignal(message) {
+        const explicitSignals = [
+          /\[COMPLETE\]/i,
+          /\[DONE\]/i,
+          /\[TASK_COMPLETE\]/i,
+          /\[MISSION_COMPLETE\]/i,
+          /EXIT_SIGNAL:\s*COMPLETE/i,
+          // JSON output with findings (structured output = done)
+          /^\s*\[[\s\S]*"type"[\s\S]*"title"[\s\S]*"confidence"[\s\S]*\]\s*$/m,
+          // Markdown report header (report = done)
+          /^#\s+.*(?:Report|Rapport|Results|Résultats)/m
+        ];
+        return explicitSignals.some((p8) => p8.test(message));
       }
-      // ── Lifecycle ───────────────────────────────────────────────────────
-      /** Reset counters after rotation. */
+      /** Reset state */
       reset() {
-        this.messageCount = 0;
-        this.estimatedTokens = 0;
+        this.noToolCallStreak = 0;
       }
-      /** Get current stats (useful for logging/telemetry). */
-      getStats() {
+    };
+  }
+});
+
+// ../agent/src/safety/handoff-generator.ts
+var HandoffGenerator;
+var init_handoff_generator = __esm({
+  "../agent/src/safety/handoff-generator.ts"() {
+    "use strict";
+    HandoffGenerator = class {
+      /**
+       * Generate a handoff document from the agent's message history.
+       * This is a heuristic extraction — no LLM call needed.
+       */
+      generate(opts) {
+        const { objective, messages, toolCalls, exitReason, costUsd } = opts;
+        const accomplished = this.extractAccomplished(messages);
+        const remaining = this.extractRemaining(messages, exitReason);
+        const currentState = this.buildCurrentState(toolCalls);
+        const decisions = this.extractDecisions(messages);
+        const errors = toolCalls.filter((tc) => tc.isError).map((tc) => ({ error: `${tc.name}: ${tc.result.substring(0, 200)}`, resolution: "Attempted" }));
+        const toolUsage = {};
+        for (const tc of toolCalls) {
+          toolUsage[tc.name] = (toolUsage[tc.name] || 0) + 1;
+        }
+        const nextSteps = this.suggestNextSteps(remaining, errors, exitReason);
         return {
-          messageCount: this.messageCount,
-          estimatedTokens: this.estimatedTokens
+          objective,
+          accomplished,
+          remaining,
+          currentState,
+          decisions,
+          errors,
+          nextSteps,
+          toolUsage,
+          costUsd,
+          timestamp: Date.now()
         };
       }
+      /** Convert handoff to Markdown for storage/display */
+      toMarkdown(handoff) {
+        const sections = [
+          `# Session Handoff`,
+          ``,
+          `**Objective:** ${handoff.objective}`,
+          `**Cost:** $${handoff.costUsd.toFixed(4)}`,
+          `**Date:** ${new Date(handoff.timestamp).toISOString()}`,
+          ``,
+          `## Accomplished`,
+          ...handoff.accomplished.map((a) => `- ${a}`),
+          ``,
+          `## Remaining`,
+          ...handoff.remaining.map((r) => `- ${r}`),
+          ``,
+          `## Current State`,
+          handoff.currentState,
+          ``,
+          `## Decisions`,
+          ...handoff.decisions.map((d) => `- **${d.decision}**: ${d.reason}`),
+          ``,
+          `## Errors (${handoff.errors.length})`,
+          ...handoff.errors.map((e) => `- ${e.error}`),
+          ``,
+          `## Next Steps`,
+          ...handoff.nextSteps.map((s) => `- ${s}`),
+          ``,
+          `## Tool Usage`,
+          ...Object.entries(handoff.toolUsage).map(([name, count]) => `- ${name}: ${count}x`)
+        ];
+        return sections.join("\n");
+      }
+      extractAccomplished(messages) {
+        const accomplished = [];
+        for (const msg of messages) {
+          if (msg.role !== "assistant") continue;
+          const lines = msg.content.split("\n");
+          for (const line of lines) {
+            if (/(?:✅|done|completed|finished|created|wrote|found|discovered|built|implemented)/i.test(line) && line.length > 10 && line.length < 200) {
+              accomplished.push(line.replace(/^[-*•]\s*/, "").trim());
+            }
+          }
+        }
+        return accomplished.slice(0, 10);
+      }
+      extractRemaining(messages, exitReason) {
+        const remaining = [];
+        if (exitReason === "max_iterations") remaining.push("Max iterations reached \u2014 work may be incomplete");
+        if (exitReason === "budget_exceeded") remaining.push("Budget exhausted \u2014 work may be incomplete");
+        if (exitReason === "aborted") remaining.push("Execution was aborted");
+        const lastAssistant = [...messages].reverse().find((m) => m.role === "assistant");
+        if (lastAssistant) {
+          const todoPattern = /(?:todo|remaining|still need|next|à faire|reste)/i;
+          const lines = lastAssistant.content.split("\n");
+          for (const line of lines) {
+            if (todoPattern.test(line) && line.length > 10 && line.length < 200) {
+              remaining.push(line.replace(/^[-*•]\s*/, "").trim());
+            }
+          }
+        }
+        return remaining.slice(0, 10);
+      }
+      buildCurrentState(toolCalls) {
+        const filesWritten = toolCalls.filter((tc) => tc.name === "file_write").map((tc) => String(tc.args.path || "")).filter(Boolean);
+        const commandsRun = toolCalls.filter((tc) => tc.name === "shell_exec").map((tc) => String(tc.args.command || "").substring(0, 100)).filter(Boolean);
+        let state = "";
+        if (filesWritten.length > 0) state += `Files modified: ${filesWritten.join(", ")}
+`;
+        if (commandsRun.length > 0) state += `Commands run: ${commandsRun.slice(-5).join("; ")}`;
+        return state || "No filesystem changes detected.";
+      }
+      extractDecisions(messages) {
+        const decisions = [];
+        for (const msg of messages) {
+          if (msg.role !== "assistant") continue;
+          const patterns = [
+            /I (?:chose|decided|selected|went with|picked) (.{10,80}) (?:because|since|as|due to) (.{10,120})/gi,
+            /(?:j'ai choisi|j'ai décidé|j'ai opté pour) (.{10,80}) (?:car|parce que|puisque) (.{10,120})/gi
+          ];
+          for (const pattern of patterns) {
+            let match;
+            while ((match = pattern.exec(msg.content)) !== null && decisions.length < 5) {
+              decisions.push({ decision: match[1].trim(), reason: match[2].trim() });
+            }
+          }
+        }
+        return decisions;
+      }
+      suggestNextSteps(remaining, errors, exitReason) {
+        const steps = [];
+        if (remaining.length > 0) steps.push(`Continue with: ${remaining[0]}`);
+        if (errors.length > 0) steps.push(`Investigate ${errors.length} error(s) from previous session`);
+        if (exitReason === "budget_exceeded") steps.push("Consider increasing budget for next run");
+        if (exitReason === "max_iterations") steps.push("Consider increasing max iterations or simplifying the objective");
+        if (steps.length === 0) steps.push("Review results and plan next action");
+        return steps;
+      }
     };
   }
 });
@@ -114615,6 +115293,9 @@ var init_safety = __esm({
     init_stuck_detector();
     init_circuit_breaker();
     init_context_rotator();
+    init_question_detector();
+    init_completion_detector();
+    init_handoff_generator();
   }
 });
 
@@ -116951,7 +117632,7 @@ var init_inventory = __esm({
       /** Find similar past missions for planning. */
       async findSimilarMissions(objective) {
         try {
-          return this.store.searchMissions(objective, 3);
+          return this.store.searchMissions(objective, { limit: 3 });
         } catch {
           return [];
         }
@@ -117834,6 +118515,7 @@ __export(src_exports3, {
   CircuitBreaker: () => CircuitBreaker,
   ClaudeAdapter: () => ClaudeAdapter,
   CodeChunker: () => CodeChunker,
+  CompletionDetector: () => CompletionDetector,
   ContextBuilder: () => ContextBuilder,
   ContextRotator: () => ContextRotator,
   DockerDeployer: () => DockerDeployer,
@@ -117847,11 +118529,13 @@ __export(src_exports3, {
   GeminiAdapter: () => GeminiAdapter,
   GeminiEmbeddingProvider: () => GeminiEmbeddingProvider,
   GrokAdapter: () => GrokAdapter,
+  HandoffGenerator: () => HandoffGenerator,
   HotSwapAdapter: () => HotSwapAdapter,
   IntentAnalyzer: () => IntentAnalyzer,
   InventoryManager: () => InventoryManager,
   K8sExecutor: () => K8sExecutor,
   KnowledgeGraph: () => KnowledgeGraph,
+  LayeredMemory: () => LayeredMemory,
   LocalEmbeddings: () => LocalEmbeddings,
   LocalSandbox: () => LocalSandbox,
   McpFactory: () => McpFactory,
@@ -117874,6 +118558,7 @@ __export(src_exports3, {
   PluginManifestSchema: () => PluginManifestSchema,
   PluginSandbox: () => PluginSandbox,
   ProcessSandbox: () => ProcessSandbox,
+  QuestionDetector: () => QuestionDetector,
   RagIndexer: () => RagIndexer,
   RagSearch: () => RagSearch,
   ReasonLogger: () => ReasonLogger,
@@ -149749,7 +150434,7 @@ var init_admin2 = __esm({
   "../server/src/routes/admin.ts"() {
     "use strict";
     init_rate_limit();
-    SERVER_VERSION3 = "2.7.1";
+    SERVER_VERSION3 = "2.9.0";
     startTime3 = Date.now();
   }
 });
@@ -151886,6 +152571,36 @@ function missionRoutes(store, logger) {
       next(err);
     }
   });
+  router.get("/search", async (req, res, next) => {
+    try {
+      const q = req.query.q || "";
+      const type = req.query.type;
+      const status = req.query.status;
+      const from2 = req.query.from;
+      const to = req.query.to;
+      const limit = req.query.limit ? parseInt(req.query.limit, 10) : 20;
+      const results = store.searchMissions(q, { type, status, from: from2, to, limit });
+      res.json({
+        data: results,
+        meta: {
+          count: results.length,
+          query: q,
+          filters: { type, status, from: from2, to }
+        }
+      });
+    } catch (err) {
+      next(err);
+    }
+  });
+  router.get("/stats", async (req, res, next) => {
+    try {
+      const tenantId = req.tenantId || "default";
+      const stats = store.getMissionStats(tenantId);
+      res.json({ data: stats });
+    } catch (err) {
+      next(err);
+    }
+  });
   router.get("/:id", async (req, res, next) => {
     try {
       const mission = store.getMission(req.params.id);
@@ -153046,7 +153761,7 @@ var VERSION2, DATA_DIR3, TELEMETRY_ID_FILE, TELEMETRY_LOG_FILE, DEFAULT_FLUSH_TH
 var init_telemetry2 = __esm({
   "../server/src/services/telemetry.ts"() {
     "use strict";
-    VERSION2 = "2.7.1";
+    VERSION2 = "2.9.0";
     DATA_DIR3 = join23(homedir8(), ".nestor");
     TELEMETRY_ID_FILE = join23(DATA_DIR3, "telemetry-id");
     TELEMETRY_LOG_FILE = join23(DATA_DIR3, "telemetry.jsonl");
@@ -157365,7 +158080,7 @@ var init_src6 = __esm({
         await this._handle.listen();
         const authMode = config2.apiKey ? "API key" : "open (no auth)";
         console.log(`
-  Nestor Server v2.7.1`);
+  Nestor Server v2.9.0`);
         console.log(`  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
         console.log(`  HTTP    : http://${this._host}:${this._port}`);
         console.log(`  WS      : ws://${this._host}:${this._port}/ws`);
@@ -167127,7 +167842,7 @@ var init_server = __esm({
     MCP_PROTOCOL_VERSION = "2024-11-05";
     SERVER_INFO = {
       name: "nestor",
-      version: "2.7.1"
+      version: "2.9.0"
     };
     SERVER_CAPABILITIES = {
       tools: { listChanged: false },
@@ -167571,7 +168286,7 @@ function printWelcome() {
   console.log(chalk11.cyan(` | .\` | | _|  \\__ \\   | |   | (_) | |   /  _  \\__ \\ | __ |`));
   console.log(chalk11.cyan(` |_|\\_| |___| |___/   |_|    \\___/  |_|_\\ (_) |___/ |_||_|`));
   console.log("");
-  console.log(chalk11.dim("  Interactive Shell \u2014 v2.7.1"));
+  console.log(chalk11.dim("  Interactive Shell \u2014 v2.9.0"));
   console.log(chalk11.dim("  Type /help for commands, /exit to quit."));
   console.log(chalk11.dim("  Multiline: end a line with \\ or use ``` code blocks."));
   console.log("");
@@ -169490,7 +170205,7 @@ var init_shell = __esm({
 
 // src/index.ts
 import { Command } from "commander";
-import { existsSync as existsSync25, readFileSync as readFileSync25 } from "node:fs";
+import { existsSync as existsSync26, readFileSync as readFileSync26 } from "node:fs";
 import { join as join29 } from "node:path";
 import { homedir as homedir12 } from "node:os";
 
@@ -169511,7 +170226,7 @@ var BANNER = `
 function registerStartCommand(program2) {
   program2.command("start").description("Start the Nestor server").option("-p, --port <port>", "Server port").option("-H, --host <host>", "Server host").option("--no-studio", "Disable the Studio web UI").action(async (options) => {
     console.log(chalk.cyan(BANNER));
-    console.log(chalk.dim(`  v2.7.1
+    console.log(chalk.dim(`  v2.9.0
 `));
     let config2 = readConfigFile();
     if (!config2) {
@@ -171203,7 +171918,7 @@ async function startForeground() {
   console.log(chalk12.cyan(` | .\` | | _|  \\__ \\   | |   | (_) | |   /  _  \\__ \\ | __ |`));
   console.log(chalk12.cyan(` |_|\\_| |___| |___/   |_|    \\___/  |_|_\\ (_) |___/ |_||_|`));
   console.log("");
-  console.log(chalk12.dim("  Daemon Mode \u2014 v2.7.1"));
+  console.log(chalk12.dim("  Daemon Mode \u2014 v2.9.0"));
   console.log(chalk12.dim(`  PID: ${process.pid}`));
   console.log(chalk12.dim(`  Log: ${LOG_FILE}`));
   console.log("");
@@ -171566,9 +172281,9 @@ var DaemonRunner = class {
     try {
       const store = await getStore();
       try {
-        const { randomUUID: randomUUID51 } = await import("node:crypto");
+        const { randomUUID: randomUUID52 } = await import("node:crypto");
         store.createRun({
-          id: randomUUID51(),
+          id: randomUUID52(),
           workflowId: `agent:${agentId}`,
           workflowVersion: 1,
           status: result.exitReason === "completed" ? "completed" : "failed",
@@ -171604,9 +172319,9 @@ var DaemonRunner = class {
     try {
       const store = await getStore();
       try {
-        const { randomUUID: randomUUID51 } = await import("node:crypto");
+        const { randomUUID: randomUUID52 } = await import("node:crypto");
         store.createRun({
-          id: randomUUID51(),
+          id: randomUUID52(),
           workflowId: `agent:${agentId}`,
           workflowVersion: 1,
           status: "failed",
@@ -173349,11 +174064,289 @@ function registerGuardrailCommand(program2) {
   });
 }
 
+// src/commands/loop.ts
+init_db();
+init_config2();
+import chalk22 from "chalk";
+import { randomUUID as randomUUID51 } from "node:crypto";
+import { readFileSync as readFileSync25, existsSync as existsSync25 } from "node:fs";
+import { execSync as execSync3 } from "node:child_process";
+function runShellCommand(cmd, cwd) {
+  try {
+    const stdout = execSync3(cmd, {
+      cwd,
+      encoding: "utf-8",
+      timeout: 6e4,
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    return { stdout: stdout.trim(), exitCode: 0 };
+  } catch (err) {
+    const execErr = err;
+    return {
+      stdout: (execErr.stdout ?? "").toString().trim(),
+      exitCode: execErr.status ?? 1
+    };
+  }
+}
+function getGitDiff(cwd) {
+  try {
+    const diff = execSync3("git diff --stat", { cwd, encoding: "utf-8", timeout: 1e4 });
+    return diff.trim() || "(no changes)";
+  } catch {
+    return "(git not available)";
+  }
+}
+function getTestOutput(verifyCmd, cwd) {
+  const result = runShellCommand(verifyCmd, cwd);
+  const maxLen = 2e3;
+  const output = result.stdout.length > maxLen ? result.stdout.slice(-maxLen) : result.stdout;
+  return output;
+}
+function buildIterationPrompt(opts) {
+  const parts = [];
+  parts.push(`# Objective (iteration ${opts.iteration}/${opts.maxIterations})`);
+  parts.push("");
+  parts.push(opts.spec);
+  parts.push("");
+  if (opts.previousResults.length > 0) {
+    parts.push("## Previous iterations summary");
+    for (const r of opts.previousResults) {
+      const status = r.specMet ? "PASSED" : "FAILED";
+      parts.push(`- Iteration ${r.iteration}: ${status} (${r.exitReason}) \u2014 ${r.output.slice(0, 200)}`);
+    }
+    parts.push("");
+  }
+  if (opts.gitDiff !== "(no changes)" && opts.gitDiff !== "(git not available)") {
+    parts.push("## Current state (git diff --stat)");
+    parts.push("```");
+    parts.push(opts.gitDiff);
+    parts.push("```");
+    parts.push("");
+  }
+  if (opts.verifyOutput) {
+    parts.push("## Verification output (from last check)");
+    parts.push("```");
+    parts.push(opts.verifyOutput);
+    parts.push("```");
+    parts.push("");
+  }
+  parts.push("## Instructions");
+  parts.push("Analyze the current state and work towards achieving the objective.");
+  parts.push("If previous iterations failed, try a DIFFERENT approach.");
+  parts.push("When done, commit your changes with a descriptive message.");
+  return parts.join("\n");
+}
+function registerLoopCommand(program2) {
+  program2.command("loop").description("Run an agent in a fresh-context loop until a specification is met (Ralph pattern)").option("--agent <name>", "Agent name to use", "default").option("--spec <text>", "Specification to achieve").option("--spec-file <path>", "File containing the specification").option("--verify <command>", "Shell command to verify spec (exit 0 = done)").option("--max-iterations <n>", "Max loop iterations", "10").option("--budget <usd>", "Max total budget in USD", "5").option("--cwd <path>", "Working directory", process.cwd()).action(async (opts) => {
+    let spec = opts.spec;
+    if (!spec && opts.specFile) {
+      if (!existsSync25(opts.specFile)) {
+        console.error(chalk22.red(`Spec file not found: ${opts.specFile}`));
+        process.exit(1);
+      }
+      spec = readFileSync25(opts.specFile, "utf-8").trim();
+    }
+    if (!spec) {
+      console.error(chalk22.red("Must provide --spec or --spec-file"));
+      process.exit(1);
+    }
+    const maxIterations = parseInt(opts.maxIterations, 10);
+    const totalBudget = parseFloat(opts.budget);
+    const cwd = opts.cwd;
+    console.log(chalk22.cyan("\n  Ralph Fresh-Context Loop"));
+    console.log(chalk22.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(chalk22.white("  Spec:"), spec.slice(0, 100) + (spec.length > 100 ? "..." : ""));
+    console.log(chalk22.white("  Agent:"), opts.agent);
+    console.log(chalk22.white("  Max iterations:"), maxIterations);
+    console.log(chalk22.white("  Budget:"), `$${totalBudget}`);
+    if (opts.verify) {
+      console.log(chalk22.white("  Verify cmd:"), opts.verify);
+    }
+    console.log("");
+    let agentModule;
+    try {
+      agentModule = await Promise.resolve().then(() => (init_src5(), src_exports3));
+    } catch {
+      console.error(chalk22.red("Failed to import @nestor/agent. Is it installed?"));
+      process.exit(1);
+    }
+    const store = await getStore();
+    let resolvedAgent;
+    try {
+      const agents = store.listAgents();
+      resolvedAgent = agents.find((a) => a.name === opts.agent);
+    } catch {
+    }
+    const agent = resolvedAgent ?? {
+      id: randomUUID51(),
+      name: opts.agent,
+      adapterType: "claude",
+      adapterConfig: {
+        model: "claude-sonnet-4-20250514",
+        instructions: "You are an expert software engineer. Complete the given specification precisely."
+      },
+      trustLevel: "community",
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    let router;
+    try {
+      router = await agentModule.createDefaultRouter();
+    } catch {
+      console.error(chalk22.red("Could not initialize LLM adapter. Is the API key configured?"));
+      process.exit(1);
+    }
+    const summary = {
+      totalIterations: 0,
+      totalCostUsd: 0,
+      totalTokens: 0,
+      totalDurationMs: 0,
+      specMet: false,
+      iterationResults: []
+    };
+    for (let i = 1; i <= maxIterations; i++) {
+      if (summary.totalCostUsd >= totalBudget) {
+        console.log(chalk22.yellow(`
+  Budget exhausted ($${summary.totalCostUsd.toFixed(4)} / $${totalBudget}). Stopping.`));
+        break;
+      }
+      const remainingBudget = totalBudget - summary.totalCostUsd;
+      console.log(chalk22.cyan(`
+  \u2500\u2500 Iteration ${i}/${maxIterations} `) + chalk22.dim(`(budget remaining: $${remainingBudget.toFixed(4)}) \u2500\u2500`));
+      if (opts.verify && i > 1) {
+        const verifyResult = runShellCommand(opts.verify, cwd);
+        if (verifyResult.exitCode === 0) {
+          console.log(chalk22.green("  Specification met! Verify command exited 0."));
+          summary.specMet = true;
+          break;
+        }
+      }
+      const gitDiff = getGitDiff(cwd);
+      const verifyOutput = opts.verify ? getTestOutput(opts.verify, cwd) : "";
+      const prompt = buildIterationPrompt({
+        spec,
+        iteration: i,
+        maxIterations,
+        previousResults: summary.iterationResults,
+        gitDiff,
+        verifyOutput
+      });
+      const modelId = agent.adapterConfig.model ?? "claude-sonnet-4-20250514";
+      const adapter = router.resolve(modelId);
+      const events = new agentModule.RuntimeEventBus();
+      const tools = new agentModule.ToolRegistry();
+      agentModule.registerBuiltinTools(tools);
+      const runtime = new agentModule.AgentRuntime({
+        adapter,
+        tools,
+        toolExecutor: new agentModule.ToolExecutor(),
+        role: {
+          name: agent.name,
+          description: agent.description ?? "Loop agent",
+          instructions: agent.adapterConfig.instructions ?? "You are an expert software engineer.",
+          constraints: []
+        },
+        workingDir: cwd,
+        events,
+        maxCostUsd: remainingBudget,
+        maxIterations: 50,
+        db: store,
+        modelRouter: router,
+        // Enable context rotation within each iteration too
+        contextRotation: { maxMessages: 40, maxTokensEstimate: 8e4 },
+        stuckDetection: { maxRepeatedCalls: 3, maxConsecutiveErrors: 3 }
+      });
+      const taskId = randomUUID51();
+      let iterOutput = "";
+      try {
+        for await (const event of runtime.runStreaming({
+          prompt,
+          agentId: agent.id,
+          taskId
+        })) {
+          switch (event.type) {
+            case "token":
+              process.stdout.write(event.text);
+              iterOutput += event.text;
+              break;
+            case "tool_start":
+              console.log(chalk22.dim(`
+    [tool] ${event.name}`));
+              break;
+            case "tool_result":
+              if (!event.success) {
+                console.log(chalk22.red(`    [tool error] ${event.name}: ${event.result.slice(0, 100)}`));
+              }
+              break;
+            case "error":
+              console.log(chalk22.red(`
+    [error] ${event.message}`));
+              break;
+            case "done": {
+              const r = event.result;
+              const iterResult = {
+                iteration: i,
+                output: r.output || iterOutput,
+                exitReason: r.exitReason,
+                costUsd: r.usage.estimatedCostUsd,
+                tokens: r.usage.totalTokens,
+                durationMs: r.durationMs,
+                specMet: false
+              };
+              summary.totalCostUsd += r.usage.estimatedCostUsd;
+              summary.totalTokens += r.usage.totalTokens;
+              summary.totalDurationMs += r.durationMs;
+              summary.totalIterations = i;
+              if (opts.verify) {
+                const postVerify = runShellCommand(opts.verify, cwd);
+                iterResult.specMet = postVerify.exitCode === 0;
+              }
+              summary.iterationResults.push(iterResult);
+              console.log("");
+              console.log(chalk22.dim(`    [${r.exitReason}] ${r.usage.totalTokens} tokens, $${r.usage.estimatedCostUsd.toFixed(4)}, ${(r.durationMs / 1e3).toFixed(1)}s`));
+              if (iterResult.specMet) {
+                console.log(chalk22.green("    Specification met!"));
+                summary.specMet = true;
+              }
+              break;
+            }
+          }
+        }
+      } catch (err) {
+        console.error(chalk22.red(`
+    Iteration ${i} crashed: ${err instanceof Error ? err.message : String(err)}`));
+        summary.iterationResults.push({
+          iteration: i,
+          output: `Error: ${err instanceof Error ? err.message : String(err)}`,
+          exitReason: "error",
+          costUsd: 0,
+          tokens: 0,
+          durationMs: 0,
+          specMet: false
+        });
+      }
+      if (summary.specMet) break;
+    }
+    console.log(chalk22.cyan("\n  \u2500\u2500 Loop Summary \u2500\u2500"));
+    console.log(chalk22.white("  Iterations:"), summary.totalIterations);
+    console.log(chalk22.white("  Total cost:"), `$${summary.totalCostUsd.toFixed(4)}`);
+    console.log(chalk22.white("  Total tokens:"), summary.totalTokens.toLocaleString());
+    console.log(chalk22.white("  Total time:"), `${(summary.totalDurationMs / 1e3).toFixed(1)}s`);
+    console.log(
+      chalk22.white("  Spec met:"),
+      summary.specMet ? chalk22.green("YES") : chalk22.red("NO")
+    );
+    console.log("");
+    await store.close();
+    process.exit(summary.specMet ? 0 : 1);
+  });
+}
+
 // src/index.ts
 function checkBetaAccess() {
   const licenseFile = join29(homedir12(), ".nestor", "license.key");
-  if (!existsSync25(licenseFile)) return false;
-  const key = readFileSync25(licenseFile, "utf-8").trim();
+  if (!existsSync26(licenseFile)) return false;
+  const key = readFileSync26(licenseFile, "utf-8").trim();
   return /^NESTOR-BETA-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$/.test(key);
 }
 var command2 = process.argv[2];
@@ -173373,7 +174366,7 @@ if (command2 && !["--help", "-h", "--version", "-V", "install"].includes(command
   }
 }
 var program = new Command();
-program.name("nestor-sh").description("Nestor AI Agent Platform \u2014 orchestrate, secure and monitor AI agents").version("2.7.1");
+program.name("nestor-sh").description("Nestor AI Agent Platform \u2014 orchestrate, secure and monitor AI agents").version("2.9.0");
 registerStartCommand(program);
 registerInstallCommand(program);
 registerAgentCommand(program);
@@ -173393,6 +174386,7 @@ registerTemplateCommand(program);
 registerRagCommand(program);
 registerTestCommand(program);
 registerGuardrailCommand(program);
+registerLoopCommand(program);
 var args = process.argv.slice(2);
 if (args.length === 0) {
   Promise.resolve().then(() => (init_shell(), shell_exports)).then(({ registerShellCommand: _ }) => {