@kortexya/reasoninglayer 1.14.0 → 1.15.0

package/dist/index.cjs

@@ -7,7 +7,7 @@ var __export = (target, all) => {
 };
 
 // src/config.ts
-var SDK_VERSION = "1.14.0";
+var SDK_VERSION = "1.15.0";
 function resolveConfig(config) {
   if (!config.baseUrl) {
     throw new Error("ClientConfig.baseUrl is required");
@@ -1414,9 +1414,10 @@ var Terms = class {
    * @request GET:/api/v1/terms
    * @secure
    */
-  listTerms = (params = {}) => this.http.request({
+  listTerms = (query, params = {}) => this.http.request({
     path: `/api/v1/terms`,
     method: "GET",
+    query,
     secure: true,
     format: "json",
     ...params
@@ -1496,7 +1497,7 @@ var Inference = class {
     ...params
   });
   /**
-   * @description # TRUE HOMOICONIC API Request contains a goal term and optional constraints. Response returns solutions with term-based substitutions. ## Temporal Reasoning Use constraints to filter by temporal relations: ```json { "goal": {"sort_name": "Employment", "features": {"valid_to": {"name": "?EndTime"}}}, "constraints": [{"type": "Guard", "left": "?EndTime", "op": "lt", "right": "1583020800000"}] } ``` # Authorization Requires X-Tenant-Id header.
+   * @description # TRUE HOMOICONIC API Request contains a goal term and optional constraints. Response returns solutions with term-based substitutions. ## Temporal Reasoning Use constraints to filter by temporal relations: ```json { "goal": {"sort_name": "Employment", "features": {"valid_to": {"name": "?EndTime"}}}, "constraints": [{"type": "Guard", "left": "?EndTime", "op": "lt", "right": "1583020800000"}] } ``` # Authorization Requires X-Tenant-Id header. Traced: this is the path the zanzibar gateway hits for every permission check, so it is where an end-to-end trace either explains a slow request or does not. `skip_all` because the request body can be large and has no business in a span attribute.
    *
    * @tags inference
    * @name BackwardChain
@@ -1753,9 +1754,10 @@ var Inference = class {
    * @request GET:/api/v1/inference/facts/{tenant_id}
    * @secure
    */
-  getFacts = (tenantId, params = {}) => this.http.request({
+  getFacts = (tenantId, query, params = {}) => this.http.request({
     path: `/api/v1/inference/facts/${tenantId}`,
     method: "GET",
+    query,
     secure: true,
     format: "json",
     ...params
@@ -2645,7 +2647,7 @@ var Ingestion = class {
     ...params
   });
   /**
-   * @description POST /api/v1/ingest/document This endpoint accepts a document (as base64 or URL) and: 1. Parses it to Markdown using the document parser service (Docling) 2. Processes the Markdown through the existing ingestion pipeline 3. Returns combined statistics from both stages # Headers - `X-Tenant-Id`: Tenant ID for multi-tenancy isolation (required) # Request Body - `document`: Document source (base64 or URL) - `document_type`: Optional type hint (auto-detected if not provided) - `owner_id`: User ID who owns the ingested data - `ocr_config`: Optional OCR/parsing configuration - `ingestion_config`: Optional markdown ingestion configuration # Response - `success`: Whether ingestion completed successfully - `parse_stats`: Statistics from document parsing - `metadata`: Extracted document metadata - `ingestion_stats`: Statistics from markdown ingestion - `pending_review`: Entities that need human review
+   * @description POST /api/v1/ingest/document This endpoint accepts a document (as base64 or URL) and: 1. Parses it to Markdown using the document parser service (Docling) 2. Returns the generated Markdown to the caller 3. Unless `parse_only` is true, processes the Markdown through ingestion 4. Returns combined statistics from the completed stages # Headers - `X-Tenant-Id`: Tenant ID for multi-tenancy isolation (required) # Request Body - `document`: Document source (base64 or URL) - `document_type`: Optional type hint (auto-detected if not provided) - `owner_id`: User ID who owns the ingested data - `ocr_config`: Optional OCR/parsing configuration - `ingestion_config`: Optional markdown ingestion configuration - `parse_only`: Return Markdown without creating sessions or semantic terms # Response - `success`: Whether ingestion completed successfully - `parse_stats`: Statistics from document parsing - `metadata`: Extracted document metadata - `markdown`: Markdown generated by Docling/OCR - `ingestion_stats`: Statistics from markdown ingestion - `pending_review`: Entities that need human review
    *
    * @tags ingestion
    * @name IngestDocument
@@ -2980,6 +2982,22 @@ var StructuredIngestion = class {
     format: "json",
     ...params
   });
+  /**
+   * @description The pre-registration half of #71's mode-discovery surface: a client rendering a "new source" picker learns, at type-selection time, which types registration would accept and which write-path modes each would serve — without constructing a source (postgres, for example, opens a connection pool eagerly). Static per build, so no tenant state is consulted; auth is still required, as for every route under `/api/v1`.
+   *
+   * @tags structured_ingestion
+   * @name ListSourceTypesCatalog
+   * @summary List the source types this build can register, with their mode capabilities.
+   * @request GET:/api/v1/sources/types
+   * @secure
+   */
+  listSourceTypesCatalog = (params = {}) => this.http.request({
+    path: `/api/v1/sources/types`,
+    method: "GET",
+    secure: true,
+    format: "json",
+    ...params
+  });
   /**
    * @description Creates a connector instance from the provided configuration and registers it with the structured ingestion service for subsequent schema discovery and data ingestion.
    *
@@ -21096,6 +21114,7 @@ function RegisterSourceResponseFromApiToFront(dto) {
     sourceId: dto.source_id,
     sourceType: dto.source_type,
     mode: dto.mode,
+    supportedModes: dto.supported_modes,
     message: dto.message
   };
 }
@@ -21118,7 +21137,21 @@ function SourceDetailResponseFromApiToFront(dto) {
     sourceId: dto.source_id,
     sourceType: dto.source_type,
     available: dto.available,
-    mode: dto.mode
+    mode: dto.mode,
+    supportedModes: dto.supported_modes
+  };
+}
+function SourceTypeDtoFromApiToFront(dto) {
+  return {
+    sourceType: dto.source_type,
+    aliases: dto.aliases,
+    available: dto.available,
+    supportedModes: dto.supported_modes
+  };
+}
+function ListSourceTypesResponseFromApiToFront(dto) {
+  return {
+    types: dto.types.map(SourceTypeDtoFromApiToFront)
   };
 }
 function DiscoverSchemaRequestFromFrontToApi(model) {
@@ -21235,17 +21268,21 @@ var SourcesClient = class {
    *
    * @param request - Source registration request. Set `mode` to declare the write-path
    *   intent (`'transpile'` for live SQL views, `'ingest'` to materialize rows as
-   *   Ψ-term facts); omit it to take the capability-grounded default (`transpile` for
-   *   postgres, `ingest` otherwise).
+   *   Ψ-term facts); omit it to take the default, which is `'ingest'` for every
+   *   source type (#71).
    * @returns Registration result. `mode` always carries the **resolved** write-path
-   *   mode, including when the default applied.
-   * @throws {ApiError} If registration fails, or with **422** if `mode` is not one of
-   *   `transpile` / `ingest`.
+   *   mode, including when the default applied; `supportedModes` advertises which
+   *   modes this source's adapter can serve.
+   * @throws {ApiError} If registration fails, with **422** if `mode` is not one of
+   *   `transpile` / `ingest`, or with **422** if `mode: 'transpile'` is requested
+   *   for a source whose adapter cannot execute transpiled SQL (a live view over it
+   *   could never be queried).
    *
    * @remarks
    * Registering with `mode: 'transpile'` makes {@link SourcesClient.ingest} refuse this
    * source with a **409** — materializing a transpiled source would create a second,
-   * divergent namespace over the same rows.
+   * divergent namespace over the same rows. To learn which types accept `transpile`
+   * before registering, call {@link SourcesClient.listSourceTypes}.
    *
    * @example
    * ```typescript
@@ -21257,12 +21294,44 @@ var SourcesClient = class {
    *   mode: 'ingest',
    * });
    * console.log(result.mode); // 'ingest'
+   * console.log(result.supportedModes); // ['ingest', 'transpile']
    * ```
    */
   async register(request) {
     const response = await this.api.registerSource(RegisterSourceRequestFromFrontToApi(request));
     return RegisterSourceResponseFromApiToFront(response.data);
   }
+  /**
+   * List the source types this build can register, with their mode capabilities.
+   *
+   * @returns Every registrable source type, its availability in this build, and the
+   *   write-path modes each would serve — before any source exists.
+   * @throws {ApiError} If the request fails.
+   *
+   * @remarks
+   * Sent to `GET /api/v1/sources/types`. The pre-registration half of #71's
+   * mode-discovery surface: a client rendering a "new source" picker learns, at
+   * type-selection time, which types registration would accept (`available` — a
+   * type behind an uncompiled cargo feature is `false`) and which modes each
+   * would serve (`supportedModes` — always `'ingest'`, plus `'transpile'` only
+   * for the SQL engines). Static per build, so no tenant state is consulted.
+   *
+   * Drive a mode selector from `supportedModes` rather than a hard-coded list of
+   * source types: the set is the adapter's declared capability, so it stays
+   * correct as adapters gain the ability (MySQL and SQLite did in #70).
+   *
+   * @example
+   * ```typescript
+   * const { types } = await client.sources.listSourceTypes();
+   * const postgres = types.find((t) => t.sourceType === 'postgres');
+   * console.log(postgres?.supportedModes); // ['ingest', 'transpile']
+   * console.log(postgres?.aliases); // ['postgresql']
+   * ```
+   */
+  async listSourceTypes() {
+    const response = await this.api.listSourceTypesCatalog();
+    return ListSourceTypesResponseFromApiToFront(response.data);
+  }
   /**
    * List all registered data sources.
    *