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

package/src/containers/SpaceHomePrompt/SpaceHomePrompt.tsx

@@ -0,0 +1,107 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import React, { useEffect, useMemo, useState } from 'react';
+
+import { Provider } from '@dxos/ai';
+import { Capabilities } from '@dxos/app-framework';
+import { useAtomCapability, 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 { type ChatEvent, ChatPrompt } from '#components';
+import { useChatProcessor, useChatServices, 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 settings = useAtomCapability(AssistantCapabilities.Settings);
+  const { preset, ...presetProps } = usePresets(settings);
+  // The remote (online) service is the edge provider; the resolved preset carries the active provider.
+  const online = preset?.provider === Provider.edge.id;
+
+  // 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}
+      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,83 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import React, { useCallback } from 'react';
+
+import { useOperationInvoker } from '@dxos/app-framework/ui';
+import { RoutineOperation } from '@dxos/plugin-routine/types';
+import { type Space } from '@dxos/react-client/echo';
+import { Card, IconButton, useTranslation } from '@dxos/react-ui';
+
+import { useHomeSuggestions } from '#hooks';
+import { meta } from '#meta';
+
+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 suggestions = useHomeSuggestions(space);
+
+  const handleRunPrompt = useCallback(
+    (prompt: string) => {
+      if (!space) {
+        return;
+      }
+      void invokePromise(RoutineOperation.RunPromptInNewChat, { db: space.db, instructions: prompt });
+    },
+    [invokePromise, space],
+  );
+
+  if (!suggestions) {
+    return null;
+  }
+
+  return (
+    <div className='flex justify-center w-full'>
+      <div className='flex flex-col gap-trim-sm w-full max-w-[40rem]'>
+        <h2 className='text-sm font-medium text-description'>{t('space-home.suggestions.heading')}</h2>
+        <div className='flex flex-col gap-3'>
+          {suggestions.map((prompt, index) => (
+            <div
+              key={`${index}:${prompt}`}
+              role='button'
+              tabIndex={0}
+              className='cursor-pointer w-full'
+              onClick={() => handleRunPrompt(prompt)}
+              onKeyDown={(e) => {
+                if (e.key === 'Enter' || e.key === ' ') {
+                  e.preventDefault();
+                  handleRunPrompt(prompt);
+                }
+              }}
+            >
+              <Card.Root fullWidth>
+                <Card.Header>
+                  <Card.Block>
+                    <IconButton
+                      variant='ghost'
+                      label={prompt}
+                      icon='ph--sparkle--regular'
+                      iconOnly
+                      tabIndex={-1}
+                      aria-hidden
+                    />
+                  </Card.Block>
+                  <Card.Title>{prompt}</Card.Title>
+                </Card.Header>
+              </Card.Root>
+            </div>
+          ))}
+        </div>
+      </div>
+    </div>
+  );
+};

package/src/containers/SpaceHomeSuggestions/index.ts

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

package/src/containers/TracePanel/TracePanel.stories.tsx

@@ -14,14 +14,16 @@ import { ProcessManager } from '@dxos/compute-runtime';
 import { Feed, Filter, Query } from '@dxos/echo';
 import { FeedTraceSink } from '@dxos/functions-runtime';
 import { log } from '@dxos/log';
-import { AutomationPlugin } from '@dxos/plugin-automation/testing';
 import { ClientPlugin } from '@dxos/plugin-client/testing';
 import { initializeIdentity } from '@dxos/plugin-client/testing';
+import { RoutinePlugin } from '@dxos/plugin-routine/testing';
 import { corePlugins } from '@dxos/plugin-testing';
 import { useQuery, useSpaces } from '@dxos/react-client/echo';
 import { IconButton, Panel, ScrollContainer, Toolbar } from '@dxos/react-ui';
-import { Timeline } from '@dxos/react-ui-components';
+import { type Commit, Timeline } from '@dxos/react-ui-components';
+import { Syntax } from '@dxos/react-ui-syntax-highlighter';
 import { withLayout, withTheme } from '@dxos/react-ui/testing';
+import { mx } from '@dxos/ui-theme';
 
 import { buildExecutionGraph } from '#execution-graph';
 import { AssistantPlugin } from '#plugin';
@@ -30,7 +32,7 @@ import { translations } from '#translations';
 import subAgentFixture from '../../execution-graph/testing/sub-agent-delegation.json';
 // TODO(dmaretskyi): testing.ts module shadows the ./testing dir.
 import { initClientFromSpaceSnapshot } from '../../testing/snapshot';
-import { PLAYBACK_INTERVAL_MS, STEP_STORAGE_KEY, SimulatedAgent, useLocalStorageNumber } from './testing';
+import { PLAYBACK_INTERVAL_MS, SimulatedAgent, STEP_STORAGE_KEY, useLocalStorageNumber } from './testing';
 import { TracePanel } from './TracePanel';
 
 type BaseStoryProps = PropsWithChildren<{
@@ -38,12 +40,34 @@ type BaseStoryProps = PropsWithChildren<{
 }>;
 
 const BaseStory = ({ children, toolbar }: BaseStoryProps) => (
-  <Panel.Root>
+  <Panel.Root classNames='h-full min-h-0'>
     <Panel.Toolbar asChild>{toolbar}</Panel.Toolbar>
-    <Panel.Content asChild>{children}</Panel.Content>
+    <Panel.Content asChild classNames='min-h-0'>
+      {children}
+    </Panel.Content>
   </Panel.Root>
 );
 
+const JsonInspectorPanel = ({ data }: { data: unknown }) => (
+  <div className='min-h-0 h-full'>
+    <ScrollContainer.Root pin>
+      <ScrollContainer.Content thin>
+        <ScrollContainer.Viewport>
+          <Syntax.Root data={data}>
+            <Syntax.Content>
+              <Syntax.Viewport>
+                <Syntax.Code className='text-xs' />
+              </Syntax.Viewport>
+            </Syntax.Content>
+          </Syntax.Root>
+        </ScrollContainer.Viewport>
+        <ScrollContainer.ScrollDownButton />
+        <ScrollContainer.Fade />
+      </ScrollContainer.Content>
+    </ScrollContainer.Root>
+  </div>
+);
+
 const DefaultStory = () => {
   const [space] = useSpaces();
   const runtime = useProcessManagerRuntime();
@@ -100,7 +124,7 @@ const SnapshotStory = () => {
     [allMessages],
   );
 
-  return <TimelinePlayback messages={sortedMessages} />;
+  return <TimelinePlayback messages={sortedMessages} collapseCompletedSpans={true} />;
 };
 
 // Raw Trace.Message[] captured from a live sub-agent delegation via `dxosDumpTrace()` (see
@@ -121,10 +145,17 @@ const FixtureStory = () => {
  * Step/playback over a fixed list of trace messages — renders the execution-graph Timeline at each
  * step so layout (e.g. concurrent sub-agent lanes) can be inspected as events "stream" in.
  */
-const TimelinePlayback = ({ messages: sortedMessages }: { messages: readonly Trace.Message[] }) => {
+const TimelinePlayback = ({
+  messages: sortedMessages,
+  collapseCompletedSpans = true,
+}: {
+  messages: readonly Trace.Message[];
+  collapseCompletedSpans?: boolean;
+}) => {
   const total = sortedMessages.length;
   const [step, setStep, stepHydrated] = useLocalStorageNumber(STEP_STORAGE_KEY, 0);
   const [playing, setPlaying] = useState(false);
+  const [selectedCommit, setSelectedCommit] = useState<Commit | undefined>();
 
   useEffect(() => {
     setStep((current) => Math.min(Math.max(current, 0), total));
@@ -143,10 +174,13 @@ const TimelinePlayback = ({ messages: sortedMessages }: { messages: readonly Tra
   }, [total, stepHydrated, setStep]);
 
   const visibleMessages = useMemo(() => sortedMessages.slice(0, step), [sortedMessages, step]);
-  const { commits, branches } = useMemo(
-    () => buildExecutionGraph({ traceMessages: visibleMessages }),
-    [visibleMessages],
+  const { commits, branches, spanTree, details } = useMemo(
+    () => buildExecutionGraph({ traceMessages: visibleMessages, collapseCompletedSpans }),
+    [visibleMessages, collapseCompletedSpans],
   );
+  const selectedCommitDetail = selectedCommit
+    ? { commit: selectedCommit, detail: details[selectedCommit.id] }
+    : undefined;
 
   // Auto-play steps forward until we reach the end.
   useEffect(() => {
@@ -215,35 +249,43 @@ const TimelinePlayback = ({ messages: sortedMessages }: { messages: readonly Tra
   }, [handleNext, handlePrev, handleTogglePlay, handleReset, handleShowAll]);
 
   return (
-    <ScrollContainer.Root pin>
-      <BaseStory
-        toolbar={
-          <Toolbar.Root>
-            <IconButton iconOnly icon='ph--skip-back--regular' label='Reset (R)' onClick={handleReset} />
-            <IconButton iconOnly icon='ph--caret-left--regular' label='Step back (← / H)' onClick={handlePrev} />
-            <IconButton
-              iconOnly
-              icon={playing ? 'ph--pause--regular' : 'ph--play--regular'}
-              label={playing ? 'Pause (Space)' : 'Play (Space)'}
-              onClick={handleTogglePlay}
-            />
-            <IconButton iconOnly icon='ph--caret-right--regular' label='Step forward (→ / L)' onClick={handleNext} />
-            <IconButton iconOnly icon='ph--skip-forward--regular' label='Show all (E / End)' onClick={handleShowAll} />
-            <Toolbar.Text className='text-right text-sm tabular-nums opacity-70'>
-              {step} / {total}
-            </Toolbar.Text>
-          </Toolbar.Root>
-        }
-      >
-        <ScrollContainer.Content thin>
-          <ScrollContainer.Viewport>
-            <Timeline branches={branches} commits={commits} showTimestamp />
-          </ScrollContainer.Viewport>
-          <ScrollContainer.ScrollDownButton />
-          <ScrollContainer.Fade />
-        </ScrollContainer.Content>
-      </BaseStory>
-    </ScrollContainer.Root>
+    <BaseStory
+      toolbar={
+        <Toolbar.Root>
+          <IconButton iconOnly icon='ph--skip-back--regular' label='Reset (R)' onClick={handleReset} />
+          <IconButton iconOnly icon='ph--caret-left--regular' label='Step back (← / H)' onClick={handlePrev} />
+          <IconButton
+            iconOnly
+            icon={playing ? 'ph--pause--regular' : 'ph--play--regular'}
+            label={playing ? 'Pause (Space)' : 'Play (Space)'}
+            onClick={handleTogglePlay}
+          />
+          <IconButton iconOnly icon='ph--caret-right--regular' label='Step forward (→ / L)' onClick={handleNext} />
+          <IconButton iconOnly icon='ph--skip-forward--regular' label='Show all (E / End)' onClick={handleShowAll} />
+          <Toolbar.Text className='text-right text-sm tabular-nums opacity-70'>
+            {step} / {total}
+          </Toolbar.Text>
+        </Toolbar.Root>
+      }
+    >
+      <div className={mx('grid h-full min-h-0 grid-cols-3 divide-x divide-separator')}>
+        <JsonInspectorPanel data={spanTree} />
+
+        <div className='min-h-0'>
+          <ScrollContainer.Root pin>
+            <ScrollContainer.Content thin>
+              <ScrollContainer.Viewport>
+                <Timeline branches={branches} commits={commits} showTimestamp onSelect={setSelectedCommit} />
+              </ScrollContainer.Viewport>
+              <ScrollContainer.ScrollDownButton />
+              <ScrollContainer.Fade />
+            </ScrollContainer.Content>
+          </ScrollContainer.Root>
+        </div>
+
+        <JsonInspectorPanel data={selectedCommitDetail} />
+      </div>
+    </BaseStory>
   );
 };
 
@@ -277,7 +319,7 @@ export const Default: Story = {
             }),
         }),
         AssistantPlugin(),
-        AutomationPlugin(),
+        RoutinePlugin(),
       ],
     }),
   ],
@@ -285,14 +327,14 @@ export const Default: Story = {
 
 export const WithSubAgentFixture: Story = {
   render: FixtureStory,
-  decorators: [withTheme(), withLayout({ layout: 'column', classNames: 'w-(--dx-complementary-sidebar-size)' })],
+  decorators: [withTheme(), withLayout({ layout: 'fullscreen' })],
 };
 
 export const WithSnapshot: Story = {
   render: SnapshotStory,
   decorators: [
     withTheme(),
-    withLayout({ layout: 'column', classNames: 'w-(--dx-complementary-sidebar-size)' }),
+    withLayout({ layout: 'fullscreen' }),
     withPluginManager({
       plugins: [
         ...corePlugins(),
@@ -300,7 +342,7 @@ export const WithSnapshot: Story = {
           types: [Feed.Feed, Trace.Message],
           onClientInitialized: initClientFromSpaceSnapshot(() => import('../../testing/data/trace-timeline.dx.json')),
         }),
-        AutomationPlugin(),
+        RoutinePlugin(),
       ],
     }),
   ],
@@ -310,7 +352,7 @@ export const WithRemoteSnapshot: Story = {
   render: SnapshotStory,
   decorators: [
     withTheme(),
-    withLayout({ layout: 'column', classNames: 'w-(--dx-complementary-sidebar-size)' }),
+    withLayout({ layout: 'fullscreen' }),
     withPluginManager({
       plugins: [
         ...corePlugins(),
@@ -320,7 +362,7 @@ export const WithRemoteSnapshot: Story = {
             () => import('../../testing/data/trace-timeline-remote.dx.json'),
           ),
         }),
-        AutomationPlugin(),
+        RoutinePlugin(),
       ],
     }),
   ],
@@ -330,7 +372,7 @@ export const WithRemoteMultipleSnapshot: Story = {
   render: SnapshotStory,
   decorators: [
     withTheme(),
-    withLayout({ layout: 'column', classNames: 'w-(--dx-complementary-sidebar-size)' }),
+    withLayout({ layout: 'fullscreen' }),
     withPluginManager({
       plugins: [
         ...corePlugins(),
@@ -340,7 +382,7 @@ export const WithRemoteMultipleSnapshot: Story = {
             () => import('../../testing/data/trace-timeline-multiple.dx.json'),
           ),
         }),
-        AutomationPlugin(),
+        RoutinePlugin(),
       ],
     }),
   ],

package/src/containers/TracePanel/TracePanel.tsx

@@ -10,23 +10,22 @@ import { pipe } from 'effect/Function';
 import React, { useCallback, useDeferredValue, useEffect, useMemo, useState } from 'react';
 
 import { Capabilities } from '@dxos/app-framework';
-import { useCapability, useAtomCapability, useOperationInvoker } from '@dxos/app-framework/ui';
+import { useAtomCapability, useCapability, useOperationInvoker } from '@dxos/app-framework/ui';
 import { LayoutOperation } from '@dxos/app-toolkit';
 import { type AppSurface } from '@dxos/app-toolkit/ui';
-import { Process, Trace } from '@dxos/compute';
-import { Filter, Query } from '@dxos/echo';
-import { FeedTraceSink } from '@dxos/functions-runtime';
+import { Process } from '@dxos/compute';
 import { EID } from '@dxos/keys';
 import { type Space } from '@dxos/react-client/echo';
 import { ScrollContainer } from '@dxos/react-ui';
 import { composable, composableProps } from '@dxos/react-ui';
 import { useAttentionAttributes } from '@dxos/react-ui-attention';
-import { Timeline, type Commit } from '@dxos/react-ui-components';
+import { type Commit, Timeline } from '@dxos/react-ui-components';
 import { Syntax } from '@dxos/react-ui-syntax-highlighter';
 import { mx } from '@dxos/ui-theme';
 
 import { ProcessTree, ProcessTreeProps } from '#components';
-import { buildExecutionGraph, type ExecutionGraph } from '#execution-graph';
+import { type ExecutionGraph, buildExecutionGraph } from '#execution-graph';
+import { getTraceMessagesAtom, useTraceMessages } from '#hooks';
 import { AssistantCapabilities } from '#types';
 
 export type TracePanelProps = AppSurface.SpaceArticleProps<Pick<ProcessTreeProps, 'onProcessTerminate'>>;
@@ -160,52 +159,29 @@ export const TracePanel = composable<HTMLDivElement, TracePanelProps>(
 const atomEmpty = Atom.make(() => [] as const);
 
 type UseExecutionGraphOptions = {
+  collapseCompletedSpans?: boolean;
   eventLimit?: number;
 };
 
-const useExecutionGraph = (space: Space, { eventLimit }: UseExecutionGraphOptions = {}): ExecutionGraph => {
+const useExecutionGraph = (
+  space: Space,
+  { collapseCompletedSpans, eventLimit }: UseExecutionGraphOptions = {},
+): ExecutionGraph => {
   const monitor = useCapability(Capabilities.ProcessMonitor);
   const processesAtom = monitor?.processTreeAtom ?? atomEmpty;
 
   const atom = useMemo(
-    () => getExecutionGraph(space, processesAtom, { eventLimit }),
-    [space, processesAtom, eventLimit],
-  );
-
-  return useAtomValue(atom);
-};
-
-/**
- * Atom of the raw trace messages for a space — the exact `Trace.Message[]` fed into
- * `buildExecutionGraph`. Shared by the execution graph and the debug trace export.
- */
-const getTraceMessagesAtom = (space: Space): Atom.Atom<readonly Trace.Message[]> =>
-  pipe(
-    space.db.query(FeedTraceSink.query).atom,
-    Atom.map(
-      (feeds) =>
-        // TODO(dmaretskyi): This should be possible in a single query with properly working limit(1) and feed > feed contents traversal.
-        space.db.query(
-          feeds.length > 0
-            ? Query.type(Trace.Message).from(feeds[0])
-            : (Query.select(Filter.nothing()) as Query.Query<never>),
-        ).atom,
-    ),
-    (atom) => Atom.make((get) => get(get(atom))),
+    () => getExecutionGraph(space, processesAtom, { collapseCompletedSpans, eventLimit }),
+    [space, processesAtom, collapseCompletedSpans, eventLimit],
   );
 
-/**
- * Returns the raw trace messages for a space (used by the debug trace export).
- */
-const useTraceMessages = (space: Space): readonly Trace.Message[] => {
-  const atom = useMemo(() => getTraceMessagesAtom(space), [space]);
   return useAtomValue(atom);
 };
 
 const getExecutionGraph = (
   space: Space,
   processesAtom: Atom.Atom<readonly Process.Info[]>,
-  { eventLimit = 100 }: UseExecutionGraphOptions = {},
+  { collapseCompletedSpans = true, eventLimit = 100 }: UseExecutionGraphOptions = {},
 ): Atom.Atom<ExecutionGraph> => {
   const traceMessages = getTraceMessagesAtom(space);
 
@@ -226,6 +202,7 @@ const getExecutionGraph = (
     buildExecutionGraph({
       traceMessages: get(traceMessages),
       activeProcesses: get(activeProcesses),
+      collapseCompletedSpans,
       eventLimit,
     }),
   );
@@ -250,6 +227,7 @@ const ProcessTreeContainer = ({
   return (
     <ProcessTree
       processes={processesDeferred}
+      depth={3}
       onProcessSelect={onProcessSelect}
       onProcessTerminate={onProcessTerminate}
     />

package/src/containers/TracePanel/dxn-extractor.test.ts

@@ -5,8 +5,8 @@
 import { describe, test } from 'vitest';
 
 import {
-  extractDxnsFromObject,
   extractDxnFromString,
+  extractDxnsFromObject,
   extractFirstDxnFromToolInput,
   extractFirstDxnFromToolResult,
 } from './dxn-extractor';
@@ -57,7 +57,7 @@ describe('dxn-extractor', () => {
     test('extracts @uri key reference { "@uri": "echo:..." }', ({ expect }) => {
       const result = extractDxnsFromObject({
         '@uri': 'echo:/01KG7R1ZXWFMWQ4DA1Q6TN1DG4',
-        name: 'Test',
+        'name': 'Test',
       });
       expect(result).toHaveLength(1);
       expect(result[0].toString()).toBe('echo:/01KG7R1ZXWFMWQ4DA1Q6TN1DG4');

package/src/containers/TriggerStatus/TriggerStatus.tsx

@@ -6,9 +6,10 @@ import React, { useMemo } from 'react';
 
 import { AppSurface } from '@dxos/app-toolkit/ui';
 import { type InvocationsState } from '@dxos/functions-runtime';
-import { useTriggerRuntimeControls } from '@dxos/plugin-automation/hooks';
+import { useTriggerRuntimeControls } from '@dxos/plugin-routine/hooks';
 import { StatusBar } from '@dxos/plugin-status-bar/components';
-import { useObject } from '@dxos/react-client/echo';
+import { useMulticastObservable } from '@dxos/react-client';
+import { SpaceState, useObject } from '@dxos/react-client/echo';
 import { IconButton, Popover, useTranslation } from '@dxos/react-ui';
 
 import { meta } from '#meta';
@@ -44,11 +45,14 @@ const getIconClassNames = (state: TriggerStatusState): string | undefined => {
 export type SpaceStatusProps = AppSurface.SpaceArticleProps;
 
 export const SpaceStatus = ({ space }: SpaceStatusProps) => {
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
   const { state } = useTriggerRuntimeControls(space.db);
   const isEnabled = state?.enabled ?? false;
-  const [properties] = useObject(space.properties);
-  const computeEnvironment = properties.computeEnvironment ?? 'local';
+  // `space.properties` throws until the space finishes initializing (e.g. right after joining);
+  // gate on `space.state` so this component doesn't crash for a freshly-joined space.
+  const spaceState = useMulticastObservable(space.state);
+  const [properties] = useObject(spaceState === SpaceState.SPACE_READY ? space.properties : undefined);
+  const computeEnvironment = properties?.computeEnvironment ?? 'local';
 
   // Determine the current trigger status state.
   const triggerState: TriggerStatusState = useMemo(() => {
@@ -115,7 +119,7 @@ const TriggerStatusPopover = ({
   currentFunctionName,
   lastInvocation, // TODO(burdon): Show.
 }: TriggerStatusPopoverProps) => {
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
 
   return (
     <div className='flex flex-col gap-2 p-2 w-[240px]'>

package/src/containers/index.ts

@@ -6,12 +6,13 @@ import { type ComponentType, lazy } from 'react';
 
 export const AgentArticle: ComponentType<any> = lazy(() => import('./AgentArticle'));
 export const AgentProperties: ComponentType<any> = lazy(() => import('./AgentProperties'));
-export const BlueprintArticle: ComponentType<any> = lazy(() => import('./BlueprintArticle'));
+export const AssistantSettings: ComponentType<any> = lazy(() => import('./AssistantSettings'));
 export const ChatCompanion: ComponentType<any> = lazy(() => import('./ChatCompanion'));
 export const ChatArticle: ComponentType<any> = lazy(() => import('./ChatArticle'));
 export const ChatDialog: ComponentType<any> = lazy(() => import('./ChatDialog'));
+export const IntegrationPrompt: ComponentType<any> = lazy(() => import('./IntegrationPrompt'));
 export const PlanArticle: ComponentType<any> = lazy(() => import('./PlanArticle'));
-export const RoutineArticle: ComponentType<any> = lazy(() => import('./RoutineArticle'));
-export const RoutineList: ComponentType<any> = lazy(() => import('./RoutineList'));
+export const SpaceHomePrompt: ComponentType<any> = lazy(() => import('./SpaceHomePrompt'));
+export const SpaceHomeSuggestions: ComponentType<any> = lazy(() => import('./SpaceHomeSuggestions'));
 export const TracePanel: ComponentType<any> = lazy(() => import('./TracePanel'));
 export const TriggerStatus: ComponentType<any> = lazy(() => import('./TriggerStatus'));

package/src/execution-graph/SPEC.md

@@ -392,7 +392,7 @@ process in `activeProcesses` (`execution-graph.ts#L397`):
 When **all** of:
 
 - `process.key === AGENT_PROCESS_KEY` (`'org.dxos.testing.process.agent'`),
-- `process.params.target` is truthy,
+- `process.params.annotations` carries a `Process.TargetAnnotation` value,
 - `process.state ∈ { RUNNING, HYBERNATING }`,
 
 emit: