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

package/src/types/Project.ts

@@ -0,0 +1,197 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+// @import-as-namespace
+
+import * as Effect from 'effect/Effect';
+import * as Function from 'effect/Function';
+import * as Schema from 'effect/Schema';
+
+import { AiContextBinder, AiContextService, type ContextBinding } from '@dxos/assistant';
+import { type Blueprint } from '@dxos/blueprints';
+import { Annotation, Database, Obj, Ref, Relation, Type } from '@dxos/echo';
+import { type ObjectNotFoundError } from '@dxos/echo/Err';
+import { FormInputAnnotation } from '@dxos/echo/internal';
+import { Queue } from '@dxos/echo-db';
+import { acquireReleaseResource } from '@dxos/effect';
+import { QueueService } from '@dxos/functions';
+import { invariant } from '@dxos/invariant';
+import { QueueAnnotation, Text } from '@dxos/schema';
+import type { Message } from '@dxos/types';
+
+import * as Chat from './Chat';
+import * as Plan from './Plan';
+
+/**
+ * Project schema definition.
+ */
+export const Project = Schema.Struct({
+  name: Schema.String,
+
+  spec: Ref.Ref(Text.Text).pipe(FormInputAnnotation.set(false)),
+  plan: Ref.Ref(Plan.Plan).pipe(FormInputAnnotation.set(false)),
+
+  artifacts: Schema.Array(
+    Schema.Struct({
+      // TODO(dmaretskyi): Consider gettings names from the artifact itself using Obj.getLabel.
+      name: Schema.String,
+      data: Ref.Ref(Obj.Unknown),
+    }),
+  ).pipe(FormInputAnnotation.set(false)),
+
+  /**
+   * Incoming queue that the agent processes.
+   */
+  // NOTE: Named `queue` to conform to subscribable schema (see QueueAnnotation).
+  queue: Schema.optional(Ref.Ref(Queue).pipe(FormInputAnnotation.set(false))),
+
+  // TODO(dmaretskyi): Multiple chats.
+  chat: Schema.optional(Ref.Ref(Chat.Chat).pipe(FormInputAnnotation.set(false))),
+
+  /**
+   * References to objects with a canonical queue property.
+   * Schema must have the QueueAnnotation.
+   */
+  // TODO(dmaretskyi): Turn into an array of objects when form-data
+  subscriptions: Schema.Array(Ref.Ref(Obj.Unknown)).pipe(FormInputAnnotation.set(false)),
+
+  useQualifyingAgent: Schema.optional(Schema.Boolean).annotations({
+    title: 'Use qualifying agent on subscriptions',
+    description:
+      'If enabled, the qualifying agent will be used to determine if the event is relevant to the project. Related events will be added to the input queue of the project. It is recommended to enable this.',
+  }),
+}).pipe(
+  Type.object({
+    typename: 'org.dxos.type.project',
+    version: '0.1.0',
+  }),
+  Annotation.IconAnnotation.set({
+    icon: 'ph--circuitry--regular',
+    hue: 'sky',
+  }),
+  QueueAnnotation.set(true),
+);
+
+export interface Project extends Schema.Schema.Type<typeof Project> {}
+
+/**
+ * Creates a fully initialized Project with chat, queue, and context bindings.
+ *
+ * @param props - Project properties including spec, plan, blueprints, and context objects.
+ * @param blueprint - The blueprint to use for the project context.
+ * @returns An Effect that yields the initialized Project.
+ */
+// TODO(burdon): Rename make and move into Project.ts?
+export const makeInitialized = (
+  props: Omit<Obj.MakeProps<typeof Project>, 'spec' | 'plan' | 'artifacts' | 'subscriptions' | 'chat'> &
+    Partial<Pick<Obj.MakeProps<typeof Project>, 'artifacts' | 'subscriptions'>> & {
+      spec: string;
+      blueprints?: Ref.Ref<Blueprint.Blueprint>[];
+      contextObjects?: Ref.Ref<Obj.Any>[];
+    },
+  blueprint: Blueprint.Blueprint,
+): Effect.Effect<Project, never, QueueService | Database.Service> =>
+  Effect.gen(function* () {
+    const project = Obj.make(Project, {
+      ...props,
+      spec: Ref.make(Text.make(props.spec)),
+      plan: Ref.make(Plan.makePlan({ tasks: [] })),
+      artifacts: props.artifacts ?? [],
+      subscriptions: props.subscriptions ?? [],
+      useQualifyingAgent: props.useQualifyingAgent ?? true,
+    });
+    yield* Database.add(project);
+    const queue = yield* QueueService.createQueue<Message.Message | ContextBinding>();
+    const contextBinder = new AiContextBinder({ queue });
+    // TODO(dmaretskyi): Blueprint registry.
+    const projectBlueprint = yield* Database.add(Obj.clone(blueprint, { deep: true }));
+    yield* Effect.promise(() =>
+      contextBinder.bind({
+        blueprints: [Ref.make(projectBlueprint), ...(props.blueprints ?? [])],
+        objects: [Ref.make(project), ...(props.contextObjects ?? [])],
+      }),
+    );
+    const chat = yield* Database.add(
+      Chat.make({
+        [Obj.Parent]: project,
+        queue: Ref.fromDXN(queue.dxn),
+      }),
+    );
+    yield* Database.add(
+      Relation.make(Chat.CompanionTo, {
+        [Relation.Source]: chat,
+        [Relation.Target]: project,
+      }),
+    );
+
+    const inputQueue = yield* QueueService.createQueue();
+
+    Obj.change(project, (project) => {
+      project.chat = Ref.make(chat);
+      project.queue = Ref.fromDXN(inputQueue.dxn);
+    });
+
+    return project;
+  });
+
+/**
+ * Resets the project chat history by rebuilding the chat context.
+ * Preserves the existing blueprints and objects from the current chat context.
+ *
+ * @param project - The project whose chat history should be reset. Must have an existing chat.
+ * @returns An Effect that resets the chat history.
+ */
+export const resetChatHistory = (
+  project: Project,
+): Effect.Effect<void, ObjectNotFoundError, QueueService | Database.Service> =>
+  Effect.gen(function* () {
+    invariant(project.chat, 'Project must have an existing chat to reset.');
+
+    const existingQueue = yield* project.chat.pipe(Database.load).pipe(
+      Effect.map((_) => _.queue),
+      Effect.flatMap(Database.load),
+    );
+    const existingContextBinder = yield* acquireReleaseResource(
+      () =>
+        new AiContextBinder({
+          queue: existingQueue,
+        }),
+    );
+    const blueprints = existingContextBinder.getBlueprints().map((blueprint) => Ref.make(blueprint));
+    const objects = existingContextBinder.getObjects().map((object) => Ref.make(object));
+
+    const queue = yield* QueueService.createQueue();
+    const contextBinder = new AiContextBinder({ queue });
+    yield* Effect.promise(() =>
+      contextBinder.bind({
+        blueprints,
+        objects,
+      }),
+    );
+    const chat = yield* Database.add(
+      Chat.make({
+        queue: Ref.fromDXN(queue.dxn),
+      }),
+    );
+
+    Obj.change(project, (project) => {
+      project.chat = Ref.make(chat);
+    });
+
+    yield* Database.add(
+      Relation.make(Chat.CompanionTo, {
+        [Relation.Source]: chat,
+        [Relation.Target]: project,
+      }),
+    );
+  }).pipe(Effect.scoped);
+
+export const getFromChatContext: Effect.Effect<Project, never, AiContextService> = Effect.gen(function* () {
+  const projects = yield* Function.pipe(AiContextService.findObjects(Project));
+  if (projects.length !== 1) {
+    throw new Error('There should be exactly one project in context. Got: ' + projects.length);
+  }
+  const project = projects[0];
+  return project;
+});

package/src/types/index.ts

@@ -0,0 +1,8 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+export * as Chat from './Chat';
+export * as Project from './Project';
+export * as Plan from './Plan';
+export * as Memory from './Memory';