akanjs 3.0.0-alpha.42 → 3.0.0-alpha.43

package/dictionary/base.dictionary.ts

@@ -60,6 +60,19 @@ export const baseDictionary = serviceDictionary(["en", "ko"])
     agentAttachRemove: ["Remove attachment", "첨부 제거"],
     agentAttachTooLarge: ["{name} is too large to attach.", "{name}은(는) 용량이 너무 커서 첨부할 수 없습니다."],
     agentAttachUnsupported: ["{name} cannot be attached here.", "{name}은(는) 여기에 첨부할 수 없습니다."],
+    agentAttachDuplicate: ["{name} is already attached.", "{name}은(는) 이미 첨부되어 있습니다."],
+    agentAttachTooMany: [
+      "One message can carry {count} files at most.",
+      "한 메시지에는 파일을 최대 {count}개까지 첨부할 수 있습니다.",
+    ],
+    agentAttachTooMuch: [
+      "{name} would make this message too large to send.",
+      "{name}을(를) 더하면 메시지가 너무 커서 보낼 수 없습니다.",
+    ],
+    agentAnswerNeeded: ["Type an answer to the question above.", "위 질문에 대한 답을 입력하세요."],
+    agentToolDone: ["Done", "완료"],
+    agentToolFailed: ["Failed", "실패"],
+    agentToolRunning: ["Running", "실행 중"],
     agentContinue: ["This is taking a while. Keep going?", "시간이 걸리고 있습니다. 계속할까요?"],
     agentKeepGoing: ["Keep going", "계속하기"],
     agentCmdNew: ["Start a new conversation", "새 대화 시작"],

package/package.json

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

package/service/agent.service.ts

@@ -12,11 +12,29 @@ export class AgentService extends serve("agent" as const, ({ plug }) => ({
   llm: plug(LlmAdaptorRole),
 })) {
   async runTurn(request: LlmTurnRequest, onDelta?: (delta: string) => void) {
-    const answer = await this.llm.chat(AgentService.readable(request, this.llm.accepts), onDelta);
+    const prepared = AgentService.readable(AgentService.explained(request), this.llm.accepts);
+    const answer = await this.llm.chat(prepared, onDelta);
     if (!answer) throw new Err("agent.error.llmUnavailable");
     return { text: answer.text ?? "", toolCalls: answer.toolCalls ?? [], stop: answer.stop };
   }
 
+  /**
+   * Folds a failed turn into the message text. `error` is a field only this wire has, so a provider mapping reads
+   * `text` and drops it — leaving the model an assistant turn that says nothing, with no hint that the attempt
+   * failed, and every reason to make the same one again. Done here rather than per adaptor because every adaptor
+   * would otherwise have to remember, and forgetting is silent.
+   */
+  static explained(request: LlmTurnRequest): LlmTurnRequest {
+    if (!request.messages.some((message) => message.error)) return request;
+    return { ...request, messages: request.messages.map((message) => AgentService.explainedMessage(message)) };
+  }
+
+  private static explainedMessage(message: AgentWireMessage): AgentWireMessage {
+    const { error, ...rest } = message;
+    if (!error) return message;
+    return { ...rest, text: [message.text, `[The turn failed: ${error}]`].filter(Boolean).join("\n\n") };
+  }
+
   /**
    * Replaces every attachment the provider cannot read with a note naming it, so no adaptor has to think about
    * attachments it does not support and none can lose one quietly. The model has to be *told*, not merely spared:

package/store/agent/AgentPrompts.ts

@@ -49,11 +49,22 @@ export class AgentPrompts {
     return this.list().find((prompt) => prompt.name === name) ?? null;
   }
 
-  /** `/name arg1 arg2` — positional because a prompt's arguments are flat strings by protocol. */
+  /** `/name arg1 "an arg with spaces"` — positional because a prompt's arguments are flat strings by protocol. */
   static parseCommand(draft: string): { name: string; args: string[] } | null {
-    const match = /^\/([A-Za-z0-9_-]+)(?:\s+(.*))?$/.exec(draft.trim());
+    const match = /^\/([A-Za-z0-9_-]+)(?:\s+([\s\S]*))?$/.exec(draft.trim());
     if (!match) return null;
-    return { name: match[1], args: match[2]?.split(/\s+/).filter(Boolean) ?? [] };
+    return { name: match[1], args: AgentPrompts.#args(match[2] ?? "") };
+  }
+
+  /**
+   * Whitespace separates arguments, and quotes are how a sentence stays one of them — a prompt taking a single
+   * `String` is the common case, and splitting "plan the week" into three arguments fills the second parameter
+   * with the second word.
+   */
+  static #args(rest: string): string[] {
+    const args: string[] = [];
+    for (const token of rest.matchAll(/"([^"]*)"|'([^']*)'|(\S+)/g)) args.push(token[1] ?? token[2] ?? token[3]);
+    return args;
   }
 
   /** The messages a prompt returns become the user's turn, the way an MCP client sends a `prompts/get` result. */

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" | "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">;
+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" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "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" | "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>;
+    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" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "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" | "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";
+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" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "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" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "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" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "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" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "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" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "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" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "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" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "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/agent.service.d.ts

@@ -8,6 +8,14 @@ export declare class AgentService extends AgentService_base {
         toolCalls: import("./predefinedAdaptor.d.ts").AgentWireToolCall[];
         stop: "end" | "toolUse";
     }>;
+    /**
+     * Folds a failed turn into the message text. `error` is a field only this wire has, so a provider mapping reads
+     * `text` and drops it — leaving the model an assistant turn that says nothing, with no hint that the attempt
+     * failed, and every reason to make the same one again. Done here rather than per adaptor because every adaptor
+     * would otherwise have to remember, and forgetting is silent.
+     */
+    static explained(request: LlmTurnRequest): LlmTurnRequest;
+    private static explainedMessage;
     /**
      * Replaces every attachment the provider cannot read with a note naming it, so no adaptor has to think about
      * attachments it does not support and none can lose one quietly. The model has to be *told*, not merely spared:

package/types/store/agent/AgentPrompts.d.ts

@@ -20,7 +20,7 @@ export declare class AgentPrompts {
     constructor(signals: Record<string, SerializedSignal>);
     list(): AgentPrompt[];
     find(name: string): AgentPrompt | null;
-    /** `/name arg1 arg2` — positional because a prompt's arguments are flat strings by protocol. */
+    /** `/name arg1 "an arg with spaces"` — positional because a prompt's arguments are flat strings by protocol. */
     static parseCommand(draft: string): {
         name: string;
         args: string[];

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

@@ -13,5 +13,11 @@ interface BubbleProps {
      */
     results?: ReadonlyMap<string, ToolCallResult>;
 }
-export default function Bubble({ className, message, progress, results }: BubbleProps): import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * Memoized because the transcript re-renders on every streamed delta and on every keystroke in the composer, and
+ * a settled bubble re-parses its markdown for nothing each time. The props are compared by identity, so the caller
+ * hands the same `results` map and `progress` value to every row — which is why only the rows that actually
+ * changed re-render.
+ */
+declare const _default: import("react").MemoExoticComponent<({ className, message, progress, results }: BubbleProps) => import("react/jsx-runtime").JSX.Element>;
+export default _default;

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

@@ -1,8 +1,8 @@
 import { type ReactNode } from "react";
 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";
+import type { AttachReader } from "./attachment.d.ts";
+import type { PersistOption } from "./sessionHistory.d.ts";
+import type { VoiceEngine } from "./voice.d.ts";
 export interface ChatProps {
     className?: string;
     title?: string;
@@ -21,6 +21,8 @@ export interface ChatProps {
     persist?: PersistOption;
     /** Renders in the page flow instead of floating above it — a zone chat that lives inside its own section. */
     inline?: boolean;
+    /** `false` gives the browser its own Cmd/Ctrl+L back, for an app whose shell already spends that chord. */
+    shortcut?: boolean;
     /**
      * Reads a file the user attached into an attachment, or answers `null` to leave it to the built-in reader
      * (images as bytes, text as text). This is where an app puts what needs a parser — a PDF's text, a spreadsheet's
@@ -38,10 +40,10 @@ export interface ChatProps {
 /**
  * The user-facing half of the in-page agent: one floating chat wired to the same surface the dock inspects.
  * The conversation loop runs in this browser session — every tool call executes here, gated by the approval
- * card — and the session lives in a ref, so it survives reopening the panel and dies with the page (v1 keeps
- * no history). An enclosing AgentProvider's session wins, which is how an app isolates a surface or swaps the
- * loop while keeping this UI.
+ * card — and the session lives in a ref, so it survives reopening the panel and dies with the page unless
+ * `persist` keeps it. 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, compact, defaultOpen, persist, inline, attach, voice, }: ChatProps) => ReactNode;
+export declare const DefaultChat: ({ className, title, instructions, runner, maxTurns, compact, defaultOpen, persist, inline, shortcut, attach, voice, }: ChatProps) => ReactNode;
 declare const _default: import("react").ComponentType<ChatProps>;
 export default _default;

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

@@ -0,0 +1,23 @@
+import type { KeyboardEvent, Ref } from "react";
+import type { AgentSession, MessageAttachment } from "../../vendor/use-agentic.d.ts";
+interface ComposerProps {
+    className?: string;
+    session: AgentSession;
+    draft: string;
+    attached: readonly MessageAttachment[];
+    /** Absent when the screen cannot listen — the same rule as publishing no tool for a control that is not drawn. */
+    mic?: {
+        listening: boolean;
+        onToggle: () => void;
+    };
+    onDraft: (text: string) => void;
+    onKeyDown: (event: KeyboardEvent<HTMLInputElement>) => void;
+    onFiles: (files: File[]) => void;
+    onRemoveFile: (idx: number) => void;
+    onSend: () => void;
+    onStop: () => void;
+    inputRef?: Ref<HTMLInputElement>;
+}
+/** What the user writes with: the staged files above, and the controls that send or stop below them. */
+export declare const Composer: ({ className, session, draft, attached, mic, onDraft, onKeyDown, onFiles, onRemoveFile, onSend, onStop, inputRef, }: ComposerProps) => import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,16 @@
+import type { Ref } from "react";
+interface LauncherProps {
+    className?: string;
+    label: string;
+    /** The chord that opens the chat, shown on hover. Null until the platform is known, which needs the client. */
+    hotkey?: {
+        label: string;
+        keys: string;
+    } | null;
+    /** Messages that arrived while the panel was closed, so a finished turn is not silent. */
+    unread: number;
+    onOpen: () => void;
+    buttonRef?: Ref<HTMLButtonElement>;
+}
+export declare const Launcher: ({ className, label, hotkey, unread, onOpen, buttonRef }: LauncherProps) => import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -1,12 +1,17 @@
-import type { AgentPrompt } from "akanjs/store";
-import type { ChatCommand } from "./ChatCommands.d.ts";
+export interface MenuRow {
+    name: string;
+    description?: string;
+    /** The argument names a prompt takes, shown so a user knows what to type after the name. */
+    hint?: string;
+    pick: () => void;
+}
 interface MenuProps {
     className?: string;
-    commands: ChatCommand[];
-    prompts: AgentPrompt[];
-    onCommand: (command: ChatCommand) => void;
-    onPrompt: (prompt: AgentPrompt) => void;
+    rows: MenuRow[];
+    /** Index the arrows are on. Enter picks it and Tab completes its name, so it has to be visible. */
+    selected: number;
+    onPick: (row: MenuRow) => void;
 }
 /** The `/` menu: this chat's own commands first, then the app's `prompt()` endpoints. */
-export default function Menu({ className, commands, prompts, onCommand, onPrompt }: MenuProps): import("react/jsx-runtime").JSX.Element | null;
+export default function Menu({ className, rows, selected, onPick }: MenuProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

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

@@ -1,6 +1,6 @@
 import { type ReactNode } from "react";
-import { type AgentRunner } from "../../vendor/use-agentic.d.ts";
-import { type PersistOption } from "./sessionHistory.d.ts";
+import { type AgentRunner, type CompactOptions } from "../../vendor/use-agentic.d.ts";
+import type { PersistOption } from "./sessionHistory.d.ts";
 export interface ZoneProps {
     className?: string;
     /** Names the zone; the scope id and the `data-agent-zone` container both derive from it. */
@@ -10,6 +10,8 @@ export interface ZoneProps {
     instructions?: string;
     runner?: AgentRunner;
     maxTurns?: number;
+    /** When this zone's conversation summarizes itself — same contract as the chat's own `compact`. */
+    compact?: CompactOptions;
     /** Keeps this zone's transcript across reloads, keyed by the zone's scope path. */
     persist?: PersistOption;
     children: ReactNode;
@@ -20,4 +22,4 @@ export interface ZoneProps {
  * zones are views, never walls. An `Agent.Chat` mounted inside binds to this session automatically, so two zones
  * on one screen run two conversations in parallel, each seeing only its own subtree.
  */
-export declare const Zone: ({ className, id, label, instructions, runner, maxTurns, persist, children }: ZoneProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Zone: ({ className, id, label, instructions, runner, maxTurns, compact, persist, children, }: ZoneProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,18 @@
+import { type AgentRunner, AgentSession, type CompactOptions } from "../../vendor/use-agentic.d.ts";
+import { type PersistOption } from "./sessionHistory.d.ts";
+export interface AgentSessionSetup {
+    /** Read per call rather than captured, so text the session builds follows a language switched mid-conversation. */
+    l: (key: string) => string;
+    /** The zone's scope path, empty for the root agent — it picks both the surface view and the persistence key. */
+    view?: string[];
+    runner?: AgentRunner;
+    instructions?: string;
+    maxTurns?: number;
+    compact?: CompactOptions;
+    persist?: PersistOption;
+}
+/**
+ * The one place a chat session is wired to the akan runtime. Chat and Zone both build one, and building it twice
+ * is how a zone came to be the only surface with no `compact` option — an option added on one side of a copy.
+ */
+export declare const agentSessionOf: ({ l, view, runner, instructions, maxTurns, compact, persist, }: AgentSessionSetup) => AgentSession;

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

@@ -7,6 +7,13 @@ export type AttachReader = (file: File) => Promise<MessageAttachment | null>;
  * the user learns which file it was.
  */
 export declare const maxAttachmentBytes: number;
+/**
+ * Ceilings for one message rather than one file. The bytes ride inside a single turn's JSON, so what a provider
+ * refuses is the sum — and a count cap keeps a whole folder dropped onto the panel from becoming one request that
+ * cannot be sent and cannot be edited down without starting over.
+ */
+export declare const maxMessageAttachmentBytes: number;
+export declare const maxMessageAttachments = 5;
 export type AttachFailure = "tooLarge" | "unsupported";
 export declare class Attachment {
     #private;
@@ -20,4 +27,8 @@ export declare class Attachment {
      */
     static read(file: File, attach?: AttachReader): Promise<MessageAttachment | AttachFailure>;
     static failure(value: MessageAttachment | AttachFailure): value is AttachFailure;
+    /** What this attachment costs the request: base64 carries three bytes per four characters, less its padding. */
+    static bytesOf(attachment: MessageAttachment): number;
+    /** Same name and same size is the same file picked twice — the shape a re-drop or a double paste produces. */
+    static same(one: MessageAttachment, other: MessageAttachment): boolean;
 }

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

@@ -13,5 +13,5 @@ export declare const Agent: {
     StateKey: typeof StateKey;
     Tool: typeof Tool;
     Transcript: typeof Transcript;
-    Zone: ({ className, id, label, instructions, runner, maxTurns, persist, children }: import("./Zone.d.ts").ZoneProps) => import("react/jsx-runtime").JSX.Element;
+    Zone: ({ className, id, label, instructions, runner, maxTurns, compact, persist, children, }: import("./Zone.d.ts").ZoneProps) => import("react/jsx-runtime").JSX.Element;
 };

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

@@ -1,4 +1,4 @@
-import type { SessionHistory } from "../../vendor/use-agentic.d.ts";
+import { type SessionHistory } from "../../vendor/use-agentic.d.ts";
 export type PersistOption = boolean | {
     storage?: "session" | "local";
     key?: string;
@@ -7,6 +7,8 @@ export type PersistOption = boolean | {
  * Maps the `persist` prop onto a `SessionHistory` over web storage. Session storage is the default on purpose:
  * surviving a refresh is the whole ask, and a transcript that dies with the tab never lingers on a shared machine
  * or collides across tabs. `"local"` is the explicit opt-up. The envelope is versioned so a wire change discards
- * stale transcripts instead of replaying them, and only the newest messages are kept under the cap.
+ * stale transcripts instead of replaying them, and only the newest messages are kept under the cap — which is
+ * why the cap is applied *before* the pairing repair: the window it keeps can start between a tool call and the
+ * result answering it, and a transcript restored in that state is refused by the provider on its first turn.
  */
 export declare const sessionHistoryOf: (persist: PersistOption | undefined, pathKey?: string) => SessionHistory | undefined;

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

@@ -0,0 +1,24 @@
+import { type DragEventHandler } from "react";
+import type { AgentSession, MessageAttachment } from "../../vendor/use-agentic.d.ts";
+import { type AttachReader } from "./attachment.d.ts";
+interface ChatAttachmentsSetup {
+    session: AgentSession;
+    attach?: AttachReader;
+    l: (key: string, param?: Record<string, string | number>) => string;
+}
+/**
+ * What the composer is holding, and the ceilings it holds it under. Staged files are mirrored in a ref because a
+ * multi-file drop reads them one at a time: the cap has to see what the previous file of the same drop added, and
+ * React state inside that loop is still the value the render started with.
+ */
+export declare const useChatAttachments: ({ session, attach, l }: ChatAttachmentsSetup) => {
+    attached: MessageAttachment[];
+    dragging: boolean;
+    dropProps: {
+        [key: string]: DragEventHandler<HTMLElement>;
+    };
+    add: (files: File[]) => Promise<void>;
+    clear: () => void;
+    remove: (idx: number) => void;
+};
+export {};

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

@@ -0,0 +1,30 @@
+import type { AgentSession } from "../../vendor/use-agentic.d.ts";
+import { type VoiceEngine } from "./voice.d.ts";
+interface ChatVoiceSetup {
+    session: AgentSession;
+    engine?: VoiceEngine;
+    /** The chat's own version snapshot — every transcript change re-runs the reading policy. */
+    version: number;
+    onTranscript: (text: string) => void;
+    onFailed: () => void;
+}
+/**
+ * The chat's speech policy, which is the framework's and not the engine's: one utterance per press, the
+ * transcript landing in the composer to be corrected, barge-in on the next press or on Stop, and a reply read
+ * aloud **only when the ask arrived by voice** — a typed question never turns the speakers on.
+ *
+ * A question or an approval the loop parked on is read too, and only in that same case: the loop stops there,
+ * and a voice user staring at a card they were never told about is a conversation that simply ends.
+ */
+export declare const useChatVoice: ({ session, engine, version, onTranscript, onFailed }: ChatVoiceSetup) => {
+    listening: boolean;
+    /** A screen that cannot listen renders no microphone — the rule that publishes no tool for a missing control. */
+    canListen: boolean;
+    silence: () => void;
+    /** Called by the send that opens a turn: only an ask that arrived by voice is answered out loud. */
+    take: () => void;
+    /** The draft was consumed by something that is not a new turn — an answer to a question the agent asked. */
+    drop: () => void;
+    toggle: () => void;
+};
+export {};

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

@@ -0,0 +1,14 @@
+import type { ChatMessage } from "../../vendor/use-agentic.d.ts";
+/**
+ * ↑ walks back through what was sent, ↓ forward, and 0 is the draft it was walked away from. A single-line input
+ * does nothing of its own with the vertical arrows, so recall is free to take them.
+ *
+ * Seeded from the transcript rather than starting empty, because a persisted chat restores the conversation and
+ * losing only "what I just typed" across a reload is the one gap a user notices.
+ */
+export declare const useDraftRecall: (messages: readonly ChatMessage[]) => {
+    has: boolean;
+    remember: (text: string) => void;
+    /** Answers the draft to show, or null when the walk cannot go that way. */
+    step: (delta: number, draft: string) => string | null;
+};

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

@@ -0,0 +1,24 @@
+import type { AgentPrompt, AgentPrompts } from "akanjs/store";
+import { type ChatCommand } from "./ChatCommands.d.ts";
+import type { MenuRow } from "./Menu.d.ts";
+interface SlashMenuSetup {
+    draft: string;
+    prompts: AgentPrompts | null;
+    l: (key: string) => string;
+    onCommand: (command: ChatCommand) => void;
+    onPrompt: (prompt: AgentPrompt) => void;
+}
+/**
+ * The `/` menu's rows and which one the keys are on. Built from this chat's own commands first and the app's
+ * `prompt()` endpoints after, with a prompt whose name a built-in already holds dropped rather than listed twice.
+ */
+export declare const useSlashMenu: ({ draft, prompts, l, onCommand, onPrompt }: SlashMenuSetup) => {
+    rows: MenuRow[];
+    selected: number;
+    /** Reset when the draft is written to: a new query has a new first row, and Escape only hides the old one. */
+    reopen: () => void;
+    hide: () => void;
+    move: (delta: number) => void;
+    at: () => MenuRow;
+};
+export {};

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

@@ -61,6 +61,11 @@ export declare class VoiceReader {
      * splits what is left, because a whole answer that arrived in one render must not be read as one long utterance.
      */
     flush(source: string): void;
+    /**
+     * A line that is not part of the answer being tracked — the question or approval the loop parked on. It joins
+     * the same queue, so it is spoken after the sentence in flight rather than over it, and Stop still cancels it.
+     */
+    say(text: string): void;
     cancel(): void;
     reset(): void;
 }

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

@@ -42,9 +42,10 @@ export interface AgentSessionOptions {
     settle?: () => Promise<void> | void;
     /**
      * Turns the turn cap into a question instead of a dead end. Omitted, the cap fails as before — a host that
-     * renders no `pendingQuestion` would otherwise wait forever for an answer nobody can give.
+     * renders no `pendingQuestion` would otherwise wait forever for an answer nobody can give. Read per ask rather
+     * than at construction, so the text follows a language switched mid-conversation.
      */
-    continueAsk?: {
+    continueAsk?: () => {
         question: string;
         keep: string;
     };