@moltzap/client 2026.1001.2 → 2026.1004.0

package/dist/transport/collectives/index.d.ts

@@ -0,0 +1,10 @@
+/** @file The collective operations the daemon service composes. */
+/** The daemon's stateful gather and all_gather operations. */
+export { type CollectiveOperations, makeCollectiveOperations, } from "./operation.js";
+/** The failure an emit port returns when the service cannot keep an item. */
+export { CollectiveEmitError } from "./forms.js";
+/** The items those operations emit. */
+export type { InboundItem } from "./inbound.js";
+/** The collective part carried in a post's content. */
+export { collectiveIdOf, readCollectiveValue } from "./wire.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/collectives/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/collectives/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,8DAA8D;AAC9D,OAAO,EACL,KAAK,oBAAoB,EACzB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AACxB,6EAA6E;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,uCAAuC;AACvC,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,uDAAuD;AACvD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/transport/collectives/index.js

@@ -0,0 +1,8 @@
+/** @file The collective operations the daemon service composes. */
+/** The daemon's stateful gather and all_gather operations. */
+export { makeCollectiveOperations, } from "./operation.js";
+/** The failure an emit port returns when the service cannot keep an item. */
+export { CollectiveEmitError } from "./forms.js";
+/** The collective part carried in a post's content. */
+export { collectiveIdOf, readCollectiveValue } from "./wire.js";
+//# sourceMappingURL=index.js.map

package/dist/transport/collectives/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transport/collectives/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,8DAA8D;AAC9D,OAAO,EAEL,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AACxB,6EAA6E;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGjD,uDAAuD;AACvD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/transport/collectives/message-text.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @file Reads the operation a message's text states.
+ *
+ * In native hosts, a model reaches every operation through the ordinary
+ * message tool, as message text. The OpenClaw and NanoClaw adapters use
+ * {@link parseMessageText}, so both hosts accept the same text:
+ *
+ * ```
+ * plain text                                                   multicast
+ * {"gather": "Which day?", "deadline": 600, "requestedSchema": {...}}
+ * {"all_gather": "Which day?", "deadline": 600, "requestedSchema": {...}}
+ * {"action": "accept", "content": {...}}                        answer
+ * {"action": "decline"}                                         answer
+ * ```
+ *
+ * Only a whole text that is a JSON object with a `gather`, `all_gather` or
+ * `action` key states an operation; any other text, JSON-looking prose
+ * included, is a multicast of that text. A text that states an operation but
+ * fails validation is refused, never sent as text, because the model meant
+ * the operation and the error names the field to fix.
+ */
+import { Either } from "effect";
+import type { MessageAddressInput } from "../messaging/address.js";
+import { SendInput } from "./forms.js";
+/** Which operation a refused text stated. */
+type StatedOperation = "message" | "gather" | "all_gather" | "answer";
+declare const MessageTextError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "MessageTextError";
+} & Readonly<A>;
+/**
+ * A message text states an operation it does not validly carry, or is plain
+ * text that is not well-formed Unicode. The message names each failing field
+ * so a host can hand it to its model as the tool error.
+ */
+export declare class MessageTextError extends MessageTextError_base<{
+    readonly operation: StatedOperation;
+    readonly detail: string;
+}> {
+    get message(): string;
+}
+/**
+ * Read one message text as the send it states.
+ * @param to The address the host's tool call names: the recipients of a
+ *   multicast, gather or all_gather, or for an answer the conversation whose
+ *   open request it answers.
+ * @param text The whole text of the message.
+ * @returns The send input, or an error naming each field a stated operation
+ *   gets wrong.
+ */
+export declare const parseMessageText: (to: MessageAddressInput, text: string) => Either.Either<SendInput, MessageTextError>;
+export {};
+//# sourceMappingURL=message-text.d.ts.map

package/dist/transport/collectives/message-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-text.d.ts","sourceRoot":"","sources":["../../../src/transport/collectives/message-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAQ,MAAM,EAA0C,MAAM,QAAQ,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,OAAO,EAKL,SAAS,EACV,MAAM,YAAY,CAAC;AAIpB,6CAA6C;AAC7C,KAAK,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;;;;AAEtE;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,sBAAqC;IACzE,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;IACA,IAAa,OAAO,IAAI,MAAM,CAE7B;CACF;AAoCD;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,OACvB,mBAAmB,QACjB,MAAM,KACX,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAKxC,CAAC"}

package/dist/transport/collectives/message-text.js

@@ -0,0 +1,118 @@
+/**
+ * @file Reads the operation a message's text states.
+ *
+ * In native hosts, a model reaches every operation through the ordinary
+ * message tool, as message text. The OpenClaw and NanoClaw adapters use
+ * {@link parseMessageText}, so both hosts accept the same text:
+ *
+ * ```
+ * plain text                                                   multicast
+ * {"gather": "Which day?", "deadline": 600, "requestedSchema": {...}}
+ * {"all_gather": "Which day?", "deadline": 600, "requestedSchema": {...}}
+ * {"action": "accept", "content": {...}}                        answer
+ * {"action": "decline"}                                         answer
+ * ```
+ *
+ * Only a whole text that is a JSON object with a `gather`, `all_gather` or
+ * `action` key states an operation; any other text, JSON-looking prose
+ * included, is a multicast of that text. A text that states an operation but
+ * fails validation is refused, never sent as text, because the model meant
+ * the operation and the error names the field to fix.
+ */
+import { Data, Either, Option, ParseResult, Predicate, Schema } from "effect";
+import { exactStruct } from "../wire/values.js";
+import { AnswerContent, DeadlineSeconds, RequestedSchema, SendInput, } from "./forms.js";
+/**
+ * A message text states an operation it does not validly carry, or is plain
+ * text that is not well-formed Unicode. The message names each failing field
+ * so a host can hand it to its model as the tool error.
+ */
+export class MessageTextError extends Data.TaggedError("MessageTextError") {
+    get message() {
+        return `${this.operation} not sent: ${this.detail}`;
+    }
+}
+const GatherText = exactStruct({
+    gather: Schema.String,
+    deadline: DeadlineSeconds,
+    requestedSchema: RequestedSchema,
+});
+const AllGatherText = exactStruct({
+    all_gather: Schema.String,
+    deadline: DeadlineSeconds,
+    requestedSchema: RequestedSchema,
+});
+const AcceptText = exactStruct({
+    action: Schema.Literal("accept"),
+    content: AnswerContent,
+});
+const DeclineText = exactStruct({
+    action: Schema.Literal("decline"),
+});
+/** The `action` key alone, so an unknown action is named as that field. */
+const AnswerAction = Schema.Struct({
+    action: Schema.Literal("accept", "decline"),
+});
+const decodeJsonText = Schema.decodeUnknownOption(Schema.parseJson(Schema.Unknown));
+/** The JSON object a whole text is, if it is one. */
+const jsonObject = (text) => decodeJsonText(text).pipe(Option.filter(Predicate.isRecord));
+/**
+ * Read one message text as the send it states.
+ * @param to The address the host's tool call names: the recipients of a
+ *   multicast, gather or all_gather, or for an answer the conversation whose
+ *   open request it answers.
+ * @param text The whole text of the message.
+ * @returns The send input, or an error naming each field a stated operation
+ *   gets wrong.
+ */
+export const parseMessageText = (to, text) => Option.match(jsonObject(text), {
+    onNone: () => sendInput("message", { to, text }),
+    onSome: (value) => statedOperation(to, value) ?? sendInput("message", { to, text }),
+});
+/**
+ * The operation a JSON object states by its key, or undefined when it has
+ * none of `gather`, `all_gather` and `action` and so is plain text.
+ */
+function statedOperation(to, value) {
+    if (Object.hasOwn(value, "gather")) {
+        return decodeText("gather", GatherText, value).pipe(Either.flatMap((stated) => sendInput("gather", {
+            to,
+            text: stated.gather,
+            collective: { ...collecting(stated), op: "gather" },
+        })));
+    }
+    if (Object.hasOwn(value, "all_gather")) {
+        return decodeText("all_gather", AllGatherText, value).pipe(Either.flatMap((stated) => sendInput("all_gather", {
+            to,
+            text: stated.all_gather,
+            collective: { ...collecting(stated), op: "all_gather" },
+        })));
+    }
+    return Object.hasOwn(value, "action") ? answer(to, value) : undefined;
+}
+function collecting(stated) {
+    return { deadline: stated.deadline, requestedSchema: stated.requestedSchema };
+}
+/** An answer: `action` decides which shape the rest must have. */
+function answer(to, value) {
+    return decodeText("answer", AnswerAction, value).pipe(Either.flatMap(({ action }) => action === "accept"
+        ? decodeText("answer", AcceptText, value)
+        : decodeText("answer", DeclineText, value)), Either.flatMap((collectiveResponse) => sendInput("answer", { to, collectiveResponse })));
+}
+function sendInput(operation, value) {
+    return decodeText(operation, SendInput, value);
+}
+function decodeText(operation, schema, value) {
+    return Schema.decodeUnknownEither(schema, { errors: "all" })(value).pipe(Either.mapLeft((error) => new MessageTextError({ operation, detail: describeIssues(error) })));
+}
+/**
+ * One line per issue, each led by its field path, such as
+ * `requestedSchema.type: Expected "object", actual "obj"`.
+ */
+function describeIssues(error) {
+    return ParseResult.ArrayFormatter.formatErrorSync(error)
+        .map(({ path, message }) => path.length === 0 ? message : `${path.map(String).join(".")}: ${message}`)
+        .join("; ");
+}
+/* eslint-enable @typescript-eslint/naming-convention -- Restore the package naming rules after the text Schemas. */
+//# sourceMappingURL=message-text.js.map

package/dist/transport/collectives/message-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-text.js","sourceRoot":"","sources":["../../../src/transport/collectives/message-text.ts"],"names":[],"mappings":"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"}

package/dist/{endpoint/collective → transport/collectives}/operation.d.ts

@@ -21,14 +21,15 @@
  *   RM->>RE: send gather to, question, deadline, schema
  *   RE->>RE: validate schema, mint id<br>deadline = now + duration
  *   RE->>ME: one request post per member
- *   alt a request post is refused
+ *   alt no request post is accepted
  *     RE-->>RM: error naming each unreachable member
- *   else every request post accepted
+ *   else some request post accepted
  *     RE-->>RM: operation id
+ *     RE->>RE: record each refused or uncertified member as no-answer
  *   end
  *   ME->>MM: collectiveRequest item
- *   MM->>ME: send collectiveResponse id, action, content
- *   ME->>ME: validate content against the stored schema
+ *   MM->>ME: send collectiveResponse to the requester, action, content
+ *   ME->>ME: match the request open in that conversation<br>validate content against its schema
  *   ME->>RE: response post in the direct conversation
  *   RE->>RE: consume, validate and record the answer
  *   Note over RE: complete when every member has an outcome<br>or at the deadline
@@ -54,8 +55,8 @@
  *     RE-->>RM: operation id
  *   end
  *   ME->>MM: collectiveRequest item
- *   MM->>ME: send collectiveResponse id, action, content
- *   ME->>ME: validate content against the stored schema
+ *   MM->>ME: send collectiveResponse to the group, action, content
+ *   ME->>ME: match the request open in the group<br>validate content against its schema
  *   ME->>RE: response post to the group
  *   ME->>ME: peer response posts, consumed and recorded by record hash
  *   Note over RE: complete when every member has an outcome<br>or at the deadline
@@ -66,9 +67,14 @@
  * ```
  */
 import { Duration, Effect, Option, type Scope } from "effect";
-import type { EngineSendInput, EngineSentPost } from "../engine-types.js";
-import type { RecordHash } from "../representation.js";
-import { AgentAddress, CollectiveError, type FailureDelivery, type InboundItem, type InboundMessage, SendError, type SendInput, type SendResult } from "../../contract.js";
+import type { EngineSendInput, EngineSentPost } from "../messaging/index.js";
+import type { InboundMessage } from "../messaging/message.js";
+import type { RecordHash } from "../wire/index.js";
+import type { InboundItem } from "./inbound.js";
+import { AgentAddress } from "../messaging/address.js";
+import { SendError } from "../messaging/errors.js";
+import { type CollectiveSendOutcome } from "./failures.js";
+import { type CollectiveEmitError, CollectiveError, type FailureDelivery, type SendInput } from "./forms.js";
 /** What the collective layer needs from the daemon around it. */
 export interface CollectivePorts {
     /** The local agent: a group gather or all_gather asks every member but this one. */
@@ -80,8 +86,11 @@ export interface CollectivePorts {
     readonly lookupMember: (member: AgentAddress) => Effect.Effect<void, SendError>;
     /** Certify one post and complete once it is stored locally. */
     readonly sendPost: (input: EngineSendInput) => Effect.Effect<EngineSentPost, SendError>;
-    /** Queue an item the layer emits itself: a result or a failure. */
-    readonly emit: (item: InboundItem) => Effect.Effect<void>;
+    /**
+     * Queue an item the layer emits itself: a result or a failure. It fails
+     * when the item cannot be kept, which ends the work that emitted it.
+     */
+    readonly emit: (item: InboundItem) => Effect.Effect<void, CollectiveEmitError>;
     /** Owns deadline timers and request sends that outlive their send call. */
     readonly scope: Scope.Scope;
     /** Overrides `REQUEST_SEND_WAIT`; tests bound the wait. */
@@ -92,26 +101,26 @@ interface CertifiedPost {
     readonly message: InboundMessage;
     readonly recordHash: RecordHash;
 }
-/** One completed send: the posts certified by its return, and a collective id. */
-interface CollectiveSendOutcome extends SendResult {
-    readonly postIds: ReadonlyArray<EngineSentPost["postId"]>;
-}
 /** The daemon's collective layer for one active identity. */
 export interface CollectiveOperations {
     /**
-     * Perform one send. A gather completes once every request post is accepted
-     * and fails naming each member whose post was refused; an all_gather
-     * completes once its group post is certified. A response is validated
-     * against its request's schema and addressed to the request's conversation.
+     * Perform one send. A gather completes once its request posts are
+     * settled, recording each member it did not reach as no-answer, and
+     * fails naming every member only when it reached none; an all_gather
+     * completes once its group post is certified. A response answers the one
+     * request open in the conversation its address names, validated against
+     * that request's schema.
      */
     readonly send: (input: SendInput, failureDelivery: FailureDelivery) => Effect.Effect<CollectiveSendOutcome, SendError | CollectiveError>;
     /**
      * Classify one certified remote post. Answers are recorded and consumed,
      * every other protocol post is consumed, and each remaining post becomes
      * one item. Classifying a post again yields the same result, so the daemon
-     * may run it on every pass over pending deliveries.
+     * may run it on every pass over pending deliveries. It fails with
+     * `CollectiveEmitError` when a result or failure the post completes cannot
+     * be kept, which ends the pass classifying it.
      */
-    readonly classify: (post: CertifiedPost) => Effect.Effect<Option.Option<InboundItem>>;
+    readonly classify: (post: CertifiedPost) => Effect.Effect<Option.Option<InboundItem>, CollectiveEmitError>;
 }
 /**
  * Build the collective layer for one active identity.

package/dist/transport/collectives/operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../../src/transport/collectives/operation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AAEH,OAAO,EAEL,QAAQ,EACR,MAAM,EAGN,MAAM,EAGN,KAAK,KAAK,EACX,MAAM,QAAQ,CAAC;AAChB,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAU,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAA2B,WAAW,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EACL,YAAY,EAGb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EACL,KAAK,qBAAqB,EAK3B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,mBAAmB,EACxB,eAAe,EAKf,KAAK,eAAe,EAGpB,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AA0FpB,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,CACrB,MAAM,EAAE,YAAY,KACjB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACpC,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,CACjB,KAAK,EAAE,eAAe,KACnB,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IAC9C;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,CACb,IAAI,EAAE,WAAW,KACd,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IAC9C,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC;CAC9C;AAED,uEAAuE;AACvE,UAAU,aAAa;IACrB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAED,6DAA6D;AAC7D,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,CACb,KAAK,EAAE,SAAS,EAChB,eAAe,EAAE,eAAe,KAC7B,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,SAAS,GAAG,eAAe,CAAC,CAAC;IACvE;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,CACjB,IAAI,EAAE,aAAa,KAChB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,mBAAmB,CAAC,CAAC;CACrE;AA4DD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,UAC5B,eAAe,KACrB,oBAiBF,CAAC"}