@ontos-ai/knowhere-claw 0.1.4 → 0.1.5-beta.20260320121253

package/README.md

@@ -138,3 +138,6 @@ Within each scope, the plugin keeps:
 
 Contributor-oriented architecture, workflow, and packaging notes live in
 `DEVELOPMENT.md` at the repository root.
+
+Release-process details for maintainers live in
+[`docs/release-workflow.md`](./docs/release-workflow.md).

package/dist/tools.js

@@ -492,7 +492,7 @@ function createIngestTool(params) {
 	return {
 		name: "knowhere_ingest_document",
 		label: "Knowhere Ingest",
-		description: "Parse a local file or remote URL with Knowhere and store the result in the current scope. Before calling this for a document that might already be stored in the current scope, use knowhere_list_documents and reuse the existing stored document when Source, File, or Title clearly match unless the user explicitly asks for a fresh parse or overwrite. When the user provides a URL to a document (PDF link, web page, etc.), pass it as the url parameter — Knowhere fetches it directly, no local download needed. Returns immediately with a job ID while parsing continues in the background. Use knowhere_get_job_status to check progress at any time. Use lang to control the language of the direct tracker follow-up (`en` by default, `ch` for Chinese). Provide either filePath or url, not both.",
+		description: "Parse a local file or remote URL with Knowhere and store the result in the current scope. Before calling this for a document that might already be stored in the current scope, use knowhere_list_documents and reuse the existing stored document when Source, File, or Title clearly match unless the user explicitly asks for a fresh parse or overwrite. When the user provides a URL to a document (PDF link, web page, etc.), pass it as the url parameter — Knowhere fetches it directly, no local download needed. Returns immediately with a job ID while parsing continues in the background. Use knowhere_get_job_status only when the current turn needs the parsed result. Use lang to control the language of any user-facing background status update (`en` by default, `ch` for Chinese). Provide either filePath or url, not both.",
 		parameters: {
 			type: "object",
 			additionalProperties: false,
@@ -536,7 +536,7 @@ function createIngestTool(params) {
 				},
 				lang: {
 					type: "string",
-					description: "Language for the direct tracker follow-up message sent after background parsing completes or fails. Supports en and ch; unsupported values fall back to en."
+					description: "Language for any user-facing background status update sent after parsing completes or fails. Supports en and ch; unsupported values fall back to en."
 				},
 				parsing: {
 					type: "object",
@@ -679,7 +679,7 @@ function createIngestTool(params) {
 				`Job ID: ${createdJob.job_id}`,
 				`File: ${progressLabel}`,
 				`Scope: ${scope.label}`,
-				"Use knowhere_get_job_status to check progress at any time."
+				"Use knowhere_get_job_status only if this turn needs the parsed result."
 			].join("\n"));
 		}
 	};

package/openclaw.plugin.json

@@ -2,8 +2,10 @@
   "id": "knowhere-claw",
   "name": "Knowhere",
   "description": "Parse documents with Knowhere and expose the stored result as tool-queryable document state for OpenClaw agents.",
-  "skills": ["./skills"],
-  "version": "0.1.4",
+  "skills": [
+    "./skills"
+  ],
+  "version": "0.1.5-beta.20260320121253",
   "uiHints": {
     "apiKey": {
       "label": "Knowhere API Key",
@@ -56,7 +58,11 @@
       },
       "scopeMode": {
         "type": "string",
-        "enum": ["session", "agent", "global"],
+        "enum": [
+          "session",
+          "agent",
+          "global"
+        ],
         "default": "session"
       },
       "pollIntervalMs": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ontos-ai/knowhere-claw",
-  "version": "0.1.4",
+  "version": "0.1.5-beta.20260320121253",
   "description": "OpenClaw plugin for Knowhere-powered document ingestion and automatic grounding.",
   "files": [
     "dist/",
@@ -19,15 +19,19 @@
   },
   "scripts": {
     "build": "rolldown -c && tsc -p tsconfig.build.json",
+    "changeset": "changeset",
+    "changeset:publish": "changeset publish",
     "fmt": "oxfmt",
     "fmt:check": "oxfmt --check",
     "lint": "oxlint --type-aware",
     "lint:fix": "oxlint --type-aware --fix",
     "smoke:tools": "vite-node --mode smoke ./smoketest/run-tool.ts",
+    "release:beta": "node ./scripts/publish-beta-release.mjs",
+    "release:publish": "node ./scripts/publish-release.mjs",
+    "release:version": "node ./scripts/release-version.mjs",
     "tsgo": "tsgo --noEmit -p tsconfig.json",
     "typecheck": "pnpm tsgo",
     "check:plugin-version": "node ./scripts/release-guard.mjs plugin-version",
-    "check:beta-version": "node ./scripts/release-guard.mjs beta-version",
     "prepack": "pnpm build",
     "test": "vitest --run",
     "clean": "rm -rf dist"
@@ -37,6 +41,8 @@
     "fflate": "^0.8.2"
   },
   "devDependencies": {
+    "@changesets/changelog-github": "^0.6.0",
+    "@changesets/cli": "^2.30.0",
     "@tsconfig/node22": "^22.0.5",
     "@types/node": "^25.3.5",
     "@typescript/native-preview": "7.0.0-dev.20260307.1",

package/skills/knowhere/SKILL.md

@@ -132,7 +132,7 @@ After ingesting a document, use the returned document or job identifiers for fol
 ## Recommended workflow
 
 1. If the document may already exist in the current scope, call `knowhere_list_documents` first and compare `Source`, `File`, and `Title` to find an existing match.
-2. Ingest or import the document only if it is not already in the store, or if the user explicitly wants a fresh parse. After calling `knowhere_ingest_document`, you receive a job ID immediately while parsing continues in the background. Wait for the plugin's completion message that the document is ready before proceeding. If no completion message arrives, check with `knowhere_get_job_status`.
+2. Ingest or import the document only if it is not already in the store, or if the user explicitly wants a fresh parse. After calling `knowhere_ingest_document`, you receive a job ID immediately while parsing continues in the background. If the current turn needs the parsed document, check with `knowhere_get_job_status`; otherwise stop and wait for the user to continue later.
 3. Call `knowhere_list_documents` again if you need to confirm the right `docId`.
 4. Call `knowhere_preview_document` to get a structural overview (table of contents with summaries).
 5. When you know what to search for, call `knowhere_grep` with `conditions: [{ pattern: "your query" }]` — this searches all text fields (content, summary, keywords, path) in one call. Add more conditions to narrow results (e.g. filter by `chunk.type` or `chunk.path`).