@finalai/agent-definition 0.1.0

package/dist/modules/runtime/described.d.mts

@@ -0,0 +1,376 @@
+import * as z from 'zod';
+import { SlotKind } from "./layout.mjs";
+import { IssueSeverity } from "./lower.mjs";
+export declare const issueSchema: z.ZodObject<{
+    severity: z.ZodEnum<typeof IssueSeverity>;
+    message: z.ZodString;
+}, z.core.$strip>;
+export declare const describedDynamicSchema: z.ZodObject<{
+    type: z.ZodLiteral<"dynamic">;
+    events: z.ZodArray<z.ZodString>;
+    description: z.ZodNullable<z.ZodString>;
+    preview: z.ZodNullable<z.ZodString>;
+    provider: z.ZodNullable<z.ZodObject<{
+        ref: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+        name: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const describedAgentSchema: z.ZodObject<{
+    type: z.ZodLiteral<"agent">;
+    name: z.ZodNullable<z.ZodString>;
+    description: z.ZodNullable<z.ZodString>;
+    avatarUrl: z.ZodNullable<z.ZodString>;
+    harness: z.ZodNullable<z.ZodObject<{
+        harness: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+        config: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+    }, z.core.$strip>>;
+    tools: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
+    hostTools: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    toolPolicy: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
+    secrets: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    channels: z.ZodNullable<z.ZodArray<z.ZodObject<{
+        key: z.ZodNullable<z.ZodString>;
+        channel: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+        config: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const describedEnvironmentSchema: z.ZodObject<{
+    providerName: z.ZodString;
+    providerRef: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+    options: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+    openOptions: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+}, z.core.$strip>;
+declare const describedSandboxTargetSchema: z.ZodObject<{
+    exportName: z.ZodString;
+    environment: z.ZodNullable<z.ZodObject<{
+        providerName: z.ZodString;
+        providerRef: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+        options: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+        openOptions: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+    }, z.core.$strip>>;
+    dynamic: z.ZodNullable<z.ZodObject<{
+        type: z.ZodLiteral<"dynamic">;
+        events: z.ZodArray<z.ZodString>;
+        description: z.ZodNullable<z.ZodString>;
+        preview: z.ZodNullable<z.ZodString>;
+        provider: z.ZodNullable<z.ZodObject<{
+            ref: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+            name: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const describedSandboxSchema: z.ZodObject<{
+    type: z.ZodLiteral<"sandbox">;
+    targets: z.ZodRecord<z.ZodString, z.ZodObject<{
+        exportName: z.ZodString;
+        environment: z.ZodNullable<z.ZodObject<{
+            providerName: z.ZodString;
+            providerRef: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+            options: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+            openOptions: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+        }, z.core.$strip>>;
+        dynamic: z.ZodNullable<z.ZodObject<{
+            type: z.ZodLiteral<"dynamic">;
+            events: z.ZodArray<z.ZodString>;
+            description: z.ZodNullable<z.ZodString>;
+            preview: z.ZodNullable<z.ZodString>;
+            provider: z.ZodNullable<z.ZodObject<{
+                ref: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+                name: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    providers: z.ZodRecord<z.ZodString, z.ZodString>;
+    selector: z.ZodBoolean;
+    defaultTarget: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const describedValueSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"agent">;
+    name: z.ZodNullable<z.ZodString>;
+    description: z.ZodNullable<z.ZodString>;
+    avatarUrl: z.ZodNullable<z.ZodString>;
+    harness: z.ZodNullable<z.ZodObject<{
+        harness: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+        config: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+    }, z.core.$strip>>;
+    tools: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
+    hostTools: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    toolPolicy: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
+    secrets: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    channels: z.ZodNullable<z.ZodArray<z.ZodObject<{
+        key: z.ZodNullable<z.ZodString>;
+        channel: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+        config: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"dynamic">;
+    events: z.ZodArray<z.ZodString>;
+    description: z.ZodNullable<z.ZodString>;
+    preview: z.ZodNullable<z.ZodString>;
+    provider: z.ZodNullable<z.ZodObject<{
+        ref: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+        name: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"instructions">;
+    role: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"skill">;
+    skill: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool">;
+    descriptor: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+    approval: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"connection">;
+    binding: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"schedule">;
+    cron: z.ZodNullable<z.ZodString>;
+    markdown: z.ZodNullable<z.ZodString>;
+    timezone: z.ZodNullable<z.ZodString>;
+    target: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"hook">;
+    keys: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"channel">;
+    routes: z.ZodArray<z.ZodObject<{
+        method: z.ZodString;
+        path: z.ZodString;
+    }, z.core.$strip>>;
+    turnPolicy: z.ZodNullable<z.ZodString>;
+    config: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+    disabled: z.ZodDefault<z.ZodBoolean>;
+    installed: z.ZodDefault<z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"sandbox">;
+    targets: z.ZodRecord<z.ZodString, z.ZodObject<{
+        exportName: z.ZodString;
+        environment: z.ZodNullable<z.ZodObject<{
+            providerName: z.ZodString;
+            providerRef: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+            options: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+            openOptions: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+        }, z.core.$strip>>;
+        dynamic: z.ZodNullable<z.ZodObject<{
+            type: z.ZodLiteral<"dynamic">;
+            events: z.ZodArray<z.ZodString>;
+            description: z.ZodNullable<z.ZodString>;
+            preview: z.ZodNullable<z.ZodString>;
+            provider: z.ZodNullable<z.ZodObject<{
+                ref: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+                name: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    providers: z.ZodRecord<z.ZodString, z.ZodString>;
+    selector: z.ZodBoolean;
+    defaultTarget: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>], "type">;
+export declare const describedModuleSchema: z.ZodObject<{
+    base: z.ZodString;
+    path: z.ZodString;
+    slot: z.ZodEnum<typeof SlotKind>;
+    key: z.ZodString;
+    hasDefault: z.ZodBoolean;
+    issues: z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<typeof IssueSeverity>;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+    value: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"agent">;
+        name: z.ZodNullable<z.ZodString>;
+        description: z.ZodNullable<z.ZodString>;
+        avatarUrl: z.ZodNullable<z.ZodString>;
+        harness: z.ZodNullable<z.ZodObject<{
+            harness: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+            config: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+        }, z.core.$strip>>;
+        tools: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
+        hostTools: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        toolPolicy: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
+        secrets: z.ZodNullable<z.ZodArray<z.ZodString>>;
+        channels: z.ZodNullable<z.ZodArray<z.ZodObject<{
+            key: z.ZodNullable<z.ZodString>;
+            channel: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+            config: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"dynamic">;
+        events: z.ZodArray<z.ZodString>;
+        description: z.ZodNullable<z.ZodString>;
+        preview: z.ZodNullable<z.ZodString>;
+        provider: z.ZodNullable<z.ZodObject<{
+            ref: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+            name: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"instructions">;
+        role: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"skill">;
+        skill: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool">;
+        descriptor: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+        approval: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"connection">;
+        binding: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"schedule">;
+        cron: z.ZodNullable<z.ZodString>;
+        markdown: z.ZodNullable<z.ZodString>;
+        timezone: z.ZodNullable<z.ZodString>;
+        target: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"hook">;
+        keys: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"channel">;
+        routes: z.ZodArray<z.ZodObject<{
+            method: z.ZodString;
+            path: z.ZodString;
+        }, z.core.$strip>>;
+        turnPolicy: z.ZodNullable<z.ZodString>;
+        config: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+        disabled: z.ZodDefault<z.ZodBoolean>;
+        installed: z.ZodDefault<z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"sandbox">;
+        targets: z.ZodRecord<z.ZodString, z.ZodObject<{
+            exportName: z.ZodString;
+            environment: z.ZodNullable<z.ZodObject<{
+                providerName: z.ZodString;
+                providerRef: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+                options: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+                openOptions: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+            }, z.core.$strip>>;
+            dynamic: z.ZodNullable<z.ZodObject<{
+                type: z.ZodLiteral<"dynamic">;
+                events: z.ZodArray<z.ZodString>;
+                description: z.ZodNullable<z.ZodString>;
+                preview: z.ZodNullable<z.ZodString>;
+                provider: z.ZodNullable<z.ZodObject<{
+                    ref: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+                    name: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        providers: z.ZodRecord<z.ZodString, z.ZodString>;
+        selector: z.ZodBoolean;
+        defaultTarget: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>], "type">>;
+}, z.core.$strip>;
+export declare const describedBundleSchema: z.ZodObject<{
+    modules: z.ZodArray<z.ZodObject<{
+        base: z.ZodString;
+        path: z.ZodString;
+        slot: z.ZodEnum<typeof SlotKind>;
+        key: z.ZodString;
+        hasDefault: z.ZodBoolean;
+        issues: z.ZodArray<z.ZodObject<{
+            severity: z.ZodEnum<typeof IssueSeverity>;
+            message: z.ZodString;
+        }, z.core.$strip>>;
+        value: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"agent">;
+            name: z.ZodNullable<z.ZodString>;
+            description: z.ZodNullable<z.ZodString>;
+            avatarUrl: z.ZodNullable<z.ZodString>;
+            harness: z.ZodNullable<z.ZodObject<{
+                harness: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+                config: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+            }, z.core.$strip>>;
+            tools: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
+            hostTools: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+            toolPolicy: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
+            secrets: z.ZodNullable<z.ZodArray<z.ZodString>>;
+            channels: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                key: z.ZodNullable<z.ZodString>;
+                channel: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+                config: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"dynamic">;
+            events: z.ZodArray<z.ZodString>;
+            description: z.ZodNullable<z.ZodString>;
+            preview: z.ZodNullable<z.ZodString>;
+            provider: z.ZodNullable<z.ZodObject<{
+                ref: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+                name: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"instructions">;
+            role: z.ZodString;
+            content: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"skill">;
+            skill: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"tool">;
+            descriptor: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+            approval: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"connection">;
+            binding: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"schedule">;
+            cron: z.ZodNullable<z.ZodString>;
+            markdown: z.ZodNullable<z.ZodString>;
+            timezone: z.ZodNullable<z.ZodString>;
+            target: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"hook">;
+            keys: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"channel">;
+            routes: z.ZodArray<z.ZodObject<{
+                method: z.ZodString;
+                path: z.ZodString;
+            }, z.core.$strip>>;
+            turnPolicy: z.ZodNullable<z.ZodString>;
+            config: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+            disabled: z.ZodDefault<z.ZodBoolean>;
+            installed: z.ZodDefault<z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"sandbox">;
+            targets: z.ZodRecord<z.ZodString, z.ZodObject<{
+                exportName: z.ZodString;
+                environment: z.ZodNullable<z.ZodObject<{
+                    providerName: z.ZodString;
+                    providerRef: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+                    options: z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>;
+                    openOptions: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+                }, z.core.$strip>>;
+                dynamic: z.ZodNullable<z.ZodObject<{
+                    type: z.ZodLiteral<"dynamic">;
+                    events: z.ZodArray<z.ZodString>;
+                    description: z.ZodNullable<z.ZodString>;
+                    preview: z.ZodNullable<z.ZodString>;
+                    provider: z.ZodNullable<z.ZodObject<{
+                        ref: z.ZodNullable<z.ZodType<import("@finalai/agent-provider").JsonValue, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonValue, unknown>>>;
+                        name: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            providers: z.ZodRecord<z.ZodString, z.ZodString>;
+            selector: z.ZodBoolean;
+            defaultTarget: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>], "type">>;
+    }, z.core.$strip>>;
+    synthesized: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type DescribedIssueIface = z.infer<typeof issueSchema>;
+export type DescribedDynamicIface = z.infer<typeof describedDynamicSchema>;
+export type DescribedAgentIface = z.infer<typeof describedAgentSchema>;
+export type DescribedSandboxIface = z.infer<typeof describedSandboxSchema>;
+export type DescribedSandboxTargetIface = z.infer<typeof describedSandboxTargetSchema>;
+export type DescribedEnvironmentIface = z.infer<typeof describedEnvironmentSchema>;
+export type DescribedValue = z.infer<typeof describedValueSchema>;
+export type DescribedModuleIface = z.infer<typeof describedModuleSchema>;
+export type DescribedBundleIface = z.infer<typeof describedBundleSchema>;
+export {};

package/dist/modules/runtime/described.mjs

@@ -0,0 +1,116 @@
+import { jsonValueSchema } from "@finalai/agent-provider";
+import * as z from "zod";
+import { SlotKind } from "./layout.mjs";
+import { IssueSeverity } from "./lower.mjs";
+const issueSchema = z.object({ severity: z.nativeEnum(IssueSeverity), message: z.string() });
+const providerHintSchema = z.object({
+  ref: jsonValueSchema.nullable(),
+  name: z.string().nullable()
+});
+const describedDynamicSchema = z.object({
+  type: z.literal("dynamic"),
+  events: z.array(z.string()),
+  description: z.string().nullable(),
+  preview: z.string().nullable(),
+  provider: providerHintSchema.nullable()
+});
+const describedAgentSchema = z.object({
+  type: z.literal("agent"),
+  name: z.string().nullable(),
+  description: z.string().nullable(),
+  avatarUrl: z.string().nullable(),
+  harness: z.object({ harness: jsonValueSchema, config: jsonValueSchema }).nullable(),
+  tools: z.record(z.string(), z.string()).nullable(),
+  // Capabilities bound to `harnessHost` (the harness's own host, no target).
+  hostTools: z.array(z.string()).nullable().default(null),
+  toolPolicy: z.record(z.string(), z.string()).nullable(),
+  secrets: z.array(z.string()).nullable(),
+  channels: z.array(
+    z.object({ key: z.string().nullable(), channel: jsonValueSchema, config: jsonValueSchema })
+  ).nullable()
+});
+const describedInstructionsSchema = z.object({
+  type: z.literal("instructions"),
+  role: z.string(),
+  content: z.string()
+});
+const describedSkillSchema = z.object({ type: z.literal("skill"), skill: jsonValueSchema });
+const describedToolSchema = z.object({
+  type: z.literal("tool"),
+  descriptor: jsonValueSchema,
+  approval: z.string()
+});
+const describedConnectionSchema = z.object({
+  type: z.literal("connection"),
+  binding: jsonValueSchema
+});
+const describedScheduleSchema = z.object({
+  type: z.literal("schedule"),
+  cron: z.string().nullable(),
+  markdown: z.string().nullable(),
+  timezone: z.string().nullable(),
+  target: z.string().nullable()
+});
+const describedHookSchema = z.object({ type: z.literal("hook"), keys: z.array(z.string()) });
+const describedChannelSchema = z.object({
+  type: z.literal("channel"),
+  routes: z.array(z.object({ method: z.string(), path: z.string() })),
+  turnPolicy: z.string().nullable(),
+  config: jsonValueSchema,
+  disabled: z.boolean().default(false),
+  installed: jsonValueSchema.nullable().default(null)
+});
+const describedEnvironmentSchema = z.object({
+  providerName: z.string(),
+  providerRef: jsonValueSchema.nullable(),
+  options: jsonValueSchema,
+  openOptions: jsonValueSchema.nullable()
+});
+const describedSandboxTargetSchema = z.object({
+  exportName: z.string(),
+  environment: describedEnvironmentSchema.nullable(),
+  dynamic: describedDynamicSchema.nullable()
+});
+const describedSandboxSchema = z.object({
+  type: z.literal("sandbox"),
+  targets: z.record(z.string(), describedSandboxTargetSchema),
+  // Bundle export name → provider name, for providers defined in sandbox.ts.
+  providers: z.record(z.string(), z.string()),
+  selector: z.boolean(),
+  defaultTarget: z.string().nullable()
+});
+const describedValueSchema = z.discriminatedUnion("type", [
+  describedAgentSchema,
+  describedDynamicSchema,
+  describedInstructionsSchema,
+  describedSkillSchema,
+  describedToolSchema,
+  describedConnectionSchema,
+  describedScheduleSchema,
+  describedHookSchema,
+  describedChannelSchema,
+  describedSandboxSchema
+]);
+const describedModuleSchema = z.object({
+  base: z.string(),
+  path: z.string(),
+  slot: z.nativeEnum(SlotKind),
+  key: z.string(),
+  hasDefault: z.boolean(),
+  issues: z.array(issueSchema),
+  value: describedValueSchema.nullable()
+});
+const describedBundleSchema = z.object({
+  modules: z.array(describedModuleSchema),
+  // Exports the bundle synthesizes beyond the authored ones.
+  synthesized: z.array(z.string())
+});
+export {
+  describedBundleSchema,
+  describedDynamicSchema,
+  describedEnvironmentSchema,
+  describedModuleSchema,
+  describedValueSchema,
+  issueSchema
+};
+//# sourceMappingURL=described.mjs.map

package/dist/modules/runtime/described.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/runtime/described.ts"],
+  "sourcesContent": ["import { jsonValueSchema } from '@finalai/agent-provider';\nimport * as z from 'zod';\nimport { SlotKind } from \"./layout.mjs\";\nimport { IssueSeverity } from \"./lower.mjs\";\n\n// The static description of a bundle's authored modules, produced inside the\n// evaluation realm and parsed by the compiler. Everything is JSON.\n\nexport const issueSchema = z.object({ severity: z.nativeEnum(IssueSeverity), message: z.string() });\n\nconst providerHintSchema = z.object({\n  ref: jsonValueSchema.nullable(),\n  name: z.string().nullable(),\n});\n\nexport const describedDynamicSchema = z.object({\n  type: z.literal('dynamic'),\n  events: z.array(z.string()),\n  description: z.string().nullable(),\n  preview: z.string().nullable(),\n  provider: providerHintSchema.nullable(),\n});\n\nconst describedAgentSchema = z.object({\n  type: z.literal('agent'),\n  name: z.string().nullable(),\n  description: z.string().nullable(),\n  avatarUrl: z.string().nullable(),\n  harness: z.object({ harness: jsonValueSchema, config: jsonValueSchema }).nullable(),\n  tools: z.record(z.string(), z.string()).nullable(),\n  // Capabilities bound to `harnessHost` (the harness's own host, no target).\n  hostTools: z.array(z.string()).nullable().default(null),\n  toolPolicy: z.record(z.string(), z.string()).nullable(),\n  secrets: z.array(z.string()).nullable(),\n  channels: z\n    .array(\n      z.object({ key: z.string().nullable(), channel: jsonValueSchema, config: jsonValueSchema }),\n    )\n    .nullable(),\n});\n\nconst describedInstructionsSchema = z.object({\n  type: z.literal('instructions'),\n  role: z.string(),\n  content: z.string(),\n});\n\nconst describedSkillSchema = z.object({ type: z.literal('skill'), skill: jsonValueSchema });\n\nconst describedToolSchema = z.object({\n  type: z.literal('tool'),\n  descriptor: jsonValueSchema,\n  approval: z.string(),\n});\n\nconst describedConnectionSchema = z.object({\n  type: z.literal('connection'),\n  binding: jsonValueSchema,\n});\n\nconst describedScheduleSchema = z.object({\n  type: z.literal('schedule'),\n  cron: z.string().nullable(),\n  markdown: z.string().nullable(),\n  timezone: z.string().nullable(),\n  target: z.string().nullable(),\n});\n\nconst describedHookSchema = z.object({ type: z.literal('hook'), keys: z.array(z.string()) });\n\nconst describedChannelSchema = z.object({\n  type: z.literal('channel'),\n  routes: z.array(z.object({ method: z.string(), path: z.string() })),\n  turnPolicy: z.string().nullable(),\n  config: jsonValueSchema,\n  disabled: z.boolean().default(false),\n  installed: jsonValueSchema.nullable().default(null),\n});\n\nexport const describedEnvironmentSchema = z.object({\n  providerName: z.string(),\n  providerRef: jsonValueSchema.nullable(),\n  options: jsonValueSchema,\n  openOptions: jsonValueSchema.nullable(),\n});\n\nconst describedSandboxTargetSchema = z.object({\n  exportName: z.string(),\n  environment: describedEnvironmentSchema.nullable(),\n  dynamic: describedDynamicSchema.nullable(),\n});\n\nconst describedSandboxSchema = z.object({\n  type: z.literal('sandbox'),\n  targets: z.record(z.string(), describedSandboxTargetSchema),\n  // Bundle export name \u2192 provider name, for providers defined in sandbox.ts.\n  providers: z.record(z.string(), z.string()),\n  selector: z.boolean(),\n  defaultTarget: z.string().nullable(),\n});\n\nexport const describedValueSchema = z.discriminatedUnion('type', [\n  describedAgentSchema,\n  describedDynamicSchema,\n  describedInstructionsSchema,\n  describedSkillSchema,\n  describedToolSchema,\n  describedConnectionSchema,\n  describedScheduleSchema,\n  describedHookSchema,\n  describedChannelSchema,\n  describedSandboxSchema,\n]);\n\nexport const describedModuleSchema = z.object({\n  base: z.string(),\n  path: z.string(),\n  slot: z.nativeEnum(SlotKind),\n  key: z.string(),\n  hasDefault: z.boolean(),\n  issues: z.array(issueSchema),\n  value: describedValueSchema.nullable(),\n});\n\nexport const describedBundleSchema = z.object({\n  modules: z.array(describedModuleSchema),\n  // Exports the bundle synthesizes beyond the authored ones.\n  synthesized: z.array(z.string()),\n});\n\nexport type DescribedIssueIface = z.infer<typeof issueSchema>;\nexport type DescribedDynamicIface = z.infer<typeof describedDynamicSchema>;\nexport type DescribedAgentIface = z.infer<typeof describedAgentSchema>;\nexport type DescribedSandboxIface = z.infer<typeof describedSandboxSchema>;\nexport type DescribedSandboxTargetIface = z.infer<typeof describedSandboxTargetSchema>;\nexport type DescribedEnvironmentIface = z.infer<typeof describedEnvironmentSchema>;\nexport type DescribedValue = z.infer<typeof describedValueSchema>;\nexport type DescribedModuleIface = z.infer<typeof describedModuleSchema>;\nexport type DescribedBundleIface = z.infer<typeof describedBundleSchema>;\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/runtime/isolate.d.mts

@@ -0,0 +1,70 @@
+import { DynamicEvent, ToolApproval, type ChannelReceiveResult, type ChannelSocketIface, type InputApprovalIface, type JsonObject, type JsonValue } from '@finalai/agent-provider';
+import { type DynamicResolveContextIface, type ToolContextIface } from "../authoring/context.mjs";
+import type { DynamicBoundaryEventIface } from "../authoring/dynamic.mjs";
+import { type HookContextIface, type HookDispatchEventIface } from "../authoring/hooks.mjs";
+import { type AuthoredRecord, type AuthoredValue } from "./values.mjs";
+export interface RunToolArgsIface {
+    export: string;
+    input: AuthoredValue;
+    dynamic?: JsonValue;
+    ctx: ToolContextIface;
+    onProgress?: (value: JsonValue, label?: string) => void;
+}
+export interface RunToolResultIface {
+    output: JsonValue;
+    modelOutput: JsonValue | null;
+}
+export interface ResolveDynamicArgsIface {
+    export: string;
+    event: DynamicEvent;
+    payload: DynamicBoundaryEventIface;
+    ctx: DynamicResolveContextIface;
+    key?: string;
+}
+export interface DispatchHookArgsIface {
+    export: string;
+    event: HookDispatchEventIface;
+    ctx: HookContextIface;
+}
+export interface HookFailureIface {
+    message: string;
+}
+export interface ChannelRouteArgsIface {
+    export: string;
+    request: Request;
+    configuration?: JsonObject;
+    path: string;
+    secrets: {
+        get(name: string): Promise<string | null>;
+    };
+    receive: (input: JsonValue) => Promise<ChannelReceiveResult>;
+}
+export interface ChannelSocketArgsIface extends ChannelRouteArgsIface {
+    socket: ChannelSocketIface;
+}
+export interface IsolateRuntimeIface {
+    evaluateApproval(args: {
+        reference: InputApprovalIface;
+        input: AuthoredValue;
+        secrets: {
+            get(name: string): Promise<string | null>;
+        };
+    }): Promise<ToolApproval>;
+    runTool(args: RunToolArgsIface): Promise<RunToolResultIface>;
+    resolveDynamic(args: ResolveDynamicArgsIface): Promise<JsonValue | null>;
+    dispatchHook(args: DispatchHookArgsIface): Promise<{
+        handled: number;
+        failures: HookFailureIface[];
+    }>;
+    handleChannelRoute(args: ChannelRouteArgsIface): Promise<Response | null>;
+    handleChannelSocket(args: ChannelSocketArgsIface): Promise<Response | void | null>;
+}
+export declare const lowerResolvedValue: (value: AuthoredValue, key: string) => JsonValue | null;
+export interface CombinedEntryIface {
+    kind: 'tool' | 'connection';
+    key: string;
+    exportName: string;
+    value: AuthoredValue;
+}
+export declare const combineMcpServers: (entries: CombinedEntryIface[]) => AuthoredValue;
+export declare const createIsolateRuntime: (modules: AuthoredRecord) => IsolateRuntimeIface;