apps 0.0.1-beta.3 → 0.0.1-beta.5

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

@@ -0,0 +1,668 @@
+/**
+ * Host protocol 2: protocol 1, and a skill catalog reply that says whether its `dynamicSkills`
+ * loader read through the app cache.
+ *
+ * Every other message is protocol 1's, re-exported unchanged. Once released this protocol is
+ * frozen like protocol 1: `bun run check` compares `protocol2` with `packages/apps/protocols/2.json`.
+ * Define the next protocol to change it. See notes/apps-publishing.md.
+ */
+import { Schema } from "effect";
+export * from "./1.js";
+/**
+ * A skill catalog and whether any of it came from `dynamicSkills`. Without a live loader the
+ * catalog is determined by the build and its evaluation inputs; with one it reflects a publisher.
+ * `cached` says the loader read through the app cache, so the cache's freshness and invalidation
+ * govern its publisher reads.
+ */
+export declare const SkillSources: 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>;
+}>;
+export type SkillSources = typeof SkillSources.Type;
+/** Either response shape; `dynamic` is unknown for builds that predate skillSources. */
+export declare const SkillCatalogResponse: 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>;
+}>>]>;
+/** Every message of protocol 2, in the order its snapshot records them. */
+export declare const protocol2: {
+    readonly version: 2;
+    readonly schemas: {
+        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 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 import("../api-response-error.js").OpenapiResponseError, typeof import("../provider-error.js").ProviderError, typeof import("../mcp.js").McpError, typeof import("../skills.js").SkillLoadFailed, typeof import("./1.js").WorkflowFailure, typeof import("./1.js").HostRequestInvalid, typeof import("./1.js").HostAccountsInvalid, typeof import("./1.js").HostDeclarationInvalid, typeof import("./1.js").HostEvaluationFailed, typeof import("./1.js").HostOperationNotFound, typeof import("./1.js").HostOperationFailed, 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]>;
+        }>]>;
+        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 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("./1.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;
+        }>]>;
+    };
+};