@fungi.computer/oyster 0.0.0-stage → 0.1.0

package/docs/api/pack.md

@@ -0,0 +1,141 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/oyster**](README.md)
+
+---
+
+[@fungi.computer/oyster](modules.md) / pack
+
+# pack
+
+## Type Aliases
+
+### PackOptions
+
+```ts
+type PackOptions = Readonly<{
+  appId: string;
+  releaseId?: string;
+  sourceDirectory: string;
+  sourceRevision: string;
+  recipe: AppPublisherCoreConfigInput["recipe"];
+  packageStoreDirectory?: string;
+  outDirectory: string;
+}>;
+```
+
+One committed repository and its canonical App build recipe.
+
+---
+
+### PackedRelease
+
+```ts
+type PackedRelease = Readonly<{
+  release: Release;
+  artifacts: readonly Readonly<{
+    artifactRef: ArtifactRef;
+    path: string;
+  }>[];
+}>;
+```
+
+A packed Release on disk.
+
+## Functions
+
+### packRelease()
+
+```ts
+function packRelease(options): Promise<
+  Readonly<{
+    release: Release;
+    artifacts: readonly Readonly<{
+      artifactRef: ArtifactRef;
+      path: string;
+    }>[];
+  }>
+>;
+```
+
+Build an exact local Git commit with the canonical compiler and artifact writer.
+
+#### Parameters
+
+| Parameter | Type                          |
+| --------- | ----------------------------- |
+| `options` | [`PackOptions`](#packoptions) |
+
+#### Returns
+
+`Promise`\<`Readonly`\<\{ `release`: `Release`; `artifacts`: readonly
+`Readonly`\<\{ `artifactRef`: `ArtifactRef`; `path`: `string`; \}\>[]; \}\>\>
+
+---
+
+### installFromSource()
+
+```ts
+function installFromSource(input): Promise<Response>;
+```
+
+Capture an Artifacts Git commit, build its Release, upload it to an Oyster, and
+install it, or switch an existing installation to it
+([installRelease](#installrelease)).
+
+#### Parameters
+
+| Parameter | Type                                                                                                                                                                                                                                                                                                                      |
+| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `input`   | `Readonly`\<\{ `appId`: `string`; `releaseId?`: `string`; `recipe`: [`PackOptions`](#packoptions)\[`"recipe"`\]; `source`: `Readonly`\<\{ `remote`: `string`; `token`: `string`; `sourceRevision`: `string`; \}\>; `packageStoreDirectory?`: `string`; `url`: `string`; `key`: `string`; `installationId`: `string`; \}\> |
+
+#### Returns
+
+`Promise`\<`Response`\>
+
+---
+
+### installRelease()
+
+```ts
+function installRelease(input): Promise<Response>;
+```
+
+Upload a packed Release to an Oyster and install it. The host installs a new
+installation (201) or switches an existing one to this Release (200), keeping
+its state; both go through its one install-or-select owner.
+
+#### Parameters
+
+| Parameter | Type                                                                                                      |
+| --------- | --------------------------------------------------------------------------------------------------------- |
+| `input`   | `Readonly`\<\{ `directory`: `string`; `url`: `string`; `key`: `string`; `installationId?`: `string`; \}\> |
+
+#### Returns
+
+`Promise`\<`Response`\>
+
+---
+
+### publishSource()
+
+```ts
+function publishSource(input): Promise<Response>;
+```
+
+Project one exact first-party commit's editable source, `git push` it to an
+Oyster's own template for that App, and claim the pushed head, so `APPS.fork`
+and Computer builds can later read it. The operator owner key authenticates
+both; it reaches Git only through its config environment and no provider
+credential ever leaves the Oyster. Answers the claim response:
+`{ kind: "recorded" | "existing", receipt }` on success.
+
+#### Parameters
+
+| Parameter | Type                                                                                                                                                                                                       |
+| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `input`   | `Readonly`\<\{ `appId`: `string`; `entry`: `string`; `repositoryPath`: `string`; `sourceRevision`: `string`; `recipe`: [`PackOptions`](#packoptions)\[`"recipe"`\]; `url`: `string`; `key`: `string`; \}\> |
+
+#### Returns
+
+`Promise`\<`Response`\>

package/docs/api/page/mount.md

@@ -0,0 +1,298 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/oyster**](../README.md)
+
+---
+
+[@fungi.computer/oyster](../modules.md) / page/mount
+
+# page/mount
+
+## Type Aliases
+
+### OysterAppOpenRouting
+
+```ts
+type OysterAppOpenRouting = Readonly<{
+  open: Promise<void>;
+  role: Promise<{
+    displayName: z.ZodNullable<z.ZodString>;
+  } | null>;
+}>;
+```
+
+Role and App opens, routed by the embedding shell; the App never names a
+surface.
+
+---
+
+### OysterAppConfig
+
+```ts
+type OysterAppConfig = typeof oysterAppConfigSchema.Type;
+```
+
+The host-admitted App configuration served by Oyster.
+
+---
+
+### OysterAppConnectionOptions
+
+```ts
+type OysterAppConnectionOptions = Readonly<{
+  config: OysterAppConfig;
+  frame: HTMLIFrameElement;
+  signal: AbortSignal;
+  handlers: AppHostHandlers;
+  appOpen?: OysterAppOpenRouting;
+  openRequest?: AppHostLaunch["context"]["value"]["openRequest"];
+  surfaceId?: string;
+  reservedChords: readonly AppHostReservedChord[];
+  theme: string;
+}>;
+```
+
+One isolated App connection, with the slots this host admitted for it.
+
+## Variables
+
+### appSandbox
+
+```ts
+const appSandbox: "allow-scripts allow-modals allow-popups allow-forms" =
+  "allow-scripts allow-modals allow-popups allow-forms";
+```
+
+The sandbox every installed App frame runs in, shell-mounted or not.
+
+---
+
+### oysterAppConfigSchema
+
+```ts
+const oysterAppConfigSchema: Struct<{
+  workbench: Boolean;
+  shellModuleUrl: NullOr<String>;
+  storage: Boolean;
+  appsOpen: Boolean;
+  computerId: NullOr<String>;
+  authorityVersion: Int;
+  commands: $Array<Codec<Readonly<{
+     id: string;
+     title: string;
+     category: string;
+     description?: string;
+     sigil?: string;
+     projections?: Readonly<{
+        bindings?: ... & ...;
+        agent?: ... & ...;
+        help?: Readonly<...>;
+        menu?: Readonly<...>;
+        palette?: Readonly<...>;
+        slash?: ... & ...;
+     }>;
+   }>, Readonly<{
+     id: string;
+     title: string;
+     category: string;
+     description?: string;
+     sigil?: string;
+     projections?: Readonly<{
+        bindings?: ... & ...;
+        agent?: ... & ...;
+        help?: Readonly<...>;
+        menu?: Readonly<...>;
+        palette?: Readonly<...>;
+        slash?: ... & ...;
+     }>;
+  }>, never, never>>;
+  icon: NullOr<String>;
+  roles: $Array<String>;
+  installationId: String;
+  appId: String;
+  releaseId: String;
+  uiUrl: String;
+  backendUrl: String;
+  methodsUrl: String;
+  capabilities: $Array<Struct<{
+     id: String;
+     version: Number;
+     base: String;
+     methods: $Record<String, Union<readonly [Struct<{
+        kind: Literal<...>;
+        method: Literals<...>;
+        path: String;
+      }>, Struct<{
+        kind: Literals<...>;
+        method: Literals<...>;
+        path: String;
+     }>]>>;
+  }>>;
+}>;
+```
+
+Current server-admitted configuration for one installed App page.
+
+## Functions
+
+### readOysterPageConfig()
+
+```ts
+function readOysterPageConfig(): object;
+```
+
+Read the server-admitted configuration this page was served with.
+
+#### Returns
+
+| Name               | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Default value    | Description                                                                     |
+| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- | ------------------------------------------------------------------------------- |
+| `workbench`        | `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | `Schema.Boolean` | -                                                                               |
+| `shellModuleUrl`   | `string` \| `null`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | -                | The home shell Release's own module, imported top-level; null if it ships none. |
+| `storage`          | `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | `Schema.Boolean` | -                                                                               |
+| `appsOpen`         | `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | `Schema.Boolean` | The Release declares `apps.open`; only an embedding shell can serve it.         |
+| `computerId`       | `string` \| `null`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | -                | -                                                                               |
+| `authorityVersion` | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `Schema.Int`     | -                                                                               |
+| `commands`         | readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`; `description?`: `string`; `sigil?`: `string`; `projections?`: `Readonly`\<\{ `bindings?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `values`: ...; \}\>; `agent?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `keybind?`: ...; \}\>; `help?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `menu?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `palette?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `slash?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `aliases`: ...; \}\>; \}\>; \}\>[] | -                | -                                                                               |
+| `icon`             | `string` \| `null`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | -                | -                                                                               |
+| `roles`            | readonly `string`[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | -                | -                                                                               |
+| `installationId`   | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `Schema.String`  | -                                                                               |
+| `appId`            | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `Schema.String`  | -                                                                               |
+| `releaseId`        | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `Schema.String`  | -                                                                               |
+| `uiUrl`            | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `Schema.String`  | -                                                                               |
+| `backendUrl`       | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `Schema.String`  | -                                                                               |
+| `methodsUrl`       | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `Schema.String`  | -                                                                               |
+| `capabilities`     | readonly `object`[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | -                | -                                                                               |
+
+---
+
+### applyOysterPageTheme()
+
+```ts
+function applyOysterPageTheme(): "mocha" | "latte";
+```
+
+Apply this host's shared page styles and the person's color theme.
+
+#### Returns
+
+`"mocha"` \| `"latte"`
+
+---
+
+### oysterShellHandles()
+
+```ts
+function oysterShellHandles(config): object;
+```
+
+The home installation's own storage and methods, for the trusted shell the host
+composes into this document. They reach the same admitted routes an isolated App
+would, without a frame between the shell and its host.
+
+#### Parameters
+
+| Parameter                 | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Description                                                                     |
+| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
+| `config`                  | \{ `workbench`: `boolean`; `shellModuleUrl`: `string` \| `null`; `storage`: `boolean`; `appsOpen`: `boolean`; `computerId`: `string` \| `null`; `authorityVersion`: `number`; `commands`: readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`; `description?`: `string`; `sigil?`: `string`; `projections?`: `Readonly`\<\{ `bindings?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `values`: ...; \}\>; `agent?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `keybind?`: ...; \}\>; `help?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `menu?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `palette?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `slash?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `aliases`: ...; \}\>; \}\>; \}\>[]; `icon`: `string` \| `null`; `roles`: readonly `string`[]; `installationId`: `string`; `appId`: `string`; `releaseId`: `string`; `uiUrl`: `string`; `backendUrl`: `string`; `methodsUrl`: `string`; `capabilities`: readonly `object`[]; \} | -                                                                               |
+| `config.workbench`        | `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | -                                                                               |
+| `config.shellModuleUrl`   | `string` \| `null`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | The home shell Release's own module, imported top-level; null if it ships none. |
+| `config.storage`          | `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | -                                                                               |
+| `config.appsOpen`         | `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | The Release declares `apps.open`; only an embedding shell can serve it.         |
+| `config.computerId`       | `string` \| `null`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | -                                                                               |
+| `config.authorityVersion` | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | -                                                                               |
+| `config.commands`         | readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`; `description?`: `string`; `sigil?`: `string`; `projections?`: `Readonly`\<\{ `bindings?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `values`: ...; \}\>; `agent?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `keybind?`: ...; \}\>; `help?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `menu?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `palette?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `slash?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `aliases`: ...; \}\>; \}\>; \}\>[]                                                                                                                                                                                                                                                                                                                                                                                                                                       | -                                                                               |
+| `config.icon`             | `string` \| `null`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | -                                                                               |
+| `config.roles`            | readonly `string`[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | -                                                                               |
+| `config.installationId`   | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | -                                                                               |
+| `config.appId`            | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | -                                                                               |
+| `config.releaseId`        | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | -                                                                               |
+| `config.uiUrl`            | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | -                                                                               |
+| `config.backendUrl`       | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | -                                                                               |
+| `config.methodsUrl`       | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | -                                                                               |
+| `config.capabilities`     | readonly `object`[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | -                                                                               |
+
+#### Returns
+
+`object`
+
+| Name      | Type                                                                                                                                                                                                                                                                                                                                                                                                                                          | Description                                                                     |
+| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
+| `storage` | \| `Readonly`\<\{ `read`: `Promise`\<\{ `value`: `Json`; `source`: `"team"` \| `"member"` \| `"none"`; `team`: \| \{ `value`: `Json`; `revision`: `number`; \} \| `null`; `member`: \| \{ `value`: `Json`; `revision`: `number`; \} \| `null`; `canWriteTeam`: `boolean`; \}\>; `write`: `Promise`\<\{ `revision`: `number`; \}\>; `reset`: `Promise`\<\{ `revision`: `number`; \}\>; `watch`: `Promise`\<`AppStorageWatch`\>; \}\> \| `null` | -                                                                               |
+| `methods` | `object`                                                                                                                                                                                                                                                                                                                                                                                                                                      | -                                                                               |
+| `call()`  | (`method`, `input`) => `Promise`\<`WhistleJsonValue`\>                                                                                                                                                                                                                                                                                                                                                                                        | Call the named method with JSON-encoded `input`; resolves with its JSON result. |
+
+---
+
+### mountOysterPage()
+
+```ts
+function mountOysterPage(): Promise<AppHost>;
+```
+
+Mount one installed App's own page: its sandboxed frame and nothing else.
+Desktop chrome (menus, palette, status) belongs to the trusted shell.
+
+#### Returns
+
+`Promise`\<`AppHost`\>
+
+---
+
+### connectOysterApp()
+
+```ts
+function connectOysterApp(options): Promise<AppHost>;
+```
+
+Connect a child or home App using the same admitted Oyster slot handles.
+
+#### Parameters
+
+| Parameter | Type                                                        |
+| --------- | ----------------------------------------------------------- |
+| `options` | [`OysterAppConnectionOptions`](#oysterappconnectionoptions) |
+
+#### Returns
+
+`Promise`\<`AppHost`\>
+
+---
+
+### oysterAppCapabilities()
+
+```ts
+function oysterAppCapabilities(options): Promise<readonly object[]>;
+```
+
+Resolve only the slots admitted for this installation by its current host.
+
+#### Parameters
+
+| Parameter | Type                                                                                                           |
+| --------- | -------------------------------------------------------------------------------------------------------------- |
+| `options` | `Pick`\<[`OysterAppConnectionOptions`](#oysterappconnectionoptions), `"config"` \| `"signal"` \| `"appOpen"`\> |
+
+#### Returns
+
+`Promise`\<readonly `object`[]\>
+
+---
+
+### oysterStorageHandle()
+
+```ts
+function oysterStorageHandle(installationId): AppStorageWire;
+```
+
+The existing Agar storage wire, scoped to an admitted installation and owner.
+
+#### Parameters
+
+| Parameter        | Type     |
+| ---------------- | -------- |
+| `installationId` | `string` |
+
+#### Returns
+
+`AppStorageWire`

package/docs/api/root-data.md

@@ -0,0 +1,111 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/oyster**](README.md)
+
+---
+
+[@fungi.computer/oyster](modules.md) / root-data
+
+# root-data
+
+## Type Aliases
+
+### OysterRootRoles
+
+```ts
+type OysterRootRoles = Readonly<
+  Record<
+    string,
+    Readonly<{
+      surfaceId: string | null;
+      chosen: boolean;
+    }>
+  >
+>;
+```
+
+Role choices belong to the root owner, independently of Release declarations.
+
+---
+
+### OysterRootDirectory
+
+```ts
+type OysterRootDirectory = Readonly<{
+  apps: readonly AppDirectoryEntry[];
+  roles: OysterRootRoles;
+  computer?: Readonly<{
+    computerId: string;
+    name: string;
+  }>;
+}>;
+```
+
+Shared workbench metadata, without a hosted Team's administration or grants.
+
+---
+
+### OysterRootDataOptions
+
+```ts
+type OysterRootDataOptions = Parameters<typeof createAppStorage>[0] &
+  Readonly<{
+    installations: Pick<InstallationStore, "list">;
+    resolveRelease: Promise<
+      Pick<
+        Readonly<{
+          release: Release;
+          build: AppBuild;
+          api: AppApi | null;
+          declaration: AppDeclaration | null;
+          ui:
+            | Readonly<{
+                kind: "html";
+                artifactRef: ArtifactRef;
+                digest: Sha256Digest;
+              }>
+            | Readonly<{
+                kind: "assets";
+                build: AssetBuild;
+              }>
+            | null;
+          backend: Readonly<{
+            artifactRef: ArtifactRef;
+            digest: Sha256Digest;
+          }> | null;
+        }>,
+        "declaration" | "ui"
+      >
+    >;
+  }>;
+```
+
+Existing installation, Release and SQLite owners supplied by the root.
+
+## Functions
+
+### createOysterRootData()
+
+```ts
+function createOysterRootData(options): object;
+```
+
+Data adapters for a standalone workbench over the root's existing owners.
+
+#### Parameters
+
+| Parameter | Type                                              |
+| --------- | ------------------------------------------------- |
+| `options` | [`OysterRootDataOptions`](#oysterrootdataoptions) |
+
+#### Returns
+
+| Name                          | Type                                                                                                                                                                                            | Description                                                                                      |
+| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
+| `storage`                     | `object`                                                                                                                                                                                        | Each open(authorize) receives fresh host admission and Release-declared keys.                    |
+| `storage.purgeInstallation()` | (`address`) => `void`                                                                                                                                                                           | Remove an installation's values and write counters inside its delete transaction.                |
+| `storage.purgeMember()`       | (`memberId`, `throughVersion`) => `void`                                                                                                                                                        | Remove a member's private values and counters through the revoked membership version.            |
+| `openInstallation()`          | (`authorize`) => `object`                                                                                                                                                                       | Bind a lifecycle view to fresh installation admission; only declared team layers are accessible. |
+| `open()`                      | (`authorize`) => `object`                                                                                                                                                                       | Bind a member view to live admission, declared keys and the current membership version.          |
+| `directory()`                 | () => `Promise`\<`Readonly`\<\{ `apps`: readonly `object`[]; `roles`: [`OysterRootRoles`](#oysterrootroles); `computer?`: `Readonly`\<\{ `computerId`: `string`; `name`: `string`; \}\>; \}\>\> | Project the current installations without minting permissions or role choices.                   |
+| `platformDestinations()`      | () => readonly `Readonly`\<\{ `id`: `string`; `label`: `string`; \}\>[]                                                                                                                         | No standalone platform navigation destination is implemented yet.                                |