@karmaniverous/jeeves-watcher-openclaw 0.12.1 → 0.13.1

package/dist/skills/jeeves-watcher/SKILL.md

@@ -16,7 +16,7 @@ The watcher is an HTTP API running as a background service (typically NSSM on Wi
 **Default port:** 1936 (configurable via `api.port` in watcher config)
 **Non-default port:** If the watcher runs on a different port, the user must set `plugins.entries.jeeves-watcher.config.apiUrl` in `openclaw.json`. The plugin cannot auto-discover a non-default port.
 
-**Health check:** `GET /status` returns uptime, point count, collection dimensions, and reindex status.
+**Health check:** `GET /status` returns `name`, `version`, `uptime`, `status` (`healthy`/`degraded`/`unhealthy`), and a `health` object containing `collection` (point count, dimensions), `reindex` status, and `initialScan` progress.
 
 **Mental model:** The `watcher_*` tools are thin HTTP wrappers. Each tool call translates to an HTTP request to the watcher API. When tools are available, use them. When they're not (e.g., different session, plugin not loaded), you can hit the API directly. Replace `<PORT>` below with the configured port (default 1936; check `plugins.entries.jeeves-watcher.config.apiUrl` in `openclaw.json` if overridden):
 
@@ -267,7 +267,7 @@ Then generate a starter config file. Example minimal config:
   },
   "vectorStore": {
     "url": "http://localhost:6333",
-    "collection": "jeeves_archive"
+    "collectionName": "jeeves_archive"
   },
   "search": {
     "scoreThresholds": { "strong": 0.75, "relevant": 0.5, "noise": 0.25 },
@@ -364,9 +364,9 @@ Set or update metadata on a document.
 - `metadata` (object, required) — key-value metadata to merge
 
 ### `watcher_status`
-Service health check. Returns uptime, version, collection stats, reindex status, and initial scan progress.
+Service health check. Returns `name`, `version`, `uptime`, `status`, and `health` object with collection stats, reindex status, and initial scan progress.
 
-After a service restart, the `initialScan` field shows scan progress:
+After a service restart, the `health.initialScan` field shows scan progress:
 - `active: true` — filesystem walk in progress; `filesMatched` and `filesEnqueued` grow until chokidar completes
 - `active: false` with `completedAt`/`durationMs` — scan finished
 

package/dist/src/cli.d.ts

@@ -5,14 +5,6 @@
  *   npx \@karmaniverous/jeeves-watcher-openclaw install
  *   npx \@karmaniverous/jeeves-watcher-openclaw uninstall
  *
- * Bypasses OpenClaw's `plugins install` command, which has a known
- * spawn EINVAL bug on Windows (https://github.com/openclaw/openclaw/issues/9224).
- *
- * Supports non-default installations via:
- *   - OPENCLAW_CONFIG env var (path to openclaw.json)
- *   - OPENCLAW_HOME env var (path to .openclaw directory)
- *   - Default: ~/.openclaw/openclaw.json
- *
  * @module cli
  */
 export {};

package/dist/src/constants.d.ts

@@ -6,16 +6,20 @@
  * Imported by both the plugin bundle (`index.ts`) and the CLI bundle
  * (`cli.ts`). Rollup inlines these into each output independently.
  */
+/** Component name shared across service and plugin descriptors. */
+export declare const COMPONENT_NAME = "watcher";
 /** Plugin identifier used in OpenClaw config and extensions directory. */
 export declare const PLUGIN_ID = "jeeves-watcher-openclaw";
+/** npm package name for the service. */
+export declare const SERVICE_PACKAGE = "@karmaniverous/jeeves-watcher";
+/** npm package name for the plugin. */
+export declare const PLUGIN_PACKAGE = "@karmaniverous/jeeves-watcher-openclaw";
+/** Default watcher API port. */
+export declare const DEFAULT_PORT = 1936;
 /** Default watcher API base URL. */
-export declare const DEFAULT_API_URL = "http://127.0.0.1:1936";
+export declare const DEFAULT_API_URL: string;
 /** Default platform config root path. */
 export declare const DEFAULT_CONFIG_ROOT = "j:/config";
-/** Default Qdrant health check URL (used in diagnostic output). */
-export declare const DEFAULT_QDRANT_URL = "http://127.0.0.1:6333";
-/** Timeout in milliseconds for service health probes. */
-export declare const PROBE_TIMEOUT_MS = 1500;
 /**
  * Timeout in milliseconds for menu generation fetch calls.
  *

package/dist/src/promptInjection.d.ts

@@ -5,5 +5,9 @@
  * @remarks
  * We intentionally do NOT embed catalogues (rules, watched paths, ignored
  * paths). Those are available live via `watcher_config` on demand.
+ *
+ * When the watcher is unreachable, this function throws — the caller
+ * (`createAsyncContentCache`) retains the previous successful result.
+ * Core's `ComponentWriter` handles unreachable-state alerts independently.
  */
 export declare function generateWatcherMenu(apiUrl: string): Promise<string>;

package/dist/src/watcherComponent.d.ts

@@ -1,6 +1,6 @@
 /**
  * @module plugin/watcherComponent
- * Jeeves component integration for the watcher OpenClaw plugin.
+ * Jeeves component descriptor for the watcher OpenClaw plugin.
  *
  * @remarks
  * Uses `createAsyncContentCache()` from core to bridge the sync/async gap:
@@ -8,7 +8,7 @@
  * async HTTP calls. The cache triggers a background refresh on each call and
  * returns the most recent successful result.
  */
-import { type JeevesComponent } from '@karmaniverous/jeeves';
+import { type JeevesComponentDescriptor } from '@karmaniverous/jeeves';
 /** Options for creating the watcher component descriptor. */
 interface CreateWatcherComponentOptions {
     /** Base URL of the jeeves-watcher HTTP API. */
@@ -17,10 +17,17 @@ interface CreateWatcherComponentOptions {
     pluginVersion: string;
 }
 /**
- * Create the watcher `JeevesComponent` descriptor.
+ * Create the watcher component descriptor.
+ *
+ * @remarks
+ * Returns a `JeevesComponentDescriptor` conforming to the core Zod schema,
+ * ready for `createComponentWriter()`. The service descriptor
+ * (`packages/service/src/descriptor.ts`) is the canonical source for
+ * config schema and CLI commands; this plugin-side descriptor carries only
+ * the fields `ComponentWriter` needs (identity, content generation).
  *
  * @param options - API URL and plugin version.
- * @returns A fully configured component descriptor ready for `createComponentWriter()`.
+ * @returns A validated component descriptor.
  */
-export declare function createWatcherComponent(options: CreateWatcherComponentOptions): JeevesComponent;
+export declare function createWatcherComponent(options: CreateWatcherComponentOptions): JeevesComponentDescriptor;
 export {};

package/dist/src/watcherComponent.test.d.ts

@@ -1,5 +1,5 @@
 /**
  * @module plugin/watcherComponent.test
- * Unit tests for the watcher JeevesComponent implementation.
+ * Unit tests for the watcher JeevesComponentDescriptor.
  */
 export {};

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "jeeves-watcher-openclaw",
   "name": "Jeeves Watcher",
   "description": "Semantic search, metadata enrichment, and instance administration for a jeeves-watcher deployment.",
-  "version": "0.12.1",
+  "version": "0.13.1",
   "skills": [
     "dist/skills/jeeves-watcher"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karmaniverous/jeeves-watcher-openclaw",
-  "version": "0.12.1",
+  "version": "0.13.1",
   "author": "Jason Williscroft",
   "description": "OpenClaw plugin for jeeves-watcher — semantic search and metadata enrichment tools",
   "license": "BSD-3-Clause",
@@ -57,21 +57,21 @@
     "hideCredit": true
   },
   "dependencies": {
-    "@karmaniverous/jeeves": "^0.3.0"
+    "@karmaniverous/jeeves": "^0.4.4"
   },
   "devDependencies": {
-    "@dotenvx/dotenvx": "^1.55.1",
+    "@dotenvx/dotenvx": "^1.59.1",
     "@rollup/plugin-commonjs": "^29.0.2",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-typescript": "^12.3.0",
     "auto-changelog": "^2.5.0",
     "cross-env": "^10.1.0",
-    "knip": "^5.87.0",
+    "knip": "^6.1.0",
     "release-it": "^19.2.4",
-    "rollup": "^4.59.0",
+    "rollup": "^4.60.1",
     "tslib": "^2.8.1",
-    "vitest": "^4.1.0"
+    "vitest": "^4.1.2"
   },
   "scripts": {
     "build:plugin": "rimraf dist && cross-env NO_COLOR=1 rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",