@kortexya/reasoninglayer 1.8.1 → 1.10.1

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.8.1";
+declare const SDK_VERSION = "1.10.1";
 /**
  * Authentication mode for the SDK.
  *
@@ -37371,6 +37371,16 @@ interface AnalyzeDocumentsRequest {
     /** Max rules to evaluate per document (0 = unlimited, the default). */
     maxRules?: number;
 }
+/** Per-call options for {@link DocumentsClient.analyze}. */
+interface AnalyzeOptions {
+    /**
+     * Abort signal to cancel the in-flight analysis request. Analyse runs many
+     * sequential LLM calls per document and can take a while, so callers (e.g. a
+     * "Cancel" button) can pass an {@link AbortController} signal to tear the
+     * request down rather than waiting for it to complete.
+     */
+    signal?: AbortSignal;
+}
 /** Status of a single rule check. */
 type DocumentRuleStatus = 'pass' | 'fail' | 'inconclusive' | 'not_applicable';
 /** Severity of a single rule. */
@@ -37450,6 +37460,7 @@ interface DocumentAnalysisReport {
 }
 
 type documents_AnalyzeDocumentsRequest = AnalyzeDocumentsRequest;
+type documents_AnalyzeOptions = AnalyzeOptions;
 type documents_DocumentAnalysisReport = DocumentAnalysisReport;
 type documents_DocumentExtractedEntity = DocumentExtractedEntity;
 type documents_DocumentInput = DocumentInput;
@@ -37459,7 +37470,7 @@ type documents_DocumentRuleResult = DocumentRuleResult;
 type documents_DocumentRuleSeverity = DocumentRuleSeverity;
 type documents_DocumentRuleStatus = DocumentRuleStatus;
 declare namespace documents {
-  export type { documents_AnalyzeDocumentsRequest as AnalyzeDocumentsRequest, documents_DocumentAnalysisReport as DocumentAnalysisReport, documents_DocumentExtractedEntity as DocumentExtractedEntity, documents_DocumentInput as DocumentInput, documents_DocumentProofStep as DocumentProofStep, documents_DocumentResult as DocumentResult, documents_DocumentRuleResult as DocumentRuleResult, documents_DocumentRuleSeverity as DocumentRuleSeverity, documents_DocumentRuleStatus as DocumentRuleStatus };
+  export type { documents_AnalyzeDocumentsRequest as AnalyzeDocumentsRequest, documents_AnalyzeOptions as AnalyzeOptions, documents_DocumentAnalysisReport as DocumentAnalysisReport, documents_DocumentExtractedEntity as DocumentExtractedEntity, documents_DocumentInput as DocumentInput, documents_DocumentProofStep as DocumentProofStep, documents_DocumentResult as DocumentResult, documents_DocumentRuleResult as DocumentRuleResult, documents_DocumentRuleSeverity as DocumentRuleSeverity, documents_DocumentRuleStatus as DocumentRuleStatus };
 }
 
 /**
@@ -37483,9 +37494,10 @@ declare class DocumentsClient {
      * Analyse documents against the knowledge base's compliance rules.
      *
      * @param request - Documents (name + content) plus optional rule-sort focus.
+     * @param options - Per-call options (e.g. an {@link AbortSignal} to cancel).
      * @returns Per-document rule results, scores, entities and proof traces.
      */
-    analyze(request: AnalyzeDocumentsRequest): Promise<DocumentAnalysisReport>;
+    analyze(request: AnalyzeDocumentsRequest, options?: AnalyzeOptions): Promise<DocumentAnalysisReport>;
 }
 
 declare class Oversight<SecurityDataType = unknown> {

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.8.1";
+declare const SDK_VERSION = "1.10.1";
 /**
  * Authentication mode for the SDK.
  *
@@ -37371,6 +37371,16 @@ interface AnalyzeDocumentsRequest {
     /** Max rules to evaluate per document (0 = unlimited, the default). */
     maxRules?: number;
 }
+/** Per-call options for {@link DocumentsClient.analyze}. */
+interface AnalyzeOptions {
+    /**
+     * Abort signal to cancel the in-flight analysis request. Analyse runs many
+     * sequential LLM calls per document and can take a while, so callers (e.g. a
+     * "Cancel" button) can pass an {@link AbortController} signal to tear the
+     * request down rather than waiting for it to complete.
+     */
+    signal?: AbortSignal;
+}
 /** Status of a single rule check. */
 type DocumentRuleStatus = 'pass' | 'fail' | 'inconclusive' | 'not_applicable';
 /** Severity of a single rule. */
@@ -37450,6 +37460,7 @@ interface DocumentAnalysisReport {
 }
 
 type documents_AnalyzeDocumentsRequest = AnalyzeDocumentsRequest;
+type documents_AnalyzeOptions = AnalyzeOptions;
 type documents_DocumentAnalysisReport = DocumentAnalysisReport;
 type documents_DocumentExtractedEntity = DocumentExtractedEntity;
 type documents_DocumentInput = DocumentInput;
@@ -37459,7 +37470,7 @@ type documents_DocumentRuleResult = DocumentRuleResult;
 type documents_DocumentRuleSeverity = DocumentRuleSeverity;
 type documents_DocumentRuleStatus = DocumentRuleStatus;
 declare namespace documents {
-  export type { documents_AnalyzeDocumentsRequest as AnalyzeDocumentsRequest, documents_DocumentAnalysisReport as DocumentAnalysisReport, documents_DocumentExtractedEntity as DocumentExtractedEntity, documents_DocumentInput as DocumentInput, documents_DocumentProofStep as DocumentProofStep, documents_DocumentResult as DocumentResult, documents_DocumentRuleResult as DocumentRuleResult, documents_DocumentRuleSeverity as DocumentRuleSeverity, documents_DocumentRuleStatus as DocumentRuleStatus };
+  export type { documents_AnalyzeDocumentsRequest as AnalyzeDocumentsRequest, documents_AnalyzeOptions as AnalyzeOptions, documents_DocumentAnalysisReport as DocumentAnalysisReport, documents_DocumentExtractedEntity as DocumentExtractedEntity, documents_DocumentInput as DocumentInput, documents_DocumentProofStep as DocumentProofStep, documents_DocumentResult as DocumentResult, documents_DocumentRuleResult as DocumentRuleResult, documents_DocumentRuleSeverity as DocumentRuleSeverity, documents_DocumentRuleStatus as DocumentRuleStatus };
 }
 
 /**
@@ -37483,9 +37494,10 @@ declare class DocumentsClient {
      * Analyse documents against the knowledge base's compliance rules.
      *
      * @param request - Documents (name + content) plus optional rule-sort focus.
+     * @param options - Per-call options (e.g. an {@link AbortSignal} to cancel).
      * @returns Per-document rule results, scores, entities and proof traces.
      */
-    analyze(request: AnalyzeDocumentsRequest): Promise<DocumentAnalysisReport>;
+    analyze(request: AnalyzeDocumentsRequest, options?: AnalyzeOptions): Promise<DocumentAnalysisReport>;
 }
 
 declare class Oversight<SecurityDataType = unknown> {

package/dist/index.js

@@ -5,7 +5,7 @@ var __export = (target, all) => {
 };
 
 // src/config.ts
-var SDK_VERSION = "1.8.1";
+var SDK_VERSION = "1.10.1";
 function resolveConfig(config) {
   if (!config.baseUrl) {
     throw new Error("ClientConfig.baseUrl is required");
@@ -18587,11 +18587,13 @@ var DocumentsClient = class {
    * Analyse documents against the knowledge base's compliance rules.
    *
    * @param request - Documents (name + content) plus optional rule-sort focus.
+   * @param options - Per-call options (e.g. an {@link AbortSignal} to cancel).
    * @returns Per-document rule results, scores, entities and proof traces.
    */
-  async analyze(request) {
+  async analyze(request, options) {
     const response = await this.api.analyzeDocuments(
-      AnalyzeDocumentsRequestFromFrontToApi(request)
+      AnalyzeDocumentsRequestFromFrontToApi(request),
+      { signal: options?.signal }
     );
     return DocumentAnalysisResponseFromApiToFront(response.data);
   }
@@ -22871,6 +22873,246 @@ var VerificationClient = class {
   }
 };
 
+// src/normalizers/research.ts
+function PaperMetadataFromApiToFront(dto) {
+  return {
+    title: dto.title,
+    authors: dto.authors,
+    doi: dto.doi ?? null,
+    pmid: dto.pmid ?? null,
+    arxivId: dto.arxiv_id ?? null,
+    journal: dto.journal ?? null,
+    year: dto.year ?? null,
+    abstractText: dto.abstract_text ?? null,
+    citationCount: dto.citation_count ?? null,
+    source: dto.source,
+    fullTextUrl: dto.full_text_url ?? null
+  };
+}
+function PaperSearchResultFromApiToFront(dto) {
+  return {
+    metadata: PaperMetadataFromApiToFront(dto.metadata),
+    relevanceScore: dto.relevance_score ?? null
+  };
+}
+function SearchPapersResponseFromApiToFront(raw) {
+  const dto = raw;
+  return {
+    results: (dto.results ?? []).map(PaperSearchResultFromApiToFront),
+    totalFound: dto.total_found
+  };
+}
+function CreateResearchSessionResponseFromApiToFront(raw) {
+  const dto = raw;
+  return {
+    sessionId: dto.session_id,
+    status: dto.status,
+    question: dto.question,
+    createdAt: dto.created_at
+  };
+}
+function ResearchCycleResultFromApiToFront(dto) {
+  return {
+    cycleNumber: dto.cycle_number,
+    gapsDetected: dto.gaps_detected,
+    gapsResolved: dto.gaps_resolved,
+    papersRetrieved: dto.papers_retrieved,
+    papersIngested: dto.papers_ingested,
+    claimsVerified: dto.claims_verified,
+    contradictionsDetected: dto.contradictions_detected,
+    processingTimeMs: dto.processing_time_ms,
+    searchQueries: dto.search_queries ?? []
+  };
+}
+function ResearchSessionResponseFromApiToFront(raw) {
+  const dto = raw;
+  return {
+    sessionId: dto.session_id,
+    question: dto.question,
+    status: dto.status,
+    error: dto.error ?? null,
+    cycles: (dto.cycles ?? []).map(ResearchCycleResultFromApiToFront),
+    totalPapersIngested: dto.total_papers_ingested,
+    totalFindings: dto.total_findings,
+    totalContradictions: dto.total_contradictions,
+    totalGaps: dto.total_gaps,
+    createdAt: dto.created_at,
+    updatedAt: dto.updated_at
+  };
+}
+function ResearchCycleResponseFromApiToFront(raw) {
+  const dto = raw;
+  return {
+    sessionId: dto.session_id,
+    status: dto.status,
+    cycle: ResearchCycleResultFromApiToFront(dto.cycle),
+    converged: dto.converged
+  };
+}
+function EvidenceItemSummaryFromApiToFront(dto) {
+  return {
+    termId: dto.term_id,
+    description: dto.description,
+    qualityWeight: dto.quality_weight,
+    supports: dto.supports,
+    contribution: dto.contribution,
+    paperDoi: dto.paper_doi ?? null
+  };
+}
+function ProvenanceStepFromApiToFront(dto) {
+  return {
+    stepType: dto.step_type,
+    description: dto.description,
+    entityId: dto.entity_id ?? null,
+    timestamp: dto.timestamp ?? null
+  };
+}
+function ResearchFindingFromApiToFront(dto) {
+  return {
+    claimId: dto.claim_id,
+    statement: dto.statement,
+    truthfulness: dto.truthfulness,
+    label: dto.label,
+    supportingEvidence: (dto.supporting_evidence ?? []).map(EvidenceItemSummaryFromApiToFront),
+    contradictingEvidence: (dto.contradicting_evidence ?? []).map(EvidenceItemSummaryFromApiToFront),
+    provenanceChain: (dto.provenance_chain ?? []).map(ProvenanceStepFromApiToFront),
+    residuated: dto.residuated,
+    residuationReason: dto.residuation_reason ?? null
+  };
+}
+function ResearchFindingsResponseFromApiToFront(raw) {
+  const dto = raw;
+  return {
+    sessionId: dto.session_id,
+    findings: (dto.findings ?? []).map(ResearchFindingFromApiToFront),
+    total: dto.total
+  };
+}
+function KnowledgeGapFromApiToFront(dto) {
+  return {
+    sortName: dto.sort_name,
+    infoGain: dto.info_gain,
+    neededBy: dto.needed_by ?? [],
+    wakeTrigger: dto.wake_trigger,
+    suggestedSearchQuery: dto.suggested_search_query ?? null
+  };
+}
+function ResearchGapsResponseFromApiToFront(raw) {
+  const dto = raw;
+  return {
+    sessionId: dto.session_id,
+    gaps: (dto.gaps ?? []).map(KnowledgeGapFromApiToFront),
+    total: dto.total
+  };
+}
+function ContradictionFromApiToFront(dto) {
+  return {
+    claimAId: dto.claim_a_id,
+    claimBId: dto.claim_b_id,
+    statementA: dto.statement_a,
+    statementB: dto.statement_b,
+    confidence: dto.confidence,
+    explanation: dto.explanation
+  };
+}
+function ResearchContradictionsResponseFromApiToFront(raw) {
+  const dto = raw;
+  return {
+    sessionId: dto.session_id,
+    contradictions: (dto.contradictions ?? []).map(ContradictionFromApiToFront),
+    total: dto.total
+  };
+}
+function ResearchStatisticsFromApiToFront(dto) {
+  return {
+    totalCycles: dto.total_cycles,
+    totalPapersRetrieved: dto.total_papers_retrieved,
+    totalPapersIngested: dto.total_papers_ingested,
+    totalClaimsExtracted: dto.total_claims_extracted,
+    totalClaimsVerified: dto.total_claims_verified,
+    totalContradictions: dto.total_contradictions,
+    totalProcessingTimeMs: dto.total_processing_time_ms,
+    gapsResolved: dto.gaps_resolved,
+    gapsRemaining: dto.gaps_remaining
+  };
+}
+function ReportVerificationFromApiToFront(dto) {
+  return {
+    verdict: dto.verdict,
+    score: dto.score,
+    computationTimeMs: dto.computation_time_ms
+  };
+}
+function ResearchReportResponseFromApiToFront(raw) {
+  const dto = raw;
+  return {
+    sessionId: dto.session_id,
+    question: dto.question,
+    summary: dto.summary,
+    findings: (dto.findings ?? []).map(ResearchFindingFromApiToFront),
+    knowledgeGaps: (dto.knowledge_gaps ?? []).map(KnowledgeGapFromApiToFront),
+    contradictions: (dto.contradictions ?? []).map(ContradictionFromApiToFront),
+    statistics: ResearchStatisticsFromApiToFront(dto.statistics),
+    generatedContent: dto.generated_content ?? null,
+    verification: dto.verification ? ReportVerificationFromApiToFront(dto.verification) : null
+  };
+}
+function IngestPaperResponseFromApiToFront(raw) {
+  const dto = raw;
+  return {
+    success: dto.success,
+    metadata: dto.metadata ? PaperMetadataFromApiToFront(dto.metadata) : null,
+    entitiesExtracted: dto.entities_extracted,
+    claimsExtracted: dto.claims_extracted,
+    error: dto.error ?? null
+  };
+}
+function VerifyClaimResponseFromApiToFront(raw) {
+  const dto = raw;
+  return {
+    truthfulness: dto.truthfulness,
+    label: dto.label,
+    supportingCount: dto.supporting_count,
+    contradictingCount: dto.contradicting_count,
+    residuated: dto.residuated,
+    residuationReason: dto.residuation_reason ?? null
+  };
+}
+function CreateResearchSessionRequestFromFrontToApi(model) {
+  return {
+    question: model.question,
+    max_cycles: model.maxCycles,
+    max_papers: model.maxPapers,
+    paper_sources: model.paperSources
+  };
+}
+function RunResearchCycleRequestFromFrontToApi(model) {
+  return {
+    additional_queries: model.additionalQueries,
+    max_papers_this_cycle: model.maxPapersThisCycle
+  };
+}
+function SearchPapersRequestFromFrontToApi(model) {
+  return {
+    query: model.query,
+    max_results: model.maxResults,
+    sources: model.sources
+  };
+}
+function IngestPaperRequestFromFrontToApi(model) {
+  return {
+    identifier: model.identifier,
+    identifier_type: model.identifierType,
+    session_id: model.sessionId
+  };
+}
+function VerifyClaimRequestFromFrontToApi(model) {
+  return {
+    claim_term_id: model.claimTermId,
+    evidence_sort_id: model.evidenceSortId
+  };
+}
+
 // src/resources/research.ts
 var ResearchClient = class {
   /** @internal */
@@ -22907,12 +23149,12 @@ var ResearchClient = class {
     const response = await this.http.request({
       path: "/api/v1/research/sessions",
       method: "POST",
-      body: request,
+      body: CreateResearchSessionRequestFromFrontToApi(request),
       secure: true,
       type: "application/json" /* Json */,
       format: "json"
     });
-    return response.data;
+    return CreateResearchSessionResponseFromApiToFront(response.data);
   }
   /**
    * Get the current state of a research session.
@@ -22942,7 +23184,7 @@ var ResearchClient = class {
       secure: true,
       format: "json"
     });
-    return response.data;
+    return ResearchSessionResponseFromApiToFront(response.data);
   }
   /**
    * Run a single research cycle within a session.
@@ -22973,12 +23215,12 @@ var ResearchClient = class {
     const response = await this.http.request({
       path: `/api/v1/research/sessions/${encodeURIComponent(sessionId)}/run`,
       method: "POST",
-      body: request,
+      body: request ? RunResearchCycleRequestFromFrontToApi(request) : void 0,
       secure: true,
       type: "application/json" /* Json */,
       format: "json"
     });
-    return response.data;
+    return ResearchCycleResponseFromApiToFront(response.data);
   }
   /**
    * Run the research session to completion (all remaining cycles).
@@ -23007,7 +23249,7 @@ var ResearchClient = class {
       secure: true,
       format: "json"
     });
-    return response.data;
+    return ResearchSessionResponseFromApiToFront(response.data);
   }
   /**
    * Delete a research session and all associated data.
@@ -23060,7 +23302,7 @@ var ResearchClient = class {
       secure: true,
       format: "json"
     });
-    return response.data;
+    return ResearchFindingsResponseFromApiToFront(response.data);
   }
   /**
    * Get knowledge gaps for a research session.
@@ -23093,7 +23335,7 @@ var ResearchClient = class {
       secure: true,
       format: "json"
     });
-    return response.data;
+    return ResearchGapsResponseFromApiToFront(response.data);
   }
   /**
    * Get detected contradictions for a research session.
@@ -23125,7 +23367,7 @@ var ResearchClient = class {
       secure: true,
       format: "json"
     });
-    return response.data;
+    return ResearchContradictionsResponseFromApiToFront(response.data);
   }
   /**
    * Get the full research report for a session.
@@ -23159,7 +23401,7 @@ var ResearchClient = class {
       secure: true,
       format: "json"
     });
-    return response.data;
+    return ResearchReportResponseFromApiToFront(response.data);
   }
   /**
    * Search for papers across external scientific databases.
@@ -23191,12 +23433,12 @@ var ResearchClient = class {
     const response = await this.http.request({
       path: "/api/v1/research/papers/search",
       method: "POST",
-      body: request,
+      body: SearchPapersRequestFromFrontToApi(request),
       secure: true,
       type: "application/json" /* Json */,
       format: "json"
     });
-    return response.data;
+    return SearchPapersResponseFromApiToFront(response.data);
   }
   /**
    * Ingest a specific paper into the knowledge base.
@@ -23228,12 +23470,12 @@ var ResearchClient = class {
     const response = await this.http.request({
       path: "/api/v1/research/papers/ingest",
       method: "POST",
-      body: request,
+      body: IngestPaperRequestFromFrontToApi(request),
       secure: true,
       type: "application/json" /* Json */,
       format: "json"
     });
-    return response.data;
+    return IngestPaperResponseFromApiToFront(response.data);
   }
   /**
    * Verify a specific claim against evidence in the knowledge base.
@@ -23266,12 +23508,12 @@ var ResearchClient = class {
     const response = await this.http.request({
       path: "/api/v1/research/claims/verify",
       method: "POST",
-      body: request,
+      body: VerifyClaimRequestFromFrontToApi(request),
       secure: true,
       type: "application/json" /* Json */,
       format: "json"
     });
-    return response.data;
+    return VerifyClaimResponseFromApiToFront(response.data);
   }
 };