@kortexya/reasoninglayer 1.21.0 → 1.22.0

package/dist/index.d.cts

@@ -109,7 +109,7 @@ type JsonValue$1 = string | number | boolean | null | JsonValue$1[] | object;
  * This is the single source of truth for the version constant.
  * The `scripts/release.sh` script updates this value alongside `package.json`.
  */
-declare const SDK_VERSION = "1.21.0";
+declare const SDK_VERSION = "1.22.0";
 /**
  * Authentication mode for the SDK.
  *
@@ -13478,6 +13478,12 @@ interface IngestDocumentRequest$1 {
 }
 /** Response from document ingestion */
 interface IngestDocumentResponse$1 {
+    /**
+     * Document ID within the session — the handle that session progress and
+     * corpus reads key on. Clients previously had to recover it from listings.
+     * @format uuid
+     */
+    document_id?: string | null;
     /** Error message if parsing failed */
     error?: string | null;
     /** Markdown ingestion statistics (from the markdown pipeline) */
@@ -24894,6 +24900,14 @@ interface StructuredIngestionStatsDto$1 {
      * @min 0
      */
     entities_extracted: number;
+    /**
+     * Number of records the source reported as available for the ingested
+     * tables, before any cap or collapse (#177). Compared with
+     * `records_processed`, a cap hit is visible; compared with `terms_created`,
+     * a partial ingest is visible.
+     * @min 0
+     */
+    records_available: number;
     /**
      * Number of source records processed
      * @min 0
@@ -24909,6 +24923,14 @@ interface StructuredIngestionStatsDto$1 {
      * @min 0
      */
     relations_discovered: number;
+    /**
+     * Number of rows that collapsed onto a key value another row already
+     * produced in the same run — the bound-key upsert merged them into one
+     * term (#177). Zero when the bound key identifies rows uniquely. Named in
+     * `warnings` when non-zero.
+     * @min 0
+     */
+    rows_collapsed: number;
     /**
      * Number of sorts created (from pipeline)
      * @min 0
@@ -41630,7 +41652,10 @@ declare class Ingestion<SecurityDataType = unknown> {
      * @request POST:/api/v1/ingest/document
      * @secure
      */
-    ingestDocument: (data: IngestDocumentRequest$1, params?: RequestParams) => Promise<HttpResponse<IngestDocumentResponse$1, void>>;
+    ingestDocument: (data: IngestDocumentRequest$1, query?: {
+        /** When true or absent, process synchronously (legacy behavior, returns 201 with full stats). When false, return 202 after parsing and ingest in the background — poll the session endpoints. */
+        sync?: boolean;
+    }, params?: RequestParams) => Promise<HttpResponse<IngestDocumentResponse$1, void>>;
     /**
      * @description POST /api/v1/ingest/document/batch This endpoint accepts multiple documents and processes them sequentially, sharing deduplication context across documents. # Headers - `X-Tenant-Id`: Tenant ID for multi-tenancy isolation (required)
      *
@@ -41660,10 +41685,10 @@ declare class Ingestion<SecurityDataType = unknown> {
      * @request POST:/api/v1/ingest/markdown
      * @secure
      */
-    ingestMarkdown: (query: {
+    ingestMarkdown: (data: IngestMarkdownRequest$1, query?: {
         /** When true, process synchronously (returns 201). When false/absent, process asynchronously (returns 202). */
-        sync: boolean;
-    }, data: IngestMarkdownRequest$1, params?: RequestParams) => Promise<HttpResponse<void, void>>;
+        sync?: boolean;
+    }, params?: RequestParams) => Promise<HttpResponse<void, void>>;
     /**
      * @description POST /api/v1/ingest/markdown/batch This endpoint accepts multiple markdown documents and enqueues them for background processing. Each document is processed independently by background workers, tracked under a single session. When a task queue is available (default), returns 202 Accepted immediately. Falls back to synchronous processing (201 Created) only when no queue is configured. # Headers - `X-Tenant-Id`: Tenant ID for multi-tenancy isolation (required) # Request Body - `documents`: List of markdown documents with IDs and content - `owner_id`: User ID who owns the ingested data - `config`: Optional configuration overrides # Response - Async (202): Session ID + document IDs for tracking - Sync fallback (201): Full ingestion result with stats
      *
@@ -41683,10 +41708,10 @@ declare class Ingestion<SecurityDataType = unknown> {
      * @request POST:/api/v1/ingest/rdf
      * @secure
      */
-    ingestRdf: (query: {
+    ingestRdf: (data: IngestRdfRequest$1, query?: {
         /** When true, run synchronously (returns 201). Default false: returns 202 with a session id. */
-        sync: boolean;
-    }, data: IngestRdfRequest$1, params?: RequestParams) => Promise<HttpResponse<IngestRdfResponse$1, void>>;
+        sync?: boolean;
+    }, params?: RequestParams) => Promise<HttpResponse<IngestRdfResponse$1, void>>;
     /**
      * @description The read-only mirror of `POST /api/v1/sparql/translate`. Runs the exact same conversion the ingest pipeline runs (`parse_rdf_with_prefixes` → `convert_rdf_to_terms`), renders each produced term as text, and returns it. No term, sort, or `@prefix` is persisted: the sort-name and prefix resolution both run against owned copies of the tenant's hierarchy state, never the shared hierarchy itself.
      *
@@ -57765,6 +57790,21 @@ interface SourceExcerptDto$1 {
     /** Source document, if applicable. */
     sourceDocument?: string | null;
 }
+/**
+ * A sort from the tenant's catalog that a claim names.
+ *
+ * @remarks
+ * The schema counterpart of {@link SourceExcerptDto}: it carries no `termId`,
+ * because there is no record to point at. An answer *about* the knowledge base
+ * — "what sorts exist here" — is built from the sort catalog, runs no query and
+ * produces no binding, so this is the only evidence it can carry.
+ */
+interface SchemaExcerptDto {
+    /** The sort as the tenant's lattice names it. */
+    sortName: string;
+    /** The features the sort declares. */
+    featureNames?: string[];
+}
 /**
  * A claim annotation with provenance information.
  */
@@ -57773,7 +57813,13 @@ interface ClaimAnnotationDto {
     text: string;
     /** Character offsets (start, end) in the assistant_message. */
     span: unknown[];
-    /** Claim classification: "kb_grounded", "derived", "llm_framing", "proven", "contradicted". */
+    /**
+     * Claim classification: "kb_grounded", "schema_grounded", "derived",
+     * "llm_framing", "proven", "contradicted".
+     *
+     * `schema_grounded` is backed by the tenant's sort catalog rather than by
+     * records — see {@link ClaimAnnotationDto.schemaExcerpts}.
+     */
     claimType: string;
     /** Confidence score (0.0-1.0). */
     confidence: number;
@@ -57781,6 +57827,11 @@ interface ClaimAnnotationDto {
     sourceTermIds?: string[];
     /** Source data excerpts from the KB. */
     sourceExcerpts?: SourceExcerptDto$1[];
+    /**
+     * Sorts from the tenant's catalog that this claim names — the evidence for a
+     * `schema_grounded` claim, and additional context on any other.
+     */
+    schemaExcerpts?: SchemaExcerptDto[];
     /** OSFQL query that produced the grounding data. */
     osfqlQuery?: string | null;
     /** Derivation chain summary. */
@@ -58109,10 +58160,11 @@ type conversation_ReasoningTraceDto = ReasoningTraceDto;
 type conversation_RecordTurnRequest = RecordTurnRequest;
 type conversation_RecordTurnResponse = RecordTurnResponse;
 type conversation_ResolvedCoreferenceDto = ResolvedCoreferenceDto;
+type conversation_SchemaExcerptDto = SchemaExcerptDto;
 type conversation_SessionGraphDto = SessionGraphDto;
 type conversation_TurnDto = TurnDto;
 declare namespace conversation {
-  export type { conversation_ClaimAnnotationDto as ClaimAnnotationDto, conversation_CognitiveStrategyDto as CognitiveStrategyDto, conversation_CompareModelDto as CompareModelDto, conversation_ConversationMessageRequest as ConversationMessageRequest, conversation_ConversationMessageResponse as ConversationMessageResponse, conversation_ConversationSummaryDto as ConversationSummaryDto, conversation_ConversationTurnsResponse as ConversationTurnsResponse, conversation_DerivationSummaryDto as DerivationSummaryDto, conversation_FocusEntryDto as FocusEntryDto, conversation_ListConversationsResponse as ListConversationsResponse, conversation_MatchedEntityDto as MatchedEntityDto, conversation_ProofTraceNodeDto as ProofTraceNodeDto, conversation_ReasoningStageDto as ReasoningStageDto, conversation_ReasoningTraceDto as ReasoningTraceDto, conversation_RecordTurnRequest as RecordTurnRequest, conversation_RecordTurnResponse as RecordTurnResponse, conversation_ResolvedCoreferenceDto as ResolvedCoreferenceDto, conversation_SessionGraphDto as SessionGraphDto, SourceExcerptDto$1 as SourceExcerptDto, conversation_TurnDto as TurnDto, UICustomizationDto$1 as UICustomizationDto };
+  export type { conversation_ClaimAnnotationDto as ClaimAnnotationDto, conversation_CognitiveStrategyDto as CognitiveStrategyDto, conversation_CompareModelDto as CompareModelDto, conversation_ConversationMessageRequest as ConversationMessageRequest, conversation_ConversationMessageResponse as ConversationMessageResponse, conversation_ConversationSummaryDto as ConversationSummaryDto, conversation_ConversationTurnsResponse as ConversationTurnsResponse, conversation_DerivationSummaryDto as DerivationSummaryDto, conversation_FocusEntryDto as FocusEntryDto, conversation_ListConversationsResponse as ListConversationsResponse, conversation_MatchedEntityDto as MatchedEntityDto, conversation_ProofTraceNodeDto as ProofTraceNodeDto, conversation_ReasoningStageDto as ReasoningStageDto, conversation_ReasoningTraceDto as ReasoningTraceDto, conversation_RecordTurnRequest as RecordTurnRequest, conversation_RecordTurnResponse as RecordTurnResponse, conversation_ResolvedCoreferenceDto as ResolvedCoreferenceDto, conversation_SchemaExcerptDto as SchemaExcerptDto, conversation_SessionGraphDto as SessionGraphDto, SourceExcerptDto$1 as SourceExcerptDto, conversation_TurnDto as TurnDto, UICustomizationDto$1 as UICustomizationDto };
 }
 
 /**

package/dist/index.d.ts

@@ -109,7 +109,7 @@ type JsonValue$1 = string | number | boolean | null | JsonValue$1[] | object;
  * This is the single source of truth for the version constant.
  * The `scripts/release.sh` script updates this value alongside `package.json`.
  */
-declare const SDK_VERSION = "1.21.0";
+declare const SDK_VERSION = "1.22.0";
 /**
  * Authentication mode for the SDK.
  *
@@ -13478,6 +13478,12 @@ interface IngestDocumentRequest$1 {
 }
 /** Response from document ingestion */
 interface IngestDocumentResponse$1 {
+    /**
+     * Document ID within the session — the handle that session progress and
+     * corpus reads key on. Clients previously had to recover it from listings.
+     * @format uuid
+     */
+    document_id?: string | null;
     /** Error message if parsing failed */
     error?: string | null;
     /** Markdown ingestion statistics (from the markdown pipeline) */
@@ -24894,6 +24900,14 @@ interface StructuredIngestionStatsDto$1 {
      * @min 0
      */
     entities_extracted: number;
+    /**
+     * Number of records the source reported as available for the ingested
+     * tables, before any cap or collapse (#177). Compared with
+     * `records_processed`, a cap hit is visible; compared with `terms_created`,
+     * a partial ingest is visible.
+     * @min 0
+     */
+    records_available: number;
     /**
      * Number of source records processed
      * @min 0
@@ -24909,6 +24923,14 @@ interface StructuredIngestionStatsDto$1 {
      * @min 0
      */
     relations_discovered: number;
+    /**
+     * Number of rows that collapsed onto a key value another row already
+     * produced in the same run — the bound-key upsert merged them into one
+     * term (#177). Zero when the bound key identifies rows uniquely. Named in
+     * `warnings` when non-zero.
+     * @min 0
+     */
+    rows_collapsed: number;
     /**
      * Number of sorts created (from pipeline)
      * @min 0
@@ -41630,7 +41652,10 @@ declare class Ingestion<SecurityDataType = unknown> {
      * @request POST:/api/v1/ingest/document
      * @secure
      */
-    ingestDocument: (data: IngestDocumentRequest$1, params?: RequestParams) => Promise<HttpResponse<IngestDocumentResponse$1, void>>;
+    ingestDocument: (data: IngestDocumentRequest$1, query?: {
+        /** When true or absent, process synchronously (legacy behavior, returns 201 with full stats). When false, return 202 after parsing and ingest in the background — poll the session endpoints. */
+        sync?: boolean;
+    }, params?: RequestParams) => Promise<HttpResponse<IngestDocumentResponse$1, void>>;
     /**
      * @description POST /api/v1/ingest/document/batch This endpoint accepts multiple documents and processes them sequentially, sharing deduplication context across documents. # Headers - `X-Tenant-Id`: Tenant ID for multi-tenancy isolation (required)
      *
@@ -41660,10 +41685,10 @@ declare class Ingestion<SecurityDataType = unknown> {
      * @request POST:/api/v1/ingest/markdown
      * @secure
      */
-    ingestMarkdown: (query: {
+    ingestMarkdown: (data: IngestMarkdownRequest$1, query?: {
         /** When true, process synchronously (returns 201). When false/absent, process asynchronously (returns 202). */
-        sync: boolean;
-    }, data: IngestMarkdownRequest$1, params?: RequestParams) => Promise<HttpResponse<void, void>>;
+        sync?: boolean;
+    }, params?: RequestParams) => Promise<HttpResponse<void, void>>;
     /**
      * @description POST /api/v1/ingest/markdown/batch This endpoint accepts multiple markdown documents and enqueues them for background processing. Each document is processed independently by background workers, tracked under a single session. When a task queue is available (default), returns 202 Accepted immediately. Falls back to synchronous processing (201 Created) only when no queue is configured. # Headers - `X-Tenant-Id`: Tenant ID for multi-tenancy isolation (required) # Request Body - `documents`: List of markdown documents with IDs and content - `owner_id`: User ID who owns the ingested data - `config`: Optional configuration overrides # Response - Async (202): Session ID + document IDs for tracking - Sync fallback (201): Full ingestion result with stats
      *
@@ -41683,10 +41708,10 @@ declare class Ingestion<SecurityDataType = unknown> {
      * @request POST:/api/v1/ingest/rdf
      * @secure
      */
-    ingestRdf: (query: {
+    ingestRdf: (data: IngestRdfRequest$1, query?: {
         /** When true, run synchronously (returns 201). Default false: returns 202 with a session id. */
-        sync: boolean;
-    }, data: IngestRdfRequest$1, params?: RequestParams) => Promise<HttpResponse<IngestRdfResponse$1, void>>;
+        sync?: boolean;
+    }, params?: RequestParams) => Promise<HttpResponse<IngestRdfResponse$1, void>>;
     /**
      * @description The read-only mirror of `POST /api/v1/sparql/translate`. Runs the exact same conversion the ingest pipeline runs (`parse_rdf_with_prefixes` → `convert_rdf_to_terms`), renders each produced term as text, and returns it. No term, sort, or `@prefix` is persisted: the sort-name and prefix resolution both run against owned copies of the tenant's hierarchy state, never the shared hierarchy itself.
      *
@@ -57765,6 +57790,21 @@ interface SourceExcerptDto$1 {
     /** Source document, if applicable. */
     sourceDocument?: string | null;
 }
+/**
+ * A sort from the tenant's catalog that a claim names.
+ *
+ * @remarks
+ * The schema counterpart of {@link SourceExcerptDto}: it carries no `termId`,
+ * because there is no record to point at. An answer *about* the knowledge base
+ * — "what sorts exist here" — is built from the sort catalog, runs no query and
+ * produces no binding, so this is the only evidence it can carry.
+ */
+interface SchemaExcerptDto {
+    /** The sort as the tenant's lattice names it. */
+    sortName: string;
+    /** The features the sort declares. */
+    featureNames?: string[];
+}
 /**
  * A claim annotation with provenance information.
  */
@@ -57773,7 +57813,13 @@ interface ClaimAnnotationDto {
     text: string;
     /** Character offsets (start, end) in the assistant_message. */
     span: unknown[];
-    /** Claim classification: "kb_grounded", "derived", "llm_framing", "proven", "contradicted". */
+    /**
+     * Claim classification: "kb_grounded", "schema_grounded", "derived",
+     * "llm_framing", "proven", "contradicted".
+     *
+     * `schema_grounded` is backed by the tenant's sort catalog rather than by
+     * records — see {@link ClaimAnnotationDto.schemaExcerpts}.
+     */
     claimType: string;
     /** Confidence score (0.0-1.0). */
     confidence: number;
@@ -57781,6 +57827,11 @@ interface ClaimAnnotationDto {
     sourceTermIds?: string[];
     /** Source data excerpts from the KB. */
     sourceExcerpts?: SourceExcerptDto$1[];
+    /**
+     * Sorts from the tenant's catalog that this claim names — the evidence for a
+     * `schema_grounded` claim, and additional context on any other.
+     */
+    schemaExcerpts?: SchemaExcerptDto[];
     /** OSFQL query that produced the grounding data. */
     osfqlQuery?: string | null;
     /** Derivation chain summary. */
@@ -58109,10 +58160,11 @@ type conversation_ReasoningTraceDto = ReasoningTraceDto;
 type conversation_RecordTurnRequest = RecordTurnRequest;
 type conversation_RecordTurnResponse = RecordTurnResponse;
 type conversation_ResolvedCoreferenceDto = ResolvedCoreferenceDto;
+type conversation_SchemaExcerptDto = SchemaExcerptDto;
 type conversation_SessionGraphDto = SessionGraphDto;
 type conversation_TurnDto = TurnDto;
 declare namespace conversation {
-  export type { conversation_ClaimAnnotationDto as ClaimAnnotationDto, conversation_CognitiveStrategyDto as CognitiveStrategyDto, conversation_CompareModelDto as CompareModelDto, conversation_ConversationMessageRequest as ConversationMessageRequest, conversation_ConversationMessageResponse as ConversationMessageResponse, conversation_ConversationSummaryDto as ConversationSummaryDto, conversation_ConversationTurnsResponse as ConversationTurnsResponse, conversation_DerivationSummaryDto as DerivationSummaryDto, conversation_FocusEntryDto as FocusEntryDto, conversation_ListConversationsResponse as ListConversationsResponse, conversation_MatchedEntityDto as MatchedEntityDto, conversation_ProofTraceNodeDto as ProofTraceNodeDto, conversation_ReasoningStageDto as ReasoningStageDto, conversation_ReasoningTraceDto as ReasoningTraceDto, conversation_RecordTurnRequest as RecordTurnRequest, conversation_RecordTurnResponse as RecordTurnResponse, conversation_ResolvedCoreferenceDto as ResolvedCoreferenceDto, conversation_SessionGraphDto as SessionGraphDto, SourceExcerptDto$1 as SourceExcerptDto, conversation_TurnDto as TurnDto, UICustomizationDto$1 as UICustomizationDto };
+  export type { conversation_ClaimAnnotationDto as ClaimAnnotationDto, conversation_CognitiveStrategyDto as CognitiveStrategyDto, conversation_CompareModelDto as CompareModelDto, conversation_ConversationMessageRequest as ConversationMessageRequest, conversation_ConversationMessageResponse as ConversationMessageResponse, conversation_ConversationSummaryDto as ConversationSummaryDto, conversation_ConversationTurnsResponse as ConversationTurnsResponse, conversation_DerivationSummaryDto as DerivationSummaryDto, conversation_FocusEntryDto as FocusEntryDto, conversation_ListConversationsResponse as ListConversationsResponse, conversation_MatchedEntityDto as MatchedEntityDto, conversation_ProofTraceNodeDto as ProofTraceNodeDto, conversation_ReasoningStageDto as ReasoningStageDto, conversation_ReasoningTraceDto as ReasoningTraceDto, conversation_RecordTurnRequest as RecordTurnRequest, conversation_RecordTurnResponse as RecordTurnResponse, conversation_ResolvedCoreferenceDto as ResolvedCoreferenceDto, conversation_SchemaExcerptDto as SchemaExcerptDto, conversation_SessionGraphDto as SessionGraphDto, SourceExcerptDto$1 as SourceExcerptDto, conversation_TurnDto as TurnDto, UICustomizationDto$1 as UICustomizationDto };
 }
 
 /**

package/dist/index.js

@@ -5,7 +5,7 @@ var __export = (target, all) => {
 };
 
 // src/config.ts
-var SDK_VERSION = "1.21.0";
+var SDK_VERSION = "1.22.0";
 function resolveConfig(config) {
   if (!config.baseUrl) {
     throw new Error("ClientConfig.baseUrl is required");
@@ -2833,9 +2833,10 @@ var Ingestion = class {
    * @request POST:/api/v1/ingest/document
    * @secure
    */
-  ingestDocument = (data, params = {}) => this.http.request({
+  ingestDocument = (data, query, params = {}) => this.http.request({
     path: `/api/v1/ingest/document`,
     method: "POST",
+    query,
     body: data,
     secure: true,
     type: "application/json",
@@ -2887,7 +2888,7 @@ var Ingestion = class {
    * @request POST:/api/v1/ingest/markdown
    * @secure
    */
-  ingestMarkdown = (query, data, params = {}) => this.http.request({
+  ingestMarkdown = (data, query, params = {}) => this.http.request({
     path: `/api/v1/ingest/markdown`,
     method: "POST",
     query,
@@ -2922,7 +2923,7 @@ var Ingestion = class {
    * @request POST:/api/v1/ingest/rdf
    * @secure
    */
-  ingestRdf = (query, data, params = {}) => this.http.request({
+  ingestRdf = (data, query, params = {}) => this.http.request({
     path: `/api/v1/ingest/rdf`,
     method: "POST",
     query,
@@ -20412,8 +20413,8 @@ var IngestionClient = class {
    */
   async ingestRdf(request) {
     const response = await this.api.ingestRdf(
-      { sync: request.sync ?? false },
-      IngestRdfRequestFromFrontToApi(request)
+      IngestRdfRequestFromFrontToApi(request),
+      { sync: request.sync ?? false }
     );
     return IngestRdfResponseFromApiToFront(response.data);
   }
@@ -28939,6 +28940,12 @@ function SourceExcerptDtoFromApiToFront(dto) {
     sourceDocument: wire.source_document ?? void 0
   };
 }
+function SchemaExcerptDtoFromApiToFront(dto) {
+  return {
+    sortName: dto.sort_name,
+    featureNames: dto.feature_names
+  };
+}
 function ClaimAnnotationDtoFromApiToFront(dto) {
   return {
     text: dto.text,
@@ -28947,6 +28954,7 @@ function ClaimAnnotationDtoFromApiToFront(dto) {
     confidence: dto.confidence,
     sourceTermIds: dto.source_term_ids,
     sourceExcerpts: dto.source_excerpts?.map(SourceExcerptDtoFromApiToFront),
+    schemaExcerpts: dto.schema_excerpts?.map(SchemaExcerptDtoFromApiToFront),
     osfqlQuery: dto.osfql_query ?? void 0,
     derivationSummary: dto.derivation_summary ? DerivationSummaryDtoFromApiToFront(dto.derivation_summary) : void 0
   };