@arke-institute/sdk 0.1.2 → 0.1.3

package/dist/query/index.cjs

@@ -248,6 +248,73 @@ var QueryClient = class {
   async health() {
     return this.request("/query/health", { method: "GET" });
   }
+  /**
+   * Direct semantic search against the vector index.
+   *
+   * This bypasses the path query syntax and directly queries Pinecone for
+   * semantically similar entities. Useful for:
+   * - Simple semantic searches without graph traversal
+   * - Scoped searches filtered by source_pi (collection scope)
+   * - Type-filtered semantic searches
+   *
+   * For graph traversal and path-based queries, use `path()` instead.
+   *
+   * @param text - Search query text
+   * @param options - Search options (namespace, filters, top_k)
+   * @returns Matching entities with similarity scores
+   *
+   * @example
+   * ```typescript
+   * // Simple semantic search
+   * const results = await query.semanticSearch('photographers from New York');
+   *
+   * // Scoped to a specific PI (collection)
+   * const scoped = await query.semanticSearch('portraits', {
+   *   filter: { source_pi: '01K75HQQXNTDG7BBP7PS9AWYAN' },
+   *   top_k: 20,
+   * });
+   *
+   * // Filter by type
+   * const people = await query.semanticSearch('artists', {
+   *   filter: { type: 'person' },
+   * });
+   *
+   * // Search across merged entities from multiple source PIs
+   * const merged = await query.semanticSearch('historical documents', {
+   *   filter: { merged_entities_source_pis: ['pi-1', 'pi-2'] },
+   * });
+   * ```
+   */
+  async semanticSearch(text, options = {}) {
+    let pineconeFilter;
+    if (options.filter) {
+      pineconeFilter = {};
+      if (options.filter.type) {
+        const types = Array.isArray(options.filter.type) ? options.filter.type : [options.filter.type];
+        pineconeFilter.type = types.length === 1 ? { $eq: types[0] } : { $in: types };
+      }
+      if (options.filter.source_pi) {
+        const pis = Array.isArray(options.filter.source_pi) ? options.filter.source_pi : [options.filter.source_pi];
+        pineconeFilter.source_pi = pis.length === 1 ? { $eq: pis[0] } : { $in: pis };
+      }
+      if (options.filter.merged_entities_source_pis) {
+        const pis = Array.isArray(options.filter.merged_entities_source_pis) ? options.filter.merged_entities_source_pis : [options.filter.merged_entities_source_pis];
+        pineconeFilter.merged_entities_source_pis = { $in: pis };
+      }
+      if (Object.keys(pineconeFilter).length === 0) {
+        pineconeFilter = void 0;
+      }
+    }
+    return this.request("/query/search/semantic", {
+      method: "POST",
+      body: JSON.stringify({
+        text,
+        namespace: options.namespace,
+        filter: pineconeFilter,
+        top_k: options.top_k
+      })
+    });
+  }
   /**
    * Search for collections by semantic similarity.
    *

package/dist/query/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/query/index.ts","../../src/query/errors.ts","../../src/query/client.ts"],"sourcesContent":["export { QueryClient, type QueryClientConfig } from './client';\nexport { QueryError } from './errors';\nexport type {\n  // Request types\n  LineageFilter,\n  PathQueryOptions,\n  NaturalQueryOptions,\n  // Response types\n  EnrichedContent,\n  Entity,\n  PathStep,\n  QueryResultItem,\n  LineageMetadata,\n  QueryMetadata,\n  QueryResult,\n  TranslationInfo,\n  NaturalQueryResult,\n  TranslateResult,\n  // Parse types\n  ASTNodeType,\n  EntryAST,\n  FilterAST,\n  HopAST,\n  PathAST,\n  ParseResult,\n  ParseError,\n  // Syntax documentation types\n  EntryPointDoc,\n  EdgeTypeDoc,\n  VariableDepthDoc,\n  FilterTypeDoc,\n  ParameterDoc,\n  ExampleDoc,\n  SyntaxDocumentation,\n  // Collection search types\n  CollectionSearchOptions,\n  CollectionSearchResult,\n  CollectionSearchResponse,\n} from './types';\n","/**\n * Error class for query operations\n */\nexport class QueryError extends Error {\n  constructor(\n    message: string,\n    public code: string = 'UNKNOWN_ERROR',\n    public details?: unknown\n  ) {\n    super(message);\n    this.name = 'QueryError';\n  }\n}\n","import { QueryError } from './errors';\nimport type {\n  PathQueryOptions,\n  NaturalQueryOptions,\n  QueryResult,\n  NaturalQueryResult,\n  TranslateResult,\n  ParseResult,\n  ParseError,\n  SyntaxDocumentation,\n  CollectionSearchOptions,\n  CollectionSearchResponse,\n} from './types';\n\n/**\n * Configuration for QueryClient\n */\nexport interface QueryClientConfig {\n  /**\n   * Gateway base URL (e.g., https://gateway.arke.institute).\n   * The client will call /query/* endpoints.\n   */\n  gatewayUrl: string;\n  /**\n   * Optional custom fetch implementation (useful for testing).\n   */\n  fetchImpl?: typeof fetch;\n}\n\ntype JsonBody = Record<string, unknown>;\n\n/**\n * Client for querying the Arke knowledge graph.\n *\n * All query endpoints are public and do not require authentication.\n *\n * @example\n * ```typescript\n * const query = new QueryClient({\n *   gatewayUrl: 'https://gateway.arke.institute',\n * });\n *\n * // Direct path query\n * const results = await query.path('\"alice austen\" -[*]{,4}-> type:person');\n *\n * // Natural language query\n * const nlResults = await query.natural('Find photographers connected to Alice Austen');\n *\n * // Get syntax documentation\n * const syntax = await query.syntax();\n * ```\n */\nexport class QueryClient {\n  private baseUrl: string;\n  private fetchImpl: typeof fetch;\n\n  constructor(config: QueryClientConfig) {\n    this.baseUrl = config.gatewayUrl.replace(/\\/$/, '');\n    this.fetchImpl = config.fetchImpl ?? fetch;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Request helpers\n  // ---------------------------------------------------------------------------\n\n  private buildUrl(path: string, query?: Record<string, string | undefined>) {\n    const url = new URL(`${this.baseUrl}${path}`);\n    if (query) {\n      Object.entries(query).forEach(([key, value]) => {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      });\n    }\n    return url.toString();\n  }\n\n  private async request<T>(\n    path: string,\n    options: RequestInit & {\n      query?: Record<string, string | undefined>;\n    } = {}\n  ): Promise<T> {\n    const url = this.buildUrl(path, options.query);\n    const headers = new Headers({ 'Content-Type': 'application/json' });\n    if (options.headers) {\n      Object.entries(options.headers).forEach(([k, v]) => {\n        if (v !== undefined) headers.set(k, v as string);\n      });\n    }\n\n    const response = await this.fetchImpl(url, { ...options, headers });\n\n    if (response.ok) {\n      const contentType = response.headers.get('content-type') || '';\n      if (contentType.includes('application/json')) {\n        return (await response.json()) as T;\n      }\n      return (await response.text()) as unknown as T;\n    }\n\n    let body: unknown;\n    const text = await response.text();\n    try {\n      body = JSON.parse(text);\n    } catch {\n      body = text;\n    }\n\n    const message =\n      (body as JsonBody)?.error && typeof (body as JsonBody).error === 'string'\n        ? ((body as JsonBody).error as string)\n        : (body as JsonBody)?.message && typeof (body as JsonBody).message === 'string'\n          ? ((body as JsonBody).message as string)\n          : `Request failed with status ${response.status}`;\n\n    throw new QueryError(message, 'HTTP_ERROR', {\n      status: response.status,\n      body,\n    });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Query methods\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Execute a path query against the knowledge graph.\n   *\n   * @param pathQuery - The path query string (e.g., '\"alice austen\" -[*]{,4}-> type:person')\n   * @param options - Query options (k, k_explore, lineage, enrich, etc.)\n   * @returns Query results with entities, paths, and metadata\n   *\n   * @example\n   * ```typescript\n   * // Simple semantic search\n   * const results = await query.path('\"Washington\" type:person');\n   *\n   * // Multi-hop traversal\n   * const results = await query.path('\"alice austen\" -[*]{,4}-> type:person ~ \"photographer\"');\n   *\n   * // With lineage filtering (collection scope)\n   * const results = await query.path('\"letters\" type:document', {\n   *   lineage: { sourcePi: 'arke:my_collection', direction: 'descendants' },\n   *   k: 10,\n   * });\n   * ```\n   */\n  async path(pathQuery: string, options: PathQueryOptions = {}): Promise<QueryResult> {\n    return this.request<QueryResult>('/query/path', {\n      method: 'POST',\n      body: JSON.stringify({\n        path: pathQuery,\n        ...options,\n      }),\n    });\n  }\n\n  /**\n   * Execute a natural language query.\n   *\n   * The query is translated to a path query using an LLM, then executed.\n   *\n   * @param question - Natural language question\n   * @param options - Query options including custom_instructions for the LLM\n   * @returns Query results with translation info\n   *\n   * @example\n   * ```typescript\n   * const results = await query.natural('Find photographers connected to Alice Austen');\n   * console.log('Generated query:', results.translation.path);\n   * console.log('Explanation:', results.translation.explanation);\n   * ```\n   */\n  async natural(question: string, options: NaturalQueryOptions = {}): Promise<NaturalQueryResult> {\n    const { custom_instructions, ...queryOptions } = options;\n    return this.request<NaturalQueryResult>('/query/natural', {\n      method: 'POST',\n      body: JSON.stringify({\n        query: question,\n        custom_instructions,\n        ...queryOptions,\n      }),\n    });\n  }\n\n  /**\n   * Translate a natural language question to a path query without executing it.\n   *\n   * Useful for understanding how questions are translated or for manual execution later.\n   *\n   * @param question - Natural language question\n   * @param customInstructions - Optional additional instructions for the LLM\n   * @returns Translation result with path query and explanation\n   *\n   * @example\n   * ```typescript\n   * const result = await query.translate('Who wrote letters from Philadelphia?');\n   * console.log('Path query:', result.path);\n   * // '\"letters\" <-[authored, wrote]- type:person -[located]-> \"Philadelphia\"'\n   * ```\n   */\n  async translate(question: string, customInstructions?: string): Promise<TranslateResult> {\n    return this.request<TranslateResult>('/query/translate', {\n      method: 'POST',\n      body: JSON.stringify({\n        query: question,\n        custom_instructions: customInstructions,\n      }),\n    });\n  }\n\n  /**\n   * Parse and validate a path query without executing it.\n   *\n   * Returns the AST (Abstract Syntax Tree) if valid, or throws an error.\n   *\n   * @param pathQuery - The path query to parse\n   * @returns Parsed AST\n   * @throws QueryError if the query has syntax errors\n   *\n   * @example\n   * ```typescript\n   * try {\n   *   const result = await query.parse('\"test\" -[*]-> type:person');\n   *   console.log('Valid query, AST:', result.ast);\n   * } catch (err) {\n   *   console.error('Invalid query:', err.message);\n   * }\n   * ```\n   */\n  async parse(pathQuery: string): Promise<ParseResult> {\n    const url = this.buildUrl('/query/parse', { path: pathQuery });\n    const response = await this.fetchImpl(url, {\n      method: 'GET',\n      headers: { 'Content-Type': 'application/json' },\n    });\n\n    const body = await response.json() as ParseResult | ParseError;\n\n    // Check if it's an error response (parse errors return 400)\n    if ('error' in body && body.error === 'Parse error') {\n      throw new QueryError(\n        (body as ParseError).message,\n        'PARSE_ERROR',\n        { position: (body as ParseError).position }\n      );\n    }\n\n    if (!response.ok) {\n      throw new QueryError(\n        (body as any).error || `Request failed with status ${response.status}`,\n        'HTTP_ERROR',\n        { status: response.status, body }\n      );\n    }\n\n    return body as ParseResult;\n  }\n\n  /**\n   * Get the path query syntax documentation.\n   *\n   * Returns comprehensive documentation including entry points, edge traversal,\n   * filters, examples, and constraints.\n   *\n   * @returns Syntax documentation\n   *\n   * @example\n   * ```typescript\n   * const syntax = await query.syntax();\n   *\n   * // List all entry point types\n   * syntax.entryPoints.types.forEach(ep => {\n   *   console.log(`${ep.syntax} - ${ep.description}`);\n   * });\n   *\n   * // Show examples\n   * syntax.examples.forEach(ex => {\n   *   console.log(`${ex.description}: ${ex.query}`);\n   * });\n   * ```\n   */\n  async syntax(): Promise<SyntaxDocumentation> {\n    return this.request<SyntaxDocumentation>('/query/syntax', {\n      method: 'GET',\n    });\n  }\n\n  /**\n   * Check the health of the query service.\n   *\n   * @returns Health status\n   */\n  async health(): Promise<{ status: string; service: string; version: string }> {\n    return this.request('/query/health', { method: 'GET' });\n  }\n\n  /**\n   * Search for collections by semantic similarity.\n   *\n   * Searches the dedicated collections index for fast semantic matching.\n   *\n   * @param query - Search query text\n   * @param options - Search options (limit, visibility filter)\n   * @returns Matching collections with similarity scores\n   *\n   * @example\n   * ```typescript\n   * // Search for photography-related collections\n   * const results = await query.searchCollections('photography');\n   * console.log(results.collections[0].title);\n   *\n   * // Search only public collections\n   * const publicResults = await query.searchCollections('history', {\n   *   visibility: 'public',\n   *   limit: 20,\n   * });\n   * ```\n   */\n  async searchCollections(\n    query: string,\n    options: CollectionSearchOptions = {}\n  ): Promise<CollectionSearchResponse> {\n    return this.request<CollectionSearchResponse>('/query/search/collections', {\n      method: 'GET',\n      query: {\n        q: query,\n        limit: options.limit?.toString(),\n        visibility: options.visibility,\n      },\n    });\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/query/index.ts","../../src/query/errors.ts","../../src/query/client.ts"],"sourcesContent":["export { QueryClient, type QueryClientConfig } from './client';\nexport { QueryError } from './errors';\nexport type {\n  // Request types\n  LineageFilter,\n  PathQueryOptions,\n  NaturalQueryOptions,\n  // Response types\n  EnrichedContent,\n  Entity,\n  PathStep,\n  QueryResultItem,\n  LineageMetadata,\n  QueryMetadata,\n  QueryResult,\n  TranslationInfo,\n  NaturalQueryResult,\n  TranslateResult,\n  // Parse types\n  ASTNodeType,\n  EntryAST,\n  FilterAST,\n  HopAST,\n  PathAST,\n  ParseResult,\n  ParseError,\n  // Syntax documentation types\n  EntryPointDoc,\n  EdgeTypeDoc,\n  VariableDepthDoc,\n  FilterTypeDoc,\n  ParameterDoc,\n  ExampleDoc,\n  SyntaxDocumentation,\n  // Semantic search types\n  SemanticSearchFilter,\n  SemanticSearchOptions,\n  SemanticSearchMetadata,\n  SemanticSearchMatch,\n  SemanticSearchResponse,\n  // Collection search types\n  CollectionSearchOptions,\n  CollectionSearchResult,\n  CollectionSearchResponse,\n} from './types';\n","/**\n * Error class for query operations\n */\nexport class QueryError extends Error {\n  constructor(\n    message: string,\n    public code: string = 'UNKNOWN_ERROR',\n    public details?: unknown\n  ) {\n    super(message);\n    this.name = 'QueryError';\n  }\n}\n","import { QueryError } from './errors';\nimport type {\n  PathQueryOptions,\n  NaturalQueryOptions,\n  QueryResult,\n  NaturalQueryResult,\n  TranslateResult,\n  ParseResult,\n  ParseError,\n  SyntaxDocumentation,\n  SemanticSearchOptions,\n  SemanticSearchResponse,\n  CollectionSearchOptions,\n  CollectionSearchResponse,\n} from './types';\n\n/**\n * Configuration for QueryClient\n */\nexport interface QueryClientConfig {\n  /**\n   * Gateway base URL (e.g., https://gateway.arke.institute).\n   * The client will call /query/* endpoints.\n   */\n  gatewayUrl: string;\n  /**\n   * Optional custom fetch implementation (useful for testing).\n   */\n  fetchImpl?: typeof fetch;\n}\n\ntype JsonBody = Record<string, unknown>;\n\n/**\n * Client for querying the Arke knowledge graph.\n *\n * All query endpoints are public and do not require authentication.\n *\n * @example\n * ```typescript\n * const query = new QueryClient({\n *   gatewayUrl: 'https://gateway.arke.institute',\n * });\n *\n * // Direct path query\n * const results = await query.path('\"alice austen\" -[*]{,4}-> type:person');\n *\n * // Natural language query\n * const nlResults = await query.natural('Find photographers connected to Alice Austen');\n *\n * // Get syntax documentation\n * const syntax = await query.syntax();\n * ```\n */\nexport class QueryClient {\n  private baseUrl: string;\n  private fetchImpl: typeof fetch;\n\n  constructor(config: QueryClientConfig) {\n    this.baseUrl = config.gatewayUrl.replace(/\\/$/, '');\n    this.fetchImpl = config.fetchImpl ?? fetch;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Request helpers\n  // ---------------------------------------------------------------------------\n\n  private buildUrl(path: string, query?: Record<string, string | undefined>) {\n    const url = new URL(`${this.baseUrl}${path}`);\n    if (query) {\n      Object.entries(query).forEach(([key, value]) => {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      });\n    }\n    return url.toString();\n  }\n\n  private async request<T>(\n    path: string,\n    options: RequestInit & {\n      query?: Record<string, string | undefined>;\n    } = {}\n  ): Promise<T> {\n    const url = this.buildUrl(path, options.query);\n    const headers = new Headers({ 'Content-Type': 'application/json' });\n    if (options.headers) {\n      Object.entries(options.headers).forEach(([k, v]) => {\n        if (v !== undefined) headers.set(k, v as string);\n      });\n    }\n\n    const response = await this.fetchImpl(url, { ...options, headers });\n\n    if (response.ok) {\n      const contentType = response.headers.get('content-type') || '';\n      if (contentType.includes('application/json')) {\n        return (await response.json()) as T;\n      }\n      return (await response.text()) as unknown as T;\n    }\n\n    let body: unknown;\n    const text = await response.text();\n    try {\n      body = JSON.parse(text);\n    } catch {\n      body = text;\n    }\n\n    const message =\n      (body as JsonBody)?.error && typeof (body as JsonBody).error === 'string'\n        ? ((body as JsonBody).error as string)\n        : (body as JsonBody)?.message && typeof (body as JsonBody).message === 'string'\n          ? ((body as JsonBody).message as string)\n          : `Request failed with status ${response.status}`;\n\n    throw new QueryError(message, 'HTTP_ERROR', {\n      status: response.status,\n      body,\n    });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Query methods\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Execute a path query against the knowledge graph.\n   *\n   * @param pathQuery - The path query string (e.g., '\"alice austen\" -[*]{,4}-> type:person')\n   * @param options - Query options (k, k_explore, lineage, enrich, etc.)\n   * @returns Query results with entities, paths, and metadata\n   *\n   * @example\n   * ```typescript\n   * // Simple semantic search\n   * const results = await query.path('\"Washington\" type:person');\n   *\n   * // Multi-hop traversal\n   * const results = await query.path('\"alice austen\" -[*]{,4}-> type:person ~ \"photographer\"');\n   *\n   * // With lineage filtering (collection scope)\n   * const results = await query.path('\"letters\" type:document', {\n   *   lineage: { sourcePi: 'arke:my_collection', direction: 'descendants' },\n   *   k: 10,\n   * });\n   * ```\n   */\n  async path(pathQuery: string, options: PathQueryOptions = {}): Promise<QueryResult> {\n    return this.request<QueryResult>('/query/path', {\n      method: 'POST',\n      body: JSON.stringify({\n        path: pathQuery,\n        ...options,\n      }),\n    });\n  }\n\n  /**\n   * Execute a natural language query.\n   *\n   * The query is translated to a path query using an LLM, then executed.\n   *\n   * @param question - Natural language question\n   * @param options - Query options including custom_instructions for the LLM\n   * @returns Query results with translation info\n   *\n   * @example\n   * ```typescript\n   * const results = await query.natural('Find photographers connected to Alice Austen');\n   * console.log('Generated query:', results.translation.path);\n   * console.log('Explanation:', results.translation.explanation);\n   * ```\n   */\n  async natural(question: string, options: NaturalQueryOptions = {}): Promise<NaturalQueryResult> {\n    const { custom_instructions, ...queryOptions } = options;\n    return this.request<NaturalQueryResult>('/query/natural', {\n      method: 'POST',\n      body: JSON.stringify({\n        query: question,\n        custom_instructions,\n        ...queryOptions,\n      }),\n    });\n  }\n\n  /**\n   * Translate a natural language question to a path query without executing it.\n   *\n   * Useful for understanding how questions are translated or for manual execution later.\n   *\n   * @param question - Natural language question\n   * @param customInstructions - Optional additional instructions for the LLM\n   * @returns Translation result with path query and explanation\n   *\n   * @example\n   * ```typescript\n   * const result = await query.translate('Who wrote letters from Philadelphia?');\n   * console.log('Path query:', result.path);\n   * // '\"letters\" <-[authored, wrote]- type:person -[located]-> \"Philadelphia\"'\n   * ```\n   */\n  async translate(question: string, customInstructions?: string): Promise<TranslateResult> {\n    return this.request<TranslateResult>('/query/translate', {\n      method: 'POST',\n      body: JSON.stringify({\n        query: question,\n        custom_instructions: customInstructions,\n      }),\n    });\n  }\n\n  /**\n   * Parse and validate a path query without executing it.\n   *\n   * Returns the AST (Abstract Syntax Tree) if valid, or throws an error.\n   *\n   * @param pathQuery - The path query to parse\n   * @returns Parsed AST\n   * @throws QueryError if the query has syntax errors\n   *\n   * @example\n   * ```typescript\n   * try {\n   *   const result = await query.parse('\"test\" -[*]-> type:person');\n   *   console.log('Valid query, AST:', result.ast);\n   * } catch (err) {\n   *   console.error('Invalid query:', err.message);\n   * }\n   * ```\n   */\n  async parse(pathQuery: string): Promise<ParseResult> {\n    const url = this.buildUrl('/query/parse', { path: pathQuery });\n    const response = await this.fetchImpl(url, {\n      method: 'GET',\n      headers: { 'Content-Type': 'application/json' },\n    });\n\n    const body = await response.json() as ParseResult | ParseError;\n\n    // Check if it's an error response (parse errors return 400)\n    if ('error' in body && body.error === 'Parse error') {\n      throw new QueryError(\n        (body as ParseError).message,\n        'PARSE_ERROR',\n        { position: (body as ParseError).position }\n      );\n    }\n\n    if (!response.ok) {\n      throw new QueryError(\n        (body as any).error || `Request failed with status ${response.status}`,\n        'HTTP_ERROR',\n        { status: response.status, body }\n      );\n    }\n\n    return body as ParseResult;\n  }\n\n  /**\n   * Get the path query syntax documentation.\n   *\n   * Returns comprehensive documentation including entry points, edge traversal,\n   * filters, examples, and constraints.\n   *\n   * @returns Syntax documentation\n   *\n   * @example\n   * ```typescript\n   * const syntax = await query.syntax();\n   *\n   * // List all entry point types\n   * syntax.entryPoints.types.forEach(ep => {\n   *   console.log(`${ep.syntax} - ${ep.description}`);\n   * });\n   *\n   * // Show examples\n   * syntax.examples.forEach(ex => {\n   *   console.log(`${ex.description}: ${ex.query}`);\n   * });\n   * ```\n   */\n  async syntax(): Promise<SyntaxDocumentation> {\n    return this.request<SyntaxDocumentation>('/query/syntax', {\n      method: 'GET',\n    });\n  }\n\n  /**\n   * Check the health of the query service.\n   *\n   * @returns Health status\n   */\n  async health(): Promise<{ status: string; service: string; version: string }> {\n    return this.request('/query/health', { method: 'GET' });\n  }\n\n  /**\n   * Direct semantic search against the vector index.\n   *\n   * This bypasses the path query syntax and directly queries Pinecone for\n   * semantically similar entities. Useful for:\n   * - Simple semantic searches without graph traversal\n   * - Scoped searches filtered by source_pi (collection scope)\n   * - Type-filtered semantic searches\n   *\n   * For graph traversal and path-based queries, use `path()` instead.\n   *\n   * @param text - Search query text\n   * @param options - Search options (namespace, filters, top_k)\n   * @returns Matching entities with similarity scores\n   *\n   * @example\n   * ```typescript\n   * // Simple semantic search\n   * const results = await query.semanticSearch('photographers from New York');\n   *\n   * // Scoped to a specific PI (collection)\n   * const scoped = await query.semanticSearch('portraits', {\n   *   filter: { source_pi: '01K75HQQXNTDG7BBP7PS9AWYAN' },\n   *   top_k: 20,\n   * });\n   *\n   * // Filter by type\n   * const people = await query.semanticSearch('artists', {\n   *   filter: { type: 'person' },\n   * });\n   *\n   * // Search across merged entities from multiple source PIs\n   * const merged = await query.semanticSearch('historical documents', {\n   *   filter: { merged_entities_source_pis: ['pi-1', 'pi-2'] },\n   * });\n   * ```\n   */\n  async semanticSearch(\n    text: string,\n    options: SemanticSearchOptions = {}\n  ): Promise<SemanticSearchResponse> {\n    // Build Pinecone-compatible filter from our typed filter\n    let pineconeFilter: Record<string, unknown> | undefined;\n\n    if (options.filter) {\n      pineconeFilter = {};\n\n      if (options.filter.type) {\n        const types = Array.isArray(options.filter.type)\n          ? options.filter.type\n          : [options.filter.type];\n        pineconeFilter.type = types.length === 1\n          ? { $eq: types[0] }\n          : { $in: types };\n      }\n\n      if (options.filter.source_pi) {\n        const pis = Array.isArray(options.filter.source_pi)\n          ? options.filter.source_pi\n          : [options.filter.source_pi];\n        pineconeFilter.source_pi = pis.length === 1\n          ? { $eq: pis[0] }\n          : { $in: pis };\n      }\n\n      if (options.filter.merged_entities_source_pis) {\n        const pis = Array.isArray(options.filter.merged_entities_source_pis)\n          ? options.filter.merged_entities_source_pis\n          : [options.filter.merged_entities_source_pis];\n        // Use $in for array field matching (any of the provided PIs)\n        pineconeFilter.merged_entities_source_pis = { $in: pis };\n      }\n\n      // If no filters were actually set, clear the object\n      if (Object.keys(pineconeFilter).length === 0) {\n        pineconeFilter = undefined;\n      }\n    }\n\n    return this.request<SemanticSearchResponse>('/query/search/semantic', {\n      method: 'POST',\n      body: JSON.stringify({\n        text,\n        namespace: options.namespace,\n        filter: pineconeFilter,\n        top_k: options.top_k,\n      }),\n    });\n  }\n\n  /**\n   * Search for collections by semantic similarity.\n   *\n   * Searches the dedicated collections index for fast semantic matching.\n   *\n   * @param query - Search query text\n   * @param options - Search options (limit, visibility filter)\n   * @returns Matching collections with similarity scores\n   *\n   * @example\n   * ```typescript\n   * // Search for photography-related collections\n   * const results = await query.searchCollections('photography');\n   * console.log(results.collections[0].title);\n   *\n   * // Search only public collections\n   * const publicResults = await query.searchCollections('history', {\n   *   visibility: 'public',\n   *   limit: 20,\n   * });\n   * ```\n   */\n  async searchCollections(\n    query: string,\n    options: CollectionSearchOptions = {}\n  ): Promise<CollectionSearchResponse> {\n    return this.request<CollectionSearchResponse>('/query/search/collections', {\n      method: 'GET',\n      query: {\n        q: query,\n        limit: options.limit?.toString(),\n        visibility: options.visibility,\n      },\n    });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACGO,IAAM,aAAN,cAAyB,MAAM;AAAA,EACpC,YACE,SACO,OAAe,iBACf,SACP;AACA,UAAM,OAAO;AAHN;AACA;AAGP,SAAK,OAAO;AAAA,EACd;AACF;;;AC0CO,IAAM,cAAN,MAAkB;AAAA,EAIvB,YAAY,QAA2B;AACrC,SAAK,UAAU,OAAO,WAAW,QAAQ,OAAO,EAAE;AAClD,SAAK,YAAY,OAAO,aAAa;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA,EAMQ,SAAS,MAAc,OAA4C;AACzE,UAAM,MAAM,IAAI,IAAI,GAAG,KAAK,OAAO,GAAG,IAAI,EAAE;AAC5C,QAAI,OAAO;AACT,aAAO,QAAQ,KAAK,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AAC9C,YAAI,UAAU,UAAa,UAAU,MAAM;AACzC,cAAI,aAAa,IAAI,KAAK,OAAO,KAAK,CAAC;AAAA,QACzC;AAAA,MACF,CAAC;AAAA,IACH;AACA,WAAO,IAAI,SAAS;AAAA,EACtB;AAAA,EAEA,MAAc,QACZ,MACA,UAEI,CAAC,GACO;AACZ,UAAM,MAAM,KAAK,SAAS,MAAM,QAAQ,KAAK;AAC7C,UAAM,UAAU,IAAI,QAAQ,EAAE,gBAAgB,mBAAmB,CAAC;AAClE,QAAI,QAAQ,SAAS;AACnB,aAAO,QAAQ,QAAQ,OAAO,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM;AAClD,YAAI,MAAM,OAAW,SAAQ,IAAI,GAAG,CAAW;AAAA,MACjD,CAAC;AAAA,IACH;AAEA,UAAM,WAAW,MAAM,KAAK,UAAU,KAAK,EAAE,GAAG,SAAS,QAAQ,CAAC;AAElE,QAAI,SAAS,IAAI;AACf,YAAM,cAAc,SAAS,QAAQ,IAAI,cAAc,KAAK;AAC5D,UAAI,YAAY,SAAS,kBAAkB,GAAG;AAC5C,eAAQ,MAAM,SAAS,KAAK;AAAA,MAC9B;AACA,aAAQ,MAAM,SAAS,KAAK;AAAA,IAC9B;AAEA,QAAI;AACJ,UAAM,OAAO,MAAM,SAAS,KAAK;AACjC,QAAI;AACF,aAAO,KAAK,MAAM,IAAI;AAAA,IACxB,QAAQ;AACN,aAAO;AAAA,IACT;AAEA,UAAM,UACH,MAAmB,SAAS,OAAQ,KAAkB,UAAU,WAC3D,KAAkB,QACnB,MAAmB,WAAW,OAAQ,KAAkB,YAAY,WACjE,KAAkB,UACpB,8BAA8B,SAAS,MAAM;AAErD,UAAM,IAAI,WAAW,SAAS,cAAc;AAAA,MAC1C,QAAQ,SAAS;AAAA,MACjB;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA4BA,MAAM,KAAK,WAAmB,UAA4B,CAAC,GAAyB;AAClF,WAAO,KAAK,QAAqB,eAAe;AAAA,MAC9C,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU;AAAA,QACnB,MAAM;AAAA,QACN,GAAG;AAAA,MACL,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBA,MAAM,QAAQ,UAAkB,UAA+B,CAAC,GAAgC;AAC9F,UAAM,EAAE,qBAAqB,GAAG,aAAa,IAAI;AACjD,WAAO,KAAK,QAA4B,kBAAkB;AAAA,MACxD,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU;AAAA,QACnB,OAAO;AAAA,QACP;AAAA,QACA,GAAG;AAAA,MACL,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBA,MAAM,UAAU,UAAkB,oBAAuD;AACvF,WAAO,KAAK,QAAyB,oBAAoB;AAAA,MACvD,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU;AAAA,QACnB,OAAO;AAAA,QACP,qBAAqB;AAAA,MACvB,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBA,MAAM,MAAM,WAAyC;AACnD,UAAM,MAAM,KAAK,SAAS,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC7D,UAAM,WAAW,MAAM,KAAK,UAAU,KAAK;AAAA,MACzC,QAAQ;AAAA,MACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,IAChD,CAAC;AAED,UAAM,OAAO,MAAM,SAAS,KAAK;AAGjC,QAAI,WAAW,QAAQ,KAAK,UAAU,eAAe;AACnD,YAAM,IAAI;AAAA,QACP,KAAoB;AAAA,QACrB;AAAA,QACA,EAAE,UAAW,KAAoB,SAAS;AAAA,MAC5C;AAAA,IACF;AAEA,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI;AAAA,QACP,KAAa,SAAS,8BAA8B,SAAS,MAAM;AAAA,QACpE;AAAA,QACA,EAAE,QAAQ,SAAS,QAAQ,KAAK;AAAA,MAClC;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBA,MAAM,SAAuC;AAC3C,WAAO,KAAK,QAA6B,iBAAiB;AAAA,MACxD,QAAQ;AAAA,IACV,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,SAAwE;AAC5E,WAAO,KAAK,QAAQ,iBAAiB,EAAE,QAAQ,MAAM,CAAC;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuCA,MAAM,eACJ,MACA,UAAiC,CAAC,GACD;AAEjC,QAAI;AAEJ,QAAI,QAAQ,QAAQ;AAClB,uBAAiB,CAAC;AAElB,UAAI,QAAQ,OAAO,MAAM;AACvB,cAAM,QAAQ,MAAM,QAAQ,QAAQ,OAAO,IAAI,IAC3C,QAAQ,OAAO,OACf,CAAC,QAAQ,OAAO,IAAI;AACxB,uBAAe,OAAO,MAAM,WAAW,IACnC,EAAE,KAAK,MAAM,CAAC,EAAE,IAChB,EAAE,KAAK,MAAM;AAAA,MACnB;AAEA,UAAI,QAAQ,OAAO,WAAW;AAC5B,cAAM,MAAM,MAAM,QAAQ,QAAQ,OAAO,SAAS,IAC9C,QAAQ,OAAO,YACf,CAAC,QAAQ,OAAO,SAAS;AAC7B,uBAAe,YAAY,IAAI,WAAW,IACtC,EAAE,KAAK,IAAI,CAAC,EAAE,IACd,EAAE,KAAK,IAAI;AAAA,MACjB;AAEA,UAAI,QAAQ,OAAO,4BAA4B;AAC7C,cAAM,MAAM,MAAM,QAAQ,QAAQ,OAAO,0BAA0B,IAC/D,QAAQ,OAAO,6BACf,CAAC,QAAQ,OAAO,0BAA0B;AAE9C,uBAAe,6BAA6B,EAAE,KAAK,IAAI;AAAA,MACzD;AAGA,UAAI,OAAO,KAAK,cAAc,EAAE,WAAW,GAAG;AAC5C,yBAAiB;AAAA,MACnB;AAAA,IACF;AAEA,WAAO,KAAK,QAAgC,0BAA0B;AAAA,MACpE,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU;AAAA,QACnB;AAAA,QACA,WAAW,QAAQ;AAAA,QACnB,QAAQ;AAAA,QACR,OAAO,QAAQ;AAAA,MACjB,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAwBA,MAAM,kBACJ,OACA,UAAmC,CAAC,GACD;AACnC,WAAO,KAAK,QAAkC,6BAA6B;AAAA,MACzE,QAAQ;AAAA,MACR,OAAO;AAAA,QACL,GAAG;AAAA,QACH,OAAO,QAAQ,OAAO,SAAS;AAAA,QAC/B,YAAY,QAAQ;AAAA,MACtB;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/query/index.d.cts

@@ -316,6 +316,63 @@ interface SyntaxDocumentation {
     constraints: string[];
     errors: Record<string, string>;
 }
+/**
+ * Filter options for semantic search
+ */
+interface SemanticSearchFilter {
+    /** Filter by entity type(s) */
+    type?: string | string[];
+    /** Filter by source PI(s) - scopes search to entities from specific PIs */
+    source_pi?: string | string[];
+    /** Filter by merged entity source PIs - for searching across collections */
+    merged_entities_source_pis?: string | string[];
+}
+/**
+ * Options for direct semantic search
+ */
+interface SemanticSearchOptions {
+    /** Pinecone namespace to search (default: 'entities') */
+    namespace?: 'entities' | 'collections' | string;
+    /** Filter criteria */
+    filter?: SemanticSearchFilter;
+    /** Maximum number of results (default: 10, max: 100) */
+    top_k?: number;
+}
+/**
+ * Metadata returned with semantic search matches
+ */
+interface SemanticSearchMetadata {
+    /** Entity canonical ID */
+    canonical_id: string;
+    /** Entity label */
+    label: string;
+    /** Entity type */
+    type: string;
+    /** Entity code */
+    code?: string;
+    /** Source PI */
+    source_pi?: string;
+    /** Additional metadata fields */
+    [key: string]: unknown;
+}
+/**
+ * A single match from semantic search
+ */
+interface SemanticSearchMatch {
+    /** Vector ID (usually canonical_id) */
+    id: string;
+    /** Similarity score (0-1, higher is more similar) */
+    score: number;
+    /** Entity metadata */
+    metadata?: SemanticSearchMetadata;
+}
+/**
+ * Response from semantic search
+ */
+interface SemanticSearchResponse {
+    /** Matching entities ordered by similarity */
+    matches: SemanticSearchMatch[];
+}
 /**
  * Options for collection search
  */
@@ -504,6 +561,44 @@ declare class QueryClient {
         service: string;
         version: string;
     }>;
+    /**
+     * Direct semantic search against the vector index.
+     *
+     * This bypasses the path query syntax and directly queries Pinecone for
+     * semantically similar entities. Useful for:
+     * - Simple semantic searches without graph traversal
+     * - Scoped searches filtered by source_pi (collection scope)
+     * - Type-filtered semantic searches
+     *
+     * For graph traversal and path-based queries, use `path()` instead.
+     *
+     * @param text - Search query text
+     * @param options - Search options (namespace, filters, top_k)
+     * @returns Matching entities with similarity scores
+     *
+     * @example
+     * ```typescript
+     * // Simple semantic search
+     * const results = await query.semanticSearch('photographers from New York');
+     *
+     * // Scoped to a specific PI (collection)
+     * const scoped = await query.semanticSearch('portraits', {
+     *   filter: { source_pi: '01K75HQQXNTDG7BBP7PS9AWYAN' },
+     *   top_k: 20,
+     * });
+     *
+     * // Filter by type
+     * const people = await query.semanticSearch('artists', {
+     *   filter: { type: 'person' },
+     * });
+     *
+     * // Search across merged entities from multiple source PIs
+     * const merged = await query.semanticSearch('historical documents', {
+     *   filter: { merged_entities_source_pis: ['pi-1', 'pi-2'] },
+     * });
+     * ```
+     */
+    semanticSearch(text: string, options?: SemanticSearchOptions): Promise<SemanticSearchResponse>;
     /**
      * Search for collections by semantic similarity.
      *
@@ -538,4 +633,4 @@ declare class QueryError extends Error {
     constructor(message: string, code?: string, details?: unknown | undefined);
 }
 
-export { type ASTNodeType, type CollectionSearchOptions, type CollectionSearchResponse, type CollectionSearchResult, type EdgeTypeDoc, type EnrichedContent, type Entity, type EntryAST, type EntryPointDoc, type ExampleDoc, type FilterAST, type FilterTypeDoc, type HopAST, type LineageFilter, type LineageMetadata, type NaturalQueryOptions, type NaturalQueryResult, type ParameterDoc, type ParseError, type ParseResult, type PathAST, type PathQueryOptions, type PathStep, QueryClient, type QueryClientConfig, QueryError, type QueryMetadata, type QueryResult, type QueryResultItem, type SyntaxDocumentation, type TranslateResult, type TranslationInfo, type VariableDepthDoc };
+export { type ASTNodeType, type CollectionSearchOptions, type CollectionSearchResponse, type CollectionSearchResult, type EdgeTypeDoc, type EnrichedContent, type Entity, type EntryAST, type EntryPointDoc, type ExampleDoc, type FilterAST, type FilterTypeDoc, type HopAST, type LineageFilter, type LineageMetadata, type NaturalQueryOptions, type NaturalQueryResult, type ParameterDoc, type ParseError, type ParseResult, type PathAST, type PathQueryOptions, type PathStep, QueryClient, type QueryClientConfig, QueryError, type QueryMetadata, type QueryResult, type QueryResultItem, type SemanticSearchFilter, type SemanticSearchMatch, type SemanticSearchMetadata, type SemanticSearchOptions, type SemanticSearchResponse, type SyntaxDocumentation, type TranslateResult, type TranslationInfo, type VariableDepthDoc };

package/dist/query/index.d.ts

@@ -316,6 +316,63 @@ interface SyntaxDocumentation {
     constraints: string[];
     errors: Record<string, string>;
 }
+/**
+ * Filter options for semantic search
+ */
+interface SemanticSearchFilter {
+    /** Filter by entity type(s) */
+    type?: string | string[];
+    /** Filter by source PI(s) - scopes search to entities from specific PIs */
+    source_pi?: string | string[];
+    /** Filter by merged entity source PIs - for searching across collections */
+    merged_entities_source_pis?: string | string[];
+}
+/**
+ * Options for direct semantic search
+ */
+interface SemanticSearchOptions {
+    /** Pinecone namespace to search (default: 'entities') */
+    namespace?: 'entities' | 'collections' | string;
+    /** Filter criteria */
+    filter?: SemanticSearchFilter;
+    /** Maximum number of results (default: 10, max: 100) */
+    top_k?: number;
+}
+/**
+ * Metadata returned with semantic search matches
+ */
+interface SemanticSearchMetadata {
+    /** Entity canonical ID */
+    canonical_id: string;
+    /** Entity label */
+    label: string;
+    /** Entity type */
+    type: string;
+    /** Entity code */
+    code?: string;
+    /** Source PI */
+    source_pi?: string;
+    /** Additional metadata fields */
+    [key: string]: unknown;
+}
+/**
+ * A single match from semantic search
+ */
+interface SemanticSearchMatch {
+    /** Vector ID (usually canonical_id) */
+    id: string;
+    /** Similarity score (0-1, higher is more similar) */
+    score: number;
+    /** Entity metadata */
+    metadata?: SemanticSearchMetadata;
+}
+/**
+ * Response from semantic search
+ */
+interface SemanticSearchResponse {
+    /** Matching entities ordered by similarity */
+    matches: SemanticSearchMatch[];
+}
 /**
  * Options for collection search
  */
@@ -504,6 +561,44 @@ declare class QueryClient {
         service: string;
         version: string;
     }>;
+    /**
+     * Direct semantic search against the vector index.
+     *
+     * This bypasses the path query syntax and directly queries Pinecone for
+     * semantically similar entities. Useful for:
+     * - Simple semantic searches without graph traversal
+     * - Scoped searches filtered by source_pi (collection scope)
+     * - Type-filtered semantic searches
+     *
+     * For graph traversal and path-based queries, use `path()` instead.
+     *
+     * @param text - Search query text
+     * @param options - Search options (namespace, filters, top_k)
+     * @returns Matching entities with similarity scores
+     *
+     * @example
+     * ```typescript
+     * // Simple semantic search
+     * const results = await query.semanticSearch('photographers from New York');
+     *
+     * // Scoped to a specific PI (collection)
+     * const scoped = await query.semanticSearch('portraits', {
+     *   filter: { source_pi: '01K75HQQXNTDG7BBP7PS9AWYAN' },
+     *   top_k: 20,
+     * });
+     *
+     * // Filter by type
+     * const people = await query.semanticSearch('artists', {
+     *   filter: { type: 'person' },
+     * });
+     *
+     * // Search across merged entities from multiple source PIs
+     * const merged = await query.semanticSearch('historical documents', {
+     *   filter: { merged_entities_source_pis: ['pi-1', 'pi-2'] },
+     * });
+     * ```
+     */
+    semanticSearch(text: string, options?: SemanticSearchOptions): Promise<SemanticSearchResponse>;
     /**
      * Search for collections by semantic similarity.
      *
@@ -538,4 +633,4 @@ declare class QueryError extends Error {
     constructor(message: string, code?: string, details?: unknown | undefined);
 }
 
-export { type ASTNodeType, type CollectionSearchOptions, type CollectionSearchResponse, type CollectionSearchResult, type EdgeTypeDoc, type EnrichedContent, type Entity, type EntryAST, type EntryPointDoc, type ExampleDoc, type FilterAST, type FilterTypeDoc, type HopAST, type LineageFilter, type LineageMetadata, type NaturalQueryOptions, type NaturalQueryResult, type ParameterDoc, type ParseError, type ParseResult, type PathAST, type PathQueryOptions, type PathStep, QueryClient, type QueryClientConfig, QueryError, type QueryMetadata, type QueryResult, type QueryResultItem, type SyntaxDocumentation, type TranslateResult, type TranslationInfo, type VariableDepthDoc };
+export { type ASTNodeType, type CollectionSearchOptions, type CollectionSearchResponse, type CollectionSearchResult, type EdgeTypeDoc, type EnrichedContent, type Entity, type EntryAST, type EntryPointDoc, type ExampleDoc, type FilterAST, type FilterTypeDoc, type HopAST, type LineageFilter, type LineageMetadata, type NaturalQueryOptions, type NaturalQueryResult, type ParameterDoc, type ParseError, type ParseResult, type PathAST, type PathQueryOptions, type PathStep, QueryClient, type QueryClientConfig, QueryError, type QueryMetadata, type QueryResult, type QueryResultItem, type SemanticSearchFilter, type SemanticSearchMatch, type SemanticSearchMetadata, type SemanticSearchOptions, type SemanticSearchResponse, type SyntaxDocumentation, type TranslateResult, type TranslationInfo, type VariableDepthDoc };

package/dist/query/index.js

@@ -221,6 +221,73 @@ var QueryClient = class {
   async health() {
     return this.request("/query/health", { method: "GET" });
   }
+  /**
+   * Direct semantic search against the vector index.
+   *
+   * This bypasses the path query syntax and directly queries Pinecone for
+   * semantically similar entities. Useful for:
+   * - Simple semantic searches without graph traversal
+   * - Scoped searches filtered by source_pi (collection scope)
+   * - Type-filtered semantic searches
+   *
+   * For graph traversal and path-based queries, use `path()` instead.
+   *
+   * @param text - Search query text
+   * @param options - Search options (namespace, filters, top_k)
+   * @returns Matching entities with similarity scores
+   *
+   * @example
+   * ```typescript
+   * // Simple semantic search
+   * const results = await query.semanticSearch('photographers from New York');
+   *
+   * // Scoped to a specific PI (collection)
+   * const scoped = await query.semanticSearch('portraits', {
+   *   filter: { source_pi: '01K75HQQXNTDG7BBP7PS9AWYAN' },
+   *   top_k: 20,
+   * });
+   *
+   * // Filter by type
+   * const people = await query.semanticSearch('artists', {
+   *   filter: { type: 'person' },
+   * });
+   *
+   * // Search across merged entities from multiple source PIs
+   * const merged = await query.semanticSearch('historical documents', {
+   *   filter: { merged_entities_source_pis: ['pi-1', 'pi-2'] },
+   * });
+   * ```
+   */
+  async semanticSearch(text, options = {}) {
+    let pineconeFilter;
+    if (options.filter) {
+      pineconeFilter = {};
+      if (options.filter.type) {
+        const types = Array.isArray(options.filter.type) ? options.filter.type : [options.filter.type];
+        pineconeFilter.type = types.length === 1 ? { $eq: types[0] } : { $in: types };
+      }
+      if (options.filter.source_pi) {
+        const pis = Array.isArray(options.filter.source_pi) ? options.filter.source_pi : [options.filter.source_pi];
+        pineconeFilter.source_pi = pis.length === 1 ? { $eq: pis[0] } : { $in: pis };
+      }
+      if (options.filter.merged_entities_source_pis) {
+        const pis = Array.isArray(options.filter.merged_entities_source_pis) ? options.filter.merged_entities_source_pis : [options.filter.merged_entities_source_pis];
+        pineconeFilter.merged_entities_source_pis = { $in: pis };
+      }
+      if (Object.keys(pineconeFilter).length === 0) {
+        pineconeFilter = void 0;
+      }
+    }
+    return this.request("/query/search/semantic", {
+      method: "POST",
+      body: JSON.stringify({
+        text,
+        namespace: options.namespace,
+        filter: pineconeFilter,
+        top_k: options.top_k
+      })
+    });
+  }
   /**
    * Search for collections by semantic similarity.
    *

package/dist/query/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/query/errors.ts","../../src/query/client.ts"],"sourcesContent":["/**\n * Error class for query operations\n */\nexport class QueryError extends Error {\n  constructor(\n    message: string,\n    public code: string = 'UNKNOWN_ERROR',\n    public details?: unknown\n  ) {\n    super(message);\n    this.name = 'QueryError';\n  }\n}\n","import { QueryError } from './errors';\nimport type {\n  PathQueryOptions,\n  NaturalQueryOptions,\n  QueryResult,\n  NaturalQueryResult,\n  TranslateResult,\n  ParseResult,\n  ParseError,\n  SyntaxDocumentation,\n  CollectionSearchOptions,\n  CollectionSearchResponse,\n} from './types';\n\n/**\n * Configuration for QueryClient\n */\nexport interface QueryClientConfig {\n  /**\n   * Gateway base URL (e.g., https://gateway.arke.institute).\n   * The client will call /query/* endpoints.\n   */\n  gatewayUrl: string;\n  /**\n   * Optional custom fetch implementation (useful for testing).\n   */\n  fetchImpl?: typeof fetch;\n}\n\ntype JsonBody = Record<string, unknown>;\n\n/**\n * Client for querying the Arke knowledge graph.\n *\n * All query endpoints are public and do not require authentication.\n *\n * @example\n * ```typescript\n * const query = new QueryClient({\n *   gatewayUrl: 'https://gateway.arke.institute',\n * });\n *\n * // Direct path query\n * const results = await query.path('\"alice austen\" -[*]{,4}-> type:person');\n *\n * // Natural language query\n * const nlResults = await query.natural('Find photographers connected to Alice Austen');\n *\n * // Get syntax documentation\n * const syntax = await query.syntax();\n * ```\n */\nexport class QueryClient {\n  private baseUrl: string;\n  private fetchImpl: typeof fetch;\n\n  constructor(config: QueryClientConfig) {\n    this.baseUrl = config.gatewayUrl.replace(/\\/$/, '');\n    this.fetchImpl = config.fetchImpl ?? fetch;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Request helpers\n  // ---------------------------------------------------------------------------\n\n  private buildUrl(path: string, query?: Record<string, string | undefined>) {\n    const url = new URL(`${this.baseUrl}${path}`);\n    if (query) {\n      Object.entries(query).forEach(([key, value]) => {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      });\n    }\n    return url.toString();\n  }\n\n  private async request<T>(\n    path: string,\n    options: RequestInit & {\n      query?: Record<string, string | undefined>;\n    } = {}\n  ): Promise<T> {\n    const url = this.buildUrl(path, options.query);\n    const headers = new Headers({ 'Content-Type': 'application/json' });\n    if (options.headers) {\n      Object.entries(options.headers).forEach(([k, v]) => {\n        if (v !== undefined) headers.set(k, v as string);\n      });\n    }\n\n    const response = await this.fetchImpl(url, { ...options, headers });\n\n    if (response.ok) {\n      const contentType = response.headers.get('content-type') || '';\n      if (contentType.includes('application/json')) {\n        return (await response.json()) as T;\n      }\n      return (await response.text()) as unknown as T;\n    }\n\n    let body: unknown;\n    const text = await response.text();\n    try {\n      body = JSON.parse(text);\n    } catch {\n      body = text;\n    }\n\n    const message =\n      (body as JsonBody)?.error && typeof (body as JsonBody).error === 'string'\n        ? ((body as JsonBody).error as string)\n        : (body as JsonBody)?.message && typeof (body as JsonBody).message === 'string'\n          ? ((body as JsonBody).message as string)\n          : `Request failed with status ${response.status}`;\n\n    throw new QueryError(message, 'HTTP_ERROR', {\n      status: response.status,\n      body,\n    });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Query methods\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Execute a path query against the knowledge graph.\n   *\n   * @param pathQuery - The path query string (e.g., '\"alice austen\" -[*]{,4}-> type:person')\n   * @param options - Query options (k, k_explore, lineage, enrich, etc.)\n   * @returns Query results with entities, paths, and metadata\n   *\n   * @example\n   * ```typescript\n   * // Simple semantic search\n   * const results = await query.path('\"Washington\" type:person');\n   *\n   * // Multi-hop traversal\n   * const results = await query.path('\"alice austen\" -[*]{,4}-> type:person ~ \"photographer\"');\n   *\n   * // With lineage filtering (collection scope)\n   * const results = await query.path('\"letters\" type:document', {\n   *   lineage: { sourcePi: 'arke:my_collection', direction: 'descendants' },\n   *   k: 10,\n   * });\n   * ```\n   */\n  async path(pathQuery: string, options: PathQueryOptions = {}): Promise<QueryResult> {\n    return this.request<QueryResult>('/query/path', {\n      method: 'POST',\n      body: JSON.stringify({\n        path: pathQuery,\n        ...options,\n      }),\n    });\n  }\n\n  /**\n   * Execute a natural language query.\n   *\n   * The query is translated to a path query using an LLM, then executed.\n   *\n   * @param question - Natural language question\n   * @param options - Query options including custom_instructions for the LLM\n   * @returns Query results with translation info\n   *\n   * @example\n   * ```typescript\n   * const results = await query.natural('Find photographers connected to Alice Austen');\n   * console.log('Generated query:', results.translation.path);\n   * console.log('Explanation:', results.translation.explanation);\n   * ```\n   */\n  async natural(question: string, options: NaturalQueryOptions = {}): Promise<NaturalQueryResult> {\n    const { custom_instructions, ...queryOptions } = options;\n    return this.request<NaturalQueryResult>('/query/natural', {\n      method: 'POST',\n      body: JSON.stringify({\n        query: question,\n        custom_instructions,\n        ...queryOptions,\n      }),\n    });\n  }\n\n  /**\n   * Translate a natural language question to a path query without executing it.\n   *\n   * Useful for understanding how questions are translated or for manual execution later.\n   *\n   * @param question - Natural language question\n   * @param customInstructions - Optional additional instructions for the LLM\n   * @returns Translation result with path query and explanation\n   *\n   * @example\n   * ```typescript\n   * const result = await query.translate('Who wrote letters from Philadelphia?');\n   * console.log('Path query:', result.path);\n   * // '\"letters\" <-[authored, wrote]- type:person -[located]-> \"Philadelphia\"'\n   * ```\n   */\n  async translate(question: string, customInstructions?: string): Promise<TranslateResult> {\n    return this.request<TranslateResult>('/query/translate', {\n      method: 'POST',\n      body: JSON.stringify({\n        query: question,\n        custom_instructions: customInstructions,\n      }),\n    });\n  }\n\n  /**\n   * Parse and validate a path query without executing it.\n   *\n   * Returns the AST (Abstract Syntax Tree) if valid, or throws an error.\n   *\n   * @param pathQuery - The path query to parse\n   * @returns Parsed AST\n   * @throws QueryError if the query has syntax errors\n   *\n   * @example\n   * ```typescript\n   * try {\n   *   const result = await query.parse('\"test\" -[*]-> type:person');\n   *   console.log('Valid query, AST:', result.ast);\n   * } catch (err) {\n   *   console.error('Invalid query:', err.message);\n   * }\n   * ```\n   */\n  async parse(pathQuery: string): Promise<ParseResult> {\n    const url = this.buildUrl('/query/parse', { path: pathQuery });\n    const response = await this.fetchImpl(url, {\n      method: 'GET',\n      headers: { 'Content-Type': 'application/json' },\n    });\n\n    const body = await response.json() as ParseResult | ParseError;\n\n    // Check if it's an error response (parse errors return 400)\n    if ('error' in body && body.error === 'Parse error') {\n      throw new QueryError(\n        (body as ParseError).message,\n        'PARSE_ERROR',\n        { position: (body as ParseError).position }\n      );\n    }\n\n    if (!response.ok) {\n      throw new QueryError(\n        (body as any).error || `Request failed with status ${response.status}`,\n        'HTTP_ERROR',\n        { status: response.status, body }\n      );\n    }\n\n    return body as ParseResult;\n  }\n\n  /**\n   * Get the path query syntax documentation.\n   *\n   * Returns comprehensive documentation including entry points, edge traversal,\n   * filters, examples, and constraints.\n   *\n   * @returns Syntax documentation\n   *\n   * @example\n   * ```typescript\n   * const syntax = await query.syntax();\n   *\n   * // List all entry point types\n   * syntax.entryPoints.types.forEach(ep => {\n   *   console.log(`${ep.syntax} - ${ep.description}`);\n   * });\n   *\n   * // Show examples\n   * syntax.examples.forEach(ex => {\n   *   console.log(`${ex.description}: ${ex.query}`);\n   * });\n   * ```\n   */\n  async syntax(): Promise<SyntaxDocumentation> {\n    return this.request<SyntaxDocumentation>('/query/syntax', {\n      method: 'GET',\n    });\n  }\n\n  /**\n   * Check the health of the query service.\n   *\n   * @returns Health status\n   */\n  async health(): Promise<{ status: string; service: string; version: string }> {\n    return this.request('/query/health', { method: 'GET' });\n  }\n\n  /**\n   * Search for collections by semantic similarity.\n   *\n   * Searches the dedicated collections index for fast semantic matching.\n   *\n   * @param query - Search query text\n   * @param options - Search options (limit, visibility filter)\n   * @returns Matching collections with similarity scores\n   *\n   * @example\n   * ```typescript\n   * // Search for photography-related collections\n   * const results = await query.searchCollections('photography');\n   * console.log(results.collections[0].title);\n   *\n   * // Search only public collections\n   * const publicResults = await query.searchCollections('history', {\n   *   visibility: 'public',\n   *   limit: 20,\n   * });\n   * ```\n   */\n  async searchCollections(\n    query: string,\n    options: CollectionSearchOptions = {}\n  ): Promise<CollectionSearchResponse> {\n    return this.request<CollectionSearchResponse>('/query/search/collections', {\n      method: 'GET',\n      query: {\n        q: query,\n        limit: options.limit?.toString(),\n        visibility: options.visibility,\n      },\n    });\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/query/errors.ts","../../src/query/client.ts"],"sourcesContent":["/**\n * Error class for query operations\n */\nexport class QueryError extends Error {\n  constructor(\n    message: string,\n    public code: string = 'UNKNOWN_ERROR',\n    public details?: unknown\n  ) {\n    super(message);\n    this.name = 'QueryError';\n  }\n}\n","import { QueryError } from './errors';\nimport type {\n  PathQueryOptions,\n  NaturalQueryOptions,\n  QueryResult,\n  NaturalQueryResult,\n  TranslateResult,\n  ParseResult,\n  ParseError,\n  SyntaxDocumentation,\n  SemanticSearchOptions,\n  SemanticSearchResponse,\n  CollectionSearchOptions,\n  CollectionSearchResponse,\n} from './types';\n\n/**\n * Configuration for QueryClient\n */\nexport interface QueryClientConfig {\n  /**\n   * Gateway base URL (e.g., https://gateway.arke.institute).\n   * The client will call /query/* endpoints.\n   */\n  gatewayUrl: string;\n  /**\n   * Optional custom fetch implementation (useful for testing).\n   */\n  fetchImpl?: typeof fetch;\n}\n\ntype JsonBody = Record<string, unknown>;\n\n/**\n * Client for querying the Arke knowledge graph.\n *\n * All query endpoints are public and do not require authentication.\n *\n * @example\n * ```typescript\n * const query = new QueryClient({\n *   gatewayUrl: 'https://gateway.arke.institute',\n * });\n *\n * // Direct path query\n * const results = await query.path('\"alice austen\" -[*]{,4}-> type:person');\n *\n * // Natural language query\n * const nlResults = await query.natural('Find photographers connected to Alice Austen');\n *\n * // Get syntax documentation\n * const syntax = await query.syntax();\n * ```\n */\nexport class QueryClient {\n  private baseUrl: string;\n  private fetchImpl: typeof fetch;\n\n  constructor(config: QueryClientConfig) {\n    this.baseUrl = config.gatewayUrl.replace(/\\/$/, '');\n    this.fetchImpl = config.fetchImpl ?? fetch;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Request helpers\n  // ---------------------------------------------------------------------------\n\n  private buildUrl(path: string, query?: Record<string, string | undefined>) {\n    const url = new URL(`${this.baseUrl}${path}`);\n    if (query) {\n      Object.entries(query).forEach(([key, value]) => {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      });\n    }\n    return url.toString();\n  }\n\n  private async request<T>(\n    path: string,\n    options: RequestInit & {\n      query?: Record<string, string | undefined>;\n    } = {}\n  ): Promise<T> {\n    const url = this.buildUrl(path, options.query);\n    const headers = new Headers({ 'Content-Type': 'application/json' });\n    if (options.headers) {\n      Object.entries(options.headers).forEach(([k, v]) => {\n        if (v !== undefined) headers.set(k, v as string);\n      });\n    }\n\n    const response = await this.fetchImpl(url, { ...options, headers });\n\n    if (response.ok) {\n      const contentType = response.headers.get('content-type') || '';\n      if (contentType.includes('application/json')) {\n        return (await response.json()) as T;\n      }\n      return (await response.text()) as unknown as T;\n    }\n\n    let body: unknown;\n    const text = await response.text();\n    try {\n      body = JSON.parse(text);\n    } catch {\n      body = text;\n    }\n\n    const message =\n      (body as JsonBody)?.error && typeof (body as JsonBody).error === 'string'\n        ? ((body as JsonBody).error as string)\n        : (body as JsonBody)?.message && typeof (body as JsonBody).message === 'string'\n          ? ((body as JsonBody).message as string)\n          : `Request failed with status ${response.status}`;\n\n    throw new QueryError(message, 'HTTP_ERROR', {\n      status: response.status,\n      body,\n    });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Query methods\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Execute a path query against the knowledge graph.\n   *\n   * @param pathQuery - The path query string (e.g., '\"alice austen\" -[*]{,4}-> type:person')\n   * @param options - Query options (k, k_explore, lineage, enrich, etc.)\n   * @returns Query results with entities, paths, and metadata\n   *\n   * @example\n   * ```typescript\n   * // Simple semantic search\n   * const results = await query.path('\"Washington\" type:person');\n   *\n   * // Multi-hop traversal\n   * const results = await query.path('\"alice austen\" -[*]{,4}-> type:person ~ \"photographer\"');\n   *\n   * // With lineage filtering (collection scope)\n   * const results = await query.path('\"letters\" type:document', {\n   *   lineage: { sourcePi: 'arke:my_collection', direction: 'descendants' },\n   *   k: 10,\n   * });\n   * ```\n   */\n  async path(pathQuery: string, options: PathQueryOptions = {}): Promise<QueryResult> {\n    return this.request<QueryResult>('/query/path', {\n      method: 'POST',\n      body: JSON.stringify({\n        path: pathQuery,\n        ...options,\n      }),\n    });\n  }\n\n  /**\n   * Execute a natural language query.\n   *\n   * The query is translated to a path query using an LLM, then executed.\n   *\n   * @param question - Natural language question\n   * @param options - Query options including custom_instructions for the LLM\n   * @returns Query results with translation info\n   *\n   * @example\n   * ```typescript\n   * const results = await query.natural('Find photographers connected to Alice Austen');\n   * console.log('Generated query:', results.translation.path);\n   * console.log('Explanation:', results.translation.explanation);\n   * ```\n   */\n  async natural(question: string, options: NaturalQueryOptions = {}): Promise<NaturalQueryResult> {\n    const { custom_instructions, ...queryOptions } = options;\n    return this.request<NaturalQueryResult>('/query/natural', {\n      method: 'POST',\n      body: JSON.stringify({\n        query: question,\n        custom_instructions,\n        ...queryOptions,\n      }),\n    });\n  }\n\n  /**\n   * Translate a natural language question to a path query without executing it.\n   *\n   * Useful for understanding how questions are translated or for manual execution later.\n   *\n   * @param question - Natural language question\n   * @param customInstructions - Optional additional instructions for the LLM\n   * @returns Translation result with path query and explanation\n   *\n   * @example\n   * ```typescript\n   * const result = await query.translate('Who wrote letters from Philadelphia?');\n   * console.log('Path query:', result.path);\n   * // '\"letters\" <-[authored, wrote]- type:person -[located]-> \"Philadelphia\"'\n   * ```\n   */\n  async translate(question: string, customInstructions?: string): Promise<TranslateResult> {\n    return this.request<TranslateResult>('/query/translate', {\n      method: 'POST',\n      body: JSON.stringify({\n        query: question,\n        custom_instructions: customInstructions,\n      }),\n    });\n  }\n\n  /**\n   * Parse and validate a path query without executing it.\n   *\n   * Returns the AST (Abstract Syntax Tree) if valid, or throws an error.\n   *\n   * @param pathQuery - The path query to parse\n   * @returns Parsed AST\n   * @throws QueryError if the query has syntax errors\n   *\n   * @example\n   * ```typescript\n   * try {\n   *   const result = await query.parse('\"test\" -[*]-> type:person');\n   *   console.log('Valid query, AST:', result.ast);\n   * } catch (err) {\n   *   console.error('Invalid query:', err.message);\n   * }\n   * ```\n   */\n  async parse(pathQuery: string): Promise<ParseResult> {\n    const url = this.buildUrl('/query/parse', { path: pathQuery });\n    const response = await this.fetchImpl(url, {\n      method: 'GET',\n      headers: { 'Content-Type': 'application/json' },\n    });\n\n    const body = await response.json() as ParseResult | ParseError;\n\n    // Check if it's an error response (parse errors return 400)\n    if ('error' in body && body.error === 'Parse error') {\n      throw new QueryError(\n        (body as ParseError).message,\n        'PARSE_ERROR',\n        { position: (body as ParseError).position }\n      );\n    }\n\n    if (!response.ok) {\n      throw new QueryError(\n        (body as any).error || `Request failed with status ${response.status}`,\n        'HTTP_ERROR',\n        { status: response.status, body }\n      );\n    }\n\n    return body as ParseResult;\n  }\n\n  /**\n   * Get the path query syntax documentation.\n   *\n   * Returns comprehensive documentation including entry points, edge traversal,\n   * filters, examples, and constraints.\n   *\n   * @returns Syntax documentation\n   *\n   * @example\n   * ```typescript\n   * const syntax = await query.syntax();\n   *\n   * // List all entry point types\n   * syntax.entryPoints.types.forEach(ep => {\n   *   console.log(`${ep.syntax} - ${ep.description}`);\n   * });\n   *\n   * // Show examples\n   * syntax.examples.forEach(ex => {\n   *   console.log(`${ex.description}: ${ex.query}`);\n   * });\n   * ```\n   */\n  async syntax(): Promise<SyntaxDocumentation> {\n    return this.request<SyntaxDocumentation>('/query/syntax', {\n      method: 'GET',\n    });\n  }\n\n  /**\n   * Check the health of the query service.\n   *\n   * @returns Health status\n   */\n  async health(): Promise<{ status: string; service: string; version: string }> {\n    return this.request('/query/health', { method: 'GET' });\n  }\n\n  /**\n   * Direct semantic search against the vector index.\n   *\n   * This bypasses the path query syntax and directly queries Pinecone for\n   * semantically similar entities. Useful for:\n   * - Simple semantic searches without graph traversal\n   * - Scoped searches filtered by source_pi (collection scope)\n   * - Type-filtered semantic searches\n   *\n   * For graph traversal and path-based queries, use `path()` instead.\n   *\n   * @param text - Search query text\n   * @param options - Search options (namespace, filters, top_k)\n   * @returns Matching entities with similarity scores\n   *\n   * @example\n   * ```typescript\n   * // Simple semantic search\n   * const results = await query.semanticSearch('photographers from New York');\n   *\n   * // Scoped to a specific PI (collection)\n   * const scoped = await query.semanticSearch('portraits', {\n   *   filter: { source_pi: '01K75HQQXNTDG7BBP7PS9AWYAN' },\n   *   top_k: 20,\n   * });\n   *\n   * // Filter by type\n   * const people = await query.semanticSearch('artists', {\n   *   filter: { type: 'person' },\n   * });\n   *\n   * // Search across merged entities from multiple source PIs\n   * const merged = await query.semanticSearch('historical documents', {\n   *   filter: { merged_entities_source_pis: ['pi-1', 'pi-2'] },\n   * });\n   * ```\n   */\n  async semanticSearch(\n    text: string,\n    options: SemanticSearchOptions = {}\n  ): Promise<SemanticSearchResponse> {\n    // Build Pinecone-compatible filter from our typed filter\n    let pineconeFilter: Record<string, unknown> | undefined;\n\n    if (options.filter) {\n      pineconeFilter = {};\n\n      if (options.filter.type) {\n        const types = Array.isArray(options.filter.type)\n          ? options.filter.type\n          : [options.filter.type];\n        pineconeFilter.type = types.length === 1\n          ? { $eq: types[0] }\n          : { $in: types };\n      }\n\n      if (options.filter.source_pi) {\n        const pis = Array.isArray(options.filter.source_pi)\n          ? options.filter.source_pi\n          : [options.filter.source_pi];\n        pineconeFilter.source_pi = pis.length === 1\n          ? { $eq: pis[0] }\n          : { $in: pis };\n      }\n\n      if (options.filter.merged_entities_source_pis) {\n        const pis = Array.isArray(options.filter.merged_entities_source_pis)\n          ? options.filter.merged_entities_source_pis\n          : [options.filter.merged_entities_source_pis];\n        // Use $in for array field matching (any of the provided PIs)\n        pineconeFilter.merged_entities_source_pis = { $in: pis };\n      }\n\n      // If no filters were actually set, clear the object\n      if (Object.keys(pineconeFilter).length === 0) {\n        pineconeFilter = undefined;\n      }\n    }\n\n    return this.request<SemanticSearchResponse>('/query/search/semantic', {\n      method: 'POST',\n      body: JSON.stringify({\n        text,\n        namespace: options.namespace,\n        filter: pineconeFilter,\n        top_k: options.top_k,\n      }),\n    });\n  }\n\n  /**\n   * Search for collections by semantic similarity.\n   *\n   * Searches the dedicated collections index for fast semantic matching.\n   *\n   * @param query - Search query text\n   * @param options - Search options (limit, visibility filter)\n   * @returns Matching collections with similarity scores\n   *\n   * @example\n   * ```typescript\n   * // Search for photography-related collections\n   * const results = await query.searchCollections('photography');\n   * console.log(results.collections[0].title);\n   *\n   * // Search only public collections\n   * const publicResults = await query.searchCollections('history', {\n   *   visibility: 'public',\n   *   limit: 20,\n   * });\n   * ```\n   */\n  async searchCollections(\n    query: string,\n    options: CollectionSearchOptions = {}\n  ): Promise<CollectionSearchResponse> {\n    return this.request<CollectionSearchResponse>('/query/search/collections', {\n      method: 'GET',\n      query: {\n        q: query,\n        limit: options.limit?.toString(),\n        visibility: options.visibility,\n      },\n    });\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arke-institute/sdk",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "description": "TypeScript SDK for building applications on the Arke platform",
   "main": "dist/index.cjs",