@karmaniverous/jeeves-server-openclaw 0.3.0 → 0.4.0

package/dist/rollup.config.d.ts

@@ -1,6 +1,11 @@
 /**
  * Rollup configuration for the OpenClaw plugin package.
  * Two entry points: plugin (ESM + declarations) and CLI (ESM executable).
+ *
+ * @remarks
+ * `@karmaniverous/jeeves` is bundled (not external) because the plugin runs
+ * inside `~/.openclaw/extensions/` where there is no `node_modules` tree.
+ * Node builtins remain external since they're always available at runtime.
  */
 import type { RollupOptions } from 'rollup';
 declare const _default: RollupOptions[];

package/dist/src/cli.d.ts

@@ -4,5 +4,12 @@
  * Usage:
  *   npx \@karmaniverous/jeeves-server-openclaw install
  *   npx \@karmaniverous/jeeves-server-openclaw uninstall
+ *
+ * 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 declare function patchConfig(config: Record<string, unknown>, mode: 'add' | 'remove'): string[];
+export {};

package/dist/src/constants.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Shared constants for the jeeves-server OpenClaw plugin.
+ */
+/** Plugin identifier used in OpenClaw config and extension paths. */
+export declare const PLUGIN_ID = "jeeves-server-openclaw";

package/dist/src/helpers.d.ts

@@ -1,46 +1,17 @@
 /**
- * Shared types and utility functions for the OpenClaw plugin tool registrations.
+ * Server-specific HMAC authentication helpers for the OpenClaw plugin.
+ *
+ * @remarks
+ * These helpers handle insider key derivation and URL signing for
+ * authenticated requests to jeeves-server. Generic helpers (ok, fail,
+ * connectionFail, fetchJson, etc.) are imported from `@karmaniverous/jeeves`.
+ *
+ * @module helpers
  */
-/** Minimal OpenClaw plugin API surface used for tool registration. */
-export interface PluginApi {
-    config?: {
-        plugins?: {
-            entries?: Record<string, {
-                config?: Record<string, unknown>;
-            }>;
-        };
-    };
-    resolvePath?: (input: string) => string;
-    registerTool(tool: {
-        name: string;
-        description: string;
-        parameters: Record<string, unknown>;
-        execute: (id: string, params: Record<string, unknown>) => Promise<ToolResult>;
-    }, options?: {
-        optional?: boolean;
-    }): void;
-}
-/** Result shape returned by each tool execution. */
-export interface ToolResult {
-    content: Array<{
-        type: string;
-        text: string;
-    }>;
-    isError?: boolean;
-}
-/** Resolve the server API base URL from plugin config. */
-export declare function getApiUrl(api: PluginApi): string;
+import type { PluginApi } from '@karmaniverous/jeeves';
 /** Resolve the plugin key seed from plugin config. */
 export declare function getPluginKey(api: PluginApi): string | undefined;
 /** Derive HMAC key from seed. */
 export declare function deriveKey(seed: string): string;
 /** Append auth key query param to a URL. */
 export declare function withAuth(url: string, keySeed: string | undefined): string;
-/** Format a successful tool result. */
-export declare function ok(data: unknown): ToolResult;
-/** Format an error tool result. */
-export declare function fail(error: unknown): ToolResult;
-/** Format a connection error with actionable guidance. */
-export declare function connectionFail(error: unknown, baseUrl: string): ToolResult;
-/** Fetch JSON from a URL, throwing on non-OK responses. */
-export declare function fetchJson(url: string, init?: RequestInit): Promise<unknown>;

package/dist/src/index.d.ts

@@ -1,6 +1,9 @@
 /**
- * OpenClaw plugin entry point. Registers all jeeves-server tools.
+ * OpenClaw plugin entry point for jeeves-server.
+ *
+ * Registers server_* tools, initializes the jeeves-core library,
+ * and starts a ComponentWriter to manage the Server section in TOOLS.md.
  */
-import type { PluginApi } from './helpers.js';
-/** Register all jeeves-server tools with the OpenClaw plugin API. */
+import { type PluginApi } from '@karmaniverous/jeeves';
+/** Register all jeeves-server tools and start the TOOLS.md writer. */
 export default function register(api: PluginApi): void;

package/dist/src/pluginRemove.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared plugin removal logic for extension directory and config cleanup.
+ *
+ * @remarks
+ * Used by both the CLI `uninstall` command and the in-process
+ * `PluginCommands.uninstall()` implementation.
+ */
+/**
+ * Remove the plugin extension directory and patch the OpenClaw config.
+ *
+ * @param home - OpenClaw home directory path.
+ * @param configPath - OpenClaw config file path.
+ * @returns Messages describing what was changed.
+ */
+export declare function removePlugin(home: string, configPath: string): string[];

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

@@ -0,0 +1,4 @@
+/**
+ * Tests for shared plugin removal logic.
+ */
+export {};

package/dist/src/serverTools.d.ts

@@ -1,6 +1,6 @@
 /**
  * Server tool registrations (server_* tools) for the OpenClaw plugin.
  */
-import { type PluginApi } from './helpers.js';
+import { type PluginApi } from '@karmaniverous/jeeves';
 /** Register all server_* tools with the OpenClaw plugin API. */
 export declare function registerServerTools(api: PluginApi, baseUrl: string): void;

package/dist/src/serviceCommands.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Service and plugin lifecycle commands for the JeevesComponent interface.
+ *
+ * Wraps NSSM service management (JeevesServer) and plugin uninstall
+ * via shared removal logic.
+ */
+import { type PluginCommands, type ServiceCommands } from '@karmaniverous/jeeves';
+/**
+ * Create service lifecycle commands for the JeevesServer NSSM service.
+ *
+ * @returns ServiceCommands implementation.
+ */
+export declare function createServiceCommands(): ServiceCommands;
+/**
+ * Create plugin lifecycle commands for the OpenClaw plugin.
+ *
+ * @returns PluginCommands implementation.
+ */
+export declare function createPluginCommands(): PluginCommands;

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

@@ -0,0 +1,4 @@
+/**
+ * Tests for service and plugin lifecycle commands.
+ */
+export {};

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "jeeves-server-openclaw",
   "name": "Jeeves Server",
   "description": "File browsing, document sharing, export, and event gateway tools for jeeves-server.",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "skills": [
     "dist/skills/jeeves-server"
   ],
@@ -18,6 +18,11 @@
       "pluginKey": {
         "type": "string",
         "description": "Server _plugin key seed (for authenticated API calls)"
+      },
+      "configRoot": {
+        "type": "string",
+        "description": "Platform config root directory (e.g. j:/config). Core derives component config dirs from this path.",
+        "default": "j:/config"
       }
     }
   },
@@ -29,6 +34,10 @@
     "pluginKey": {
       "label": "Plugin Key Seed",
       "placeholder": "hex string from server config keys._plugin"
+    },
+    "configRoot": {
+      "label": "Config Root",
+      "placeholder": "j:/config"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karmaniverous/jeeves-server-openclaw",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "main": "dist/index.js",
   "scripts": {
@@ -17,14 +17,17 @@
     "release:pre": "dotenvx run -f .env.local -- release-it --no-git.requireBranch --github.prerelease --preRelease"
   },
   "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",
     "release-it": "^19.2.4",
     "rollup": "^4.59.0",
     "tslib": "^2.8.1",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.0"
   },
   "author": "Jason Williscroft",
   "description": "OpenClaw plugin for jeeves-server — file browsing, sharing, export, and event gateway tools",
@@ -103,5 +106,15 @@
     "npm": {
       "publish": true
     }
+  },
+  "auto-changelog": {
+    "output": "CHANGELOG.md",
+    "tagPrefix": "openclaw/",
+    "unreleased": true,
+    "commitLimit": false,
+    "hideCredit": true
+  },
+  "dependencies": {
+    "@karmaniverous/jeeves": "^0.2.0"
   }
 }

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

@@ -1 +0,0 @@
-export {};

package/dist/src/toolsWriter.d.ts

@@ -1,8 +0,0 @@
-/**
- * Writes the Server menu section directly to TOOLS.md on disk.
- */
-import { type PluginApi } from './helpers.js';
-/**
- * Start the periodic TOOLS.md writer.
- */
-export declare function startToolsWriter(api: PluginApi): void;