@fungi.computer/nacre 0.0.0-stage → 0.0.1

package/dist/app-directory.d.ts

@@ -0,0 +1,600 @@
+import * as Schema from "effect/Schema";
+import { appDeclaredGillSchema } from "@fungi.computer/gills";
+import * as z from "zod";
+/** An App address selects a host default or a specific installation. */
+export declare const appAddressSchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
+    kind: z.ZodLiteral<"default">;
+    appId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"installation">;
+    installationId: z.ZodString;
+}, z.core.$strict>]>>;
+/** Host-reported progress of applying a revised App authority version. */
+export declare const appAuthorityEnforcementSchema: z.ZodLazy<z.ZodObject<{
+    requestId: z.ZodString;
+    address: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"default">;
+        appId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"installation">;
+        installationId: z.ZodString;
+    }, z.core.$strict>]>>;
+    authorityVersion: z.ZodNumber;
+    state: z.ZodEnum<{
+        /** The change needs no delivery. */
+        readonly unaffected: "unaffected";
+        /** Some deliveries are still unconfirmed. */
+        readonly pending: "pending";
+        /** Every delivery was confirmed. */
+        readonly applied: "applied";
+        /** Nothing is outstanding, but not every delivery was confirmed. */
+        readonly expired: "expired";
+    }>;
+    outstanding: z.ZodNumber;
+}, z.core.$strict>>;
+/** Decoded address of a default App or an installation. */
+export type AppAddress = z.output<typeof appAddressSchema>;
+/** Stable identity of one App address across directory and settings views. */
+export declare const addressKey: (address: AppAddress) => string;
+/** A host-reported authority change and its remaining work. */
+export type AppAuthorityEnforcement = z.output<typeof appAuthorityEnforcementSchema>;
+/**
+ * A Release-declared Gill carried by the host's App directory. The named
+ * mapped type keeps consumer declarations attached to this public contract.
+ */
+export type AppDirectoryGill = {
+    [Field in keyof Schema.Schema.Type<typeof appDeclaredGillSchema>]: Schema.Schema.Type<typeof appDeclaredGillSchema>[Field];
+};
+/** Reusable App metadata supplied by an embedding host; it conveys no permissions. */
+export declare const appDirectoryEntrySchema: z.ZodObject<{
+    address: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"default">;
+        appId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"installation">;
+        installationId: z.ZodString;
+    }, z.core.$strict>]>>;
+    installationId: z.ZodNullable<z.ZodString>;
+    surfaceId: z.ZodString;
+    appId: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    releaseId: z.ZodNullable<z.ZodString>;
+    authorityVersion: z.ZodNumber;
+    enforcement: z.ZodNullable<z.ZodLazy<z.ZodObject<{
+        requestId: z.ZodString;
+        address: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"default">;
+            appId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"installation">;
+            installationId: z.ZodString;
+        }, z.core.$strict>]>>;
+        authorityVersion: z.ZodNumber;
+        state: z.ZodEnum<{
+            /** The change needs no delivery. */
+            readonly unaffected: "unaffected";
+            /** Some deliveries are still unconfirmed. */
+            readonly pending: "pending";
+            /** Every delivery was confirmed. */
+            readonly applied: "applied";
+            /** Nothing is outstanding, but not every delivery was confirmed. */
+            readonly expired: "expired";
+        }>;
+        outstanding: z.ZodNumber;
+    }, z.core.$strict>>>;
+    handlers: z.ZodArray<z.ZodLiteral<"file.open">>;
+    roles: z.ZodArray<z.ZodString>;
+    declaredCapabilities: z.ZodArray<z.ZodString>;
+    calls: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<readonly {
+        readonly appId: string;
+        readonly methods: readonly string[];
+    }[], unknown>>>;
+    commands: z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<Readonly<{
+        id: string;
+        title: string;
+        category: string;
+        description?: string | undefined;
+        sigil?: string | undefined;
+        projections?: Readonly<{
+            bindings?: (Readonly<{
+                order?: number | undefined;
+            }> & Readonly<{
+                values: readonly string[];
+            }>) | undefined;
+            agent?: (Readonly<{
+                order?: number | undefined;
+            }> & Readonly<{
+                keybind?: string | undefined;
+            }>) | undefined;
+            help?: Readonly<{
+                order?: number | undefined;
+            }> | undefined;
+            menu?: Readonly<{
+                order?: number | undefined;
+            }> | undefined;
+            palette?: Readonly<{
+                order?: number | undefined;
+            }> | undefined;
+            slash?: (Readonly<{
+                order?: number | undefined;
+            }> & Readonly<{
+                aliases: readonly string[];
+            }>) | undefined;
+        }> | undefined;
+    }>[], unknown[]>>;
+    gills: z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<AppDirectoryGill[], unknown[]>>;
+    availability: z.ZodEnum<{
+        /** The App can be opened. */
+        readonly available: "available";
+        /** The App cannot be opened now. */
+        readonly unavailable: "unavailable";
+    }>;
+    surface: z.ZodNullable<z.ZodObject<{
+        stableRoute: z.ZodString;
+    }, z.core.$strict>>;
+    surfacePath: z.ZodString;
+}, z.core.$strict>;
+/** An App directory row before host-specific permissions are attached. */
+export type AppDirectoryEntry = z.output<typeof appDirectoryEntrySchema>;
+/** A host-resolved role selection; a surface address is not launch authority. */
+export declare const appRoleSelectionSchema: z.ZodObject<{
+    surfaceId: z.ZodNullable<z.ZodString>;
+    chosen: z.ZodBoolean;
+}, z.core.$strict>;
+/** App Computer permissions limited to selected Computers or the Team's Computers. */
+export declare const appComputerPermissionSchema: z.ZodDiscriminatedUnion<[z.ZodLazy<z.ZodObject<{
+    kind: z.ZodLiteral<"selected-computers">;
+    computers: z.ZodArray<z.ZodObject<{
+        computerId: z.ZodString;
+        operations: z.ZodArray<z.ZodEnum<{
+            /** List the Team's Computers. */
+            readonly "computer.list": "computer.list";
+            /** Read a file on a Computer. */
+            readonly "computer.readFile": "computer.readFile";
+            /** Write a file on a Computer. */
+            readonly "computer.writeFile": "computer.writeFile";
+            /** Run a command on a Computer. */
+            readonly "computer.execute": "computer.execute";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>>, z.ZodLazy<z.ZodObject<{
+    kind: z.ZodLiteral<"all-team-computers">;
+    operations: z.ZodArray<z.ZodEnum<{
+        /** List the Team's Computers. */
+        readonly "computer.list": "computer.list";
+        /** Read a file on a Computer. */
+        readonly "computer.readFile": "computer.readFile";
+        /** Write a file on a Computer. */
+        readonly "computer.writeFile": "computer.writeFile";
+        /** Run a command on a Computer. */
+        readonly "computer.execute": "computer.execute";
+    }>>;
+}, z.core.$strict>>], "kind">;
+/** One operation an App may request for a Computer. */
+export type AppComputerOperation = Extract<z.output<typeof appComputerPermissionSchema>, {
+    /** The permission that covers all of the Team's Computers. */
+    kind: "all-team-computers";
+}>["operations"][number];
+/** Decoded Computer permission scope attached to an App directory entry. */
+export type AppComputerPermission = z.output<typeof appComputerPermissionSchema>;
+/** Agent directory and session operations an App may request from its host. */
+export declare const appAgentPermissionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"all-team-agents">;
+    directoryOperations: z.ZodArray<z.ZodEnum<{
+        /** List the Team's agents. */
+        readonly "agent.list": "agent.list";
+    }>>;
+    sessionOperations: z.ZodArray<z.ZodEnum<{
+        /** Read an agent's session. */
+        readonly "agent.read": "agent.read";
+        /** Send a message in an agent's session. */
+        readonly "agent.send": "agent.send";
+        /** Manage an agent's session. */
+        readonly "agent.manage": "agent.manage";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"selected-agents">;
+    directoryOperations: z.ZodArray<z.ZodEnum<{
+        /** List the Team's agents. */
+        readonly "agent.list": "agent.list";
+    }>>;
+    agents: z.ZodArray<z.ZodObject<{
+        agentId: z.ZodString;
+        sessionOperations: z.ZodArray<z.ZodEnum<{
+            /** Read an agent's session. */
+            readonly "agent.read": "agent.read";
+            /** Send a message in an agent's session. */
+            readonly "agent.send": "agent.send";
+            /** Manage an agent's session. */
+            readonly "agent.manage": "agent.manage";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>], "kind">;
+/** Decoded Agent permission scope attached to an App directory entry. */
+export type AppAgentPermission = z.output<typeof appAgentPermissionSchema>;
+/** Whether an App may use language-model and media generation services. */
+export declare const appGenerationPermissionsSchema: z.ZodObject<{
+    llm: z.ZodBoolean;
+    media: z.ZodBoolean;
+}, z.core.$strict>;
+/** Decoded generation permissions attached to an App directory entry. */
+export type AppGenerationPermissions = z.output<typeof appGenerationPermissionsSchema>;
+/** Whether an App may browse, buy, or install free marketplace entries. */
+export declare const appMarketplacePermissionsSchema: z.ZodObject<{
+    browse: z.ZodBoolean;
+    purchase: z.ZodBoolean;
+    installFree: z.ZodBoolean;
+}, z.core.$strict>;
+/** Decoded marketplace permissions attached to an App directory entry. */
+export type AppMarketplacePermissions = z.output<typeof appMarketplacePermissionsSchema>;
+/**
+ * A host's Team App directory with its permission projection, parsed strictly
+ * by every consumer: an unknown field is a contract change both sides make.
+ */
+export declare const appDirectoryResponseSchema: z.ZodLazy<z.ZodObject<{
+    actorIsTeamOwner: z.ZodBoolean;
+    needsUpdate: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        installationId: z.ZodNullable<z.ZodString>;
+        appId: z.ZodNullable<z.ZodString>;
+        displayName: z.ZodString;
+    }, z.core.$strict>>>;
+    apps: z.ZodArray<z.ZodObject<{
+        address: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"default">;
+            appId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"installation">;
+            installationId: z.ZodString;
+        }, z.core.$strict>]>>;
+        installationId: z.ZodNullable<z.ZodString>;
+        surfaceId: z.ZodString;
+        appId: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        releaseId: z.ZodNullable<z.ZodString>;
+        authorityVersion: z.ZodNumber;
+        enforcement: z.ZodNullable<z.ZodLazy<z.ZodObject<{
+            requestId: z.ZodString;
+            address: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
+                kind: z.ZodLiteral<"default">;
+                appId: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"installation">;
+                installationId: z.ZodString;
+            }, z.core.$strict>]>>;
+            authorityVersion: z.ZodNumber;
+            state: z.ZodEnum<{
+                /** The change needs no delivery. */
+                readonly unaffected: "unaffected";
+                /** Some deliveries are still unconfirmed. */
+                readonly pending: "pending";
+                /** Every delivery was confirmed. */
+                readonly applied: "applied";
+                /** Nothing is outstanding, but not every delivery was confirmed. */
+                readonly expired: "expired";
+            }>;
+            outstanding: z.ZodNumber;
+        }, z.core.$strict>>>;
+        handlers: z.ZodArray<z.ZodLiteral<"file.open">>;
+        roles: z.ZodArray<z.ZodString>;
+        declaredCapabilities: z.ZodArray<z.ZodString>;
+        calls: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<readonly {
+            readonly appId: string;
+            readonly methods: readonly string[];
+        }[], unknown>>>;
+        commands: z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<Readonly<{
+            id: string;
+            title: string;
+            category: string;
+            description?: string | undefined;
+            sigil?: string | undefined;
+            projections?: Readonly<{
+                bindings?: (Readonly<{
+                    order?: number | undefined;
+                }> & Readonly<{
+                    values: readonly string[];
+                }>) | undefined;
+                agent?: (Readonly<{
+                    order?: number | undefined;
+                }> & Readonly<{
+                    keybind?: string | undefined;
+                }>) | undefined;
+                help?: Readonly<{
+                    order?: number | undefined;
+                }> | undefined;
+                menu?: Readonly<{
+                    order?: number | undefined;
+                }> | undefined;
+                palette?: Readonly<{
+                    order?: number | undefined;
+                }> | undefined;
+                slash?: (Readonly<{
+                    order?: number | undefined;
+                }> & Readonly<{
+                    aliases: readonly string[];
+                }>) | undefined;
+            }> | undefined;
+        }>[], unknown[]>>;
+        gills: z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<AppDirectoryGill[], unknown[]>>;
+        availability: z.ZodEnum<{
+            /** The App can be opened. */
+            readonly available: "available";
+            /** The App cannot be opened now. */
+            readonly unavailable: "unavailable";
+        }>;
+        surface: z.ZodNullable<z.ZodObject<{
+            stableRoute: z.ZodString;
+        }, z.core.$strict>>;
+        surfacePath: z.ZodString;
+        override: z.ZodNullable<z.ZodObject<{
+            appId: z.ZodOptional<z.ZodString>;
+            releaseId: z.ZodString;
+            surfaceRoute: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        grants: z.ZodArray<z.ZodObject<{
+            operation: z.ZodString;
+            resourceId: z.ZodString;
+        }, z.core.$strict>>;
+        computerPermission: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodLazy<z.ZodObject<{
+            kind: z.ZodLiteral<"selected-computers">;
+            computers: z.ZodArray<z.ZodObject<{
+                computerId: z.ZodString;
+                operations: z.ZodArray<z.ZodEnum<{
+                    /** List the Team's Computers. */
+                    readonly "computer.list": "computer.list";
+                    /** Read a file on a Computer. */
+                    readonly "computer.readFile": "computer.readFile";
+                    /** Write a file on a Computer. */
+                    readonly "computer.writeFile": "computer.writeFile";
+                    /** Run a command on a Computer. */
+                    readonly "computer.execute": "computer.execute";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>, z.ZodLazy<z.ZodObject<{
+            kind: z.ZodLiteral<"all-team-computers">;
+            operations: z.ZodArray<z.ZodEnum<{
+                /** List the Team's Computers. */
+                readonly "computer.list": "computer.list";
+                /** Read a file on a Computer. */
+                readonly "computer.readFile": "computer.readFile";
+                /** Write a file on a Computer. */
+                readonly "computer.writeFile": "computer.writeFile";
+                /** Run a command on a Computer. */
+                readonly "computer.execute": "computer.execute";
+            }>>;
+        }, z.core.$strict>>], "kind">>>;
+        generationPermissions: z.ZodObject<{
+            llm: z.ZodBoolean;
+            media: z.ZodBoolean;
+        }, z.core.$strict>;
+        marketplacePermissions: z.ZodObject<{
+            browse: z.ZodBoolean;
+            purchase: z.ZodBoolean;
+            installFree: z.ZodBoolean;
+        }, z.core.$strict>;
+        agentPermission: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"all-team-agents">;
+            directoryOperations: z.ZodArray<z.ZodEnum<{
+                /** List the Team's agents. */
+                readonly "agent.list": "agent.list";
+            }>>;
+            sessionOperations: z.ZodArray<z.ZodEnum<{
+                /** Read an agent's session. */
+                readonly "agent.read": "agent.read";
+                /** Send a message in an agent's session. */
+                readonly "agent.send": "agent.send";
+                /** Manage an agent's session. */
+                readonly "agent.manage": "agent.manage";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"selected-agents">;
+            directoryOperations: z.ZodArray<z.ZodEnum<{
+                /** List the Team's agents. */
+                readonly "agent.list": "agent.list";
+            }>>;
+            agents: z.ZodArray<z.ZodObject<{
+                agentId: z.ZodString;
+                sessionOperations: z.ZodArray<z.ZodEnum<{
+                    /** Read an agent's session. */
+                    readonly "agent.read": "agent.read";
+                    /** Send a message in an agent's session. */
+                    readonly "agent.send": "agent.send";
+                    /** Manage an agent's session. */
+                    readonly "agent.manage": "agent.manage";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>>;
+    roles: z.ZodRecord<z.ZodString, z.ZodObject<{
+        surfaceId: z.ZodNullable<z.ZodString>;
+        chosen: z.ZodBoolean;
+    }, z.core.$strict>>;
+}, z.core.$strict>>;
+/** The host-resolved Team App directory and its permission projections. */
+export type AppDirectory = z.output<typeof appDirectoryResponseSchema>;
+/** Read-only catalog metadata for one App, without host-specific role policy. */
+export declare const appCatalogEntrySchema: z.ZodObject<{
+    appId: z.ZodString;
+    surfaceId: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+    gills: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        params: z.ZodOptional<z.ZodLazy<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+            kind: z.ZodEnum<{
+                computer: "computer";
+                repository: "repository";
+                branch: "branch";
+            }>;
+            required: z.ZodBoolean;
+            options: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>> & z.ZodType<readonly {
+            readonly kind: "computer" | "repository" | "branch";
+            readonly required: boolean;
+            readonly key: string;
+            readonly label: string;
+            readonly options?: string | undefined;
+        }[], {
+            key: string;
+            label: string;
+            kind: "computer" | "repository" | "branch";
+            required: boolean;
+            options?: string | undefined;
+        }[], z.core.$ZodTypeInternals<readonly {
+            readonly kind: "computer" | "repository" | "branch";
+            readonly required: boolean;
+            readonly key: string;
+            readonly label: string;
+            readonly options?: string | undefined;
+        }[], {
+            key: string;
+            label: string;
+            kind: "computer" | "repository" | "branch";
+            required: boolean;
+            options?: string | undefined;
+        }[]>>>>;
+        desktop: z.ZodOptional<z.ZodObject<{
+            sizes: z.ZodArray<z.ZodEnum<{
+                /** Small: one dashboard cell. */
+                readonly S: "S";
+                /** Medium: two cells wide, one tall. */
+                readonly M: "M";
+                /** Large: two cells wide, two tall. */
+                readonly L: "L";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** Read-only desktop metadata; identities are surface addresses, never launch authority. */
+export declare const appCatalogResponseSchema: z.ZodLazy<z.ZodObject<{
+    apps: z.ZodArray<z.ZodObject<{
+        appId: z.ZodString;
+        surfaceId: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        gills: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            params: z.ZodOptional<z.ZodLazy<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                label: z.ZodString;
+                kind: z.ZodEnum<{
+                    computer: "computer";
+                    repository: "repository";
+                    branch: "branch";
+                }>;
+                required: z.ZodBoolean;
+                options: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>> & z.ZodType<readonly {
+                readonly kind: "computer" | "repository" | "branch";
+                readonly required: boolean;
+                readonly key: string;
+                readonly label: string;
+                readonly options?: string | undefined;
+            }[], {
+                key: string;
+                label: string;
+                kind: "computer" | "repository" | "branch";
+                required: boolean;
+                options?: string | undefined;
+            }[], z.core.$ZodTypeInternals<readonly {
+                readonly kind: "computer" | "repository" | "branch";
+                readonly required: boolean;
+                readonly key: string;
+                readonly label: string;
+                readonly options?: string | undefined;
+            }[], {
+                key: string;
+                label: string;
+                kind: "computer" | "repository" | "branch";
+                required: boolean;
+                options?: string | undefined;
+            }[]>>>>;
+            desktop: z.ZodOptional<z.ZodObject<{
+                sizes: z.ZodArray<z.ZodEnum<{
+                    /** Small: one dashboard cell. */
+                    readonly S: "S";
+                    /** Medium: two cells wide, one tall. */
+                    readonly M: "M";
+                    /** Large: two cells wide, two tall. */
+                    readonly L: "L";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    roles: z.ZodObject<{
+        inbox: z.ZodOptional<z.ZodObject<{
+            surfaceId: z.ZodNullable<z.ZodString>;
+            chosen: z.ZodBoolean;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>>;
+/** Parsed metadata returned by the read-only APPS.catalog binding. */
+export type AppCatalog = z.output<typeof appCatalogResponseSchema>;
+/** Complete APPS.catalog reply, including broker admission failures. */
+export declare const appCatalogBrokerResultSchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodLazy<z.ZodObject<{
+    apps: z.ZodArray<z.ZodObject<{
+        appId: z.ZodString;
+        surfaceId: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        gills: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            params: z.ZodOptional<z.ZodLazy<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                label: z.ZodString;
+                kind: z.ZodEnum<{
+                    computer: "computer";
+                    repository: "repository";
+                    branch: "branch";
+                }>;
+                required: z.ZodBoolean;
+                options: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>> & z.ZodType<readonly {
+                readonly kind: "computer" | "repository" | "branch";
+                readonly required: boolean;
+                readonly key: string;
+                readonly label: string;
+                readonly options?: string | undefined;
+            }[], {
+                key: string;
+                label: string;
+                kind: "computer" | "repository" | "branch";
+                required: boolean;
+                options?: string | undefined;
+            }[], z.core.$ZodTypeInternals<readonly {
+                readonly kind: "computer" | "repository" | "branch";
+                readonly required: boolean;
+                readonly key: string;
+                readonly label: string;
+                readonly options?: string | undefined;
+            }[], {
+                key: string;
+                label: string;
+                kind: "computer" | "repository" | "branch";
+                required: boolean;
+                options?: string | undefined;
+            }[]>>>>;
+            desktop: z.ZodOptional<z.ZodObject<{
+                sizes: z.ZodArray<z.ZodEnum<{
+                    /** Small: one dashboard cell. */
+                    readonly S: "S";
+                    /** Medium: two cells wide, one tall. */
+                    readonly M: "M";
+                    /** Large: two cells wide, two tall. */
+                    readonly L: "L";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    roles: z.ZodObject<{
+        inbox: z.ZodOptional<z.ZodObject<{
+            surfaceId: z.ZodNullable<z.ZodString>;
+            chosen: z.ZodBoolean;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>>, z.ZodObject<{
+    error: z.ZodString;
+}, z.core.$strict>]>>;