instar 1.3.236 → 1.3.238

package/dist/server/routes.js

@@ -3484,6 +3484,51 @@ export function createRoutes(ctx) {
         }
         res.json(ctx.mcpProcessReaper.snapshot());
     });
+    // GeminiLoopRunner (need-gem-002) — the multi-turn gemini loop-driver. Lets a
+    // caller hand the gemini mentee a goal it works across turns (turn 1 one-shot →
+    // resume by handle, no transcript re-send). A run can take minutes, so POST
+    // ADMITS + launches async and returns a runId immediately; GET polls the result.
+    // Subscription-auth only (the transport strips billing env). Ships DARK
+    // (autonomousSessions.geminiLoopDriver.enabled; developmentAgent gate turns it on
+    // for dev agents). 503 when not wired; 409 when disabled / at capacity / budget.
+    router.post('/gemini-loop/runs', (req, res) => {
+        if (!ctx.geminiLoopRunner) {
+            res.status(503).json({ error: 'gemini loop runner unavailable' });
+            return;
+        }
+        const { goalPrompt, model, maxTurns } = req.body ?? {};
+        if (!goalPrompt || typeof goalPrompt !== 'string') {
+            res.status(400).json({ error: 'goalPrompt (string) is required' });
+            return;
+        }
+        const outcome = ctx.geminiLoopRunner.startRun({ goalPrompt, model, maxTurns });
+        if (!outcome.ok) {
+            // disabled / at-capacity / budget / invalid → 409 (cannot admit right now)
+            const code = outcome.reason === 'invalid' ? 400 : 409;
+            res.status(code).json({ error: outcome.reason, detail: outcome.detail });
+            return;
+        }
+        res.status(202).json({ runId: outcome.runId, status: 'running' });
+    });
+    router.get('/gemini-loop/runs', (_req, res) => {
+        if (!ctx.geminiLoopRunner) {
+            res.status(503).json({ error: 'gemini loop runner unavailable' });
+            return;
+        }
+        res.json({ runs: ctx.geminiLoopRunner.listRuns(), active: ctx.geminiLoopRunner.activeRuns() });
+    });
+    router.get('/gemini-loop/runs/:id', (req, res) => {
+        if (!ctx.geminiLoopRunner) {
+            res.status(503).json({ error: 'gemini loop runner unavailable' });
+            return;
+        }
+        const run = ctx.geminiLoopRunner.getRun(req.params.id);
+        if (!run) {
+            res.status(404).json({ error: 'run not found' });
+            return;
+        }
+        res.json(run);
+    });
     // SleepController (RESPONSIBLE-RESOURCE-USAGE — agent hard-sleep, Stage B). The
     // pull-surface answer to "would this idle agent sleep right now, and if not,
     // which guard is holding it awake?": the live verdict (awake / idle-shallow /
@@ -4070,6 +4115,23 @@ export function createRoutes(ctx) {
             samples: ctx.resourceLedger.recentSamples({ sinceMs, limit, source }),
         });
     });
+    // ── Parallel-Work Awareness (docs/specs/parallel-activity-coherence.md, Phase A) ──
+    // Read-only cross-topic index: every topic with intent state + its current focus +
+    // high-specificity tags + whether a session is live on it. Signal-only; never gates.
+    // 503 when the index is unavailable (no stateDir / init failed).
+    router.get('/parallel-work/activities', (_req, res) => {
+        if (!ctx.parallelActivityIndex) {
+            res.status(503).json({ error: 'parallel-activity index unavailable (no stateDir or init failed)' });
+            return;
+        }
+        const activities = ctx.parallelActivityIndex.activities();
+        res.json({
+            count: activities.length,
+            runningCount: activities.filter((a) => a.running).length,
+            activities,
+            note: 'Cross-topic read over the existing Topic-Intent layer. The overlap sentinel (Phase B) ships separately.',
+        });
+    });
     // ── Per-component framework routing (docs/specs/per-component-framework-routing.md) ──
     // Read-only: what framework each known component resolves to right now (live config),
     // whether that framework is available, and the per-framework breaker isolation. 503