From 79740319d5ca98d9f7a7e0319f16e487a5f2060f Mon Sep 17 00:00:00 2001
From: chengke <404835780@qq.com>
Date: Tue, 19 May 2026 18:12:02 +0800
Subject: [PATCH 1/4] feat(retrieval): add agentic context fields to response
 types

---
 src/types/retrieval.ts | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/types/retrieval.ts b/src/types/retrieval.ts
index e804e3a..402a523 100644
--- a/src/types/retrieval.ts
+++ b/src/types/retrieval.ts
@@ -100,6 +100,12 @@ export interface RetrievalQueryResponse {
   answerText?: string | null;
   /** Cited evidence chunks with asset URLs (agentic mode only) */
   referencedChunks?: Array<Record<string, unknown>> | null;
+  /** Tree-structured evidence text rendered by the agentic navigator */
+  evidenceText?: string | null;
+  /** Reason why the agentic run stopped (e.g. answer_done, not_found) */
+  stopReason?: string | null;
+  /** Semantic failure reason when the agentic evidence is insufficient */
+  failureReason?: string | null;
   /** Ranked retrieval results */
   results: RetrievalResult[];
 }

From 9e3fe5a280c64e7154befe6a46b01b39390862e2 Mon Sep 17 00:00:00 2001
From: chengke <404835780@qq.com>
Date: Tue, 19 May 2026 18:12:17 +0800
Subject: [PATCH 2/4] chore: update lockfile

---
 package-lock.json | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 516525d..8d7ad97 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "@ontos-ai/knowhere-sdk",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@ontos-ai/knowhere-sdk",
-      "version": "0.3.0",
+      "version": "0.5.0",
       "license": "MIT",
       "dependencies": {
         "axios": "^1.15.2",

From 3d87a031ba3acf69f5f80ed1d118b40260ffcb6f Mon Sep 17 00:00:00 2001
From: chengke <404835780@qq.com>
Date: Tue, 19 May 2026 18:12:17 +0800
Subject: [PATCH 3/4] chore(release): 0.6.0

---
 package-lock.json | 4 ++--
 package.json      | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 8d7ad97..f072e6f 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "@ontos-ai/knowhere-sdk",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@ontos-ai/knowhere-sdk",
-      "version": "0.5.0",
+      "version": "0.6.0",
       "license": "MIT",
       "dependencies": {
         "axios": "^1.15.2",
diff --git a/package.json b/package.json
index 7a70d9b..f71c7a6 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@ontos-ai/knowhere-sdk",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Official Node.js SDK for Knowhere document parsing API",
   "keywords": [
     "knowhere",

From e9080b6d31784082553427faade38eaeb0429741 Mon Sep 17 00:00:00 2001
From: chengke <404835780@qq.com>
Date: Tue, 19 May 2026 18:14:16 +0800
Subject: [PATCH 4/4] chore: add changeset for agentic context fields

---
 .changeset/pr-84-agentic-context.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 .changeset/pr-84-agentic-context.md

diff --git a/.changeset/pr-84-agentic-context.md b/.changeset/pr-84-agentic-context.md
new file mode 100644
index 0000000..50fb81a
--- /dev/null
+++ b/.changeset/pr-84-agentic-context.md
@@ -0,0 +1,5 @@
+---
+"@ontos-ai/knowhere-sdk": minor
+---
+
+Add agentic context fields (evidenceText, stopReason, failureReason) to RetrievalQueryResponse