@arke-institute/sdk 0.1.3 → 2.0.0

package/dist/query/index.cjs

@@ -1,356 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/query/index.ts
-var query_exports = {};
-__export(query_exports, {
-  QueryClient: () => QueryClient,
-  QueryError: () => QueryError
-});
-module.exports = __toCommonJS(query_exports);
-
-// src/query/errors.ts
-var QueryError = class extends Error {
-  constructor(message, code = "UNKNOWN_ERROR", details) {
-    super(message);
-    this.code = code;
-    this.details = details;
-    this.name = "QueryError";
-  }
-};
-
-// src/query/client.ts
-var QueryClient = class {
-  constructor(config) {
-    this.baseUrl = config.gatewayUrl.replace(/\/$/, "");
-    this.fetchImpl = config.fetchImpl ?? fetch;
-  }
-  // ---------------------------------------------------------------------------
-  // Request helpers
-  // ---------------------------------------------------------------------------
-  buildUrl(path, query) {
-    const url = new URL(`${this.baseUrl}${path}`);
-    if (query) {
-      Object.entries(query).forEach(([key, value]) => {
-        if (value !== void 0 && value !== null) {
-          url.searchParams.set(key, String(value));
-        }
-      });
-    }
-    return url.toString();
-  }
-  async request(path, options = {}) {
-    const url = this.buildUrl(path, options.query);
-    const headers = new Headers({ "Content-Type": "application/json" });
-    if (options.headers) {
-      Object.entries(options.headers).forEach(([k, v]) => {
-        if (v !== void 0) headers.set(k, v);
-      });
-    }
-    const response = await this.fetchImpl(url, { ...options, headers });
-    if (response.ok) {
-      const contentType = response.headers.get("content-type") || "";
-      if (contentType.includes("application/json")) {
-        return await response.json();
-      }
-      return await response.text();
-    }
-    let body;
-    const text = await response.text();
-    try {
-      body = JSON.parse(text);
-    } catch {
-      body = text;
-    }
-    const message = body?.error && typeof body.error === "string" ? body.error : body?.message && typeof body.message === "string" ? body.message : `Request failed with status ${response.status}`;
-    throw new QueryError(message, "HTTP_ERROR", {
-      status: response.status,
-      body
-    });
-  }
-  // ---------------------------------------------------------------------------
-  // Query methods
-  // ---------------------------------------------------------------------------
-  /**
-   * Execute a path query against the knowledge graph.
-   *
-   * @param pathQuery - The path query string (e.g., '"alice austen" -[*]{,4}-> type:person')
-   * @param options - Query options (k, k_explore, lineage, enrich, etc.)
-   * @returns Query results with entities, paths, and metadata
-   *
-   * @example
-   * ```typescript
-   * // Simple semantic search
-   * const results = await query.path('"Washington" type:person');
-   *
-   * // Multi-hop traversal
-   * const results = await query.path('"alice austen" -[*]{,4}-> type:person ~ "photographer"');
-   *
-   * // With lineage filtering (collection scope)
-   * const results = await query.path('"letters" type:document', {
-   *   lineage: { sourcePi: 'arke:my_collection', direction: 'descendants' },
-   *   k: 10,
-   * });
-   * ```
-   */
-  async path(pathQuery, options = {}) {
-    return this.request("/query/path", {
-      method: "POST",
-      body: JSON.stringify({
-        path: pathQuery,
-        ...options
-      })
-    });
-  }
-  /**
-   * Execute a natural language query.
-   *
-   * The query is translated to a path query using an LLM, then executed.
-   *
-   * @param question - Natural language question
-   * @param options - Query options including custom_instructions for the LLM
-   * @returns Query results with translation info
-   *
-   * @example
-   * ```typescript
-   * const results = await query.natural('Find photographers connected to Alice Austen');
-   * console.log('Generated query:', results.translation.path);
-   * console.log('Explanation:', results.translation.explanation);
-   * ```
-   */
-  async natural(question, options = {}) {
-    const { custom_instructions, ...queryOptions } = options;
-    return this.request("/query/natural", {
-      method: "POST",
-      body: JSON.stringify({
-        query: question,
-        custom_instructions,
-        ...queryOptions
-      })
-    });
-  }
-  /**
-   * Translate a natural language question to a path query without executing it.
-   *
-   * Useful for understanding how questions are translated or for manual execution later.
-   *
-   * @param question - Natural language question
-   * @param customInstructions - Optional additional instructions for the LLM
-   * @returns Translation result with path query and explanation
-   *
-   * @example
-   * ```typescript
-   * const result = await query.translate('Who wrote letters from Philadelphia?');
-   * console.log('Path query:', result.path);
-   * // '"letters" <-[authored, wrote]- type:person -[located]-> "Philadelphia"'
-   * ```
-   */
-  async translate(question, customInstructions) {
-    return this.request("/query/translate", {
-      method: "POST",
-      body: JSON.stringify({
-        query: question,
-        custom_instructions: customInstructions
-      })
-    });
-  }
-  /**
-   * Parse and validate a path query without executing it.
-   *
-   * Returns the AST (Abstract Syntax Tree) if valid, or throws an error.
-   *
-   * @param pathQuery - The path query to parse
-   * @returns Parsed AST
-   * @throws QueryError if the query has syntax errors
-   *
-   * @example
-   * ```typescript
-   * try {
-   *   const result = await query.parse('"test" -[*]-> type:person');
-   *   console.log('Valid query, AST:', result.ast);
-   * } catch (err) {
-   *   console.error('Invalid query:', err.message);
-   * }
-   * ```
-   */
-  async parse(pathQuery) {
-    const url = this.buildUrl("/query/parse", { path: pathQuery });
-    const response = await this.fetchImpl(url, {
-      method: "GET",
-      headers: { "Content-Type": "application/json" }
-    });
-    const body = await response.json();
-    if ("error" in body && body.error === "Parse error") {
-      throw new QueryError(
-        body.message,
-        "PARSE_ERROR",
-        { position: body.position }
-      );
-    }
-    if (!response.ok) {
-      throw new QueryError(
-        body.error || `Request failed with status ${response.status}`,
-        "HTTP_ERROR",
-        { status: response.status, body }
-      );
-    }
-    return body;
-  }
-  /**
-   * Get the path query syntax documentation.
-   *
-   * Returns comprehensive documentation including entry points, edge traversal,
-   * filters, examples, and constraints.
-   *
-   * @returns Syntax documentation
-   *
-   * @example
-   * ```typescript
-   * const syntax = await query.syntax();
-   *
-   * // List all entry point types
-   * syntax.entryPoints.types.forEach(ep => {
-   *   console.log(`${ep.syntax} - ${ep.description}`);
-   * });
-   *
-   * // Show examples
-   * syntax.examples.forEach(ex => {
-   *   console.log(`${ex.description}: ${ex.query}`);
-   * });
-   * ```
-   */
-  async syntax() {
-    return this.request("/query/syntax", {
-      method: "GET"
-    });
-  }
-  /**
-   * Check the health of the query service.
-   *
-   * @returns Health status
-   */
-  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.
-   *
-   * Searches the dedicated collections index for fast semantic matching.
-   *
-   * @param query - Search query text
-   * @param options - Search options (limit, visibility filter)
-   * @returns Matching collections with similarity scores
-   *
-   * @example
-   * ```typescript
-   * // Search for photography-related collections
-   * const results = await query.searchCollections('photography');
-   * console.log(results.collections[0].title);
-   *
-   * // Search only public collections
-   * const publicResults = await query.searchCollections('history', {
-   *   visibility: 'public',
-   *   limit: 20,
-   * });
-   * ```
-   */
-  async searchCollections(query, options = {}) {
-    return this.request("/query/search/collections", {
-      method: "GET",
-      query: {
-        q: query,
-        limit: options.limit?.toString(),
-        visibility: options.visibility
-      }
-    });
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  QueryClient,
-  QueryError
-});
-//# sourceMappingURL=index.cjs.map

package/dist/query/index.cjs.map

@@ -1 +0,0 @@
-{"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":[]}