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

package/src/testing/test-generator.test.ts

@@ -2,54 +2,58 @@
 // Copyright 2025 DXOS.org
 //
 
-import * as Context from 'effect/Context';
 import * as Effect from 'effect/Effect';
 import * as Layer from 'effect/Layer';
 import { describe, test } from 'vitest';
 
-import { Database, Feed, Obj } from '@dxos/echo';
+import { Database, Entity, Feed, Obj } from '@dxos/echo';
 import { EffectEx } from '@dxos/effect';
 import { type Message } from '@dxos/types';
 
 import { createMessageGenerator } from './test-generator';
 
 /**
- * In-memory FeedService that records appends and emits a change event whenever
- * `append` is called. Used to verify the streaming-message generator emits
- * per-chunk updates.
+ * In-memory Database.Service that records appendToFeed calls and emits a change event
+ * whenever `appendToFeed` is called. Used to verify the streaming-message generator
+ * emits per-chunk updates.
  */
-const makeRecordingFeedLayer = () => {
+const makeRecordingDatabaseLayer = () => {
   const items: Message.Message[] = [];
   const subscribers = new Set<() => void>();
 
-  const feedService: Context.Tag.Service<Feed.FeedService> = {
-    append: async (_feed: Feed.Feed, newItems) => {
+  const dbService: Database.Database = {
+    get spaceId() {
+      return 'recording' as any;
+    },
+    add: (obj: any) => obj as any,
+    addType: async () => undefined as any,
+    remove: () => {},
+    appendToFeed: async (_feed: Feed.Feed, newItems: Entity.Unknown[]) => {
       items.push(...(newItems as Message.Message[]));
       for (const fn of subscribers) {
         fn();
       }
     },
-    remove: async () => {},
-    query: () =>
-      ({
-        subscribe: () => () => {},
-        results: [],
-        run: async () => [],
-      }) as any,
-    sync: async () => {},
-    getSyncState: async () => ({ blocksToPull: 0, blocksToPush: 0, totalBlocks: 0 }),
-  };
+    removeFeedItemsByIds: async () => {},
+    queryFeed: () => ({ subscribe: () => () => {}, results: [], run: async () => [] }) as any,
+    query: () => ({ subscribe: () => () => {}, results: [], run: async () => [] }) as any,
+    syncFeed: async () => {},
+    getFeedSyncState: async () => ({ blocksToPull: 0, blocksToPush: 0, totalBlocks: 0 }),
+    flush: async () => {},
+    makeRef: () => undefined as any,
+    deleteFromFeed: async () => {},
+  } as unknown as Database.Database;
 
   return {
     items,
     onAppend: (cb: () => void) => subscribers.add(cb),
-    layer: Layer.succeed(Feed.FeedService, feedService),
+    layer: Layer.succeed(Database.Service, { db: dbService }),
   };
 };
 
 describe('createMessageGenerator', () => {
   test('streaming message publishes updates for chunk mutations', async ({ expect }) => {
-    const recording = makeRecordingFeedLayer();
+    const recording = makeRecordingDatabaseLayer();
     let updates = 0;
     recording.onAppend(() => updates++);
 
@@ -57,10 +61,10 @@ describe('createMessageGenerator', () => {
 
     // The streaming step is the third entry (index 2) — earlier indices are the initial
     // user prompt and an assistant message with an Organization link (which requires
-    // `Database.Service`, unavailable in this unit-test layer).
+    // a real database; the recording layer stub is sufficient for this streaming test).
     await EffectEx.runAndForwardErrors(
       createMessageGenerator()[2]!.pipe(
-        Effect.provide(Layer.mergeAll(Feed.ContextFeedService.layer(feed), recording.layer, Database.notAvailable)),
+        Effect.provide(Layer.mergeAll(Feed.ContextFeedService.layer(feed), recording.layer)),
       ),
     );
 

package/src/testing/test-generator.ts

@@ -19,11 +19,7 @@ export const createMessage = (role: Actor.Role, blocks: ContentBlock.Any[]): Mes
   });
 };
 
-export type MessageGenerator = Effect.Effect<
-  void,
-  never,
-  Database.Service | Feed.ContextFeedService | Feed.FeedService
->;
+export type MessageGenerator = Effect.Effect<void, never, Database.Service | Feed.ContextFeedService>;
 
 export const createMessageGenerator = (): MessageGenerator[] => [
   Effect.gen(function* () {
@@ -75,7 +71,7 @@ export const createMessageGenerator = (): MessageGenerator[] => [
   // so the syncer renders progressive deltas through the feed (not via the controller).
   Effect.gen(function* () {
     const { feed } = yield* Feed.ContextFeedService;
-    const feedService = yield* Feed.FeedService;
+    const { db } = yield* Database.Service;
     const message = createMessage('assistant', [{ _tag: 'text', text: '', pending: true }]);
     yield* Feed.append(feed, [message]);
 
@@ -92,13 +88,13 @@ export const createMessageGenerator = (): MessageGenerator[] => [
           block.text += chunk;
         });
         // Feed queries only react to feed-level updates, not in-place object mutations.
-        await feedService.append(feed, []);
+        await db.appendToFeed(feed, []);
       }
       Obj.update(message, (message) => {
         const block = message.blocks[0] as Mutable<ContentBlock.Text>;
         block.pending = false;
       });
-      await feedService.append(feed, []);
+      await db.appendToFeed(feed, []);
     });
   }),
 

package/src/testing/test-trace.ts

@@ -5,13 +5,14 @@
 import * as Option from 'effect/Option';
 
 import { Process } from '@dxos/compute';
+import { Annotation } from '@dxos/echo';
 
 export const makeProcess = (
   overrides: Partial<Process.Info> & Pick<Process.Info, 'pid' | 'state'> & { name: string },
 ): Process.Info => ({
   parentPid: null,
   key: `test.process.${overrides.name}`,
-  params: { name: overrides.name, target: null },
+  params: { name: overrides.name, annotations: Annotation.buildDictionary(() => {}) },
   error: null,
   startedAt: Date.now() - 10_000,
   completedAt: Option.none(),

package/src/testing/trace-timeline.node.test.ts

@@ -7,14 +7,14 @@ import * as Effect from 'effect/Effect';
 
 import {
   AgentHandlers,
-  AgentPrompt,
-  DatabaseBlueprint,
   DatabaseHandlers,
-  WebSearchBlueprint,
+  DatabaseSkill,
+  RunInstructions,
   WebSearchHandlers,
+  WebSearchSkill,
   WebSearchToolkitOpaque,
 } from '@dxos/assistant-toolkit';
-import { Blueprint, Routine, Trace, Trigger, Operation } from '@dxos/compute';
+import { Instructions, Operation, Skill, Trace, Trigger } from '@dxos/compute';
 import { ExampleHandlers, Reply } from '@dxos/compute/testing';
 import { Database, Feed, Filter, Obj, Query, Ref } from '@dxos/echo';
 import { TestHelpers } from '@dxos/effect/testing';
@@ -39,7 +39,7 @@ const queryTraceMessages = Effect.gen(function* () {
 
 const TestLayer = AssistantTestLayerWithTriggers({
   types: [Organization.Organization, Person.Person],
-  blueprints: [DatabaseBlueprint.make(), WebSearchBlueprint.make()],
+  skills: [DatabaseSkill.make(), WebSearchSkill.make()],
   operationHandlers: [DatabaseHandlers, AgentHandlers, WebSearchHandlers, ExampleHandlers],
   toolkits: [WebSearchToolkitOpaque],
   tracing: 'feed',
@@ -54,7 +54,7 @@ describe.skip('Trace timeline', () => {
       Effect.fnUntraced(
         function* ({ expect }) {
           const agent = yield* AgentService.createSession({
-            blueprints: [DatabaseBlueprint.make()],
+            skills: [DatabaseSkill.make()],
           });
           yield* agent.submitPrompt('Create an organization called "Cyberdyne Systems".');
           yield* agent.waitForCompletion();
@@ -92,7 +92,7 @@ describe.skip('Trace timeline', () => {
       Effect.fnUntraced(
         function* ({ expect }) {
           const agent = yield* AgentService.createSession({
-            blueprints: [DatabaseBlueprint.make()],
+            skills: [DatabaseSkill.make()],
           });
           yield* Database.add(Obj.make(Organization.Organization, { name: 'Acme Corp' }));
           yield* Database.add(Obj.make(Organization.Organization, { name: 'Globex Industries' }));
@@ -124,7 +124,7 @@ describe.skip('Trace timeline', () => {
       Effect.fnUntraced(
         function* ({ expect }) {
           const agent = yield* AgentService.createSession({
-            blueprints: [DatabaseBlueprint.make()],
+            skills: [DatabaseSkill.make()],
           });
           yield* agent.submitPrompt('List all available schemas. Tell me what typenames are available.');
           yield* agent.waitForCompletion();
@@ -165,20 +165,20 @@ describe.skip('Trace timeline', () => {
               name: 'DXOS',
             }),
           ]);
-          const prompt = yield* Database.add(
-            Routine.make({
+          const instructions = yield* Database.add(
+            Instructions.make({
               name: 'Research',
-              instructions: 'Research the given topic, or object.',
-              blueprints: [Ref.make(yield* Blueprint.upsert(WebSearchBlueprint.key))],
+              text: 'Research the given topic, or object.',
+              skills: [Ref.make(yield* Skill.upsert(WebSearchSkill.key))],
             }),
           );
           yield* Database.add(
             Trigger.make({
-              function: Ref.make(Operation.serialize(AgentPrompt)),
+              runnable: Ref.make(Operation.serialize(RunInstructions)),
               enabled: true,
               spec: Trigger.specFeed(feed),
               input: {
-                prompt: Ref.make(prompt),
+                instructions: Ref.make(instructions),
                 input: '{{event.item}}',
               },
             }),

package/src/translations.ts

@@ -2,8 +2,8 @@
 // Copyright 2023 DXOS.org
 //
 
-import { Chat, Agent, McpServer } from '@dxos/assistant-toolkit';
-import { Blueprint, Routine } from '@dxos/compute';
+import { Agent, Chat, McpServer } from '@dxos/assistant-toolkit';
+import { Instructions, Skill } from '@dxos/compute';
 import { Sequence } from '@dxos/conductor';
 import { Type } from '@dxos/echo';
 import { type Resource } from '@dxos/react-ui';
@@ -12,24 +12,23 @@ import { translations as formTranslations } from '@dxos/react-ui-form/translatio
 
 import { meta } from '#meta';
 
-// TODO(burdon): Standardize translation names.
 export const translations: Resource[] = [
   ...componentsTranslations,
   ...formTranslations,
   {
     'en-US': {
-      [Type.getTypename(Blueprint.Blueprint)]: {
-        'typename.label': 'Blueprint',
-        'typename.label_zero': 'Blueprints',
-        'typename.label_one': 'Blueprint',
-        'typename.label_other': 'Blueprints',
-        'object-name.placeholder': 'New blueprint',
-        'add-object.label': 'Add blueprint',
-        'rename-object.label': 'Rename blueprint',
-        'delete-object.label': 'Delete blueprint',
-        'object-deleted.label': 'Blueprint deleted',
+      [Type.getTypename(Skill.Skill)]: {
+        'typename.label': 'Skill',
+        'typename.label_zero': 'Skills',
+        'typename.label_one': 'Skill',
+        'typename.label_other': 'Skills',
+        'object-name.placeholder': 'New skill',
+        'add-object.label': 'Add skill',
+        'rename-object.label': 'Rename skill',
+        'delete-object.label': 'Delete skill',
+        'object-deleted.label': 'Skill deleted',
       },
-      [Type.getTypename(Routine.Routine)]: {
+      [Type.getTypename(Instructions.Instructions)]: {
         'typename.label': 'Routine',
         'typename.label_zero': 'Routines',
         'typename.label_one': 'Routine',
@@ -52,15 +51,15 @@ export const translations: Resource[] = [
         'object-deleted.label': 'Sequence deleted',
       },
       [Type.getTypename(Chat.Chat)]: {
-        'typename.label': 'AI Chat',
-        'typename.label_zero': 'AI Chats',
-        'typename.label_one': 'AI Chat',
-        'typename.label_other': 'AI Chats',
-        'object-name.placeholder': 'New AI Chat',
-        'add-object.label': 'Add AI chat',
-        'rename-object.label': 'Rename AI Chat',
-        'delete-object.label': 'Delete AI Chat',
-        'object-deleted.label': 'AI Chat deleted',
+        'typename.label': 'Session',
+        'typename.label_zero': 'Sessions',
+        'typename.label_one': 'Session',
+        'typename.label_other': 'Sessions',
+        'object-name.placeholder': 'New session',
+        'add-object.label': 'Add Session',
+        'rename-object.label': 'Rename session',
+        'delete-object.label': 'Delete session',
+        'object-deleted.label': 'Session deleted',
       },
       [Type.getTypename(McpServer.McpServer)]: {
         'typename.label': 'MCP Server',
@@ -80,18 +79,15 @@ export const translations: Resource[] = [
         'object-deleted.label': 'Agent deleted',
       },
       // TODO(burdon): Reconcile with react-ui-chat.
-      [meta.id]: {
+      [meta.profile.key]: {
         'templates.label': 'Templates',
         'open-ambient-chat.label': 'Open Assistant',
         'assistant-chat.label': 'Assistant',
         'plugin.name': 'Assistant',
-        'settings.title': 'Assistant settings',
         'object.placeholder': 'New prompt',
         'create-object.label': 'Create prompt',
         'create-trigger.label': 'Create trigger',
         'create-stack-section.label': 'Create prompt',
-        'command.placeholder': 'Enter slash command...',
-        'template.placeholder': 'Enter template...',
         'value.placeholder': 'Enter value...',
         'prompt-rules.label': 'Prompt Rules',
         'typename.placeholder': 'Enter typename of objects which this template is for',
@@ -100,7 +96,7 @@ export const translations: Resource[] = [
         'service-registry.label': 'Service Registry',
         'type-filter.placeholder': 'Type',
         'any-type-filter.label': 'Any',
-        'no-blueprint.message': 'No active blueprints',
+        'no-skill.message': 'No active skills',
         'tool-call.label': 'Calling',
         'tool-result.label': 'Success',
         'tool-error.label': 'Tool call failed',
@@ -128,14 +124,29 @@ export const translations: Resource[] = [
         'summary.label': 'Summary',
         'thinking.label': 'Thinking',
 
+        'integration-prompt.title': 'Connect {{service}}',
+        'integration-prompt.description': 'This action needs access to {{service}}. Connect it to continue.',
+        'integration-prompt.unavailable': 'No connector is available for {{service}}.',
+
         'search.placeholder': 'Search...',
         'prompt.placeholder': 'Enter question or command...',
         'context-objects.button': 'Add to context',
         'context-settings.button': 'Chat settings',
         'microphone.button': 'Click to speak',
+        'recording.placeholder': 'Recording…',
+        'stop-recording.label': 'Stop recording',
+        'hold-to-record.label': 'Hold to record',
+        'start-recording.label': 'Start recording',
+        'recording-options.label': 'Recording options',
+        'record-mode.label': 'Record mode',
+        'record-mode.toggle.label': 'Toggle',
+        'record-mode.hold.label': 'Hold (push-to-talk)',
+        'audio-device.label': 'Microphone',
+        'audio-device.default.label': 'System default',
+        'settings.entity-extraction.label': 'Entity extraction',
         'cancel-processing.button': 'Stop processing',
 
-        'options.blueprints.title': 'Skills',
+        'options.skills.title': 'Skills',
         'options.mcp.title': 'MCP',
         'options.chat-model.title': 'Models',
         'remove-object.label': 'Remove object',
@@ -156,11 +167,33 @@ export const translations: Resource[] = [
         'mcp-server-api-key.placeholder': 'API key (optional)',
         'mcp-server-error.label': 'MCP server unavailable',
         'ai-service-error.label': 'AI service error',
+        'view-usage.label': 'View usage',
+
+        // LLM provider labels.
+        'settings.provider.edge.label': 'Edge',
+        'settings.provider.built-in.label': 'Built-in',
+        'settings.provider.ollama.label': 'Ollama',
+        'settings.provider.lmstudio.label': 'LM Studio',
+
+        // Ollama local model management (desktop only).
+        'settings.ollama.title': 'Local models',
+        'settings.ollama.installed.label': 'Downloaded models',
+        'settings.ollama.empty.message': 'No models downloaded. Pull one below to get started.',
+        'settings.ollama.pull.label': 'Pull model',
+        'settings.ollama.pull.placeholder': 'Search or enter a model name (e.g. llama3.2:1b)',
+        'settings.ollama.pull-custom.label': 'Pull “{{name}}”',
+        'settings.ollama.pulling.label': 'Pulling…',
+        'settings.ollama.pulling.message': 'Downloading… {{percent}}%',
+        'settings.ollama.cancel.label': 'Cancel download',
+        'settings.ollama.loaded.label': 'Loaded',
+        'settings.ollama.loaded.vram': 'Loaded · {{size}}',
+        'settings.ollama.load.label': 'Load into memory',
+        'settings.ollama.unload.label': 'Unload from memory',
+        'settings.ollama.remove.label': 'Delete model',
+        'settings.ollama.failed.message': 'Could not reach the local model service: {{error}}',
 
         'debug.button': 'Debug',
         'online-switch.label': 'Online',
-        'run-prompt.label': 'Run prompt',
-        'routine-running.label': 'Running…',
         'typename.label': 'Typename',
         'branch-thread.menu': 'Branch chat',
         'chat-toolbar.title': 'Chat toolbar',
@@ -186,6 +219,16 @@ export const translations: Resource[] = [
         'instructions.placeholder': 'Enter instructions, goals, and constraints for the assistant.',
         'reset-history.button': 'Reset',
         'subscriptions.label': 'Subscriptions',
+
+        // Per-space Home article: starter-prompt cards + the pinned assistant prompt.
+        'space-home.suggestions.heading': 'Get started',
+        'space-home.suggestion-magazine.label': 'Create feeds for tracking the latest AI news and build a magazine',
+        'space-home.suggestion-spreadsheet.label':
+          "Look up and create a spreadsheet of MLB's top starters by month for {{year}}",
+        'space-home.suggestion-kanban.label': 'Create a kanban view for tracking tasks',
+        'space-home.prompt.placeholder': 'Ask the assistant anything…',
+
+        'nav-tree-group-ai.label': 'Assistant',
       },
     },
   },

package/src/types/Assistant.ts

@@ -9,6 +9,8 @@ import { Chat as ChatModule } from '@dxos/assistant-toolkit';
 export const Chat = ChatModule.Chat;
 export type Chat = ChatModule.Chat;
 
+import { type DXN } from '@dxos/keys';
+
 // Re-export Settings as merged const/type (not as namespace).
 import * as SettingsModule from './Settings';
 export const Settings = SettingsModule.Settings;
@@ -18,7 +20,7 @@ export const ChatViews = SettingsModule.ChatViews;
 export const ChatView = SettingsModule.ChatView;
 export type ChatView = SettingsModule.ChatView;
 
-export const ModelProviders = SettingsModule.ModelProviders;
+export const ModelProviders: readonly DXN.DXN[] = SettingsModule.ModelProviders;
 export const ModelProvider = SettingsModule.ModelProvider;
 export type ModelProvider = SettingsModule.ModelProvider;
 

package/src/types/AssistantCapabilities.ts

@@ -13,8 +13,11 @@ import { type Obj } from '@dxos/echo';
 import { meta } from '#meta';
 
 import * as Assistant from './Assistant';
+import * as Ollama from './Ollama';
 
-export const Settings = Capability.make<Atom.Writable<Assistant.Settings>>(`${meta.id}.capability.settings`);
+export const Settings = Capability.make<Atom.Writable<Assistant.Settings>>(`${meta.profile.key}.capability.settings`);
+
+export const OllamaManager = Capability.make<Ollama.Manager>(`${meta.profile.key}.capability.ollama-manager`);
 
 export const StateSchema = Schema.mutable(
   Schema.Struct({
@@ -27,9 +30,27 @@ export const StateSchema = Schema.mutable(
 
 export type AssistantState = Schema.Schema.Type<typeof StateSchema>;
 
-export const State = Capability.make<Atom.Writable<AssistantState>>(`${meta.id}.capability.state`);
+export const State = Capability.make<Atom.Writable<AssistantState>>(`${meta.profile.key}.capability.state`);
 
 /** Session-scoped cache of transient (not yet persisted) companion chats keyed by companion DXN string. */
 export const CompanionChatCache = Capability.make<Atom.Writable<Record<string, Obj.Unknown | undefined>>>(
-  `${meta.id}.capability.companion-chat-cache`,
+  `${meta.profile.key}.capability.companion-chat-cache`,
+);
+
+export const HomeSuggestionsCacheSchema = Schema.mutable(
+  Schema.Record({
+    key: Schema.String,
+    value: Schema.Struct({
+      /** Epoch ms timestamp of the successful generation that produced these prompts. */
+      generatedAt: Schema.Number,
+      /** Non-empty, trimmed prompts from a successful generation. */
+      prompts: Schema.Array(Schema.String),
+    }),
+  }),
+);
+export type HomeSuggestionsCache = Schema.Schema.Type<typeof HomeSuggestionsCacheSchema>;
+
+/** Per-space cache of LLM-generated home starter prompts, persisted across page reloads. */
+export const HomeSuggestionsCache = Capability.make<Atom.Writable<HomeSuggestionsCache>>(
+  `${meta.profile.key}.capability.home-suggestions-cache`,
 );

package/src/types/AssistantEvents.ts

@@ -8,4 +8,4 @@ import { ActivationEvent } from '@dxos/app-framework';
 
 import { meta } from '#meta';
 
-export const SetupAiServiceProviders = ActivationEvent.make(`${meta.id}.event.setup-ai-service-providers`);
+export const SetupAiServiceProviders = ActivationEvent.make(`${meta.profile.key}.event.setupAiServiceProviders`);

package/src/types/AssistantOperation.ts

@@ -9,13 +9,13 @@ import * as Schema from 'effect/Schema';
 import { AiService } from '@dxos/ai';
 import { Capability } from '@dxos/app-framework';
 import { Chat } from '@dxos/assistant-toolkit';
-import { Routine, Operation } from '@dxos/compute';
-import { Database, Feed, Obj, Ref, Type } from '@dxos/echo';
-import { DXN } from '@dxos/keys';
+import { Operation } from '@dxos/compute';
+import { Database, Obj, Type } from '@dxos/echo';
+import { DXN, URI } from '@dxos/keys';
 
 import { meta } from '#meta';
 
-const makeKey = (name: string) => DXN.make(`${meta.id}.operation.${name}`);
+const makeKey = (name: string) => DXN.make(`${meta.profile.key}.operation.${name}`);
 
 export const CreateChat = Operation.make({
   meta: { key: makeKey('createChat'), name: 'Create Chat', icon: 'ph--chat-text--regular' },
@@ -37,7 +37,7 @@ export const UpdateChatName = Operation.make({
     name: 'Update Chat Name',
     icon: 'ph--pencil--regular',
   },
-  services: [Database.Service, Feed.FeedService, AiService.AiService],
+  services: [Database.Service, AiService.AiService],
   input: Schema.Struct({
     chat: Type.getSchema(Chat.Chat),
     /** Initial user message text; used when the feed has no history yet (e.g. auto-rename on first send). */
@@ -60,31 +60,6 @@ export const SetCurrentChat = Operation.make({
   output: Schema.Void,
 });
 
-export const RunPromptInNewChat = Operation.make({
-  meta: {
-    key: makeKey('runPromptInNewChat'),
-    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.' }),
@@ -96,13 +71,14 @@ export const ResolveNavigationTargets = Operation.make({
     key: makeKey('resolveNavigationTargets'),
     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.',
+      "Resolve a navigation path for the Open operation. Pass an object's URI (its DXN, e.g. a context object's <dxn>) as the query uri to resolve that object to its navigation target, or omit the query to list pages that can be navigated to. Pass the returned target path to Open.",
     icon: 'ph--compass--regular',
   },
   input: Schema.Struct({
     query: Schema.optional(
       Schema.Struct({
-        dxn: Schema.optional(DXN.Schema),
+        // An object URI (e.g. a context object's `<dxn>`); accepts both `echo:` EIDs and `dxn:` DXNs.
+        uri: Schema.optional(URI.Schema),
       }),
     ),
   }),
@@ -143,12 +119,25 @@ export const EnsureCompanionChat = Operation.make({
   }),
 });
 
-export const BlueprintForm = Schema.Struct({
+export const SkillForm = Schema.Struct({
   key: Schema.String,
   name: Schema.String,
   description: Schema.optional(Schema.String),
 });
 
+export const GenerateHomeSuggestions = Operation.make({
+  meta: {
+    key: makeKey('generateHomeSuggestions'),
+    name: 'Generate Home Suggestions',
+    icon: 'ph--sparkle--regular',
+    // Internal UI operation — not exposed as an agent tool.
+    skipRegistry: true,
+  },
+  services: [Capability.Service, AiService.AiService],
+  input: Schema.Struct({ db: Database.Database }),
+  output: Schema.Struct({ prompts: Schema.Array(Schema.String) }),
+});
+
 export const ToggleTracePanelDebug = Operation.make({
   meta: {
     key: makeKey('toggleTracePanelDebug'),

package/src/types/ChatSurface.ts

@@ -0,0 +1,16 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { Surface } from '@dxos/app-framework/ui';
+
+/**
+ * Role token for surfaces an agent requests inline in the conversation via the `<surface>` content
+ * block. `role` selects the concrete surface to render (e.g. `integration-prompt`); `data` carries
+ * its payload (e.g. `{ service: 'gmail.com' }`). Plugins contribute renderers by filtering on the
+ * inner `role`, which keeps the chat renderer decoupled from the specific surfaces it can host.
+ */
+export const ChatSurface: Surface.RoleToken<{
+  role: string;
+  data?: Record<string, unknown>;
+}> = Surface.makeType('org.dxos.plugin.assistant.role.chatSurface');

package/src/types/Ollama.ts

@@ -0,0 +1,59 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+// @import-as-namespace
+
+import { Atom } from '@effect-atom/atom-react';
+import type * as Effect from 'effect/Effect';
+
+import { type OllamaAdmin } from '@dxos/ai/resolvers';
+
+/**
+ * Reactive state of the local Ollama model installation, surfaced to the settings UI.
+ */
+export type ModelsState = {
+  kind: 'idle' | 'loading' | 'ready' | 'failed';
+  models: OllamaAdmin.Model[];
+  /** Models currently loaded into memory (from `/api/ps`). */
+  loaded: OllamaAdmin.RunningModel[];
+  /** In-flight pulls keyed by model name. */
+  pulls: Record<string, OllamaAdmin.PullProgress>;
+  /** Per-model action errors (load/unload/remove/pull), keyed by model name, shown inline. */
+  errors: Record<string, string>;
+  /** Connection-level error reaching the service (no specific model). */
+  error?: string;
+};
+
+/**
+ * Stable, empty model state. Subscribed to when no sidecar manager is present (web/mobile) so a
+ * reactive read keeps an unconditional hook order.
+ */
+export const emptyState: Atom.Atom<ModelsState> = Atom.make<ModelsState>({
+  kind: 'idle',
+  models: [],
+  loaded: [],
+  pulls: {},
+  errors: {},
+});
+
+/**
+ * Capability for managing locally-installed Ollama models. Implemented by the native (desktop)
+ * plugin against the bundled sidecar; absent in the browser/mobile, where the UI renders nothing.
+ */
+export type Manager = {
+  readonly endpoint: string;
+  state: Atom.Writable<ModelsState>;
+  /** List installed models (and currently-loaded models). Ensures the sidecar is running. */
+  refresh: Effect.Effect<void>;
+  /** Refresh only the currently-loaded models; cheap, for polling while a chat runs. */
+  refreshLoaded: Effect.Effect<void>;
+  pull: (name: string) => Effect.Effect<void>;
+  /** Abort an in-flight pull, leaving any already-downloaded layers in place. */
+  cancel: (name: string) => Effect.Effect<void>;
+  /** Load a model into memory (kept resident until unloaded). */
+  load: (name: string) => Effect.Effect<void>;
+  /** Unload a model from memory. */
+  unload: (name: string) => Effect.Effect<void>;
+  remove: (name: string) => Effect.Effect<void>;
+};