@vibesdotdev/tools 0.0.0-stage → 1.0.0-rc.3

package/dist/tools.universal.plugin.d.ts

@@ -0,0 +1,1401 @@
+export declare const toolsPluginDefinition: {
+    id: string;
+    name: string;
+    description: string;
+    dependencies: string[];
+    kinds: (import("@vibesdotdev/kernel").RuntimeKindDescriptorRecord<unknown> | {
+        id: string;
+        descriptorSchema: import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            kind: import("zod").ZodLiteral<"tools/result-encoder">;
+            encoderId: import("zod").ZodEnum<{
+                json: "json";
+                "compact-json": "compact-json";
+                toon: "toon";
+            }>;
+            version: import("zod").ZodDefault<import("zod").ZodString>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>;
+        defaultImplementation: typeof import("./kinds/result-encoder.kind.ts").DefaultResultEncoderImplementation;
+        contexts: readonly [];
+    } | {
+        id: string;
+        descriptorSchema: import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            name: import("zod").ZodOptional<import("zod").ZodString>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            hardware: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            enabled: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            priority: import("zod").ZodOptional<import("zod").ZodNumber>;
+            capabilityId: import("zod").ZodOptional<import("zod").ZodString>;
+            requiredContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            optionalContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            config: import("zod").ZodOptional<import("zod").ZodUnknown>;
+            retention: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodObject<{
+                maxAgeDays: import("zod").ZodOptional<import("zod").ZodNumber>;
+                maxEntries: import("zod").ZodOptional<import("zod").ZodNumber>;
+                maxBytes: import("zod").ZodOptional<import("zod").ZodNumber>;
+                cascadeFrom: import("zod").ZodOptional<import("zod").ZodString>;
+                ageField: import("zod").ZodOptional<import("zod").ZodString>;
+                reason: import("zod").ZodString;
+                enforcedBy: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>]>>;
+            purpose: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+                agent: "agent";
+                worker: "worker";
+                mcp: "mcp";
+                direct: "direct";
+                projection: "projection";
+            }>>>;
+            restrictPurpose: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            category: import("zod").ZodOptional<import("zod").ZodString>;
+            subcategory: import("zod").ZodOptional<import("zod").ZodString>;
+            aliases: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            permissions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            requiresApproval: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            approval: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodPipe<import("zod").ZodObject<{
+                channel: import("zod").ZodString;
+                correlation: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodOptional<import("zod").ZodString>>>;
+            }, import("zod/v4/core").$strict>, import("zod").ZodTransform<{
+                channel: string;
+                correlation?: Record<string, string> | undefined;
+            }, {
+                channel: string;
+                correlation?: Record<string, string | undefined> | undefined;
+            }>>, import("zod").ZodObject<{
+                config: import("zod").ZodObject<{
+                    id: import("zod").ZodString;
+                    field: import("zod").ZodString;
+                }, import("zod/v4/core").$strip>;
+            }, import("zod/v4/core").$strip>]>>;
+            capability: import("zod").ZodOptional<import("zod").ZodObject<{
+                scopes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                samplingIntent: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                tier: import("zod").ZodEnum<{
+                    0: "0";
+                    1: "1";
+                    3: "3";
+                    "2a": "2a";
+                    "2b": "2b";
+                }>;
+                egress: import("zod").ZodOptional<import("zod").ZodObject<{
+                    anyHost: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    hosts: import("zod").ZodArray<import("zod").ZodString>;
+                }, import("zod/v4/core").$strip>>;
+            }, import("zod/v4/core").$strip>>;
+            safety: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"read">, import("zod").ZodLiteral<"write">, import("zod").ZodLiteral<"execute">, import("zod").ZodObject<{
+                category: import("zod").ZodEnum<{
+                    read: "read";
+                    write: "write";
+                    execute: "execute";
+                }>;
+                idempotent: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                destructive: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                openWorld: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            }, import("zod/v4/core").$strip>]>>;
+            reads: import("zod").ZodOptional<import("zod").ZodEnum<{
+                index: "index";
+                "working-tree": "working-tree";
+            }>>;
+            mcpDescription: import("zod").ZodOptional<import("zod").ZodString>;
+            mcp: import("zod").ZodOptional<import("zod").ZodObject<{
+                resource: import("zod").ZodOptional<import("zod").ZodObject<{
+                    uri: import("zod").ZodString;
+                    name: import("zod").ZodString;
+                    description: import("zod").ZodOptional<import("zod").ZodString>;
+                    mimeType: import("zod").ZodOptional<import("zod").ZodString>;
+                    cacheable: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    subscriptions: import("zod").ZodOptional<import("zod").ZodObject<{
+                        supported: import("zod").ZodBoolean;
+                        events: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                    }, import("zod/v4/core").$strip>>;
+                }, import("zod/v4/core").$strip>>;
+                resources: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                    uri: import("zod").ZodString;
+                    name: import("zod").ZodString;
+                    description: import("zod").ZodOptional<import("zod").ZodString>;
+                    mimeType: import("zod").ZodOptional<import("zod").ZodString>;
+                    cacheable: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    subscriptions: import("zod").ZodOptional<import("zod").ZodObject<{
+                        supported: import("zod").ZodBoolean;
+                        events: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                    }, import("zod/v4/core").$strip>>;
+                }, import("zod/v4/core").$strip>>>;
+                resourceTemplates: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                    uriTemplate: import("zod").ZodString;
+                    name: import("zod").ZodString;
+                    description: import("zod").ZodOptional<import("zod").ZodString>;
+                    mimeType: import("zod").ZodOptional<import("zod").ZodString>;
+                    cacheable: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    subscriptions: import("zod").ZodOptional<import("zod").ZodObject<{
+                        supported: import("zod").ZodBoolean;
+                        events: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                    }, import("zod/v4/core").$strip>>;
+                }, import("zod/v4/core").$strip>>>;
+                promptIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            }, import("zod/v4/core").$strip>>;
+            examples: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                description: import("zod").ZodOptional<import("zod").ZodString>;
+                input: import("zod").ZodOptional<import("zod").ZodUnknown>;
+                output: import("zod").ZodOptional<import("zod").ZodUnknown>;
+                notes: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>>>;
+            usageGuidance: import("zod").ZodOptional<import("zod").ZodObject<{
+                when: import("zod").ZodOptional<import("zod").ZodString>;
+                whenNot: import("zod").ZodOptional<import("zod").ZodString>;
+                alternatives: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                    tool: import("zod").ZodString;
+                    scenario: import("zod").ZodOptional<import("zod").ZodString>;
+                }, import("zod/v4/core").$strip>>>;
+                commonPatterns: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            }, import("zod/v4/core").$strip>>;
+            kind: import("zod").ZodLiteral<"tools/tool">;
+            schemas: import("zod").ZodObject<{
+                events: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodInstanceOf<import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>>>>;
+                defaultAction: import("zod").ZodOptional<import("zod").ZodString>;
+                actionSafety: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodEnum<{
+                    read: "read";
+                    write: "write";
+                    execute: "execute";
+                }>>>;
+                input: import("zod").ZodUnion<readonly [import("zod").ZodInstanceOf<import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>>, import("zod").ZodPipe<import("zod").ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, import("zod/v4/core").$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>, import("zod").ZodTransform<import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>, import("@vibesdotdev/kernel/schemas/json").JsonObject>>]>;
+                output: import("zod").ZodUnion<readonly [import("zod").ZodInstanceOf<import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>>, import("zod").ZodPipe<import("zod").ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, import("zod/v4/core").$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>, import("zod").ZodTransform<import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>, import("@vibesdotdev/kernel/schemas/json").JsonObject>>]>;
+            }, import("zod/v4/core").$strip>;
+        }, import("zod/v4/core").$strip>;
+        defaultImplementation: {
+            new (descriptor: import("@vibesdotdev/kernel").RuntimeDescriptor, _context: import("@vibesdotdev/kernel").KindContext): {
+                readonly id: string;
+                readonly descriptor: import("@vibesdotdev/ai-schemas/schemas/runtime/descriptors").ToolAssetDescriptor;
+                execute(_input: import("./kinds/tool.ts").ToolExecutionInput, _runtime: import("@vibesdotdev/kernel").VibesRuntime, _ctx: import("@vibesdotdev/kernel").ToolCallContext): Promise<import("./kinds/tool.ts").ToolExecutionResult>;
+            };
+        };
+        validateImplementation: (impl: import("./kinds/schemas/tool.ts").ToolImplementationBinding) => boolean;
+        resolve: (candidates: import("@vibesdotdev/kernel").RuntimeDescriptor[]) => import("@vibesdotdev/kernel").RuntimeDescriptor | undefined;
+        isEligible: (descriptor: import("@vibesdotdev/kernel").RuntimeDescriptor, requestedScope: {
+            purpose?: string;
+        }, executionScope: {
+            hardware?: import("@vibesdotdev/kernel").RuntimeScope["hardware"];
+        }) => boolean;
+        contexts: never[];
+        discoveryPatterns: readonly [".vibes/tools/*.descriptor.ts"];
+        discoveredImplementation: typeof import("./kinds/tool.ts").localToolImplementation;
+    } | {
+        id: string;
+        descriptorSchema: import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            name: import("zod").ZodOptional<import("zod").ZodString>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            enabled: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            priority: import("zod").ZodOptional<import("zod").ZodNumber>;
+            capabilityId: import("zod").ZodOptional<import("zod").ZodString>;
+            requiredContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            optionalContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            config: import("zod").ZodOptional<import("zod").ZodUnknown>;
+            retention: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodObject<{
+                maxAgeDays: import("zod").ZodOptional<import("zod").ZodNumber>;
+                maxEntries: import("zod").ZodOptional<import("zod").ZodNumber>;
+                maxBytes: import("zod").ZodOptional<import("zod").ZodNumber>;
+                cascadeFrom: import("zod").ZodOptional<import("zod").ZodString>;
+                ageField: import("zod").ZodOptional<import("zod").ZodString>;
+                reason: import("zod").ZodString;
+                enforcedBy: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>]>>;
+            kind: import("zod").ZodLiteral<"tools/adapter">;
+            surfaces: import("zod").ZodArray<import("zod").ZodEnum<{
+                agent: "agent";
+                cli: "cli";
+                tui: "tui";
+                worker: "worker";
+                mcp: "mcp";
+                api: "api";
+                skill: "skill";
+                opencode: "opencode";
+            }>>;
+            hardware: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+                consumer: "consumer";
+                cloud: "cloud";
+            }>>>;
+        }, import("zod/v4/core").$strip>;
+        defaultImplementation: typeof import("./shared/tool-kind-resolvers.ts").DefaultToolAdapterRuntime;
+        resolve: typeof import("./shared/tool-kind-resolvers.ts").resolveAdapterBySurface;
+        contexts: string[];
+    } | {
+        id: string;
+        descriptorSchema: import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            name: import("zod").ZodOptional<import("zod").ZodString>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            enabled: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            priority: import("zod").ZodOptional<import("zod").ZodNumber>;
+            capabilityId: import("zod").ZodOptional<import("zod").ZodString>;
+            requiredContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            optionalContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            config: import("zod").ZodOptional<import("zod").ZodUnknown>;
+            retention: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodObject<{
+                maxAgeDays: import("zod").ZodOptional<import("zod").ZodNumber>;
+                maxEntries: import("zod").ZodOptional<import("zod").ZodNumber>;
+                maxBytes: import("zod").ZodOptional<import("zod").ZodNumber>;
+                cascadeFrom: import("zod").ZodOptional<import("zod").ZodString>;
+                ageField: import("zod").ZodOptional<import("zod").ZodString>;
+                reason: import("zod").ZodString;
+                enforcedBy: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>]>>;
+            kind: import("zod").ZodLiteral<"tools/provider">;
+            capabilities: import("zod").ZodObject<{
+                watchable: import("zod").ZodBoolean;
+                writable: import("zod").ZodBoolean;
+                remote: import("zod").ZodBoolean;
+            }, import("zod/v4/core").$strip>;
+            hardware: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+                consumer: "consumer";
+                cloud: "cloud";
+            }>>>;
+        }, import("zod/v4/core").$strip>;
+        defaultImplementation: typeof import("./shared/tool-kind-resolvers.ts").DefaultToolProviderRuntime;
+        contexts: string[];
+    } | {
+        id: string;
+        descriptorSchema: import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            name: import("zod").ZodOptional<import("zod").ZodString>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            enabled: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            priority: import("zod").ZodOptional<import("zod").ZodNumber>;
+            capabilityId: import("zod").ZodOptional<import("zod").ZodString>;
+            requiredContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            optionalContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            config: import("zod").ZodOptional<import("zod").ZodUnknown>;
+            retention: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodObject<{
+                maxAgeDays: import("zod").ZodOptional<import("zod").ZodNumber>;
+                maxEntries: import("zod").ZodOptional<import("zod").ZodNumber>;
+                maxBytes: import("zod").ZodOptional<import("zod").ZodNumber>;
+                cascadeFrom: import("zod").ZodOptional<import("zod").ZodString>;
+                ageField: import("zod").ZodOptional<import("zod").ZodString>;
+                reason: import("zod").ZodString;
+                enforcedBy: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>]>>;
+            kind: import("zod").ZodLiteral<"tools/ui">;
+            surfaces: import("zod").ZodArray<import("zod").ZodEnum<{
+                cli: "cli";
+                tui: "tui";
+                worker: "worker";
+                bridge: "bridge";
+                web: "web";
+            }>>;
+            hardware: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+                consumer: "consumer";
+                cloud: "cloud";
+            }>>>;
+            targetId: import("zod").ZodOptional<import("zod").ZodString>;
+            role: import("zod").ZodEnum<{
+                approval: "approval";
+                badge: "badge";
+                widget: "widget";
+            }>;
+            targetToolId: import("zod").ZodString;
+            placement: import("zod").ZodOptional<import("zod").ZodEnum<{
+                inline: "inline";
+                top: "top";
+                bottom: "bottom";
+            }>>;
+        }, import("zod/v4/core").$strip>;
+        defaultImplementation: typeof import("./shared/tool-kind-resolvers.ts").DefaultToolUI;
+        resolve: typeof import("./shared/tool-kind-resolvers.ts").resolveToolUI;
+        contexts: readonly [];
+    } | {
+        id: string;
+        descriptorSchema: import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            kind: import("zod").ZodLiteral<"tools/fetch-scan-cache">;
+            version: import("zod").ZodDefault<import("zod").ZodString>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>;
+        defaultImplementation: typeof import("./kinds/fetch-scan-cache.kind.ts").DefaultFetchScanCacheImplementation;
+        contexts: readonly [];
+    } | {
+        id: "tools/approval-channel";
+        descriptorSchema: import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            name: import("zod").ZodOptional<import("zod").ZodString>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            hardware: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            enabled: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            priority: import("zod").ZodOptional<import("zod").ZodNumber>;
+            capabilityId: import("zod").ZodOptional<import("zod").ZodString>;
+            requiredContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            optionalContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            config: import("zod").ZodOptional<import("zod").ZodUnknown>;
+            retention: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodObject<{
+                maxAgeDays: import("zod").ZodOptional<import("zod").ZodNumber>;
+                maxEntries: import("zod").ZodOptional<import("zod").ZodNumber>;
+                maxBytes: import("zod").ZodOptional<import("zod").ZodNumber>;
+                cascadeFrom: import("zod").ZodOptional<import("zod").ZodString>;
+                ageField: import("zod").ZodOptional<import("zod").ZodString>;
+                reason: import("zod").ZodString;
+                enforcedBy: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>]>>;
+            kind: import("zod").ZodLiteral<"tools/approval-channel">;
+            surfaces: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        }, import("zod/v4/core").$strip>;
+        defaultImplementation: {
+            new (): {
+                createRuntime(): import("./agents/contracts/approval-types.ts").ToolApprovalRuntime;
+            };
+        };
+    } | {
+        id: string;
+        descriptorSchema: import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            kind: import("zod").ZodLiteral<"tools/signature-verifier">;
+            name: import("zod").ZodString;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            source: import("zod").ZodString;
+            headerName: import("zod").ZodOptional<import("zod").ZodString>;
+            signingSecretEnv: import("zod").ZodOptional<import("zod").ZodString>;
+            tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        }, import("zod/v4/core").$strip>;
+        defaultImplementation: {
+            new (descriptor: import("@vibesdotdev/kernel").RuntimeDescriptor): {
+                readonly descriptor: import("./webhooks/index.ts").SignatureVerifierDescriptor;
+                verify(_rawBody: string, _headers: Record<string, string>, _secret: string): boolean;
+            };
+        };
+        resolve: (candidates: import("@vibesdotdev/kernel").RuntimeDescriptor[]) => import("@vibesdotdev/kernel").RuntimeDescriptor;
+        contexts: never[];
+    } | {
+        id: string;
+        descriptorSchema: import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            kind: import("zod").ZodLiteral<"tools/webhook-event-definition">;
+            name: import("zod").ZodString;
+            description: import("zod").ZodString;
+            source: import("zod").ZodString;
+            event_type: import("zod").ZodString;
+            dispatchMode: import("zod").ZodOptional<import("zod").ZodEnum<{
+                none: "none";
+                hook: "hook";
+            }>>;
+            tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        }, import("zod/v4/core").$strip>;
+        defaultImplementation: {
+            new (descriptor: import("@vibesdotdev/kernel").RuntimeDescriptor): {
+                readonly descriptor: import("./webhooks/index.ts").WebhookEventDefinitionDescriptor;
+                parse(): never;
+                buildTask(): never;
+            };
+        };
+        resolve: (candidates: import("@vibesdotdev/kernel").RuntimeDescriptor[]) => import("@vibesdotdev/kernel").RuntimeDescriptor;
+        contexts: never[];
+    } | {
+        id: string;
+        descriptorSchema: import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            name: import("zod").ZodOptional<import("zod").ZodString>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            hardware: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            enabled: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            priority: import("zod").ZodOptional<import("zod").ZodNumber>;
+            capabilityId: import("zod").ZodOptional<import("zod").ZodString>;
+            requiredContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            optionalContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            config: import("zod").ZodOptional<import("zod").ZodUnknown>;
+            retention: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodObject<{
+                maxAgeDays: import("zod").ZodOptional<import("zod").ZodNumber>;
+                maxEntries: import("zod").ZodOptional<import("zod").ZodNumber>;
+                maxBytes: import("zod").ZodOptional<import("zod").ZodNumber>;
+                cascadeFrom: import("zod").ZodOptional<import("zod").ZodString>;
+                ageField: import("zod").ZodOptional<import("zod").ZodString>;
+                reason: import("zod").ZodString;
+                enforcedBy: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>]>>;
+            kind: import("zod").ZodLiteral<"tools/webhook-consumer">;
+            sources: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            eventTypes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            maxAttempts: import("zod").ZodDefault<import("zod").ZodNumber>;
+        }, import("zod/v4/core").$strip>;
+        resolve: (candidates: import("@vibesdotdev/kernel").RuntimeDescriptor[]) => import("@vibesdotdev/kernel").RuntimeDescriptor;
+        contexts: never[];
+    } | {
+        id: string;
+        descriptorSchema: import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            name: import("zod").ZodOptional<import("zod").ZodString>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            hardware: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            enabled: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            priority: import("zod").ZodOptional<import("zod").ZodNumber>;
+            capabilityId: import("zod").ZodOptional<import("zod").ZodString>;
+            requiredContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            optionalContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            config: import("zod").ZodOptional<import("zod").ZodUnknown>;
+            retention: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodObject<{
+                maxAgeDays: import("zod").ZodOptional<import("zod").ZodNumber>;
+                maxEntries: import("zod").ZodOptional<import("zod").ZodNumber>;
+                maxBytes: import("zod").ZodOptional<import("zod").ZodNumber>;
+                cascadeFrom: import("zod").ZodOptional<import("zod").ZodString>;
+                ageField: import("zod").ZodOptional<import("zod").ZodString>;
+                reason: import("zod").ZodString;
+                enforcedBy: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>]>>;
+            kind: import("zod").ZodLiteral<"tools/webhook-service">;
+        }, import("zod/v4/core").$strip>;
+        resolve: (candidates: import("@vibesdotdev/kernel").RuntimeDescriptor[]) => import("@vibesdotdev/kernel").RuntimeDescriptor;
+        contexts: never[];
+    })[];
+    descriptors: (import("@vibesdotdev/kernel").RuntimeDescriptor | {
+        kind: "docs/topic";
+        id: string;
+        title: string;
+        body: {
+            type: "markdown";
+            sourceType: "raw" | "package";
+            source: string;
+        } | {
+            type: "component";
+            path: string;
+            exportKey: string;
+            props?: Record<string, unknown> | undefined;
+        } | {
+            type: "route";
+            path: string;
+        } | {
+            type: "openapi";
+            source: string;
+        } | {
+            type: "graphql";
+            source: string;
+        } | {
+            type: "descriptor-ref";
+            kind: string;
+            id: string;
+        };
+        tags: string[];
+        surfaces: ("cli" | "mcp" | "web" | "in-app")[];
+        enabled: boolean;
+        summary?: string | undefined;
+        parent?: string | undefined;
+        track?: "start-here" | "framework-kit" | "platform-cloud" | "local-tooling" | "api-reference" | "internals" | undefined;
+        order?: number | undefined;
+        subject?: {
+            kind: string;
+            id: string;
+        } | undefined;
+        man?: {
+            name?: string | undefined;
+            section?: number | undefined;
+            synopsis?: string | undefined;
+            options?: {
+                flag: string;
+                description: string;
+            }[] | undefined;
+            examples?: {
+                description: string;
+                command: string;
+            }[] | undefined;
+            seeAlso?: string[] | undefined;
+        } | undefined;
+        hardware?: ("consumer" | "cloud")[] | undefined;
+    } | {
+        readonly kind: "tools/tool";
+        readonly id: "run-feedback";
+        readonly name: "Run feedback";
+        readonly description: "Publish a concise activity description or ask a blocking question in the current recorded execution. Ask waits for the answer or cancellation. This communicates task guidance; it does not grant tool approval or permissions.";
+        readonly mcpDescription: "Report what you are doing with action activity, or ask for missing information with action ask. Keep messages concise. Available only inside a recorded run.";
+        readonly hardware: ["consumer", "cloud"];
+        readonly purpose: ["agent", "worker"];
+        readonly category: "agents";
+        readonly subcategory: "orchestration";
+        readonly safety: "write";
+        readonly capability: {
+            readonly tier: "1";
+        };
+        readonly schemas: {
+            readonly input: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+                action: import("zod").ZodLiteral<"ask">;
+                message: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+                action: import("zod").ZodLiteral<"activity">;
+                message: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>], "action">;
+            readonly output: import("zod").ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, import("zod/v4/core").$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>;
+        };
+    } | {
+        id: string;
+        kind: "tools/result-encoder";
+        encoderId: "json";
+        version: string;
+    } | {
+        id: string;
+        kind: "tools/result-encoder";
+        encoderId: "compact-json";
+        version: string;
+    } | {
+        readonly id: "fetch-scan-cache";
+        readonly kind: "tools/fetch-scan-cache";
+        readonly description: "Default HTTP fetch scan cache";
+    } | {
+        kind: "runtime/event";
+        id: string;
+        source: string;
+        name: string;
+        description: string;
+        trigger: string;
+    } | {
+        kind: "config/manifest";
+        id: string;
+        name: string;
+        namespace: string;
+        description: string;
+        schema: import("zod").ZodObject<{
+            vibesAiOrigin: import("zod").ZodDefault<import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string | undefined, string>>>;
+            vibesApiEndpoint: import("zod").ZodOptional<import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string | undefined, string>>>;
+            vibesToolNpmRegistry: import("zod").ZodOptional<import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string | undefined, string>>>;
+            vibesRegistryOrigin: import("zod").ZodOptional<import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string | undefined, string>>>;
+            publicVibesRegistryOrigin: import("zod").ZodDefault<import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string | undefined, string>>>;
+            vibesToolRegistry: import("zod").ZodOptional<import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string | undefined, string>>>;
+            vibesToolNpmScope: import("zod").ZodOptional<import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string | undefined, string>>>;
+            webhookAllowUnsigned: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            presets: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                name: import("zod").ZodString;
+                description: import("zod").ZodOptional<import("zod").ZodString>;
+                inherits: import("zod").ZodOptional<import("zod").ZodString>;
+                enabledPatterns: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                resetPatterns: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                disabledPatterns: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                tools: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodObject<{
+                    enabled: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    approval: import("zod").ZodOptional<import("zod").ZodEnum<{
+                        default: "default";
+                        confirm: "confirm";
+                        auto: "auto";
+                        "safe-auto": "safe-auto";
+                    }>>;
+                    priority: import("zod").ZodOptional<import("zod").ZodNumber>;
+                }, import("zod/v4/core").$strip>>>;
+                defaultApproval: import("zod").ZodOptional<import("zod").ZodEnum<{
+                    default: "default";
+                    confirm: "confirm";
+                    auto: "auto";
+                    "safe-auto": "safe-auto";
+                }>>;
+                systemPromptAddition: import("zod").ZodOptional<import("zod").ZodString>;
+                maxIterations: import("zod").ZodOptional<import("zod").ZodNumber>;
+                maxTools: import("zod").ZodOptional<import("zod").ZodNumber>;
+                toolPriority: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                requiredTools: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                omitOutputSchemaOnWire: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                mcpWireNaming: import("zod").ZodOptional<import("zod").ZodEnum<{
+                    identity: "identity";
+                    "underscore-dots": "underscore-dots";
+                    "strict-alphanumeric": "strict-alphanumeric";
+                }>>;
+                aliases: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            }, import("zod/v4/core").$strip>>>;
+        }, import("zod/v4/core").$strip>;
+        specialization: {
+            id: string;
+            payload: {
+                id: string;
+                name: string;
+                inherits: string;
+                requiredTools: string[];
+                tools: {
+                    knowledge: {
+                        enabled: true;
+                        priority: number;
+                    };
+                    'vibes-work': {
+                        enabled: true;
+                        priority: number;
+                    };
+                    brain: {
+                        enabled: true;
+                        priority: number;
+                    };
+                    presence: {
+                        enabled: true;
+                        priority: number;
+                    };
+                    awareness: {
+                        enabled: true;
+                        priority: number;
+                    };
+                    session: {
+                        enabled: true;
+                    };
+                    'session-todo': {
+                        enabled: true;
+                    };
+                    'session-scratchpad': {
+                        enabled: true;
+                    };
+                    'session-collaborate': {
+                        enabled: true;
+                    };
+                    'session-workspace': {
+                        enabled: true;
+                    };
+                };
+            };
+        };
+        scope: "global";
+        tier: "user";
+        storedLayer: "none";
+        allowedAdapters: string[];
+        fields: {
+            vibesAiOrigin: {
+                ui: {
+                    label: string;
+                    component: "input";
+                };
+            };
+            vibesApiEndpoint: {
+                ui: {
+                    label: string;
+                    component: "input";
+                };
+            };
+            vibesToolNpmRegistry: {
+                ui: {
+                    label: string;
+                    component: "input";
+                };
+            };
+            vibesRegistryOrigin: {
+                ui: {
+                    label: string;
+                    component: "input";
+                };
+            };
+            publicVibesRegistryOrigin: {
+                ui: {
+                    label: string;
+                    component: "input";
+                };
+            };
+            vibesToolRegistry: {
+                ui: {
+                    label: string;
+                    component: "input";
+                };
+            };
+            vibesToolNpmScope: {
+                ui: {
+                    label: string;
+                    component: "input";
+                };
+            };
+        };
+        customTables: false;
+        version: number;
+        internal: false;
+    } | {
+        kind: "config/manifest";
+        id: string;
+        name: string;
+        namespace: string;
+        description: string;
+        schema: import("zod").ZodObject<{
+            channel: import("zod").ZodOptional<import("zod").ZodString>;
+            wait: import("zod").ZodDefault<import("zod").ZodEnum<{
+                run: "run";
+                branch: "branch";
+                linked: "linked";
+            }>>;
+            changes: import("zod").ZodDefault<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodEnum<{
+                never: "never";
+                ask: "ask";
+                auto: "auto";
+            }>>>;
+        }, import("zod/v4/core").$strip>;
+        scope: "auto";
+        tier: "user";
+        allowedAdapters: string[];
+        fields: {
+            channel: {
+                ui: {
+                    label: string;
+                    component: "input";
+                };
+            };
+            wait: {
+                ui: {
+                    label: string;
+                    component: "select";
+                };
+            };
+        };
+        customTables: false;
+        version: number;
+        internal: false;
+    } | {
+        readonly kind: "tools/tool";
+        readonly id: "agent-execution";
+        readonly name: "Agent Execution";
+        readonly description: "Execute an AI agent with billing integration and token usage tracking";
+        readonly mcpDescription: "Execute an agent with input and return generated content with usage stats.";
+        readonly hardware: ["consumer", "cloud"];
+        readonly purpose: ["direct", "worker", "agent"];
+        readonly category: "ai";
+        readonly subcategory: "agent";
+        readonly safety: {
+            readonly category: "execute";
+            readonly destructive: true;
+        };
+        readonly requiresApproval: true;
+        readonly tags: ["agent", "execution", "ai", "generation", "billing"];
+        readonly schemas: {
+            readonly input: import("zod").ZodObject<{
+                agentId: import("zod").ZodString;
+                input: import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>]>;
+                options: import("zod").ZodOptional<import("zod").ZodObject<{
+                    modelId: import("zod").ZodOptional<import("zod").ZodString>;
+                    temperature: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    maxTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    timeout: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    toolIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                    inheritAgentTools: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    toolConfigurations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                        toolId: import("zod").ZodString;
+                    }, import("zod/v4/core").$loose>>>;
+                }, import("zod/v4/core").$strip>>;
+            }, import("zod/v4/core").$strip>;
+            readonly output: import("zod").ZodObject<{
+                status: import("zod").ZodEnum<{
+                    failed: "failed";
+                    timeout: "timeout";
+                    completed: "completed";
+                }>;
+                content: import("zod").ZodString;
+                output: import("zod").ZodObject<{
+                    result: import("zod").ZodString;
+                    content: import("zod").ZodString;
+                }, import("zod/v4/core").$strip>;
+                executionTimeMs: import("zod").ZodNumber;
+                timestamp: import("zod").ZodISODateTime;
+                usage: import("zod").ZodOptional<import("zod").ZodObject<{
+                    input: import("zod").ZodNumber;
+                    output: import("zod").ZodNumber;
+                    total: import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>>;
+                metadata: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+            }, import("zod/v4/core").$strip>;
+        };
+        readonly examples: [{
+            readonly description: "Execute an agent with a simple text input";
+            readonly input: {
+                readonly agentId: "agent-123";
+                readonly input: "Hello, what can you do?";
+            };
+            readonly notes: "Returns generated content with usage statistics";
+        }, {
+            readonly description: "Execute with options";
+            readonly input: {
+                readonly agentId: "agent-123";
+                readonly input: {
+                    readonly messages: readonly [{
+                        readonly role: "user";
+                        readonly content: "Explain quantum computing";
+                    }];
+                };
+                readonly options: {
+                    readonly temperature: 0.7;
+                    readonly maxTokens: 2000;
+                };
+            };
+        }];
+        readonly usageGuidance: {
+            readonly when: "Run a configured AI agent against a caller-provided input and capture usage metadata.";
+            readonly commonPatterns: ["Provide agentId and input for every invocation.", "Use streaming for real-time responses.", "Identity and billing are supplied by the calling surface — never pass them as input."];
+        };
+    } | {
+        readonly kind: "tools/tool";
+        readonly id: "dashboard-stats";
+        readonly name: "Dashboard Stats";
+        readonly description: "Aggregates dashboard statistics from platform or tools database tables and runtime queries.";
+        readonly mcpDescription: "Get aggregated dashboard statistics. Ex: {context:\"platform\",owner:{...}}.";
+        readonly hardware: ["consumer", "cloud"];
+        readonly purpose: ["direct", "worker"];
+        readonly category: "analytics";
+        readonly subcategory: "dashboard";
+        readonly tags: ["stats", "dashboard", "metrics", "aggregation"];
+        readonly safety: "read";
+        readonly requiresApproval: false;
+        readonly schemas: {
+            readonly input: import("zod").ZodUnion<readonly [import("zod").ZodObject<{
+                context: import("zod").ZodLiteral<"platform">;
+                owner: import("zod").ZodObject<{
+                    ownerType: import("zod").ZodEnum<{
+                        user: "user";
+                        organization: "organization";
+                    }>;
+                    ownerId: import("zod").ZodString;
+                    userId: import("zod").ZodString;
+                }, import("zod/v4/core").$strip>;
+                db: import("zod").ZodAny;
+                dbOps: import("zod").ZodAny;
+                tables: import("zod").ZodObject<{
+                    customHostnames: import("zod").ZodAny;
+                    integrations: import("zod").ZodAny;
+                    databaseConnections: import("zod").ZodAny;
+                    storageProviders: import("zod").ZodAny;
+                    mediaCollections: import("zod").ZodAny;
+                    secrets: import("zod").ZodAny;
+                    daemons: import("zod").ZodAny;
+                    processes: import("zod").ZodAny;
+                }, import("zod/v4/core").$strip>;
+                filterIntegrationFn: import("zod").ZodOptional<import("zod").ZodAny>;
+            }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+                context: import("zod").ZodLiteral<"tools">;
+                db: import("zod").ZodAny;
+                dbOps: import("zod").ZodAny;
+                tables: import("zod").ZodObject<{
+                    agents: import("zod").ZodAny;
+                    prompts: import("zod").ZodAny;
+                    benchmarks: import("zod").ZodAny;
+                    tools: import("zod").ZodAny;
+                }, import("zod/v4/core").$strip>;
+                runtimeStats: import("zod").ZodObject<{
+                    totalTools: import("zod").ZodNumber;
+                    enabledTools: import("zod").ZodNumber;
+                    totalAdapters: import("zod").ZodNumber;
+                    enabledAdapters: import("zod").ZodNumber;
+                    totalProviders: import("zod").ZodNumber;
+                    enabledProviders: import("zod").ZodNumber;
+                    registeredKinds: import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>;
+                remoteRegistryCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+                componentCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+            }, import("zod/v4/core").$strip>]>;
+            readonly output: import("zod").ZodUnion<readonly [import("zod").ZodObject<{
+                context: import("zod").ZodLiteral<"platform">;
+                stats: import("zod").ZodObject<{
+                    hostnames: import("zod").ZodNumber;
+                    integrations: import("zod").ZodNumber;
+                    activeIntegrations: import("zod").ZodNumber;
+                    databases: import("zod").ZodNumber;
+                    connectedDatabases: import("zod").ZodNumber;
+                    storageProviders: import("zod").ZodNumber;
+                    storageCollections: import("zod").ZodNumber;
+                    secrets: import("zod").ZodNumber;
+                    daemons: import("zod").ZodNumber;
+                    activeDaemons: import("zod").ZodNumber;
+                    processes: import("zod").ZodNumber;
+                    runningProcesses: import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>;
+            }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+                context: import("zod").ZodLiteral<"tools">;
+                runtimeStats: import("zod").ZodObject<{
+                    totalTools: import("zod").ZodNumber;
+                    enabledTools: import("zod").ZodNumber;
+                    totalAdapters: import("zod").ZodNumber;
+                    enabledAdapters: import("zod").ZodNumber;
+                    totalProviders: import("zod").ZodNumber;
+                    enabledProviders: import("zod").ZodNumber;
+                    registeredKinds: import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>;
+                rawStats: import("zod").ZodObject<{
+                    customTools: import("zod").ZodNumber;
+                    agents: import("zod").ZodNumber;
+                    prompts: import("zod").ZodNumber;
+                    benchmarks: import("zod").ZodNumber;
+                    components: import("zod").ZodNumber;
+                    recent: import("zod").ZodObject<{
+                        agents: import("zod").ZodArray<import("zod").ZodObject<{
+                            id: import("zod").ZodString;
+                            name: import("zod").ZodNullable<import("zod").ZodString>;
+                        }, import("zod/v4/core").$strip>>;
+                        prompts: import("zod").ZodArray<import("zod").ZodObject<{
+                            id: import("zod").ZodString;
+                            name: import("zod").ZodNullable<import("zod").ZodString>;
+                        }, import("zod/v4/core").$strip>>;
+                        benchmarks: import("zod").ZodArray<import("zod").ZodObject<{
+                            id: import("zod").ZodString;
+                            name: import("zod").ZodNullable<import("zod").ZodString>;
+                        }, import("zod/v4/core").$strip>>;
+                        tools: import("zod").ZodArray<import("zod").ZodObject<{
+                            id: import("zod").ZodString;
+                            name: import("zod").ZodNullable<import("zod").ZodString>;
+                        }, import("zod/v4/core").$strip>>;
+                    }, import("zod/v4/core").$strip>;
+                }, import("zod/v4/core").$strip>;
+                remoteRegistryCount: import("zod").ZodNumber;
+            }, import("zod/v4/core").$strip>]>;
+        };
+    } | {
+        readonly kind: "tools/tool";
+        readonly id: "tool-help";
+        readonly name: "Tool Help";
+        readonly description: "Show tool params and examples.";
+        readonly mcpDescription: "Tool usage help. Ex: {toolId:\"workspace-fs\"}.";
+        readonly hardware: ["consumer", "cloud"];
+        readonly purpose: ["direct", "worker", "mcp", "agent"];
+        readonly category: "meta";
+        readonly subcategory: "help";
+        readonly safety: "read";
+        readonly requiresApproval: false;
+        readonly capability: {
+            readonly tier: "0";
+        };
+        readonly tags: ["help", "meta", "documentation", "examples"];
+        readonly schemas: {
+            readonly input: import("zod").ZodObject<{
+                toolId: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>;
+            readonly output: import("zod").ZodObject<{
+                toolId: import("zod").ZodString;
+                name: import("zod").ZodString;
+                description: import("zod").ZodString;
+                examples: import("zod").ZodArray<import("zod").ZodObject<{
+                    description: import("zod").ZodString;
+                    input: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+                    output: import("zod").ZodOptional<import("zod").ZodUnknown>;
+                    notes: import("zod").ZodOptional<import("zod").ZodString>;
+                }, import("zod/v4/core").$strip>>;
+                requiredParams: import("zod").ZodArray<import("zod").ZodObject<{
+                    name: import("zod").ZodString;
+                    type: import("zod").ZodString;
+                    description: import("zod").ZodOptional<import("zod").ZodString>;
+                }, import("zod/v4/core").$strip>>;
+                optionalParams: import("zod").ZodArray<import("zod").ZodObject<{
+                    name: import("zod").ZodString;
+                    type: import("zod").ZodString;
+                    description: import("zod").ZodOptional<import("zod").ZodString>;
+                    default: import("zod").ZodOptional<import("zod").ZodUnknown>;
+                }, import("zod/v4/core").$strip>>;
+                actions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                    name: import("zod").ZodString;
+                    safety: import("zod").ZodOptional<import("zod").ZodEnum<{
+                        read: "read";
+                        write: "write";
+                        execute: "execute";
+                    }>>;
+                    isDefault: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    requiredParams: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                        name: import("zod").ZodString;
+                        type: import("zod").ZodString;
+                        description: import("zod").ZodOptional<import("zod").ZodString>;
+                    }, import("zod/v4/core").$strip>>>;
+                }, import("zod/v4/core").$strip>>>;
+                usageGuidance: import("zod").ZodOptional<import("zod").ZodObject<{
+                    when: import("zod").ZodOptional<import("zod").ZodString>;
+                    whenNot: import("zod").ZodOptional<import("zod").ZodString>;
+                    alternatives: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                        tool: import("zod").ZodString;
+                        scenario: import("zod").ZodOptional<import("zod").ZodString>;
+                    }, import("zod/v4/core").$strip>>>;
+                    commonPatterns: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                }, import("zod/v4/core").$strip>>;
+                category: import("zod").ZodOptional<import("zod").ZodString>;
+                safety: import("zod").ZodOptional<import("zod").ZodEnum<{
+                    read: "read";
+                    write: "write";
+                    execute: "execute";
+                }>>;
+            }, import("zod/v4/core").$strip>;
+        };
+        readonly examples: [{
+            readonly description: "Get help for workspace-fs search";
+            readonly input: {
+                readonly toolId: "workspace-fs";
+            };
+            readonly notes: "Returns required/optional params + examples";
+        }, {
+            readonly description: "Check a tool first";
+            readonly input: {
+                readonly toolId: "workspace-lsp";
+            };
+            readonly notes: "Useful before first use";
+        }];
+    } | {
+        readonly kind: "tools/tool";
+        readonly id: "request-approval";
+        readonly name: "Request Approval";
+        readonly description: "Ask for approval before a change your instructions say needs it; wait for the answer.";
+        readonly mcpDescription: "Ask for approval before a change. Ex: {action:\"Remove the legacy loader\",why:\"…\",paths:[\"src/loader.ts\"]}.";
+        readonly hardware: ["consumer", "cloud"];
+        readonly purpose: ["agent", "worker"];
+        readonly category: "agents";
+        readonly subcategory: "approval";
+        readonly safety: "read";
+        readonly capability: {
+            readonly tier: "1";
+        };
+        readonly requiresApproval: true;
+        readonly tags: ["approval", "agents"];
+        readonly schemas: {
+            readonly input: import("zod").ZodObject<{
+                action: import("zod").ZodString;
+                why: import("zod").ZodString;
+                paths: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                evidence: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>;
+            readonly output: import("zod").ZodObject<{
+                approved: import("zod").ZodLiteral<true>;
+                approvedBy: import("zod").ZodEnum<{
+                    channel: "channel";
+                    "run-mode": "run-mode";
+                }>;
+                channel: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>;
+        };
+        readonly examples: [{
+            readonly description: "Ask before removing a capability";
+            readonly input: {
+                readonly action: "Remove the duplicate R2 upload store in chat";
+                readonly why: "integrations-cloudflare already provides uploads/store on R2; chat should use it";
+                readonly paths: readonly ["framework/chat/src/uploads/store.impl.cloud.ts"];
+            };
+            readonly notes: "Approved: you receive { approved: true }. Declined: the result says so, with the reason.";
+        }];
+    } | {
+        readonly kind: "tools/tool";
+        readonly id: "tool-search";
+        readonly name: "Tool Search";
+        readonly description: "Find eligible tools by capability, including tools already advertised in the current catalog.";
+        readonly mcpDescription: "Find tools by task, then use tool-help on the returned toolId. Use tool-call for callable matches; approval-required matches must use their direct host approval path. Ex: {query:\"generate image\"}.";
+        readonly hardware: ["consumer", "cloud"];
+        readonly purpose: ["mcp", "agent"];
+        readonly category: "meta";
+        readonly subcategory: "discovery";
+        readonly safety: "read";
+        readonly requiresApproval: false;
+        readonly capability: {
+            readonly tier: "0";
+        };
+        readonly tags: ["tools", "discovery", "capabilities"];
+        readonly schemas: {
+            readonly input: import("zod").ZodObject<{
+                query: import("zod").ZodString;
+                limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+            }, import("zod/v4/core").$strip>;
+            readonly output: import("zod").ZodObject<{
+                matches: import("zod").ZodArray<import("zod").ZodObject<{
+                    toolId: import("zod").ZodString;
+                    name: import("zod").ZodString;
+                    description: import("zod").ZodString;
+                    category: import("zod").ZodOptional<import("zod").ZodString>;
+                    safety: import("zod").ZodOptional<import("zod").ZodEnum<{
+                        read: "read";
+                        write: "write";
+                        execute: "execute";
+                    }>>;
+                    requiresApproval: import("zod").ZodBoolean;
+                    callable: import("zod").ZodBoolean;
+                    unavailableReason: import("zod").ZodOptional<import("zod").ZodString>;
+                }, import("zod/v4/core").$strip>>;
+                availableCount: import("zod").ZodNumber;
+                next: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>;
+        };
+        readonly examples: [{
+            readonly description: "Find image-generation capabilities";
+            readonly input: {
+                readonly query: "generate image";
+            };
+        }];
+    } | {
+        readonly kind: "tools/tool";
+        readonly id: "tool-call";
+        readonly name: "Tool Call";
+        readonly description: "Invoke a specialized MCP tool found through tool-search.";
+        readonly mcpDescription: "Invoke a callable match from tool-search, including tools already advertised in the current catalog. Targets requiring approval must be invoked directly through an approving host; this bridge cannot verify target approval. Full-catalog denials still apply. First use tool-help. Ex: {toolId:\"calculate\",input:{expression:\"6*7\"}}.";
+        readonly hardware: ["consumer"];
+        readonly purpose: ["mcp"];
+        readonly restrictPurpose: true;
+        readonly category: "meta";
+        readonly subcategory: "execution";
+        readonly safety: {
+            readonly category: "execute";
+            readonly destructive: true;
+        };
+        readonly requiresApproval: true;
+        readonly tags: ["tools", "invocation", "capabilities"];
+        readonly schemas: {
+            readonly input: import("zod").ZodObject<{
+                toolId: import("zod").ZodString;
+                input: import("zod").ZodDefault<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>;
+            }, import("zod/v4/core").$strip>;
+            readonly output: import("zod").ZodObject<{
+                toolId: import("zod").ZodString;
+                result: import("zod").ZodUnknown;
+            }, import("zod/v4/core").$strip>;
+        };
+        readonly examples: [{
+            readonly description: "Invoke a discovered calculator";
+            readonly input: {
+                readonly toolId: "calculate";
+                readonly input: {
+                    readonly expression: "6*7";
+                };
+            };
+        }];
+    } | {
+        readonly kind: "tools/tool";
+        readonly id: "docs-audit-scan";
+        readonly name: "Docs Audit Scan";
+        readonly description: "Scan markdown for stale links, missing files, and likely code/doc mismatches.";
+        readonly mcpDescription: "Scan markdown for stale links, missing files, and code/doc mismatches.";
+        readonly hardware: ["consumer"];
+        readonly purpose: ["direct", "mcp", "agent"];
+        readonly category: "documentation";
+        readonly subcategory: "audit";
+        readonly tags: ["docs", "audit", "markdown"];
+        readonly safety: "read";
+        readonly requiresApproval: false;
+        readonly schemas: {
+            readonly input: import("zod").ZodObject<{
+                cwd: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>;
+            readonly output: import("zod").ZodObject<{
+                files: import("zod").ZodArray<import("zod").ZodString>;
+                findings: import("zod").ZodArray<import("zod").ZodObject<{
+                    file: import("zod").ZodString;
+                    line: import("zod").ZodNumber;
+                    kind: import("zod").ZodEnum<{
+                        "doc-stale": "doc-stale";
+                        "doc-structure": "doc-structure";
+                        "likely-code-bug": "likely-code-bug";
+                    }>;
+                    claim: import("zod").ZodString;
+                    observed: import("zod").ZodString;
+                    suggestedAction: import("zod").ZodString;
+                    featureDir: import("zod").ZodOptional<import("zod").ZodString>;
+                    claimType: import("zod").ZodOptional<import("zod").ZodEnum<{
+                        artifact: "artifact";
+                        "package-entrypoint": "package-entrypoint";
+                        historical: "historical";
+                    }>>;
+                }, import("zod/v4/core").$strip>>;
+            }, import("zod/v4/core").$strip>;
+        };
+    } | {
+        readonly kind: "tools/tool";
+        readonly id: "docs-audit-run";
+        readonly name: "Docs Audit Run";
+        readonly description: "Scan markdown documentation and write generated audit sections to feature ISSUES files.";
+        readonly mcpDescription: "Scan docs and write audit findings to feature ISSUES files.";
+        readonly hardware: ["consumer"];
+        readonly purpose: ["direct", "mcp", "agent"];
+        readonly category: "documentation";
+        readonly subcategory: "audit";
+        readonly tags: ["docs", "audit", "issues"];
+        readonly safety: "write";
+        readonly requiresApproval: true;
+        readonly schemas: {
+            readonly input: import("zod").ZodObject<{
+                cwd: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>;
+            readonly output: import("zod").ZodObject<{
+                scannedFiles: import("zod").ZodNumber;
+                findings: import("zod").ZodNumber;
+                byKind: import("zod").ZodObject<{
+                    'doc-stale': import("zod").ZodNumber;
+                    'doc-structure': import("zod").ZodNumber;
+                    'likely-code-bug': import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>;
+                featureDirectories: import("zod").ZodNumber;
+            }, import("zod/v4/core").$strip>;
+        };
+    } | {
+        readonly kind: "tools/tool";
+        readonly id: "docs-audit-write";
+        readonly name: "Docs Audit Write";
+        readonly description: "Write documentation audit findings into generated sections of feature ISSUES files.";
+        readonly mcpDescription: "Write documentation audit findings to feature ISSUES files.";
+        readonly hardware: ["consumer"];
+        readonly purpose: ["direct", "mcp", "agent"];
+        readonly category: "documentation";
+        readonly subcategory: "audit";
+        readonly tags: ["docs", "audit", "issues"];
+        readonly safety: "write";
+        readonly requiresApproval: true;
+        readonly schemas: {
+            readonly input: import("zod").ZodObject<{
+                cwd: import("zod").ZodOptional<import("zod").ZodString>;
+                scannedFiles: import("zod").ZodNumber;
+                findings: import("zod").ZodArray<import("zod").ZodObject<{
+                    file: import("zod").ZodString;
+                    line: import("zod").ZodNumber;
+                    kind: import("zod").ZodEnum<{
+                        "doc-stale": "doc-stale";
+                        "doc-structure": "doc-structure";
+                        "likely-code-bug": "likely-code-bug";
+                    }>;
+                    claim: import("zod").ZodString;
+                    observed: import("zod").ZodString;
+                    suggestedAction: import("zod").ZodString;
+                    featureDir: import("zod").ZodOptional<import("zod").ZodString>;
+                    claimType: import("zod").ZodOptional<import("zod").ZodEnum<{
+                        artifact: "artifact";
+                        "package-entrypoint": "package-entrypoint";
+                        historical: "historical";
+                    }>>;
+                }, import("zod/v4/core").$strip>>;
+            }, import("zod/v4/core").$strip>;
+            readonly output: import("zod").ZodObject<{
+                scannedFiles: import("zod").ZodNumber;
+                findings: import("zod").ZodNumber;
+                byKind: import("zod").ZodObject<{
+                    'doc-stale': import("zod").ZodNumber;
+                    'doc-structure': import("zod").ZodNumber;
+                    'likely-code-bug': import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>;
+                featureDirectories: import("zod").ZodNumber;
+            }, import("zod/v4/core").$strip>;
+        };
+    } | {
+        readonly kind: "tools/tool";
+        readonly id: "workspace-status";
+        readonly name: "Workspace Status";
+        readonly description: "Query status, health, and resource details of a cloud workspace";
+        readonly mcpDescription: "Query the current status, IP address, CPU/RAM, and TTL of a cloud workspace host.";
+        readonly hardware: ["consumer", "cloud"];
+        readonly purpose: ["mcp", "agent", "direct"];
+        readonly category: "workspace";
+        readonly subcategory: "monitoring";
+        readonly safety: "read";
+        readonly requiresApproval: false;
+        readonly tags: ["workspace", "cloud", "status", "health", "monitoring"];
+        readonly schemas: {
+            readonly input: import("zod").ZodObject<{
+                workspaceId: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>;
+            readonly output: import("zod").ZodObject<{
+                workspaceId: import("zod").ZodString;
+                status: import("zod").ZodString;
+                ip: import("zod").ZodOptional<import("zod").ZodString>;
+                cpu: import("zod").ZodOptional<import("zod").ZodNumber>;
+                ram: import("zod").ZodOptional<import("zod").ZodNumber>;
+                ttl: import("zod").ZodOptional<import("zod").ZodNumber>;
+                region: import("zod").ZodOptional<import("zod").ZodString>;
+                terminalUrl: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>;
+        };
+    } | {
+        readonly kind: "tools/tool";
+        readonly id: "workspace-exec";
+        readonly name: "Workspace Exec";
+        readonly description: "Execute a shell command inside a cloud workspace host";
+        readonly mcpDescription: "Execute a command on a remote cloud workspace host and return the stdout, stderr, and exit code.";
+        readonly hardware: ["consumer", "cloud"];
+        readonly purpose: ["mcp", "agent", "direct"];
+        readonly category: "workspace";
+        readonly subcategory: "execution";
+        readonly safety: "write";
+        readonly requiresApproval: true;
+        readonly tags: ["workspace", "cloud", "exec", "command", "remote"];
+        readonly schemas: {
+            readonly input: import("zod").ZodObject<{
+                workspaceId: import("zod").ZodString;
+                command: import("zod").ZodString;
+                args: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                cwd: import("zod").ZodOptional<import("zod").ZodString>;
+                env: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+                timeoutMs: import("zod").ZodOptional<import("zod").ZodNumber>;
+            }, import("zod/v4/core").$strip>;
+            readonly output: import("zod").ZodObject<{
+                exitCode: import("zod").ZodNumber;
+                stdout: import("zod").ZodString;
+                stderr: import("zod").ZodString;
+                timedOut: import("zod").ZodBoolean;
+            }, import("zod/v4/core").$strip>;
+        };
+    } | {
+        readonly kind: "tools/tool";
+        readonly id: "workspace-pull";
+        readonly name: "Workspace Pull";
+        readonly description: "Copy a file from a fleet host to a local path";
+        readonly mcpDescription: "Copy one file from a fleet host (for example a generated GLB, FBX or BVH) to a path on this runtime; returns its size and sha256.";
+        readonly hardware: ["consumer", "cloud"];
+        readonly purpose: ["mcp", "agent", "direct"];
+        readonly category: "workspace";
+        readonly subcategory: "execution";
+        readonly safety: "write";
+        readonly capability: {
+            readonly tier: "1";
+        };
+        readonly requiresApproval: true;
+        readonly tags: ["workspace", "cloud", "fleet", "file", "artifact", "remote"];
+        readonly schemas: {
+            readonly input: import("zod").ZodObject<{
+                workspaceId: import("zod").ZodString;
+                path: import("zod").ZodString;
+                destination: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>;
+            readonly output: import("zod").ZodObject<{
+                workspaceId: import("zod").ZodString;
+                path: import("zod").ZodString;
+                destination: import("zod").ZodString;
+                bytes: import("zod").ZodNumber;
+                sha256: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>;
+        };
+    })[];
+    loaders: import("@vibesdotdev/kernel").AssetLoader[];
+    remoteExposures: {
+        kindId: string;
+        assetId: string;
+        exposure: {
+            protocolVersion: 1;
+            discoverable: boolean;
+            audiences: ("service" | "operator" | "consumer-renderer" | "consumer-cli" | "consumer-agent")[];
+            methods: Record<string, {
+                request: {
+                    id: string;
+                    version: number;
+                    schema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+                };
+                result: {
+                    id: string;
+                    version: number;
+                    schema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+                };
+                dataClassification: "user" | "secret" | "public" | "sensitive";
+                rendererView: "denied" | "raw" | "redacted";
+                retry: {
+                    mode: "read";
+                    retry: "safe";
+                } | {
+                    mode: "idempotent";
+                    operationIdRequired: true;
+                    reconciliationMethod: string;
+                } | {
+                    mode: "non-idempotent";
+                    retry: "never";
+                };
+                cancellation: {
+                    mode: "required" | "none" | "cooperative";
+                    defaultDeadlineMs: number;
+                    maxDeadlineMs: number;
+                };
+                maxRequestBytes: number;
+                maxResultBytes: number;
+                projectRenderer?: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>> | undefined;
+                stream?: {
+                    event: {
+                        id: string;
+                        version: number;
+                        schema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+                    };
+                    maxEventBytes: number;
+                    initialCredits: number;
+                    maxCredits: number;
+                    projectRenderer?: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>> | undefined;
+                } | undefined;
+            }>;
+        };
+    }[];
+    onActivate(runtime: import("@vibesdotdev/kernel").RuntimeRef): Promise<void>;
+};
+declare const defaultExport: import("@vibesdotdev/kernel").RuntimePlugin;
+export default defaultExport;
+//# sourceMappingURL=tools.universal.plugin.d.ts.map