@kortexya/reasoninglayer 1.9.0 → 1.11.0

package/dist/index.cjs

@@ -7,7 +7,7 @@ var __export = (target, all) => {
 };
 
 // src/config.ts
-var SDK_VERSION = "1.9.0";
+var SDK_VERSION = "1.11.0";
 function resolveConfig(config) {
   if (!config.baseUrl) {
     throw new Error("ClientConfig.baseUrl is required");
@@ -22875,6 +22875,266 @@ 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 ResearchSessionSummaryFromApiToFront(raw) {
+  const dto = raw;
+  return {
+    sessionId: dto.session_id,
+    question: dto.question,
+    status: dto.status,
+    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 ListResearchSessionsResponseFromApiToFront(raw) {
+  const dto = raw;
+  return {
+    sessions: (dto.sessions ?? []).map(ResearchSessionSummaryFromApiToFront)
+  };
+}
+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 */
@@ -22911,12 +23171,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.
@@ -22946,7 +23206,31 @@ var ResearchClient = class {
       secure: true,
       format: "json"
     });
-    return response.data;
+    return ResearchSessionResponseFromApiToFront(response.data);
+  }
+  /**
+   * List the current tenant's research sessions, newest first.
+   *
+   * Tenant-scoped via the `X-Tenant-Id` header (set on the client), mirroring
+   * how conversations are listed. Returns lightweight summaries — use
+   * {@link getSession} / {@link getReport} for a session's full detail.
+   *
+   * @returns The tenant's session summaries.
+   *
+   * @example
+   * ```ts
+   * const { sessions } = await client.research.listSessions();
+   * sessions.forEach((s) => console.log(s.sessionId, s.status, s.question));
+   * ```
+   */
+  async listSessions() {
+    const response = await this.http.request({
+      path: `/api/v1/research/sessions`,
+      method: "GET",
+      secure: true,
+      format: "json"
+    });
+    return ListResearchSessionsResponseFromApiToFront(response.data);
   }
   /**
    * Run a single research cycle within a session.
@@ -22977,12 +23261,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).
@@ -23011,7 +23295,7 @@ var ResearchClient = class {
       secure: true,
       format: "json"
     });
-    return response.data;
+    return ResearchSessionResponseFromApiToFront(response.data);
   }
   /**
    * Delete a research session and all associated data.
@@ -23064,7 +23348,7 @@ var ResearchClient = class {
       secure: true,
       format: "json"
     });
-    return response.data;
+    return ResearchFindingsResponseFromApiToFront(response.data);
   }
   /**
    * Get knowledge gaps for a research session.
@@ -23097,7 +23381,7 @@ var ResearchClient = class {
       secure: true,
       format: "json"
     });
-    return response.data;
+    return ResearchGapsResponseFromApiToFront(response.data);
   }
   /**
    * Get detected contradictions for a research session.
@@ -23129,7 +23413,7 @@ var ResearchClient = class {
       secure: true,
       format: "json"
     });
-    return response.data;
+    return ResearchContradictionsResponseFromApiToFront(response.data);
   }
   /**
    * Get the full research report for a session.
@@ -23163,7 +23447,7 @@ var ResearchClient = class {
       secure: true,
       format: "json"
     });
-    return response.data;
+    return ResearchReportResponseFromApiToFront(response.data);
   }
   /**
    * Search for papers across external scientific databases.
@@ -23195,12 +23479,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.
@@ -23232,12 +23516,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.
@@ -23270,12 +23554,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);
   }
 };