@fungi.computer/oyster 0.2.0 → 0.3.0

package/dist/shell/app-directory.d.ts

@@ -1,542 +0,0 @@
-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<{
-        unaffected: "unaffected";
-        pending: "pending";
-        applied: "applied";
-        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<{
-            unaffected: "unaffected";
-            pending: "pending";
-            applied: "applied";
-            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<{
-        available: "available";
-        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<{
-            "computer.list": "computer.list";
-            "computer.readFile": "computer.readFile";
-            "computer.writeFile": "computer.writeFile";
-            "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<{
-        "computer.list": "computer.list";
-        "computer.readFile": "computer.readFile";
-        "computer.writeFile": "computer.writeFile";
-        "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>, {
-    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<{
-        "agent.list": "agent.list";
-    }>>;
-    sessionOperations: z.ZodArray<z.ZodEnum<{
-        "agent.read": "agent.read";
-        "agent.send": "agent.send";
-        "agent.manage": "agent.manage";
-    }>>;
-}, z.core.$strict>, z.ZodObject<{
-    kind: z.ZodLiteral<"selected-agents">;
-    directoryOperations: z.ZodArray<z.ZodEnum<{
-        "agent.list": "agent.list";
-    }>>;
-    agents: z.ZodArray<z.ZodObject<{
-        agentId: z.ZodString;
-        sessionOperations: z.ZodArray<z.ZodEnum<{
-            "agent.read": "agent.read";
-            "agent.send": "agent.send";
-            "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<{
-                unaffected: "unaffected";
-                pending: "pending";
-                applied: "applied";
-                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<{
-            available: "available";
-            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<{
-                    "computer.list": "computer.list";
-                    "computer.readFile": "computer.readFile";
-                    "computer.writeFile": "computer.writeFile";
-                    "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<{
-                "computer.list": "computer.list";
-                "computer.readFile": "computer.readFile";
-                "computer.writeFile": "computer.writeFile";
-                "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<{
-                "agent.list": "agent.list";
-            }>>;
-            sessionOperations: z.ZodArray<z.ZodEnum<{
-                "agent.read": "agent.read";
-                "agent.send": "agent.send";
-                "agent.manage": "agent.manage";
-            }>>;
-        }, z.core.$strict>, z.ZodObject<{
-            kind: z.ZodLiteral<"selected-agents">;
-            directoryOperations: z.ZodArray<z.ZodEnum<{
-                "agent.list": "agent.list";
-            }>>;
-            agents: z.ZodArray<z.ZodObject<{
-                agentId: z.ZodString;
-                sessionOperations: z.ZodArray<z.ZodEnum<{
-                    "agent.read": "agent.read";
-                    "agent.send": "agent.send";
-                    "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<{
-                S: "S";
-                M: "M";
-                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<{
-                    S: "S";
-                    M: "M";
-                    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<{
-                    S: "S";
-                    M: "M";
-                    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>]>>;