@evandu/super-pi 0.1.145 → 0.1.147

package/dist/server/turn-failure.d.ts

@@ -19,4 +19,30 @@
  * needs no server, socket or Pi process.
  */
 export declare function formatTurnFailure(error: unknown): string;
+/**
+ * THE MODEL FILLED ITS OUTPUT BUDGET AND STOPPED MID-ANSWER.
+ *
+ * A length stop is NOT a crash. The provider answered, streamed real text, and stopped because it
+ * ran out of `max_tokens` - which is what happens every time an answer is longer than one output
+ * budget. Treating it as a failure is what made an orchestrated child session die: the run service
+ * stamped the conversation `failed`, the orchestrator reported a failure to the parent, and a task
+ * that was one sentence from done was thrown away.
+ *
+ * It carries a CLASS so the layers above can tell it apart from a provider error by identity rather
+ * than by matching a Chinese substring - the message is written for a reader, and a reader-facing
+ * sentence is not a reliable machine contract.
+ */
+export declare class LengthExceededError extends Error {
+    readonly stopReason: "length";
+    constructor(message?: string);
+}
+/**
+ * Whether this failure is a length stop rather than a real failure.
+ *
+ * The class is the answer; the message match is the BACKSTOP for a throw site that never got to
+ * construct the class - an error that crossed a process boundary, or one that was rebuilt from its
+ * text somewhere along the way. Both are checked because a length stop that loses its class on the
+ * way up is exactly the case that used to kill a child session.
+ */
+export declare function isLengthExceededError(error: unknown): boolean;
 export declare function controllerAborted(error: unknown): boolean;

package/dist/server/turn-failure.js

@@ -43,7 +43,9 @@ export function formatTurnFailure(error) {
     // WORKSPACE PATH - turn refused on directory the contract forbids. Refusal happens before
     // anything is on screen, so the banner is also the only place the reason lives.
     if (lower.includes("workspace directory") || lower.includes("does not exist or is not a directory")) {
-        return `工作区目录无效：${raw}`;
+        const match = raw.match(/does not exist or is not a directory:\s*(.+?)(?:\.\s*Refusing|$)/);
+        const path = match?.[1]?.trim();
+        return `工作区目录不存在：${path || "未知路径"}`;
     }
     // PROVIDER UNREACHABLE - the request never reached the model. This is the branch a custom
     // provider with a wrong Base URL lands in, and the person editing that URL needs to be told that
@@ -63,15 +65,79 @@ export function formatTurnFailure(error) {
     if (code >= 500 && code <= 599 || /internal server error|bad gateway|service unavailable|gateway timeout/.test(lower)) {
         return `模型供应商服务端出错了${code ? `（HTTP ${code}）` : ""}，通常稍后重试即可。`;
     }
+    // CONTEXT OVERFLOW - the conversation outgrew the model's window.
+    //
+    // This is the branch a reader hits when the session stops working entirely, so it has to name the
+    // cause AND the way out. The upstream wording varies by provider, and the shapes that show up are
+    // "context length exceeded", "maximum context length", "too many tokens", "prompt is too long",
+    // "reduce the length of the messages", and the 400s some providers use for it.
+    //
+    // The action is the same in every case: the conversation is too long for one request, and the
+    // reader's choices are to start a new conversation or use a model with a bigger window. Saying
+    // "the model refused" would hide both.
+    if (/context[\s_]*(?:length|window|size)[\s_]*(?:exceeded|exceeds|too large|limit)|maximum context|context limit|too many tokens|prompt is too long|reduce the length of the messages|exceeds the maximum|上下文(?:超|过)限|上下文长度/.test(lower)) {
+        return "这一轮的内容超过了模型的上下文上限，模型没能读下整段对话。可以新开一个会话继续，或换一个上下文窗口更大的模型（Pi 会在超限前自动压缩，这轮没能完成压缩）。";
+    }
     // IMAGE MISMATCH - explicit by the caller, no need to translate.
     if (lower.includes("不支持图片输入")) {
         return raw;
     }
+    // LENGTH LIMIT - the model stopped because it filled the output budget, NOT because anything
+    // broke. The answer is incomplete, but everything that was said is still on screen, so the
+    // sentence has to offer the way out (say "continue") instead of calling it a failure.
+    //
+    // THE SENTENCE IS BUILT, NOT TAKEN FROM THE ERROR. The error's own message says the fact
+    // ("模型输出达到本轮长度上限，回答未完成") and stops there - which is a statement, not an action, and
+    // a reader who is told a thing stopped has no idea what to do next. What they need is the way
+    // out, so the sentence always carries it. Pi's own words are kept only when they add something
+    // the sentence does not already say.
+    if (isLengthExceededError(error)) {
+        const detail = raw && !/长度上限/.test(raw) ? `（${raw}）` : "";
+        return `模型单次输出达到长度上限，回答没有写完${detail}。可以点「继续写完」或者自己发一句「继续」，模型会从被截断的地方接着写。`;
+    }
     // GENERIC - the literal message is more useful than a paraphrase, but it has to be the LAST
     // branch and the message has to be non-empty (a thrown `new Error()` is empty and renders
     // nothing, which is exactly the silence this whole change exists to break).
     return raw || "Pi 未能完成本轮回答，已标记为失败。可以重发任务继续。";
 }
+/**
+ * THE MODEL FILLED ITS OUTPUT BUDGET AND STOPPED MID-ANSWER.
+ *
+ * A length stop is NOT a crash. The provider answered, streamed real text, and stopped because it
+ * ran out of `max_tokens` - which is what happens every time an answer is longer than one output
+ * budget. Treating it as a failure is what made an orchestrated child session die: the run service
+ * stamped the conversation `failed`, the orchestrator reported a failure to the parent, and a task
+ * that was one sentence from done was thrown away.
+ *
+ * It carries a CLASS so the layers above can tell it apart from a provider error by identity rather
+ * than by matching a Chinese substring - the message is written for a reader, and a reader-facing
+ * sentence is not a reliable machine contract.
+ */
+export class LengthExceededError extends Error {
+    stopReason = "length";
+    constructor(message) {
+        super(message || "模型输出达到本轮长度上限，回答未完成。");
+        this.name = "LengthExceededError";
+    }
+}
+/**
+ * Whether this failure is a length stop rather than a real failure.
+ *
+ * The class is the answer; the message match is the BACKSTOP for a throw site that never got to
+ * construct the class - an error that crossed a process boundary, or one that was rebuilt from its
+ * text somewhere along the way. Both are checked because a length stop that loses its class on the
+ * way up is exactly the case that used to kill a child session.
+ */
+export function isLengthExceededError(error) {
+    if (!error)
+        return false;
+    if (error instanceof LengthExceededError)
+        return true;
+    if (error?.stopReason === "length")
+        return true;
+    const msg = error instanceof Error ? error.message : typeof error === "string" ? error : "";
+    return msg.includes("模型输出达到本轮长度上限") || msg.includes("达到本轮长度上限") || msg.includes("单次输出达到长度上限");
+}
 export function controllerAborted(error) {
     if (!error)
         return false;

package/dist/server/types.d.ts

@@ -18,7 +18,7 @@ import type { ScheduledTask } from "./scheduled-tasks.js";
  * `failed` is what any unhandled throw lands (with `Conversation.error` carrying the translated reason);
  * `completed` is the clean path.
  */
-export type RunStatus = "idle" | "waiting" | "running" | "completed" | "stopped" | "failed";
+export type RunStatus = "idle" | "waiting" | "running" | "awaiting_background" | "completed" | "stopped" | "failed";
 export type MessageRole = "user" | "assistant" | "tool" | "system";
 /**
  * One message in `state.json`.
@@ -464,6 +464,12 @@ export type Conversation = {
     status: RunStatus;
     messages: Message[];
     archivedAt?: string;
+    /** Cumulative primary-assistant usage observed since readout collection began; excludes subagents. */
+    usage?: SubagentUsage;
+    /** False means cost is only a sum of reported costs, not a complete price (zero is not "free"). */
+    usageCostKnown?: boolean;
+    contextUsage?: ConversationContextUsage;
+    usageUpdatedAt?: string;
     /** Transport projection only: false means messages were omitted, rather than an empty transcript. */
     messagesLoaded?: boolean;
     /** Pending question summary, retained when a focused snapshot omits this conversation's messages. */
@@ -488,6 +494,20 @@ export type Conversation = {
      * would answer "what happened" with something the reader has to go and decode.
      */
     error?: string;
+    /**
+     * WHY THIS CONVERSATION'S LAST ANSWER IS INCOMPLETE - in words a person reads.
+     *
+     * A WARNING, not a failure. The model filled its single-response output budget and stopped
+     * mid-answer; everything it said is on screen, and the conversation is still usable. It is a
+     * separate field from `error` because the two mean different things to the reader: `error` says
+     * "this run broke, here is why", this says "this answer was cut short, and here is what to do
+     * about it". Collapsing them would paint a recoverable truncation as a crash - which is exactly
+     * what made an orchestrated child session die.
+     *
+     * Cleared by the next turn, the same way `error` is: it describes the turn that just ended and
+     * must never outlive it.
+     */
+    warning?: string;
     /**
      * WHY THIS CONVERSATION IS NOT ON THE MODEL THE USER SET FOR IT - in words a person reads.
      *
@@ -519,6 +539,8 @@ export type Conversation = {
      * deleted agent degrades to "no role" instead of leaving a stale snapshot in state.json.
      */
     agentId?: string;
+    /** Relative to the workspace root. Absent or empty preserves the original workspace-root cwd. */
+    cwd?: string;
     /**
      * The conversation that opened this one, when an orchestrator agent created it. Absent for a
      * conversation the user started. This is the session tree's edge, and it PERSISTS: the sidebar
@@ -655,6 +677,12 @@ export type SubagentUsage = {
     cost: number;
     turns: number;
 };
+/** Current context occupancy, distinct from cumulative billed tokens; null means unknown after compaction. */
+export type ConversationContextUsage = {
+    tokens: number | null;
+    contextWindow: number;
+    percent: number | null;
+};
 /**
  * ONE TOOL CALL, as the card shows it, and the boundary that keeps a child's turn out of `state.json`.
  *
@@ -1022,6 +1050,7 @@ export type ClientCommandBody =
     type: "terminal.open";
     sessionId: string;
     workspaceId: string;
+    cwd?: string;
     cols?: number;
     rows?: number;
 }
@@ -1182,6 +1211,7 @@ export type ClientCommandBody =
 } | {
     type: "conversation.create";
     workspaceId: string;
+    cwd?: string;
 } | {
     type: "conversation.select";
     conversationId: string;
@@ -1284,6 +1314,7 @@ export type ClientCommandBody =
  | {
     type: "files.index.subscribe";
     workspaceId?: string;
+    cwd?: string;
 } | {
     type: "state.subscribe";
     conversationId?: string;
@@ -1601,6 +1632,7 @@ export type ServerEvent = {
 } | {
     type: "files.index";
     workspaceId: string;
+    cwd?: string;
     version: number;
     changed: {
         path: string;

package/dist/server/version.d.ts

@@ -1,10 +1,33 @@
 import type { ServerVersionInfo } from "./types.js";
+export declare const UNKNOWN_VERSION = "0.0.0-unknown";
+/**
+ * Reads and validates the version string from a package.json located in the given directory.
+ */
+export declare function readPackageVersion(dir?: string): string | undefined;
+/**
+ * Resolves the version of Super Pi itself by searching relative to this module's location.
+ * In both development (`src/server/`) and production build (`dist/server/`), two levels up
+ * is the repository / package root containing package.json.
+ */
+export declare function resolveSelfVersion(fromDir?: string): string | undefined;
 /**
  * Initializes the version captured when this server process booted up.
+ * If the provided rootDir fails to yield a valid package.json version,
+ * attempts to self-heal using the module's own location before falling back to UNKNOWN_VERSION.
+ */
+export declare function initRunningVersion(rootDir: string, selfFromDir?: string): string;
+/**
+ * Returns the currently running version captured in memory.
+ */
+export declare function getRunningVersion(): string;
+/**
+ * Resets the in-memory running version, primarily for testing purposes.
  */
-export declare function initRunningVersion(rootDir: string): string;
+export declare function resetRunningVersion(toVersion?: string): string;
 /**
  * Checks whether the package.json version on disk has been updated beyond
  * the version currently executing in this process.
+ * If rootDir fails to yield a valid package.json version, attempts to self-heal
+ * using the module's own location.
  */
-export declare function checkDiskVersion(rootDir: string): ServerVersionInfo;
+export declare function checkDiskVersion(rootDir: string, selfFromDir?: string): ServerVersionInfo;

package/dist/server/version.js

@@ -1,39 +1,111 @@
-import { readFileSync } from "node:fs";
-import { join } from "node:path";
-let runningVersion = "0.1.3";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+export const UNKNOWN_VERSION = "0.0.0-unknown";
 /**
- * Initializes the version captured when this server process booted up.
+ * Reads and validates the version string from a package.json located in the given directory.
  */
-export function initRunningVersion(rootDir) {
+export function readPackageVersion(dir) {
+    if (!dir || typeof dir !== "string")
+        return undefined;
     try {
-        const pkg = JSON.parse(readFileSync(join(rootDir, "package.json"), "utf8"));
-        if (pkg.version)
-            runningVersion = pkg.version;
+        const pkgPath = join(dir, "package.json");
+        if (!existsSync(pkgPath))
+            return undefined;
+        const raw = readFileSync(pkgPath, "utf8");
+        const pkg = JSON.parse(raw);
+        if (pkg && typeof pkg.version === "string" && pkg.version.trim().length > 0) {
+            return pkg.version.trim();
+        }
     }
     catch {
-        // fallback to default
+        // Read or JSON parse error - return undefined to allow self-healing / fallback
+    }
+    return undefined;
+}
+/**
+ * Resolves the version of Super Pi itself by searching relative to this module's location.
+ * In both development (`src/server/`) and production build (`dist/server/`), two levels up
+ * is the repository / package root containing package.json.
+ */
+export function resolveSelfVersion(fromDir = import.meta.dirname) {
+    if (!fromDir || typeof fromDir !== "string")
+        return undefined;
+    // Primary path: two levels up from server module directory (src/server or dist/server)
+    const canonicalRoot = resolve(fromDir, "../..");
+    const canonicalVersion = readPackageVersion(canonicalRoot);
+    if (canonicalVersion)
+        return canonicalVersion;
+    // Secondary path: walk upwards to locate the nearest directory containing Super Pi's package.json
+    let current = resolve(fromDir);
+    while (true) {
+        try {
+            const pkgPath = join(current, "package.json");
+            if (existsSync(pkgPath)) {
+                const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+                if (pkg && pkg.name === "@evandu/super-pi" && typeof pkg.version === "string" && pkg.version.trim()) {
+                    return pkg.version.trim();
+                }
+            }
+        }
+        catch {
+            // Continue searching upwards
+        }
+        const parent = dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return undefined;
+}
+let runningVersion = resolveSelfVersion() ?? UNKNOWN_VERSION;
+/**
+ * Initializes the version captured when this server process booted up.
+ * If the provided rootDir fails to yield a valid package.json version,
+ * attempts to self-heal using the module's own location before falling back to UNKNOWN_VERSION.
+ */
+export function initRunningVersion(rootDir, selfFromDir = import.meta.dirname) {
+    const direct = readPackageVersion(rootDir);
+    if (direct) {
+        runningVersion = direct;
+        return runningVersion;
+    }
+    const self = resolveSelfVersion(selfFromDir);
+    if (self) {
+        runningVersion = self;
+        return runningVersion;
     }
+    runningVersion = UNKNOWN_VERSION;
+    return runningVersion;
+}
+/**
+ * Returns the currently running version captured in memory.
+ */
+export function getRunningVersion() {
+    return runningVersion;
+}
+/**
+ * Resets the in-memory running version, primarily for testing purposes.
+ */
+export function resetRunningVersion(toVersion) {
+    runningVersion = toVersion ?? resolveSelfVersion() ?? UNKNOWN_VERSION;
     return runningVersion;
 }
 /**
  * Checks whether the package.json version on disk has been updated beyond
  * the version currently executing in this process.
+ * If rootDir fails to yield a valid package.json version, attempts to self-heal
+ * using the module's own location.
  */
-export function checkDiskVersion(rootDir) {
-    try {
-        const pkg = JSON.parse(readFileSync(join(rootDir, "package.json"), "utf8"));
-        const diskVersion = pkg.version ?? runningVersion;
-        return {
-            runningVersion,
-            diskVersion,
-            needsRestart: diskVersion !== runningVersion,
-        };
-    }
-    catch {
-        return {
-            runningVersion,
-            diskVersion: runningVersion,
-            needsRestart: false,
-        };
-    }
+export function checkDiskVersion(rootDir, selfFromDir = import.meta.dirname) {
+    const diskVersion = readPackageVersion(rootDir) ??
+        resolveSelfVersion(selfFromDir) ??
+        runningVersion;
+    const needsRestart = Boolean(diskVersion !== runningVersion &&
+        runningVersion !== UNKNOWN_VERSION &&
+        diskVersion !== UNKNOWN_VERSION);
+    return {
+        runningVersion,
+        diskVersion,
+        needsRestart,
+    };
 }

package/dist/server/ws-server.d.ts

@@ -71,7 +71,7 @@ export declare class WsBroadcaster implements EventBroadcaster {
     unregister(socket: WebSocket): void;
     subscribe(socket: WebSocket, conversationId?: string): void;
     sendState(socket: WebSocket): void;
-    subscribeFileIndex(socket: WebSocket, workspaceId?: string): void;
+    subscribeFileIndex(socket: WebSocket, workspaceId?: string, cwd?: string): void;
     private receives;
     configureStreaming(socket: WebSocket, coalesce: boolean): void;
     private flushStreaming;

package/dist/server/ws-server.js

@@ -116,9 +116,9 @@ export class WsBroadcaster {
         this.flushStreaming(socket);
         safeSend(socket, JSON.stringify({ type: "state", state: this.getState(this.scopes.get(socket)) }));
     }
-    subscribeFileIndex(socket, workspaceId) {
+    subscribeFileIndex(socket, workspaceId, cwd = "") {
         if (workspaceId)
-            this.fileIndexScopes.set(socket, workspaceId);
+            this.fileIndexScopes.set(socket, { workspaceId, cwd });
         else
             this.fileIndexScopes.delete(socket);
     }
@@ -127,8 +127,10 @@ export class WsBroadcaster {
         if (!scope)
             return true;
         switch (event.type) {
-            case "files.index":
-                return this.fileIndexScopes.get(socket) === event.workspaceId;
+            case "files.index": {
+                const fileScope = this.fileIndexScopes.get(socket);
+                return fileScope?.workspaceId === event.workspaceId && fileScope.cwd === (event.cwd ?? "");
+            }
             case "message.delta":
             case "message.thinking":
             case "message.tools":
@@ -481,7 +483,7 @@ export class WsServer {
                     return;
                 }
                 if (parsed.type === "files.index.subscribe") {
-                    this.broadcaster.subscribeFileIndex(socket, typeof parsed.workspaceId === "string" ? parsed.workspaceId : undefined);
+                    this.broadcaster.subscribeFileIndex(socket, typeof parsed.workspaceId === "string" ? parsed.workspaceId : undefined, typeof parsed.cwd === "string" ? parsed.cwd : "");
                     return;
                 }
                 if (parsed.type === "stream.configure") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evandu/super-pi",
-  "version": "0.1.145",
+  "version": "0.1.147",
   "description": "Web control plane and companion for Pi",
   "license": "MIT",
   "type": "module",
@@ -51,6 +51,7 @@
     "scripts/inline-thinking.test.mjs",
     "scripts/inline-thinking-close-tag.test.mjs",
     "scripts/pi-session.test.mjs",
+    "scripts/length-continuation.test.mjs",
     "scripts/pi-session-isolation.test.mjs",
     "scripts/installed-layout.test.mjs",
     "scripts/pi-model-switch.test.mjs",
@@ -67,6 +68,7 @@
     "scripts/verify-source-text.test.mjs",
     "scripts/runtime-extension-ui.test.mjs",
     "scripts/agent-mechanism.test.mjs",
+    "scripts/super-pi-tool-names.test.mjs",
     "scripts/agent-wiring.test.mjs",
     "scripts/message-timestamps.test.mjs",
     "scripts/pi-resolution.test.mjs",
@@ -83,6 +85,8 @@
     "scripts/session-tree-collapse.test.mjs",
     "scripts/archive-cascade.test.mjs",
     "scripts/workspace-cwd.test.mjs",
+    "scripts/session-cwd.test.mjs",
+    "scripts/session-cwd-panels.test.mjs",
     "scripts/subagents.test.mjs",
     "scripts/subagent-noise.test.mjs",
     "scripts/subagent-response-receipt.test.mjs",
@@ -99,6 +103,7 @@
     "scripts/queue-store.test.mjs",
     "scripts/git-api.test.mjs",
     "scripts/turn-failure-marks-failed.test.mjs",
+    "scripts/model-context-window.test.mjs",
     "scripts/update-ui-contract.test.mjs",
     "scripts/temp-sweep.test.mjs",
     "scripts/workspace-identity.test.mjs",
@@ -188,11 +193,30 @@
     "scripts/document-write-overwrite.test.mjs",
     "scripts/feishu.test.mjs",
     "scripts/scheduled-tasks.test.mjs",
+    "scripts/scheduled-tasks-timezone.test.mjs",
     "scripts/scheduled-task-model-clear.test.mjs",
     "scripts/scheduled-task-scope.test.mjs",
     "scripts/scheduled-task-tool.test.mjs",
     "scripts/run-state-sync.test.mjs",
-    "scripts/performance-architecture.test.mjs"
+    "scripts/performance-architecture.test.mjs",
+    "scripts/upgrade-from-138-browser.test.mjs",
+    "scripts/session-orchestrator-role-prompt.test.mjs",
+    "scripts/context-overflow-failure.test.mjs",
+    "scripts/spawn-workspace-boundary.test.mjs",
+    "scripts/cwd-agent-spawn.test.mjs",
+    "scripts/capabilities-prompt.test.mjs",
+    "scripts/version-fallback.test.mjs",
+    "scripts/model-image-input-session.test.mjs",
+    "scripts/conversation-usage.test.mjs",
+    "scripts/orchestrator-observability.test.mjs",
+    "scripts/session-tab-preview.test.mjs",
+    "scripts/knowledge-retrieval-quality.test.mjs",
+    "scripts/rail-ui-contract.test.mjs",
+    "scripts/session-tree-scope.test.mjs",
+    "scripts/session-spawn-model.test.mjs",
+    "scripts/background-result-steer.test.mjs",
+    "scripts/session-report-watchdog.test.mjs",
+    "scripts/awaiting-background-status.test.mjs"
   ],
   "check:browser": [
     "scripts/interrupt-browser.test.mjs",
@@ -231,6 +255,7 @@
     "scripts/archive-restore-race-browser.test.mjs",
     "scripts/tool-call-blocks-browser.test.mjs",
     "scripts/model-notice-browser.test.mjs",
+    "scripts/length-warning-browser.test.mjs",
     "scripts/dead-default-agent-browser.test.mjs",
     "scripts/assistant-working-indicator-browser.test.mjs",
     "scripts/thinking-first-delta-once-browser.test.mjs",
@@ -268,7 +293,15 @@
     "scripts/ux-polish-browser.test.mjs",
     "scripts/prompt-templates-browser.test.mjs",
     "scripts/documents-browser.test.mjs",
-    "scripts/feishu-browser.test.mjs"
+    "scripts/feishu-browser.test.mjs",
+    "scripts/session-read-state-regression.test.mjs",
+    "scripts/orchestrated-order-role-browser.test.mjs",
+    "scripts/result-file-link-browser.test.mjs",
+    "scripts/git-panel-confirm-browser.test.mjs",
+    "scripts/session-origin-badge-browser.test.mjs",
+    "scripts/rail-ui-layout-browser.test.mjs",
+    "scripts/session-landing-browser.test.mjs",
+    "scripts/responsive-rail-drawer-browser.test.mjs"
   ],
   "dependencies": {
     "@codemirror/commands": "^6.11.1",