@moltzap/client 2026.922.3 → 2026.1001.0

package/dist/contract.d.ts

@@ -54,31 +54,131 @@ export declare const Content: Schema.refine<readonly [{
 }>]>>>;
 /** Validated nonempty semantic content. */
 export type Content = typeof Content.Type;
-/** Complete semantic input for one addressed send. */
-export declare const SendInput: Schema.Struct<{
+/**
+ * Identity of one gather or all_gather, minted by the requesting endpoint.
+ * The request, each member's answer, an all_gather's close, the result and
+ * any failure carry it.
+ */
+export declare const CollectiveId: Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">;
+/** A validated collective operation id. */
+export type CollectiveId = typeof CollectiveId.Type;
+/**
+ * The MCP form-mode `requestedSchema` of a collecting operation: a flat object
+ * of primitive properties. This schema fixes its outline; the sending endpoint
+ * checks each property against the MCP form-mode grammar before any post.
+ */
+export declare const RequestedSchema: Schema.Struct<{
+    $schema: Schema.optionalWith<typeof Schema.String, {
+        exact: true;
+    }>;
+    type: Schema.Literal<["object"]>;
+    properties: Schema.Record$<typeof Schema.String, Schema.Record$<typeof Schema.String, Schema.Schema<JsonValue, JsonValue, never>>>;
+    required: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
+        exact: true;
+    }>;
+}>;
+/** A form-mode schema as stated by its requester. */
+export type RequestedSchema = typeof RequestedSchema.Type;
+/**
+ * One answer to a collecting operation, field by field. Its value space is MCP
+ * `ElicitResult` content's; the request's schema decides which fields apply.
+ */
+export declare const AnswerContent: Schema.Record$<typeof Schema.String, Schema.Union<[typeof Schema.String, Schema.filter<typeof Schema.Number>, typeof Schema.Boolean, Schema.Array$<typeof Schema.String>]>>;
+/** A structurally valid answer. */
+export type AnswerContent = typeof AnswerContent.Type;
+/** The longest deadline a collecting operation may state: 30 days, in seconds. */
+export declare const MAXIMUM_DEADLINE_SECONDS = 2592000;
+/**
+ * The collective operation one send performs, discriminated by `op`. Each
+ * operation is one member of this union; the schema carries no identifier so
+ * its JSON Schema embeds inline in a host tool's parameters.
+ */
+export declare const CollectiveOperation: Schema.Union<[Schema.Struct<{
+    op: Schema.optionalWith<Schema.Literal<["multicast"]>, {
+        exact: true;
+    }>;
+}>, Schema.Struct<{
+    op: Schema.Literal<["gather", "all_gather"]>;
+    deadline: Schema.refine<number, Schema.filter<typeof Schema.Number>>;
+    requestedSchema: Schema.Struct<{
+        $schema: Schema.optionalWith<typeof Schema.String, {
+            exact: true;
+        }>;
+        type: Schema.Literal<["object"]>;
+        properties: Schema.Record$<typeof Schema.String, Schema.Record$<typeof Schema.String, Schema.Schema<JsonValue, JsonValue, never>>>;
+        required: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
+            exact: true;
+        }>;
+    }>;
+}>]>;
+/** A validated collective operation. */
+export type CollectiveOperation = typeof CollectiveOperation.Type;
+/**
+ * A member's reply to one collective request. Only `accept` carries content,
+ * valid against the request's schema; the member's endpoint addresses the
+ * reply to the conversation the request arrived in.
+ */
+export declare const CollectiveResponse: Schema.Union<[Schema.Struct<{
+    id: Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">;
+    action: Schema.Literal<["accept"]>;
+    content: Schema.Record$<typeof Schema.String, Schema.Union<[typeof Schema.String, Schema.filter<typeof Schema.Number>, typeof Schema.Boolean, Schema.Array$<typeof Schema.String>]>>;
+}>, Schema.Struct<{
+    id: Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">;
+    action: Schema.Literal<["decline", "cancel"]>;
+}>]>;
+/** A validated collective response. */
+export type CollectiveResponse = typeof CollectiveResponse.Type;
+/**
+ * One send: an operation with its address, body text and collective
+ * operation, multicast when `collective` is omitted; or a response to a
+ * collective request, which names no address because the member's endpoint
+ * derives it from the request.
+ */
+export declare const SendInput: Schema.Union<[Schema.Struct<{
     to: Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">;
-    content: Schema.refine<readonly [{
-        readonly type: "text";
-        readonly text: string;
-    } | {
-        readonly type: "data";
-        readonly value: JsonValue;
-    }, ...({
-        readonly type: "text";
-        readonly text: string;
-    } | {
-        readonly type: "data";
-        readonly value: JsonValue;
-    })[]], Schema.NonEmptyArray<Schema.Union<[Schema.Struct<{
-        type: Schema.Literal<["text"]>;
-        text: Schema.filter<typeof Schema.String>;
+    text: Schema.filter<typeof Schema.String>;
+    collective: Schema.optionalWith<Schema.Union<[Schema.Struct<{
+        op: Schema.optionalWith<Schema.Literal<["multicast"]>, {
+            exact: true;
+        }>;
     }>, Schema.Struct<{
-        type: Schema.Literal<["data"]>;
-        value: Schema.Schema<JsonValue, JsonValue, never>;
-    }>]>>>;
-}>;
-/** Validated semantic input for one addressed send. */
+        op: Schema.Literal<["gather", "all_gather"]>;
+        deadline: Schema.refine<number, Schema.filter<typeof Schema.Number>>;
+        requestedSchema: Schema.Struct<{
+            $schema: Schema.optionalWith<typeof Schema.String, {
+                exact: true;
+            }>;
+            type: Schema.Literal<["object"]>;
+            properties: Schema.Record$<typeof Schema.String, Schema.Record$<typeof Schema.String, Schema.Schema<JsonValue, JsonValue, never>>>;
+            required: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
+                exact: true;
+            }>;
+        }>;
+    }>]>, {
+        exact: true;
+    }>;
+}>, Schema.Struct<{
+    collectiveResponse: Schema.Union<[Schema.Struct<{
+        id: Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">;
+        action: Schema.Literal<["accept"]>;
+        content: Schema.Record$<typeof Schema.String, Schema.Union<[typeof Schema.String, Schema.filter<typeof Schema.Number>, typeof Schema.Boolean, Schema.Array$<typeof Schema.String>]>>;
+    }>, Schema.Struct<{
+        id: Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">;
+        action: Schema.Literal<["decline", "cancel"]>;
+    }>]>;
+}>]>;
+/** Validated input for one send. */
 export type SendInput = typeof SendInput.Type;
+/**
+ * Where a refused collecting operation or response reports its error:
+ * returned to the caller, or emitted as an `operationFailed` item while the
+ * send completes.
+ */
+export type FailureDelivery = "result" | "inbound";
+/** What a completed send returns: a collecting operation names its id. */
+export interface SendResult {
+    readonly operationId?: CollectiveId;
+}
 declare const directMessage: Schema.filter<Schema.Struct<{
     kind: Schema.Literal<["direct"]>;
     postId: Schema.brand<Schema.filter<typeof Schema.String>, "PostId">;
@@ -134,7 +234,7 @@ declare const groupMessage: Schema.filter<Schema.Struct<{
 export type DirectMessage = typeof directMessage.Type;
 /** One certified remote-authored fixed-group message. */
 export type GroupMessage = typeof groupMessage.Type;
-/** Exact discriminated inbound message projection. */
+/** One certified remote-authored post, direct or to a fixed group. */
 export declare const InboundMessage: Schema.Union<[Schema.filter<Schema.Struct<{
     kind: Schema.Literal<["direct"]>;
     postId: Schema.brand<Schema.filter<typeof Schema.String>, "PostId">;
@@ -185,18 +285,33 @@ export declare const InboundMessage: Schema.Union<[Schema.filter<Schema.Struct<{
         value: Schema.Schema<JsonValue, JsonValue, never>;
     }>]>>>;
 }>>]>;
-/** A validated direct or group inbound message. */
+/** A validated direct or group post. */
 export type InboundMessage = typeof InboundMessage.Type;
-declare const sendFailure: Schema.Literal<["invalid-address", "unknown-agent", "membership-invalid", "content-invalid", "not-registered", "version-mismatch", "certification-unavailable", "persistence-failed", "network-unavailable"]>;
-type SendFailure = typeof sendFailure.Type;
+/** One member's outcome in a completed gather or all_gather, discriminated by `kind`. */
+declare const memberOutcome: Schema.Union<[Schema.Struct<{
+    kind: Schema.Literal<["answered"]>;
+    content: Schema.Record$<typeof Schema.String, Schema.Union<[typeof Schema.String, Schema.filter<typeof Schema.Number>, typeof Schema.Boolean, Schema.Array$<typeof Schema.String>]>>;
+}>, Schema.Struct<{
+    kind: Schema.Literal<["declined"]>;
+}>, Schema.Struct<{
+    kind: Schema.Literal<["cancelled"]>;
+}>, Schema.Struct<{
+    kind: Schema.Literal<["invalid"]>;
+    reason: typeof Schema.String;
+}>, Schema.Struct<{
+    kind: Schema.Literal<["no-answer"]>;
+}>]>;
+/** One member's recorded outcome. */
+export type CollectiveMemberOutcome = typeof memberOutcome.Type;
 /**
- * One line of the daemon's optional history export: a certified inbound
- * delivery, a completed `send` invocation with its outcome, or the one line
- * that says the export stopped. Readers decode the file line by line with
- * this schema rather than copying its shape.
+ * One inbound item, discriminated by `kind`. The endpoint consumes the
+ * collective layer's protocol posts, posts whose collective part is malformed
+ * or duplicated, and multicasts that carry nothing besides that part; every
+ * other certified post becomes one item, and the endpoint itself emits
+ * results and failures.
  */
-export declare const HistoryExportRecord: Schema.Union<[Schema.Struct<{
-    kind: Schema.Literal<["inbound"]>;
+export declare const InboundItem: Schema.Union<[Schema.Struct<{
+    kind: Schema.Literal<["multicast"]>;
     message: Schema.Union<[Schema.filter<Schema.Struct<{
         kind: Schema.Literal<["direct"]>;
         postId: Schema.brand<Schema.filter<typeof Schema.String>, "PostId">;
@@ -247,35 +362,211 @@ export declare const HistoryExportRecord: Schema.Union<[Schema.Struct<{
             value: Schema.Schema<JsonValue, JsonValue, never>;
         }>]>>>;
     }>>]>;
+}>, Schema.Struct<{
+    kind: Schema.Literal<["collectiveRequest"]>;
+    id: Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">;
+    postId: Schema.brand<Schema.filter<typeof Schema.String>, "PostId">;
+    from: Schema.brand<Schema.filter<Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">>, "AgentAddress">;
+    to: Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">;
+    question: Schema.filter<typeof Schema.String>;
+    requestedSchema: Schema.Struct<{
+        $schema: Schema.optionalWith<typeof Schema.String, {
+            exact: true;
+        }>;
+        type: Schema.Literal<["object"]>;
+        properties: Schema.Record$<typeof Schema.String, Schema.Record$<typeof Schema.String, Schema.Schema<JsonValue, JsonValue, never>>>;
+        required: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
+            exact: true;
+        }>;
+    }>;
+    deadlineAt: Schema.filter<Schema.filter<typeof Schema.Number>>;
+}>, Schema.Struct<{
+    kind: Schema.Literal<["collectiveResult"]>;
+    id: Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">;
+    to: Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">;
+    question: Schema.filter<typeof Schema.String>;
+    outcomes: Schema.NonEmptyArray<Schema.Struct<{
+        member: Schema.brand<Schema.filter<Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">>, "AgentAddress">;
+        outcome: Schema.Union<[Schema.Struct<{
+            kind: Schema.Literal<["answered"]>;
+            content: Schema.Record$<typeof Schema.String, Schema.Union<[typeof Schema.String, Schema.filter<typeof Schema.Number>, typeof Schema.Boolean, Schema.Array$<typeof Schema.String>]>>;
+        }>, Schema.Struct<{
+            kind: Schema.Literal<["declined"]>;
+        }>, Schema.Struct<{
+            kind: Schema.Literal<["cancelled"]>;
+        }>, Schema.Struct<{
+            kind: Schema.Literal<["invalid"]>;
+            reason: typeof Schema.String;
+        }>, Schema.Struct<{
+            kind: Schema.Literal<["no-answer"]>;
+        }>]>;
+    }>>;
+    closePostId: Schema.optionalWith<Schema.brand<Schema.filter<typeof Schema.String>, "PostId">, {
+        exact: true;
+    }>;
+}>, Schema.Struct<{
+    kind: Schema.Literal<["operationFailed"]>;
+    id: Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">;
+    to: Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">;
+    error: typeof Schema.String;
+}>]>;
+/** A validated inbound item. */
+export type InboundItem = typeof InboundItem.Type;
+declare const sendFailure: Schema.Literal<["invalid-address", "unknown-agent", "membership-invalid", "content-invalid", "not-registered", "version-mismatch", "certification-unavailable", "persistence-failed", "network-unavailable"]>;
+type SendFailure = typeof sendFailure.Type;
+/**
+ * One line of the daemon's optional history export: an item as the daemon
+ * published it, a completed `send` invocation with its input and outcome, or
+ * the one line that says the export stopped. Readers decode the file line by
+ * line with this schema rather than copying its shape.
+ */
+export declare const HistoryExportRecord: Schema.Union<[Schema.Struct<{
+    kind: Schema.Literal<["inbound"]>;
+    item: Schema.Union<[Schema.Struct<{
+        kind: Schema.Literal<["multicast"]>;
+        message: Schema.Union<[Schema.filter<Schema.Struct<{
+            kind: Schema.Literal<["direct"]>;
+            postId: Schema.brand<Schema.filter<typeof Schema.String>, "PostId">;
+            address: Schema.brand<Schema.filter<Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">>, "AgentAddress">;
+            sender: Schema.brand<Schema.filter<Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">>, "AgentAddress">;
+            content: Schema.refine<readonly [{
+                readonly type: "text";
+                readonly text: string;
+            } | {
+                readonly type: "data";
+                readonly value: JsonValue;
+            }, ...({
+                readonly type: "text";
+                readonly text: string;
+            } | {
+                readonly type: "data";
+                readonly value: JsonValue;
+            })[]], Schema.NonEmptyArray<Schema.Union<[Schema.Struct<{
+                type: Schema.Literal<["text"]>;
+                text: Schema.filter<typeof Schema.String>;
+            }>, Schema.Struct<{
+                type: Schema.Literal<["data"]>;
+                value: Schema.Schema<JsonValue, JsonValue, never>;
+            }>]>>>;
+        }>>, Schema.filter<Schema.Struct<{
+            kind: Schema.Literal<["group"]>;
+            postId: Schema.brand<Schema.filter<typeof Schema.String>, "PostId">;
+            address: Schema.brand<Schema.filter<Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">>, "GroupAddress">;
+            sender: Schema.brand<Schema.filter<Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">>, "AgentAddress">;
+            members: Schema.filter<Schema.TupleType<readonly [Schema.brand<Schema.filter<Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">>, "AgentAddress">, Schema.brand<Schema.filter<Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">>, "AgentAddress">, Schema.brand<Schema.filter<Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">>, "AgentAddress">], [Schema.brand<Schema.filter<Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">>, "AgentAddress">]>>;
+            content: Schema.refine<readonly [{
+                readonly type: "text";
+                readonly text: string;
+            } | {
+                readonly type: "data";
+                readonly value: JsonValue;
+            }, ...({
+                readonly type: "text";
+                readonly text: string;
+            } | {
+                readonly type: "data";
+                readonly value: JsonValue;
+            })[]], Schema.NonEmptyArray<Schema.Union<[Schema.Struct<{
+                type: Schema.Literal<["text"]>;
+                text: Schema.filter<typeof Schema.String>;
+            }>, Schema.Struct<{
+                type: Schema.Literal<["data"]>;
+                value: Schema.Schema<JsonValue, JsonValue, never>;
+            }>]>>>;
+        }>>]>;
+    }>, Schema.Struct<{
+        kind: Schema.Literal<["collectiveRequest"]>;
+        id: Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">;
+        postId: Schema.brand<Schema.filter<typeof Schema.String>, "PostId">;
+        from: Schema.brand<Schema.filter<Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">>, "AgentAddress">;
+        to: Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">;
+        question: Schema.filter<typeof Schema.String>;
+        requestedSchema: Schema.Struct<{
+            $schema: Schema.optionalWith<typeof Schema.String, {
+                exact: true;
+            }>;
+            type: Schema.Literal<["object"]>;
+            properties: Schema.Record$<typeof Schema.String, Schema.Record$<typeof Schema.String, Schema.Schema<JsonValue, JsonValue, never>>>;
+            required: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
+                exact: true;
+            }>;
+        }>;
+        deadlineAt: Schema.filter<Schema.filter<typeof Schema.Number>>;
+    }>, Schema.Struct<{
+        kind: Schema.Literal<["collectiveResult"]>;
+        id: Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">;
+        to: Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">;
+        question: Schema.filter<typeof Schema.String>;
+        outcomes: Schema.NonEmptyArray<Schema.Struct<{
+            member: Schema.brand<Schema.filter<Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">>, "AgentAddress">;
+            outcome: Schema.Union<[Schema.Struct<{
+                kind: Schema.Literal<["answered"]>;
+                content: Schema.Record$<typeof Schema.String, Schema.Union<[typeof Schema.String, Schema.filter<typeof Schema.Number>, typeof Schema.Boolean, Schema.Array$<typeof Schema.String>]>>;
+            }>, Schema.Struct<{
+                kind: Schema.Literal<["declined"]>;
+            }>, Schema.Struct<{
+                kind: Schema.Literal<["cancelled"]>;
+            }>, Schema.Struct<{
+                kind: Schema.Literal<["invalid"]>;
+                reason: typeof Schema.String;
+            }>, Schema.Struct<{
+                kind: Schema.Literal<["no-answer"]>;
+            }>]>;
+        }>>;
+        closePostId: Schema.optionalWith<Schema.brand<Schema.filter<typeof Schema.String>, "PostId">, {
+            exact: true;
+        }>;
+    }>, Schema.Struct<{
+        kind: Schema.Literal<["operationFailed"]>;
+        id: Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">;
+        to: Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">;
+        error: typeof Schema.String;
+    }>]>;
     at: typeof Schema.DateTimeUtc;
 }>, Schema.Struct<{
     kind: Schema.Literal<["outbound"]>;
-    to: Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">;
-    content: Schema.refine<readonly [{
-        readonly type: "text";
-        readonly text: string;
-    } | {
-        readonly type: "data";
-        readonly value: JsonValue;
-    }, ...({
-        readonly type: "text";
-        readonly text: string;
-    } | {
-        readonly type: "data";
-        readonly value: JsonValue;
-    })[]], Schema.NonEmptyArray<Schema.Union<[Schema.Struct<{
-        type: Schema.Literal<["text"]>;
+    input: Schema.Union<[Schema.Struct<{
+        to: Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">;
         text: Schema.filter<typeof Schema.String>;
+        collective: Schema.optionalWith<Schema.Union<[Schema.Struct<{
+            op: Schema.optionalWith<Schema.Literal<["multicast"]>, {
+                exact: true;
+            }>;
+        }>, Schema.Struct<{
+            op: Schema.Literal<["gather", "all_gather"]>;
+            deadline: Schema.refine<number, Schema.filter<typeof Schema.Number>>;
+            requestedSchema: Schema.Struct<{
+                $schema: Schema.optionalWith<typeof Schema.String, {
+                    exact: true;
+                }>;
+                type: Schema.Literal<["object"]>;
+                properties: Schema.Record$<typeof Schema.String, Schema.Record$<typeof Schema.String, Schema.Schema<JsonValue, JsonValue, never>>>;
+                required: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
+                    exact: true;
+                }>;
+            }>;
+        }>]>, {
+            exact: true;
+        }>;
     }>, Schema.Struct<{
-        type: Schema.Literal<["data"]>;
-        value: Schema.Schema<JsonValue, JsonValue, never>;
-    }>]>>>;
+        collectiveResponse: Schema.Union<[Schema.Struct<{
+            id: Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">;
+            action: Schema.Literal<["accept"]>;
+            content: Schema.Record$<typeof Schema.String, Schema.Union<[typeof Schema.String, Schema.filter<typeof Schema.Number>, typeof Schema.Boolean, Schema.Array$<typeof Schema.String>]>>;
+        }>, Schema.Struct<{
+            id: Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">;
+            action: Schema.Literal<["decline", "cancel"]>;
+        }>]>;
+    }>]>;
     outcome: Schema.Union<[Schema.Struct<{
-        kind: Schema.Literal<["certified"]>;
-        postId: Schema.brand<Schema.filter<typeof Schema.String>, "PostId">;
+        kind: Schema.Literal<["sent"]>;
+        operationId: Schema.optionalWith<Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">, {
+            exact: true;
+        }>;
+        postIds: Schema.Array$<Schema.brand<Schema.filter<typeof Schema.String>, "PostId">>;
     }>, Schema.Struct<{
         kind: Schema.Literal<["failed"]>;
-        reason: Schema.Literal<["invalid-address", "unknown-agent", "membership-invalid", "content-invalid", "not-registered", "version-mismatch", "certification-unavailable", "persistence-failed", "network-unavailable"]>;
+        error: typeof Schema.String;
     }>]>;
     at: typeof Schema.DateTimeUtc;
 }>, Schema.Struct<{
@@ -294,6 +585,87 @@ export declare class SendError extends SendError_base<{
 }> {
     get message(): string;
 }
+/**
+ * Why a collective send was refused, discriminated by `kind`: a gather or
+ * all_gather whose schema is outside the form-mode grammar or whose request
+ * post some member could not receive, or a response the member's endpoint
+ * cannot send.
+ */
+declare const collectiveFailure: Schema.Union<[Schema.Struct<{
+    kind: Schema.Literal<["members-unreachable"]>;
+    members: Schema.NonEmptyArray<Schema.Struct<{
+        member: Schema.brand<Schema.filter<Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">>, "AgentAddress">;
+        reason: Schema.Literal<["invalid-address", "unknown-agent", "membership-invalid", "content-invalid", "not-registered", "version-mismatch", "certification-unavailable", "persistence-failed", "network-unavailable"]>;
+    }>>;
+}>, Schema.Struct<{
+    kind: Schema.Literal<["schema-invalid"]>;
+    detail: typeof Schema.String;
+}>, Schema.Struct<{
+    kind: Schema.Literal<["answer-invalid"]>;
+    fields: Schema.NonEmptyArray<Schema.Struct<{
+        field: typeof Schema.String;
+        reason: Schema.Literal<["missing", "unexpected", "invalid"]>;
+        detail: Schema.optionalWith<typeof Schema.String, {
+            exact: true;
+        }>;
+    }>>;
+}>, Schema.Struct<{
+    kind: Schema.Literal<["request-unknown"]>;
+}>, Schema.Struct<{
+    kind: Schema.Literal<["request-answered"]>;
+}>, Schema.Struct<{
+    kind: Schema.Literal<["request-expired"]>;
+}>]>;
+/** A validated collective failure. */
+export type CollectiveFailure = typeof collectiveFailure.Type;
+/**
+ * Decode a collective failure carried across the loopback MCP boundary.
+ * @param value Untrusted failure detail from a refused send's error data.
+ * @returns The validated failure.
+ */
+export declare const decodeCollectiveFailure: (u: unknown, overrideOptions?: import("effect/SchemaAST").ParseOptions) => Effect.Effect<{
+    readonly kind: "members-unreachable";
+    readonly members: readonly [{
+        readonly member: string & import("effect/Brand").Brand<"MessageAddressInput"> & import("effect/Brand").Brand<"AgentAddress">;
+        readonly reason: "certification-unavailable" | "content-invalid" | "invalid-address" | "membership-invalid" | "network-unavailable" | "not-registered" | "persistence-failed" | "unknown-agent" | "version-mismatch";
+    }, ...{
+        readonly member: string & import("effect/Brand").Brand<"MessageAddressInput"> & import("effect/Brand").Brand<"AgentAddress">;
+        readonly reason: "certification-unavailable" | "content-invalid" | "invalid-address" | "membership-invalid" | "network-unavailable" | "not-registered" | "persistence-failed" | "unknown-agent" | "version-mismatch";
+    }[]];
+} | {
+    readonly kind: "schema-invalid";
+    readonly detail: string;
+} | {
+    readonly kind: "answer-invalid";
+    readonly fields: readonly [{
+        readonly field: string;
+        readonly reason: "invalid" | "missing" | "unexpected";
+        readonly detail?: string | undefined;
+    }, ...{
+        readonly field: string;
+        readonly reason: "invalid" | "missing" | "unexpected";
+        readonly detail?: string | undefined;
+    }[]];
+} | {
+    readonly kind: "request-unknown";
+} | {
+    readonly kind: "request-answered";
+} | {
+    readonly kind: "request-expired";
+}, import("effect/ParseResult").ParseError, never>;
+declare const CollectiveError_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: "CollectiveError";
+} & Readonly<A>;
+/**
+ * A collective send was refused. The message names each unreachable member or
+ * failing field, so a host can hand it to its model as the tool error.
+ */
+export declare class CollectiveError extends CollectiveError_base<{
+    readonly id: CollectiveId;
+    readonly failure: CollectiveFailure;
+}> {
+    get message(): string;
+}
 type ListenFailure = "already-listening" | "incompatible-daemon" | "transport-failed" | "decode-failed";
 declare const ListenError_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: "ListenError";
@@ -324,14 +696,25 @@ export declare class ConnectError extends ConnectError_base<{
 }> {
     get message(): string;
 }
-/** One message plus its transport-only acknowledgment. */
+/** One inbound item plus its transport-only acknowledgment. */
 export interface InboundDelivery {
-    readonly message: InboundMessage;
+    readonly item: InboundItem;
     readonly acknowledge: Effect.Effect<void, DeliveryAcknowledgeError>;
 }
-/** Structural runtime capability owned by one scoped endpoint connection. */
+/**
+ * Structural runtime capability owned by one scoped endpoint connection.
+ * Every send is one operation or one collective response; the stream yields
+ * inbound items.
+ *
+ * A host whose tool returns before the send completes passes
+ * `failureDelivery: "inbound"`: a refused gather, all_gather or response
+ * then completes and its error arrives as an `operationFailed` item on the
+ * stream. A multicast has no operation id, so its failure is always returned.
+ */
 export interface HarnessEndpoint {
-    readonly send: (input: SendInput) => Effect.Effect<void, SendError>;
+    readonly send: (input: SendInput, options?: Readonly<{
+        failureDelivery?: FailureDelivery;
+    }>) => Effect.Effect<SendResult, SendError | CollectiveError>;
     readonly messages: Stream.Stream<InboundDelivery, ListenError>;
 }
 export {};

package/dist/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"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"}