@karmaniverous/jeeves-meta-openclaw 0.1.5 → 0.2.0

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

@@ -9,7 +9,7 @@ produce structured synthesis artifacts co-located with source content.
 
 ## Available Tools
 
-### synth_list
+### meta_list
 List all `.meta/` directories with summary stats and per-meta projection.
 Supports filtering by path prefix, error status, staleness, and lock state.
 Use for engine health checks and finding stale knowledge.
@@ -19,7 +19,7 @@ Use for engine health checks and finding stale knowledge.
 - `filter` (optional): Structured filter (`{ hasError: true }`, `{ staleHours: 24 }`)
 - `fields` (optional): Property projection array
 
-### synth_detail
+### meta_detail
 Full detail for a single meta, with optional archive history.
 
 **Parameters:**
@@ -27,19 +27,21 @@ Full detail for a single meta, with optional archive history.
 - `fields` (optional): Property projection
 - `includeArchive` (optional): false, true, or number (N most recent)
 
-### synth_preview
+### meta_preview
 Dry-run for the next synthesis cycle. Shows scope files, delta files,
 architect trigger reasons, steer status, and structure changes — without
-running any LLM calls. Use before `synth_trigger` to understand what
+running any LLM calls. Use before `meta_trigger` to understand what
 will happen.
 
 **Parameters:**
 - `path` (optional): Specific `.meta/` or owner directory path. If omitted,
   previews the stalest candidate.
 
-### synth_trigger
-Manually trigger a full synthesis cycle (architect → builder → critic) for
-a specific meta or the next-stalest candidate.
+### meta_trigger
+Enqueue a synthesis cycle for a specific meta or the next-stalest candidate.
+The synthesis runs asynchronously in the service queue; the tool returns
+immediately with the queue position. The full cycle (architect → builder →
+critic) runs in the background.
 
 **Parameters:**
 - `path` (optional): Specific `.meta/` or owner directory path. If omitted,
@@ -47,12 +49,12 @@ a specific meta or the next-stalest candidate.
 
 ## When to Use
 
-- **Checking synthesis health:** `synth_list`
-- **Finding stale knowledge:** `synth_list` with `filter: { staleHours: 24 }`
-- **Checking errors:** `synth_list` with `filter: { hasError: true }`
-- **Getting full details:** `synth_detail` with optional `includeArchive: 5`
-- **Understanding what a cycle will do:** `synth_preview`
-- **Forcing a refresh:** `synth_trigger` with optional path
+- **Checking synthesis health:** `meta_list`
+- **Finding stale knowledge:** `meta_list` with `filter: { staleHours: 24 }`
+- **Checking errors:** `meta_list` with `filter: { hasError: true }`
+- **Getting full details:** `meta_detail` with optional `includeArchive: 5`
+- **Understanding what a cycle will do:** `meta_preview`
+- **Forcing a refresh:** `meta_trigger` with optional path
 - **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
@@ -80,7 +82,7 @@ Key settings:
 | Setting | Default | Description |
 |---------|---------|-------------|
 | `watcherUrl` | (required) | Watcher service URL (e.g. `http://localhost:1936`) |
-| `gatewayUrl` | `http://127.0.0.1:3000` | OpenClaw gateway URL for subprocess spawning |
+| `gatewayUrl` | `http://127.0.0.1:18789` | OpenClaw gateway URL for subprocess spawning |
 | `gatewayApiKey` | (optional) | API key for gateway authentication |
 | `metaProperty` | `{ _meta: "current" }` | Watcher metadata properties applied to live `.meta/meta.json` files. `Record<string, unknown>` — any shape accepted. |
 | `metaArchiveProperty` | `{ _meta: "archive" }` | Watcher metadata properties applied to `.meta/archive/**` snapshots. Same shape flexibility. |
@@ -92,13 +94,18 @@ Key settings:
 | `builderTimeout` | 600s | Builder subprocess timeout |
 | `criticTimeout` | 300s | Critic subprocess timeout |
 | `skipUnchanged` | true | Skip candidates with no changes since last synthesis |
-| `batchSize` | 1 | Number of metas to synthesize per invocation |
+| `thinking` | `low` | Thinking level for spawned LLM sessions |
+| `port` | 1938 | HTTP API listen port |
+| `schedule` | `*/30 * * * *` | Cron expression for automatic synthesis scheduling |
+| `reportChannel` | (optional) | Gateway channel target for progress messages (e.g. Slack channel ID) |
+| `logging.level` | `info` | Log level (trace/debug/info/warn/error) |
+| `logging.file` | (optional) | Log file path |
 
 ### Meta Discovery
 
 Discovery is entirely watcher-based. The engine:
 
-1. **Registers virtual inference rules** at plugin startup. These rules match
+1. **Registers virtual inference rules** at service startup. These rules match
    file paths (`**/.meta/meta.json` and `**/.meta/archive/*.json`) and apply
    the configured `metaProperty`/`metaArchiveProperty` values as watcher
    metadata on those indexed points.
@@ -113,8 +120,8 @@ Discovery is entirely watcher-based. The engine:
 
 **Important:** If you change `metaProperty` or `metaArchiveProperty` in config,
 you must:
-- Restart the OpenClaw gateway (so the plugin re-registers virtual rules with
-  the new property values)
+- Restart the jeeves-meta service (so it re-registers virtual rules with the
+  new property values)
 - Trigger a watcher rules reindex (`watcher_reindex` with scope `rules`) so
   existing indexed points get retagged with the new properties
 
@@ -160,15 +167,34 @@ referenced via `@file:` in the config:
 **Per-meta overrides:** Set `_architect` or `_critic` directly in a `meta.json`
 to override the defaults for that specific entity.
 
+### Minimal Config Example
+
+A minimum viable config file requires only `watcherUrl`, `defaultArchitect`,
+and `defaultCritic`:
+
+```json
+{
+  "watcherUrl": "http://localhost:1936",
+  "gatewayUrl": "http://127.0.0.1:18789",
+  "gatewayApiKey": "your-api-key",
+  "defaultArchitect": "@file:prompts/architect.md",
+  "defaultCritic": "@file:prompts/critic.md"
+}
+```
+
+All other fields use sensible defaults (port 1938, schedule every 30 min,
+depth weight 0.5, etc). Add `reportChannel`, `metaProperty`, `logging`,
+etc. as needed.
+
 ### Adding New Metas
 
 1. Create the `.meta/` directory under the domain path
-2. Seed it: `npx @karmaniverous/jeeves-meta seed <path>` — creates `meta.json`
-   with a UUID and default fields
+2. Seed it: `jeeves-meta seed <path>` — creates `meta.json`
+   with a UUID (`_id`). All other fields are populated on first synthesis
 3. Optionally edit `meta.json` to set `_steer`, `_depth`, and `_emphasis`
 4. Wait for the watcher to index the new `meta.json` (typically seconds via
    chokidar file watching)
-5. The entity appears in `synth_list` on the next query
+5. The entity appears in `meta_list` on the next query
 
 ### Tuning Scheduling
 
@@ -179,85 +205,208 @@ to override the defaults for that specific entity.
 - **`architectEvery`:** Higher = fewer architect runs (cheaper but slower to
   adapt to structural changes).
 
+### Config Hot-Reload
+
+The following fields can be changed without restarting the service:
+- `schedule` — cron expression
+- `reportChannel` — progress reporting target
+- `logging.level` — log verbosity
+
+Edit the config file and save; the service detects changes via `fs.watchFile`.
+All other fields (including `metaProperty`, `port`, timeouts) require a service
+restart.
+
+### Progress Reporting
+
+When `reportChannel` is set, the service sends real-time progress messages
+to that channel via the OpenClaw gateway. Events include: synthesis started,
+phase started/completed (architect, builder, critic), synthesis completed,
+and errors. This uses
+`/tools/invoke` → `message` tool — zero LLM token cost.
+
+### TOOLS.md Bootstrapping Prompts
+
+The plugin's TOOLS.md injection automatically prompts bootstrapping:
+- **Service unreachable:** Shows "ACTION REQUIRED: jeeves-meta service is
+  unreachable" with troubleshooting steps and directs to this skill's
+  Bootstrapping section
+- **No entities found:** Shows "ACTION REQUIRED: No synthesis entities found"
+  and directs to this skill's Bootstrapping section
+
+These messages appear in the agent's system prompt, ensuring proactive
+discovery of configuration issues.
+
 ## Bootstrapping
 
 ### Prerequisites
 
 Before the synthesis engine can operate:
 
-1. **jeeves-watcher** must be running and indexing data
+1. **OpenClaw gateway** must be running (the service spawns LLM sessions
+   through it via `gatewayUrl`)
+   - Verify: `openclaw gateway status` or check the URL in config
+
+2. **jeeves-watcher** must be running and indexing data
    - Verify: `watcher_status` tool or `curl http://localhost:1936/status`
    - The watcher provides both semantic search and structured scan
 
-2. **Qdrant** must be running
+3. **Qdrant** must be running
    - Verify: `curl http://localhost:6333/healthz`
 
-3. **Config file** must exist at the path specified by `JEEVES_META_CONFIG`
+4. **Config file** must exist at the path specified by `JEEVES_META_CONFIG`
    - Must contain valid `watcherUrl`
    - Must contain `defaultArchitect` and `defaultCritic` (or `@file:` refs)
 
-4. **Prompt files** must exist if using `@file:` references
+5. **Prompt files** must exist if using `@file:` references
    - e.g. `J:\config\jeeves-meta\prompts\architect.md`
    - e.g. `J:\config\jeeves-meta\prompts\critic.md`
 
-5. **`.meta/` directories** must exist and be within paths the watcher indexes
-   - Seed new metas: `npx @karmaniverous/jeeves-meta seed <path>`
+6. **`.meta/` directories** must exist and be within paths the watcher indexes
+   - Seed new metas: `jeeves-meta seed <path>`
 
 ### Installation
 
-1. Install the OpenClaw plugin:
+1. Install and start the jeeves-meta service:
 
 ```bash
-npx @karmaniverous/jeeves-meta-openclaw install
+npm install -g @karmaniverous/jeeves-meta
+jeeves-meta start --config J:\config\jeeves-meta.config.json
 ```
 
-2. Set the config path environment variable (in the gateway's environment):
+2. Install the OpenClaw plugin:
 
+```bash
+npx @karmaniverous/jeeves-meta-openclaw install
 ```
-JEEVES_META_CONFIG=J:\config\jeeves-meta.config.json
+
+For non-default OpenClaw installations, set `OPENCLAW_CONFIG` (path to
+`openclaw.json`) or `OPENCLAW_HOME` (path to `.openclaw` directory).
+
+To uninstall: `npx @karmaniverous/jeeves-meta-openclaw uninstall`
+
+3. (Optional) Configure the plugin with the service URL — only needed if the
+   service runs on a non-default port or host:
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "jeeves-meta-openclaw": {
+        "enabled": true,
+        "config": {
+          "serviceUrl": "http://127.0.0.1:1938"
+        }
+      }
+    }
+  }
+}
 ```
 
-3. Restart the OpenClaw gateway to load the plugin.
+4. Restart the OpenClaw gateway to load the plugin.
 
-4. Verify: check that `## Meta` appears in TOOLS.md injection and
+5. Verify: check that `## Meta` appears in TOOLS.md injection and
    `jeeves-meta` appears in available skills.
 
 ### First Synthesis
 
-1. Check discovery: `synth_list` — should show your `.meta/` entities
-2. Preview: `synth_preview` — verify scope files and delta detection
-3. Trigger: `synth_trigger` — run the first cycle
-4. Review: `synth_detail <path>` with `includeArchive: 1` — check output quality
+1. Check discovery: `meta_list` — should show your `.meta/` entities
+2. Preview: `meta_preview` — verify scope files and delta detection
+3. Trigger: `meta_trigger` — run the first cycle
+4. Review: `meta_detail <path>` with `includeArchive: 1` — check output quality
 5. Iterate on `_steer` prompts if needed
 
-## Library CLI
+### System Service Management
+
+For production deployments, install as a system service:
+
+```bash
+jeeves-meta service install --config J:\config\jeeves-meta.config.json
+```
 
-The library ships a CLI for non-plugin operation:
+This prints OS-specific instructions:
+- **Windows:** NSSM service commands
+- **macOS:** launchd plist
+- **Linux:** systemd unit
 
+Management commands (print OS-specific equivalents):
 ```bash
-npx @karmaniverous/jeeves-meta <command> [options]
+jeeves-meta service start     # print start instructions
+jeeves-meta service stop      # print stop instructions
+jeeves-meta service status    # query running service via HTTP API
+jeeves-meta service remove    # print removal instructions
 ```
 
-Commands: `status`, `list`, `detail`, `preview`, `synthesize`, `seed`,
-`unlock`, `validate`, `config show`, `config check`.
+### HTTP API
+
+The service exposes these endpoints (default port 1938):
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | `/status` | Service health, queue state, dependency checks |
+| GET | `/metas` | List metas with filtering and field projection |
+| 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 | `/seed` | Create `.meta/` directory + meta.json |
+| POST | `/unlock` | Remove `.lock` file from a meta entity |
+| GET | `/config/validate` | Return sanitized active configuration |
+
+All endpoints return JSON. The OpenClaw plugin tools are thin wrappers
+around these endpoints.
+
+## Service CLI
+
+The service package ships a CLI:
+
+```bash
+jeeves-meta <command> [options]
+```
+
+Commands: `start`, `status`, `list`, `detail`, `preview`, `synthesize`,
+`seed`, `unlock`, `validate`, `service install|start|stop|status|remove`.
 
 Config resolution: `--config` flag → `JEEVES_META_CONFIG` env var → error.
-All commands support `--json` for machine-readable output.
+All client commands support `-p, --port` to specify the service port (default: 1938).
+The `start` command uses `--config`/`-c` instead (port is read from the config file).
+
+## Operational Monitoring
+
+Recommended periodic checks:
+- **Errors:** `meta_list` with `filter: { hasError: true }` — investigate
+  and retry with `meta_trigger`
+- **Stuck locks:** `meta_list` with `filter: { locked: true }` — locks
+  older than 30 minutes indicate a crashed synthesis; use `jeeves-meta unlock`
+- **Stale knowledge:** `meta_list` with `filter: { staleHours: 48 }` — check
+  if the scheduler is running and the watcher is up
+- **Service health:** `/status` endpoint (via `meta_list` summary or direct
+  HTTP) includes dependency status for watcher and gateway
+
+The TOOLS.md injection surfaces the most critical stats (entity count, errors,
+stalest entity) in the agent's system prompt automatically.
 
 ## Troubleshooting
 
+### Service unreachable
+
+**Symptom:** TOOLS.md shows "ACTION REQUIRED: jeeves-meta service is unreachable"
+**Cause:** Meta service not running or wrong `serviceUrl` in plugin config
+**Fix:**
+1. Check if the service is running: `jeeves-meta service status` or `curl http://localhost:1938/status`
+2. If down, start it: `jeeves-meta service start` or `jeeves-meta start --config <path>`
+3. If running on a different port, update `serviceUrl` in plugin config
+
 ### Watcher unreachable
 
-**Symptom:** TOOLS.md shows "ACTION REQUIRED: jeeves-watcher is unreachable"
-**Cause:** Watcher service not running or wrong URL in config
+**Symptom:** TOOLS.md shows a ⚠️ **Watcher** dependency warning in the entity summary
+**Cause:** Watcher service not running or wrong URL in meta service config
 **Fix:**
-1. Check watcher status: `watcher_status` tool
+1. Check watcher status: `watcher_status` tool or `curl http://localhost:1936/status`
 2. If down, start the watcher service
-3. If running on a different port, update `watcherUrl` in config
+3. If running on a different port, update `watcherUrl` in meta service config and restart the service
 
 ### No entities discovered
 
-**Symptom:** `synth_list` returns empty, TOOLS.md shows "No synthesis entities found"
+**Symptom:** `meta_list` returns empty, TOOLS.md shows "No synthesis entities found"
 **Cause:** No `.meta/meta.json` files indexed, or `metaProperty` mismatch
 **Fix:**
 1. Verify `.meta/meta.json` files exist on disk
@@ -265,22 +414,22 @@ All commands support `--json` for machine-readable output.
    configured `watch` globs)
 3. Check that `metaProperty` in config matches the properties actually set
    on indexed points. If you changed `metaProperty`, run `watcher_reindex`
-   with scope `rules` and restart the gateway.
-4. Seed new metas if needed: `npx @karmaniverous/jeeves-meta seed <path>`
+   with scope `rules` and restart the meta service.
+4. Seed new metas if needed: `jeeves-meta seed <path>`
 
 ### Synthesis stuck (locked entities)
 
-**Symptom:** `synth_list` shows locked entities that never unlock
+**Symptom:** `meta_list` shows locked entities that never unlock
 **Cause:** Previous synthesis crashed, leaving stale `.lock` file
 **Fix:**
-1. Check lock: `synth_detail <path>` — look for `locked: true`
+1. Check lock: `meta_detail <path>` — look for `locked: true`
 2. Locks auto-expire after 30 minutes
-3. For immediate unlock: `npx @karmaniverous/jeeves-meta unlock <path>`
+3. For immediate unlock: `jeeves-meta unlock <path>`
    or delete `.meta/.lock` file manually
 
 ### Executor timeouts
 
-**Symptom:** `synth_trigger` fails with timeout error
+**Symptom:** `meta_trigger` fails with timeout error
 **Cause:** Subprocess took longer than configured timeout
 **Fix:**
 1. Increase timeout in config (`architectTimeout`, `builderTimeout`,
@@ -290,24 +439,24 @@ All commands support `--json` for machine-readable output.
 
 ### LLM errors in synthesis steps
 
-**Symptom:** `synth_detail` shows `_error` field with step/code/message
+**Symptom:** `meta_detail` shows `_error` field with step/code/message
 **Cause:** Subprocess failed (API error, malformed output, rate limit)
 **Fix:**
-1. Check error details: `synth_detail <path>` — `_error.step` tells you
+1. Check error details: `meta_detail <path>` — `_error.step` tells you
    which step failed
 2. Architect failure with existing `_builder`: engine reuses cached brief
    (self-healing)
-3. Architect failure without `_builder` (first run): retry with `synth_trigger`
+3. Architect failure without `_builder` (first run): retry with `meta_trigger`
 4. Builder failure: meta stays stale, retried next cycle automatically
 5. Critic failure: content saved without feedback, not critical
 
 ### Discovery returns wrong/stale results
 
-**Symptom:** `synth_list` shows old metas or misses new ones
+**Symptom:** `meta_list` shows old metas or misses new ones
 **Cause:** Virtual rules not re-registered after config change, or watcher
 not yet indexed new files
 **Fix:**
-1. If `metaProperty` changed: restart gateway + `watcher_reindex` (scope: rules)
+1. If `metaProperty` changed: restart meta service + `watcher_reindex` (scope: rules)
 2. If new `.meta/` directory: wait for chokidar detection (seconds) or
    trigger `watcher_reindex` (scope: full)
 3. Verify with `watcher_scan`: query for the expected properties to confirm
@@ -315,11 +464,17 @@ not yet indexed new files
 
 ## Gotchas
 
-- `synth_trigger` runs a full LLM cycle (3 subprocess calls). It can take
+- `meta_trigger` runs a full LLM cycle (3 subprocess calls). It can take
   several minutes.
 - A locked meta (another synthesis in progress) will be skipped silently.
 - First-run quality is lower — the feedback loop needs 2-3 cycles to calibrate.
-- Changing `metaProperty` requires both a gateway restart AND a watcher reindex.
-  The gateway restart re-registers virtual rules; the reindex retags existing points.
+- Changing `metaProperty` requires both a meta service restart AND a watcher reindex.
+  The service restart re-registers virtual rules; the reindex retags existing points.
 - The `@file:` prefix in `defaultArchitect`/`defaultCritic` is resolved relative
   to the config file's directory, not the working directory.
+- The synthesis queue is single-threaded: one synthesis at a time. HTTP-triggered
+  syntheses get priority over scheduler-triggered ones.
+- The scheduler uses adaptive backoff: if no stale candidates are found, it
+  doubles the skip interval (max 4×). Backoff resets after a successful synthesis.
+- All CLI commands except `start` require the service to be running (they call
+  the HTTP API).

package/dist/src/helpers.d.ts

@@ -30,14 +30,14 @@ export interface ToolResult {
     isError?: boolean;
 }
 /**
- * Resolve the config file path.
+ * Resolve the service URL.
  *
  * Resolution order:
- * 1. Plugin config `configPath` setting
- * 2. `JEEVES_META_CONFIG` environment variable
- * 3. Error — no default path
+ * 1. Plugin config `serviceUrl` setting
+ * 2. `JEEVES_META_URL` environment variable
+ * 3. Default: http://127.0.0.1:1938
  */
-export declare function getConfigPath(api: PluginApi): string;
+export declare function getServiceUrl(api: PluginApi): string;
 /** Format a successful tool result. */
 export declare function ok(data: unknown): ToolResult;
 /** Format an error tool result. */

package/dist/src/index.d.ts

@@ -1,11 +1,11 @@
 /**
  * OpenClaw plugin for jeeves-meta.
  *
- * Registers synthesis tools, virtual inference rules, and starts
- * the periodic TOOLS.md writer at gateway startup.
+ * Thin HTTP client — all operations delegate to the jeeves-meta service.
+ * The plugin registers tools and starts the periodic TOOLS.md writer.
  *
  * @packageDocumentation
  */
-import type { PluginApi } from './helpers.js';
-/** Register all jeeves-meta tools and rules with the OpenClaw plugin API. */
+import { type PluginApi } from './helpers.js';
+/** Register all jeeves-meta tools with the OpenClaw plugin API. */
 export default function register(api: PluginApi): void;

package/dist/src/promptInjection.d.ts

@@ -1,21 +1,16 @@
 /**
  * Generate the Meta menu content for TOOLS.md injection.
  *
- * Queries the watcher API for synthesis entity stats and produces
+ * Queries the jeeves-meta service for entity stats and produces
  * a Markdown section suitable for agent system prompt injection.
  *
  * @module promptInjection
  */
-import { type SynthConfig } from '@karmaniverous/jeeves-meta';
+import type { MetaServiceClient } from './serviceClient.js';
 /**
  * Generate the Meta menu Markdown for TOOLS.md.
  *
- * Three output modes:
- * 1. Watcher unreachable - ACTION REQUIRED with diagnostic
- * 2. No entities found - ACTION REQUIRED with setup guidance
- * 3. Healthy - entity stats + tool listing + skill reference
- *
- * @param config - Full synth config (for listMetas and watcherUrl).
+ * @param client - MetaServiceClient instance.
  * @returns Markdown string for the Meta section.
  */
-export declare function generateMetaMenu(config: SynthConfig): Promise<string>;
+export declare function generateMetaMenu(client: MetaServiceClient): Promise<string>;

package/dist/src/serviceClient.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Thin HTTP client for the jeeves-meta service.
+ *
+ * Plugin delegates all operations to the running service via HTTP.
+ *
+ * @module serviceClient
+ */
+export interface MetaServiceConfig {
+    /** Base URL of the jeeves-meta service (e.g. http://127.0.0.1:1938). */
+    serviceUrl: string;
+}
+export declare class MetaServiceClient {
+    private readonly baseUrl;
+    constructor(config: MetaServiceConfig);
+    /** GET helper — returns parsed JSON. */
+    private get;
+    /** POST helper — returns parsed JSON. */
+    private post;
+    /** GET /status — service health + queue state. */
+    status(): Promise<unknown>;
+    /** GET /metas — list all meta entities with summary. */
+    listMetas(params?: {
+        pathPrefix?: string;
+        hasError?: boolean;
+        staleHours?: number;
+        neverSynthesized?: boolean;
+        locked?: boolean;
+        fields?: string[];
+    }): Promise<unknown>;
+    /** GET /metas/:path — detail for a single meta. */
+    detail(metaPath: string, options?: {
+        includeArchive?: boolean | number;
+        fields?: string[];
+    }): Promise<unknown>;
+    /** GET /preview — dry-run next synthesis candidate. */
+    preview(path?: string): Promise<unknown>;
+    /** POST /synthesize — enqueue synthesis. */
+    synthesize(path?: string): Promise<unknown>;
+    /** POST /seed — create .meta/ for a path. */
+    seed(path: string): Promise<unknown>;
+    /** POST /unlock — remove .lock from a meta entity. */
+    unlock(path: string): Promise<unknown>;
+    /** GET /config/validate — validate current config. */
+    validate(): Promise<unknown>;
+}

package/dist/src/tools.d.ts

@@ -1,8 +1,11 @@
 /**
- * Synth tool registrations for OpenClaw.
+ * Meta tool registrations for OpenClaw.
+ *
+ * All tools delegate to the jeeves-meta HTTP service.
  *
  * @module tools
  */
 import { type PluginApi } from './helpers.js';
-/** Register all synth_* tools. */
-export declare function registerSynthTools(api: PluginApi): void;
+import type { MetaServiceClient } from './serviceClient.js';
+/** Register all meta_* tools. */
+export declare function registerMetaTools(api: PluginApi, client: MetaServiceClient): void;

package/dist/src/toolsWriter.d.ts

@@ -6,8 +6,8 @@
  *
  * @module toolsWriter
  */
-import { type SynthConfig } from '@karmaniverous/jeeves-meta';
 import type { PluginApi } from './helpers.js';
+import type { MetaServiceClient } from './serviceClient.js';
 /**
  * Upsert the Meta section in TOOLS.md content.
  *
@@ -22,6 +22,6 @@ export declare function upsertMetaSection(existing: string, metaMenu: string): s
  * Defers first write by 5s, then refreshes every 60s.
  *
  * @param api - Plugin API.
- * @param watcherUrl - Watcher API base URL.
+ * @param client - MetaServiceClient instance.
  */
-export declare function startToolsWriter(api: PluginApi, config: SynthConfig): void;
+export declare function startToolsWriter(api: PluginApi, client: MetaServiceClient): void;

package/openclaw.plugin.json

@@ -2,16 +2,16 @@
   "id": "jeeves-meta-openclaw",
   "name": "Jeeves Meta",
   "description": "Knowledge synthesis tools — trigger synthesis, view status, manage entities.",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "skills": [
     "dist/skills/jeeves-meta"
   ],
   "configSchema": {
     "type": "object",
     "properties": {
-      "configPath": {
+      "serviceUrl": {
         "type": "string",
-        "description": "Path to jeeves-meta.config.json. Falls back to JEEVES_META_CONFIG env var."
+        "description": "URL of the jeeves-meta HTTP service. Defaults to http://127.0.0.1:1938. Falls back to JEEVES_META_URL env var."
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karmaniverous/jeeves-meta-openclaw",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "author": "Jason Williscroft",
   "description": "OpenClaw plugin for jeeves-meta — synthesis tools and virtual rule registration",
   "license": "BSD-3-Clause",
@@ -112,8 +112,5 @@
     "npm": {
       "publish": true
     }
-  },
-  "dependencies": {
-    "@karmaniverous/jeeves-meta": "*"
   }
 }

package/dist/src/configLoader.d.ts

@@ -1,6 +0,0 @@
-/**
- * Config loader — re-exports from the library package.
- *
- * @module configLoader
- */
-export { loadSynthConfig } from '@karmaniverous/jeeves-meta';