@karmaniverous/jeeves-server-openclaw 0.5.1 → 0.6.0

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

@@ -6,12 +6,15 @@ Operate and interact with a jeeves-server deployment. Use for file browsing, doc
 
 | Tool | Purpose |
 |------|---------|
-| `server_status` | Server health: version, uptime, Chrome availability, export formats, connected services |
+| `server_status` | Server health: version, uptime, port, Chrome availability, export formats, auth info |
 | `server_browse` | Get file/directory metadata and listings for a browse path |
 | `server_link_info` | Query available link types for a path (page URL, raw URL, export links) |
 | `server_share` | Generate share links with optional expiry and directory depth |
 | `server_export` | Trigger export (PDF, DOCX, SVG, PNG, ZIP) and get download URL |
 | `server_event_status` | Query event gateway status, active schemas, and recent event log |
+| `server_config` | Query resolved server configuration (supports JSONPath) |
+| `server_config_apply` | Apply a configuration patch to the running server |
+| `server_service` | Manage the system service (install, uninstall, start, stop, restart, status) |
 
 ## Browse Paths
 
@@ -44,8 +47,11 @@ Use `server_link_info` first to check which formats are available for a path.
 Run `server_status` to check:
 - Server version and uptime
 - Chrome availability (required for PDF export)
-- Connected services (watcher, runner) and their reachability
 - Available export formats and diagram languages
+- Auth configuration (insider count, key count)
+- Event gateway schemas
+
+Service health for companion services (watcher, runner, meta) is mediated through the server's `/status` endpoint. The plugin queries the server only — never watcher or runner directly.
 
 ## Bootstrap: Full Stack Setup
 
@@ -65,7 +71,13 @@ npm install -g @karmaniverous/jeeves-server
 
 ### 2. Create config
 
-Create `jeeves-server.config.json` (or any cosmiconfig-supported format) in the server's working directory:
+Generate a starter config:
+
+```bash
+jeeves-server init --config /path/to/config-dir
+```
+
+Or create `jeeves-server/config.json` manually (JSON only — cosmiconfig was removed):
 
 ```json
 {
@@ -107,36 +119,6 @@ Create `jeeves-server.config.json` (or any cosmiconfig-supported format) in the
 - `keys._plugin` — required for OpenClaw plugin auth
 - `outsiderPolicy` — optional global constraints on outsider sharing (can reference a named scope)
 
-### Named Scope Composition
-
-Define reusable scope policies at the top level, then reference them by name:
-
-```json
-{
-  "scopes": {
-    "standard": { "allow": ["/**"], "deny": ["/secrets/**"] },
-    "no-vc": { "deny": ["/projects/vc/**"] },
-    "no-private": { "deny": ["/projects/jill/**"] }
-  },
-  "insiders": {
-    "dev@example.com": { "scopes": ["standard", "no-vc"] },
-    "jill@example.com": {
-      "scopes": ["standard", "no-private"],
-      "allow": ["/projects/jill/**"]
-    }
-  }
-}
-```
-
-**Composition rules:**
-- Multiple named scopes are **unioned** — all `allow` and `deny` patterns merge
-- Explicit `allow`/`deny` on the insider or key entry act as **overrides** with highest precedence:
-  1. Explicit `deny` → **DENIED** (overrides named allow)
-  2. Explicit `allow` → **ALLOWED** (overrides named deny)
-  3. Standard named scope `allow AND NOT deny`
-
-This lets you compose broad policies (e.g. `no-private`) and surgically override them for specific users (e.g. Jill gets access to her own project).
-
 Environment variable substitution is supported: `${VAR_NAME}` in string values.
 
 Generate key seeds with:
@@ -148,11 +130,13 @@ node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
 
 ```bash
 jeeves-server config validate [--config <path>]
-jeeves-server config show [--config <path>]
+jeeves-server config [jsonpath] [--config <path>]
 ```
 
 ### 4. Register as system service
 
+Service commands execute directly (no more printing instructions):
+
 **Windows (NSSM):**
 ```bash
 jeeves-server service install [--config <path>]
@@ -162,8 +146,7 @@ jeeves-server service start
 **Linux (systemd):**
 ```bash
 jeeves-server service install [--config <path>]
-sudo systemctl enable jeeves-server
-sudo systemctl start jeeves-server
+jeeves-server service start
 ```
 
 ### 5. Configure Caddy reverse proxy
@@ -186,14 +169,12 @@ npx @karmaniverous/jeeves-server-openclaw install
 
 Configure the plugin in `openclaw.json` with `apiUrl` and `pluginKey` (matching the `_plugin` key seed from server config).
 
-**Note:** The installer handles plugin registration in `openclaw.json` automatically. If using `openclaw plugins install` instead (when available), you may need to manually add the plugin entry to `plugins.entries` in `openclaw.json` with `apiUrl` and `pluginKey` config values.
-
 Restart the gateway to load the plugin.
 
 ## Troubleshooting
 
 If the server is unreachable:
-1. Is the service running? → `jeeves-server service start`
+1. Is the service running? → `jeeves-server service status`
 2. Is the apiUrl correct? → Default: `http://127.0.0.1:1934`
 3. Is the `_plugin` key configured in both server config and plugin config?
 4. Is Caddy proxying to the correct port? → Check `Caddyfile`

package/dist/src/cli.d.ts

@@ -2,13 +2,8 @@
  * CLI for installing/uninstalling the jeeves-server OpenClaw plugin.
  *
  * 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
+ *   `npx @karmaniverous/jeeves-server-openclaw install`
+ *   `npx @karmaniverous/jeeves-server-openclaw uninstall`
  *
  * @packageDocumentation
  */

package/dist/src/serverTools.d.ts

@@ -1,6 +1,9 @@
 /**
- * Server tool registrations (server_* tools) for the OpenClaw plugin.
+ * Domain-specific server tool registrations for the OpenClaw plugin.
+ *
+ * Standard tools (`server_status`, `server_config`, `server_config_apply`,
+ * `server_service`) come from `createPluginToolset(descriptor)` in core.
  */
 import { type PluginApi } from '@karmaniverous/jeeves';
-/** Register all server_* tools with the OpenClaw plugin API. */
+/** Register all domain-specific server_* tools with the OpenClaw plugin API. */
 export declare function registerServerTools(api: PluginApi, baseUrl: string): void;

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.5.1",
+  "version": "0.6.0",
   "skills": [
     "dist/skills/jeeves-server"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karmaniverous/jeeves-server-openclaw",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "type": "module",
   "main": "dist/index.js",
   "scripts": {
@@ -115,6 +115,6 @@
     "hideCredit": true
   },
   "dependencies": {
-    "@karmaniverous/jeeves": "^0.3.0"
+    "@karmaniverous/jeeves": "^0.4.4"
   }
 }

package/dist/src/pluginRemove.d.ts

@@ -1,15 +0,0 @@
-/**
- * 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

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

package/dist/src/serviceCommands.d.ts

@@ -1,19 +0,0 @@
-/**
- * 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

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