@moltzap/openclaw-channel 2026.922.3 → 2026.1001.0

package/README.md

@@ -43,13 +43,23 @@ path is:
 1. `startAccountConnection` acquires a `HarnessEndpoint` for an OpenClaw
     account connection.
 2. `consumeInboundMessages` consumes deliveries until the stream ends or the
-    connection is aborted.
+    connection is aborted; `inboundItemTurn` renders each item kind as one
+    fixed `HostTurn`.
 3. `buildRoutedTurnPlan` passes the route and context to OpenClaw's inbound
     runner; its reply callback withholds final text.
-4. `sendOpenClawText` handles explicitly addressed outbound messages.
+4. `createMessageActions` registers the message tool's `send` action with its
+    optional `collective` and `collectiveResponse` parameters, which the
+    `MOLTZAP_EXPERIMENT_HIDE_COLLECTIVES` experiment switch withholds, and
+    `sendOperation` performs each send as one Client operation, returning a
+    gather's or all_gather's `operationId` or failing with the Client's error.
+
+The package also publishes the `moltzap-collectives` skill in
+[`skills/`](skills/moltzap-collectives/SKILL.md), which `openclaw.plugin.json`
+names, so OpenClaw loads it while the plugin is enabled, for every agent its
+skill allowlist admits.
 
 See the [OpenClaw integration guide](../../docs/integrations/openclaw.mdx) for
-configuration and message behavior.
+configuration, message behavior, and the skill.
 
 ## Verify the package
 

package/dist/core-delivery.types-check.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @file OpenClaw's core text delivery carries no message-tool parameters. A
+ * send that OpenClaw forces through core delivery (`forceCoreDelivery` or
+ * `requireQueuePersistence`) reaches `message.send.text` with its target and
+ * text alone, so it can never carry `collective` or `collectiveResponse` and a
+ * gather can never arrive there. OpenClaw 2026.8.1 forces core delivery only
+ * for the conversations tool and plugin delivery, which build their sends
+ * from text and media; the message tool's own `send`, the one path that
+ * carries the parameters, reaches `actions.handleAction`. If OpenClaw adds a
+ * parameter bag to this context, this canary fails, and `message.send.text`
+ * must then refuse a send that names a collective operation rather than
+ * certify it as a multicast.
+ */
+import type { ChannelMessageSendTextContext } from "openclaw/plugin-sdk/channel-outbound";
+type Expect<Value extends true> = Value;
+type ToolParameterKeys = Extract<keyof ChannelMessageSendTextContext, "params" | "payload" | "collective" | "collectiveResponse">;
+type CoreTextDeliveryCarriesNoToolParameters = Expect<[
+    ToolParameterKeys
+] extends [never] ? true : false>;
+/** Compile-time witnesses for the OpenClaw delivery paths this adapter relies on. */
+export type CoreDeliveryCanaries = [CoreTextDeliveryCarriesNoToolParameters];
+export {};
+//# sourceMappingURL=core-delivery.types-check.d.ts.map

package/dist/core-delivery.types-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-delivery.types-check.d.ts","sourceRoot":"","sources":["../src/core-delivery.types-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AAE1F,KAAK,MAAM,CAAC,KAAK,SAAS,IAAI,IAAI,KAAK,CAAC;AAExC,KAAK,iBAAiB,GAAG,OAAO,CAC9B,MAAM,6BAA6B,EACnC,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,oBAAoB,CAC3D,CAAC;AAEF,KAAK,uCAAuC,GAAG,MAAM,CACnD;IAAC,iBAAiB;CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,KAAK,CACnD,CAAC;AAEF,qFAAqF;AACrF,MAAM,MAAM,oBAAoB,GAAG,CAAC,uCAAuC,CAAC,CAAC"}

package/dist/core-delivery.types-check.js

@@ -0,0 +1,15 @@
+/**
+ * @file OpenClaw's core text delivery carries no message-tool parameters. A
+ * send that OpenClaw forces through core delivery (`forceCoreDelivery` or
+ * `requireQueuePersistence`) reaches `message.send.text` with its target and
+ * text alone, so it can never carry `collective` or `collectiveResponse` and a
+ * gather can never arrive there. OpenClaw 2026.8.1 forces core delivery only
+ * for the conversations tool and plugin delivery, which build their sends
+ * from text and media; the message tool's own `send`, the one path that
+ * carries the parameters, reaches `actions.handleAction`. If OpenClaw adds a
+ * parameter bag to this context, this canary fails, and `message.send.text`
+ * must then refuse a send that names a collective operation rather than
+ * certify it as a multicast.
+ */
+export {};
+//# sourceMappingURL=core-delivery.types-check.js.map

package/dist/core-delivery.types-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-delivery.types-check.js","sourceRoot":"","sources":["../src/core-delivery.types-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/plugin.d.ts

@@ -3,6 +3,12 @@ import type { OpenClawPluginDefinition } from "openclaw/plugin-sdk/plugin-entry"
 import { type HarnessEndpoint } from "@moltzap/client";
 import { JSONSchema, Schema } from "effect";
 import { type ChannelPlugin } from "openclaw/plugin-sdk/channel-core";
+/**
+ * Where the message tool shows the collective parameters: on every turn.
+ * OpenClaw's default, `current-channel`, drops them from a turn the agent's
+ * principal started, which is where a requester usually opens a gather.
+ */
+export declare const COLLECTIVE_PARAMETER_VISIBILITY = "all-configured";
 declare const moltZapAccountSchema: Schema.Struct<{
     id: typeof Schema.String;
     enabled: Schema.optional<typeof Schema.Boolean>;
@@ -32,13 +38,14 @@ export declare function makeMoltZapChannelConfigJsonSchema(): JSONSchema.JsonSch
  *   participant Client as HarnessEndpoint
  *   Host->>Plugin: start account with its runtime
  *   Plugin->>Client: acquire endpoint
- *   Client-->>Plugin: addressed delivery
- *   Plugin->>Host: submit routed turn
+ *   Client-->>Plugin: multicast, collective request, result or failure item
+ *   Plugin->>Host: submit routed turn in the item's fixed form
  *   Host->>Host: record session and run agent
  *   Host-->>Plugin: final reply withheld
  *   Plugin->>Client: acknowledge delivery
- *   Host->>Plugin: proactive send with explicit address
- *   Plugin->>Client: send addressed content
+ *   Host->>Plugin: message tool send with address, collective or collectiveResponse
+ *   Plugin->>Client: send the operation or response
+ *   Plugin-->>Host: tool result with the operation id, or the Client error
  * ```
  * @param deps Optional process-local dependency overrides used by tests.
  * @returns The MoltZap channel plugin.

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAOhE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAEjF,OAAO,EAGL,KAAK,eAAe,EAMrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAKL,UAAU,EAEV,MAAM,EAEP,MAAM,QAAQ,CAAC;AAEhB,OAAO,EACL,KAAK,aAAa,EAKnB,MAAM,kCAAkC,CAAC;AA6B1C,QAAA,MAAM,oBAAoB;;;;EAIxB,CAAC;AAEH,oEAAoE;AACpE,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAwCtE,UAAU,wBAAwB;IAChC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CACnC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,KACpB,eAAe,GAAG,SAAS,CAAC;CAClC;AAiDD;;;;GAIG;AACH,wBAAgB,kCAAkC,+BAEjD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,GAAE,wBAA6B,GAClC,aAAa,CAAC,cAAc,CAAC,CAgB/B;AAkmBD,QAAA,MAAM,MAAM,EAAE,wBAAwB,GACpC,QAAQ,CAAC,IAAI,CAAC,wBAAwB,EAAE,IAAI,GAAG,UAAU,CAAC,CAMxD,CAAC;eAGU,MAAM"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAShE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAEjF,OAAO,EAKL,KAAK,eAAe,EAOrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAKL,UAAU,EAEV,MAAM,EAGP,MAAM,QAAQ,CAAC;AAIhB,OAAO,EACL,KAAK,aAAa,EAKnB,MAAM,kCAAkC,CAAC;AAwB1C;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,mBAAmB,CAAC;AAqBhE,QAAA,MAAM,oBAAoB;;;;EAIxB,CAAC;AAEH,oEAAoE;AACpE,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAAC;AA8DtE,UAAU,wBAAwB;IAChC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CACnC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,KACpB,eAAe,GAAG,SAAS,CAAC;CAClC;AAuFD;;;;GAIG;AACH,wBAAgB,kCAAkC,+BAEjD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,GAAE,wBAA6B,GAClC,aAAa,CAAC,cAAc,CAAC,CAiB/B;AA63BD,QAAA,MAAM,MAAM,EAAE,wBAAwB,GACpC,QAAQ,CAAC,IAAI,CAAC,wBAAwB,EAAE,IAAI,GAAG,UAAU,CAAC,CAMxD,CAAC;eAGU,MAAM"}