@dxos/plugin-automation 0.7.5-staging.2ff1350 → 0.7.5-staging.e6154f3

package/src/hooks/useLocalTriggerManager.ts

@@ -1,82 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import { useEffect, useState } from 'react';
-
-import { Mutex } from '@dxos/async';
-import { Context } from '@dxos/context';
-import { createSubscriptionTrigger, type TriggerFactory } from '@dxos/functions';
-import { FunctionTrigger } from '@dxos/functions';
-import { invariant } from '@dxos/invariant';
-import { log } from '@dxos/log';
-import { useClient } from '@dxos/react-client';
-import { Filter, type Space, useQuery } from '@dxos/react-client/echo';
-
-import { invokeFunction } from './invocation-handler';
-
-const registerTriggersMutex = new Mutex();
-
-export const useLocalTriggerManager = (space: Space) => {
-  const client = useClient();
-
-  // TODO(burdon): Factor out, creating context for plugin (runs outside of component).
-  const [registry] = useState(new Map<string, Context>());
-  const triggers = useQuery(space, Filter.schema(FunctionTrigger));
-  useEffect(() => {
-    setTimeout(async () => {
-      // Mark-and-sweep removing disabled triggers.
-      await registerTriggersMutex.executeSynchronized(async () => {
-        const deprecated = new Set(Array.from(registry.keys()));
-        log('triggers', {
-          deprecated,
-          all: triggers.map((t) => t.id),
-          enabled: triggers.filter((t) => t.enabled).map((t) => t.id),
-        });
-
-        for (const trigger of triggers) {
-          if (trigger.enabled) {
-            if (registry.has(trigger.id)) {
-              deprecated.delete(trigger.id);
-              continue;
-            }
-            log.info('activating trigger', trigger.id);
-
-            const ctx = new Context();
-            registry.set(trigger.id, ctx);
-            const triggerSpec = trigger.spec;
-            invariant(triggerSpec);
-
-            let triggerFactory: TriggerFactory<any>;
-            if (triggerSpec.type === 'subscription') {
-              triggerFactory = createSubscriptionTrigger;
-            } else {
-              log.info('unsupported trigger', { type: triggerSpec.type });
-              continue;
-            }
-
-            await triggerFactory(ctx, space, trigger.spec, (data: any) => {
-              return invokeFunction(client, space, trigger, data);
-            });
-          }
-        }
-
-        for (const id of deprecated) {
-          const ctx = registry.get(id);
-          if (ctx) {
-            await ctx.dispose();
-            registry.delete(id);
-          }
-        }
-      });
-    });
-  }, [JSON.stringify(triggers)]);
-
-  useEffect(() => {
-    return () => {
-      for (const ctx of registry.values()) {
-        void ctx.dispose();
-      }
-    };
-  }, []);
-};

package/src/hooks/useMessageQueue.ts

@@ -1,23 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { useMemo } from 'react';
-
-import { type Message } from '@dxos/artifact';
-import { DXN, QueueSubspaceTags } from '@dxos/keys';
-import { getSpace } from '@dxos/react-client/echo';
-import { useEdgeClient, useQueue } from '@dxos/react-edge-client';
-
-import { type AIChatType } from '../types';
-
-export const useMessageQueue = (chat?: AIChatType) => {
-  const space = getSpace(chat);
-  const queueDxn = useMemo(() => {
-    const dxn = space && chat?.queue.dxn;
-    return dxn ? new DXN(DXN.kind.QUEUE, [QueueSubspaceTags.DATA, space.id, dxn.parts.at(-1)!]) : undefined;
-  }, [space, chat?.queue.dxn]);
-
-  const edgeClient = useEdgeClient();
-  return useQueue<Message>(edgeClient, queueDxn);
-};

package/src/hooks/useServices.ts

@@ -1,28 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { useEffect, useMemo, useState } from 'react';
-
-import { type Space } from '@dxos/client/echo';
-
-import { MockServiceRegistry } from '../testing';
-import { type ServiceType, type ServiceQuery } from '../types';
-
-/**
- * Retrieves matching services from the registry.
- */
-export const useServices = (space: Space, query?: ServiceQuery): ServiceType[] => {
-  const registry = useMemo(() => new MockServiceRegistry(), []);
-  const [services, setServices] = useState<ServiceType[]>([]);
-  useEffect(() => {
-    const t = setTimeout(async () => {
-      const services = await registry.queryServices(query);
-      setServices(services);
-    });
-
-    return () => clearTimeout(t);
-  }, [query, registry]);
-
-  return services;
-};

package/src/hooks/useTextInputEvents.ts

@@ -1,49 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { useState, useCallback, type KeyboardEventHandler, type ChangeEventHandler } from 'react';
-
-/**
- * Hook that handles text input events.
- */
-// TODO(burdon): Factor out.
-export const useTextInputEvents = ({
-  onEnter,
-  onEscape,
-}: {
-  onEnter?: (text: string) => boolean | void;
-  onEscape?: () => void;
-}) => {
-  const [value, setValue] = useState('');
-
-  const onKeyDown = useCallback<KeyboardEventHandler<HTMLInputElement>>(
-    (ev) => {
-      switch (ev.key) {
-        case 'Escape': {
-          onEscape?.();
-          setValue('');
-          break;
-        }
-
-        case 'Enter': {
-          const value = (ev.target as HTMLInputElement).value.trim();
-          if (value.length > 0) {
-            const reset = onEnter?.(value);
-            if (reset) {
-              setValue('');
-            }
-          }
-          break;
-        }
-      }
-    },
-    [onEnter, onEscape],
-  );
-
-  const onChange = useCallback<ChangeEventHandler<HTMLInputElement>>((ev) => {
-    setValue(ev.target.value);
-  }, []);
-
-  return [{ value, onKeyDown, onChange }, setValue];
-};

package/src/presets.ts

@@ -1,248 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import { create } from '@dxos/live-object';
-
-import { ChainInputType, ChainPromptType } from './types';
-
-export const str = (...text: (string | undefined | boolean)[]): string =>
-  text
-    .filter((value) => value !== undefined && value !== false)
-    .flat()
-    .join('\n');
-
-export type Preset = {
-  id: string;
-  title: string;
-  createPrompt: () => ChainPromptType;
-};
-
-export const chainPresets: Preset[] = [
-  {
-    id: 'dxos.org/prompt/translate',
-    title: 'Translate',
-    createPrompt: () =>
-      create(ChainPromptType, {
-        command: 'say',
-        template: str(
-          // prettier-ignore
-          'Translate the following into {language}:',
-          '',
-          '---',
-          '',
-          '{input}',
-        ),
-        inputs: [
-          {
-            type: ChainInputType.VALUE,
-            name: 'language',
-            value: 'japanese',
-          },
-          {
-            type: ChainInputType.PASS_THROUGH,
-            name: 'input',
-          },
-          // TODO(burdon): Message.
-          // {
-          //   type: ChainInputType.CONTEXT,
-          //   name: 'input',
-          //   value: 'object.text',
-          // },
-        ],
-      }),
-  },
-  {
-    id: 'dxos.org/prompt/chess',
-    title: 'Chess',
-    createPrompt: () =>
-      create(ChainPromptType, {
-        command: 'hint',
-        template: str(
-          // prettier-ignore
-          'You are a machine that is an expert chess player.',
-          '',
-          'The move history of the current game is: {history}',
-          '',
-          'Suggest the next move and very briefly explain your strategy in a couple of sentences.',
-        ),
-        inputs: [
-          {
-            type: ChainInputType.CONTEXT,
-            name: 'history',
-            value: 'object.pgn',
-          },
-        ],
-      }),
-  },
-  {
-    id: 'dxos.org/prompt/mermaid',
-    title: 'Mermaid',
-    createPrompt: () =>
-      create(ChainPromptType, {
-        command: 'draw',
-        template: str(
-          // prettier-ignore
-          'Create a simplified mermaid graph representing the text below.',
-          'Do not explain anything.',
-          '',
-          '---',
-          '',
-          '{input}',
-        ),
-        inputs: [
-          {
-            type: ChainInputType.PASS_THROUGH,
-            name: 'input',
-          },
-        ],
-      }),
-  },
-  {
-    id: 'dxos.org/prompt/list',
-    title: 'List',
-    createPrompt: () =>
-      create(ChainPromptType, {
-        command: 'list',
-        template: str(
-          // prettier-ignore
-          'You are a machine that only replies with valid, iterable RFC8259 compliant JSON in your responses.',
-          'Your entire response should be a single array of JSON objects.',
-          '',
-          'Your entire response should be a map where the key is the type and the value is a single array of JSON objects conforming to the following types:',
-          '',
-          '{schema}',
-          '',
-          '---',
-          '',
-          '{question}',
-        ),
-        inputs: [
-          {
-            type: ChainInputType.SCHEMA,
-            name: 'schema',
-            value: 'example.com/type/project',
-          },
-          {
-            type: ChainInputType.PASS_THROUGH,
-            name: 'question',
-          },
-        ],
-      }),
-  },
-  {
-    id: 'dxos.org/prompt/base',
-    title: 'RAG',
-    createPrompt: () =>
-      create(ChainPromptType, {
-        command: 'rag',
-        template: str(
-          // prettier-ignore
-          "Very briefly answer the question based only on the following context and say if you don't know the answer.",
-          // 'answer the question using the following context as well as your training data:',
-          '',
-          '{context}',
-          '',
-          '---',
-          '',
-          'question: {question}',
-        ),
-        inputs: [
-          {
-            type: ChainInputType.RETRIEVER,
-            name: 'context',
-          },
-          {
-            type: ChainInputType.CONTEXT,
-            name: 'question',
-            value: 'object.text',
-          },
-        ],
-      }),
-  },
-  {
-    id: 'dxos.org/prompt/lookup',
-    title: 'Lookup',
-    createPrompt: () =>
-      create(ChainPromptType, {
-        command: 'lookup',
-        template: str(
-          // prettier-ignore
-          'Lookup and very briefly summarize the following topic in one or two sentences:',
-          '',
-          '---',
-          '',
-          '{input}',
-        ),
-        inputs: [
-          {
-            type: ChainInputType.CONTEXT,
-            name: 'input',
-            value: 'text',
-          },
-        ],
-      }),
-  },
-  {
-    id: 'dxos.org/prompt/extract',
-    title: 'Extract',
-    createPrompt: () =>
-      create(ChainPromptType, {
-        command: 'extract',
-        template: str(
-          // prettier-ignore
-          'List all people and companies mentioned in the text below.',
-          '',
-          'You are a machine that only replies with valid, iterable RFC8259 compliant JSON in your responses.',
-          'Your entire response should be a map where the key is the type and the value is a single array of JSON objects conforming to the following types:',
-          '',
-          '{contact}',
-          '{company}',
-          '',
-          '---',
-          '',
-          '{input}',
-        ),
-        inputs: [
-          {
-            type: ChainInputType.SCHEMA,
-            name: 'contact',
-            value: 'example.com/type/contact',
-          },
-          {
-            type: ChainInputType.SCHEMA,
-            name: 'company',
-            value: 'example.com/type/organization',
-          },
-          {
-            type: ChainInputType.CONTEXT,
-            name: 'input',
-            value: 'text',
-          },
-        ],
-      }),
-  },
-  {
-    id: 'dxos.org/prompt/discord',
-    title: 'Summarize',
-    createPrompt: () =>
-      create(ChainPromptType, {
-        command: 'summarize',
-        template: str(
-          // prettier-ignore
-          'Summarize what the team is working on and format it as a markdown table without any explanation.',
-          '',
-          '---',
-          '',
-          '{context}',
-        ),
-        inputs: [
-          {
-            type: ChainInputType.RESOLVER,
-            name: 'context',
-            value: 'discord.messages.recent',
-          },
-        ],
-      }),
-  },
-];

package/src/testing/test-services.ts

@@ -1,131 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { createStatic } from '@dxos/echo-schema';
-
-import {
-  type ApiAuthorization,
-  type BaseServiceRegistry,
-  type ServiceQuery,
-  ServiceType,
-  categoryIcons,
-} from '../types';
-
-export class MockServiceRegistry implements BaseServiceRegistry {
-  async queryServices(query?: ServiceQuery): Promise<ServiceType[]> {
-    return TEST_SERVICES;
-  }
-}
-
-// TODO(burdon): Can we generalize credentials?
-
-const AMADEUS_AUTH: ApiAuthorization = {
-  type: 'oauth',
-  clientId: 'BOEnpLd1sMyKjAPGKYeAPFFy60u53QEG',
-  clientSecret: 'n4qldSN7usvD57gm',
-  tokenUrl: 'https://test.api.amadeus.com/v1/security/oauth2/token',
-  grantType: 'client_credentials',
-};
-
-const VISUAL_CROSSING_CREDENTIALS: ApiAuthorization = {
-  type: 'api-key',
-  key: 'FDPRVS953KB4GQQLD25GRT975',
-  placement: {
-    type: 'query',
-    name: 'key',
-  },
-};
-
-// Registries:
-//  - https://apis.guru
-//  - https://rapidapi.com
-//  - https://github.com/konfig-sdks/openapi-examples
-//  - https://publicapis.io/?utm_source=chatgpt.com
-
-// Examples:
-//  - https://petstore.swagger.io/v2/swagger.json (testing)
-//  - https://lichess.org/api
-//  - https://github.com/konfig-sdks/openapi-examples/tree/main/xkcd
-//  - https://api.coindesk.com/v1/bpi/currentprice.json
-//  - https://www.coingecko.com/en/api/documentation
-
-// TODO(burdon): Support yaml endpoints.
-//  - e.g., https://github.com/konfig-sdks/openapi-examples/blob/main/xkcd/openapi.yaml
-
-const TEST_SERVICES: ServiceType[] = [
-  createStatic(ServiceType, {
-    serviceId: 'amadeus.com/service/FlightSearch',
-    name: 'Amadeus Flight Search',
-    description: 'Search for local and international flights.',
-    category: 'travel',
-    interfaces: [
-      {
-        kind: 'api',
-        schemaUrl: 'https://api.apis.guru/v2/specs/amadeus.com/amadeus-flight-availabilities-search/1.0.2/swagger.json',
-        authorization: AMADEUS_AUTH,
-      },
-    ],
-  }),
-
-  createStatic(ServiceType, {
-    serviceId: 'amadeus.com/service/HotelSearch',
-    name: 'Amadeus Hotel Search',
-    description: 'Search for local and international hotels.',
-    category: 'travel',
-    interfaces: [
-      {
-        kind: 'api',
-        schemaUrl: 'https://api.apis.guru/v2/specs/amadeus.com/amadeus-hotel-search/3.0.8/swagger.json',
-        authorization: AMADEUS_AUTH,
-      },
-    ],
-  }),
-
-  createStatic(ServiceType, {
-    serviceId: 'visualcrossing.com/service/Weather',
-    name: 'Visual Crossing Weather',
-    description: 'Search for global weather forecasts.',
-    category: 'weather',
-    interfaces: [
-      {
-        kind: 'api',
-        schemaUrl: 'https://api.apis.guru/v2/specs/visualcrossing.com/weather/4.6/openapi.json',
-        authorization: VISUAL_CROSSING_CREDENTIALS,
-      },
-    ],
-  }),
-
-  // TODO(burdon): Needs auth.
-  createStatic(ServiceType, {
-    serviceId: 'abstractapi.com/service/GeoLocation',
-    name: 'Abstract GeoLocation',
-    description: 'Get the location of any IP address.',
-    category: 'geolocation',
-    interfaces: [
-      {
-        kind: 'api',
-        schemaUrl: 'https://api.apis.guru/v2/specs/abstractapi.com/geolocation/1.0.0/openapi.json',
-      },
-    ],
-  }),
-
-  //
-  // Testing
-  //
-
-  ...Array.from({ length: 20 }, (_, i) =>
-    createStatic(ServiceType, {
-      serviceId: `example.com/service/test-${i}`,
-      name: `Test ${i}`,
-      description: `Test ${i}`,
-      category: Object.keys(categoryIcons)[Math.floor(Math.random() * Object.keys(categoryIcons).length)],
-      interfaces: [
-        {
-          kind: 'api',
-          schemaUrl: 'https://petstore.swagger.io/v2/swagger.json',
-        },
-      ],
-    }),
-  ),
-] as const;

package/src/tools/function.ts

@@ -1,47 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { defineTool, ToolResult } from '@dxos/artifact';
-import type { Tool } from '@dxos/artifact';
-import { toEffectSchema } from '@dxos/echo-schema';
-import { getInvocationUrl, getUserFunctionUrlInMetadata } from '@dxos/functions';
-import type { FunctionType } from '@dxos/functions';
-import { log } from '@dxos/log';
-import type { SpaceId } from '@dxos/react-client/echo';
-import { getMeta } from '@dxos/react-client/echo';
-
-export const covertFunctionToTool = (
-  fn: FunctionType,
-  edgeUrl: string,
-  spaceId?: SpaceId | undefined,
-): Tool | undefined => {
-  if (!fn.description || !fn.inputSchema) {
-    return undefined;
-  }
-
-  const existingFunctionUrl = getUserFunctionUrlInMetadata(getMeta(fn));
-  if (!existingFunctionUrl) {
-    return undefined;
-  }
-  const url = getInvocationUrl(existingFunctionUrl, edgeUrl, {
-    spaceId,
-  });
-
-  return defineTool({
-    name: fn.name,
-    description: fn.description,
-    schema: toEffectSchema(fn.inputSchema),
-    execute: async (input) => {
-      log.info('execute function tool', { name: fn.name, url, input });
-      const response = await fetch(url, {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-        },
-        body: JSON.stringify(input),
-      });
-      return ToolResult.Success(await response.text());
-    },
-  });
-};

package/src/tools/index.ts

@@ -1,6 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-export * from './function';
-export * from './openapi';