@dxos/plugin-search 0.8.4-main.b97322e → 0.8.4-main.bcb3aa67d6

package/src/hooks/useWebSearch.ts

@@ -2,37 +2,44 @@
 // Copyright 2025 DXOS.org
 //
 
-import { useState } from 'react';
+import { useCallback, useState } from 'react';
 
-import { EdgeAiServiceClient } from '@dxos/ai';
-import { AI_SERVICE_ENDPOINT, EXA_API_KEY } from '@dxos/ai/testing';
+import { EXA_API_KEY } from '@dxos/ai/testing';
 import { Obj } from '@dxos/echo';
-import { type DXN } from '@dxos/keys';
 import { log } from '@dxos/log';
 import { getIconAnnotation } from '@dxos/schema';
-import { Testing } from '@dxos/schema/testing';
+import { TestSchema } from '@dxos/schema/testing';
 
-import { getStringProperty } from './sync';
 import { search } from '../search';
-import { type SearchResult } from '../types';
+import { type SearchResult } from '#types';
+
+import { getStringProperty } from './sync';
 
-export const useWebSearch = ({ query, context }: { query?: string; context?: string }) => {
-  const AiService = new EdgeAiServiceClient({
-    endpoint: AI_SERVICE_ENDPOINT.REMOTE,
-  });
+export type UseWebSearchProps = {
+  query?: string;
+  context?: string;
+};
+
+export type UseWebSearch = {
+  update: () => Promise<void>;
+  results: SearchResult[];
+  isLoading: boolean;
+};
 
+/** @deprecated */
+// TODO(burdon): Remove testing deps.
+export const useWebSearch = ({ query, context }: UseWebSearchProps): UseWebSearch => {
   const [results, setResults] = useState<SearchResult[]>([]);
   const [isLoading, setIsLoading] = useState(false);
 
-  const runSearch = async () => {
+  const update = useCallback(async () => {
     try {
       setIsLoading(true);
       log.info('Running web search', { query, context });
       const results = await search({
         query,
         context,
-        schema: [Testing.Project, Testing.Organization, Testing.Contact],
-        AiService,
+        schema: [TestSchema.Person, TestSchema.Project, TestSchema.Organization], // TODO(burdon): ???
         exaApiKey: EXA_API_KEY,
       });
 
@@ -40,7 +47,6 @@ export const useWebSearch = ({ query, context }: { query?: string; context?: str
         const schema = Obj.getSchema(result);
         return {
           id: result.id,
-          objectType: Obj.getTypename(result) as DXN.String | undefined,
           label: getStringProperty(result, ['name', 'title', 'label']),
           snippet: getStringProperty(result, ['description', 'content', 'website', 'email']),
           object: result,
@@ -52,7 +58,7 @@ export const useWebSearch = ({ query, context }: { query?: string; context?: str
     } finally {
       setIsLoading(false);
     }
-  };
+  }, [query, context]);
 
-  return { runSearch, results, isLoading };
+  return { update, results, isLoading };
 };

package/src/meta.ts

@@ -2,16 +2,19 @@
 // Copyright 2023 DXOS.org
 //
 
-import { type PluginMeta } from '@dxos/app-framework';
+import { type Plugin } from '@dxos/app-framework';
+import { trim } from '@dxos/util';
 
-export const SEARCH_PLUGIN = 'dxos.org/plugin/search';
-export const SEARCH_RESULT = `${SEARCH_PLUGIN}/result`;
-
-export const meta: PluginMeta = {
-  id: SEARCH_PLUGIN,
+export const meta: Plugin.Meta = {
+  id: 'org.dxos.plugin.search',
   name: 'Search',
-  description: 'Search ECHO spaces for content.',
+  description: trim`
+    Full-text search engine for finding content across all spaces and object types.
+    Quickly locate documents, tables, and other objects with instant results and relevance ranking.
+  `,
   icon: 'ph--magnifying-glass--regular',
   source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-search',
   tags: ['labs'],
 };
+
+export const SEARCH_RESULT = `${meta.id}.result`;

package/src/operations/definitions.ts

@@ -0,0 +1,17 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Schema from 'effect/Schema';
+
+import { Operation } from '@dxos/operation';
+
+import { meta } from '#meta';
+
+const SEARCH_OPERATION = `${meta.id}.operation`;
+
+export const OpenSearch = Operation.make({
+  meta: { key: `${SEARCH_OPERATION}.open-search`, name: 'Open Search' },
+  input: Schema.Void,
+  output: Schema.Void,
+});

package/src/operations/index.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { OperationHandlerSet } from '@dxos/operation';
+
+export * as SearchOperation from './definitions';
+
+export const SearchOperationHandlerSet = OperationHandlerSet.lazy(() => import('./open-search'));

package/src/operations/open-search.ts

@@ -0,0 +1,25 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { LayoutOperation } from '@dxos/app-toolkit';
+import { Operation } from '@dxos/operation';
+
+import { SEARCH_DIALOG } from '../constants';
+
+import { OpenSearch } from './definitions';
+
+const handler: Operation.WithHandler<typeof OpenSearch> = OpenSearch.pipe(
+  Operation.withHandler(
+    Effect.fnUntraced(function* () {
+      yield* Operation.invoke(LayoutOperation.UpdateDialog, {
+        subject: SEARCH_DIALOG,
+        blockAlign: 'start',
+      });
+    }),
+  ),
+);
+
+export default handler;

package/src/search/exa.test.ts

@@ -5,9 +5,8 @@
 import { describe, test } from 'vitest';
 
 import { EXA_API_KEY } from '@dxos/ai/testing';
-import { todo } from '@dxos/debug';
 import { log } from '@dxos/log';
-import { Testing } from '@dxos/schema/testing';
+import { TestSchema } from '@dxos/schema/testing';
 
 import { search } from './exa';
 
@@ -16,8 +15,7 @@ describe.skip('Search', () => {
     test.skip('contacts', { timeout: 60_000 }, async () => {
       const objects = await search({
         query: 'top executives at google',
-        schema: [Testing.Contact],
-        AiService: null as any, // TODO: Implement AiService
+        schema: [TestSchema.Person],
         exaApiKey: EXA_API_KEY,
       });
 
@@ -27,8 +25,7 @@ describe.skip('Search', () => {
     test.skip('contacts projects and orgs', { timeout: 60_000 }, async () => {
       const objects = await search({
         query: 'top executives at google',
-        schema: [Testing.Contact, Testing.Project, Testing.Organization],
-        AiService: todo(),
+        schema: [TestSchema.Person, TestSchema.Project, TestSchema.Organization],
         exaApiKey: EXA_API_KEY,
       });
 
@@ -38,8 +35,7 @@ describe.skip('Search', () => {
     test('a19z org, projects they invest in and team', { timeout: 60_000 }, async () => {
       const objects = await search({
         query: 'a19z org, projects they invest in and team',
-        schema: [Testing.Project, Testing.Organization, Testing.Contact],
-        AiService: todo(),
+        schema: [TestSchema.Project, TestSchema.Organization, TestSchema.Person],
         exaApiKey: EXA_API_KEY,
       });
 
@@ -49,8 +45,7 @@ describe.skip('Search', () => {
     test('companies building CRDTs', { timeout: 60_000 }, async () => {
       const objects = await search({
         query: 'companies building CRDTs',
-        schema: [Testing.Project, Testing.Organization, Testing.Contact],
-        AiService: todo(),
+        schema: [TestSchema.Project, TestSchema.Organization, TestSchema.Person],
         exaApiKey: EXA_API_KEY,
       });
 
@@ -62,8 +57,7 @@ describe.skip('Search', () => {
     test('composer context-based search', { timeout: 60_000 }, async () => {
       const objects = await search({
         context: COMPOSER_DXOS_DOC,
-        schema: [Testing.Project, Testing.Organization, Testing.Contact],
-        AiService: todo(),
+        schema: [TestSchema.Project, TestSchema.Organization, TestSchema.Person],
         exaApiKey: EXA_API_KEY,
       });
 
@@ -73,8 +67,7 @@ describe.skip('Search', () => {
     test.only('edge architecture', { timeout: 60_000 }, async () => {
       const objects = await search({
         context: EDGE_ARCHITECTURE_DOC,
-        schema: [Testing.Project, Testing.Organization, Testing.Contact],
-        AiService: todo(),
+        schema: [TestSchema.Project, TestSchema.Organization, TestSchema.Person],
         exaApiKey: EXA_API_KEY,
       });
 
@@ -83,9 +76,7 @@ describe.skip('Search', () => {
   });
 });
 
-// TODO(dmaretskyi): Import as txt.
 const COMPOSER_DXOS_DOC = `
-
 ![img](https://dxos.network/dxos-logotype-blue.png)
 # Welcome to Composer by DXOS
 
@@ -93,7 +84,7 @@ const COMPOSER_DXOS_DOC = `
 
 Composer is an extensible application that includes familiar components such as documents, diagrams, and tables. It leverages DXOS — a full stack framework for building collaborative local-first applications.
 
-With our upcoming SDK, you'll be able to build custom plugins, leverage external APIs and integrate with LLMs. All inside of a private collaborative workspace.
+With our SDK, you'll be able to build custom plugins, leverage external APIs and integrate with LLMs. All inside of a private collaborative workspace.
 
 ## Disclaimer
 
@@ -219,6 +210,4 @@ const EDGE_ARCHITECTURE_DOC = `
 - given the fq id of the deployment object, anyone in the space should be able to invoke the function even if they don't have access to the object itself
 
 ### Service Side
-
-
 `;

package/src/search/exa.ts

@@ -2,30 +2,24 @@
 // Copyright 2025 DXOS.org
 //
 
-import { Option, Schema, SchemaAST } from 'effect';
-import Exa from 'exa-js';
+// ISSUE(burdon): deprecated types: MixedStreamParser => effect
 
-import { type AiServiceClient, type GenerateRequest, MixedStreamParser, createTool } from '@dxos/ai';
-import { Key, Obj, Type } from '@dxos/echo';
+import * as Option from 'effect/Option';
+import * as Schema from 'effect/Schema';
+import * as SchemaAST from 'effect/SchemaAST';
+
+import { type Entity, Key, Obj, type Type } from '@dxos/echo';
+import { ReferenceAnnotationId } from '@dxos/echo/internal';
 import { isEncodedReference } from '@dxos/echo-protocol';
-import { ReferenceAnnotationId } from '@dxos/echo-schema';
 import { mapAst } from '@dxos/effect';
-import { assertArgument, failedInvariant } from '@dxos/invariant';
-import { log } from '@dxos/log';
-import { type ContentBlock, DataType } from '@dxos/schema';
 import { deepMapValues, trim } from '@dxos/util';
 
 export type SearchOptions<Schema extends Schema.Schema.AnyNoContext> = {
   query?: string;
-
   // TODO(dmaretskyi): How can we pass this through.
   context?: string;
-
   schema: Schema[];
-
-  AiService: AiServiceClient;
   exaApiKey: string;
-
   liveCrawl?: boolean;
 };
 
@@ -37,94 +31,81 @@ export type SearchResult<T = unknown> = {
   };
 };
 
+/** @deprecated Use MixedStreamParser */
 export const search = async <Schema extends Schema.Schema.AnyNoContext>(
   options: SearchOptions<Schema>,
-): Promise<SearchResult<Schema.Schema.Type<Schema>>> => {
-  assertArgument(options.query || options.context, 'query or context is required');
-
-  let contextSearchTerms: readonly string[] = [];
-  if (options.context) {
-    contextSearchTerms = await getSearchTerms(options.AiService, options.context);
-    log.info('context search terms', { additionalSearchTerms: contextSearchTerms });
-  }
-
-  const mappedSchema = options.schema.map(mapSchemaRefs);
-
-  let startTime = performance.now();
-
-  const exa = new Exa(options.exaApiKey);
-  const context = await exa.searchAndContents(options.query + ' ' + contextSearchTerms.join(' '), {
-    type: 'auto',
-    text: { maxCharacters: 3_000 },
-    livecrawl: options.liveCrawl ? 'always' : undefined,
-  });
-  log.info('context', { context });
-
-  const sourceQueryTime = performance.now() - startTime;
-  startTime = performance.now();
-
-  let systemPrompt = DATA_EXTRACTION_INSTRUCTIONS;
-  if (options.query) {
-    systemPrompt += `\n<query>${options.query}</query>`;
-  }
-  if (options.context) {
-    systemPrompt += `\n<search_context>${options.context}</search_context>`;
-  }
-
-  const result = await getStructuredOutput(options.AiService, {
-    model: '@anthropic/claude-3-5-haiku-20241022',
-    systemPrompt,
-    history: [
-      Obj.make(DataType.Message, {
-        created: new Date().toISOString(),
-        sender: { role: 'user' },
-        blocks: context.results.map(
-          (result): ContentBlock.Text => ({
-            _tag: 'text',
-            text: `# ${result.title}\n\n${result.text}`,
-          }),
-        ),
-      }),
-    ],
-
-    schema: Schema.Struct({
-      ...Object.fromEntries(
-        mappedSchema.map((schema, index) => [
-          `objects_${index}`,
-          Schema.Array(schema).annotations({
-            description: `The objects to answer the query of type ${Type.getTypename(schema) ?? SchemaAST.getIdentifierAnnotation(schema.ast).pipe(Option.getOrNull)}`,
-          }),
-        ]),
-      ),
-    }),
-  });
-
-  const dataExtractionTime = performance.now() - startTime;
-
-  log.info('result', { result });
-
-  const rawObjects = Object.values(result);
-
-  // log('rawObjects', { rawObjects });
-
-  const entries = mappedSchema.flatMap((schema, i) => {
-    return (
-      (rawObjects[i] as any[])?.map((object: any) => ({
-        data: object,
-        schema: options.schema[i],
-      })) ?? []
-    );
-  });
-
-  // log('verified objects', { entries });
-
-  return {
-    data: sanitizeObjects(entries),
-    metrics: {
-      sourceQueryTime,
-      dataExtractionTime,
-    },
-  };
+): Promise<SearchResult<Entity.Unknown>> => {
+  throw new Error('Not implemented');
+  // assertArgument(options.query || options.context, "query or context", "query or context is required");
+  // let contextSearchTerms: readonly string[] = [];
+  // if (options.context) {
+  //   contextSearchTerms = await getSearchTerms(options.AiService, options.context);
+  //   log.info('context search terms', { additionalSearchTerms: contextSearchTerms });
+  // }
+  // const mappedSchema = options.schema.map(mapSchemaRefs);
+  // let startTime = performance.now();
+  // const exa = new Exa(options.exaApiKey);
+  // const context = await exa.searchAndContents(options.query + ' ' + contextSearchTerms.join(' '), {
+  //   type: 'auto',
+  //   text: { maxCharacters: 3_000 },
+  //   livecrawl: options.liveCrawl ? 'always' : undefined,
+  // });
+  // log.info('context', { context });
+  // const sourceQueryTime = performance.now() - startTime;
+  // startTime = performance.now();
+  // let systemPrompt = DATA_EXTRACTION_INSTRUCTIONS;
+  // if (options.query) {
+  //   systemPrompt += `\n<query>${options.query}</query>`;
+  // }
+  // if (options.context) {
+  //   systemPrompt += `\n<search_context>${options.context}</search_context>`;
+  // }
+  // const result = await getStructuredOutput(options.AiService, {
+  //   model: '@anthropic/claude-3-5-haiku-20241022',
+  //   systemPrompt,
+  //   history: [
+  //     Obj.make(Message.Message, {
+  //       created: new Date().toISOString(),
+  //       sender: { role: 'user' },
+  //       blocks: context.results.map(
+  //         (result): ContentBlock.Text => ({
+  //           _tag: 'text',
+  //           text: `# ${result.title}\n\n${result.text}`,
+  //         }),
+  //       ),
+  //     }),
+  //   ],
+  //   schema: Schema.Struct({
+  //     ...Object.fromEntries(
+  //       mappedSchema.map((schema, index) => [
+  //         `objects_${index}`,
+  //         Schema.Array(schema).annotations({
+  //           description: `The objects to answer the query of type ${Type.getTypename(schema) ?? SchemaAST.getIdentifierAnnotation(schema.ast).pipe(Option.getOrNull)}`,
+  //         }),
+  //       ]),
+  //     ),
+  //   }),
+  // });
+  // const dataExtractionTime = performance.now() - startTime;
+  // log.info('result', { result });
+  // const rawObjects = Object.values(result);
+  // // log('rawObjects', { rawObjects });
+  // const entries = mappedSchema.flatMap((schema, i) => {
+  //   return (
+  //     (rawObjects[i] as any[])?.map((object: any) => ({
+  //       data: object,
+  //       schema: options.schema[i],
+  //     })) ?? []
+  //   );
+  // });
+  // // log('verified objects', { entries });
+  // return {
+  //   data: sanitizeObjects(entries),
+  //   metrics: {
+  //     sourceQueryTime,
+  //     dataExtractionTime,
+  //   },
+  // };
 };
 
 const DATA_EXTRACTION_INSTRUCTIONS = trim`
@@ -146,61 +127,61 @@ const DATA_EXTRACTION_INSTRUCTIONS = trim`
 /**
  * Runs the LLM to produce a structured output matching a schema
  */
-const getStructuredOutput = async <S extends Schema.Schema.AnyNoContext>(
-  AiService: AiServiceClient,
-  request: Omit<GenerateRequest, 'tools'> & { schema: S },
-): Promise<Schema.Schema.Type<S>> => {
-  const result = await new MixedStreamParser().parse(
-    await AiService.execStream({
-      ...request,
-      systemPrompt:
-        request.systemPrompt +
-        '\nDo not output anything other then the tool call. Call the submit_result tool with the result.',
-      tools: [
-        createTool('submit_result', {
-          name: 'submit_result',
-          description: 'Submit the result',
-          schema: request.schema,
-          execute: async () => failedInvariant(),
-        }),
-      ],
-    }),
-  );
-  return result[0].blocks.find((c) => c._tag === 'toolCall')?.input as any;
-};
-
-const getSearchTerms = async (AiService: AiServiceClient, context: string) => {
-  const { terms } = await getStructuredOutput(AiService, {
-    model: '@anthropic/claude-3-5-haiku-20241022',
-    systemPrompt: trim`
-      You are a search term extraction agent.
-      Extract the relevant search terms from the context.
-      Return the search terms as an array of strings.
-      Prefer own names of people, companies, and projects, technologies, and other entities.
-    `,
-    history: [
-      Obj.make(DataType.Message, {
-        created: new Date().toISOString(),
-        sender: { role: 'user' },
-        blocks: [
-          {
-            _tag: 'text',
-            text: `# Context to extract search terms from:\n\n${context}`,
-          },
-        ],
-      }),
-    ],
-    schema: Schema.Struct({
-      terms: Schema.Array(Schema.String).annotations({
-        description: 'The search terms to use to find the objects. 0-10 terms.',
-      }),
-    }),
-  });
-
-  return terms;
-};
-
-const sanitizeObjects = (entries: { data: any; schema: Schema.Schema.AnyNoContext }[]) => {
+// const getStructuredOutput = async <S extends Schema.Schema.AnyNoContext>(
+//   AiService: AiServiceClient,
+//   request: Omit<GenerateRequest, 'tools'> & { schema: S },
+// ): Promise<Schema.Schema.Type<S>> => {
+//   const result = await new MixedStreamParser().parse(
+//     await AiService.execStream({
+//       ...request,
+//       systemPrompt:
+//         request.systemPrompt +
+//         '\nDo not output anything other then the tool call. Call the submit_result tool with the result.',
+//       tools: [
+//         createTool('submit_result', {
+//           name: 'submit_result',
+//           description: 'Submit the result',
+//           schema: request.schema,
+//           execute: async () => failedInvariant(),
+//         }),
+//       ],
+//     }),
+//   );
+//   return result[0].blocks.find((c) => c._tag === 'toolCall')?.input as any;
+// };
+
+// const getSearchTerms = async (AiService: AiServiceClient, context: string) => {
+//   const { terms } = await getStructuredOutput(AiService, {
+//     model: '@anthropic/claude-3-5-haiku-20241022',
+//     systemPrompt: trim`
+//       You are a search term extraction agent.
+//       Extract the relevant search terms from the context.
+//       Return the search terms as an array of strings.
+//       Prefer own names of people, companies, and projects, technologies, and other entities.
+//     `,
+//     history: [
+//       Obj.make(Message.Message, {
+//         created: new Date().toISOString(),
+//         sender: { role: 'user' },
+//         blocks: [
+//           {
+//             _tag: 'text',
+//             text: `# Context to extract search terms from:\n\n${context}`,
+//           },
+//         ],
+//       }),
+//     ],
+//     schema: Schema.Struct({
+//       terms: Schema.Array(Schema.String).annotations({
+//         description: 'The search terms to use to find the objects. 0-10 terms.',
+//       }),
+//     }),
+//   });
+
+//   return terms;
+// };
+
+const sanitizeObjects = (entries: { data: any; schema: Type.AnyObj }[]) => {
   const idMap = new Map<string, string>();
 
   return entries

package/src/translations.ts

@@ -3,21 +3,22 @@
 //
 
 import { type Resource } from '@dxos/react-ui';
+import { translations as searchTranslations } from '@dxos/react-ui-search';
 
-import { meta } from './meta';
+import { meta } from '#meta';
 
 export const translations = [
+  ...searchTranslations,
   {
     'en-US': {
       [meta.id]: {
-        'plugin name': 'Search',
-        'search action label': 'Search spaces',
-        'search placeholder': 'Search…',
-        'search dialog title': 'Open',
-        'recently closed heading': 'Recently closed',
-        'pending results message': 'Searching…',
-        'empty results message': 'No matching items in your spaces',
-        'search label': 'Search',
+        'plugin.name': 'Search',
+        'search-action.label': 'Search spaces',
+        'search.placeholder': 'Search…',
+        'search-dialog.title': 'Search',
+        'recently-closed.heading': 'Recently closed',
+        'pending-results.message': 'Searching…',
+        'search.label': 'Search',
       },
     },
   },

package/src/types/command-score.d.ts

@@ -0,0 +1,16 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+declare module 'command-score' {
+  /**
+   * Scores how well a string matches a query using a fuzzy matching algorithm.
+   * Used by cmdk for its built-in filtering.
+   *
+   * @param string - The string to score against.
+   * @param query - The search query.
+   * @returns A score between 0 and 1, where higher values indicate better matches.
+   */
+  function commandScore(string: string, query: string): number;
+  export default commandScore;
+}

package/src/types/index.ts

@@ -2,5 +2,4 @@
 // Copyright 2025 DXOS.org
 //
 
-export * from './action';
 export type * from './search';