@dxos/plugin-assistant 0.8.3-staging.0fa589b → 0.8.4-main.03d5cd7b56

package/src/types/AssistantOperation.ts

@@ -0,0 +1,128 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+// @import-as-namespace
+
+import * as Schema from 'effect/Schema';
+
+import { AiService } from '@dxos/ai';
+import { Capability } from '@dxos/app-framework';
+import { Chat } from '@dxos/assistant-toolkit';
+import { SpaceSchema } from '@dxos/client/echo';
+import { Routine, Operation } from '@dxos/compute';
+import { Collection, Database, DXN, Feed, Obj, Ref } from '@dxos/echo';
+
+import { meta } from '#meta';
+
+const ASSISTANT_OPERATION = `${meta.id}.operation`;
+
+export const OnCreateSpace = Operation.make({
+  meta: { key: `${ASSISTANT_OPERATION}.on-create-space`, name: 'On Create Space' },
+  services: [Capability.Service],
+  input: Schema.Struct({
+    space: SpaceSchema,
+    rootCollection: Collection.Collection,
+  }),
+  output: Schema.Void,
+});
+
+export const CreateChat = Operation.make({
+  meta: { key: `${ASSISTANT_OPERATION}.create-chat`, name: 'Create Chat' },
+  services: [Capability.Service],
+  input: Schema.Struct({
+    db: Database.Database,
+    name: Schema.optional(Schema.String),
+    /** If false, chat is created in-memory only and not added to space. Defaults to true. */
+    addToSpace: Schema.optional(Schema.Boolean),
+  }),
+  output: Schema.Struct({
+    object: Chat.Chat,
+  }),
+});
+
+export const UpdateChatName = Operation.make({
+  meta: { key: `${ASSISTANT_OPERATION}.update-chat-name`, name: 'Update Chat Name' },
+  services: [Database.Service, Feed.FeedService, AiService.AiService],
+  input: Schema.Struct({
+    chat: Chat.Chat,
+  }),
+  output: Schema.Void,
+});
+
+export const SetCurrentChat = Operation.make({
+  meta: { key: `${ASSISTANT_OPERATION}.set-current-chat`, name: 'Set Current Chat' },
+  services: [Capability.Service],
+  input: Schema.Struct({
+    companionTo: Obj.Unknown,
+    chat: Chat.Chat.pipe(Schema.optional),
+  }),
+  output: Schema.Void,
+});
+
+export const RunPromptInNewChat = Operation.make({
+  meta: { key: `${ASSISTANT_OPERATION}.run-prompt-in-new-chat`, name: 'Run Prompt In New Chat' },
+  services: [Capability.Service],
+  input: Schema.Struct({
+    db: Database.Database,
+    /** Context objects to bind to the new chat. */
+    objects: Schema.optional(Schema.Array(Obj.Unknown)),
+    /** Blueprint keys to look up and bind to the new chat. */
+    blueprints: Schema.optional(Schema.Array(Schema.String)),
+    /** Raw instructions or an existing Routine object reference. */
+    prompt: Schema.Union(Schema.String, Ref.Ref(Routine.Routine)),
+    /**
+     * When true, skips opening the chat: runs the Agent prompt operation against the new chat via the compute runtime (traced).
+     */
+    background: Schema.optional(Schema.Boolean),
+  }),
+  output: Schema.Struct({
+    object: Chat.Chat,
+  }),
+});
+
+const NavigationTargetSchema = Schema.Struct({
+  path: Schema.String.annotations({ description: 'Navigation path to use with the Open operation.' }),
+  label: Schema.String.annotations({ description: 'Human-readable label.' }),
+  type: Schema.String.annotations({ description: 'Object type.' }),
+});
+
+export const ResolveNavigationTargets = Operation.make({
+  meta: {
+    key: `${ASSISTANT_OPERATION}.resolve-navigation-targets`,
+    name: 'Resolve navigation targets',
+    description:
+      'Resolve navigation targets within the application. The returned paths can be used with the Open operation. Without a query, returns pages that can be navigated to.',
+  },
+  input: Schema.Struct({
+    query: Schema.optional(
+      Schema.Struct({
+        dxn: DXN.Schema.pipe(Schema.optional),
+      }),
+    ),
+  }),
+  output: Schema.Struct({
+    targets: Schema.Array(NavigationTargetSchema),
+  }),
+  services: [Capability.Service],
+});
+
+export const EnsureCompanionChat = Operation.make({
+  meta: { key: `${ASSISTANT_OPERATION}.ensure-companion-chat`, name: 'Ensure Companion Chat' },
+  services: [Capability.Service],
+  input: Schema.Struct({
+    db: Database.Database,
+    companionTo: Obj.Unknown,
+  }),
+  output: Schema.Struct({
+    chat: Chat.Chat,
+    /** Whether the returned chat was already persisted in the space. */
+    persisted: Schema.Boolean,
+  }),
+});
+
+export const BlueprintForm = Schema.Struct({
+  key: Schema.String,
+  name: Schema.String,
+  description: Schema.optional(Schema.String),
+});

package/src/types/Settings.ts

@@ -0,0 +1,76 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+// @import-as-namespace
+
+import * as Schema from 'effect/Schema';
+
+import { getLiteralValues } from '@dxos/effect';
+
+export const ModelProvider = Schema.Union(
+  Schema.Literal('edge').annotations({ title: 'DXOS' }),
+  Schema.Literal('ollama').annotations({ title: 'Ollama' }),
+  Schema.Literal('lmstudio').annotations({ title: 'LM Studio' }),
+);
+export type ModelProvider = Schema.Schema.Type<typeof ModelProvider>;
+export const ModelProviders = getLiteralValues(ModelProvider);
+
+export const ChatView = Schema.Union(
+  Schema.Literal('normal').annotations({ title: 'Normal' }),
+  Schema.Literal('summary').annotations({ title: 'Summary' }),
+  Schema.Literal('thinking').annotations({ title: 'Thinking' }),
+  Schema.Literal('debug').annotations({ title: 'Debug' }),
+);
+export type ChatView = Schema.Schema.Type<typeof ChatView>;
+export const ChatViews = getLiteralValues(ChatView);
+
+export const ModelDefaults = Schema.mutable(
+  Schema.Struct({
+    edge: Schema.optional(
+      Schema.String.annotations({
+        title: 'Remote language model',
+        description: 'Choose the remote language model used for AI requests.',
+      }),
+    ),
+    ollama: Schema.optional(
+      Schema.String.annotations({
+        title: 'Ollama language model',
+        description: 'Choose the locally hosted Ollama model for AI requests.',
+      }),
+    ),
+    lmstudio: Schema.optional(
+      Schema.String.annotations({
+        title: 'LM Studio language model',
+        description: 'Choose the locally hosted LM Studio model for AI requests.',
+      }),
+    ),
+  }),
+);
+export type ModelDefaults = Schema.Schema.Type<typeof ModelDefaults>;
+
+export const Settings = Schema.mutable(
+  Schema.Struct({
+    customPrompts: Schema.optional(
+      Schema.Boolean.annotations({
+        title: 'Use custom prompts',
+        description: 'Allow the assistant to use custom prompts defined in your spaces.',
+      }),
+    ),
+    chatView: Schema.optional(
+      ChatView.annotations({
+        title: 'Chat view',
+        description:
+          'Controls which message blocks are shown in the chat: normal hides reasoning, thinking shows reasoning, debug shows raw blocks, summary shows only conversational text.',
+      }),
+    ),
+    modelProvider: Schema.optional(
+      ModelProvider.annotations({
+        title: 'LLM provider',
+        description: 'Select which language model service to use for AI responses.',
+      }),
+    ),
+    modelDefaults: Schema.optional(ModelDefaults),
+  }),
+);
+export interface Settings extends Schema.Schema.Type<typeof Settings> {}

package/src/types/index.ts

@@ -2,7 +2,14 @@
 // Copyright 2024 DXOS.org
 //
 
-export * from './chat';
+// TODO(wittjosiah): Remove. This is included in Assistant namespace.
+// Re-export Chat type from assistant-toolkit for public API type declarations.
+export type { Chat as ChatType } from '@dxos/assistant-toolkit';
+
+export * as Assistant from './Assistant';
+export * as AssistantOperation from './AssistantOperation';
+export * as AssistantCapabilities from './AssistantCapabilities';
+export * as AssistantEvents from './AssistantEvents';
+
+// TODO(wittjosiah): Namespace.
 export * from './service';
-export * from './template';
-export * from './types';

package/src/types/service.ts

@@ -2,12 +2,13 @@
 // Copyright 2024 DXOS.org
 //
 
-import { Schema } from 'effect';
+import * as Schema from 'effect/Schema';
 
+import { Operation } from '@dxos/compute';
 import { ComputeGraph } from '@dxos/conductor';
-import { Type } from '@dxos/echo';
-import { TypedObject } from '@dxos/echo-schema';
-import { FunctionType } from '@dxos/functions';
+import { Ref, Type } from '@dxos/echo';
+
+// TODO(burdon): Factor out and reconcile with https://github.com/dxos/dxos/blob/main/packages/plugins/plugin-token-manager/src/defs/presets.ts#L7
 
 const ApiAuthorizationKey = Schema.Struct({
   type: Schema.Literal('api-key'),
@@ -36,12 +37,12 @@ export type ApiAuthorization = Schema.Schema.Type<typeof ApiAuthorization>;
 
 const ServiceInterfaceFunction = Schema.Struct({
   kind: Schema.Literal('function'),
-  fn: Type.Ref(FunctionType),
+  fn: Ref.Ref(Operation.PersistentOperation),
 });
 
 const ServiceInterfaceWorkflow = Schema.Struct({
   kind: Schema.Literal('workflow'),
-  workflow: Type.Ref(ComputeGraph),
+  workflow: Ref.Ref(ComputeGraph),
 });
 
 const ServiceInterfaceApi = Schema.Struct({
@@ -63,13 +64,16 @@ const ServiceInterfaceApi = Schema.Struct({
   authorization: Schema.optional(ApiAuthorization),
 });
 
-const ServiceInterface = Schema.Union(ServiceInterfaceFunction, ServiceInterfaceWorkflow, ServiceInterfaceApi);
+const ServiceInterface = Schema.Union(
+  // Service types.
+  ServiceInterfaceFunction,
+  ServiceInterfaceWorkflow,
+  ServiceInterfaceApi,
+) as any;
+
 export type ServiceInterface = Schema.Schema.Type<typeof ServiceInterface>;
 
-export class ServiceType extends TypedObject({
-  typename: 'dxos.org/type/ServiceType',
-  version: '0.1.0',
-})({
+export const ServiceType = Schema.Struct({
   serviceId: Schema.String,
   name: Schema.optional(Schema.String),
   description: Schema.optional(Schema.String),
@@ -80,21 +84,28 @@ export class ServiceType extends TypedObject({
    * Entries exposed: functions, workflows, and APIs.
    */
   interfaces: Schema.optional(Schema.Array(ServiceInterface)),
-}) {}
+}).pipe(
+  Type.object({
+    typename: 'org.dxos.type.service',
+    version: '0.1.0',
+  }),
+);
+
+export interface ServiceType extends Schema.Schema.Type<typeof ServiceType> {}
 
 //
 // Service Registry
 //
 
+export interface BaseServiceRegistry {
+  queryServices(query?: ServiceQuery): Promise<ServiceType[]>;
+}
+
 export type ServiceQuery = {
   name?: string;
   category?: string;
 };
 
-export interface BaseServiceRegistry {
-  queryServices(query?: ServiceQuery): Promise<ServiceType[]>;
-}
-
 export const categoryIcons: Record<string, string> = {
   finance: 'ph--bank--regular',
   health: 'ph--heart--regular',

package/src/vite-env.d.ts

@@ -0,0 +1,30 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+/// <reference types="vite/client" />
+
+interface ViteTypeOptions {
+  // By adding this line, you can make the type of ImportMetaEnv strict
+  // to disallow unknown keys.
+  // strictImportMetaEnv: unknown
+}
+
+interface ImportMetaEnv {
+  readonly VITE_LINEAR_API_KEY: string | undefined;
+  // more env variables...
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}
+
+declare module '*.wav' {
+  const src: string;
+  export default src;
+}
+
+declare module '*?raw' {
+  const content: string;
+  export default content;
+}

package/dist/lib/browser/AssistantDialog-MQOOR364.mjs

@@ -1,47 +0,0 @@
-import {
-  AmbientDialog
-} from "./chunk-Q6UZ4F3H.mjs";
-import {
-  ThreadContainer
-} from "./chunk-JO4W3MF7.mjs";
-import "./chunk-AAOKC2JN.mjs";
-import "./chunk-MEGMOFJB.mjs";
-import "./chunk-UE3IZ4PN.mjs";
-import {
-  ASSISTANT_PLUGIN
-} from "./chunk-XOZ7YMO3.mjs";
-
-// packages/plugins/plugin-assistant/src/components/AssistantDialog.tsx
-import { useSignals as _useSignals } from "@preact-signals/safe-react/tracking";
-import React, { useState } from "react";
-import { useCapability, Capabilities, useCapabilities } from "@dxos/app-framework";
-import { TranscriptionCapabilities } from "@dxos/plugin-transcription";
-import { useTranslation } from "@dxos/react-ui";
-var AssistantDialog = ({ chat }) => {
-  var _effect = _useSignals();
-  try {
-    const { t } = useTranslation(ASSISTANT_PLUGIN);
-    const transcription = useCapabilities(TranscriptionCapabilities.Transcriber).length > 0;
-    const settings = useCapability(Capabilities.SettingsStore).getStore(ASSISTANT_PLUGIN)?.value;
-    const [open, setOpen] = useState(false);
-    return /* @__PURE__ */ React.createElement(AmbientDialog, {
-      open,
-      onOpenChange: setOpen,
-      title: t("assistant dialog title")
-    }, /* @__PURE__ */ React.createElement(ThreadContainer, {
-      part: "dialog",
-      chat,
-      onOpenChange: setOpen,
-      settings,
-      transcription
-    }));
-  } finally {
-    _effect.f();
-  }
-};
-var AssistantDialog_default = AssistantDialog;
-export {
-  AssistantDialog,
-  AssistantDialog_default as default
-};
-//# sourceMappingURL=AssistantDialog-MQOOR364.mjs.map

package/dist/lib/browser/AssistantDialog-MQOOR364.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/components/AssistantDialog.tsx"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport React, { type FC, useState } from 'react';\n\nimport { useCapability, Capabilities, useCapabilities } from '@dxos/app-framework';\nimport { TranscriptionCapabilities } from '@dxos/plugin-transcription';\nimport { useTranslation } from '@dxos/react-ui';\n\nimport { AmbientDialog } from './AmbientDialog';\nimport { ThreadContainer } from './Thread';\nimport { ASSISTANT_PLUGIN } from '../meta';\nimport { type AssistantSettingsProps, type AIChatType } from '../types';\n\nexport const AssistantDialog: FC<{ chat?: AIChatType }> = ({ chat }) => {\n  const { t } = useTranslation(ASSISTANT_PLUGIN);\n  const transcription = useCapabilities(TranscriptionCapabilities.Transcriber).length > 0;\n  const settings = useCapability(Capabilities.SettingsStore).getStore<AssistantSettingsProps>(ASSISTANT_PLUGIN)?.value;\n\n  // TODO(burdon): Refocus when open.\n  const [open, setOpen] = useState(false);\n\n  return (\n    <AmbientDialog open={open} onOpenChange={setOpen} title={t('assistant dialog title')}>\n      <ThreadContainer\n        part={'dialog'}\n        chat={chat}\n        onOpenChange={setOpen}\n        settings={settings}\n        transcription={transcription}\n      />\n    </AmbientDialog>\n  );\n};\n\nexport default AssistantDialog;\n"],
-  "mappings": ";;;;;;;;;;;;;;;AAIA,OAAOA,SAAkBC,gBAAgB;AAEzC,SAASC,eAAeC,cAAcC,uBAAuB;AAC7D,SAASC,iCAAiC;AAC1C,SAASC,sBAAsB;AAOxB,IAAMC,kBAA6C,CAAC,EAAEC,KAAI,MAAE;;;AACjE,UAAM,EAAEC,EAAC,IAAKC,eAAeC,gBAAAA;AAC7B,UAAMC,gBAAgBC,gBAAgBC,0BAA0BC,WAAW,EAAEC,SAAS;AACtF,UAAMC,WAAWC,cAAcC,aAAaC,aAAa,EAAEC,SAAiCV,gBAAAA,GAAmBW;AAG/G,UAAM,CAACC,MAAMC,OAAAA,IAAWC,SAAS,KAAA;AAEjC,WACE,sBAAA,cAACC,eAAAA;MAAcH;MAAYI,cAAcH;MAASI,OAAOnB,EAAE,wBAAA;OACzD,sBAAA,cAACoB,iBAAAA;MACCC,MAAM;MACNtB;MACAmB,cAAcH;MACdP;MACAL;;;;;AAIR;AAEA,IAAA,0BAAeL;",
-  "names": ["React", "useState", "useCapability", "Capabilities", "useCapabilities", "TranscriptionCapabilities", "useTranslation", "AssistantDialog", "chat", "t", "useTranslation", "ASSISTANT_PLUGIN", "transcription", "useCapabilities", "TranscriptionCapabilities", "Transcriber", "length", "settings", "useCapability", "Capabilities", "SettingsStore", "getStore", "value", "open", "setOpen", "useState", "AmbientDialog", "onOpenChange", "title", "ThreadContainer", "part"]
-}