@fungi.computer/oyster 0.0.0-stage → 0.0.1

package/docs/api/build.md

@@ -0,0 +1,1476 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/oyster**](README.md)
+
+---
+
+[@fungi.computer/oyster](modules.md) / build
+
+# build
+
+## Classes
+
+### AppPublisherError
+
+Closed failure boundary for the four private composition stages.
+
+#### Extends
+
+- `Error`
+
+#### Constructors
+
+##### Constructor
+
+```ts
+new AppPublisherError(stage, options?): AppPublisherError;
+```
+
+###### Parameters
+
+| Parameter  | Type                                      |
+| ---------- | ----------------------------------------- |
+| `stage`    | [`AppPublisherStage`](#apppublisherstage) |
+| `options?` | `ErrorOptions`                            |
+
+###### Returns
+
+[`AppPublisherError`](#apppublishererror)
+
+###### Overrides
+
+```ts
+Error.constructor;
+```
+
+#### Properties
+
+##### \_tag
+
+```ts
+readonly _tag: "AppPublisherError";
+```
+
+##### stage
+
+```ts
+readonly stage: AppPublisherStage;
+```
+
+## Type Aliases
+
+### WorkspaceBuildStep
+
+```ts
+type WorkspaceBuildStep = Schema.Schema.Type<typeof workspaceBuildStepSchema>;
+```
+
+One captured dependency build step.
+
+---
+
+### AppBackendOutput
+
+```ts
+type AppBackendOutput = Readonly<{
+  file: esbuild.OutputFile;
+  inputs: readonly string[];
+}>;
+```
+
+The checked Worker output of one App backend build.
+
+---
+
+### DefinitionEmission
+
+```ts
+type DefinitionEmission = Awaited<ReturnType<typeof createDefinitionEmission>>;
+```
+
+One App backend build and the declaration derived from it.
+
+---
+
+### AppPublisherCoreConfigInput
+
+```ts
+type AppPublisherCoreConfigInput = Schema.Codec.Encoded<
+  typeof AppPublisherCoreConfigSchema
+>;
+```
+
+App identity and caller-selected recipe inputs before normalization.
+
+---
+
+### PinnedRecipe
+
+```ts
+type PinnedRecipe = Schema.Schema.Type<typeof capturedPinnedRecipeSchema>;
+```
+
+Fully resolved recipe with its pinned toolchain.
+
+---
+
+### CapturedSource
+
+```ts
+type CapturedSource = Readonly<{
+  sourceRevision: SourceRevision;
+  sourceTreeDigest: Sha256Digest;
+  snapshotPath: string;
+}>;
+```
+
+A source tree captured into a scoped local snapshot directory.
+
+---
+
+### RawBuildOutput
+
+```ts
+type RawBuildOutput =
+  | Readonly<{
+      kind: "bytes";
+      bytes: Uint8Array;
+    }>
+  | Readonly<{
+      kind: "assets";
+      base: string;
+      assets: readonly object[];
+    }>;
+```
+
+Compiler bytes or a bounded collection of emitted UI assets.
+
+---
+
+### UiBuildOutput
+
+```ts
+type UiBuildOutput =
+  | Readonly<{
+      kind: "html";
+      bytes: Uint8Array;
+    }>
+  | Extract<
+      RawBuildOutput,
+      {
+        kind: "assets";
+      }
+    >;
+```
+
+A complete HTML document or an asset collection.
+
+---
+
+### BuildExecutorOutput
+
+```ts
+type BuildExecutorOutput =
+  | RawBuildOutput
+  | Readonly<{
+      kind: "app";
+      ui: PreparedUiOutput | null;
+      backend: Uint8Array | null;
+    }>;
+```
+
+Raw executor result before the recipe owner assigns App surface meaning.
+
+---
+
+### PreparedUiOutput
+
+```ts
+type PreparedUiOutput =
+  | Readonly<{
+      content: Extract<
+        UiBuildOutput,
+        {
+          kind: "html";
+        }
+      >;
+      mediaType: "text/html; charset=utf-8";
+    }>
+  | Readonly<{
+      content: Extract<
+        UiBuildOutput,
+        {
+          kind: "assets";
+        }
+      >;
+      mediaType: "application/vnd.fungi.app-assets+json";
+    }>;
+```
+
+UI output paired with its immutable artifact media type.
+
+---
+
+### BuildOutput
+
+```ts
+type BuildOutput =
+  | Readonly<{
+      kind: "ui";
+      ui: PreparedUiOutput;
+    }>
+  | Readonly<{
+      kind: "backend";
+      backend: Uint8Array;
+    }>
+  | (Readonly<{
+      kind: "app";
+      ui: PreparedUiOutput;
+      backend: Uint8Array;
+    }> &
+      Readonly<{
+        declaration?: AppDeclaration;
+      }>);
+```
+
+Complete, non-empty App content accepted by immutable artifact writers.
+
+---
+
+### StoredArtifact
+
+```ts
+type StoredArtifact = Readonly<{
+  artifactRef: ArtifactRef;
+  artifactDigest: Sha256Digest;
+}>;
+```
+
+Reference and digest of the persisted App build root.
+
+---
+
+### PreparedCandidate
+
+```ts
+type PreparedCandidate = Readonly<{
+  appId: AppId;
+  releaseId: ReleaseId;
+  output: BuildOutput;
+  provenance: Readonly<{
+    sourceRevision: SourceRevision;
+    sourceTreeDigest: Sha256Digest;
+    buildRecipeDigest: Sha256Digest;
+  }>;
+}>;
+```
+
+A locally captured and built candidate awaiting native artifact/catalog custody.
+
+---
+
+### SourceCapture
+
+```ts
+type SourceCapture = object;
+```
+
+Four structural roles used by the private composition.
+
+#### Properties
+
+##### capture
+
+```ts
+readonly capture: () => Effect.Effect<CapturedSource, unknown, Scope.Scope>;
+```
+
+Acquire a snapshot whose cleanup follows the Effect scope.
+
+###### Returns
+
+`Effect.Effect`\<[`CapturedSource`](#capturedsource), `unknown`, `Scope.Scope`\>
+
+---
+
+### BuildExecutor
+
+```ts
+type BuildExecutor = object;
+```
+
+Compiles captured source and reads its matching declaration.
+
+#### Properties
+
+##### build
+
+```ts
+readonly build: (source, recipe) => Effect.Effect<BuildExecutorOutput, unknown, Scope.Scope>;
+```
+
+Compile only the captured source under its pinned recipe.
+
+###### Parameters
+
+| Parameter | Type                                |
+| --------- | ----------------------------------- |
+| `source`  | [`CapturedSource`](#capturedsource) |
+| `recipe`  | [`PinnedRecipe`](#pinnedrecipe)     |
+
+###### Returns
+
+`Effect.Effect`\<[`BuildExecutorOutput`](#buildexecutoroutput), `unknown`,
+`Scope.Scope`\>
+
+##### declaration?
+
+```ts
+readonly optional declaration?: (source, recipe) => Effect.Effect<AppDeclaration, unknown>;
+```
+
+Read the App's declaration from the same captured tree. Every App, a fork
+included, declares through its own source; there is no other source.
+
+###### Parameters
+
+| Parameter | Type                                |
+| --------- | ----------------------------------- |
+| `source`  | [`CapturedSource`](#capturedsource) |
+| `recipe`  | [`PinnedRecipe`](#pinnedrecipe)     |
+
+###### Returns
+
+`Effect.Effect`\<`AppDeclaration`, `unknown`\>
+
+---
+
+### ArtifactWriter
+
+```ts
+type ArtifactWriter = object;
+```
+
+Persists one complete App build as immutable artifacts.
+
+#### Properties
+
+##### write
+
+```ts
+readonly write: (output) => Effect.Effect<StoredArtifact, unknown>;
+```
+
+Persist the App root and return its reference and digest.
+
+###### Parameters
+
+| Parameter | Type                          |
+| --------- | ----------------------------- |
+| `output`  | [`BuildOutput`](#buildoutput) |
+
+###### Returns
+
+`Effect.Effect`\<[`StoredArtifact`](#storedartifact), `unknown`\>
+
+---
+
+### ReleaseCreator
+
+```ts
+type ReleaseCreator = Pick<AppReleaseCatalog, "createRelease">;
+```
+
+Release catalog role needed to record a built candidate.
+
+---
+
+### AppPublisherOptions
+
+```ts
+type AppPublisherOptions = Readonly<{
+  config: AppPublisherCoreConfigInput;
+  releaseCatalog: ReleaseCreator;
+  sourceCapture: SourceCapture;
+  buildExecutor: BuildExecutor;
+  artifactWriter: ArtifactWriter;
+}>;
+```
+
+Captured build inputs and the resource owners used to publish a candidate.
+
+---
+
+### AppPublisher
+
+```ts
+type AppPublisher = Readonly<{
+  createCandidate: (releaseId) => Effect.Effect<Release, AppPublisherError>;
+}>;
+```
+
+Builds and records immutable App Release candidates.
+
+---
+
+### AppCandidatePreparer
+
+```ts
+type AppCandidatePreparer = Readonly<{
+  prepareCandidate: (
+    releaseId,
+  ) => Effect.Effect<PreparedCandidate, AppPublisherError>;
+}>;
+```
+
+Builds a candidate before artifact storage and catalog publication.
+
+---
+
+### AppPublisherStage
+
+```ts
+type AppPublisherStage =
+  "configuration" | "source" | "build" | "artifact" | "release";
+```
+
+The bounded stages reported by AppPublisherError.
+
+---
+
+### CapturedConfig
+
+```ts
+type CapturedConfig = Readonly<{
+  appId: AppId;
+  recipe: PinnedRecipe;
+  buildRecipeDigest: Sha256Digest;
+}>;
+```
+
+App identity and normalized recipe with its digest.
+
+---
+
+### FirstPartyAppSourceDistribution
+
+```ts
+type FirstPartyAppSourceDistribution = Readonly<{
+  appId: AppId;
+  sourceRevision: SourceRevision;
+  sourceTreeDigest: ReturnType<typeof parseSha256Digest>;
+  appDirectory: string;
+  files: readonly Readonly<{
+    path: string;
+    contents: Uint8Array;
+  }>[];
+}>;
+```
+
+A first-party editable source tree ready to seed into an Artifacts template.
+
+---
+
+### LocalAppPublisherOptions
+
+```ts
+type LocalAppPublisherOptions = Readonly<{
+  config: unknown;
+  releaseCatalog: ReleaseCreator;
+}>;
+```
+
+Local Git, recipe and artifact directory configuration with a Release catalog.
+
+---
+
+### WorkspaceBuildPolicy
+
+```ts
+type WorkspaceBuildPolicy = Schema.Schema.Type<
+  typeof workspaceBuildPolicySchema
+>;
+```
+
+The build policy one manifest declares.
+
+---
+
+### WorkspaceBuild
+
+```ts
+type WorkspaceBuild = Readonly<{
+  directory: string;
+  packageName: string;
+  react: boolean;
+  shellEntry?: string;
+  dependencies: readonly string[];
+  steps: readonly WorkspaceBuildStep[];
+}>;
+```
+
+One App page build derived from its manifests and package graph.
+
+## Variables
+
+### workspaceBuildStepSchema
+
+```ts
+const workspaceBuildStepSchema: Union<
+  readonly [
+    Struct<{
+      kind: Literal<"typescript">;
+      config: String;
+    }>,
+    Struct<{
+      kind: Literal<"tailwind">;
+      input: String;
+      output: String;
+    }>,
+  ]
+>;
+```
+
+One captured dependency build step. Paths are relative to the captured snapshot
+root. A TypeScript step compiles one config; a Tailwind step compiles one
+stylesheet input into its output (the same path for an App's own stylesheet,
+which compiles in place).
+
+---
+
+### pinnedRecipeSchema
+
+```ts
+const pinnedRecipeSchema: Struct<{
+  kind: optional<Literals<readonly ["bundled-html", "source-html"]>>;
+  entry: String;
+  assets: optional<
+    Struct<{
+      maxManifestBytes: Number;
+      maxObjects: Number;
+      maxObjectBytes: Number;
+      maxTotalBytes: Number;
+    }>
+  >;
+  assetBase: optionalKey<String>;
+  backend: Union<
+    readonly [
+      Null,
+      Struct<{
+        entry: optional<String>;
+        runtime: Struct<{
+          kind: Literal<"durable-facet">;
+          stateSchema: Number;
+        }>;
+        compatibilityDate: String;
+        exportName: String;
+      }>,
+    ]
+  >;
+  maxOutputBytes: Number;
+}>;
+```
+
+Canonical recipe policy shared by core and the local adapter.
+
+---
+
+### AppPublisherCoreConfigSchema
+
+```ts
+const AppPublisherCoreConfigSchema: Struct<{
+  appId: refine<AppId, String>;
+  recipe: Struct<{
+     kind: optional<Literals<readonly ["bundled-html", "source-html"]>>;
+     entry: String;
+     assets: optional<Struct<{
+        maxManifestBytes: Number;
+        maxObjects: Number;
+        maxObjectBytes: Number;
+        maxTotalBytes: Number;
+     }>>;
+     assetBase: optionalKey<String>;
+     backend: Union<readonly [Null, Struct<{
+        entry: optional<String>;
+        runtime: Struct<{
+           kind: Literal<...>;
+           stateSchema: Number;
+        }>;
+        compatibilityDate: String;
+        exportName: String;
+     }>]>;
+     maxOutputBytes: Number;
+  }>;
+}>;
+```
+
+Core configuration contains only immutable App identity and recipe policy.
+
+---
+
+### appBackendExportConditions
+
+```ts
+const appBackendExportConditions: readonly string[];
+```
+
+Package-export conditions used by the pinned Workers builder.
+
+---
+
+### capturedPinnedRecipeSchema
+
+```ts
+const capturedPinnedRecipeSchema: Struct<{
+  kind: optional<Literals<readonly ["bundled-html", "source-html"]>>;
+  bundle: Literal<true>;
+  entry: String;
+  format: Literals<readonly ["html", "esm", "assets"]>;
+  assets: optional<
+    Struct<{
+      maxManifestBytes: Number;
+      maxObjects: Number;
+      maxObjectBytes: Number;
+      maxTotalBytes: Number;
+    }>
+  >;
+  assetBase: optionalKey<String>;
+  toolchain: $Record<String, String>;
+  maxOutputBytes: Number;
+  platform: Literals<readonly ["browser", "neutral"]>;
+  backend: Union<
+    readonly [
+      Null,
+      Struct<{
+        entry: optional<String>;
+        runtime: Struct<{
+          kind: Literal<"durable-facet">;
+          stateSchema: Number;
+        }>;
+        compatibilityDate: String;
+        exportName: String;
+      }>,
+    ]
+  >;
+  target: Tuple<readonly [Literal<"es2022">]>;
+}>;
+```
+
+Persisted, fully resolved recipe including its code-owned toolchain.
+
+---
+
+### bundledHtmlRecipe
+
+```ts
+const bundledHtmlRecipe: Readonly<{
+  kind: "bundled-html";
+  toolchain: Readonly<{
+    recipe: "captured-bundled-html-v1";
+  }>;
+  limits: Readonly<{
+    maxManifestBytes: 1048576;
+    maxObjects: 1024;
+    maxObjectBytes: 16777216;
+    maxTotalBytes: 67108864;
+  }>;
+  extensions: readonly string[];
+}>;
+```
+
+Engine/toolchain-independent input: an already bundled, captured directory. The
+producer owns compilation; Publisher never discovers its build scripts. These
+ceilings cannot be raised by a publication request.
+
+---
+
+### dependencyBuildProgram
+
+```ts
+const dependencyBuildProgram: string;
+```
+
+Captured-dependency build program with guarded filesystem access.
+
+---
+
+### workspaceBuildPolicySchema
+
+```ts
+const workspaceBuildPolicySchema: Struct<{
+  react: optional<Boolean>;
+  shellEntry: optional<String>;
+  packageStylesheets: optional<$Array<String>>;
+  stylesheets: optional<$Array<String>>;
+  typescript: optional<$Array<String>>;
+  stylesheet: optional<
+    Struct<{
+      input: String;
+      output: String;
+    }>
+  >;
+}>;
+```
+
+`package.json#fungi.build`. An App manifest (the manifest nearest the entry)
+declares how its page builds: `react`, `shellEntry`, the workspace packages
+whose declared stylesheets compile first (`packageStylesheets`) and its own
+`stylesheets`, compiled in place, in order. A workspace package declares its
+build products: extra TypeScript configs compiled after its
+`tsconfig.build.json`, and its stylesheet input and output. Every path is
+relative to the manifest that declares it.
+
+---
+
+### workspaceProjectsArguments
+
+```ts
+const workspaceProjectsArguments: readonly string[];
+```
+
+The pnpm arguments that list a source tree's workspace projects.
+
+## Functions
+
+### readBundledHtml()
+
+```ts
+function readBundledHtml(
+  snapshot,
+  recipe,
+): Promise<
+  Readonly<{
+    kind: "assets";
+    base: string;
+    assets: readonly object[];
+  }>
+>;
+```
+
+Read only regular files under the captured entry's directory. No scripts,
+dependency hydration, URL rewriting, or access to the producer's live build.
+
+#### Parameters
+
+| Parameter                        | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `snapshot`                       | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe`                         | \{ `kind?`: `"bundled-html"` \| `"source-html"`; `bundle`: `true`; `entry`: `string`; `format`: `"html"` \| `"assets"` \| `"esm"`; `assets?`: \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}; `assetBase?`: `string`; `toolchain`: \{ \[`key`: `string`\]: `string`; \}; `maxOutputBytes`: `number`; `platform`: `"browser"` \| `"neutral"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \} |
+| `recipe.kind?`                   | `"bundled-html"` \| `"source-html"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `recipe.bundle`                  | `true`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `recipe.entry`                   | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.format`                  | `"html"` \| `"assets"` \| `"esm"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `recipe.assets?`                 | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `recipe.assets.maxManifestBytes` | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.assets.maxObjects`       | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.assets.maxObjectBytes`   | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.assets.maxTotalBytes`    | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.assetBase?`              | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.toolchain`               | \{ \[`key`: `string`\]: `string`; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `recipe.maxOutputBytes`          | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.platform`                | `"browser"` \| `"neutral"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `recipe.backend`                 | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `recipe.target`                  | readonly \[`"es2022"`\]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+
+#### Returns
+
+`Promise`\<`Readonly`\<\{ `kind`: `"assets"`; `base`: `string`; `assets`:
+readonly `object`[]; \}\>\>
+
+---
+
+### createDefinitionEmission()
+
+```ts
+function createDefinitionEmission(source, recipe): Promise<{
+  entryPoints: (entry) => Record<string, string>;
+  outdir: string;
+  plugins: Plugin[];
+  worker: AppBackendOutput;
+  declare: Promise<Readonly<{
+     api?: Readonly<{
+        methods: Readonly<Record<string, Readonly<...>>>;
+        toolFamily?: Readonly<{
+           name: ...;
+           list: ...;
+           call: ...;
+        }>;
+        events?: Readonly<Record<..., ...>>;
+     }>;
+     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 string[];
+     }>[];
+     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?: string;
+        sigil?: string;
+        projections?: Readonly<...>;
+     }>[];
+     gills?: readonly Readonly<{
+        id: string;
+        source: string;
+        title: string;
+        params?: readonly ...[];
+        watch?: AppGillWatch;
+        desktop?: Readonly<...>;
+     }>[];
+     backend?: Readonly<{
+        bindings: readonly Readonly<{
+           name: ...;
+           operations: ...;
+        }>[];
+        sync?: Readonly<{
+           method: ...;
+        }>;
+     }>;
+  }>>;
+}>;
+```
+
+Build one App backend and derive its declaration from that same build.
+
+A declared `fungi.backendDefinition` adds a second, build-only entry that
+derives the declaration with `buildAppDeclaration(appBackend, fungi.app)`.
+esbuild loads every path and resolves every import once per build, so the Worker
+serves exactly the definition bytes and module resolution the declaration
+describes. The Worker output is then checked to include that definition and no
+build-only declaration code, and the declaration output to import nothing at
+runtime.
+
+#### Parameters
+
+| Parameter                        | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `source`                         | [`CapturedSource`](#capturedsource)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `recipe`                         | \{ `kind?`: `"bundled-html"` \| `"source-html"`; `bundle`: `true`; `entry`: `string`; `format`: `"html"` \| `"assets"` \| `"esm"`; `assets?`: \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}; `assetBase?`: `string`; `toolchain`: \{ \[`key`: `string`\]: `string`; \}; `maxOutputBytes`: `number`; `platform`: `"browser"` \| `"neutral"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \} |
+| `recipe.kind?`                   | `"bundled-html"` \| `"source-html"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `recipe.bundle`                  | `true`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `recipe.entry`                   | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.format`                  | `"html"` \| `"assets"` \| `"esm"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `recipe.assets?`                 | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `recipe.assets.maxManifestBytes` | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.assets.maxObjects`       | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.assets.maxObjectBytes`   | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.assets.maxTotalBytes`    | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.assetBase?`              | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.toolchain`               | \{ \[`key`: `string`\]: `string`; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `recipe.maxOutputBytes`          | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.platform`                | `"browser"` \| `"neutral"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `recipe.backend`                 | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `recipe.target`                  | readonly \[`"es2022"`\]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+
+#### Returns
+
+`Promise`\<\{ `entryPoints`: (`entry`) => `Record`\<`string`, `string`\>;
+`outdir`: `string`; `plugins`: `Plugin`[]; `worker`:
+[`AppBackendOutput`](#appbackendoutput); `declare`: `Promise`\<`Readonly`\<\{
+`api?`: `Readonly`\<\{ `methods`: `Readonly`\<`Record`\<`string`,
+`Readonly`\<...\>\>\>; `toolFamily?`: `Readonly`\<\{ `name`: ...; `list`: ...;
+`call`: ...; \}\>; `events?`: `Readonly`\<`Record`\<..., ...\>\>; \}\>;
+`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 `string`[]; \}\>[];
+`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?`: `string`;
+`sigil?`: `string`; `projections?`: `Readonly`\<...\>; \}\>[]; `gills?`:
+readonly `Readonly`\<\{ `id`: `string`; `source`: `string`; `title`: `string`;
+`params?`: readonly ...[]; `watch?`: `AppGillWatch`; `desktop?`:
+`Readonly`\<...\>; \}\>[]; `backend?`: `Readonly`\<\{ `bindings`: readonly
+`Readonly`\<\{ `name`: ...; `operations`: ...; \}\>[]; `sync?`: `Readonly`\<\{
+`method`: ...; \}\>; \}\>; \}\>\>; \}\>
+
+---
+
+### digestPinnedRecipe()
+
+```ts
+function digestPinnedRecipe(recipe): Sha256Digest;
+```
+
+Hash every captured build and output-policy input in the Publisher recipe.
+
+#### Parameters
+
+| Parameter                        | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `recipe`                         | \{ `kind?`: `"bundled-html"` \| `"source-html"`; `bundle`: `true`; `entry`: `string`; `format`: `"html"` \| `"assets"` \| `"esm"`; `assets?`: \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}; `assetBase?`: `string`; `toolchain`: \{ \[`key`: `string`\]: `string`; \}; `maxOutputBytes`: `number`; `platform`: `"browser"` \| `"neutral"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \} |
+| `recipe.kind?`                   | `"bundled-html"` \| `"source-html"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `recipe.bundle`                  | `true`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `recipe.entry`                   | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.format`                  | `"html"` \| `"assets"` \| `"esm"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `recipe.assets?`                 | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `recipe.assets.maxManifestBytes` | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.assets.maxObjects`       | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.assets.maxObjectBytes`   | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.assets.maxTotalBytes`    | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.assetBase?`              | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.toolchain`               | \{ \[`key`: `string`\]: `string`; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `recipe.maxOutputBytes`          | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `recipe.platform`                | `"browser"` \| `"neutral"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `recipe.backend`                 | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `recipe.target`                  | readonly \[`"es2022"`\]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+
+#### Returns
+
+`Sha256Digest`
+
+---
+
+### normalizeAppPublisherRecipe()
+
+```ts
+function normalizeAppPublisherRecipe(input): Readonly<{
+  recipe: PinnedRecipe;
+  buildRecipeDigest: Sha256Digest;
+}>;
+```
+
+Decode and normalize Publisher-owned recipe policy for durable seed proof.
+
+#### Parameters
+
+| Parameter                              | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `input`                                | \{ `appId`: `string`; `recipe`: \{ `kind?`: `"bundled-html"` \| `"source-html"`; `entry`: `string`; `assets?`: \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}; `assetBase?`: `string`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `maxOutputBytes`: `number`; \}; \} |
+| `input.appId`                          | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `input.recipe`                         | \{ `kind?`: `"bundled-html"` \| `"source-html"`; `entry`: `string`; `assets?`: \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}; `assetBase?`: `string`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `maxOutputBytes`: `number`; \}                                     |
+| `input.recipe.kind?`                   | `"bundled-html"` \| `"source-html"`                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `input.recipe.entry`                   | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `input.recipe.assets?`                 | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}                                                                                                                                                                                                                                                                                                                                                            |
+| `input.recipe.assets.maxManifestBytes` | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `input.recipe.assets.maxObjects`       | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `input.recipe.assets.maxObjectBytes`   | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `input.recipe.assets.maxTotalBytes`    | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `input.recipe.assetBase?`              | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `input.recipe.backend`                 | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`                                                                                                                                                                                                                                                                                                           |
+| `input.recipe.maxOutputBytes`          | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+
+#### Returns
+
+`Readonly`\<\{ `recipe`: [`PinnedRecipe`](#pinnedrecipe); `buildRecipeDigest`:
+`Sha256Digest`; \}\>
+
+---
+
+### createAppCandidatePreparer()
+
+```ts
+function createAppCandidatePreparer(options): AppCandidatePreparer;
+```
+
+Construct one private App Publisher with copied core configuration and roles.
+
+#### Parameters
+
+| Parameter | Type                                                                                                          |
+| --------- | ------------------------------------------------------------------------------------------------------------- |
+| `options` | `Pick`\<[`AppPublisherOptions`](#apppublisheroptions), `"config"` \| `"sourceCapture"` \| `"buildExecutor"`\> |
+
+#### Returns
+
+[`AppCandidatePreparer`](#appcandidatepreparer)
+
+---
+
+### createCapturedCandidatePreparer()
+
+```ts
+function createCapturedCandidatePreparer(config, options): AppCandidatePreparer;
+```
+
+Prepare a candidate from a previously captured recipe.
+
+#### Parameters
+
+| Parameter | Type                                                                                            |
+| --------- | ----------------------------------------------------------------------------------------------- |
+| `config`  | [`CapturedConfig`](#capturedconfig)                                                             |
+| `options` | `Pick`\<[`AppPublisherOptions`](#apppublisheroptions), `"sourceCapture"` \| `"buildExecutor"`\> |
+
+#### Returns
+
+[`AppCandidatePreparer`](#appcandidatepreparer)
+
+---
+
+### commitPreparedCandidate()
+
+```ts
+function commitPreparedCandidate(
+  prepared,
+  options,
+): Effect<Release, AppPublisherError>;
+```
+
+Persist a prepared build through the native artifact and App Release owners.
+
+#### Parameters
+
+| Parameter  | Type                                                                                              |
+| ---------- | ------------------------------------------------------------------------------------------------- |
+| `prepared` | [`PreparedCandidate`](#preparedcandidate)                                                         |
+| `options`  | `Pick`\<[`AppPublisherOptions`](#apppublisheroptions), `"artifactWriter"` \| `"releaseCatalog"`\> |
+
+#### Returns
+
+`Effect`\<`Release`, [`AppPublisherError`](#apppublishererror)\>
+
+---
+
+### createAppPublisher()
+
+```ts
+function createAppPublisher(options): AppPublisher;
+```
+
+Compose capture, compilation, immutable writing and Release recording.
+
+#### Parameters
+
+| Parameter | Type                                          |
+| --------- | --------------------------------------------- |
+| `options` | [`AppPublisherOptions`](#apppublisheroptions) |
+
+#### Returns
+
+[`AppPublisher`](#apppublisher)
+
+---
+
+### repositoryEnvironment()
+
+```ts
+function repositoryEnvironment(): ProcessEnv;
+```
+
+Run a nested repository without inheriting the caller's Git checkout.
+
+#### Returns
+
+`ProcessEnv`
+
+---
+
+### artifactsGitEnvironment()
+
+```ts
+function artifactsGitEnvironment(token): ProcessEnv;
+```
+
+Git environment for one authenticated Artifacts fetch; caller validates token.
+
+#### Parameters
+
+| Parameter | Type     |
+| --------- | -------- |
+| `token`   | `string` |
+
+#### Returns
+
+`ProcessEnv`
+
+---
+
+### hostedArtifactsGitRemote()
+
+```ts
+function hostedArtifactsGitRemote(endpoint, repository): string;
+```
+
+Credential-free private route used by the hosted Publisher Git client.
+
+#### Parameters
+
+| Parameter    | Type     |
+| ------------ | -------- |
+| `endpoint`   | `string` |
+| `repository` | `string` |
+
+#### Returns
+
+`string`
+
+---
+
+### boundedBundlePolicy()
+
+```ts
+function boundedBundlePolicy(policy, maxOutputBytes): boolean;
+```
+
+Requests may tighten the catalog bounds, never raise them.
+
+#### Parameters
+
+| Parameter                 | Type                                                                                                               |
+| ------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `policy`                  | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \} |
+| `policy.maxManifestBytes` | `number`                                                                                                           |
+| `policy.maxObjects`       | `number`                                                                                                           |
+| `policy.maxObjectBytes`   | `number`                                                                                                           |
+| `policy.maxTotalBytes`    | `number`                                                                                                           |
+| `maxOutputBytes`          | `number`                                                                                                           |
+
+#### Returns
+
+`boolean`
+
+---
+
+### createLocalSourceCapture()
+
+```ts
+function createLocalSourceCapture(repositoryPath): SourceCapture;
+```
+
+Local proving adapter; accepted source policy is intentionally fixed to main.
+
+#### Parameters
+
+| Parameter        | Type     |
+| ---------------- | -------- |
+| `repositoryPath` | `string` |
+
+#### Returns
+
+[`SourceCapture`](#sourcecapture)
+
+---
+
+### createLocalDirectorySourceCapture()
+
+```ts
+function createLocalDirectorySourceCapture(directory): SourceCapture;
+```
+
+Capture saved App files for local authoring without modifying the customer's
+repository. Provenance names the exact temporary Git snapshot, not an existing
+customer commit. Dependencies and local credentials are not source inputs.
+
+#### Parameters
+
+| Parameter   | Type     |
+| ----------- | -------- |
+| `directory` | `string` |
+
+#### Returns
+
+[`SourceCapture`](#sourcecapture)
+
+---
+
+### createArtifactsSourceCapture()
+
+```ts
+function createArtifactsSourceCapture(options): SourceCapture;
+```
+
+Capture an exact Artifacts commit through a trusted host's credential-free Git
+URL.
+
+#### Parameters
+
+| Parameter                | Type                                                                             |
+| ------------------------ | -------------------------------------------------------------------------------- |
+| `options`                | \{ `remote`: `string`; `token`: `string`; `sourceRevision`: `SourceRevision`; \} |
+| `options.remote`         | `string`                                                                         |
+| `options.token`          | `string`                                                                         |
+| `options.sourceRevision` | `SourceRevision`                                                                 |
+
+#### Returns
+
+[`SourceCapture`](#sourcecapture)
+
+---
+
+### createLocalCommitSourceCapture()
+
+```ts
+function createLocalCommitSourceCapture(
+  repositoryPath,
+  sourceRevision,
+): SourceCapture;
+```
+
+Capture one explicit committed revision without manufacturing a branch.
+
+#### Parameters
+
+| Parameter        | Type             |
+| ---------------- | ---------------- |
+| `repositoryPath` | `string`         |
+| `sourceRevision` | `SourceRevision` |
+
+#### Returns
+
+[`SourceCapture`](#sourcecapture)
+
+---
+
+### createFirstPartyAppSourceDistribution()
+
+```ts
+function createFirstPartyAppSourceDistribution(options): Effect<
+  Readonly<{
+    appId: AppId;
+    sourceRevision: SourceRevision;
+    sourceTreeDigest: Sha256Digest;
+    appDirectory: string;
+    files: readonly Readonly<{
+      path: string;
+      contents: Uint8Array;
+    }>[];
+  }>,
+  unknown
+>;
+```
+
+Project one pinned first-party App and its pnpm workspace dependency graph
+without changing upstream files or manufacturing Git history. The caller records
+the returned provenance on the Artifacts template seed commit.
+
+#### Parameters
+
+| Parameter        | Type                                                                                       |
+| ---------------- | ------------------------------------------------------------------------------------------ |
+| `options`        | \{ `appId`: `string`; `source`: [`CapturedSource`](#capturedsource); `entry`: `string`; \} |
+| `options.appId`  | `string`                                                                                   |
+| `options.source` | [`CapturedSource`](#capturedsource)                                                        |
+| `options.entry`  | `string`                                                                                   |
+
+#### Returns
+
+`Effect`\<`Readonly`\<\{ `appId`: `AppId`; `sourceRevision`: `SourceRevision`;
+`sourceTreeDigest`: `Sha256Digest`; `appDirectory`: `string`; `files`: readonly
+`Readonly`\<\{ `path`: `string`; `contents`: `Uint8Array`; \}\>[]; \}\>,
+`unknown`\>
+
+---
+
+### localSnapshotBuildOptions()
+
+```ts
+function localSnapshotBuildOptions(source, recipe, emission): BuildOptions;
+```
+
+Exact pinned esbuild options shared by local builds and artifact-budget proofs.
+
+#### Parameters
+
+| Parameter                        | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Description                                                                     |
+| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
+| `source`                         | [`CapturedSource`](#capturedsource)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | -                                                                               |
+| `recipe`                         | \{ `kind?`: `"bundled-html"` \| `"source-html"`; `bundle`: `true`; `entry`: `string`; `format`: `"html"` \| `"assets"` \| `"esm"`; `assets?`: \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}; `assetBase?`: `string`; `toolchain`: \{ \[`key`: `string`\]: `string`; \}; `maxOutputBytes`: `number`; `platform`: `"browser"` \| `"neutral"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | -                                                                               |
+| `recipe.kind?`                   | `"bundled-html"` \| `"source-html"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | -                                                                               |
+| `recipe.bundle`                  | `true`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | -                                                                               |
+| `recipe.entry`                   | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | -                                                                               |
+| `recipe.format`                  | `"html"` \| `"assets"` \| `"esm"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | -                                                                               |
+| `recipe.assets?`                 | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | -                                                                               |
+| `recipe.assets.maxManifestBytes` | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | -                                                                               |
+| `recipe.assets.maxObjects`       | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | -                                                                               |
+| `recipe.assets.maxObjectBytes`   | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | -                                                                               |
+| `recipe.assets.maxTotalBytes`    | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | -                                                                               |
+| `recipe.assetBase?`              | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | -                                                                               |
+| `recipe.toolchain`               | \{ \[`key`: `string`\]: `string`; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | -                                                                               |
+| `recipe.maxOutputBytes`          | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | -                                                                               |
+| `recipe.platform`                | `"browser"` \| `"neutral"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | -                                                                               |
+| `recipe.backend`                 | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | -                                                                               |
+| `recipe.target`                  | readonly \[`"es2022"`\]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | -                                                                               |
+| `emission`                       | \{ `entryPoints`: (`entry`) => `Record`\<`string`, `string`\>; `outdir`: `string`; `plugins`: `Plugin`[]; `worker`: [`AppBackendOutput`](#appbackendoutput); `declare`: `Promise`\<`Readonly`\<\{ `api?`: `Readonly`\<\{ `methods`: `Readonly`\<`Record`\<`string`, `Readonly`\<\{ `description`: ...; `input`: ...; `output`: ...; `effect`: ...; `requires`: ...; `pending?`: ...; `hidden?`: ...; `anonymous?`: ...; \}\>\>\>; `toolFamily?`: `Readonly`\<\{ `name`: `string`; `list`: `string`; `call`: `string`; \}\>; `events?`: `Readonly`\<`Record`\<`string`, `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 `string`[]; \}\>[]; `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 (`"team"` \| `"member"`)[]; `maxBytes`: `number`; \}\>[]; `commands?`: readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`; `description?`: `string`; `sigil?`: `string`; `projections?`: `Readonly`\<\{ `bindings?`: ...; `agent?`: ...; `help?`: ...; `menu?`: ...; `palette?`: ...; `slash?`: ...; \}\>; \}\>[]; `gills?`: readonly `Readonly`\<\{ `id`: `string`; `source`: `string`; `title`: `string`; `params?`: readonly `Readonly`\<...\>[]; `watch?`: `AppGillWatch`; `desktop?`: `Readonly`\<\{ `sizes`: ...; \}\>; \}\>[]; `backend?`: `Readonly`\<\{ `bindings`: readonly `Readonly`\<\{ `name`: ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ...; `operations`: readonly ...[]; \}\>[]; `sync?`: `Readonly`\<\{ `method`: `string`; \}\>; \}\>; \}\>\>; \} | -                                                                               |
+| `emission.entryPoints`           | (`entry`) => `Record`\<`string`, `string`\>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Entries for the one backend build: the Worker and, if defined, its declaration. |
+| `emission.outdir`                | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | -                                                                               |
+| `emission.plugins`               | `Plugin`[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | -                                                                               |
+| `emission.worker`                | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| `emission.declare`               | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+
+#### Returns
+
+`BuildOptions`
+
+---
+
+### createLocalBuildExecutor()
+
+```ts
+function createLocalBuildExecutor(options?): BuildExecutor;
+```
+
+Local proving adapter; it builds only the captured extracted snapshot.
+
+#### Parameters
+
+| Parameter | Type                                                    |
+| --------- | ------------------------------------------------------- |
+| `options` | `Readonly`\<\{ `packageStoreDirectory?`: `string`; \}\> |
+
+#### Returns
+
+[`BuildExecutor`](#buildexecutor)
+
+---
+
+### createLocalArtifactWriter()
+
+```ts
+function createLocalArtifactWriter(artifactRoot, assetPolicy?): ArtifactWriter;
+```
+
+Local proving adapter; the configured root is private and write-once.
+
+#### Parameters
+
+| Parameter                       | Type                                                                                                               |
+| ------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `artifactRoot`                  | `string`                                                                                                           |
+| `assetPolicy?`                  | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \} |
+| `assetPolicy.maxManifestBytes?` | `number`                                                                                                           |
+| `assetPolicy.maxObjects?`       | `number`                                                                                                           |
+| `assetPolicy.maxObjectBytes?`   | `number`                                                                                                           |
+| `assetPolicy.maxTotalBytes?`    | `number`                                                                                                           |
+
+#### Returns
+
+[`ArtifactWriter`](#artifactwriter)
+
+---
+
+### createLocalAppPublisher()
+
+```ts
+function createLocalAppPublisher(options): AppPublisher;
+```
+
+Construct the complete local proving adapter around the provider-neutral core.
+
+#### Parameters
+
+| Parameter | Type                                                    |
+| --------- | ------------------------------------------------------- |
+| `options` | [`LocalAppPublisherOptions`](#localapppublisheroptions) |
+
+#### Returns
+
+[`AppPublisher`](#apppublisher)
+
+---
+
+### frozenSnapshotInstallArguments()
+
+```ts
+function frozenSnapshotInstallArguments(packageStoreDirectory?): string[];
+```
+
+Frozen hydration policy. Cached bytes are verified and copied into each
+snapshot.
+
+#### Parameters
+
+| Parameter                | Type     |
+| ------------------------ | -------- |
+| `packageStoreDirectory?` | `string` |
+
+#### Returns
+
+`string`[]
+
+---
+
+### resolveWorkspaceBuild()
+
+```ts
+function resolveWorkspaceBuild(options): Promise<
+  Readonly<{
+    directory: string;
+    packageName: string;
+    react: boolean;
+    shellEntry?: string;
+    dependencies: readonly string[];
+    steps: readonly (
+      | {
+          kind: "typescript";
+          config: string;
+        }
+      | {
+          kind: "tailwind";
+          input: string;
+          output: string;
+        }
+    )[];
+  }>
+>;
+```
+
+Derive one App's page build from the captured source alone: the manifest nearest
+`entry` declares the App policy, the owning pnpm workspace's runtime
+`workspace:` dependencies give the compile order, and each dependency's manifest
+declares its own extra build products.
+
+#### Parameters
+
+| Parameter          | Type                                                             | Description                                                     |
+| ------------------ | ---------------------------------------------------------------- | --------------------------------------------------------------- |
+| `options`          | \{ `root`: `string`; `entry`: `string`; `projects`: `string`; \} | -                                                               |
+| `options.root`     | `string`                                                         | -                                                               |
+| `options.entry`    | `string`                                                         | -                                                               |
+| `options.projects` | `string`                                                         | `pnpm ls -r --depth -1 --json` output for the same source tree. |
+
+#### Returns
+
+`Promise`\<`Readonly`\<\{ `directory`: `string`; `packageName`: `string`;
+`react`: `boolean`; `shellEntry?`: `string`; `dependencies`: readonly
+`string`[]; `steps`: readonly ( \| \{ `kind`: `"typescript"`; `config`:
+`string`; \} \| \{ `kind`: `"tailwind"`; `input`: `string`; `output`: `string`;
+\})[]; \}\>\>