@moltzap/client 2026.1002.0 → 2026.1005.0

package/dist/delivery/operations.d.ts

@@ -0,0 +1,787 @@
+/** @file The values harness operations take, return and persist: sends, inbox pages, events and acknowledgments. */
+import { Effect, type ParseResult, Schema, type SchemaAST } from "effect";
+import type { SendError } from "../transport/messaging/errors.js";
+import { DeliveryToken, type EndpointStore, type InboxSummary } from "../store/types.js";
+import { type CollectiveError, CollectiveId, decodeCollectiveFailure } from "../transport/collectives/forms.js";
+/** Canonical event identities reuse the immutable inbox binding's random bytes. */
+export declare const eventIdSchema: Schema.filter<typeof Schema.String>;
+/** Read-only content lookup never acknowledges or retries delivery. */
+export declare const readEventRequestSchema: Schema.Struct<{
+    eventId: Schema.filter<typeof Schema.String>;
+}>;
+/** The original classified payload, including after its handoff. */
+export declare const readEventResultSchema: Schema.Struct<{
+    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: import("../index.js").JsonValue;
+            }, ...({
+                readonly type: "text";
+                readonly text: string;
+            } | {
+                readonly type: "data";
+                readonly value: import("../index.js").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<import("../index.js").JsonValue, import("../index.js").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: import("../index.js").JsonValue;
+            }, ...({
+                readonly type: "text";
+                readonly text: string;
+            } | {
+                readonly type: "data";
+                readonly value: import("../index.js").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<import("../index.js").JsonValue, import("../index.js").JsonValue, never>;
+            }>]>>>;
+        }>>]>;
+    }>, Schema.Struct<{
+        kind: Schema.Literal<["collectiveRequest"]>;
+        op: Schema.Literal<["gather", "all_gather"]>;
+        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<import("../index.js").JsonValue, import("../index.js").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"]>;
+        op: Schema.Literal<["gather", "all_gather"]>;
+        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<["invalid"]>;
+                reason: typeof Schema.String;
+            }>, Schema.Struct<{
+                kind: Schema.Literal<["no-answer"]>;
+            }>]>;
+        }>>;
+    }>, 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 delivery acknowledgment names the delivery it retires. */
+export declare const harnessAcknowledgeDeliveryRequestSchema: Schema.Struct<{
+    deliveryToken: Schema.brand<Schema.filter<typeof Schema.String>, "DeliveryToken">;
+}>;
+/**
+ * Runtime identity and routing of a refused gather or response.
+ * `inbound` is for a host whose tool returns before the
+ * send: the call completes and the error arrives as an `operationFailed`
+ * item. The default returns it as the tool error.
+ */
+export declare const harnessSendOptionsSchema: Schema.Struct<{
+    idempotencyKey: Schema.optionalWith<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>, {
+        exact: true;
+    }>;
+    failureDelivery: Schema.optionalWith<Schema.Literal<["result", "inbound"]>, {
+        exact: true;
+    }>;
+}>;
+/** The model-visible arguments of one send. */
+export declare const harnessSendArgumentsSchema: Schema.Struct<{
+    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.filter<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<import("../index.js").JsonValue, import("../index.js").JsonValue, never>>>;
+                required: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
+                    exact: true;
+                }>;
+            }>;
+        }>]>, {
+            exact: true;
+        }>;
+    }>, Schema.Struct<{
+        to: Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">;
+        collectiveResponse: Schema.Union<[Schema.Struct<{
+            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<{
+            action: Schema.Literal<["decline"]>;
+        }>]>;
+    }>]>;
+}>;
+declare const harnessSendRequestSchema: Schema.Struct<{
+    idempotencyKey: Schema.optionalWith<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>, {
+        exact: true;
+    }>;
+    failureDelivery: Schema.optionalWith<Schema.Literal<["result", "inbound"]>, {
+        exact: true;
+    }>;
+    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.filter<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<import("../index.js").JsonValue, import("../index.js").JsonValue, never>>>;
+                required: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
+                    exact: true;
+                }>;
+            }>;
+        }>]>, {
+            exact: true;
+        }>;
+    }>, Schema.Struct<{
+        to: Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">;
+        collectiveResponse: Schema.Union<[Schema.Struct<{
+            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<{
+            action: Schema.Literal<["decline"]>;
+        }>]>;
+    }>]>;
+}>;
+/**
+ * A completed operation. A collecting operation names the id its answers and
+ * result carry; a multicast has none, so its result is empty.
+ */
+export declare const harnessSendResultSchema: Schema.Struct<{
+    operationId: Schema.optionalWith<Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">, {
+        exact: true;
+    }>;
+}>;
+declare const harnessMessageReadyEventSchema: Schema.Struct<{
+    deliveryToken: Schema.brand<Schema.filter<typeof Schema.String>, "DeliveryToken">;
+    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: import("../index.js").JsonValue;
+            }, ...({
+                readonly type: "text";
+                readonly text: string;
+            } | {
+                readonly type: "data";
+                readonly value: import("../index.js").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<import("../index.js").JsonValue, import("../index.js").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: import("../index.js").JsonValue;
+            }, ...({
+                readonly type: "text";
+                readonly text: string;
+            } | {
+                readonly type: "data";
+                readonly value: import("../index.js").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<import("../index.js").JsonValue, import("../index.js").JsonValue, never>;
+            }>]>>>;
+        }>>]>;
+    }>, Schema.Struct<{
+        kind: Schema.Literal<["collectiveRequest"]>;
+        op: Schema.Literal<["gather", "all_gather"]>;
+        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<import("../index.js").JsonValue, import("../index.js").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"]>;
+        op: Schema.Literal<["gather", "all_gather"]>;
+        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<["invalid"]>;
+                reason: typeof Schema.String;
+            }>, Schema.Struct<{
+                kind: Schema.Literal<["no-answer"]>;
+            }>]>;
+        }>>;
+    }>, 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;
+    }>]>;
+}>;
+/** One page request over the classified inbox. */
+export declare const inboxRequestSchema: Schema.Struct<{
+    cursor: Schema.optionalWith<typeof Schema.String, {
+        exact: true;
+    }>;
+}>;
+/** One page of classified deliveries and the cursor after it. */
+export declare const inboxResultSchema: Schema.Struct<{
+    items: Schema.Array$<Schema.Struct<{
+        deliveryToken: Schema.brand<Schema.filter<typeof Schema.String>, "DeliveryToken">;
+        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: import("../index.js").JsonValue;
+                }, ...({
+                    readonly type: "text";
+                    readonly text: string;
+                } | {
+                    readonly type: "data";
+                    readonly value: import("../index.js").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<import("../index.js").JsonValue, import("../index.js").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: import("../index.js").JsonValue;
+                }, ...({
+                    readonly type: "text";
+                    readonly text: string;
+                } | {
+                    readonly type: "data";
+                    readonly value: import("../index.js").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<import("../index.js").JsonValue, import("../index.js").JsonValue, never>;
+                }>]>>>;
+            }>>]>;
+        }>, Schema.Struct<{
+            kind: Schema.Literal<["collectiveRequest"]>;
+            op: Schema.Literal<["gather", "all_gather"]>;
+            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<import("../index.js").JsonValue, import("../index.js").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"]>;
+            op: Schema.Literal<["gather", "all_gather"]>;
+            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<["invalid"]>;
+                    reason: typeof Schema.String;
+                }>, Schema.Struct<{
+                    kind: Schema.Literal<["no-answer"]>;
+                }>]>;
+            }>>;
+        }>, 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;
+        }>]>;
+    }>>;
+    nextCursor: Schema.optionalWith<typeof Schema.String, {
+        exact: true;
+    }>;
+}>;
+/** Caller-selected identity of one previously attempted send. */
+export declare const readSendRequestSchema: Schema.Struct<{
+    idempotencyKey: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+}>;
+/** Exact retained result of one invocation; failure is not proof of no post. */
+declare const harnessSendOutcomeSchema: Schema.Union<[Schema.Struct<{
+    kind: Schema.Literal<["success"]>;
+    result: Schema.Struct<{
+        operationId: Schema.optionalWith<Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">, {
+            exact: true;
+        }>;
+    }>;
+}>, Schema.Struct<{
+    kind: Schema.Literal<["failure"]>;
+    error: Schema.Union<[Schema.Struct<{
+        reason: Schema.Literal<["collective-failed"]>;
+        id: Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">;
+        failure: typeof Schema.Unknown;
+    }>, Schema.Struct<{
+        reason: typeof Schema.String;
+        detail: Schema.optionalWith<typeof Schema.String, {
+            exact: true;
+        }>;
+    }>]>;
+}>]>;
+/** Observed invocation evidence without a collective completion claim. */
+export declare const readSendResultSchema: Schema.Union<[Schema.Struct<{
+    state: Schema.Literal<["absent"]>;
+}>, Schema.Struct<{
+    state: Schema.Literal<["pending", "indeterminate"]>;
+    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.filter<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<import("../index.js").JsonValue, import("../index.js").JsonValue, never>>>;
+                required: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
+                    exact: true;
+                }>;
+            }>;
+        }>]>, {
+            exact: true;
+        }>;
+    }>, Schema.Struct<{
+        to: Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">;
+        collectiveResponse: Schema.Union<[Schema.Struct<{
+            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<{
+            action: Schema.Literal<["decline"]>;
+        }>]>;
+    }>]>;
+}>, Schema.Struct<{
+    state: Schema.Literal<["returned"]>;
+    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.filter<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<import("../index.js").JsonValue, import("../index.js").JsonValue, never>>>;
+                required: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
+                    exact: true;
+                }>;
+            }>;
+        }>]>, {
+            exact: true;
+        }>;
+    }>, Schema.Struct<{
+        to: Schema.brand<Schema.filter<typeof Schema.String>, "MessageAddressInput">;
+        collectiveResponse: Schema.Union<[Schema.Struct<{
+            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<{
+            action: Schema.Literal<["decline"]>;
+        }>]>;
+    }>]>;
+    outcome: Schema.Union<[Schema.Struct<{
+        kind: Schema.Literal<["success"]>;
+        result: Schema.Struct<{
+            operationId: Schema.optionalWith<Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">, {
+                exact: true;
+            }>;
+        }>;
+    }>, Schema.Struct<{
+        kind: Schema.Literal<["failure"]>;
+        error: Schema.Union<[Schema.Struct<{
+            reason: Schema.Literal<["collective-failed"]>;
+            id: Schema.brand<Schema.filter<typeof Schema.String>, "CollectiveId">;
+            failure: typeof Schema.Unknown;
+        }>, Schema.Struct<{
+            reason: typeof Schema.String;
+            detail: Schema.optionalWith<typeof Schema.String, {
+                exact: true;
+            }>;
+        }>]>;
+    }>]>;
+}>]>;
+/** Validate the persisted wire outcome before reconstructing a typed send result. */
+export declare const decodeHarnessSendOutcome: (u: unknown, overrideOptions?: SchemaAST.ParseOptions) => Effect.Effect<{
+    readonly kind: "success";
+    readonly result: {
+        readonly operationId?: (string & import("effect/Brand").Brand<"CollectiveId">) | undefined;
+    };
+} | {
+    readonly kind: "failure";
+    readonly error: {
+        readonly reason: "collective-failed";
+        readonly id: string & import("effect/Brand").Brand<"CollectiveId">;
+        readonly failure: unknown;
+    } | {
+        readonly reason: string;
+        readonly detail?: string | undefined;
+    };
+}, ParseResult.ParseError, never>;
+/** Decoded pagination request for the current classified inbox. */
+export type HarnessReadInboxRequest = typeof inboxRequestSchema.Type;
+/** Classified deliveries, bounded by the daemon's snapshot pagination. */
+export type HarnessReadInboxResult = typeof inboxResultSchema.Type;
+/** Caller-selected identity of one previously attempted send. */
+export type HarnessReadSendRequest = typeof readSendRequestSchema.Type;
+/** Observed invocation evidence without a collective completion claim. */
+export type HarnessReadSendResult = typeof readSendResultSchema.Type;
+/** Retained tool outcome for a keyed invocation. */
+export type HarnessSendOutcome = typeof harnessSendOutcomeSchema.Type;
+/** Decode a bounded inbox page received through the MCP transport. */
+export declare const decodeHarnessReadInboxResult: (u: unknown, overrideOptions?: SchemaAST.ParseOptions) => Effect.Effect<{
+    readonly items: readonly {
+        readonly deliveryToken: string & import("effect/Brand").Brand<"DeliveryToken">;
+        readonly item: {
+            readonly kind: "multicast";
+            readonly message: {
+                readonly kind: "direct";
+                readonly postId: string & import("effect/Brand").Brand<"PostId">;
+                readonly address: string & import("effect/Brand").Brand<"MessageAddressInput"> & import("effect/Brand").Brand<"AgentAddress">;
+                readonly sender: string & import("effect/Brand").Brand<"MessageAddressInput"> & import("effect/Brand").Brand<"AgentAddress">;
+                readonly content: readonly [{
+                    readonly type: "text";
+                    readonly text: string;
+                } | {
+                    readonly type: "data";
+                    readonly value: import("../index.js").JsonValue;
+                }, ...({
+                    readonly type: "text";
+                    readonly text: string;
+                } | {
+                    readonly type: "data";
+                    readonly value: import("../index.js").JsonValue;
+                })[]];
+            } | {
+                readonly kind: "group";
+                readonly postId: string & import("effect/Brand").Brand<"PostId">;
+                readonly address: string & import("effect/Brand").Brand<"MessageAddressInput"> & import("effect/Brand").Brand<"GroupAddress">;
+                readonly sender: string & import("effect/Brand").Brand<"MessageAddressInput"> & import("effect/Brand").Brand<"AgentAddress">;
+                readonly members: readonly [string & import("effect/Brand").Brand<"MessageAddressInput"> & import("effect/Brand").Brand<"AgentAddress">, string & import("effect/Brand").Brand<"MessageAddressInput"> & import("effect/Brand").Brand<"AgentAddress">, string & import("effect/Brand").Brand<"MessageAddressInput"> & import("effect/Brand").Brand<"AgentAddress">, ...(string & import("effect/Brand").Brand<"MessageAddressInput"> & import("effect/Brand").Brand<"AgentAddress">)[]];
+                readonly content: readonly [{
+                    readonly type: "text";
+                    readonly text: string;
+                } | {
+                    readonly type: "data";
+                    readonly value: import("../index.js").JsonValue;
+                }, ...({
+                    readonly type: "text";
+                    readonly text: string;
+                } | {
+                    readonly type: "data";
+                    readonly value: import("../index.js").JsonValue;
+                })[]];
+            };
+        } | {
+            readonly kind: "collectiveRequest";
+            readonly op: "all_gather" | "gather";
+            readonly id: string & import("effect/Brand").Brand<"CollectiveId">;
+            readonly postId: string & import("effect/Brand").Brand<"PostId">;
+            readonly from: string & import("effect/Brand").Brand<"MessageAddressInput"> & import("effect/Brand").Brand<"AgentAddress">;
+            readonly to: string & import("effect/Brand").Brand<"MessageAddressInput">;
+            readonly question: string;
+            readonly requestedSchema: {
+                readonly $schema?: string | undefined;
+                readonly type: "object";
+                readonly properties: {
+                    readonly [x: string]: {
+                        readonly [x: string]: import("../index.js").JsonValue;
+                    };
+                };
+                readonly required?: readonly string[] | undefined;
+            };
+            readonly deadlineAt: number;
+        } | {
+            readonly kind: "collectiveResult";
+            readonly op: "all_gather" | "gather";
+            readonly id: string & import("effect/Brand").Brand<"CollectiveId">;
+            readonly to: string & import("effect/Brand").Brand<"MessageAddressInput">;
+            readonly question: string;
+            readonly outcomes: readonly [{
+                readonly member: string & import("effect/Brand").Brand<"MessageAddressInput"> & import("effect/Brand").Brand<"AgentAddress">;
+                readonly outcome: {
+                    readonly kind: "answered";
+                    readonly content: {
+                        readonly [x: string]: string | number | boolean | readonly string[];
+                    };
+                } | {
+                    readonly kind: "declined";
+                } | {
+                    readonly kind: "invalid";
+                    readonly reason: string;
+                } | {
+                    readonly kind: "no-answer";
+                };
+            }, ...{
+                readonly member: string & import("effect/Brand").Brand<"MessageAddressInput"> & import("effect/Brand").Brand<"AgentAddress">;
+                readonly outcome: {
+                    readonly kind: "answered";
+                    readonly content: {
+                        readonly [x: string]: string | number | boolean | readonly string[];
+                    };
+                } | {
+                    readonly kind: "declined";
+                } | {
+                    readonly kind: "invalid";
+                    readonly reason: string;
+                } | {
+                    readonly kind: "no-answer";
+                };
+            }[]];
+        } | {
+            readonly kind: "operationFailed";
+            readonly id: string & import("effect/Brand").Brand<"CollectiveId">;
+            readonly to: string & import("effect/Brand").Brand<"MessageAddressInput">;
+            readonly error: string;
+        };
+    }[];
+    readonly nextCursor?: string | undefined;
+}, ParseResult.ParseError, never>;
+/** Validate the keyed lookup at the tool boundary, including its UTF-8 bound. */
+export declare const decodeHarnessReadSendRequest: (u: unknown, overrideOptions?: SchemaAST.ParseOptions) => Effect.Effect<{
+    readonly idempotencyKey: string;
+}, ParseResult.ParseError, never>;
+/** Validate a daemon invocation before binding its input in the durable store. */
+export declare const decodeHarnessSendRequest: (u: unknown, overrideOptions?: SchemaAST.ParseOptions) => Effect.Effect<{
+    readonly idempotencyKey?: string | undefined;
+    readonly failureDelivery?: "inbound" | "result" | undefined;
+    readonly input: {
+        readonly to: string & import("effect/Brand").Brand<"MessageAddressInput">;
+        readonly text: string;
+        readonly collective?: {
+            readonly op?: "multicast" | undefined;
+        } | {
+            readonly op: "all_gather" | "gather";
+            readonly deadline: number;
+            readonly requestedSchema: {
+                readonly $schema?: string | undefined;
+                readonly type: "object";
+                readonly properties: {
+                    readonly [x: string]: {
+                        readonly [x: string]: import("../index.js").JsonValue;
+                    };
+                };
+                readonly required?: readonly string[] | undefined;
+            };
+        } | undefined;
+    } | {
+        readonly to: string & import("effect/Brand").Brand<"MessageAddressInput">;
+        readonly collectiveResponse: {
+            readonly action: "accept";
+            readonly content: {
+                readonly [x: string]: string | number | boolean | readonly string[];
+            };
+        } | {
+            readonly action: "decline";
+        };
+    };
+}, ParseResult.ParseError, never>;
+/** Decoded delivery acknowledgment arguments owned by the daemon. */
+export type HarnessAcknowledgeDeliveryRequest = typeof harnessAcknowledgeDeliveryRequestSchema.Type;
+/** Semantic arguments advertised to the host's model tool projection. */
+export type HarnessSendArguments = typeof harnessSendArgumentsSchema.Type;
+/** Validated semantic input and runtime options of one daemon invocation. */
+export type HarnessSendRequest = typeof harnessSendRequestSchema.Type;
+/** Decoded error data of one refused `send_message` call. */
+export type HarnessSendErrorData = Readonly<{
+    reason: string;
+    detail?: string;
+}> | Readonly<{
+    reason: "collective-failed";
+    id: CollectiveId;
+    failure: Effect.Effect.Success<ReturnType<typeof decodeCollectiveFailure>>;
+}>;
+/**
+ * The error data a refused send carries across the daemon boundary and into
+ * its durable invocation record: a collective failure keeps its id and the
+ * members or fields it names, and a send failure keeps the detail naming its
+ * cause, so the receiving side rebuilds the same typed error and message.
+ * @param error The refused send's typed error.
+ * @returns The JSON error data.
+ */
+export declare function sendErrorData(error: SendError | CollectiveError): HarnessSendErrorData;
+/** Decoded result of one `send_message` operation. */
+export type HarnessSendResult = typeof harnessSendResultSchema.Type;
+/** One stable pending inbound item emitted by the daemon. */
+export type HarnessMessageReadyEvent = typeof harnessMessageReadyEventSchema.Type;
+/**
+ * Decode one exact delivery acknowledgment request.
+ * @param value Untrusted tool arguments.
+ * @returns The validated request.
+ */
+export declare function decodeHarnessAcknowledgeDeliveryRequest(value: unknown): Effect.Effect<HarnessAcknowledgeDeliveryRequest, ParseResult.ParseError>;
+/**
+ * Decode one exact pending-delivery notification payload.
+ * @param value Untrusted notification parameters.
+ * @returns The validated pending delivery.
+ */
+export declare function decodeHarnessMessageReadyEvent(value: unknown): Effect.Effect<HarnessMessageReadyEvent, ParseResult.ParseError>;
+/**
+ * Decode the error data of one refused `send_message` call.
+ * @param value Untrusted JSON-RPC error data.
+ * @returns The collective failure or send reason it carries.
+ */
+export declare function decodeHarnessSendErrorData(value: unknown): Effect.Effect<HarnessSendErrorData, ParseResult.ParseError>;
+/**
+ * Decode one `send_message` result.
+ * @param value Untrusted structured tool content.
+ * @returns The operation id a gather names, if any.
+ */
+export declare function decodeHarnessSendResult(value: unknown): Effect.Effect<HarnessSendResult, ParseResult.ParseError>;
+/** The existing endpoint store owns both callback progress and immutable inbox items. */
+export type EventStore = Pick<EndpointStore, "readEventState" | "writeEventState" | "readInbox" | "readInboxItem" | "readInboxSummary" | "completeWebhookDelivery">;
+/** Reversible naming keeps lookup independent of subscription and retry state. */
+export declare const eventIdOf: (token: DeliveryToken) => string;
+type ClosedOperationError = Readonly<{
+    readonly reason: string;
+}>;
+/** The delivery operations a host calls: inbox and event reads, sends, and acknowledgments. */
+export interface DeliveryOperations {
+    readonly readEvent: (input: typeof readEventRequestSchema.Type) => Effect.Effect<typeof readEventResultSchema.Type, ClosedOperationError>;
+    readonly readInboxSummary: () => Effect.Effect<InboxSummary, ClosedOperationError>;
+    readonly readInbox: (input: HarnessReadInboxRequest) => Effect.Effect<HarnessReadInboxResult, ClosedOperationError>;
+    readonly readSend: (input: HarnessReadSendRequest) => Effect.Effect<HarnessReadSendResult, ClosedOperationError>;
+    readonly send: (request: HarnessSendRequest) => Effect.Effect<HarnessSendResult, SendError | CollectiveError>;
+    readonly acknowledgeDelivery: (deliveryToken: DeliveryToken) => Effect.Effect<void, ClosedOperationError>;
+}
+export {};
+//# sourceMappingURL=operations.d.ts.map