@aexol/spectral 0.4.3 → 0.4.8

package/dist/cli.js

@@ -75,21 +75,42 @@ function resolvePiBin() {
     }
     return resolve(dirname(piPkgJsonPath), binRel);
 }
-/** Absolute path to the bundled aexol-mcp extension, sitting next to this file in dist/. */
+/**
+ * Resolve an extension entry-point path, falling back from .js to .ts.
+ *
+ * In production __dirname is dist/ and compiled .js files exist. In dev
+ * (tsx src/cli.ts) __dirname is src/ and only .ts sources are present.
+ * pi's extension loader uses jiti which handles .ts transparently.
+ */
+function resolveExtensionEntry(relativePath, fileName) {
+    const dir = resolve(__dirname, relativePath);
+    const jsPath = resolve(dir, fileName + ".js");
+    if (existsSync(jsPath))
+        return jsPath;
+    const tsPath = resolve(dir, fileName + ".ts");
+    if (existsSync(tsPath))
+        return tsPath;
+    return jsPath; // let the missing-file check produce a clear error
+}
+/** Absolute path to the bundled aexol-mcp extension. */
 function resolveAexolExtensionPath() {
-    return resolve(__dirname, "extensions", "aexol-mcp.js");
+    return resolveExtensionEntry("extensions", "aexol-mcp");
 }
-/** Absolute path to the bundled observational-memory extension, sitting next to this file in dist/. */
+/** Absolute path to the bundled observations-memory extension. */
 function resolveObservationalMemoryPath() {
-    return resolve(__dirname, "memory", "index.js");
+    return resolveExtensionEntry("memory", "index");
 }
-/** Absolute path to the bundled pi-mcp-adapter extension, sitting next to this file in dist/. */
+/** Absolute path to the bundled pi-mcp-adapter extension. */
 function resolveMcpExtensionPath() {
-    return resolve(__dirname, "mcp", "index.js");
+    return resolveExtensionEntry("mcp", "index");
 }
-/** Absolute path to the bundled openrouter-attribution extension, sitting next to this file in dist/. */
+/** Absolute path to the bundled openrouter-attribution extension. */
 function resolveOpenRouterAttributionPath() {
-    return resolve(__dirname, "extensions", "openrouter-attribution.js");
+    return resolveExtensionEntry("extensions", "openrouter-attribution");
+}
+/** Absolute path to the bundled agent subagent extension. */
+function resolveAgentExtensionPath() {
+    return resolveExtensionEntry("agent", "index");
 }
 // ---- Branded helpers ---------------------------------------------------------
 function printVersion() {
@@ -228,7 +249,19 @@ async function main() {
         process.stderr.write(`spectral: bundled OpenRouter attribution extension not found at ${openrouterAttrPath}. This is a packaging bug.\n`);
         process.exit(1);
     }
-    const extFlags = ["--extension", aexolExtPath, "--extension", mcpExtPath, "--extension", obsMemPath, "--extension", openrouterAttrPath];
+    // Bundled agent delegation extension for subagent task delegation
+    const agentExtPath = resolveAgentExtensionPath();
+    if (!existsSync(agentExtPath)) {
+        process.stderr.write(`spectral: bundled agent extension not found at ${agentExtPath}. This is a packaging bug.\n`);
+        process.exit(1);
+    }
+    const extFlags = [
+        "--extension", aexolExtPath,
+        "--extension", mcpExtPath,
+        "--extension", obsMemPath,
+        "--extension", openrouterAttrPath,
+        "--extension", agentExtPath,
+    ];
     const finalArgs = [...extFlags, ...args];
     delegateToPi(finalArgs);
 }

package/dist/memory/hooks/observer-trigger.js

@@ -7,15 +7,23 @@ import { estimateStringTokens } from "../tokens.js";
 import { OBSERVATION_CUSTOM_TYPE, reflectionToPromptLine } from "../types.js";
 export function registerObserverTrigger(pi, runtime) {
     pi.on("turn_end", (_event, ctx) => {
+        process.stderr.write("[obs-mem] turn_end fired\n");
         runtime.ensureConfig(ctx.cwd);
-        if (runtime.config.passive === true)
+        if (runtime.config.passive === true) {
+            process.stderr.write("[obs-mem] passive=true → skipping\n");
             return;
-        if (runtime.observerInFlight)
+        }
+        if (runtime.observerInFlight) {
+            process.stderr.write("[obs-mem] observer already in flight → skipping\n");
             return;
+        }
         const entries = ctx.sessionManager.getBranch();
         const tokens = rawTokensSinceLastBound(entries);
-        if (tokens < runtime.config.observationThresholdTokens)
+        process.stderr.write(`[obs-mem] tokens since last bound: ${tokens} (threshold: ${runtime.config.observationThresholdTokens})\n`);
+        if (tokens < runtime.config.observationThresholdTokens) {
+            process.stderr.write("[obs-mem] below threshold → skipping observer\n");
             return;
+        }
         const lastBoundIdx = lastObservationCoverEndIdx(entries);
         const coversFromId = firstRawIdAfter(entries, lastBoundIdx);
         if (!coversFromId)

package/dist/memory/index.js

@@ -7,6 +7,8 @@ import { Runtime } from "./runtime.js";
 import { registerRecallTool } from "./tools/recall-observation.js";
 export default function observationalMemory(pi) {
     const runtime = new Runtime();
+    // Log extension load so we can confirm it's running in serve mode.
+    process.stderr.write("[obs-mem] extension loaded\n");
     registerObserverTrigger(pi, runtime);
     registerCompactionTrigger(pi, runtime);
     registerCompactionHook(pi, runtime);

package/dist/relay/dispatcher.js

@@ -489,6 +489,8 @@ export function handleClientMessage(frame, deps) {
                 history: attachResult.history,
                 currentTurn: attachResult.currentTurn,
                 forkCompactPending: attachResult.forkCompactPending || undefined,
+                contextWindowUsed: attachResult.contextWindowUsed,
+                contextWindowMax: attachResult.contextWindowMax,
             },
         });
         // Surface bridge-start failures as `error` events; otherwise the
@@ -561,6 +563,8 @@ export function handleSubscribe(frame, deps) {
             history: attachResult.history,
             currentTurn: attachResult.currentTurn,
             forkCompactPending: attachResult.forkCompactPending || undefined,
+            contextWindowUsed: attachResult.contextWindowUsed,
+            contextWindowMax: attachResult.contextWindowMax,
         },
     });
     if (isNewSubscriber) {

package/dist/relay/models-fetch.js

@@ -28,7 +28,7 @@ const cache = new Map();
 export function clearAllowedModelsCache() {
     cache.clear();
 }
-const QUERY = `query AvailableBaseModels { availableBaseModels { name provider userModelId agentEnabled creditInputPer1M creditOutputPer1M creditCachedInputPer1M creditCacheReadPer1M creditCacheWritePer1M } }`;
+const QUERY = `query AvailableBaseModels { availableBaseModels { name provider userModelId agentEnabled creditInputPer1M creditOutputPer1M creditCachedInputPer1M creditCacheReadPer1M creditCacheWritePer1M contextWindow } }`;
 /**
  * Fetch the whitelist of allowed base models. Throws on any failure with a
  * message tailored for an operator running `spectral serve` — the caller
@@ -98,6 +98,9 @@ export async function fetchAllowedModels(opts) {
         if (!name || !provider)
             continue; // skip malformed rows defensively
         const asOptionalNumber = (v) => typeof v === "number" ? v : v == null ? null : undefined;
+        const contextWindow = typeof row?.contextWindow === "number" && row.contextWindow > 0
+            ? row.contextWindow
+            : null;
         const model = {
             modelId: name,
             displayName: name,
@@ -107,6 +110,7 @@ export async function fetchAllowedModels(opts) {
             creditCachedInputPer1M: asOptionalNumber(row?.creditCachedInputPer1M),
             creditCacheReadPer1M: asOptionalNumber(row?.creditCacheReadPer1M),
             creditCacheWritePer1M: asOptionalNumber(row?.creditCacheWritePer1M),
+            contextWindow,
         };
         if (typeof row?.userModelId === "string") {
             model.userModelId = row.userModelId;

package/dist/server/pi-bridge.js

@@ -55,6 +55,7 @@ import { existsSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import aexolMcpExtension from "../extensions/aexol-mcp.js";
+import observationalMemory from "../memory/index.js";
 import { fetchAllowedModels as defaultFetchAllowedModels, } from "../relay/models-fetch.js";
 /**
  * Synthetic provider names registered with pi's `ModelRegistry`. They route
@@ -331,7 +332,7 @@ export class PiBridge {
     async start() {
         if (this.disposed)
             throw new Error("PiBridge already disposed");
-        const extensionFactories = [aexolMcpExtension];
+        const extensionFactories = [aexolMcpExtension, async (pi) => { observationalMemory(pi); }];
         // Load pi-mcp-adapter via jiti so tsc never crawls its .ts files in
         // node_modules. The static `import` was causing tsc to type-check
         // pi-mcp-adapter's source and fail the build on its type errors.
@@ -570,7 +571,7 @@ export class PiBridge {
                         cost: pricing
                             ? { input: pricing.input, output: pricing.output, cacheRead: pricing.cacheRead, cacheWrite: pricing.cacheWrite }
                             : { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
-                        contextWindow: 0,
+                        contextWindow: m.contextWindow ?? 0,
                         maxTokens: 0,
                     };
                 }),
@@ -600,7 +601,7 @@ export class PiBridge {
                         cost: pricing
                             ? { input: pricing.input, output: pricing.output, cacheRead: pricing.cacheRead, cacheWrite: pricing.cacheWrite }
                             : { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
-                        contextWindow: 0,
+                        contextWindow: m.contextWindow ?? 0,
                         maxTokens: 0,
                     };
                 }),
@@ -630,7 +631,7 @@ export class PiBridge {
                         cost: pricing
                             ? { input: pricing.input, output: pricing.output, cacheRead: pricing.cacheRead, cacheWrite: pricing.cacheWrite }
                             : { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
-                        contextWindow: 0,
+                        contextWindow: m.contextWindow ?? 0,
                         maxTokens: 0,
                     };
                 }),
@@ -964,6 +965,10 @@ export class PiBridge {
                     (usage?.cacheRead ?? 0) +
                     (usage?.cacheWrite ?? 0);
                 if (usage && totalTokens > 0) {
+                    // Resolve current context window usage from pi's built-in
+                    // `getContextUsage()`, which handles post-compaction ambiguity
+                    // and estimates total tokens from the full session tree.
+                    const ctxUsage = this.session?.getContextUsage();
                     const usageEvent = {
                         type: "token_usage",
                         messageId,
@@ -976,6 +981,8 @@ export class PiBridge {
                             cost: usage.cost?.total ?? null,
                             creditsUsed: calculateCredits(usage.input ?? 0, usage.output ?? 0, usage.cacheRead ?? 0, usage.cacheWrite ?? 0, this.activeCreditRates?.creditInputPer1M, this.activeCreditRates?.creditOutputPer1M, this.activeCreditRates?.creditCachedInputPer1M, this.activeCreditRates?.creditCacheReadPer1M, this.activeCreditRates?.creditCacheWritePer1M),
                         },
+                        contextWindowUsed: ctxUsage?.tokens ?? null,
+                        contextWindowMax: ctxUsage?.contextWindow ?? null,
                     };
                     this.pending.wireEvents.push(usageEvent);
                     this.opts.emit(usageEvent);
@@ -1040,11 +1047,12 @@ function detectMemorySystem(message) {
         return "memory_observer";
     if (lower.includes("compaction") || lower.includes("compact"))
         return "memory_compaction";
-    if (lower.includes("reflection"))
+    if (lower.includes("reflection") || lower.includes("reflect"))
         return "memory_reflection";
     if (lower.includes("pruner") || lower.includes("prune"))
         return "memory_pruner";
-    return "extension";
+    // Keep generic observational-memory messages visible in the landing badge.
+    return "memory_observer";
 }
 /**
  * Create a minimal ExtensionUIContext that forwards `notify()` calls as
@@ -1061,11 +1069,16 @@ function createHeadlessUIContext(emit) {
         get(_target, prop) {
             if (prop === "notify") {
                 return (message, type) => {
+                    const level = type ?? "info";
+                    const system = detectMemorySystem(message);
+                    if (system?.startsWith("memory_")) {
+                        console.info(`[PiBridge][memory][${level}] ${message}`);
+                    }
                     emit({
                         type: "agent_notification",
                         message,
-                        level: type ?? "info",
-                        system: detectMemorySystem(message),
+                        level,
+                        system,
                     });
                 };
             }

package/dist/server/session-stream.js

@@ -106,6 +106,8 @@ export class SessionStreamManager {
             currentTurn: stream.currentTurn ? snapshotTurn(stream.currentTurn) : null,
             ready: stream.ready,
             forkCompactPending: stream.forkCompactSourceId != null,
+            contextWindowUsed: stream.contextWindowUsed,
+            contextWindowMax: stream.contextWindowMax,
         };
     }
     /**
@@ -553,6 +555,8 @@ export class SessionStreamManager {
             loopOriginalPrompt: null,
             forkCompactSourceId: forkSourceId ?? null,
             compacting: false,
+            contextWindowUsed: null,
+            contextWindowMax: null,
         };
         const bridgeOpts = {
             cwd,
@@ -584,6 +588,46 @@ export class SessionStreamManager {
         stream.bridge = this.bridgeFactory(bridgeOpts);
         stream.ready = stream.bridge
             .start()
+            .then(() => {
+            // After pi has replayed history into its session manager, populate
+            // context window state from its built-in getContextUsage() estimator.
+            // Historical sessions need this — without it, the initial
+            // session_ready carries null fields and the context-window bar
+            // stays invisible until the user sends a new prompt.
+            const ctx = stream.bridge.getContextUsage?.();
+            if (ctx) {
+                stream.contextWindowUsed = ctx.tokens;
+                stream.contextWindowMax = ctx.contextWindow;
+                // Emit directly to subscribers (not via handleBridgeEvent, which
+                // would buffer the synthetic event into currentTurn). The frontend
+                // reducer's token_usage fallthrough updates session-level context
+                // window fields when no open turn exists.
+                for (const subscriber of stream.subscribers) {
+                    if (!subscriber.isOpen())
+                        continue;
+                    try {
+                        subscriber.send({
+                            type: "token_usage",
+                            messageId: "",
+                            usage: {
+                                inputTokens: 0,
+                                outputTokens: 0,
+                                cacheReadTokens: 0,
+                                cacheWriteTokens: 0,
+                                totalTokens: 0,
+                                cost: null,
+                                creditsUsed: 0,
+                            },
+                            contextWindowUsed: ctx.tokens,
+                            contextWindowMax: ctx.contextWindow,
+                        });
+                    }
+                    catch {
+                        // best-effort
+                    }
+                }
+            }
+        })
             .catch((err) => {
             const e = err instanceof Error ? err : new Error(String(err));
             stream.startError = e;
@@ -648,6 +692,17 @@ export class SessionStreamManager {
         // buffer because by that point the assistant message is already in
         // SQLite (PiBridge calls onAssistantMessageComplete on message_end,
         // which fires before agent_end).
+        //
+        // Track context window state from token_usage events — the bridge emits
+        // cumulative session-wide values from pi's getContextUsage(). This lets
+        // late-attaching subsribers (reconnects / multi-tab) get the latest
+        // context window state via session_ready.
+        if (event.type === "token_usage") {
+            if (event.contextWindowUsed != null)
+                stream.contextWindowUsed = event.contextWindowUsed;
+            if (event.contextWindowMax != null)
+                stream.contextWindowMax = event.contextWindowMax;
+        }
         this.broadcast(stream, event);
         if (event.type === "agent_end") {
             // Final flush + clear batch-persist tracking. `onAssistantMessageComplete`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexol/spectral",
-  "version": "0.4.3",
+  "version": "0.4.8",
   "description": "Always-on coding agent for Aexol — branded pi wrapper with relay-based browser access.",
   "type": "module",
   "private": false,