akanjs 3.0.0-alpha.41 → 3.0.0-alpha.42

package/dictionary/agent.dictionary.ts

@@ -21,11 +21,11 @@ export const agentDictionary = serviceDictionary(["en", "ko"])
   }))
   .error({
     llmUnavailable: [
-      "The agent model is unavailable — no LLM adaptor answered this turn",
-      "에이전트 모델을 사용할 수 없습니다. 이번 턴에 응답한 LLM 어댑터가 없습니다",
+      "The agent is unavailable — this app has no language model configured",
+      "에이전트를 사용할 수 없습니다. 이 앱에 언어 모델이 설정되어 있지 않습니다",
     ],
     deepseekRequestFailed: [
-      "DeepSeek request failed with status {status}",
-      "DeepSeek 요청이 실패했습니다 (status {status})",
+      "DeepSeek refused this turn with status {status}. Reason: {reason}",
+      "DeepSeek가 이번 턴을 거절했습니다 (status {status}). 사유: {reason}",
     ],
   });

package/dictionary/base.dictionary.ts

@@ -64,6 +64,7 @@ export const baseDictionary = serviceDictionary(["en", "ko"])
     agentKeepGoing: ["Keep going", "계속하기"],
     agentCmdNew: ["Start a new conversation", "새 대화 시작"],
     agentCmdRetry: ["Send the last message again", "마지막 메시지 다시 보내기"],
+    agentCmdCompact: ["Summarize the conversation so far", "지금까지의 대화 요약하기"],
     agentCmdCopy: ["Copy this conversation", "이 대화 복사"],
     agentCmdHelp: ["What you can do here", "여기서 할 수 있는 것"],
     agentCmdTools: ["List this screen's tools", "이 화면의 툴 목록"],
@@ -76,6 +77,9 @@ export const baseDictionary = serviceDictionary(["en", "ko"])
       "에이전트는 혼자 결정하면 안 되는 일을 하기 전에 물어보며, 중지는 진행 중인 턴을 끝냅니다.",
     ],
     agentNothingToRetry: ["There is no message to send again.", "다시 보낼 메시지가 없습니다."],
+    agentNothingToCompact: ["There is nothing to summarize yet.", "아직 요약할 대화가 없습니다."],
+    agentCompacted: ["Summarized the conversation so far.", "지금까지의 대화를 요약했습니다."],
+    agentSummary: ["Summary of the earlier conversation", "이전 대화 요약"],
     agentBusy: ["A turn is still running. Stop it first.", "진행 중인 턴이 있습니다. 먼저 중지하세요."],
     agentCopied: ["Conversation copied to the clipboard.", "대화를 클립보드에 복사했습니다."],
     agentCopyFailed: ["Could not reach the clipboard.", "클립보드에 접근할 수 없습니다."],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akanjs",
-  "version": "3.0.0-alpha.41",
+  "version": "3.0.0-alpha.42",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {

package/service/predefinedAdaptor/deepseekLlm.ts

@@ -54,8 +54,9 @@ export class DeepseekLlm
       const body = await this.#apiStream("/chat/completions", DeepseekLlm.requestBody(this.#model, request, true));
       return await DeepseekLlm.consumeStream(body, onDelta);
     } catch (error) {
+
       this.logger.error(`DeepSeek turn failed: ${error instanceof Error ? error.message : String(error)}`);
-      return null;
+      throw error;
     }
   }
 
@@ -67,7 +68,7 @@ export class DeepseekLlm
       
       signal: AbortSignal.timeout(120_000),
     });
-    if (!response.ok) throw new Err("agent.error.deepseekRequestFailed", { status: String(response.status) });
+    if (!response.ok) throw await DeepseekLlm.refusal(response);
     return (await response.json()) as T;
   }
 
@@ -78,11 +79,31 @@ export class DeepseekLlm
       body: JSON.stringify(body),
       signal: AbortSignal.timeout(120_000),
     });
-    if (!response.ok || !response.body)
-      throw new Err("agent.error.deepseekRequestFailed", { status: String(response.status) });
+    if (!response.ok || !response.body) throw await DeepseekLlm.refusal(response);
     return response.body;
   }
 
+  /**
+   * The dialect answers a refusal as `{ error: { message } }`, and that sentence is the useful half — a request
+   * past the context window says exactly which limit it passed. Carried on the `Err` so the chat can print it.
+   */
+  static async refusal(response: Response): Promise<Error> {
+    return new Err("agent.error.deepseekRequestFailed", {
+      status: String(response.status),
+      reason: await DeepseekLlm.reasonOf(response),
+    });
+  }
+
+  static async reasonOf(response: Response): Promise<string> {
+    try {
+      const body = (await response.json()) as { error?: { message?: unknown } | string };
+      const message = typeof body.error === "string" ? body.error : body.error?.message;
+      if (typeof message === "string" && message) return message;
+    } catch {
+    }
+    return response.statusText || "no reason given";
+  }
+
   /**
    * The dialect streams `data: {chunk}` SSE lines ending with `data: [DONE]`. Tool calls arrive fragmented — the
    * first fragment of an index carries id/name, later ones append to the arguments string — so they are assembled
@@ -175,6 +196,14 @@ export class DeepseekLlm
   }
 
   static providerMessages(message: AgentWireMessage): DeepseekMessage[] {
+
+    if (message.summary)
+      return [
+        {
+          role: "system" as const,
+          content: `Summary of the earlier conversation, standing in for the messages it replaced:\n\n${message.text ?? ""}`,
+        },
+      ];
     if (message.role === "tool")
       return (message.toolResults ?? []).map((result) => ({
         role: "tool" as const,

package/service/predefinedAdaptor/llm.adaptor.ts

@@ -37,6 +37,11 @@ export interface AgentWireMessage {
   toolCalls?: AgentWireToolCall[];
   toolResults?: AgentWireToolResult[];
   error?: string;
+  /**
+   * Stands in for the messages the client's own compaction replaced. It arrives with the user's role because the
+   * wire has no other, but it is history rather than an ask, so a provider mapping frames it as one.
+   */
+  summary?: boolean;
 }
 
 export interface AgentWireTool {
@@ -68,8 +73,12 @@ export interface LlmTurnAnswer {
 /**
  * The provider seam for one stateless agent turn: the whole transcript in, one assistant answer out. The server
  * relays — it never executes a client tool — so this is the only surface a provider integration fills. An
- * implementation is an `adapt()` class in a lib's `srvkit/` and follows the adapter convention: failures are
- * logged and answered as `null`, and the calling service decides what that means.
+ * implementation is an `adapt()` class in a lib's `srvkit/`.
+ *
+ * `null` means this provider is not configured, and the caller turns it into the one sentence that says so. A
+ * failure the provider explained is logged and **thrown** instead, as an `Err` whose text the chat prints: a
+ * refused turn and an unconfigured app are different things to be told, and collapsing both into `null` left a
+ * user reading "no model is configured" about a conversation that had merely outgrown the context window.
  */
 export interface LlmAdaptor {
   /**

package/signal/agentTurnStream.ts

@@ -16,6 +16,18 @@ export class AgentTurnStream {
     return !!request.headers.get("accept")?.includes("text/event-stream");
   }
 
+  /**
+   * A domain `Err` carries its dictionary key as the message and the values its text interpolates as `data`, so
+   * both travel: the key alone would reach the chat as `agent.error.…` with its placeholders unfilled.
+   */
+  static failure(error: unknown): { message: string; data?: Record<string, string | number> } {
+    const message = error instanceof Error ? error.message : String(error);
+    const data = (error as { data?: unknown } | null)?.data;
+    return data && typeof data === "object" && !Array.isArray(data)
+      ? { message, data: data as Record<string, string | number> }
+      : { message };
+  }
+
   static response(run: (onDelta: (delta: string) => void) => Promise<StreamedTurn>): Response {
     const encoder = new TextEncoder();
     const stream = new ReadableStream<Uint8Array>({
@@ -35,7 +47,7 @@ export class AgentTurnStream {
           send({ type: "done", stop: turn.stop === "toolUse" || toolCalls.length ? "toolUse" : "end" });
         } catch (error) {
           
-          send({ type: "error", message: error instanceof Error ? error.message : String(error) });
+          send({ type: "error", ...AgentTurnStream.failure(error) });
         } finally {
           controller.close();
         }

package/types/dictionary/base.dictionary.d.ts

@@ -1 +1 @@
-export declare const baseDictionary: import("./dictInfo.d.ts").ServiceDictInfo<[string, string], "ping" | "pingBody" | "pingParam" | "pingQuery" | "wsPing" | "pubsubPing", never, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view">;
+export declare const baseDictionary: import("./dictInfo.d.ts").ServiceDictInfo<[string, string], "ping" | "pingBody" | "pingParam" | "pingQuery" | "wsPing" | "pubsubPing", never, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view">;

package/types/dictionary/dictionary.d.ts

@@ -1,13 +1,13 @@
 import type { AgentEndpoint, AgentTurn, BaseEndpoint } from "akanjs/signal";
 export declare const dictionary: {
-    base: import("./locale.d.ts").DictModule<import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view">, never>;
+    base: import("./locale.d.ts").DictModule<import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view">, never>;
     agentTurn: import("./locale.d.ts").DictModule<import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc`, never>;
     agent: import("./locale.d.ts").DictModule<import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, "agent.error.llmUnavailable" | "agent.error.deepseekRequestFailed">;
 };
-export declare const Err: import("./trans.d.ts").ErrConstructor<"agent.error.llmUnavailable" | "agent.error.deepseekRequestFailed">, translate: (lang: "en" | "ko" | "zhChs" | "zhCht" | "ja", key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, data?: import("./trans.d.ts").TranslationData) => string, msg: {
-    info: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
-    success: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
-    error: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
-    warning: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
-    loading: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
-}, getDictionary: (lang: "en" | "ko" | "zhChs" | "zhCht" | "ja") => object, getAllDictionary: () => import("./trans.d.ts").RootDictionary, __Dict_Key__: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, __Error_Key__: "agent.error.llmUnavailable" | "agent.error.deepseekRequestFailed";
+export declare const Err: import("./trans.d.ts").ErrConstructor<"agent.error.llmUnavailable" | "agent.error.deepseekRequestFailed">, translate: (lang: "en" | "ko" | "zhChs" | "zhCht" | "ja", key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, data?: import("./trans.d.ts").TranslationData) => string, msg: {
+    info: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
+    success: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
+    error: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
+    warning: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
+    loading: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
+}, getDictionary: (lang: "en" | "ko" | "zhChs" | "zhCht" | "ja") => object, getAllDictionary: () => import("./trans.d.ts").RootDictionary, __Dict_Key__: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, __Error_Key__: "agent.error.llmUnavailable" | "agent.error.deepseekRequestFailed";

package/types/service/predefinedAdaptor/deepseekLlm.d.ts

@@ -34,6 +34,12 @@ declare const DeepseekLlm_base: import("..").AdaptorCls<{}, {
 export declare class DeepseekLlm extends DeepseekLlm_base implements LlmAdaptor {
     #private;
     chat(request: LlmTurnRequest, onDelta?: (delta: string) => void): Promise<LlmTurnAnswer | null>;
+    /**
+     * The dialect answers a refusal as `{ error: { message } }`, and that sentence is the useful half — a request
+     * past the context window says exactly which limit it passed. Carried on the `Err` so the chat can print it.
+     */
+    static refusal(response: Response): Promise<Error>;
+    static reasonOf(response: Response): Promise<string>;
     /**
      * The dialect streams `data: {chunk}` SSE lines ending with `data: [DONE]`. Tool calls arrive fragmented — the
      * first fragment of an index carries id/name, later ones append to the arguments string — so they are assembled

package/types/service/predefinedAdaptor/llm.adaptor.d.ts

@@ -34,6 +34,11 @@ export interface AgentWireMessage {
     toolCalls?: AgentWireToolCall[];
     toolResults?: AgentWireToolResult[];
     error?: string;
+    /**
+     * Stands in for the messages the client's own compaction replaced. It arrives with the user's role because the
+     * wire has no other, but it is history rather than an ask, so a provider mapping frames it as one.
+     */
+    summary?: boolean;
 }
 export interface AgentWireTool {
     name: string;
@@ -60,8 +65,12 @@ export interface LlmTurnAnswer {
 /**
  * The provider seam for one stateless agent turn: the whole transcript in, one assistant answer out. The server
  * relays — it never executes a client tool — so this is the only surface a provider integration fills. An
- * implementation is an `adapt()` class in a lib's `srvkit/` and follows the adapter convention: failures are
- * logged and answered as `null`, and the calling service decides what that means.
+ * implementation is an `adapt()` class in a lib's `srvkit/`.
+ *
+ * `null` means this provider is not configured, and the caller turns it into the one sentence that says so. A
+ * failure the provider explained is logged and **thrown** instead, as an `Err` whose text the chat prints: a
+ * refused turn and an unconfigured app are different things to be told, and collapsing both into `null` left a
+ * user reading "no model is configured" about a conversation that had merely outgrown the context window.
  */
 export interface LlmAdaptor {
     /**

package/types/signal/agentTurnStream.d.ts

@@ -11,6 +11,14 @@ interface StreamedTurn {
  */
 export declare class AgentTurnStream {
     static wants(request: Bun.BunRequest): boolean;
+    /**
+     * A domain `Err` carries its dictionary key as the message and the values its text interpolates as `data`, so
+     * both travel: the key alone would reach the chat as `agent.error.…` with its placeholders unfilled.
+     */
+    static failure(error: unknown): {
+        message: string;
+        data?: Record<string, string | number>;
+    };
     static response(run: (onDelta: (delta: string) => void) => Promise<StreamedTurn>): Response;
 }
 export {};

package/types/ui/Agent/Chat.d.ts

@@ -1,5 +1,5 @@
 import { type ReactNode } from "react";
-import { type AgentRunner } from "../../vendor/use-agentic.d.ts";
+import { type AgentRunner, type CompactOptions } from "../../vendor/use-agentic.d.ts";
 import { type AttachReader } from "./attachment.d.ts";
 import { type PersistOption } from "./sessionHistory.d.ts";
 import { type VoiceEngine } from "./voice.d.ts";
@@ -11,6 +11,11 @@ export interface ChatProps {
     /** Swap the transport; the default drives the app's `runAgentTurn` endpoint. */
     runner?: AgentRunner;
     maxTurns?: number;
+    /**
+     * When the conversation summarizes itself to stay inside the model's window — `at` estimated tokens, `keep`
+     * messages left verbatim below the summary. Tune it per provider; `{ at: 0 }` turns it off.
+     */
+    compact?: CompactOptions;
     defaultOpen?: boolean;
     /** Keeps the transcript across reloads — sessionStorage by default, `{ storage: "local" }` to outlive the tab. */
     persist?: PersistOption;
@@ -37,6 +42,6 @@ export interface ChatProps {
  * no history). An enclosing AgentProvider's session wins, which is how an app isolates a surface or swaps the
  * loop while keeping this UI.
  */
-export declare const DefaultChat: ({ className, title, instructions, runner, maxTurns, defaultOpen, persist, inline, attach, voice, }: ChatProps) => ReactNode;
+export declare const DefaultChat: ({ className, title, instructions, runner, maxTurns, compact, defaultOpen, persist, inline, attach, voice, }: ChatProps) => ReactNode;
 declare const _default: import("react").ComponentType<ChatProps>;
 export default _default;

package/types/vendor/use-agentic/AgentSession.d.ts

@@ -1,4 +1,5 @@
 import { type AgentProgressReport } from "./AgentProgress.d.ts";
+import { type CompactOptions } from "./Compaction.d.ts";
 import type { AgentRunner, ChatMessage, ContextBlock, PublishedTool, SurfaceView } from "./types.d.ts";
 export interface PendingApproval {
     callId: string;
@@ -47,6 +48,11 @@ export interface AgentSessionOptions {
         question: string;
         keep: string;
     };
+    /**
+     * Keeps a long conversation inside the model's window: past `at` estimated tokens the history above the last
+     * few messages is replaced by one summary of itself, before the turn that would have overflowed is sent.
+     */
+    compact?: CompactOptions;
 }
 /**
  * The client-side conversation loop: send → model turn → tool calls → approval gate → execute → report diffs → next
@@ -93,6 +99,16 @@ export declare class AgentSession {
      * only way back. Only the trailing message is replayed, so a prompt's own preamble stays where it is.
      */
     retry: () => Promise<boolean>;
+    /**
+     * Replaces the history with one summary of itself and returns whether anything was replaced. `keep` leaves that
+     * many trailing messages verbatim; the command that a user types keeps none, because a summary of everything is
+     * what they asked for. A turn in flight refuses — the transcript it is appending to is not one to rewrite.
+     */
+    compact: ({ keep }?: {
+        keep?: number;
+    }) => Promise<boolean>;
+    /** What the transcript is estimated to cost the next turn, in tokens — the number auto-compaction watches. */
+    get tokens(): number;
     /** Records a host-side failure (a prompt fetch, an upload) in the transcript, where every other failure lands. */
     report: (error: string) => void;
     /** A line the host wrote — a command's own output. Rendered in the transcript, withheld from the model. */

package/types/vendor/use-agentic/Compaction.d.ts

@@ -0,0 +1,45 @@
+import type { ChatMessage } from "./types.d.ts";
+export interface CompactOptions {
+    /** Estimated transcript tokens above which a turn summarizes its own history first. `0` never compacts. */
+    at?: number;
+    /** Messages left verbatim below the summary. The cut rises to the nearest user message above them. */
+    keep?: number;
+    /** Produces the summary from the digest. Default: one tool-less turn through the session's own runner. */
+    summarize?: (digest: string, signal: AbortSignal) => Promise<string>;
+}
+/**
+ * Turns the part of a transcript that no longer fits into one message standing in for it. The loop runs in the
+ * browser and the relay is stateless, so nothing else is keeping the conversation inside the model's window: an
+ * uncompacted chat simply grows until the provider refuses the request.
+ */
+export declare class Compaction {
+    #private;
+    /**
+     * Deliberately well under the smallest window a provider is likely to have: what a conversation loses to an
+     * early summary is detail, and what it loses to a late one is the conversation. The tools, the screen context
+     * and the system prompt ride on top of the transcript on every turn, and none of them is compactable.
+     */
+    static readonly defaults: {
+        at: number;
+        keep: number;
+    };
+    static readonly instruction: string;
+    /**
+     * Four characters per token, counted over the JSON the turn actually posts. A rough estimate on purpose: this
+     * places a threshold, and shipping a per-provider tokenizer to the browser to place it more exactly would cost
+     * more than the slack the estimate leaves.
+     */
+    static tokensOf(messages: readonly ChatMessage[]): number;
+    /**
+     * Where the kept half starts, or `-1` when nothing can be cut. Only a user message opens one: everything before
+     * it is settled, so the kept half never begins with a `tool` result whose call was summarized away — a shape
+     * every provider dialect rejects. `keep: 0` summarizes the whole transcript, which is what the command does.
+     */
+    static cutAt(messages: readonly ChatMessage[], keep: number): number;
+    /**
+     * The messages as one bounded block of text. Bounded is the point: the transcript being summarized is the one
+     * that no longer fits, so feeding it back verbatim would fail exactly where compaction is needed most.
+     */
+    static digest(messages: readonly ChatMessage[], budget?: number): string;
+    static message(summary: string): ChatMessage;
+}

package/types/vendor/use-agentic/index.d.ts

@@ -5,6 +5,7 @@ export * from "./AgentProgress.d.ts";
 export * from "./AgentProvider.d.ts";
 export * from "./AgentScope.d.ts";
 export * from "./AgentSession.d.ts";
+export * from "./Compaction.d.ts";
 export * from "./httpRunner.d.ts";
 export * from "./surfaceContext.d.ts";
 export * from "./types.d.ts";

package/types/vendor/use-agentic/types.d.ts

@@ -136,6 +136,12 @@ export interface ChatMessage {
      * history the model reads, which would take it for something it had said itself.
      */
     local?: boolean;
+    /**
+     * Stands in for the messages compaction replaced. It rides the wire like any other message — it is what the
+     * model now remembers of them — but it is not something the user said, so a backend frames it as a summary and
+     * a host renders it as one.
+     */
+    summary?: boolean;
 }
 /** One block of screen context the host assembles per turn. `kind` is the host's vocabulary; the wire forwards it verbatim. */
 export interface ContextBlock {
@@ -153,9 +159,15 @@ export type RunnerEvent = {
 } | {
     type: "done";
     stop: "end" | "toolUse";
-} | {
+}
+/**
+ * `data` accompanies a message that is a code rather than a sentence — the values whoever resolves the code
+ * interpolates into its text. A host that does not know the code shows the message as it stands.
+ */
+ | {
     type: "error";
     message: string;
+    data?: Record<string, string | number>;
 };
 export interface RunnerRequest {
     messages: ChatMessage[];

package/ui/Agent/Bubble.tsx

@@ -1,5 +1,5 @@
 "use client";
-import { cn } from "akanjs/client";
+import { cn, usePage } from "akanjs/client";
 import { type AgentProgressReport, AgentSession, type ChatMessage, type ToolCallResult } from "../../vendor/use-agentic";
 import { Chips } from "./Attach";
 import Markdown from "./Markdown";
@@ -81,6 +81,15 @@ const Ask = ({ args, result }: AskProps) => {
 };
 
 export default function Bubble({ className, message, progress, results }: BubbleProps) {
+  const { l } = usePage();
+
+  if (message.summary)
+    return (
+      <details className={cn("rounded-box border border-border bg-muted/60 px-3 py-2", className)}>
+        <summary className="cursor-pointer text-foreground/50 text-xs">{l("base.agentSummary")}</summary>
+        <p className="mt-2 whitespace-pre-wrap text-foreground/70 text-xs">{message.text}</p>
+      </details>
+    );
   if (message.role === "tool")
     return (
       <div className={cn("flex flex-col gap-1", className)}>

package/ui/Agent/Chat.tsx

@@ -5,7 +5,13 @@ import { AgentContext, type AgentPrompt, AgentPrompts, ensureStoreSurface, Scree
 import { type ReactNode, useContext, useEffect, useRef, useState, useSyncExternalStore } from "react";
 import { createPortal } from "react-dom";
 import { AiOutlineClear, AiOutlineClose } from "react-icons/ai";
-import { type AgentRunner, AgentSession, type MessageAttachment, SessionContext } from "../../vendor/use-agentic";
+import {
+  type AgentRunner,
+  AgentSession,
+  type CompactOptions,
+  type MessageAttachment,
+  SessionContext,
+} from "../../vendor/use-agentic";
 import { Button } from "../Button";
 import { inputRecipe } from "../recipe";
 import { createOverridable } from "../UiOverride";
@@ -29,6 +35,11 @@ export interface ChatProps {
   /** Swap the transport; the default drives the app's `runAgentTurn` endpoint. */
   runner?: AgentRunner;
   maxTurns?: number;
+  /**
+   * When the conversation summarizes itself to stay inside the model's window — `at` estimated tokens, `keep`
+   * messages left verbatim below the summary. Tune it per provider; `{ at: 0 }` turns it off.
+   */
+  compact?: CompactOptions;
   defaultOpen?: boolean;
   /** Keeps the transcript across reloads — sessionStorage by default, `{ storage: "local" }` to outlive the tab. */
   persist?: PersistOption;
@@ -66,6 +77,7 @@ export const DefaultChat = ({
   instructions,
   runner,
   maxTurns,
+  compact,
   defaultOpen = false,
   persist,
   inline = false,
@@ -83,6 +95,7 @@ export const DefaultChat = ({
       continueAsk: { question: l("base.agentContinue"), keep: l("base.agentKeepGoing") },
       ...(instructions ? { instructions } : {}),
       ...(maxTurns ? { maxTurns } : {}),
+      ...(compact ? { compact } : {}),
       ...(persist ? { history: sessionHistoryOf(persist) } : {}),
     });
   const session = held.current;

package/ui/Agent/ChatCommands.ts

@@ -42,6 +42,15 @@ export class ChatCommands {
           else if (!(await session.retry())) session.note(t("base.agentNothingToRetry"));
         },
       },
+      {
+        name: "compact",
+        description: l("base.agentCmdCompact"),
+        run: async ({ session, l: t }) => {
+          if (session.isRunning) session.note(t("base.agentBusy"));
+          else if (await session.compact()) session.note(t("base.agentCompacted"));
+          else session.note(t("base.agentNothingToCompact"));
+        },
+      },
       { name: "copy", description: l("base.agentCmdCopy"), run: (context) => ChatCommands.#copy(context) },
       { name: "help", description: l("base.agentCmdHelp"), run: (context) => ChatCommands.#help(context) },
       { name: "tools", description: l("base.agentCmdTools"), run: (context) => ChatCommands.#tools(context) },
@@ -70,7 +79,8 @@ export class ChatCommands {
     const lines = [`# Agent conversation`, [where, new Date().toISOString()].filter(Boolean).join(" · "), ""];
     for (const message of messages) {
       if (message.local) continue;
-      lines.push(`**${message.role}**`);
+
+      lines.push(`**${message.summary ? "summary" : message.role}**`);
       if (message.text) lines.push(message.text);
       for (const attachment of message.attachments ?? [])
         lines.push(`- attached \`${attachment.name}\` (${attachment.mimeType})`);

package/ui/Agent/fetchRunner.ts

@@ -1,6 +1,20 @@
 import { getEnv } from "akanjs/base";
-import { fetch } from "akanjs/client";
-import { type AgentRunner, httpRunner } from "../../vendor/use-agentic";
+import { fetch, Translator } from "akanjs/client";
+import { type AgentRunner, httpRunner, type RunnerEvent } from "../../vendor/use-agentic";
+
+/** `<refName>.error.<key>` — the shape a domain `Err` puts on the wire, its dictionary text being the message. */
+const errorKey = /^[a-zA-Z][A-Za-z0-9]*\.error\.[A-Za-z0-9_]+$/;
+
+/**
+ * A server `Err` travels as its key, because the endpoint has no language to resolve it in — the chat does, so
+ * the resolving happens here, one step before the transcript. Anything else is already a sentence somebody wrote,
+ * and a key with no entry stays as it is rather than becoming a worse sentence.
+ */
+const readable = (event: RunnerEvent): RunnerEvent => {
+  if (event.type !== "error" || !errorKey.test(event.message)) return event;
+  const text = Translator.translateByLocale(Translator.getActiveLocale() ?? "en", event.message, event.data);
+  return text === event.message ? event : { type: "error", message: text };
+};
 
 /**
  * Runs each assistant turn against the app's own `runAgentTurn` route — service signals mount unprefixed, so the
@@ -25,6 +39,6 @@ export const fetchRunner = (options: { fetcher?: typeof globalThis.fetch } = {})
       },
       ...(options.fetcher ? { fetcher: options.fetcher } : {}),
     });
-    yield* runner.run(request);
+    for await (const event of runner.run(request)) yield readable(event);
   },
 });

package/ui/Load/Units.tsx

@@ -113,7 +113,6 @@ function Render<RefName extends string, Light extends { id: string }>({
   const initModelObjInsight = (init as any)[names.modelObjInsight] as BaseInsight;
   const initLimitOfModel = (init as any)[names.limitOfModel] as number;
   const initPageOfModel = (init as any)[names.pageOfModel] as number;
-  const modelStaleAt = storeUse[namesOfSlice.modelStaleAt]() as Date;
 
   const useCache =
     !modelListLoading &&
@@ -152,11 +151,12 @@ function Render<RefName extends string, Light extends { id: string }>({
   }, []);
 
   useEffect(() => {
+    const modelStaleAt = storeGet<Date>()[namesOfSlice.modelStaleAt];
     const staleThreshold = Math.max(modelStaleAt.getTime(), staleTime === undefined ? 0 : Date.now() - staleTime);
     if (storeGet<Date>()[namesOfSlice.modelInitAt].getTime() >= staleThreshold) return;
     if (storeGet<boolean>()[namesOfSlice.modelListLoading]) return;
     void storeDo[namesOfSlice.refreshModel]({ invalidate: true });
-  }, [modelStaleAt]);
+  }, []);
 
   const modelInsight = storeUse[namesOfSlice.modelInsight]() as BaseInsight;
   const limitOfModel = storeUse[namesOfSlice.limitOfModel]() as number;

package/vendor/use-agentic/AgentSession.ts

@@ -1,5 +1,6 @@
 import { AgentAbort } from "./AgentAbort";
 import { AgentProgress, type AgentProgressReport } from "./AgentProgress";
+import { Compaction, type CompactOptions } from "./Compaction";
 import type {
   AgentRunner,
   ChatMessage,
@@ -59,6 +60,11 @@ export interface AgentSessionOptions {
    * renders no `pendingQuestion` would otherwise wait forever for an answer nobody can give.
    */
   continueAsk?: { question: string; keep: string };
+  /**
+   * Keeps a long conversation inside the model's window: past `at` estimated tokens the history above the last
+   * few messages is replaced by one summary of itself, before the turn that would have overflowed is sent.
+   */
+  compact?: CompactOptions;
 }
 
 /**
@@ -107,6 +113,8 @@ export class AgentSession {
   #version = 0;
   #listeners = new Set<() => void>();
   #saveTimer: ReturnType<typeof setTimeout> | null = null;
+  /** Size below which auto-compaction stays out of the way, raised when a summary failed to shrink anything. */
+  #compactFloor = 0;
 
   constructor(surface: SurfaceView, runner: AgentRunner, options: AgentSessionOptions = {}) {
     this.#surface = surface;
@@ -181,6 +189,7 @@ export class AgentSession {
           this.#append({ role: "user", text: answer });
           budget = turn + maxTurns;
         }
+        await this.#autoCompact(controller.signal);
         const { toolCalls, stop } = await this.#assistantTurn(controller.signal);
         if (controller.signal.aborted || stop !== "toolUse" || !toolCalls.length) return;
         const toolResults: ToolCallResult[] = [];
@@ -218,6 +227,7 @@ export class AgentSession {
       await this.#active;
     }
     this.#messages = [];
+    this.#compactFloor = 0;
     
     if (this.#saveTimer) {
       clearTimeout(this.#saveTimer);
@@ -239,7 +249,8 @@ export class AgentSession {
   retry = async (): Promise<boolean> => {
     if (this.#active) return false;
     const at = this.#messages.findLastIndex(
-      (message) => message.role === "user" && (!!message.text || !!message.attachments?.length),
+      
+      (message) => message.role === "user" && !message.summary && (!!message.text || !!message.attachments?.length),
     );
     if (at < 0) return false;
     const again = this.#messages[at];
@@ -248,6 +259,43 @@ export class AgentSession {
     return true;
   };
 
+  /**
+   * Replaces the history with one summary of itself and returns whether anything was replaced. `keep` leaves that
+   * many trailing messages verbatim; the command that a user types keeps none, because a summary of everything is
+   * what they asked for. A turn in flight refuses — the transcript it is appending to is not one to rewrite.
+   */
+  compact = async ({ keep = 0 }: { keep?: number } = {}): Promise<boolean> => {
+    if (this.#running) return false;
+    const controller = new AbortController();
+    this.#controller = controller;
+    this.#running = true;
+    
+    this.#notify();
+    const run = this.#compact(keep, controller.signal);
+
+    this.#active = run.then(
+      () => undefined,
+      () => undefined,
+    );
+    try {
+      return await run;
+    } catch (error) {
+      
+      if (controller.signal.aborted) return false;
+      throw error;
+    } finally {
+      this.#running = false;
+      this.#controller = null;
+      this.#active = null;
+      this.#notify();
+    }
+  };
+
+  /** What the transcript is estimated to cost the next turn, in tokens — the number auto-compaction watches. */
+  get tokens() {
+    return Compaction.tokensOf(this.#messages);
+  }
+
   /** Records a host-side failure (a prompt fetch, an upload) in the transcript, where every other failure lands. */
   report = (error: string) => {
     this.#append({ role: "assistant", error });
@@ -258,6 +306,53 @@ export class AgentSession {
     this.#append({ role: "assistant", text, local: true });
   };
 
+  async #compact(keep: number, signal: AbortSignal): Promise<boolean> {
+    const at = Compaction.cutAt(this.#messages, keep);
+    if (at <= 0) return false;
+    const summary = (await this.#summarize(Compaction.digest(this.#messages.slice(0, at)), signal)).trim();
+    if (!summary || signal.aborted) return false;
+    this.#messages = [Compaction.message(summary), ...this.#messages.slice(at)];
+    this.#notify();
+    return true;
+  }
+
+  /**
+   * Runs before the turn that would have overflowed rather than after it fails: the provider answers a request
+   * that is too long with a refusal, not with a shorter answer, so there is nothing to recover from afterwards.
+   * Best effort — a summary that cannot be produced leaves the transcript as it stands and the turn goes out as
+   * it would have, since it may well still fit.
+   */
+  async #autoCompact(signal: AbortSignal) {
+    const { at = Compaction.defaults.at, keep = Compaction.defaults.keep } = this.#options.compact ?? {};
+    if (!at || Compaction.tokensOf(this.#messages) < Math.max(at, this.#compactFloor)) return;
+    try {
+      await this.#compact(keep, signal);
+    } catch (error) {
+      console.warn(`[use-agentic] compaction failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const after = Compaction.tokensOf(this.#messages);
+
+    this.#compactFloor = after < at ? 0 : after + at;
+  }
+
+  /** No tools and no screen context: this turn summarizes the conversation, and must not act on it. */
+  async #summarize(digest: string, signal: AbortSignal): Promise<string> {
+    const custom = this.#options.compact?.summarize;
+    if (custom) return await custom(digest, signal);
+    let text = "";
+    for await (const event of this.#runner.run({
+      messages: [{ role: "user", text: digest }],
+      tools: [],
+      context: [],
+      instructions: Compaction.instruction,
+      signal,
+    })) {
+      if (event.type === "text") text += event.delta;
+      else if (event.type === "error") throw new Error(event.message);
+    }
+    return text;
+  }
+
   async #assistantTurn(signal: AbortSignal): Promise<{ toolCalls: ToolCallRequest[]; stop: "end" | "toolUse" }> {
     const { tools, guides } = this.#surface.snapshot();
     const instructions = [this.#options.instructions, ...guides].filter(Boolean).join("\n\n");

package/vendor/use-agentic/Compaction.ts

@@ -0,0 +1,110 @@
+import type { ChatMessage } from "./types";
+
+export interface CompactOptions {
+  /** Estimated transcript tokens above which a turn summarizes its own history first. `0` never compacts. */
+  at?: number;
+  /** Messages left verbatim below the summary. The cut rises to the nearest user message above them. */
+  keep?: number;
+  /** Produces the summary from the digest. Default: one tool-less turn through the session's own runner. */
+  summarize?: (digest: string, signal: AbortSignal) => Promise<string>;
+}
+
+/**
+ * Turns the part of a transcript that no longer fits into one message standing in for it. The loop runs in the
+ * browser and the relay is stateless, so nothing else is keeping the conversation inside the model's window: an
+ * uncompacted chat simply grows until the provider refuses the request.
+ */
+export class Compaction {
+  /**
+   * Deliberately well under the smallest window a provider is likely to have: what a conversation loses to an
+   * early summary is detail, and what it loses to a late one is the conversation. The tools, the screen context
+   * and the system prompt ride on top of the transcript on every turn, and none of them is compactable.
+   */
+  static readonly defaults = { at: 24_000, keep: 6 };
+
+  static readonly instruction =
+    "Summarize the conversation below so you can carry it on with the summary in place of the messages themselves. " +
+    "Keep what the user is trying to do, the decisions taken, the facts and tool results that still matter, and " +
+    "anything left unfinished. Drop pleasantries and anything already superseded. Write compact notes, not prose, " +
+    "and write nothing but the summary itself.";
+
+  /**
+   * Four characters per token, counted over the JSON the turn actually posts. A rough estimate on purpose: this
+   * places a threshold, and shipping a per-provider tokenizer to the browser to place it more exactly would cost
+   * more than the slack the estimate leaves.
+   */
+  static tokensOf(messages: readonly ChatMessage[]): number {
+    let chars = 0;
+    for (const message of messages) if (!message.local) chars += JSON.stringify(message).length;
+    return Math.ceil(chars / 4);
+  }
+
+  /**
+   * Where the kept half starts, or `-1` when nothing can be cut. Only a user message opens one: everything before
+   * it is settled, so the kept half never begins with a `tool` result whose call was summarized away — a shape
+   * every provider dialect rejects. `keep: 0` summarizes the whole transcript, which is what the command does.
+   */
+  static cutAt(messages: readonly ChatMessage[], keep: number): number {
+    if (!messages.length) return -1;
+    if (keep <= 0) return messages.length;
+    const target = messages.length - keep;
+    if (target <= 0) return -1;
+    for (let at = target; at < messages.length; at += 1) if (messages[at].role === "user") return at;
+    return -1;
+  }
+
+  /**
+   * The messages as one bounded block of text. Bounded is the point: the transcript being summarized is the one
+   * that no longer fits, so feeding it back verbatim would fail exactly where compaction is needed most.
+   */
+  static digest(messages: readonly ChatMessage[], budget = 12_000): string {
+    const lines = messages.filter((message) => !message.local).map((message) => Compaction.#line(message));
+    if (lines.reduce((sum, line) => sum + line.length + 1, 0) <= budget) return lines.join("\n");
+
+    const head: string[] = [];
+    const tail: string[] = [];
+    let used = 0;
+    let low = 0;
+    let high = lines.length - 1;
+    let fromHead = true;
+    while (low <= high) {
+      const line = lines[fromHead ? low : high];
+      if (used + line.length + 1 > budget) break;
+      used += line.length + 1;
+      if (fromHead) {
+        head.push(line);
+        low += 1;
+      } else {
+        tail.unshift(line);
+        high -= 1;
+      }
+      fromHead = !fromHead;
+    }
+    return [...head, `[... ${high - low + 1} messages omitted ...]`, ...tail].join("\n");
+  }
+
+  static message(summary: string): ChatMessage {
+    return { role: "user", text: summary, summary: true };
+  }
+
+  static #line(message: ChatMessage): string {
+    const parts: string[] = [];
+    if (message.text) parts.push(Compaction.#clip(message.text, 1200));
+    for (const attachment of message.attachments ?? []) parts.push(`[attached ${attachment.name}]`);
+    for (const call of message.toolCalls ?? [])
+      parts.push(`[called ${call.name} ${Compaction.#clip(JSON.stringify(call.args), 200)}]`);
+    for (const result of message.toolResults ?? [])
+      parts.push(
+        `[${result.error ? "failed" : "result"} ${result.name}: ${Compaction.#clip(
+          result.error ?? JSON.stringify(result.result ?? null),
+          400,
+        )}]`,
+      );
+    if (message.error) parts.push(`[turn failed: ${message.error}]`);
+    return `${message.role}: ${parts.join(" ")}`.trimEnd();
+  }
+
+  static #clip(text: string, max: number): string {
+    return text.length <= max ? text : `${text.slice(0, max)}...`;
+  }
+}

package/vendor/use-agentic/WIRE.md

@@ -30,6 +30,8 @@ tools, and the loop stay in the client; the server serves exactly one stateless
 
 - `messages` is the whole transcript in `ChatMessage` shape (`types.ts`). The server maps it to its provider's
   format and maps the answer back; it never executes a tool — `tools` is a schema catalogue, not an offer.
+- A message flagged `"summary": true` stands in for the earlier messages a client-side compaction replaced. It is
+  history, not something the user said, so a backend that can frame it as one — a system message — should.
 - `context` blocks are host vocabulary. The server forwards them to the model as data, framed as data.
 - Everything is JSON-serializable by contract; a tool whose `result` is not is the tool's bug.
 
@@ -64,7 +66,10 @@ Nothing here is stored: the wire carries the bytes for exactly one turn's reques
 ```
 
 Any non-2xx status is surfaced to the session as one error event and ends the turn; a string `message` or
-`error` field in a JSON body is quoted in that event, and any other body is not interpreted.
+`error` field in a JSON body becomes that event's message verbatim, and any other body is not interpreted. A
+message that is a code rather than a sentence may be accompanied by a flat `data` object of strings and numbers —
+the values whoever resolves the code interpolates into its text; a host that does not know the code shows the
+message as it stands.
 
 ## Streaming
 

package/vendor/use-agentic/httpRunner.ts

@@ -64,12 +64,28 @@ async function* streamedEvents(body: ReadableStream<Uint8Array>, signal: AbortSi
   if (!ended) yield { type: "error", message: "The turn stream ended without a done event." };
 }
 
-const turnErrorMessage = async (response: Response): Promise<string> => {
-  const fallback = `Agent turn failed: ${response.status}`;
+/** Only a flat record of scalars is forwarded: what a coded message interpolates, never a nested payload. */
+const interpolations = (value: unknown): Record<string, string | number> | undefined => {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return undefined;
+  const entries = Object.entries(value).filter(
+    (entry): entry is [string, string | number] => typeof entry[1] === "string" || typeof entry[1] === "number",
+  );
+  return entries.length ? Object.fromEntries(entries) : undefined;
+};
+
+/**
+ * The server's own message travels verbatim — it was written for whoever is reading the chat, and a prefix in
+ * front of it both reads as two sentences and hides a coded message from the host that would have resolved it.
+ * The status stands in only when the body says nothing.
+ */
+const turnError = async (response: Response): Promise<RunnerEvent> => {
+  const fallback = { type: "error", message: `Agent turn failed: ${response.status}` } as const;
   try {
-    const body = (await response.json()) as { message?: unknown; error?: unknown };
+    const body = (await response.json()) as { message?: unknown; error?: unknown; data?: unknown };
     const message = typeof body.message === "string" ? body.message : typeof body.error === "string" ? body.error : "";
-    return message ? `Agent turn failed: ${message}` : fallback;
+    if (!message) return fallback;
+    const data = interpolations(body.data);
+    return { type: "error", message, ...(data ? { data } : {}) };
   } catch {
     return fallback;
   }
@@ -100,7 +116,7 @@ export const httpRunner = ({ url, headers, fetcher }: HttpRunnerOptions): AgentR
       signal: request.signal,
     });
     if (!response.ok) {
-      yield { type: "error", message: await turnErrorMessage(response) };
+      yield await turnError(response);
       return;
     }
     if (response.headers.get("content-type")?.includes("text/event-stream") && response.body) {

package/vendor/use-agentic/index.ts

@@ -6,6 +6,7 @@ export * from "./AgentProgress";
 export * from "./AgentProvider";
 export * from "./AgentScope";
 export * from "./AgentSession";
+export * from "./Compaction";
 export * from "./httpRunner";
 export * from "./surfaceContext";
 export * from "./types";

package/vendor/use-agentic/types.ts

@@ -155,6 +155,12 @@ export interface ChatMessage {
    * history the model reads, which would take it for something it had said itself.
    */
   local?: boolean;
+  /**
+   * Stands in for the messages compaction replaced. It rides the wire like any other message — it is what the
+   * model now remembers of them — but it is not something the user said, so a backend frames it as a summary and
+   * a host renders it as one.
+   */
+  summary?: boolean;
 }
 
 /** One block of screen context the host assembles per turn. `kind` is the host's vocabulary; the wire forwards it verbatim. */
@@ -167,7 +173,11 @@ export type RunnerEvent =
   | { type: "text"; delta: string }
   | { type: "toolCall"; id: string; name: string; args: Record<string, unknown> }
   | { type: "done"; stop: "end" | "toolUse" }
-  | { type: "error"; message: string };
+  /**
+   * `data` accompanies a message that is a code rather than a sentence — the values whoever resolves the code
+   * interpolates into its text. A host that does not know the code shows the message as it stands.
+   */
+  | { type: "error"; message: string; data?: Record<string, string | number> };
 
 export interface RunnerRequest {
   messages: ChatMessage[];