@glbgpt/cli 0.1.4 → 0.2.0

package/dist/src/core/compaction.d.ts

@@ -0,0 +1,52 @@
+import type { ChatBackend, ChatMessage } from './types.js';
+/**
+ * Context compaction (spec lineage: pi B1 blueprint, 2026-08-08 调研; implemented
+ * 2026-08-21). When a conversation approaches the model's context window, the older
+ * part is summarized into one structured note and only a recent tail keeps riding
+ * along. Same philosophy as microcompact (contextPrune.ts): the DECISION is stored
+ * on the session and applied as a request-time PROJECTION — raw messages are never
+ * edited, so resume/timeline/recovery keep the full history.
+ *
+ * Triggers:
+ * - proactive: last call's prompt_tokens crossed (context window - reserve);
+ * - reactive: a turn failed with a provider context-overflow error (regex set below)
+ *   → compact and retry once;
+ * - manual: /compact.
+ */
+export interface CompactionState {
+    /** Structured summary standing in for messages [tailStart..upToIndex) of the raw array. */
+    summary: string;
+    /** Raw-array index the summary covers up to (exclusive). Tail = messages[upToIndex..]. */
+    upToIndex: number;
+    createdAt: number;
+}
+export declare const DEFAULT_CONTEXT_WINDOW = 128000;
+/** Output + safety headroom subtracted from the window to get the trigger. */
+export declare const COMPACT_RESERVE_TOKENS = 24000;
+/** Token budget for the retained tail after a compaction. */
+export declare const RETAIN_TAIL_TOKENS = 20000;
+export declare function contextWindowFor(model: string, catalogOverride?: number): number;
+export declare function compactionTriggerTokens(model: string, catalogOverride?: number): number;
+/** Cheap token estimate (bytes/4) — same heuristic the pruning note uses. */
+export declare function estimateMessageTokens(m: ChatMessage): number;
+/** Count of consecutive system messages at the head (base prompts — always kept verbatim). */
+export declare function leadingSystemCount(messages: ChatMessage[]): number;
+/**
+ * Choose the compaction cut. Cut points are USER-turn starts only — that boundary can
+ * never split an assistant tool_calls message from its tool replies. Picks the earliest
+ * user index that keeps the tail within RETAIN_TAIL_TOKENS; falls back to the LAST user
+ * turn when even a single turn overflows the tail budget. Returns null when there is
+ * nothing worth compacting (too little history, or no meaningful advance over the
+ * existing compaction).
+ */
+export declare function planCompaction(messages: ChatMessage[], existing: CompactionState | null): {
+    cutIndex: number;
+} | null;
+/** The projection: leading system prompts + one summary note + the retained tail. */
+export declare function applyCompaction(messages: ChatMessage[], c: CompactionState | null): ChatMessage[];
+/**
+ * Summarize `toSummarize` (which already embeds any prior summary note via the
+ * projection) with a plain, tool-less model call. Returns the summary text.
+ */
+export declare function summarizeForCompaction(backend: ChatBackend, model: string, toSummarize: ChatMessage[], signal?: AbortSignal): Promise<string>;
+export declare function isContextOverflowError(message: string): boolean;

package/dist/src/core/compaction.js

@@ -0,0 +1,151 @@
+/**
+ * Context windows by model id prefix (longest match wins). Server catalog may later
+ * serve a per-model `context_window`; the catalog value takes precedence when present.
+ * Being wrong LOW just compacts early (harmless); being wrong HIGH is caught by the
+ * reactive overflow path.
+ */
+const CONTEXT_WINDOWS = [
+    ['kimi-', 1_000_000],
+    ['gemini-', 1_000_000],
+];
+export const DEFAULT_CONTEXT_WINDOW = 128_000;
+/** Output + safety headroom subtracted from the window to get the trigger. */
+export const COMPACT_RESERVE_TOKENS = 24_000;
+/** Token budget for the retained tail after a compaction. */
+export const RETAIN_TAIL_TOKENS = 20_000;
+/** A new compaction must advance the covered range by at least this many messages. */
+const MIN_ADVANCE_MESSAGES = 4;
+export function contextWindowFor(model, catalogOverride) {
+    if (typeof catalogOverride === 'number' && catalogOverride > 0)
+        return catalogOverride;
+    for (const [prefix, tokens] of CONTEXT_WINDOWS) {
+        if (model.startsWith(prefix))
+            return tokens;
+    }
+    return DEFAULT_CONTEXT_WINDOW;
+}
+export function compactionTriggerTokens(model, catalogOverride) {
+    return contextWindowFor(model, catalogOverride) - COMPACT_RESERVE_TOKENS;
+}
+/** Cheap token estimate (bytes/4) — same heuristic the pruning note uses. */
+export function estimateMessageTokens(m) {
+    const content = typeof m.content === 'string' ? m.content : m.content == null ? '' : JSON.stringify(m.content);
+    const extra = m.tool_calls ? JSON.stringify(m.tool_calls) : '';
+    return Math.ceil((Buffer.byteLength(content, 'utf8') + Buffer.byteLength(extra, 'utf8')) / 4);
+}
+/** Count of consecutive system messages at the head (base prompts — always kept verbatim). */
+export function leadingSystemCount(messages) {
+    let n = 0;
+    while (n < messages.length && messages[n].role === 'system')
+        n += 1;
+    return n;
+}
+/**
+ * Choose the compaction cut. Cut points are USER-turn starts only — that boundary can
+ * never split an assistant tool_calls message from its tool replies. Picks the earliest
+ * user index that keeps the tail within RETAIN_TAIL_TOKENS; falls back to the LAST user
+ * turn when even a single turn overflows the tail budget. Returns null when there is
+ * nothing worth compacting (too little history, or no meaningful advance over the
+ * existing compaction).
+ */
+export function planCompaction(messages, existing) {
+    const head = leadingSystemCount(messages);
+    const userIndexes = [];
+    for (let i = head; i < messages.length; i++) {
+        if (messages[i].role === 'user')
+            userIndexes.push(i);
+    }
+    // Need at least two turns: one to summarize away, one to retain.
+    if (userIndexes.length < 2)
+        return null;
+    // Suffix token sums, walked from the end: the first (earliest) user index whose
+    // tail fits the budget.
+    let cutIndex = userIndexes[userIndexes.length - 1]; // fallback: retain only the last turn
+    for (let k = 0; k < userIndexes.length; k++) {
+        const idx = userIndexes[k];
+        let tail = 0;
+        for (let i = idx; i < messages.length; i++)
+            tail += estimateMessageTokens(messages[i]);
+        if (tail <= RETAIN_TAIL_TOKENS) {
+            cutIndex = idx;
+            break;
+        }
+    }
+    const floor = Math.max(head, existing?.upToIndex ?? 0);
+    if (cutIndex <= floor + MIN_ADVANCE_MESSAGES - 1)
+        return null; // no meaningful advance
+    return { cutIndex };
+}
+/** The projection: leading system prompts + one summary note + the retained tail. */
+export function applyCompaction(messages, c) {
+    if (!c)
+        return messages;
+    const head = leadingSystemCount(messages);
+    const upTo = Math.min(c.upToIndex, messages.length);
+    return [
+        ...messages.slice(0, head),
+        {
+            role: 'system',
+            content: 'Earlier conversation was summarized to stay within the context limit ' +
+                '(the full history is kept locally):\n\n' +
+                c.summary,
+        },
+        ...messages.slice(Math.max(upTo, head)),
+    ];
+}
+const SUMMARIZE_SYSTEM = 'You summarize a conversation so it can continue seamlessly with the summary standing in ' +
+    'for the older messages. Write a dense, factual summary in the language the user has been ' +
+    'writing in. Use exactly these sections (markdown headers), omitting any that are empty:\n' +
+    '## Goal\nWhat the user is trying to accomplish overall.\n' +
+    '## Constraints & decisions\nRequirements, preferences, and decisions already made.\n' +
+    '## Progress\nWhat has been done so far, including tool actions and their outcomes.\n' +
+    '## Files\nFiles read or modified, with paths and what matters about each.\n' +
+    '## Next steps\nWhat remains or was about to happen.\n' +
+    'Never invent details. Keep concrete identifiers verbatim (paths, commands, URLs, ids, ' +
+    'numbers, code names). Do not add commentary about the summarization itself.';
+/**
+ * Summarize `toSummarize` (which already embeds any prior summary note via the
+ * projection) with a plain, tool-less model call. Returns the summary text.
+ */
+export async function summarizeForCompaction(backend, model, toSummarize, signal) {
+    const req = {
+        model,
+        messages: [
+            { role: 'system', content: SUMMARIZE_SYSTEM },
+            ...toSummarize,
+            {
+                role: 'user',
+                content: '[Summarize the conversation above following your instructions. Output ONLY the summary.]',
+            },
+        ],
+        stream: true,
+    };
+    let text = '';
+    for await (const chunk of backend.stream(req, signal)) {
+        const t = chunk.choices?.[0]?.delta?.content;
+        if (typeof t === 'string')
+            text += t;
+    }
+    const trimmed = text.trim();
+    if (trimmed.length === 0)
+        throw new Error('Compaction failed: the model returned an empty summary.');
+    return trimmed;
+}
+/**
+ * Provider context-overflow classification (subset of pi's overflow regex library,
+ * matched against the error text our backend relays from the upstream).
+ */
+const OVERFLOW_PATTERNS = [
+    /context.{0,20}(length|window)/i,
+    /maximum context/i,
+    /context_length_exceeded/i,
+    /prompt (is )?too long/i,
+    /input (is )?too long/i,
+    /too many tokens/i,
+    /token (count |limit )?exceed/i,
+    /exceeds? .{0,30}token/i,
+];
+export function isContextOverflowError(message) {
+    return OVERFLOW_PATTERNS.some((p) => p.test(message));
+}
+//# sourceMappingURL=compaction.js.map

package/dist/src/core/compaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.js","sourceRoot":"","sources":["../../../src/core/compaction.ts"],"names":[],"mappings":"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"}

package/dist/src/core/contextPrune.js

@@ -1,4 +1,5 @@
 import { FS_TOOL_NAMES } from '../fs/index.js';
+import { CODING_TOOL_NAMES } from '../coding/index.js';
 import { PRUNE_KEEP_RECENT, PRUNE_MIN_CONTENT_BYTES, PRUNE_PLACEHOLDER } from '../fs/limits.js';
 /**
  * Microcompact selection and projection (spec: 2026-07-19-context-pruning-design.md).
@@ -12,7 +13,13 @@ import { PRUNE_KEEP_RECENT, PRUNE_MIN_CONTENT_BYTES, PRUNE_PLACEHOLDER } from '.
  * Prunable = free to re-run. web_fetch joins the fs tools (local, no cost); web_search
  * does NOT — clearing its results would nudge the model into re-searching, which bills.
  */
-const PRUNABLE_TOOL_NAMES = new Set([...FS_TOOL_NAMES, 'web_fetch']);
+// Coding tool results are prunable too: bash output goes stale quickly, and edit/write
+// results are one-line confirmations whose loss costs nothing.
+const PRUNABLE_TOOL_NAMES = new Set([
+    ...FS_TOOL_NAMES,
+    ...CODING_TOOL_NAMES,
+    'web_fetch',
+]);
 /** True for a tool result we may clear: successful re-runnable output big enough to matter. */
 function isPrunable(m) {
     if (m.role !== 'tool' || typeof m.content !== 'string' || !m.tool_call_id)

package/dist/src/core/contextPrune.js.map

@@ -1 +1 @@
-{"version":3,"file":"contextPrune.js","sourceRoot":"","sources":["../../../src/core/contextPrune.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEhG;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC,CAAC,GAAG,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;AAE1F,+FAA+F;AAC/F,SAAS,UAAU,CAAC,CAAc;IAChC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IACxF,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,sCAAsC;IACrG,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,uBAAuB;QAAE,OAAO,KAAK,CAAC;IAClF,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAChE,IAAI,OAAO,IAAI,MAAM;YAAE,OAAO,KAAK,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC,CAAC,sCAAsC;IACtD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAuB,EACvB,aAAkC;IAElC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,0EAA0E;QAC1E,6EAA6E;QAC7E,6EAA6E;QAC7E,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC;YAAE,SAAS;QACxF,IAAI,UAAU,CAAC,CAAC,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC;AACjF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAuB,EACvB,SAA8B;IAE9B,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACxB,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,YAAY,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC;QAClE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE;QACtC,CAAC,CAAC,CAAC,CACN,CAAC;AACJ,CAAC"}
+{"version":3,"file":"contextPrune.js","sourceRoot":"","sources":["../../../src/core/contextPrune.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEhG;;;;;;;GAOG;AAEH;;;GAGG;AACH,uFAAuF;AACvF,+DAA+D;AAC/D,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC;IACvD,GAAG,aAAa;IAChB,GAAG,iBAAiB;IACpB,WAAW;CACZ,CAAC,CAAC;AAEH,+FAA+F;AAC/F,SAAS,UAAU,CAAC,CAAc;IAChC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IACxF,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,sCAAsC;IACrG,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,uBAAuB;QAAE,OAAO,KAAK,CAAC;IAClF,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAChE,IAAI,OAAO,IAAI,MAAM;YAAE,OAAO,KAAK,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC,CAAC,sCAAsC;IACtD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAuB,EAAE,aAAkC;IACxF,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,0EAA0E;QAC1E,6EAA6E;QAC7E,6EAA6E;QAC7E,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC;YAAE,SAAS;QACxF,IAAI,UAAU,CAAC,CAAC,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC;AACjF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,QAAuB,EAAE,SAA8B;IAClF,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACxB,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,YAAY,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC;QAClE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE;QACtC,CAAC,CAAC,CAAC,CACN,CAAC;AACJ,CAAC"}

package/dist/src/core/runChat.d.ts

@@ -39,4 +39,4 @@ export interface ChatTurnParams {
  * tool events live (exec's --jsonl uses it); callers that only want the final result omit it.
  * Throws on a backend/turn error or when structured output does not parse.
  */
-export declare function runChatTurn(params: ChatTurnParams, onEvent?: (event: EngineEvent) => void): Promise<ChatTurnResult>;
+export declare function runChatTurn(params: ChatTurnParams, onEvent?: (event: EngineEvent) => void | Promise<void>): Promise<ChatTurnResult>;

package/dist/src/core/runChat.js

@@ -67,7 +67,7 @@ async function runOnce(params, plan, onEvent) {
                 // the switch above forwards every event via onEvent below, so callers see them too.
                 // turn_complete is implicit in runTurn resolving.
             }
-            onEvent?.(event);
+            return onEvent?.(event);
         }, { responseFormat });
     }
     catch (err) {

package/dist/src/core/runChat.js.map

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

package/dist/src/core/session.d.ts

@@ -1,4 +1,5 @@
 import type { ChatMessage, ToolCall, ToolResult } from './types.js';
+import { type CompactionState } from './compaction.js';
 /** Serializable snapshot of a conversation, used for local persistence and resume. */
 export interface SessionSnapshot {
     id: string;
@@ -8,6 +9,8 @@ export interface SessionSnapshot {
     messages: ChatMessage[];
     /** Context-pruning decision set (absent in pre-pruning snapshots → empty). */
     prunedToolCallIds?: string[];
+    /** Context-compaction decision (absent when never compacted). */
+    compaction?: CompactionState;
 }
 /**
  * A single conversation the CLI owns end to end.
@@ -27,14 +30,20 @@ export declare class Session {
      * so policy changes and bugs stay recoverable. Persisted in the snapshot.
      */
     prunedToolCallIds: Set<string>;
+    /**
+     * Context-compaction decision (compaction.ts): a summary standing in for the
+     * covered prefix in the REQUEST view. Raw messages stay intact, like pruning.
+     */
+    compaction: CompactionState | null;
     constructor(params: {
         id: string;
         model: string;
         createdAt?: number;
         messages?: ChatMessage[];
         prunedToolCallIds?: string[];
+        compaction?: CompactionState | null;
     });
-    /** The messages to SEND: the pruning projection over the intact raw history. */
+    /** The messages to SEND: compaction, then pruning, projected over the intact raw history. */
     requestMessages(): ChatMessage[];
     /** Prepend a system message (must precede the first user message to steer the model). */
     addSystemMessage(text: string): void;

package/dist/src/core/session.js

@@ -1,4 +1,5 @@
 import { applyPruning } from './contextPrune.js';
+import { applyCompaction } from './compaction.js';
 /**
  * A single conversation the CLI owns end to end.
  *
@@ -17,16 +18,22 @@ export class Session {
      * so policy changes and bugs stay recoverable. Persisted in the snapshot.
      */
     prunedToolCallIds;
+    /**
+     * Context-compaction decision (compaction.ts): a summary standing in for the
+     * covered prefix in the REQUEST view. Raw messages stay intact, like pruning.
+     */
+    compaction;
     constructor(params) {
         this.id = params.id;
         this.model = params.model;
         this.createdAt = params.createdAt ?? nowMs();
         this.messages = params.messages ?? [];
         this.prunedToolCallIds = new Set(params.prunedToolCallIds ?? []);
+        this.compaction = params.compaction ?? null;
     }
-    /** The messages to SEND: the pruning projection over the intact raw history. */
+    /** The messages to SEND: compaction, then pruning, projected over the intact raw history. */
     requestMessages() {
-        return applyPruning(this.messages, this.prunedToolCallIds);
+        return applyPruning(applyCompaction(this.messages, this.compaction), this.prunedToolCallIds);
     }
     /** Prepend a system message (must precede the first user message to steer the model). */
     addSystemMessage(text) {
@@ -80,6 +87,7 @@ export class Session {
             updatedAt: nowMs(),
             messages: this.messages,
             ...(this.prunedToolCallIds.size > 0 ? { prunedToolCallIds: [...this.prunedToolCallIds] } : {}),
+            ...(this.compaction ? { compaction: this.compaction } : {}),
         };
     }
     static fromSnapshot(s) {
@@ -89,6 +97,7 @@ export class Session {
             createdAt: s.createdAt,
             messages: s.messages,
             prunedToolCallIds: s.prunedToolCallIds,
+            compaction: s.compaction ?? null,
         });
     }
 }

package/dist/src/core/session.js.map

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

package/dist/src/core/turnLoop.d.ts

@@ -1,7 +1,12 @@
 import type { ChatBackend, EngineEvent } from './types.js';
 import type { Session } from './session.js';
 import type { ToolRegistry } from './toolRegistry.js';
-export type Emit = (event: EngineEvent) => void;
+/**
+ * Event sink. A returned promise applies BACKPRESSURE on the streaming pump (pi A3):
+ * consumeStream awaits it before pulling the next chunk, so a slow consumer (exec piping
+ * into a slow reader) bounds memory instead of buffering the whole model stream.
+ */
+export type Emit = (event: EngineEvent) => void | Promise<void>;
 /** Per-turn options. `exec --output-schema` passes a `response_format` value here. */
 export interface TurnOptions {
     responseFormat?: unknown;
@@ -11,6 +16,14 @@ export interface TurnOptions {
     includeGatedTools?: boolean;
     /** Hard cap on tool calls dispatched in this turn. Default MAX_TOOL_CALLS_PER_TURN. */
     maxToolCalls?: number;
+    /**
+     * Steering (pi B2): called at each round boundary AFTER tool results are appended and
+     * BEFORE the next model call. Returned items are appended as user messages, so text the
+     * user typed mid-turn reaches the model without waiting for the whole turn to finish.
+     * Only multi-round (tool-using) turns have injection points; anything not injected by
+     * turn end stays queued for the caller's normal follow-up flush.
+     */
+    takeSteering?: () => Array<string | import('./types.js').ContentPart[]>;
 }
 /**
  * Drives one user turn to completion, following the OpenAI tool-calling protocol:
@@ -32,6 +45,9 @@ export declare class TurnLoop {
     runTurn(session: Session, userContent: string | import('./types.js').ContentPart[], emit: Emit, opts?: TurnOptions): Promise<void>;
     /** Stream a single model call, emitting text deltas and accumulating tool_calls. */
     private streamOneCall;
-    /** Iterate the backend stream, forwarding deltas/usage and accumulating tool-call pieces. */
+    /**
+     * Iterate the backend stream, forwarding deltas/usage and accumulating tool-call pieces.
+     * Returns the last non-null finish_reason seen (providers send it on the closing chunk).
+     */
     private consumeStream;
 }

package/dist/src/core/turnLoop.js

@@ -1,7 +1,16 @@
 import { BUDGET_EXHAUSTED_MESSAGE, MAX_TOOL_CALLS_PER_TURN } from '../fs/limits.js';
 import { track } from '../telemetry/telemetry.js';
 /** Pathological backstop only — the tool budget below governs normal turns. */
-const MAX_ROUNDS = 24;
+const MAX_ROUNDS = 32;
+/**
+ * Fed back for every tool call on a message the provider cut off with finish_reason=length:
+ * streamed tool-call arguments are accumulated incrementally, so a length-truncated message
+ * can yield arguments that parse as valid JSON yet are semantically incomplete. With tools
+ * that mutate files or spend credits, executing them would corrupt state — discard them all
+ * and let the model re-issue (pi agent-loop behavior, 2026-08-08 调研 A1).
+ */
+const LENGTH_TRUNCATED_TOOLS_MESSAGE = 'Response was truncated by the output limit; this tool call was discarded because its ' +
+    'arguments may be incomplete. Re-issue the call (smaller, if possible).';
 /**
  * Drives one user turn to completion, following the OpenAI tool-calling protocol:
  *
@@ -39,8 +48,9 @@ export class TurnLoop {
         for (let round = 0; round < MAX_ROUNDS; round++) {
             let content;
             let toolCalls;
+            let finishReason;
             try {
-                ({ content, toolCalls } = await this.streamOneCall(session, emit, opts, toolCallsUsed >= budget));
+                ({ content, toolCalls, finishReason } = await this.streamOneCall(session, emit, opts, toolCallsUsed >= budget));
             }
             catch (err) {
                 // User interruption (Esc): keep whatever partial text already streamed so the
@@ -61,7 +71,10 @@ export class TurnLoop {
             if (content.length === 0 && toolCalls.length === 0) {
                 // The request itself succeeded (no throw) — the model just returned nothing. Keep the
                 // user message (not a poison payload) so a retry has context; only add nothing more.
-                emit({ type: 'error', message: 'The model returned no output. Please try again.' });
+                emit({
+                    type: 'error',
+                    message: 'The model returned no output. Please try again.',
+                });
                 return;
             }
             session.addAssistantMessage(content.length > 0 ? content : null, toolCalls);
@@ -74,6 +87,28 @@ export class TurnLoop {
                 emit({ type: 'turn_complete' });
                 return;
             }
+            // Length-truncated message with tool calls: never execute them (arguments may be
+            // silently incomplete). Answer every call with an error result and loop so the
+            // model re-issues. Consumes no budget — nothing ran.
+            if (finishReason === 'length') {
+                for (const call of toolCalls) {
+                    const result = { error: LENGTH_TRUNCATED_TOOLS_MESSAGE };
+                    emit({
+                        type: 'tool_call_begin',
+                        id: call.id,
+                        name: call.function.name,
+                        args: safeParseArgs(call.function.arguments),
+                    });
+                    emit({
+                        type: 'tool_call_end',
+                        id: call.id,
+                        name: call.function.name,
+                        result,
+                    });
+                    session.addToolMessage(call.id, call.function.name, result);
+                }
+                continue;
+            }
             // Execute the requested tools and feed results back into the conversation.
             // Tool execution itself is never aborted mid-flight (a paid submit must not be torn),
             // but an interrupt takes effect before the next model call.
@@ -116,7 +151,12 @@ export class TurnLoop {
                         ? { error: denied }
                         : await this.registry.dispatch(call.function.name, call.function.arguments);
                     // Ends may arrive out of completion order; the TUI matches rows by call id.
-                    emit({ type: 'tool_call_end', id: call.id, name: call.function.name, result });
+                    emit({
+                        type: 'tool_call_end',
+                        id: call.id,
+                        name: call.function.name,
+                        result,
+                    });
                     return result;
                 }));
                 // Tool messages must follow the tool_calls order the model emitted.
@@ -126,14 +166,24 @@ export class TurnLoop {
                 for (let i = 0; i < toolCalls.length; i++) {
                     const call = toolCalls[i];
                     const args = safeParseArgs(call.function.arguments);
-                    emit({ type: 'tool_call_begin', id: call.id, name: call.function.name, args });
+                    emit({
+                        type: 'tool_call_begin',
+                        id: call.id,
+                        name: call.function.name,
+                        args,
+                    });
                     // Past a budget/cap, don't dispatch: feed the model an error instead, so it
                     // wraps up with what it has (a normal answer, not a hard stop).
                     const denied = denial[i];
                     const result = denied
                         ? { error: denied }
                         : await this.registry.dispatch(call.function.name, call.function.arguments);
-                    emit({ type: 'tool_call_end', id: call.id, name: call.function.name, result });
+                    emit({
+                        type: 'tool_call_end',
+                        id: call.id,
+                        name: call.function.name,
+                        result,
+                    });
                     session.addToolMessage(call.id, call.function.name, result);
                 }
             }
@@ -141,10 +191,17 @@ export class TurnLoop {
                 emit({ type: 'turn_interrupted' });
                 return;
             }
-            // Loop: stream again now that tool results are in the messages.
+            // Steering: text typed mid-turn joins the conversation before the next model call.
+            for (const content of opts.takeSteering?.() ?? []) {
+                session.addUserMessage(content);
+            }
+            // Loop: stream again now that tool results (and any steering) are in the messages.
         }
         session.rollbackTo(checkpoint);
-        emit({ type: 'error', message: `Turn exceeded ${MAX_ROUNDS} tool-calling rounds` });
+        emit({
+            type: 'error',
+            message: `Turn exceeded ${MAX_ROUNDS} tool-calling rounds`,
+        });
     }
     /** Stream a single model call, emitting text deltas and accumulating tool_calls. */
     async streamOneCall(session, emit, opts, forceNoTools) {
@@ -159,8 +216,9 @@ export class TurnLoop {
         };
         let content = '';
         const toolAcc = new Map();
+        let finishReason = null;
         try {
-            await this.consumeStream(req, opts, emit, (text) => (content += text), toolAcc);
+            finishReason = await this.consumeStream(req, opts, emit, (text) => (content += text), toolAcc);
         }
         catch (err) {
             // Attach the partial text so an interrupt can preserve what already streamed.
@@ -178,10 +236,14 @@ export class TurnLoop {
             ...(e.extraContent !== undefined ? { extra_content: e.extraContent } : {}),
         }))
             .filter((c) => c.function.name.length > 0);
-        return { content, toolCalls };
+        return { content, toolCalls, finishReason };
     }
-    /** Iterate the backend stream, forwarding deltas/usage and accumulating tool-call pieces. */
+    /**
+     * Iterate the backend stream, forwarding deltas/usage and accumulating tool-call pieces.
+     * Returns the last non-null finish_reason seen (providers send it on the closing chunk).
+     */
     async consumeStream(req, opts, emit, onText, toolAcc) {
+        let finishReason = null;
         for await (const chunk of this.backend.stream(req, opts.signal)) {
             // The final chunk (include_usage) carries token counts with empty/no choices; surface
             // them before the delta guard below skips it.
@@ -193,12 +255,16 @@ export class TurnLoop {
                 });
             }
             const choice = chunk.choices?.[0];
+            if (typeof choice?.finish_reason === 'string')
+                finishReason = choice.finish_reason;
             const delta = choice?.delta;
             if (!delta)
                 continue;
             if (typeof delta.content === 'string' && delta.content.length > 0) {
                 onText(delta.content);
-                emit({ type: 'assistant_delta', text: delta.content });
+                const r = emit({ type: 'assistant_delta', text: delta.content });
+                if (r)
+                    await r; // backpressure: wait for the consumer to drain
             }
             if (delta.tool_calls) {
                 for (const tc of delta.tool_calls) {
@@ -215,6 +281,7 @@ export class TurnLoop {
                 }
             }
         }
+        return finishReason;
     }
 }
 /** Thrown when the user aborts mid-stream; carries the text streamed so far. */