@fungi.computer/oyster 0.0.0-stage → 0.0.1

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

@@ -0,0 +1,537 @@
+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.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.ZodObject<{
+    requestId: z.ZodString;
+    address: 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.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.ZodObject<{
+        requestId: z.ZodString;
+        address: 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>;
+declare const appComputerOperationSchema: z.ZodEnum<{
+    "computer.list": "computer.list";
+    "computer.readFile": "computer.readFile";
+    "computer.writeFile": "computer.writeFile";
+    "computer.execute": "computer.execute";
+}>;
+export type AppComputerOperation = z.output<typeof appComputerOperationSchema>;
+export declare const appComputerPermissionSchema: z.ZodDiscriminatedUnion<[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.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">;
+export type AppComputerPermission = z.output<typeof appComputerPermissionSchema>;
+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">;
+export type AppAgentPermission = z.output<typeof appAgentPermissionSchema>;
+export declare const appGenerationPermissionsSchema: z.ZodObject<{
+    llm: z.ZodBoolean;
+    media: z.ZodBoolean;
+}, z.core.$strict>;
+export type AppGenerationPermissions = z.output<typeof appGenerationPermissionsSchema>;
+export declare const appMarketplacePermissionsSchema: z.ZodObject<{
+    browse: z.ZodBoolean;
+    purchase: z.ZodBoolean;
+    installFree: z.ZodBoolean;
+}, z.core.$strict>;
+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.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.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.ZodObject<{
+            requestId: z.ZodString;
+            address: 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.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.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>;
+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.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.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.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.ZodUnion<readonly [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.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>]>;
+export {};