@dxos/plugin-assistant 0.9.0 → 0.9.1-staging.ee54ba693a

package/dist/lib/neutral/chunk-XVGEJWJX.mjs

@@ -0,0 +1,133 @@
+// src/AssistantPlugin.ts
+import { ActivationEvent, ActivationEvents, Capability, Plugin } from "@dxos/app-framework";
+import { AppActivationEvents, AppPlugin } from "@dxos/app-toolkit";
+import { AiContext } from "@dxos/assistant";
+import { Agent, Chat, McpServer, Memory, Plan } from "@dxos/assistant-toolkit";
+import { Instructions, Skill } from "@dxos/compute";
+import { Sequence } from "@dxos/conductor";
+import { Feed } from "@dxos/echo";
+import { ClientEvents } from "@dxos/plugin-client";
+import { DeckEvents } from "@dxos/plugin-deck";
+import { MarkdownEvents } from "@dxos/plugin-markdown";
+import { Text } from "@dxos/schema";
+import { HasSubject, Message } from "@dxos/types";
+import { AgentHydrator, AgentRuntime, AiContext as AiContextCapability, AiService, AppGraphBuilder, AssistantState, AutomationTemplates, CompanionChatProvisioner, Connector, CreateObject, EdgeModelResolver, LocalModelResolver, MarkdownExtension, Migrations, NavigationResolver, OperationHandler, ReactSurface, Settings, SkillDefinition, Toolkit } from "#capabilities";
+import { meta } from "#meta";
+import { translations } from "#translations";
+import { AssistantEvents } from "#types";
+
+// raw-loader:/__w/dxos/dxos/packages/plugins/plugin-assistant/PLUGIN.mdl
+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| `test`      | `org.dxos.mdl.test@1.0`      |\n| `component` | `org.dxos.mdl.component@1.0` |\n| `op`        | `org.dxos.mdl.op@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    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 NavigationTarget\n  fields:\n    path: string\n    label: string\n    type: 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    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 [toolbar slot]          \u2502\n    \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n    \u2502                         \u2502\n    \u2502  message list           \u2502\n    \u2502  [empty slot]           \u2502\n    \u2502                         \u2502\n    \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n    \u2502  input + send           \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\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    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 trace / span tree       \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\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  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  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  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 ResolveNavigationTargets\n  desc: Returns navigation paths for objects in the active space, optionally filtered by DXN.\n  input:\n    query?:\n      dxn?: DXN\n  output:\n    targets: NavigationTarget[]\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  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: user sends a message in the companion chat\n    then: the primary object is automatically bound as AI context\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, AgentWizard.\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 ResolveNavigationTargets as tools.\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```\n\n```mdl\nfeat F-6: ECHO Integration\n\n  req F-6.1: Chat, CompanionTo, Skill, Feed, Message, Memory, Plan, Routine, Agent, McpServer, and Sequence schemas are registered with ECHO.\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\ntest 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\ntest 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\ntest 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\ntest 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\ntest 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\ntest T-6: Navigation target resolution\n  given: active space contains documents and collections\n  when: op:ResolveNavigationTargets is called with no query\n  then:\n    - returned targets include paths for all top-level navigable objects\n    - each target has a non-empty label and type\n```\n\n```mdl\ntest 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---\n\n## Appendix: Extension Definitions\n\nExtension block types used in this document are defined below using\nthe core `ext` primitive \u2014 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 test\n  uri: org.dxos.mdl.test@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';
+
+// src/AssistantPlugin.ts
+var StateReady = AppActivationEvents.createStateEvent(meta.profile.key);
+var AssistantPlugin = Plugin.define(meta).pipe(AppPlugin.addAppGraphModule({
+  activate: AppGraphBuilder
+}), AppPlugin.addNavigationResolverModule({
+  activatesOn: ClientEvents.ClientReady,
+  activate: NavigationResolver
+}), AppPlugin.addSkillDefinitionModule({
+  activate: SkillDefinition
+}), AppPlugin.addCreateObjectModule({
+  activate: CreateObject
+}), AppPlugin.addOperationHandlerModule({
+  activate: OperationHandler
+}), AppPlugin.addSchemaModule({
+  schema: [
+    Chat.Chat,
+    Chat.CompanionTo,
+    Skill.Skill,
+    AiContext.Binding,
+    Feed.Feed,
+    HasSubject.HasSubject,
+    Message.Message,
+    Instructions.Instructions,
+    Agent.Agent,
+    McpServer.McpServer,
+    Plan.Plan,
+    Sequence.Sequence,
+    Memory.Memory,
+    Text.Text
+  ]
+}), AppPlugin.addSettingsModule({
+  activate: Settings
+}), AppPlugin.addSurfaceModule({
+  activate: ReactSurface,
+  firesBeforeActivation: [
+    AppActivationEvents.SetupArtifactDefinition
+  ]
+}), AppPlugin.addTranslationsModule({
+  translations
+}), Plugin.addModule({
+  id: "automation-templates",
+  activatesOn: AppActivationEvents.SetupSchema,
+  activate: AutomationTemplates
+}), Plugin.addModule({
+  id: "markdown",
+  activatesOn: MarkdownEvents.SetupExtensions,
+  activate: MarkdownExtension
+}), Plugin.addModule({
+  // TODO(wittjosiah): Does not integrate with settings store.
+  //   Should this be a different event?
+  //   Should settings store be renamed to be more generic?
+  activatesOn: AppActivationEvents.SetupSettings,
+  firesAfterActivation: [
+    StateReady
+  ],
+  activate: AssistantState
+}), Plugin.addModule({
+  activatesOn: AssistantEvents.SetupAiServiceProviders,
+  activate: EdgeModelResolver
+}), Plugin.addModule({
+  activatesOn: AssistantEvents.SetupAiServiceProviders,
+  activate: LocalModelResolver
+}), Plugin.addModule((options) => ({
+  id: Capability.getModuleTag(AiService),
+  firesBeforeActivation: [
+    AssistantEvents.SetupAiServiceProviders
+  ],
+  // TODO(dmaretskyi): This should activate lazily when the AI chat is used.
+  activatesOn: ActivationEvents.SetupProcessManager,
+  activate: () => AiService(options)
+})), Plugin.addModule({
+  // Process-affinity `Harness.HarnessService` LayerSpec — needed so operations
+  // dispatched as their own processes (e.g. via `Operation.invoke` from
+  // `AiSession.createRequest` or `TriggerDispatcher`) can resolve
+  // conversation-scoped services without an inline `Effect.provideService`
+  // upstream. See `capabilities/ai-context.ts` for the rationale.
+  activatesOn: ActivationEvents.SetupProcessManager,
+  activate: AiContextCapability
+}), Plugin.addModule({
+  activatesOn: ActivationEvents.SetupProcessManager,
+  activate: AgentRuntime
+})).pipe(Plugin.addModule({
+  // TODO(wittjosiah): Use a different event.
+  activatesOn: ActivationEvents.Startup,
+  activate: Toolkit
+}), Plugin.addModule({
+  activatesOn: ActivationEvents.ProcessManagerReady,
+  activate: AgentHydrator
+}), Plugin.addModule({
+  activatesOn: ActivationEvent.allOf(ActivationEvents.ProcessManagerReady, AppActivationEvents.AppGraphReady, DeckEvents.StateReady, StateReady),
+  activate: CompanionChatProvisioner
+}), Plugin.addModule({
+  activatesOn: ClientEvents.SetupMigration,
+  activate: Migrations
+}), Plugin.addModule({
+  activatesOn: AppActivationEvents.SetupConnectors,
+  activate: Connector
+}), AppPlugin.addPluginAssetModule({
+  asset: {
+    pluginId: meta.profile.key,
+    path: "PLUGIN.mdl",
+    content: PLUGIN_default,
+    mimeType: "application/x-mdl"
+  }
+}), Plugin.make);
+var AssistantPlugin_default = AssistantPlugin;
+
+export {
+  AssistantPlugin,
+  AssistantPlugin_default
+};
+//# sourceMappingURL=chunk-XVGEJWJX.mjs.map

package/dist/lib/neutral/chunk-XVGEJWJX.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/AssistantPlugin.ts", "raw-loader:/__w/dxos/dxos/packages/plugins/plugin-assistant/PLUGIN.mdl"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { ActivationEvent, ActivationEvents, Capability, Plugin } from '@dxos/app-framework';\nimport { AppActivationEvents, AppPlugin } from '@dxos/app-toolkit';\nimport { AiContext } from '@dxos/assistant';\nimport { Agent, Chat, McpServer, Memory, Plan } from '@dxos/assistant-toolkit';\nimport { Instructions, Skill } from '@dxos/compute';\nimport { Sequence } from '@dxos/conductor';\nimport { Feed } from '@dxos/echo';\nimport { ClientEvents } from '@dxos/plugin-client';\nimport { DeckEvents } from '@dxos/plugin-deck';\nimport { MarkdownEvents } from '@dxos/plugin-markdown';\nimport { Text } from '@dxos/schema';\nimport { HasSubject, Message } from '@dxos/types';\n\nimport {\n  AgentHydrator,\n  AgentRuntime,\n  AiContext as AiContextCapability,\n  AiService,\n  AppGraphBuilder,\n  AssistantState,\n  AutomationTemplates,\n  CompanionChatProvisioner,\n  Connector,\n  CreateObject,\n  EdgeModelResolver,\n  LocalModelResolver,\n  MarkdownExtension,\n  Migrations,\n  NavigationResolver,\n  OperationHandler,\n  ReactSurface,\n  Settings,\n  SkillDefinition,\n  Toolkit,\n} from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { AssistantEvents, type AssistantPluginOptions } from '#types';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../PLUGIN.mdl?raw';\n\nconst StateReady = AppActivationEvents.createStateEvent(meta.profile.key);\n\nexport const AssistantPlugin = Plugin.define<AssistantPluginOptions | void>(meta)\n  .pipe(\n    AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),\n    AppPlugin.addNavigationResolverModule({ activatesOn: ClientEvents.ClientReady, activate: NavigationResolver }),\n    AppPlugin.addSkillDefinitionModule({ activate: SkillDefinition }),\n    AppPlugin.addCreateObjectModule({ activate: CreateObject }),\n    AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n    AppPlugin.addSchemaModule({\n      schema: [\n        Chat.Chat,\n        Chat.CompanionTo,\n        Skill.Skill,\n        AiContext.Binding,\n        Feed.Feed,\n        HasSubject.HasSubject,\n        Message.Message,\n        Instructions.Instructions,\n        Agent.Agent,\n        McpServer.McpServer,\n        Plan.Plan,\n        Sequence.Sequence,\n        Memory.Memory,\n        Text.Text,\n      ],\n    }),\n    AppPlugin.addSettingsModule({ activate: Settings }),\n    AppPlugin.addSurfaceModule({\n      activate: ReactSurface,\n      firesBeforeActivation: [AppActivationEvents.SetupArtifactDefinition],\n    }),\n    AppPlugin.addTranslationsModule({ translations }),\n    Plugin.addModule({\n      id: 'automation-templates',\n      activatesOn: AppActivationEvents.SetupSchema,\n      activate: AutomationTemplates,\n    }),\n    Plugin.addModule({\n      id: 'markdown',\n      activatesOn: MarkdownEvents.SetupExtensions,\n      activate: MarkdownExtension,\n    }),\n    Plugin.addModule({\n      // TODO(wittjosiah): Does not integrate with settings store.\n      //   Should this be a different event?\n      //   Should settings store be renamed to be more generic?\n      activatesOn: AppActivationEvents.SetupSettings,\n      firesAfterActivation: [StateReady],\n      activate: AssistantState,\n    }),\n    Plugin.addModule({\n      activatesOn: AssistantEvents.SetupAiServiceProviders,\n      activate: EdgeModelResolver,\n    }),\n    Plugin.addModule({\n      activatesOn: AssistantEvents.SetupAiServiceProviders,\n      activate: LocalModelResolver,\n    }),\n    Plugin.addModule((options) => ({\n      id: Capability.getModuleTag(AiService),\n      firesBeforeActivation: [AssistantEvents.SetupAiServiceProviders],\n      // TODO(dmaretskyi): This should activate lazily when the AI chat is used.\n      activatesOn: ActivationEvents.SetupProcessManager,\n      activate: () => AiService(options),\n    })),\n    Plugin.addModule({\n      // Process-affinity `Harness.HarnessService` LayerSpec — needed so operations\n      // dispatched as their own processes (e.g. via `Operation.invoke` from\n      // `AiSession.createRequest` or `TriggerDispatcher`) can resolve\n      // conversation-scoped services without an inline `Effect.provideService`\n      // upstream. See `capabilities/ai-context.ts` for the rationale.\n      activatesOn: ActivationEvents.SetupProcessManager,\n      activate: AiContextCapability,\n    }),\n    Plugin.addModule({\n      activatesOn: ActivationEvents.SetupProcessManager,\n      activate: AgentRuntime,\n    }),\n  )\n  .pipe(\n    Plugin.addModule({\n      // TODO(wittjosiah): Use a different event.\n      activatesOn: ActivationEvents.Startup,\n      activate: Toolkit,\n    }),\n    Plugin.addModule({\n      activatesOn: ActivationEvents.ProcessManagerReady,\n      activate: AgentHydrator,\n    }),\n    Plugin.addModule({\n      activatesOn: ActivationEvent.allOf(\n        ActivationEvents.ProcessManagerReady,\n        AppActivationEvents.AppGraphReady,\n        DeckEvents.StateReady,\n        StateReady,\n      ),\n      activate: CompanionChatProvisioner,\n    }),\n    Plugin.addModule({\n      activatesOn: ClientEvents.SetupMigration,\n      activate: Migrations,\n    }),\n    Plugin.addModule({\n      activatesOn: AppActivationEvents.SetupConnectors,\n      activate: Connector,\n    }),\n    AppPlugin.addPluginAssetModule({\n      asset: { pluginId: meta.profile.key, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },\n    }),\n    Plugin.make,\n  );\n\nexport default AssistantPlugin;\n", "---\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| `test`      | `org.dxos.mdl.test@1.0`      |\n| `component` | `org.dxos.mdl.component@1.0` |\n| `op`        | `org.dxos.mdl.op@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    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 NavigationTarget\n  fields:\n    path: string\n    label: string\n    type: 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    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 [toolbar slot]          \u2502\n    \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n    \u2502                         \u2502\n    \u2502  message list           \u2502\n    \u2502  [empty slot]           \u2502\n    \u2502                         \u2502\n    \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n    \u2502  input + send           \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\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    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 trace / span tree       \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\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  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  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  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 ResolveNavigationTargets\n  desc: Returns navigation paths for objects in the active space, optionally filtered by DXN.\n  input:\n    query?:\n      dxn?: DXN\n  output:\n    targets: NavigationTarget[]\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  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: user sends a message in the companion chat\n    then: the primary object is automatically bound as AI context\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, AgentWizard.\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 ResolveNavigationTargets as tools.\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```\n\n```mdl\nfeat F-6: ECHO Integration\n\n  req F-6.1: Chat, CompanionTo, Skill, Feed, Message, Memory, Plan, Routine, Agent, McpServer, and Sequence schemas are registered with ECHO.\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\ntest 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\ntest 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\ntest 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\ntest 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\ntest 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\ntest T-6: Navigation target resolution\n  given: active space contains documents and collections\n  when: op:ResolveNavigationTargets is called with no query\n  then:\n    - returned targets include paths for all top-level navigable objects\n    - each target has a non-empty label and type\n```\n\n```mdl\ntest 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---\n\n## Appendix: Extension Definitions\n\nExtension block types used in this document are defined below using\nthe core `ext` primitive \u2014 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 test\n  uri: org.dxos.mdl.test@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"],
+  "mappings": "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",
+  "names": ["ActivationEvent", "ActivationEvents", "Capability", "Plugin", "AppActivationEvents", "AppPlugin", "AiContext", "Agent", "Chat", "McpServer", "Memory", "Plan", "Instructions", "Skill", "Sequence", "Feed", "ClientEvents", "DeckEvents", "MarkdownEvents", "Text", "HasSubject", "Message", "AgentHydrator", "AgentRuntime", "AiContextCapability", "AiService", "AppGraphBuilder", "AssistantState", "AutomationTemplates", "CompanionChatProvisioner", "Connector", "CreateObject", "EdgeModelResolver", "LocalModelResolver", "MarkdownExtension", "Migrations", "NavigationResolver", "OperationHandler", "ReactSurface", "Settings", "SkillDefinition", "Toolkit", "meta", "translations", "AssistantEvents", "StateReady", "AppActivationEvents", "createStateEvent", "meta", "profile", "key", "AssistantPlugin", "Plugin", "define", "pipe", "AppPlugin", "addAppGraphModule", "activate", "AppGraphBuilder", "addNavigationResolverModule", "activatesOn", "ClientEvents", "ClientReady", "NavigationResolver", "addSkillDefinitionModule", "SkillDefinition", "addCreateObjectModule", "CreateObject", "addOperationHandlerModule", "OperationHandler", "addSchemaModule", "schema", "Chat", "CompanionTo", "Skill", "AiContext", "Binding", "Feed", "HasSubject", "Message", "Instructions", "Agent", "McpServer", "Plan", "Sequence", "Memory", "Text", "addSettingsModule", "Settings", "addSurfaceModule", "ReactSurface", "firesBeforeActivation", "SetupArtifactDefinition", "addTranslationsModule", "translations", "addModule", "id", "SetupSchema", "AutomationTemplates", "MarkdownEvents", "SetupExtensions", "MarkdownExtension", "SetupSettings", "firesAfterActivation", "AssistantState", "AssistantEvents", "SetupAiServiceProviders", "EdgeModelResolver", "LocalModelResolver", "options", "Capability", "getModuleTag", "AiService", "ActivationEvents", "SetupProcessManager", "AiContextCapability", "AgentRuntime", "Startup", "Toolkit", "ProcessManagerReady", "AgentHydrator", "ActivationEvent", "allOf", "AppGraphReady", "DeckEvents", "CompanionChatProvisioner", "SetupMigration", "Migrations", "SetupConnectors", "Connector", "addPluginAssetModule", "asset", "pluginId", "path", "content", "pluginSpec", "mimeType", "make"]
+}

package/dist/lib/neutral/{companion-chat-provisioner-YZZ73P6E.mjs → companion-chat-provisioner-IQV5VIVE.mjs}

@@ -9,9 +9,10 @@ import { AppCapabilities } from "@dxos/app-toolkit";
 import { Chat } from "@dxos/assistant-toolkit";
 import { Obj } from "@dxos/echo";
 import { log } from "@dxos/log";
-import { DeckCapabilities, PLANK_COMPANION_TYPE } from "@dxos/plugin-deck";
+import { AttentionCapabilities } from "@dxos/plugin-attention";
+import { COMPANION_VIEW_STATE_CONTEXT, DeckCapabilities, PLANK_COMPANION_TYPE, companionVariantAspect } from "@dxos/plugin-deck";
 import { getLinkedVariant } from "@dxos/react-ui-attention";
-import { byPosition } from "@dxos/util";
+import { Position } from "@dxos/util";
 import { ASSISTANT_COMPANION_VARIANT } from "#meta";
 import { AssistantCapabilities, AssistantOperation } from "#types";
 var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-assistant/src/capabilities/companion-chat-provisioner.ts";
@@ -22,6 +23,8 @@ var companion_chat_provisioner_default = Capability.makeModule(Effect.fnUntraced
   const deckStateAtom = yield* Capability.get(DeckCapabilities.State);
   const cacheAtom = yield* Capability.get(AssistantCapabilities.CompanionChatCache);
   const stateAtom = yield* Capability.get(AssistantCapabilities.State);
+  const viewState = yield* Capability.get(AttentionCapabilities.ViewState);
+  const variantAtom = viewState.atom(companionVariantAspect, COMPANION_VIEW_STATE_CONTEXT);
   const plankSubs = /* @__PURE__ */ new Map();
   const unsubPlank = (plankId) => {
     plankSubs.get(plankId)?.();
@@ -52,7 +55,7 @@ var companion_chat_provisioner_default = Capability.makeModule(Effect.fnUntraced
       log.warn("No db for object", {
         plankId,
         companionUri
-      }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 58, S: this });
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 63, S: this });
       return false;
     }
     void operationInvoker.invokePromise(AssistantOperation.EnsureCompanionChat, {
@@ -61,7 +64,7 @@ var companion_chat_provisioner_default = Capability.makeModule(Effect.fnUntraced
     }).catch((error) => log.warn("Failed to provision companion chat", {
       plankId,
       error
-    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 67, S: this }));
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 72, S: this }));
     return false;
   };
   const provision = () => {
@@ -71,6 +74,7 @@ var companion_chat_provisioner_default = Capability.makeModule(Effect.fnUntraced
       unsubAllPlanks();
       return;
     }
+    const companionVariant = registry.get(variantAtom).variant;
     const plankIds = new Set(deck.solo ? [
       deck.solo
     ] : deck.active);
@@ -80,12 +84,12 @@ var companion_chat_provisioner_default = Capability.makeModule(Effect.fnUntraced
       }
     }
     for (const plankId of plankIds) {
-      const resolved = provisionForPlank(plankId, deck.companionVariant);
+      const resolved = provisionForPlank(plankId, companionVariant);
       if (resolved) {
         unsubPlank(plankId);
       } else if (!plankSubs.has(plankId)) {
         plankSubs.set(plankId, registry.subscribe(graph.connections(plankId, "child"), () => {
-          if (provisionForPlank(plankId, deck.companionVariant)) {
+          if (provisionForPlank(plankId, registry.get(variantAtom).variant)) {
             unsubPlank(plankId);
           }
         }));
@@ -95,14 +99,16 @@ var companion_chat_provisioner_default = Capability.makeModule(Effect.fnUntraced
   provision();
   const unsub1 = registry.subscribe(deckStateAtom, provision);
   const unsub2 = registry.subscribe(stateAtom, provision);
+  const unsub3 = registry.subscribe(variantAtom, provision);
   return Capability.contributes(Capabilities.Null, null, () => Effect.sync(() => {
     unsub1();
     unsub2();
+    unsub3();
     unsubAllPlanks();
   }));
 }));
 var resolveEffectiveVariant = (graph, plankId, preferredVariant) => {
-  const companions = Graph.getConnections(graph, plankId, "child").filter((node) => node.type === PLANK_COMPANION_TYPE).toSorted((a, b) => byPosition(a.properties, b.properties));
+  const companions = Graph.getConnections(graph, plankId, "child").filter((node) => node.type === PLANK_COMPANION_TYPE).toSorted((a, b) => Position.compare(a.properties, b.properties));
   if (companions.length === 0) {
     return void 0;
   }
@@ -117,4 +123,4 @@ var resolveEffectiveVariant = (graph, plankId, preferredVariant) => {
 export {
   companion_chat_provisioner_default as default
 };
-//# sourceMappingURL=companion-chat-provisioner-YZZ73P6E.mjs.map
+//# sourceMappingURL=companion-chat-provisioner-IQV5VIVE.mjs.map

package/dist/lib/neutral/companion-chat-provisioner-IQV5VIVE.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/capabilities/companion-chat-provisioner.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Registry } from '@effect-atom/atom-react';\nimport * as Effect from 'effect/Effect';\nimport * as Option from 'effect/Option';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport { Graph, type Node } from '@dxos/app-graph';\nimport { AppCapabilities } from '@dxos/app-toolkit';\nimport { Chat } from '@dxos/assistant-toolkit';\nimport { Obj } from '@dxos/echo';\nimport { log } from '@dxos/log';\nimport { AttentionCapabilities } from '@dxos/plugin-attention';\nimport {\n  COMPANION_VIEW_STATE_CONTEXT,\n  DeckCapabilities,\n  PLANK_COMPANION_TYPE,\n  type StoredDeckState,\n  companionVariantAspect,\n} from '@dxos/plugin-deck';\nimport { getLinkedVariant } from '@dxos/react-ui-attention';\nimport { Position } from '@dxos/util';\n\nimport { ASSISTANT_COMPANION_VARIANT } from '#meta';\nimport { AssistantCapabilities, AssistantOperation } from '#types';\n\n/**\n * Non-React capability that watches deck companion state and provisions transient chats\n * for active planks when the assistant companion is selected.\n */\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    const operationInvoker = yield* Capability.get(Capabilities.OperationInvoker);\n    const { graph } = yield* Capability.get(AppCapabilities.AppGraph);\n    const registry: Registry.Registry = yield* Capability.get(Capabilities.AtomRegistry);\n    const deckStateAtom = yield* Capability.get(DeckCapabilities.State);\n    const cacheAtom = yield* Capability.get(AssistantCapabilities.CompanionChatCache);\n    const stateAtom = yield* Capability.get(AssistantCapabilities.State);\n    // The selected companion variant moved off deck state into a global view-state aspect; read and\n    // observe it directly so a tab switch (which no longer touches deck state) still re-provisions.\n    const viewState = yield* Capability.get(AttentionCapabilities.ViewState);\n    const variantAtom = viewState.atom(companionVariantAspect, COMPANION_VIEW_STATE_CONTEXT);\n\n    const plankSubs = new Map<string, () => void>();\n\n    /** Unsubscribe a single plank and remove it from the map. */\n    const unsubPlank = (plankId: string) => {\n      plankSubs.get(plankId)?.();\n      plankSubs.delete(plankId);\n    };\n\n    /** Unsubscribe all per-plank subscriptions. */\n    const unsubAllPlanks = () => {\n      for (const unsub of plankSubs.values()) {\n        unsub();\n      }\n      plankSubs.clear();\n    };\n\n    /**\n     * Attempt to provision for a single plank.\n     * Returns true when the plank is resolved (provisioned or already cached)\n     * so the caller can tear down the connection subscription.\n     */\n    const provisionForPlank = (plankId: string, companionVariant: string | undefined): boolean => {\n      const node: Node.Node | null = Graph.getNode(graph, plankId).pipe(Option.getOrNull);\n      if (!node || !Obj.isObject(node.data) || Obj.instanceOf(Chat.Chat, node.data)) {\n        return false;\n      }\n\n      if (resolveEffectiveVariant(graph, plankId, companionVariant) !== ASSISTANT_COMPANION_VARIANT) {\n        return false;\n      }\n\n      const object = node.data;\n      const companionUri = Obj.getURI(object);\n      const cache = registry.get(cacheAtom);\n      if (cache[companionUri]) {\n        return true;\n      }\n\n      const db = Obj.getDatabase(object);\n      if (!db) {\n        log.warn('No db for object', { plankId, companionUri });\n        return false;\n      }\n\n      void operationInvoker\n        .invokePromise(AssistantOperation.EnsureCompanionChat, { db, companionTo: object })\n        .catch((error) => log.warn('Failed to provision companion chat', { plankId, error }));\n\n      return false;\n    };\n\n    const provision = () => {\n      const deckState: StoredDeckState = registry.get(deckStateAtom);\n      const deck = deckState.decks[deckState.activeDeck];\n      if (!deck?.companionOpen) {\n        unsubAllPlanks();\n        return;\n      }\n\n      const companionVariant = registry.get(variantAtom).variant;\n      const plankIds = new Set(deck.solo ? [deck.solo] : deck.active);\n\n      // Remove subscriptions for planks that are no longer active.\n      for (const trackedId of plankSubs.keys()) {\n        if (!plankIds.has(trackedId)) {\n          unsubPlank(trackedId);\n        }\n      }\n\n      for (const plankId of plankIds) {\n        const resolved = provisionForPlank(plankId, companionVariant);\n\n        if (resolved) {\n          // Already provisioned — no need to watch connections.\n          unsubPlank(plankId);\n        } else if (!plankSubs.has(plankId)) {\n          // Not yet resolved — subscribe to child connections so we re-try\n          // when graph builder extensions add companion nodes (after expand). This subscription\n          // outlives the current `provision()` run, so re-read the latest variant at callback time\n          // rather than closing over the one captured here.\n          plankSubs.set(\n            plankId,\n            registry.subscribe(graph.connections(plankId, 'child'), () => {\n              if (provisionForPlank(plankId, registry.get(variantAtom).variant)) {\n                unsubPlank(plankId);\n              }\n            }),\n          );\n        }\n      }\n    };\n\n    provision();\n\n    const unsub1 = registry.subscribe(deckStateAtom, provision);\n    const unsub2 = registry.subscribe(stateAtom, provision);\n    const unsub3 = registry.subscribe(variantAtom, provision);\n\n    return Capability.contributes(Capabilities.Null, null, () =>\n      Effect.sync(() => {\n        unsub1();\n        unsub2();\n        unsub3();\n        unsubAllPlanks();\n      }),\n    );\n  }),\n);\n\n/**\n * Mirrors useSelectedCompanion fallback logic outside of React.\n * Returns the variant that would actually be rendered for a given plank.\n */\nconst resolveEffectiveVariant = (\n  graph: Graph.BaseGraph,\n  plankId: string,\n  preferredVariant: string | undefined,\n): string | undefined => {\n  const companions = Graph.getConnections(graph, plankId, 'child')\n    .filter((node) => node.type === PLANK_COMPANION_TYPE)\n    .toSorted((a, b) => Position.compare(a.properties, b.properties));\n\n  if (companions.length === 0) {\n    return undefined;\n  }\n\n  if (preferredVariant) {\n    const preferred = companions.find((companion) => getLinkedVariant(companion.id) === preferredVariant);\n    if (preferred) {\n      return getLinkedVariant(preferred.id);\n    }\n  }\n\n  return getLinkedVariant(companions[0].id);\n};\n"],
+  "mappings": "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",
+  "names": ["Effect", "Option", "Capabilities", "Capability", "Graph", "AppCapabilities", "Chat", "Obj", "log", "AttentionCapabilities", "COMPANION_VIEW_STATE_CONTEXT", "DeckCapabilities", "PLANK_COMPANION_TYPE", "companionVariantAspect", "getLinkedVariant", "Position", "ASSISTANT_COMPANION_VARIANT", "AssistantCapabilities", "AssistantOperation", "registry", "AtomRegistry", "deckStateAtom", "get", "State", "cacheAtom", "CompanionChatCache", "stateAtom", "plankSubs", "Map", "plankId", "unsub", "clear", "node", "resolveEffectiveVariant", "object", "cache", "companionUri", "warn", "operationInvoker", "companionTo", "catch", "error", "provision", "deckState", "deck", "companionOpen", "unsubAllPlanks", "trackedId", "unsubPlank", "resolved", "unsub2", "unsub3", "subscribe", "variantAtom", "contributes", "Null", "unsub1", "companions", "undefined", "preferredVariant", "preferred"]
+}