@karmaniverous/jeeves-watcher-openclaw 0.7.0 → 0.8.1

package/dist/rollup.config.d.ts

@@ -1,7 +1,12 @@
 /**
- * @module rollup.config
  * Rollup configuration for the OpenClaw plugin package.
  * Two entry points: plugin (ESM + declarations) and CLI (ESM executable).
+ *
+ * `@karmaniverous/jeeves` is BUNDLED into the plugin output — the plugin
+ * runs in OpenClaw's extensions directory where node_modules is not
+ * reliably available. All node: builtins are externalized.
+ *
+ * @module rollup.config
  */
 import type { RollupOptions } from 'rollup';
 declare const _default: RollupOptions[];

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

@@ -72,6 +72,21 @@ You have access to a **semantic archive** of your human's working world. Documen
 
 **The principle:** Memory-core is your curated highlights. The watcher archive is your perfect recall. Use memory first for speed and signal, but never let its narrow scope be the ceiling of what you can remember.
 
+## ⚠️ Embedding Cost — Hard Behavioral Gate
+
+**The watcher embeds every file it sees.** Embedding is the most expensive operation in the pipeline — each file triggers a Gemini API call. The index may contain hundreds of thousands of points. Any action that causes the watcher to process a large number of files has real, potentially significant cost.
+
+**STOP and ask for a human decision before:**
+
+- **Renaming, moving, or reorganizing watched directories.** A directory rename at the filesystem level is cheap — chokidar sees unlink + add events, but the content hasn't changed. However, if a rename is blocked (e.g., by a file lock from the watcher or another service), **do NOT work around it by creating new directories and copying/moving files**. That creates duplicate embeddings at the new paths while the old paths still exist. Instead: stop the blocking service, perform the rename, restart. This is a 30-second operation. The workaround can cost thousands of API calls.
+- **Changing `watch.paths` to add large directory trees.** Adding a new watch root triggers initial indexing of every matching file under it.
+- **Running `scope: "full"` reindex.** This re-embeds the entire index. Use `scope: "rules"` for inference rule changes (zero embedding cost — only metadata reapplication).
+- **Any bulk file operation** (mass copy, mass move, template-based file generation) under watched paths.
+
+**The right instinct when blocked:** If a filesystem operation fails because a service has a lock, the correct response is to stop the service, do the operation, and restart — NOT to find a creative workaround. Creative workarounds in the presence of a live watcher are how you accidentally trigger re-embedding of tens of thousands of files.
+
+**Cost context:** A single file embedding costs a Gemini API call. 1,000 unnecessary embeddings is a noticeable cost. 100,000 unnecessary embeddings (e.g., copying an entire domain directory to a new path) is a billing event worth flagging.
+
 ## Plugin Installation
 
 ```

package/dist/src/constants.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @module plugin/constants
+ * Shared constants for the OpenClaw plugin package.
+ *
+ * @remarks
+ * Imported by both the plugin bundle (`index.ts`) and the CLI bundle
+ * (`cli.ts`). Rollup inlines these into each output independently.
+ */
+/** Plugin identifier used in OpenClaw config and extensions directory. */
+export declare const PLUGIN_ID = "jeeves-watcher-openclaw";
+/** Default watcher API base URL. */
+export declare const DEFAULT_API_URL = "http://127.0.0.1:1936";
+/** 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.
+ *
+ * @remarks
+ * Must be generous enough to survive watcher startup (initial scan can
+ * take 15+ minutes on large filesystems). If the fetch hangs past this
+ * timeout, the `createAsyncContentCache` `refreshing` flag is cleared
+ * and the next cycle retries. Too short = unnecessary "unreachable"
+ * messages. Too long = `refreshing` deadlock when the server genuinely
+ * hangs. 10 seconds balances both concerns.
+ */
+export declare const MENU_FETCH_TIMEOUT_MS = 10000;

package/dist/src/helpers.d.ts

@@ -5,12 +5,24 @@
 /** Minimal OpenClaw plugin API surface used for tool registration. */
 export interface PluginApi {
     config?: {
+        agents?: {
+            defaults?: {
+                workspace?: string;
+            };
+        };
         plugins?: {
             entries?: Record<string, {
                 config?: Record<string, unknown>;
             }>;
         };
     };
+    /**
+     * Resolve a path relative to the OpenClaw workspace.
+     *
+     * @remarks
+     * Present on newer OpenClaw builds; optional for backwards compatibility.
+     */
+    resolvePath?: (input: string) => string;
     registerTool(tool: {
         name: string;
         description: string;
@@ -19,15 +31,6 @@ export interface PluginApi {
     }, options?: {
         optional?: boolean;
     }): void;
-    /**
-     * Optional internal hook registration (available on newer OpenClaw builds).
-     * We keep this optional to preserve compatibility.
-     */
-    registerHook?: (event: string | string[], handler: (event: unknown) => Promise<void> | void, opts?: {
-        name?: string;
-        description?: string;
-        register?: boolean;
-    }) => void;
 }
 /** Result shape returned by each tool execution. */
 export interface ToolResult {
@@ -39,6 +42,8 @@ export interface ToolResult {
 }
 /** Resolve the watcher API base URL from plugin config. */
 export declare function getApiUrl(api: PluginApi): string;
+/** Resolve the platform config root path from plugin config. */
+export declare function getConfigRoot(api: PluginApi): string;
 /** Format a successful tool result. */
 export declare function ok(data: unknown): ToolResult;
 /** Format a connection error with actionable guidance. */

package/dist/src/index.d.ts

@@ -1,6 +1,7 @@
 /**
  * @module plugin
- * OpenClaw plugin entry point. Registers all jeeves-watcher tools.
+ * OpenClaw plugin entry point. Registers all jeeves-watcher tools and starts
+ * the managed content writer via `@karmaniverous/jeeves` core.
  */
 import type { PluginApi } from './helpers.js';
 /** Register all jeeves-watcher tools with the OpenClaw plugin API. */

package/dist/src/watcherComponent.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @module plugin/watcherComponent
+ * Jeeves component integration for the watcher OpenClaw plugin.
+ *
+ * @remarks
+ * Uses `createAsyncContentCache()` from core to bridge the sync/async gap:
+ * `generateToolsContent()` must be synchronous, but the watcher menu requires
+ * 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';
+/** Options for creating the watcher component descriptor. */
+interface CreateWatcherComponentOptions {
+    /** Base URL of the jeeves-watcher HTTP API. */
+    apiUrl: string;
+    /** Plugin package version. */
+    pluginVersion: string;
+}
+/**
+ * Create the watcher `JeevesComponent` descriptor.
+ *
+ * @param options - API URL and plugin version.
+ * @returns A fully configured component descriptor ready for `createComponentWriter()`.
+ */
+export declare function createWatcherComponent(options: CreateWatcherComponentOptions): JeevesComponent;
+export {};

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

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

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

@@ -0,0 +1,5 @@
+/**
+ * @module plugin/writerIntegration.test
+ * Integration tests for the ComponentWriter lifecycle via jeeves-core.
+ */
+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.7.0",
+  "version": "0.8.1",
   "skills": [
     "dist/skills/jeeves-watcher"
   ],
@@ -14,6 +14,11 @@
         "type": "string",
         "description": "jeeves-watcher API base URL",
         "default": "http://127.0.0.1:1936"
+      },
+      "configRoot": {
+        "type": "string",
+        "description": "Platform config root path (e.g., j:/config)",
+        "default": "j:/config"
       }
     }
   },
@@ -21,6 +26,10 @@
     "apiUrl": {
       "label": "Watcher API URL",
       "placeholder": "http://127.0.0.1:1936"
+    },
+    "configRoot": {
+      "label": "Config root",
+      "placeholder": "j:/config"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karmaniverous/jeeves-watcher-openclaw",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "author": "Jason Williscroft",
   "description": "OpenClaw plugin for jeeves-watcher — semantic search and metadata enrichment tools",
   "license": "BSD-3-Clause",
@@ -20,6 +20,7 @@
   },
   "files": [
     "dist",
+    "content",
     "openclaw.plugin.json"
   ],
   "publishConfig": {
@@ -50,25 +51,33 @@
   },
   "auto-changelog": {
     "output": "CHANGELOG.md",
+    "tagPrefix": "openclaw/",
     "unreleased": true,
     "commitLimit": false,
     "hideCredit": true
   },
+  "dependencies": {
+    "@karmaniverous/jeeves": "^0.1.6"
+  },
   "devDependencies": {
-    "@dotenvx/dotenvx": "^1.54.1",
+    "@dotenvx/dotenvx": "^1.55.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.85.0",
+    "knip": "^5.87.0",
     "release-it": "^19.2.4",
     "rollup": "^4.59.0",
     "tslib": "^2.8.1",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.0"
   },
   "scripts": {
     "build:plugin": "rimraf dist && cross-env NO_COLOR=1 rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",
     "build:skills": "tsx scripts/build-skills.ts",
-    "build": "npm run build:plugin && npm run build:skills",
+    "build": "npm run build:plugin && npm run build:skills && npm run build:content",
+    "build:content": "node scripts/copy-content.mjs",
     "changelog": "auto-changelog",
     "lint": "eslint .",
     "lint:fix": "eslint --fix .",

package/dist/src/toolsWriter.d.ts

@@ -1,12 +0,0 @@
-/**
- * @module plugin/toolsWriter
- * Writes the Watcher menu section directly to TOOLS.md on disk.
- * Replaces the agent:bootstrap hook approach which was unreliable due to
- * OpenClaw's clearInternalHooks() wiping plugin-registered hooks on startup.
- */
-import { type PluginApi } from './helpers.js';
-/**
- * Start the periodic TOOLS.md writer.
- * Writes immediately on startup, then refreshes every REFRESH_INTERVAL_MS.
- */
-export declare function startToolsWriter(api: PluginApi): void;