@fungi.computer/oyster 0.0.0-stage → 0.0.1

package/docs/api/auth.md

@@ -0,0 +1,63 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/oyster**](README.md)
+
+---
+
+[@fungi.computer/oyster](modules.md) / auth
+
+# auth
+
+## Variables
+
+### ownerKeyCookieName
+
+```ts
+const ownerKeyCookieName: "oyster_session" = "oyster_session";
+```
+
+Cookie emitted by ownerKeyAuth, for composing credential-specific adapters.
+
+## Functions
+
+### ownerKeyAuth()
+
+```ts
+function ownerKeyAuth(ownerKey, ownerId?): OysterAuth;
+```
+
+Single-owner sign-in: a bearer token or a session cookie holding the owner key's
+digest. The key itself is never stored in the browser.
+
+#### Parameters
+
+| Parameter  | Type     | Default value |
+| ---------- | -------- | ------------- |
+| `ownerKey` | `string` | `undefined`   |
+| `ownerId`  | `string` | `"owner"`     |
+
+#### Returns
+
+[`OysterAuth`](host.md#oysterauth)
+
+---
+
+### ownerOrKeyAuth()
+
+```ts
+function ownerOrKeyAuth(ownerKey, ownerId, keys): OysterAuth;
+```
+
+The owner key, or a named key admitted as its canonical Team-key actor.
+
+#### Parameters
+
+| Parameter  | Type                                                                   |
+| ---------- | ---------------------------------------------------------------------- |
+| `ownerKey` | `string`                                                               |
+| `ownerId`  | `string`                                                               |
+| `keys`     | () => `Pick`\<[`OysterKeyStore`](keys.md#oysterkeystore), `"verify"`\> |
+
+#### Returns
+
+[`OysterAuth`](host.md#oysterauth)

package/docs/api/build-contract.md

@@ -0,0 +1,507 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/oyster**](README.md)
+
+---
+
+[@fungi.computer/oyster](modules.md) / build-contract
+
+# build-contract
+
+## Type Aliases
+
+### TeamAppCandidateSubmission
+
+```ts
+type TeamAppCandidateSubmission = Schema.Schema.Type<
+  typeof teamAppCandidateSubmissionSchema
+>;
+```
+
+One submitted Team App candidate.
+
+---
+
+### PreparedTeamAppCandidate
+
+```ts
+type PreparedTeamAppCandidate = Schema.Schema.Type<
+  typeof preparedCandidateSchema
+>;
+```
+
+One Team App candidate with its reserved Release ID.
+
+## Variables
+
+### TEAM\_APP\_SUBMISSION\_MAX\_REQUEST\_BYTES
+
+```ts
+const TEAM_APP_SUBMISSION_MAX_REQUEST_BYTES: number;
+```
+
+The largest Team App candidate submission request body, in bytes.
+
+---
+
+### teamAppCandidateSubmissionSchema
+
+```ts
+const teamAppCandidateSubmissionSchema: Struct<{
+  appId: refine<AppId, String>;
+  output: Union<readonly [Struct<{
+     declaration: optionalKey<Codec<Readonly<{
+        api?: ... | ...;
+        displayName?: ... | ...;
+        capabilities: readonly ...[];
+        calls?: ... | ...;
+        guidance?: ... | ...;
+        handlers: readonly ...[];
+        receives?: ... | ...;
+        icon?: ... | ...;
+        roles: readonly ...[];
+        storage?: ... | ...;
+        commands?: ... | ...;
+        gills?: ... | ...;
+        backend?: ... | ...;
+      }>, Readonly<{
+        api?: ... | ...;
+        displayName?: ... | ...;
+        capabilities: readonly ...[];
+        calls?: ... | ...;
+        guidance?: ... | ...;
+        handlers: readonly ...[];
+        receives?: ... | ...;
+        icon?: ... | ...;
+        roles: readonly ...[];
+        storage?: ... | ...;
+        commands?: ... | ...;
+        gills?: ... | ...;
+        backend?: ... | ...;
+     }>, never, never>>;
+     kind: Literal<"ui">;
+     ui: Union<readonly [Struct<{
+        mediaType: Literal<...>;
+        content: Struct<...>;
+      }>, Struct<{
+        mediaType: Literal<...>;
+        content: Struct<...>;
+     }>]>;
+   }>, Struct<{
+     declaration: optionalKey<Codec<Readonly<{
+        api?: ... | ...;
+        displayName?: ... | ...;
+        capabilities: readonly ...[];
+        calls?: ... | ...;
+        guidance?: ... | ...;
+        handlers: readonly ...[];
+        receives?: ... | ...;
+        icon?: ... | ...;
+        roles: readonly ...[];
+        storage?: ... | ...;
+        commands?: ... | ...;
+        gills?: ... | ...;
+        backend?: ... | ...;
+      }>, Readonly<{
+        api?: ... | ...;
+        displayName?: ... | ...;
+        capabilities: readonly ...[];
+        calls?: ... | ...;
+        guidance?: ... | ...;
+        handlers: readonly ...[];
+        receives?: ... | ...;
+        icon?: ... | ...;
+        roles: readonly ...[];
+        storage?: ... | ...;
+        commands?: ... | ...;
+        gills?: ... | ...;
+        backend?: ... | ...;
+     }>, never, never>>;
+     kind: Literal<"backend">;
+     backend: Uint8ArrayFromBase64;
+   }>, Struct<{
+     declaration: optionalKey<Codec<Readonly<{
+        api?: ... | ...;
+        displayName?: ... | ...;
+        capabilities: readonly ...[];
+        calls?: ... | ...;
+        guidance?: ... | ...;
+        handlers: readonly ...[];
+        receives?: ... | ...;
+        icon?: ... | ...;
+        roles: readonly ...[];
+        storage?: ... | ...;
+        commands?: ... | ...;
+        gills?: ... | ...;
+        backend?: ... | ...;
+      }>, Readonly<{
+        api?: ... | ...;
+        displayName?: ... | ...;
+        capabilities: readonly ...[];
+        calls?: ... | ...;
+        guidance?: ... | ...;
+        handlers: readonly ...[];
+        receives?: ... | ...;
+        icon?: ... | ...;
+        roles: readonly ...[];
+        storage?: ... | ...;
+        commands?: ... | ...;
+        gills?: ... | ...;
+        backend?: ... | ...;
+     }>, never, never>>;
+     kind: Literal<"app">;
+     ui: Union<readonly [Struct<{
+        mediaType: Literal<...>;
+        content: Struct<...>;
+      }>, Struct<{
+        mediaType: Literal<...>;
+        content: Struct<...>;
+     }>]>;
+     backend: Uint8ArrayFromBase64;
+  }>]>;
+  provenance: Struct<{
+     sourceRevision: refine<SourceRevision, String>;
+     sourceTreeDigest: refine<Sha256Digest, String>;
+     buildRecipeDigest: refine<Sha256Digest, String>;
+  }>;
+}>;
+```
+
+Exact submitted output and provenance before the Team assigns a stable Release
+ID.
+
+---
+
+### preparedCandidateSchema
+
+```ts
+const preparedCandidateSchema: Struct<{
+  appId: refine<AppId, String>;
+  output: Union<readonly [Struct<{
+     declaration: optionalKey<Codec<Readonly<{
+        api?: ... | ...;
+        displayName?: ... | ...;
+        capabilities: readonly ...[];
+        calls?: ... | ...;
+        guidance?: ... | ...;
+        handlers: readonly ...[];
+        receives?: ... | ...;
+        icon?: ... | ...;
+        roles: readonly ...[];
+        storage?: ... | ...;
+        commands?: ... | ...;
+        gills?: ... | ...;
+        backend?: ... | ...;
+      }>, Readonly<{
+        api?: ... | ...;
+        displayName?: ... | ...;
+        capabilities: readonly ...[];
+        calls?: ... | ...;
+        guidance?: ... | ...;
+        handlers: readonly ...[];
+        receives?: ... | ...;
+        icon?: ... | ...;
+        roles: readonly ...[];
+        storage?: ... | ...;
+        commands?: ... | ...;
+        gills?: ... | ...;
+        backend?: ... | ...;
+     }>, never, never>>;
+     kind: Literal<"ui">;
+     ui: Union<readonly [Struct<{
+        mediaType: Literal<...>;
+        content: Struct<...>;
+      }>, Struct<{
+        mediaType: Literal<...>;
+        content: Struct<...>;
+     }>]>;
+   }>, Struct<{
+     declaration: optionalKey<Codec<Readonly<{
+        api?: ... | ...;
+        displayName?: ... | ...;
+        capabilities: readonly ...[];
+        calls?: ... | ...;
+        guidance?: ... | ...;
+        handlers: readonly ...[];
+        receives?: ... | ...;
+        icon?: ... | ...;
+        roles: readonly ...[];
+        storage?: ... | ...;
+        commands?: ... | ...;
+        gills?: ... | ...;
+        backend?: ... | ...;
+      }>, Readonly<{
+        api?: ... | ...;
+        displayName?: ... | ...;
+        capabilities: readonly ...[];
+        calls?: ... | ...;
+        guidance?: ... | ...;
+        handlers: readonly ...[];
+        receives?: ... | ...;
+        icon?: ... | ...;
+        roles: readonly ...[];
+        storage?: ... | ...;
+        commands?: ... | ...;
+        gills?: ... | ...;
+        backend?: ... | ...;
+     }>, never, never>>;
+     kind: Literal<"backend">;
+     backend: Uint8ArrayFromBase64;
+   }>, Struct<{
+     declaration: optionalKey<Codec<Readonly<{
+        api?: ... | ...;
+        displayName?: ... | ...;
+        capabilities: readonly ...[];
+        calls?: ... | ...;
+        guidance?: ... | ...;
+        handlers: readonly ...[];
+        receives?: ... | ...;
+        icon?: ... | ...;
+        roles: readonly ...[];
+        storage?: ... | ...;
+        commands?: ... | ...;
+        gills?: ... | ...;
+        backend?: ... | ...;
+      }>, Readonly<{
+        api?: ... | ...;
+        displayName?: ... | ...;
+        capabilities: readonly ...[];
+        calls?: ... | ...;
+        guidance?: ... | ...;
+        handlers: readonly ...[];
+        receives?: ... | ...;
+        icon?: ... | ...;
+        roles: readonly ...[];
+        storage?: ... | ...;
+        commands?: ... | ...;
+        gills?: ... | ...;
+        backend?: ... | ...;
+     }>, never, never>>;
+     kind: Literal<"app">;
+     ui: Union<readonly [Struct<{
+        mediaType: Literal<...>;
+        content: Struct<...>;
+      }>, Struct<{
+        mediaType: Literal<...>;
+        content: Struct<...>;
+     }>]>;
+     backend: Uint8ArrayFromBase64;
+  }>]>;
+  provenance: Struct<{
+     sourceRevision: refine<SourceRevision, String>;
+     sourceTreeDigest: refine<Sha256Digest, String>;
+     buildRecipeDigest: refine<Sha256Digest, String>;
+  }>;
+  releaseId: refine<ReleaseId, String>;
+}>;
+```
+
+Publisher persistence input after TeamDO reserves retry-stable identities.
+
+## Functions
+
+### encodeTeamAppCandidateSubmission()
+
+```ts
+function encodeTeamAppCandidateSubmission(input): string;
+```
+
+Canonical wire bytes make TeamDO's same-request digest independent of JSON
+spacing.
+
+#### Parameters
+
+| Parameter                            | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `input`                              | \{ `appId`: `AppId`; `output`: \| \{ `declaration?`: `Readonly`\<\{ `api?`: `Readonly`\<\{ `methods`: `Readonly`\<`Record`\<..., ...\>\>; `toolFamily?`: `Readonly`\<...\>; `events?`: `Readonly`\<...\>; \}\>; `displayName?`: `string`; `capabilities`: readonly ( \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`)[]; `calls?`: readonly `Readonly`\<\{ `appId`: `string`; `methods`: readonly ...[]; \}\>[]; `guidance?`: `string`; `handlers`: readonly `"file.open"`[]; `receives?`: readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly (`"dashboard"` \| `"inbox"` \| `"files"` \| `"media"` \| `"sessions"` \| `"terminal"`)[]; `storage?`: readonly `Readonly`\<\{ `key`: `string`; `scopes`: readonly ...[]; `maxBytes`: `number`; \}\>[]; `commands?`: readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`; `description?`: ... \| ...; `sigil?`: ... \| ...; `projections?`: ... \| ...; \}\>[]; `gills?`: readonly `Readonly`\<\{ `id`: `string`; `source`: `string`; `title`: `string`; `params?`: ... \| ...; `watch?`: ... \| ...; `desktop?`: ... \| ...; \}\>[]; `backend?`: `Readonly`\<\{ `bindings`: readonly `Readonly`\<...\>[]; `sync?`: `Readonly`\<...\>; \}\>; \}\>; `kind`: `"ui"`; `ui`: \| \{ `mediaType`: `"text/html; charset=utf-8"`; `content`: \{ `kind`: `"html"`; `bytes`: `Uint8Array`\<`ArrayBufferLike`\>; \}; \} \| \{ `mediaType`: `"application/vnd.fungi.app-assets+json"`; `content`: \{ `kind`: `"assets"`; `base`: `string`; `assets`: readonly `object`[]; \}; \}; \} \| \{ `declaration?`: `Readonly`\<\{ `api?`: `Readonly`\<\{ `methods`: `Readonly`\<`Record`\<..., ...\>\>; `toolFamily?`: `Readonly`\<...\>; `events?`: `Readonly`\<...\>; \}\>; `displayName?`: `string`; `capabilities`: readonly ( \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`)[]; `calls?`: readonly `Readonly`\<\{ `appId`: `string`; `methods`: readonly ...[]; \}\>[]; `guidance?`: `string`; `handlers`: readonly `"file.open"`[]; `receives?`: readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly (`"dashboard"` \| `"inbox"` \| `"files"` \| `"media"` \| `"sessions"` \| `"terminal"`)[]; `storage?`: readonly `Readonly`\<\{ `key`: `string`; `scopes`: readonly ...[]; `maxBytes`: `number`; \}\>[]; `commands?`: readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`; `description?`: ... \| ...; `sigil?`: ... \| ...; `projections?`: ... \| ...; \}\>[]; `gills?`: readonly `Readonly`\<\{ `id`: `string`; `source`: `string`; `title`: `string`; `params?`: ... \| ...; `watch?`: ... \| ...; `desktop?`: ... \| ...; \}\>[]; `backend?`: `Readonly`\<\{ `bindings`: readonly `Readonly`\<...\>[]; `sync?`: `Readonly`\<...\>; \}\>; \}\>; `kind`: `"backend"`; `backend`: `Uint8Array`\<`ArrayBufferLike`\>; \} \| \{ `declaration?`: `Readonly`\<\{ `api?`: `Readonly`\<\{ `methods`: `Readonly`\<`Record`\<..., ...\>\>; `toolFamily?`: `Readonly`\<...\>; `events?`: `Readonly`\<...\>; \}\>; `displayName?`: `string`; `capabilities`: readonly ( \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`)[]; `calls?`: readonly `Readonly`\<\{ `appId`: `string`; `methods`: readonly ...[]; \}\>[]; `guidance?`: `string`; `handlers`: readonly `"file.open"`[]; `receives?`: readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly (`"dashboard"` \| `"inbox"` \| `"files"` \| `"media"` \| `"sessions"` \| `"terminal"`)[]; `storage?`: readonly `Readonly`\<\{ `key`: `string`; `scopes`: readonly ...[]; `maxBytes`: `number`; \}\>[]; `commands?`: readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`; `description?`: ... \| ...; `sigil?`: ... \| ...; `projections?`: ... \| ...; \}\>[]; `gills?`: readonly `Readonly`\<\{ `id`: `string`; `source`: `string`; `title`: `string`; `params?`: ... \| ...; `watch?`: ... \| ...; `desktop?`: ... \| ...; \}\>[]; `backend?`: `Readonly`\<\{ `bindings`: readonly `Readonly`\<...\>[]; `sync?`: `Readonly`\<...\>; \}\>; \}\>; `kind`: `"app"`; `ui`: \| \{ `mediaType`: `"text/html; charset=utf-8"`; `content`: \{ `kind`: `"html"`; `bytes`: `Uint8Array`\<`ArrayBufferLike`\>; \}; \} \| \{ `mediaType`: `"application/vnd.fungi.app-assets+json"`; `content`: \{ `kind`: `"assets"`; `base`: `string`; `assets`: readonly `object`[]; \}; \}; `backend`: `Uint8Array`\<`ArrayBufferLike`\>; \}; `provenance`: \{ `sourceRevision`: `SourceRevision`; `sourceTreeDigest`: `Sha256Digest`; `buildRecipeDigest`: `Sha256Digest`; \}; \} |
+| `input.appId`                        | `AppId`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| `input.output`                       | \| \{ `declaration?`: `Readonly`\<\{ `api?`: `Readonly`\<\{ `methods`: `Readonly`\<`Record`\<..., ...\>\>; `toolFamily?`: `Readonly`\<...\>; `events?`: `Readonly`\<...\>; \}\>; `displayName?`: `string`; `capabilities`: readonly ( \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`)[]; `calls?`: readonly `Readonly`\<\{ `appId`: `string`; `methods`: readonly ...[]; \}\>[]; `guidance?`: `string`; `handlers`: readonly `"file.open"`[]; `receives?`: readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly (`"dashboard"` \| `"inbox"` \| `"files"` \| `"media"` \| `"sessions"` \| `"terminal"`)[]; `storage?`: readonly `Readonly`\<\{ `key`: `string`; `scopes`: readonly ...[]; `maxBytes`: `number`; \}\>[]; `commands?`: readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`; `description?`: ... \| ...; `sigil?`: ... \| ...; `projections?`: ... \| ...; \}\>[]; `gills?`: readonly `Readonly`\<\{ `id`: `string`; `source`: `string`; `title`: `string`; `params?`: ... \| ...; `watch?`: ... \| ...; `desktop?`: ... \| ...; \}\>[]; `backend?`: `Readonly`\<\{ `bindings`: readonly `Readonly`\<...\>[]; `sync?`: `Readonly`\<...\>; \}\>; \}\>; `kind`: `"ui"`; `ui`: \| \{ `mediaType`: `"text/html; charset=utf-8"`; `content`: \{ `kind`: `"html"`; `bytes`: `Uint8Array`\<`ArrayBufferLike`\>; \}; \} \| \{ `mediaType`: `"application/vnd.fungi.app-assets+json"`; `content`: \{ `kind`: `"assets"`; `base`: `string`; `assets`: readonly `object`[]; \}; \}; \} \| \{ `declaration?`: `Readonly`\<\{ `api?`: `Readonly`\<\{ `methods`: `Readonly`\<`Record`\<..., ...\>\>; `toolFamily?`: `Readonly`\<...\>; `events?`: `Readonly`\<...\>; \}\>; `displayName?`: `string`; `capabilities`: readonly ( \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`)[]; `calls?`: readonly `Readonly`\<\{ `appId`: `string`; `methods`: readonly ...[]; \}\>[]; `guidance?`: `string`; `handlers`: readonly `"file.open"`[]; `receives?`: readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly (`"dashboard"` \| `"inbox"` \| `"files"` \| `"media"` \| `"sessions"` \| `"terminal"`)[]; `storage?`: readonly `Readonly`\<\{ `key`: `string`; `scopes`: readonly ...[]; `maxBytes`: `number`; \}\>[]; `commands?`: readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`; `description?`: ... \| ...; `sigil?`: ... \| ...; `projections?`: ... \| ...; \}\>[]; `gills?`: readonly `Readonly`\<\{ `id`: `string`; `source`: `string`; `title`: `string`; `params?`: ... \| ...; `watch?`: ... \| ...; `desktop?`: ... \| ...; \}\>[]; `backend?`: `Readonly`\<\{ `bindings`: readonly `Readonly`\<...\>[]; `sync?`: `Readonly`\<...\>; \}\>; \}\>; `kind`: `"backend"`; `backend`: `Uint8Array`\<`ArrayBufferLike`\>; \} \| \{ `declaration?`: `Readonly`\<\{ `api?`: `Readonly`\<\{ `methods`: `Readonly`\<`Record`\<..., ...\>\>; `toolFamily?`: `Readonly`\<...\>; `events?`: `Readonly`\<...\>; \}\>; `displayName?`: `string`; `capabilities`: readonly ( \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`)[]; `calls?`: readonly `Readonly`\<\{ `appId`: `string`; `methods`: readonly ...[]; \}\>[]; `guidance?`: `string`; `handlers`: readonly `"file.open"`[]; `receives?`: readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly (`"dashboard"` \| `"inbox"` \| `"files"` \| `"media"` \| `"sessions"` \| `"terminal"`)[]; `storage?`: readonly `Readonly`\<\{ `key`: `string`; `scopes`: readonly ...[]; `maxBytes`: `number`; \}\>[]; `commands?`: readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`; `description?`: ... \| ...; `sigil?`: ... \| ...; `projections?`: ... \| ...; \}\>[]; `gills?`: readonly `Readonly`\<\{ `id`: `string`; `source`: `string`; `title`: `string`; `params?`: ... \| ...; `watch?`: ... \| ...; `desktop?`: ... \| ...; \}\>[]; `backend?`: `Readonly`\<\{ `bindings`: readonly `Readonly`\<...\>[]; `sync?`: `Readonly`\<...\>; \}\>; \}\>; `kind`: `"app"`; `ui`: \| \{ `mediaType`: `"text/html; charset=utf-8"`; `content`: \{ `kind`: `"html"`; `bytes`: `Uint8Array`\<`ArrayBufferLike`\>; \}; \} \| \{ `mediaType`: `"application/vnd.fungi.app-assets+json"`; `content`: \{ `kind`: `"assets"`; `base`: `string`; `assets`: readonly `object`[]; \}; \}; `backend`: `Uint8Array`\<`ArrayBufferLike`\>; \}                                                                                                                                                                      |
+| `input.provenance`                   | \{ `sourceRevision`: `SourceRevision`; `sourceTreeDigest`: `Sha256Digest`; `buildRecipeDigest`: `Sha256Digest`; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `input.provenance.sourceRevision`    | `SourceRevision`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `input.provenance.sourceTreeDigest`  | `Sha256Digest`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| `input.provenance.buildRecipeDigest` | `Sha256Digest`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+
+#### Returns
+
+`string`
+
+## References
+
+### pinnedRecipeSchema
+
+Re-exports [pinnedRecipeSchema](build.md#pinnedrecipeschema)
+
+---
+
+### AppPublisherCoreConfigSchema
+
+Re-exports [AppPublisherCoreConfigSchema](build.md#apppublishercoreconfigschema)
+
+---
+
+### AppPublisherCoreConfigInput
+
+Re-exports [AppPublisherCoreConfigInput](build.md#apppublishercoreconfiginput)
+
+---
+
+### appBackendExportConditions
+
+Re-exports [appBackendExportConditions](build.md#appbackendexportconditions)
+
+---
+
+### capturedPinnedRecipeSchema
+
+Re-exports [capturedPinnedRecipeSchema](build.md#capturedpinnedrecipeschema)
+
+---
+
+### PinnedRecipe
+
+Re-exports [PinnedRecipe](build.md#pinnedrecipe)
+
+---
+
+### CapturedSource
+
+Re-exports [CapturedSource](build.md#capturedsource)
+
+---
+
+### RawBuildOutput
+
+Re-exports [RawBuildOutput](build.md#rawbuildoutput)
+
+---
+
+### UiBuildOutput
+
+Re-exports [UiBuildOutput](build.md#uibuildoutput)
+
+---
+
+### BuildExecutorOutput
+
+Re-exports [BuildExecutorOutput](build.md#buildexecutoroutput)
+
+---
+
+### PreparedUiOutput
+
+Re-exports [PreparedUiOutput](build.md#prepareduioutput)
+
+---
+
+### BuildOutput
+
+Re-exports [BuildOutput](build.md#buildoutput)
+
+---
+
+### StoredArtifact
+
+Re-exports [StoredArtifact](build.md#storedartifact)
+
+---
+
+### PreparedCandidate
+
+Re-exports [PreparedCandidate](build.md#preparedcandidate)
+
+---
+
+### SourceCapture
+
+Re-exports [SourceCapture](build.md#sourcecapture)
+
+---
+
+### BuildExecutor
+
+Re-exports [BuildExecutor](build.md#buildexecutor)
+
+---
+
+### ArtifactWriter
+
+Re-exports [ArtifactWriter](build.md#artifactwriter)
+
+---
+
+### ReleaseCreator
+
+Re-exports [ReleaseCreator](build.md#releasecreator)
+
+---
+
+### AppPublisherOptions
+
+Re-exports [AppPublisherOptions](build.md#apppublisheroptions)
+
+---
+
+### AppPublisher
+
+Re-exports [AppPublisher](build.md#apppublisher)
+
+---
+
+### AppCandidatePreparer
+
+Re-exports [AppCandidatePreparer](build.md#appcandidatepreparer)
+
+---
+
+### AppPublisherStage
+
+Re-exports [AppPublisherStage](build.md#apppublisherstage)
+
+---
+
+### AppPublisherError
+
+Re-exports [AppPublisherError](build.md#apppublishererror)
+
+---
+
+### CapturedConfig
+
+Re-exports [CapturedConfig](build.md#capturedconfig)
+
+---
+
+### digestPinnedRecipe
+
+Re-exports [digestPinnedRecipe](build.md#digestpinnedrecipe)
+
+---
+
+### normalizeAppPublisherRecipe
+
+Re-exports [normalizeAppPublisherRecipe](build.md#normalizeapppublisherrecipe)
+
+---
+
+### createAppCandidatePreparer
+
+Re-exports [createAppCandidatePreparer](build.md#createappcandidatepreparer)
+
+---
+
+### createCapturedCandidatePreparer
+
+Re-exports
+[createCapturedCandidatePreparer](build.md#createcapturedcandidatepreparer)
+
+---
+
+### commitPreparedCandidate
+
+Re-exports [commitPreparedCandidate](build.md#commitpreparedcandidate)
+
+---
+
+### createAppPublisher
+
+Re-exports [createAppPublisher](build.md#createapppublisher)