@ai-matrx/chat 0.2.2 → 0.2.4

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @ai-matrx/chat
 
+## 0.2.4 — 2026-10-06
+
+- The Alchemy menu imports come from `@ai-matrx/alchemy/react/workspace` and transfer types from
+  `@ai-matrx/alchemy/operate` (ALC-16; design-system 0.69.0 removed `./content-transfer`).
+  `conversationJsonFormat` is the contract's lazy `FormatAdapter` (`load()` → `build(draft, options, signal)`).
+- `store/root-state.ts` `ChatHostReadSlices` drops its `[field: string]: unknown` index signatures, so a
+  host's concrete slice interfaces (matrx-frontend's `UserAuthState`, …) are assignable to the
+  package's emitted selector/thunk signatures (P27: ~490 of the 646 app errors against 0.2.3).
+- Consumer action: none.
+
+## 0.2.3
+### The frontend's last in-flight chat edit, carried at the P27 cutover
+
+- `run-headless-agent-json.ts`: an edit another lane had uncommitted in matrx-frontend's
+  `packages/chat` when that copy was deleted, carried here verbatim.
+- Consumer action: none.
+
 ## 0.2.2
 ### Last re-sync before matrx-frontend consumes the published package (P27)
 

package/dist/agent-copy/AlchemySurfaceBridge.js

@@ -4,7 +4,7 @@ import { useEffect, useId, useRef } from "react";
 import {
   createSurfaceTransferHandle
 } from "@ai-matrx/alchemy/operate";
-import { ContentTransferSurfaceProvider } from "@ai-matrx/design-system/content-transfer";
+import { ContentTransferSurfaceProvider } from "@ai-matrx/alchemy/react/workspace";
 import { getSurfaceManifest } from "../host/ui-slots.js";
 function useAlchemySurfaceHandle(surfaceName, getScope) {
   const instanceId = useId();

package/dist/agent-copy/alchemy-session.d.ts

@@ -1,5 +1,5 @@
-import type { FormatAdapter, Payload, Source } from "@ai-matrx/kit/content-transfer";
-import type { EnvelopeMeta, TransferMenuVariant } from "@ai-matrx/design-system/content-transfer";
+import type { FormatAdapter, Payload, Source } from "@ai-matrx/alchemy/operate";
+import type { EnvelopeMeta, TransferMenuVariant } from "@ai-matrx/alchemy/react/workspace";
 export type AlchemySessionIntent = 
 /**
  * The preparation workspace (trim, choose, AI preparation, destinations). `forDestination`: the

package/dist/agent-copy/page-capture/pageCapture.d.ts

@@ -15,7 +15,7 @@
  * network — the suite drives it directly.
  */
 import type { AgentPayloadInput } from "@ai-matrx/alchemy/operate";
-import type { AlchemyGroomerConfig } from "@ai-matrx/design-system/content-transfer";
+import type { AlchemyGroomerConfig } from "@ai-matrx/alchemy/react/workspace";
 export type PageCaptureKind = "table-page" | "record" | "dialog" | "admin-page";
 /** A chosen thing, by name and id. Either may be null (not chosen / not loaded). */
 export interface PageCaptureNamed {

package/dist/agents/conversation-export/conversation-transfer.d.ts

@@ -1,6 +1,6 @@
 import type { ConversationTransferRow } from "./conversation-transfer-rows.js";
 import type { Payload, Section, Source } from "@ai-matrx/alchemy/operate";
-import type { FormatAdapter } from "@ai-matrx/kit/content-transfer";
+import type { FormatAdapter } from "@ai-matrx/alchemy/operate";
 import type { ChatDispatch, ChatRootState } from "../../store/root-state.js";
 export interface ConversationMessageRow {
     role: "user" | "assistant";

package/dist/agents/conversation-export/conversation-transfer.js

@@ -100,8 +100,13 @@ function conversationJsonFormat(read) {
   return {
     id: "json",
     label: "JSON",
+    extension: "json",
+    mime: "application/json;charset=utf-8",
+    modes: ["copy", "download"],
+    runsOn: "client",
     supports: (payload) => payload.kind === "markdown" || payload.kind === "text",
-    build: async (draft, signal) => {
+    // The contract's lazy adapter (`@ai-matrx/alchemy/operate`): the engine is this closure.
+    load: async () => ({ build: async (draft, _options, signal) => {
       const c = await read();
       signal.throwIfAborted();
       const onlyCut = !draft.manuallyEdited && draft.provenance.every((p) => p.kind === "original" || p.kind === "deterministic") && draft.omissions.every((o) => o.reason === "excluded");
@@ -128,7 +133,7 @@ function conversationJsonFormat(read) {
         file: { filename: `${c.fileBase}.json`, mime: "application/json;charset=utf-8", bytes: new TextEncoder().encode(json) },
         omissions: draft.omissions.map((o) => ({ ...o }))
       });
-    }
+    } })
   };
 }
 function sourceOf(id, label, read) {

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

@@ -418,10 +418,8 @@ export declare function makeSelectAssembledRequest(conversationId: string): ((st
     resetResultsCount: () => void;
 } & {
     resultFunc: (resultFuncArgs_0: import("../conversations/conversations.slice.js").ConversationsState, resultFuncArgs_1: import("../instance-ui-state/instance-ui-state.slice.js").InstanceUIStateSlice, resultFuncArgs_2: import("../instance-user-input/instance-user-input.slice.js").InstanceUserInputSliceState, resultFuncArgs_3: import("../instance-resources/instance-resources.slice.js").InstanceResourcesState, resultFuncArgs_4: import("../instance-variable-values/instance-variable-values.slice.js").InstanceVariableValuesState, resultFuncArgs_5: import("../instance-model-overrides/instance-model-overrides.slice.js").InstanceModelOverridesState, resultFuncArgs_6: import("../instance-context/instance-context.slice.js").InstanceContextState, resultFuncArgs_7: import("../instance-client-tools/instance-client-tools.slice.js").InstanceClientToolsState, resultFuncArgs_8: {
-        [field: string]: unknown;
         organization_id?: string | null;
     } | undefined, resultFuncArgs_9: import("../../../../store/chat-host.slice.js").ChatHostState, resultFuncArgs_10: import("../../../types/agent-definition.types.js").AgentDefinitionSliceState, resultFuncArgs_11: import("../../../../surfaces/redux/userStateSlice.js").SurfaceUserStateSlice, resultFuncArgs_12: import("../messages/messages.slice.js").MessagesState, resultFuncArgs_13: {
-        [field: string]: unknown;
         id: string | null;
         email?: string | null;
         isAnonymous?: boolean;
@@ -430,20 +428,16 @@ export declare function makeSelectAssembledRequest(conversationId: string): ((st
         adminLaneOpen?: boolean;
         adminLevel?: string | null;
     } | undefined, resultFuncArgs_14: {
-        [field: string]: unknown;
         fingerprintId?: string | null;
         userMetadata?: {
             fullName?: string | null;
             name?: string | null;
             preferredUsername?: string | null;
-            [field: string]: unknown;
         } | null;
     } | undefined) => AssembledAgentStartRequest | null;
     memoizedResultFunc: ((resultFuncArgs_0: import("../conversations/conversations.slice.js").ConversationsState, resultFuncArgs_1: import("../instance-ui-state/instance-ui-state.slice.js").InstanceUIStateSlice, resultFuncArgs_2: import("../instance-user-input/instance-user-input.slice.js").InstanceUserInputSliceState, resultFuncArgs_3: import("../instance-resources/instance-resources.slice.js").InstanceResourcesState, resultFuncArgs_4: import("../instance-variable-values/instance-variable-values.slice.js").InstanceVariableValuesState, resultFuncArgs_5: import("../instance-model-overrides/instance-model-overrides.slice.js").InstanceModelOverridesState, resultFuncArgs_6: import("../instance-context/instance-context.slice.js").InstanceContextState, resultFuncArgs_7: import("../instance-client-tools/instance-client-tools.slice.js").InstanceClientToolsState, resultFuncArgs_8: {
-        [field: string]: unknown;
         organization_id?: string | null;
     } | undefined, resultFuncArgs_9: import("../../../../store/chat-host.slice.js").ChatHostState, resultFuncArgs_10: import("../../../types/agent-definition.types.js").AgentDefinitionSliceState, resultFuncArgs_11: import("../../../../surfaces/redux/userStateSlice.js").SurfaceUserStateSlice, resultFuncArgs_12: import("../messages/messages.slice.js").MessagesState, resultFuncArgs_13: {
-        [field: string]: unknown;
         id: string | null;
         email?: string | null;
         isAnonymous?: boolean;
@@ -452,13 +446,11 @@ export declare function makeSelectAssembledRequest(conversationId: string): ((st
         adminLaneOpen?: boolean;
         adminLevel?: string | null;
     } | undefined, resultFuncArgs_14: {
-        [field: string]: unknown;
         fingerprintId?: string | null;
         userMetadata?: {
             fullName?: string | null;
             name?: string | null;
             preferredUsername?: string | null;
-            [field: string]: unknown;
         } | null;
     } | undefined) => AssembledAgentStartRequest | null) & {
         clearCache: () => void;
@@ -467,10 +459,8 @@ export declare function makeSelectAssembledRequest(conversationId: string): ((st
     };
     lastResult: () => AssembledAgentStartRequest | null;
     dependencies: [(s: ChatRootState) => import("../conversations/conversations.slice.js").ConversationsState, (s: ChatRootState) => import("../instance-ui-state/instance-ui-state.slice.js").InstanceUIStateSlice, (s: ChatRootState) => import("../instance-user-input/instance-user-input.slice.js").InstanceUserInputSliceState, (s: ChatRootState) => import("../instance-resources/instance-resources.slice.js").InstanceResourcesState, (s: ChatRootState) => import("../instance-variable-values/instance-variable-values.slice.js").InstanceVariableValuesState, (s: ChatRootState) => import("../instance-model-overrides/instance-model-overrides.slice.js").InstanceModelOverridesState, (s: ChatRootState) => import("../instance-context/instance-context.slice.js").InstanceContextState, (s: ChatRootState) => import("../instance-client-tools/instance-client-tools.slice.js").InstanceClientToolsState, (s: ChatRootState) => {
-        [field: string]: unknown;
         organization_id?: string | null;
     } | undefined, (s: ChatRootState) => import("../../../../store/chat-host.slice.js").ChatHostState, (s: ChatRootState) => import("../../../types/agent-definition.types.js").AgentDefinitionSliceState, (s: ChatRootState) => import("../../../../surfaces/redux/userStateSlice.js").SurfaceUserStateSlice, (s: ChatRootState) => import("../messages/messages.slice.js").MessagesState, (s: ChatRootState) => {
-        [field: string]: unknown;
         id: string | null;
         email?: string | null;
         isAnonymous?: boolean;
@@ -479,13 +469,11 @@ export declare function makeSelectAssembledRequest(conversationId: string): ((st
         adminLaneOpen?: boolean;
         adminLevel?: string | null;
     } | undefined, (s: ChatRootState) => {
-        [field: string]: unknown;
         fingerprintId?: string | null;
         userMetadata?: {
             fullName?: string | null;
             name?: string | null;
             preferredUsername?: string | null;
-            [field: string]: unknown;
         } | null;
     } | undefined];
     recomputations: () => number;

package/dist/agents/redux/execution-system/thunks/run-headless-agent-json.d.ts

@@ -28,12 +28,21 @@
 import type { ChatDispatch, ChatRootState } from "../../../../store/root-state.js";
 import type { MessagePart } from "@ai-matrx/agents/generated/stream-events";
 import type { ContextAnchor, SourceFeature, RequestInitiation } from "../../../types/instance.types.js";
+import type { ApplicationScope } from "../../../types/scope.types.js";
 import type { AnyMandateKey } from "@ai-matrx/agents/mandates";
 export interface HeadlessAgentJsonOptions {
-    /** Exact agent to run. Mutually exclusive with mandateKey. */
+    /** Exact agent to run. Mutually exclusive with mandateKey and shortcutId. */
     agentId?: string;
     /** Swappable mandate to resolve inside the canonical launcher, preserving config_overrides. */
     mandateKey?: AnyMandateKey;
+    /**
+     * A saved shortcut to run: the launcher resolves its agent, config and scope
+     * mappings exactly as a menu click would. Mutually exclusive with agentId and
+     * mandateKey. Pair with `applicationScope` for the shortcut's mapped values.
+     */
+    shortcutId?: string;
+    /** UI-captured scope values a shortcut's scopeMappings read (selection, content, …). */
+    applicationScope?: ApplicationScope;
     /** Stable surface key for telemetry + the focus registry. */
     surfaceKey: string;
     /** UI feature that triggered the run. */

package/dist/agents/redux/execution-system/thunks/run-headless-agent-json.js

@@ -176,7 +176,7 @@ async function runHeadlessAgentJson(dispatch, getState, opts) {
     {
       onResult: opts.onResult,
       surfaceKey: opts.surfaceKey,
-      agentRef: opts.agentId ?? opts.mandateKey ?? "unknown"
+      agentRef: opts.agentId ?? opts.mandateKey ?? opts.shortcutId ?? "unknown"
     },
     result
   );
@@ -244,20 +244,20 @@ async function launchAndWait(dispatch, getState, opts) {
   };
   try {
     let executionIdentity;
+    const identities = [opts.agentId, opts.mandateKey, opts.shortcutId].filter((v) => v !== void 0);
+    if (identities.length !== 1) {
+      throw new Error("runHeadlessAgentJson requires exactly one of agentId, mandateKey or shortcutId");
+    }
     if (opts.mandateKey !== void 0) {
-      if (opts.agentId !== void 0) {
-        throw new Error("runHeadlessAgentJson accepts agentId or mandateKey, never both");
-      }
       executionIdentity = { mandateKey: opts.mandateKey };
+    } else if (opts.shortcutId !== void 0) {
+      executionIdentity = { shortcutId: opts.shortcutId };
     } else {
-      if (opts.agentId === void 0) {
-        throw new Error("runHeadlessAgentJson requires agentId or mandateKey");
-      }
       executionIdentity = { agentId: opts.agentId };
     }
     screamIfDeclaredFlattening(
       opts,
-      opts.agentId ?? opts.mandateKey ?? "unknown"
+      opts.agentId ?? opts.mandateKey ?? opts.shortcutId ?? "unknown"
     );
     const launch = await dispatch(
       launchAgentExecution({
@@ -282,7 +282,8 @@ async function launchAndWait(dispatch, getState, opts) {
         runtime: {
           ...opts.surfaceName !== void 0 ? { surfaceName: opts.surfaceName } : {},
           ...opts.variables ? { variables: opts.variables } : {},
-          ...opts.userInput !== void 0 ? { userInput: opts.userInput } : {}
+          ...opts.userInput !== void 0 ? { userInput: opts.userInput } : {},
+          ...opts.applicationScope ? { applicationScope: opts.applicationScope } : {}
         },
         // `callerExecutes` is the deliberate half of `autoRun: !twoStep`. A
         // headless launch normally IGNORES autoRun (no interface = nothing to
@@ -335,7 +336,7 @@ async function launchAndWait(dispatch, getState, opts) {
       pollMs,
       settleMs,
       surfaceKey: opts.surfaceKey,
-      agentRef: opts.agentId ?? opts.mandateKey ?? "unknown",
+      agentRef: opts.agentId ?? opts.mandateKey ?? opts.shortcutId ?? "unknown",
       msgs,
       expect: opts.expect ?? "json",
       ...opts.signal ? { signal: opts.signal } : {},
@@ -351,7 +352,7 @@ async function launchAndWait(dispatch, getState, opts) {
       conversationId: conversationId ?? void 0,
       raw: {
         surfaceKey: opts.surfaceKey,
-        agent: opts.agentId ?? opts.mandateKey ?? "unknown",
+        agent: opts.agentId ?? opts.mandateKey ?? opts.shortcutId ?? "unknown",
         detail,
         // Only when nothing readable came out: the raw shape, so a throw this
         // helper cannot read is a bug report rather than a shrug.

package/dist/store/hooks.d.ts

@@ -6,138 +6,6 @@ export declare const useChatSelector: UseSelector<ChatRootState>;
 export declare const useChatDispatch: UseDispatch<ChatDispatch>;
 /** The chat store itself (for `getState()` inside callbacks). */
 export declare const useChatStore: UseStore<ChatAppStore>;
-export declare const useAppSelector: UseSelector<{
-    voiceAgent: import("../voice-agent/types.js").VoiceAgentState;
-    agentDefinition: import("../agents/types/agent-definition.types.js").AgentDefinitionSliceState;
-    conversationList: import("../agents/redux/conversation-list/conversation-list.types.js").ConversationListState;
-    conversationHistory: import("../agents/redux/conversation-history/index.js").ConversationHistoryState;
-    agentShortcut: import("../agents/redux/agent-shortcuts/types.js").AgentShortcutSliceState;
-    agentShortcutCategory: import("../agents/redux/agent-shortcut-categories/types.js").AgentShortcutCategorySliceState;
-    surfaceUserState: import("../surfaces/redux/userStateSlice.js").SurfaceUserStateSlice;
-    tools: import("../agents/redux/tools/tools.slice.js").ToolsSliceState;
-    conversations: import("../agents/redux/execution-system/conversations/conversations.slice.js").ConversationsState;
-    chatIncognito: import("../agents/redux/chat/chat-incognito.slice.js").ChatIncognitoState;
-    chatRoute: import("../agents/redux/chat/chat-route.slice.js").ChatRouteState;
-    instanceModelOverrides: import("../agents/redux/execution-system/instance-model-overrides/instance-model-overrides.slice.js").InstanceModelOverridesState;
-    instanceInputCapabilities: import("../agents/redux/execution-system/instance-input-capabilities/instance-input-capabilities.slice.js").InstanceInputCapabilitiesState;
-    instanceVariableValues: import("../agents/redux/execution-system/instance-variable-values/instance-variable-values.slice.js").InstanceVariableValuesState;
-    instanceResources: import("../agents/redux/execution-system/instance-resources/instance-resources.slice.js").InstanceResourcesState;
-    instanceContext: import("../agents/redux/execution-system/instance-context/instance-context.slice.js").InstanceContextState;
-    instanceWorkingDocument: import("../agents/redux/execution-system/instance-working-document/instance-working-document.slice.js").InstanceWorkingDocumentSliceState;
-    instanceUserInput: import("../agents/redux/execution-system/instance-user-input/instance-user-input.slice.js").InstanceUserInputSliceState;
-    instanceClientTools: import("../agents/redux/execution-system/instance-client-tools/instance-client-tools.slice.js").InstanceClientToolsState;
-    pendingAsks: import("../agents/ui-first-tools/redux/pending-asks.slice.js").PendingAsksState;
-    conversationInbox: import("../agents/redux/execution-system/inbox/inbox.slice.js").ConversationInboxState;
-    agentLists: import("../agents/ui-first-tools/redux/agent-lists.slice.js").AgentListsState;
-    instanceUIState: import("../agents/redux/execution-system/instance-ui-state/instance-ui-state.slice.js").InstanceUIStateSlice;
-    activeTools: import("../agents/redux/execution-system/active-tools/active-tools.slice.js").ActiveToolsState;
-    activeRequests: import("../agents/redux/execution-system/active-requests/active-requests.slice.js").ActiveRequestsState;
-    runSets: import("../agents/redux/execution-system/run-sets/run-sets.slice.js").RunSetsState;
-    messages: import("../agents/redux/execution-system/messages/messages.slice.js").MessagesState;
-    observability: import("../agents/redux/execution-system/observability/observability.slice.js").ObservabilityState;
-    contextState: import("../agents/redux/execution-system/context-state/context-state.slice.js").ContextStateSliceState;
-    observationalMemory: import("../agents/redux/execution-system/observational-memory/observational-memory.slice.js").ObservationalMemoryState;
-    cacheBypass: import("../agents/redux/execution-system/message-crud/cache-bypass.slice.js").CacheBypassState;
-    conversationFocus: import("../agents/redux/execution-system/conversation-focus/conversation-focus.slice.js").ConversationFocusState;
-    surfaces: import("../agents/redux/surfaces/surfaces.slice.js").SurfacesState;
-    surfacesCatalog: import("../surfaces/redux/surfacesCatalogSlice.js").SurfacesCatalogSliceState;
-    agentSurfaceBindings: import("../surfaces/redux/agentSurfaceBindingsSlice.js").AgentSurfaceBindingsSliceState;
-    surfaceConfig: import("../surfaces/redux/surfaceConfigSlice.js").SurfaceConfigSliceState;
-    agentAssistantMarkdownDraft: import("../agents/redux/agent-assistant-markdown-draft.slice.js").AgentAssistantMarkdownDraftState;
-    mcp: import("../agents/redux/mcp/mcp.slice.js").McpSliceState;
-    proposedDirectives: import("../agents/redux/proposed-directives/proposedDirectivesSlice.js").ProposedDirectivesState;
-    agentSettings: import("../agents/redux/agent-settings/types.js").AgentSettingsState;
-    conversationAttachments: import("../agents/connectors/attachments.slice.js").AttachmentsSliceState;
-    modelRegistry: import("../agents/model-registry/modelRegistrySlice.js").ModelRegistryState;
-    chatHost: import("./chat-host.slice.js").ChatHostState;
-} & import("./root-state.js").ChatHostReadSlices>;
-export declare const useAppDispatch: UseDispatch<import("redux-thunk").ThunkDispatch<{
-    voiceAgent: import("../voice-agent/types.js").VoiceAgentState;
-    agentDefinition: import("../agents/types/agent-definition.types.js").AgentDefinitionSliceState;
-    conversationList: import("../agents/redux/conversation-list/conversation-list.types.js").ConversationListState;
-    conversationHistory: import("../agents/redux/conversation-history/index.js").ConversationHistoryState;
-    agentShortcut: import("../agents/redux/agent-shortcuts/types.js").AgentShortcutSliceState;
-    agentShortcutCategory: import("../agents/redux/agent-shortcut-categories/types.js").AgentShortcutCategorySliceState;
-    surfaceUserState: import("../surfaces/redux/userStateSlice.js").SurfaceUserStateSlice;
-    tools: import("../agents/redux/tools/tools.slice.js").ToolsSliceState;
-    conversations: import("../agents/redux/execution-system/conversations/conversations.slice.js").ConversationsState;
-    chatIncognito: import("../agents/redux/chat/chat-incognito.slice.js").ChatIncognitoState;
-    chatRoute: import("../agents/redux/chat/chat-route.slice.js").ChatRouteState;
-    instanceModelOverrides: import("../agents/redux/execution-system/instance-model-overrides/instance-model-overrides.slice.js").InstanceModelOverridesState;
-    instanceInputCapabilities: import("../agents/redux/execution-system/instance-input-capabilities/instance-input-capabilities.slice.js").InstanceInputCapabilitiesState;
-    instanceVariableValues: import("../agents/redux/execution-system/instance-variable-values/instance-variable-values.slice.js").InstanceVariableValuesState;
-    instanceResources: import("../agents/redux/execution-system/instance-resources/instance-resources.slice.js").InstanceResourcesState;
-    instanceContext: import("../agents/redux/execution-system/instance-context/instance-context.slice.js").InstanceContextState;
-    instanceWorkingDocument: import("../agents/redux/execution-system/instance-working-document/instance-working-document.slice.js").InstanceWorkingDocumentSliceState;
-    instanceUserInput: import("../agents/redux/execution-system/instance-user-input/instance-user-input.slice.js").InstanceUserInputSliceState;
-    instanceClientTools: import("../agents/redux/execution-system/instance-client-tools/instance-client-tools.slice.js").InstanceClientToolsState;
-    pendingAsks: import("../agents/ui-first-tools/redux/pending-asks.slice.js").PendingAsksState;
-    conversationInbox: import("../agents/redux/execution-system/inbox/inbox.slice.js").ConversationInboxState;
-    agentLists: import("../agents/ui-first-tools/redux/agent-lists.slice.js").AgentListsState;
-    instanceUIState: import("../agents/redux/execution-system/instance-ui-state/instance-ui-state.slice.js").InstanceUIStateSlice;
-    activeTools: import("../agents/redux/execution-system/active-tools/active-tools.slice.js").ActiveToolsState;
-    activeRequests: import("../agents/redux/execution-system/active-requests/active-requests.slice.js").ActiveRequestsState;
-    runSets: import("../agents/redux/execution-system/run-sets/run-sets.slice.js").RunSetsState;
-    messages: import("../agents/redux/execution-system/messages/messages.slice.js").MessagesState;
-    observability: import("../agents/redux/execution-system/observability/observability.slice.js").ObservabilityState;
-    contextState: import("../agents/redux/execution-system/context-state/context-state.slice.js").ContextStateSliceState;
-    observationalMemory: import("../agents/redux/execution-system/observational-memory/observational-memory.slice.js").ObservationalMemoryState;
-    cacheBypass: import("../agents/redux/execution-system/message-crud/cache-bypass.slice.js").CacheBypassState;
-    conversationFocus: import("../agents/redux/execution-system/conversation-focus/conversation-focus.slice.js").ConversationFocusState;
-    surfaces: import("../agents/redux/surfaces/surfaces.slice.js").SurfacesState;
-    surfacesCatalog: import("../surfaces/redux/surfacesCatalogSlice.js").SurfacesCatalogSliceState;
-    agentSurfaceBindings: import("../surfaces/redux/agentSurfaceBindingsSlice.js").AgentSurfaceBindingsSliceState;
-    surfaceConfig: import("../surfaces/redux/surfaceConfigSlice.js").SurfaceConfigSliceState;
-    agentAssistantMarkdownDraft: import("../agents/redux/agent-assistant-markdown-draft.slice.js").AgentAssistantMarkdownDraftState;
-    mcp: import("../agents/redux/mcp/mcp.slice.js").McpSliceState;
-    proposedDirectives: import("../agents/redux/proposed-directives/proposedDirectivesSlice.js").ProposedDirectivesState;
-    agentSettings: import("../agents/redux/agent-settings/types.js").AgentSettingsState;
-    conversationAttachments: import("../agents/connectors/attachments.slice.js").AttachmentsSliceState;
-    modelRegistry: import("../agents/model-registry/modelRegistrySlice.js").ModelRegistryState;
-    chatHost: import("./chat-host.slice.js").ChatHostState;
-} & import("./root-state.js").ChatHostReadSlices, unknown, import("redux").UnknownAction> & import("redux").Dispatch<import("redux").UnknownAction>>;
-export declare const useAppStore: UseStore<import("redux").Store<{
-    voiceAgent: import("../voice-agent/types.js").VoiceAgentState;
-    agentDefinition: import("../agents/types/agent-definition.types.js").AgentDefinitionSliceState;
-    conversationList: import("../agents/redux/conversation-list/conversation-list.types.js").ConversationListState;
-    conversationHistory: import("../agents/redux/conversation-history/index.js").ConversationHistoryState;
-    agentShortcut: import("../agents/redux/agent-shortcuts/types.js").AgentShortcutSliceState;
-    agentShortcutCategory: import("../agents/redux/agent-shortcut-categories/types.js").AgentShortcutCategorySliceState;
-    surfaceUserState: import("../surfaces/redux/userStateSlice.js").SurfaceUserStateSlice;
-    tools: import("../agents/redux/tools/tools.slice.js").ToolsSliceState;
-    conversations: import("../agents/redux/execution-system/conversations/conversations.slice.js").ConversationsState;
-    chatIncognito: import("../agents/redux/chat/chat-incognito.slice.js").ChatIncognitoState;
-    chatRoute: import("../agents/redux/chat/chat-route.slice.js").ChatRouteState;
-    instanceModelOverrides: import("../agents/redux/execution-system/instance-model-overrides/instance-model-overrides.slice.js").InstanceModelOverridesState;
-    instanceInputCapabilities: import("../agents/redux/execution-system/instance-input-capabilities/instance-input-capabilities.slice.js").InstanceInputCapabilitiesState;
-    instanceVariableValues: import("../agents/redux/execution-system/instance-variable-values/instance-variable-values.slice.js").InstanceVariableValuesState;
-    instanceResources: import("../agents/redux/execution-system/instance-resources/instance-resources.slice.js").InstanceResourcesState;
-    instanceContext: import("../agents/redux/execution-system/instance-context/instance-context.slice.js").InstanceContextState;
-    instanceWorkingDocument: import("../agents/redux/execution-system/instance-working-document/instance-working-document.slice.js").InstanceWorkingDocumentSliceState;
-    instanceUserInput: import("../agents/redux/execution-system/instance-user-input/instance-user-input.slice.js").InstanceUserInputSliceState;
-    instanceClientTools: import("../agents/redux/execution-system/instance-client-tools/instance-client-tools.slice.js").InstanceClientToolsState;
-    pendingAsks: import("../agents/ui-first-tools/redux/pending-asks.slice.js").PendingAsksState;
-    conversationInbox: import("../agents/redux/execution-system/inbox/inbox.slice.js").ConversationInboxState;
-    agentLists: import("../agents/ui-first-tools/redux/agent-lists.slice.js").AgentListsState;
-    instanceUIState: import("../agents/redux/execution-system/instance-ui-state/instance-ui-state.slice.js").InstanceUIStateSlice;
-    activeTools: import("../agents/redux/execution-system/active-tools/active-tools.slice.js").ActiveToolsState;
-    activeRequests: import("../agents/redux/execution-system/active-requests/active-requests.slice.js").ActiveRequestsState;
-    runSets: import("../agents/redux/execution-system/run-sets/run-sets.slice.js").RunSetsState;
-    messages: import("../agents/redux/execution-system/messages/messages.slice.js").MessagesState;
-    observability: import("../agents/redux/execution-system/observability/observability.slice.js").ObservabilityState;
-    contextState: import("../agents/redux/execution-system/context-state/context-state.slice.js").ContextStateSliceState;
-    observationalMemory: import("../agents/redux/execution-system/observational-memory/observational-memory.slice.js").ObservationalMemoryState;
-    cacheBypass: import("../agents/redux/execution-system/message-crud/cache-bypass.slice.js").CacheBypassState;
-    conversationFocus: import("../agents/redux/execution-system/conversation-focus/conversation-focus.slice.js").ConversationFocusState;
-    surfaces: import("../agents/redux/surfaces/surfaces.slice.js").SurfacesState;
-    surfacesCatalog: import("../surfaces/redux/surfacesCatalogSlice.js").SurfacesCatalogSliceState;
-    agentSurfaceBindings: import("../surfaces/redux/agentSurfaceBindingsSlice.js").AgentSurfaceBindingsSliceState;
-    surfaceConfig: import("../surfaces/redux/surfaceConfigSlice.js").SurfaceConfigSliceState;
-    agentAssistantMarkdownDraft: import("../agents/redux/agent-assistant-markdown-draft.slice.js").AgentAssistantMarkdownDraftState;
-    mcp: import("../agents/redux/mcp/mcp.slice.js").McpSliceState;
-    proposedDirectives: import("../agents/redux/proposed-directives/proposedDirectivesSlice.js").ProposedDirectivesState;
-    agentSettings: import("../agents/redux/agent-settings/types.js").AgentSettingsState;
-    conversationAttachments: import("../agents/connectors/attachments.slice.js").AttachmentsSliceState;
-    modelRegistry: import("../agents/model-registry/modelRegistrySlice.js").ModelRegistryState;
-    chatHost: import("./chat-host.slice.js").ChatHostState;
-} & import("./root-state.js").ChatHostReadSlices, import("redux").UnknownAction, unknown>>;
+export declare const useAppSelector: UseSelector<ChatRootState>;
+export declare const useAppDispatch: UseDispatch<ChatDispatch>;
+export declare const useAppStore: UseStore<ChatAppStore>;

package/dist/store/root-state.d.ts

@@ -6,7 +6,8 @@ export interface ChatStoreRegister {
 /**
  * Slices the HOST owns that package code reads when present (§2.3). A private store has none of
  * them, so every read is optional; a registered host store supplies the real shapes. Only the
- * fields the package reads are named — anything else stays `unknown`.
+ * fields the package reads are named, with no index signatures, so a host's concrete slice
+ * interfaces (which carry extra fields) stay assignable.
  */
 export interface ChatHostReadSlices {
     userAuth?: {
@@ -17,11 +18,9 @@ export interface ChatHostReadSlices {
         isAdmin?: boolean;
         adminLaneOpen?: boolean;
         adminLevel?: string | null;
-        [field: string]: unknown;
     };
     appContext?: {
         organization_id?: string | null;
-        [field: string]: unknown;
     };
     userProfile?: {
         fingerprintId?: string | null;
@@ -29,16 +28,12 @@ export interface ChatHostReadSlices {
             fullName?: string | null;
             name?: string | null;
             preferredUsername?: string | null;
-            [field: string]: unknown;
         } | null;
-        [field: string]: unknown;
     };
     cloudFiles?: {
         filesById: Record<string, {
             fileName?: string | null;
-            [field: string]: unknown;
         } | undefined>;
-        [field: string]: unknown;
     };
     transcriptStudio?: {
         byId?: Record<string, {
@@ -46,16 +41,12 @@ export interface ChatHostReadSlices {
             assistantConversationId?: string | null;
             assistantConversations?: readonly {
                 conversationId: string;
-                [field: string]: unknown;
             }[];
-            [field: string]: unknown;
         } | undefined>;
         documentsById?: Record<string, Record<string, {
             id?: string;
             content?: string | null;
-            [field: string]: unknown;
         } | undefined> | undefined>;
-        [field: string]: unknown;
     };
 }
 /** The full store state the package runs in: the host's when registered, else `ChatState` + optional host reads. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "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",
@@ -209,15 +209,15 @@
     "@ai-matrx/content-ir": "latest",
     "@ai-matrx/content-ir-react": "latest",
     "@ai-matrx/data": "latest",
+    "@ai-matrx/design-system": "latest",
     "@ai-matrx/icons": "latest",
+    "@ai-matrx/kit": "latest",
     "@ai-matrx/media": "latest",
-    "@ai-matrx/diff": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
-    "@ai-matrx/records": "latest",
+    "@ai-matrx/diff": "latest",
     "@ai-matrx/records-ui": "latest",
-    "@ai-matrx/kit": "latest",
-    "@ai-matrx/design-system": "latest",
+    "@ai-matrx/records": "latest",
     "@ai-matrx/tap-target": "latest"
   },
   "devDependencies": {