@dxos/plugin-assistant 0.8.4-main.fd6878d → 0.9.0

package/src/meta.ts

@@ -2,17 +2,42 @@
 // Copyright 2023 DXOS.org
 //
 
-import { type PluginMeta } from '@dxos/app-framework';
+import { Plugin } from '@dxos/app-framework';
+import { DXN } from '@dxos/keys';
+import { trim } from '@dxos/util';
 
-export const ASSISTANT_PLUGIN = 'dxos.org/plugin/assistant';
+export const meta = Plugin.makeMeta({
+  key: DXN.make('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.
 
-export const ASSISTANT_DIALOG = `${ASSISTANT_PLUGIN}/assistant/dialog`;
+    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.
 
-export const meta: PluginMeta = {
-  id: ASSISTANT_PLUGIN,
-  name: 'Assistant',
-  description: 'The Assistant tab allows you to chat with your spaces inside of Composer.',
-  icon: 'ph--atom--regular',
+    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',
-  tags: ['labs'],
-};
+  spec: 'PLUGIN.mdl',
+});
+
+export const ASSISTANT_DIALOG = DXN.make(`${meta.id}.assistantDialog`);
+
+/** Companion variant identifier for the assistant chat panel. */
+export const ASSISTANT_COMPANION_VARIANT = 'assistant-chat';

package/src/operations/create-chat.ts

@@ -0,0 +1,57 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { AiContext } from '@dxos/assistant';
+import { Chat, DatabaseBlueprint, AgentWizardBlueprint } from '@dxos/assistant-toolkit';
+import { Blueprint, Operation } from '@dxos/compute';
+import { Feed, Obj, Ref } from '@dxos/echo';
+import { createFeedServiceLayer } from '@dxos/echo-client';
+import { invariant } from '@dxos/invariant';
+import { ClientCapabilities } from '@dxos/plugin-client';
+
+import { AssistantBlueprint } from '#blueprints';
+import { AssistantOperation } from '#types';
+
+const handler: Operation.WithHandler<typeof AssistantOperation.CreateChat> = AssistantOperation.CreateChat.pipe(
+  Operation.withHandler(
+    Effect.fnUntraced(function* ({ db, name, addToSpace = true }) {
+      const registry = yield* Capability.get(Capabilities.AtomRegistry);
+      const client = yield* Capability.get(ClientCapabilities.Client);
+      const space = client.spaces.get(db.spaceId);
+      invariant(space, 'Space not found');
+      const feed = space.db.add(Feed.make());
+      const chat = Chat.make({ name, feed: Ref.make(feed) });
+      Obj.setParent(feed, chat);
+      if (addToSpace) {
+        space.db.add(chat);
+      }
+
+      // Dynamic import to avoid circular dependency with the barrel that also exports BlueprintManagerHandlers.
+      const { BlueprintManagerBlueprint } = yield* Effect.promise(() => import('@dxos/assistant-toolkit'));
+
+      const feedServiceLayer = createFeedServiceLayer(space.queues);
+      const runtime = yield* Effect.runtime<Feed.FeedService>().pipe(Effect.provide(feedServiceLayer));
+      const binder = new AiContext.Binder({ feed, runtime, registry });
+
+      // Bind default blueprints via registry refs — no DB clone needed since the ECHO ref
+      // resolver already spans the hypergraph registry.
+      yield* Effect.promise(() =>
+        binder.use((b: AiContext.Binder) =>
+          b.bind({
+            blueprints: [AssistantBlueprint, DatabaseBlueprint, AgentWizardBlueprint, BlueprintManagerBlueprint].map(
+              ({ key }) => Ref.fromURI(Blueprint.registryURI(key)),
+            ),
+          }),
+        ),
+      );
+
+      return { object: chat };
+    }),
+  ),
+);
+
+export default handler;

package/src/operations/ensure-companion-chat.ts

@@ -0,0 +1,63 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { Chat } from '@dxos/assistant-toolkit';
+import { Operation } from '@dxos/compute';
+import { Filter, Obj, Query } from '@dxos/echo';
+
+import { AssistantCapabilities, AssistantOperation } from '#types';
+
+const handler: Operation.WithHandler<typeof AssistantOperation.EnsureCompanionChat> =
+  AssistantOperation.EnsureCompanionChat.pipe(
+    Operation.withHandler(
+      Effect.fnUntraced(function* ({ db, companionTo }) {
+        const operationInvoker = yield* Capability.get(Capabilities.OperationInvoker);
+        const companionUri = Obj.getURI(companionTo);
+
+        // 1. Look for an existing persisted companion chat in the space.
+        const existingChats = yield* Effect.promise(() =>
+          db.query(Query.select(Filter.id(companionTo.id)).targetOf(Chat.CompanionTo).source()).run(),
+        );
+        const existingChat = existingChats.at(-1);
+        if (existingChat) {
+          // Cache the persisted chat so the graph connector can resolve it immediately
+          // via the cache fallback, without waiting for AtomObj.make(ref) to hydrate.
+          yield* Capabilities.updateAtomValue(AssistantCapabilities.CompanionChatCache, (current) => ({
+            ...current,
+            [companionUri]: existingChat,
+          }));
+          yield* Effect.promise(() =>
+            operationInvoker.invokePromise(AssistantOperation.SetCurrentChat, { companionTo, chat: existingChat }),
+          );
+          return { chat: existingChat, persisted: true };
+        }
+
+        // 2. Return cached transient chat for this companion if present.
+        const cache = yield* Capabilities.getAtomValue(AssistantCapabilities.CompanionChatCache);
+        const cached = cache[companionUri] as Chat.Chat | undefined;
+        if (cached) {
+          return { chat: cached, persisted: false };
+        }
+
+        // 3. Create a new transient chat, cache it, and return it without persisting.
+        const { data } = yield* Effect.promise(() =>
+          operationInvoker.invokePromise(AssistantOperation.CreateChat, { db, addToSpace: false }),
+        );
+        if (!data?.object) {
+          return yield* Effect.fail(new Error('CreateChat did not return a chat object'));
+        }
+        const chat = data.object;
+        yield* Capabilities.updateAtomValue(AssistantCapabilities.CompanionChatCache, (current) => ({
+          ...current,
+          [companionUri]: chat,
+        }));
+        return { chat, persisted: false };
+      }),
+    ),
+  );
+
+export default handler;

package/src/operations/fork-chat.ts

@@ -0,0 +1,112 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { getObjectPathFromObject, LayoutOperation } from '@dxos/app-toolkit';
+import { AiContext, SessionLink } from '@dxos/assistant';
+import { Chat } from '@dxos/assistant-toolkit';
+import { Operation } from '@dxos/compute';
+import { Database, Feed, Filter, Obj, Ref } from '@dxos/echo';
+import { createFeedServiceLayer } from '@dxos/echo-client';
+import { invariant } from '@dxos/invariant';
+import { ClientCapabilities } from '@dxos/plugin-client';
+import { SpaceOperation } from '@dxos/plugin-space';
+import { Message } from '@dxos/types';
+
+import { AssistantOperation } from '#types';
+
+const handler: Operation.WithHandler<typeof AssistantOperation.ForkChat> = AssistantOperation.ForkChat.pipe(
+  Operation.withHandler(
+    Effect.fnUntraced(function* ({ chat, companionTo }) {
+      const { db } = yield* Database.Service;
+      const sourceFeed = chat.feed.target;
+      invariant(sourceFeed, 'Chat feed not found.');
+
+      const client = yield* Capability.get(ClientCapabilities.Client);
+      const space = client.spaces.get(db.spaceId);
+      invariant(space, 'Space not found.');
+
+      const feedServiceLayer = createFeedServiceLayer(space.queues);
+
+      const messages = yield* Feed.runQuery(sourceFeed, Filter.type(Message.Message)).pipe(
+        Effect.provide(feedServiceLayer),
+      );
+
+      // Sort chronologically to find the last message.
+      const sorted = messages
+        .filter(Obj.instanceOf(Message.Message))
+        .sort((a, b) => a.created.localeCompare(b.created));
+
+      // Create a new chat, then apply source bindings and session link.
+      const sourceName = Obj.getLabel(chat);
+      const { object: newChat } = yield* Operation.invoke(AssistantOperation.CreateChat, {
+        db,
+        name: sourceName ? `${sourceName} (fork)` : undefined,
+      });
+      const newFeed = newChat.feed.target;
+      invariant(newFeed, 'New chat feed not found.');
+
+      if (sorted.length > 0) {
+        const lastMessage = sorted[sorted.length - 1];
+
+        // Append a SessionLink record pointing to the last message of the source feed.
+        yield* Feed.append(newFeed, [
+          Obj.make(SessionLink.SessionLink, {
+            feedRef: Ref.make(sourceFeed),
+            messageId: lastMessage.id,
+          }),
+        ]).pipe(Effect.provide(feedServiceLayer));
+      }
+
+      // Copy source chat's blueprint and object bindings to the new feed.
+      // Sort chronologically so add/remove events are applied in the correct order.
+      const sourceBindings = (yield* Feed.runQuery(sourceFeed, Filter.type(AiContext.Binding)).pipe(
+        Effect.provide(feedServiceLayer),
+      )).filter(Obj.instanceOf(AiContext.Binding));
+
+      if (sourceBindings.length > 0) {
+        // Reduce binding events to the final active set.
+        const blueprintRefMap = new Map<string, Ref.Ref<any>>();
+        const objectRefMap = new Map<string, Ref.Ref<any>>();
+        for (const binding of sourceBindings) {
+          binding.blueprints.added.forEach((ref: Ref.Ref<any>) => blueprintRefMap.set(ref.uri, ref));
+          binding.blueprints.removed.forEach((ref: Ref.Ref<any>) => blueprintRefMap.delete(ref.uri));
+          binding.objects.added.forEach((ref: Ref.Ref<any>) => objectRefMap.set(ref.uri, ref));
+          binding.objects.removed.forEach((ref: Ref.Ref<any>) => objectRefMap.delete(ref.uri));
+        }
+
+        yield* Feed.append(newFeed, [
+          Obj.make(AiContext.Binding, {
+            blueprints: { added: Array.from(blueprintRefMap.values()), removed: [] },
+            objects: { added: Array.from(objectRefMap.values()), removed: [] },
+          }),
+        ]).pipe(Effect.provide(feedServiceLayer));
+      }
+
+      if (companionTo) {
+        // Wire the forked chat as a companion and switch to it without navigating away.
+        yield* Operation.invoke(SpaceOperation.AddRelation, {
+          db,
+          schema: Chat.CompanionTo,
+          source: newChat,
+          target: companionTo,
+        });
+        const operationInvoker = yield* Capability.get(Capabilities.OperationInvoker);
+        yield* Effect.promise(() =>
+          operationInvoker.invokePromise(AssistantOperation.SetCurrentChat, { companionTo, chat: newChat }),
+        );
+      } else {
+        // Navigate to the forked chat as a standalone plank.
+        const chatPath = getObjectPathFromObject(newChat);
+        yield* Operation.invoke(LayoutOperation.Open, { subject: [chatPath] });
+      }
+
+      return { object: newChat };
+    }),
+  ),
+);
+
+export default handler;

package/src/operations/index.ts

@@ -0,0 +1,16 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { OperationHandlerSet } from '@dxos/compute';
+
+export const AssistantOperationHandlerSet = OperationHandlerSet.lazy(
+  () => import('./create-chat'),
+  () => import('./ensure-companion-chat'),
+  () => import('./fork-chat'),
+  () => import('./resolve-navigation-targets'),
+  () => import('./run-prompt-in-new-chat'),
+  () => import('./set-current-chat'),
+  () => import('./toggle-trace-panel-debug'),
+  () => import('./update-chat-name'),
+);

package/src/operations/prompt.node.test.ts

@@ -0,0 +1,82 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Array from 'effect/Array';
+import * as Effect from 'effect/Effect';
+import { describe, test } from 'vitest';
+
+import { AgentPrompt, Chat } from '@dxos/assistant-toolkit';
+import { Operation, Routine, ServiceResolver } from '@dxos/compute';
+import { Database, Feed, Filter, Ref } from '@dxos/echo';
+import { EffectEx } from '@dxos/effect';
+import { EntityId } from '@dxos/keys';
+import { AutomationPlugin } from '@dxos/plugin-automation/plugin';
+import { ClientCapabilities } from '@dxos/plugin-client';
+import { ClientPlugin } from '@dxos/plugin-client/plugin';
+import { initializeIdentity } from '@dxos/plugin-client/testing';
+import { createComposerTestApp } from '@dxos/plugin-testing/harness';
+import { Message } from '@dxos/types';
+
+import { AssistantPlugin } from '#plugin';
+
+EntityId.dangerouslyDisableRandomness();
+
+describe('Agent prompt (composer plugin harness)', () => {
+  // Hits AutomationPlugin compute runtime (plugin handlers, AiServiceLayer, blueprints).
+  // Requires reachable edge AI (see repo DX_EDGE_AI_SERVICE_URL); not memoized like AssistantTestLayer tests.
+  test(
+    'chat mode appends assistant messages to the chat queue',
+    { tags: ['llm'], timeout: 60_000 },
+    async ({ expect }) => {
+      await using harness = await createComposerTestApp({
+        plugins: [ClientPlugin({}), AssistantPlugin(), AutomationPlugin()],
+      });
+
+      const { personalSpace } = await EffectEx.runAndForwardErrors(
+        initializeIdentity(harness.get(ClientCapabilities.Client)),
+      );
+
+      await harness.runPromise(
+        Effect.gen(function* () {
+          const feed = yield* Database.add(Feed.make());
+
+          const messageCountBefore = yield* Feed.runQuery(feed, Filter.type(Message.Message)).pipe(
+            Effect.map(Array.length),
+          );
+
+          const chat = yield* Database.add(Chat.make({ feed: Ref.make(feed) }));
+          const prompt = yield* Database.add(
+            Routine.make({
+              name: 'chat-mode-test',
+              instructions: 'Reply with a single word: ack.',
+              blueprints: [],
+              context: [],
+            }),
+          );
+          yield* Database.flush();
+
+          const result = yield* Operation.invoke(
+            AgentPrompt,
+            {
+              prompt: Ref.make(prompt),
+              input: {},
+              chat: Ref.make(chat),
+            },
+            { spaceId: personalSpace.id },
+          );
+
+          const messageCountAfter = yield* Feed.runQuery(feed, Filter.type(Message.Message)).pipe(
+            Effect.map(Array.length),
+          );
+
+          expect(messageCountAfter).toBeGreaterThan(messageCountBefore);
+          expect(result).toBe('ack');
+        }).pipe(
+          Effect.provide(ServiceResolver.provide({ space: personalSpace.id }, Database.Service, Feed.FeedService)),
+        ),
+        { timeout: 30_000 },
+      );
+    },
+  );
+});

package/src/operations/resolve-navigation-targets.ts

@@ -0,0 +1,31 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability } from '@dxos/app-framework';
+import { AppCapabilities } from '@dxos/app-toolkit';
+import { Operation } from '@dxos/compute';
+// Value-side `DXN` re-export keeps the inferred `default` export's `.d.ts` portable —
+// `AssistantOperation.ResolveNavigationTargets` references `DXN.Schema` and the emitter
+// would otherwise emit an unresolvable type-only reference.
+import { DXN as _DXNReference } from '@dxos/keys';
+export { _DXNReference };
+
+import { AssistantOperation } from '#types';
+
+export default AssistantOperation.ResolveNavigationTargets.pipe(
+  Operation.withHandler(
+    Effect.fn(function* ({ query }) {
+      const capabilities = yield* Capability.Service;
+
+      // Delegate to contributed resolvers.
+      const resolvers = capabilities.getAll(AppCapabilities.NavigationTargetResolver);
+      const results = yield* Effect.forEach(resolvers, (resolver) =>
+        resolver(query as AppCapabilities.NavigationQuery).pipe(Effect.catchAll(() => Effect.succeed([]))),
+      );
+      return { targets: results.flat() };
+    }),
+  ),
+);

package/src/operations/run-prompt-in-new-chat.ts

@@ -0,0 +1,113 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { getObjectPathFromObject, LayoutOperation } from '@dxos/app-toolkit';
+import { AiContext } from '@dxos/assistant';
+import { AgentPrompt } from '@dxos/assistant-toolkit';
+import { Blueprint, Operation, Routine, Template } from '@dxos/compute';
+import { Database, Feed, Filter, Obj, Ref } from '@dxos/echo';
+import { createFeedServiceLayer } from '@dxos/echo-client';
+import { invariant } from '@dxos/invariant';
+import { log } from '@dxos/log';
+import { ClientCapabilities } from '@dxos/plugin-client';
+import { Text } from '@dxos/schema';
+
+import { AssistantCapabilities, AssistantOperation } from '#types';
+
+const handler: Operation.WithHandler<typeof AssistantOperation.RunPromptInNewChat> =
+  AssistantOperation.RunPromptInNewChat.pipe(
+    Operation.withHandler(
+      Effect.fnUntraced(
+        function* ({ db, prompt, objects, blueprints, background }) {
+          const registry = yield* Capability.get(Capabilities.AtomRegistry);
+          const { object: chat } = yield* Operation.invoke(AssistantOperation.CreateChat, { db });
+
+          if ((objects && objects.length > 0) || (blueprints && blueprints.length > 0)) {
+            const feedTarget = chat.feed.target;
+            invariant(feedTarget, 'Chat feed not found.');
+            const client = yield* Capability.get(ClientCapabilities.Client);
+            const space = client.spaces.get(db.spaceId);
+            invariant(space, 'Space not found.');
+            const feedServiceLayer = createFeedServiceLayer(space.queues);
+            const runtime = yield* Effect.runtime<Feed.FeedService>().pipe(Effect.provide(feedServiceLayer));
+            const binder = new AiContext.Binder({ feed: feedTarget, runtime, registry });
+            yield* Effect.promise(() =>
+              binder.use(async (b: AiContext.Binder) => {
+                const bindingProps: Parameters<AiContext.Binder['bind']>[0] = {};
+
+                if (objects && objects.length > 0) {
+                  bindingProps.objects = objects.map((obj) => Ref.make(obj));
+                }
+
+                if (blueprints && blueprints.length > 0) {
+                  const allBlueprints = await db.query(Filter.type(Blueprint.Blueprint)).run();
+                  const matchedBlueprints = allBlueprints.filter((blueprint) => {
+                    const blueprintKey = Obj.getMeta(blueprint).key;
+                    return blueprintKey !== undefined && blueprints.includes(blueprintKey);
+                  });
+                  if (matchedBlueprints.length > 0) {
+                    bindingProps.blueprints = matchedBlueprints.map((blueprint) => Ref.make(blueprint));
+                  }
+                }
+
+                await b.bind(bindingProps);
+              }),
+            );
+          }
+
+          if (background) {
+            const promptRef =
+              typeof prompt === 'string'
+                ? Ref.make(
+                    Routine.make({
+                      instructions: prompt,
+                      blueprints: [],
+                      context: [],
+                    }),
+                  )
+                : prompt;
+            yield* Database.flush();
+            yield* Operation.invoke(
+              AgentPrompt,
+              {
+                prompt: promptRef,
+                input: {},
+                chat: Ref.make(chat),
+              },
+              { spaceId: db.spaceId },
+            ).pipe(
+              Effect.catchAll((error) => {
+                log.catch(error);
+                return Effect.void;
+              }),
+            );
+            return { object: chat };
+          }
+
+          const chatPath = getObjectPathFromObject(chat);
+          const pendingPromptText =
+            typeof prompt === 'string'
+              ? prompt
+              : yield* Effect.gen(function* () {
+                  const promptObj = yield* Effect.promise(() => prompt.load());
+                  const source = yield* Effect.promise(() => promptObj.instructions.load());
+                  invariant(Obj.instanceOf(Text.Text, source), 'Prompt instructions must be Text.');
+                  return Template.process(source.content ?? '');
+                });
+          yield* Capabilities.updateAtomValue(AssistantCapabilities.State, (current) => ({
+            ...current,
+            pendingPrompts: { ...current.pendingPrompts, [chatPath]: pendingPromptText },
+          }));
+          yield* Operation.invoke(LayoutOperation.Open, { subject: [chatPath] });
+          return { object: chat };
+        },
+        (effect, { db }) => effect.pipe(Effect.provide(Database.layer(db))),
+      ),
+    ),
+  );
+
+export default handler;

package/src/operations/set-current-chat.ts

@@ -0,0 +1,49 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { Operation } from '@dxos/compute';
+import { Obj } from '@dxos/echo';
+
+import { AssistantCapabilities, AssistantOperation } from '#types';
+
+const handler: Operation.WithHandler<typeof AssistantOperation.SetCurrentChat> = AssistantOperation.SetCurrentChat.pipe(
+  Operation.withHandler(
+    Effect.fnUntraced(function* ({ companionTo, chat }) {
+      const companionToId = Obj.getURI(companionTo);
+
+      if (chat) {
+        const chatId = Obj.getURI(chat);
+        yield* Capabilities.updateAtomValue(AssistantCapabilities.State, (current) => ({
+          ...current,
+          currentChat: { ...current.currentChat, [companionToId]: chatId },
+        }));
+      } else {
+        // New thread: create a transient chat and cache it so the graph connector
+        // can resolve it immediately via the cache fallback tier.
+        const operationInvoker = yield* Capability.get(Capabilities.OperationInvoker);
+        const db = Obj.getDatabase(companionTo);
+        if (db) {
+          const { data } = yield* Effect.promise(() =>
+            operationInvoker.invokePromise(AssistantOperation.CreateChat, { db, addToSpace: false }),
+          );
+          if (data?.object) {
+            yield* Capabilities.updateAtomValue(AssistantCapabilities.CompanionChatCache, (current) => ({
+              ...current,
+              [companionToId]: data.object,
+            }));
+          }
+        }
+        yield* Capabilities.updateAtomValue(AssistantCapabilities.State, (current) => ({
+          ...current,
+          currentChat: { ...current.currentChat, [companionToId]: undefined },
+        }));
+      }
+    }),
+  ),
+);
+
+export default handler;

package/src/operations/toggle-trace-panel-debug.ts

@@ -0,0 +1,27 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capabilities } from '@dxos/app-framework';
+import { Operation } from '@dxos/compute';
+
+import { AssistantCapabilities, AssistantOperation } from '#types';
+
+const handler: Operation.WithHandler<typeof AssistantOperation.ToggleTracePanelDebug> =
+  AssistantOperation.ToggleTracePanelDebug.pipe(
+    Operation.withHandler(
+      Effect.fnUntraced(function* (input) {
+        const current = yield* Capabilities.getAtomValue(AssistantCapabilities.Settings);
+        const next = input.state ?? !current.tracePanelDebug;
+        yield* Capabilities.updateAtomValue(AssistantCapabilities.Settings, (settings) => ({
+          ...settings,
+          tracePanelDebug: next,
+        }));
+        return next;
+      }),
+    ),
+  );
+
+export default handler;

package/src/operations/update-chat-name.ts

@@ -0,0 +1,65 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as LanguageModel from '@effect/ai/LanguageModel';
+import * as Prompt from '@effect/ai/Prompt';
+import * as Effect from 'effect/Effect';
+
+import { AiPreprocessor, AiService } from '@dxos/ai';
+import { Operation } from '@dxos/compute';
+import { Database, Feed, Filter, Obj } from '@dxos/echo';
+import { log } from '@dxos/log';
+import { Message } from '@dxos/types';
+import { trim } from '@dxos/util';
+
+import { AssistantOperation } from '#types';
+
+const handler: Operation.WithHandler<typeof AssistantOperation.UpdateChatName> = AssistantOperation.UpdateChatName.pipe(
+  Operation.withHandler(
+    Effect.fnUntraced(
+      function* ({ chat, prompt: initialPrompt }) {
+        log.info('updating chat name', { chat });
+
+        const system = trim`
+          It is extremely important that you respond only with the title and nothing else.
+          Do not use markdown or other formatting.
+          If you cannot do this effectively respond with "New Chat".
+
+          <example_reply>
+          Fishing Trip
+          </example_reply>
+        `;
+
+        let namePrompt: Prompt.Prompt;
+        if (initialPrompt) {
+          // Use the provided prompt text directly; the feed may not have messages yet.
+          namePrompt = Prompt.setSystem(
+            Prompt.make(`User's first message: "${initialPrompt}"\n\nSuggest a name for this chat.`),
+            system,
+          );
+        } else {
+          const feed = yield* Database.load(chat.feed);
+          const history = yield* Feed.runQuery(feed, Filter.type(Message.Message));
+          log.info('history', { history: history.length });
+          const historyPrompt = yield* AiPreprocessor.preprocessPrompt(history, {
+            system,
+            cacheControl: 'ephemeral',
+          });
+          namePrompt = Prompt.merge(historyPrompt, 'Suggest a name for this chat');
+        }
+
+        const response = yield* LanguageModel.generateText({ prompt: namePrompt });
+        const newName = response.text.replaceAll(/[^a-zA-Z0-9\s]/g, '').trim();
+
+        Obj.update(chat, (chat) => {
+          chat.name = newName;
+        });
+        log.info('chat name updated', { chat, newName: chat.name });
+      },
+      Effect.provide(AiService.model('ai.claude.model.claude-haiku-4-5')),
+    ),
+  ),
+);
+
+export default handler;