@claw-fact-bus/openclaw-plugin 1.0.0 → 1.0.1

package/README.md

@@ -71,12 +71,14 @@ python -m uvicorn src.claw_fact_bus.server.main:app --port 8080
 
 ## Features
 
-- **Publish Facts**: Emit facts to the bus for other claws to sense
+- **Sense (fact_bus_sense)**: Drain pending WebSocket events with action hints (call periodically)
+- **Publish Facts**: Emit facts to the bus; optional `parent_fact_id` for causation chains
 - **Query Facts**: Search and filter facts on the bus
-- **Claim Facts**: Claim exclusive facts for processing
-- **Resolve Facts**: Mark facts as resolved with optional child facts
+- **Claim / Release**: Claim exclusive facts, or release if you cannot finish
+- **Resolve Facts**: Mark facts resolved; child `result_facts` support `semantic_kind` (default resolution)
+- **Get Schema (fact_bus_get_schema)**: Look up payload structure for a `fact_type`
 - **Social Validation**: Corroborate or contradict facts for consensus building
-- **WebSocket Events**: Real-time fact notifications
+- **WebSocket subscription filters**: `semanticKinds`, `minEpistemicRank`, `minConfidence`, `subjectKeyPatterns`
 
 ## Installation
 
@@ -123,6 +125,12 @@ Add to your OpenClaw configuration:
 | `capabilityOffer` | string[] | `[]` | Capabilities this claw offers |
 | `domainInterests` | string[] | `[]` | Domains this claw is interested in |
 | `factTypePatterns` | string[] | `[]` | Fact type patterns to subscribe (glob) |
+| `priorityRange` | `[number, number]` | `[0, 7]` | Priority range for WebSocket filter |
+| `modes` | `("exclusive"\|"broadcast")[]` | both | Delivery modes to accept |
+| `semanticKinds` | string[] | `[]` (all) | Semantic kinds to subscribe |
+| `minEpistemicRank` | number | `-3` | Minimum epistemic trust rank |
+| `minConfidence` | number | `0` | Minimum publisher confidence |
+| `subjectKeyPatterns` | string[] | `[]` | Glob patterns for `subject_key` |
 | `autoReconnect` | boolean | `true` | Auto-reconnect WebSocket on disconnect |
 | `reconnectInterval` | number | `5000` | Reconnect interval in milliseconds |
 
@@ -130,6 +138,10 @@ Add to your OpenClaw configuration:
 
 Once installed, the following tools are available to your OpenClaw agent:
 
+### fact_bus_sense
+
+Drain buffered bus events (from WebSocket) with suggested next actions. Call regularly or after activity.
+
 ### fact_bus_publish
 
 Publish a new fact to the bus.

package/dist/{chunk-PR4QN5HX.js → chunk-7D4SUZUM.js}

@@ -13,10 +13,6 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 var __commonJS = (cb, mod) => function __require2() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
@@ -34,6 +30,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-export { __commonJS, __export, __require, __toESM };
-//# sourceMappingURL=chunk-PR4QN5HX.js.map
-//# sourceMappingURL=chunk-PR4QN5HX.js.map
+export { __commonJS, __require, __toESM };
+//# sourceMappingURL=chunk-7D4SUZUM.js.map
+//# sourceMappingURL=chunk-7D4SUZUM.js.map

package/dist/{chunk-PR4QN5HX.js.map → chunk-7D4SUZUM.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-PR4QN5HX.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-7D4SUZUM.js"}

package/dist/index.d.ts

@@ -1,14 +1,11 @@
 import * as openclaw_plugin_sdk_core from 'openclaw/plugin-sdk/core';
-import * as openclaw_plugin_sdk from 'openclaw/plugin-sdk';
+import { OpenClawPluginConfigSchema } from 'openclaw/plugin-sdk';
 
-/**
- * Claw Fact Bus OpenClaw Plugin Entry Point
- */
 declare const _default: {
     id: string;
     name: string;
     description: string;
-    configSchema: openclaw_plugin_sdk.OpenClawPluginConfigSchema;
+    configSchema: OpenClawPluginConfigSchema;
     register: NonNullable<openclaw_plugin_sdk_core.OpenClawPluginDefinition["register"]>;
 } & Pick<openclaw_plugin_sdk_core.OpenClawPluginDefinition, "kind">;