@k2b/cloud 0.27.0 → 0.29.0

package/src/ai/chat/turn-error.ts

@@ -0,0 +1,21 @@
+import type { AiTurnError } from "../types";
+import { aiChatMessages } from "./messages";
+
+/**
+ * Whether a new message can pick up the work. A full context, a used-up quota, or lost access would fail the next
+ * turn the same way; the reason then names the next step itself.
+ */
+export const aiTurnErrorCanContinue = (error: AiTurnError): boolean =>
+  error.code !== "context_full" && error.code !== "quota_exhausted" && error.code !== "not_allowed";
+
+/** What the chat shows under the title: the reason, and that the results so far are kept when the work can go on. */
+export const aiTurnErrorDescription = (error: AiTurnError, locale: string): string => {
+  const t = aiChatMessages(locale);
+  return aiTurnErrorCanContinue(error) ? `${t.turnErrorReason(error)} ${t.turnErrorKept}` : t.turnErrorReason(error);
+};
+
+/** The turn's stored error for readers without the chat view, such as `cld`: the description and how to go on. */
+export const aiTurnErrorText = (error: AiTurnError, locale: string): string =>
+  aiTurnErrorCanContinue(error)
+    ? `${aiTurnErrorDescription(error, locale)} ${aiChatMessages(locale).turnErrorContinueHint}`
+    : aiTurnErrorDescription(error, locale);

package/src/ai/chat/turn-layout.ts

@@ -1,4 +1,5 @@
 import { type AiTurnBlock, isRenderableTurnBlock } from "../protocol";
+import type { AiStoredMessage } from "../types";
 import { hasCapabilityTable } from "./capability-result";
 import { isCardToolName, isRecord, isSurveyToolName, isTextEditorToolName } from "./message-utils";
 import { isFailedTool } from "./tool-groups";
@@ -139,3 +140,14 @@ export function layoutAiTurn(input: readonly AiTurnBlock[], options: { phase: Ai
     waitingFor,
   };
 }
+
+/** The loop ending is authoritative; partial messages also carry their own failed or interrupted ending. */
+export const storedPhase = (entries: readonly Pick<AiStoredMessage, "loopDoneReason" | "stopReason">[]): AiTurnPhase => {
+  const reason = entries.findLast((entry) => entry.loopDoneReason)?.loopDoneReason;
+  if (reason === "aborted") return "stopped";
+  if (reason && reason !== "stop") return "failed";
+  const stop = entries.findLast((entry) => entry.stopReason)?.stopReason;
+  if (stop === "error") return "failed";
+  if (stop === "interrupted" || stop === "aborted") return "stopped";
+  return "completed";
+};

package/src/ai/chat/turn-view.tsx

@@ -1,4 +1,4 @@
-import { announce, Button, ButtonLink, Chat, useLocale } from "@k2b/ui";
+import { announce, Button, ButtonLink, Chat, NoticeCard, useLocale } from "@k2b/ui";
 import {
   type Accessor,
   createEffect,
@@ -16,6 +16,7 @@ import {
 } from "solid-js";
 import { markdown } from "../../shared";
 import { AI_TURN_LEASE_MS, type AiTurnBlock } from "../protocol";
+import type { AiTurnError } from "../types";
 import { ApprovalBlockView, CompactionBlockView, CompactToolRow, SurveyToolView, TextEditorToolView } from "./blocks";
 import { CapabilityTablePreview } from "./capability-table";
 import { PresentToolBlock } from "./file-tools";
@@ -25,6 +26,7 @@ import { aiChatMessages } from "./messages";
 import { AssistantMarkdownBlock } from "./primitives";
 import { AiToolActivity, AiToolDisclosureProvider, type AiToolDisclosureState } from "./tool-disclosure";
 import { type AiWorkEntry, countWorkSteps, groupWorkBlocks, summarizeToolGroup } from "./tool-groups";
+import { aiTurnErrorCanContinue, aiTurnErrorDescription } from "./turn-error";
 import type { AiTurnAction, AiTurnLayout, AiTurnPhase, AiTurnResult } from "./turn-layout";
 import { CloudCardBlock } from "./visual-tools";
 
@@ -53,6 +55,10 @@ export type AiTurnSegment = {
    * it in a row at the end of its last segment.
    */
   reconnect?: "line" | "row";
+  /** Why the turn failed, shown in a notice at its end. Only the last segment of a failed turn carries it. */
+  error?: AiTurnError | null;
+  /** The failed turn is the chat's newest and nothing runs, so a new message can pick up its work. */
+  continuable?: boolean;
 };
 
 const isLive = (phase: AiTurnPhase) => phase === "running" || phase === "waiting";
@@ -121,7 +127,8 @@ const stepPhrase = (block: AiTurnBlock | null, t: Messages, withTargets: boolean
   if (["code_write", "code_create", "code_update", "code_fork", "code_remove", "code_restore"].includes(name))
     return withTarget(t.stepWritingCode);
   if (["code_run", "code_action", "code_sql"].includes(name)) return withTarget(t.stepRunningCode);
-  if (["code_inspect", "code_interact"].includes(name)) return t.stepCheckingApp;
+  if (name === "code_check") return t.stepCheckingApp;
+  if (name === "code_inspect") return t.stepCheckingRun;
   if (name.startsWith("code_")) return t.stepCode;
   if (["markdown_to_pdf", "html_to_pdf"].includes(name)) return withTarget(t.stepPdf);
   if (["load_skill", "load_tools", "search_tools", "list_apps"].includes(name)) return t.stepLoading;
@@ -165,7 +172,8 @@ function AiWorkLine(props: { segment: Accessor<AiTurnSegment> }) {
     const duration = worked();
     const short = duration === null ? "" : formatWorkDuration(duration, t());
     if (segment().phase === "stopped") return t().workedStopped({ duration: short });
-    if (segment().phase === "failed") return t().workedInterrupted({ duration: short });
+    // A failed turn with a stored reason says it in its notice; the line then reads like any finished turn.
+    if (segment().phase === "failed" && !segment().error) return t().workedInterrupted({ duration: short });
     return short ? t().workedFor({ duration: short }) : t().worked;
   };
   const ariaLabel = () => {
@@ -175,7 +183,7 @@ function AiWorkLine(props: { segment: Accessor<AiTurnSegment> }) {
     return t().workedLabel({
       duration: duration === null ? "" : formatWorkDuration(duration, t(), true),
       steps: layout().steps ? steps() : "",
-      ending: phase === "stopped" || phase === "failed" ? phase : null,
+      ending: phase === "stopped" || (phase === "failed" && !segment().error) ? phase : null,
     });
   };
   const trailing = () => {
@@ -362,6 +370,7 @@ function ResultLinks(props: { links: Record<string, unknown>[] }) {
 
 /** The summary and links of a table result, unless its receipt in place 4 already shows them. */
 function CapabilityResultRow(props: { block: ToolBlock }) {
+  const locale = useLocale();
   const block = () => props.block;
   const summary = () => resultSummary(block());
   const links = () => resultLinks(block());
@@ -370,7 +379,7 @@ function CapabilityResultRow(props: { block: ToolBlock }) {
       <Chat.Activity
         icon={aiToolIcon(block().name, block().presentation?.appIcon)}
         accent={block().presentation?.appAccent}
-        label={summary() || (block().presentation?.title ?? displayToolName(block().name))}
+        label={summary() || (block().presentation?.title ?? displayToolName(block().name, locale()))}
         trailing={links().length > 0 ? <ResultLinks links={links()} /> : undefined}
       />
     </Show>
@@ -378,6 +387,7 @@ function CapabilityResultRow(props: { block: ToolBlock }) {
 }
 
 function AiTurnResultView(props: { result: Accessor<AiTurnResult | undefined>; receipt: Accessor<boolean> }) {
+  const locale = useLocale();
   const actions = useAiChatActions();
   const block = () => props.result()?.block;
   return (
@@ -407,7 +417,10 @@ function AiTurnResultView(props: { result: Accessor<AiTurnResult | undefined>; r
             <Show when={!props.receipt()}>
               <CapabilityResultRow block={current()} />
             </Show>
-            <CapabilityTablePreview result={current().result} label={current().presentation?.title ?? displayToolName(current().name)} />
+            <CapabilityTablePreview
+              result={current().result}
+              label={current().presentation?.title ?? displayToolName(current().name, locale())}
+            />
           </Match>
         </Switch>
       )}
@@ -419,7 +432,7 @@ function AiReceipt(props: { action: AiTurnAction; stopped: boolean }) {
   const locale = useLocale();
   const t = () => aiChatMessages(locale());
   const block = () => props.action.block;
-  const title = () => block().presentation?.title ?? displayToolName(block().name);
+  const title = () => block().presentation?.title ?? displayToolName(block().name, locale());
   const links = () => (props.action.state === "done" ? resultLinks(block()) : []);
   const label = () => {
     const state = props.action.state;
@@ -458,7 +471,9 @@ function AiTurnActionView(props: { action: Accessor<AiTurnAction | undefined>; t
       const current = action();
       if (next !== "open" || previous === "open" || !isLive(props.phase) || current?.block.status !== "awaiting_approval") return;
       announce(
-        aiChatMessages(locale()).approvalNeeded({ title: current.block.presentation?.title ?? displayToolName(current.block.name) }),
+        aiChatMessages(locale()).approvalNeeded({
+          title: current.block.presentation?.title ?? displayToolName(current.block.name, locale()),
+        }),
       );
     }),
   );
@@ -493,7 +508,7 @@ function AiTurnActionView(props: { action: Accessor<AiTurnAction | undefined>; t
               <Switch
                 fallback={
                   <Chat.Activity
-                    label={current().block.presentation?.title ?? displayToolName(current().block.name)}
+                    label={current().block.presentation?.title ?? displayToolName(current().block.name, locale())}
                     icon={aiToolIcon(current().block.name)}
                     busy={current().block.status === "awaiting_client"}
                   />
@@ -509,7 +524,7 @@ function AiTurnActionView(props: { action: Accessor<AiTurnAction | undefined>; t
             </Match>
             <Match when={current().state === "running"}>
               <Chat.Activity
-                label={current().block.presentation?.title ?? displayToolName(current().block.name)}
+                label={current().block.presentation?.title ?? displayToolName(current().block.name, locale())}
                 icon={aiToolIcon(current().block.name, current().block.presentation?.appIcon)}
                 accent={current().block.presentation?.appAccent}
                 busy
@@ -522,6 +537,37 @@ function AiTurnActionView(props: { action: Accessor<AiTurnAction | undefined>; t
   );
 }
 
+/**
+ * Why a turn failed and what comes next, at its end. "Continue" sends a visible message through the host's normal
+ * send path, so the person sees what was asked; it is offered only for the chat's newest turn and only when a new
+ * turn can finish the work.
+ */
+function AiTurnErrorNotice(props: { error: AiTurnError; continuable: boolean }) {
+  const locale = useLocale();
+  const t = () => aiChatMessages(locale());
+  const actions = useAiChatActions();
+  const [continuing, setContinuing] = createSignal(false);
+  const canContinue = () => props.continuable && aiTurnErrorCanContinue(props.error) && Boolean(actions.onContinueTurn);
+  const continueTurn = async () => {
+    if (continuing()) return;
+    setContinuing(true);
+    try {
+      await actions.onContinueTurn?.(t().continueTurnMessage);
+    } finally {
+      setContinuing(false);
+    }
+  };
+  return (
+    <NoticeCard tone="danger" class="ai-turn__notice" title={t().turnErrorTitle} detail={aiTurnErrorDescription(props.error, locale())}>
+      <Show when={canContinue()}>
+        <Button variant="text" size="sm" loading={continuing()} disabled={actions.actionDisabled?.()} onClick={() => void continueTurn()}>
+          <i class="ti ti-player-play" aria-hidden="true" /> {t().continueTurn}
+        </Button>
+      </Show>
+    </NoticeCard>
+  );
+}
+
 /**
  * Place 3. Live it is a status that switches in this same element; it keeps its height until the turn ends. A status
  * is not read token by token: screen readers hear each status once it is complete, and that the answer is ready.
@@ -605,6 +651,16 @@ export function AiTurnView(props: { segment: Accessor<AiTurnSegment>; disclosure
   const actions = createMemo(() => new Map(layout().actions.map((action) => [action.id, action])));
   const actionIds = createMemo(() => [...actions().keys()]);
   const live = () => isLive(props.segment().phase);
+  // Screen readers hear once that the turn they followed failed and why; history read later is not announced.
+  createEffect(
+    on(live, (now, before) => {
+      const error = props.segment().error;
+      if (before && !now && error) {
+        const t = aiChatMessages(locale());
+        announce(`${t.turnErrorTitle} ${aiTurnErrorDescription(error, locale())}`);
+      }
+    }),
+  );
   return (
     <AiToolDisclosureProvider state={props.disclosureState}>
       <div class="ai-turn">
@@ -638,6 +694,9 @@ export function AiTurnView(props: { segment: Accessor<AiTurnSegment>; disclosure
           {/* Calm by design: no busy sweep while the turn reconnects. */}
           <Chat.Activity label={aiChatMessages(locale()).reconnecting} icon="ti ti-refresh" />
         </Show>
+        <Show when={props.segment().error}>
+          {(error) => <AiTurnErrorNotice error={error()} continuable={props.segment().continuable === true} />}
+        </Show>
       </div>
     </AiToolDisclosureProvider>
   );

package/src/ai/chat/user-message.tsx

@@ -13,11 +13,14 @@ import {
   userVisibleTextFromMessage,
   vfsAttachmentsFromMessage,
 } from "./message-utils";
+import { aiChatMessages } from "./messages";
 
 const openModifyRetryDialog = (
   entry: AiStoredMessage,
   onRetryMessage: (entry: AiStoredMessage, input?: AiRetryMessageInput) => void | Promise<void>,
+  locale: string,
 ) => {
+  const t = aiChatMessages(locale);
   void dialogCore.open<void>((close) => {
     const [draft, setDraft] = createSignal(userVisibleTextFromMessage(entry.message));
     const content = () => userContentWithEditedVisibleText(entry.message, draft());
@@ -34,11 +37,11 @@ const openModifyRetryDialog = (
 
     return (
       <PanelDialog>
-        <PanelDialog.Header title="Edit and try again" icon="ti ti-pencil" close={close} />
+        <PanelDialog.Header title={t.retryTitle} icon="ti ti-pencil" close={close} />
         <PanelDialog.Body>
           <TextInput
-            label="Prompt"
-            description="Attachments from the original message stay attached."
+            label={t.retryPrompt}
+            description={t.retryPromptHint}
             multiline
             lines={8}
             value={draft}
@@ -47,18 +50,18 @@ const openModifyRetryDialog = (
           />
           <Show when={retryMutation.error()}>
             <p class="text-xs text-red-600 dark:text-red-400" role="alert">
-              Could not retry this message. Your changes are still here.
+              {t.retryFailed}
             </p>
           </Show>
         </PanelDialog.Body>
         <PanelDialog.Footer>
           <div class="ml-auto flex items-center gap-2">
             <Button type="button" variant="secondary" size="sm" onClick={() => close()}>
-              Cancel
+              {t.cancel}
             </Button>
             <Button type="button" variant="ai" size="sm" disabled={!canRetry()} onClick={retry}>
               <i class={`ti ${retryMutation.loading() ? "ti-loader-2 animate-spin" : "ti-refresh"}`} aria-hidden="true" />
-              {retryMutation.loading() ? "Trying again" : "Try again"}
+              {retryMutation.loading() ? t.retrying : t.actionTryAgain}
             </Button>
           </div>
         </PanelDialog.Footer>
@@ -93,38 +96,39 @@ export const aiUserMessageAttachments = (entry: AiStoredMessage, actions: AiChat
   })),
 ];
 
-export const createAiUserMessageActions = (entry: AiStoredMessage, actions: AiChatActions): ChatAction[] => {
+export const createAiUserMessageActions = (entry: AiStoredMessage, actions: AiChatActions, locale: string): ChatAction[] => {
+  const t = aiChatMessages(locale);
   const result: ChatAction[] = [];
   const copyText = copyTextFromMessage(entry.message);
 
   if (copyText) {
-    result.push({ id: "copy", label: "Copy", icon: "ti ti-copy", copyText });
+    result.push({ id: "copy", label: t.actionCopy, icon: "ti ti-copy", copyText });
   }
   if (!entry.compactedAt && actions.onRetryMessage) {
     result.push(
       {
         id: "retry",
-        label: "Try again",
+        label: t.actionTryAgain,
         icon: "ti ti-refresh",
         onSelect: () => actions.onRetryMessage?.(entry, { mode: "retry" }),
       },
       {
         id: "details",
-        label: "More detailed",
+        label: t.actionMoreDetailed,
         icon: "ti ti-list-details",
         onSelect: () => actions.onRetryMessage?.(entry, { mode: "details" }),
       },
       {
         id: "concise",
-        label: "More concise",
+        label: t.actionMoreConcise,
         icon: "ti ti-align-left",
         onSelect: () => actions.onRetryMessage?.(entry, { mode: "concise" }),
       },
       {
         id: "edit",
-        label: "Edit prompt",
+        label: t.actionEditPrompt,
         icon: "ti ti-pencil",
-        onSelect: () => openModifyRetryDialog(entry, actions.onRetryMessage!),
+        onSelect: () => openModifyRetryDialog(entry, actions.onRetryMessage!, locale),
       },
     );
   }
@@ -136,12 +140,13 @@ export const aiSteerMessageText = (block: Extract<AiTurnBlock, { kind: "steer_me
 export const createAiSteerMessageActions = (
   block: Extract<AiTurnBlock, { kind: "steer_message" }>,
   actions: AiChatActions,
+  locale: string,
 ): ChatAction[] => {
   if (block.status !== "failed" || !actions.onRetrySteer) return [];
   return [
     {
       id: "retry-steer",
-      label: "Retry guidance",
+      label: aiChatMessages(locale).actionRetryGuidance,
       icon: "ti ti-refresh",
       onSelect: () => actions.onRetrySteer?.(block),
     },

package/src/ai/chat/visual-tools.tsx

@@ -228,7 +228,7 @@ export function CloudSurveyBlock(props: {
           </Show>
         </div>
       </div>
-      <footer class="flex min-h-12 items-center gap-3 border-t border-[var(--k2b-border)] bg-[var(--k2b-surface-subtle)] px-4 py-2.5">
+      <footer class="flex min-h-12 items-center gap-3 px-4 pb-3">
         <Show when={submitted()}>
           <span class="inline-flex items-center gap-1.5 text-xs font-medium text-secondary">
             <i class="ti ti-check text-[var(--k2b-ai-accent)]" aria-hidden="true" />

package/src/ai/chat-tasks.ts

@@ -4,6 +4,7 @@ import { getCapability } from "../_internal/registry";
 import { logger } from "../services/logging";
 import {
   createMandate,
+  MANDATE_POLICY_DENIED_MESSAGE,
   type Mandate,
   type MandatePolicyV1,
   MandatePolicyV1Schema,
@@ -88,7 +89,14 @@ export class AiChatTaskIdempotencyConflictError extends Error {
 }
 
 class AiChatTaskCreateRace extends Error {}
-class AiChatTaskAuthorityError extends Error {}
+export class AiChatTaskAuthorityError extends Error {
+  constructor(
+    message: string,
+    readonly code?: string,
+  ) {
+    super(message);
+  }
+}
 const log = logger("ai:chat-tasks");
 
 type OccurrenceRow = {
@@ -497,10 +505,15 @@ export const aiChatTasks = {
       input: input.input,
       capabilityApproval: input.approval,
     });
-    if (!result.ok)
+    if (!result.ok) {
+      const policyDenied = result.error.code === "FORBIDDEN" && result.error.message === MANDATE_POLICY_DENIED_MESSAGE;
       throw new AiChatTaskAuthorityError(
-        `Background task cannot call ${input.appId}.${input.capabilityId}: ${result.error.message}. Check the task grants and fixed inputs in the normal chat; this run cannot expand them.`,
+        policyDenied
+          ? `This task's grants do not allow ${input.appId}.${input.capabilityId} with these inputs; continue with the granted tools or explain what is missing.`
+          : `Background task cannot call ${input.appId}.${input.capabilityId}: ${result.error.message}. Check the task grants and fixed inputs in the normal chat; this run cannot expand them.`,
+        policyDenied ? "MANDATE_POLICY_DENIED" : result.error.code,
       );
+    }
   },
   list: async (input: {
     userId: string;

package/src/ai/client/controller.ts

@@ -94,13 +94,26 @@ const isCurrentStreamSession = (current: AiStreamSession | null, candidate: AiSt
 
 const DEFAULT_RUN_ERROR = "Assistant response failed.";
 
-const conversationRunError = (conversation: AiConversation | null | undefined): string | null =>
-  conversation?.runStatus === "failed" ? conversation.runError?.trim() || DEFAULT_RUN_ERROR : null;
+/** The failure of the chat's latest turn, and that turn when known. */
+type AiRunError = { message: string; turnId: string | null };
 
-const runErrorFromEvent = (event: AiStreamEvent, activeTurnId: string | null | undefined): string | null | undefined => {
+const conversationRunError = (conversation: AiConversation | null | undefined): AiRunError | null =>
+  conversation?.runStatus === "failed"
+    ? { message: conversation.runError?.trim() || DEFAULT_RUN_ERROR, turnId: conversation.runTurnId ?? null }
+    : null;
+
+/**
+ * Whether the failed turn shows its failure itself: its last message carries the reason, and the timeline words it in
+ * a notice at the turn's end. The run error then stays out of `error()`, so it does not appear twice. A turn without a
+ * recorded reason, such as a failed compaction or a turn from an earlier release, still reports it there.
+ */
+const turnShowsError = (messages: readonly AiStoredMessage[], turnId: string | null): boolean =>
+  turnId !== null && messages.some((message) => message.loopId === turnId && message.meta?.turnError);
+
+const runErrorFromEvent = (event: AiStreamEvent, activeTurnId: string | null | undefined): AiRunError | null | undefined => {
   if (event.type === "state") return conversationRunError(event.conversation);
   if (event.type !== "turn_finished" || event.turnId !== activeTurnId) return undefined;
-  return event.status === "failed" ? event.error?.trim() || DEFAULT_RUN_ERROR : null;
+  return event.status === "failed" ? { message: event.error?.trim() || DEFAULT_RUN_ERROR, turnId: event.turnId } : null;
 };
 
 export type CreateAiChatControllerOptions = {
@@ -168,7 +181,7 @@ const errorText = (error: unknown, fallback: string): string =>
 export const createAiChatController = (options: CreateAiChatControllerOptions) => {
   const [activeConversationId, setActiveConversationIdSignal] = createSignal<string | null>(options.initialConversationId ?? null);
   const [globalError, setGlobalError] = createSignal<string | null>(options.initialError ?? null);
-  const [runError, setRunError] = createSignal<string | null>(conversationRunError(options.initialDetail?.conversation));
+  const [runError, setRunError] = createSignal<AiRunError | null>(conversationRunError(options.initialDetail?.conversation));
   const [runStatusRaw, setRunStatusRaw] = createSignal<AiChatRunStatus | null>(null);
   const [streamStatus, setStreamStatus] = createSignal<AiStreamStatus>("idle");
   const initialProjection = options.initialDetail ? detailToProjection(options.initialDetail) : emptyProjection();
@@ -250,7 +263,10 @@ export const createAiChatController = (options: CreateAiChatControllerOptions) =
     const conversationId = activeConversationId();
     if (conversationId) openStream(conversationId);
   };
-  const error = () => globalError() ?? runError();
+  const error = () => {
+    const run = runError();
+    return globalError() ?? (run && !turnShowsError(state.messages, run.turnId) ? run.message : null);
+  };
 
   const activeTurn = () => state.activeTurn;
   const messages = createMemo(() => messagesWithPendingSend(visibleMessages(state), pendingSends()[activeConversationId() ?? ""]));
@@ -1415,6 +1431,7 @@ export const __aiControllerTest = {
   completeFrontendToolBlock,
   conversationRunError,
   failSteerBlock,
+  turnShowsError,
   projectionForConversationOpen,
   reconcileSteerBlocks,
   runErrorFromEvent,