apps 0.0.1-beta.0 → 0.0.1-beta.10

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

@@ -0,0 +1,676 @@
+/**
+ * Host protocol 3: protocol 2 plus the app's own failure detail. Operation, evaluation and
+ * declaration failures carry the error name and bounded, secret-free message the app raised, and
+ * workflow failures carry the failing step and app error. Queries and mutations that exceed a
+ * database budget, and declarations with a reserved database field, fail with their named error.
+ *
+ * This protocol is released and frozen once merged. `bun run check` compares `protocol3` with
+ * `packages/apps/protocols/3.json`. Do not edit this file or the schemas it reaches to change the
+ * wire format; define the next protocol instead. See notes/apps-publishing.md.
+ */
+import { Schema } from "effect";
+import { DatabaseFieldReserved, DatabaseLimitExceeded } from "../../../../app-data/src/contracts/database.js";
+import { OpenapiResponseError } from "../api-response-error.js";
+import { ElicitationFailed } from "../elicitation.js";
+import { McpError } from "../mcp.js";
+import { ProviderError } from "../provider-error.js";
+import { SkillLoadFailed } from "../skills.js";
+import { WorkflowFailure } from "../workflows.js";
+import { HostAccountsInvalid, HostInputInvalid, HostOperationNotFound, HostOutputInvalid, HostRequestInvalid, HostToolApprovalRequired, HostToolBlocked, HostToolNotFound, HostToolPolicyFailed } from "./1.js";
+export { DeclaredAuthMethod, DeclaredProvider, DeclaredRequirements, ResolvedAccount, ResolvedAccounts, TrustedToolApproval, InvocationDeadline, HostedTool, HostedToolSummary, HostRequest, HostRequestInvalid, HostAccountsInvalid, HostOperationNotFound, HostToolNotFound, InputProblem, maxInputProblems, HostInputInvalid, HostToolBlocked, HostToolApprovalRequired, HostToolPolicyFailed, HostOutputInvalid, HostInvocation, } from "./1.js";
+export { SkillSources, SkillCatalogResponse } from "./2.js";
+declare const HostDeclarationInvalid_base: Schema.Class<HostDeclarationInvalid, Schema.TaggedStruct<"HostDeclarationInvalid", {
+    source: Schema.optionalKey<Schema.Literals<readonly ["app", "storage", "service"]>>;
+    errorName: Schema.optionalKey<Schema.String>;
+    code: Schema.optionalKey<Schema.String>;
+    message: Schema.optionalKey<Schema.String>;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * The module or declared capability shape could not be hosted. The detail names what the app
+ * declared wrongly; declarations bind no accounts.
+ */
+export declare class HostDeclarationInvalid extends HostDeclarationInvalid_base {
+}
+declare const HostEvaluationFailed_base: Schema.Class<HostEvaluationFailed, Schema.TaggedStruct<"HostEvaluationFailed", {
+    source: Schema.optionalKey<Schema.Literals<readonly ["app", "storage", "service"]>>;
+    errorName: Schema.optionalKey<Schema.String>;
+    code: Schema.optionalKey<Schema.String>;
+    message: Schema.optionalKey<Schema.String>;
+}>, import("effect/Cause").YieldableError>;
+/** Fresh app evaluation failed before calling a tool. */
+export declare class HostEvaluationFailed extends HostEvaluationFailed_base {
+}
+declare const HostOperationFailed_base: Schema.Class<HostOperationFailed, Schema.TaggedStruct<"HostOperationFailed", {
+    source: Schema.optionalKey<Schema.Literals<readonly ["app", "storage", "service"]>>;
+    errorName: Schema.optionalKey<Schema.String>;
+    code: Schema.optionalKey<Schema.String>;
+    message: Schema.optionalKey<Schema.String>;
+}>, import("effect/Cause").YieldableError>;
+/** An app operation failed. Carries the app's own error name and bounded, secret-free message. */
+export declare class HostOperationFailed extends HostOperationFailed_base {
+}
+/**
+ * Safe error envelope. Author failures carry only their name and bounded message with account
+ * secrets replaced; no source, account fields, stack or cause value is serialized.
+ */
+export declare const HostError: Schema.Union<readonly [typeof OpenapiResponseError, typeof ProviderError, typeof McpError, typeof SkillLoadFailed, typeof WorkflowFailure, typeof HostRequestInvalid, typeof HostAccountsInvalid, typeof HostDeclarationInvalid, typeof HostEvaluationFailed, typeof HostOperationNotFound, typeof HostOperationFailed, typeof DatabaseLimitExceeded, typeof DatabaseFieldReserved, typeof HostToolNotFound, typeof HostInputInvalid, typeof HostOutputInvalid, typeof HostToolBlocked, typeof HostToolApprovalRequired, typeof HostToolPolicyFailed, typeof ElicitationFailed]>;
+/** Expected host failures. */
+export type HostError = typeof HostError.Type;
+/** Portable response envelope; callers parse the success value for their operation. */
+export declare const HostResponse: 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 OpenapiResponseError, typeof ProviderError, typeof McpError, typeof SkillLoadFailed, typeof WorkflowFailure, typeof HostRequestInvalid, typeof HostAccountsInvalid, typeof HostDeclarationInvalid, typeof HostEvaluationFailed, typeof HostOperationNotFound, typeof HostOperationFailed, typeof DatabaseLimitExceeded, typeof DatabaseFieldReserved, typeof HostToolNotFound, typeof HostInputInvalid, typeof HostOutputInvalid, typeof HostToolBlocked, typeof HostToolApprovalRequired, typeof HostToolPolicyFailed, typeof ElicitationFailed]>;
+}>]>;
+/** Parsed response envelope. */
+export type HostResponse = typeof HostResponse.Type;
+/** Every message of protocol 3, in the order its snapshot records them. */
+export declare const protocol3: {
+    readonly version: 3;
+    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 input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+            }>]>;
+            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 input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        }>]>;
+        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 OpenapiResponseError, typeof ProviderError, typeof McpError, typeof SkillLoadFailed, typeof WorkflowFailure, typeof HostRequestInvalid, typeof HostAccountsInvalid, typeof HostDeclarationInvalid, typeof HostEvaluationFailed, typeof HostOperationNotFound, typeof HostOperationFailed, typeof DatabaseLimitExceeded, typeof DatabaseFieldReserved, typeof HostToolNotFound, typeof HostInputInvalid, typeof HostOutputInvalid, typeof HostToolBlocked, typeof HostToolApprovalRequired, typeof HostToolPolicyFailed, typeof ElicitationFailed]>;
+        }>]>;
+        readonly requirements: Schema.Struct<{
+            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"]>;
+            }>>;
+        }>;
+        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 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 toolSummaries: 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 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 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 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 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;
+        }>]>;
+    };
+};