@dxos/plugin-assistant 0.13.0 → 0.14.0

package/dist/lib/chunk-ChatArticle.mjs

@@ -7,7 +7,8 @@ import * as Hooks from "@dxos/app-framework/Hooks";
 import { Obj } from "@dxos/echo";
 import { useObject } from "@dxos/echo-react";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { useChatProcessor, useChatServices, usePlatform, usePresets, useSelectionContext } from "#hooks";
+import { useChatModel, useChatServices, usePlatform, usePresets, useSelectionContext } from "#hooks";
+import { useIdentity } from "@dxos/halo-react";
 import { graphActions, isPromptAction } from "@dxos/react-ui-menu";
 import * as Layout from "@dxos/react-ui/Layout";
 import * as ToolkitHooks from "@dxos/app-toolkit/Hooks";
@@ -25,13 +26,19 @@ var ChatArticle = forwardRef(({ role, attendableId, nodeId, subject: chat, compa
 	const db = (chat && Obj.getDatabase(chat)) ?? (companionTo && Obj.getDatabase(companionTo));
 	const runtime = useChatServices({ id: db?.spaceId });
 	const { preset, ...chatProps } = usePresets(settings, chat);
-	const processor = useChatProcessor({
+	const identity = useIdentity();
+	const sender = useMemo(() => identity ? {
+		identityDid: identity.did,
+		...identity.displayName ? { name: identity.displayName } : {}
+	} : void 0, [identity?.did, identity?.displayName]);
+	const chatModel = useChatModel({
 		db,
 		chat,
 		preset,
 		runtime,
 		registry,
-		settings
+		settings,
+		sender
 	});
 	const getContext = useSelectionContext(companionTo);
 	const [chatViewType] = useObject(chat, "viewType");
@@ -48,7 +55,7 @@ var ChatArticle = forwardRef(({ role, attendableId, nodeId, subject: chat, compa
 		pendingSubmitted.current = false;
 	}, [attendableId]);
 	useEffect(() => {
-		if (!processor || !attendableId || pendingSubmitted.current) return;
+		if (!chatModel || !attendableId || pendingSubmitted.current) return;
 		const pendingPrompt = atomRegistry.get(stateAtom).pendingPrompts[attendableId];
 		if (pendingPrompt) {
 			pendingSubmitted.current = true;
@@ -59,10 +66,10 @@ var ChatArticle = forwardRef(({ role, attendableId, nodeId, subject: chat, compa
 					pendingPrompts: rest
 				};
 			});
-			processor.request({ message: pendingPrompt });
+			chatModel.request({ message: pendingPrompt });
 		}
 	}, [
-		processor,
+		chatModel,
 		attendableId,
 		atomRegistry,
 		stateAtom
@@ -70,7 +77,7 @@ var ChatArticle = forwardRef(({ role, attendableId, nodeId, subject: chat, compa
 	return /* @__PURE__ */ jsx(Chat.Root, {
 		chat,
 		db,
-		processor,
+		chatModel,
 		debug,
 		getContext,
 		onEvent,

package/dist/lib/chunk-ChatArticle.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"chunk-ChatArticle.mjs","names":[],"sources":["../../src/containers/ChatArticle/ChatArticle.tsx","../../src/containers/ChatArticle/index.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Atom from 'effect/reactivity/Atom';\nimport React, { forwardRef, useCallback, useEffect, useMemo, useRef } from 'react';\n\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Hooks from '@dxos/app-framework/Hooks';\nimport type * as AppSurface from '@dxos/app-toolkit/AppSurface';\nimport * as ToolkitHooks from '@dxos/app-toolkit/Hooks';\nimport type * as Chat from '@dxos/assistant/Chat';\nimport { Obj } from '@dxos/echo';\nimport { useObject } from '@dxos/echo-react';\nimport * as ClientOperation from '@dxos/plugin-client/ClientOperation';\nimport { useRegistry } from '@dxos/react-client/echo';\nimport { type ChatView } from '@dxos/react-ui-assistant';\nimport { graphActions, isPromptAction } from '@dxos/react-ui-menu';\nimport * as Layout from '@dxos/react-ui/Layout';\nimport * as Panel from '@dxos/react-ui/Panel';\nimport { Merge } from '@dxos/util';\n\nimport { Chat as ChatComponent, type ChatRootProps } from '#components';\nimport { useChatProcessor, useChatServices, usePlatform, usePresets, useSelectionContext } from '#hooks';\nimport { AssistantCapabilities } from '#types';\n\nexport type ChatArticleProps = Merge<\n  Omit<AppSurface.ObjectSectionProps<Chat.Chat>, 'subject'> & {\n    subject?: Chat.Chat;\n    companionTo?: Obj.Unknown;\n  },\n  Pick<ChatRootProps, 'debug' | 'onEvent' | 'onSubmit'>\n>;\n\nexport const ChatArticle = forwardRef<HTMLDivElement, ChatArticleProps>(\n  ({ role, attendableId, nodeId, subject: chat, companionTo, debug, onEvent, onSubmit }, forwardedRef) => {\n    const registry = useRegistry();\n    // The marker rail is a hover/precision target pinned to the thread's left edge, and the status\n    // pill floats over the last turn — on a phone the rail has nowhere to live outside the text and\n    // the pill covers the reply it reports on. Neither has a toggle to orphan; both are passive.\n    const mobile = usePlatform() === 'mobile';\n    const settings = Hooks.useAtomCapability(AssistantCapabilities.Settings);\n    const atomRegistry = Hooks.useCapability(Capabilities.AtomRegistry);\n    const stateAtom = Hooks.useCapability(AssistantCapabilities.State);\n    // Transient (pre-submit) chats have no database; fall back to the companion's.\n    const db = (chat && Obj.getDatabase(chat)) ?? (companionTo && Obj.getDatabase(companionTo));\n    const runtime = useChatServices({ id: db?.spaceId });\n\n    const { preset, ...chatProps } = usePresets(settings, chat);\n    const processor = useChatProcessor({ db, chat, preset, runtime, registry, settings });\n    const getContext = useSelectionContext(companionTo);\n\n    // Subscribe to the view type via `useObject` so the thread re-renders when ChatOptions changes it;\n    // a direct `chat.viewType` read in render does not establish a reactive dependency.\n    const [chatViewType] = useObject(chat, 'viewType');\n    const viewType = (chatViewType as ChatView | undefined) ?? settings.chatView;\n\n    const { invokePromise } = Hooks.useOperationInvoker();\n    const handleViewUsage = useCallback(() => {\n      void invokePromise(ClientOperation.OpenUsage, undefined);\n    }, [invokePromise]);\n\n    // Actions other plugins filed on this chat's node — the microphone among them — so a contributor\n    // reaches the prompt without plugin-assistant importing it (or knowing it exists).\n    //\n    // Sourced from this surface's own node rather than `attendableId`: a companion shares the host\n    // plank's attention id (`CompanionPlank`), so reading actions from it hands a chat attached to a\n    // document that document's toolbar — its comment action, and a second copy of its microphone\n    // keyed to the document. `nodeId` is the companion node itself, which is where a contributor\n    // matching on the chat files them; it falls back to the object for a surface rendered outside a\n    // plank. Filtered to the prompt surface for the same reason the id is: an action on the chat\n    // acts on the chat, and only some of those belong beside the text being composed.\n    const { graph } = ToolkitHooks.useAppGraph();\n    const actionNodeId = nodeId ?? (chat && Obj.getURI(chat));\n    const customActions = useMemo(\n      () => Atom.make((get) => graphActions(graph, get, actionNodeId, { filter: isPromptAction })),\n      [graph, actionNodeId],\n    );\n\n    // Reset the one-shot guard when the target conversation changes, so a pending prompt for a new\n    // `attendableId` is still auto-submitted within the same mount.\n    const pendingSubmitted = useRef(false);\n    useEffect(() => {\n      pendingSubmitted.current = false;\n    }, [attendableId]);\n\n    useEffect(() => {\n      if (!processor || !attendableId || pendingSubmitted.current) {\n        return;\n      }\n\n      const state = atomRegistry.get(stateAtom);\n      const pendingPrompt = state.pendingPrompts[attendableId];\n      if (pendingPrompt) {\n        pendingSubmitted.current = true;\n        atomRegistry.update(stateAtom, (current) => {\n          const { [attendableId]: _, ...rest } = current.pendingPrompts;\n          return { ...current, pendingPrompts: rest };\n        });\n\n        void processor.request({ message: pendingPrompt });\n      }\n    }, [processor, attendableId, atomRegistry, stateAtom]);\n\n    return (\n      <ChatComponent.Root\n        chat={chat}\n        db={db}\n        processor={processor}\n        debug={debug}\n        getContext={getContext}\n        onEvent={onEvent}\n        onSubmit={onSubmit}\n      >\n        <Panel.Root role={role} ref={forwardedRef}>\n          <Panel.Header>\n            <ChatComponent.Toolbar classNames='dx-document' attendableId={attendableId} companionTo={companionTo} />\n          </Panel.Header>\n          <Panel.Body asChild>\n            <ChatComponent.Content>\n              <Layout.Flex classNames='dx-expand relative'>\n                {/* Thread outline (Table of Contents). */}\n                {!mobile && <ChatComponent.Outline classNames='absolute left-0 top-1/2 -translate-y-1/2 z-10' />}\n\n                {/* Main thread. */}\n                <ChatComponent.Thread viewType={viewType} tailLines={4} onViewUsage={handleViewUsage} />\n\n                {/** Floating info. */}\n                {!mobile && (\n                  <Layout.Grid\n                    cols={['fill', 'auto']}\n                    gap='sm'\n                    classNames='absolute bottom-0 left-0 right-0 dx-document px-3 pb-2'\n                    data-testid='assistant.chat-status'\n                  >\n                    {/* Pinned to their columns: either renders nothing while idle, which would move the other over. */}\n                    <ChatComponent.Activity classNames='col-start-1 self-center' />\n                    <ChatComponent.Status classNames='col-start-2 justify-self-end bg-input-surface rounded-sm' />\n                  </Layout.Grid>\n                )}\n              </Layout.Flex>\n\n              <Layout.Flex column classNames='dx-document px-2 pb-2'>\n                {mobile && (\n                  <Layout.Grid cols={2}>\n                    <ChatComponent.Activity />\n                  </Layout.Grid>\n                )}\n\n                {/* Composer and checklist in one: `Chat.Prompt` owns the disclosure between them. */}\n                <ChatComponent.Prompt\n                  {...chatProps}\n                  outline\n                  autoFocus={!companionTo}\n                  attendableId={attendableId}\n                  companionTo={companionTo}\n                  customActions={customActions}\n                  nodeId={actionNodeId}\n                  preset={preset?.id}\n                />\n              </Layout.Flex>\n            </ChatComponent.Content>\n          </Panel.Body>\n        </Panel.Root>\n      </ChatComponent.Root>\n    );\n  },\n);\n\nChatArticle.displayName = 'ChatArticle';\n","//\n// Copyright 2025 DXOS.org\n//\n\nexport { ChatArticle as default } from './ChatArticle.tsx';\n"],"mappings":"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"}
+{"version":3,"file":"chunk-ChatArticle.mjs","names":[],"sources":["../../src/containers/ChatArticle/ChatArticle.tsx","../../src/containers/ChatArticle/index.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Atom from 'effect/reactivity/Atom';\nimport React, { forwardRef, useCallback, useEffect, useMemo, useRef } from 'react';\n\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Hooks from '@dxos/app-framework/Hooks';\nimport type * as AppSurface from '@dxos/app-toolkit/AppSurface';\nimport * as ToolkitHooks from '@dxos/app-toolkit/Hooks';\nimport type * as Chat from '@dxos/assistant/Chat';\nimport { Obj } from '@dxos/echo';\nimport { useObject } from '@dxos/echo-react';\nimport { useIdentity } from '@dxos/halo-react';\nimport * as ClientOperation from '@dxos/plugin-client/ClientOperation';\nimport { useRegistry } from '@dxos/react-client/echo';\nimport { type ChatView } from '@dxos/react-ui-assistant';\nimport { graphActions, isPromptAction } from '@dxos/react-ui-menu';\nimport * as Layout from '@dxos/react-ui/Layout';\nimport * as Panel from '@dxos/react-ui/Panel';\nimport { Merge } from '@dxos/util';\n\nimport { Chat as ChatComponent, type ChatRootProps } from '#components';\nimport { useChatModel, useChatServices, usePlatform, usePresets, useSelectionContext } from '#hooks';\nimport { AssistantCapabilities } from '#types';\n\nexport type ChatArticleProps = Merge<\n  Omit<AppSurface.ObjectSectionProps<Chat.Chat>, 'subject'> & {\n    subject?: Chat.Chat;\n    companionTo?: Obj.Unknown;\n  },\n  Pick<ChatRootProps, 'debug' | 'onEvent' | 'onSubmit'>\n>;\n\nexport const ChatArticle = forwardRef<HTMLDivElement, ChatArticleProps>(\n  ({ role, attendableId, nodeId, subject: chat, companionTo, debug, onEvent, onSubmit }, forwardedRef) => {\n    const registry = useRegistry();\n    // The marker rail is a hover/precision target pinned to the thread's left edge, and the status\n    // pill floats over the last turn — on a phone the rail has nowhere to live outside the text and\n    // the pill covers the reply it reports on. Neither has a toggle to orphan; both are passive.\n    const mobile = usePlatform() === 'mobile';\n    const settings = Hooks.useAtomCapability(AssistantCapabilities.Settings);\n    const atomRegistry = Hooks.useCapability(Capabilities.AtomRegistry);\n    const stateAtom = Hooks.useCapability(AssistantCapabilities.State);\n    // Transient (pre-submit) chats have no database; fall back to the companion's.\n    const db = (chat && Obj.getDatabase(chat)) ?? (companionTo && Obj.getDatabase(companionTo));\n    const runtime = useChatServices({ id: db?.spaceId });\n\n    const { preset, ...chatProps } = usePresets(settings, chat);\n    // Every prompt carries the member's DID, so what they say is attributed to them rather than to a name.\n    const identity = useIdentity();\n    const sender = useMemo(\n      () =>\n        identity\n          ? { identityDid: identity.did, ...(identity.displayName ? { name: identity.displayName } : {}) }\n          : undefined,\n      [identity?.did, identity?.displayName],\n    );\n    const chatModel = useChatModel({ db, chat, preset, runtime, registry, settings, sender });\n    const getContext = useSelectionContext(companionTo);\n\n    // Subscribe to the view type via `useObject` so the thread re-renders when ChatOptions changes it;\n    // a direct `chat.viewType` read in render does not establish a reactive dependency.\n    const [chatViewType] = useObject(chat, 'viewType');\n    const viewType = (chatViewType as ChatView | undefined) ?? settings.chatView;\n\n    const { invokePromise } = Hooks.useOperationInvoker();\n    const handleViewUsage = useCallback(() => {\n      void invokePromise(ClientOperation.OpenUsage, undefined);\n    }, [invokePromise]);\n\n    // Actions other plugins filed on this chat's node — the microphone among them — so a contributor\n    // reaches the prompt without plugin-assistant importing it (or knowing it exists).\n    //\n    // Sourced from this surface's own node rather than `attendableId`: a companion shares the host\n    // plank's attention id (`CompanionPlank`), so reading actions from it hands a chat attached to a\n    // document that document's toolbar — its comment action, and a second copy of its microphone\n    // keyed to the document. `nodeId` is the companion node itself, which is where a contributor\n    // matching on the chat files them; it falls back to the object for a surface rendered outside a\n    // plank. Filtered to the prompt surface for the same reason the id is: an action on the chat\n    // acts on the chat, and only some of those belong beside the text being composed.\n    const { graph } = ToolkitHooks.useAppGraph();\n    const actionNodeId = nodeId ?? (chat && Obj.getURI(chat));\n    const customActions = useMemo(\n      () => Atom.make((get) => graphActions(graph, get, actionNodeId, { filter: isPromptAction })),\n      [graph, actionNodeId],\n    );\n\n    // Reset the one-shot guard when the target conversation changes, so a pending prompt for a new\n    // `attendableId` is still auto-submitted within the same mount.\n    const pendingSubmitted = useRef(false);\n    useEffect(() => {\n      pendingSubmitted.current = false;\n    }, [attendableId]);\n\n    useEffect(() => {\n      if (!chatModel || !attendableId || pendingSubmitted.current) {\n        return;\n      }\n\n      const state = atomRegistry.get(stateAtom);\n      const pendingPrompt = state.pendingPrompts[attendableId];\n      if (pendingPrompt) {\n        pendingSubmitted.current = true;\n        atomRegistry.update(stateAtom, (current) => {\n          const { [attendableId]: _, ...rest } = current.pendingPrompts;\n          return { ...current, pendingPrompts: rest };\n        });\n\n        void chatModel.request({ message: pendingPrompt });\n      }\n    }, [chatModel, attendableId, atomRegistry, stateAtom]);\n\n    return (\n      <ChatComponent.Root\n        chat={chat}\n        db={db}\n        chatModel={chatModel}\n        debug={debug}\n        getContext={getContext}\n        onEvent={onEvent}\n        onSubmit={onSubmit}\n      >\n        <Panel.Root role={role} ref={forwardedRef}>\n          <Panel.Header>\n            <ChatComponent.Toolbar classNames='dx-document' attendableId={attendableId} companionTo={companionTo} />\n          </Panel.Header>\n          <Panel.Body asChild>\n            <ChatComponent.Content>\n              <Layout.Flex classNames='dx-expand relative'>\n                {/* Thread outline (Table of Contents). */}\n                {!mobile && <ChatComponent.Outline classNames='absolute left-0 top-1/2 -translate-y-1/2 z-10' />}\n\n                {/* Main thread. */}\n                <ChatComponent.Thread viewType={viewType} tailLines={4} onViewUsage={handleViewUsage} />\n\n                {/** Floating info. */}\n                {!mobile && (\n                  <Layout.Grid\n                    cols={['fill', 'auto']}\n                    gap='sm'\n                    classNames='absolute bottom-0 left-0 right-0 dx-document px-3 pb-2'\n                    data-testid='assistant.chat-status'\n                  >\n                    {/* Pinned to their columns: either renders nothing while idle, which would move the other over. */}\n                    <ChatComponent.Activity classNames='col-start-1 self-center' />\n                    <ChatComponent.Status classNames='col-start-2 justify-self-end bg-input-surface rounded-sm' />\n                  </Layout.Grid>\n                )}\n              </Layout.Flex>\n\n              <Layout.Flex column classNames='dx-document px-2 pb-2'>\n                {mobile && (\n                  <Layout.Grid cols={2}>\n                    <ChatComponent.Activity />\n                  </Layout.Grid>\n                )}\n\n                {/* Composer and checklist in one: `Chat.Prompt` owns the disclosure between them. */}\n                <ChatComponent.Prompt\n                  {...chatProps}\n                  outline\n                  autoFocus={!companionTo}\n                  attendableId={attendableId}\n                  companionTo={companionTo}\n                  customActions={customActions}\n                  nodeId={actionNodeId}\n                  preset={preset?.id}\n                />\n              </Layout.Flex>\n            </ChatComponent.Content>\n          </Panel.Body>\n        </Panel.Root>\n      </ChatComponent.Root>\n    );\n  },\n);\n\nChatArticle.displayName = 'ChatArticle';\n","//\n// Copyright 2025 DXOS.org\n//\n\nexport { ChatArticle as default } from './ChatArticle.tsx';\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmCA,IAAa,cAAc,YACxB,EAAE,MAAM,cAAc,QAAQ,SAAS,MAAM,aAAa,OAAO,SAAS,YAAY,iBAAiB;CACtG,MAAM,WAAW,YAAY;CAI7B,MAAM,SAAS,YAAY,MAAM;CACjC,MAAM,WAAW,MAAM,kBAAkB,sBAAsB,QAAQ;CACvE,MAAM,eAAe,MAAM,cAAc,aAAa,YAAY;CAClE,MAAM,YAAY,MAAM,cAAc,sBAAsB,KAAK;CAEjE,MAAM,MAAM,QAAQ,IAAI,YAAY,IAAI,OAAO,eAAe,IAAI,YAAY,WAAW;CACzF,MAAM,UAAU,gBAAgB,EAAE,IAAI,IAAI,QAAQ,CAAC;CAEnD,MAAM,EAAE,QAAQ,GAAG,cAAc,WAAW,UAAU,IAAI;CAE1D,MAAM,WAAW,YAAY;CAC7B,MAAM,SAAS,cAEX,WACI;EAAE,aAAa,SAAS;EAAK,GAAI,SAAS,cAAc,EAAE,MAAM,SAAS,YAAY,IAAI,CAAC;CAAG,IAC7F,KAAA,GACN,CAAC,UAAU,KAAK,UAAU,WAAW,CACvC;CACA,MAAM,YAAY,aAAa;EAAE;EAAI;EAAM;EAAQ;EAAS;EAAU;EAAU;CAAO,CAAC;CACxF,MAAM,aAAa,oBAAoB,WAAW;CAIlD,MAAM,CAAC,gBAAgB,UAAU,MAAM,UAAU;CACjD,MAAM,WAAY,gBAAyC,SAAS;CAEpE,MAAM,EAAE,kBAAkB,MAAM,oBAAoB;CACpD,MAAM,kBAAkB,kBAAkB;EACxC,cAAmB,gBAAgB,WAAW,KAAA,CAAS;CACzD,GAAG,CAAC,aAAa,CAAC;CAYlB,MAAM,EAAE,UAAU,aAAa,YAAY;CAC3C,MAAM,eAAe,WAAW,QAAQ,IAAI,OAAO,IAAI;CACvD,MAAM,gBAAgB,cACd,KAAK,MAAM,QAAQ,aAAa,OAAO,KAAK,cAAc,EAAE,QAAQ,eAAe,CAAC,CAAC,GAC3F,CAAC,OAAO,YAAY,CACtB;CAIA,MAAM,mBAAmB,OAAO,KAAK;CACrC,gBAAgB;EACd,iBAAiB,UAAU;CAC7B,GAAG,CAAC,YAAY,CAAC;CAEjB,gBAAgB;EACd,IAAI,CAAC,aAAa,CAAC,gBAAgB,iBAAiB,SAClD;EAIF,MAAM,gBADQ,aAAa,IAAI,SACT,CAAA,CAAM,eAAe;EAC3C,IAAI,eAAe;GACjB,iBAAiB,UAAU;GAC3B,aAAa,OAAO,YAAY,YAAY;IAC1C,MAAM,GAAG,eAAe,GAAG,GAAG,SAAS,QAAQ;IAC/C,OAAO;KAAE,GAAG;KAAS,gBAAgB;IAAK;GAC5C,CAAC;GAED,UAAe,QAAQ,EAAE,SAAS,cAAc,CAAC;EACnD;CACF,GAAG;EAAC;EAAW;EAAc;EAAc;CAAS,CAAC;CAErD,OACE,oBAAC,KAAc,MAAf;EACQ;EACF;EACO;EACJ;EACK;EACH;EACC;EAEV,UAAA,qBAAC,MAAM,MAAP;GAAkB;GAAM,KAAK;GAA7B,UAAA,CACE,oBAAC,MAAM,QAAP,EAAA,UACE,oBAAC,KAAc,SAAf;IAAuB,YAAW;IAA4B;IAA2B;GAAc,CAAA,EAC3F,CAAA,GACd,oBAAC,MAAM,MAAP;IAAY,SAAA;IACV,UAAA,qBAAC,KAAc,SAAf,EAAA,UAAA,CACE,qBAAC,OAAO,MAAR;KAAa,YAAW;KAAxB,UAAA;MAEG,CAAC,UAAU,oBAAC,KAAc,SAAf,EAAuB,YAAW,gDAAiD,CAAA;MAG/F,oBAAC,KAAc,QAAf;OAAgC;OAAU,WAAW;OAAG,aAAa;MAAkB,CAAA;MAGtF,CAAC,UACA,qBAAC,OAAO,MAAR;OACE,MAAM,CAAC,QAAQ,MAAM;OACrB,KAAI;OACJ,YAAW;OACX,eAAY;OAJd,UAAA,CAOE,oBAAC,KAAc,UAAf,EAAwB,YAAW,0BAA2B,CAAA,GAC9D,oBAAC,KAAc,QAAf,EAAsB,YAAW,2DAA4D,CAAA,CAClF;;KAEJ;IAEb,CAAA,GAAA,qBAAC,OAAO,MAAR;KAAa,QAAA;KAAO,YAAW;KAA/B,UAAA,CACG,UACC,oBAAC,OAAO,MAAR;MAAa,MAAM;MACjB,UAAA,oBAAC,KAAc,UAAf,CAAyB,CAAA;KACd,CAAA,GAIf,oBAAC,KAAc,QAAf;MACE,GAAI;MACJ,SAAA;MACA,WAAW,CAAC;MACE;MACD;MACE;MACf,QAAQ;MACR,QAAQ,QAAQ;KACjB,CAAA,CACU;IACQ,CAAA,CAAA,EAAA,CAAA;GACb,CAAA,CACF;;CACM,CAAA;AAExB,CACF;AAEA,YAAY,cAAc"}

package/dist/lib/chunk-ChatDialog.mjs

@@ -5,7 +5,7 @@ import * as Hooks from "@dxos/app-framework/Hooks";
 import { Obj } from "@dxos/echo";
 import { useObject } from "@dxos/echo-react";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { useChatProcessor, useChatServices, usePresets } from "#hooks";
+import { useChatModel, useChatServices, usePresets } from "#hooks";
 import * as UiHooks from "@dxos/react-ui/Hooks";
 import { ChatDialog as ChatDialog$1 } from "@dxos/react-ui-chat";
 import { Chat } from "#components";
@@ -18,7 +18,8 @@ var ChatDialog = ({ chat }) => {
 	const runtime = useChatServices({ id: db?.spaceId });
 	const { preset, ...chatProps } = usePresets(settings, chat);
 	const registry = useRegistry();
-	const processor = useChatProcessor({
+	const chatModel = useChatModel({
+		db,
 		chat,
 		preset,
 		runtime,
@@ -38,10 +39,10 @@ var ChatDialog = ({ chat }) => {
 			case "thread-close": setOpen(false);
 		}
 	}, []);
-	if (!chat || !processor) return null;
+	if (!chat || !chatModel) return null;
 	return /* @__PURE__ */ jsx(Chat.Root, {
 		chat,
-		processor,
+		chatModel,
 		onEvent: handleEvent,
 		children: /* @__PURE__ */ jsxs(ChatDialog$1.Root, {
 			open,

package/dist/lib/chunk-ChatDialog.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"chunk-ChatDialog.mjs","names":[],"sources":["../../src/containers/ChatDialog/ChatDialog.tsx"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport React, { useCallback, useState } from 'react';\n\nimport * as Hooks from '@dxos/app-framework/Hooks';\nimport type * as AssistantChat from '@dxos/assistant/Chat';\nimport { Obj } from '@dxos/echo';\nimport { useObject } from '@dxos/echo-react';\nimport { useRegistry } from '@dxos/react-client/echo';\nimport { type ChatView } from '@dxos/react-ui-assistant';\nimport { ChatDialog as NaturalChatDialog } from '@dxos/react-ui-chat';\nimport * as UiHooks from '@dxos/react-ui/Hooks';\n\nimport { Chat, type ChatRootProps } from '#components';\nimport { useChatProcessor, useChatServices, usePresets } from '#hooks';\nimport { meta } from '#meta';\nimport { AssistantCapabilities } from '#types';\n\nexport type ChatDialogProps = {\n  chat?: AssistantChat.Chat;\n};\n\nexport const ChatDialog = ({ chat }: ChatDialogProps) => {\n  const { t } = UiHooks.useTranslation(meta.profile.key);\n\n  const db = chat && Obj.getDatabase(chat);\n  const settings = Hooks.useAtomCapability(AssistantCapabilities.Settings);\n  const runtime = useChatServices({ id: db?.spaceId });\n  const { preset, ...chatProps } = usePresets(settings, chat);\n  const registry = useRegistry();\n  const processor = useChatProcessor({ chat, preset, runtime, registry, settings });\n  // Subscribe via `useObject` so the thread re-renders when ChatOptions changes the view type.\n  const [chatViewType] = useObject(chat, 'viewType');\n\n  // TODO(burdon): Refocus when open.\n  const [open, setOpen] = useState(true);\n  const [expanded, setExpanded] = useState(false);\n  const handleEvent = useCallback<NonNullable<ChatRootProps['onEvent']>>((event) => {\n    switch (event.type) {\n      case 'submit':\n      case 'thread-open':\n        setOpen(true);\n        setExpanded(true);\n        break;\n      case 'thread-close':\n        setOpen(false);\n        break;\n    }\n  }, []);\n\n  if (!chat || !processor) {\n    return null;\n  }\n\n  return (\n    <Chat.Root chat={chat} processor={processor} onEvent={handleEvent}>\n      <NaturalChatDialog.Root open={open} expanded={expanded} onOpenChange={setOpen}>\n        <NaturalChatDialog.Header title={t('assistant-dialog.title')} />\n        <NaturalChatDialog.Content>\n          <Chat.Thread viewType={(chatViewType as ChatView | undefined) ?? settings.chatView} />\n        </NaturalChatDialog.Content>\n        <NaturalChatDialog.Footer classNames='p-1.5'>\n          {/* What the request is doing before the first token arrives. */}\n          <Chat.Activity />\n          {/* Queued prompts the agent has not taken up yet, stacked right above the composer. */}\n          <Chat.Prompt {...chatProps} preset={preset?.id} expandable />\n        </NaturalChatDialog.Footer>\n      </NaturalChatDialog.Root>\n    </Chat.Root>\n  );\n};\n\nChatDialog.displayName = 'ChatDialog';\n"],"mappings":";;;;;;;;;;;;;AAwBA,IAAa,cAAc,EAAE,WAA4B;CACvD,MAAM,EAAE,MAAM,QAAQ,eAAe,KAAK,QAAQ,GAAG;CAErD,MAAM,KAAK,QAAQ,IAAI,YAAY,IAAI;CACvC,MAAM,WAAW,MAAM,kBAAkB,sBAAsB,QAAQ;CACvE,MAAM,UAAU,gBAAgB,EAAE,IAAI,IAAI,QAAQ,CAAC;CACnD,MAAM,EAAE,QAAQ,GAAG,cAAc,WAAW,UAAU,IAAI;CAC1D,MAAM,WAAW,YAAY;CAC7B,MAAM,YAAY,iBAAiB;EAAE;EAAM;EAAQ;EAAS;EAAU;CAAS,CAAC;CAEhF,MAAM,CAAC,gBAAgB,UAAU,MAAM,UAAU;CAGjD,MAAM,CAAC,MAAM,WAAW,SAAS,IAAI;CACrC,MAAM,CAAC,UAAU,eAAe,SAAS,KAAK;CAC9C,MAAM,cAAc,aAAoD,UAAU;EAChF,QAAQ,MAAM,MAAd;GACE,KAAK;GACL,KAAK;IACH,QAAQ,IAAI;IACZ,YAAY,IAAI;IAChB;GACF,KAAK,gBACH,QAAQ,KAAK;EAEjB;CACF,GAAG,CAAC,CAAC;CAEL,IAAI,CAAC,QAAQ,CAAC,WACZ,OAAO;CAGT,OACE,oBAAC,KAAK,MAAN;EAAiB;EAAiB;EAAW,SAAS;EACpD,UAAA,qBAAC,aAAkB,MAAnB;GAA8B;GAAgB;GAAU,cAAc;GAAtE,UAAA;IACE,oBAAC,aAAkB,QAAnB,EAA0B,OAAO,EAAE,wBAAwB,EAAI,CAAA;IAC/D,oBAAC,aAAkB,SAAnB,EAAA,UACE,oBAAC,KAAK,QAAN,EAAa,UAAW,gBAAyC,SAAS,SAAW,CAAA,EAC5D,CAAA;IAC3B,qBAAC,aAAkB,QAAnB;KAA0B,YAAW;KAArC,UAAA,CAEE,oBAAC,KAAK,UAAN,CAAgB,CAAA,GAEhB,oBAAC,KAAK,QAAN;MAAa,GAAI;MAAW,QAAQ,QAAQ;MAAI,YAAA;KAAY,CAAA,CACpC;;GACJ;;CACf,CAAA;AAEf;AAEA,WAAW,cAAc"}
+{"version":3,"file":"chunk-ChatDialog.mjs","names":[],"sources":["../../src/containers/ChatDialog/ChatDialog.tsx"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport React, { useCallback, useState } from 'react';\n\nimport * as Hooks from '@dxos/app-framework/Hooks';\nimport type * as AssistantChat from '@dxos/assistant/Chat';\nimport { Obj } from '@dxos/echo';\nimport { useObject } from '@dxos/echo-react';\nimport { useRegistry } from '@dxos/react-client/echo';\nimport { type ChatView } from '@dxos/react-ui-assistant';\nimport { ChatDialog as NaturalChatDialog } from '@dxos/react-ui-chat';\nimport * as UiHooks from '@dxos/react-ui/Hooks';\n\nimport { Chat, type ChatRootProps } from '#components';\nimport { useChatModel, useChatServices, usePresets } from '#hooks';\nimport { meta } from '#meta';\nimport { AssistantCapabilities } from '#types';\n\nexport type ChatDialogProps = {\n  chat?: AssistantChat.Chat;\n};\n\nexport const ChatDialog = ({ chat }: ChatDialogProps) => {\n  const { t } = UiHooks.useTranslation(meta.profile.key);\n\n  const db = chat && Obj.getDatabase(chat);\n  const settings = Hooks.useAtomCapability(AssistantCapabilities.Settings);\n  const runtime = useChatServices({ id: db?.spaceId });\n  const { preset, ...chatProps } = usePresets(settings, chat);\n  const registry = useRegistry();\n  const chatModel = useChatModel({ db, chat, preset, runtime, registry, settings });\n  // Subscribe via `useObject` so the thread re-renders when ChatOptions changes the view type.\n  const [chatViewType] = useObject(chat, 'viewType');\n\n  // TODO(burdon): Refocus when open.\n  const [open, setOpen] = useState(true);\n  const [expanded, setExpanded] = useState(false);\n  const handleEvent = useCallback<NonNullable<ChatRootProps['onEvent']>>((event) => {\n    switch (event.type) {\n      case 'submit':\n      case 'thread-open':\n        setOpen(true);\n        setExpanded(true);\n        break;\n      case 'thread-close':\n        setOpen(false);\n        break;\n    }\n  }, []);\n\n  if (!chat || !chatModel) {\n    return null;\n  }\n\n  return (\n    <Chat.Root chat={chat} chatModel={chatModel} onEvent={handleEvent}>\n      <NaturalChatDialog.Root open={open} expanded={expanded} onOpenChange={setOpen}>\n        <NaturalChatDialog.Header title={t('assistant-dialog.title')} />\n        <NaturalChatDialog.Content>\n          <Chat.Thread viewType={(chatViewType as ChatView | undefined) ?? settings.chatView} />\n        </NaturalChatDialog.Content>\n        <NaturalChatDialog.Footer classNames='p-1.5'>\n          {/* What the request is doing before the first token arrives. */}\n          <Chat.Activity />\n          {/* Queued prompts the agent has not taken up yet, stacked right above the composer. */}\n          <Chat.Prompt {...chatProps} preset={preset?.id} expandable />\n        </NaturalChatDialog.Footer>\n      </NaturalChatDialog.Root>\n    </Chat.Root>\n  );\n};\n\nChatDialog.displayName = 'ChatDialog';\n"],"mappings":";;;;;;;;;;;;;AAwBA,IAAa,cAAc,EAAE,WAA4B;CACvD,MAAM,EAAE,MAAM,QAAQ,eAAe,KAAK,QAAQ,GAAG;CAErD,MAAM,KAAK,QAAQ,IAAI,YAAY,IAAI;CACvC,MAAM,WAAW,MAAM,kBAAkB,sBAAsB,QAAQ;CACvE,MAAM,UAAU,gBAAgB,EAAE,IAAI,IAAI,QAAQ,CAAC;CACnD,MAAM,EAAE,QAAQ,GAAG,cAAc,WAAW,UAAU,IAAI;CAC1D,MAAM,WAAW,YAAY;CAC7B,MAAM,YAAY,aAAa;EAAE;EAAI;EAAM;EAAQ;EAAS;EAAU;CAAS,CAAC;CAEhF,MAAM,CAAC,gBAAgB,UAAU,MAAM,UAAU;CAGjD,MAAM,CAAC,MAAM,WAAW,SAAS,IAAI;CACrC,MAAM,CAAC,UAAU,eAAe,SAAS,KAAK;CAC9C,MAAM,cAAc,aAAoD,UAAU;EAChF,QAAQ,MAAM,MAAd;GACE,KAAK;GACL,KAAK;IACH,QAAQ,IAAI;IACZ,YAAY,IAAI;IAChB;GACF,KAAK,gBACH,QAAQ,KAAK;EAEjB;CACF,GAAG,CAAC,CAAC;CAEL,IAAI,CAAC,QAAQ,CAAC,WACZ,OAAO;CAGT,OACE,oBAAC,KAAK,MAAN;EAAiB;EAAiB;EAAW,SAAS;EACpD,UAAA,qBAAC,aAAkB,MAAnB;GAA8B;GAAgB;GAAU,cAAc;GAAtE,UAAA;IACE,oBAAC,aAAkB,QAAnB,EAA0B,OAAO,EAAE,wBAAwB,EAAI,CAAA;IAC/D,oBAAC,aAAkB,SAAnB,EAAA,UACE,oBAAC,KAAK,QAAN,EAAa,UAAW,gBAAyC,SAAS,SAAW,CAAA,EAC5D,CAAA;IAC3B,qBAAC,aAAkB,QAAnB;KAA0B,YAAW;KAArC,UAAA,CAEE,oBAAC,KAAK,UAAN,CAAgB,CAAA,GAEhB,oBAAC,KAAK,QAAN;MAAa,GAAI;MAAW,QAAQ,QAAQ;MAAI,YAAA;KAAY,CAAA,CACpC;;GACJ;;CACf,CAAA;AAEf;AAEA,WAAW,cAAc"}

package/dist/lib/chunk-IntegrationPrompt.mjs

@@ -7,8 +7,8 @@ import { Filter } from "@dxos/echo";
 import { useQuery } from "@dxos/echo-react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import * as UiHooks from "@dxos/react-ui/Hooks";
-import { Connection } from "@dxos/link";
 import * as Layout from "@dxos/react-ui/Layout";
+import { Connection } from "@dxos/link";
 import * as Icon from "@dxos/react-ui/Icon";
 import * as ToolkitHooks from "@dxos/app-toolkit/Hooks";
 import { ConnectorAuthMenu } from "#components";

package/dist/lib/chunk-PLUGIN.mjs

@@ -1,5 +1,5 @@
 //#region PLUGIN.mdl?raw
-var PLUGIN_default = "---\nid: org.dxos.plugin.assistant\nname: AssistantPlugin\nversion: 0.1.0\n---\n\nAn AI assistant plugin for DXOS Composer that provides conversational AI, skill-driven automation,\nmulti-provider LLM support, and deep ECHO integration.\n\n## Extensions\n\nThe following extension dialects are used in this document.\nEach extension is defined in the Appendix or resolved via its URI.\n\n| Term        | URI                           |\n|-------------|-------------------------------|\n| `type`      | `org.dxos.mdl.type@1.0`      |\n| `feat`      | `org.dxos.mdl.feat@1.0`      |\n| `scenario`  | `org.dxos.mdl.scenario@1.0`  |\n| `component` | `org.dxos.mdl.component@1.0` |\n| `op`        | `org.dxos.mdl.op@1.1`        |\n| `test`      | `org.dxos.mdl.test@1.0`      |\n\n## Types\n\n```mdl\ntype ModelProvider\n  literals: edge | ollama | lmstudio\n```\n\n```mdl\ntype ChatView\n  literals: normal | summary | thinking | debug\n```\n\n```mdl\ntype ModelDefaults\n  fields:\n    edge?: string\n    ollama?: string\n    lmstudio?: string\n```\n\n```mdl\ntype Settings\n  fields:\n    customPrompts?: boolean\n    chatView?: ChatView\n    modelProvider?: ModelProvider\n    modelDefaults?: ModelDefaults\n    codeMode?: boolean\n    tracePanelDebug?: boolean\n```\n\n```mdl\ntype Chat\n  fields:\n    id: string\n    name?: string\n    messages: Message[]\n```\n\n```mdl\ntype Message\n  fields:\n    id: string\n    role: user | assistant | system\n    content: string\n    timestamp: string\n```\n\n```mdl\ntype SkillForm\n  fields:\n    key: string\n    name: string\n    description?: string\n```\n\n## Components\n\n```mdl\ncomponent ChatPanel\n  desc: Main conversational interface for interacting with the AI assistant.\n  props:\n    chat: Chat\n    companionTo?: Obj\n  state:\n    messages: Message[]\n    pending: boolean\n    view: ChatView\n  slots:\n    toolbar?: ReactNode\n    empty?: ReactNode\n  actions:\n    sendMessage(content: string)\n    clearHistory()\n    switchView(view: ChatView)\n  emits:\n    onMessage(message: Message)\n  layout: |\n    ┌─────────────────────────┐\n    │ [toolbar slot]          │\n    ├─────────────────────────┤\n    │                         │\n    │  message list           │\n    │  [empty slot]           │\n    │                         │\n    ├─────────────────────────┤\n    │  input + send           │\n    └─────────────────────────┘\n```\n\n```mdl\ncomponent TracePanel\n  desc: Displays the execution trace of an AI operation as a commit graph or raw JSON.\n  props:\n    chat: Chat\n  state:\n    debug: boolean\n  actions:\n    toggleDebug()\n  layout: |\n    ┌─────────────────────────┐\n    │ trace / span tree       │\n    └─────────────────────────┘\n```\n\n```mdl\ncomponent AssistantSettings\n  desc: Settings panel for configuring the AI model provider, model defaults, and chat view.\n  props:\n    settings: Settings\n  emits:\n    onChange(settings: Settings)\n```\n\n## Operations\n\n```mdl\nop CreateChat\n  key: org.dxos.operation.assistant.createChat\n  desc: Creates a new Chat object and optionally adds it to the active space.\n  input:\n    db: Database\n    name?: string\n    addToSpace?: boolean\n  output: Chat\n  effects: [echo:write]\n```\n\n```mdl\nop UpdateChatName\n  key: org.dxos.operation.assistant.updateChatName\n  desc: Automatically derives and updates the name of a chat using the AI service.\n  input:\n    chat: Chat\n  output: void\n  effects: [echo:write, ai:infer]\n```\n\n```mdl\nop SetCurrentChat\n  desc: Associates a primary object with a specific companion chat in session state.\n  input:\n    companionTo: Obj\n    chat?: Chat\n  output: void\n```\n\n```mdl\nop RunPromptInNewChat\n  desc: Creates a new chat, binds context objects and skills, then runs a prompt.\n  note: |\n    Operation DEFINED in plugin-routine (RoutineOperation.RunPromptInNewChat)\n    so Routine UI and downstream plugins can dispatch it without depending on\n    plugin-assistant. The HANDLER (chat creation + AiContext binding) is contributed\n    here; see operations/run-prompt-in-new-chat.ts.\n```\n\n```mdl\nop EnsureCompanionChat\n  key: org.dxos.operation.assistant.ensureCompanionChat\n  desc: Returns the companion chat for an object, creating one if none exists.\n  input:\n    db: Database\n    companionTo: Obj\n  output:\n    chat: Chat\n    persisted: boolean\n  effects: [echo:write]\n```\n\n```mdl\nop OnCreateSpace\n  desc: Provisions initial assistant objects when a new space is created.\n  input:\n    space: Space\n    rootCollection: Collection\n  output: void\n  effects: [echo:write]\n```\n\n```mdl\nop ToggleTracePanelDebug\n  key: org.dxos.operation.assistant.setTracePanelDebug\n  desc: Toggles the trace panel between commit-graph and raw JSON debug view.\n  input:\n    state?: boolean\n  output: boolean\n```\n\n## Features\n\n```mdl\nfeat F-1: AI Chat\n\n  req F-1.1: User can create a new Chat object in any space.\n  req F-1.2: User can type a message and receive a streamed AI response.\n  req F-1.3: Chat history is persisted to ECHO and replicated to all peers.\n  req F-1.4:\n    when: chat has enough messages\n    then: chat name is automatically derived from the conversation\n```\n\n```mdl\nfeat F-2: Companion Chat\n\n  req F-2.1:\n    when: user opens an object that supports companions\n    then: a companion chat panel is shown alongside the object\n  req F-2.2:\n    when: companion chat does not yet exist\n    then: op:EnsureCompanionChat creates one and optionally persists it\n  req F-2.3:\n    when: op:EnsureCompanionChat resolves a companion chat\n    then: op:BindChatContext runs every cap:SubjectContext contribution that applies to the primary\n      object and binds the merged result — by default the object itself plus the skills its type\n      declares via Skill.SkillsAnnotation\n```\n\n```mdl\nfeat F-3: Skill System\n\n  req F-3.1: Skills define named AI configurations (instructions, tools, model).\n  req F-3.2: Built-in skills include: Assistant, Browser, Database, WebSearch, Discord, Linear, Agent, Planning, Memory, Automation, SkillManager.\n  req F-3.3:\n    when: user selects a skill for a chat\n    then: chat uses that skill's instructions and tool set\n  req F-3.4: op:RunPromptInNewChat accepts skill keys to bind before sending the prompt.\n```\n\n```mdl\nfeat F-4: Multi-Provider LLM\n\n  req F-4.1: Supported providers: DXOS Edge (remote), Ollama (local), LM Studio (local).\n  req F-4.2: User can configure the active provider and per-provider default model in Settings.\n  req F-4.3:\n    when: the active provider is unavailable\n    then: AiService falls back to the next registered resolver\n```\n\n```mdl\nfeat F-5: Tool Execution\n\n  req F-5.1: The assistant skill exposes LayoutOperation.Open and NavigationOperation.ResolveNavigationTargets\n             as tools. Both are owned elsewhere — the assistant contributes no navigation operation of its\n             own, so an agent resolving an object to a path uses the same entry point the UI does.\n  req F-5.2: Web search tool is registered via WebSearchToolkit.\n  req F-5.3:\n    when: AI invokes a tool during a conversation\n    then: operation is dispatched via the compute runtime and result returned to the model\n  req F-5.4: Code mode is opt-in via `Settings.codeMode`, off by default; the host supplies the engine\n             through the `codeModeTurnProducer` plugin option, and without it the setting has no effect.\n  req F-5.5:\n    when: Settings.codeMode is enabled, the host supplied a code-mode producer, and no AgentTurnProducer is contributed\n    then: agent processes spawned afterwards run turns through the code-mode producer (one `eval` tool)\n          instead of AiSession\n```\n\n```mdl\nfeat F-6: ECHO Integration\n\n  req F-6.1: Chat, Skill, Feed, Message, Memory, Plan, Routine, Agent, McpServer, and Sequence schemas are registered with ECHO. A chat's subject is recorded by Chat.CompanionChatAnnotation on that subject, not by a type.\n  req F-6.2:\n    when: a new space is created\n    then: op:OnCreateSpace provisions default assistant objects\n  req F-6.3: AiContext.Binding schema supports binding ECHO objects as named context variables in a conversation.\n```\n\n```mdl\nfeat F-7: Execution Trace\n\n  req F-7.1: Every AI operation produces a structured span tree captured in the TracePanel.\n  req F-7.2: User can toggle between commit-graph and raw JSON views via op:ToggleTracePanelDebug.\n```\n\n## Acceptance\n\n```mdl\nscenario T-1: Create chat and send message\n  given: a space is open and the assistant plugin is active\n  when: user creates a new Chat and sends \"Hello\"\n  then:\n    - Chat object appears in the space\n    - AI response is appended to Chat.messages\n    - Chat is persisted to ECHO\n```\n\n```mdl\nscenario T-2: Companion chat provisioning\n  given: user opens a document with no companion chat\n  when: companion panel initializes\n  then:\n    - op:EnsureCompanionChat creates a new Chat\n    - persisted === false until user sends a message\n```\n\n```mdl\nscenario T-3: Skill binding\n  given: a chat exists\n  when: user binds the \"WebSearch\" skill key\n  then:\n    - skill instructions are applied to the next AI request\n    - web search tool is available in the tool list\n```\n\n```mdl\nscenario T-4: Model provider switch\n  given: assistant settings are open\n  when: user switches provider from edge to ollama\n  then:\n    - Settings.modelProvider === ollama\n    - next AI request is routed to the Ollama resolver\n```\n\n```mdl\nscenario T-5: Run prompt in background\n  given: a database and a prompt string are available\n  when: op:RunPromptInNewChat is called with background: true\n  then:\n    - a new Chat is created and returned\n    - the prompt runs via compute runtime without opening the UI\n```\n\n```mdl\nscenario T-7: Trace panel debug toggle\n  given: trace panel is showing commit-graph view\n  when: op:ToggleTracePanelDebug is invoked with no argument\n  then:\n    - tracePanelDebug setting flips to true\n    - trace panel switches to raw JSON view\n```\n\n## QA\n\nExecutable tests. Each step carries a human instruction (`do`) and, where the step maps to an\ninvocable operation, an agent binding (`invoke`). Report failures by test and step number.\n\n```mdl\ntest QA-1: Create a chat and send a message\n  desc: The core assistant round-trip — create a Chat, send a prompt, get a streamed AI response.\n  actors: both\n  covers: [F-1.1, F-1.2, F-1.3, F-1.4, T-1]\n  status: unverified\n  given:\n    - an identity exists\n    - space: a space is open\n    - no Chat named \"QA Chat\" exists — ABORT rather than deleting one this test did not create\n  steps:\n    - name: Create the chat\n      do: Open the assistant panel and click \"New chat\".\n      invoke: [op:CreateChat] { name: \"QA Chat\" }\n      capture: created\n      expect: a new Chat named \"QA Chat\" opens, empty\n      assert: return !!$created.object\n      note: |\n        CreateChat returns the chat UNFILED — the handler adds its feed regardless, but persisting\n        it in the space is a separate step (see plugin-space's addObject), which the UI's \"New\n        chat\" gesture does implicitly.\n    - name: Send a message\n      do: Type \"Hello\" into the chat input and press Enter.\n      expect: \"Hello\" appears as a user message, followed by a streamed assistant response, and\n        the chat is persisted to ECHO and replicated to peers\n      note: |\n        NO `invoke` — sending a prompt runs through the AI streaming path (`AiSession`), not\n        through the operation invoker; there is no `SendMessage` operation to call directly.\n    - name: Chat is auto-named\n      do: (no gesture — happens automatically once the chat has enough messages)\n      invoke: [op:UpdateChatName] { chat: $created.object }\n      expect: the chat's name changes from \"QA Chat\" to something derived from the conversation\n      assert: return typeof $result === 'undefined' || true;\n      note: |\n        `UpdateChatName` returns void — verify the effect on `chat.name`, not the return value\n        (Execution Rule 3). Included here for completeness; a fast QA pass may treat this as\n        `given` already established rather than re-triggering it.\n  after:\n    - name: Delete the chat\n      do: Right-click \"QA Chat\" in the navtree and choose Delete.\n      invoke: org.dxos.operation.space.removeObjects { objects: [$created.object], target: $given.space.db }\n      expect: the row leaves the navtree and its plank closes if it was open\n```\n\n```mdl\ntest QA-2: Companion chat is provisioned and bound\n  desc: op:EnsureCompanionChat + op:BindChatContext — the chat a companioned object gets automatically.\n  actors: both\n  covers: [F-2.1, F-2.2, F-2.3, T-2]\n  status: unverified\n  given:\n    - an identity exists\n    - space: a space is open\n    - subject: a Document in the space that has no companion chat yet\n  steps:\n    - name: Ensure the companion chat\n      do: Open the document; the companion chat panel initializes automatically.\n      invoke: [op:EnsureCompanionChat] { companionTo: $given.subject }\n      capture: ensured\n      expect: a new Chat is returned and NOT yet persisted (`persisted === false`)\n      assert: return $result.persisted === false && !!$result.chat;\n    - name: Bind chat context\n      do: (no separate gesture — panel initialization runs this immediately after ensuring the chat)\n      invoke: org.dxos.operation.assistant.bindChatContext { chat: $ensured.chat, subject: $given.subject }\n      note: No `op BindChatContext` block is declared above — referenced by its full runtime key.\n      expect: the companion chat's context now includes the document (and any skills its type\n        declares via Skill.SkillsAnnotation)\n  after:\n    - name: (nothing to undo)\n      do: The companion chat is never persisted unless a message is sent, so nothing was written\n        to the space.\n      expect: the document still has no persisted companion chat\n```\n\n---\n\n## Appendix: Extension Definitions\n\nExtension block types used in this document are defined below using\nthe core `ext` primitive — the only construct the base language provides.\n\n```mdl\next type\n  uri: org.dxos.mdl.type@1.0\n  desc: A named data structure with typed fields and optional literals.\n  fields:\n    desc?: Prose\n    fields?: FieldMap\n    literals?: UnionList\n    extends?: TypeRef[]\n```\n\n```mdl\next feat\n  uri: org.dxos.mdl.feat@1.0\n  desc: A named feature grouping one or more requirements.\n  fields:\n    desc?: Prose\n    req: RequirementList\n  nesting: self\n```\n\n```mdl\next scenario\n  uri: org.dxos.mdl.scenario@1.0\n  desc: An acceptance scenario expressed as given / when / then steps.\n  fields:\n    given?: Step | Step[]\n    when?: Step | Step[]\n    then: Step | Step[]\n    tags?: TagList\n```\n\n```mdl\next component\n  uri: org.dxos.mdl.component@1.0\n  desc: A UI component with props, internal state, slots, actions, and events.\n  fields:\n    desc?: Prose\n    props?: FieldMap\n    state?: FieldMap\n    slots?: FieldMap\n    actions?: ActionMap\n    emits?: EventMap\n    layout?: CodeBlock\n```\n\n```mdl\next op\n  uri: org.dxos.mdl.op@1.0\n  desc: |\n    A named operation with typed inputs, outputs, and declared errors.\n    Pure ops have no effects or requires. Effectful ops declare both.\n  fields:\n    desc?: Prose\n    input?: FieldMap\n    output?: TypeExpr\n    errors?: ErrorMap\n    effects?: EffectList\n    requires?: ServiceList\n    note?: Prose\n```\n";
+var PLUGIN_default = "---\nid: org.dxos.plugin.assistant\nname: AssistantPlugin\nversion: 0.1.0\n---\n\nAn AI assistant plugin for DXOS Composer that provides conversational AI, skill-driven automation,\nmulti-provider LLM support, and deep ECHO integration.\n\n## Extensions\n\nThe following extension dialects are used in this document.\nEach extension is defined in the Appendix or resolved via its URI.\n\n| Term        | URI                           |\n|-------------|-------------------------------|\n| `type`      | `org.dxos.mdl.type@1.0`      |\n| `feat`      | `org.dxos.mdl.feat@1.0`      |\n| `scenario`  | `org.dxos.mdl.scenario@1.0`  |\n| `component` | `org.dxos.mdl.component@1.0` |\n| `op`        | `org.dxos.mdl.op@1.1`        |\n| `test`      | `org.dxos.mdl.test@1.0`      |\n\n## Types\n\n```mdl\ntype ModelProvider\n  literals: edge | ollama | lmstudio\n```\n\n```mdl\ntype ChatView\n  literals: normal | summary | thinking | debug\n```\n\n```mdl\ntype ModelDefaults\n  fields:\n    edge?: string\n    ollama?: string\n    lmstudio?: string\n```\n\n```mdl\ntype Settings\n  fields:\n    customPrompts?: boolean\n    chatView?: ChatView\n    modelProvider?: ModelProvider\n    modelDefaults?: ModelDefaults\n    codeMode?: boolean\n    reportStruggles?: boolean\n    tracePanelDebug?: boolean\n```\n\n```mdl\ntype Chat\n  fields:\n    id: string\n    name?: string\n    messages: Message[]\n```\n\n```mdl\ntype Message\n  fields:\n    id: string\n    role: user | assistant | system\n    content: string\n    timestamp: string\n```\n\n```mdl\ntype SkillForm\n  fields:\n    key: string\n    name: string\n    description?: string\n```\n\n## Components\n\n```mdl\ncomponent ChatPanel\n  desc: Main conversational interface for interacting with the AI assistant.\n  props:\n    chat: Chat\n    companionTo?: Obj\n  state:\n    messages: Message[]\n    pending: boolean\n    view: ChatView\n  slots:\n    toolbar?: ReactNode\n    empty?: ReactNode\n  actions:\n    sendMessage(content: string)\n    clearHistory()\n    switchView(view: ChatView)\n  emits:\n    onMessage(message: Message)\n  layout: |\n    ┌─────────────────────────┐\n    │ [toolbar slot]          │\n    ├─────────────────────────┤\n    │                         │\n    │  message list           │\n    │  [empty slot]           │\n    │                         │\n    ├─────────────────────────┤\n    │  input + send           │\n    └─────────────────────────┘\n```\n\n```mdl\ncomponent TracePanel\n  desc: Displays the execution trace of an AI operation as a commit graph or raw JSON.\n  props:\n    chat: Chat\n  state:\n    debug: boolean\n  actions:\n    toggleDebug()\n  layout: |\n    ┌─────────────────────────┐\n    │ trace / span tree       │\n    └─────────────────────────┘\n```\n\n```mdl\ncomponent AssistantSettings\n  desc: Settings panel for configuring the AI model provider, model defaults, and chat view.\n  props:\n    settings: Settings\n  emits:\n    onChange(settings: Settings)\n```\n\n## Operations\n\n```mdl\nop CreateChat\n  key: org.dxos.operation.assistant.createChat\n  desc: Creates a new Chat object and optionally adds it to the active space.\n  input:\n    db: Database\n    name?: string\n    addToSpace?: boolean\n  output: Chat\n  effects: [echo:write]\n```\n\n```mdl\nop UpdateChatName\n  key: org.dxos.operation.assistant.updateChatName\n  desc: Automatically derives and updates the name of a chat using the AI service.\n  input:\n    chat: Chat\n  output: void\n  effects: [echo:write, ai:infer]\n```\n\n```mdl\nop AnalyzeTurn\n  key: org.dxos.operation.assistant.analyzeTurn\n  desc: TurnReviewSkill's background end-request hook. Judges the turn that just ended with a small model and reports it when the agent struggled because of its prompting or tooling.\n  input: {}\n  output: void\n  effects: [echo:read, ai:infer, http:post]\n```\n\n```mdl\nop SetCurrentChat\n  desc: Associates a primary object with a specific companion chat in session state.\n  input:\n    companionTo: Obj\n    chat?: Chat\n  output: void\n```\n\n```mdl\nop RunPromptInNewChat\n  desc: Creates a new chat, binds context objects and skills, then runs a prompt.\n  note: |\n    Operation DEFINED in plugin-routine (RoutineOperation.RunPromptInNewChat)\n    so Routine UI and downstream plugins can dispatch it without depending on\n    plugin-assistant. The HANDLER (chat creation + AiContext binding) is contributed\n    here; see operations/run-prompt-in-new-chat.ts.\n```\n\n```mdl\nop EnsureCompanionChat\n  key: org.dxos.operation.assistant.ensureCompanionChat\n  desc: Returns the companion chat for an object, creating one if none exists.\n  input:\n    db: Database\n    companionTo: Obj\n  output:\n    chat: Chat\n    persisted: boolean\n  effects: [echo:write]\n```\n\n```mdl\nop OnCreateSpace\n  desc: Provisions initial assistant objects when a new space is created.\n  input:\n    space: Space\n    rootCollection: Collection\n  output: void\n  effects: [echo:write]\n```\n\n```mdl\nop ToggleTracePanelDebug\n  key: org.dxos.operation.assistant.setTracePanelDebug\n  desc: Toggles the trace panel between commit-graph and raw JSON debug view.\n  input:\n    state?: boolean\n  output: boolean\n```\n\n## Features\n\n```mdl\nfeat F-1: AI Chat\n\n  req F-1.1: User can create a new Chat object in any space.\n  req F-1.2: User can type a message and receive a streamed AI response.\n  req F-1.3: Chat history is persisted to ECHO and replicated to all peers.\n  req F-1.4:\n    when: chat has enough messages\n    then: chat name is automatically derived from the conversation\n```\n\n```mdl\nfeat F-2: Companion Chat\n\n  req F-2.1:\n    when: user opens an object that supports companions\n    then: a companion chat panel is shown alongside the object\n  req F-2.2:\n    when: companion chat does not yet exist\n    then: op:EnsureCompanionChat creates one and optionally persists it\n  req F-2.3:\n    when: op:EnsureCompanionChat resolves a companion chat\n    then: op:BindChatContext runs every cap:SubjectContext contribution that applies to the primary\n      object and binds the merged result — by default the object itself plus the skills its type\n      declares via Skill.SkillsAnnotation\n```\n\n```mdl\nfeat F-3: Skill System\n\n  req F-3.1: Skills define named AI configurations (instructions, tools, model).\n  req F-3.2: Built-in skills include: Assistant, Browser, Database, WebSearch, Discord, Linear, Agent, Planning, Memory, Automation, SkillManager.\n  req F-3.3:\n    when: user selects a skill for a chat\n    then: chat uses that skill's instructions and tool set\n  req F-3.4: op:RunPromptInNewChat accepts skill keys to bind before sending the prompt.\n```\n\n```mdl\nfeat F-4: Multi-Provider LLM\n\n  req F-4.1: Supported providers: DXOS Edge (remote), Ollama (local), LM Studio (local).\n  req F-4.2: User can configure the active provider and per-provider default model in Settings.\n  req F-4.3:\n    when: the active provider is unavailable\n    then: AiService falls back to the next registered resolver\n```\n\n```mdl\nfeat F-5: Tool Execution\n\n  req F-5.1: The assistant skill exposes LayoutOperation.Open and NavigationOperation.ResolveNavigationTargets\n             as tools. Both are owned elsewhere — the assistant contributes no navigation operation of its\n             own, so an agent resolving an object to a path uses the same entry point the UI does.\n  req F-5.2: Web search tool is registered via WebSearchToolkit.\n  req F-5.3:\n    when: AI invokes a tool during a conversation\n    then: operation is dispatched via the compute runtime and result returned to the model\n  req F-5.4: Code mode is opt-in via `Settings.codeMode`, off by default; the host supplies the engine\n             through the `codeModeTurnProducer` plugin option, and without it the setting has no effect.\n  req F-5.5:\n    when: Settings.codeMode is enabled, the host supplied a code-mode producer, and no AgentTurnProducer is contributed\n    then: agent processes spawned afterwards run turns through the code-mode producer (one `eval` tool)\n          instead of AiSession\n```\n\n```mdl\nfeat F-6: ECHO Integration\n\n  req F-6.1: Chat, Skill, Feed, Message, Memory, Plan, Routine, Agent, McpServer, and Sequence schemas are registered with ECHO. A chat's subject is recorded by Chat.CompanionChatAnnotation on that subject, not by a type.\n  req F-6.2:\n    when: a new space is created\n    then: op:OnCreateSpace provisions default assistant objects\n  req F-6.3: AiContext.Binding schema supports binding ECHO objects as named context variables in a conversation.\n```\n\n```mdl\nfeat F-7: Execution Trace\n\n  req F-7.1: Every AI operation produces a structured span tree captured in the TracePanel.\n  req F-7.2: User can toggle between commit-graph and raw JSON views via op:ToggleTracePanelDebug.\n```\n\n```mdl\nfeat F-8: Agent Struggle Reports\n\n  req F-8.1: Reporting is opt-in via `Settings.reportStruggles`, off by default, and also requires telemetry to be enabled.\n  req F-8.2:\n    when: the chat processor issues a request with reporting enabled\n    then: TurnReviewSkill is bound to the chat; its end-request hook (op:AnalyzeTurn) runs in the background, so\n          the request settles without waiting for the review and the agent process awaits it before finishing\n  req F-8.3:\n    when: the reviewer judges the agent struggled from missing/wrong instructions or a missing/faulty tool\n    then: the trajectory is uploaded to the feedback-logs bucket under `trajectories/` and an `agent_struggle` event is captured\n          carrying the cause, model DXN, code mode, and enabled skills\n  req F-8.4: A review that fails is logged and dropped; it never surfaces to the user.\n```\n\n## Acceptance\n\n```mdl\nscenario T-1: Create chat and send message\n  given: a space is open and the assistant plugin is active\n  when: user creates a new Chat and sends \"Hello\"\n  then:\n    - Chat object appears in the space\n    - AI response is appended to Chat.messages\n    - Chat is persisted to ECHO\n```\n\n```mdl\nscenario T-2: Companion chat provisioning\n  given: user opens a document with no companion chat\n  when: companion panel initializes\n  then:\n    - op:EnsureCompanionChat creates a new Chat\n    - persisted === false until user sends a message\n```\n\n```mdl\nscenario T-3: Skill binding\n  given: a chat exists\n  when: user binds the \"WebSearch\" skill key\n  then:\n    - skill instructions are applied to the next AI request\n    - web search tool is available in the tool list\n```\n\n```mdl\nscenario T-4: Model provider switch\n  given: assistant settings are open\n  when: user switches provider from edge to ollama\n  then:\n    - Settings.modelProvider === ollama\n    - next AI request is routed to the Ollama resolver\n```\n\n```mdl\nscenario T-5: Run prompt in background\n  given: a database and a prompt string are available\n  when: op:RunPromptInNewChat is called with background: true\n  then:\n    - a new Chat is created and returned\n    - the prompt runs via compute runtime without opening the UI\n```\n\n```mdl\nscenario T-7: Trace panel debug toggle\n  given: trace panel is showing commit-graph view\n  when: op:ToggleTracePanelDebug is invoked with no argument\n  then:\n    - tracePanelDebug setting flips to true\n    - trace panel switches to raw JSON view\n```\n\n## QA\n\nExecutable tests. Each step carries a human instruction (`do`) and, where the step maps to an\ninvocable operation, an agent binding (`invoke`). Report failures by test and step number.\n\n```mdl\ntest QA-1: Create a chat and send a message\n  desc: The core assistant round-trip — create a Chat, send a prompt, get a streamed AI response.\n  actors: both\n  covers: [F-1.1, F-1.2, F-1.3, F-1.4, T-1]\n  status: unverified\n  given:\n    - an identity exists\n    - space: a space is open\n    - no Chat named \"QA Chat\" exists — ABORT rather than deleting one this test did not create\n  steps:\n    - name: Create the chat\n      do: Open the assistant panel and click \"New chat\".\n      invoke: [op:CreateChat] { name: \"QA Chat\" }\n      capture: created\n      expect: a new Chat named \"QA Chat\" opens, empty\n      assert: return !!$created.object\n      note: |\n        CreateChat returns the chat UNFILED — the handler adds its feed regardless, but persisting\n        it in the space is a separate step (see plugin-space's addObject), which the UI's \"New\n        chat\" gesture does implicitly.\n    - name: Send a message\n      do: Type \"Hello\" into the chat input and press Enter.\n      expect: \"Hello\" appears as a user message, followed by a streamed assistant response, and\n        the chat is persisted to ECHO and replicated to peers\n      note: |\n        NO `invoke` — sending a prompt runs through the AI streaming path (`AiSession`), not\n        through the operation invoker; there is no `SendMessage` operation to call directly.\n    - name: Chat is auto-named\n      do: (no gesture — happens automatically once the chat has enough messages)\n      invoke: [op:UpdateChatName] { chat: $created.object }\n      expect: the chat's name changes from \"QA Chat\" to something derived from the conversation\n      assert: return typeof $result === 'undefined' || true;\n      note: |\n        `UpdateChatName` returns void — verify the effect on `chat.name`, not the return value\n        (Execution Rule 3). Included here for completeness; a fast QA pass may treat this as\n        `given` already established rather than re-triggering it.\n  after:\n    - name: Delete the chat\n      do: Right-click \"QA Chat\" in the navtree and choose Delete.\n      invoke: org.dxos.operation.space.removeObjects { objects: [$created.object], target: $given.space.db }\n      expect: the row leaves the navtree and its plank closes if it was open\n```\n\n```mdl\ntest QA-2: Companion chat is provisioned and bound\n  desc: op:EnsureCompanionChat + op:BindChatContext — the chat a companioned object gets automatically.\n  actors: both\n  covers: [F-2.1, F-2.2, F-2.3, T-2]\n  status: unverified\n  given:\n    - an identity exists\n    - space: a space is open\n    - subject: a Document in the space that has no companion chat yet\n  steps:\n    - name: Ensure the companion chat\n      do: Open the document; the companion chat panel initializes automatically.\n      invoke: [op:EnsureCompanionChat] { companionTo: $given.subject }\n      capture: ensured\n      expect: a new Chat is returned and NOT yet persisted (`persisted === false`)\n      assert: return $result.persisted === false && !!$result.chat;\n    - name: Bind chat context\n      do: (no separate gesture — panel initialization runs this immediately after ensuring the chat)\n      invoke: org.dxos.operation.assistant.bindChatContext { chat: $ensured.chat, subject: $given.subject }\n      note: No `op BindChatContext` block is declared above — referenced by its full runtime key.\n      expect: the companion chat's context now includes the document (and any skills its type\n        declares via Skill.SkillsAnnotation)\n  after:\n    - name: (nothing to undo)\n      do: The companion chat is never persisted unless a message is sent, so nothing was written\n        to the space.\n      expect: the document still has no persisted companion chat\n```\n\n---\n\n## Appendix: Extension Definitions\n\nExtension block types used in this document are defined below using\nthe core `ext` primitive — the only construct the base language provides.\n\n```mdl\next type\n  uri: org.dxos.mdl.type@1.0\n  desc: A named data structure with typed fields and optional literals.\n  fields:\n    desc?: Prose\n    fields?: FieldMap\n    literals?: UnionList\n    extends?: TypeRef[]\n```\n\n```mdl\next feat\n  uri: org.dxos.mdl.feat@1.0\n  desc: A named feature grouping one or more requirements.\n  fields:\n    desc?: Prose\n    req: RequirementList\n  nesting: self\n```\n\n```mdl\next scenario\n  uri: org.dxos.mdl.scenario@1.0\n  desc: An acceptance scenario expressed as given / when / then steps.\n  fields:\n    given?: Step | Step[]\n    when?: Step | Step[]\n    then: Step | Step[]\n    tags?: TagList\n```\n\n```mdl\next component\n  uri: org.dxos.mdl.component@1.0\n  desc: A UI component with props, internal state, slots, actions, and events.\n  fields:\n    desc?: Prose\n    props?: FieldMap\n    state?: FieldMap\n    slots?: FieldMap\n    actions?: ActionMap\n    emits?: EventMap\n    layout?: CodeBlock\n```\n\n```mdl\next op\n  uri: org.dxos.mdl.op@1.0\n  desc: |\n    A named operation with typed inputs, outputs, and declared errors.\n    Pure ops have no effects or requires. Effectful ops declare both.\n  fields:\n    desc?: Prose\n    input?: FieldMap\n    output?: TypeExpr\n    errors?: ErrorMap\n    effects?: EffectList\n    requires?: ServiceList\n    note?: Prose\n```\n";
 //#endregion
 export { PLUGIN_default as t };
 

package/dist/lib/chunk-PluginUrlPrompt.mjs

@@ -5,8 +5,8 @@ import { useCallback, useState } from "react";
 import * as Hooks from "@dxos/app-framework/Hooks";
 import { jsx, jsxs } from "react/jsx-runtime";
 import * as UiHooks from "@dxos/react-ui/Hooks";
-import * as Button from "@dxos/react-ui/Button";
 import * as Layout from "@dxos/react-ui/Layout";
+import * as Button from "@dxos/react-ui/Button";
 import * as Icon from "@dxos/react-ui/Icon";
 import * as PluginManagerProvider from "@dxos/app-framework/PluginManagerProvider";
 import * as Operations from "@dxos/plugin-registry/Operations";

package/dist/lib/chunk-QuestionSurface.mjs

@@ -10,9 +10,9 @@ import { log } from "@dxos/log";
 import { ActionMenu } from "@dxos/react-ui-menu";
 import { TaskQuestion } from "@dxos/react-ui-task";
 import * as UiHooks from "@dxos/react-ui/Hooks";
+import * as Layout from "@dxos/react-ui/Layout";
 import { Task } from "@dxos/types";
 import * as Button from "@dxos/react-ui/Button";
-import * as Layout from "@dxos/react-ui/Layout";
 import * as Icon from "@dxos/react-ui/Icon";
 import * as ToolkitHooks from "@dxos/app-toolkit/Hooks";
 import * as CardSlot from "@dxos/app-toolkit/CardSlot";

package/dist/lib/chunk-SpaceHomePrompt.mjs

@@ -1,98 +1,154 @@
 import { t as getChatPath } from "./chunk-paths.mjs";
-import { AssistantCapabilities, AssistantOperation } from "#types";
+import { n as contributesPluginManager, t as bindChatDefaults } from "./chunk-default-skills.mjs";
+import * as AppCapabilities from "@dxos/app-toolkit/AppCapabilities";
+import { AssistantCapabilities } from "#types";
 import * as Capabilities from "@dxos/app-framework/Capabilities";
 import { meta } from "#meta";
-import { useEffect, useMemo, useState } from "react";
+import { useCallback, useEffect, useMemo, useState } from "react";
 import * as Hooks from "@dxos/app-framework/Hooks";
 import * as LayoutOperation from "@dxos/app-toolkit/LayoutOperation";
+import * as Chat$1 from "@dxos/assistant/Chat";
+import { Database, Feed, Ref } from "@dxos/echo";
 import { jsx } from "react/jsx-runtime";
-import { useChatProcessor, useChatServices, usePresets } from "#hooks";
+import { usePresets } from "#hooks";
+import { AiContext } from "@dxos/assistant";
 import { Event } from "@dxos/async";
+import { log } from "@dxos/log";
 import * as UiHooks from "@dxos/react-ui/Hooks";
+import * as Effect from "effect/Effect";
+import * as EffectEx from "@dxos/effect/EffectEx";
 import { ChatPrompt } from "#components";
 import { useRegistry } from "@dxos/react-client/echo";
 //#region src/containers/SpaceHomePrompt/SpaceHomePrompt.tsx
-/**
-* Home article pinned-bottom contributor: the assistant prompt. Backed by an ephemeral in-memory
-* chat whose sole responsibility is to collect the user's text, context bindings, and preset
-* choice, then on submit: persist the chat to the space, queue the text as a pending prompt, and
-* navigate to it. AI generation runs in the opened chat view — the processor here exists only to
-* back the context-binder UI.
-*/
+var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-assistant/src/containers/SpaceHomePrompt/SpaceHomePrompt.tsx";
 var SpaceHomePrompt = ({ space }) => {
 	const { t } = UiHooks.useTranslation(meta.profile.key);
-	const { invokePromise } = Hooks.useOperationInvoker();
 	const registry = useRegistry();
 	const atomRegistry = Hooks.useCapability(Capabilities.AtomRegistry);
-	const stateAtom = Hooks.useCapability(AssistantCapabilities.State);
-	const runtime = useChatServices({ id: space?.id });
 	const settings = Hooks.useAtomCapability(AssistantCapabilities.Settings);
-	const [chat, setChat] = useState();
-	const [nonce, setNonce] = useState(0);
-	const { preset, ...presetProps } = usePresets(settings, chat);
-	useEffect(() => {
-		if (!space) {
-			setChat(void 0);
-			return;
-		}
-		let cancelled = false;
-		invokePromise(AssistantOperation.CreateChat, {}, { spaceId: space.db.spaceId }).then((result) => {
-			if (!cancelled) setChat(result.data?.object);
-		});
-		return () => {
-			cancelled = true;
+	const pluginManager = contributesPluginManager(Hooks.useCapabilities(AppCapabilities.SkillDefinition));
+	const [draftGeneration, setDraftGeneration] = useState(0);
+	const draft = useMemo(() => {
+		if (!space) return;
+		const feed = Feed.make();
+		return {
+			feed,
+			chat: Chat$1.make({ feed: Ref.make(feed) })
 		};
-	}, [
-		space,
-		nonce,
-		invokePromise
-	]);
-	const processor = useChatProcessor({
+	}, [space, draftGeneration]);
+	const chat = draft?.chat;
+	const context = useDraftContext({
 		db: space?.db,
+		draft,
+		registry: atomRegistry,
+		pluginManager
+	});
+	const { preset, ...presetProps } = usePresets(settings, chat);
+	const event = useDraftSend({
+		space,
+		draft,
+		context,
+		onSent: useCallback(() => setDraftGeneration((current) => current + 1), [])
+	});
+	if (!space) return null;
+	return /* @__PURE__ */ jsx(ChatPrompt, {
+		...presetProps,
+		outline: true,
 		chat,
-		preset,
-		runtime,
-		registry
+		db: space.db,
+		context,
+		registry,
+		event,
+		preset: preset?.id,
+		placeholder: t("space-home.prompt.placeholder")
 	});
+};
+SpaceHomePrompt.displayName = "SpaceHomePrompt";
+/** Stores the draft's chat and bindings, then opens it; a failed send removes what it stored and restores the text. */
+var useDraftSend = ({ space, draft, context, onSent }) => {
+	const { invokePromise } = Hooks.useOperationInvoker();
+	const atomRegistry = Hooks.useCapability(Capabilities.AtomRegistry);
+	const stateAtom = Hooks.useCapability(AssistantCapabilities.State);
 	const event = useMemo(() => new Event(), []);
 	useEffect(() => {
 		return event.on((ev) => {
 			if (ev.type !== "submit") return;
 			const text = ev.text.trim();
-			if (!space || !chat || text.length === 0) return;
+			if (!space || !draft || !context || text.length === 0) return;
+			const { feed, chat } = draft;
+			space.db.add(feed);
 			space.db.add(chat);
 			const chatPath = getChatPath(space.db.spaceId, chat.id);
-			atomRegistry.update(stateAtom, (current) => ({
-				...current,
-				pendingPrompts: {
-					...current.pendingPrompts,
-					[chatPath]: text
-				}
-			}));
-			invokePromise(LayoutOperation.Open, { subject: [chatPath] });
-			setNonce((current) => current + 1);
+			onSent();
+			context.flush().then(() => {
+				atomRegistry.update(stateAtom, (current) => ({
+					...current,
+					pendingPrompts: {
+						...current.pendingPrompts,
+						[chatPath]: text
+					}
+				}));
+				invokePromise(LayoutOperation.Open, { subject: [chatPath] });
+			}).catch((err) => {
+				log.catch(err, void 0, {
+					"~LogMeta": "~LogMeta",
+					F: __dxlog_file,
+					L: 116,
+					S: void 0
+				});
+				space.db.remove(chat);
+				space.db.remove(feed);
+				event.emit({
+					type: "update-prompt",
+					text
+				});
+			});
 		});
 	}, [
 		event,
 		space,
-		chat,
+		draft,
+		context,
 		atomRegistry,
 		stateAtom,
-		invokePromise
+		invokePromise,
+		onSent
 	]);
-	if (!processor || !chat || !space) return null;
-	return /* @__PURE__ */ jsx(ChatPrompt, {
-		...presetProps,
-		outline: true,
-		chat,
-		db: space.db,
-		processor,
-		event,
-		preset: preset?.id,
-		placeholder: t("space-home.prompt.placeholder")
-	});
+	return event;
+};
+var useDraftContext = ({ db, draft, registry, pluginManager }) => {
+	const [context, setContext] = useState();
+	UiHooks.useAsyncEffect(async (controller) => {
+		if (!db || !draft) return;
+		const runtime = await EffectEx.runAndForwardErrors(Effect.context().pipe(Effect.provide(Database.layer(db))));
+		const binder = new AiContext.Binder({
+			feed: draft.feed,
+			runtime,
+			registry,
+			hold: true
+		});
+		await binder.open();
+		await bindChatDefaults(binder, {
+			chat: draft.chat,
+			pluginManager
+		});
+		if (controller.signal.aborted) {
+			binder.close();
+			return;
+		}
+		setContext(binder);
+		return () => {
+			setContext(void 0);
+			binder.close();
+		};
+	}, [
+		db,
+		draft,
+		registry,
+		pluginManager
+	]);
+	return context;
 };
-SpaceHomePrompt.displayName = "SpaceHomePrompt";
 //#endregion
 export { SpaceHomePrompt as default };
 

package/dist/lib/chunk-SpaceHomePrompt.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"chunk-SpaceHomePrompt.mjs","names":[],"sources":["../../src/containers/SpaceHomePrompt/SpaceHomePrompt.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport React, { useEffect, useMemo, useState } from 'react';\n\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Hooks from '@dxos/app-framework/Hooks';\nimport * as LayoutOperation from '@dxos/app-toolkit/LayoutOperation';\nimport type * as Chat from '@dxos/assistant/Chat';\nimport { Event } from '@dxos/async';\nimport { type Space, useRegistry } from '@dxos/react-client/echo';\nimport * as UiHooks from '@dxos/react-ui/Hooks';\n\nimport { type ChatEvent, ChatPrompt } from '#components';\nimport { useChatProcessor, useChatServices, usePresets } from '#hooks';\nimport { meta } from '#meta';\nimport { AssistantCapabilities, AssistantOperation } from '#types';\n\nimport { getChatPath } from '../../paths.ts';\n\ntype SpaceScopedProps = {\n  space?: Space;\n};\n\n/**\n * Home article pinned-bottom contributor: the assistant prompt. Backed by an ephemeral in-memory\n * chat whose sole responsibility is to collect the user's text, context bindings, and preset\n * choice, then on submit: persist the chat to the space, queue the text as a pending prompt, and\n * navigate to it. AI generation runs in the opened chat view — the processor here exists only to\n * back the context-binder UI.\n */\nexport const SpaceHomePrompt = ({ space }: SpaceScopedProps) => {\n  const { t } = UiHooks.useTranslation(meta.profile.key);\n  const { invokePromise } = Hooks.useOperationInvoker();\n\n  const registry = useRegistry();\n  const atomRegistry = Hooks.useCapability(Capabilities.AtomRegistry);\n  const stateAtom = Hooks.useCapability(AssistantCapabilities.State);\n  const runtime = useChatServices({ id: space?.id });\n  const settings = Hooks.useAtomCapability(AssistantCapabilities.Settings);\n\n  // In-memory backing chat (not yet added to the space). `nonce` forces a fresh chat after submit.\n  const [chat, setChat] = useState<Chat.Chat>();\n  const [nonce, setNonce] = useState(0);\n  const { preset, ...presetProps } = usePresets(settings, chat);\n  useEffect(() => {\n    if (!space) {\n      setChat(undefined);\n      return;\n    }\n    let cancelled = false;\n    void invokePromise(AssistantOperation.CreateChat, {}, { spaceId: space.db.spaceId }).then((result) => {\n      if (!cancelled) {\n        setChat(result.data?.object);\n      }\n    });\n    return () => {\n      cancelled = true;\n    };\n  }, [space, nonce, invokePromise]);\n\n  const processor = useChatProcessor({ db: space?.db, chat, preset, runtime, registry });\n\n  const event = useMemo(() => new Event<ChatEvent>(), []);\n  useEffect(() => {\n    return event.on((ev) => {\n      if (ev.type !== 'submit') {\n        return;\n      }\n      const text = ev.text.trim();\n      if (!space || !chat || text.length === 0) {\n        return;\n      }\n\n      // Persist the in-memory chat, queue the prompt, and open the chat (which submits it).\n      space.db.add(chat);\n      const chatPath = getChatPath(space.db.spaceId, chat.id);\n      atomRegistry.update(stateAtom, (current) => ({\n        ...current,\n        pendingPrompts: { ...current.pendingPrompts, [chatPath]: text },\n      }));\n      void invokePromise(LayoutOperation.Open, { subject: [chatPath] });\n      setNonce((current) => current + 1);\n    });\n  }, [event, space, chat, atomRegistry, stateAtom, invokePromise]);\n\n  if (!processor || !chat || !space) {\n    return null;\n  }\n\n  return (\n    <ChatPrompt\n      {...presetProps}\n      outline\n      chat={chat}\n      db={space.db}\n      processor={processor}\n      event={event}\n      preset={preset?.id}\n      placeholder={t('space-home.prompt.placeholder')}\n    />\n  );\n};\n\nSpaceHomePrompt.displayName = 'SpaceHomePrompt';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAgCA,IAAa,mBAAmB,EAAE,YAA8B;CAC9D,MAAM,EAAE,MAAM,QAAQ,eAAe,KAAK,QAAQ,GAAG;CACrD,MAAM,EAAE,kBAAkB,MAAM,oBAAoB;CAEpD,MAAM,WAAW,YAAY;CAC7B,MAAM,eAAe,MAAM,cAAc,aAAa,YAAY;CAClE,MAAM,YAAY,MAAM,cAAc,sBAAsB,KAAK;CACjE,MAAM,UAAU,gBAAgB,EAAE,IAAI,OAAO,GAAG,CAAC;CACjD,MAAM,WAAW,MAAM,kBAAkB,sBAAsB,QAAQ;CAGvE,MAAM,CAAC,MAAM,WAAW,SAAoB;CAC5C,MAAM,CAAC,OAAO,YAAY,SAAS,CAAC;CACpC,MAAM,EAAE,QAAQ,GAAG,gBAAgB,WAAW,UAAU,IAAI;CAC5D,gBAAgB;EACd,IAAI,CAAC,OAAO;GACV,QAAQ,KAAA,CAAS;GACjB;EACF;EACA,IAAI,YAAY;EAChB,cAAmB,mBAAmB,YAAY,CAAC,GAAG,EAAE,SAAS,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,WAAW;GACpG,IAAI,CAAC,WACH,QAAQ,OAAO,MAAM,MAAM;EAE/B,CAAC;EACD,aAAa;GACX,YAAY;EACd;CACF,GAAG;EAAC;EAAO;EAAO;CAAa,CAAC;CAEhC,MAAM,YAAY,iBAAiB;EAAE,IAAI,OAAO;EAAI;EAAM;EAAQ;EAAS;CAAS,CAAC;CAErF,MAAM,QAAQ,cAAc,IAAI,MAAiB,GAAG,CAAC,CAAC;CACtD,gBAAgB;EACd,OAAO,MAAM,IAAI,OAAO;GACtB,IAAI,GAAG,SAAS,UACd;GAEF,MAAM,OAAO,GAAG,KAAK,KAAK;GAC1B,IAAI,CAAC,SAAS,CAAC,QAAQ,KAAK,WAAW,GACrC;GAIF,MAAM,GAAG,IAAI,IAAI;GACjB,MAAM,WAAW,YAAY,MAAM,GAAG,SAAS,KAAK,EAAE;GACtD,aAAa,OAAO,YAAY,aAAa;IAC3C,GAAG;IACH,gBAAgB;KAAE,GAAG,QAAQ;MAAiB,WAAW;IAAK;GAChE,EAAE;GACF,cAAmB,gBAAgB,MAAM,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC;GAChE,UAAU,YAAY,UAAU,CAAC;EACnC,CAAC;CACH,GAAG;EAAC;EAAO;EAAO;EAAM;EAAc;EAAW;CAAa,CAAC;CAE/D,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAC1B,OAAO;CAGT,OACE,oBAAC,YAAD;EACE,GAAI;EACJ,SAAA;EACM;EACN,IAAI,MAAM;EACC;EACJ;EACP,QAAQ,QAAQ;EAChB,aAAa,EAAE,+BAA+B;CAC/C,CAAA;AAEL;AAEA,gBAAgB,cAAc"}
+{"version":3,"file":"chunk-SpaceHomePrompt.mjs","names":[],"sources":["../../src/containers/SpaceHomePrompt/SpaceHomePrompt.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport type * as AtomRegistry from 'effect/reactivity/AtomRegistry';\nimport React, { useCallback, useEffect, useMemo, useState } from 'react';\n\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Hooks from '@dxos/app-framework/Hooks';\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\nimport * as LayoutOperation from '@dxos/app-toolkit/LayoutOperation';\nimport { AiContext } from '@dxos/assistant';\nimport * as Chat from '@dxos/assistant/Chat';\nimport { Event } from '@dxos/async';\nimport { Database, Feed, Ref } from '@dxos/echo';\nimport * as EffectEx from '@dxos/effect/EffectEx';\nimport { log } from '@dxos/log';\nimport { type Space, useRegistry } from '@dxos/react-client/echo';\nimport * as UiHooks from '@dxos/react-ui/Hooks';\n\nimport { type ChatEvent, ChatPrompt } from '#components';\nimport { usePresets } from '#hooks';\nimport { meta } from '#meta';\nimport { AssistantCapabilities } from '#types';\n\nimport { getChatPath } from '../../paths.ts';\nimport { bindChatDefaults, contributesPluginManager } from '../../util/default-skills.ts';\n\ntype SpaceScopedProps = {\n  space?: Space;\n};\n\nexport const SpaceHomePrompt = ({ space }: SpaceScopedProps) => {\n  const { t } = UiHooks.useTranslation(meta.profile.key);\n\n  const registry = useRegistry();\n  const atomRegistry = Hooks.useCapability(Capabilities.AtomRegistry);\n  const settings = Hooks.useAtomCapability(AssistantCapabilities.Settings);\n  const pluginManager = contributesPluginManager(Hooks.useCapabilities(AppCapabilities.SkillDefinition));\n\n  const [draftGeneration, setDraftGeneration] = useState(0);\n  const draft = useMemo(() => {\n    if (!space) {\n      return undefined;\n    }\n    const feed = Feed.make();\n    return { feed, chat: Chat.make({ feed: Ref.make(feed) }) };\n  }, [space, draftGeneration]);\n  const chat = draft?.chat;\n  const context = useDraftContext({ db: space?.db, draft, registry: atomRegistry, pluginManager });\n  const { preset, ...presetProps } = usePresets(settings, chat);\n\n  const startNewDraft = useCallback(() => setDraftGeneration((current) => current + 1), []);\n  const event = useDraftSend({ space, draft, context, onSent: startNewDraft });\n\n  if (!space) {\n    return null;\n  }\n\n  return (\n    <ChatPrompt\n      {...presetProps}\n      outline\n      chat={chat}\n      db={space.db}\n      context={context}\n      registry={registry}\n      event={event}\n      preset={preset?.id}\n      placeholder={t('space-home.prompt.placeholder')}\n    />\n  );\n};\n\nSpaceHomePrompt.displayName = 'SpaceHomePrompt';\n\ntype UseDraftSendProps = {\n  space?: Space;\n  draft?: { feed: Feed.Feed; chat: Chat.Chat };\n  context?: AiContext.Binder;\n  onSent: () => void;\n};\n\n/** Stores the draft's chat and bindings, then opens it; a failed send removes what it stored and restores the text. */\nconst useDraftSend = ({ space, draft, context, onSent }: UseDraftSendProps) => {\n  const { invokePromise } = Hooks.useOperationInvoker();\n  const atomRegistry = Hooks.useCapability(Capabilities.AtomRegistry);\n  const stateAtom = Hooks.useCapability(AssistantCapabilities.State);\n  const event = useMemo(() => new Event<ChatEvent>(), []);\n  useEffect(() => {\n    return event.on((ev) => {\n      if (ev.type !== 'submit') {\n        return;\n      }\n      const text = ev.text.trim();\n      if (!space || !draft || !context || text.length === 0) {\n        return;\n      }\n\n      const { feed, chat } = draft;\n      space.db.add(feed);\n      space.db.add(chat);\n      const chatPath = getChatPath(space.db.spaceId, chat.id);\n      onSent();\n      void context\n        .flush()\n        .then(() => {\n          atomRegistry.update(stateAtom, (current) => ({\n            ...current,\n            pendingPrompts: { ...current.pendingPrompts, [chatPath]: text },\n          }));\n          void invokePromise(LayoutOperation.Open, { subject: [chatPath] });\n        })\n        .catch((err) => {\n          log.catch(err);\n          space.db.remove(chat);\n          space.db.remove(feed);\n          event.emit({ type: 'update-prompt', text });\n        });\n    });\n  }, [event, space, draft, context, atomRegistry, stateAtom, invokePromise, onSent]);\n  return event;\n};\n\ntype UseDraftContextProps = {\n  db?: Database.Database;\n  draft?: { feed: Feed.Feed; chat: Chat.Chat };\n  registry: AtomRegistry.AtomRegistry;\n  pluginManager: boolean;\n};\n\nconst useDraftContext = ({ db, draft, registry, pluginManager }: UseDraftContextProps) => {\n  const [context, setContext] = useState<AiContext.Binder>();\n  UiHooks.useAsyncEffect(\n    async (controller) => {\n      if (!db || !draft) {\n        return;\n      }\n      const runtime = await EffectEx.runAndForwardErrors(\n        Effect.context<Database.Service>().pipe(Effect.provide(Database.layer(db))),\n      );\n      const binder = new AiContext.Binder({ feed: draft.feed, runtime, registry, hold: true });\n      await binder.open();\n      await bindChatDefaults(binder, { chat: draft.chat, pluginManager });\n      if (controller.signal.aborted) {\n        void binder.close();\n        return;\n      }\n      setContext(binder);\n      return () => {\n        setContext(undefined);\n        void binder.close();\n      };\n    },\n    [db, draft, registry, pluginManager],\n  );\n  return context;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAiCA,IAAa,mBAAmB,EAAE,YAA8B;CAC9D,MAAM,EAAE,MAAM,QAAQ,eAAe,KAAK,QAAQ,GAAG;CAErD,MAAM,WAAW,YAAY;CAC7B,MAAM,eAAe,MAAM,cAAc,aAAa,YAAY;CAClE,MAAM,WAAW,MAAM,kBAAkB,sBAAsB,QAAQ;CACvE,MAAM,gBAAgB,yBAAyB,MAAM,gBAAgB,gBAAgB,eAAe,CAAC;CAErG,MAAM,CAAC,iBAAiB,sBAAsB,SAAS,CAAC;CACxD,MAAM,QAAQ,cAAc;EAC1B,IAAI,CAAC,OACH;EAEF,MAAM,OAAO,KAAK,KAAK;EACvB,OAAO;GAAE;GAAM,MAAM,OAAK,KAAK,EAAE,MAAM,IAAI,KAAK,IAAI,EAAE,CAAC;EAAE;CAC3D,GAAG,CAAC,OAAO,eAAe,CAAC;CAC3B,MAAM,OAAO,OAAO;CACpB,MAAM,UAAU,gBAAgB;EAAE,IAAI,OAAO;EAAI;EAAO,UAAU;EAAc;CAAc,CAAC;CAC/F,MAAM,EAAE,QAAQ,GAAG,gBAAgB,WAAW,UAAU,IAAI;CAG5D,MAAM,QAAQ,aAAa;EAAE;EAAO;EAAO;EAAS,QAD9B,kBAAkB,oBAAoB,YAAY,UAAU,CAAC,GAAG,CAAC,CAC3B;CAAc,CAAC;CAE3E,IAAI,CAAC,OACH,OAAO;CAGT,OACE,oBAAC,YAAD;EACE,GAAI;EACJ,SAAA;EACM;EACN,IAAI,MAAM;EACD;EACC;EACH;EACP,QAAQ,QAAQ;EAChB,aAAa,EAAE,+BAA+B;CAC/C,CAAA;AAEL;AAEA,gBAAgB,cAAc;;AAU9B,IAAM,gBAAgB,EAAE,OAAO,OAAO,SAAS,aAAgC;CAC7E,MAAM,EAAE,kBAAkB,MAAM,oBAAoB;CACpD,MAAM,eAAe,MAAM,cAAc,aAAa,YAAY;CAClE,MAAM,YAAY,MAAM,cAAc,sBAAsB,KAAK;CACjE,MAAM,QAAQ,cAAc,IAAI,MAAiB,GAAG,CAAC,CAAC;CACtD,gBAAgB;EACd,OAAO,MAAM,IAAI,OAAO;GACtB,IAAI,GAAG,SAAS,UACd;GAEF,MAAM,OAAO,GAAG,KAAK,KAAK;GAC1B,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,WAAW,KAAK,WAAW,GAClD;GAGF,MAAM,EAAE,MAAM,SAAS;GACvB,MAAM,GAAG,IAAI,IAAI;GACjB,MAAM,GAAG,IAAI,IAAI;GACjB,MAAM,WAAW,YAAY,MAAM,GAAG,SAAS,KAAK,EAAE;GACtD,OAAO;GACP,QACG,MAAM,CAAA,CACN,WAAW;IACV,aAAa,OAAO,YAAY,aAAa;KAC3C,GAAG;KACH,gBAAgB;MAAE,GAAG,QAAQ;OAAiB,WAAW;KAAK;IAChE,EAAE;IACF,cAAmB,gBAAgB,MAAM,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC;GAClE,CAAC,CAAA,CACA,OAAO,QAAQ;IACd,IAAI,MAAM,KAAE,KAAA,GAAA;KAAA,YAAA;KAAA,GAAA;KAAA,GAAA;KAAA,GAAA,KAAA;IAAA,CAAC;IACb,MAAM,GAAG,OAAO,IAAI;IACpB,MAAM,GAAG,OAAO,IAAI;IACpB,MAAM,KAAK;KAAE,MAAM;KAAiB;IAAK,CAAC;GAC5C,CAAC;EACL,CAAC;CACH,GAAG;EAAC;EAAO;EAAO;EAAO;EAAS;EAAc;EAAW;EAAe;CAAM,CAAC;CACjF,OAAO;AACT;AASA,IAAM,mBAAmB,EAAE,IAAI,OAAO,UAAU,oBAA0C;CACxF,MAAM,CAAC,SAAS,cAAc,SAA2B;CACzD,QAAQ,eACN,OAAO,eAAe;EACpB,IAAI,CAAC,MAAM,CAAC,OACV;EAEF,MAAM,UAAU,MAAM,SAAS,oBAC7B,OAAO,QAA0B,CAAC,CAAC,KAAK,OAAO,QAAQ,SAAS,MAAM,EAAE,CAAC,CAAC,CAC5E;EACA,MAAM,SAAS,IAAI,UAAU,OAAO;GAAE,MAAM,MAAM;GAAM;GAAS;GAAU,MAAM;EAAK,CAAC;EACvF,MAAM,OAAO,KAAK;EAClB,MAAM,iBAAiB,QAAQ;GAAE,MAAM,MAAM;GAAM;EAAc,CAAC;EAClE,IAAI,WAAW,OAAO,SAAS;GAC7B,OAAY,MAAM;GAClB;EACF;EACA,WAAW,MAAM;EACjB,aAAa;GACX,WAAW,KAAA,CAAS;GACpB,OAAY,MAAM;EACpB;CACF,GACA;EAAC;EAAI;EAAO;EAAU;CAAa,CACrC;CACA,OAAO;AACT"}

package/dist/lib/chunk-TriggerStatus.mjs

@@ -2,8 +2,8 @@ import { meta } from "#meta";
 import { useMemo } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import * as Hooks from "@dxos/react-ui/Hooks";
-import * as Button from "@dxos/react-ui/Button";
 import * as Layout from "@dxos/react-ui/Layout";
+import * as Button from "@dxos/react-ui/Button";
 import * as Popover from "@dxos/react-ui/Popover";
 import * as RoutineHooks from "@dxos/plugin-routine/Hooks";
 import * as StatusBar from "@dxos/plugin-status-bar/StatusBar";

package/dist/lib/chunk-agent-service.mjs

@@ -1,6 +1,7 @@
 import { n as resolveTurnProducer } from "./chunk-turn-producers.mjs";
 import * as Capability from "@dxos/app-framework/Capability";
 import * as RoutineCapabilities from "@dxos/plugin-routine/RoutineCapabilities";
+import { AssistantCapabilities } from "#types";
 import * as Capabilities from "@dxos/app-framework/Capabilities";
 import * as Process from "@dxos/compute/Process";
 import * as Effect from "effect/Effect";
@@ -19,7 +20,8 @@ var makeAgentServiceSpec = (codeModeTurnProducer) => LayerSpec.make({
 	const codeMode = codeModeTurnProducer?.(manager);
 	return AgentService.layer({
 		delegationStrategy: strategies[0],
-		makeTurnProducer: (options) => resolveTurnProducer(manager, codeMode)(options)
+		makeTurnProducer: (options) => resolveTurnProducer(manager, codeMode)(options),
+		processes: () => manager.getAll(AssistantCapabilities.AgentProcess)
 	});
 })));
 var agent_service_default = Capability.makeModule((options) => Effect.succeed(Capability.contribute(Capabilities.LayerSpec, makeAgentServiceSpec(options?.codeModeTurnProducer))));

package/dist/lib/chunk-agent-service.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"chunk-agent-service.mjs","names":[],"sources":["../../src/capabilities/agent-service.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\n\nimport { AgentService as AgentServiceRuntime } from '@dxos/agent-runtime';\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AgentService from '@dxos/compute/AgentService';\nimport * as LayerSpec from '@dxos/compute/LayerSpec';\nimport * as Process from '@dxos/compute/Process';\nimport * as RoutineCapabilities from '@dxos/plugin-routine/RoutineCapabilities';\n\nimport { AssistantOptions } from '#types';\n\nimport { resolveTurnProducer } from './turn-producers.ts';\n\n//\n// Capability Module\n//\n// Owns the application-affinity {@link AgentService} layer for process-backed agents.\n//\n\nconst makeAgentServiceSpec = (codeModeTurnProducer: AssistantOptions.AssistantPluginOptions['codeModeTurnProducer']) =>\n  LayerSpec.make(\n    {\n      affinity: 'application',\n      // Declared, not read optionally: a tag this spec does not require is never in its context. The\n      // manager spans the local and remote runtimes; plugin-routine contributes it for every stack.\n      requires: [Process.ManagerService, Capability.Service],\n      provides: [AgentService.AgentService],\n    },\n    () =>\n      Layer.unwrap(\n        Effect.gen(function* () {\n          // Optional supervisor behaviour, contributed by a plugin that knows the agent/plan model.\n          const strategies = yield* Capability.getAll(RoutineCapabilities.AgentDelegationStrategy);\n          const manager = yield* Capability.Service;\n          const codeMode = codeModeTurnProducer?.(manager);\n          return AgentServiceRuntime.layer({\n            delegationStrategy: strategies[0],\n            makeTurnProducer: (options) => resolveTurnProducer(manager, codeMode)(options),\n          });\n        }),\n      ),\n  );\n\nexport default Capability.makeModule((options: AssistantOptions.AssistantPluginOptions | void) =>\n  Effect.succeed(Capability.contribute(Capabilities.LayerSpec, makeAgentServiceSpec(options?.codeModeTurnProducer))),\n);\n"],"mappings":";;;;;;;;;;;AAyBA,IAAM,wBAAwB,yBAC5B,UAAU,KACR;CACE,UAAU;CAGV,UAAU,CAAC,QAAQ,gBAAgB,WAAW,OAAO;CACrD,UAAU,CAAC,eAAa,YAAY;AACtC,SAEE,MAAM,OACJ,OAAO,IAAI,aAAa;CAEtB,MAAM,aAAa,OAAO,WAAW,OAAO,oBAAoB,uBAAuB;CACvF,MAAM,UAAU,OAAO,WAAW;CAClC,MAAM,WAAW,uBAAuB,OAAO;CAC/C,OAAO,aAAoB,MAAM;EAC/B,oBAAoB,WAAW;EAC/B,mBAAmB,YAAY,oBAAoB,SAAS,QAAQ,CAAC,CAAC,OAAO;CAC/E,CAAC;AACH,CAAC,CACH,CACJ;AAEF,IAAA,wBAAe,WAAW,YAAY,YACpC,OAAO,QAAQ,WAAW,WAAW,aAAa,WAAW,qBAAqB,SAAS,oBAAoB,CAAC,CAAC,CACnH"}
+{"version":3,"file":"chunk-agent-service.mjs","names":[],"sources":["../../src/capabilities/agent-service.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\n\nimport { AgentService as AgentServiceRuntime } from '@dxos/agent-runtime';\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AgentService from '@dxos/compute/AgentService';\nimport * as LayerSpec from '@dxos/compute/LayerSpec';\nimport * as Process from '@dxos/compute/Process';\nimport * as RoutineCapabilities from '@dxos/plugin-routine/RoutineCapabilities';\n\nimport { AssistantCapabilities, AssistantOptions } from '#types';\n\nimport { resolveTurnProducer } from './turn-producers.ts';\n\n//\n// Capability Module\n//\n// Owns the application-affinity {@link AgentService} layer for process-backed agents.\n//\n\nconst makeAgentServiceSpec = (codeModeTurnProducer: AssistantOptions.AssistantPluginOptions['codeModeTurnProducer']) =>\n  LayerSpec.make(\n    {\n      affinity: 'application',\n      // Declared, not read optionally: a tag this spec does not require is never in its context. The\n      // manager spans the local and remote runtimes; plugin-routine contributes it for every stack.\n      requires: [Process.ManagerService, Capability.Service],\n      provides: [AgentService.AgentService],\n    },\n    () =>\n      Layer.unwrap(\n        Effect.gen(function* () {\n          // Optional supervisor behaviour, contributed by a plugin that knows the agent/plan model.\n          const strategies = yield* Capability.getAll(RoutineCapabilities.AgentDelegationStrategy);\n          const manager = yield* Capability.Service;\n          const codeMode = codeModeTurnProducer?.(manager);\n          return AgentServiceRuntime.layer({\n            delegationStrategy: strategies[0],\n            makeTurnProducer: (options) => resolveTurnProducer(manager, codeMode)(options),\n            processes: () => manager.getAll(AssistantCapabilities.AgentProcess),\n          });\n        }),\n      ),\n  );\n\nexport default Capability.makeModule((options: AssistantOptions.AssistantPluginOptions | void) =>\n  Effect.succeed(Capability.contribute(Capabilities.LayerSpec, makeAgentServiceSpec(options?.codeModeTurnProducer))),\n);\n"],"mappings":";;;;;;;;;;;;AAyBA,IAAM,wBAAwB,yBAC5B,UAAU,KACR;CACE,UAAU;CAGV,UAAU,CAAC,QAAQ,gBAAgB,WAAW,OAAO;CACrD,UAAU,CAAC,eAAa,YAAY;AACtC,SAEE,MAAM,OACJ,OAAO,IAAI,aAAa;CAEtB,MAAM,aAAa,OAAO,WAAW,OAAO,oBAAoB,uBAAuB;CACvF,MAAM,UAAU,OAAO,WAAW;CAClC,MAAM,WAAW,uBAAuB,OAAO;CAC/C,OAAO,aAAoB,MAAM;EAC/B,oBAAoB,WAAW;EAC/B,mBAAmB,YAAY,oBAAoB,SAAS,QAAQ,CAAC,CAAC,OAAO;EAC7E,iBAAiB,QAAQ,OAAO,sBAAsB,YAAY;CACpE,CAAC;AACH,CAAC,CACH,CACJ;AAEF,IAAA,wBAAe,WAAW,YAAY,YACpC,OAAO,QAAQ,WAAW,WAAW,aAAa,WAAW,qBAAqB,SAAS,oBAAoB,CAAC,CAAC,CACnH"}