@aexol/spectral 0.8.5 → 0.8.6

package/dist/server/paths.d.ts

@@ -9,9 +9,9 @@
  *    ourselves with a leading-segment check (NOT a global string replace —
  *    `~user/...` and embedded `~` are intentionally left alone).
  *  - Validation: the path must exist, must be a directory, and must be
- *    readable. We do NOT attempt to verify writability — pi may want to
+ *    readable. We do NOT attempt to verify writability — spectral may want to
  *    create files inside it, but failure modes there surface naturally
- *    through pi's tools, and a write probe here would create stray files.
+ *    through spectral's tools, and a write probe here would create stray files.
  *
  * Both helpers are synchronous because they're called on hot HTTP paths
  * (POST /api/projects) where blocking is acceptable: the operation is rare

package/dist/server/paths.js

@@ -9,9 +9,9 @@
  *    ourselves with a leading-segment check (NOT a global string replace —
  *    `~user/...` and embedded `~` are intentionally left alone).
  *  - Validation: the path must exist, must be a directory, and must be
- *    readable. We do NOT attempt to verify writability — pi may want to
+ *    readable. We do NOT attempt to verify writability — spectral may want to
  *    create files inside it, but failure modes there surface naturally
- *    through pi's tools, and a write probe here would create stray files.
+ *    through spectral's tools, and a write probe here would create stray files.
  *
  * Both helpers are synchronous because they're called on hot HTTP paths
  * (POST /api/projects) where blocking is acceptable: the operation is rare

package/dist/server/session-stream.d.ts

@@ -4,14 +4,14 @@
  * Background: prior to this module each WebSocket owned its own `AgentBridge`
  * instance and the routes layer enforced single-writer-wins (4001 eviction)
  * to keep that bridge unique per session. That model lost data on browser
- * refresh — the WS close torn down the pi process mid-stream, and a re-open
+ * refresh — the WS close torn down the spectral process mid-stream, and a re-open
  * couldn't recover what hadn't yet hit `agent_end` (and thus SQLite).
  *
  * New model:
  *   - Pi lifecycle is per **Spectral session**, not per WS.
  *   - 0..N WebSockets may attach to the same session simultaneously. Each
  *     gets the same broadcast stream of events.
- *   - When a WS detaches (close, error, refresh), the pi process keeps
+ *   - When a WS detaches (close, error, refresh), the spectral process keeps
  *     running. Closing every tab does NOT cancel the in-flight turn —
  *     it runs to completion and persists on `agent_end` as before.
  *   - On `attach`, the manager hands back a replay payload: full DB history
@@ -24,7 +24,7 @@
  *     for MVP.
  *
  * Failure modes:
- *   - Pi throws synchronously in `prompt()` → bridge surfaces as `error`
+ *   - spectral throws synchronously in `prompt()` → bridge surfaces as `error`
  *     event; manager broadcasts and clears `currentTurn`.
  *   - One subscriber's `ws.send` throws → caught, logged, removed from the
  *     subscriber set; broadcast continues to the rest.
@@ -33,7 +33,7 @@
  *
  * TODO (future): idle GC. A `SessionStream` with `subscribers.size === 0`
  *   and no current turn could be disposed after some grace window (e.g. 5
- *   minutes) to release pi resources for chronically-idle sessions. Skipped
+ *   minutes) to release spectral resources for chronically-idle sessions. Skipped
  *   for now — streams accumulate for the lifetime of the server process.
  */
 import { type AgentBridgeOptions } from "./agent-bridge.js";
@@ -59,7 +59,7 @@ export interface BridgeLike {
     prompt(text: string, images?: ImageAttachment[]): Promise<void>;
     dispose(): void;
     /**
-     * Manually compact the session context via pi's built-in compaction.
+     * Manually compact the session context via spectral's built-in compaction.
      * Fires compaction_start / compaction_end events through the bridge's
      * emit callback. Used by the Fork & Compact flow after the first
      * assistant turn of a forked session completes.
@@ -67,7 +67,7 @@ export interface BridgeLike {
     compact?(customInstructions?: string): Promise<void>;
     /**
      * Optional sticky reasoning effort. Maps frontend effort strings
-     * (xhigh|high|medium|low|minimal|none) to pi ThinkingLevel.
+     * (xhigh|high|medium|low|minimal|none) to spectral ThinkingLevel.
      */
     setReasoningEffort?(effort: string | undefined): void;
     /**
@@ -86,7 +86,7 @@ export interface BridgeLike {
      */
     getFirstAvailableModelId?(): string | undefined;
     /**
-     * Return current session context usage from pi's built-in estimator.
+     * Return current session context usage from spectral's built-in estimator.
      * Returns `undefined` when the bridge hasn't started yet or the model
      * has no context window configured.
      */
@@ -153,7 +153,7 @@ export interface SessionMemoryStatus {
 export interface AttachResult {
     history: WireMessage[];
     currentTurn: InProgressTurnSnapshot | null;
-    /** Resolves when the underlying pi session is ready (or rejects on start failure). */
+    /** Resolves when the underlying spectral session is ready (or rejects on start failure). */
     ready: Promise<void>;
     /** True when this session was created via "Fork & Compact" and has not yet
      *  triggered its first compaction. The dispatcher includes this in
@@ -169,18 +169,18 @@ export interface SessionStreamManagerOptions {
     /**
      * Fallback cwd used ONLY when a session has no resolvable project (which
      * shouldn't happen in normal operation since FK enforces it). Sessions
-     * with a valid project always run pi against `project.path`.
+     * with a valid project always run spectral against `project.path`.
      */
     cwd: string;
     /**
-     * Backend base URL — threaded into every AgentBridge so pi proxies all
+     * Backend base URL — threaded into every AgentBridge so spectral proxies all
      * inference through `${backendUrl}/v1` instead of reading
      * `~/.spectral/agent/auth.json`. Required in production; tests that supply a
      * `bridgeFactory` may pass any non-empty placeholder.
      */
     backendUrl: string;
     /**
-     * Machine JWT — used as the Bearer credential pi sends to the backend
+     * Machine JWT — used as the Bearer credential spectral sends to the backend
      * proxy on every inference call. See `backendUrl` for context.
      */
     machineJwt: string;
@@ -198,7 +198,7 @@ export declare class SessionStreamManager {
     private disposed;
     constructor(opts: SessionStreamManagerOptions);
     /**
-     * Attach a subscriber to a session. Lazily creates the underlying pi
+     * Attach a subscriber to a session. Lazily creates the underlying spectral
      * session on first attach. The caller is responsible for sending the
      * initial `session_ready` frame using the returned replay payload (this
      * keeps wire-protocol concerns in the routes layer).
@@ -208,7 +208,7 @@ export declare class SessionStreamManager {
      */
     attach(sessionId: string, subscriber: Subscriber): AttachResult;
     /**
-     * Detach a subscriber. Idempotent. Does NOT dispose the underlying pi
+     * Detach a subscriber. Idempotent. Does NOT dispose the underlying spectral
      * session — even when subscribers reach zero, the in-flight turn must
      * complete and persist.
      */
@@ -226,8 +226,8 @@ export declare class SessionStreamManager {
     getSessionMemoryDetails(sessionId: string): WireSessionMemoryDetails;
     compactSession(sessionId: string): Promise<void>;
     /**
-     * Persist a user message and forward it to pi. Resolves after the user
-     * message is persisted + pi is invoked (NOT after the turn completes —
+     * Persist a user message and forward it to spectral. Resolves after the user
+     * message is persisted + spectral is invoked (NOT after the turn completes —
      * the turn lifetime is observed via the broadcast stream).
      *
      * Broadcast ordering:
@@ -242,15 +242,15 @@ export declare class SessionStreamManager {
      *   - When `modelId` is provided, we apply it via `bridge.setModel()` and
      *     persist to SQLite for cross-restart recovery, BEFORE invoking
      *     `bridge.prompt()`. If `setModel` fails (unknown model, registry
-     *     unavailable, pi-side error) the bridge has already emitted an
+     *     unavailable, agent-side error) the bridge has already emitted an
      *     `error` wire event and we drop the prompt to avoid running it
      *     against the wrong model.
      *   - When `modelId` is omitted, we look up SQLite. If a previous turn
      *     persisted a value, we reapply it on this turn (this is the
-     *     cross-restart recovery path: a fresh server process has lost pi's
+     *     cross-restart recovery path: a fresh server process has lost spectral's
      *     in-memory model state, so we re-pin from durable storage).
      *   - When neither envelope nor SQLite have a value, we leave model
-     *     selection to pi's own settings file (pre-Phase-3 behaviour).
+     *     selection to spectral's own settings file (pre-Phase-3 behaviour).
      */
     prompt(sessionId: string, content: string, modelId?: string, images?: ImageAttachment[], reasoningEffort?: string): Promise<void>;
     /**
@@ -273,7 +273,7 @@ export declare class SessionStreamManager {
     activeTurnCount(): number;
     /**
      * Cancel the in-flight turn for a session (user pressed Stop in the UI).
-     * Disposes the pi bridge and broadcasts `agent_end` so all subscribers
+     * Disposes the agent bridge and broadcasts `agent_end` so all subscribers
      * see the turn close. The stream itself is kept alive — the next user
      * message (via `prompt()`) will lazily create a fresh bridge.
      *
@@ -282,10 +282,10 @@ export declare class SessionStreamManager {
      */
     cancelTurn(sessionId: string): void;
     /**
-     * Tear down a single session's stream — disposes the pi bridge and clears
+     * Tear down a single session's stream — disposes the agent bridge and clears
      * subscribers. Idempotent. Called by the routes layer right before
      * `DELETE /api/sessions/:id` so the SQL cascade doesn't leave a zombie
-     * pi process driving events at a session that no longer exists.
+     * spectral process driving events at a session that no longer exists.
      *
      * Does NOT remove the session from the store — that's the caller's job.
      */
@@ -294,7 +294,7 @@ export declare class SessionStreamManager {
      * Tear down every stream whose session belongs to the given list of ids.
      * Used by the project-delete path: the route layer reads the project's
      * session ids from `deleteProject()` and passes them here BEFORE the SQL
-     * cascade fires, so no pi process ever observes the FK cascade.
+     * cascade fires, so no spectral process ever observes the FK cascade.
      */
     disposeProjectStreams(sessionIds: readonly string[]): void;
     /**
@@ -309,7 +309,7 @@ export declare class SessionStreamManager {
     setLoopActive(sessionId: string, active: boolean, originalPrompt?: string, maxIterations?: number, goal?: string): void;
     /**
      * Fork & Compact: trigger compaction after the first assistant turn of a
-     * forked session. Uses pi's built-in `compact()` which generates a summary
+     * forked session. Uses spectral's built-in `compact()` which generates a summary
      * of older context, retaining the most recent ~20K tokens (including the
      * user's new message + the assistant's response).
      *
@@ -326,11 +326,11 @@ export declare class SessionStreamManager {
      * so we poll stream.compacting briefly. If compaction hasn't started after
      * a short grace period, we check whether the context window exceeds the
      * threshold and proactively trigger compaction via the bridge (which
-     * invokes pi's full pipeline, including the session_before_compact hook
+     * invokes spectral's full pipeline, including the session_before_compact hook
      * where the observational memory extension provides its summary).
      *
      * A duplicate call from the extension's delayed compaction trigger is
-     * harmless — pi throws "Already compacted" which the extension catches.
+     * harmless — spectral throws "Already compacted" which the extension catches.
      */
     /**
      * Send the next prompt for an autonomous loop iteration, compacting first

package/dist/server/session-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-stream.d.ts","sourceRoot":"","sources":["../../src/server/session-stream.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-stream.d.ts","sourceRoot":"","sources":["../../src/server/session-stream.ts"],"names":[],"mappings":"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"}

package/dist/server/session-stream.js

@@ -4,14 +4,14 @@
  * Background: prior to this module each WebSocket owned its own `AgentBridge`
  * instance and the routes layer enforced single-writer-wins (4001 eviction)
  * to keep that bridge unique per session. That model lost data on browser
- * refresh — the WS close torn down the pi process mid-stream, and a re-open
+ * refresh — the WS close torn down the spectral process mid-stream, and a re-open
  * couldn't recover what hadn't yet hit `agent_end` (and thus SQLite).
  *
  * New model:
  *   - Pi lifecycle is per **Spectral session**, not per WS.
  *   - 0..N WebSockets may attach to the same session simultaneously. Each
  *     gets the same broadcast stream of events.
- *   - When a WS detaches (close, error, refresh), the pi process keeps
+ *   - When a WS detaches (close, error, refresh), the spectral process keeps
  *     running. Closing every tab does NOT cancel the in-flight turn —
  *     it runs to completion and persists on `agent_end` as before.
  *   - On `attach`, the manager hands back a replay payload: full DB history
@@ -24,7 +24,7 @@
  *     for MVP.
  *
  * Failure modes:
- *   - Pi throws synchronously in `prompt()` → bridge surfaces as `error`
+ *   - spectral throws synchronously in `prompt()` → bridge surfaces as `error`
  *     event; manager broadcasts and clears `currentTurn`.
  *   - One subscriber's `ws.send` throws → caught, logged, removed from the
  *     subscriber set; broadcast continues to the rest.
@@ -33,7 +33,7 @@
  *
  * TODO (future): idle GC. A `SessionStream` with `subscribers.size === 0`
  *   and no current turn could be disposed after some grace window (e.g. 5
- *   minutes) to release pi resources for chronically-idle sessions. Skipped
+ *   minutes) to release spectral resources for chronically-idle sessions. Skipped
  *   for now — streams accumulate for the lifetime of the server process.
  */
 import { randomUUID } from "node:crypto";
@@ -54,13 +54,13 @@ const MAX_LOOP_ITERATIONS = 100;
 const LOOP_COMPACTION_THRESHOLD_TOKENS = 50_000;
 /**
  * Defensive cap for fresh-bridge history replay when we already have a
- * persisted observational-memory snapshot. Pi's own compaction keeps a
+ * persisted observational-memory snapshot. spectral's own compaction keeps a
  * recent live tail verbatim and summarizes the older prefix; replaying the
  * entire SQLite transcript after restart defeats that and can explode the
  * next prompt. We therefore rehydrate only an approximate recent tail.
  *
  * Keep this conservative — the tail is rehydrated as raw user/assistant
- * messages PLUS pi reconstructs tool-result messages from events_jsonl,
+ * messages PLUS spectral reconstructs tool-result messages from events_jsonl,
  * so the actual context inflation is 3-8× the stored token estimate.
  */
 const REHYDRATION_TAIL_TOKEN_BUDGET = 20_000;
@@ -251,7 +251,7 @@ export class SessionStreamManager {
         });
     }
     /**
-     * Attach a subscriber to a session. Lazily creates the underlying pi
+     * Attach a subscriber to a session. Lazily creates the underlying spectral
      * session on first attach. The caller is responsible for sending the
      * initial `session_ready` frame using the returned replay payload (this
      * keeps wire-protocol concerns in the routes layer).
@@ -281,7 +281,7 @@ export class SessionStreamManager {
         };
     }
     /**
-     * Detach a subscriber. Idempotent. Does NOT dispose the underlying pi
+     * Detach a subscriber. Idempotent. Does NOT dispose the underlying spectral
      * session — even when subscribers reach zero, the in-flight turn must
      * complete and persist.
      */
@@ -454,11 +454,12 @@ export class SessionStreamManager {
         finally {
             if (stream.compacting)
                 stream.compacting = false;
+            this.maybeAutoDequeue(stream);
         }
     }
     /**
-     * Persist a user message and forward it to pi. Resolves after the user
-     * message is persisted + pi is invoked (NOT after the turn completes —
+     * Persist a user message and forward it to spectral. Resolves after the user
+     * message is persisted + spectral is invoked (NOT after the turn completes —
      * the turn lifetime is observed via the broadcast stream).
      *
      * Broadcast ordering:
@@ -473,15 +474,15 @@ export class SessionStreamManager {
      *   - When `modelId` is provided, we apply it via `bridge.setModel()` and
      *     persist to SQLite for cross-restart recovery, BEFORE invoking
      *     `bridge.prompt()`. If `setModel` fails (unknown model, registry
-     *     unavailable, pi-side error) the bridge has already emitted an
+     *     unavailable, agent-side error) the bridge has already emitted an
      *     `error` wire event and we drop the prompt to avoid running it
      *     against the wrong model.
      *   - When `modelId` is omitted, we look up SQLite. If a previous turn
      *     persisted a value, we reapply it on this turn (this is the
-     *     cross-restart recovery path: a fresh server process has lost pi's
+     *     cross-restart recovery path: a fresh server process has lost spectral's
      *     in-memory model state, so we re-pin from durable storage).
      *   - When neither envelope nor SQLite have a value, we leave model
-     *     selection to pi's own settings file (pre-Phase-3 behaviour).
+     *     selection to spectral's own settings file (pre-Phase-3 behaviour).
      */
     async prompt(sessionId, content, modelId, images, reasoningEffort) {
         if (this.disposed)
@@ -531,7 +532,7 @@ export class SessionStreamManager {
                     this.store.deleteMessage(messageId);
                 },
                 onError: (err) => {
-                    console.error(`[spectral] error: pi bridge error: ${err.message}`);
+                    console.error(`[spectral] error: agent bridge error: ${err.message}`);
                 },
             };
             stream.bridge = this.bridgeFactory(bridgeOpts);
@@ -548,7 +549,7 @@ export class SessionStreamManager {
                 throw e;
             });
         }
-        // Wait for pi to be ready before we persist + invoke. If start failed,
+        // Wait for spectral to be ready before we persist + invoke. If start failed,
         // surface to all subscribers instead of throwing into the route handler.
         try {
             await stream.ready;
@@ -562,7 +563,7 @@ export class SessionStreamManager {
         // whitelist). Order:
         //   a) If envelope carried a `modelId`, use it.
         //   b) Else, look up the per-session persisted modelId in SQLite
-        //      (cross-restart recovery — server restart wipes pi's in-memory
+        //      (cross-restart recovery — server restart wipes spectral's in-memory
         //      session model state, but our durable store has the last value).
         //   c) Else, ask the bridge for the first available model from the
         //      backend whitelist (same sortOrder the frontend uses for its
@@ -602,7 +603,7 @@ export class SessionStreamManager {
         // Sticky reasoning-effort resolution. Same order as modelId:
         //   a) Envelope-supplied value → apply + persist.
         //   b) Otherwise, look up the persisted value from SQLite.
-        //   c) When neither is present, leave pi's current thinking level unchanged.
+        //   c) When neither is present, leave spectral's current thinking level unchanged.
         // We apply BEFORE persisting the user message so the turn runs with the
         // correct reasoning level.
         const effectiveReasoningEffort = reasoningEffort ?? this.store.getSessionReasoningEffort(sessionId) ?? undefined;
@@ -637,7 +638,7 @@ export class SessionStreamManager {
         // 2. Broadcast the persisted message so every tab — including the one
         //    that sent the prompt — appends an authoritative user turn.
         this.broadcast(stream, { type: "user_message_appended", message: stored });
-        // 3. Open a new in-flight turn. Allocated even before pi emits anything
+        // 3. Open a new in-flight turn. Allocated even before spectral emits anything
         //    so a re-attach immediately after `prompt` sees the turn.
         stream.currentTurn = {
             turnId: randomUUID(),
@@ -645,7 +646,7 @@ export class SessionStreamManager {
             events: [],
             assistantText: "",
         };
-        // 4. Fire pi. `prompt` resolves on agent_end; errors are handled inside
+        // 4. Fire spectral. `prompt` resolves on agent_end; errors are handled inside
         //    AgentBridge (it emits `error` for us). We don't await — broadcast is
         //    driven by the bridge's emit callback.
         void stream.bridge.prompt(content, images);
@@ -694,7 +695,7 @@ export class SessionStreamManager {
     }
     /**
      * Cancel the in-flight turn for a session (user pressed Stop in the UI).
-     * Disposes the pi bridge and broadcasts `agent_end` so all subscribers
+     * Disposes the agent bridge and broadcasts `agent_end` so all subscribers
      * see the turn close. The stream itself is kept alive — the next user
      * message (via `prompt()`) will lazily create a fresh bridge.
      *
@@ -712,12 +713,12 @@ export class SessionStreamManager {
         stream.loopGoal = null;
         stream.loopIterationCount = 0;
         // Capture whether a turn is in-flight BEFORE we dispose the bridge.
-        // dispose() tears down pi, which can cause the in-flight prompt()
+        // dispose() tears down spectral, which can cause the in-flight prompt()
         // promise to reject synchronously/microtask and emit an error event
         // through handleBridgeEvent — which clears currentTurn. We must
         // broadcast agent_end regardless of what dispose() does to currentTurn.
         const hadTurn = stream.currentTurn != null;
-        // Dispose the pi bridge immediately — this tears down pi's session and
+        // Dispose the agent bridge immediately — this tears down spectral's session and
         // unsubscribe. The bridge's own event handler is detached; no further
         // events will flow. We broadcast agent_end ourselves below.
         try {
@@ -738,10 +739,11 @@ export class SessionStreamManager {
         // Broadcast agent_end so all subscribers close their open turn and
         // re-enable their composers. Use the pre-disposal flag — dispose()
         // may have cleared currentTurn via an error event from the torn-down
-        // pi session.
+        // spectral session.
         if (hadTurn) {
             this.broadcast(stream, { type: "agent_end" });
             stream.currentTurn = null;
+            this.maybeAutoDequeue(stream);
         }
         // Don't delete the stream — the subscribers are still attached and the
         // next `prompt()` call will create a fresh bridge via `createStream()`.
@@ -749,10 +751,10 @@ export class SessionStreamManager {
         // recreate one.
     }
     /**
-     * Tear down a single session's stream — disposes the pi bridge and clears
+     * Tear down a single session's stream — disposes the agent bridge and clears
      * subscribers. Idempotent. Called by the routes layer right before
      * `DELETE /api/sessions/:id` so the SQL cascade doesn't leave a zombie
-     * pi process driving events at a session that no longer exists.
+     * spectral process driving events at a session that no longer exists.
      *
      * Does NOT remove the session from the store — that's the caller's job.
      */
@@ -771,7 +773,7 @@ export class SessionStreamManager {
             // ignore
         }
         // Best-effort: notify any still-open subscribers so they close cleanly
-        // rather than hanging on a dead pi process. We don't broadcast through
+        // rather than hanging on a dead spectral process. We don't broadcast through
         // `broadcast()` because that would re-enter the dead-subscriber pruning
         // loop on a stream we're about to drop anyway.
         for (const sub of stream.subscribers) {
@@ -791,7 +793,7 @@ export class SessionStreamManager {
      * Tear down every stream whose session belongs to the given list of ids.
      * Used by the project-delete path: the route layer reads the project's
      * session ids from `deleteProject()` and passes them here BEFORE the SQL
-     * cascade fires, so no pi process ever observes the FK cascade.
+     * cascade fires, so no spectral process ever observes the FK cascade.
      */
     disposeProjectStreams(sessionIds) {
         for (const sid of sessionIds) {
@@ -827,7 +829,7 @@ export class SessionStreamManager {
     }
     /**
      * Fork & Compact: trigger compaction after the first assistant turn of a
-     * forked session. Uses pi's built-in `compact()` which generates a summary
+     * forked session. Uses spectral's built-in `compact()` which generates a summary
      * of older context, retaining the most recent ~20K tokens (including the
      * user's new message + the assistant's response).
      *
@@ -861,6 +863,7 @@ export class SessionStreamManager {
                 // best-effort
             }
             console.log(`[spectral] fork-compact completed for ${stream.sessionId}`);
+            this.maybeAutoDequeue(stream);
         })
             .catch((err) => {
             stream.compacting = false;
@@ -877,6 +880,7 @@ export class SessionStreamManager {
             catch {
                 // best-effort
             }
+            this.maybeAutoDequeue(stream);
         });
     }
     /**
@@ -888,11 +892,11 @@ export class SessionStreamManager {
      * so we poll stream.compacting briefly. If compaction hasn't started after
      * a short grace period, we check whether the context window exceeds the
      * threshold and proactively trigger compaction via the bridge (which
-     * invokes pi's full pipeline, including the session_before_compact hook
+     * invokes spectral's full pipeline, including the session_before_compact hook
      * where the observational memory extension provides its summary).
      *
      * A duplicate call from the extension's delayed compaction trigger is
-     * harmless — pi throws "Already compacted" which the extension catches.
+     * harmless — spectral throws "Already compacted" which the extension catches.
      */
     /**
      * Send the next prompt for an autonomous loop iteration, compacting first
@@ -1019,14 +1023,14 @@ export class SessionStreamManager {
                 this.store.deleteMessage(messageId);
             },
             onError: (err) => {
-                console.error(`[spectral] error: pi bridge error: ${err.message}`);
+                console.error(`[spectral] error: agent bridge error: ${err.message}`);
             },
         };
         stream.bridge = this.bridgeFactory(bridgeOpts);
         stream.ready = stream.bridge
             .start()
             .then(() => {
-            // After pi has replayed history into its session manager, populate
+            // After spectral 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
@@ -1064,6 +1068,7 @@ export class SessionStreamManager {
                     }
                 }
             }
+            this.maybeAutoDequeue(stream);
         })
             .catch((err) => {
             const e = err instanceof Error ? err : new Error(String(err));
@@ -1080,7 +1085,7 @@ export class SessionStreamManager {
     }
     handleBridgeEvent(stream, event) {
         // Buffer replayable events into the in-flight turn. We intentionally
-        // accept events even if currentTurn is null (rare race: pi emits before
+        // accept events even if currentTurn is null (rare race: spectral emits before
         // prompt() opened the turn), in which case we open one defensively so
         // late attachers see the events. The first event in such a case is
         // typically `message_start`.
@@ -1131,7 +1136,7 @@ export class SessionStreamManager {
         // 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
+        // cumulative session-wide values from spectral's getContextUsage(). This lets
         // late-attaching subsribers (reconnects / multi-tab) get the latest
         // context window state via session_ready.
         if (event.type === "token_usage") {
@@ -1388,6 +1393,10 @@ export class SessionStreamManager {
      * Returns true if a prompt was dequeued and a turn started.
      */
     maybeAutoDequeue(stream) {
+        if (stream.currentTurn || stream.compacting)
+            return false;
+        if (stream.loopActive && stream.loopOriginalPrompt)
+            return false;
         const next = this.store.dequeuePrompt(stream.sessionId);
         if (!next)
             return false;

package/dist/server/shutdown.d.ts

@@ -23,12 +23,12 @@
  *     - Close the relay (code 1000, reason "shutdown") and dispose the
  *       manager. The dispose order matters: relay first so the backend
  *       sees a clean close before our local state goes; manager second so
- *       any pi processes get torn down deterministically.
+ *       any spectral processes get torn down deterministically.
  *     - Close the SQLite store (best-effort — a failure here just gets
  *       logged; the process is exiting anyway).
  *     - Exit with the supplied code (default 0).
  *  2. Second SIGINT/SIGTERM during the grace period: skip the wait, force
- *     immediate exit with code 1. We don't want a hung pi process to
+ *     immediate exit with code 1. We don't want a hung spectral process to
  *     prevent operators from killing the server with a second Ctrl-C.
  *
  * The function is intentionally framework-free — it takes plain callbacks
@@ -65,7 +65,7 @@ export interface GracefulShutdownOptions {
     inFlightCount?: () => number;
     /** Close the relay with code 1000 / reason "shutdown". */
     closeRelay?: () => void | Promise<void>;
-    /** Dispose the SessionStreamManager (kills pi processes). */
+    /** Dispose the SessionStreamManager (kills spectral processes). */
     disposeManager?: () => void | Promise<void>;
     /** Close the SQLite store. Failures are logged, not rethrown. */
     closeStore?: () => void;

package/dist/server/shutdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/server/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,EAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAEpD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACjD;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAaD,oEAAoE;AACpE,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,IAAI,CAAC,CAmGf"}
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/server/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,EAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAEpD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACjD;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAaD,oEAAoE;AACpE,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,IAAI,CAAC,CAmGf"}

package/dist/server/shutdown.js

@@ -23,12 +23,12 @@
  *     - Close the relay (code 1000, reason "shutdown") and dispose the
  *       manager. The dispose order matters: relay first so the backend
  *       sees a clean close before our local state goes; manager second so
- *       any pi processes get torn down deterministically.
+ *       any spectral processes get torn down deterministically.
  *     - Close the SQLite store (best-effort — a failure here just gets
  *       logged; the process is exiting anyway).
  *     - Exit with the supplied code (default 0).
  *  2. Second SIGINT/SIGTERM during the grace period: skip the wait, force
- *     immediate exit with code 1. We don't want a hung pi process to
+ *     immediate exit with code 1. We don't want a hung spectral process to
  *     prevent operators from killing the server with a second Ctrl-C.
  *
  * The function is intentionally framework-free — it takes plain callbacks
@@ -89,7 +89,7 @@ export async function gracefulShutdown(opts = {}) {
     entryCount += 1;
     // Second signal during a graceful shutdown: don't wait around, just go.
     // Code 1 signals "abnormal exit" — operators wanted out NOW, not after
-    // pi finishes its turn.
+    // spectral finishes its turn.
     if (entryCount > 1) {
         try {
             logger.error("Shutdown forced by repeated signal — exiting immediately.");

package/dist/server/storage.d.ts

@@ -19,7 +19,7 @@
  *
  * Foreign keys are enabled so DELETE FROM projects cascades to sessions
  * cascades to messages. The route layer must still tear down any in-flight
- * pi streams BEFORE deleting — see `SessionStreamManager.disposeProjectStreams`.
+ * agent streams BEFORE deleting — see `SessionStreamManager.disposeProjectStreams`.
  *
  * The repo is intentionally a thin wrapper. We do NOT expose `Database`
  * itself — callers go through the typed methods so we can swap the backend
@@ -130,7 +130,7 @@ export declare class SessionStore {
     updateProject(id: string, input: UpdateProjectInput): WireProject | null;
     /**
      * Delete a project. Cascades to sessions and messages via FK.
-     * Caller MUST tear down any active SessionStream subscribers / pi
+     * Caller MUST tear down any active SessionStream subscribers / spectral
      * processes for sessions in this project BEFORE invoking this.
      * Returns the list of session ids that belonged to the project (so
      * the caller can include them in the stream-teardown call).
@@ -172,8 +172,8 @@ export declare class SessionStore {
      * the session does not exist. The CLI uses this for cross-restart recovery:
      * when an envelope arrives WITHOUT a `modelId` but SQLite has a value
      * persisted from an earlier turn, we apply the persisted value before
-     * forwarding to pi. When neither envelope nor SQLite have a value, we
-     * leave model selection to pi's own settings file (pre-Phase-3 behaviour).
+     * forwarding to spectral. When neither envelope nor SQLite have a value, we
+     * leave model selection to spectral's own settings file (pre-Phase-3 behaviour).
      */
     getSessionModel(sessionId: string): string | null;
     /**