@fungi.computer/oyster 0.37.1 → 0.38.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (86) hide show
  1. package/README.md +5 -4
  2. package/dist/agents.js +9 -2
  3. package/dist/app-builds.d.ts +1 -1
  4. package/dist/app-region.d.ts +94 -0
  5. package/dist/app-region.js +316 -0
  6. package/dist/authorization.d.ts +58 -9
  7. package/dist/authorization.js +56 -11
  8. package/dist/boot-host-script.js +1 -1
  9. package/dist/build/candidate-builder.d.ts +1 -1
  10. package/dist/build/candidate-cli.mjs +284 -17
  11. package/dist/build/effect.d.ts +3 -3
  12. package/dist/build/submission-contract.d.ts +1 -1
  13. package/dist/build/workspace-build.d.ts +2 -2
  14. package/dist/channels/discord-replies.d.ts +8 -1
  15. package/dist/channels/discord-replies.js +80 -29
  16. package/dist/cloudflare.d.ts +1 -0
  17. package/dist/cloudflare.js +11 -0
  18. package/dist/credential-migration-001.d.ts +14 -0
  19. package/dist/credential-migration-001.js +13 -0
  20. package/dist/credential-migration-002.d.ts +38 -0
  21. package/dist/credential-migration-002.js +74 -0
  22. package/dist/embed-metafiles.js +2 -2
  23. package/dist/embed-scripts.js +1 -1
  24. package/dist/host.d.ts +2 -0
  25. package/dist/host.js +20 -1
  26. package/dist/index.d.ts +15 -1
  27. package/dist/index.js +19 -0
  28. package/dist/invocation.d.ts +165 -0
  29. package/dist/invocation.js +67 -0
  30. package/dist/keys.d.ts +4 -3
  31. package/dist/keys.js +5 -4
  32. package/dist/mcp-owner.d.ts +4 -3
  33. package/dist/mcp-owner.js +3 -2
  34. package/dist/page/mount.js +5 -1
  35. package/dist/page/region.d.ts +6 -0
  36. package/dist/page/region.js +12 -0
  37. package/dist/page-config.d.ts +2 -0
  38. package/dist/page-config.js +2 -0
  39. package/dist/page-script.js +3 -3
  40. package/dist/source/seed-receipt.d.ts +1 -1
  41. package/dist/source/template-seed.d.ts +1 -1
  42. package/dist/standalone/agent-connections.d.ts +49 -1
  43. package/dist/standalone/agent-connections.js +101 -12
  44. package/dist/standalone/agent-self.js +2 -1
  45. package/dist/standalone/agents.d.ts +7 -3
  46. package/dist/standalone/agents.js +42 -19
  47. package/dist/standalone/computer-fleet.d.ts +12 -6
  48. package/dist/standalone/computer-fleet.js +70 -29
  49. package/dist/standalone/computer.js +39 -14
  50. package/dist/standalone/instance.d.ts +3 -1
  51. package/dist/standalone/instance.js +8 -0
  52. package/dist/standalone/model-key-vault.d.ts +33 -4
  53. package/dist/standalone/model-key-vault.js +74 -17
  54. package/dist/standalone/preview.js +11 -10
  55. package/dist/standalone/try-cli.d.ts +12 -2
  56. package/dist/standalone/try-cli.js +170 -32
  57. package/dist/standalone/try-worker.d.ts +2 -0
  58. package/dist/standalone/try-worker.js +15 -0
  59. package/dist/standalone/worker.js +3 -3
  60. package/dist/standalone/workflow-host.d.ts +1 -1
  61. package/dist/standalone/workflows.d.ts +3 -3
  62. package/dist/standalone/workflows.js +7 -0
  63. package/dist/testing/capabilities.d.ts +2 -0
  64. package/dist/testing/capabilities.js +2 -0
  65. package/dist/webhook-custody.d.ts +14 -3
  66. package/dist/webhook-custody.js +165 -43
  67. package/dist/webhooks.d.ts +1 -1
  68. package/dist/webhooks.js +15 -3
  69. package/dist/workers-git.d.ts +24 -8
  70. package/dist/workers-git.js +105 -15
  71. package/dist/workers.d.ts +16 -0
  72. package/dist/workers.js +95 -5
  73. package/docs/api/apps.md +31 -31
  74. package/docs/api/authorization.md +119 -17
  75. package/docs/api/build-contract.md +8 -8
  76. package/docs/api/build.md +163 -174
  77. package/docs/api/cloudflare.md +171 -0
  78. package/docs/api/host.md +1 -0
  79. package/docs/api/index.md +23 -0
  80. package/docs/api/invocation.md +623 -23
  81. package/docs/api/keys.md +6 -6
  82. package/docs/api/pack.md +3 -3
  83. package/docs/api/page/mount.md +22 -20
  84. package/docs/api/workers-git.md +273 -157
  85. package/docs/api/workers.md +257 -175
  86. package/package.json +19 -18
package/docs/api/build.md CHANGED
@@ -720,7 +720,7 @@ const pinnedRecipeSchema: Struct<{
720
720
  Struct<{
721
721
  entry: optional<String>;
722
722
  runtime: Struct<{
723
- kind: Literal<"durable-facet">;
723
+ kind: Literals<readonly ["durable-facet", "region"]>;
724
724
  stateSchema: Number;
725
725
  }>;
726
726
  compatibilityDate: String;
@@ -754,7 +754,7 @@ const AppPublisherCoreConfigSchema: Struct<{
754
754
  backend: Union<readonly [Null, Struct<{
755
755
  entry: optional<String>;
756
756
  runtime: Struct<{
757
- kind: Literal<...>;
757
+ kind: Literals<...>;
758
758
  stateSchema: Number;
759
759
  }>;
760
760
  compatibilityDate: String;
@@ -805,7 +805,7 @@ const capturedPinnedRecipeSchema: Struct<{
805
805
  Struct<{
806
806
  entry: optional<String>;
807
807
  runtime: Struct<{
808
- kind: Literal<"durable-facet">;
808
+ kind: Literals<readonly ["durable-facet", "region"]>;
809
809
  stateSchema: Number;
810
810
  }>;
811
811
  compatibilityDate: String;
@@ -850,32 +850,23 @@ ceilings cannot be raised by a publication request.
850
850
  ```ts
851
851
  const workspaceBuildPolicySchema: Struct<{
852
852
  kind: optional<Literals<readonly ["bundled-html", "source-html"]>>;
853
- assets: optional<
854
- Struct<{
855
- maxManifestBytes: Number;
856
- maxObjects: Number;
857
- maxObjectBytes: Number;
858
- maxTotalBytes: Number;
859
- }>
860
- >;
853
+ assets: optional<Struct<{
854
+ maxManifestBytes: Number;
855
+ maxObjects: Number;
856
+ maxObjectBytes: Number;
857
+ maxTotalBytes: Number;
858
+ }>>;
861
859
  assetBase: optionalKey<String>;
862
860
  entry: optional<String>;
863
- backend: optional<
864
- Union<
865
- readonly [
866
- Null,
867
- Struct<{
868
- entry: optional<String>;
869
- runtime: Struct<{
870
- kind: Literal<"durable-facet">;
871
- stateSchema: Number;
872
- }>;
873
- compatibilityDate: String;
874
- exportName: String;
875
- }>,
876
- ]
877
- >
878
- >;
861
+ backend: optional<Union<readonly [Null, Struct<{
862
+ entry: optional<String>;
863
+ runtime: Struct<{
864
+ kind: Literals<readonly [..., ...]>;
865
+ stateSchema: Number;
866
+ }>;
867
+ compatibilityDate: String;
868
+ exportName: String;
869
+ }>]>>;
879
870
  maxOutputBytes: optional<Number>;
880
871
  react: optional<Boolean>;
881
872
  shellEntry: optional<String>;
@@ -883,12 +874,10 @@ const workspaceBuildPolicySchema: Struct<{
883
874
  stylesheets: optional<$Array<String>>;
884
875
  typescript: optional<$Array<String>>;
885
876
  script: optional<NonEmptyString>;
886
- stylesheet: optional<
887
- Struct<{
888
- input: String;
889
- output: String;
890
- }>
891
- >;
877
+ stylesheet: optional<Struct<{
878
+ input: String;
879
+ output: String;
880
+ }>>;
892
881
  }>;
893
882
  ```
894
883
 
@@ -990,25 +979,25 @@ dependency hydration, URL rewriting, or access to the producer's live build.
990
979
 
991
980
  #### Parameters
992
981
 
993
- | Parameter | Type |
994
- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
995
- | `snapshot` | `string` |
996
- | `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`: `"neutral"` \| `"browser"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \} |
997
- | `recipe.kind?` | `"bundled-html"` \| `"source-html"` |
998
- | `recipe.bundle` | `true` |
999
- | `recipe.entry` | `string` |
1000
- | `recipe.format` | `"html"` \| `"assets"` \| `"esm"` |
1001
- | `recipe.assets?` | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \} |
1002
- | `recipe.assets.maxManifestBytes` | `number` |
1003
- | `recipe.assets.maxObjects` | `number` |
1004
- | `recipe.assets.maxObjectBytes` | `number` |
1005
- | `recipe.assets.maxTotalBytes` | `number` |
1006
- | `recipe.assetBase?` | `string` |
1007
- | `recipe.toolchain` | \{ \[`key`: `string`\]: `string`; \} |
1008
- | `recipe.maxOutputBytes` | `number` |
1009
- | `recipe.platform` | `"neutral"` \| `"browser"` |
1010
- | `recipe.backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` |
1011
- | `recipe.target` | readonly \[`"es2022"`\] |
982
+ | Parameter | Type |
983
+ | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
984
+ | `snapshot` | `string` |
985
+ | `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`: `"neutral"` \| `"browser"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \} |
986
+ | `recipe.kind?` | `"bundled-html"` \| `"source-html"` |
987
+ | `recipe.bundle` | `true` |
988
+ | `recipe.entry` | `string` |
989
+ | `recipe.format` | `"html"` \| `"assets"` \| `"esm"` |
990
+ | `recipe.assets?` | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \} |
991
+ | `recipe.assets.maxManifestBytes` | `number` |
992
+ | `recipe.assets.maxObjects` | `number` |
993
+ | `recipe.assets.maxObjectBytes` | `number` |
994
+ | `recipe.assets.maxTotalBytes` | `number` |
995
+ | `recipe.assetBase?` | `string` |
996
+ | `recipe.toolchain` | \{ \[`key`: `string`\]: `string`; \} |
997
+ | `recipe.maxOutputBytes` | `number` |
998
+ | `recipe.platform` | `"neutral"` \| `"browser"` |
999
+ | `recipe.backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` |
1000
+ | `recipe.target` | readonly \[`"es2022"`\] |
1012
1001
 
1013
1002
  #### Returns
1014
1003
 
@@ -1116,25 +1105,25 @@ runtime.
1116
1105
 
1117
1106
  #### Parameters
1118
1107
 
1119
- | Parameter | Type |
1120
- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1121
- | `source` | [`CapturedSource`](#capturedsource) |
1122
- | `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`: `"neutral"` \| `"browser"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \} |
1123
- | `recipe.kind?` | `"bundled-html"` \| `"source-html"` |
1124
- | `recipe.bundle` | `true` |
1125
- | `recipe.entry` | `string` |
1126
- | `recipe.format` | `"html"` \| `"assets"` \| `"esm"` |
1127
- | `recipe.assets?` | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \} |
1128
- | `recipe.assets.maxManifestBytes` | `number` |
1129
- | `recipe.assets.maxObjects` | `number` |
1130
- | `recipe.assets.maxObjectBytes` | `number` |
1131
- | `recipe.assets.maxTotalBytes` | `number` |
1132
- | `recipe.assetBase?` | `string` |
1133
- | `recipe.toolchain` | \{ \[`key`: `string`\]: `string`; \} |
1134
- | `recipe.maxOutputBytes` | `number` |
1135
- | `recipe.platform` | `"neutral"` \| `"browser"` |
1136
- | `recipe.backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` |
1137
- | `recipe.target` | readonly \[`"es2022"`\] |
1108
+ | Parameter | Type |
1109
+ | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1110
+ | `source` | [`CapturedSource`](#capturedsource) |
1111
+ | `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`: `"neutral"` \| `"browser"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \} |
1112
+ | `recipe.kind?` | `"bundled-html"` \| `"source-html"` |
1113
+ | `recipe.bundle` | `true` |
1114
+ | `recipe.entry` | `string` |
1115
+ | `recipe.format` | `"html"` \| `"assets"` \| `"esm"` |
1116
+ | `recipe.assets?` | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \} |
1117
+ | `recipe.assets.maxManifestBytes` | `number` |
1118
+ | `recipe.assets.maxObjects` | `number` |
1119
+ | `recipe.assets.maxObjectBytes` | `number` |
1120
+ | `recipe.assets.maxTotalBytes` | `number` |
1121
+ | `recipe.assetBase?` | `string` |
1122
+ | `recipe.toolchain` | \{ \[`key`: `string`\]: `string`; \} |
1123
+ | `recipe.maxOutputBytes` | `number` |
1124
+ | `recipe.platform` | `"neutral"` \| `"browser"` |
1125
+ | `recipe.backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` |
1126
+ | `recipe.target` | readonly \[`"es2022"`\] |
1138
1127
 
1139
1128
  #### Returns
1140
1129
 
@@ -1180,24 +1169,24 @@ policy describes a build this code does not perform.
1180
1169
 
1181
1170
  #### Parameters
1182
1171
 
1183
- | Parameter | Type |
1184
- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1185
- | `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`: `"neutral"` \| `"browser"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \} |
1186
- | `recipe.kind?` | `"bundled-html"` \| `"source-html"` |
1187
- | `recipe.bundle` | `true` |
1188
- | `recipe.entry` | `string` |
1189
- | `recipe.format` | `"html"` \| `"assets"` \| `"esm"` |
1190
- | `recipe.assets?` | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \} |
1191
- | `recipe.assets.maxManifestBytes` | `number` |
1192
- | `recipe.assets.maxObjects` | `number` |
1193
- | `recipe.assets.maxObjectBytes` | `number` |
1194
- | `recipe.assets.maxTotalBytes` | `number` |
1195
- | `recipe.assetBase?` | `string` |
1196
- | `recipe.toolchain` | \{ \[`key`: `string`\]: `string`; \} |
1197
- | `recipe.maxOutputBytes` | `number` |
1198
- | `recipe.platform` | `"neutral"` \| `"browser"` |
1199
- | `recipe.backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` |
1200
- | `recipe.target` | readonly \[`"es2022"`\] |
1172
+ | Parameter | Type |
1173
+ | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1174
+ | `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`: `"neutral"` \| `"browser"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \} |
1175
+ | `recipe.kind?` | `"bundled-html"` \| `"source-html"` |
1176
+ | `recipe.bundle` | `true` |
1177
+ | `recipe.entry` | `string` |
1178
+ | `recipe.format` | `"html"` \| `"assets"` \| `"esm"` |
1179
+ | `recipe.assets?` | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \} |
1180
+ | `recipe.assets.maxManifestBytes` | `number` |
1181
+ | `recipe.assets.maxObjects` | `number` |
1182
+ | `recipe.assets.maxObjectBytes` | `number` |
1183
+ | `recipe.assets.maxTotalBytes` | `number` |
1184
+ | `recipe.assetBase?` | `string` |
1185
+ | `recipe.toolchain` | \{ \[`key`: `string`\]: `string`; \} |
1186
+ | `recipe.maxOutputBytes` | `number` |
1187
+ | `recipe.platform` | `"neutral"` \| `"browser"` |
1188
+ | `recipe.backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` |
1189
+ | `recipe.target` | readonly \[`"es2022"`\] |
1201
1190
 
1202
1191
  #### Returns
1203
1192
 
@@ -1215,24 +1204,24 @@ Hash every captured build and output-policy input in the Publisher recipe.
1215
1204
 
1216
1205
  #### Parameters
1217
1206
 
1218
- | Parameter | Type |
1219
- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1220
- | `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`: `"neutral"` \| `"browser"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \} |
1221
- | `recipe.kind?` | `"bundled-html"` \| `"source-html"` |
1222
- | `recipe.bundle` | `true` |
1223
- | `recipe.entry` | `string` |
1224
- | `recipe.format` | `"html"` \| `"assets"` \| `"esm"` |
1225
- | `recipe.assets?` | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \} |
1226
- | `recipe.assets.maxManifestBytes` | `number` |
1227
- | `recipe.assets.maxObjects` | `number` |
1228
- | `recipe.assets.maxObjectBytes` | `number` |
1229
- | `recipe.assets.maxTotalBytes` | `number` |
1230
- | `recipe.assetBase?` | `string` |
1231
- | `recipe.toolchain` | \{ \[`key`: `string`\]: `string`; \} |
1232
- | `recipe.maxOutputBytes` | `number` |
1233
- | `recipe.platform` | `"neutral"` \| `"browser"` |
1234
- | `recipe.backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` |
1235
- | `recipe.target` | readonly \[`"es2022"`\] |
1207
+ | Parameter | Type |
1208
+ | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1209
+ | `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`: `"neutral"` \| `"browser"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \} |
1210
+ | `recipe.kind?` | `"bundled-html"` \| `"source-html"` |
1211
+ | `recipe.bundle` | `true` |
1212
+ | `recipe.entry` | `string` |
1213
+ | `recipe.format` | `"html"` \| `"assets"` \| `"esm"` |
1214
+ | `recipe.assets?` | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \} |
1215
+ | `recipe.assets.maxManifestBytes` | `number` |
1216
+ | `recipe.assets.maxObjects` | `number` |
1217
+ | `recipe.assets.maxObjectBytes` | `number` |
1218
+ | `recipe.assets.maxTotalBytes` | `number` |
1219
+ | `recipe.assetBase?` | `string` |
1220
+ | `recipe.toolchain` | \{ \[`key`: `string`\]: `string`; \} |
1221
+ | `recipe.maxOutputBytes` | `number` |
1222
+ | `recipe.platform` | `"neutral"` \| `"browser"` |
1223
+ | `recipe.backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` |
1224
+ | `recipe.target` | readonly \[`"es2022"`\] |
1236
1225
 
1237
1226
  #### Returns
1238
1227
 
@@ -1253,21 +1242,21 @@ Decode and normalize Publisher-owned recipe policy for durable seed proof.
1253
1242
 
1254
1243
  #### Parameters
1255
1244
 
1256
- | Parameter | Type |
1257
- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1258
- | `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`; \}; \} |
1259
- | `input.appId` | `string` |
1260
- | `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`; \} |
1261
- | `input.recipe.kind?` | `"bundled-html"` \| `"source-html"` |
1262
- | `input.recipe.entry` | `string` |
1263
- | `input.recipe.assets?` | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \} |
1264
- | `input.recipe.assets.maxManifestBytes` | `number` |
1265
- | `input.recipe.assets.maxObjects` | `number` |
1266
- | `input.recipe.assets.maxObjectBytes` | `number` |
1267
- | `input.recipe.assets.maxTotalBytes` | `number` |
1268
- | `input.recipe.assetBase?` | `string` |
1269
- | `input.recipe.backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` |
1270
- | `input.recipe.maxOutputBytes` | `number` |
1245
+ | Parameter | Type |
1246
+ | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1247
+ | `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"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `maxOutputBytes`: `number`; \}; \} |
1248
+ | `input.appId` | `string` |
1249
+ | `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"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `maxOutputBytes`: `number`; \} |
1250
+ | `input.recipe.kind?` | `"bundled-html"` \| `"source-html"` |
1251
+ | `input.recipe.entry` | `string` |
1252
+ | `input.recipe.assets?` | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \} |
1253
+ | `input.recipe.assets.maxManifestBytes` | `number` |
1254
+ | `input.recipe.assets.maxObjects` | `number` |
1255
+ | `input.recipe.assets.maxObjectBytes` | `number` |
1256
+ | `input.recipe.assets.maxTotalBytes` | `number` |
1257
+ | `input.recipe.assetBase?` | `string` |
1258
+ | `input.recipe.backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` |
1259
+ | `input.recipe.maxOutputBytes` | `number` |
1271
1260
 
1272
1261
  #### Returns
1273
1262
 
@@ -1287,24 +1276,24 @@ the largest output bound the recipe could assign it under.
1287
1276
 
1288
1277
  #### Parameters
1289
1278
 
1290
- | Parameter | Type |
1291
- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1292
- | `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`: `"neutral"` \| `"browser"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \} |
1293
- | `recipe.kind?` | `"bundled-html"` \| `"source-html"` |
1294
- | `recipe.bundle` | `true` |
1295
- | `recipe.entry` | `string` |
1296
- | `recipe.format` | `"html"` \| `"assets"` \| `"esm"` |
1297
- | `recipe.assets?` | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \} |
1298
- | `recipe.assets.maxManifestBytes` | `number` |
1299
- | `recipe.assets.maxObjects` | `number` |
1300
- | `recipe.assets.maxObjectBytes` | `number` |
1301
- | `recipe.assets.maxTotalBytes` | `number` |
1302
- | `recipe.assetBase?` | `string` |
1303
- | `recipe.toolchain` | \{ \[`key`: `string`\]: `string`; \} |
1304
- | `recipe.maxOutputBytes` | `number` |
1305
- | `recipe.platform` | `"neutral"` \| `"browser"` |
1306
- | `recipe.backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` |
1307
- | `recipe.target` | readonly \[`"es2022"`\] |
1279
+ | Parameter | Type |
1280
+ | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1281
+ | `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`: `"neutral"` \| `"browser"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \} |
1282
+ | `recipe.kind?` | `"bundled-html"` \| `"source-html"` |
1283
+ | `recipe.bundle` | `true` |
1284
+ | `recipe.entry` | `string` |
1285
+ | `recipe.format` | `"html"` \| `"assets"` \| `"esm"` |
1286
+ | `recipe.assets?` | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \} |
1287
+ | `recipe.assets.maxManifestBytes` | `number` |
1288
+ | `recipe.assets.maxObjects` | `number` |
1289
+ | `recipe.assets.maxObjectBytes` | `number` |
1290
+ | `recipe.assets.maxTotalBytes` | `number` |
1291
+ | `recipe.assetBase?` | `string` |
1292
+ | `recipe.toolchain` | \{ \[`key`: `string`\]: `string`; \} |
1293
+ | `recipe.maxOutputBytes` | `number` |
1294
+ | `recipe.platform` | `"neutral"` \| `"browser"` |
1295
+ | `recipe.backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` |
1296
+ | `recipe.target` | readonly \[`"es2022"`\] |
1308
1297
 
1309
1298
  #### Returns
1310
1299
 
@@ -1327,7 +1316,7 @@ applies here. Asset sizes stay the artifact writer's policy.
1327
1316
  | Parameter | Type |
1328
1317
  | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
1329
1318
  | `output` | \| \{ `declaration?`: `Readonly`\<\{ `api?`: `Readonly`\<\{ `methods`: `Readonly`\<`Record`\<`string`, `Readonly`\<...\>\>\>; `toolFamily?`: `Readonly`\<\{ `name`: ...; `list`: ...; `call`: ...; \}\>; `events?`: `Readonly`\<`Record`\<..., ...\>\>; \}\>; `displayName?`: `string`; `capabilities`: readonly ( \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"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 (`"files"` \| `"dashboard"` \| `"inbox"` \| `"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 `AppDeclaredGill`[]; `backend?`: `Readonly`\<\{ `bindings`: readonly `Readonly`\<\{ `name`: ...; `operations`: ...; \}\>[]; `sync?`: `Readonly`\<\{ `method`: ...; \}\>; \}\>; \}\>; `kind`: `"ui"`; `ui`: \| \{ `mediaType`: `"text/html; charset=utf-8"`; `content`: \{ `digest`: `Sha256Digest`; `byteLength`: `number`; `kind`: `"html"`; \}; \} \| \{ `mediaType`: `"application/vnd.fungi.app-assets+json"`; `content`: \{ `kind`: `"assets"`; `base`: `string`; `assets`: readonly `object`[]; \}; \}; \} \| \{ `declaration?`: `Readonly`\<\{ `api?`: `Readonly`\<\{ `methods`: `Readonly`\<`Record`\<`string`, `Readonly`\<...\>\>\>; `toolFamily?`: `Readonly`\<\{ `name`: ...; `list`: ...; `call`: ...; \}\>; `events?`: `Readonly`\<`Record`\<..., ...\>\>; \}\>; `displayName?`: `string`; `capabilities`: readonly ( \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"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 (`"files"` \| `"dashboard"` \| `"inbox"` \| `"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 `AppDeclaredGill`[]; `backend?`: `Readonly`\<\{ `bindings`: readonly `Readonly`\<\{ `name`: ...; `operations`: ...; \}\>[]; `sync?`: `Readonly`\<\{ `method`: ...; \}\>; \}\>; \}\>; `kind`: `"backend"`; `backend`: \{ `digest`: `Sha256Digest`; `byteLength`: `number`; \}; \} \| \{ `declaration?`: `Readonly`\<\{ `api?`: `Readonly`\<\{ `methods`: `Readonly`\<`Record`\<`string`, `Readonly`\<...\>\>\>; `toolFamily?`: `Readonly`\<\{ `name`: ...; `list`: ...; `call`: ...; \}\>; `events?`: `Readonly`\<`Record`\<..., ...\>\>; \}\>; `displayName?`: `string`; `capabilities`: readonly ( \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"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 (`"files"` \| `"dashboard"` \| `"inbox"` \| `"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 `AppDeclaredGill`[]; `backend?`: `Readonly`\<\{ `bindings`: readonly `Readonly`\<\{ `name`: ...; `operations`: ...; \}\>[]; `sync?`: `Readonly`\<\{ `method`: ...; \}\>; \}\>; \}\>; `kind`: `"app"`; `ui`: \| \{ `mediaType`: `"text/html; charset=utf-8"`; `content`: \{ `digest`: `Sha256Digest`; `byteLength`: `number`; `kind`: `"html"`; \}; \} \| \{ `mediaType`: `"application/vnd.fungi.app-assets+json"`; `content`: \{ `kind`: `"assets"`; `base`: `string`; `assets`: readonly `object`[]; \}; \}; `backend`: \{ `digest`: `Sha256Digest`; `byteLength`: `number`; \}; \} |
1330
- | `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`: `"neutral"` \| `"browser"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \} |
1319
+ | `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`: `"neutral"` \| `"browser"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \} |
1331
1320
  | `recipe.kind?` | `"bundled-html"` \| `"source-html"` |
1332
1321
  | `recipe.bundle` | `true` |
1333
1322
  | `recipe.entry` | `string` |
@@ -1341,7 +1330,7 @@ applies here. Asset sizes stay the artifact writer's policy.
1341
1330
  | `recipe.toolchain` | \{ \[`key`: `string`\]: `string`; \} |
1342
1331
  | `recipe.maxOutputBytes` | `number` |
1343
1332
  | `recipe.platform` | `"neutral"` \| `"browser"` |
1344
- | `recipe.backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` |
1333
+ | `recipe.backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` |
1345
1334
  | `recipe.target` | readonly \[`"es2022"`\] |
1346
1335
 
1347
1336
  #### Returns
@@ -1658,7 +1647,7 @@ Exact pinned esbuild options shared by local builds and artifact-budget proofs.
1658
1647
  | Parameter | Type | Description |
1659
1648
  | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- |
1660
1649
  | `source` | [`CapturedSource`](#capturedsource) | - |
1661
- | `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`: `"neutral"` \| `"browser"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \} | - |
1650
+ | `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`: `"neutral"` \| `"browser"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \} | - |
1662
1651
  | `recipe.kind?` | `"bundled-html"` \| `"source-html"` | - |
1663
1652
  | `recipe.bundle` | `true` | - |
1664
1653
  | `recipe.entry` | `string` | - |
@@ -1672,7 +1661,7 @@ Exact pinned esbuild options shared by local builds and artifact-budget proofs.
1672
1661
  | `recipe.toolchain` | \{ \[`key`: `string`\]: `string`; \} | - |
1673
1662
  | `recipe.maxOutputBytes` | `number` | - |
1674
1663
  | `recipe.platform` | `"neutral"` \| `"browser"` | - |
1675
- | `recipe.backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` | - |
1664
+ | `recipe.backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` | - |
1676
1665
  | `recipe.target` | readonly \[`"es2022"`\] | - |
1677
1666
  | `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?`: ...; `present?`: ...; \}\>\>\>; `toolFamily?`: `Readonly`\<\{ `name`: `string`; `list`: `string`; `call`: `string`; \}\>; `events?`: `Readonly`\<`Record`\<`string`, `Readonly`\<...\>\>\>; \}\>; `displayName?`: `string`; `capabilities`: readonly ( \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"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 (`"files"` \| `"dashboard"` \| `"inbox"` \| `"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 `AppDeclaredGill`[]; `backend?`: `Readonly`\<\{ `bindings`: readonly `Readonly`\<\{ `name`: ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ...; `operations`: readonly ...[]; \}\>[]; `sync?`: `Readonly`\<\{ `method`: `string`; \}\>; \}\>; \}\>\>; \} | - |
1678
1667
  | `emission.entryPoints` | (`entry`) => `Record`\<`string`, `string`\> | Entries for the one backend build: the Worker and, if defined, its declaration. |
@@ -1795,14 +1784,14 @@ Read package metadata once; only fungi.build rejects unknown fields.
1795
1784
 
1796
1785
  `object`
1797
1786
 
1798
- | Name | Type |
1799
- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1800
- | `name?` | `string` |
1801
- | `dependencies?` | `object` |
1802
- | `scripts?` | `object` |
1803
- | `fungi` | `object` |
1804
- | `fungi.appId?` | `AppId` |
1805
- | `fungi.build` | \| \{ `kind?`: `"bundled-html"` \| `"source-html"`; `assets?`: \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}; `assetBase?`: `string`; `entry?`: `string`; `backend?`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `maxOutputBytes?`: `number`; `react?`: `boolean`; `shellEntry?`: `string`; `packageStylesheets?`: readonly `string`[]; `stylesheets?`: readonly `string`[]; `typescript?`: readonly `string`[]; `script?`: `string`; `stylesheet?`: \{ `input`: `string`; `output`: `string`; \}; \} \| `undefined` |
1787
+ | Name | Type |
1788
+ | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1789
+ | `name?` | `string` |
1790
+ | `dependencies?` | `object` |
1791
+ | `scripts?` | `object` |
1792
+ | `fungi` | `object` |
1793
+ | `fungi.appId?` | `AppId` |
1794
+ | `fungi.build` | \| \{ `kind?`: `"bundled-html"` \| `"source-html"`; `assets?`: \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}; `assetBase?`: `string`; `entry?`: `string`; `backend?`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `maxOutputBytes?`: `number`; `react?`: `boolean`; `shellEntry?`: `string`; `packageStylesheets?`: readonly `string`[]; `stylesheets?`: readonly `string`[]; `typescript?`: readonly `string`[]; `script?`: `string`; `stylesheet?`: \{ `input`: `string`; `output`: `string`; \}; \} \| `undefined` |
1806
1795
 
1807
1796
  ---
1808
1797
 
@@ -1816,33 +1805,33 @@ Select an App recipe and root its paths in the captured source tree.
1816
1805
 
1817
1806
  #### Parameters
1818
1807
 
1819
- | Parameter | Type |
1820
- | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1821
- | `manifest` | \{ `name?`: `string`; `dependencies?`: \{ \[`key`: `string`\]: `string`; \}; `scripts?`: \{ \[`key`: `string`\]: `string`; \}; `fungi`: \{ `appId?`: `AppId`; `build`: \| \{ `kind?`: `"bundled-html"` \| `"source-html"`; `assets?`: \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}; `assetBase?`: `string`; `entry?`: `string`; `backend?`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `maxOutputBytes?`: `number`; `react?`: `boolean`; `shellEntry?`: `string`; `packageStylesheets?`: readonly `string`[]; `stylesheets?`: readonly `string`[]; `typescript?`: readonly `string`[]; `script?`: `string`; `stylesheet?`: \{ `input`: `string`; `output`: `string`; \}; \} \| `undefined`; \}; \} |
1822
- | `manifest.name?` | `string` |
1823
- | `manifest.dependencies?` | \{ \[`key`: `string`\]: `string`; \} |
1824
- | `manifest.scripts?` | \{ \[`key`: `string`\]: `string`; \} |
1825
- | `manifest.fungi` | \{ `appId?`: `AppId`; `build`: \| \{ `kind?`: `"bundled-html"` \| `"source-html"`; `assets?`: \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}; `assetBase?`: `string`; `entry?`: `string`; `backend?`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `maxOutputBytes?`: `number`; `react?`: `boolean`; `shellEntry?`: `string`; `packageStylesheets?`: readonly `string`[]; `stylesheets?`: readonly `string`[]; `typescript?`: readonly `string`[]; `script?`: `string`; `stylesheet?`: \{ `input`: `string`; `output`: `string`; \}; \} \| `undefined`; \} |
1826
- | `manifest.fungi.appId?` | `AppId` |
1827
- | `manifest.fungi.build` | \| \{ `kind?`: `"bundled-html"` \| `"source-html"`; `assets?`: \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}; `assetBase?`: `string`; `entry?`: `string`; `backend?`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `maxOutputBytes?`: `number`; `react?`: `boolean`; `shellEntry?`: `string`; `packageStylesheets?`: readonly `string`[]; `stylesheets?`: readonly `string`[]; `typescript?`: readonly `string`[]; `script?`: `string`; `stylesheet?`: \{ `input`: `string`; `output`: `string`; \}; \} \| `undefined` |
1828
- | `directory` | `string` |
1808
+ | Parameter | Type |
1809
+ | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1810
+ | `manifest` | \{ `name?`: `string`; `dependencies?`: \{ \[`key`: `string`\]: `string`; \}; `scripts?`: \{ \[`key`: `string`\]: `string`; \}; `fungi`: \{ `appId?`: `AppId`; `build`: \| \{ `kind?`: `"bundled-html"` \| `"source-html"`; `assets?`: \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}; `assetBase?`: `string`; `entry?`: `string`; `backend?`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `maxOutputBytes?`: `number`; `react?`: `boolean`; `shellEntry?`: `string`; `packageStylesheets?`: readonly `string`[]; `stylesheets?`: readonly `string`[]; `typescript?`: readonly `string`[]; `script?`: `string`; `stylesheet?`: \{ `input`: `string`; `output`: `string`; \}; \} \| `undefined`; \}; \} |
1811
+ | `manifest.name?` | `string` |
1812
+ | `manifest.dependencies?` | \{ \[`key`: `string`\]: `string`; \} |
1813
+ | `manifest.scripts?` | \{ \[`key`: `string`\]: `string`; \} |
1814
+ | `manifest.fungi` | \{ `appId?`: `AppId`; `build`: \| \{ `kind?`: `"bundled-html"` \| `"source-html"`; `assets?`: \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}; `assetBase?`: `string`; `entry?`: `string`; `backend?`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `maxOutputBytes?`: `number`; `react?`: `boolean`; `shellEntry?`: `string`; `packageStylesheets?`: readonly `string`[]; `stylesheets?`: readonly `string`[]; `typescript?`: readonly `string`[]; `script?`: `string`; `stylesheet?`: \{ `input`: `string`; `output`: `string`; \}; \} \| `undefined`; \} |
1815
+ | `manifest.fungi.appId?` | `AppId` |
1816
+ | `manifest.fungi.build` | \| \{ `kind?`: `"bundled-html"` \| `"source-html"`; `assets?`: \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}; `assetBase?`: `string`; `entry?`: `string`; `backend?`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `maxOutputBytes?`: `number`; `react?`: `boolean`; `shellEntry?`: `string`; `packageStylesheets?`: readonly `string`[]; `stylesheets?`: readonly `string`[]; `typescript?`: readonly `string`[]; `script?`: `string`; `stylesheet?`: \{ `input`: `string`; `output`: `string`; \}; \} \| `undefined` |
1817
+ | `directory` | `string` |
1829
1818
 
1830
1819
  #### Returns
1831
1820
 
1832
1821
  `object`
1833
1822
 
1834
- | Name | Type | Default value |
1835
- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- |
1836
- | `kind?` | `"bundled-html"` \| `"source-html"` | - |
1837
- | `entry` | `string` | `relativeEntrySchema` |
1838
- | `assets?` | `object` | - |
1839
- | `assets.maxManifestBytes` | `number` | - |
1840
- | `assets.maxObjects` | `number` | - |
1841
- | `assets.maxObjectBytes` | `number` | - |
1842
- | `assets.maxTotalBytes` | `number` | - |
1843
- | `assetBase?` | `string` | - |
1844
- | `backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` | - |
1845
- | `maxOutputBytes` | `number` | - |
1823
+ | Name | Type | Default value |
1824
+ | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- |
1825
+ | `kind?` | `"bundled-html"` \| `"source-html"` | - |
1826
+ | `entry` | `string` | `relativeEntrySchema` |
1827
+ | `assets?` | `object` | - |
1828
+ | `assets.maxManifestBytes` | `number` | - |
1829
+ | `assets.maxObjects` | `number` | - |
1830
+ | `assets.maxObjectBytes` | `number` | - |
1831
+ | `assets.maxTotalBytes` | `number` | - |
1832
+ | `assetBase?` | `string` | - |
1833
+ | `backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` | - |
1834
+ | `maxOutputBytes` | `number` | - |
1846
1835
 
1847
1836
  ---
1848
1837