@dxos/plugin-assistant 0.8.4-main.406dc2a → 0.8.4-main.43cb759274

package/src/components/Toolbar/useChatToolbarActions.ts

@@ -1,126 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Rx } from '@effect-rx/rx-react';
-import * as Effect from 'effect/Effect';
-import { useMemo } from 'react';
-
-import { createIntent, useIntentDispatcher } from '@dxos/app-framework';
-import { Filter, Obj, Query } from '@dxos/echo';
-import { invariant } from '@dxos/invariant';
-import { SpaceAction } from '@dxos/plugin-space/types';
-import { getSpace, useQuery } from '@dxos/react-client/echo';
-import { MenuBuilder, useMenuActions } from '@dxos/react-ui-menu';
-
-import { meta } from '../../meta';
-import { Assistant, AssistantAction } from '../../types';
-
-export type ChatToolbarActionsProps = {
-  chat: Assistant.Chat;
-  companionTo?: Obj.Any;
-  onReset?: () => void;
-};
-
-export const useChatToolbarActions = ({ chat, companionTo, onReset }: ChatToolbarActionsProps) => {
-  const { dispatch } = useIntentDispatcher();
-  const space = getSpace(chat);
-  const query = companionTo
-    ? Query.select(Filter.ids(companionTo.id)).targetOf(Assistant.CompanionTo).source()
-    : Query.select(Filter.nothing());
-  // TODO(wittjosiah): Query in react vs query in rx?
-  const chats = useQuery(space, query);
-
-  return useMenuActions(
-    useMemo(
-      () =>
-        Rx.make(() => {
-          const builder = MenuBuilder.make()
-            .root({
-              label: ['chat toolbar title', { ns: meta.id }],
-            })
-            .action(
-              'new',
-              {
-                label: ['button new thread', { ns: meta.id }],
-                icon: 'ph--plus--regular',
-                type: 'new',
-              },
-              () =>
-                Effect.gen(function* () {
-                  invariant(space);
-                  const { object } = yield* dispatch(createIntent(AssistantAction.CreateChat, { space }));
-                  yield* dispatch(createIntent(SpaceAction.AddObject, { object, target: space, hidden: true }));
-                  if (companionTo) {
-                    yield* dispatch(
-                      createIntent(SpaceAction.AddRelation, {
-                        space,
-                        schema: Assistant.CompanionTo,
-                        source: object,
-                        target: companionTo,
-                      }),
-                    );
-
-                    yield* dispatch(createIntent(AssistantAction.SetCurrentChat, { companionTo, chat: object }));
-                  }
-                }).pipe(Effect.runPromise),
-            )
-            .action(
-              'branch',
-              {
-                label: ['button branch thread', { ns: meta.id }],
-                icon: 'ph--git-branch--regular',
-                type: 'branch',
-                disabled: true,
-              },
-              () => {},
-            );
-
-          if (chats.length > 0) {
-            builder.group(
-              'chats',
-              {
-                label: ['chat history label', { ns: meta.id }],
-                icon: 'ph--clock-counter-clockwise--regular',
-                selectCardinality: 'single',
-                variant: 'dropdownMenu',
-              },
-              (builder) => {
-                chats
-                  // TODO(wittjosiah): This should be the default sort order.
-                  .toSorted((a, b) => a.id.localeCompare(b.id))
-                  .forEach((chat) => {
-                    builder.action(
-                      chat.id,
-                      {
-                        label: Obj.getLabel(chat) ?? ['object name placeholder', { ns: Assistant.Chat.typename }],
-                      },
-                      () =>
-                        Effect.gen(function* () {
-                          invariant(companionTo);
-                          yield* dispatch(createIntent(AssistantAction.SetCurrentChat, { companionTo, chat }));
-                        }).pipe(Effect.runPromise),
-                    );
-                  });
-              },
-            );
-          }
-
-          if (onReset) {
-            builder.action(
-              'reset',
-              {
-                label: ['button reset', { ns: meta.id }],
-                icon: 'ph--trash--regular',
-                type: 'reset',
-              },
-              onReset,
-            );
-          }
-
-          return builder.build();
-        }),
-      [chats],
-    ),
-  );
-};

package/src/events.ts

@@ -1,11 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { defineEvent } from '@dxos/app-framework';
-
-import { meta } from './meta';
-
-export namespace AssistantEvents {
-  export const SetupAiServiceProviders = defineEvent(`${meta.id}/event/setup-ai-service-providers`);
-}

package/src/functions/analysis.ts

@@ -1,22 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Effect from 'effect/Effect';
-import * as Schema from 'effect/Schema';
-
-import { defineFunction } from '@dxos/functions';
-import { log } from '@dxos/log';
-
-export default defineFunction({
-  key: 'dxos.org/function/assistant-analysis',
-  name: 'Assistant analysis',
-  description: 'Enter analysis analysis mode.',
-  inputSchema: Schema.Struct({
-    enable: Schema.Boolean.annotations({ description: 'Enable or disable analysis mode.' }),
-  }),
-  outputSchema: Schema.Void,
-  handler: Effect.fn(function* ({ context, data: { enable } }) {
-    log.info('analysis mode', { space: context.space?.id, enable });
-  }),
-});

package/src/functions/index.ts

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-export { default as analysis } from './analysis';
-export { default as list } from './list';
-export { default as load } from './load';

package/src/functions/list.ts

@@ -1,48 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Effect from 'effect/Effect';
-import * as Schema from 'effect/Schema';
-
-import { Filter, Obj, Query } from '@dxos/echo';
-import { DatabaseService, defineFunction } from '@dxos/functions';
-import { trim } from '@dxos/util';
-
-// TODO(burdon): Factor out to space plugin.
-export default defineFunction({
-  key: 'dxos.org/function/assistant/list',
-  name: 'Assistant list',
-  description:
-    // TODO(wittjosiah): Find a better way to prompt for looking up typenames before querying with them.
-    trim`
-      Lists the objects of the given type.
-      Check the list-schemas tool for available types before calling this function.
-    `,
-  inputSchema: Schema.Struct({
-    typename: Schema.String.annotations({
-      description: 'The typename of the objects to list.',
-    }),
-  }),
-  outputSchema: Schema.Struct({
-    results: Schema.Array(
-      Schema.Struct({
-        dxn: Schema.String.annotations({ description: 'The DXN of the object.' }),
-        label: Schema.optional(Schema.String.annotations({ description: 'The label of the object.' })),
-      }),
-    ),
-  }),
-  handler: Effect.fn(function* ({ data: { typename } }) {
-    // TODO(wittjosiah): Typename query is not working for dynamic schemas.
-    const [schema] = yield* DatabaseService.runSchemaQuery({ typename });
-    const filter = schema ? Filter.type(schema) : Filter.typename(typename);
-
-    const { objects } = yield* DatabaseService.runQuery(Query.select(filter));
-    const results = objects.map((object) => ({
-      dxn: Obj.getDXN(object).toString(),
-      label: Obj.getLabel(object),
-    }));
-
-    return { results };
-  }),
-});

package/src/functions/load.ts

@@ -1,46 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Effect from 'effect/Effect';
-import * as Function from 'effect/Function';
-import * as Option from 'effect/Option';
-import * as Schema from 'effect/Schema';
-
-import { ArtifactId } from '@dxos/assistant';
-import { Obj } from '@dxos/echo';
-import { DatabaseService, defineFunction } from '@dxos/functions';
-
-// TODO(burdon): Common error handling.
-// TODO(burdon): Factor out to space plugin.
-export default defineFunction({
-  key: 'dxos.org/function/assistant/load',
-  name: 'Assistant load',
-  description: 'Loads the object.',
-  inputSchema: Schema.Struct({
-    id: ArtifactId.annotations({
-      description: 'The ID of the object.',
-    }),
-    typename: Schema.String.annotations({
-      description: 'The typename of the object.',
-    }),
-  }),
-  outputSchema: Schema.Struct({
-    // TODO(wittjosiah): Type.Obj.Any | Type.Relation.Any
-    object: Schema.Any,
-  }),
-  handler: Effect.fn(function* ({ data: { id, typename } }) {
-    const object = yield* DatabaseService.resolve(ArtifactId.toDXN(id));
-    return yield* Function.pipe(
-      Option.fromNullable(object),
-      Option.flatMap((object) => (Obj.getTypename(object) === typename ? Option.some(object) : Option.none())),
-      Option.match({
-        onNone: () => Effect.fail('Object not found.'),
-        onSome: (object) => {
-          // log.info('object', { object });
-          return Effect.succeed({ object });
-        },
-      }),
-    );
-  }),
-});

package/src/hooks/useItemTypes.ts

@@ -1,37 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Option from 'effect/Option';
-import { useEffect, useState } from 'react';
-
-import { type Type } from '@dxos/echo';
-import { type Space } from '@dxos/react-client/echo';
-import { ItemAnnotation } from '@dxos/schema';
-
-// TODO(burdon): Pass in filter.
-export const useItemTypes = (space?: Space): Type.Obj.Any[] => {
-  const [types, setTypes] = useState<Type.Obj.Any[]>([]);
-  useEffect(() => {
-    if (!space) {
-      return;
-    }
-
-    return space.db.schemaRegistry.query().subscribe(
-      (query) => {
-        const types = Array.from(
-          new Set(
-            [...space.db.graph.schemaRegistry.schemas, ...query.results].filter((type) =>
-              Option.isSome(ItemAnnotation.get(type)),
-            ),
-          ),
-        );
-
-        setTypes(types);
-      },
-      { fire: true },
-    );
-  }, [space]);
-
-  return types;
-};

package/src/processor/processor.test.ts

@@ -1,81 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Tool from '@effect/ai/Tool';
-import * as Toolkit from '@effect/ai/Toolkit';
-import { describe, it } from '@effect/vitest';
-import * as Effect from 'effect/Effect';
-import * as Layer from 'effect/Layer';
-import * as Schema from 'effect/Schema';
-
-import { AiService } from '@dxos/ai';
-import { AiServiceTestingPreset } from '@dxos/ai/testing';
-import { AiConversation, makeToolExecutionServiceFromFunctions, makeToolResolverFromFunctions } from '@dxos/assistant';
-import { TestHelpers, acquireReleaseResource } from '@dxos/effect';
-import {
-  ComputeEventLogger,
-  CredentialsService,
-  FunctionInvocationService,
-  QueueService,
-  TracingService,
-} from '@dxos/functions';
-import { TestDatabaseLayer } from '@dxos/functions/testing';
-import { type DataType } from '@dxos/schema';
-
-import { AiChatProcessor, type AiChatServices } from './processor';
-
-class TestToolkit extends Toolkit.make(
-  Tool.make('random', {
-    description: 'Random number generator',
-    parameters: {},
-    success: Schema.Number,
-  }),
-) {}
-
-// TODO(burdon): Create minimal toolkit.
-const toolkit = Toolkit.merge(TestToolkit) as Toolkit.Toolkit<any>;
-
-// TODO(burdon): Explain structure.
-const TestServicesLayer = Layer.mergeAll(
-  TracingService.layerNoop,
-  AiServiceTestingPreset('direct'),
-  TestDatabaseLayer({
-    // indexing: { vector: true },
-    // types: [],
-  }),
-  // CredentialsService.configuredLayer([{ service: 'exa.ai', apiKey: EXA_API_KEY }]),
-  FunctionInvocationService.layerTestMocked({ functions: [] }).pipe(
-    Layer.provideMerge(ComputeEventLogger.layerFromTracing),
-    Layer.provideMerge(TracingService.layerNoop),
-  ),
-);
-
-const TestLayer: Layer.Layer<AiChatServices, never, never> = Layer.mergeAll(
-  AiService.model('@anthropic/claude-opus-4-0'),
-  makeToolResolverFromFunctions([], toolkit),
-  makeToolExecutionServiceFromFunctions(toolkit, toolkit.toLayer({}) as any),
-  CredentialsService.layerFromDatabase(),
-  ComputeEventLogger.layerFromTracing,
-).pipe(Layer.provideMerge(TestServicesLayer), Layer.orDie);
-
-// TODO(burdon): Create actual test with mock LLM.
-describe('Chat processor', () => {
-  it.scoped(
-    'basic',
-    Effect.fn(
-      function* ({ expect }) {
-        const services = yield* Effect.runtime<AiChatServices>();
-        const queue = yield* QueueService.createQueue<DataType.Message>();
-        const conversation = yield* acquireReleaseResource(() => new AiConversation({ queue }));
-        const processor = new AiChatProcessor(conversation, async () => services);
-        const result = yield* Effect.promise(() => processor.request({ message: 'Hello' }));
-        void processor.cancel();
-        expect(processor.active).to.be.false;
-        expect(result).to.exist;
-      },
-      Effect.provide(TestLayer),
-      TestHelpers.taggedTest('llm'),
-    ),
-  );
-});

package/src/queue-logger.ts

@@ -1,125 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { type Queue, Ref, type Space, getSpace } from '@dxos/client/echo';
-import { type Sequence, type SequenceEvent, type SequenceLogger } from '@dxos/conductor';
-import { DXN, Key, Obj } from '@dxos/echo';
-import {
-  InvocationOutcome,
-  InvocationTraceEndEvent,
-  type InvocationTraceEvent,
-  InvocationTraceEventType,
-  InvocationTraceStartEvent,
-  TraceEvent,
-} from '@dxos/functions';
-import { invariant } from '@dxos/invariant';
-import { QueueSubspaceTags } from '@dxos/keys';
-
-export class QueueLogger implements SequenceLogger {
-  private _space: Space;
-  private _invocationTraceQueue: Queue<InvocationTraceEvent>;
-
-  constructor(private readonly sequence: Sequence) {
-    const space = getSpace(sequence);
-    invariant(space, 'Space not found');
-    this._space = space;
-    let dxn = this._space.properties.invocationTraceQueue?.dxn;
-    if (!dxn) {
-      dxn = DXN.fromQueue(QueueSubspaceTags.TRACE, this._space.id, Key.ObjectId.random());
-      this._space.properties.invocationTraceQueue = Ref.fromDXN(dxn);
-    }
-    this._invocationTraceQueue = this._space.queues.get(dxn);
-  }
-
-  log(event: SequenceEvent) {
-    switch (event.type) {
-      case 'begin':
-        void this._invocationTraceQueue.append([
-          Obj.make(InvocationTraceStartEvent, {
-            type: InvocationTraceEventType.START,
-            invocationId: event.invocationId,
-            timestamp: Date.now(),
-            input: {},
-            invocationTraceQueue: Ref.fromDXN(this._getTraceQueueDxn(event.invocationId)),
-            invocationTarget: Ref.make(this.sequence),
-          }),
-        ]);
-        break;
-      case 'end':
-        void this._invocationTraceQueue.append([
-          Obj.make(InvocationTraceEndEvent, {
-            type: InvocationTraceEventType.END,
-            invocationId: event.invocationId,
-            timestamp: Date.now(),
-            outcome: InvocationOutcome.SUCCESS,
-          }),
-        ]);
-        break;
-      case 'step-start':
-      case 'step-complete':
-        void this._getTraceEventQueue(event.invocationId).append([
-          Obj.make(TraceEvent, {
-            outcome: event.type,
-            truncated: false,
-            ingestionTimestamp: Date.now(),
-            logs: [
-              {
-                timestamp: Date.now(),
-                level: 'info',
-                message: event.type,
-                context: { step: event.step },
-              },
-            ],
-            exceptions: [],
-          }),
-        ]);
-        break;
-      case 'message':
-        void this._getTraceEventQueue(event.invocationId).append([
-          Obj.make(TraceEvent, {
-            outcome: event.type,
-            truncated: false,
-            ingestionTimestamp: Date.now(),
-            logs: [
-              {
-                timestamp: Date.now(),
-                level: 'info',
-                message: event.type,
-                context: { message: event.message },
-              },
-            ],
-            exceptions: [],
-          }),
-        ]);
-        break;
-      case 'block':
-        void this._getTraceEventQueue(event.invocationId).append([
-          Obj.make(TraceEvent, {
-            outcome: event.type,
-            truncated: false,
-            ingestionTimestamp: Date.now(),
-            logs: [
-              {
-                timestamp: Date.now(),
-                level: 'info',
-                message: event.type,
-                context: { block: event.block },
-              },
-            ],
-            exceptions: [],
-          }),
-        ]);
-        break;
-    }
-  }
-
-  private _getTraceQueueDxn(invocationId: string): DXN {
-    return DXN.fromQueue(QueueSubspaceTags.TRACE, this._space.id, invocationId);
-  }
-
-  private _getTraceEventQueue(invocationId: string): Queue<TraceEvent> {
-    const dxn = this._getTraceQueueDxn(invocationId);
-    return this._space.queues.get(dxn);
-  }
-}

package/src/types/AssistantAction.ts

@@ -1,62 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import * as Schema from 'effect/Schema';
-
-import { Blueprint } from '@dxos/blueprints';
-import { EchoObjectSchema, SpaceSchema } from '@dxos/client/echo';
-import { Sequence } from '@dxos/conductor';
-import { DataType } from '@dxos/schema';
-
-import { meta } from '../meta';
-
-import { Chat } from './Assistant';
-
-export class onCreateSpace extends Schema.TaggedClass<onCreateSpace>()(`${meta.id}/on-space-created`, {
-  input: Schema.Struct({
-    space: SpaceSchema,
-    rootCollection: DataType.Collection,
-  }),
-  output: Schema.Void,
-}) {}
-
-export class CreateChat extends Schema.TaggedClass<CreateChat>()(`${meta.id}/action/create-chat`, {
-  input: Schema.Struct({
-    space: SpaceSchema,
-    name: Schema.optional(Schema.String),
-  }),
-  output: Schema.Struct({
-    object: Chat,
-  }),
-}) {}
-
-export const BlueprintForm = Schema.Struct({
-  key: Schema.String,
-  name: Schema.String,
-  description: Schema.optional(Schema.String),
-});
-
-export class CreateBlueprint extends Schema.TaggedClass<CreateBlueprint>()(`${meta.id}/action/create-blueprint`, {
-  input: BlueprintForm,
-  output: Schema.Struct({
-    object: Blueprint.Blueprint,
-  }),
-}) {}
-
-export class CreateSequence extends Schema.TaggedClass<CreateSequence>()(`${meta.id}/action/create-sequence`, {
-  input: Schema.Struct({
-    name: Schema.optional(Schema.String),
-  }),
-  output: Schema.Struct({
-    object: Sequence,
-  }),
-}) {}
-
-export class SetCurrentChat extends Schema.TaggedClass<SetCurrentChat>()(`${meta.id}/action/set-current-chat`, {
-  input: Schema.Struct({
-    companionTo: EchoObjectSchema,
-    chat: Chat,
-  }),
-  output: Schema.Void,
-}) {}

package/src/types/defs.ts

@@ -1,5 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-export const LLM_PROVIDERS = ['edge', 'ollama', 'lmstudio'] as const;