@dxos/plugin-assistant 0.8.4-staging.60fe92afc8 → 0.9.1-main.c7dcc2e112

package/src/components/TaskList/TaskList.tsx

@@ -2,44 +2,138 @@
 // Copyright 2026 DXOS.org
 //
 
-import React from 'react';
+import React, { useMemo } from 'react';
 
 import { Plan } from '@dxos/assistant-toolkit';
+import { type Process, type Trace } from '@dxos/compute';
 import { useObject } from '@dxos/react-client/echo';
+import { type Space } from '@dxos/react-client/echo';
 import { Icon, Tag, type ThemedClassName } from '@dxos/react-ui';
 import { composable, composableProps } from '@dxos/react-ui';
-import { Row, RowList } from '@dxos/react-ui-list';
+import { TextCrawl } from '@dxos/react-ui-components';
+import { Listbox } from '@dxos/react-ui-list';
+
+import { collectProcessActivityLines, deriveInFlightActivityLine } from '#execution-graph';
+import { isTerminalActivityLine, useProcessEphemeralStatus } from '#hooks';
 
 export type TaskListProps = ThemedClassName<{
   plan: Plan.Plan;
+  space?: Space;
+  /**
+   * Supervisor conversation feed id; trace messages without a conversation id still match by pid.
+   */
+  conversationId?: string;
+  traceMessages?: readonly Trace.Message[];
 }>;
 
-export const TaskList = composable<HTMLDivElement, TaskListProps>(({ plan, ...props }, forwardedRef) => {
-  const [snapshot] = useObject(plan);
-  const tasks = snapshot?.tasks ?? [];
+export const TaskList = composable<HTMLDivElement, TaskListProps>(
+  ({ plan, space, conversationId, traceMessages, ...props }, forwardedRef) => {
+    const [snapshot] = useObject(plan);
+    const tasks = snapshot?.tasks ?? [];
+
+    return (
+      <Listbox.Root>
+        <Listbox.Viewport {...composableProps(props, { classNames: 'dx-container' })} ref={forwardedRef}>
+          <Listbox.Content aria-label='Tasks'>
+            {tasks.map((task) => (
+              <TaskListItem
+                key={task.id}
+                task={task}
+                space={space}
+                traceMessages={traceMessages}
+                conversationId={conversationId}
+              />
+            ))}
+          </Listbox.Content>
+        </Listbox.Viewport>
+      </Listbox.Root>
+    );
+  },
+);
+
+type TaskListItemProps = {
+  task: Plan.Task;
+  space?: Space;
+  traceMessages?: readonly Trace.Message[];
+  conversationId?: string;
+};
+
+const TaskListItem = ({ task, space, traceMessages, conversationId }: TaskListItemProps) => {
+  const durableLines = useMemo(() => {
+    if (!task.agentPid || !traceMessages?.length) {
+      return [];
+    }
+    const lines = collectProcessActivityLines(traceMessages, String(task.agentPid), { conversationId });
+    if (task.status !== 'in-progress') {
+      return lines;
+    }
+    return lines.filter((line) => !isTerminalActivityLine(line));
+  }, [task.agentPid, task.status, traceMessages, conversationId]);
+
+  const ephemeralLine = useProcessEphemeralStatus(
+    task.delegated === true && task.status === 'in-progress' ? task.agentPid : undefined,
+    space,
+  );
+
+  const inFlightLine = useMemo(() => {
+    if (ephemeralLine || task.status !== 'in-progress' || !task.agentPid || !traceMessages?.length) {
+      return undefined;
+    }
+    return deriveInFlightActivityLine(traceMessages, String(task.agentPid), { conversationId });
+  }, [ephemeralLine, task.status, task.agentPid, traceMessages, conversationId]);
+
+  const activityLines = useMemo(() => {
+    if (ephemeralLine) {
+      return [ephemeralLine];
+    }
+    if (inFlightLine) {
+      return [inFlightLine];
+    }
+    return durableLines;
+  }, [durableLines, ephemeralLine, inFlightLine]);
+
+  const agentPid = task.agentPid;
+  const showActivity = task.delegated === true && agentPid != null && activityLines.length > 0;
+
+  return (
+    <Listbox.Item id={task.id} classNames='py-0'>
+      <div className='flex flex-col gap-0.5 min-w-0'>
+        <div className='flex items-center gap-2 min-w-0'>
+          <Icon
+            icon={task.status === 'done' ? 'ph--check--regular' : 'ph--circle--regular'}
+            classNames={task.status === 'done' ? 'text-success-text' : undefined}
+            size={4}
+          />
+          <span className='sr-only'>
+            {task.status === 'done' ? 'done' : task.status === 'in-progress' ? 'in progress' : 'to do'}
+          </span>
+          <span className='truncate flex-1'>{task.title}</span>
+          {task.status === 'in-progress' && <Tag palette='info'>pending</Tag>}
+          {task.agentPid && <Tag palette='info'>{Plan.formatAgentPidTag(task.agentPid)}</Tag>}
+        </div>
+        {showActivity && agentPid != null && <DelegatedTaskActivity agentPid={agentPid} lines={activityLines} />}
+      </div>
+    </Listbox.Item>
+  );
+};
+
+type DelegatedTaskActivityProps = {
+  agentPid: Process.ID;
+  lines: string[];
+};
 
+const DelegatedTaskActivity = ({ agentPid, lines }: DelegatedTaskActivityProps) => {
   return (
-    <RowList.Root>
-      <RowList.Viewport {...composableProps(props, { classNames: 'dx-container' })} ref={forwardedRef}>
-        <RowList.Content aria-label='Tasks'>
-          {tasks.map((task) => (
-            <Row key={task.id} id={task.id} classNames='py-0'>
-              <div className='flex items-center gap-2'>
-                <Icon
-                  icon={task.status === 'done' ? 'ph--check--regular' : 'ph--circle--regular'}
-                  classNames={task.status === 'done' ? 'text-success-text' : undefined}
-                  size={4}
-                />
-                <span className='sr-only'>
-                  {task.status === 'done' ? 'done' : task.status === 'in-progress' ? 'in progress' : 'to do'}
-                </span>
-                <span className='truncate flex-1'>{task.title}</span>
-                {task.status === 'in-progress' && <Tag palette='info'>pending</Tag>}
-              </div>
-            </Row>
-          ))}
-        </RowList.Content>
-      </RowList.Viewport>
-    </RowList.Root>
+    <div className='flex items-center gap-2 ps-6 min-w-0 text-placeholder'>
+      <Icon icon='ph--brain--regular' size={3} classNames='shrink-0 opacity-70' />
+      <TextCrawl
+        key={`${String(agentPid)}:${lines.length}:${lines[lines.length - 1]}`}
+        lines={lines}
+        autoAdvance
+        greedy
+        size='sm'
+        classNames='text-xs text-subdued min-w-0 flex-1'
+      />
+    </div>
   );
-});
+};

package/src/components/TemplateEditor/TemplateEditor.tsx

@@ -34,7 +34,7 @@ export type TemplateEditorProps = {
 
 export const TemplateEditor = composable<HTMLDivElement, TemplateEditorProps>(
   ({ classNames, id, source, lineNumbers = true, ...props }, forwardedRef) => {
-    const { t } = useTranslation(meta.id);
+    const { t } = useTranslation(meta.profile.key);
     const { themeMode } = useThemeContext();
     const { parentRef } = useTextEditor(() => {
       const target = source?.target;

package/src/components/TemplateEditor/TemplateForm.tsx

@@ -31,7 +31,7 @@ export type TemplateFormProps = {
 };
 
 export const TemplateForm = ({ id, template, onChange }: TemplateFormProps) => {
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
   usePromptInputs(template, onChange);
 
   const handleInputKindChange = useCallback(

package/src/components/ToolBlock/ToolBlock.tsx

@@ -23,7 +23,7 @@ export type ToolBlockProps = XmlWidgetProps<{
 }>;
 
 export const ToolBlock = ({ view, blocks = [] }: ToolBlockProps) => {
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
 
   const items = useMemo<ToolPanelProps['items']>(() => {
     let lastToolCall: { tool: Tool.Any | undefined; block: ContentBlock.ToolCall } | undefined;

package/src/components/index.ts

@@ -7,6 +7,7 @@ import { type ComponentType, lazy } from 'react';
 
 export * from './AgentProperties';
 export * from './Chat';
+export { TracePanel } from '../containers/TracePanel/TracePanel';
 export * from './ProcessTree';
 export * from './TaskList';
 export * from './TemplateEditor';

package/src/containers/AgentArticle/AgentArticle.stories.tsx

@@ -8,7 +8,7 @@ import React from 'react';
 
 import { withPluginManager } from '@dxos/app-framework/testing';
 import { Plan, Agent } from '@dxos/assistant-toolkit';
-import { Filter, Obj, Ref } from '@dxos/echo';
+import { Feed, Filter, Obj, Ref } from '@dxos/echo';
 import { AutomationPlugin } from '@dxos/plugin-automation/testing';
 import { ClientPlugin } from '@dxos/plugin-client/testing';
 import { initializeIdentity } from '@dxos/plugin-client/testing';
@@ -71,10 +71,10 @@ const meta = {
               const factory = createObjectFactory(space.db, random as any);
               const artifacts = yield* Effect.promise(() => factory(defaultSpec));
 
-              const inputQueue = space.queues.create();
+              const inputFeed = space.db.add(Feed.make({}));
               if (inputs) {
                 yield* Effect.promise(() =>
-                  inputQueue.append([
+                  space.db.appendToFeed(inputFeed, [
                     createMessage('user', [{ _tag: 'text', text: 'Summarize the current artifacts.' }]),
                     createMessage('assistant', [
                       { _tag: 'text', text: 'Here is a quick overview of the organizations and contacts in context.' },
@@ -92,7 +92,7 @@ const meta = {
                     name: Obj.getLabel(obj) ?? 'Artifact',
                     data: Ref.make(obj),
                   })),
-                  feed: Ref.fromURI(inputQueue.uri),
+                  feed: Ref.make(inputFeed),
                   subscriptions: [],
                 }),
               );

package/src/containers/AgentArticle/AgentArticle.tsx

@@ -12,7 +12,7 @@ import { AppSurface, useObjectMenuItems } from '@dxos/app-toolkit/ui';
 import { Agent } from '@dxos/assistant-toolkit';
 import { Database, Feed, Filter, Obj, Query, Ref } from '@dxos/echo';
 import { useQuery } from '@dxos/react-client/echo';
-import { Card, Message, Panel, ScrollArea, Toolbar, useTranslation } from '@dxos/react-ui';
+import { Card, Icon, IconButton, Message, Panel, ScrollArea, Toolbar, useTranslation } from '@dxos/react-ui';
 import { composable } from '@dxos/react-ui';
 import { Masonry } from '@dxos/react-ui-masonry';
 import { Menu } from '@dxos/react-ui-menu';
@@ -26,7 +26,7 @@ type Tab = 'artifacts' | 'inputs';
 export type AgentArticleProps = AppSurface.ObjectArticleProps<Agent.Agent>;
 
 export const AgentArticle = ({ role, subject: agent }: AgentArticleProps) => {
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
   const [tab, setTab] = useState<Tab>('artifacts');
   const [viewport, setViewport] = useState<HTMLElement | null>(null);
 
@@ -146,21 +146,21 @@ const ArtifactTileCard = composable<HTMLDivElement, { data: Obj.Unknown }>(({ da
   return (
     <Card.Root {...props} ref={forwardedRef} data-testid='board-item' fullWidth>
       <Card.Header>
-        <Card.IconBlock>
-          <Card.Icon icon={icon} />
-        </Card.IconBlock>
+        <Card.Block>
+          <Icon icon={icon} />
+        </Card.Block>
         <Card.Title>{Obj.getLabel(data, { fallback: 'typename' })}</Card.Title>
         {/* TODO(wittjosiah): Reconcile with Card.Menu. */}
-        <Card.IconBlock>
+        <Card.Block end>
           <Menu.Trigger asChild disabled={!objectMenuItems?.length}>
-            <Toolbar.IconButton iconOnly variant='ghost' icon='ph--dots-three-vertical--regular' label='Actions' />
+            <IconButton iconOnly variant='ghost' icon='ph--dots-three-vertical--regular' label='Actions' />
           </Menu.Trigger>
           <Menu.Content items={objectMenuItems} />
-        </Card.IconBlock>
+        </Card.Block>
       </Card.Header>
       <Card.Body>
         <Surface.Surface
-          type={AppSurface.Card}
+          type={AppSurface.CardContent}
           limit={1}
           data={{ subject: data } satisfies AppSurface.ObjectCardData}
         />

package/src/containers/ChatArticle/ChatArticle.tsx

@@ -2,14 +2,15 @@
 // Copyright 2025 DXOS.org
 //
 
-import React, { forwardRef, useEffect, useRef } from 'react';
+import React, { forwardRef, useCallback, useEffect, useRef } from 'react';
 
 import { Capabilities } from '@dxos/app-framework';
-import { useAtomCapability, useCapability } from '@dxos/app-framework/ui';
+import { useAtomCapability, useCapability, useOperationInvoker } from '@dxos/app-framework/ui';
 import { type AppSurface } from '@dxos/app-toolkit/ui';
 import { getSpace } from '@dxos/client/echo';
 import { type Obj } from '@dxos/echo';
-import { useRegistry } from '@dxos/react-client/echo';
+import { ClientOperation } from '@dxos/plugin-client';
+import { useObject, useRegistry } from '@dxos/react-client/echo';
 import { Panel } from '@dxos/react-ui';
 
 import { Chat as ChatComponent, type ChatRootProps } from '#components';
@@ -33,10 +34,20 @@ export const ChatArticle = forwardRef<HTMLDivElement, ChatArticleProps>(
     const [online, setOnline] = useOnline();
     const { preset, ...chatProps } = usePresets(online);
     const processor = useChatProcessor({ space, chat, preset, runtime, registry, settings });
-    const pendingSubmitted = useRef(false);
+
+    // Subscribe to the view type via `useObject` so the thread re-renders when ChatOptions changes it;
+    // a direct `chat.viewType` read in render does not establish a reactive dependency.
+    const [chatViewType] = useObject(chat, 'viewType');
+    const viewType = (chatViewType as Assistant.ChatView | undefined) ?? settings.chatView;
+
+    const { invokePromise } = useOperationInvoker();
+    const handleViewUsage = useCallback(() => {
+      void invokePromise(ClientOperation.OpenUsage, undefined);
+    }, [invokePromise]);
 
     // Reset the one-shot guard when the target conversation changes, so a pending prompt for a new
     // `attendableId` is still auto-submitted within the same mount.
+    const pendingSubmitted = useRef(false);
     useEffect(() => {
       pendingSubmitted.current = false;
     }, [attendableId]);
@@ -59,9 +70,6 @@ export const ChatArticle = forwardRef<HTMLDivElement, ChatArticleProps>(
       }
     }, [processor, attendableId, atomRegistry, stateAtom]);
 
-    const feedTarget = chat?.feed.target;
-    const view = (chat?.view as Assistant.ChatView | undefined) ?? settings.chatView;
-
     if (!processor) {
       return null;
     }
@@ -69,7 +77,7 @@ export const ChatArticle = forwardRef<HTMLDivElement, ChatArticleProps>(
     return (
       <ChatComponent.Root
         chat={chat}
-        feed={feedTarget}
+        feed={chat?.feed.target}
         db={space?.db}
         processor={processor}
         onEvent={onEvent}
@@ -82,8 +90,8 @@ export const ChatArticle = forwardRef<HTMLDivElement, ChatArticleProps>(
           <Panel.Content>
             <ChatComponent.Content>
               <div className='dx-container relative'>
-                <ChatComponent.Thread viewType={view} />
-                {view !== 'summary' && (
+                <ChatComponent.Thread viewType={viewType} onViewUsage={handleViewUsage} />
+                {viewType !== 'summary' && (
                   <div className='absolute bottom-2 left-0 right-0'>
                     <div className='dx-document px-4'>
                       <ChatComponent.Status classNames='px-3 rounded-sm bg-group-surface' />

package/src/containers/ChatCompanion/ChatCompanion.tsx

@@ -6,7 +6,7 @@ import * as Option from 'effect/Option';
 import React, { forwardRef, useCallback, useMemo } from 'react';
 
 import { useOperationInvoker } from '@dxos/app-framework/ui';
-import { BlueprintsAnnotation } from '@dxos/app-toolkit';
+import { AppAnnotation } from '@dxos/app-toolkit';
 import { type AppSurface } from '@dxos/app-toolkit/ui';
 import { Chat } from '@dxos/assistant-toolkit';
 import { getSpace } from '@dxos/client/echo';
@@ -83,7 +83,7 @@ const useBlueprints = ({ subject: chat, companionTo }: Pick<ChatCompanionProps,
       return [] as string[];
     }
 
-    return Option.getOrElse(() => [] as string[])(BlueprintsAnnotation.get(Type.getSchema(schema)));
+    return Option.getOrElse(() => [] as string[])(AppAnnotation.BlueprintsAnnotation.get(Type.getSchema(schema)));
   }, [companionTo]);
 
   const existingBlueprints = useQuery(space?.db, Filter.type(Blueprint.Blueprint));

package/src/containers/ChatDialog/ChatDialog.tsx

@@ -7,7 +7,7 @@ import React, { useCallback, useState } from 'react';
 import { useAtomCapability } from '@dxos/app-framework/ui';
 import { type Chat as ChatTypes } from '@dxos/assistant-toolkit';
 import { Obj } from '@dxos/echo';
-import { useRegistry } from '@dxos/react-client/echo';
+import { useObject, useRegistry } from '@dxos/react-client/echo';
 import { useTranslation } from '@dxos/react-ui';
 import { ChatDialog as NaturalChatDialog } from '@dxos/react-ui-chat';
 
@@ -21,7 +21,7 @@ export type ChatDialogProps = {
 };
 
 export const ChatDialog = ({ chat }: ChatDialogProps) => {
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
 
   const db = chat && Obj.getDatabase(chat);
   const settings = useAtomCapability(AssistantCapabilities.Settings);
@@ -30,6 +30,8 @@ export const ChatDialog = ({ chat }: ChatDialogProps) => {
   const { preset, ...chatProps } = usePresets(online);
   const registry = useRegistry();
   const processor = useChatProcessor({ chat, preset, runtime, registry, settings });
+  // Subscribe via `useObject` so the thread re-renders when ChatOptions changes the view type.
+  const [chatViewType] = useObject(chat, 'viewType');
 
   // TODO(burdon): Refocus when open.
   const [open, setOpen] = useState(true);
@@ -56,7 +58,7 @@ export const ChatDialog = ({ chat }: ChatDialogProps) => {
       <NaturalChatDialog.Root open={open} expanded={expanded} onOpenChange={setOpen}>
         <NaturalChatDialog.Header title={t('assistant-dialog.title')} />
         <NaturalChatDialog.Content>
-          <Chat.Thread viewType={(chat.view as Assistant.ChatView | undefined) ?? settings.chatView} />
+          <Chat.Thread viewType={(chatViewType as Assistant.ChatView | undefined) ?? settings.chatView} />
         </NaturalChatDialog.Content>
         <NaturalChatDialog.Footer classNames='p-1.5'>
           <Chat.Prompt {...chatProps} preset={preset?.id} online={online} onOnlineChange={setOnline} expandable />

package/src/containers/PlanArticle/PlanArticle.tsx

@@ -6,15 +6,19 @@ import React from 'react';
 
 import { type AppSurface } from '@dxos/app-toolkit/ui';
 import { type Plan } from '@dxos/assistant-toolkit';
+import { getSpace } from '@dxos/client/echo';
 import { Panel, ScrollArea, Toolbar } from '@dxos/react-ui';
 import { useAttention } from '@dxos/react-ui-attention';
 
 import { TaskList } from '#components';
+import { useTraceMessages } from '#hooks';
 
 export type PlanArticleProps = AppSurface.ObjectArticleProps<Plan.Plan>;
 
 export const PlanArticle = ({ role, attendableId, subject }: PlanArticleProps) => {
   const { hasAttention } = useAttention(attendableId);
+  const space = getSpace(subject);
+  const traceMessages = useTraceMessages(space);
 
   return (
     <Panel.Root role={role} classNames='dx-document'>
@@ -24,7 +28,7 @@ export const PlanArticle = ({ role, attendableId, subject }: PlanArticleProps) =
       <Panel.Content asChild>
         <ScrollArea.Root orientation='vertical'>
           <ScrollArea.Viewport>
-            <TaskList plan={subject} />
+            <TaskList plan={subject} space={space} traceMessages={traceMessages} />
           </ScrollArea.Viewport>
         </ScrollArea.Root>
       </Panel.Content>

package/src/containers/RoutineArticle/RoutineArticle.tsx

@@ -27,7 +27,7 @@ type RunState =
 
 // TODO(burdon): Trigger editor.
 export const RoutineArticle = ({ role, attendableId, subject }: RoutineArticleProps) => {
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
   const { hasAttention } = useAttention(attendableId);
   const invoke = usePromptHandler(subject);
   const [state, setState] = useState<RunState>({ status: 'idle' });
@@ -73,7 +73,7 @@ export const RoutineArticle = ({ role, attendableId, subject }: RoutineArticlePr
 };
 
 const RoutineResult = ({ state }: { state: RunState }) => {
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
   switch (state.status) {
     case 'idle':
       return null;

package/src/containers/SpaceHomePrompt/SpaceHomePrompt.tsx

@@ -0,0 +1,105 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import React, { useEffect, useMemo, useState } from 'react';
+
+import { Capabilities } from '@dxos/app-framework';
+import { useCapability, useOperationInvoker } from '@dxos/app-framework/ui';
+import { LayoutOperation } from '@dxos/app-toolkit';
+import { Event } from '@dxos/async';
+import { type Space, useRegistry } from '@dxos/react-client/echo';
+import { useTranslation } from '@dxos/react-ui';
+
+import { ChatPrompt, type ChatEvent } from '#components';
+import { useChatProcessor, useChatServices, useOnline, usePresets } from '#hooks';
+import { meta } from '#meta';
+import { AssistantCapabilities, AssistantOperation, type ChatType } from '#types';
+
+import { getChatPath } from '../../paths';
+
+type SpaceScopedProps = {
+  space?: Space;
+};
+
+/**
+ * Home article pinned-bottom contributor: the assistant prompt. Backed by an ephemeral in-memory
+ * chat whose sole responsibility is to collect the user's text, context bindings, and preset
+ * choice, then on submit: persist the chat to the space, queue the text as a pending prompt, and
+ * navigate to it. AI generation runs in the opened chat view — the processor here exists only to
+ * back the context-binder UI.
+ */
+export const SpaceHomePrompt = ({ space }: SpaceScopedProps) => {
+  const { t } = useTranslation(meta.profile.key);
+  const { invokePromise } = useOperationInvoker();
+
+  const registry = useRegistry();
+  const atomRegistry = useCapability(Capabilities.AtomRegistry);
+  const stateAtom = useCapability(AssistantCapabilities.State);
+  const runtime = useChatServices({ id: space?.id });
+  const [online, setOnline] = useOnline();
+  const { preset, ...presetProps } = usePresets(online);
+
+  // In-memory backing chat (not yet added to the space). `nonce` forces a fresh chat after submit.
+  const [chat, setChat] = useState<ChatType.Chat>();
+  const [nonce, setNonce] = useState(0);
+  useEffect(() => {
+    if (!space) {
+      setChat(undefined);
+      return;
+    }
+    let cancelled = false;
+    void invokePromise(AssistantOperation.CreateChat, { db: space.db, addToSpace: false }).then((result) => {
+      if (!cancelled) {
+        setChat(result.data?.object);
+      }
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [space, nonce, invokePromise]);
+
+  const processor = useChatProcessor({ space, chat, preset, runtime, registry });
+
+  const event = useMemo(() => new Event<ChatEvent>(), []);
+  useEffect(() => {
+    return event.on((ev) => {
+      if (ev.type !== 'submit') {
+        return;
+      }
+      const text = ev.text.trim();
+      if (!space || !chat || text.length === 0) {
+        return;
+      }
+
+      // Persist the in-memory chat, queue the prompt, and open the chat (which submits it).
+      space.db.add(chat);
+      const chatPath = getChatPath(space.db.spaceId, chat.id);
+      atomRegistry.update(stateAtom, (current) => ({
+        ...current,
+        pendingPrompts: { ...current.pendingPrompts, [chatPath]: text },
+      }));
+      void invokePromise(LayoutOperation.Open, { subject: [chatPath] });
+      setNonce((current) => current + 1);
+    });
+  }, [event, space, chat, atomRegistry, stateAtom, invokePromise]);
+
+  if (!processor || !chat || !space) {
+    return null;
+  }
+
+  return (
+    <ChatPrompt
+      {...presetProps}
+      outline
+      chat={chat}
+      db={space.db}
+      processor={processor}
+      event={event}
+      preset={preset?.id}
+      online={online}
+      onOnlineChange={setOnline}
+      placeholder={t('space-home.prompt.placeholder')}
+    />
+  );
+};

package/src/containers/SpaceHomePrompt/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+export { SpaceHomePrompt as default } from './SpaceHomePrompt';

package/src/containers/SpaceHomeSuggestions/SpaceHomeSuggestions.tsx

@@ -0,0 +1,69 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import React, { useCallback } from 'react';
+
+import { useOperationInvoker } from '@dxos/app-framework/ui';
+import { type Space } from '@dxos/react-client/echo';
+import { Card, IconButton, useTranslation } from '@dxos/react-ui';
+
+import { meta } from '#meta';
+import { AssistantOperation } from '#types';
+
+/** Starter prompts shown on the Home page. Always rendered — they surface quick actions alongside
+ * the recent-objects masonry rather than only as an empty-state fallback. */
+const SUGGESTION_KEYS = [
+  'space-home.suggestion-draft-doc.label',
+  'space-home.suggestion-data-type.label',
+  'space-home.suggestion-ideas.label',
+] as const;
+
+type SpaceScopedProps = {
+  space?: Space;
+};
+
+/**
+ * Home content contributor: starter-prompt cards. Each card runs its prompt in a new chat via the
+ * assistant operation. Always renders (below the recent-objects masonry) so the Home page offers
+ * quick entry points regardless of whether recent objects exist.
+ */
+export const SpaceHomeSuggestions = ({ space }: SpaceScopedProps) => {
+  const { t } = useTranslation(meta.profile.key);
+  const { invokePromise } = useOperationInvoker();
+
+  const handleRunPrompt = useCallback(
+    (prompt: string) => {
+      if (!space) {
+        return;
+      }
+      void invokePromise(AssistantOperation.RunPromptInNewChat, { db: space.db, prompt });
+    },
+    [invokePromise, space],
+  );
+
+  return (
+    <>
+      <h2 className='text-sm font-medium text-description'>{t('space-home.suggestions.heading')}</h2>
+      {SUGGESTION_KEYS.map((key) => {
+        const prompt = t(key);
+        return (
+          <Card.Root
+            key={key}
+            fullWidth
+            role='button'
+            classNames='cursor-pointer'
+            onClick={() => handleRunPrompt(prompt)}
+          >
+            <Card.Header>
+              <Card.Block>
+                <IconButton variant='ghost' label={prompt} icon='ph--sparkle--regular' iconOnly />
+              </Card.Block>
+              <Card.Title>{prompt}</Card.Title>
+            </Card.Header>
+          </Card.Root>
+        );
+      })}
+    </>
+  );
+};

package/src/containers/SpaceHomeSuggestions/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+export { SpaceHomeSuggestions as default } from './SpaceHomeSuggestions';