@dxos/plugin-assistant 0.9.1-main.c7dcc2e112 → 0.10.0

package/src/components/TemplateEditor/index.ts

@@ -1,5 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-export * from './TemplateEditor';

package/src/components/TemplateEditor/types.tsx

@@ -1,28 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-// TODO(burdon): Factor out (shared with backend). core/chain (@dxos/chain).
-// TODO(burdon): Agent/plan-and-execute (with tools). Create design doc/ontology of sequence/agent.
-
-export type Step = {
-  id: string;
-};
-
-export type Variable = {
-  name: string;
-  type: 'value' | 'function' | 'query' | 'retriever' | 'pass-through';
-};
-
-export type Prompt = Step & {
-  title?: string;
-  description?: string;
-  template: string;
-  variables: Variable[];
-};
-
-export type Sequence = Step & {
-  runnable: Step[];
-};
-
-export type Chain = {};

package/src/containers/BlueprintArticle/BlueprintArticle.tsx

@@ -1,29 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import React from 'react';
-
-import { type AppSurface } from '@dxos/app-toolkit/ui';
-import { type Blueprint } from '@dxos/compute';
-import { Panel, Toolbar } from '@dxos/react-ui';
-import { useAttention } from '@dxos/react-ui-attention';
-
-import { TemplateEditor } from '#components';
-
-export type BlueprintArticleProps = AppSurface.ObjectArticleProps<Blueprint.Blueprint>;
-
-export const BlueprintArticle = ({ role, attendableId, subject }: BlueprintArticleProps) => {
-  const { hasAttention } = useAttention(attendableId);
-
-  return (
-    <Panel.Root role={role} classNames='dx-document'>
-      <Panel.Toolbar asChild>
-        <Toolbar.Root disabled={!hasAttention} />
-      </Panel.Toolbar>
-      <Panel.Content asChild>
-        <TemplateEditor id={subject.id} source={subject.instructions.source} />
-      </Panel.Content>
-    </Panel.Root>
-  );
-};

package/src/containers/BlueprintArticle/index.ts

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

package/src/containers/RoutineArticle/RoutineArticle.stories.tsx

@@ -1,75 +0,0 @@
-//
-// Copyright 2026 DXOS.org
-//
-
-import { type Meta, type StoryObj } from '@storybook/react-vite';
-import * as Effect from 'effect/Effect';
-import React from 'react';
-
-import { withPluginManager } from '@dxos/app-framework/testing';
-import { Routine } from '@dxos/compute';
-import { Filter } from '@dxos/echo';
-import { AutomationPlugin } from '@dxos/plugin-automation/testing';
-import { ClientPlugin } from '@dxos/plugin-client/testing';
-import { initializeIdentity } from '@dxos/plugin-client/testing';
-import { corePlugins } from '@dxos/plugin-testing';
-import { useQuery, useSpaces } from '@dxos/react-client/echo';
-import { Loading, withLayout, withTheme } from '@dxos/react-ui/testing';
-
-import { translations } from '#translations';
-
-import { AssistantPlugin } from '../../AssistantPlugin';
-import { RoutineArticle } from './RoutineArticle';
-
-const DefaultStory = () => {
-  const [space] = useSpaces();
-  const [routine] = useQuery(space?.db, Filter.type(Routine.Routine));
-  if (!routine) {
-    return <Loading />;
-  }
-
-  return <RoutineArticle role='article' subject={routine} attendableId='story' />;
-};
-
-const meta = {
-  title: 'plugins/plugin-assistant/containers/RoutineArticle',
-  render: DefaultStory,
-  decorators: [
-    withTheme(),
-    withLayout({ layout: 'column' }),
-    withPluginManager({
-      plugins: [
-        ...corePlugins(),
-        ClientPlugin({
-          types: [Routine.Routine],
-          onClientInitialized: ({ client }) =>
-            Effect.gen(function* () {
-              yield* initializeIdentity(client);
-              const [space] = client.spaces.get();
-              yield* Effect.promise(() => space.waitUntilReady());
-
-              space.db.add(
-                Routine.make({
-                  name: 'Summarize',
-                  description: 'Summarize the selected object.',
-                  instructions: 'Create a new markdown document that is a summary of the selected object.',
-                }),
-              );
-            }),
-        }),
-        AutomationPlugin(),
-        AssistantPlugin(),
-      ],
-    }),
-  ],
-  parameters: {
-    layout: 'fullscreen',
-    translations,
-  },
-} satisfies Meta<typeof DefaultStory>;
-
-export default meta;
-
-type Story = StoryObj<typeof meta>;
-
-export const Default: Story = {};

package/src/containers/RoutineArticle/RoutineArticle.tsx

@@ -1,109 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
-
-import { useSpaceCallback } from '@dxos/app-framework/ui';
-import { type AppSurface } from '@dxos/app-toolkit/ui';
-import { AgentPrompt } from '@dxos/assistant-toolkit';
-import { Operation, type Routine } from '@dxos/compute';
-import { Database, Feed, Obj } from '@dxos/echo';
-import { invariant } from '@dxos/invariant';
-import { Panel, Toolbar, useTranslation } from '@dxos/react-ui';
-import { useAttention } from '@dxos/react-ui-attention';
-import { JsonHighlighter } from '@dxos/react-ui-syntax-highlighter';
-
-import { TemplateEditor } from '#components';
-import { meta } from '#meta';
-
-export type RoutineArticleProps = AppSurface.ObjectArticleProps<Routine.Routine>;
-
-type RunState =
-  | { status: 'idle' }
-  | { status: 'running' }
-  | { status: 'success'; result: unknown }
-  | { status: 'error'; error: Error };
-
-// TODO(burdon): Trigger editor.
-export const RoutineArticle = ({ role, attendableId, subject }: RoutineArticleProps) => {
-  const { t } = useTranslation(meta.profile.key);
-  const { hasAttention } = useAttention(attendableId);
-  const invoke = usePromptHandler(subject);
-  const [state, setState] = useState<RunState>({ status: 'idle' });
-  const mountedRef = useRef(true);
-  useEffect(() => {
-    return () => {
-      mountedRef.current = false;
-    };
-  }, []);
-
-  const handleRun = useCallback(async () => {
-    setState({ status: 'running' });
-    try {
-      const result = await invoke();
-      if (mountedRef.current) {
-        setState({ status: 'success', result });
-      }
-    } catch (err) {
-      if (mountedRef.current) {
-        setState({ status: 'error', error: err instanceof Error ? err : new Error(String(err)) });
-      }
-    }
-  }, [invoke]);
-
-  return (
-    <Panel.Root role={role} className='dx-document'>
-      <Panel.Toolbar asChild>
-        <Toolbar.Root disabled={!hasAttention || state.status === 'running'}>
-          <Toolbar.IconButton
-            iconOnly
-            icon={state.status === 'running' ? 'ph--spinner-gap--regular' : 'ph--play--regular'}
-            label={t('run-prompt.label')}
-            onClick={handleRun}
-          />
-        </Toolbar.Root>
-      </Panel.Toolbar>
-      <Panel.Content classNames='flex flex-col gap-2'>
-        <TemplateEditor id={subject.id} source={subject.instructions} />
-        <RoutineResult state={state} />
-      </Panel.Content>
-    </Panel.Root>
-  );
-};
-
-const RoutineResult = ({ state }: { state: RunState }) => {
-  const { t } = useTranslation(meta.profile.key);
-  switch (state.status) {
-    case 'idle':
-      return null;
-    case 'running':
-      return <div className='p-2 text-sm text-subdued'>{t('routine-running.label')}</div>;
-    case 'error':
-      return <div className='p-2 text-sm text-error'>{state.error.message}</div>;
-    case 'success':
-      return <JsonHighlighter classNames='p-2! text-sm' data={state.result} />;
-  }
-};
-
-const usePromptHandler = (routine: Routine.Routine) => {
-  const db = Obj.getDatabase(routine);
-  const data = useMemo<Operation.Definition.Input<typeof AgentPrompt> | undefined>(() => {
-    if (db && routine) {
-      return {
-        prompt: db.makeRef(Obj.getURI(routine)),
-        input: {},
-      };
-    }
-  }, [routine, db]);
-
-  return useSpaceCallback(
-    db?.spaceId,
-    [Database.Service, Feed.FeedService] as const,
-    () => {
-      invariant(data);
-      return Operation.invoke(AgentPrompt, data);
-    },
-    [data],
-  );
-};

package/src/containers/RoutineArticle/index.ts

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

package/src/containers/RoutineList/RoutineList.stories.tsx

@@ -1,130 +0,0 @@
-//
-// Copyright 2026 DXOS.org
-//
-
-import { type Meta, type StoryObj } from '@storybook/react-vite';
-import * as Effect from 'effect/Effect';
-import React from 'react';
-
-import { SERVICES_CONFIG } from '@dxos/ai/testing';
-import { withPluginManager } from '@dxos/app-framework/testing';
-import { Routine } from '@dxos/compute';
-import { Filter } from '@dxos/echo';
-import { AutomationPlugin } from '@dxos/plugin-automation/testing';
-import { ClientPlugin } from '@dxos/plugin-client/testing';
-import { Markdown } from '@dxos/plugin-markdown';
-import { corePlugins } from '@dxos/plugin-testing';
-import { Config } from '@dxos/react-client';
-import { useQuery, useSpaces } from '@dxos/react-client/echo';
-import { Panel } from '@dxos/react-ui';
-import { Loading, withLayout } from '@dxos/react-ui/testing';
-import { Organization } from '@dxos/types';
-
-import { translations } from '#translations';
-
-import { AssistantPlugin } from '../../AssistantPlugin';
-import { TracePanel } from '../TracePanel';
-import { RoutineList } from './RoutineList';
-
-// TODO(burdon): Factor out (see assistant-stories)
-export const config = {
-  remote: new Config({
-    runtime: {
-      services: SERVICES_CONFIG.REMOTE,
-    },
-  }),
-  persistent: new Config({
-    runtime: {
-      client: {
-        storage: {
-          persistent: true,
-        },
-      },
-      services: SERVICES_CONFIG.REMOTE,
-    },
-  }),
-  local: new Config({
-    runtime: {
-      services: SERVICES_CONFIG.LOCAL,
-    },
-  }),
-};
-
-const DefaultStory = () => {
-  const spaces = useSpaces();
-  const space = spaces[spaces.length - 1];
-  const [subject] = useQuery(space?.db, Filter.type(Organization.Organization));
-  if (!subject) {
-    return <Loading data={{ space: !!space, subject: !!subject }} />;
-  }
-
-  return (
-    <Panel.Root>
-      <Panel.Toolbar className='flex p-1 items-center'>
-        <RoutineList subject={subject} role='toolbar-input' attendableId='story' />
-      </Panel.Toolbar>
-      <Panel.Content>
-        <TracePanel role='article' space={space} attendableId={space.id} />
-      </Panel.Content>
-    </Panel.Root>
-  );
-};
-
-const meta = {
-  title: 'plugins/plugin-assistant/containers/RoutineList',
-  render: DefaultStory,
-  decorators: [
-    withLayout({ layout: 'column' }),
-    withPluginManager({
-      plugins: [
-        ...corePlugins(),
-        ClientPlugin({
-          types: [Routine.Routine, Organization.Organization, Markdown.Document],
-          config: config.remote,
-          onClientInitialized: ({ client }) =>
-            Effect.gen(function* () {
-              yield* Effect.promise(() => client.halo.createIdentity());
-              const space = yield* Effect.promise(() => client.spaces.create());
-              yield* Effect.promise(() => space.waitUntilReady());
-              space.db.add(
-                Organization.make({
-                  name: 'DXOS',
-                }),
-              );
-              space.db.add(
-                Routine.make({
-                  name: 'Summarize',
-                  instructions: 'Create a new markdown document that is a summary of the selected object.',
-                }),
-              );
-              space.db.add(
-                Routine.make({
-                  name: 'Analyze',
-                  instructions: 'Analyze the selected content.',
-                }),
-              );
-              space.db.add(
-                Routine.make({
-                  name: 'Translate',
-                  instructions: 'Translate the selected content to Spanish.',
-                }),
-              );
-            }),
-        }),
-
-        AssistantPlugin(),
-        AutomationPlugin(),
-      ],
-    }),
-  ],
-  parameters: {
-    layout: 'centered',
-    translations,
-  },
-} satisfies Meta<typeof DefaultStory>;
-
-export default meta;
-
-type Story = StoryObj<typeof meta>;
-
-export const Default: Story = {};

package/src/containers/RoutineList/RoutineList.tsx

@@ -1,50 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import React from 'react';
-
-import { useOperationInvoker } from '@dxos/app-framework/ui';
-import { type AppSurface } from '@dxos/app-toolkit/ui';
-import { DatabaseBlueprint, WebSearchBlueprint } from '@dxos/assistant-toolkit';
-import { Routine } from '@dxos/compute';
-import { Filter, Obj, Ref } from '@dxos/echo';
-import { MarkdownBlueprint } from '@dxos/plugin-markdown';
-import { useQuery } from '@dxos/react-client/echo';
-import { IconButton } from '@dxos/react-ui';
-
-import { AssistantOperation } from '#types';
-
-export type RoutineListProps = AppSurface.ObjectSectionProps<Obj.Unknown>;
-
-export const RoutineList = ({ subject }: RoutineListProps) => {
-  const { invokePromise } = useOperationInvoker();
-  const db = Obj.getDatabase(subject);
-  const prompts = useQuery(db, Filter.type(Routine.Routine));
-  if (!db) {
-    return null;
-  }
-
-  return (
-    <div className='flex gap-2'>
-      {prompts.map((prompt, i) => (
-        <div key={i}>
-          <IconButton
-            icon='ph--magic-wand--regular'
-            label={Obj.getLabel(prompt) ?? Obj.getURI(prompt)}
-            onClick={() => {
-              void invokePromise(AssistantOperation.RunPromptInNewChat, {
-                db,
-                prompt: Ref.make(prompt),
-                objects: [subject],
-                // TODO(burdon): Concifgure from Prompt object.
-                blueprints: [DatabaseBlueprint.key, WebSearchBlueprint.key, MarkdownBlueprint.key],
-                background: true,
-              });
-            }}
-          />
-        </div>
-      ))}
-    </div>
-  );
-};

package/src/containers/RoutineList/index.ts

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

package/src/hooks/useBlueprintRegistry.ts

@@ -1,125 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { useCallback, useEffect, useMemo, useState } from 'react';
-
-import { type AiContext } from '@dxos/assistant';
-import { Blueprint } from '@dxos/compute';
-import { type Database, Filter, Obj, Ref, type Registry } from '@dxos/echo';
-import { useQuery } from '@dxos/react-client/echo';
-import { distinctBy } from '@dxos/util';
-
-export const useBlueprints = ({ registry, db }: { registry?: Registry.Registry; db?: Database.Database }) => {
-  const [registryBlueprints, setRegistryBlueprints] = useState<Blueprint.Blueprint[]>(
-    () => registry?.query(Filter.type(Blueprint.Blueprint)).runSync() ?? [],
-  );
-
-  useEffect(() => {
-    if (!registry) {
-      setRegistryBlueprints([]);
-      return;
-    }
-    setRegistryBlueprints(registry.query(Filter.type(Blueprint.Blueprint)).runSync());
-    return registry.changed.on(() => {
-      setRegistryBlueprints(registry.query(Filter.type(Blueprint.Blueprint)).runSync());
-    });
-  }, [registry]);
-
-  const spaceBlueprints = useQuery(db, Filter.type(Blueprint.Blueprint));
-  return useMemo(() => {
-    const blueprints = distinctBy([...registryBlueprints, ...spaceBlueprints], (b) => Obj.getMeta(b).key);
-    blueprints.sort(({ name: a }, { name: b }) => a.localeCompare(b));
-    return blueprints;
-  }, [registryBlueprints, spaceBlueprints]);
-};
-
-/**
- * Create reactive map of active blueprints (by key).
- */
-export const useActiveBlueprints = ({ context }: { context?: AiContext.Binder }) => {
-  const [active, setActive] = useState<Map<string, Blueprint.Blueprint>>(new Map());
-
-  useEffect(() => {
-    if (!context) {
-      setActive(new Map());
-      return;
-    }
-
-    const updateActive = () => {
-      const blueprints = context.getBlueprints();
-      setActive(
-        new Map(
-          blueprints
-            .map((blueprint) => [Obj.getMeta(blueprint).key, blueprint] as const)
-            .filter((entry): entry is readonly [string, Blueprint.Blueprint] => entry[0] !== undefined),
-        ),
-      );
-    };
-
-    // Set initial value.
-    updateActive();
-
-    // Subscribe to changes.
-    return context.subscribeBlueprints(updateActive);
-  }, [context]);
-
-  return active;
-};
-
-// TODO(burdon): Move logic into binder.
-export const useBlueprintHandlers = ({
-  db,
-  context,
-  registry,
-}: {
-  db: Database.Database;
-  context?: AiContext.Binder;
-  registry?: Registry.Registry;
-}) => {
-  const onUpdateBlueprint = useCallback(
-    async (key: string, checked: boolean) => {
-      if (!context) {
-        return;
-      }
-
-      if (checked) {
-        // Check if the blueprint is in the registry — if so, bind via its key URI directly
-        // (no DB clone needed). Fall back to an existing DB copy for user-forked blueprints.
-        const registryBlueprint = registry
-          ?.query(Filter.type(Blueprint.Blueprint))
-          .runSync()
-          .find((b) => Obj.getMeta(b).key === key);
-
-        if (registryBlueprint) {
-          await context.bind({ blueprints: [Ref.fromURI(Blueprint.registryURI(key))] });
-        } else {
-          // User-forked blueprint (in DB but not in registry): bind via DB ref.
-          const objects = await db.query(Filter.type(Blueprint.Blueprint)).run();
-          const storedBlueprint = objects.find((blueprint) => Obj.getMeta(blueprint).key === key);
-          if (storedBlueprint) {
-            await context.bind({ blueprints: [Ref.make(storedBlueprint)] });
-          }
-        }
-      } else {
-        // Unbind: try registry ref first, then DB ref.
-        const registryBlueprint = registry
-          ?.query(Filter.type(Blueprint.Blueprint))
-          .runSync()
-          .find((b) => Obj.getMeta(b).key === key);
-        if (registryBlueprint) {
-          await context.unbind({ blueprints: [Ref.fromURI(Blueprint.registryURI(key))] });
-        } else {
-          const objects = await db.query(Filter.type(Blueprint.Blueprint)).run();
-          const storedBlueprint = objects.find((blueprint) => Obj.getMeta(blueprint).key === key);
-          if (storedBlueprint) {
-            await context.unbind({ blueprints: [Ref.make(storedBlueprint)] });
-          }
-        }
-      }
-    },
-    [db, context, registry],
-  );
-
-  return { onUpdateBlueprint };
-};

package/src/hooks/useOnline.ts

@@ -1,10 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { type Dispatch, type SetStateAction, useState } from 'react';
-
-export const useOnline = (): [boolean, Dispatch<SetStateAction<boolean>>] => {
-  const [online, setOnline] = useState(true);
-  return [online, setOnline];
-};

package/src/templates/automation-templates.test.ts

@@ -1,66 +0,0 @@
-//
-// Copyright 2026 DXOS.org
-//
-
-import * as Effect from 'effect/Effect';
-import * as Layer from 'effect/Layer';
-import { describe, test } from 'vitest';
-
-import { Operation, Routine, Trace, Trigger } from '@dxos/compute';
-import { Database, Filter, Obj, Query } from '@dxos/echo';
-import { TestDatabaseLayer } from '@dxos/echo-client/testing';
-import { EffectEx } from '@dxos/effect';
-import { Automation } from '@dxos/plugin-automation';
-
-import { dailyDigest } from './daily-digest';
-import { researchBrief } from './research-brief';
-
-const dbLayer = TestDatabaseLayer({
-  types: [Automation.Automation, Routine.Routine, Trigger.Trigger, Operation.PersistentOperation],
-});
-
-const TestLayer = Layer.mergeAll(dbLayer, Trace.writerLayerNoop);
-
-const templates = [
-  { template: researchBrief, blueprintCount: 4 },
-  { template: dailyDigest, blueprintCount: 3 },
-];
-
-describe('scheduled automation templates', () => {
-  test('apply globally (no subject required)', ({ expect }) => {
-    // Like Blank, these are offered in the global create dialog — no `appliesTo` gate.
-    expect(researchBrief.appliesTo).toBeUndefined();
-    expect(dailyDigest.appliesTo).toBeUndefined();
-  });
-
-  for (const { template, blueprintCount } of templates) {
-    test(`${template.label} scaffolds a Routine, a disabled timer Trigger, and an Automation`, async ({ expect }) => {
-      await Effect.gen(function* () {
-        const automation = yield* template.scaffold({});
-        yield* Database.add(automation);
-        yield* Database.flush();
-
-        expect(automation.triggers).toHaveLength(1);
-        expect(automation.runnable).toBeDefined();
-
-        const routines = yield* Database.query(Filter.type(Routine.Routine)).run;
-        expect(routines).toHaveLength(1);
-        expect(routines[0]?.blueprints).toHaveLength(blueprintCount);
-
-        const triggers = yield* Database.query(Query.select(Filter.type(Trigger.Trigger))).run;
-        expect(triggers).toHaveLength(1);
-        const trigger = triggers[0];
-        expect(trigger?.enabled).toBe(false);
-        expect(trigger?.spec?.kind).toBe('timer');
-        expect(trigger?.input?.prompt).toBeDefined();
-        // The trigger is owned by the automation (cascade-deletes with it); the routine stays independent.
-        expect(trigger && Obj.getParent(trigger)?.id).toBe(automation.id);
-        expect(routines[0] && Obj.getParent(routines[0])).toBeUndefined();
-
-        const operations = yield* Database.query(Filter.type(Operation.PersistentOperation)).run;
-        expect(operations).toHaveLength(1);
-        expect(automation.runnable?.uri).toBe(trigger?.function?.uri);
-      }).pipe(Effect.provide(TestLayer), EffectEx.runAndForwardErrors);
-    });
-  }
-});