@dxos/plugin-assistant 0.8.4-main.bc674ce → 0.8.4-main.c351d160a8

package/src/containers/TracePanel/TracePanel.tsx

@@ -0,0 +1,260 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Schema from 'effect/Schema';
+import React, { useMemo } from 'react';
+
+import { Filter, Obj, Query } from '@dxos/echo';
+import { InvocationOutcome, InvocationTraceEndEvent, InvocationTraceStartEvent } from '@dxos/functions-runtime';
+import { useTriggerRuntimeControls } from '@dxos/plugin-automation';
+import { useActiveSpace } from '@dxos/plugin-space';
+import { type Space } from '@dxos/react-client/echo';
+import { Input, Panel, Toolbar, useTranslation } from '@dxos/react-ui';
+import { Timeline, type Commit } from '@dxos/react-ui-components';
+import { Message } from '@dxos/types';
+
+import { AtomObj, AtomQuery, AtomRef } from '@dxos/echo-atom';
+import { LogLevel } from '@dxos/log';
+import { Atom } from '@effect-atom/atom';
+import { useAtomValue } from '@effect-atom/atom-react';
+import * as Array from 'effect/Array';
+import { pipe } from 'effect/Function';
+import { meta } from '../../meta';
+
+export const TracePanel = () => {
+  const space = useActiveSpace();
+  if (!space) {
+    return null;
+  }
+
+  return <TracePanelMain space={space} />;
+};
+
+const TracePanelMain = ({ space }: { space: Space }) => {
+  const { t } = useTranslation(meta.id);
+  const { state, start, stop } = useTriggerRuntimeControls(space.db);
+  const isRunning = state?.enabled ?? false;
+
+  const { branches, commits } = useAtomValue(useMemo(() => getExecutionGraph(space), [space]));
+
+  return (
+    <Panel.Root>
+      <Panel.Toolbar asChild>
+        <Toolbar.Root>
+          <Input.Root>
+            <Input.Switch checked={isRunning} onCheckedChange={isRunning ? stop : start} />
+          </Input.Root>
+          <span className='text-sm'>{t('trigger runtime label')}</span>
+        </Toolbar.Root>
+      </Panel.Toolbar>
+      <Panel.Content>
+        <Timeline branches={branches} commits={commits} compact />
+      </Panel.Content>
+    </Panel.Root>
+  );
+};
+
+type InvocationInfo = {
+  startEvent: InvocationTraceStartEvent;
+  endEvent: InvocationTraceEndEvent | null;
+  subevents: Obj.Unknown[];
+};
+
+const getExecutionGraph = (
+  space: Space,
+  {
+    invocationsLimit = 100,
+    subeventsLimit = 20,
+    showSubeventsForLastNInvocations = 4,
+  }: { invocationsLimit?: number; subeventsLimit?: number; showSubeventsForLastNInvocations?: number } = {},
+): Atom.Atom<{
+  branches: string[];
+  commits: Commit[];
+}> => {
+  return pipe(
+    space.properties,
+    (_) => AtomObj.make(_),
+    // space properies => Atom<Atom<InvocationTraceEvent[]>>
+    (_) =>
+      Atom.make((get) => {
+        const queueDxn = get(_).invocationTraceQueue?.dxn;
+        return AtomQuery.make(
+          space.db,
+          !queueDxn
+            ? (Query.select(Filter.nothing()) as Query.Query<never>) // TODO(dmaretskyi): Broken echo types here.
+            : Query.select(
+                Filter.or(Filter.type(InvocationTraceStartEvent), Filter.type(InvocationTraceEndEvent)),
+              ).from({
+                queues: [queueDxn.toString()],
+              }),
+        );
+      }),
+    // Flatten atoms
+    (_) => Atom.make((get) => get(get(_))),
+    // Atom<InvocationTraceEvent[]> => Atom<InvocationInfo[]>
+    (_) =>
+      Atom.make((get) => {
+        const events = get(_);
+        const invocations: InvocationInfo[] = [];
+
+        for (const event of events) {
+          if (Schema.is(InvocationTraceStartEvent)(event)) {
+            const invocationInfo: InvocationInfo = {
+              startEvent: event,
+              endEvent: null,
+              subevents: [],
+            };
+            invocations.push(invocationInfo);
+          } else if (Schema.is(InvocationTraceEndEvent)(event)) {
+            const invocationInfo = invocations.find((i) => i.startEvent.invocationId === event.invocationId);
+            if (invocationInfo) {
+              invocationInfo.endEvent = event;
+            }
+          }
+        }
+
+        let expandedBudget = showSubeventsForLastNInvocations;
+        for (let i = invocations.length - 1; i >= 0; i--) {
+          const invocation = invocations[i];
+          if (!invocation.startEvent.invocationTraceQueue) {
+            continue;
+          }
+          const subevents = get(
+            AtomQuery.make(
+              space.db,
+              Query.select(Filter.everything())
+                .limit(subeventsLimit)
+                .from({ queues: [invocation.startEvent.invocationTraceQueue?.dxn?.toString()] }),
+            ),
+          );
+          invocation.subevents = subevents;
+          if (subevents.length > 0) {
+            expandedBudget--;
+          }
+          if (expandedBudget <= 0) {
+            break;
+          }
+        }
+
+        return invocations;
+      }),
+
+    // Build commit graph from InvocationInfo[]
+    (_) =>
+      Atom.make((get) => {
+        const invocations = get(_);
+        // Two alternating branches for subevents to save horizontal space.
+        const branches: string[] = ['invocations'];
+        const commits: Commit[] = [];
+
+        const sorted = invocations.sort((a, b) => a.startEvent.timestamp - b.startEvent.timestamp);
+        let idx = 0;
+        for (const invocation of sorted.slice(-invocationsLimit)) {
+          const trigger = invocation.startEvent.trigger && AtomRef.make(invocation.startEvent.trigger).pipe(get);
+          const fn =
+            (invocation.startEvent.invocationTarget &&
+              AtomRef.make(invocation.startEvent.invocationTarget).pipe(get)) ??
+            (trigger?.function && AtomRef.make(trigger.function).pipe(get));
+
+          const functionName = fn ? Obj.getLabel(fn) : undefined;
+          const triggerName = trigger?.spec?.kind ?? 'trigger';
+          const label = functionName ? `${functionName} on ${triggerName}` : triggerName;
+
+          const branchName = `invocation-${invocation.startEvent.invocationId.slice(0, 8)}`;
+
+          if (invocation.endEvent && invocation.subevents.length === 0) {
+            commits.push({
+              id: invocation.endEvent.id,
+              branch: 'invocations',
+              parents: commits.length > 0 ? [commits.at(-1)!.id] : [],
+              icon:
+                invocation.endEvent.outcome === InvocationOutcome.SUCCESS
+                  ? 'ph--check-circle--regular'
+                  : 'ph--x-circle--regular',
+              level: invocation.endEvent.outcome === InvocationOutcome.SUCCESS ? LogLevel.INFO : LogLevel.ERROR,
+              message: `${label} - ${invocation.endEvent.outcome}`,
+              timestamp: new Date(invocation.endEvent.timestamp),
+            });
+            continue;
+          }
+
+          commits.push({
+            id: invocation.startEvent.id,
+            branch: 'invocations',
+            parents: commits.length > 0 ? [commits.at(-1)!.id] : [],
+            icon: invocation.endEvent ? 'ph--play--regular' : 'ph--spinner-gap--regular',
+            level: invocation.endEvent ? LogLevel.INFO : LogLevel.VERBOSE,
+            message: label,
+            timestamp: new Date(invocation.startEvent.timestamp),
+          });
+
+          for (const subevent of invocation.subevents.slice(-subeventsLimit)) {
+            if (Obj.instanceOf(Message.Message, subevent)) {
+              for (const block of subevent.blocks) {
+                switch (block._tag) {
+                  case 'text':
+                    commits.push({
+                      id: subevent.id,
+                      branch: branchName,
+                      parents: [commits.at(-1)!.id],
+                      icon: 'ph--robot--regular',
+                      level: LogLevel.VERBOSE,
+                      message: block.text.slice(0, 50),
+                      timestamp: new Date(subevent.created),
+                    });
+                    if (!branches.includes(branchName)) {
+                      branches.push(branchName);
+                    }
+                    break;
+                  case 'toolCall':
+                    commits.push({
+                      id: subevent.id,
+                      branch: branchName,
+                      parents: [commits.at(-1)!.id],
+                      icon: 'ph--wrench--regular',
+                      level: LogLevel.VERBOSE,
+                      message: block.name,
+                      timestamp: new Date(subevent.created),
+                    });
+                    if (!branches.includes(branchName)) {
+                      branches.push(branchName);
+                    }
+                    break;
+                }
+              }
+            }
+          }
+
+          if (!invocation.endEvent && invocation.subevents.length > 0) {
+            commits.push({
+              id: invocation.startEvent.invocationId + 'pending',
+              branch: branchName,
+              parents: [commits.at(-1)!.id],
+              icon: 'ph--dots-three-vertical--regular',
+              level: LogLevel.VERBOSE,
+              message: 'Running...',
+              timestamp: new Date(),
+            });
+          }
+
+          if (invocation.endEvent && invocation.subevents.length > 0) {
+            commits.push({
+              id: invocation.endEvent.id,
+              branch: 'invocations',
+              parents: Array.dedupe([invocation.startEvent.invocationId, commits.at(-1)!.id]),
+              icon:
+                invocation.endEvent.outcome === InvocationOutcome.SUCCESS
+                  ? 'ph--check-circle--regular'
+                  : 'ph--x-circle--regular',
+              level: invocation.endEvent.outcome === InvocationOutcome.SUCCESS ? LogLevel.INFO : LogLevel.ERROR,
+              message: `${label} - ${invocation.endEvent.outcome === InvocationOutcome.SUCCESS ? 'Success' : 'Failure'}`,
+              timestamp: new Date(invocation.endEvent.timestamp),
+            });
+          }
+        }
+
+        return { branches, commits };
+      }),
+  );
+};

package/src/containers/TracePanel/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { TracePanel } from './TracePanel';
+
+export default TracePanel;

package/src/containers/TriggerStatus/TriggerStatus.tsx

@@ -0,0 +1,140 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import React, { useMemo } from 'react';
+
+import { type InvocationsState } from '@dxos/functions-runtime';
+import { useTriggerRuntimeControls } from '@dxos/plugin-automation';
+import { useActiveSpace } from '@dxos/plugin-space';
+import { StatusBar } from '@dxos/plugin-status-bar';
+import { type Database } from '@dxos/react-client/echo';
+import { Icon, Input, Popover, useTranslation } from '@dxos/react-ui';
+import { Settings } from '@dxos/react-ui-form';
+import { mx } from '@dxos/ui-theme';
+
+import { meta } from '../../meta';
+
+type TriggerStatusState = 'disabled' | 'idle' | 'running' | 'error';
+
+const getIcon = (state: TriggerStatusState): string => {
+  switch (state) {
+    case 'disabled':
+      return 'ph--lightning-slash--regular';
+    case 'idle':
+      return 'ph--lightning--regular';
+    case 'running':
+      return 'ph--lightning--fill';
+    case 'error':
+      return 'ph--warning--regular';
+  }
+};
+
+const getIconClassNames = (state: TriggerStatusState): string | undefined => {
+  switch (state) {
+    case 'running':
+      return 'animate-pulse text-accent-text';
+    case 'error':
+      return 'text-error-text';
+    default:
+      return undefined;
+  }
+};
+
+export const TriggerStatus = () => {
+  const space = useActiveSpace();
+  const db = space?.db;
+  if (!db) {
+    return null;
+  }
+
+  return <SpaceStatusMain db={db} />;
+};
+
+const SpaceStatusMain = ({ db }: { db: Database.Database }) => {
+  const { state, start, stop } = useTriggerRuntimeControls(db);
+  const isRunning = state?.enabled ?? false;
+
+  // Determine the current trigger status state.
+  const triggerState: TriggerStatusState = useMemo(() => {
+    if (!isRunning) {
+      return 'disabled';
+    }
+
+    // Check if there's any pending invocation.
+    const hasPending = state?.invocations.some((invocation) => invocation.result === null);
+    if (hasPending) {
+      return 'running';
+    }
+
+    // Check if the last invocation failed.
+    const lastInvocation = state?.invocations.at(-1);
+    if (lastInvocation?.result?._tag === 'Failure') {
+      return 'error';
+    }
+
+    return 'idle';
+  }, [isRunning, state?.invocations]);
+
+  const { t } = useTranslation(meta.id);
+  const title = t(`trigger status ${triggerState} label`);
+  const icon = <Icon icon={getIcon(triggerState)} classNames={getIconClassNames(triggerState)} />;
+
+  return (
+    <Popover.Root>
+      <Popover.Trigger asChild>
+        <StatusBar.Item title={title}>{icon}</StatusBar.Item>
+      </Popover.Trigger>
+      <Popover.Portal>
+        <Popover.Content>
+          <TriggerStatusPopover
+            isRunning={isRunning}
+            state={triggerState}
+            currentFunctionName={state?.invocations.at(-1)?.function?.name ?? state?.invocations.at(-1)?.function?.key}
+            lastInvocation={state?.invocations.at(-1)}
+            onToggle={isRunning ? stop : start}
+          />
+          <Popover.Arrow />
+        </Popover.Content>
+      </Popover.Portal>
+    </Popover.Root>
+  );
+};
+
+interface TriggerStatusPopoverProps {
+  isRunning: boolean;
+  state: TriggerStatusState;
+  currentFunctionName?: string;
+  lastInvocation?: InvocationsState;
+  onToggle: () => void;
+}
+
+const TriggerStatusPopover = ({
+  isRunning,
+  state,
+  currentFunctionName,
+  lastInvocation,
+  onToggle,
+}: TriggerStatusPopoverProps) => {
+  const { t } = useTranslation(meta.id);
+
+  return (
+    <div className='min-w-[240px] p-2 space-y-3'>
+      {/* Runtime Toggle */}
+      <Settings.ItemInput title={t('trigger runtime label')} description={t('trigger runtime description')}>
+        <Input.Switch classNames='justify-self-end' checked={isRunning} onCheckedChange={onToggle} />
+      </Settings.ItemInput>
+
+      {/* Status Indicator */}
+      <div className='flex items-center gap-2 pt-2 border-t border-separator'>
+        <Icon icon={getIcon(state)} classNames={mx(getIconClassNames(state), 'shrink-0')} />
+        <span className='text-sm'>{t(`trigger status ${state} label`)}</span>
+        {currentFunctionName && state === 'running' && (
+          <span className='text-xs text-description'>{currentFunctionName}</span>
+        )}
+      </div>
+    </div>
+  );
+};
+
+export default TriggerStatus;

package/src/containers/TriggerStatus/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { TriggerStatus } from './TriggerStatus';
+
+export default TriggerStatus;

package/src/containers/index.ts

@@ -0,0 +1,16 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { type ComponentType, lazy } from 'react';
+
+export * from './Project';
+
+export const AssistantSettings: ComponentType<any> = lazy(() => import('./AssistantSettings'));
+export const BlueprintArticle: ComponentType<any> = lazy(() => import('./BlueprintArticle'));
+export const ChatCompanion: ComponentType<any> = lazy(() => import('./ChatCompanion'));
+export const ChatContainer: ComponentType<any> = lazy(() => import('./ChatContainer'));
+export const ChatDialog: ComponentType<any> = lazy(() => import('./ChatDialog'));
+export const PromptArticle: ComponentType<any> = lazy(() => import('./PromptArticle'));
+export const TracePanel: ComponentType<any> = lazy(() => import('./TracePanel'));
+export const TriggerStatus: ComponentType<any> = lazy(() => import('./TriggerStatus'));

package/src/extensions/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+export { promptRunExtension, type PromptExtensionOptions } from './prompt-extension';

package/src/extensions/prompt-extension.ts

@@ -0,0 +1,142 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { syntaxTree } from '@codemirror/language';
+import { type Extension } from '@codemirror/state';
+import { Decoration, type DecorationSet, EditorView, ViewPlugin, type ViewUpdate, WidgetType } from '@codemirror/view';
+
+export type PromptExtensionOptions = {
+  /** Called when the user clicks the run button on a prompt code block. */
+  onRun: (promptText: string) => void;
+};
+
+/**
+ * CodeMirror extension that adds a green "run" button to ```prompt fenced code blocks.
+ */
+export const promptRunExtension = ({ onRun }: PromptExtensionOptions): Extension => {
+  return [
+    ViewPlugin.fromClass(
+      class {
+        decorations: DecorationSet;
+
+        constructor(view: EditorView) {
+          this.decorations = this.buildDecorations(view);
+        }
+
+        update(update: ViewUpdate) {
+          if (update.docChanged || update.viewportChanged || update.selectionSet || update.focusChanged) {
+            this.decorations = this.buildDecorations(update.view);
+          }
+        }
+
+        buildDecorations(view: EditorView): DecorationSet {
+          const decorations: Array<{ from: number; to: number; decoration: Decoration }> = [];
+
+          syntaxTree(view.state).iterate({
+            enter: (node) => {
+              if (node.name === 'FencedCode') {
+                const info = node.node.getChild('CodeInfo');
+                if (info) {
+                  const type = view.state.sliceDoc(info.from, info.to);
+                  const text = node.node.getChild('CodeText');
+                  if (type === 'prompt' && text) {
+                    const content = view.state.sliceDoc(text.from, text.to).trim();
+                    if (content.length > 0) {
+                      const widget = new PromptRunWidget(content, onRun);
+                      decorations.push({
+                        from: node.from,
+                        to: node.from,
+                        decoration: Decoration.widget({ widget, side: -1 }),
+                      });
+                    }
+                  }
+                }
+              }
+            },
+          });
+
+          return Decoration.set(
+            decorations.sort((a, b) => a.from - b.from || a.to - b.to).map((d) => d.decoration.range(d.from, d.to)),
+          );
+        }
+      },
+      {
+        decorations: (v) => v.decorations,
+      },
+    ),
+    EditorView.theme({
+      '& .cm-prompt-run-container': {
+        position: 'relative',
+        display: 'block',
+        height: '0',
+      },
+      '& .cm-prompt-run': {
+        position: 'absolute',
+        right: '8px',
+        top: '8px',
+        zIndex: '10',
+        display: 'inline-flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        width: '24px',
+        height: '24px',
+        border: 'none',
+        borderRadius: '4px',
+        background: 'var(--color-success, #22c55e)',
+        cursor: 'pointer',
+        opacity: '0.85',
+        transition: 'opacity 0.15s ease',
+        '&:hover': {
+          opacity: '1',
+        },
+      },
+      '& .cm-prompt-run-icon': {
+        width: '0',
+        height: '0',
+        borderTop: '5px solid transparent',
+        borderBottom: '5px solid transparent',
+        borderLeft: '8px solid white',
+        marginLeft: '2px',
+      },
+    }),
+  ];
+};
+
+class PromptRunWidget extends WidgetType {
+  constructor(
+    private readonly _promptText: string,
+    private readonly _onRun: (promptText: string) => void,
+  ) {
+    super();
+  }
+
+  override eq(other: this) {
+    return this._promptText === other._promptText;
+  }
+
+  override ignoreEvent() {
+    return false;
+  }
+
+  override toDOM() {
+    const container = document.createElement('div');
+    container.className = 'cm-prompt-run-container';
+
+    const button = document.createElement('button');
+    button.className = 'cm-prompt-run';
+    button.title = 'Run prompt in new chat';
+    button.addEventListener('mousedown', (event) => {
+      event.preventDefault();
+      event.stopPropagation();
+      this._onRun(this._promptText);
+    });
+
+    const icon = document.createElement('span');
+    icon.className = 'cm-prompt-run-icon';
+    button.appendChild(icon);
+    container.appendChild(button);
+
+    return container;
+  }
+}

package/src/hooks/useBlueprintRegistry.ts

@@ -4,8 +4,8 @@
 
 import { useCallback, useEffect, useMemo, useState } from 'react';
 
-import { Common } from '@dxos/app-framework';
-import { useCapabilities } from '@dxos/app-framework/react';
+import { useCapabilities } from '@dxos/app-framework/ui';
+import { AppCapabilities } from '@dxos/app-toolkit';
 import { type AiContextBinder } from '@dxos/assistant';
 import { Blueprint } from '@dxos/blueprints';
 import { type Database, Filter, Obj, Ref } from '@dxos/echo';
@@ -16,9 +16,13 @@ import { distinctBy } from '@dxos/util';
  * Provide a registry of blueprints from plugins.
  */
 // TODO(burdon): Reconcile with eventual public registry.
+// TODO(dmaretskyi): Reconcile with blueprint registry in compute runtime.
 export const useBlueprintRegistry = () => {
-  const blueprints = useCapabilities(Common.Capability.BlueprintDefinition);
-  return useMemo(() => new Blueprint.Registry(blueprints), [blueprints]);
+  const blueprintDefinitions = useCapabilities(AppCapabilities.BlueprintDefinition);
+  return useMemo(
+    () => new Blueprint.Registry(blueprintDefinitions.map((blueprint) => blueprint.make())),
+    [blueprintDefinitions],
+  );
 };
 
 export const useBlueprints = ({

package/src/hooks/useChatProcessor.ts

@@ -7,6 +7,7 @@ import type * as Runtime from 'effect/Runtime';
 import { useContext, useMemo, useState } from 'react';
 
 import { AiConversation } from '@dxos/assistant';
+import { type Chat } from '@dxos/assistant-toolkit';
 import { type Blueprint } from '@dxos/blueprints';
 import { log } from '@dxos/log';
 import { type Queue, type Space } from '@dxos/react-client/echo';
@@ -17,7 +18,7 @@ import { type Assistant } from '../types';
 
 export type UseChatProcessorProps = {
   space?: Space;
-  chat?: Assistant.Chat;
+  chat?: Chat.Chat;
   preset?: AiServicePreset;
   services?: () => Promise<Runtime.Runtime<AiChatServices>>;
   blueprintRegistry?: Blueprint.Registry;

package/src/hooks/useChatServices.ts

@@ -6,7 +6,8 @@ import * as Effect from 'effect/Effect';
 import type * as Runtime from 'effect/Runtime';
 import { useMemo } from 'react';
 
-import { useCapability } from '@dxos/app-framework/react';
+import { useCapability } from '@dxos/app-framework/ui';
+import { type Chat } from '@dxos/assistant-toolkit';
 import { type Key } from '@dxos/echo';
 import { TracingService } from '@dxos/functions';
 import { TracingServiceExt } from '@dxos/functions-runtime';
@@ -14,11 +15,10 @@ import { AutomationCapabilities } from '@dxos/plugin-automation';
 import { useClient } from '@dxos/react-client';
 
 import { type AiChatServices } from '../processor';
-import { type Assistant } from '../types';
 
 export type UseChatServicesProps = {
   id?: Key.SpaceId;
-  chat?: Assistant.Chat;
+  chat?: Chat.Chat;
 };
 
 /**