@ai-matrx/chat 0.3.27 → 0.3.30

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @ai-matrx/chat
 
+## 0.3.30
+
+The composer rail's Scratch pill no longer dead-ends: with no scratchpad attached it used to toast "Nothing to show in the canvas yet" and open nothing. It now opens the scratchpad canvas tab, whose body hydrates the active scratchpad and creates one when the pool is empty.
+
+Consumer action: none.
+
+## 0.3.29
+
+Never reached npm: the tag commit failed CI typecheck on a content-ir-react error fixed right after. These changes ship in 0.3.30.
+
+Package-twins collapse onto `@ai-matrx/kit`: character counts across context, memory, scrape and tool-call views use `formatCount` (compact where the view was compact); sandbox activity and context-compare durations use `formatDurationMs` compact; the document link picker and surface-check age use `formatRelativeTime` ("5h ago" / "5h" where they said "today"); reserved-conversation, table-variable and canvas conversation ids use `isUuidShape`. The `isUuidValue` slot's DEFAULT now matches the registered host rule (trimmed RFC 9562); hosts still override it.
+
+Consumer action: none.
+
+## 0.3.28
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/chat/v0.3.27..npm/chat/v0.3.28 -- apps/shared/chat`).
+No source changes intended and no consumer action required.
+
 ## 0.3.27
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/agents/components/chat/begin-fresh-chat.js

@@ -1,4 +1,5 @@
 "use client";
+import { isUuidShape } from "@ai-matrx/kit/uuid";
 import { clearFocus } from "../../redux/execution-system/conversation-focus/conversation-focus.slice.js";
 import { resolveMandateAsking } from "../../../mandates/resolve-asking.js";
 import { isOrganizationSelectionCancelled } from "../../../host/org.js";
@@ -38,9 +39,8 @@ function getFreshChatHref(activeAgentId, defaultAgentId) {
   }
   return `/chat/a/${encodeURIComponent(activeAgentId)}`;
 }
-const RESERVED_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function reservedConversationIdOf(param) {
-  return param && RESERVED_ID_RE.test(param) ? param.toLowerCase() : null;
+  return param && isUuidShape(param) ? param.toLowerCase() : null;
 }
 function getReservedFreshChatHref(activeAgentId, defaultAgentId, conversationId) {
   return `${getFreshChatHref(activeAgentId, defaultAgentId)}?c=${conversationId}`;

package/dist/agents/components/chat/sandbox-insight/SandboxActivityFeed.d.ts

@@ -1,13 +1,3 @@
-/**
- * SandboxActivityFeed — "what has the agent actually done inside the box?"
- *
- * One line per sandbox tool call, oldest → newest: the tool, its subject (the
- * command, or the path), how it ended (exit code / failed / still running),
- * how long it took, and the output on expand. It is the transcript's sandbox
- * work, extracted and put in one place — reading the SAME tool calls the
- * thread renders from (`sandbox-activity.ts` merges the live lifecycle map
- * with the persisted `cx_tool_call` rows), never a second data path.
- */
 import React from "react";
 export declare function SandboxActivityFeed({ conversationId, }: {
     conversationId: string;

package/dist/agents/components/chat/sandbox-insight/SandboxActivityFeed.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { formatDurationMs } from "@ai-matrx/kit/format";
 import React from "react";
 import { AlertTriangle, ChevronRight, Loader2, Terminal } from "lucide-react";
 import { cn, ErrorBox } from "@ai-matrx/design-system";
@@ -13,9 +14,7 @@ import { DURABLE_VFS_BADGE_TEXT } from "../../../../tool-call-visualization/rend
 import { ErrorAlchemyMenu } from "../../../../host/ui-slots.js";
 import { getToolDisplayName } from "../../../../tool-call-visualization/registry/registry.js";
 function formatDuration(ms) {
-  if (ms === null) return null;
-  if (ms < 1e3) return `${ms}ms`;
-  return `${(ms / 1e3).toFixed(ms < 1e4 ? 1 : 0)}s`;
+  return ms === null ? null : formatDurationMs(ms, { style: "compact" });
 }
 const ActivityRow = ({ row }) => {
   const [open, setOpen] = React.useState(false);

package/dist/agents/components/context-policies-display/contextPolicyPreview.js

@@ -1,3 +1,4 @@
+import { formatCount } from "@ai-matrx/kit/format";
 import {
   previewKnownContext,
   resolveContextEntryValue
@@ -6,7 +7,7 @@ import { unwrapRichContextValue } from "./contextValueUtils.js";
 const PREVIEW_MAX = 32;
 const SIZE_HINT_RE = /^\d[\d,]*\s*chars$/i;
 function formatCharCount(n) {
-  return `~${n.toLocaleString()} chars`;
+  return `~${formatCount(n)} chars`;
 }
 function extractCharCount(value) {
   if (value === void 0 || value === null) return null;

package/dist/agents/components/context-preview/AttachedContextSection.js

@@ -1,5 +1,6 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { formatCount } from "@ai-matrx/kit/format";
 import { Badge, Chip, Button } from "@ai-matrx/design-system/controls";
 import { useMemo } from "react";
 import {
@@ -272,7 +273,7 @@ function AttachedContextSection({
               ),
               /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 truncate text-sm font-medium text-foreground", children: item.title }),
               /* @__PURE__ */ jsxs("span", { className: "shrink-0 text-[10px] tabular-nums text-muted-foreground", children: [
-                item.chars.toLocaleString(),
+                formatCount(item.chars),
                 " chars"
               ] }),
               item.onRemove && /* @__PURE__ */ jsx(RemoveX, { label: item.title, onRemove: item.onRemove })
@@ -306,7 +307,7 @@ function AttachedContextSection({
       ] }),
       " ",
       "\xB7 ~",
-      totalChars.toLocaleString(),
+      formatCount(totalChars),
       " characters of content"
     ] })
   ] });

package/dist/agents/components/context-preview/ContextCompareView.js

@@ -21,7 +21,7 @@ import { usePageCaptureContribution } from "../../../host/ui-slots.js";
 import { useContextPreview } from "./useContextPreview.js";
 import { ErrorAlchemyMenu } from "../../../host/ui-slots.js";
 import { AGENT_ICON } from "@ai-matrx/icons/domain";
-import { formatCount } from "@ai-matrx/kit/format";
+import { formatCount, formatDurationMs } from "@ai-matrx/kit/format";
 import { getUserId } from "../../../host/identity.js";
 import { humanizeIdentifier } from "@ai-matrx/kit/text-case";
 import { useAgentName } from "../../identity/agent-identity.js";
@@ -525,7 +525,7 @@ function AnswerBoth({
             /* @__PURE__ */ jsx("span", { className: "text-[11px] font-semibold uppercase tracking-wider text-primary", children: p === "old" ? "Current system" : "Record store" }),
             /* @__PURE__ */ jsxs("span", { className: "text-[10px] tabular-nums text-muted-foreground", children: [
               a?.model && !/^[0-9a-f-]{36}$/i.test(a.model) ? a.model : "",
-              typeof a?.duration_ms === "number" ? ` ${(a.duration_ms / 1e3).toFixed(1)} s` : "",
+              typeof a?.duration_ms === "number" ? ` ${formatDurationMs(a.duration_ms, { style: "compact" })}` : "",
               typeof a?.input_tokens === "number" ? ` \xB7 ${formatCount(a.input_tokens)} tokens in` : ""
             ] })
           ] }),

package/dist/agents/components/inputs/smart-input/ComposerDraftNotice.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { formatCount } from "@ai-matrx/kit/format";
 import { RotateCcw, TriangleAlert } from "lucide-react";
 import { useComposerDraftRestore } from "../../../redux/execution-system/instance-user-input/useComposerDraftRestore.js";
 import { Button } from "@ai-matrx/design-system/controls";
@@ -15,7 +16,7 @@ function ComposerDraftNotice({
       /* @__PURE__ */ jsx(RotateCcw, { className: "w-3 h-3 shrink-0" }),
       /* @__PURE__ */ jsxs("span", { className: "min-w-0", children: [
         "We put your unsent draft back (",
-        restoredChars.toLocaleString(),
+        formatCount(restoredChars),
         " ",
         "characters)."
       ] }),

package/dist/agents/components/inputs/smart-input/ConversationContextRail.js

@@ -36,7 +36,6 @@ import {
   useOpenScratchpadPanel,
   useOpenWorkingDocumentPanel
 } from "../../../../host/window-openers.js";
-import { reportCanvasOpenDrop } from "../../../../host/ui-slots.js";
 import { selectCloudBrowserRunLive } from "../../../../host/ui-slots.js";
 import {
   selectInstanceContextEntries,
@@ -182,14 +181,6 @@ function ConversationContextRail({
     contextTab.toggle(key);
   };
   const toggleDocInCanvas = (kind) => {
-    if (kind === "scratch" && !activeScratchId) {
-      reportCanvasOpenDrop({
-        reason: "nothing-to-show",
-        requested: scratchTitle?.trim() || "Scratchpad",
-        detail: "no scratchpad is attached to this conversation yet"
-      });
-      return;
-    }
     const tabId = kind === "scratch" ? scratchpadTabId() : conversationDocumentsTabId(conversationId);
     if (canvasOpen && currentCanvasSourceId === tabId) {
       canvas.hide();

package/dist/agents/components/observational-memory/components/MemoryStateInspector.js

@@ -1,5 +1,6 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { formatCount } from "@ai-matrx/kit/format";
 import { useClipboard } from "@ai-matrx/kit/clipboard";
 import { toast } from "../../../../host/notify.js";
 import { useCallback, useEffect, useMemo, useState } from "react";
@@ -335,7 +336,7 @@ function BufferedObservationCard({
                   "t"
                 ] }),
                 hasText && /* @__PURE__ */ jsxs("span", { children: [
-                  /* @__PURE__ */ jsx("span", { className: "text-foreground/70 font-mono", children: text.length.toLocaleString() }),
+                  /* @__PURE__ */ jsx("span", { className: "text-foreground/70 font-mono", children: formatCount(text.length) }),
                   " ",
                   "chars"
                 ] })
@@ -523,7 +524,7 @@ function TextPayload({
       ] }),
       hasText && text && /* @__PURE__ */ jsxs(Fragment, { children: [
         /* @__PURE__ */ jsxs("span", { className: "text-[10px] font-mono text-muted-foreground shrink-0", children: [
-          text.length.toLocaleString(),
+          formatCount(text.length),
           " chars"
         ] }),
         /* @__PURE__ */ jsx(Button, { variant: "quiet", icon: copied ? /* @__PURE__ */ jsx(Check, {}) : /* @__PURE__ */ jsx(Copy, {}), glyphTone: copied ? "success" : void 0, onClick: handleCopy, title: "Copy", "aria-label": "Copy", className: "shrink-0" })

package/dist/agents/components/run-controls/panels/ModelContextPanel.js

@@ -1,6 +1,6 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { formatDurationSeconds } from "@ai-matrx/kit/format";
+import { formatDurationSeconds, formatCount } from "@ai-matrx/kit/format";
 import { useEffect, useMemo, useState } from "react";
 import { useAppDispatch, useAppSelector } from "../../../../store/hooks.js";
 import { useOrganizationRequired } from "../../../../host/ui-slots.js";
@@ -178,7 +178,7 @@ function TrimSummaryView({ trim }) {
         valueClassName: skipped ? "text-amber-500" : rewrittenCount > 0 ? "text-emerald-500" : "text-muted-foreground"
       }
     ),
-    rewrittenCount > 0 && /* @__PURE__ */ jsx(StatRow, { label: "Freed", value: `${freed.toLocaleString()} chars` }),
+    rewrittenCount > 0 && /* @__PURE__ */ jsx(StatRow, { label: "Freed", value: `${formatCount(freed)} chars` }),
     rewrittenBlocks.length > 0 && /* @__PURE__ */ jsxs("div", { className: "text-[10px] font-mono text-muted-foreground space-y-0.5 mt-1", children: [
       rewrittenBlocks.slice(0, 8).map((b) => /* @__PURE__ */ jsxs("div", { className: "truncate", children: [
         "pos ",
@@ -189,9 +189,9 @@ function TrimSummaryView({ trim }) {
         b.tier,
         ") \xB7",
         " ",
-        b.before_chars.toLocaleString(),
+        formatCount(b.before_chars),
         " \u2192 ",
-        b.after_chars.toLocaleString()
+        formatCount(b.after_chars)
       ] }, `${b.message_position}:${b.call_id}`)),
       rewrittenBlocks.length > 8 && /* @__PURE__ */ jsxs("div", { className: "italic", children: [
         "\u2026and ",

package/dist/agents/components/working-document/DocumentLinkPicker.d.ts

@@ -1,11 +1,3 @@
-/**
- * DocumentLinkPicker — pick an existing document (working / scratch) of the
- * current user to LINK this conversation to. Powers cross-conversation sharing:
- * both conversations then point at the same `content.document` row, so
- * edits round-trip to all of them.
- *
- * Desktop: Popover. Mobile: BottomSheet (nested pickers must not use Popover).
- */
 import React from "react";
 import { type WorkingDocumentKind } from "../../redux/execution-system/instance-working-document/cx-working-document.service.js";
 interface DocumentLinkPickerProps {

package/dist/agents/components/working-document/DocumentLinkPicker.js

@@ -1,5 +1,6 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { formatRelativeTime } from "@ai-matrx/kit/format";
 import React, { useCallback, useMemo, useState } from "react";
 import { FileText, Loader2, NotebookPen, Search } from "lucide-react";
 import { Input, Tabs, Tile } from "@ai-matrx/design-system/controls";
@@ -23,14 +24,7 @@ function previewOf(content) {
   return trimmed.length > 80 ? `${trimmed.slice(0, 80)}\u2026` : trimmed;
 }
 function formatWhen(iso) {
-  const then = new Date(iso).getTime();
-  if (Number.isNaN(then)) return "";
-  const diff = Date.now() - then;
-  const day = 864e5;
-  if (diff < day) return "today";
-  if (diff < 2 * day) return "yesterday";
-  if (diff < 7 * day) return `${Math.floor(diff / day)}d ago`;
-  return new Date(iso).toLocaleDateString();
+  return formatRelativeTime(iso, { fallback: "" });
 }
 const SCOPES = [
   { value: "mine", label: "Mine" },

package/dist/agents/hooks/useAgentLauncher.js

@@ -22,6 +22,8 @@ import {
 } from "../../ui/projectCreateAiDebug.js";
 import { toast } from "../../host/notify.js";
 import { isNotAuthenticatedError } from "../../host/identity.js";
+import { isOrganizationSelectionCancelled } from "../../host/org.js";
+import { launchFailureMessage } from "../redux/execution-system/utils/launch-failure-message.js";
 function isConversationInvocation(options) {
   return "identity" in options && "engine" in options && "routing" in options && "origin" in options;
 }
@@ -289,6 +291,7 @@ function useAgentLauncher(agentId, optionsInput) {
         return;
       }
       if (isNotAuthenticatedError(err)) return;
+      if (isOrganizationSelectionCancelled(err)) return;
       if (isProjectCreateFlow(sourceFeature, agentId)) {
         warnProjectCreateAi(
           "useAgentLauncher \u2192 launchAgentExecution FAILED",
@@ -303,9 +306,7 @@ function useAgentLauncher(agentId, optionsInput) {
       } else {
         console.error("Failed to create agent conversation:", err);
       }
-      toast.error(
-        err instanceof Error && err.message ? err.message : "Failed to start the agent conversation."
-      );
+      toast.error(launchFailureMessage(err, "Failed to start the agent conversation."));
     });
     return () => {
       launch.wanted = false;

package/dist/agents/redux/execution-system/context-rules/request-context.js

@@ -371,7 +371,11 @@ const selectDisplayContextRows = (conversationId, mandateKillSwitch = false) =>
   }
   const actual = toContextReceipt(receipt);
   const shown = new Set(rows.map((row) => row.key));
-  const unsent = expected ? compareReceipt(expected.rows, actual).systemRows : actual.rows.filter((row) => row.origin !== "client");
+  const systemRows = expected ? compareReceipt(expected.rows, actual).systemRows : actual.rows.filter((row) => row.origin !== "client");
+  const unsent = [
+    ...systemRows,
+    ...actual.rows.filter((row) => isServerAuthoritativeKey(row.key) && !systemRows.includes(row))
+  ];
   const cap = selectContextInlineCap(state, conversationId);
   const primarySurface = resolveClientSurface(state, conversationId) ?? null;
   const serverAdded = systemRowsToResolved(unsent).filter((row) => !shown.has(row.key)).map((row) => ({

package/dist/agents/utils/table-variable.js

@@ -1,4 +1,4 @@
-const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+import { isUuidShape } from "@ai-matrx/kit/uuid";
 function isTableVariableType(type) {
   return type === "table" || type === "tables";
 }
@@ -7,7 +7,7 @@ function tableVariableTypeOf(customComponent) {
   return typeof type === "string" && isTableVariableType(type) ? type : null;
 }
 function isTableId(value) {
-  return typeof value === "string" && UUID_RE.test(value.trim());
+  return typeof value === "string" && isUuidShape(value.trim());
 }
 function readTableReference(value) {
   const out = [];

package/dist/canvas/workspace/useCanvasWorkspaceConversation.js

@@ -1,4 +1,5 @@
 "use client";
+import { isUuidShape } from "@ai-matrx/kit/uuid";
 import { useEffect, useRef, useState } from "react";
 import { useAgentLauncher } from "../../agents/hooks/useAgentLauncher.js";
 import { DEFAULT_NEW_CHAT_MANDATE_KEY } from "../../agents/components/chat/chat-quick-actions.config.js";
@@ -15,10 +16,9 @@ function initialRequest(start) {
     return { kind: "open", conversationId: start.conversationId, agentId: start.agentId ?? null, nonce: 0 };
   return { kind: "new", nonce: 0 };
 }
-const CONVERSATION_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function conversationInAddress(param, search) {
   const value = new URLSearchParams(search).get(param);
-  return value && CONVERSATION_ID.test(value) ? value : null;
+  return value && isUuidShape(value) ? value : null;
 }
 function workspaceChatMemoryKey(surfaceKey) {
   return `matrx:workspace-chat:${surfaceKey}`;
@@ -26,7 +26,7 @@ function workspaceChatMemoryKey(surfaceKey) {
 function recallWorkspaceConversation(surfaceKey) {
   try {
     const value = window.localStorage.getItem(workspaceChatMemoryKey(surfaceKey));
-    return value && CONVERSATION_ID.test(value) ? value : null;
+    return value && isUuidShape(value) ? value : null;
   } catch {
     return null;
   }
@@ -46,7 +46,7 @@ function reserveWorkspaceConversationId(surfaceKey, fresh) {
   try {
     const key = reservedChatKey(surfaceKey);
     const kept = fresh ? null : window.localStorage.getItem(key);
-    if (kept && CONVERSATION_ID.test(kept)) return kept;
+    if (kept && isUuidShape(kept)) return kept;
     const id = window.crypto.randomUUID();
     window.localStorage.setItem(key, id);
     return id;

package/dist/cx-chat/hooks/useInstanceBootstrap.js

@@ -10,6 +10,7 @@ import { loadConversation } from "../../agents/redux/execution-system/thunks/loa
 import { followWhatIsStillInFlight } from "../../agents/runtime-reconnect/follow-what-is-still-in-flight.js";
 import { toast } from "../../host/notify.js";
 import { isNotAuthenticatedError } from "../../host/identity.js";
+import { isOrganizationSelectionCancelled } from "../../host/org.js";
 import { DEFAULT_AGENT_ID } from "../components/agent/local-agents.js";
 import { replaceAddressWithoutNavigating } from "../../ui/addressWithoutNavigating.js";
 import { ensureAgentCatalog, isAgentCatalogStale } from "../../agents/identity/agent-identity.js";
@@ -90,7 +91,8 @@ function useInstanceBootstrap() {
           resolvedId = result.payload.conversationId;
           instanceByAgentId.current.set(agentId, resolvedId);
         } else if (launchAgentExecution.rejected.match(result) && // Signed out is a state (the sign-in gate), not a failed launch.
-        !isNotAuthenticatedError(result.error)) {
+        !isNotAuthenticatedError(result.error) && // A closed organization chooser is the person's "not now", never a failure.
+        !isOrganizationSelectionCancelled(result.error)) {
           toast.error(
             result.error.message ?? "Failed to start the agent conversation."
           );

package/dist/host/db-types.d.ts

@@ -2240,6 +2240,25 @@ export type ChatDatabase = {
                 };
                 Returns: Json;
             };
+            duplicate_agent: {
+                Args: {
+                    p_agent_id: string;
+                    p_as_system?: boolean;
+                    p_follows_source?: boolean;
+                    p_name?: string;
+                    p_organization_id?: string;
+                };
+                Returns: string;
+            };
+            duplicate_version: {
+                Args: {
+                    p_as_system?: boolean;
+                    p_name?: string;
+                    p_organization_id?: string;
+                    p_version_id: string;
+                };
+                Returns: string;
+            };
             message_flag_problems: {
                 Args: never;
                 Returns: {
@@ -9789,6 +9808,33 @@ export type ChatDatabase = {
                 };
                 Relationships: [];
             };
+            rag_library_docs_bodies: {
+                Row: {
+                    archived_at: string | null;
+                    body: string | null;
+                    body_hash: string | null;
+                    id: string;
+                    processed_document_id: string | null;
+                    title: string | null;
+                };
+                Insert: {
+                    archived_at?: string | null;
+                    body?: string | null;
+                    body_hash?: string | null;
+                    id: string;
+                    processed_document_id?: string | null;
+                    title?: string | null;
+                };
+                Update: {
+                    archived_at?: string | null;
+                    body?: string | null;
+                    body_hash?: string | null;
+                    id?: string;
+                    processed_document_id?: string | null;
+                    title?: string | null;
+                };
+                Relationships: [];
+            };
             research_rs_content_bodies: {
                 Row: {
                     archived_at: string;
@@ -46153,7 +46199,7 @@ export type ChatDatabase = {
             operation_type: "insert" | "update" | "delete";
             org_role: "owner" | "member" | "admin";
             orientation: "vertical" | "horizontal" | "default";
-            permission_level: "viewer" | "commenter" | "editor" | "admin";
+            permission_level: "viewer" | "commenter" | "edit_content" | "editor" | "admin";
             project_role: "owner" | "admin" | "member";
             recipe_status: "live" | "draft" | "in_review" | "active_testing" | "archived" | "other";
             reg_func_category: "Recipes" | "Agents" | "Prompts" | "Processors" | "Extractors" | "Files" | "Database" | "Web" | "Media" | "Documents" | "Integrations" | "Commands" | "Executors" | "API" | "Other";

package/dist/host/defaults/webpage-snapshot-view.js

@@ -1,3 +1,4 @@
+import { formatCount } from "@ai-matrx/kit/format";
 import { createElement } from "react";
 function DefaultWebpageSnapshotView({
   snapshot,
@@ -17,7 +18,7 @@ function DefaultWebpageSnapshotView({
         { className: "font-medium text-foreground" },
         variant === "submitted" ? "Snapshot sent with this message" : "Snapshot attached to this draft"
       ),
-      createElement("span", null, `${charCount.toLocaleString()} characters`),
+      createElement("span", null, `${formatCount(charCount)} characters`),
       scrapedAt ? createElement("span", null, scrapedAt) : null
     ) : null,
     createElement(

package/dist/host/ui-slots.d.ts

@@ -1,16 +1,3 @@
-/**
- * host/ui-slots — host registrations for app UI the package draws but does not own
- * (PACKAGE-INDEPENDENCE.md: "a host registration", not an import of app code).
- *
- * The host registers once at startup with `registerChatUi({...})`; package code
- * imports the named wrappers below. A component the host did not register renders
- * nothing (or its plain stand-in, marked `data-chat-slot-fallback`) and reports itself
- * ONCE through the host diagnostics port (never silent: Law 4); a function or hook it
- * did not register throws, naming the slot (or runs its declared stand-in, reported once). A test registers a stand-in the same way (`registerChatUi`).
- *
- * Slot shapes are the host component's own props — package call sites keep passing
- * exactly what they passed when they imported the component directly.
- */
 import { type ComponentType, type ChangeEvent, type ReactNode } from "react";
 import type { EditableContextMenuProps, NonEditableContextMenuProps } from "../context-menu/types.js";
 /** The host context menu's props (its registration is typed against them). */

package/dist/host/ui-slots.js

@@ -1,4 +1,5 @@
 "use client";
+import { isRfc9562Uuid } from "@ai-matrx/kit/uuid";
 import { createElement, Fragment, useRef } from "react";
 import { formatCost, usdToPoints } from "@ai-matrx/kit/format";
 import { reportUnregisteredHostSlot as reportUnregistered } from "./diagnostics.js";
@@ -143,7 +144,7 @@ const STAND_INS = {
   bookmarksToReferenceDirectives: () => NONE,
   notifyPrintOutcome: () => void 0,
   awaitEffectiveOrganizationId: async () => ({ status: "unavailable", reason: "This host registers no organization source.", cause: "no-selection" }),
-  isUuidValue: (value) => typeof value === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value),
+  isUuidValue: (value) => typeof value === "string" && isRfc9562Uuid(value.trim()),
   useClippedContentGuard: () => void 0,
   answerPreviewText: (text) => String(text ?? ""),
   beginPlaybackSession: () => ({ id: "", update: () => void 0, end: () => void 0 }),

package/dist/surfaces/utils/surface-check-ledger.js

@@ -1,3 +1,4 @@
+import { formatRelativeTime } from "@ai-matrx/kit/format";
 const SURFACE_CHECK_FRESH_DAYS = 30;
 function daysSinceCheck(row, now = Date.now()) {
   if (!row.last_checked_at) return null;
@@ -11,13 +12,7 @@ function surfaceCheckState(row, now = Date.now()) {
   return days > SURFACE_CHECK_FRESH_DAYS ? "stale" : "fresh";
 }
 function checkAgeLabel(row, now = Date.now()) {
-  const days = daysSinceCheck(row, now);
-  if (days === null) return "never";
-  if (days === 0) return "today";
-  if (days === 1) return "1d";
-  if (days < 30) return `${days}d`;
-  const months = Math.floor(days / 30);
-  return months < 12 ? `${months}mo` : `${Math.floor(days / 365)}y`;
+  return formatRelativeTime(row.last_checked_at, { style: "short", suffix: false, now, fallback: "never" });
 }
 function checkSortWeight(row, now = Date.now()) {
   const days = daysSinceCheck(row, now);

package/dist/tool-call-visualization/registry/registry.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { formatCount } from "@ai-matrx/kit/format";
 import {
   CheckCircle,
   FileSearch,
@@ -139,7 +140,7 @@ function scrapeHeaderExtras(entry) {
       "read"
     ] }),
     parsed.totalChars > 0 && /* @__PURE__ */ jsxs("span", { children: [
-      parsed.totalChars.toLocaleString(),
+      formatCount(parsed.totalChars),
       " chars"
     ] })
   ] });

package/dist/tool-call-visualization/renderers/ctx/CtxItemCard.d.ts

@@ -1,18 +1,3 @@
-/**
- * CtxItemCard — the note-card display for ONE context item.
- *
- * Shared by every CTX renderer (`ctx_get`, `ctx_batch`). Renders a single
- * resolved context object — `{ key, type, label, content }` (or `summary`
- * in summary mode) — as a polished note card: a header row carrying the
- * type icon, the human label, the raw key, and an optional size badge, then
- * the value itself via the recursive `<ResultValue>` field library.
- *
- * The component is deliberately shape-tolerant: the server `type` field is a
- * free string, so the icon is resolved through a string-keyed map with a
- * `Layers` fallback. `content` is handed straight to `<ResultValue>`, which
- * already knows how to render markdown, tables, json, media, and scalars by
- * shape — this card never reimplements rendering.
- */
 import React from "react";
 import { type ResultDensity } from "../../result-fields/ResultValue.js";
 export interface CtxItem {

package/dist/tool-call-visualization/renderers/ctx/CtxItemCard.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { formatCount } from "@ai-matrx/kit/format";
 import {
   FileText,
   File,
@@ -34,11 +35,7 @@ function iconForType(type) {
   return CTX_TYPE_ICON[type] ?? Layers;
 }
 function formatCharCount(n) {
-  if (n >= 1e3) {
-    const k = n / 1e3;
-    return `${k >= 10 ? Math.round(k) : k.toFixed(1)}k chars`;
-  }
-  return `${n} char${n === 1 ? "" : "s"}`;
+  return `${formatCount(n, { style: "compact" })} char${n === 1 ? "" : "s"}`;
 }
 const CtxItemCard = ({
   item,

package/dist/tool-call-visualization/renderers/research/ResearchOverlay.d.ts

@@ -1,18 +1,3 @@
-/**
- * Research overlay tabs (`research_web`, `core_web_search_and_read`).
- *
- * Exposes Report · Sources · Full Text, plus a `researchOverlayTabs` array the
- * tool registry hands to `ToolUpdatesOverlay`. When the tool is opened in the
- * overlay these REPLACE the default "Results" tab and sit beside the standard
- * "Input" and "Raw" admin tabs:
- *
- *     [ Report | Sources | Full Text | Input | Raw ]
- *
- * All three parse the raw blob via the ONE canonical `parseSearch` (the
- * deep-research `parser.ts` it used to use is deleted — no duplicate parsers).
- * The Report tab renders through `RichDocument` (full action toolkit); Sources
- * is the dense ranked + deep-read view; Full Text is a copyable synthesized dump.
- */
 import React from "react";
 import type { ToolOverlayTabSpec, ToolRendererProps } from "../../types.js";
 export declare const ResearchReportTab: React.FC<ToolRendererProps>;

package/dist/tool-call-visualization/renderers/research/ResearchOverlay.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { formatCount } from "@ai-matrx/kit/format";
 import { useMemo, useState } from "react";
 import {
   BookOpen,
@@ -106,7 +107,7 @@ const ReadCard = ({
             content: expanded || !isLong ? read.text : `${read.text.slice(0, 500)}\u2026`
           }
         ),
-        isLong && /* @__PURE__ */ jsx(Button, { variant: "quiet", tone: "primary", onClick: () => setExpanded((p) => !p), className: "mt-2", children: expanded ? "Show less" : `Show full content (${Math.round(read.text.length / 1e3)}k chars)` })
+        isLong && /* @__PURE__ */ jsx(Button, { variant: "quiet", tone: "primary", onClick: () => setExpanded((p) => !p), className: "mt-2", children: expanded ? "Show less" : `Show full content (${formatCount(read.text.length, { style: "compact" })} chars)` })
       ] })
     ] })
   ] });

package/dist/tool-call-visualization/renderers/scrape/ScrapeInline.d.ts

@@ -1,33 +1,3 @@
-/**
- * ScrapeInline — the canonical inline renderer for the page-read / scrape family
- * (`web_read`, `core_web_read_web_pages`).
- *
- * Reading 40k tokens off a page is NOT a one-line event — so each page gets a
- * full rectangular CARD (favicon + title + domain + meta; a preview image when
- * one is present; an AI-review line ONLY when present). ONE card per page,
- * multiple cards when reading several pages at once.
- *
- * ─── The two phases ──────────────────────────────────────────────────────────
- *
- *   • READING (live): a left-to-right "reading wave" shimmer sweeps across each
- *     card (the `readingWave` keyframe in globals.css), mimicking a person
- *     reading the page top-to-bottom while the content is fetched. While reading
- *     we know the URLs (from `arguments.urls` and/or the real-time "Browsing
- *     <url>" activity on `entry.events`) but not yet the body — so the card
- *     shows the favicon + domain + a shimmering placeholder.
- *   • DONE (persistent): the card fills in — title, a content snippet, the char
- *     count, the optional preview image (durable, via `InlineMediaRef`), and the
- *     optional AI-review line. A "View page" affordance opens the overlay.
- *
- * Phase is keyed on `selectIsLatestToolActivity(requestId, callId)` when a live
- * requestId is threaded (the card keeps reading until the model moves on), and
- * falls back to `entry.status` for the simulator / persisted snapshots.
- *
- * Images go through `InlineMediaRef` ONLY (never a raw <img>) so a page's
- * preview image self-heals if it's an expiring signed URL. Favicons use the
- * Google favicon service (not owned media → a plain <img> with a Globe fallback
- * is correct). Semantic tokens only; React Compiler is on (no manual memo).
- */
 import React from "react";
 import type { ToolRendererProps } from "../../types.js";
 export declare const ScrapeInline: React.FC<ToolRendererProps>;

package/dist/tool-call-visualization/renderers/scrape/ScrapeInline.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { formatCount } from "@ai-matrx/kit/format";
 import { useMemo, useState } from "react";
 import {
   Globe,
@@ -168,7 +169,7 @@ const ReadPageCard = ({ page, index, onOpen }) => {
           /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3 pt-0.5 text-xs text-muted-foreground", children: [
             /* @__PURE__ */ jsxs("span", { className: "flex items-center gap-1", children: [
               /* @__PURE__ */ jsx(FileText, { className: "h-3 w-3" }),
-              page.charCount.toLocaleString(),
+              formatCount(page.charCount),
               " chars"
             ] }),
             onOpen && /* @__PURE__ */ jsx(Button, { variant: "quiet", tone: "primary", iconEnd: /* @__PURE__ */ jsx(ArrowRight, {}), onClick: (e) => {

package/dist/tool-call-visualization/renderers/scrape/ScrapeOverlay.d.ts

@@ -1,14 +1,3 @@
-/**
- * ScrapeOverlay — the full "hide nothing" page-read view for the scrape family
- * (`web_read`, `core_web_read_web_pages`), rendered in the fullscreen overlay
- * and the floating window panel.
- *
- * Layout: a page list on the left, the selected page's FULL content on the
- * right (rendered as markdown), plus the optional preview image and AI-review
- * when present. Same canonical `parseScrape` as the inline renderer; semantic
- * tokens only; favicons via the Google favicon service; the preview image via
- * `InlineMediaRef` (durable, never a raw <img>).
- */
 import React from "react";
 import type { ToolRendererProps } from "../../types.js";
 export declare const ScrapeOverlay: React.FC<ToolRendererProps>;

package/dist/tool-call-visualization/renderers/scrape/ScrapeOverlay.js

@@ -1,5 +1,6 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { formatCount } from "@ai-matrx/kit/format";
 import { useMemo, useState } from "react";
 import {
   Globe,
@@ -58,7 +59,7 @@ const ScrapeOverlay = ({ entry }) => {
         ] })
       ] }),
       parsed.totalChars > 0 && /* @__PURE__ */ jsxs("span", { className: "ml-auto text-xs tabular-nums text-muted-foreground", children: [
-        parsed.totalChars.toLocaleString(),
+        formatCount(parsed.totalChars),
         " chars total"
       ] })
     ] }),
@@ -88,7 +89,7 @@ const ScrapeOverlay = ({ entry }) => {
               /* @__PURE__ */ jsxs("div", { className: "truncate text-xs text-muted-foreground", children: [
                 p.domain,
                 " \xB7 ",
-                p.charCount.toLocaleString(),
+                formatCount(p.charCount),
                 " chars"
               ] })
             ] })

package/dist/tool-call-visualization/result-fields/KeyValueGrid.d.ts

@@ -1,36 +1,3 @@
-/**
- * KeyValueGrid — renders a plain object as a compact, shape-aware field layout.
- *
- * Fields are partitioned by what their VALUE is, not treated uniformly:
- *
- *   inline  — short values (scalar / uuid / url / boolean / empty) render as
- *             single-line `Label  value` rows on a two-column grid. Key, Type,
- *             Label never burn two lines each again.
- *   chips   — numeric metadata (total_chars, count, duration_ms, tokens…)
- *             renders as one wrapping row of quiet badges.
- *   blocks  — anything of unknown length (text, markdown, nested objects,
- *             tables, lists, media) keeps a full-width section: small label
- *             header, value beneath, recursing through {@link ResultValue}.
- *
- * Display order is inline rows → chips → blocks so unknown-length content
- * always sits last. Identifier keys (`id`, `*_id`, `uuid`) render the full
- * UUID with an always-visible copy button.
- *
- * Every key is reachable: nothing is dropped, only deferred behind a toggle.
- *
- * FIELDS THAT DO NOT APPLY (wall W61, 2026-09-12) obey the document's optional
- * -field policy (`document-presentation.tsx`), not the density. Before that,
- * `inline` silently skipped them and `full` printed the word "None" — the same
- * payload read two different ways, and the `full` reading put "Physician note:
- * None" at the top of a page written for a parent. Under the default `omit`
- * policy they leave the field list and are COUNTED on a quiet trailing line
- * that opens them; under `note` they keep their row with a quiet "Not
- * applicable"; under `show` the producer's value renders untouched.
- *
- * FIELD LABELS come from the producer's own JSON Schema `title` when the host
- * supplied one, and from the key otherwise. The key is the machine's name for
- * a field; the schema's title is the author's.
- */
 import React from "react";
 import { type ResultDensity } from "./ResultValue.js";
 export interface KeyValueGridProps {

package/dist/tool-call-visualization/result-fields/KeyValueGrid.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { formatCount } from "@ai-matrx/kit/format";
 import React from "react";
 import { cn } from "@ai-matrx/design-system";
 import {
@@ -53,13 +54,7 @@ function isMetaCountField(key, val) {
   return typeof val === "number" && Number.isFinite(val) && META_COUNT_KEY.test(key);
 }
 function formatMetaNumber(n) {
-  if (Number.isInteger(n) && Math.abs(n) >= 1e4) {
-    return new Intl.NumberFormat("en-US", {
-      notation: "compact",
-      maximumFractionDigits: 1
-    }).format(n);
-  }
-  return n.toLocaleString("en-US");
+  return Number.isInteger(n) && Math.abs(n) >= 1e4 ? formatCount(n, { style: "compact" }) : formatCount(n, { locale: "en-US" });
 }
 function isInlineValue(key, val) {
   if (typeof val === "string" && isIdentifierKey(key)) {

package/dist/ui/mandates-storage/mandateStorage.d.ts

@@ -10298,6 +10298,25 @@ export declare function mandateNotes(supabase: Client): import("@supabase/supaba
             };
             Returns: Json;
         };
+        duplicate_agent: {
+            Args: {
+                p_agent_id: string;
+                p_as_system?: boolean;
+                p_follows_source?: boolean;
+                p_name?: string;
+                p_organization_id?: string;
+            };
+            Returns: string;
+        };
+        duplicate_version: {
+            Args: {
+                p_as_system?: boolean;
+                p_name?: string;
+                p_organization_id?: string;
+                p_version_id: string;
+            };
+            Returns: string;
+        };
         message_flag_problems: {
             Args: never;
             Returns: {

package/dist/ui/mandates-storage/shortcutStorage.d.ts

@@ -1941,6 +1941,25 @@ declare const agentShortcutTable: (supabase: Client) => import("@supabase/supaba
             };
             Returns: import("../../host/db-types.js").Json;
         };
+        duplicate_agent: {
+            Args: {
+                p_agent_id: string;
+                p_as_system?: boolean;
+                p_follows_source?: boolean;
+                p_name?: string;
+                p_organization_id?: string;
+            };
+            Returns: string;
+        };
+        duplicate_version: {
+            Args: {
+                p_as_system?: boolean;
+                p_name?: string;
+                p_organization_id?: string;
+                p_version_id: string;
+            };
+            Returns: string;
+        };
         message_flag_problems: {
             Args: never;
             Returns: {
@@ -4137,6 +4156,25 @@ declare const agentContextMenuView: (supabase: Client) => import("@supabase/supa
             };
             Returns: import("../../host/db-types.js").Json;
         };
+        duplicate_agent: {
+            Args: {
+                p_agent_id: string;
+                p_as_system?: boolean;
+                p_follows_source?: boolean;
+                p_name?: string;
+                p_organization_id?: string;
+            };
+            Returns: string;
+        };
+        duplicate_version: {
+            Args: {
+                p_as_system?: boolean;
+                p_name?: string;
+                p_organization_id?: string;
+                p_version_id: string;
+            };
+            Returns: string;
+        };
         message_flag_problems: {
             Args: never;
             Returns: {

package/dist/ui/permission-levels.d.ts

@@ -44,12 +44,18 @@ import type { ChatDatabase as Database } from "../host/db-types.js";
  * The canonical ladder, ascending. THE ONE PLACE a level is declared.
  * Order is authority order: each entry outranks every entry before it.
  */
-export declare const PERMISSION_LEVELS: readonly ["viewer", "commenter", "editor", "admin"];
+export declare const PERMISSION_LEVELS: readonly ["viewer", "commenter", "edit_content", "editor", "admin"];
 export type PermissionLevel = (typeof PERMISSION_LEVELS)[number];
 /** Ordinal rank, 1-based, derived from the ladder so it can never drift. */
 export declare const PERMISSION_LEVEL_RANK: Record<PermissionLevel, number>;
 /** Sentence labels, used where the level is described ("Can view"). */
 export declare const PERMISSION_LEVEL_LABELS: Record<PermissionLevel, string>;
+/**
+ * One line each, for a picker's tooltip: what the level lets a person do. `edit_content` is
+ * Notion's "Can edit content" - change the rows and page content, never the structure
+ * (columns, views, settings) or the sharing. It sorts between `commenter` and `editor`.
+ */
+export declare const PERMISSION_LEVEL_HINTS: Record<PermissionLevel, string>;
 /** Noun labels, used in pickers and chips ("Viewer"). */
 export declare const PERMISSION_LEVEL_SHORT_LABELS: Record<PermissionLevel, string>;
 /**
@@ -63,7 +69,7 @@ export type DbPermissionLevel = Database["public"]["Enums"]["permission_level"];
  * below: when `public.permission_level` gains a value and `pnpm db-types` regenerates, this
  * line stops compiling until the new value is added — never a silent gap.
  */
-export declare const DB_PERMISSION_LEVELS: readonly ["viewer", "commenter", "editor", "admin"];
+export declare const DB_PERMISSION_LEVELS: readonly ["viewer", "commenter", "edit_content", "editor", "admin"];
 /** Type guard for an arbitrary value being a known code-ladder level. */
 export declare function isPermissionLevel(raw: unknown): raw is PermissionLevel;
 /** True when the database enum can currently store this level. */

package/dist/ui/permission-levels.js

@@ -1,6 +1,7 @@
 const PERMISSION_LEVELS = [
   "viewer",
   "commenter",
+  "edit_content",
   "editor",
   "admin"
 ];
@@ -10,16 +11,25 @@ const PERMISSION_LEVEL_RANK = Object.fromEntries(
 const PERMISSION_LEVEL_LABELS = {
   viewer: "Can view",
   commenter: "Can comment",
+  edit_content: "Can edit content",
   editor: "Can edit",
   admin: "Full access"
 };
+const PERMISSION_LEVEL_HINTS = {
+  viewer: "Can open and read it.",
+  commenter: "Can read it and leave comments.",
+  edit_content: "Can change the content, not the structure or the sharing.",
+  editor: "Can change content and structure.",
+  admin: "Can change everything and decide who else may."
+};
 const PERMISSION_LEVEL_SHORT_LABELS = {
   viewer: "Viewer",
   commenter: "Commenter",
+  edit_content: "Content editor",
   editor: "Editor",
   admin: "Full access"
 };
-const DB_PERMISSION_LEVELS = ["viewer", "commenter", "editor", "admin"];
+const DB_PERMISSION_LEVELS = ["viewer", "commenter", "edit_content", "editor", "admin"];
 const _everyDbLevelIsListed = true;
 void _everyDbLevelIsListed;
 function isPermissionLevel(raw) {
@@ -55,6 +65,7 @@ function permissionLevelRank(level) {
 export {
   DB_PERMISSION_LEVELS,
   PERMISSION_LEVELS,
+  PERMISSION_LEVEL_HINTS,
   PERMISSION_LEVEL_LABELS,
   PERMISSION_LEVEL_RANK,
   PERMISSION_LEVEL_SHORT_LABELS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.3.27",
+  "version": "0.3.30",
   "description": "THE one AI Matrx person-to-agent chat system: the full chat (running agents, conversations, tool calls, streaming, context, surfaces, voice) as per-module subpaths @ai-matrx/chat/<domain>/<module> over a host contract (/host, /host/react) whose only required value is a db; plus the kernel compatibility entries (., /external-store, /matrx, /react, /tools, styles.css, tokens.css) until P28.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -226,24 +226,24 @@
     "server-only": "^0.0.1",
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
-    "@ai-matrx/alchemy": "latest",
+    "@ai-matrx/agents": "latest",
     "@ai-matrx/associations": "latest",
+    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/browser-audio": "latest",
     "@ai-matrx/canvas": "latest",
+    "@ai-matrx/content-ir": "latest",
     "@ai-matrx/content-ir-react": "latest",
-    "@ai-matrx/agents": "latest",
+    "@ai-matrx/data": "latest",
     "@ai-matrx/design-system": "latest",
     "@ai-matrx/diff": "latest",
     "@ai-matrx/icons": "latest",
+    "@ai-matrx/kit": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
+    "@ai-matrx/tap-target": "latest",
     "@ai-matrx/media": "latest",
     "@ai-matrx/records": "latest",
-    "@ai-matrx/tap-target": "latest",
-    "@ai-matrx/records-ui": "latest",
-    "@ai-matrx/content-ir": "latest",
-    "@ai-matrx/data": "latest",
-    "@ai-matrx/kit": "latest"
+    "@ai-matrx/records-ui": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",

package/dist/agents/components/shared/AgentDuplicateOutcomeDialog.d.ts

@@ -1,57 +0,0 @@
-/** "choose" = the person picks which version to copy before anything runs. */
-export type DuplicateOutcomeState = "choose" | "loading" | "success" | "error";
-/** The value of the "copy the agent as it is now" choice. */
-export declare const CURRENT_VERSION_CHOICE = "current";
-export interface DuplicateVersionOption {
-    versionId: string;
-    versionNumber: number;
-    changedAt: string;
-    changeNote: string | null;
-}
-export interface DuplicateVersionChooser {
-    /** The source agent's live version number, shown on the default choice. */
-    currentVersion: number | null;
-    /** Saved past versions, newest first. */
-    versions: DuplicateVersionOption[];
-    versionsLoading: boolean;
-    /** Set when the version list could not be read — the current version still works. */
-    versionsError: string | null;
-    /** CURRENT_VERSION_CHOICE or a version id. */
-    selected: string;
-    onSelectedChange: (value: string) => void;
-    onConfirm: () => void;
-}
-export interface AgentDuplicateOutcomeDialogProps {
-    open: boolean;
-    /** Called when the user dismisses the dialog (X button, escape, or "Stay
-     *  here"). The dialog is fully controlled — the parent owns lifecycle. */
-    onOpenChange: (open: boolean) => void;
-    state: DuplicateOutcomeState;
-    /** Display name of the new agent (only meaningful in success state). */
-    newAgentName?: string;
-    /** Path to the new agent — used by both "Open new agent" and "Open in new
-     *  tab." Defaults to `null` while loading; required in success state. */
-    newAgentPath?: string | null;
-    /** Optional error message in error state. */
-    errorMessage?: string;
-    /** Whether the source agent was a builtin/system agent. Tweaks the success
-     *  copy so admins know the duplicate is also a system agent. */
-    asSystem?: boolean;
-    /** Required for the "choose" state. */
-    chooser?: DuplicateVersionChooser;
-}
-/**
- * Post-duplicate "where would you like to go?" choice surface.
- *
- * Flow:
- *   1. Parent fires the duplicate thunk and immediately mounts this dialog
- *      with `state="loading"` so the user sees the in-flight work.
- *   2. On success, the parent flips to `state="success"` and supplies the
- *      new agent's id + computed `newAgentPath`. The user picks one of three
- *      destinations (open in current tab, open in new tab, stay here).
- *   3. On failure, the parent flips to `state="error"` with a message.
- *
- * Mobile renders as a bottom Drawer (per project mobile rules — never Dialog
- * on mobile); desktop uses a small Dialog (`sm:max-w-md`).
- */
-export declare function AgentDuplicateOutcomeDialog({ open, onOpenChange, state, newAgentName, newAgentPath, errorMessage, asSystem, chooser, }: AgentDuplicateOutcomeDialogProps): import("react").JSX.Element;

package/dist/agents/components/shared/AgentDuplicateOutcomeDialog.js

@@ -1,188 +0,0 @@
-"use client";
-import { jsx, jsxs } from "react/jsx-runtime";
-import { useTransition } from "react";
-import { useRouter } from "../../../host/navigation.js";
-import {
-  AlertCircle,
-  ArrowRight,
-  CheckCircle2,
-  Copy,
-  ExternalLink,
-  Loader2
-} from "lucide-react";
-import {
-  Dialog,
-  DialogContent,
-  DialogDescription,
-  DialogHeader,
-  DialogTitle
-} from "@ai-matrx/design-system";
-import {
-  Drawer,
-  DrawerContent,
-  DrawerDescription,
-  DrawerHeader,
-  DrawerTitle
-} from "@ai-matrx/design-system";
-import { Alert, AlertDescription } from "@ai-matrx/design-system";
-import { Button } from "@ai-matrx/design-system";
-import { Select } from "@ai-matrx/design-system/controls";
-import { useIsMobile } from "@ai-matrx/kit/media-query";
-const CURRENT_VERSION_CHOICE = "current";
-function AgentDuplicateOutcomeDialog({
-  open,
-  onOpenChange,
-  state,
-  newAgentName,
-  newAgentPath,
-  errorMessage,
-  asSystem = false,
-  chooser
-}) {
-  const isMobile = useIsMobile();
-  const router = useRouter();
-  const [isNavigating, startTransition] = useTransition();
-  const handleGoToAgent = () => {
-    if (!newAgentPath) return;
-    onOpenChange(false);
-    startTransition(() => router.push(newAgentPath));
-  };
-  const handleOpenInNewTab = () => {
-    if (!newAgentPath) return;
-    window.open(newAgentPath, "_blank", "noopener,noreferrer");
-    onOpenChange(false);
-  };
-  const handleStayHere = () => {
-    onOpenChange(false);
-  };
-  const titleText = state === "choose" ? "Duplicate agent" : state === "loading" ? "Duplicating agent\u2026" : state === "success" ? asSystem ? "System agent duplicated" : "Agent duplicated" : "Duplicate failed";
-  const descriptionText = state === "choose" ? "Pick the version to copy into a new agent." : state === "loading" ? "Creating a copy with all messages, variables, settings, and tools." : state === "success" ? newAgentName ? `"${newAgentName}" is ready. Where would you like to go?` : "The copy is ready. Where would you like to go?" : errorMessage ?? "Something went wrong while duplicating.";
-  const body = /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
-    state === "choose" && chooser && /* @__PURE__ */ jsxs("div", { className: "space-y-3", children: [
-      /* @__PURE__ */ jsx(
-        Select,
-        {
-          "aria-label": "Version to copy",
-          className: "w-full",
-          value: chooser.selected,
-          onValueChange: chooser.onSelectedChange,
-          options: [
-            {
-              value: CURRENT_VERSION_CHOICE,
-              label: chooser.currentVersion != null ? `Current version (v${chooser.currentVersion})` : "Current version"
-            },
-            ...chooser.versions.filter((v) => v.versionNumber !== chooser.currentVersion).map((v) => ({ value: v.versionId, label: versionOptionLabel(v) }))
-          ]
-        }
-      ),
-      chooser.versionsLoading && /* @__PURE__ */ jsxs("p", { className: "flex items-center gap-2 text-xs text-muted-foreground", children: [
-        /* @__PURE__ */ jsx(Loader2, { className: "h-3 w-3 animate-spin" }),
-        "Loading versions\u2026"
-      ] }),
-      chooser.versionsError && /* @__PURE__ */ jsxs("p", { className: "text-xs text-destructive", children: [
-        "Past versions could not be loaded: ",
-        chooser.versionsError
-      ] }),
-      /* @__PURE__ */ jsxs("div", { className: "flex justify-end gap-2", children: [
-        /* @__PURE__ */ jsx(Button, { variant: "ghost", onClick: handleStayHere, children: "Cancel" }),
-        /* @__PURE__ */ jsxs(Button, { onClick: chooser.onConfirm, children: [
-          /* @__PURE__ */ jsx(Copy, { className: "h-4 w-4" }),
-          "Duplicate"
-        ] })
-      ] })
-    ] }),
-    state === "loading" && /* @__PURE__ */ jsxs("div", { className: "flex flex-col items-center gap-3 py-6", children: [
-      /* @__PURE__ */ jsx(Loader2, { className: "h-10 w-10 animate-spin text-primary" }),
-      /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: "Please wait\u2026" })
-    ] }),
-    state === "success" && /* @__PURE__ */ jsxs("div", { className: "space-y-3", children: [
-      /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3 p-3 rounded-md bg-success/10 border border-success/20", children: [
-        /* @__PURE__ */ jsx(CheckCircle2, { className: "h-5 w-5 text-success shrink-0" }),
-        /* @__PURE__ */ jsx("p", { className: "text-sm font-medium", children: "Copy created successfully." })
-      ] }),
-      /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-2", children: [
-        /* @__PURE__ */ jsxs(
-          Button,
-          {
-            size: "lg",
-            onClick: handleGoToAgent,
-            disabled: !newAgentPath || isNavigating,
-            className: "w-full justify-start gap-2",
-            children: [
-              isNavigating ? /* @__PURE__ */ jsx(Loader2, { className: "h-4 w-4 animate-spin" }) : /* @__PURE__ */ jsx(ArrowRight, { className: "h-4 w-4" }),
-              /* @__PURE__ */ jsx("span", { className: "flex-1 text-left", children: "Open new agent" })
-            ]
-          }
-        ),
-        newAgentPath ? /* @__PURE__ */ jsxs(
-          Button,
-          {
-            size: "lg",
-            variant: "outline",
-            onClick: handleOpenInNewTab,
-            className: "w-full justify-start gap-2",
-            children: [
-              /* @__PURE__ */ jsx(ExternalLink, { className: "h-4 w-4" }),
-              /* @__PURE__ */ jsx("span", { className: "flex-1 text-left", children: "Open in new tab" })
-            ]
-          }
-        ) : null,
-        /* @__PURE__ */ jsxs(
-          Button,
-          {
-            size: "lg",
-            variant: "ghost",
-            onClick: handleStayHere,
-            className: "w-full justify-start gap-2",
-            children: [
-              /* @__PURE__ */ jsx(Copy, { className: "h-4 w-4" }),
-              /* @__PURE__ */ jsx("span", { className: "flex-1 text-left", children: "Stay here" })
-            ]
-          }
-        )
-      ] })
-    ] }),
-    state === "error" && /* @__PURE__ */ jsxs("div", { className: "space-y-3", children: [
-      /* @__PURE__ */ jsxs(Alert, { variant: "destructive", children: [
-        /* @__PURE__ */ jsx(AlertCircle, { className: "h-4 w-4" }),
-        /* @__PURE__ */ jsx(AlertDescription, { children: errorMessage ?? "Failed to duplicate agent." })
-      ] }),
-      /* @__PURE__ */ jsx(Button, { variant: "outline", onClick: handleStayHere, className: "w-full", children: "Close" })
-    ] })
-  ] });
-  if (isMobile) {
-    return /* @__PURE__ */ jsx(Drawer, { open, onOpenChange, children: /* @__PURE__ */ jsxs(DrawerContent, { className: "max-h-[85dvh] pb-safe", children: [
-      /* @__PURE__ */ jsxs(DrawerHeader, { children: [
-        /* @__PURE__ */ jsxs(DrawerTitle, { className: "flex items-center gap-2", children: [
-          /* @__PURE__ */ jsx(Copy, { className: "h-5 w-5" }),
-          titleText
-        ] }),
-        /* @__PURE__ */ jsx(DrawerDescription, { children: descriptionText })
-      ] }),
-      /* @__PURE__ */ jsx("div", { className: "px-4 pb-4", children: body })
-    ] }) });
-  }
-  return /* @__PURE__ */ jsx(Dialog, { open, onOpenChange, children: /* @__PURE__ */ jsxs(DialogContent, { className: "sm:max-w-md", children: [
-    /* @__PURE__ */ jsxs(DialogHeader, { children: [
-      /* @__PURE__ */ jsxs(DialogTitle, { className: "flex items-center gap-2", children: [
-        /* @__PURE__ */ jsx(Copy, { className: "h-5 w-5" }),
-        titleText
-      ] }),
-      /* @__PURE__ */ jsx(DialogDescription, { children: descriptionText })
-    ] }),
-    body
-  ] }) });
-}
-function versionOptionLabel(v) {
-  const date = new Date(v.changedAt).toLocaleDateString(void 0, {
-    month: "short",
-    day: "numeric",
-    year: "numeric"
-  });
-  const note = v.changeNote?.trim();
-  return note ? `v${v.versionNumber} \xB7 ${date} \xB7 ${note.length > 40 ? `${note.slice(0, 40)}\u2026` : note}` : `v${v.versionNumber} \xB7 ${date}`;
-}
-export {
-  AgentDuplicateOutcomeDialog,
-  CURRENT_VERSION_CHOICE
-};