@ai-matrx/chat 0.7.17 → 0.7.19

package/dist/agents/redux/conversation-list/conversation-rows.d.ts

@@ -11,6 +11,13 @@
 import type { ConversationListItem } from "./conversation-list.types.js";
 /** Columns projected from `chat.conversation` — enough for any list row. */
 export declare const CONVERSATION_ROW_COLUMNS = "id, title, description, status, message_count, initial_agent_id, last_model_id, source_app, source_feature, origin_class, created_at, updated_at, exclude_from_kg";
+/**
+ * The columns a history ROW shows — its name, its time, and the provenance its
+ * menu offers (agent, source, archive, knowledge-graph opt-out). The /chat
+ * sidebar reads only these (owner, 2026-10-09: "little to no additional data
+ * than just the names"); `mapConversationDbRow` leaves the rest unset.
+ */
+export declare const CONVERSATION_NAME_ROW_COLUMNS = "id, title, status, initial_agent_id, source_app, source_feature, origin_class, updated_at, exclude_from_kg";
 /** Structural row type — the columns above, loosely typed like the query result. */
 export type ConversationDbRow = Record<string, unknown>;
 export declare function mapConversationDbRow(row: ConversationDbRow): ConversationListItem;

package/dist/agents/redux/conversation-list/conversation-rows.js

@@ -1,12 +1,13 @@
 import { conversationTitleText } from "@ai-matrx/content-ir/surfaces";
 const CONVERSATION_ROW_COLUMNS = "id, title, description, status, message_count, initial_agent_id, last_model_id, source_app, source_feature, origin_class, created_at, updated_at, exclude_from_kg";
+const CONVERSATION_NAME_ROW_COLUMNS = "id, title, status, initial_agent_id, source_app, source_feature, origin_class, updated_at, exclude_from_kg";
 function mapConversationDbRow(row) {
   return {
     conversationId: row.id,
     title: conversationTitleText(row.title ?? null),
     description: row.description ?? null,
     updatedAt: row.updated_at,
-    createdAt: row.created_at,
+    ...typeof row.created_at === "string" ? { createdAt: row.created_at } : {},
     status: row.status,
     messageCount: row.message_count ?? 0,
     isFavorite: false,
@@ -19,6 +20,7 @@ function mapConversationDbRow(row) {
   };
 }
 export {
+  CONVERSATION_NAME_ROW_COLUMNS,
   CONVERSATION_ROW_COLUMNS,
   mapConversationDbRow
 };

package/dist/agents/redux/execution-system/client-capabilities/desktop-native.provider.js

@@ -1,3 +1,4 @@
+import { whenPageIdle } from "@ai-matrx/kit/idle-scheduler";
 import { getLiveDesktopInstance } from "./desktop-presence.js";
 import { registerClientCapability } from "./registry.js";
 import { isChatHostConfigured, onChatHostConfigured } from "../../../../host/configure.js";
@@ -6,7 +7,9 @@ function toSysPlatform(platform) {
 }
 const PRESENCE_BUDGET_MS = 150;
 if (typeof window !== "undefined") {
-  const warm = () => setTimeout(() => void getLiveDesktopInstance(), 0);
+  const warm = () => void whenPageIdle().then((idle) => {
+    if (idle) void getLiveDesktopInstance();
+  });
   if (isChatHostConfigured()) {
     warm();
   } else {

package/dist/agents/redux/execution-system/context-rules/mandate-kill-switch.d.ts

@@ -13,6 +13,10 @@
  * `false` would send page values the server then withholds (R2-1). Every
  * resolution invalidation (an organization switch, a binding write) forgets
  * the answers, since a verdict is true for one person in one organization.
+ * An answer younger than the resolution cache's lifetime is reused without a
+ * re-ask, and concurrent askers (the rail and the meta row) share one refresh.
  */
 import type { AnyMandateKey } from "@ai-matrx/agents/mandates";
 export declare function resolveMandateKillSwitch(mandateKey: AnyMandateKey | null | undefined): Promise<boolean>;
+/** The last answer, synchronously (undefined until one was read) — a mount's first paint. */
+export declare function peekMandateKillSwitch(mandateKey: AnyMandateKey | null | undefined): boolean | undefined;

package/dist/agents/redux/execution-system/context-rules/mandate-kill-switch.js

@@ -1,19 +1,37 @@
 import { onMandateCacheInvalidated, resolveMandate } from "../../../../mandates/service.js";
 const lastKnown = /* @__PURE__ */ new Map();
+const knownAt = /* @__PURE__ */ new Map();
+const refreshing = /* @__PURE__ */ new Map();
+const FRESH_MS = 5 * 60 * 1e3;
 let forgetsOnInvalidation = false;
 function forgetOnInvalidation() {
   if (forgetsOnInvalidation) return;
   forgetsOnInvalidation = true;
   onMandateCacheInvalidated((mandateKey) => {
-    if (mandateKey === void 0) lastKnown.clear();
-    else lastKnown.delete(mandateKey);
+    if (mandateKey === void 0) {
+      lastKnown.clear();
+      knownAt.clear();
+    } else {
+      lastKnown.delete(mandateKey);
+      knownAt.delete(mandateKey);
+    }
   });
 }
 function refreshKillSwitch(mandateKey) {
+  const pending = refreshing.get(mandateKey);
+  if (pending) return pending;
+  const run = askKillSwitch(mandateKey).finally(() => {
+    if (refreshing.get(mandateKey) === run) refreshing.delete(mandateKey);
+  });
+  refreshing.set(mandateKey, run);
+  return run;
+}
+function askKillSwitch(mandateKey) {
   return resolveMandate(mandateKey, { optional: true }).then(
     (mandate) => {
       const closed = mandate?.contract.autoContextDisabled === true;
       lastKnown.set(mandateKey, closed);
+      knownAt.set(mandateKey, Date.now());
       return closed;
     },
     (error) => {
@@ -26,9 +44,15 @@ async function resolveMandateKillSwitch(mandateKey) {
   if (!mandateKey) return false;
   forgetOnInvalidation();
   const known = lastKnown.get(mandateKey);
+  const at = knownAt.get(mandateKey);
+  if (known !== void 0 && at !== void 0 && Date.now() - at < FRESH_MS) return known;
   const fresh = refreshKillSwitch(mandateKey);
   return known ?? fresh;
 }
+function peekMandateKillSwitch(mandateKey) {
+  return mandateKey ? lastKnown.get(mandateKey) : void 0;
+}
 export {
+  peekMandateKillSwitch,
   resolveMandateKillSwitch
 };

package/dist/agents/redux/execution-system/conversations/conversations.selectors.d.ts

@@ -266,6 +266,16 @@ export declare const selectRunningInstances: ((state: {
 };
 export declare const selectAgentIdFromInstance: (conversationId: string) => (state: ChatRootState) => string | undefined;
 export declare const selectIsCacheOnly: (conversationId: string) => (state: ChatRootState) => boolean;
+/**
+ * Is this a DRAFT — a conversation minted in this tab that has no server row
+ * yet (`cacheOnly`, until the first send's confirmation or a DB hydrate flips
+ * it)? Reads keyed by a draft's id can only answer "nothing": gate them on
+ * this and they run the moment the first send makes it real. A conversation
+ * Redux does not hold is NOT a draft (it was opened from elsewhere, so it has a
+ * row) — unlike `selectIsCacheOnly`, which answers true for an unknown id
+ * because it gates WRITES.
+ */
+export declare const selectIsDraftConversation: (conversationId: string | null | undefined) => (state: ChatRootState) => boolean;
 export declare const selectConversationTitle: (conversationId: string) => (state: ChatRootState) => string | null;
 export declare const selectConversationDescription: (conversationId: string) => (state: ChatRootState) => string | null;
 export declare const selectConversationKeywords: (conversationId: string) => (state: ChatRootState) => string[] | null;

package/dist/agents/redux/execution-system/conversations/conversations.selectors.js

@@ -44,6 +44,8 @@ const selectRunningInstances = createSelector(
 );
 const selectAgentIdFromInstance = (conversationId) => (state) => state.conversations.byConversationId[conversationId]?.agentId;
 const selectIsCacheOnly = (conversationId) => (state) => state.conversations.byConversationId[conversationId]?.cacheOnly ?? true;
+const selectIsDraftConversation = (conversationId) => (state) => !!conversationId && // A store without the conversations slice holds no drafts.
+state.conversations?.byConversationId[conversationId]?.cacheOnly === true;
 const selectConversationTitle = (conversationId) => (state) => state.conversations.byConversationId[conversationId]?.title ?? null;
 const selectConversationDescription = (conversationId) => (state) => state.conversations.byConversationId[conversationId]?.description ?? null;
 const selectConversationKeywords = (conversationId) => (state) => state.conversations.byConversationId[conversationId]?.keywords ?? null;
@@ -82,6 +84,7 @@ export {
   selectInstanceStatus,
   selectInstancesByAgent,
   selectIsCacheOnly,
+  selectIsDraftConversation,
   selectRunningInstances,
   selectViewerCanReply
 };

package/dist/agents/redux/execution-system/instance-user-input/useComposerDraftRestore.js

@@ -10,6 +10,7 @@ import {
 } from "./composer-draft-store.js";
 import { applyComposerDraft } from "./restore-composer-draft.thunk.js";
 import { restoreComposerRemarks } from "../instance-resources/remarks.js";
+import { selectIsDraftConversation } from "../conversations/conversations.selectors.js";
 import {
   flushComposerDraftWrite,
   isDraftRestoreEnabled
@@ -50,7 +51,6 @@ function useComposerDraftRestore(conversationId, alias) {
     setRestoredValue(null);
     setStorageAvailable(isComposerDraftStorageAvailable());
     if (!enabled) return;
-    if (chatHostHasDatabase()) restoreComposerRemarks(conversationId);
     restoreRenderedArtifactChips(dispatch, store.getState, conversationId, ownerId ?? null);
     const token = peekComposerDraft(conversationId, liveAlias, ownerId);
     if (!token) return;
@@ -58,6 +58,11 @@ function useComposerDraftRestore(conversationId, alias) {
       setRestoredValue(token.value);
     }
   }, [conversationId, liveAlias, dispatch, store, enabled, entryReady, ownerId]);
+  const isDraft = useAppSelector(selectIsDraftConversation(conversationId));
+  useEffect(() => {
+    if (!enabled || !entryReady || isDraft || !ownerId) return;
+    if (chatHostHasDatabase()) restoreComposerRemarks(conversationId);
+  }, [conversationId, enabled, entryReady, isDraft, ownerId]);
   useEffect(() => {
     if (restoredValue !== null && text !== restoredValue) setRestoredValue(null);
   }, [text, restoredValue]);

package/dist/agents/redux/execution-system/instance-working-document/scratchpad.thunks.js

@@ -27,6 +27,7 @@ import {
   unlinkDocumentFromConversation
 } from "./cx-working-document.service.js";
 import { getActiveOrgId } from "../../../../host/org.js";
+import { toast } from "../../../../host/notify.js";
 function setActivePreference(dispatch, id) {
   dispatch(
     setPreference({ module: "scratchpad", preference: "activeId", value: id })
@@ -131,6 +132,14 @@ const createScratchpadThunk = createAsyncThunk("scratchpad/create", async (args,
 const setScratchpadGateThunk = createAsyncThunk(
   "scratchpad/setGate",
   async ({ conversationId, enabled }, { dispatch, getState }) => {
+    if (enabled) {
+      try {
+        await dispatch(hydrateActiveScratchpadThunk()).unwrap();
+      } catch (err) {
+        toast.error("Couldn't load your scratchpad. Try turning it on again.");
+        throw err;
+      }
+    }
     if (enabled && !selectActiveScratchpadId(getState())) {
       await dispatch(createScratchpadThunk());
     }

package/dist/agents/redux/execution-system/thunks/launch-agent-execution.thunk.js

@@ -26,7 +26,7 @@ import { alwaysOnSurfaceKeys } from "../../../../surfaces/utils/always-on-contex
 import {
   fetchAgentRunTier
 } from "../../agent-definition/thunks.js";
-import { isSignedOutVisitor, NotAuthenticatedError, selectAccessToken } from "../../../../host/identity.js";
+import { isSignedOutVisitor, NotAuthenticatedError } from "../../../../host/identity.js";
 import { applyLaunchModelOverrides } from "../instance-model-overrides/launch-model-overrides.js";
 import { selectAgentRunTier, selectAgentById } from "../../agent-definition/selectors.js";
 import { getShortcutRecordFromState } from "../../agent-shortcuts/selectors.js";
@@ -80,11 +80,7 @@ import {
   resolveLaunchMappingLayers,
   resolvePerLaunchMappings
 } from "./surface-scope-mapping.js";
-import { ensureAgentCatalog } from "../../../identity/agent-identity.js";
 import { selectOrganizationId } from "../../../../host/org.js";
-function hasSignedInSession(state) {
-  return Boolean(selectAccessToken(state));
-}
 const INTERACTIVE_MODES = /* @__PURE__ */ new Set([
   "modal-full",
   "modal-compact",
@@ -217,9 +213,6 @@ const launchAgentExecution = createAsyncThunk("instances/launch", async (options
   let bindingAutoRun = resolvedMandate?.autoRun ?? null;
   let bindingAutoRunGap = [];
   if (agentId && !shortcutId) {
-    if (hasSignedInSession(getState())) {
-      void ensureAgentCatalog();
-    }
     const preState = getState();
     const payload = selectAgentRunTier(preState, agentId);
     const debugProjectCreate = isProjectCreateFlow(sourceFeature, agentId);

package/dist/agents/ui-first-tools/ui/lists/TaskPanelChip.js

@@ -15,6 +15,7 @@ import {
   unsubscribeAgentLists
 } from "../../redux/agent-lists.thunks.js";
 import { useConversationListsTab } from "./TaskPanel.js";
+import { selectIsDraftConversation } from "../../../redux/execution-system/conversations/conversations.selectors.js";
 function TaskPanelChip({
   conversationId,
   className
@@ -24,14 +25,15 @@ function TaskPanelChip({
   const hasContent = useAppSelector(selectHasAgentListsContent(conversationId));
   const taskCounts = useAppSelector(selectAgentTaskCounts(conversationId));
   const todoCounts = useAppSelector(selectUserTodoCounts(conversationId));
+  const isDraft = useAppSelector(selectIsDraftConversation(conversationId));
   useEffect(() => {
-    if (!conversationId) return void 0;
+    if (!conversationId || isDraft) return void 0;
     void dispatch(ensureAgentLists(conversationId));
     dispatch(subscribeAgentLists(conversationId));
     return () => {
       dispatch(unsubscribeAgentLists(conversationId));
     };
-  }, [conversationId, dispatch]);
+  }, [conversationId, isDraft, dispatch]);
   if (!hasContent) return null;
   return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(
     Chip,

package/dist/mandates/service.js

@@ -84,9 +84,24 @@ function mandateCacheKey(userId, organizationId, mandateKey) {
   return `${userId}:${organizationId}:${mandateKey}`;
 }
 function dropMandateCacheForOrgSwitch() {
-  cache.clear();
+  let current = null;
+  try {
+    current = peekSelectedOrganizationId() ?? null;
+  } catch {
+    current = null;
+  }
+  let dropped = false;
+  for (const [key, entry] of cache) {
+    if (current !== null && entry.value.organizationId === current) continue;
+    cache.delete(key);
+    dropped = true;
+  }
+  resolutionsInFlight.clear();
+  cacheGeneration += 1;
+  if (!dropped) return;
   for (const listener of invalidationListeners) listener(void 0);
 }
+let cacheGeneration = 0;
 const invalidationListeners = /* @__PURE__ */ new Set();
 function onMandateCacheInvalidated(listener) {
   invalidationListeners.add(listener);
@@ -94,6 +109,8 @@ function onMandateCacheInvalidated(listener) {
 }
 function invalidateMandateCache(mandateKey) {
   invalidateMandateCatalogueCache();
+  cacheGeneration += 1;
+  resolutionsInFlight.clear();
   if (mandateKey) {
     for (const key of cache.keys()) {
       if (key.endsWith(`:${mandateKey}`)) cache.delete(key);
@@ -153,7 +170,13 @@ async function selectedOrganizationFor(mandateKey) {
   }
   return organizationId;
 }
-async function fetchResolutionVerdict(mandateKey, options, cacheLookup) {
+async function fetchResolutionVerdict(mandateKey, options) {
+  const question = await resolutionQuestion(mandateKey, options);
+  const verdict = await askResolutionDoor(mandateKey, options, question.organizationId);
+  if (verdict === null) return null;
+  return { kind: "verdict", verdict, ...question };
+}
+async function resolutionQuestion(mandateKey, options) {
   const supabase = createClient();
   const { data: auth, error: authError } = await getClaimsUser(supabase);
   const userId = auth.user?.id;
@@ -161,26 +184,10 @@ async function fetchResolutionVerdict(mandateKey, options, cacheLookup) {
     throw new Error(`mandate resolution could not verify the session: ${authError.message}`);
   }
   if (!userId) {
-    const guestKey = `guest::${mandateKey}`;
-    const cachedGuest = cacheLookup?.(guestKey);
-    if (cachedGuest) return { kind: "cached", value: cachedGuest };
-    const guestVerdict = await askResolutionDoor(mandateKey, options, null);
-    if (guestVerdict === null) return null;
-    return {
-      kind: "verdict",
-      verdict: guestVerdict,
-      organizationId: null,
-      cacheKey: guestKey,
-      guest: true
-    };
+    return { organizationId: null, cacheKey: `guest::${mandateKey}`, guest: true };
   }
   const organizationId = options.organizationId ?? await selectedOrganizationFor(mandateKey);
-  const cacheKey = mandateCacheKey(userId, organizationId, mandateKey);
-  const cachedValue = cacheLookup?.(cacheKey);
-  if (cachedValue) return { kind: "cached", value: cachedValue };
-  const verdict = await askResolutionDoor(mandateKey, options, organizationId);
-  if (verdict === null) return null;
-  return { kind: "verdict", verdict, organizationId, cacheKey, guest: false };
+  return { organizationId, cacheKey: mandateCacheKey(userId, organizationId, mandateKey), guest: false };
 }
 async function askResolutionDoor(mandateKey, options, organizationId) {
   let verdict;
@@ -222,14 +229,25 @@ async function askResolutionDoor(mandateKey, options, organizationId) {
   return verdict;
 }
 async function resolveMandate(mandateKey, options = {}) {
-  const supabase = createClient();
-  const fetched = await fetchResolutionVerdict(mandateKey, options, (cacheKey2) => {
-    const cached = cache.get(cacheKey2);
-    return cached && Date.now() - cached.at < CACHE_TTL_MS ? cached.value : void 0;
+  const question = await resolutionQuestion(mandateKey, options);
+  const cached = cache.get(question.cacheKey);
+  if (cached && Date.now() - cached.at < CACHE_TTL_MS) return cached.value;
+  const flightKey = `${question.cacheKey}|${options.optional ? "optional" : "required"}`;
+  const pending = resolutionsInFlight.get(flightKey);
+  if (pending) return pending;
+  const run = resolveFromDoor(mandateKey, options, question).finally(() => {
+    if (resolutionsInFlight.get(flightKey) === run) resolutionsInFlight.delete(flightKey);
   });
-  if (fetched === null) return null;
-  if (fetched.kind === "cached") return fetched.value;
-  const { verdict, organizationId, cacheKey, guest } = fetched;
+  resolutionsInFlight.set(flightKey, run);
+  return run;
+}
+const resolutionsInFlight = /* @__PURE__ */ new Map();
+async function resolveFromDoor(mandateKey, options, question) {
+  const supabase = createClient();
+  const generation = cacheGeneration;
+  const verdict = await askResolutionDoor(mandateKey, options, question.organizationId);
+  if (verdict === null) return null;
+  const { organizationId, cacheKey, guest } = question;
   const holder = assertRunnableVerdict(mandateKey, verdict);
   const provenance = verdict.provenance;
   const holderType = verdict.holder_type ?? "agent";
@@ -260,7 +278,7 @@ async function resolveMandate(mandateKey, options = {}) {
       pinnedContext: [],
       presentation: null
     };
-    cache.set(cacheKey, { at: Date.now(), value: guestValue });
+    if (generation === cacheGeneration) cache.set(cacheKey, { at: Date.now(), value: guestValue });
     return guestValue;
   }
   const { data: mandate, error } = await mandateDefinitions(supabase).select("*").eq("mandate_key", mandateKey).is("deleted_at", null).maybeSingle();
@@ -319,15 +337,12 @@ async function resolveMandate(mandateKey, options = {}) {
     pinnedContext: wave1.pinnedContext,
     presentation
   };
-  cache.set(cacheKey, { at: Date.now(), value });
+  if (generation === cacheGeneration) cache.set(cacheKey, { at: Date.now(), value });
   return value;
 }
 async function resolveMandateHolder(mandateKey, options = {}) {
   const fetched = await fetchResolutionVerdict(mandateKey, options);
   if (fetched === null) return null;
-  if (fetched.kind === "cached") {
-    return null;
-  }
   const { verdict, organizationId } = fetched;
   const base = {
     mandateKey,

package/dist/next/navigation.js

@@ -1,6 +1,10 @@
 "use client";
+import { createElement } from "react";
 import NextLink from "next/link";
 import { usePathname, useRouter, useSearchParams } from "next/navigation";
+function ChatNextLink({ prefetch, ...props }) {
+  return createElement(NextLink, { ...props, prefetch: prefetch ?? false });
+}
 function useNextNavigation() {
   const router = useRouter();
   return {
@@ -10,7 +14,7 @@ function useNextNavigation() {
     useRouter,
     usePathname,
     useSearchParams,
-    Link: NextLink
+    Link: ChatNextLink
   };
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.7.17",
+  "version": "0.7.19",
   "description": "THE one AI Matrx person-to-agent chat system: the full chat (running agents, conversations, tool calls, streaming, context, surfaces, voice) as explicit per-module subpaths @ai-matrx/chat/<domain>/<module> (no wildcards: scripts/public-modules.json) over a host contract (/host, /host/react) whose only required value is a db. One chat, one renderer: the old kernel entries (., /external-store, /matrx, /react, /tools, styles.css, tokens.css) are retired.",
   "type": "module",
   "license": "MIT",
@@ -4681,25 +4681,25 @@
     "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/browser-audio": "latest",
-    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/content-ir": "latest",
     "@ai-matrx/canvas": "latest",
+    "@ai-matrx/browser-audio": "latest",
+    "@ai-matrx/content-ir-react": "latest",
     "@ai-matrx/data": "latest",
     "@ai-matrx/design-system": "latest",
     "@ai-matrx/diff": "latest",
     "@ai-matrx/icons": "latest",
     "@ai-matrx/kit": "latest",
-    "@ai-matrx/media": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
     "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
     "@ai-matrx/rich-content": "latest",
     "@ai-matrx/rich-editor": "latest",
-    "@ai-matrx/content-ir-react": "latest"
+    "@ai-matrx/media": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
@@ -4818,5 +4818,5 @@
     "check:side-effects": "node ../scripts/check-side-effects-listed.mjs . && node ../scripts/check-side-effects-listed.mjs --self-test",
     "check:public-surface": "node ./scripts/sync-public-surface.mjs --check && node ./scripts/sync-public-surface.mjs --self-test"
   },
-  "gitHead": "d9101c14c9a0338c4468cfd4c7d18aa5400a5762"
+  "gitHead": "e41d5e343fbfd45a4bac979f5b353b34d63d348b"
 }