@dxos/plugin-assistant 0.7.5-labs.a8b535d

package/src/types/service.ts

@@ -0,0 +1,102 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { ComputeGraph } from '@dxos/conductor';
+import { Ref, S, TypedObject, type Ref$ } from '@dxos/echo-schema';
+import { FunctionType } from '@dxos/functions';
+
+const ApiAuthorizationKey = S.Struct({
+  type: S.Literal('api-key'),
+  key: S.String,
+  placement: S.Union(
+    S.Struct({
+      type: S.Literal('authorization-header'),
+    }),
+    S.Struct({
+      type: S.Literal('query'),
+      name: S.String,
+    }),
+  ),
+});
+
+const ApiAuthorizationOauth = S.Struct({
+  type: S.Literal('oauth'),
+  clientId: S.String,
+  clientSecret: S.String,
+  tokenUrl: S.String,
+  grantType: S.String,
+});
+
+export const ApiAuthorization = S.Union(ApiAuthorizationKey, ApiAuthorizationOauth);
+export type ApiAuthorization = S.Schema.Type<typeof ApiAuthorization>;
+
+const ServiceInterfaceFunction = S.Struct({
+  kind: S.Literal('function'),
+  fn: Ref(FunctionType) as Ref$<FunctionType>,
+});
+
+const ServiceInterfaceWorkflow = S.Struct({
+  kind: S.Literal('workflow'),
+  workflow: Ref(ComputeGraph) as Ref$<ComputeGraph>,
+});
+
+const ServiceInterfaceApi = S.Struct({
+  kind: S.Literal('api'),
+
+  /**
+   * URL to fetch the openapi schema.
+   */
+  schemaUrl: S.optional(S.String),
+
+  /**
+   * Inlined openapi schema.
+   */
+  schema: S.optional(S.Any),
+
+  /**
+   * Authorization configuration if required.
+   */
+  authorization: S.optional(ApiAuthorization),
+});
+
+const ServiceInterface = S.Union(ServiceInterfaceFunction, ServiceInterfaceWorkflow, ServiceInterfaceApi);
+export type ServiceInterface = S.Schema.Type<typeof ServiceInterface>;
+
+export class ServiceType extends TypedObject({ typename: 'dxos.org/type/ServiceType', version: '0.1.0' })({
+  serviceId: S.String,
+  name: S.optional(S.String),
+  description: S.optional(S.String),
+  category: S.optional(S.String),
+  enabled: S.optional(S.Boolean),
+
+  /**
+   * Entries exposed: functions, workflows, and APIs.
+   */
+  interfaces: S.optional(S.Array(ServiceInterface)),
+}) {}
+
+//
+// Service Registry
+//
+
+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',
+  geolocation: 'ph--globe-simple--regular',
+  education: 'ph--books--regular',
+  entertainment: 'ph--music-notes--regular',
+  shopping: 'ph--shopping-cart--regular',
+  travel: 'ph--airplane-takeoff--regular',
+  utilities: 'ph--lightning--regular',
+  weather: 'ph--cloud-rain--regular',
+} as const;

package/src/types/template.ts

@@ -0,0 +1,34 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { S, TypedObject } from '@dxos/echo-schema';
+
+// TODO(burdon): Change to S.Literal (and discriminated union).
+export enum TemplateInputType {
+  VALUE = 0,
+  PASS_THROUGH = 1,
+  RETRIEVER = 2,
+  FUNCTION = 3,
+  QUERY = 4,
+  RESOLVER = 5,
+  CONTEXT = 6,
+  SCHEMA = 7,
+}
+
+export const TemplateInputSchema = S.mutable(
+  S.Struct({
+    name: S.String,
+    type: S.optional(S.Enums(TemplateInputType)),
+    value: S.optional(S.String),
+  }),
+);
+
+export type TemplateInput = S.Schema.Type<typeof TemplateInputSchema>;
+
+export class TemplateType extends TypedObject({ typename: 'dxos.org/type/Template', version: '0.1.0' })({
+  name: S.optional(S.String),
+  source: S.String,
+  inputs: S.optional(S.mutable(S.Array(TemplateInputSchema))),
+  command: S.optional(S.String),
+}) {}

package/src/types/types.ts

@@ -0,0 +1,41 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { S } from '@dxos/echo-schema';
+
+import { AIChatType } from './chat';
+import { TemplateType } from './template';
+import { ASSISTANT_PLUGIN } from '../meta';
+
+export namespace AssistantAction {
+  const ASSISTANT_ACTION = `${ASSISTANT_PLUGIN}/action`;
+
+  export class CreateChat extends S.TaggedClass<CreateChat>()(`${ASSISTANT_ACTION}/create-chat`, {
+    input: S.Struct({
+      spaceId: S.optional(S.String),
+      name: S.optional(S.String),
+    }),
+    output: S.Struct({
+      object: AIChatType,
+    }),
+  }) {}
+
+  export class CreateTemplate extends S.TaggedClass<CreateTemplate>()(`${ASSISTANT_ACTION}/create-template`, {
+    input: S.Struct({
+      name: S.optional(S.String),
+    }),
+    output: S.Struct({
+      object: TemplateType,
+    }),
+  }) {}
+}
+
+export const AssistantSettingsSchema = S.mutable(
+  S.Struct({
+    llmModel: S.optional(S.String),
+    customPrompts: S.optional(S.Boolean),
+  }),
+);
+
+export type AssistantSettingsProps = S.Schema.Type<typeof AssistantSettingsSchema>;

package/src/typings.d.ts

@@ -0,0 +1,9 @@
+// src/types.d.ts
+//
+// Copyright 2025 DXOS.org
+//
+
+declare module '*.wav' {
+  const src: string;
+  export default src;
+}