@dxos/plugin-assistant 0.8.4-main.ead640a → 0.8.4-main.effb148878

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

@@ -0,0 +1,106 @@
+// src/containers/ChatArticle/ChatArticle.tsx
+import React, { forwardRef, useEffect, useRef } from "react";
+import { Capabilities } from "@dxos/app-framework";
+import { useAtomCapability, useCapability } from "@dxos/app-framework/ui";
+import { getSpace } from "@dxos/client/echo";
+import { Panel } from "@dxos/react-ui";
+import { getParentId } from "@dxos/react-ui-attention";
+import { Chat as ChatComponent } from "#components";
+import { useBlueprintRegistry, useChatProcessor, useChatServices, useOnline, usePresets } from "#hooks";
+import { AssistantCapabilities } from "#types";
+var ChatArticle = /* @__PURE__ */ forwardRef((props, forwardedRef) => {
+  const { role, attendableId, subject: chat, space: spaceProp, companionTo, onEvent } = props;
+  const parentId = attendableId ? getParentId(attendableId) : void 0;
+  const space = spaceProp ?? getSpace(chat);
+  const settings = useAtomCapability(AssistantCapabilities.Settings);
+  const runtime = useChatServices({
+    id: space?.id
+  });
+  const [online, setOnline] = useOnline();
+  const { preset, ...chatProps } = usePresets(online);
+  const blueprintRegistry = useBlueprintRegistry();
+  const processor = useChatProcessor({
+    space,
+    chat,
+    preset,
+    runtime,
+    blueprintRegistry,
+    settings
+  });
+  const registry = useCapability(Capabilities.AtomRegistry);
+  const stateAtom = useCapability(AssistantCapabilities.State);
+  const pendingSubmitted = useRef(false);
+  useEffect(() => {
+    if (!processor || !attendableId || pendingSubmitted.current) {
+      return;
+    }
+    const state = registry.get(stateAtom);
+    const pendingPrompt = state.pendingPrompts[attendableId];
+    if (pendingPrompt) {
+      pendingSubmitted.current = true;
+      registry.update(stateAtom, (current) => {
+        const { [attendableId]: _, ...rest } = current.pendingPrompts;
+        return {
+          ...current,
+          pendingPrompts: rest
+        };
+      });
+      void processor.request({
+        message: pendingPrompt
+      });
+    }
+  }, [
+    processor,
+    attendableId,
+    registry,
+    stateAtom
+  ]);
+  const feedTarget = chat?.feed.target;
+  const view = chat?.view ?? settings.chatView;
+  if (!processor) {
+    return null;
+  }
+  return /* @__PURE__ */ React.createElement(ChatComponent.Root, {
+    db: space?.db,
+    chat,
+    feed: feedTarget,
+    processor,
+    onEvent
+  }, /* @__PURE__ */ React.createElement(Panel.Root, {
+    role,
+    ref: forwardedRef
+  }, /* @__PURE__ */ React.createElement(Panel.Toolbar, {
+    className: "bg-toolbar-surface"
+  }, /* @__PURE__ */ React.createElement(ChatComponent.Toolbar, {
+    classNames: "dx-document",
+    attendableId,
+    companionTo
+  })), /* @__PURE__ */ React.createElement(Panel.Content, null, /* @__PURE__ */ React.createElement(ChatComponent.Content, null, /* @__PURE__ */ React.createElement("div", {
+    className: "dx-container relative"
+  }, /* @__PURE__ */ React.createElement(ChatComponent.Thread, {
+    viewType: view
+  }), view !== "summary" && /* @__PURE__ */ React.createElement("div", {
+    className: "absolute bottom-2 left-0 right-0"
+  }, /* @__PURE__ */ React.createElement("div", {
+    className: "dx-document px-4"
+  }, /* @__PURE__ */ React.createElement(ChatComponent.Status, {
+    classNames: "px-3 rounded-sm bg-group-surface"
+  })))), /* @__PURE__ */ React.createElement("div", {
+    className: "dx-document px-4 pb-4"
+  }, /* @__PURE__ */ React.createElement("div", {
+    className: "flex flex-col items-center py-2 overflow-hidden"
+  }, /* @__PURE__ */ React.createElement(ChatComponent.TaskList, {
+    classNames: "max-h-[120px] border border-separator rounded-sm text-description"
+  })), /* @__PURE__ */ React.createElement(ChatComponent.Prompt, {
+    ...chatProps,
+    outline: true,
+    preset: preset?.id,
+    online,
+    onOnlineChange: setOnline
+  }))))));
+});
+
+export {
+  ChatArticle
+};
+//# sourceMappingURL=chunk-SLIPV6NN.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/containers/ChatArticle/ChatArticle.tsx"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport React, { forwardRef, useEffect, useRef } from 'react';\n\nimport { Capabilities } from '@dxos/app-framework';\nimport { useAtomCapability, useCapability } from '@dxos/app-framework/ui';\nimport { type AppSurface } from '@dxos/app-toolkit/ui';\nimport { type Space, getSpace } from '@dxos/client/echo';\nimport { type Obj } from '@dxos/echo';\nimport { Panel } from '@dxos/react-ui';\nimport { getParentId } from '@dxos/react-ui-attention';\n\nimport { Chat as ChatComponent, type ChatRootProps } from '#components';\nimport { useBlueprintRegistry, useChatProcessor, useChatServices, useOnline, usePresets } from '#hooks';\nimport { type Assistant, AssistantCapabilities, type ChatType } from '#types';\n\nexport type ChatArticleProps = (\n  | AppSurface.ObjectArticleProps<ChatType.Chat | undefined>\n  | AppSurface.ObjectSectionProps<ChatType.Chat | undefined>\n) & {\n  space?: Space;\n  companionTo?: Obj.Unknown;\n} & Pick<ChatRootProps, 'onEvent'>;\n\nexport const ChatArticle = forwardRef<HTMLDivElement, ChatArticleProps>((props, forwardedRef) => {\n  const { role, attendableId, subject: chat, space: spaceProp, companionTo, onEvent } = props;\n  const parentId = attendableId ? getParentId(attendableId) : undefined;\n  const space = spaceProp ?? getSpace(chat);\n  const settings = useAtomCapability(AssistantCapabilities.Settings);\n  const runtime = useChatServices({ id: space?.id });\n  const [online, setOnline] = useOnline();\n  const { preset, ...chatProps } = usePresets(online);\n  const blueprintRegistry = useBlueprintRegistry();\n  const processor = useChatProcessor({\n    space,\n    chat,\n    preset,\n    runtime,\n    blueprintRegistry,\n    settings,\n  });\n\n  const registry = useCapability(Capabilities.AtomRegistry);\n  const stateAtom = useCapability(AssistantCapabilities.State);\n  const pendingSubmitted = useRef(false);\n  useEffect(() => {\n    if (!processor || !attendableId || pendingSubmitted.current) {\n      return;\n    }\n\n    const state = registry.get(stateAtom);\n    const pendingPrompt = state.pendingPrompts[attendableId];\n    if (pendingPrompt) {\n      pendingSubmitted.current = true;\n      registry.update(stateAtom, (current) => {\n        const { [attendableId]: _, ...rest } = current.pendingPrompts;\n        return { ...current, pendingPrompts: rest };\n      });\n      void processor.request({ message: pendingPrompt });\n    }\n  }, [processor, attendableId, registry, stateAtom]);\n\n  const feedTarget = chat?.feed.target;\n  const view = (chat?.view as Assistant.ChatView | undefined) ?? settings.chatView;\n\n  if (!processor) {\n    return null;\n  }\n\n  return (\n    <ChatComponent.Root db={space?.db} chat={chat} feed={feedTarget} processor={processor} onEvent={onEvent}>\n      <Panel.Root role={role} ref={forwardedRef}>\n        <Panel.Toolbar className='bg-toolbar-surface'>\n          <ChatComponent.Toolbar classNames='dx-document' attendableId={attendableId} companionTo={companionTo} />\n        </Panel.Toolbar>\n        <Panel.Content>\n          <ChatComponent.Content>\n            <div className='dx-container relative'>\n              <ChatComponent.Thread viewType={view} />\n              {view !== 'summary' && (\n                <div className='absolute bottom-2 left-0 right-0'>\n                  <div className='dx-document px-4'>\n                    <ChatComponent.Status classNames='px-3 rounded-sm bg-group-surface' />\n                  </div>\n                </div>\n              )}\n            </div>\n            <div className='dx-document px-4 pb-4'>\n              <div className='flex flex-col items-center py-2 overflow-hidden'>\n                <ChatComponent.TaskList classNames='max-h-[120px] border border-separator rounded-sm text-description' />\n              </div>\n              <ChatComponent.Prompt\n                {...chatProps}\n                outline\n                preset={preset?.id}\n                online={online}\n                onOnlineChange={setOnline}\n              />\n            </div>\n          </ChatComponent.Content>\n        </Panel.Content>\n      </Panel.Root>\n    </ChatComponent.Root>\n  );\n});\n"],
+  "mappings": "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",
+  "names": ["React", "forwardRef", "useEffect", "useRef", "Capabilities", "useAtomCapability", "useCapability", "getSpace", "Panel", "getParentId", "Chat", "ChatComponent", "useBlueprintRegistry", "useChatProcessor", "useChatServices", "useOnline", "usePresets", "AssistantCapabilities", "ChatArticle", "props", "forwardedRef", "role", "attendableId", "subject", "chat", "space", "spaceProp", "companionTo", "onEvent", "parentId", "undefined", "settings", "Settings", "runtime", "id", "online", "setOnline", "preset", "chatProps", "blueprintRegistry", "processor", "registry", "AtomRegistry", "stateAtom", "State", "pendingSubmitted", "current", "state", "get", "pendingPrompt", "pendingPrompts", "update", "_", "rest", "request", "message", "feedTarget", "feed", "target", "view", "chatView", "Root", "db", "ref", "Toolbar", "className", "classNames", "Content", "div", "Thread", "viewType", "Status", "TaskList", "Prompt", "outline", "onOnlineChange"]
+}

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

@@ -0,0 +1,41 @@
+// src/meta.ts
+import { trim } from "@dxos/util";
+var meta = {
+  id: "org.dxos.plugin.assistant",
+  name: "Assistant",
+  author: "DXOS",
+  description: trim`
+    AssistantPlugin brings a conversational AI assistant into DXOS Composer, letting users chat naturally
+    with objects in their spaces. Every Chat is a first-class ECHO object — messages are persisted,
+    replicated across peers in real time, and can be bound to any document or collection as a companion
+    panel that appears alongside the primary view.
+
+    AI capabilities are delivered through a flexible multi-provider model layer. Users can route requests
+    to the DXOS Edge service, a locally running Ollama instance, or LM Studio, and switch providers at
+    any time in Settings. Each provider can be configured with a preferred model, and the runtime
+    automatically falls back when a provider is unavailable.
+
+    Blueprints give every chat a specialised identity. Built-in blueprints cover general assistance,
+    web browsing, database interaction, web search, Discord and Linear integration, autonomous agents,
+    planning, memory, automation, and a wizard for authoring new blueprints. Binding a blueprint
+    changes the system instructions and the tool set exposed to the model in a single step.
+
+    Tool execution runs through the DXOS compute runtime so every AI action — opening a document,
+    searching the web, querying a database — produces a structured execution trace. The optional
+    TracePanel visualises that trace as a commit graph or raw JSON, giving developers full observability
+    into what the model did and why.
+  `,
+  icon: "ph--sparkle--regular",
+  iconHue: "sky",
+  source: "https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-assistant",
+  spec: "PLUGIN.mdl"
+};
+var ASSISTANT_DIALOG = `${meta.id}.assistant.dialog`;
+var ASSISTANT_COMPANION_VARIANT = "assistant-chat";
+
+export {
+  meta,
+  ASSISTANT_DIALOG,
+  ASSISTANT_COMPANION_VARIANT
+};
+//# sourceMappingURL=chunk-ZWY6Y5IW.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/meta.ts"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Plugin } from '@dxos/app-framework';\nimport { trim } from '@dxos/util';\n\nexport const meta: Plugin.Meta = {\n  id: 'org.dxos.plugin.assistant',\n  name: 'Assistant',\n  author: 'DXOS',\n  description: trim`\n    AssistantPlugin brings a conversational AI assistant into DXOS Composer, letting users chat naturally\n    with objects in their spaces. Every Chat is a first-class ECHO object — messages are persisted,\n    replicated across peers in real time, and can be bound to any document or collection as a companion\n    panel that appears alongside the primary view.\n\n    AI capabilities are delivered through a flexible multi-provider model layer. Users can route requests\n    to the DXOS Edge service, a locally running Ollama instance, or LM Studio, and switch providers at\n    any time in Settings. Each provider can be configured with a preferred model, and the runtime\n    automatically falls back when a provider is unavailable.\n\n    Blueprints give every chat a specialised identity. Built-in blueprints cover general assistance,\n    web browsing, database interaction, web search, Discord and Linear integration, autonomous agents,\n    planning, memory, automation, and a wizard for authoring new blueprints. Binding a blueprint\n    changes the system instructions and the tool set exposed to the model in a single step.\n\n    Tool execution runs through the DXOS compute runtime so every AI action — opening a document,\n    searching the web, querying a database — produces a structured execution trace. The optional\n    TracePanel visualises that trace as a commit graph or raw JSON, giving developers full observability\n    into what the model did and why.\n  `,\n  icon: 'ph--sparkle--regular',\n  iconHue: 'sky',\n  source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-assistant',\n  spec: 'PLUGIN.mdl',\n};\n\nexport const ASSISTANT_DIALOG = `${meta.id}.assistant.dialog`;\n\n/** Companion variant identifier for the assistant chat panel. */\nexport const ASSISTANT_COMPANION_VARIANT = 'assistant-chat';\n"],
+  "mappings": ";AAKA,SAASA,YAAY;AAEd,IAAMC,OAAoB;EAC/BC,IAAI;EACJC,MAAM;EACNC,QAAQ;EACRC,aAAaL;;;;;;;;;;;;;;;;;;;;;EAqBbM,MAAM;EACNC,SAAS;EACTC,QAAQ;EACRC,MAAM;AACR;AAEO,IAAMC,mBAAmB,GAAGT,KAAKC,EAAE;AAGnC,IAAMS,8BAA8B;",
+  "names": ["trim", "meta", "id", "name", "author", "description", "icon", "iconHue", "source", "spec", "ASSISTANT_DIALOG", "ASSISTANT_COMPANION_VARIANT"]
+}

package/dist/lib/neutral/companion-chat-provisioner-7RTSXL6M.mjs

@@ -0,0 +1,116 @@
+import "./chunk-J5LGTIGS.mjs";
+
+// src/capabilities/companion-chat-provisioner.ts
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { Capabilities, Capability } from "@dxos/app-framework";
+import { Graph } from "@dxos/app-graph";
+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 { getLinkedVariant } from "@dxos/react-ui-attention";
+import { byPosition } 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";
+var companion_chat_provisioner_default = Capability.makeModule(Effect.fnUntraced(function* () {
+  const operationInvoker = yield* Capability.get(Capabilities.OperationInvoker);
+  const { graph } = yield* Capability.get(AppCapabilities.AppGraph);
+  const registry = yield* Capability.get(Capabilities.AtomRegistry);
+  const deckStateAtom = yield* Capability.get(DeckCapabilities.State);
+  const cacheAtom = yield* Capability.get(AssistantCapabilities.CompanionChatCache);
+  const stateAtom = yield* Capability.get(AssistantCapabilities.State);
+  const plankSubs = /* @__PURE__ */ new Map();
+  const unsubPlank = (plankId) => {
+    plankSubs.get(plankId)?.();
+    plankSubs.delete(plankId);
+  };
+  const unsubAllPlanks = () => {
+    for (const unsub of plankSubs.values()) {
+      unsub();
+    }
+    plankSubs.clear();
+  };
+  const provisionForPlank = (plankId, companionVariant) => {
+    const node = Graph.getNode(graph, plankId).pipe(Option.getOrNull);
+    if (!node || !Obj.isObject(node.data) || Obj.instanceOf(Chat.Chat, node.data)) {
+      return false;
+    }
+    if (resolveEffectiveVariant(graph, plankId, companionVariant) !== ASSISTANT_COMPANION_VARIANT) {
+      return false;
+    }
+    const object = node.data;
+    const companionUri = Obj.getURI(object);
+    const cache = registry.get(cacheAtom);
+    if (cache[companionUri]) {
+      return true;
+    }
+    const db = Obj.getDatabase(object);
+    if (!db) {
+      return false;
+    }
+    void operationInvoker.invokePromise(AssistantOperation.EnsureCompanionChat, {
+      db,
+      companionTo: object
+    }).catch((error) => log.warn("Failed to provision companion chat", {
+      plankId,
+      error
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 63, S: this }));
+    return false;
+  };
+  const provision = () => {
+    const deckState = registry.get(deckStateAtom);
+    const deck = deckState.decks[deckState.activeDeck];
+    if (!deck?.companionOpen) {
+      unsubAllPlanks();
+      return;
+    }
+    const plankIds = new Set(deck.solo ? [
+      deck.solo
+    ] : deck.active);
+    for (const trackedId of plankSubs.keys()) {
+      if (!plankIds.has(trackedId)) {
+        unsubPlank(trackedId);
+      }
+    }
+    for (const plankId of plankIds) {
+      const resolved = provisionForPlank(plankId, deck.companionVariant);
+      if (resolved) {
+        unsubPlank(plankId);
+      } else if (!plankSubs.has(plankId)) {
+        plankSubs.set(plankId, registry.subscribe(graph.connections(plankId, "child"), () => {
+          if (provisionForPlank(plankId, deck.companionVariant)) {
+            unsubPlank(plankId);
+          }
+        }));
+      }
+    }
+  };
+  provision();
+  const unsub1 = registry.subscribe(deckStateAtom, provision);
+  const unsub2 = registry.subscribe(stateAtom, provision);
+  return Capability.contributes(Capabilities.Null, null, () => Effect.sync(() => {
+    unsub1();
+    unsub2();
+    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));
+  if (companions.length === 0) {
+    return void 0;
+  }
+  if (preferredVariant) {
+    const preferred = companions.find((companion) => getLinkedVariant(companion.id) === preferredVariant);
+    if (preferred) {
+      return getLinkedVariant(preferred.id);
+    }
+  }
+  return getLinkedVariant(companions[0].id);
+};
+export {
+  companion_chat_provisioner_default as default
+};
+//# sourceMappingURL=companion-chat-provisioner-7RTSXL6M.mjs.map

package/dist/lib/neutral/companion-chat-provisioner-7RTSXL6M.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 { DeckCapabilities, PLANK_COMPANION_TYPE, type StoredDeckState } from '@dxos/plugin-deck';\nimport { getLinkedVariant } from '@dxos/react-ui-attention';\nimport { byPosition } 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\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        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 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, deck.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).\n          plankSubs.set(\n            plankId,\n            registry.subscribe(graph.connections(plankId, 'child'), () => {\n              if (provisionForPlank(plankId, deck.companionVariant)) {\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\n    return Capability.contributes(Capabilities.Null, null, () =>\n      Effect.sync(() => {\n        unsub1();\n        unsub2();\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) => byPosition(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", "DeckCapabilities", "PLANK_COMPANION_TYPE", "getLinkedVariant", "byPosition", "ASSISTANT_COMPANION_VARIANT", "AssistantCapabilities", "AssistantOperation", "registry", "AtomRegistry", "deckStateAtom", "get", "State", "cacheAtom", "CompanionChatCache", "stateAtom", "plankSubs", "Map", "plankId", "unsub", "clear", "node", "resolveEffectiveVariant", "object", "cache", "companionUri", "operationInvoker", "companionTo", "catch", "error", "provision", "deckState", "deck", "companionOpen", "unsubAllPlanks", "trackedId", "unsubPlank", "resolved", "unsub2", "contributes", "unsub1", "companions", "undefined", "preferredVariant", "preferred"]
+}