apps 0.0.1-beta.5 → 0.0.1-beta.7

package/types/apps/src/contracts/protocols/5.d.ts

@@ -0,0 +1,1090 @@
+/**
+ * Host protocol 5: protocol 4 plus account checks.
+ *
+ * Builds declare which account slots have a provider check, and hosts can ask a build to check one
+ * account for one slot without evaluating the app. Every other message is protocol 4's, re-exported
+ * unchanged.
+ *
+ * Once released this protocol is frozen like the earlier ones: `bun run check` compares `protocol5` with
+ * `packages/apps/protocols/5.json`. Define the next protocol instead of editing this file.
+ * See notes/apps-publishing.md.
+ */
+import { Schema } from "effect";
+export * from "./4.js";
+/** Account slots available without binding accounts or evaluating the app factory. */
+export declare const DeclaredRequirements: Schema.Struct<{
+    /** Protocol support of this retained framework build, not an author-declared requirement. */
+    readonly capabilities: Schema.optionalKey<Schema.Struct<{
+        readonly skills: Schema.Literal<true>;
+        readonly toolIndex: Schema.optionalKey<Schema.Literal<true>>;
+        readonly skillSources: Schema.optionalKey<Schema.Literal<true>>;
+        readonly scheduledTools: Schema.optionalKey<Schema.Literal<true>>;
+    }>>;
+    readonly database: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Struct<{
+        readonly fields: Schema.$Record<Schema.String, Schema.Struct<{
+            readonly kind: Schema.Literals<readonly ["string", "number", "boolean", "id", "userId"]>;
+            readonly optional: Schema.optional<Schema.Boolean>;
+            readonly default: Schema.optional<Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean]>>;
+            readonly references: Schema.optional<Schema.String>;
+        }>>;
+        readonly indexes: Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+            readonly fields: Schema.NonEmptyArray<Schema.String>;
+        }>>;
+    }>>>;
+    readonly accounts: Schema.$Record<Schema.NonEmptyString, Schema.Struct<{
+        readonly definition: Schema.Struct<{
+            readonly name: Schema.NonEmptyString;
+            readonly auth: Schema.$Record<Schema.NonEmptyString, Schema.Union<readonly [Schema.Struct<{
+                readonly type: Schema.Literal<"secrets">;
+                readonly label: Schema.String;
+                readonly fields: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+            }>, Schema.Struct<{
+                readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                readonly discover: Schema.String;
+                readonly authorizationUrl: Schema.optionalKey<Schema.Never>;
+                readonly tokenUrl: Schema.optionalKey<Schema.Never>;
+                readonly revocationUrl: Schema.optionalKey<Schema.Never>;
+                readonly scopes: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                readonly grant: Schema.optionalKey<Schema.Literal<"authorization_code">>;
+                readonly authorizationParams: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+                readonly tokenEndpointAuthMethod: Schema.optionalKey<Schema.Literals<readonly ["none", "client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>>;
+                readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                readonly type: Schema.Literal<"oauth2">;
+            }>, Schema.Struct<{
+                readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                readonly authorizationUrl: Schema.String;
+                readonly tokenUrl: Schema.String;
+                readonly revocationUrl: Schema.optionalKey<Schema.String>;
+                readonly scopes: Schema.$Array<Schema.String>;
+                readonly issuer: Schema.optionalKey<Schema.String>;
+                readonly discover: Schema.optionalKey<Schema.Never>;
+                readonly grant: Schema.optionalKey<Schema.Literal<"authorization_code">>;
+                readonly authorizationParams: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+                readonly tokenEndpointAuthMethod: Schema.optionalKey<Schema.Literals<readonly ["none", "client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>>;
+                readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                readonly type: Schema.Literal<"oauth2">;
+            }>, Schema.Struct<{
+                readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                readonly grant: Schema.Literal<"client_credentials">;
+                readonly discover: Schema.String;
+                readonly authorizationUrl: Schema.optionalKey<Schema.Never>;
+                readonly tokenUrl: Schema.optionalKey<Schema.Never>;
+                readonly revocationUrl: Schema.optionalKey<Schema.Never>;
+                readonly scopes: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                readonly tokenEndpointAuthMethod: Schema.Literals<readonly ["client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>;
+                readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                readonly type: Schema.Literal<"oauth2">;
+            }>, Schema.Struct<{
+                readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                readonly grant: Schema.Literal<"client_credentials">;
+                readonly tokenUrl: Schema.String;
+                readonly revocationUrl: Schema.optionalKey<Schema.String>;
+                readonly scopes: Schema.$Array<Schema.String>;
+                readonly tokenEndpointAuthMethod: Schema.Literals<readonly ["client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>;
+                readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                readonly authorizationUrl: Schema.optionalKey<Schema.Never>;
+                readonly discover: Schema.optionalKey<Schema.Never>;
+                readonly type: Schema.Literal<"oauth2">;
+            }>]>>;
+        }>;
+        readonly cardinality: Schema.Literals<readonly ["one", "many"]>;
+        /**
+         * The slot's provider defines an account check. Kept beside the definition, not in it, so
+         * adding or editing a check never changes the provider's identity.
+         */
+        readonly health: Schema.optionalKey<Schema.Literal<true>>;
+    }>>;
+}>;
+/** Parsed declared account requirements. */
+export type DeclaredRequirements = typeof DeclaredRequirements.Type;
+/**
+ * Check one account for one declared slot. The invocation supplies only that slot, as a single
+ * account even when the slot takes many. The app factory is not evaluated.
+ */
+export declare const AccountCheckCommand: Schema.Struct<{
+    readonly operation: Schema.Literal<"account-check">;
+    readonly requirement: Schema.NonEmptyString;
+}>;
+export type AccountCheckCommand = typeof AccountCheckCommand.Type;
+/** Framework-owned dispatch, independent of app-authored HTTP routing. */
+export declare const HostRequest: Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
+    readonly operation: Schema.Literal<"workflows">;
+}>, Schema.Struct<{
+    readonly operation: Schema.Literal<"workflow-validate">;
+    readonly name: Schema.NonEmptyString;
+    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Struct<{
+    readonly operation: Schema.Literal<"workflow-run">;
+    readonly name: Schema.NonEmptyString;
+    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>]>, Schema.Union<readonly [Schema.Struct<{
+    readonly operation: Schema.Literal<"webhooks">;
+}>, Schema.Struct<{
+    readonly name: Schema.NonEmptyString;
+    readonly subscriptionId: Schema.NonEmptyString;
+    readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+    readonly callbackUrl: Schema.String;
+    readonly secret: Schema.String;
+    readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    readonly operation: Schema.Literal<"webhook-validate">;
+}>, Schema.Struct<{
+    readonly state: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    readonly name: Schema.NonEmptyString;
+    readonly subscriptionId: Schema.NonEmptyString;
+    readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+    readonly callbackUrl: Schema.String;
+    readonly secret: Schema.String;
+    readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    readonly operation: Schema.Literal<"webhook-complete">;
+}>, Schema.Struct<{
+    readonly name: Schema.NonEmptyString;
+    readonly subscriptionId: Schema.NonEmptyString;
+    readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+    readonly callbackUrl: Schema.String;
+    readonly secret: Schema.String;
+    readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    readonly operation: Schema.Literal<"webhook-register">;
+}>, Schema.Struct<{
+    readonly state: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    readonly name: Schema.NonEmptyString;
+    readonly subscriptionId: Schema.NonEmptyString;
+    readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+    readonly callbackUrl: Schema.String;
+    readonly secret: Schema.String;
+    readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    readonly operation: Schema.Literal<"webhook-unregister">;
+}>, Schema.Struct<{
+    readonly state: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    readonly request: Schema.Struct<{
+        readonly url: Schema.String;
+        readonly method: Schema.Literals<readonly ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
+        readonly headers: Schema.$Record<Schema.String, Schema.String>;
+        readonly body: Schema.String;
+    }>;
+    readonly name: Schema.NonEmptyString;
+    readonly subscriptionId: Schema.NonEmptyString;
+    readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+    readonly callbackUrl: Schema.String;
+    readonly secret: Schema.String;
+    readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    readonly operation: Schema.Literal<"webhook-handle">;
+}>]>, Schema.Struct<{
+    readonly operation: Schema.Literal<"requirements">;
+}>, Schema.Struct<{
+    readonly operation: Schema.Literal<"inspect">;
+    readonly detail: Schema.optionalKey<Schema.Literal<"summary">>;
+    readonly tools: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+    readonly scheduled: Schema.optionalKey<Schema.Literal<true>>;
+}>, Schema.Struct<{
+    readonly operation: Schema.Literal<"skills">;
+    readonly sources: Schema.optionalKey<Schema.Literal<true>>;
+}>, Schema.Struct<{
+    readonly operation: Schema.Literal<"query">;
+    readonly name: Schema.NonEmptyString;
+    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Struct<{
+    readonly operation: Schema.Literal<"mutate">;
+    readonly name: Schema.NonEmptyString;
+    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Struct<{
+    readonly operation: Schema.Literal<"call">;
+    readonly tool: Schema.NonEmptyString;
+    readonly kind: Schema.optionalKey<Schema.Literals<readonly ["query", "mutation"]>>;
+    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Struct<{
+    readonly operation: Schema.Literal<"account-check">;
+    readonly requirement: Schema.NonEmptyString;
+}>]>;
+/** Parsed portable dispatch request. */
+export type HostRequest = typeof HostRequest.Type;
+/** The JSON body the host sends to a bundle's generated server entry. */
+export declare const HostInvocation: Schema.Struct<{
+    readonly command: Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
+        readonly operation: Schema.Literal<"workflows">;
+    }>, Schema.Struct<{
+        readonly operation: Schema.Literal<"workflow-validate">;
+        readonly name: Schema.NonEmptyString;
+        readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>, Schema.Struct<{
+        readonly operation: Schema.Literal<"workflow-run">;
+        readonly name: Schema.NonEmptyString;
+        readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>]>, Schema.Union<readonly [Schema.Struct<{
+        readonly operation: Schema.Literal<"webhooks">;
+    }>, Schema.Struct<{
+        readonly name: Schema.NonEmptyString;
+        readonly subscriptionId: Schema.NonEmptyString;
+        readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+        readonly callbackUrl: Schema.String;
+        readonly secret: Schema.String;
+        readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        readonly operation: Schema.Literal<"webhook-validate">;
+    }>, Schema.Struct<{
+        readonly state: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        readonly name: Schema.NonEmptyString;
+        readonly subscriptionId: Schema.NonEmptyString;
+        readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+        readonly callbackUrl: Schema.String;
+        readonly secret: Schema.String;
+        readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        readonly operation: Schema.Literal<"webhook-complete">;
+    }>, Schema.Struct<{
+        readonly name: Schema.NonEmptyString;
+        readonly subscriptionId: Schema.NonEmptyString;
+        readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+        readonly callbackUrl: Schema.String;
+        readonly secret: Schema.String;
+        readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        readonly operation: Schema.Literal<"webhook-register">;
+    }>, Schema.Struct<{
+        readonly state: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        readonly name: Schema.NonEmptyString;
+        readonly subscriptionId: Schema.NonEmptyString;
+        readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+        readonly callbackUrl: Schema.String;
+        readonly secret: Schema.String;
+        readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        readonly operation: Schema.Literal<"webhook-unregister">;
+    }>, Schema.Struct<{
+        readonly state: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        readonly request: Schema.Struct<{
+            readonly url: Schema.String;
+            readonly method: Schema.Literals<readonly ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
+            readonly headers: Schema.$Record<Schema.String, Schema.String>;
+            readonly body: Schema.String;
+        }>;
+        readonly name: Schema.NonEmptyString;
+        readonly subscriptionId: Schema.NonEmptyString;
+        readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+        readonly callbackUrl: Schema.String;
+        readonly secret: Schema.String;
+        readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        readonly operation: Schema.Literal<"webhook-handle">;
+    }>]>, Schema.Struct<{
+        readonly operation: Schema.Literal<"requirements">;
+    }>, Schema.Struct<{
+        readonly operation: Schema.Literal<"inspect">;
+        readonly detail: Schema.optionalKey<Schema.Literal<"summary">>;
+        readonly tools: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+        readonly scheduled: Schema.optionalKey<Schema.Literal<true>>;
+    }>, Schema.Struct<{
+        readonly operation: Schema.Literal<"skills">;
+        readonly sources: Schema.optionalKey<Schema.Literal<true>>;
+    }>, Schema.Struct<{
+        readonly operation: Schema.Literal<"query">;
+        readonly name: Schema.NonEmptyString;
+        readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>, Schema.Struct<{
+        readonly operation: Schema.Literal<"mutate">;
+        readonly name: Schema.NonEmptyString;
+        readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>, Schema.Struct<{
+        readonly operation: Schema.Literal<"call">;
+        readonly tool: Schema.NonEmptyString;
+        readonly kind: Schema.optionalKey<Schema.Literals<readonly ["query", "mutation"]>>;
+        readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>, Schema.Struct<{
+        readonly operation: Schema.Literal<"account-check">;
+        readonly requirement: Schema.NonEmptyString;
+    }>]>;
+    readonly accounts: Schema.$Record<Schema.NonEmptyString, Schema.Union<readonly [Schema.Struct<{
+        readonly id: Schema.brand<Schema.String, "acc">;
+        readonly provider: Schema.Struct<{
+            readonly name: Schema.NonEmptyString;
+            readonly auth: Schema.$Record<Schema.NonEmptyString, Schema.Union<readonly [Schema.Struct<{
+                readonly type: Schema.Literal<"secrets">;
+                readonly label: Schema.String;
+                readonly fields: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+            }>, Schema.Struct<{
+                readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                readonly discover: Schema.String;
+                readonly authorizationUrl: Schema.optionalKey<Schema.Never>;
+                readonly tokenUrl: Schema.optionalKey<Schema.Never>;
+                readonly revocationUrl: Schema.optionalKey<Schema.Never>;
+                readonly scopes: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                readonly grant: Schema.optionalKey<Schema.Literal<"authorization_code">>;
+                readonly authorizationParams: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+                readonly tokenEndpointAuthMethod: Schema.optionalKey<Schema.Literals<readonly ["none", "client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>>;
+                readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                readonly type: Schema.Literal<"oauth2">;
+            }>, Schema.Struct<{
+                readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                readonly authorizationUrl: Schema.String;
+                readonly tokenUrl: Schema.String;
+                readonly revocationUrl: Schema.optionalKey<Schema.String>;
+                readonly scopes: Schema.$Array<Schema.String>;
+                readonly issuer: Schema.optionalKey<Schema.String>;
+                readonly discover: Schema.optionalKey<Schema.Never>;
+                readonly grant: Schema.optionalKey<Schema.Literal<"authorization_code">>;
+                readonly authorizationParams: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+                readonly tokenEndpointAuthMethod: Schema.optionalKey<Schema.Literals<readonly ["none", "client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>>;
+                readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                readonly type: Schema.Literal<"oauth2">;
+            }>, Schema.Struct<{
+                readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                readonly grant: Schema.Literal<"client_credentials">;
+                readonly discover: Schema.String;
+                readonly authorizationUrl: Schema.optionalKey<Schema.Never>;
+                readonly tokenUrl: Schema.optionalKey<Schema.Never>;
+                readonly revocationUrl: Schema.optionalKey<Schema.Never>;
+                readonly scopes: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                readonly tokenEndpointAuthMethod: Schema.Literals<readonly ["client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>;
+                readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                readonly type: Schema.Literal<"oauth2">;
+            }>, Schema.Struct<{
+                readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                readonly grant: Schema.Literal<"client_credentials">;
+                readonly tokenUrl: Schema.String;
+                readonly revocationUrl: Schema.optionalKey<Schema.String>;
+                readonly scopes: Schema.$Array<Schema.String>;
+                readonly tokenEndpointAuthMethod: Schema.Literals<readonly ["client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>;
+                readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                readonly authorizationUrl: Schema.optionalKey<Schema.Never>;
+                readonly discover: Schema.optionalKey<Schema.Never>;
+                readonly type: Schema.Literal<"oauth2">;
+            }>]>>;
+        }>;
+        readonly method: Schema.NonEmptyString;
+        readonly generation: Schema.optionalKey<Schema.Int>;
+        readonly fields: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>, Schema.$Array<Schema.Struct<{
+        readonly id: Schema.brand<Schema.String, "acc">;
+        readonly provider: Schema.Struct<{
+            readonly name: Schema.NonEmptyString;
+            readonly auth: Schema.$Record<Schema.NonEmptyString, Schema.Union<readonly [Schema.Struct<{
+                readonly type: Schema.Literal<"secrets">;
+                readonly label: Schema.String;
+                readonly fields: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+            }>, Schema.Struct<{
+                readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                readonly discover: Schema.String;
+                readonly authorizationUrl: Schema.optionalKey<Schema.Never>;
+                readonly tokenUrl: Schema.optionalKey<Schema.Never>;
+                readonly revocationUrl: Schema.optionalKey<Schema.Never>;
+                readonly scopes: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                readonly grant: Schema.optionalKey<Schema.Literal<"authorization_code">>;
+                readonly authorizationParams: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+                readonly tokenEndpointAuthMethod: Schema.optionalKey<Schema.Literals<readonly ["none", "client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>>;
+                readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                readonly type: Schema.Literal<"oauth2">;
+            }>, Schema.Struct<{
+                readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                readonly authorizationUrl: Schema.String;
+                readonly tokenUrl: Schema.String;
+                readonly revocationUrl: Schema.optionalKey<Schema.String>;
+                readonly scopes: Schema.$Array<Schema.String>;
+                readonly issuer: Schema.optionalKey<Schema.String>;
+                readonly discover: Schema.optionalKey<Schema.Never>;
+                readonly grant: Schema.optionalKey<Schema.Literal<"authorization_code">>;
+                readonly authorizationParams: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+                readonly tokenEndpointAuthMethod: Schema.optionalKey<Schema.Literals<readonly ["none", "client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>>;
+                readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                readonly type: Schema.Literal<"oauth2">;
+            }>, Schema.Struct<{
+                readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                readonly grant: Schema.Literal<"client_credentials">;
+                readonly discover: Schema.String;
+                readonly authorizationUrl: Schema.optionalKey<Schema.Never>;
+                readonly tokenUrl: Schema.optionalKey<Schema.Never>;
+                readonly revocationUrl: Schema.optionalKey<Schema.Never>;
+                readonly scopes: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                readonly tokenEndpointAuthMethod: Schema.Literals<readonly ["client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>;
+                readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                readonly type: Schema.Literal<"oauth2">;
+            }>, Schema.Struct<{
+                readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                readonly grant: Schema.Literal<"client_credentials">;
+                readonly tokenUrl: Schema.String;
+                readonly revocationUrl: Schema.optionalKey<Schema.String>;
+                readonly scopes: Schema.$Array<Schema.String>;
+                readonly tokenEndpointAuthMethod: Schema.Literals<readonly ["client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>;
+                readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                readonly authorizationUrl: Schema.optionalKey<Schema.Never>;
+                readonly discover: Schema.optionalKey<Schema.Never>;
+                readonly type: Schema.Literal<"oauth2">;
+            }>]>>;
+        }>;
+        readonly method: Schema.NonEmptyString;
+        readonly generation: Schema.optionalKey<Schema.Int>;
+        readonly fields: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>>]>>;
+    readonly approval: Schema.optionalKey<Schema.Struct<{
+        readonly tool: Schema.NonEmptyString;
+        readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>>;
+    readonly replay: Schema.optionalKey<Schema.Struct<{
+        readonly key: Schema.NonEmptyString;
+        readonly fingerprint: Schema.NonEmptyString;
+    }>>;
+    readonly deadline: Schema.optionalKey<Schema.Finite>;
+    readonly workflowRun: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "wfr">>;
+}>;
+export type HostInvocation = typeof HostInvocation.Type;
+/** Every message of protocol 5, in the order its snapshot records them. */
+export declare const protocol5: {
+    readonly version: 5;
+    readonly schemas: {
+        readonly invocation: Schema.Struct<{
+            readonly command: Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
+                readonly operation: Schema.Literal<"workflows">;
+            }>, Schema.Struct<{
+                readonly operation: Schema.Literal<"workflow-validate">;
+                readonly name: Schema.NonEmptyString;
+                readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            }>, Schema.Struct<{
+                readonly operation: Schema.Literal<"workflow-run">;
+                readonly name: Schema.NonEmptyString;
+                readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            }>]>, Schema.Union<readonly [Schema.Struct<{
+                readonly operation: Schema.Literal<"webhooks">;
+            }>, Schema.Struct<{
+                readonly name: Schema.NonEmptyString;
+                readonly subscriptionId: Schema.NonEmptyString;
+                readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+                readonly callbackUrl: Schema.String;
+                readonly secret: Schema.String;
+                readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+                readonly operation: Schema.Literal<"webhook-validate">;
+            }>, Schema.Struct<{
+                readonly state: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+                readonly name: Schema.NonEmptyString;
+                readonly subscriptionId: Schema.NonEmptyString;
+                readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+                readonly callbackUrl: Schema.String;
+                readonly secret: Schema.String;
+                readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+                readonly operation: Schema.Literal<"webhook-complete">;
+            }>, Schema.Struct<{
+                readonly name: Schema.NonEmptyString;
+                readonly subscriptionId: Schema.NonEmptyString;
+                readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+                readonly callbackUrl: Schema.String;
+                readonly secret: Schema.String;
+                readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+                readonly operation: Schema.Literal<"webhook-register">;
+            }>, Schema.Struct<{
+                readonly state: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+                readonly name: Schema.NonEmptyString;
+                readonly subscriptionId: Schema.NonEmptyString;
+                readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+                readonly callbackUrl: Schema.String;
+                readonly secret: Schema.String;
+                readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+                readonly operation: Schema.Literal<"webhook-unregister">;
+            }>, Schema.Struct<{
+                readonly state: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+                readonly request: Schema.Struct<{
+                    readonly url: Schema.String;
+                    readonly method: Schema.Literals<readonly ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
+                    readonly headers: Schema.$Record<Schema.String, Schema.String>;
+                    readonly body: Schema.String;
+                }>;
+                readonly name: Schema.NonEmptyString;
+                readonly subscriptionId: Schema.NonEmptyString;
+                readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+                readonly callbackUrl: Schema.String;
+                readonly secret: Schema.String;
+                readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+                readonly operation: Schema.Literal<"webhook-handle">;
+            }>]>, Schema.Struct<{
+                readonly operation: Schema.Literal<"requirements">;
+            }>, Schema.Struct<{
+                readonly operation: Schema.Literal<"inspect">;
+                readonly detail: Schema.optionalKey<Schema.Literal<"summary">>;
+                readonly tools: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+                readonly scheduled: Schema.optionalKey<Schema.Literal<true>>;
+            }>, Schema.Struct<{
+                readonly operation: Schema.Literal<"skills">;
+                readonly sources: Schema.optionalKey<Schema.Literal<true>>;
+            }>, Schema.Struct<{
+                readonly operation: Schema.Literal<"query">;
+                readonly name: Schema.NonEmptyString;
+                readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            }>, Schema.Struct<{
+                readonly operation: Schema.Literal<"mutate">;
+                readonly name: Schema.NonEmptyString;
+                readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            }>, Schema.Struct<{
+                readonly operation: Schema.Literal<"call">;
+                readonly tool: Schema.NonEmptyString;
+                readonly kind: Schema.optionalKey<Schema.Literals<readonly ["query", "mutation"]>>;
+                readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            }>, Schema.Struct<{
+                readonly operation: Schema.Literal<"account-check">;
+                readonly requirement: Schema.NonEmptyString;
+            }>]>;
+            readonly accounts: Schema.$Record<Schema.NonEmptyString, Schema.Union<readonly [Schema.Struct<{
+                readonly id: Schema.brand<Schema.String, "acc">;
+                readonly provider: Schema.Struct<{
+                    readonly name: Schema.NonEmptyString;
+                    readonly auth: Schema.$Record<Schema.NonEmptyString, Schema.Union<readonly [Schema.Struct<{
+                        readonly type: Schema.Literal<"secrets">;
+                        readonly label: Schema.String;
+                        readonly fields: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                    }>, Schema.Struct<{
+                        readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                        readonly discover: Schema.String;
+                        readonly authorizationUrl: Schema.optionalKey<Schema.Never>;
+                        readonly tokenUrl: Schema.optionalKey<Schema.Never>;
+                        readonly revocationUrl: Schema.optionalKey<Schema.Never>;
+                        readonly scopes: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                        readonly grant: Schema.optionalKey<Schema.Literal<"authorization_code">>;
+                        readonly authorizationParams: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+                        readonly tokenEndpointAuthMethod: Schema.optionalKey<Schema.Literals<readonly ["none", "client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>>;
+                        readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                        readonly type: Schema.Literal<"oauth2">;
+                    }>, Schema.Struct<{
+                        readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                        readonly authorizationUrl: Schema.String;
+                        readonly tokenUrl: Schema.String;
+                        readonly revocationUrl: Schema.optionalKey<Schema.String>;
+                        readonly scopes: Schema.$Array<Schema.String>;
+                        readonly issuer: Schema.optionalKey<Schema.String>;
+                        readonly discover: Schema.optionalKey<Schema.Never>;
+                        readonly grant: Schema.optionalKey<Schema.Literal<"authorization_code">>;
+                        readonly authorizationParams: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+                        readonly tokenEndpointAuthMethod: Schema.optionalKey<Schema.Literals<readonly ["none", "client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>>;
+                        readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                        readonly type: Schema.Literal<"oauth2">;
+                    }>, Schema.Struct<{
+                        readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                        readonly grant: Schema.Literal<"client_credentials">;
+                        readonly discover: Schema.String;
+                        readonly authorizationUrl: Schema.optionalKey<Schema.Never>;
+                        readonly tokenUrl: Schema.optionalKey<Schema.Never>;
+                        readonly revocationUrl: Schema.optionalKey<Schema.Never>;
+                        readonly scopes: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                        readonly tokenEndpointAuthMethod: Schema.Literals<readonly ["client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>;
+                        readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                        readonly type: Schema.Literal<"oauth2">;
+                    }>, Schema.Struct<{
+                        readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                        readonly grant: Schema.Literal<"client_credentials">;
+                        readonly tokenUrl: Schema.String;
+                        readonly revocationUrl: Schema.optionalKey<Schema.String>;
+                        readonly scopes: Schema.$Array<Schema.String>;
+                        readonly tokenEndpointAuthMethod: Schema.Literals<readonly ["client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>;
+                        readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                        readonly authorizationUrl: Schema.optionalKey<Schema.Never>;
+                        readonly discover: Schema.optionalKey<Schema.Never>;
+                        readonly type: Schema.Literal<"oauth2">;
+                    }>]>>;
+                }>;
+                readonly method: Schema.NonEmptyString;
+                readonly generation: Schema.optionalKey<Schema.Int>;
+                readonly fields: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+            }>, Schema.$Array<Schema.Struct<{
+                readonly id: Schema.brand<Schema.String, "acc">;
+                readonly provider: Schema.Struct<{
+                    readonly name: Schema.NonEmptyString;
+                    readonly auth: Schema.$Record<Schema.NonEmptyString, Schema.Union<readonly [Schema.Struct<{
+                        readonly type: Schema.Literal<"secrets">;
+                        readonly label: Schema.String;
+                        readonly fields: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                    }>, Schema.Struct<{
+                        readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                        readonly discover: Schema.String;
+                        readonly authorizationUrl: Schema.optionalKey<Schema.Never>;
+                        readonly tokenUrl: Schema.optionalKey<Schema.Never>;
+                        readonly revocationUrl: Schema.optionalKey<Schema.Never>;
+                        readonly scopes: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                        readonly grant: Schema.optionalKey<Schema.Literal<"authorization_code">>;
+                        readonly authorizationParams: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+                        readonly tokenEndpointAuthMethod: Schema.optionalKey<Schema.Literals<readonly ["none", "client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>>;
+                        readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                        readonly type: Schema.Literal<"oauth2">;
+                    }>, Schema.Struct<{
+                        readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                        readonly authorizationUrl: Schema.String;
+                        readonly tokenUrl: Schema.String;
+                        readonly revocationUrl: Schema.optionalKey<Schema.String>;
+                        readonly scopes: Schema.$Array<Schema.String>;
+                        readonly issuer: Schema.optionalKey<Schema.String>;
+                        readonly discover: Schema.optionalKey<Schema.Never>;
+                        readonly grant: Schema.optionalKey<Schema.Literal<"authorization_code">>;
+                        readonly authorizationParams: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+                        readonly tokenEndpointAuthMethod: Schema.optionalKey<Schema.Literals<readonly ["none", "client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>>;
+                        readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                        readonly type: Schema.Literal<"oauth2">;
+                    }>, Schema.Struct<{
+                        readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                        readonly grant: Schema.Literal<"client_credentials">;
+                        readonly discover: Schema.String;
+                        readonly authorizationUrl: Schema.optionalKey<Schema.Never>;
+                        readonly tokenUrl: Schema.optionalKey<Schema.Never>;
+                        readonly revocationUrl: Schema.optionalKey<Schema.Never>;
+                        readonly scopes: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                        readonly tokenEndpointAuthMethod: Schema.Literals<readonly ["client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>;
+                        readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                        readonly type: Schema.Literal<"oauth2">;
+                    }>, Schema.Struct<{
+                        readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                        readonly grant: Schema.Literal<"client_credentials">;
+                        readonly tokenUrl: Schema.String;
+                        readonly revocationUrl: Schema.optionalKey<Schema.String>;
+                        readonly scopes: Schema.$Array<Schema.String>;
+                        readonly tokenEndpointAuthMethod: Schema.Literals<readonly ["client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>;
+                        readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                        readonly authorizationUrl: Schema.optionalKey<Schema.Never>;
+                        readonly discover: Schema.optionalKey<Schema.Never>;
+                        readonly type: Schema.Literal<"oauth2">;
+                    }>]>>;
+                }>;
+                readonly method: Schema.NonEmptyString;
+                readonly generation: Schema.optionalKey<Schema.Int>;
+                readonly fields: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+            }>>]>>;
+            readonly approval: Schema.optionalKey<Schema.Struct<{
+                readonly tool: Schema.NonEmptyString;
+                readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            }>>;
+            readonly replay: Schema.optionalKey<Schema.Struct<{
+                readonly key: Schema.NonEmptyString;
+                readonly fingerprint: Schema.NonEmptyString;
+            }>>;
+            readonly deadline: Schema.optionalKey<Schema.Finite>;
+            readonly workflowRun: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "wfr">>;
+        }>;
+        readonly request: Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
+            readonly operation: Schema.Literal<"workflows">;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"workflow-validate">;
+            readonly name: Schema.NonEmptyString;
+            readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"workflow-run">;
+            readonly name: Schema.NonEmptyString;
+            readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        }>]>, Schema.Union<readonly [Schema.Struct<{
+            readonly operation: Schema.Literal<"webhooks">;
+        }>, Schema.Struct<{
+            readonly name: Schema.NonEmptyString;
+            readonly subscriptionId: Schema.NonEmptyString;
+            readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+            readonly callbackUrl: Schema.String;
+            readonly secret: Schema.String;
+            readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            readonly operation: Schema.Literal<"webhook-validate">;
+        }>, Schema.Struct<{
+            readonly state: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            readonly name: Schema.NonEmptyString;
+            readonly subscriptionId: Schema.NonEmptyString;
+            readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+            readonly callbackUrl: Schema.String;
+            readonly secret: Schema.String;
+            readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            readonly operation: Schema.Literal<"webhook-complete">;
+        }>, Schema.Struct<{
+            readonly name: Schema.NonEmptyString;
+            readonly subscriptionId: Schema.NonEmptyString;
+            readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+            readonly callbackUrl: Schema.String;
+            readonly secret: Schema.String;
+            readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            readonly operation: Schema.Literal<"webhook-register">;
+        }>, Schema.Struct<{
+            readonly state: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            readonly name: Schema.NonEmptyString;
+            readonly subscriptionId: Schema.NonEmptyString;
+            readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+            readonly callbackUrl: Schema.String;
+            readonly secret: Schema.String;
+            readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            readonly operation: Schema.Literal<"webhook-unregister">;
+        }>, Schema.Struct<{
+            readonly state: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            readonly request: Schema.Struct<{
+                readonly url: Schema.String;
+                readonly method: Schema.Literals<readonly ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
+                readonly headers: Schema.$Record<Schema.String, Schema.String>;
+                readonly body: Schema.String;
+            }>;
+            readonly name: Schema.NonEmptyString;
+            readonly subscriptionId: Schema.NonEmptyString;
+            readonly sourceAccount: Schema.brand<Schema.String, "acc">;
+            readonly callbackUrl: Schema.String;
+            readonly secret: Schema.String;
+            readonly config: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            readonly operation: Schema.Literal<"webhook-handle">;
+        }>]>, Schema.Struct<{
+            readonly operation: Schema.Literal<"requirements">;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"inspect">;
+            readonly detail: Schema.optionalKey<Schema.Literal<"summary">>;
+            readonly tools: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+            readonly scheduled: Schema.optionalKey<Schema.Literal<true>>;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"skills">;
+            readonly sources: Schema.optionalKey<Schema.Literal<true>>;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"query">;
+            readonly name: Schema.NonEmptyString;
+            readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"mutate">;
+            readonly name: Schema.NonEmptyString;
+            readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"call">;
+            readonly tool: Schema.NonEmptyString;
+            readonly kind: Schema.optionalKey<Schema.Literals<readonly ["query", "mutation"]>>;
+            readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"account-check">;
+            readonly requirement: Schema.NonEmptyString;
+        }>]>;
+        readonly requirements: Schema.Struct<{
+            /** Protocol support of this retained framework build, not an author-declared requirement. */
+            readonly capabilities: Schema.optionalKey<Schema.Struct<{
+                readonly skills: Schema.Literal<true>;
+                readonly toolIndex: Schema.optionalKey<Schema.Literal<true>>;
+                readonly skillSources: Schema.optionalKey<Schema.Literal<true>>;
+                readonly scheduledTools: Schema.optionalKey<Schema.Literal<true>>;
+            }>>;
+            readonly database: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Struct<{
+                readonly fields: Schema.$Record<Schema.String, Schema.Struct<{
+                    readonly kind: Schema.Literals<readonly ["string", "number", "boolean", "id", "userId"]>;
+                    readonly optional: Schema.optional<Schema.Boolean>;
+                    readonly default: Schema.optional<Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean]>>;
+                    readonly references: Schema.optional<Schema.String>;
+                }>>;
+                readonly indexes: Schema.$Array<Schema.Struct<{
+                    readonly name: Schema.String;
+                    readonly fields: Schema.NonEmptyArray<Schema.String>;
+                }>>;
+            }>>>;
+            readonly accounts: Schema.$Record<Schema.NonEmptyString, Schema.Struct<{
+                readonly definition: Schema.Struct<{
+                    readonly name: Schema.NonEmptyString;
+                    readonly auth: Schema.$Record<Schema.NonEmptyString, Schema.Union<readonly [Schema.Struct<{
+                        readonly type: Schema.Literal<"secrets">;
+                        readonly label: Schema.String;
+                        readonly fields: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                    }>, Schema.Struct<{
+                        readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                        readonly discover: Schema.String;
+                        readonly authorizationUrl: Schema.optionalKey<Schema.Never>;
+                        readonly tokenUrl: Schema.optionalKey<Schema.Never>;
+                        readonly revocationUrl: Schema.optionalKey<Schema.Never>;
+                        readonly scopes: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                        readonly grant: Schema.optionalKey<Schema.Literal<"authorization_code">>;
+                        readonly authorizationParams: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+                        readonly tokenEndpointAuthMethod: Schema.optionalKey<Schema.Literals<readonly ["none", "client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>>;
+                        readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                        readonly type: Schema.Literal<"oauth2">;
+                    }>, Schema.Struct<{
+                        readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                        readonly authorizationUrl: Schema.String;
+                        readonly tokenUrl: Schema.String;
+                        readonly revocationUrl: Schema.optionalKey<Schema.String>;
+                        readonly scopes: Schema.$Array<Schema.String>;
+                        readonly issuer: Schema.optionalKey<Schema.String>;
+                        readonly discover: Schema.optionalKey<Schema.Never>;
+                        readonly grant: Schema.optionalKey<Schema.Literal<"authorization_code">>;
+                        readonly authorizationParams: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+                        readonly tokenEndpointAuthMethod: Schema.optionalKey<Schema.Literals<readonly ["none", "client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>>;
+                        readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                        readonly type: Schema.Literal<"oauth2">;
+                    }>, Schema.Struct<{
+                        readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                        readonly grant: Schema.Literal<"client_credentials">;
+                        readonly discover: Schema.String;
+                        readonly authorizationUrl: Schema.optionalKey<Schema.Never>;
+                        readonly tokenUrl: Schema.optionalKey<Schema.Never>;
+                        readonly revocationUrl: Schema.optionalKey<Schema.Never>;
+                        readonly scopes: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                        readonly tokenEndpointAuthMethod: Schema.Literals<readonly ["client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>;
+                        readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                        readonly type: Schema.Literal<"oauth2">;
+                    }>, Schema.Struct<{
+                        readonly response: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                        readonly grant: Schema.Literal<"client_credentials">;
+                        readonly tokenUrl: Schema.String;
+                        readonly revocationUrl: Schema.optionalKey<Schema.String>;
+                        readonly scopes: Schema.$Array<Schema.String>;
+                        readonly tokenEndpointAuthMethod: Schema.Literals<readonly ["client_secret_post", "client_secret_basic", "client_secret_basic_raw"]>;
+                        readonly resource: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+                        readonly authorizationUrl: Schema.optionalKey<Schema.Never>;
+                        readonly discover: Schema.optionalKey<Schema.Never>;
+                        readonly type: Schema.Literal<"oauth2">;
+                    }>]>>;
+                }>;
+                readonly cardinality: Schema.Literals<readonly ["one", "many"]>;
+                /**
+                 * The slot's provider defines an account check. Kept beside the definition, not in it, so
+                 * adding or editing a check never changes the provider's identity.
+                 */
+                readonly health: Schema.optionalKey<Schema.Literal<true>>;
+            }>>;
+        }>;
+        readonly accountCheck: Schema.Struct<{
+            readonly accountInfo: Schema.optionalKey<Schema.Struct<{
+                readonly externalId: Schema.optionalKey<Schema.String>;
+                readonly displayName: Schema.optionalKey<Schema.String>;
+                readonly username: Schema.optionalKey<Schema.String>;
+                readonly email: Schema.optionalKey<Schema.String>;
+                readonly avatarUrl: Schema.optionalKey<Schema.String>;
+                readonly profileUrl: Schema.optionalKey<Schema.String>;
+            }>>;
+        }>;
+        readonly response: Schema.Union<readonly [Schema.Struct<{
+            readonly ok: Schema.Literal<true>;
+            readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            readonly toolError: Schema.optionalKey<Schema.Literal<true>>;
+        }>, Schema.Struct<{
+            readonly ok: Schema.Literal<false>;
+            readonly error: Schema.Union<readonly [typeof import("../api-response-error.js").OpenapiResponseError, typeof import("../provider-error.js").ProviderError, typeof import("../mcp.js").McpError, typeof import("../skills.js").SkillLoadFailed, typeof import("../workflows.js").WorkflowFailure, typeof import("./1.js").HostRequestInvalid, typeof import("./1.js").HostAccountsInvalid, typeof import("./3.js").HostDeclarationInvalid, typeof import("./3.js").HostEvaluationFailed, typeof import("./1.js").HostOperationNotFound, typeof import("./3.js").HostOperationFailed, typeof import("../../../../app-data/src/index.js").DatabaseLimitExceeded, typeof import("../../../../app-data/src/index.js").DatabaseFieldReserved, typeof import("./1.js").HostToolNotFound, typeof import("./1.js").HostInputInvalid, typeof import("./1.js").HostOutputInvalid, typeof import("./1.js").HostToolBlocked, typeof import("./1.js").HostToolApprovalRequired, typeof import("./1.js").HostToolPolicyFailed, typeof import("../elicitation.js").ElicitationFailed, typeof import("./4.js").HostKindMismatch]>;
+        }>]>;
+        readonly catalog: Schema.Struct<{
+            readonly tools: Schema.$Array<Schema.Struct<{
+                readonly schedules: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+                    readonly name: Schema.NonEmptyString;
+                    readonly timing: Schema.Union<readonly [Schema.Struct<{
+                        readonly kind: Schema.Literal<"interval">;
+                        readonly milliseconds: Schema.Int;
+                    }>, Schema.Struct<{
+                        readonly kind: Schema.Literal<"cron">;
+                        readonly calendar: Schema.Struct<{
+                            readonly expression: Schema.NonEmptyString;
+                            readonly timezone: Schema.NonEmptyString;
+                        }>;
+                    }>]>;
+                    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+                }>>>;
+                readonly name: Schema.NonEmptyString;
+                readonly router: Schema.optionalKey<Schema.NonEmptyString>;
+                readonly tags: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+                readonly description: Schema.String;
+                readonly inputSchema: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+                readonly readOnly: Schema.optionalKey<Schema.Boolean>;
+                readonly title: Schema.optionalKey<Schema.String>;
+                readonly outputSchema: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+                readonly annotations: Schema.optionalKey<Schema.Struct<{
+                    readonly title: Schema.optionalKey<Schema.String>;
+                    readonly readOnlyHint: Schema.optionalKey<Schema.Boolean>;
+                    readonly destructiveHint: Schema.optionalKey<Schema.Boolean>;
+                    readonly idempotentHint: Schema.optionalKey<Schema.Boolean>;
+                    readonly openWorldHint: Schema.optionalKey<Schema.Boolean>;
+                }>>;
+                readonly _meta: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+            }>>;
+            readonly routers: Schema.$Array<Schema.Struct<{
+                readonly path: Schema.String;
+                readonly title: Schema.optionalKey<Schema.String>;
+                readonly description: Schema.optionalKey<Schema.String>;
+                readonly icons: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+                    readonly src: Schema.NonEmptyString;
+                    readonly mimeType: Schema.optionalKey<Schema.String>;
+                    readonly sizes: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                    readonly theme: Schema.optionalKey<Schema.Literals<readonly ["light", "dark"]>>;
+                }>>>;
+                readonly tags: Schema.optionalKey<Schema.$Record<Schema.NonEmptyString, Schema.String>>;
+                readonly skill: Schema.optionalKey<Schema.NonEmptyString>;
+                readonly error: Schema.optionalKey<Schema.Union<readonly [typeof import("../provider-error.js").ProviderError, typeof import("../mcp.js").McpError, typeof import("../skills.js").SkillLoadFailed, typeof import("./3.js").HostDeclarationInvalid, typeof import("./3.js").HostEvaluationFailed]>>;
+            }>>;
+        }>;
+        readonly catalogSummary: Schema.Struct<{
+            readonly tools: Schema.$Array<Schema.Struct<{
+                readonly schedules: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+                    readonly name: Schema.NonEmptyString;
+                    readonly timing: Schema.Union<readonly [Schema.Struct<{
+                        readonly kind: Schema.Literal<"interval">;
+                        readonly milliseconds: Schema.Int;
+                    }>, Schema.Struct<{
+                        readonly kind: Schema.Literal<"cron">;
+                        readonly calendar: Schema.Struct<{
+                            readonly expression: Schema.NonEmptyString;
+                            readonly timezone: Schema.NonEmptyString;
+                        }>;
+                    }>]>;
+                    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+                }>>>;
+                readonly name: Schema.NonEmptyString;
+                readonly router: Schema.optionalKey<Schema.NonEmptyString>;
+                readonly tags: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+                readonly description: Schema.String;
+                readonly readOnly: Schema.optionalKey<Schema.Boolean>;
+                readonly title: Schema.optionalKey<Schema.String>;
+                readonly annotations: Schema.optionalKey<Schema.Struct<{
+                    readonly title: Schema.optionalKey<Schema.String>;
+                    readonly readOnlyHint: Schema.optionalKey<Schema.Boolean>;
+                    readonly destructiveHint: Schema.optionalKey<Schema.Boolean>;
+                    readonly idempotentHint: Schema.optionalKey<Schema.Boolean>;
+                    readonly openWorldHint: Schema.optionalKey<Schema.Boolean>;
+                }>>;
+            }>>;
+            readonly routers: Schema.$Array<Schema.Struct<{
+                readonly path: Schema.String;
+                readonly title: Schema.optionalKey<Schema.String>;
+                readonly description: Schema.optionalKey<Schema.String>;
+                readonly icons: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+                    readonly src: Schema.NonEmptyString;
+                    readonly mimeType: Schema.optionalKey<Schema.String>;
+                    readonly sizes: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                    readonly theme: Schema.optionalKey<Schema.Literals<readonly ["light", "dark"]>>;
+                }>>>;
+                readonly tags: Schema.optionalKey<Schema.$Record<Schema.NonEmptyString, Schema.String>>;
+                readonly skill: Schema.optionalKey<Schema.NonEmptyString>;
+                readonly error: Schema.optionalKey<Schema.Union<readonly [typeof import("../provider-error.js").ProviderError, typeof import("../mcp.js").McpError, typeof import("../skills.js").SkillLoadFailed, typeof import("./3.js").HostDeclarationInvalid, typeof import("./3.js").HostEvaluationFailed]>>;
+            }>>;
+        }>;
+        readonly skills: Schema.Union<readonly [Schema.Struct<{
+            readonly skills: Schema.$Array<Schema.Struct<{
+                readonly files: Schema.$Array<Schema.Struct<{
+                    readonly path: Schema.NonEmptyString;
+                    readonly content: Schema.String;
+                }>>;
+                readonly name: Schema.NonEmptyString;
+                readonly description: Schema.String;
+                readonly license: Schema.optionalKey<Schema.String>;
+                readonly compatibility: Schema.optionalKey<Schema.String>;
+                readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+                readonly "allowed-tools": Schema.optionalKey<Schema.String>;
+            }>>;
+            readonly dynamic: Schema.Boolean;
+            readonly cached: Schema.optionalKey<Schema.Boolean>;
+        }>, Schema.$Array<Schema.Struct<{
+            readonly files: Schema.$Array<Schema.Struct<{
+                readonly path: Schema.NonEmptyString;
+                readonly content: Schema.String;
+            }>>;
+            readonly name: Schema.NonEmptyString;
+            readonly description: Schema.String;
+            readonly license: Schema.optionalKey<Schema.String>;
+            readonly compatibility: Schema.optionalKey<Schema.String>;
+            readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+            readonly "allowed-tools": Schema.optionalKey<Schema.String>;
+        }>>]>;
+        readonly elicitationRequest: Schema.Struct<{
+            readonly mode: Schema.Literal<"form">;
+            readonly requestedSchema: Schema.toEncoded<Schema.Struct<{
+                readonly $schema: Schema.decodeTo<Schema.optional<Schema.String>, Schema.optionalKey<Schema.String>, never, never>;
+                readonly type: Schema.tag<"object">;
+                readonly properties: Schema.$Record<Schema.String, Schema.Union<readonly [Schema.Union<readonly [typeof import("effect/unstable/ai/McpSchema").LegacyTitledEnum, Schema.Union<readonly [typeof import("effect/unstable/ai/McpSchema").UntitledSingleSelectEnum, typeof import("effect/unstable/ai/McpSchema").TitledSingleSelectEnum]>, Schema.Union<readonly [typeof import("effect/unstable/ai/McpSchema").UntitledMultiSelectEnum, typeof import("effect/unstable/ai/McpSchema").TitledMultiSelectEnum]>]>, typeof import("effect/unstable/ai/McpSchema").ElicitationString, typeof import("effect/unstable/ai/McpSchema").ElicitationNumber, typeof import("effect/unstable/ai/McpSchema").ElicitationBoolean]>>;
+                readonly required: Schema.decodeTo<Schema.optional<Schema.$Array<Schema.String>>, Schema.optionalKey<Schema.$Array<Schema.String>>, never, never>;
+            }>>;
+            readonly _meta: Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+            readonly message: Schema.String;
+        }>;
+        readonly elicitationReply: Schema.Union<readonly [Schema.Struct<{
+            readonly ok: Schema.Literal<true>;
+            readonly response: Schema.Union<readonly [Schema.Struct<{
+                readonly _meta: Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+                readonly action: Schema.Literal<"accept">;
+                readonly content: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.$Array<Schema.String>]>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.$Array<Schema.String>]>>>, never, never>;
+            }>, Schema.Struct<{
+                readonly _meta: Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+                readonly action: Schema.Literals<readonly ["cancel", "decline"]>;
+            }>]>;
+        }>, Schema.Struct<{
+            readonly ok: Schema.Literal<false>;
+            readonly error: typeof import("../elicitation.js").ElicitationFailed;
+        }>]>;
+        readonly workflowStep: Schema.Union<readonly [Schema.Struct<{
+            readonly operation: Schema.Literal<"do">;
+            readonly name: Schema.NonEmptyString;
+            readonly options: Schema.Struct<{
+                readonly retries: Schema.optionalKey<Schema.Struct<{
+                    readonly limit: Schema.Int;
+                    readonly delay: Schema.Union<readonly [Schema.Finite, Schema.NonEmptyString]>;
+                    readonly backoff: Schema.optionalKey<Schema.Literals<readonly ["constant", "linear", "exponential"]>>;
+                }>>;
+                readonly timeout: Schema.optionalKey<Schema.Union<readonly [Schema.Finite, Schema.NonEmptyString]>>;
+            }>;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"sleep">;
+            readonly name: Schema.NonEmptyString;
+            readonly duration: Schema.Union<readonly [Schema.Finite, Schema.NonEmptyString]>;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"until">;
+            readonly name: Schema.NonEmptyString;
+            readonly timestamp: Schema.Finite;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"context">;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"invoke">;
+            readonly kind: Schema.Literals<readonly ["query", "mutation"]>;
+            readonly name: Schema.NonEmptyString;
+            readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            readonly stepId: Schema.NonEmptyString;
+            readonly timeout: Schema.Finite;
+        }>]>;
+        readonly workflowStepReply: Schema.Union<readonly [Schema.Struct<{
+            readonly ok: Schema.Literal<true>;
+            readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        }>, Schema.Struct<{
+            readonly ok: Schema.Literal<false>;
+            readonly error: typeof import("../workflows.js").WorkflowFailure;
+        }>]>;
+        readonly workflowControl: Schema.Union<readonly [Schema.Struct<{
+            readonly operation: Schema.Literal<"start">;
+            readonly workflow: Schema.NonEmptyString;
+            readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            readonly key: Schema.optionalKey<Schema.NonEmptyString>;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"get">;
+            readonly run: Schema.brand<Schema.NonEmptyString, "wfr">;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"list">;
+            readonly workflow: Schema.optionalKey<Schema.NonEmptyString>;
+            readonly cursor: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "wfr">>;
+            readonly limit: Schema.optionalKey<Schema.Int>;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"terminate">;
+            readonly run: Schema.brand<Schema.NonEmptyString, "wfr">;
+        }>]>;
+        readonly cacheCommand: Schema.Union<readonly [Schema.Struct<{
+            readonly operation: Schema.Literal<"read">;
+            readonly keys: Schema.$Array<Schema.String>;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"acquire">;
+            readonly key: Schema.String;
+            readonly refresh: Schema.Boolean;
+            readonly version: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"claim">;
+            readonly key: Schema.String;
+            readonly version: Schema.NullOr<Schema.String>;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"publish">;
+            readonly key: Schema.String;
+            readonly lease: Schema.String;
+            readonly entry: Schema.Struct<{
+                readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+                readonly version: Schema.String;
+                readonly freshUntil: Schema.Finite;
+                readonly staleUntil: Schema.Finite;
+            }>;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"release">;
+            readonly key: Schema.String;
+            readonly lease: Schema.String;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"renew">;
+            readonly key: Schema.String;
+            readonly lease: Schema.String;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"write">;
+            readonly entries: Schema.$Array<Schema.Struct<{
+                readonly key: Schema.String;
+                readonly entry: Schema.Struct<{
+                    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+                    readonly version: Schema.String;
+                    readonly freshUntil: Schema.Finite;
+                    readonly staleUntil: Schema.Finite;
+                }>;
+            }>>;
+        }>, Schema.Struct<{
+            readonly operation: Schema.Literal<"invalidate">;
+            readonly key: Schema.String;
+        }>]>;
+        readonly cacheReply: Schema.Union<readonly [Schema.Struct<{
+            readonly ok: Schema.Literal<true>;
+            readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        }>, Schema.Struct<{
+            readonly ok: Schema.Literal<false>;
+            readonly error: typeof import("../../../../app-cache/src/index.js").CacheError;
+        }>]>;
+    };
+};