instar 1.3.234 → 1.3.236

package/dist/server/routes.js

@@ -10,6 +10,8 @@ import { createHash, timingSafeEqual, randomUUID } from 'node:crypto';
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
+import { IntelligenceRouter } from '../core/IntelligenceRouter.js';
+import { knownComponents } from '../core/componentCategories.js';
 import { rateLimiter, signViewPath } from './middleware.js';
 import { writeLifelineRestartSignal } from '../core/version-skew.js';
 import { readSessionClocks } from '../core/SessionClockReader.js';
@@ -4025,6 +4027,74 @@ export function createRoutes(ctx) {
             events: ctx.resourceLedger.rateLimitEvents({ sinceMs: now - windowMs, limit: 200 }),
         });
     });
+    // ── Per-agent ResourceLedger (Phase B: CPU + memory samples) ─────────
+    // Read-only. Mirrors /tokens/summary: current + windowed CPU%/RSS per source
+    // (agent-server, each session, aggregate) + the total sample count. 503 when
+    // the ledger is unavailable (disabled / not initialized). Never gates.
+    router.get('/resources/summary', (req, res) => {
+        if (!ctx.resourceLedger) {
+            res.status(503).json({ error: 'resource ledger unavailable (disabled or not initialized)' });
+            return;
+        }
+        const sinceHours = req.query.sinceHours ? Number(req.query.sinceHours) : 1;
+        const windowHours = sinceHours && sinceHours > 0 ? sinceHours : 1;
+        const sinceMs = Date.now() - windowHours * 3_600_000;
+        res.json({
+            windowHours,
+            sinceMs,
+            sampleCount: ctx.resourceLedger.sampleCount(),
+            sources: ctx.resourceLedger.summary(sinceMs),
+        });
+    });
+    // Recent raw CPU/mem samples, newest first (paginated; ?limit= / ?source= /
+    // ?sinceHours=). Read-only.
+    router.get('/resources/samples', (req, res) => {
+        if (!ctx.resourceLedger) {
+            res.status(503).json({ error: 'resource ledger unavailable (disabled or not initialized)' });
+            return;
+        }
+        const sinceHours = req.query.sinceHours ? Number(req.query.sinceHours) : 1;
+        const windowHours = sinceHours && sinceHours > 0 ? sinceHours : 1;
+        const sinceMs = Date.now() - windowHours * 3_600_000;
+        let limit = 200;
+        if (typeof req.query.limit === 'string' && /^\d+$/.test(req.query.limit)) {
+            const n = Number(req.query.limit);
+            if (n > 0 && n <= 2000)
+                limit = n;
+        }
+        const source = typeof req.query.source === 'string' ? req.query.source : undefined;
+        res.json({
+            windowHours,
+            sinceMs,
+            limit,
+            samples: ctx.resourceLedger.recentSamples({ sinceMs, limit, source }),
+        });
+    });
+    // ── 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
+    // when no IntelligenceRouter is wired (e.g. no LLM CLI available).
+    router.get('/intelligence/routing', (_req, res) => {
+        const intel = ctx.intelligence;
+        if (!intel || !(intel instanceof IntelligenceRouter)) {
+            res.status(503).json({ error: 'intelligence router unavailable (no LLM provider configured)' });
+            return;
+        }
+        // '__nonexistent__' is not in the registry, so it resolves to category 'other'
+        // → the effective DEFAULT framework (what an unrouted call gets).
+        const defaultFramework = intel.for('__nonexistent__').framework;
+        const components = knownComponents().map((name) => intel.for(name));
+        res.json({
+            defaultFramework,
+            components,
+            coverage: {
+                known: components.length,
+                // how many known components are routed OFF the default framework right now
+                routedOffDefault: components.filter((c) => c.framework !== defaultFramework).length,
+            },
+            note: 'Routes INTERNAL component LLM calls only; spawned interactive sessions use topicFrameworks.',
+        });
+    });
     // ── Release-readiness (Layer B of release-readiness-visibility) ──────
     // Null when there's no analyzable instar git repo or the feature is off.
     router.get('/release-readiness', (_req, res) => {