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

package/src/types/AssistantEvents.ts

@@ -0,0 +1,11 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+// @import-as-namespace
+
+import { ActivationEvent } from '@dxos/app-framework';
+
+import { meta } from '#meta';
+
+export const SetupAiServiceProviders = ActivationEvent.make(`${meta.id}.event.setup-ai-service-providers`);

package/src/types/AssistantOperation.ts

@@ -0,0 +1,152 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+// @import-as-namespace
+
+import * as Schema from 'effect/Schema';
+
+import { AiService } from '@dxos/ai';
+import { Capability } from '@dxos/app-framework';
+import { Chat } from '@dxos/assistant-toolkit';
+import { SpaceSchema } from '@dxos/client/echo';
+import { Routine, Operation } from '@dxos/compute';
+import { Collection, Database, Feed, Obj, Ref, Type } from '@dxos/echo';
+import { DXN } from '@dxos/keys';
+
+import { meta } from '#meta';
+
+const ASSISTANT_OPERATION = `${meta.id}.operation`;
+
+export const OnCreateSpace = Operation.make({
+  meta: { key: `${ASSISTANT_OPERATION}.on-create-space`, name: 'On Create Space', icon: 'ph--chat-text--regular' },
+  services: [Capability.Service],
+  input: Schema.Struct({
+    space: SpaceSchema,
+    rootCollection: Type.getSchema(Collection.Collection),
+  }),
+  output: Schema.Void,
+});
+
+export const CreateChat = Operation.make({
+  meta: { key: `${ASSISTANT_OPERATION}.create-chat`, name: 'Create Chat', icon: 'ph--chat-text--regular' },
+  services: [Capability.Service],
+  input: Schema.Struct({
+    db: Database.Database,
+    name: Schema.optional(Schema.String),
+    /** If false, chat is created in-memory only and not added to space. Defaults to true. */
+    addToSpace: Schema.optional(Schema.Boolean),
+  }),
+  output: Schema.Struct({
+    object: Type.getSchema(Chat.Chat),
+  }),
+});
+
+export const UpdateChatName = Operation.make({
+  meta: { key: `${ASSISTANT_OPERATION}.update-chat-name`, name: 'Update Chat Name', icon: 'ph--pencil--regular' },
+  services: [Database.Service, Feed.FeedService, AiService.AiService],
+  input: Schema.Struct({
+    chat: Type.getSchema(Chat.Chat),
+  }),
+  output: Schema.Void,
+});
+
+export const SetCurrentChat = Operation.make({
+  meta: { key: `${ASSISTANT_OPERATION}.set-current-chat`, name: 'Set Current Chat', icon: 'ph--chat-text--regular' },
+  services: [Capability.Service],
+  input: Schema.Struct({
+    companionTo: Obj.Unknown,
+    chat: Type.getSchema(Chat.Chat).pipe(Schema.optional),
+  }),
+  output: Schema.Void,
+});
+
+export const RunPromptInNewChat = Operation.make({
+  meta: {
+    key: `${ASSISTANT_OPERATION}.run-prompt-in-new-chat`,
+    name: 'Run Prompt In New Chat',
+    icon: 'ph--chat-text--regular',
+  },
+  services: [Capability.Service],
+  input: Schema.Struct({
+    db: Database.Database,
+    /** Context objects to bind to the new chat. */
+    objects: Schema.optional(Schema.Array(Obj.Unknown)),
+    /** Blueprint keys to look up and bind to the new chat. */
+    blueprints: Schema.optional(Schema.Array(Schema.String)),
+    /** Raw instructions or an existing Routine object reference. */
+    prompt: Schema.Union(Schema.String, Ref.Ref(Routine.Routine)),
+    /**
+     * When true, skips opening the chat: runs the Agent prompt operation against the new chat via the compute runtime (traced).
+     */
+    background: Schema.optional(Schema.Boolean),
+  }),
+  output: Schema.Struct({
+    object: Type.getSchema(Chat.Chat),
+  }),
+});
+
+const NavigationTargetSchema = Schema.Struct({
+  path: Schema.String.annotations({ description: 'Navigation path to use with the Open operation.' }),
+  label: Schema.String.annotations({ description: 'Human-readable label.' }),
+  type: Schema.String.annotations({ description: 'Object type.' }),
+});
+
+export const ResolveNavigationTargets = Operation.make({
+  meta: {
+    key: `${ASSISTANT_OPERATION}.resolve-navigation-targets`,
+    name: 'Resolve navigation targets',
+    description:
+      'Resolve navigation targets within the application. The returned paths can be used with the Open operation. Without a query, returns pages that can be navigated to.',
+    icon: 'ph--compass--regular',
+  },
+  input: Schema.Struct({
+    query: Schema.optional(
+      Schema.Struct({
+        dxn: Schema.optional(DXN.Schema),
+      }),
+    ),
+  }),
+  output: Schema.Struct({
+    targets: Schema.Array(NavigationTargetSchema),
+  }),
+  services: [Capability.Service],
+});
+
+export const EnsureCompanionChat = Operation.make({
+  meta: {
+    key: `${ASSISTANT_OPERATION}.ensure-companion-chat`,
+    name: 'Ensure Companion Chat',
+    icon: 'ph--chat-text--regular',
+  },
+  services: [Capability.Service],
+  input: Schema.Struct({
+    db: Database.Database,
+    companionTo: Obj.Unknown,
+  }),
+  output: Schema.Struct({
+    chat: Type.getSchema(Chat.Chat),
+    /** Whether the returned chat was already persisted in the space. */
+    persisted: Schema.Boolean,
+  }),
+});
+
+export const BlueprintForm = Schema.Struct({
+  key: Schema.String,
+  name: Schema.String,
+  description: Schema.optional(Schema.String),
+});
+
+export const ToggleTracePanelDebug = Operation.make({
+  meta: {
+    key: `${ASSISTANT_OPERATION}.toggle-trace-panel-debug`,
+    name: 'Toggle trace panel debug',
+    description: 'Toggle trace panel between commit graph and raw span tree JSON.',
+    icon: 'ph--bug--regular',
+  },
+  services: [Capability.Service],
+  input: Schema.Struct({
+    state: Schema.optional(Schema.Boolean),
+  }),
+  output: Schema.Boolean,
+});

package/src/types/Settings.ts

@@ -0,0 +1,82 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+// @import-as-namespace
+
+import * as Schema from 'effect/Schema';
+
+import { getLiteralValues } from '@dxos/effect';
+
+export const ModelProvider = Schema.Union(
+  Schema.Literal('edge').annotations({ title: 'DXOS' }),
+  Schema.Literal('ollama').annotations({ title: 'Ollama' }),
+  Schema.Literal('lmstudio').annotations({ title: 'LM Studio' }),
+);
+export type ModelProvider = Schema.Schema.Type<typeof ModelProvider>;
+export const ModelProviders = getLiteralValues(ModelProvider);
+
+export const ChatView = Schema.Union(
+  Schema.Literal('normal').annotations({ title: 'Normal' }),
+  Schema.Literal('summary').annotations({ title: 'Summary' }),
+  Schema.Literal('thinking').annotations({ title: 'Thinking' }),
+  Schema.Literal('debug').annotations({ title: 'Debug' }),
+);
+export type ChatView = Schema.Schema.Type<typeof ChatView>;
+export const ChatViews = getLiteralValues(ChatView);
+
+export const ModelDefaults = Schema.mutable(
+  Schema.Struct({
+    edge: Schema.optional(
+      Schema.String.annotations({
+        title: 'Remote language model',
+        description: 'Choose the remote language model used for AI requests.',
+      }),
+    ),
+    ollama: Schema.optional(
+      Schema.String.annotations({
+        title: 'Ollama language model',
+        description: 'Choose the locally hosted Ollama model for AI requests.',
+      }),
+    ),
+    lmstudio: Schema.optional(
+      Schema.String.annotations({
+        title: 'LM Studio language model',
+        description: 'Choose the locally hosted LM Studio model for AI requests.',
+      }),
+    ),
+  }),
+);
+export type ModelDefaults = Schema.Schema.Type<typeof ModelDefaults>;
+
+export const Settings = Schema.mutable(
+  Schema.Struct({
+    customPrompts: Schema.optional(
+      Schema.Boolean.annotations({
+        title: 'Use custom prompts',
+        description: 'Allow the assistant to use custom prompts defined in your spaces.',
+      }),
+    ),
+    chatView: Schema.optional(
+      ChatView.annotations({
+        title: 'Chat view',
+        description:
+          'Controls which message blocks are shown in the chat: normal hides reasoning, thinking shows reasoning, debug shows raw blocks, summary shows only conversational text.',
+      }),
+    ),
+    modelProvider: Schema.optional(
+      ModelProvider.annotations({
+        title: 'LLM provider',
+        description: 'Select which language model service to use for AI responses.',
+      }),
+    ),
+    modelDefaults: Schema.optional(ModelDefaults),
+    tracePanelDebug: Schema.optional(
+      Schema.Boolean.annotations({
+        title: 'Trace panel debug',
+        description: 'Show the raw span tree as JSON in the trace panel instead of the commit graph.',
+      }),
+    ),
+  }),
+);
+export interface Settings extends Schema.Schema.Type<typeof Settings> {}

package/src/types/index.ts

@@ -2,8 +2,14 @@
 // Copyright 2024 DXOS.org
 //
 
+// TODO(wittjosiah): Remove. This is included in Assistant namespace.
+// Re-export Chat type from assistant-toolkit for public API type declarations.
+export type { Chat as ChatType } from '@dxos/assistant-toolkit';
+
 export * as Assistant from './Assistant';
-export * as AssistantAction from './AssistantAction';
+export * as AssistantOperation from './AssistantOperation';
+export * as AssistantCapabilities from './AssistantCapabilities';
+export * as AssistantEvents from './AssistantEvents';
 
-export * from './defs';
+// TODO(wittjosiah): Namespace.
 export * from './service';

package/src/types/service.ts

@@ -4,10 +4,9 @@
 
 import * as Schema from 'effect/Schema';
 
+import { Operation } from '@dxos/compute';
 import { ComputeGraph } from '@dxos/conductor';
-import { Type } from '@dxos/echo';
-import { TypedObject } from '@dxos/echo/internal';
-import { Function } from '@dxos/functions';
+import { DXN, Ref, Type } from '@dxos/echo';
 
 // TODO(burdon): Factor out and reconcile with https://github.com/dxos/dxos/blob/main/packages/plugins/plugin-token-manager/src/defs/presets.ts#L7
 
@@ -38,12 +37,12 @@ export type ApiAuthorization = Schema.Schema.Type<typeof ApiAuthorization>;
 
 const ServiceInterfaceFunction = Schema.Struct({
   kind: Schema.Literal('function'),
-  fn: Type.Ref(Function.Function),
+  fn: Ref.Ref(Operation.PersistentOperation),
 });
 
 const ServiceInterfaceWorkflow = Schema.Struct({
   kind: Schema.Literal('workflow'),
-  workflow: Type.Ref(ComputeGraph),
+  workflow: Ref.Ref(ComputeGraph),
 });
 
 const ServiceInterfaceApi = Schema.Struct({
@@ -70,14 +69,11 @@ const ServiceInterface = Schema.Union(
   ServiceInterfaceFunction,
   ServiceInterfaceWorkflow,
   ServiceInterfaceApi,
-);
+) as any;
 
 export type ServiceInterface = Schema.Schema.Type<typeof ServiceInterface>;
 
-export class ServiceType extends TypedObject({
-  typename: 'dxos.org/type/ServiceType',
-  version: '0.1.0',
-})({
+export const ServiceType = Schema.Struct({
   serviceId: Schema.String,
   name: Schema.optional(Schema.String),
   description: Schema.optional(Schema.String),
@@ -88,7 +84,9 @@ export class ServiceType extends TypedObject({
    * Entries exposed: functions, workflows, and APIs.
    */
   interfaces: Schema.optional(Schema.Array(ServiceInterface)),
-}) {}
+}).pipe(Type.makeObject(DXN.make('org.dxos.type.service', '0.1.0')));
+
+export type ServiceType = Type.InstanceType<typeof ServiceType>;
 
 //
 // Service Registry

package/src/util/suggestions.test.ts

@@ -0,0 +1,52 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { describe, test } from 'vitest';
+
+import { parseSuggestions } from './suggestions';
+
+describe('parseSuggestions', () => {
+  test('returns [] for empty / undefined input', ({ expect }) => {
+    expect(parseSuggestions(undefined)).toEqual([]);
+    expect(parseSuggestions('')).toEqual([]);
+    expect(parseSuggestions('Just a paragraph, no headings.')).toEqual([]);
+  });
+
+  test('extracts bullets from the Suggested starting prompts section', ({ expect }) => {
+    const md = [
+      '# Title',
+      '',
+      'Some intro.',
+      '',
+      '## Suggested starting prompts',
+      '',
+      '- "Give me a 30-second tour of Composer."',
+      '- How do spaces work?',
+      "- 'Single quoted prompt'",
+      '',
+      '## Out of scope',
+      '',
+      '- Should not appear',
+    ].join('\n');
+    expect(parseSuggestions(md)).toEqual([
+      'Give me a 30-second tour of Composer.',
+      'How do spaces work?',
+      'Single quoted prompt',
+    ]);
+  });
+
+  test('matches case-insensitively and accepts "starter prompts"', ({ expect }) => {
+    expect(parseSuggestions('### SUGGESTED STARTER PROMPTS\n- Hello')).toEqual(['Hello']);
+  });
+
+  test('returns [] when section is missing or empty', ({ expect }) => {
+    expect(parseSuggestions('## Other section\n- item')).toEqual([]);
+    expect(parseSuggestions('## Suggested starting prompts\n\n## Next')).toEqual([]);
+  });
+
+  test('supports * and numbered bullets', ({ expect }) => {
+    const md = ['## Suggested starting prompts', '* First', '+ Second', '1. Third'].join('\n');
+    expect(parseSuggestions(md)).toEqual(['First', 'Second', 'Third']);
+  });
+});

package/src/util/suggestions.ts

@@ -0,0 +1,42 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+/**
+ * Extract starter-prompt suggestions from a blueprint's instructions markdown.
+ *
+ * Looks for the first `## Suggested starting prompts` heading (case-insensitive) and returns the
+ * bullet-list items immediately following it. Items wrapped in single or double quotes have their
+ * quotes stripped. Returns an empty array when the section is missing or empty.
+ */
+export const parseSuggestions = (markdown: string | undefined): string[] => {
+  if (!markdown) {
+    return [];
+  }
+
+  const lines = markdown.split('\n');
+  const headingIndex = lines.findIndex((line) => /^#{1,6}\s+suggested\s+(starting|starter)\s+prompts\b/i.test(line));
+  if (headingIndex === -1) {
+    return [];
+  }
+
+  const suggestions: string[] = [];
+  for (let i = headingIndex + 1; i < lines.length; i++) {
+    const line = lines[i];
+    // Stop at the next heading.
+    if (/^#{1,6}\s/.test(line)) {
+      break;
+    }
+    // Match `- item`, `* item`, `+ item`, or `1. item`.
+    const match = line.match(/^\s*(?:[-*+]|\d+\.)\s+(.+?)\s*$/);
+    if (match) {
+      // Strip surrounding quotes if present.
+      const text = match[1].replace(/^["'](.+)["']$/, '$1').trim();
+      if (text.length > 0) {
+        suggestions.push(text);
+      }
+    }
+  }
+
+  return suggestions;
+};

package/dist/lib/browser/BlueprintArticle-IMCR3642.mjs

@@ -1,36 +0,0 @@
-import {
-  TemplateEditor
-} from "./chunk-FJQ4ZRYJ.mjs";
-import "./chunk-WBG5PTSX.mjs";
-import "./chunk-J5LGTIGS.mjs";
-
-// src/components/BlueprintArticle.tsx
-import { useSignals as _useSignals } from "@preact-signals/safe-react/tracking";
-import React from "react";
-import { Obj } from "@dxos/echo";
-import { Toolbar } from "@dxos/react-ui";
-import { useAttention } from "@dxos/react-ui-attention";
-import { StackItem } from "@dxos/react-ui-stack";
-var BlueprintArticle = ({ subject }) => {
-  var _effect = _useSignals();
-  try {
-    const { hasAttention } = useAttention(Obj.getDXN(subject).toString());
-    return /* @__PURE__ */ React.createElement(StackItem.Content, {
-      toolbar: true
-    }, /* @__PURE__ */ React.createElement(Toolbar.Root, {
-      disabled: !hasAttention
-    }), /* @__PURE__ */ React.createElement(TemplateEditor, {
-      id: subject.id,
-      template: subject.instructions,
-      classNames: "container-max-width"
-    }));
-  } finally {
-    _effect.f();
-  }
-};
-var BlueprintArticle_default = BlueprintArticle;
-export {
-  BlueprintArticle,
-  BlueprintArticle_default as default
-};
-//# sourceMappingURL=BlueprintArticle-IMCR3642.mjs.map

package/dist/lib/browser/BlueprintArticle-IMCR3642.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/components/BlueprintArticle.tsx"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport React from 'react';\n\nimport { type SurfaceComponentProps } from '@dxos/app-framework/react';\nimport { type Blueprint } from '@dxos/blueprints';\nimport { Obj } from '@dxos/echo';\nimport { Toolbar } from '@dxos/react-ui';\nimport { useAttention } from '@dxos/react-ui-attention';\nimport { StackItem } from '@dxos/react-ui-stack';\n\nimport { TemplateEditor } from './TemplateEditor';\n\nexport type BlueprintArticleProps = SurfaceComponentProps<Blueprint.Blueprint>;\n\nexport const BlueprintArticle = ({ subject }: BlueprintArticleProps) => {\n  const { hasAttention } = useAttention(Obj.getDXN(subject).toString());\n\n  return (\n    <StackItem.Content toolbar>\n      <Toolbar.Root disabled={!hasAttention} />\n      <TemplateEditor id={subject.id} template={subject.instructions} classNames='container-max-width' />\n    </StackItem.Content>\n  );\n};\n\nexport default BlueprintArticle;\n"],
-  "mappings": ";;;;;;;;AAIA,OAAOA,WAAW;AAIlB,SAASC,WAAW;AACpB,SAASC,eAAe;AACxB,SAASC,oBAAoB;AAC7B,SAASC,iBAAiB;AAMnB,IAAMC,mBAAmB,CAAC,EAAEC,QAAO,MAAyB;;;AACjE,UAAM,EAAEC,aAAY,IAAKC,aAAaC,IAAIC,OAAOJ,OAAAA,EAASK,SAAQ,CAAA;AAElE,WACE,sBAAA,cAACC,UAAUC,SAAO;MAACC,SAAAA;OACjB,sBAAA,cAACC,QAAQC,MAAI;MAACC,UAAU,CAACV;QACzB,sBAAA,cAACW,gBAAAA;MAAeC,IAAIb,QAAQa;MAAIC,UAAUd,QAAQe;MAAcC,YAAW;;;;;AAGjF;AAEA,IAAA,2BAAejB;",
-  "names": ["React", "Obj", "Toolbar", "useAttention", "StackItem", "BlueprintArticle", "subject", "hasAttention", "useAttention", "Obj", "getDXN", "toString", "StackItem", "Content", "toolbar", "Toolbar", "Root", "disabled", "TemplateEditor", "id", "template", "instructions", "classNames"]
-}

package/dist/lib/browser/ChatCompanion-JYD2RIBJ.mjs

@@ -1,158 +0,0 @@
-import {
-  ChatContainer,
-  useBlueprintRegistry,
-  useContextBinder
-} from "./chunk-U62BTGDF.mjs";
-import "./chunk-FJQ4ZRYJ.mjs";
-import "./chunk-2BOE3OTW.mjs";
-import {
-  AssistantAction_exports,
-  Assistant_exports
-} from "./chunk-BNTPFZ7O.mjs";
-import "./chunk-WBG5PTSX.mjs";
-import "./chunk-J5LGTIGS.mjs";
-
-// src/components/ChatCompanion.tsx
-import { useSignals as _useSignals } from "@preact-signals/safe-react/tracking";
-import * as Array from "effect/Array";
-import * as Function from "effect/Function";
-import * as Option from "effect/Option";
-import React, { useCallback, useEffect, useMemo, useState } from "react";
-import { Capabilities, createIntent } from "@dxos/app-framework";
-import { useCapabilities, useIntentDispatcher } from "@dxos/app-framework/react";
-import { Blueprint } from "@dxos/blueprints";
-import { getSpace } from "@dxos/client/echo";
-import { Filter, Obj, Ref } from "@dxos/echo";
-import { SpaceAction } from "@dxos/plugin-space/types";
-import { useQuery } from "@dxos/react-client/echo";
-import { useAsyncEffect } from "@dxos/react-ui";
-var ChatCompanion = ({ role, data }) => {
-  var _effect = _useSignals();
-  try {
-    const { dispatchPromise: dispatch } = useIntentDispatcher();
-    const blueprintRegistry = useBlueprintRegistry();
-    const companionTo = data.companionTo;
-    const space = getSpace(companionTo);
-    const [chat, setChat] = useState(data.subject === "assistant-chat" ? void 0 : data.subject);
-    useEffect(() => {
-      setChat(data.subject === "assistant-chat" ? void 0 : data.subject);
-    }, [
-      data.subject
-    ]);
-    const chatQueue = space && chat ? space.queues.get(chat.queue.dxn) : void 0;
-    const binder = useContextBinder(chatQueue);
-    useAsyncEffect(async () => {
-      if (!space || chat) {
-        return;
-      }
-      const { data: data2 } = await dispatch(createIntent(AssistantAction_exports.CreateChat, {
-        space
-      }));
-      setChat(data2?.object);
-    }, [
-      chat,
-      space
-    ]);
-    const handleEvent = useCallback(async (event) => {
-      const chatInSpace = !!getSpace(chat);
-      if (chatInSpace || !chat || !space) {
-        return;
-      }
-      if (event.type === "submit") {
-        await dispatch(createIntent(SpaceAction.AddObject, {
-          object: chat,
-          target: space,
-          hidden: true
-        }));
-        await dispatch(createIntent(SpaceAction.AddRelation, {
-          space,
-          schema: Assistant_exports.CompanionTo,
-          source: chat,
-          target: companionTo
-        }));
-        await dispatch(createIntent(AssistantAction_exports.SetCurrentChat, {
-          companionTo,
-          chat
-        }));
-      }
-    }, [
-      chat,
-      space,
-      companionTo,
-      dispatch
-    ]);
-    const metadata = useCapabilities(Capabilities.Metadata);
-    const blueprintKeys = useMemo(() => Function.pipe(metadata, Array.findFirst((capability) => capability.id === Obj.getTypename(companionTo)), Option.flatMap((c) => Option.fromNullable(c.metadata.blueprints)), Option.getOrElse(() => [])), [
-      metadata,
-      companionTo
-    ]);
-    const existingBlueprints = useQuery(space, Filter.type(Blueprint.Blueprint));
-    const pluginBlueprints = useMemo(() => existingBlueprints.filter((blueprint) => blueprintKeys.includes(blueprint.key)), [
-      existingBlueprints,
-      blueprintKeys
-    ]);
-    useAsyncEffect(async () => {
-      if (!space) {
-        return;
-      }
-      const { objects: existingBlueprints2 } = await space.db.query(Filter.type(Blueprint.Blueprint)).run();
-      for (const key of blueprintKeys) {
-        const existingBlueprint = existingBlueprints2.find((blueprint2) => blueprint2.key === key);
-        if (existingBlueprint) {
-          continue;
-        }
-        const blueprint = blueprintRegistry.getByKey(key);
-        if (!blueprint) {
-          continue;
-        }
-        space.db.add(Obj.clone(blueprint));
-      }
-    }, [
-      space,
-      blueprintRegistry,
-      blueprintKeys
-    ]);
-    useAsyncEffect(async () => {
-      if (!binder?.isOpen) {
-        return;
-      }
-      if (pluginBlueprints.length > 0) {
-        await binder.bind({
-          blueprints: pluginBlueprints.map((blueprint) => Ref.make(blueprint))
-        });
-      }
-      if (Obj.instanceOf(Blueprint.Blueprint, companionTo)) {
-        await binder.bind({
-          blueprints: [
-            Ref.make(companionTo)
-          ]
-        });
-      } else {
-        await binder.bind({
-          objects: [
-            Ref.make(companionTo)
-          ]
-        });
-      }
-    }, [
-      binder,
-      companionTo,
-      blueprintKeys
-    ]);
-    return /* @__PURE__ */ React.createElement(ChatContainer, {
-      role,
-      space,
-      chat,
-      companionTo,
-      onEvent: handleEvent
-    });
-  } finally {
-    _effect.f();
-  }
-};
-var ChatCompanion_default = ChatCompanion;
-export {
-  ChatCompanion,
-  ChatCompanion_default as default
-};
-//# sourceMappingURL=ChatCompanion-JYD2RIBJ.mjs.map

package/dist/lib/browser/ChatCompanion-JYD2RIBJ.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/components/ChatCompanion.tsx"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Array from 'effect/Array';\nimport * as Function from 'effect/Function';\nimport * as Option from 'effect/Option';\nimport React, { useCallback, useEffect, useMemo, useState } from 'react';\n\nimport { Capabilities, createIntent } from '@dxos/app-framework';\nimport { useCapabilities, useIntentDispatcher } from '@dxos/app-framework/react';\nimport { Blueprint } from '@dxos/blueprints';\nimport { getSpace } from '@dxos/client/echo';\nimport { Filter, Obj, Ref } from '@dxos/echo';\nimport { SpaceAction } from '@dxos/plugin-space/types';\nimport { useQuery } from '@dxos/react-client/echo';\nimport { useAsyncEffect } from '@dxos/react-ui';\n\nimport { ChatContainer, type ChatEvent } from '../components';\nimport { useBlueprintRegistry, useContextBinder } from '../hooks';\nimport { Assistant, AssistantAction } from '../types';\n\nexport type ChatCompanionProps = {\n  role?: string;\n  data: { subject: Assistant.Chat | 'assistant-chat'; companionTo: Obj.Any };\n};\n\nexport const ChatCompanion = ({ role, data }: ChatCompanionProps) => {\n  const { dispatchPromise: dispatch } = useIntentDispatcher();\n  const blueprintRegistry = useBlueprintRegistry();\n  const companionTo = data.companionTo;\n\n  const space = getSpace(companionTo);\n  const [chat, setChat] = useState(data.subject === 'assistant-chat' ? undefined : data.subject);\n  useEffect(() => {\n    setChat(data.subject === 'assistant-chat' ? undefined : data.subject);\n  }, [data.subject]);\n\n  const chatQueue = space && chat ? space.queues.get(chat.queue.dxn) : undefined;\n  const binder = useContextBinder(chatQueue);\n\n  // Initialize companion chat if it doesn't exist, but don't add it to the space immediately.\n  useAsyncEffect(async () => {\n    if (!space || chat) {\n      return;\n    }\n\n    const { data } = await dispatch(createIntent(AssistantAction.CreateChat, { space }));\n    setChat(data?.object);\n  }, [chat, space]);\n\n  // Add chat to space when user submits the first message.\n  const handleEvent = useCallback(\n    async (event: ChatEvent) => {\n      const chatInSpace = !!getSpace(chat);\n      if (chatInSpace || !chat || !space) {\n        return;\n      }\n\n      if (event.type === 'submit') {\n        await dispatch(\n          createIntent(SpaceAction.AddObject, {\n            object: chat,\n            target: space,\n            hidden: true,\n          }),\n        );\n        await dispatch(\n          createIntent(SpaceAction.AddRelation, {\n            space,\n            schema: Assistant.CompanionTo,\n            source: chat,\n            target: companionTo,\n          }),\n        );\n        await dispatch(\n          createIntent(AssistantAction.SetCurrentChat, {\n            companionTo,\n            chat,\n          }),\n        );\n      }\n    },\n    [chat, space, companionTo, dispatch],\n  );\n\n  const metadata = useCapabilities(Capabilities.Metadata);\n  const blueprintKeys = useMemo(\n    () =>\n      Function.pipe(\n        metadata,\n        Array.findFirst(\n          (\n            capability,\n          ): capability is {\n            id: string;\n            metadata: { blueprints?: string[] };\n          } => capability.id === Obj.getTypename(companionTo),\n        ),\n        Option.flatMap((c) => Option.fromNullable(c.metadata.blueprints)),\n        Option.getOrElse(() => [] as string[]),\n      ),\n    [metadata, companionTo],\n  );\n  const existingBlueprints = useQuery(space, Filter.type(Blueprint.Blueprint));\n  const pluginBlueprints = useMemo(\n    () => existingBlueprints.filter((blueprint) => blueprintKeys.includes(blueprint.key)),\n    [existingBlueprints, blueprintKeys],\n  );\n\n  // Initialize related blueprints that are not already in the space.\n  useAsyncEffect(async () => {\n    if (!space) {\n      return;\n    }\n\n    // NOTE: This must be run instead of using the useQuery result to avoid duplicates.\n    const { objects: existingBlueprints } = await space.db.query(Filter.type(Blueprint.Blueprint)).run();\n    for (const key of blueprintKeys) {\n      const existingBlueprint = existingBlueprints.find((blueprint) => blueprint.key === key);\n      if (existingBlueprint) {\n        continue;\n      }\n\n      const blueprint = blueprintRegistry.getByKey(key);\n      if (!blueprint) {\n        continue;\n      }\n\n      space.db.add(Obj.clone(blueprint));\n    }\n  }, [space, blueprintRegistry, blueprintKeys]);\n\n  useAsyncEffect(async () => {\n    if (!binder?.isOpen) {\n      return;\n    }\n\n    if (pluginBlueprints.length > 0) {\n      await binder.bind({\n        blueprints: pluginBlueprints.map((blueprint) => Ref.make(blueprint)),\n      });\n    }\n\n    if (Obj.instanceOf(Blueprint.Blueprint, companionTo)) {\n      await binder.bind({ blueprints: [Ref.make(companionTo)] });\n    } else {\n      await binder.bind({ objects: [Ref.make(companionTo)] });\n    }\n  }, [binder, companionTo, blueprintKeys]);\n\n  return <ChatContainer role={role} space={space} chat={chat} companionTo={companionTo} onEvent={handleEvent} />;\n};\n\nexport default ChatCompanion;\n"],
-  "mappings": "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",
-  "names": ["Array", "Function", "Option", "React", "useCallback", "useEffect", "useMemo", "useState", "Capabilities", "createIntent", "useCapabilities", "useIntentDispatcher", "Blueprint", "getSpace", "Filter", "Obj", "Ref", "SpaceAction", "useQuery", "useAsyncEffect", "ChatCompanion", "role", "data", "dispatchPromise", "dispatch", "useIntentDispatcher", "blueprintRegistry", "useBlueprintRegistry", "companionTo", "space", "getSpace", "chat", "setChat", "useState", "subject", "undefined", "useEffect", "chatQueue", "queues", "get", "queue", "dxn", "binder", "useContextBinder", "useAsyncEffect", "createIntent", "AssistantAction", "CreateChat", "object", "handleEvent", "useCallback", "event", "chatInSpace", "type", "SpaceAction", "AddObject", "target", "hidden", "AddRelation", "schema", "Assistant", "CompanionTo", "source", "SetCurrentChat", "metadata", "useCapabilities", "Capabilities", "Metadata", "blueprintKeys", "useMemo", "pipe", "findFirst", "capability", "id", "Obj", "getTypename", "flatMap", "c", "fromNullable", "blueprints", "getOrElse", "existingBlueprints", "useQuery", "Filter", "Blueprint", "pluginBlueprints", "filter", "blueprint", "includes", "key", "objects", "db", "query", "run", "existingBlueprint", "find", "getByKey", "add", "clone", "isOpen", "length", "bind", "map", "Ref", "make", "instanceOf", "ChatContainer", "onEvent"]
-}