@karmaniverous/jeeves-meta-openclaw 0.8.2 → 0.9.0

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

@@ -86,6 +86,17 @@ filtering to extract specific settings. Sensitive fields (e.g.
 - `path` (optional): JSONPath expression (e.g. `$.schedule`). If omitted,
   returns the full sanitized config.
 
+### meta_queue
+Queue management: list pending items, clear the queue, or abort current
+synthesis. The synthesis queue is single-threaded; use this tool to inspect
+what's running, clear queued work, or abort a stuck synthesis.
+
+**Parameters:**
+- `action` (required): One of `list`, `clear`, `abort`.
+  - `list`: Show current queue state (current synthesis, pending items).
+  - `clear`: Remove all pending queue items.
+  - `abort`: Stop the currently running synthesis and release its lock.
+
 ## When to Use
 
 - **Checking synthesis health:** `meta_list`
@@ -99,6 +110,9 @@ filtering to extract specific settings. Sensitive fields (e.g.
 - **Checking cross-ref health:** `meta_detail` with path — `crossRefs` array shows resolved/missing status
 - **Clearing a stuck lock:** `meta_unlock` with path
 - **Inspecting service config:** `meta_config` with optional JSONPath
+- **Checking queue state:** `meta_queue` with action `list`
+- **Clearing queued work:** `meta_queue` with action `clear`
+- **Aborting stuck synthesis:** `meta_queue` with action `abort`
 - **Reading synthesis output:** Use `watcher_search` filtered by the properties
   configured in `metaProperty` (e.g. `{ "domains": ["meta"] }` in production).
   The default properties are `{ _meta: "current" }` for live metas and
@@ -490,9 +504,13 @@ The service exposes these endpoints (default port 1938):
 | GET | `/metas/:path` | Single meta detail with optional archive |
 | GET | `/preview` | Dry-run next synthesis candidate |
 | POST | `/synthesize` | Enqueue synthesis (stalest or specific path) |
+| POST | `/synthesize/abort` | Abort the currently running synthesis |
 | POST | `/seed` | Create `.meta/` directory + meta.json |
 | POST | `/unlock` | Remove `.lock` file from a meta entity |
 | GET | `/config` | Query sanitized config with optional JSONPath (`?path=$.schedule`) |
+| POST | `/config/apply` | Apply a config patch (merge or replace) |
+| GET | `/queue` | Current queue state (current, pending, stats) |
+| POST | `/queue/clear` | Remove all pending queue items |
 
 All endpoints return JSON. The OpenClaw plugin tools are thin wrappers
 around these endpoints.

package/dist/src/cli.d.ts

@@ -1,18 +1,12 @@
 /**
  * CLI for installing/uninstalling the jeeves-meta OpenClaw plugin.
  *
+ * Uses `createPluginCli` from the core SDK for standard install/uninstall.
+ *
  * Usage:
  *   npx \@karmaniverous/jeeves-meta-openclaw install
  *   npx \@karmaniverous/jeeves-meta-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/customTools.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Custom domain-specific tool descriptors for the meta plugin.
+ *
+ * These tools supplement the standard factory-produced tools
+ * (meta_status, meta_config, meta_config_apply, meta_service).
+ *
+ * @module customTools
+ */
+import { type ToolDescriptor } from '@karmaniverous/jeeves';
+import type { MetaServiceClient } from './serviceClient.js';
+/** Build the array of custom domain-specific tool descriptors. */
+export declare function buildCustomTools(client: MetaServiceClient, baseUrl: string): ToolDescriptor[];

package/dist/src/serviceClient.d.ts

@@ -87,10 +87,16 @@ export declare class MetaServiceClient {
     /** POST /synthesize — enqueue synthesis. */
     synthesize(path?: string): Promise<unknown>;
     /** POST /seed — create .meta/ for a path. */
-    seed(path: string, crossRefs?: string[]): Promise<unknown>;
+    seed(path: string, crossRefs?: string[], steer?: string): Promise<unknown>;
     /** POST /unlock — remove .lock from a meta entity. */
     unlock(path: string): Promise<unknown>;
     /** GET /config — query service config with optional JSONPath. */
     config(path?: string): Promise<unknown>;
+    /** GET /queue — current queue state. */
+    queue(): Promise<unknown>;
+    /** POST /queue/clear — remove all pending queue items. */
+    clearQueue(): Promise<unknown>;
+    /** POST /synthesize/abort — abort current synthesis. */
+    abort(): Promise<unknown>;
 }
 export {};

package/dist/src/tools.d.ts

@@ -1,12 +1,13 @@
 /**
  * Meta tool registrations for OpenClaw.
  *
- * All tools delegate to the jeeves-meta HTTP service.
- * Tool names and descriptions are sourced from {@link META_TOOLS}.
+ * Standard tools (status, config, config_apply, service) are produced
+ * by `createPluginToolset()`. Custom domain-specific tools are
+ * registered here alongside them.
  *
  * @module tools
  */
-import { type PluginApi } from '@karmaniverous/jeeves';
+import { type JeevesComponentDescriptor, type PluginApi } from '@karmaniverous/jeeves';
 import type { MetaServiceClient } from './serviceClient.js';
-/** Register all meta_* tools. */
-export declare function registerMetaTools(api: PluginApi, client: MetaServiceClient): void;
+/** Register all meta_* tools (standard + custom). */
+export declare function registerMetaTools(api: PluginApi, client: MetaServiceClient, descriptor: JeevesComponentDescriptor): void;

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "jeeves-meta-openclaw",
   "name": "Jeeves Meta",
   "description": "Knowledge synthesis tools — trigger synthesis, view status, manage entities.",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "skills": [
     "dist/skills/jeeves-meta"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karmaniverous/jeeves-meta-openclaw",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "author": "Jason Williscroft",
   "description": "OpenClaw plugin for jeeves-meta — synthesis tools and virtual rule registration",
   "license": "BSD-3-Clause",
@@ -57,6 +57,7 @@
     "tagPrefix": "openclaw/"
   },
   "devDependencies": {
+    "@commander-js/extra-typings": "^14.0.0",
     "@dotenvx/dotenvx": "^1.55.1",
     "@rollup/plugin-commonjs": "^29.0.2",
     "@rollup/plugin-node-resolve": "^16.0.3",
@@ -80,7 +81,7 @@
     "test": "vitest run",
     "typecheck": "tsc",
     "diagrams": "cd diagrams && plantuml -tpng -o ../assets -r .",
-    "build:plugin": "rimraf dist && cross-env NO_COLOR=1 rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",
+    "build:plugin": "rimraf dist && cross-env NO_COLOR=1 rollup --config rollup.config.mjs",
     "build:skills": "node scripts/build-skills.mjs",
     "build:content": "node scripts/copy-content.mjs"
   },
@@ -119,6 +120,6 @@
     }
   },
   "dependencies": {
-    "@karmaniverous/jeeves": "^0.3.0"
+    "@karmaniverous/jeeves": "^0.4.4"
   }
 }

package/dist/src/serviceCommands.d.ts

@@ -1,16 +0,0 @@
-/**
- * ServiceCommands and PluginCommands implementations for the JeevesComponent
- * descriptor. Separated from register() for single-responsibility.
- *
- * @module serviceCommands
- */
-import type { PluginCommands, ServiceCommands } from '@karmaniverous/jeeves';
-import type { MetaServiceClient } from './serviceClient.js';
-/**
- * Create ServiceCommands that proxy to the meta HTTP service.
- *
- * @param client - MetaServiceClient instance.
- */
-export declare function createServiceCommands(client: MetaServiceClient): ServiceCommands;
-/** Create PluginCommands (uninstall handled by CLI). */
-export declare function createPluginCommands(): PluginCommands;

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

@@ -1,6 +0,0 @@
-/**
- * Tests for ServiceCommands — status mapping and error handling.
- *
- * @module serviceCommands.test
- */
-export {};

package/dist/src/toolMeta.d.ts

@@ -1,16 +0,0 @@
-/**
- * Tool name/description pairs — single source of truth for tool registration
- * and placeholder content.
- *
- * @module toolMeta
- */
-/** Metadata for a single meta_* tool. */
-interface ToolMeta {
-    /** Tool name as registered with OpenClaw. */
-    name: string;
-    /** Human-readable description. */
-    description: string;
-}
-/** Ordered list of meta_* tools. */
-export declare const META_TOOLS: readonly ToolMeta[];
-export {};