@open-mercato/ui 0.5.1-develop.3036.f02c281f23 → 0.5.1-develop.3045.b4b3320cc2

package/dist/ai/parts/MutationResultCard.js

@@ -0,0 +1,240 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { AlertTriangle, CheckCircle2, Wand2, XCircle } from "lucide-react";
+import { useT } from "@open-mercato/shared/lib/i18n/context";
+import { Alert, AlertTitle } from "../../primitives/alert.js";
+import { Button } from "../../primitives/button.js";
+import { useAiPendingActionPolling } from "./useAiPendingActionPolling.js";
+const AI_CHAT_FIX_REQUEST_EVENT = "om-ai-chat-fix-request";
+function dispatchFixRequest(detail) {
+  if (typeof window === "undefined") return;
+  window.dispatchEvent(new CustomEvent(AI_CHAT_FIX_REQUEST_EVENT, { detail }));
+}
+function isSuccessStatus(status) {
+  return status === "confirmed";
+}
+function isFailureStatus(status) {
+  return status === "failed" || status === "cancelled" || status === "expired";
+}
+function MutationResultCard(props) {
+  const t = useT();
+  const pendingActionId = props.pendingActionId ?? "";
+  const payload = props.payload ?? {};
+  const injected = props.initialAction ?? payload.pendingAction ?? null;
+  const { action: polled } = useAiPendingActionPolling({
+    pendingActionId,
+    endpoint: props.endpoint,
+    disabled: !pendingActionId || Boolean(injected)
+  });
+  const action = injected ?? polled;
+  const status = action?.status ?? null;
+  const failedRecords = action?.failedRecords ?? null;
+  const result = action?.executionResult ?? null;
+  if (!action) {
+    return null;
+  }
+  if (isSuccessStatus(status) && failedRecords && failedRecords.length > 0) {
+    return /* @__PURE__ */ jsxs(Alert, { variant: "warning", "data-ai-mutation-result": "partial", children: [
+      /* @__PURE__ */ jsx(AlertTriangle, { className: "size-4", "aria-hidden": true }),
+      /* @__PURE__ */ jsx(AlertTitle, { children: t(
+        "ai_assistant.chat.mutation_cards.result.partialTitle",
+        "Action applied with failures"
+      ) }),
+      /* @__PURE__ */ jsxs("div", { className: "text-sm leading-relaxed", children: [
+        /* @__PURE__ */ jsx("p", { children: t(
+          "ai_assistant.chat.mutation_cards.result.partialBody",
+          "Some records could not be updated."
+        ) }),
+        /* @__PURE__ */ jsx(
+          "ul",
+          {
+            className: "mt-2 list-disc space-y-1 pl-5 text-xs",
+            "data-ai-mutation-failed-records": true,
+            children: failedRecords.map((record) => /* @__PURE__ */ jsxs("li", { "data-ai-mutation-failed-record": record.recordId, children: [
+              /* @__PURE__ */ jsx("span", { className: "font-mono", children: record.recordId }),
+              /* @__PURE__ */ jsx("span", { className: "mx-1 text-muted-foreground", children: "\u2022" }),
+              /* @__PURE__ */ jsx("span", { className: "font-mono", children: record.error.code }),
+              /* @__PURE__ */ jsx("span", { className: "mx-1 text-muted-foreground", children: "\u2014" }),
+              /* @__PURE__ */ jsx("span", { children: record.error.message })
+            ] }, record.recordId))
+          }
+        )
+      ] })
+    ] });
+  }
+  if (isSuccessStatus(status)) {
+    const recordId = result?.recordId ?? action.targetRecordId ?? null;
+    const href = payload.recordHref ?? null;
+    return /* @__PURE__ */ jsxs(Alert, { variant: "success", "data-ai-mutation-result": "success", children: [
+      /* @__PURE__ */ jsx(CheckCircle2, { className: "size-4", "aria-hidden": true }),
+      /* @__PURE__ */ jsx(AlertTitle, { children: t("ai_assistant.chat.mutation_cards.result.successTitle", "Action applied") }),
+      /* @__PURE__ */ jsxs("div", { className: "text-sm leading-relaxed", children: [
+        /* @__PURE__ */ jsx("p", { children: result?.commandName ? t(
+          "ai_assistant.chat.mutation_cards.result.successWithCommand",
+          "Completed"
+        ) + `: ${result.commandName}` : t(
+          "ai_assistant.chat.mutation_cards.result.successBody",
+          "The mutation completed successfully."
+        ) }),
+        recordId ? /* @__PURE__ */ jsx("p", { className: "mt-1 text-xs", children: href ? /* @__PURE__ */ jsxs(
+          "a",
+          {
+            className: "font-mono text-primary underline",
+            href,
+            "data-ai-mutation-result-link": true,
+            children: [
+              t(
+                "ai_assistant.chat.mutation_cards.result.viewRecord",
+                "View record"
+              ),
+              ": ",
+              recordId
+            ]
+          }
+        ) : /* @__PURE__ */ jsx("span", { className: "font-mono", "data-ai-mutation-result-record-id": true, children: recordId }) }) : null
+      ] })
+    ] });
+  }
+  if (isFailureStatus(status) || result?.error) {
+    const code = result?.error?.code ?? status ?? "failed";
+    const message = result?.error?.message ?? t(
+      "ai_assistant.chat.mutation_cards.result.failureBody",
+      "The mutation could not be applied."
+    );
+    const errorObj = result?.error;
+    const errorDetails = errorObj?.details;
+    const errorInput = errorObj?.input;
+    const errorName = errorObj?.name;
+    const onFixWithAi = () => {
+      const promptLines = [
+        `The previous call to tool "${action.toolName}" failed.`,
+        `Error: ${code} \u2014 ${message}.`
+      ];
+      if (errorName && errorName !== "Error") {
+        promptLines.push(`Error class: ${errorName}.`);
+      }
+      if (action.targetEntityType || action.targetRecordId) {
+        promptLines.push(
+          `Target: ${action.targetEntityType ?? "?"}${action.targetRecordId ? " / " + action.targetRecordId : ""}.`
+        );
+      }
+      const issues = errorDetails?.issues ?? [];
+      if (Array.isArray(issues) && issues.length > 0) {
+        promptLines.push("", "Validation issues:");
+        for (const issue of issues) {
+          const path = Array.isArray(issue?.path) && issue.path.length > 0 ? issue.path.join(".") : "(root)";
+          const msg = issue?.message ?? "(no message)";
+          const codeHint = issue?.code ? ` [${issue.code}]` : "";
+          const expHint = issue?.expected || issue?.received ? ` (expected ${issue?.expected ?? "?"}, got ${issue?.received ?? "?"})` : "";
+          promptLines.push(`- ${path}: ${msg}${codeHint}${expHint}`);
+        }
+      } else if (errorDetails?.fieldErrors && typeof errorDetails.fieldErrors === "object") {
+        const entries = Object.entries(errorDetails.fieldErrors);
+        if (entries.length > 0) {
+          promptLines.push("", "Field errors:");
+          for (const [path, msgs] of entries) {
+            const list = Array.isArray(msgs) ? msgs.join("; ") : String(msgs);
+            promptLines.push(`- ${path}: ${list}`);
+          }
+        }
+      }
+      if (errorInput !== void 0) {
+        try {
+          const json = JSON.stringify(errorInput, null, 2);
+          if (json && json !== "{}" && json.length <= 4e3) {
+            promptLines.push("", "Arguments you sent:", "```json", json, "```");
+          } else if (json && json.length > 4e3) {
+            promptLines.push(
+              "",
+              "Arguments you sent (truncated):",
+              "```json",
+              json.slice(0, 4e3) + "\n\u2026 [truncated]",
+              "```"
+            );
+          }
+        } catch {
+        }
+      }
+      if (errorDetails?.cause !== void 0) {
+        try {
+          const causeJson = JSON.stringify(errorDetails.cause, null, 2);
+          if (causeJson && causeJson !== "{}" && causeJson.length <= 1500) {
+            promptLines.push("", "Underlying cause:", "```json", causeJson, "```");
+          }
+        } catch {
+        }
+      }
+      if (failedRecords && failedRecords.length > 0) {
+        promptLines.push("", "Records that failed:");
+        for (const rec of failedRecords) {
+          promptLines.push(
+            `- ${rec.recordId} \u2192 ${rec.error.code}: ${rec.error.message}`
+          );
+        }
+      }
+      promptLines.push(
+        "",
+        "Diagnose what went wrong using the validation issues / cause / arguments above, correct the arguments, and call the tool again. If the failure indicates missing prerequisites (e.g. a deal needs a linked person/company before commenting), tell me what to fix on the platform side instead of retrying blindly. Do not repeat the exact same arguments \u2014 you must change at least one parameter or stop and explain."
+      );
+      dispatchFixRequest({
+        message: promptLines.join("\n"),
+        toolName: action.toolName,
+        pendingActionId: action.id
+      });
+    };
+    const visibleIssues = Array.isArray(errorDetails?.issues) ? errorDetails.issues.filter((entry) => entry && (entry.message || entry.path)) : [];
+    return /* @__PURE__ */ jsxs(Alert, { variant: "destructive", "data-ai-mutation-result": "failure", children: [
+      /* @__PURE__ */ jsx(XCircle, { className: "size-4", "aria-hidden": true }),
+      /* @__PURE__ */ jsx(AlertTitle, { children: t(
+        "ai_assistant.chat.mutation_cards.result.failureTitle",
+        "Action failed"
+      ) }),
+      /* @__PURE__ */ jsxs("div", { className: "text-sm leading-relaxed", children: [
+        /* @__PURE__ */ jsxs("div", { children: [
+          /* @__PURE__ */ jsx("span", { className: "mr-2 font-mono text-xs", "data-ai-mutation-result-code": true, children: code }),
+          /* @__PURE__ */ jsx("span", { children: message })
+        ] }),
+        visibleIssues.length > 0 ? /* @__PURE__ */ jsx(
+          "ul",
+          {
+            className: "mt-2 list-disc space-y-0.5 pl-5 text-xs",
+            "data-ai-mutation-result-issues": true,
+            children: visibleIssues.map((issue, index) => {
+              const path = Array.isArray(issue?.path) && issue.path.length > 0 ? issue.path.join(".") : null;
+              return /* @__PURE__ */ jsxs("li", { children: [
+                path ? /* @__PURE__ */ jsx("span", { className: "font-mono", children: path }) : null,
+                path && issue?.message ? /* @__PURE__ */ jsx("span", { className: "mx-1", children: "\u2014" }) : null,
+                issue?.message ? /* @__PURE__ */ jsx("span", { children: issue.message }) : null
+              ] }, index);
+            })
+          }
+        ) : null,
+        /* @__PURE__ */ jsx("div", { className: "mt-2 flex items-center gap-2", children: /* @__PURE__ */ jsxs(
+          Button,
+          {
+            type: "button",
+            variant: "outline",
+            size: "sm",
+            onClick: onFixWithAi,
+            "data-ai-mutation-result-fix": true,
+            children: [
+              /* @__PURE__ */ jsx(Wand2, { className: "size-4", "aria-hidden": true }),
+              /* @__PURE__ */ jsx("span", { children: t(
+                "ai_assistant.chat.mutation_cards.result.fixWithAi",
+                "Fix with AI"
+              ) })
+            ]
+          }
+        ) })
+      ] })
+    ] });
+  }
+  return null;
+}
+var MutationResultCard_default = MutationResultCard;
+export {
+  AI_CHAT_FIX_REQUEST_EVENT,
+  MutationResultCard,
+  MutationResultCard_default as default
+};
+//# sourceMappingURL=MutationResultCard.js.map

package/dist/ai/parts/MutationResultCard.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/ai/parts/MutationResultCard.tsx"],
+  "sourcesContent": ["\"use client\"\n\nimport * as React from 'react'\nimport { AlertTriangle, CheckCircle2, Wand2, XCircle } from 'lucide-react'\nimport { useT } from '@open-mercato/shared/lib/i18n/context'\nimport { Alert, AlertDescription, AlertTitle } from '../../primitives/alert'\nimport { Button } from '../../primitives/button'\nimport type { AiUiPartProps } from '../ui-part-registry'\nimport { useAiPendingActionPolling } from './useAiPendingActionPolling'\nimport type { AiPendingActionCardAction, AiPendingActionCardStatus } from './types'\n\n/** Custom DOM event the failure card dispatches when the operator clicks\n * \"Fix with AI\". `<AiChat>` listens for this and sends a follow-up user\n * message asking the agent to diagnose and retry the failed call. */\nexport const AI_CHAT_FIX_REQUEST_EVENT = 'om-ai-chat-fix-request'\n\nexport interface AiChatFixRequestDetail {\n  message: string\n  toolName?: string\n  pendingActionId?: string\n}\n\nfunction dispatchFixRequest(detail: AiChatFixRequestDetail): void {\n  if (typeof window === 'undefined') return\n  window.dispatchEvent(new CustomEvent<AiChatFixRequestDetail>(AI_CHAT_FIX_REQUEST_EVENT, { detail }))\n}\n\n/**\n * Terminal-state card that renders the `executionResult` of a pending\n * action. Success \u2192 `Alert variant=\"success\"` with a record link; partial\n * success (batch `failedRecords[]`) \u2192 `variant=\"warning\"` with the list;\n * failure \u2192 `variant=\"destructive\"` with the error code + message.\n *\n * Reads the pending action via the shared polling hook so page reloads\n * still recover state. The hook short-circuits once the row is terminal\n * (spec's reconnect behavior), which is always the case for this card.\n */\nexport interface MutationResultCardPayload {\n  /** Server-serialized pending action snapshot (optional \u2014 the hook refetches). */\n  pendingAction?: AiPendingActionCardAction\n  /** Optional link target for the success record. */\n  recordHref?: string\n}\n\nexport interface MutationResultCardProps extends AiUiPartProps {\n  /** Optional injected action for tests \u2014 bypasses the polling fetch. */\n  initialAction?: AiPendingActionCardAction\n  /** Poll endpoint override for tests. */\n  endpoint?: string\n}\n\nfunction isSuccessStatus(status: AiPendingActionCardStatus | null): boolean {\n  return status === 'confirmed'\n}\n\nfunction isFailureStatus(status: AiPendingActionCardStatus | null): boolean {\n  return status === 'failed' || status === 'cancelled' || status === 'expired'\n}\n\nexport function MutationResultCard(props: MutationResultCardProps) {\n  const t = useT()\n  const pendingActionId = props.pendingActionId ?? ''\n  const payload = (props.payload as MutationResultCardPayload | undefined) ?? {}\n  const injected = props.initialAction ?? payload.pendingAction ?? null\n\n  const { action: polled } = useAiPendingActionPolling({\n    pendingActionId,\n    endpoint: props.endpoint,\n    disabled: !pendingActionId || Boolean(injected),\n  })\n  const action = injected ?? polled\n  const status = action?.status ?? null\n  const failedRecords = action?.failedRecords ?? null\n  const result = action?.executionResult ?? null\n\n  if (!action) {\n    return null\n  }\n\n  if (isSuccessStatus(status) && failedRecords && failedRecords.length > 0) {\n    return (\n      <Alert variant=\"warning\" data-ai-mutation-result=\"partial\">\n        <AlertTriangle className=\"size-4\" aria-hidden />\n        <AlertTitle>\n          {t(\n            'ai_assistant.chat.mutation_cards.result.partialTitle',\n            'Action applied with failures',\n          )}\n        </AlertTitle>\n        <div className=\"text-sm leading-relaxed\">\n          <p>\n            {t(\n              'ai_assistant.chat.mutation_cards.result.partialBody',\n              'Some records could not be updated.',\n            )}\n          </p>\n          <ul\n            className=\"mt-2 list-disc space-y-1 pl-5 text-xs\"\n            data-ai-mutation-failed-records\n          >\n            {failedRecords.map((record) => (\n              <li key={record.recordId} data-ai-mutation-failed-record={record.recordId}>\n                <span className=\"font-mono\">{record.recordId}</span>\n                <span className=\"mx-1 text-muted-foreground\">\u2022</span>\n                <span className=\"font-mono\">{record.error.code}</span>\n                <span className=\"mx-1 text-muted-foreground\">\u2014</span>\n                <span>{record.error.message}</span>\n              </li>\n            ))}\n          </ul>\n        </div>\n      </Alert>\n    )\n  }\n\n  if (isSuccessStatus(status)) {\n    const recordId = result?.recordId ?? action.targetRecordId ?? null\n    const href = payload.recordHref ?? null\n    return (\n      <Alert variant=\"success\" data-ai-mutation-result=\"success\">\n        <CheckCircle2 className=\"size-4\" aria-hidden />\n        <AlertTitle>\n          {t('ai_assistant.chat.mutation_cards.result.successTitle', 'Action applied')}\n        </AlertTitle>\n        <div className=\"text-sm leading-relaxed\">\n          <p>\n            {result?.commandName\n              ? t(\n                  'ai_assistant.chat.mutation_cards.result.successWithCommand',\n                  'Completed',\n                ) + `: ${result.commandName}`\n              : t(\n                  'ai_assistant.chat.mutation_cards.result.successBody',\n                  'The mutation completed successfully.',\n                )}\n          </p>\n          {recordId ? (\n            <p className=\"mt-1 text-xs\">\n              {href ? (\n                <a\n                  className=\"font-mono text-primary underline\"\n                  href={href}\n                  data-ai-mutation-result-link\n                >\n                  {t(\n                    'ai_assistant.chat.mutation_cards.result.viewRecord',\n                    'View record',\n                  )}\n                  : {recordId}\n                </a>\n              ) : (\n                <span className=\"font-mono\" data-ai-mutation-result-record-id>\n                  {recordId}\n                </span>\n              )}\n            </p>\n          ) : null}\n        </div>\n      </Alert>\n    )\n  }\n\n  // Render the failure alert when the action is in a failure status OR when\n  // the dispatcher already captured an `executionResult.error` (the row may\n  // not yet have transitioned out of `executing` in the polling snapshot,\n  // but the handler error is authoritative \u2014 surface it immediately so the\n  // operator never sees a stuck \"applying\u2026\" state silently masking a real\n  // failure).\n  if (isFailureStatus(status) || result?.error) {\n    const code = result?.error?.code ?? status ?? 'failed'\n    const message =\n      result?.error?.message ??\n      t(\n        'ai_assistant.chat.mutation_cards.result.failureBody',\n        'The mutation could not be applied.',\n      )\n    const errorObj = result?.error\n    const errorDetails = errorObj?.details\n    const errorInput = errorObj?.input\n    const errorName = errorObj?.name\n    const onFixWithAi = () => {\n      // Build a structured prompt that gives the agent enough context to\n      // diagnose and retry without copy/paste from the operator. Keeping\n      // it explicit (\"retry with corrected arguments\") nudges the model\n      // away from re-issuing the same args (which would just hit the\n      // same error). The repository's idempotency check only dedupes\n      // active `pending` rows, so a fresh prepareMutation call after a\n      // terminal failure always produces a new pending action \u2014 the\n      // retry is never silently collapsed.\n      //\n      // The prompt now embeds the full structured failure context the\n      // server captured (Zod issues / fieldErrors, original arguments,\n      // failedRecords for batch tools, error name + cause). Without this\n      // the operator routinely saw \"Invalid input\" with no field path \u2014\n      // the model literally could not fix what it could not see.\n      const promptLines: string[] = [\n        `The previous call to tool \"${action.toolName}\" failed.`,\n        `Error: ${code} \u2014 ${message}.`,\n      ]\n      if (errorName && errorName !== 'Error') {\n        promptLines.push(`Error class: ${errorName}.`)\n      }\n      if (action.targetEntityType || action.targetRecordId) {\n        promptLines.push(\n          `Target: ${action.targetEntityType ?? '?'}${action.targetRecordId ? ' / ' + action.targetRecordId : ''}.`,\n        )\n      }\n\n      // Field-level validation issues (Zod, custom). Render as a bulleted\n      // list of `path: message` so the model can locate the offender by\n      // schema path instead of guessing from a generic message.\n      const issues = errorDetails?.issues ?? []\n      if (Array.isArray(issues) && issues.length > 0) {\n        promptLines.push('', 'Validation issues:')\n        for (const issue of issues) {\n          const path = Array.isArray(issue?.path) && issue.path.length > 0\n            ? issue.path.join('.')\n            : '(root)'\n          const msg = issue?.message ?? '(no message)'\n          const codeHint = issue?.code ? ` [${issue.code}]` : ''\n          const expHint =\n            issue?.expected || issue?.received\n              ? ` (expected ${issue?.expected ?? '?'}, got ${issue?.received ?? '?'})`\n              : ''\n          promptLines.push(`- ${path}: ${msg}${codeHint}${expHint}`)\n        }\n      } else if (errorDetails?.fieldErrors && typeof errorDetails.fieldErrors === 'object') {\n        const entries = Object.entries(errorDetails.fieldErrors)\n        if (entries.length > 0) {\n          promptLines.push('', 'Field errors:')\n          for (const [path, msgs] of entries) {\n            const list = Array.isArray(msgs) ? msgs.join('; ') : String(msgs)\n            promptLines.push(`- ${path}: ${list}`)\n          }\n        }\n      }\n\n      // Echo the arguments the handler was invoked with so the model can\n      // see exactly what it sent and change at least one parameter on\n      // retry. JSON-stringified inline for compactness; non-serializable\n      // values are dropped on the server side already.\n      if (errorInput !== undefined) {\n        try {\n          const json = JSON.stringify(errorInput, null, 2)\n          if (json && json !== '{}' && json.length <= 4000) {\n            promptLines.push('', 'Arguments you sent:', '```json', json, '```')\n          } else if (json && json.length > 4000) {\n            promptLines.push(\n              '',\n              'Arguments you sent (truncated):',\n              '```json',\n              json.slice(0, 4000) + '\\n\u2026 [truncated]',\n              '```',\n            )\n          }\n        } catch {\n          // ignore\n        }\n      }\n\n      // Surface root-cause when the handler nested another error inside.\n      if (errorDetails?.cause !== undefined) {\n        try {\n          const causeJson = JSON.stringify(errorDetails.cause, null, 2)\n          if (causeJson && causeJson !== '{}' && causeJson.length <= 1500) {\n            promptLines.push('', 'Underlying cause:', '```json', causeJson, '```')\n          }\n        } catch {\n          // ignore\n        }\n      }\n\n      // Per-record failures from batch tools (Step 5.14). These usually\n      // carry the most actionable information for partial-success cases.\n      if (failedRecords && failedRecords.length > 0) {\n        promptLines.push('', 'Records that failed:')\n        for (const rec of failedRecords) {\n          promptLines.push(\n            `- ${rec.recordId} \u2192 ${rec.error.code}: ${rec.error.message}`,\n          )\n        }\n      }\n\n      promptLines.push(\n        '',\n        'Diagnose what went wrong using the validation issues / cause / arguments above, correct the arguments, and call the tool again. If the failure indicates missing prerequisites (e.g. a deal needs a linked person/company before commenting), tell me what to fix on the platform side instead of retrying blindly. Do not repeat the exact same arguments \u2014 you must change at least one parameter or stop and explain.',\n      )\n      dispatchFixRequest({\n        message: promptLines.join('\\n'),\n        toolName: action.toolName,\n        pendingActionId: action.id,\n      })\n    }\n    const visibleIssues = Array.isArray(errorDetails?.issues)\n      ? errorDetails!.issues!.filter((entry) => entry && (entry.message || entry.path))\n      : []\n    return (\n      <Alert variant=\"destructive\" data-ai-mutation-result=\"failure\">\n        <XCircle className=\"size-4\" aria-hidden />\n        <AlertTitle>\n          {t(\n            'ai_assistant.chat.mutation_cards.result.failureTitle',\n            'Action failed',\n          )}\n        </AlertTitle>\n        <div className=\"text-sm leading-relaxed\">\n          <div>\n            <span className=\"mr-2 font-mono text-xs\" data-ai-mutation-result-code>\n              {code}\n            </span>\n            <span>{message}</span>\n          </div>\n          {visibleIssues.length > 0 ? (\n            <ul\n              className=\"mt-2 list-disc space-y-0.5 pl-5 text-xs\"\n              data-ai-mutation-result-issues\n            >\n              {visibleIssues.map((issue, index) => {\n                const path =\n                  Array.isArray(issue?.path) && issue.path.length > 0\n                    ? issue.path.join('.')\n                    : null\n                return (\n                  <li key={index}>\n                    {path ? (\n                      <span className=\"font-mono\">{path}</span>\n                    ) : null}\n                    {path && issue?.message ? <span className=\"mx-1\">\u2014</span> : null}\n                    {issue?.message ? <span>{issue.message}</span> : null}\n                  </li>\n                )\n              })}\n            </ul>\n          ) : null}\n          <div className=\"mt-2 flex items-center gap-2\">\n            <Button\n              type=\"button\"\n              variant=\"outline\"\n              size=\"sm\"\n              onClick={onFixWithAi}\n              data-ai-mutation-result-fix\n            >\n              <Wand2 className=\"size-4\" aria-hidden />\n              <span>\n                {t(\n                  'ai_assistant.chat.mutation_cards.result.fixWithAi',\n                  'Fix with AI',\n                )}\n              </span>\n            </Button>\n          </div>\n        </div>\n      </Alert>\n    )\n  }\n\n  return null\n}\n\nexport default MutationResultCard\n"],
+  "mappings": ";AAkFQ,cAmBM,YAnBN;AA/ER,SAAS,eAAe,cAAc,OAAO,eAAe;AAC5D,SAAS,YAAY;AACrB,SAAS,OAAyB,kBAAkB;AACpD,SAAS,cAAc;AAEvB,SAAS,iCAAiC;AAMnC,MAAM,4BAA4B;AAQzC,SAAS,mBAAmB,QAAsC;AAChE,MAAI,OAAO,WAAW,YAAa;AACnC,SAAO,cAAc,IAAI,YAAoC,2BAA2B,EAAE,OAAO,CAAC,CAAC;AACrG;AA0BA,SAAS,gBAAgB,QAAmD;AAC1E,SAAO,WAAW;AACpB;AAEA,SAAS,gBAAgB,QAAmD;AAC1E,SAAO,WAAW,YAAY,WAAW,eAAe,WAAW;AACrE;AAEO,SAAS,mBAAmB,OAAgC;AACjE,QAAM,IAAI,KAAK;AACf,QAAM,kBAAkB,MAAM,mBAAmB;AACjD,QAAM,UAAW,MAAM,WAAqD,CAAC;AAC7E,QAAM,WAAW,MAAM,iBAAiB,QAAQ,iBAAiB;AAEjE,QAAM,EAAE,QAAQ,OAAO,IAAI,0BAA0B;AAAA,IACnD;AAAA,IACA,UAAU,MAAM;AAAA,IAChB,UAAU,CAAC,mBAAmB,QAAQ,QAAQ;AAAA,EAChD,CAAC;AACD,QAAM,SAAS,YAAY;AAC3B,QAAM,SAAS,QAAQ,UAAU;AACjC,QAAM,gBAAgB,QAAQ,iBAAiB;AAC/C,QAAM,SAAS,QAAQ,mBAAmB;AAE1C,MAAI,CAAC,QAAQ;AACX,WAAO;AAAA,EACT;AAEA,MAAI,gBAAgB,MAAM,KAAK,iBAAiB,cAAc,SAAS,GAAG;AACxE,WACE,qBAAC,SAAM,SAAQ,WAAU,2BAAwB,WAC/C;AAAA,0BAAC,iBAAc,WAAU,UAAS,eAAW,MAAC;AAAA,MAC9C,oBAAC,cACE;AAAA,QACC;AAAA,QACA;AAAA,MACF,GACF;AAAA,MACA,qBAAC,SAAI,WAAU,2BACb;AAAA,4BAAC,OACE;AAAA,UACC;AAAA,UACA;AAAA,QACF,GACF;AAAA,QACA;AAAA,UAAC;AAAA;AAAA,YACC,WAAU;AAAA,YACV,mCAA+B;AAAA,YAE9B,wBAAc,IAAI,CAAC,WAClB,qBAAC,QAAyB,kCAAgC,OAAO,UAC/D;AAAA,kCAAC,UAAK,WAAU,aAAa,iBAAO,UAAS;AAAA,cAC7C,oBAAC,UAAK,WAAU,8BAA6B,oBAAC;AAAA,cAC9C,oBAAC,UAAK,WAAU,aAAa,iBAAO,MAAM,MAAK;AAAA,cAC/C,oBAAC,UAAK,WAAU,8BAA6B,oBAAC;AAAA,cAC9C,oBAAC,UAAM,iBAAO,MAAM,SAAQ;AAAA,iBALrB,OAAO,QAMhB,CACD;AAAA;AAAA,QACH;AAAA,SACF;AAAA,OACF;AAAA,EAEJ;AAEA,MAAI,gBAAgB,MAAM,GAAG;AAC3B,UAAM,WAAW,QAAQ,YAAY,OAAO,kBAAkB;AAC9D,UAAM,OAAO,QAAQ,cAAc;AACnC,WACE,qBAAC,SAAM,SAAQ,WAAU,2BAAwB,WAC/C;AAAA,0BAAC,gBAAa,WAAU,UAAS,eAAW,MAAC;AAAA,MAC7C,oBAAC,cACE,YAAE,wDAAwD,gBAAgB,GAC7E;AAAA,MACA,qBAAC,SAAI,WAAU,2BACb;AAAA,4BAAC,OACE,kBAAQ,cACL;AAAA,UACE;AAAA,UACA;AAAA,QACF,IAAI,KAAK,OAAO,WAAW,KAC3B;AAAA,UACE;AAAA,UACA;AAAA,QACF,GACN;AAAA,QACC,WACC,oBAAC,OAAE,WAAU,gBACV,iBACC;AAAA,UAAC;AAAA;AAAA,YACC,WAAU;AAAA,YACV;AAAA,YACA,gCAA4B;AAAA,YAE3B;AAAA;AAAA,gBACC;AAAA,gBACA;AAAA,cACF;AAAA,cAAE;AAAA,cACC;AAAA;AAAA;AAAA,QACL,IAEA,oBAAC,UAAK,WAAU,aAAY,qCAAiC,MAC1D,oBACH,GAEJ,IACE;AAAA,SACN;AAAA,OACF;AAAA,EAEJ;AAQA,MAAI,gBAAgB,MAAM,KAAK,QAAQ,OAAO;AAC5C,UAAM,OAAO,QAAQ,OAAO,QAAQ,UAAU;AAC9C,UAAM,UACJ,QAAQ,OAAO,WACf;AAAA,MACE;AAAA,MACA;AAAA,IACF;AACF,UAAM,WAAW,QAAQ;AACzB,UAAM,eAAe,UAAU;AAC/B,UAAM,aAAa,UAAU;AAC7B,UAAM,YAAY,UAAU;AAC5B,UAAM,cAAc,MAAM;AAexB,YAAM,cAAwB;AAAA,QAC5B,8BAA8B,OAAO,QAAQ;AAAA,QAC7C,UAAU,IAAI,WAAM,OAAO;AAAA,MAC7B;AACA,UAAI,aAAa,cAAc,SAAS;AACtC,oBAAY,KAAK,gBAAgB,SAAS,GAAG;AAAA,MAC/C;AACA,UAAI,OAAO,oBAAoB,OAAO,gBAAgB;AACpD,oBAAY;AAAA,UACV,WAAW,OAAO,oBAAoB,GAAG,GAAG,OAAO,iBAAiB,QAAQ,OAAO,iBAAiB,EAAE;AAAA,QACxG;AAAA,MACF;AAKA,YAAM,SAAS,cAAc,UAAU,CAAC;AACxC,UAAI,MAAM,QAAQ,MAAM,KAAK,OAAO,SAAS,GAAG;AAC9C,oBAAY,KAAK,IAAI,oBAAoB;AACzC,mBAAW,SAAS,QAAQ;AAC1B,gBAAM,OAAO,MAAM,QAAQ,OAAO,IAAI,KAAK,MAAM,KAAK,SAAS,IAC3D,MAAM,KAAK,KAAK,GAAG,IACnB;AACJ,gBAAM,MAAM,OAAO,WAAW;AAC9B,gBAAM,WAAW,OAAO,OAAO,KAAK,MAAM,IAAI,MAAM;AACpD,gBAAM,UACJ,OAAO,YAAY,OAAO,WACtB,cAAc,OAAO,YAAY,GAAG,SAAS,OAAO,YAAY,GAAG,MACnE;AACN,sBAAY,KAAK,KAAK,IAAI,KAAK,GAAG,GAAG,QAAQ,GAAG,OAAO,EAAE;AAAA,QAC3D;AAAA,MACF,WAAW,cAAc,eAAe,OAAO,aAAa,gBAAgB,UAAU;AACpF,cAAM,UAAU,OAAO,QAAQ,aAAa,WAAW;AACvD,YAAI,QAAQ,SAAS,GAAG;AACtB,sBAAY,KAAK,IAAI,eAAe;AACpC,qBAAW,CAAC,MAAM,IAAI,KAAK,SAAS;AAClC,kBAAM,OAAO,MAAM,QAAQ,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI;AAChE,wBAAY,KAAK,KAAK,IAAI,KAAK,IAAI,EAAE;AAAA,UACvC;AAAA,QACF;AAAA,MACF;AAMA,UAAI,eAAe,QAAW;AAC5B,YAAI;AACF,gBAAM,OAAO,KAAK,UAAU,YAAY,MAAM,CAAC;AAC/C,cAAI,QAAQ,SAAS,QAAQ,KAAK,UAAU,KAAM;AAChD,wBAAY,KAAK,IAAI,uBAAuB,WAAW,MAAM,KAAK;AAAA,UACpE,WAAW,QAAQ,KAAK,SAAS,KAAM;AACrC,wBAAY;AAAA,cACV;AAAA,cACA;AAAA,cACA;AAAA,cACA,KAAK,MAAM,GAAG,GAAI,IAAI;AAAA,cACtB;AAAA,YACF;AAAA,UACF;AAAA,QACF,QAAQ;AAAA,QAER;AAAA,MACF;AAGA,UAAI,cAAc,UAAU,QAAW;AACrC,YAAI;AACF,gBAAM,YAAY,KAAK,UAAU,aAAa,OAAO,MAAM,CAAC;AAC5D,cAAI,aAAa,cAAc,QAAQ,UAAU,UAAU,MAAM;AAC/D,wBAAY,KAAK,IAAI,qBAAqB,WAAW,WAAW,KAAK;AAAA,UACvE;AAAA,QACF,QAAQ;AAAA,QAER;AAAA,MACF;AAIA,UAAI,iBAAiB,cAAc,SAAS,GAAG;AAC7C,oBAAY,KAAK,IAAI,sBAAsB;AAC3C,mBAAW,OAAO,eAAe;AAC/B,sBAAY;AAAA,YACV,KAAK,IAAI,QAAQ,WAAM,IAAI,MAAM,IAAI,KAAK,IAAI,MAAM,OAAO;AAAA,UAC7D;AAAA,QACF;AAAA,MACF;AAEA,kBAAY;AAAA,QACV;AAAA,QACA;AAAA,MACF;AACA,yBAAmB;AAAA,QACjB,SAAS,YAAY,KAAK,IAAI;AAAA,QAC9B,UAAU,OAAO;AAAA,QACjB,iBAAiB,OAAO;AAAA,MAC1B,CAAC;AAAA,IACH;AACA,UAAM,gBAAgB,MAAM,QAAQ,cAAc,MAAM,IACpD,aAAc,OAAQ,OAAO,CAAC,UAAU,UAAU,MAAM,WAAW,MAAM,KAAK,IAC9E,CAAC;AACL,WACE,qBAAC,SAAM,SAAQ,eAAc,2BAAwB,WACnD;AAAA,0BAAC,WAAQ,WAAU,UAAS,eAAW,MAAC;AAAA,MACxC,oBAAC,cACE;AAAA,QACC;AAAA,QACA;AAAA,MACF,GACF;AAAA,MACA,qBAAC,SAAI,WAAU,2BACb;AAAA,6BAAC,SACC;AAAA,8BAAC,UAAK,WAAU,0BAAyB,gCAA4B,MAClE,gBACH;AAAA,UACA,oBAAC,UAAM,mBAAQ;AAAA,WACjB;AAAA,QACC,cAAc,SAAS,IACtB;AAAA,UAAC;AAAA;AAAA,YACC,WAAU;AAAA,YACV,kCAA8B;AAAA,YAE7B,wBAAc,IAAI,CAAC,OAAO,UAAU;AACnC,oBAAM,OACJ,MAAM,QAAQ,OAAO,IAAI,KAAK,MAAM,KAAK,SAAS,IAC9C,MAAM,KAAK,KAAK,GAAG,IACnB;AACN,qBACE,qBAAC,QACE;AAAA,uBACC,oBAAC,UAAK,WAAU,aAAa,gBAAK,IAChC;AAAA,gBACH,QAAQ,OAAO,UAAU,oBAAC,UAAK,WAAU,QAAO,oBAAC,IAAU;AAAA,gBAC3D,OAAO,UAAU,oBAAC,UAAM,gBAAM,SAAQ,IAAU;AAAA,mBAL1C,KAMT;AAAA,YAEJ,CAAC;AAAA;AAAA,QACH,IACE;AAAA,QACJ,oBAAC,SAAI,WAAU,gCACb;AAAA,UAAC;AAAA;AAAA,YACC,MAAK;AAAA,YACL,SAAQ;AAAA,YACR,MAAK;AAAA,YACL,SAAS;AAAA,YACT,+BAA2B;AAAA,YAE3B;AAAA,kCAAC,SAAM,WAAU,UAAS,eAAW,MAAC;AAAA,cACtC,oBAAC,UACE;AAAA,gBACC;AAAA,gBACA;AAAA,cACF,GACF;AAAA;AAAA;AAAA,QACF,GACF;AAAA,SACF;AAAA,OACF;AAAA,EAEJ;AAEA,SAAO;AACT;AAEA,IAAO,6BAAQ;",
+  "names": []
+}

package/dist/ai/parts/approval-cards-map.js

@@ -0,0 +1,15 @@
+"use client";
+import { MutationPreviewCard } from "./MutationPreviewCard.js";
+import { FieldDiffCard } from "./FieldDiffCard.js";
+import { ConfirmationCard } from "./ConfirmationCard.js";
+import { MutationResultCard } from "./MutationResultCard.js";
+const AI_MUTATION_APPROVAL_CARDS = Object.freeze({
+  "mutation-preview-card": MutationPreviewCard,
+  "field-diff-card": FieldDiffCard,
+  "confirmation-card": ConfirmationCard,
+  "mutation-result-card": MutationResultCard
+});
+export {
+  AI_MUTATION_APPROVAL_CARDS
+};
+//# sourceMappingURL=approval-cards-map.js.map

package/dist/ai/parts/approval-cards-map.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/ai/parts/approval-cards-map.ts"],
+  "sourcesContent": ["\"use client\"\n\nimport type { AiUiPartComponent, AiUiPartProps } from '../ui-part-registry'\nimport { MutationPreviewCard } from './MutationPreviewCard'\nimport { FieldDiffCard } from './FieldDiffCard'\nimport { ConfirmationCard } from './ConfirmationCard'\nimport { MutationResultCard } from './MutationResultCard'\n\n/**\n * Canonical map of the four Phase 3 mutation-approval cards keyed by their\n * reserved registry component ids. Consumers can spread this into any\n * `AiUiPartRegistry` to wire the live cards at once. Isolated from\n * `parts/index.ts` so the `ui-part-registry` module can import the map\n * without importing the barrel (which would re-export back into the same\n * module and trip Node's \"Cannot access before initialization\" ordering).\n */\nexport const AI_MUTATION_APPROVAL_CARDS: Readonly<\n  Record<string, AiUiPartComponent<AiUiPartProps>>\n> = Object.freeze({\n  'mutation-preview-card': MutationPreviewCard as AiUiPartComponent<AiUiPartProps>,\n  'field-diff-card': FieldDiffCard as unknown as AiUiPartComponent<AiUiPartProps>,\n  'confirmation-card': ConfirmationCard as AiUiPartComponent<AiUiPartProps>,\n  'mutation-result-card': MutationResultCard as AiUiPartComponent<AiUiPartProps>,\n})\n"],
+  "mappings": ";AAGA,SAAS,2BAA2B;AACpC,SAAS,qBAAqB;AAC9B,SAAS,wBAAwB;AACjC,SAAS,0BAA0B;AAU5B,MAAM,6BAET,OAAO,OAAO;AAAA,EAChB,yBAAyB;AAAA,EACzB,mBAAmB;AAAA,EACnB,qBAAqB;AAAA,EACrB,wBAAwB;AAC1B,CAAC;",
+  "names": []
+}

package/dist/ai/parts/index.js

@@ -0,0 +1,24 @@
+"use client";
+import { MutationPreviewCard } from "./MutationPreviewCard.js";
+import { FieldDiffCard } from "./FieldDiffCard.js";
+import { ConfirmationCard } from "./ConfirmationCard.js";
+import { MutationResultCard } from "./MutationResultCard.js";
+import {
+  useAiPendingActionPolling
+} from "./useAiPendingActionPolling.js";
+import {
+  confirmPendingAction,
+  cancelPendingAction
+} from "./pending-action-api.js";
+import { AI_MUTATION_APPROVAL_CARDS } from "./approval-cards-map.js";
+export {
+  AI_MUTATION_APPROVAL_CARDS,
+  ConfirmationCard,
+  FieldDiffCard,
+  MutationPreviewCard,
+  MutationResultCard,
+  cancelPendingAction,
+  confirmPendingAction,
+  useAiPendingActionPolling
+};
+//# sourceMappingURL=index.js.map

package/dist/ai/parts/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/ai/parts/index.ts"],
+  "sourcesContent": ["\"use client\"\n\nexport { MutationPreviewCard } from './MutationPreviewCard'\nexport { FieldDiffCard } from './FieldDiffCard'\nexport { ConfirmationCard } from './ConfirmationCard'\nexport { MutationResultCard } from './MutationResultCard'\nexport {\n  useAiPendingActionPolling,\n  type UseAiPendingActionPollingOptions,\n  type UseAiPendingActionPollingResult,\n} from './useAiPendingActionPolling'\nexport {\n  confirmPendingAction,\n  cancelPendingAction,\n  type PendingActionMutationOk,\n  type PendingActionMutationError,\n  type PendingActionMutationResult,\n} from './pending-action-api'\nexport type {\n  AiPendingActionCardAction,\n  AiPendingActionCardStatus,\n  AiPendingActionCardFieldDiff,\n  AiPendingActionCardRecordDiff,\n  AiPendingActionCardFailedRecord,\n  AiPendingActionCardExecutionResult,\n} from './types'\nexport { AI_MUTATION_APPROVAL_CARDS } from './approval-cards-map'\n"],
+  "mappings": ";AAEA,SAAS,2BAA2B;AACpC,SAAS,qBAAqB;AAC9B,SAAS,wBAAwB;AACjC,SAAS,0BAA0B;AACnC;AAAA,EACE;AAAA,OAGK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAIK;AASP,SAAS,kCAAkC;",
+  "names": []
+}

package/dist/ai/parts/pending-action-api.js

@@ -0,0 +1,60 @@
+"use client";
+import { apiCall } from "../../backend/utils/apiCall.js";
+const POST_JSON_TIMEOUT_MS = 6e4;
+async function postJson(url, body) {
+  const controller = new AbortController();
+  const timer = typeof window !== "undefined" ? window.setTimeout(() => controller.abort(), POST_JSON_TIMEOUT_MS) : null;
+  try {
+    const call = await apiCall(url, {
+      method: "POST",
+      headers: body ? { "Content-Type": "application/json" } : void 0,
+      body: body ? JSON.stringify(body) : void 0,
+      signal: controller.signal
+    });
+    if (call.ok) {
+      const data = call.result;
+      return { ok: true, data };
+    }
+    const raw = call.result ?? {};
+    const errorMessage = typeof raw.error === "string" && raw.error.length > 0 ? raw.error : `Request failed (${call.status}).`;
+    const code = typeof raw.code === "string" ? raw.code : void 0;
+    const { error: _err, code: _code, ...extra } = raw;
+    return {
+      ok: false,
+      error: {
+        status: call.status,
+        code,
+        message: errorMessage,
+        extra: Object.keys(extra).length > 0 ? extra : void 0
+      }
+    };
+  } catch (err) {
+    const aborted = err?.name === "AbortError" || controller.signal.aborted;
+    return {
+      ok: false,
+      error: {
+        status: aborted ? 408 : 0,
+        code: aborted ? "request_timeout" : "network_error",
+        message: aborted ? `Request timed out after ${Math.round(POST_JSON_TIMEOUT_MS / 1e3)}s.` : err instanceof Error ? err.message : "Network error contacting the AI dispatcher."
+      }
+    };
+  } finally {
+    if (timer !== null) window.clearTimeout(timer);
+  }
+}
+async function confirmPendingAction(pendingActionId, options) {
+  const base = options?.endpoint ?? "/api/ai_assistant/ai/actions";
+  const url = `${base}/${encodeURIComponent(pendingActionId)}/confirm`;
+  return postJson(url);
+}
+async function cancelPendingAction(pendingActionId, options) {
+  const base = options?.endpoint ?? "/api/ai_assistant/ai/actions";
+  const url = `${base}/${encodeURIComponent(pendingActionId)}/cancel`;
+  const body = options?.reason ? { reason: options.reason } : void 0;
+  return postJson(url, body);
+}
+export {
+  cancelPendingAction,
+  confirmPendingAction
+};
+//# sourceMappingURL=pending-action-api.js.map

package/dist/ai/parts/pending-action-api.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/ai/parts/pending-action-api.ts"],
+  "sourcesContent": ["\"use client\"\n\nimport { apiCall } from '../../backend/utils/apiCall'\nimport type { AiPendingActionCardAction } from './types'\n\n/**\n * Thin client wrappers over the pending-action confirm/cancel routes\n * (Steps 5.8 / 5.9). Kept here so the mutation-approval cards (Step 5.10)\n * can thread structured error envelopes \u2014 especially the 412 `stale_version`\n * / 412 `schema_drift` / 409 `invalid_status` shapes \u2014 back into the UI\n * without each card reimplementing the same fetch boilerplate.\n *\n * `apiCall` is used (not `apiCallOrThrow`) because the cards need the\n * non-2xx response body (`{ error, code, failedRecords?, issues? }`) to\n * surface a targeted alert, not a generic thrown error.\n */\n\nexport type PendingActionMutationOk = {\n  ok: boolean\n  pendingAction: AiPendingActionCardAction\n  mutationResult?: AiPendingActionCardAction['executionResult']\n}\n\nexport type PendingActionMutationError = {\n  status: number\n  code?: string\n  message: string\n  extra?: Record<string, unknown>\n}\n\nexport type PendingActionMutationResult =\n  | { ok: true; data: PendingActionMutationOk }\n  | { ok: false; error: PendingActionMutationError }\n\n// Hard ceiling for confirm/cancel calls. The dispatcher's mutation gate runs\n// the wrapped tool handler synchronously inside the POST, so for slow\n// providers (LLM-backed handlers, large bulk batches, external APIs) we still\n// give it ~1 minute. Going longer than this is almost always a server-side\n// hang and the operator should see an error rather than an indefinite\n// \"processing\u2026\" spinner.\nconst POST_JSON_TIMEOUT_MS = 60_000\n\nasync function postJson(\n  url: string,\n  body?: unknown,\n): Promise<PendingActionMutationResult> {\n  const controller = new AbortController()\n  const timer =\n    typeof window !== 'undefined'\n      ? window.setTimeout(() => controller.abort(), POST_JSON_TIMEOUT_MS)\n      : null\n  try {\n    const call = await apiCall<Record<string, unknown>>(url, {\n      method: 'POST',\n      headers: body ? { 'Content-Type': 'application/json' } : undefined,\n      body: body ? JSON.stringify(body) : undefined,\n      signal: controller.signal,\n    } as RequestInit)\n    if (call.ok) {\n      const data = call.result as PendingActionMutationOk\n      return { ok: true, data }\n    }\n    const raw = (call.result ?? {}) as {\n      error?: unknown\n      code?: unknown\n      [key: string]: unknown\n    }\n    const errorMessage =\n      typeof raw.error === 'string' && raw.error.length > 0\n        ? raw.error\n        : `Request failed (${call.status}).`\n    const code = typeof raw.code === 'string' ? raw.code : undefined\n    const { error: _err, code: _code, ...extra } = raw\n    return {\n      ok: false,\n      error: {\n        status: call.status,\n        code,\n        message: errorMessage,\n        extra: Object.keys(extra).length > 0 ? extra : undefined,\n      },\n    }\n  } catch (err) {\n    // Aborted (timeout) or network error. Surface a structured envelope so\n    // the card can render the failure inline instead of stalling.\n    const aborted =\n      (err as { name?: string } | null)?.name === 'AbortError' ||\n      controller.signal.aborted\n    return {\n      ok: false,\n      error: {\n        status: aborted ? 408 : 0,\n        code: aborted ? 'request_timeout' : 'network_error',\n        message: aborted\n          ? `Request timed out after ${Math.round(POST_JSON_TIMEOUT_MS / 1000)}s.`\n          : err instanceof Error\n            ? err.message\n            : 'Network error contacting the AI dispatcher.',\n      },\n    }\n  } finally {\n    if (timer !== null) window.clearTimeout(timer)\n  }\n}\n\nexport async function confirmPendingAction(\n  pendingActionId: string,\n  options?: { endpoint?: string },\n): Promise<PendingActionMutationResult> {\n  const base = options?.endpoint ?? '/api/ai_assistant/ai/actions'\n  const url = `${base}/${encodeURIComponent(pendingActionId)}/confirm`\n  return postJson(url)\n}\n\nexport async function cancelPendingAction(\n  pendingActionId: string,\n  options?: { endpoint?: string; reason?: string },\n): Promise<PendingActionMutationResult> {\n  const base = options?.endpoint ?? '/api/ai_assistant/ai/actions'\n  const url = `${base}/${encodeURIComponent(pendingActionId)}/cancel`\n  const body = options?.reason ? { reason: options.reason } : undefined\n  return postJson(url, body)\n}\n"],
+  "mappings": ";AAEA,SAAS,eAAe;AAsCxB,MAAM,uBAAuB;AAE7B,eAAe,SACb,KACA,MACsC;AACtC,QAAM,aAAa,IAAI,gBAAgB;AACvC,QAAM,QACJ,OAAO,WAAW,cACd,OAAO,WAAW,MAAM,WAAW,MAAM,GAAG,oBAAoB,IAChE;AACN,MAAI;AACF,UAAM,OAAO,MAAM,QAAiC,KAAK;AAAA,MACvD,QAAQ;AAAA,MACR,SAAS,OAAO,EAAE,gBAAgB,mBAAmB,IAAI;AAAA,MACzD,MAAM,OAAO,KAAK,UAAU,IAAI,IAAI;AAAA,MACpC,QAAQ,WAAW;AAAA,IACrB,CAAgB;AAChB,QAAI,KAAK,IAAI;AACX,YAAM,OAAO,KAAK;AAClB,aAAO,EAAE,IAAI,MAAM,KAAK;AAAA,IAC1B;AACA,UAAM,MAAO,KAAK,UAAU,CAAC;AAK7B,UAAM,eACJ,OAAO,IAAI,UAAU,YAAY,IAAI,MAAM,SAAS,IAChD,IAAI,QACJ,mBAAmB,KAAK,MAAM;AACpC,UAAM,OAAO,OAAO,IAAI,SAAS,WAAW,IAAI,OAAO;AACvD,UAAM,EAAE,OAAO,MAAM,MAAM,OAAO,GAAG,MAAM,IAAI;AAC/C,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,OAAO;AAAA,QACL,QAAQ,KAAK;AAAA,QACb;AAAA,QACA,SAAS;AAAA,QACT,OAAO,OAAO,KAAK,KAAK,EAAE,SAAS,IAAI,QAAQ;AAAA,MACjD;AAAA,IACF;AAAA,EACF,SAAS,KAAK;AAGZ,UAAM,UACH,KAAkC,SAAS,gBAC5C,WAAW,OAAO;AACpB,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,OAAO;AAAA,QACL,QAAQ,UAAU,MAAM;AAAA,QACxB,MAAM,UAAU,oBAAoB;AAAA,QACpC,SAAS,UACL,2BAA2B,KAAK,MAAM,uBAAuB,GAAI,CAAC,OAClE,eAAe,QACb,IAAI,UACJ;AAAA,MACR;AAAA,IACF;AAAA,EACF,UAAE;AACA,QAAI,UAAU,KAAM,QAAO,aAAa,KAAK;AAAA,EAC/C;AACF;AAEA,eAAsB,qBACpB,iBACA,SACsC;AACtC,QAAM,OAAO,SAAS,YAAY;AAClC,QAAM,MAAM,GAAG,IAAI,IAAI,mBAAmB,eAAe,CAAC;AAC1D,SAAO,SAAS,GAAG;AACrB;AAEA,eAAsB,oBACpB,iBACA,SACsC;AACtC,QAAM,OAAO,SAAS,YAAY;AAClC,QAAM,MAAM,GAAG,IAAI,IAAI,mBAAmB,eAAe,CAAC;AAC1D,QAAM,OAAO,SAAS,SAAS,EAAE,QAAQ,QAAQ,OAAO,IAAI;AAC5D,SAAO,SAAS,KAAK,IAAI;AAC3B;",
+  "names": []
+}

package/dist/ai/parts/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/ai/parts/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/ai/parts/useAiPendingActionPolling.js

@@ -0,0 +1,126 @@
+"use client";
+import * as React from "react";
+import { apiCallOrThrow } from "../../backend/utils/apiCall.js";
+const TERMINAL_STATUSES = [
+  "confirmed",
+  "cancelled",
+  "failed",
+  "expired"
+];
+function isTerminal(status) {
+  if (!status) return false;
+  return TERMINAL_STATUSES.includes(status);
+}
+async function fetchPendingAction(pendingActionId, endpoint) {
+  const url = `${endpoint}/${encodeURIComponent(pendingActionId)}`;
+  const call = await apiCallOrThrow(url, { method: "GET" });
+  const body = call.result;
+  if (body && typeof body === "object") {
+    if (body.pendingAction) {
+      return { pendingAction: body.pendingAction, error: null };
+    }
+    if (typeof body.id === "string" && typeof body.status === "string") {
+      return { pendingAction: body, error: null };
+    }
+    if (body.error) {
+      return {
+        pendingAction: null,
+        error: { message: body.error, code: body.code }
+      };
+    }
+  }
+  return { pendingAction: null, error: null };
+}
+function useAiPendingActionPolling(options) {
+  const {
+    pendingActionId,
+    intervalMs = 3e3,
+    endpoint = "/api/ai_assistant/ai/actions",
+    disabled = false
+  } = options;
+  const [action, setAction] = React.useState(null);
+  const [error, setError] = React.useState(null);
+  const [isPolling, setIsPolling] = React.useState(!disabled);
+  const mountedRef = React.useRef(true);
+  const timerRef = React.useRef(null);
+  const statusRef = React.useRef(null);
+  const clearTimer = React.useCallback(() => {
+    if (timerRef.current) {
+      clearTimeout(timerRef.current);
+      timerRef.current = null;
+    }
+  }, []);
+  const refresh = React.useCallback(async () => {
+    if (!pendingActionId) return null;
+    try {
+      const result = await fetchPendingAction(pendingActionId, endpoint);
+      if (!mountedRef.current) return result.pendingAction ?? null;
+      if (result.error) {
+        setError(result.error);
+      } else {
+        setError(null);
+      }
+      if (result.pendingAction) {
+        setAction(result.pendingAction);
+        statusRef.current = result.pendingAction.status;
+      }
+      return result.pendingAction;
+    } catch (err) {
+      if (!mountedRef.current) return null;
+      const message = err instanceof Error ? err.message : "Failed to load pending action.";
+      setError({ message });
+      return null;
+    }
+  }, [endpoint, pendingActionId]);
+  const scheduleNext = React.useCallback(() => {
+    clearTimer();
+    if (!mountedRef.current) return;
+    if (disabled) {
+      setIsPolling(false);
+      return;
+    }
+    if (isTerminal(statusRef.current)) {
+      setIsPolling(false);
+      return;
+    }
+    setIsPolling(true);
+    timerRef.current = setTimeout(async () => {
+      await refresh();
+      scheduleNext();
+    }, intervalMs);
+  }, [clearTimer, disabled, intervalMs, refresh]);
+  React.useEffect(() => {
+    mountedRef.current = true;
+    statusRef.current = null;
+    if (disabled) {
+      setIsPolling(false);
+      return () => {
+        mountedRef.current = false;
+        clearTimer();
+      };
+    }
+    setIsPolling(true);
+    void refresh().then(() => {
+      if (!mountedRef.current) return;
+      scheduleNext();
+    });
+    return () => {
+      mountedRef.current = false;
+      clearTimer();
+    };
+  }, [pendingActionId, endpoint, intervalMs, disabled]);
+  const status = action?.status ?? null;
+  return {
+    action,
+    status,
+    isPolling: isPolling && !isTerminal(status),
+    error,
+    refresh
+  };
+}
+var useAiPendingActionPolling_default = useAiPendingActionPolling;
+export {
+  useAiPendingActionPolling_default as default,
+  useAiPendingActionPolling
+};
+//# sourceMappingURL=useAiPendingActionPolling.js.map

package/dist/ai/parts/useAiPendingActionPolling.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/ai/parts/useAiPendingActionPolling.ts"],
+  "sourcesContent": ["\"use client\"\n\nimport * as React from 'react'\nimport { apiCallOrThrow } from '../../backend/utils/apiCall'\nimport type { AiPendingActionCardAction, AiPendingActionCardStatus } from './types'\n\n/**\n * Shared polling hook for the Phase 3 mutation-approval cards (Step 5.10).\n *\n * Responsibilities:\n * - Fetch `GET /api/ai_assistant/ai/actions/:id` on mount, even when the\n *   server previously streamed a preview card. This is the \"reconnect\" path:\n *   after a page reload or navigation away+back, the card recovers the\n *   current pending-action state instead of staying blank.\n * - Poll every 3 seconds while the status is non-terminal\n *   (`pending` / `executing`). Terminal states (`confirmed`, `cancelled`,\n *   `failed`, `expired`) stop polling.\n * - Expose a `refresh()` force-fetch helper the confirmation card uses after\n *   a confirm POST races with the polling loop.\n *\n * The hook owns a single `setInterval`/`setTimeout` \u2014 unmounting clears\n * every outstanding timer. This is required for the Jest fake-timers\n * \"mount, unmount mid-poll\" test contract.\n */\n\nconst TERMINAL_STATUSES: ReadonlyArray<AiPendingActionCardStatus> = [\n  'confirmed',\n  'cancelled',\n  'failed',\n  'expired',\n]\n\nfunction isTerminal(status: AiPendingActionCardStatus | null): boolean {\n  if (!status) return false\n  return TERMINAL_STATUSES.includes(status)\n}\n\nexport interface UseAiPendingActionPollingOptions {\n  pendingActionId: string\n  /**\n   * Poll interval in ms while the status is non-terminal. Defaults to 3000.\n   */\n  intervalMs?: number\n  /**\n   * Endpoint base. Override to point at a mock during tests.\n   */\n  endpoint?: string\n  /**\n   * When true, the hook does NOT schedule any network activity. Used by the\n   * result card which already holds a terminal state and only needs to read\n   * what the preview card fetched.\n   */\n  disabled?: boolean\n}\n\nexport interface AiPendingActionFetchResult {\n  pendingAction: AiPendingActionCardAction | null\n  error?: { code?: string; message: string } | null\n}\n\nexport interface UseAiPendingActionPollingResult {\n  action: AiPendingActionCardAction | null\n  status: AiPendingActionCardStatus | null\n  isPolling: boolean\n  error: { code?: string; message: string } | null\n  refresh: () => Promise<AiPendingActionCardAction | null>\n}\n\nasync function fetchPendingAction(\n  pendingActionId: string,\n  endpoint: string,\n): Promise<AiPendingActionFetchResult> {\n  const url = `${endpoint}/${encodeURIComponent(pendingActionId)}`\n  const call = await apiCallOrThrow<unknown>(url, { method: 'GET' })\n  const body = call.result as\n    | (Partial<AiPendingActionCardAction> & {\n        pendingAction?: AiPendingActionCardAction\n        error?: string\n        code?: string\n      })\n    | null\n    | undefined\n\n  // The GET route returns the bare action object (`serializePendingActionForClient(row)`),\n  // but earlier client code expected it under a `pendingAction` envelope.\n  // Accept BOTH shapes so the cards work whether the dispatcher wraps or\n  // not \u2014 bare-object payloads were the actual cause of empty\n  // `fieldDiff` and missing `executionResult.error` displays in\n  // MutationPreviewCard / ConfirmationCard / MutationResultCard.\n  if (body && typeof body === 'object') {\n    if (body.pendingAction) {\n      return { pendingAction: body.pendingAction, error: null }\n    }\n    if (\n      typeof (body as Partial<AiPendingActionCardAction>).id === 'string' &&\n      typeof (body as Partial<AiPendingActionCardAction>).status === 'string'\n    ) {\n      return { pendingAction: body as AiPendingActionCardAction, error: null }\n    }\n    if (body.error) {\n      return {\n        pendingAction: null,\n        error: { message: body.error, code: body.code },\n      }\n    }\n  }\n  return { pendingAction: null, error: null }\n}\n\nexport function useAiPendingActionPolling(\n  options: UseAiPendingActionPollingOptions,\n): UseAiPendingActionPollingResult {\n  const {\n    pendingActionId,\n    intervalMs = 3000,\n    endpoint = '/api/ai_assistant/ai/actions',\n    disabled = false,\n  } = options\n\n  const [action, setAction] = React.useState<AiPendingActionCardAction | null>(null)\n  const [error, setError] = React.useState<{ code?: string; message: string } | null>(null)\n  const [isPolling, setIsPolling] = React.useState<boolean>(!disabled)\n\n  const mountedRef = React.useRef(true)\n  const timerRef = React.useRef<ReturnType<typeof setTimeout> | null>(null)\n  const statusRef = React.useRef<AiPendingActionCardStatus | null>(null)\n\n  const clearTimer = React.useCallback(() => {\n    if (timerRef.current) {\n      clearTimeout(timerRef.current)\n      timerRef.current = null\n    }\n  }, [])\n\n  const refresh = React.useCallback(async (): Promise<AiPendingActionCardAction | null> => {\n    if (!pendingActionId) return null\n    try {\n      const result = await fetchPendingAction(pendingActionId, endpoint)\n      if (!mountedRef.current) return result.pendingAction ?? null\n      if (result.error) {\n        setError(result.error)\n      } else {\n        setError(null)\n      }\n      if (result.pendingAction) {\n        setAction(result.pendingAction)\n        statusRef.current = result.pendingAction.status\n      }\n      return result.pendingAction\n    } catch (err) {\n      if (!mountedRef.current) return null\n      const message = err instanceof Error ? err.message : 'Failed to load pending action.'\n      setError({ message })\n      return null\n    }\n  }, [endpoint, pendingActionId])\n\n  const scheduleNext = React.useCallback(() => {\n    clearTimer()\n    if (!mountedRef.current) return\n    if (disabled) {\n      setIsPolling(false)\n      return\n    }\n    if (isTerminal(statusRef.current)) {\n      setIsPolling(false)\n      return\n    }\n    setIsPolling(true)\n    timerRef.current = setTimeout(async () => {\n      await refresh()\n      scheduleNext()\n    }, intervalMs)\n  }, [clearTimer, disabled, intervalMs, refresh])\n\n  React.useEffect(() => {\n    mountedRef.current = true\n    statusRef.current = null\n    if (disabled) {\n      setIsPolling(false)\n      return () => {\n        mountedRef.current = false\n        clearTimer()\n      }\n    }\n    setIsPolling(true)\n    // Always fetch on mount \u2014 the \"reconnect behavior\" guarantee.\n    void refresh().then(() => {\n      if (!mountedRef.current) return\n      scheduleNext()\n    })\n    return () => {\n      mountedRef.current = false\n      clearTimer()\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [pendingActionId, endpoint, intervalMs, disabled])\n\n  const status = action?.status ?? null\n\n  return {\n    action,\n    status,\n    isPolling: isPolling && !isTerminal(status),\n    error,\n    refresh,\n  }\n}\n\nexport default useAiPendingActionPolling\n"],
+  "mappings": "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",
+  "names": []
+}