@dual-os/sdk 0.0.0-stage → 0.8.0-next.0

package/dist/AgentChannel.d.ts

@@ -0,0 +1,1717 @@
+import { Any as Any$1, Value } from "./AuthMethod.js";
+import "./AgentChannel.js";
+import { Context, Effect, Pipeable, Schema } from "effect";
+declare namespace AgentChannel_d_exports {
+  export { AccessOutcome, AgentChannel, Any, Asset, AssetFile, ChannelError, ChannelOptions, CheckedResult, Command, CommandFor, CommandV2, Content, ContextMessage, Contract, Definition, DeliveryUpdate, Destination, Echo, ErrorCode, Event, EventV2, Exposure, FailureCode, Features, Handler, HandlerContext, HandlerError, Key, Message, Operation, OperationKind, Plan, PlanItem, Protocol, Reaction, Request, RequiredChecks, ResolvedAuth, Result, ResultFor, ResultV2, RuntimeContract, Stop, Timestamp, TypeId, Verification, VerifiedIdentity, WebhookResponse, commandSchema, commandSchemaV2, handlerKey, isAgentChannel, make, projectContract, resultSchema, resultSchemaV2, schemasFor, validateDefinition };
+}
+export declare const TypeId: "@dual-os/sdk/AgentChannel";
+export type TypeId = typeof TypeId;
+/** Keys are opaque and installation-scoped. Never parse them into product identities. */
+export declare const Key: Schema.NonEmptyString;
+/**
+ * The command and result schemas a version uses. Absent means the original protocol, whose
+ * projection stays byte-identical for contracts already published with it. `v2` adds the stop
+ * event, conversation reads and output operations.
+ */
+export declare const Protocol: Schema.Literals<readonly ["v2"]>;
+export type Protocol = typeof Protocol.Type;
+/** What a `v2` destination can show. Every channel shows `present_outcome`. */
+export declare const OperationKind: Schema.Literals<readonly ["present_outcome", "create_message", "update_message", "delete_message", "set_reaction", "set_activity", "render_plan"]>;
+export type OperationKind = typeof OperationKind.Type;
+export declare const Features: Schema.Struct<{
+  readonly assets: Schema.Boolean;
+  /** Whether replaying one durable delivery key is safe at the provider boundary. */
+  readonly deliveryMode: Schema.Literals<readonly ["idempotent", "at-most-once"]>;
+  readonly deliveryState: Schema.Boolean;
+  readonly directText: Schema.Literal<true>;
+  readonly groups: Schema.Boolean;
+  /** Maximum Unicode code points per physical text message, including server-added prefixes. */
+  readonly maxTextLength: Schema.optionalKey<Schema.Int>;
+  readonly mentions: Schema.Boolean;
+  /** `v2` only: the output operations every destination of this version shows. */
+  readonly operations: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["present_outcome", "create_message", "update_message", "delete_message", "set_reaction", "set_activity", "render_plan"]>>>;
+  /** `v2` only: whether `read_context` returns the conversation's earlier messages. */
+  readonly readContext: Schema.optionalKey<Schema.Boolean>;
+  readonly replies: Schema.Boolean;
+  /** Maximum age of the original responding input before preparation and delivery. */
+  readonly responseWindowMs: Schema.optionalKey<Schema.Int>;
+  readonly threads: Schema.Boolean;
+}>;
+export type Features = typeof Features.Type;
+export declare const Destination: Schema.Struct<{
+  readonly conversationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+  readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+}>;
+export type Destination = typeof Destination.Type;
+export declare const Asset: Schema.Struct<{
+  readonly assetKey: Schema.NonEmptyString;
+  readonly mediaType: Schema.NonEmptyString;
+  readonly url: Schema.String;
+}>;
+export declare const Content: Schema.Struct<{
+  readonly assets: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+    readonly assetKey: Schema.NonEmptyString;
+    readonly mediaType: Schema.NonEmptyString;
+    readonly url: Schema.String;
+  }>>>;
+  readonly mentions: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+  readonly replyToMessageKey: Schema.optionalKey<Schema.NonEmptyString>;
+  readonly text: Schema.String;
+}>;
+export type Content = typeof Content.Type;
+/** The body is the unmodified UTF-8 provider body, before JSON parsing/signature verification. */
+export declare const Request: Schema.Struct<{
+  readonly body: Schema.String;
+  readonly headers: Schema.$Record<Schema.NonEmptyString, Schema.String>;
+  readonly method: Schema.Literals<readonly ["GET", "POST", "PUT", "PATCH", "DELETE"]>;
+  readonly url: Schema.String;
+}>;
+export type Request = typeof Request.Type;
+/** Bounded provider-required webhook response, returned only after request verification. */
+export declare const WebhookResponse: Schema.Struct<{
+  readonly body: Schema.String;
+  readonly headers: Schema.optionalKey<Schema.$Record<Schema.NonEmptyString, Schema.String>>;
+  readonly status: Schema.Int;
+}>;
+export type WebhookResponse = typeof WebhookResponse.Type;
+export declare const Timestamp: Schema.String;
+export declare const VerifiedIdentity: Schema.Struct<{
+  readonly conversation: Schema.Struct<{
+    readonly conversationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+    readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+  }>;
+  readonly senderKey: Schema.NonEmptyString;
+}>;
+export type VerifiedIdentity = typeof VerifiedIdentity.Type;
+export declare const AccessOutcome: Schema.Struct<{
+  readonly decision: Schema.Literals<readonly ["allow", "deny"]>;
+}>;
+export type AccessOutcome = typeof AccessOutcome.Type;
+export declare const Verification: Schema.Struct<{
+  readonly verified: Schema.Literal<true>;
+}>;
+export type Verification = typeof Verification.Type;
+export declare const Exposure: Schema.Literals<readonly ["webhook", "host"]>;
+export declare const RequiredChecks: Schema.Tuple<readonly [Schema.Literal<"access">]>;
+export declare const Message: Schema.Struct<{
+  readonly content: Schema.Struct<{
+    readonly assets: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+      readonly assetKey: Schema.NonEmptyString;
+      readonly mediaType: Schema.NonEmptyString;
+      readonly url: Schema.String;
+    }>>>;
+    readonly mentions: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+    readonly replyToMessageKey: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly text: Schema.String;
+  }>;
+  readonly conversation: Schema.Struct<{
+    readonly conversationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+    readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+  }>;
+  readonly eventKey: Schema.NonEmptyString;
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly kind: Schema.Literal<"message">;
+  readonly messageKey: Schema.NonEmptyString;
+  readonly respond: Schema.Boolean;
+  readonly senderKey: Schema.NonEmptyString;
+  readonly timestamp: Schema.String;
+}>;
+export declare const DeliveryUpdate: Schema.Struct<{
+  readonly deliveryKey: Schema.NonEmptyString;
+  readonly deliveryUpdateKey: Schema.NonEmptyString;
+  readonly eventKey: Schema.NonEmptyString;
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly kind: Schema.Literal<"delivery_update">;
+  readonly providerDeliveryKey: Schema.NonEmptyString;
+  readonly sequence: Schema.Natural;
+  readonly status: Schema.Literals<readonly ["succeeded", "failed"]>;
+  readonly timestamp: Schema.String;
+}>;
+/** Provider-confirmed own output. No content is accepted or added to conversation history. */
+export declare const Echo: Schema.Struct<{
+  readonly conversation: Schema.Struct<{
+    readonly conversationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+    readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+  }>;
+  readonly senderKey: Schema.NonEmptyString;
+  readonly eventKey: Schema.NonEmptyString;
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly kind: Schema.Literal<"echo">;
+  readonly messageKey: Schema.NonEmptyString;
+  readonly timestamp: Schema.String;
+}>;
+export declare const Event: Schema.Union<readonly [Schema.Struct<{
+  readonly content: Schema.Struct<{
+    readonly assets: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+      readonly assetKey: Schema.NonEmptyString;
+      readonly mediaType: Schema.NonEmptyString;
+      readonly url: Schema.String;
+    }>>>;
+    readonly mentions: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+    readonly replyToMessageKey: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly text: Schema.String;
+  }>;
+  readonly conversation: Schema.Struct<{
+    readonly conversationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+    readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+  }>;
+  readonly eventKey: Schema.NonEmptyString;
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly kind: Schema.Literal<"message">;
+  readonly messageKey: Schema.NonEmptyString;
+  readonly respond: Schema.Boolean;
+  readonly senderKey: Schema.NonEmptyString;
+  readonly timestamp: Schema.String;
+}>, Schema.Struct<{
+  readonly conversation: Schema.Struct<{
+    readonly conversationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+    readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+  }>;
+  readonly senderKey: Schema.NonEmptyString;
+  readonly eventKey: Schema.NonEmptyString;
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly kind: Schema.Literal<"echo">;
+  readonly messageKey: Schema.NonEmptyString;
+  readonly timestamp: Schema.String;
+}>, Schema.Struct<{
+  readonly deliveryKey: Schema.NonEmptyString;
+  readonly deliveryUpdateKey: Schema.NonEmptyString;
+  readonly eventKey: Schema.NonEmptyString;
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly kind: Schema.Literal<"delivery_update">;
+  readonly providerDeliveryKey: Schema.NonEmptyString;
+  readonly sequence: Schema.Natural;
+  readonly status: Schema.Literals<readonly ["succeeded", "failed"]>;
+  readonly timestamp: Schema.String;
+}>]>;
+export type Event = typeof Event.Type;
+/** `v2`: the sender asked the agent to stop working in this conversation. Access applies. */
+export declare const Stop: Schema.Struct<{
+  readonly conversation: Schema.Struct<{
+    readonly conversationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+    readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+  }>;
+  readonly senderKey: Schema.NonEmptyString;
+  readonly eventKey: Schema.NonEmptyString;
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly kind: Schema.Literal<"stop">;
+  readonly timestamp: Schema.String;
+}>;
+export declare const EventV2: Schema.Union<readonly [Schema.Struct<{
+  readonly content: Schema.Struct<{
+    readonly assets: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+      readonly assetKey: Schema.NonEmptyString;
+      readonly mediaType: Schema.NonEmptyString;
+      readonly url: Schema.String;
+    }>>>;
+    readonly mentions: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+    readonly replyToMessageKey: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly text: Schema.String;
+  }>;
+  readonly conversation: Schema.Struct<{
+    readonly conversationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+    readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+  }>;
+  readonly eventKey: Schema.NonEmptyString;
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly kind: Schema.Literal<"message">;
+  readonly messageKey: Schema.NonEmptyString;
+  readonly respond: Schema.Boolean;
+  readonly senderKey: Schema.NonEmptyString;
+  readonly timestamp: Schema.String;
+}>, Schema.Struct<{
+  readonly conversation: Schema.Struct<{
+    readonly conversationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+    readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+  }>;
+  readonly senderKey: Schema.NonEmptyString;
+  readonly eventKey: Schema.NonEmptyString;
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly kind: Schema.Literal<"echo">;
+  readonly messageKey: Schema.NonEmptyString;
+  readonly timestamp: Schema.String;
+}>, Schema.Struct<{
+  readonly deliveryKey: Schema.NonEmptyString;
+  readonly deliveryUpdateKey: Schema.NonEmptyString;
+  readonly eventKey: Schema.NonEmptyString;
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly kind: Schema.Literal<"delivery_update">;
+  readonly providerDeliveryKey: Schema.NonEmptyString;
+  readonly sequence: Schema.Natural;
+  readonly status: Schema.Literals<readonly ["succeeded", "failed"]>;
+  readonly timestamp: Schema.String;
+}>, Schema.Struct<{
+  readonly conversation: Schema.Struct<{
+    readonly conversationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+    readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+  }>;
+  readonly senderKey: Schema.NonEmptyString;
+  readonly eventKey: Schema.NonEmptyString;
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly kind: Schema.Literal<"stop">;
+  readonly timestamp: Schema.String;
+}>]>;
+export type EventV2 = typeof EventV2.Type;
+/** The reactions every `v2` provider can show. Each provider maps them to its own emoji. */
+export declare const Reaction: Schema.Literals<readonly ["thumbs_up", "thumbs_down", "laugh", "confused", "heart", "hooray", "rocket", "eyes"]>;
+export type Reaction = typeof Reaction.Type;
+export declare const PlanItem: Schema.Struct<{
+  readonly itemKey: Schema.NonEmptyString;
+  readonly note: Schema.optionalKey<Schema.NonEmptyString>;
+  readonly state: Schema.Literals<readonly ["pending", "in_progress", "completed", "failed"]>;
+  readonly title: Schema.NonEmptyString;
+}>;
+/** A whole task list, always sent complete. Item keys are unique and stable across revisions. */
+export declare const Plan: Schema.Struct<{
+  readonly items: Schema.$Array<Schema.Struct<{
+    readonly itemKey: Schema.NonEmptyString;
+    readonly note: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly state: Schema.Literals<readonly ["pending", "in_progress", "completed", "failed"]>;
+    readonly title: Schema.NonEmptyString;
+  }>>;
+  readonly title: Schema.optionalKey<Schema.NonEmptyString>;
+}>;
+export type Plan = typeof Plan.Type;
+/**
+ * One piece of `v2` output. A `reference` is the `providerDeliveryKey` the provider returned for
+ * the message or plan it made; only that provider reads it.
+ */
+export declare const Operation: Schema.Union<readonly [Schema.Struct<{
+  readonly kind: Schema.Literal<"present_outcome">;
+  readonly options: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+  readonly outcome: Schema.Literals<readonly ["completed", "failed", "awaiting_input"]>;
+  readonly text: Schema.String;
+}>, Schema.Struct<{
+  readonly kind: Schema.Literal<"create_message">;
+  readonly messageKey: Schema.NonEmptyString;
+  readonly text: Schema.String;
+}>, Schema.Struct<{
+  readonly kind: Schema.Literal<"update_message">;
+  readonly messageKey: Schema.NonEmptyString;
+  readonly reference: Schema.NonEmptyString;
+  readonly text: Schema.String;
+}>, Schema.Struct<{
+  readonly kind: Schema.Literal<"delete_message">;
+  readonly messageKey: Schema.NonEmptyString;
+  readonly reference: Schema.NonEmptyString;
+}>, Schema.Struct<{
+  readonly active: Schema.Boolean;
+  readonly kind: Schema.Literal<"set_reaction">;
+  readonly reaction: Schema.Literals<readonly ["thumbs_up", "thumbs_down", "laugh", "confused", "heart", "hooray", "rocket", "eyes"]>;
+  readonly target: Schema.Union<readonly [Schema.Struct<{
+    readonly kind: Schema.Literal<"activation">;
+  }>, Schema.Struct<{
+    readonly kind: Schema.Literal<"message">;
+    readonly reference: Schema.NonEmptyString;
+  }>]>;
+}>, Schema.Struct<{
+  readonly activity: Schema.Union<readonly [Schema.Struct<{
+    readonly kind: Schema.Literal<"working">;
+    readonly text: Schema.optionalKey<Schema.NonEmptyString>;
+  }>, Schema.Struct<{
+    readonly kind: Schema.Literal<"idle">;
+  }>]>;
+  readonly kind: Schema.Literal<"set_activity">;
+}>, Schema.Struct<{
+  readonly kind: Schema.Literal<"render_plan">;
+  readonly plan: Schema.Struct<{
+    readonly items: Schema.$Array<Schema.Struct<{
+      readonly itemKey: Schema.NonEmptyString;
+      readonly note: Schema.optionalKey<Schema.NonEmptyString>;
+      readonly state: Schema.Literals<readonly ["pending", "in_progress", "completed", "failed"]>;
+      readonly title: Schema.NonEmptyString;
+    }>>;
+    readonly title: Schema.optionalKey<Schema.NonEmptyString>;
+  }>;
+  readonly reference: Schema.optionalKey<Schema.NonEmptyString>;
+  readonly revision: Schema.Int;
+}>]>;
+export type Operation = typeof Operation.Type;
+/** A message read back from the provider's conversation history. */
+export declare const ContextMessage: Schema.Struct<{
+  readonly messageKey: Schema.NonEmptyString;
+  /** The agent's own message. */
+  readonly own: Schema.Boolean;
+  readonly senderKey: Schema.NonEmptyString;
+  readonly senderName: Schema.optionalKey<Schema.NonEmptyString>;
+  readonly text: Schema.String;
+  readonly timestamp: Schema.String;
+}>;
+export type ContextMessage = typeof ContextMessage.Type;
+/** Decoded originals are limited separately by the host; ordinary command JSON stays bounded. */
+export declare const AssetFile: Schema.Struct<{
+  readonly _tag: Schema.tag<"ToolFile">;
+  readonly contentBase64: Schema.String;
+  readonly contentType: Schema.NullOr<Schema.String>;
+  readonly filename: Schema.NullOr<Schema.String>;
+  readonly sizeBytes: Schema.Natural;
+}>;
+/** Closed error vocabulary: provider messages, payloads, and causes never cross this seam. */
+export declare const FailureCode: Schema.Literals<readonly ["rejected", "unauthorized", "rate_limited", "unavailable", "unknown_completion", "window_closed"]>;
+declare const HandlerError_base: Schema.Class<HandlerError, Schema.TaggedStruct<"AgentChannelHandlerError", {
+  readonly code: Schema.Literals<readonly ["rejected", "unauthorized", "rate_limited", "unavailable", "unknown_completion", "window_closed"]>;
+}>, import("effect/Cause").YieldableError>;
+export declare class HandlerError extends HandlerError_base {}
+export declare const ErrorCode: Schema.Literals<readonly ["invalid_definition", "not_found", "invalid_input", "invalid_auth", "unsupported_feature", "invalid_result", "handler_unavailable", "provider_failure"]>;
+declare const ChannelError_base: Schema.Class<ChannelError, Schema.TaggedStruct<"AgentChannelError", {
+  readonly code: Schema.Literals<readonly ["invalid_definition", "not_found", "invalid_input", "invalid_auth", "unsupported_feature", "invalid_result", "handler_unavailable", "provider_failure"]>;
+  readonly providerCode: Schema.optionalKey<Schema.Literals<readonly ["rejected", "unauthorized", "rate_limited", "unavailable", "unknown_completion", "window_closed"]>>;
+}>, import("effect/Cause").YieldableError>;
+export declare class ChannelError extends ChannelError_base {
+  get message(): string;
+}
+export declare const commandSchema: <State extends Schema.Top>(state: State) => Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"activate">;
+  readonly ingressUrl: Schema.String;
+  readonly state: Schema.optionalKey<State>;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly installationKey: Schema.NonEmptyString;
+  readonly state: State;
+  readonly kind: Schema.Literal<"deactivate">;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly installationKey: Schema.NonEmptyString;
+  readonly state: State;
+  readonly kind: Schema.Literal<"receive">;
+  readonly request: Schema.Struct<{
+    readonly body: Schema.String;
+    readonly headers: Schema.$Record<Schema.NonEmptyString, Schema.String>;
+    readonly method: Schema.Literals<readonly ["GET", "POST", "PUT", "PATCH", "DELETE"]>;
+    readonly url: Schema.String;
+  }>;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly installationKey: Schema.NonEmptyString;
+  readonly state: State;
+  readonly kind: Schema.Literal<"deliver">;
+  readonly deliveryKey: Schema.NonEmptyString;
+  readonly destination: Schema.Struct<{
+    readonly conversationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+    readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+  }>;
+  readonly content: Schema.Struct<{
+    readonly assets: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+      readonly assetKey: Schema.NonEmptyString;
+      readonly mediaType: Schema.NonEmptyString;
+      readonly url: Schema.String;
+    }>>>;
+    readonly mentions: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+    readonly replyToMessageKey: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly text: Schema.String;
+  }>;
+  /** Original responding input timestamp; retries must preserve this reference. */
+  readonly responseToTimestamp: Schema.optionalKey<Schema.String>;
+}>]>, Schema.Struct<{
+  readonly asset: Schema.Struct<{
+    readonly assetKey: Schema.NonEmptyString;
+    readonly mediaType: Schema.NonEmptyString;
+    readonly url: Schema.String;
+  }>;
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly identity: Schema.Struct<{
+    readonly conversation: Schema.Struct<{
+      readonly conversationKey: Schema.NonEmptyString;
+      readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+      readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly senderKey: Schema.NonEmptyString;
+  }>;
+  readonly installationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"read_asset">;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly state: State;
+}>]>;
+export declare const resultSchema: <State extends Schema.Top>(state: State) => Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"activate">;
+  readonly installationKey: Schema.NonEmptyString;
+  readonly state: State;
+  /** Durable read-only provider state that the host must persist before retrying activation. */
+  readonly checkpoint: Schema.optionalKey<Schema.Literal<true>>;
+  /** The host must observe a verified webhook handshake before cutover. */
+  readonly verification: Schema.optionalKey<Schema.Literal<"ingress">>;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"deactivate">;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"receive">;
+  readonly verified: Schema.Literal<true>;
+  readonly deniedEventKeys: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+  readonly events: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+    readonly content: Schema.Struct<{
+      readonly assets: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+        readonly assetKey: Schema.NonEmptyString;
+        readonly mediaType: Schema.NonEmptyString;
+        readonly url: Schema.String;
+      }>>>;
+      readonly mentions: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+      readonly replyToMessageKey: Schema.optionalKey<Schema.NonEmptyString>;
+      readonly text: Schema.String;
+    }>;
+    readonly conversation: Schema.Struct<{
+      readonly conversationKey: Schema.NonEmptyString;
+      readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+      readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly eventKey: Schema.NonEmptyString;
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly kind: Schema.Literal<"message">;
+    readonly messageKey: Schema.NonEmptyString;
+    readonly respond: Schema.Boolean;
+    readonly senderKey: Schema.NonEmptyString;
+    readonly timestamp: Schema.String;
+  }>, Schema.Struct<{
+    readonly conversation: Schema.Struct<{
+      readonly conversationKey: Schema.NonEmptyString;
+      readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+      readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly senderKey: Schema.NonEmptyString;
+    readonly eventKey: Schema.NonEmptyString;
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly kind: Schema.Literal<"echo">;
+    readonly messageKey: Schema.NonEmptyString;
+    readonly timestamp: Schema.String;
+  }>, Schema.Struct<{
+    readonly deliveryKey: Schema.NonEmptyString;
+    readonly deliveryUpdateKey: Schema.NonEmptyString;
+    readonly eventKey: Schema.NonEmptyString;
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly kind: Schema.Literal<"delivery_update">;
+    readonly providerDeliveryKey: Schema.NonEmptyString;
+    readonly sequence: Schema.Natural;
+    readonly status: Schema.Literals<readonly ["succeeded", "failed"]>;
+    readonly timestamp: Schema.String;
+  }>]>>;
+  readonly response: Schema.optionalKey<Schema.Struct<{
+    readonly body: Schema.String;
+    readonly headers: Schema.optionalKey<Schema.$Record<Schema.NonEmptyString, Schema.String>>;
+    readonly status: Schema.Int;
+  }>>;
+  /** A provider-native setup challenge or ping proved the configured ingress. */
+  readonly activationProof: Schema.optionalKey<Schema.Literal<"verified">>;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"deliver">;
+  readonly deliveryKey: Schema.NonEmptyString;
+  readonly status: Schema.Literal<"succeeded">;
+  readonly providerDeliveryKey: Schema.NonEmptyString;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"deliver">;
+  readonly deliveryKey: Schema.NonEmptyString;
+  readonly status: Schema.Literal<"pending">;
+  readonly providerDeliveryKey: Schema.NonEmptyString;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"deliver">;
+  readonly deliveryKey: Schema.NonEmptyString;
+  readonly status: Schema.Literal<"failed">;
+  readonly code: Schema.Literals<readonly ["rejected", "unauthorized", "rate_limited", "unavailable", "window_closed"]>;
+}>]>, Schema.Struct<{
+  readonly assetKey: Schema.NonEmptyString;
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly file: Schema.Struct<{
+    readonly _tag: Schema.tag<"ToolFile">;
+    readonly contentBase64: Schema.String;
+    readonly contentType: Schema.NullOr<Schema.String>;
+    readonly filename: Schema.NullOr<Schema.String>;
+    readonly sizeBytes: Schema.Natural;
+  }>;
+  readonly kind: Schema.Literal<"read_asset">;
+  readonly operationKey: Schema.NonEmptyString;
+}>]>;
+export declare const commandSchemaV2: <State extends Schema.Top>(state: State) => Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"activate">;
+  readonly ingressUrl: Schema.String;
+  readonly state: Schema.optionalKey<State>;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly installationKey: Schema.NonEmptyString;
+  readonly state: State;
+  readonly kind: Schema.Literal<"deactivate">;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly installationKey: Schema.NonEmptyString;
+  readonly state: State;
+  readonly kind: Schema.Literal<"receive">;
+  readonly request: Schema.Struct<{
+    readonly body: Schema.String;
+    readonly headers: Schema.$Record<Schema.NonEmptyString, Schema.String>;
+    readonly method: Schema.Literals<readonly ["GET", "POST", "PUT", "PATCH", "DELETE"]>;
+    readonly url: Schema.String;
+  }>;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly installationKey: Schema.NonEmptyString;
+  readonly state: State;
+  readonly kind: Schema.Literal<"deliver">;
+  /** The provider message that started the turn, when the host knows it. */
+  readonly activationMessageKey: Schema.optionalKey<Schema.NonEmptyString>;
+  readonly deliveryKey: Schema.NonEmptyString;
+  readonly destination: Schema.Struct<{
+    readonly conversationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+    readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+  }>;
+  readonly operation: Schema.Union<readonly [Schema.Struct<{
+    readonly kind: Schema.Literal<"present_outcome">;
+    readonly options: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+    readonly outcome: Schema.Literals<readonly ["completed", "failed", "awaiting_input"]>;
+    readonly text: Schema.String;
+  }>, Schema.Struct<{
+    readonly kind: Schema.Literal<"create_message">;
+    readonly messageKey: Schema.NonEmptyString;
+    readonly text: Schema.String;
+  }>, Schema.Struct<{
+    readonly kind: Schema.Literal<"update_message">;
+    readonly messageKey: Schema.NonEmptyString;
+    readonly reference: Schema.NonEmptyString;
+    readonly text: Schema.String;
+  }>, Schema.Struct<{
+    readonly kind: Schema.Literal<"delete_message">;
+    readonly messageKey: Schema.NonEmptyString;
+    readonly reference: Schema.NonEmptyString;
+  }>, Schema.Struct<{
+    readonly active: Schema.Boolean;
+    readonly kind: Schema.Literal<"set_reaction">;
+    readonly reaction: Schema.Literals<readonly ["thumbs_up", "thumbs_down", "laugh", "confused", "heart", "hooray", "rocket", "eyes"]>;
+    readonly target: Schema.Union<readonly [Schema.Struct<{
+      readonly kind: Schema.Literal<"activation">;
+    }>, Schema.Struct<{
+      readonly kind: Schema.Literal<"message">;
+      readonly reference: Schema.NonEmptyString;
+    }>]>;
+  }>, Schema.Struct<{
+    readonly activity: Schema.Union<readonly [Schema.Struct<{
+      readonly kind: Schema.Literal<"working">;
+      readonly text: Schema.optionalKey<Schema.NonEmptyString>;
+    }>, Schema.Struct<{
+      readonly kind: Schema.Literal<"idle">;
+    }>]>;
+    readonly kind: Schema.Literal<"set_activity">;
+  }>, Schema.Struct<{
+    readonly kind: Schema.Literal<"render_plan">;
+    readonly plan: Schema.Struct<{
+      readonly items: Schema.$Array<Schema.Struct<{
+        readonly itemKey: Schema.NonEmptyString;
+        readonly note: Schema.optionalKey<Schema.NonEmptyString>;
+        readonly state: Schema.Literals<readonly ["pending", "in_progress", "completed", "failed"]>;
+        readonly title: Schema.NonEmptyString;
+      }>>;
+      readonly title: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly reference: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly revision: Schema.Int;
+  }>]>;
+  /** Original responding input timestamp; retries must preserve this reference. */
+  readonly responseToTimestamp: Schema.optionalKey<Schema.String>;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly installationKey: Schema.NonEmptyString;
+  readonly state: State;
+  readonly kind: Schema.Literal<"read_context">;
+  readonly destination: Schema.Struct<{
+    readonly conversationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+    readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+  }>;
+  readonly limit: Schema.Int;
+}>]>, Schema.Struct<{
+  readonly asset: Schema.Struct<{
+    readonly assetKey: Schema.NonEmptyString;
+    readonly mediaType: Schema.NonEmptyString;
+    readonly url: Schema.String;
+  }>;
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly identity: Schema.Struct<{
+    readonly conversation: Schema.Struct<{
+      readonly conversationKey: Schema.NonEmptyString;
+      readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+      readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly senderKey: Schema.NonEmptyString;
+  }>;
+  readonly installationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"read_asset">;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly state: State;
+}>]>;
+export declare const resultSchemaV2: <State extends Schema.Top>(state: State) => Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"activate">;
+  readonly installationKey: Schema.NonEmptyString;
+  readonly state: State;
+  /** Durable read-only provider state that the host must persist before retrying activation. */
+  readonly checkpoint: Schema.optionalKey<Schema.Literal<true>>;
+  /** The host must observe a verified webhook handshake before cutover. */
+  readonly verification: Schema.optionalKey<Schema.Literal<"ingress">>;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"deactivate">;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"receive">;
+  readonly verified: Schema.Literal<true>;
+  readonly deniedEventKeys: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+  readonly events: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+    readonly content: Schema.Struct<{
+      readonly assets: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+        readonly assetKey: Schema.NonEmptyString;
+        readonly mediaType: Schema.NonEmptyString;
+        readonly url: Schema.String;
+      }>>>;
+      readonly mentions: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+      readonly replyToMessageKey: Schema.optionalKey<Schema.NonEmptyString>;
+      readonly text: Schema.String;
+    }>;
+    readonly conversation: Schema.Struct<{
+      readonly conversationKey: Schema.NonEmptyString;
+      readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+      readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly eventKey: Schema.NonEmptyString;
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly kind: Schema.Literal<"message">;
+    readonly messageKey: Schema.NonEmptyString;
+    readonly respond: Schema.Boolean;
+    readonly senderKey: Schema.NonEmptyString;
+    readonly timestamp: Schema.String;
+  }>, Schema.Struct<{
+    readonly conversation: Schema.Struct<{
+      readonly conversationKey: Schema.NonEmptyString;
+      readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+      readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly senderKey: Schema.NonEmptyString;
+    readonly eventKey: Schema.NonEmptyString;
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly kind: Schema.Literal<"echo">;
+    readonly messageKey: Schema.NonEmptyString;
+    readonly timestamp: Schema.String;
+  }>, Schema.Struct<{
+    readonly deliveryKey: Schema.NonEmptyString;
+    readonly deliveryUpdateKey: Schema.NonEmptyString;
+    readonly eventKey: Schema.NonEmptyString;
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly kind: Schema.Literal<"delivery_update">;
+    readonly providerDeliveryKey: Schema.NonEmptyString;
+    readonly sequence: Schema.Natural;
+    readonly status: Schema.Literals<readonly ["succeeded", "failed"]>;
+    readonly timestamp: Schema.String;
+  }>, Schema.Struct<{
+    readonly conversation: Schema.Struct<{
+      readonly conversationKey: Schema.NonEmptyString;
+      readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+      readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly senderKey: Schema.NonEmptyString;
+    readonly eventKey: Schema.NonEmptyString;
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly kind: Schema.Literal<"stop">;
+    readonly timestamp: Schema.String;
+  }>]>>;
+  readonly response: Schema.optionalKey<Schema.Struct<{
+    readonly body: Schema.String;
+    readonly headers: Schema.optionalKey<Schema.$Record<Schema.NonEmptyString, Schema.String>>;
+    readonly status: Schema.Int;
+  }>>;
+  /** A provider-native setup challenge or ping proved the configured ingress. */
+  readonly activationProof: Schema.optionalKey<Schema.Literal<"verified">>;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"deliver">;
+  readonly deliveryKey: Schema.NonEmptyString;
+  readonly status: Schema.Literal<"succeeded">;
+  readonly providerDeliveryKey: Schema.NonEmptyString;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"deliver">;
+  readonly deliveryKey: Schema.NonEmptyString;
+  readonly status: Schema.Literal<"pending">;
+  readonly providerDeliveryKey: Schema.NonEmptyString;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"deliver">;
+  readonly deliveryKey: Schema.NonEmptyString;
+  readonly status: Schema.Literal<"failed">;
+  readonly code: Schema.Literals<readonly ["rejected", "unauthorized", "rate_limited", "unavailable", "window_closed"]>;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"read_context">;
+  readonly messages: Schema.$Array<Schema.Struct<{
+    readonly messageKey: Schema.NonEmptyString;
+    /** The agent's own message. */
+    readonly own: Schema.Boolean;
+    readonly senderKey: Schema.NonEmptyString;
+    readonly senderName: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly text: Schema.String;
+    readonly timestamp: Schema.String;
+  }>>;
+}>]>, Schema.Struct<{
+  readonly assetKey: Schema.NonEmptyString;
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly file: Schema.Struct<{
+    readonly _tag: Schema.tag<"ToolFile">;
+    readonly contentBase64: Schema.String;
+    readonly contentType: Schema.NullOr<Schema.String>;
+    readonly filename: Schema.NullOr<Schema.String>;
+    readonly sizeBytes: Schema.Natural;
+  }>;
+  readonly kind: Schema.Literal<"read_asset">;
+  readonly operationKey: Schema.NonEmptyString;
+}>]>;
+export type Command<State extends Schema.Top = Schema.Unknown> = ReturnType<typeof commandSchema<State>>["Type"];
+export type Result<State extends Schema.Top = Schema.Unknown> = ReturnType<typeof resultSchema<State>>["Type"];
+export type CommandV2<State extends Schema.Top = Schema.Unknown> = ReturnType<typeof commandSchemaV2<State>>["Type"];
+export type ResultV2<State extends Schema.Top = Schema.Unknown> = ReturnType<typeof resultSchemaV2<State>>["Type"];
+/** The command and result schemas of a Channel's protocol. */
+export declare const schemasFor: (definition: Pick<Definition, "protocol" | "state">) => {
+  command: Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"activate">;
+    readonly ingressUrl: Schema.String;
+    readonly state: Schema.optionalKey<Schema.Top>;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly installationKey: Schema.NonEmptyString;
+    readonly state: Schema.Top;
+    readonly kind: Schema.Literal<"deactivate">;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly installationKey: Schema.NonEmptyString;
+    readonly state: Schema.Top;
+    readonly kind: Schema.Literal<"receive">;
+    readonly request: Schema.Struct<{
+      readonly body: Schema.String;
+      readonly headers: Schema.$Record<Schema.NonEmptyString, Schema.String>;
+      readonly method: Schema.Literals<readonly ["GET", "POST", "PUT", "PATCH", "DELETE"]>;
+      readonly url: Schema.String;
+    }>;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly installationKey: Schema.NonEmptyString;
+    readonly state: Schema.Top;
+    readonly kind: Schema.Literal<"deliver">;
+    /** The provider message that started the turn, when the host knows it. */
+    readonly activationMessageKey: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly deliveryKey: Schema.NonEmptyString;
+    readonly destination: Schema.Struct<{
+      readonly conversationKey: Schema.NonEmptyString;
+      readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+      readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly operation: Schema.Union<readonly [Schema.Struct<{
+      readonly kind: Schema.Literal<"present_outcome">;
+      readonly options: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+      readonly outcome: Schema.Literals<readonly ["completed", "failed", "awaiting_input"]>;
+      readonly text: Schema.String;
+    }>, Schema.Struct<{
+      readonly kind: Schema.Literal<"create_message">;
+      readonly messageKey: Schema.NonEmptyString;
+      readonly text: Schema.String;
+    }>, Schema.Struct<{
+      readonly kind: Schema.Literal<"update_message">;
+      readonly messageKey: Schema.NonEmptyString;
+      readonly reference: Schema.NonEmptyString;
+      readonly text: Schema.String;
+    }>, Schema.Struct<{
+      readonly kind: Schema.Literal<"delete_message">;
+      readonly messageKey: Schema.NonEmptyString;
+      readonly reference: Schema.NonEmptyString;
+    }>, Schema.Struct<{
+      readonly active: Schema.Boolean;
+      readonly kind: Schema.Literal<"set_reaction">;
+      readonly reaction: Schema.Literals<readonly ["thumbs_up", "thumbs_down", "laugh", "confused", "heart", "hooray", "rocket", "eyes"]>;
+      readonly target: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"activation">;
+      }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"message">;
+        readonly reference: Schema.NonEmptyString;
+      }>]>;
+    }>, Schema.Struct<{
+      readonly activity: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"working">;
+        readonly text: Schema.optionalKey<Schema.NonEmptyString>;
+      }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"idle">;
+      }>]>;
+      readonly kind: Schema.Literal<"set_activity">;
+    }>, Schema.Struct<{
+      readonly kind: Schema.Literal<"render_plan">;
+      readonly plan: Schema.Struct<{
+        readonly items: Schema.$Array<Schema.Struct<{
+          readonly itemKey: Schema.NonEmptyString;
+          readonly note: Schema.optionalKey<Schema.NonEmptyString>;
+          readonly state: Schema.Literals<readonly ["pending", "in_progress", "completed", "failed"]>;
+          readonly title: Schema.NonEmptyString;
+        }>>;
+        readonly title: Schema.optionalKey<Schema.NonEmptyString>;
+      }>;
+      readonly reference: Schema.optionalKey<Schema.NonEmptyString>;
+      readonly revision: Schema.Int;
+    }>]>;
+    /** Original responding input timestamp; retries must preserve this reference. */
+    readonly responseToTimestamp: Schema.optionalKey<Schema.String>;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly installationKey: Schema.NonEmptyString;
+    readonly state: Schema.Top;
+    readonly kind: Schema.Literal<"read_context">;
+    readonly destination: Schema.Struct<{
+      readonly conversationKey: Schema.NonEmptyString;
+      readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+      readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly limit: Schema.Int;
+  }>]>, Schema.Struct<{
+    readonly asset: Schema.Struct<{
+      readonly assetKey: Schema.NonEmptyString;
+      readonly mediaType: Schema.NonEmptyString;
+      readonly url: Schema.String;
+    }>;
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly identity: Schema.Struct<{
+      readonly conversation: Schema.Struct<{
+        readonly conversationKey: Schema.NonEmptyString;
+        readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+        readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+      }>;
+      readonly senderKey: Schema.NonEmptyString;
+    }>;
+    readonly installationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"read_asset">;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly state: Schema.Top;
+  }>]>;
+  result: Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"activate">;
+    readonly installationKey: Schema.NonEmptyString;
+    readonly state: Schema.Top;
+    /** Durable read-only provider state that the host must persist before retrying activation. */
+    readonly checkpoint: Schema.optionalKey<Schema.Literal<true>>;
+    /** The host must observe a verified webhook handshake before cutover. */
+    readonly verification: Schema.optionalKey<Schema.Literal<"ingress">>;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"deactivate">;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"receive">;
+    readonly verified: Schema.Literal<true>;
+    readonly deniedEventKeys: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+    readonly events: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+      readonly content: Schema.Struct<{
+        readonly assets: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+          readonly assetKey: Schema.NonEmptyString;
+          readonly mediaType: Schema.NonEmptyString;
+          readonly url: Schema.String;
+        }>>>;
+        readonly mentions: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+        readonly replyToMessageKey: Schema.optionalKey<Schema.NonEmptyString>;
+        readonly text: Schema.String;
+      }>;
+      readonly conversation: Schema.Struct<{
+        readonly conversationKey: Schema.NonEmptyString;
+        readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+        readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+      }>;
+      readonly eventKey: Schema.NonEmptyString;
+      readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+      readonly kind: Schema.Literal<"message">;
+      readonly messageKey: Schema.NonEmptyString;
+      readonly respond: Schema.Boolean;
+      readonly senderKey: Schema.NonEmptyString;
+      readonly timestamp: Schema.String;
+    }>, Schema.Struct<{
+      readonly conversation: Schema.Struct<{
+        readonly conversationKey: Schema.NonEmptyString;
+        readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+        readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+      }>;
+      readonly senderKey: Schema.NonEmptyString;
+      readonly eventKey: Schema.NonEmptyString;
+      readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+      readonly kind: Schema.Literal<"echo">;
+      readonly messageKey: Schema.NonEmptyString;
+      readonly timestamp: Schema.String;
+    }>, Schema.Struct<{
+      readonly deliveryKey: Schema.NonEmptyString;
+      readonly deliveryUpdateKey: Schema.NonEmptyString;
+      readonly eventKey: Schema.NonEmptyString;
+      readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+      readonly kind: Schema.Literal<"delivery_update">;
+      readonly providerDeliveryKey: Schema.NonEmptyString;
+      readonly sequence: Schema.Natural;
+      readonly status: Schema.Literals<readonly ["succeeded", "failed"]>;
+      readonly timestamp: Schema.String;
+    }>, Schema.Struct<{
+      readonly conversation: Schema.Struct<{
+        readonly conversationKey: Schema.NonEmptyString;
+        readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+        readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+      }>;
+      readonly senderKey: Schema.NonEmptyString;
+      readonly eventKey: Schema.NonEmptyString;
+      readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+      readonly kind: Schema.Literal<"stop">;
+      readonly timestamp: Schema.String;
+    }>]>>;
+    readonly response: Schema.optionalKey<Schema.Struct<{
+      readonly body: Schema.String;
+      readonly headers: Schema.optionalKey<Schema.$Record<Schema.NonEmptyString, Schema.String>>;
+      readonly status: Schema.Int;
+    }>>;
+    /** A provider-native setup challenge or ping proved the configured ingress. */
+    readonly activationProof: Schema.optionalKey<Schema.Literal<"verified">>;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"deliver">;
+    readonly deliveryKey: Schema.NonEmptyString;
+    readonly status: Schema.Literal<"succeeded">;
+    readonly providerDeliveryKey: Schema.NonEmptyString;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"deliver">;
+    readonly deliveryKey: Schema.NonEmptyString;
+    readonly status: Schema.Literal<"pending">;
+    readonly providerDeliveryKey: Schema.NonEmptyString;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"deliver">;
+    readonly deliveryKey: Schema.NonEmptyString;
+    readonly status: Schema.Literal<"failed">;
+    readonly code: Schema.Literals<readonly ["rejected", "unauthorized", "rate_limited", "unavailable", "window_closed"]>;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"read_context">;
+    readonly messages: Schema.$Array<Schema.Struct<{
+      readonly messageKey: Schema.NonEmptyString;
+      /** The agent's own message. */
+      readonly own: Schema.Boolean;
+      readonly senderKey: Schema.NonEmptyString;
+      readonly senderName: Schema.optionalKey<Schema.NonEmptyString>;
+      readonly text: Schema.String;
+      readonly timestamp: Schema.String;
+    }>>;
+  }>]>, Schema.Struct<{
+    readonly assetKey: Schema.NonEmptyString;
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly file: Schema.Struct<{
+      readonly _tag: Schema.tag<"ToolFile">;
+      readonly contentBase64: Schema.String;
+      readonly contentType: Schema.NullOr<Schema.String>;
+      readonly filename: Schema.NullOr<Schema.String>;
+      readonly sizeBytes: Schema.Natural;
+    }>;
+    readonly kind: Schema.Literal<"read_asset">;
+    readonly operationKey: Schema.NonEmptyString;
+  }>]>;
+  typeResult: Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"activate">;
+    readonly installationKey: Schema.NonEmptyString;
+    readonly state: Schema.toType<Schema.Top>;
+    /** Durable read-only provider state that the host must persist before retrying activation. */
+    readonly checkpoint: Schema.optionalKey<Schema.Literal<true>>;
+    /** The host must observe a verified webhook handshake before cutover. */
+    readonly verification: Schema.optionalKey<Schema.Literal<"ingress">>;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"deactivate">;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"receive">;
+    readonly verified: Schema.Literal<true>;
+    readonly deniedEventKeys: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+    readonly events: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+      readonly content: Schema.Struct<{
+        readonly assets: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+          readonly assetKey: Schema.NonEmptyString;
+          readonly mediaType: Schema.NonEmptyString;
+          readonly url: Schema.String;
+        }>>>;
+        readonly mentions: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+        readonly replyToMessageKey: Schema.optionalKey<Schema.NonEmptyString>;
+        readonly text: Schema.String;
+      }>;
+      readonly conversation: Schema.Struct<{
+        readonly conversationKey: Schema.NonEmptyString;
+        readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+        readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+      }>;
+      readonly eventKey: Schema.NonEmptyString;
+      readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+      readonly kind: Schema.Literal<"message">;
+      readonly messageKey: Schema.NonEmptyString;
+      readonly respond: Schema.Boolean;
+      readonly senderKey: Schema.NonEmptyString;
+      readonly timestamp: Schema.String;
+    }>, Schema.Struct<{
+      readonly conversation: Schema.Struct<{
+        readonly conversationKey: Schema.NonEmptyString;
+        readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+        readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+      }>;
+      readonly senderKey: Schema.NonEmptyString;
+      readonly eventKey: Schema.NonEmptyString;
+      readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+      readonly kind: Schema.Literal<"echo">;
+      readonly messageKey: Schema.NonEmptyString;
+      readonly timestamp: Schema.String;
+    }>, Schema.Struct<{
+      readonly deliveryKey: Schema.NonEmptyString;
+      readonly deliveryUpdateKey: Schema.NonEmptyString;
+      readonly eventKey: Schema.NonEmptyString;
+      readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+      readonly kind: Schema.Literal<"delivery_update">;
+      readonly providerDeliveryKey: Schema.NonEmptyString;
+      readonly sequence: Schema.Natural;
+      readonly status: Schema.Literals<readonly ["succeeded", "failed"]>;
+      readonly timestamp: Schema.String;
+    }>, Schema.Struct<{
+      readonly conversation: Schema.Struct<{
+        readonly conversationKey: Schema.NonEmptyString;
+        readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+        readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+      }>;
+      readonly senderKey: Schema.NonEmptyString;
+      readonly eventKey: Schema.NonEmptyString;
+      readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+      readonly kind: Schema.Literal<"stop">;
+      readonly timestamp: Schema.String;
+    }>]>>;
+    readonly response: Schema.optionalKey<Schema.Struct<{
+      readonly body: Schema.String;
+      readonly headers: Schema.optionalKey<Schema.$Record<Schema.NonEmptyString, Schema.String>>;
+      readonly status: Schema.Int;
+    }>>;
+    /** A provider-native setup challenge or ping proved the configured ingress. */
+    readonly activationProof: Schema.optionalKey<Schema.Literal<"verified">>;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"deliver">;
+    readonly deliveryKey: Schema.NonEmptyString;
+    readonly status: Schema.Literal<"succeeded">;
+    readonly providerDeliveryKey: Schema.NonEmptyString;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"deliver">;
+    readonly deliveryKey: Schema.NonEmptyString;
+    readonly status: Schema.Literal<"pending">;
+    readonly providerDeliveryKey: Schema.NonEmptyString;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"deliver">;
+    readonly deliveryKey: Schema.NonEmptyString;
+    readonly status: Schema.Literal<"failed">;
+    readonly code: Schema.Literals<readonly ["rejected", "unauthorized", "rate_limited", "unavailable", "window_closed"]>;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"read_context">;
+    readonly messages: Schema.$Array<Schema.Struct<{
+      readonly messageKey: Schema.NonEmptyString;
+      /** The agent's own message. */
+      readonly own: Schema.Boolean;
+      readonly senderKey: Schema.NonEmptyString;
+      readonly senderName: Schema.optionalKey<Schema.NonEmptyString>;
+      readonly text: Schema.String;
+      readonly timestamp: Schema.String;
+    }>>;
+  }>]>, Schema.Struct<{
+    readonly assetKey: Schema.NonEmptyString;
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly file: Schema.Struct<{
+      readonly _tag: Schema.tag<"ToolFile">;
+      readonly contentBase64: Schema.String;
+      readonly contentType: Schema.NullOr<Schema.String>;
+      readonly filename: Schema.NullOr<Schema.String>;
+      readonly sizeBytes: Schema.Natural;
+    }>;
+    readonly kind: Schema.Literal<"read_asset">;
+    readonly operationKey: Schema.NonEmptyString;
+  }>]>;
+} | {
+  command: Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"activate">;
+    readonly ingressUrl: Schema.String;
+    readonly state: Schema.optionalKey<Schema.Top>;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly installationKey: Schema.NonEmptyString;
+    readonly state: Schema.Top;
+    readonly kind: Schema.Literal<"deactivate">;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly installationKey: Schema.NonEmptyString;
+    readonly state: Schema.Top;
+    readonly kind: Schema.Literal<"receive">;
+    readonly request: Schema.Struct<{
+      readonly body: Schema.String;
+      readonly headers: Schema.$Record<Schema.NonEmptyString, Schema.String>;
+      readonly method: Schema.Literals<readonly ["GET", "POST", "PUT", "PATCH", "DELETE"]>;
+      readonly url: Schema.String;
+    }>;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly installationKey: Schema.NonEmptyString;
+    readonly state: Schema.Top;
+    readonly kind: Schema.Literal<"deliver">;
+    readonly deliveryKey: Schema.NonEmptyString;
+    readonly destination: Schema.Struct<{
+      readonly conversationKey: Schema.NonEmptyString;
+      readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+      readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly content: Schema.Struct<{
+      readonly assets: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+        readonly assetKey: Schema.NonEmptyString;
+        readonly mediaType: Schema.NonEmptyString;
+        readonly url: Schema.String;
+      }>>>;
+      readonly mentions: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+      readonly replyToMessageKey: Schema.optionalKey<Schema.NonEmptyString>;
+      readonly text: Schema.String;
+    }>;
+    /** Original responding input timestamp; retries must preserve this reference. */
+    readonly responseToTimestamp: Schema.optionalKey<Schema.String>;
+  }>]>, Schema.Struct<{
+    readonly asset: Schema.Struct<{
+      readonly assetKey: Schema.NonEmptyString;
+      readonly mediaType: Schema.NonEmptyString;
+      readonly url: Schema.String;
+    }>;
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly identity: Schema.Struct<{
+      readonly conversation: Schema.Struct<{
+        readonly conversationKey: Schema.NonEmptyString;
+        readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+        readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+      }>;
+      readonly senderKey: Schema.NonEmptyString;
+    }>;
+    readonly installationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"read_asset">;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly state: Schema.Top;
+  }>]>;
+  result: Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"activate">;
+    readonly installationKey: Schema.NonEmptyString;
+    readonly state: Schema.Top;
+    /** Durable read-only provider state that the host must persist before retrying activation. */
+    readonly checkpoint: Schema.optionalKey<Schema.Literal<true>>;
+    /** The host must observe a verified webhook handshake before cutover. */
+    readonly verification: Schema.optionalKey<Schema.Literal<"ingress">>;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"deactivate">;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"receive">;
+    readonly verified: Schema.Literal<true>;
+    readonly deniedEventKeys: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+    readonly events: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+      readonly content: Schema.Struct<{
+        readonly assets: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+          readonly assetKey: Schema.NonEmptyString;
+          readonly mediaType: Schema.NonEmptyString;
+          readonly url: Schema.String;
+        }>>>;
+        readonly mentions: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+        readonly replyToMessageKey: Schema.optionalKey<Schema.NonEmptyString>;
+        readonly text: Schema.String;
+      }>;
+      readonly conversation: Schema.Struct<{
+        readonly conversationKey: Schema.NonEmptyString;
+        readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+        readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+      }>;
+      readonly eventKey: Schema.NonEmptyString;
+      readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+      readonly kind: Schema.Literal<"message">;
+      readonly messageKey: Schema.NonEmptyString;
+      readonly respond: Schema.Boolean;
+      readonly senderKey: Schema.NonEmptyString;
+      readonly timestamp: Schema.String;
+    }>, Schema.Struct<{
+      readonly conversation: Schema.Struct<{
+        readonly conversationKey: Schema.NonEmptyString;
+        readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+        readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+      }>;
+      readonly senderKey: Schema.NonEmptyString;
+      readonly eventKey: Schema.NonEmptyString;
+      readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+      readonly kind: Schema.Literal<"echo">;
+      readonly messageKey: Schema.NonEmptyString;
+      readonly timestamp: Schema.String;
+    }>, Schema.Struct<{
+      readonly deliveryKey: Schema.NonEmptyString;
+      readonly deliveryUpdateKey: Schema.NonEmptyString;
+      readonly eventKey: Schema.NonEmptyString;
+      readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+      readonly kind: Schema.Literal<"delivery_update">;
+      readonly providerDeliveryKey: Schema.NonEmptyString;
+      readonly sequence: Schema.Natural;
+      readonly status: Schema.Literals<readonly ["succeeded", "failed"]>;
+      readonly timestamp: Schema.String;
+    }>]>>;
+    readonly response: Schema.optionalKey<Schema.Struct<{
+      readonly body: Schema.String;
+      readonly headers: Schema.optionalKey<Schema.$Record<Schema.NonEmptyString, Schema.String>>;
+      readonly status: Schema.Int;
+    }>>;
+    /** A provider-native setup challenge or ping proved the configured ingress. */
+    readonly activationProof: Schema.optionalKey<Schema.Literal<"verified">>;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"deliver">;
+    readonly deliveryKey: Schema.NonEmptyString;
+    readonly status: Schema.Literal<"succeeded">;
+    readonly providerDeliveryKey: Schema.NonEmptyString;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"deliver">;
+    readonly deliveryKey: Schema.NonEmptyString;
+    readonly status: Schema.Literal<"pending">;
+    readonly providerDeliveryKey: Schema.NonEmptyString;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"deliver">;
+    readonly deliveryKey: Schema.NonEmptyString;
+    readonly status: Schema.Literal<"failed">;
+    readonly code: Schema.Literals<readonly ["rejected", "unauthorized", "rate_limited", "unavailable", "window_closed"]>;
+  }>]>, Schema.Struct<{
+    readonly assetKey: Schema.NonEmptyString;
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly file: Schema.Struct<{
+      readonly _tag: Schema.tag<"ToolFile">;
+      readonly contentBase64: Schema.String;
+      readonly contentType: Schema.NullOr<Schema.String>;
+      readonly filename: Schema.NullOr<Schema.String>;
+      readonly sizeBytes: Schema.Natural;
+    }>;
+    readonly kind: Schema.Literal<"read_asset">;
+    readonly operationKey: Schema.NonEmptyString;
+  }>]>;
+  typeResult: Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"activate">;
+    readonly installationKey: Schema.NonEmptyString;
+    readonly state: Schema.toType<Schema.Top>;
+    /** Durable read-only provider state that the host must persist before retrying activation. */
+    readonly checkpoint: Schema.optionalKey<Schema.Literal<true>>;
+    /** The host must observe a verified webhook handshake before cutover. */
+    readonly verification: Schema.optionalKey<Schema.Literal<"ingress">>;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"deactivate">;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"receive">;
+    readonly verified: Schema.Literal<true>;
+    readonly deniedEventKeys: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+    readonly events: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+      readonly content: Schema.Struct<{
+        readonly assets: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+          readonly assetKey: Schema.NonEmptyString;
+          readonly mediaType: Schema.NonEmptyString;
+          readonly url: Schema.String;
+        }>>>;
+        readonly mentions: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+        readonly replyToMessageKey: Schema.optionalKey<Schema.NonEmptyString>;
+        readonly text: Schema.String;
+      }>;
+      readonly conversation: Schema.Struct<{
+        readonly conversationKey: Schema.NonEmptyString;
+        readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+        readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+      }>;
+      readonly eventKey: Schema.NonEmptyString;
+      readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+      readonly kind: Schema.Literal<"message">;
+      readonly messageKey: Schema.NonEmptyString;
+      readonly respond: Schema.Boolean;
+      readonly senderKey: Schema.NonEmptyString;
+      readonly timestamp: Schema.String;
+    }>, Schema.Struct<{
+      readonly conversation: Schema.Struct<{
+        readonly conversationKey: Schema.NonEmptyString;
+        readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+        readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+      }>;
+      readonly senderKey: Schema.NonEmptyString;
+      readonly eventKey: Schema.NonEmptyString;
+      readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+      readonly kind: Schema.Literal<"echo">;
+      readonly messageKey: Schema.NonEmptyString;
+      readonly timestamp: Schema.String;
+    }>, Schema.Struct<{
+      readonly deliveryKey: Schema.NonEmptyString;
+      readonly deliveryUpdateKey: Schema.NonEmptyString;
+      readonly eventKey: Schema.NonEmptyString;
+      readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+      readonly kind: Schema.Literal<"delivery_update">;
+      readonly providerDeliveryKey: Schema.NonEmptyString;
+      readonly sequence: Schema.Natural;
+      readonly status: Schema.Literals<readonly ["succeeded", "failed"]>;
+      readonly timestamp: Schema.String;
+    }>]>>;
+    readonly response: Schema.optionalKey<Schema.Struct<{
+      readonly body: Schema.String;
+      readonly headers: Schema.optionalKey<Schema.$Record<Schema.NonEmptyString, Schema.String>>;
+      readonly status: Schema.Int;
+    }>>;
+    /** A provider-native setup challenge or ping proved the configured ingress. */
+    readonly activationProof: Schema.optionalKey<Schema.Literal<"verified">>;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"deliver">;
+    readonly deliveryKey: Schema.NonEmptyString;
+    readonly status: Schema.Literal<"succeeded">;
+    readonly providerDeliveryKey: Schema.NonEmptyString;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"deliver">;
+    readonly deliveryKey: Schema.NonEmptyString;
+    readonly status: Schema.Literal<"pending">;
+    readonly providerDeliveryKey: Schema.NonEmptyString;
+  }>, Schema.Struct<{
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly operationKey: Schema.NonEmptyString;
+    readonly kind: Schema.Literal<"deliver">;
+    readonly deliveryKey: Schema.NonEmptyString;
+    readonly status: Schema.Literal<"failed">;
+    readonly code: Schema.Literals<readonly ["rejected", "unauthorized", "rate_limited", "unavailable", "window_closed"]>;
+  }>]>, Schema.Struct<{
+    readonly assetKey: Schema.NonEmptyString;
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly file: Schema.Struct<{
+      readonly _tag: Schema.tag<"ToolFile">;
+      readonly contentBase64: Schema.String;
+      readonly contentType: Schema.NullOr<Schema.String>;
+      readonly filename: Schema.NullOr<Schema.String>;
+      readonly sizeBytes: Schema.Natural;
+    }>;
+    readonly kind: Schema.Literal<"read_asset">;
+    readonly operationKey: Schema.NonEmptyString;
+  }>]>;
+};
+/**
+ * Encoded, JSON-safe runtime result suitable for host persistence. It accepts both protocols;
+ * a `v1` result decodes unchanged.
+ */
+export declare const CheckedResult: Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"activate">;
+  readonly installationKey: Schema.NonEmptyString;
+  readonly state: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  /** Durable read-only provider state that the host must persist before retrying activation. */
+  readonly checkpoint: Schema.optionalKey<Schema.Literal<true>>;
+  /** The host must observe a verified webhook handshake before cutover. */
+  readonly verification: Schema.optionalKey<Schema.Literal<"ingress">>;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"deactivate">;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"receive">;
+  readonly verified: Schema.Literal<true>;
+  readonly deniedEventKeys: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+  readonly events: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+    readonly content: Schema.Struct<{
+      readonly assets: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+        readonly assetKey: Schema.NonEmptyString;
+        readonly mediaType: Schema.NonEmptyString;
+        readonly url: Schema.String;
+      }>>>;
+      readonly mentions: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+      readonly replyToMessageKey: Schema.optionalKey<Schema.NonEmptyString>;
+      readonly text: Schema.String;
+    }>;
+    readonly conversation: Schema.Struct<{
+      readonly conversationKey: Schema.NonEmptyString;
+      readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+      readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly eventKey: Schema.NonEmptyString;
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly kind: Schema.Literal<"message">;
+    readonly messageKey: Schema.NonEmptyString;
+    readonly respond: Schema.Boolean;
+    readonly senderKey: Schema.NonEmptyString;
+    readonly timestamp: Schema.String;
+  }>, Schema.Struct<{
+    readonly conversation: Schema.Struct<{
+      readonly conversationKey: Schema.NonEmptyString;
+      readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+      readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly senderKey: Schema.NonEmptyString;
+    readonly eventKey: Schema.NonEmptyString;
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly kind: Schema.Literal<"echo">;
+    readonly messageKey: Schema.NonEmptyString;
+    readonly timestamp: Schema.String;
+  }>, Schema.Struct<{
+    readonly deliveryKey: Schema.NonEmptyString;
+    readonly deliveryUpdateKey: Schema.NonEmptyString;
+    readonly eventKey: Schema.NonEmptyString;
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly kind: Schema.Literal<"delivery_update">;
+    readonly providerDeliveryKey: Schema.NonEmptyString;
+    readonly sequence: Schema.Natural;
+    readonly status: Schema.Literals<readonly ["succeeded", "failed"]>;
+    readonly timestamp: Schema.String;
+  }>, Schema.Struct<{
+    readonly conversation: Schema.Struct<{
+      readonly conversationKey: Schema.NonEmptyString;
+      readonly kind: Schema.Literals<readonly ["direct", "group"]>;
+      readonly threadKey: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly senderKey: Schema.NonEmptyString;
+    readonly eventKey: Schema.NonEmptyString;
+    readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly kind: Schema.Literal<"stop">;
+    readonly timestamp: Schema.String;
+  }>]>>;
+  readonly response: Schema.optionalKey<Schema.Struct<{
+    readonly body: Schema.String;
+    readonly headers: Schema.optionalKey<Schema.$Record<Schema.NonEmptyString, Schema.String>>;
+    readonly status: Schema.Int;
+  }>>;
+  /** A provider-native setup challenge or ping proved the configured ingress. */
+  readonly activationProof: Schema.optionalKey<Schema.Literal<"verified">>;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"deliver">;
+  readonly deliveryKey: Schema.NonEmptyString;
+  readonly status: Schema.Literal<"succeeded">;
+  readonly providerDeliveryKey: Schema.NonEmptyString;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"deliver">;
+  readonly deliveryKey: Schema.NonEmptyString;
+  readonly status: Schema.Literal<"pending">;
+  readonly providerDeliveryKey: Schema.NonEmptyString;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"deliver">;
+  readonly deliveryKey: Schema.NonEmptyString;
+  readonly status: Schema.Literal<"failed">;
+  readonly code: Schema.Literals<readonly ["rejected", "unauthorized", "rate_limited", "unavailable", "window_closed"]>;
+}>, Schema.Struct<{
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly operationKey: Schema.NonEmptyString;
+  readonly kind: Schema.Literal<"read_context">;
+  readonly messages: Schema.$Array<Schema.Struct<{
+    readonly messageKey: Schema.NonEmptyString;
+    /** The agent's own message. */
+    readonly own: Schema.Boolean;
+    readonly senderKey: Schema.NonEmptyString;
+    readonly senderName: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly text: Schema.String;
+    readonly timestamp: Schema.String;
+  }>>;
+}>]>, Schema.Struct<{
+  readonly assetKey: Schema.NonEmptyString;
+  readonly extensions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  readonly file: Schema.Struct<{
+    readonly _tag: Schema.tag<"ToolFile">;
+    readonly contentBase64: Schema.String;
+    readonly contentType: Schema.NullOr<Schema.String>;
+    readonly filename: Schema.NullOr<Schema.String>;
+    readonly sizeBytes: Schema.Natural;
+  }>;
+  readonly kind: Schema.Literal<"read_asset">;
+  readonly operationKey: Schema.NonEmptyString;
+}>]>;
+export type CheckedResult = typeof CheckedResult.Type;
+/** Immutable catalog projection. Live schemas remain the execution validators. */
+export declare const Contract: Schema.Struct<{
+  readonly definitionSettingsSchemaJson: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  readonly deploymentSettingsSchemaJson: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  readonly exposure: Schema.Literals<readonly ["webhook", "host"]>;
+  readonly extensionsSchemaJson: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+  readonly featuresJson: Schema.Struct<{
+    readonly assets: Schema.Boolean;
+    /** Whether replaying one durable delivery key is safe at the provider boundary. */
+    readonly deliveryMode: Schema.Literals<readonly ["idempotent", "at-most-once"]>;
+    readonly deliveryState: Schema.Boolean;
+    readonly directText: Schema.Literal<true>;
+    readonly groups: Schema.Boolean;
+    /** Maximum Unicode code points per physical text message, including server-added prefixes. */
+    readonly maxTextLength: Schema.optionalKey<Schema.Int>;
+    readonly mentions: Schema.Boolean;
+    /** `v2` only: the output operations every destination of this version shows. */
+    readonly operations: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["present_outcome", "create_message", "update_message", "delete_message", "set_reaction", "set_activity", "render_plan"]>>>;
+    /** `v2` only: whether `read_context` returns the conversation's earlier messages. */
+    readonly readContext: Schema.optionalKey<Schema.Boolean>;
+    readonly replies: Schema.Boolean;
+    /** Maximum age of the original responding input before preparation and delivery. */
+    readonly responseWindowMs: Schema.optionalKey<Schema.Int>;
+    readonly threads: Schema.Boolean;
+  }>;
+  readonly operationInputSchemaJson: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  readonly operationOutputSchemaJson: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  readonly protocol: Schema.optionalKey<Schema.Literals<readonly ["v2"]>>;
+  readonly requiredChecks: Schema.Tuple<readonly [Schema.Literal<"access">]>;
+  readonly stateSchemaJson: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>;
+export type Contract = typeof Contract.Type;
+export interface Definition<Settings extends Schema.Top = Schema.Top, Mappings extends Schema.Top = Schema.Top, State extends Schema.Top = Schema.Top, Methods extends readonly Any$1[] = readonly Any$1[]> {
+  /** Absent for the original protocol. Publish a new release to change it. */
+  readonly protocol?: Protocol;
+  readonly definitionSettings: Settings;
+  readonly deploymentSettings: Mappings;
+  readonly state: State;
+  readonly features: Features;
+  readonly exposure: typeof Exposure.Type;
+  readonly requiredChecks: typeof RequiredChecks.Type;
+  /** Explicit subset of the provider's methods; [] means the channel accepts no connection. */
+  readonly authMethods: Methods;
+  /** Each key is provider/name. Values are checked on every command/result/event. */
+  readonly extensions?: Readonly<Record<string, Schema.Top>>;
+}
+/** Project the exact declaration once for SDK discovery and server contract comparison. */
+export declare const projectContract: (definition: Definition, project?: (schema: Schema.Top) => unknown) => Contract;
+export interface Any extends Pipeable.Pipeable {
+  readonly [TypeId]: TypeId;
+  readonly identifier: string;
+  readonly name: string | undefined;
+  readonly description: string | undefined;
+  readonly definition: Definition;
+}
+export interface AgentChannel<out Identifier extends string = string, out D extends Definition = Definition> extends Any {
+  readonly identifier: Identifier;
+  readonly definition: D;
+}
+export type ResolvedAuth<Methods extends readonly Any$1[]> = Methods[number] extends (infer M) ? M extends Any$1 ? {
+  readonly methodId: M["identifier"];
+  readonly value: Value<M>;
+} : never : never;
+export type HandlerContext<D extends Definition> = {
+  readonly definitionSettings: D["definitionSettings"]["Type"];
+  readonly deploymentSettings: D["deploymentSettings"]["Type"];
+} & (D["authMethods"] extends readonly [] ? {} : number extends D["authMethods"]["length"] ? {
+  readonly auth?: ResolvedAuth<D["authMethods"]>;
+} : {
+  readonly auth: ResolvedAuth<D["authMethods"]>;
+});
+/** The command a Channel's handler receives, by its protocol. */
+export type CommandFor<D extends Definition> = D extends {
+  readonly protocol: "v2";
+} ? CommandV2<D["state"]> : Command<D["state"]>;
+/** The result a Channel's handler returns, by its protocol. */
+export type ResultFor<D extends Definition> = D extends {
+  readonly protocol: "v2";
+} ? ResultV2<D["state"]> : Result<D["state"]>;
+export interface RuntimeContract<D extends Definition, R = never> {
+  readonly verify: (request: Request, context: HandlerContext<D>) => Effect.Effect<Verification, HandlerError, R>;
+  readonly checkAccess: (identity: VerifiedIdentity, context: HandlerContext<D>) => Effect.Effect<AccessOutcome, HandlerError, R>;
+  readonly execute: (command: CommandFor<D>, context: HandlerContext<D>) => Effect.Effect<ResultFor<D>, HandlerError, R>;
+}
+/** Erased service representation. Input and output are checked by AgentChannelRuntime. */
+export interface Handler<Id extends string = string> {
+  readonly channelId: Id;
+  readonly context: Context.Context<never>;
+  readonly runtime: {
+    readonly verify: (request: unknown, context: unknown) => Effect.Effect<unknown, unknown, unknown>;
+    readonly checkAccess: (identity: unknown, context: unknown) => Effect.Effect<unknown, unknown, unknown>;
+    readonly execute: (command: unknown, context: unknown) => Effect.Effect<unknown, unknown, unknown>;
+  };
+}
+export declare const handlerKey: (channelId: string) => string;
+/** Validate declarations at registration as well as at builder time. */
+export declare const validateDefinition: (definition: Definition, providerId?: string, methods?: readonly Any$1[]) => void;
+export interface ChannelOptions {
+  readonly name?: string;
+  readonly description?: string;
+}
+/** Create a Channel from its contract. */
+export declare const make: <const Id extends string, const O extends Definition & ChannelOptions>(identifier: Id, options: O) => AgentChannel<Id, O>;
+export declare const isAgentChannel: (value: unknown) => value is Any;
+//#endregion
+export { AgentChannel_d_exports };
+//# sourceMappingURL=AgentChannel.d.ts.map