@fungi.computer/oyster 0.35.1 → 0.37.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 (39) hide show
  1. package/dist/boot-host-script.js +1 -1
  2. package/dist/build/candidate-cli.mjs +50 -15
  3. package/dist/catalog-frame.js +8 -0
  4. package/dist/cloudflare.js +1 -0
  5. package/dist/embed-metafiles.js +2 -2
  6. package/dist/embed-scripts.js +1 -1
  7. package/dist/hello-app-script.js +1 -1
  8. package/dist/host.d.ts +3 -1
  9. package/dist/host.js +9 -9
  10. package/dist/internal/delivery.js +1 -1
  11. package/dist/invocation.d.ts +27 -5
  12. package/dist/invocation.js +9 -7
  13. package/dist/mcp.d.ts +3 -3
  14. package/dist/mcp.js +1 -1
  15. package/dist/page-script.js +2 -2
  16. package/dist/standalone/agent-self.d.ts +19 -0
  17. package/dist/standalone/agent-self.js +72 -0
  18. package/dist/standalone/agents.d.ts +2 -2
  19. package/dist/standalone/agents.js +30 -8
  20. package/dist/standalone/workflow-git-capture.d.ts +1 -1
  21. package/dist/standalone/workflow-git-capture.js +1 -1
  22. package/dist/standalone/workflow-host.d.ts +63 -26
  23. package/dist/standalone/workflow-host.js +21 -3
  24. package/dist/standalone/workflow-node-capture.d.ts +1 -1
  25. package/dist/standalone/workflow-node-capture.js +1 -1
  26. package/dist/standalone/workflow-trigger-host.d.ts +193 -73
  27. package/dist/standalone/workflows.d.ts +54 -24
  28. package/dist/testing/capabilities.js +2 -0
  29. package/dist/testing/worker.js +1 -0
  30. package/dist/workers-git.js +2 -1
  31. package/dist/workers.js +5 -0
  32. package/docs/api/build-contract.md +27 -27
  33. package/docs/api/build.md +51 -60
  34. package/docs/api/host.md +19 -34
  35. package/docs/api/invocation.md +135 -97
  36. package/docs/api/mcp.md +5 -5
  37. package/docs/api/workers-git.md +180 -179
  38. package/docs/api/workers.md +217 -215
  39. package/package.json +18 -18
package/docs/api/host.md CHANGED
@@ -443,6 +443,7 @@ Variables: TimingVariables;
443
443
 
444
444
  ```ts
445
445
  type OysterHost = Readonly<{
446
+ tenantId: TenantId;
446
447
  approvals?: Readonly<{
447
448
  submit: Promise<OysterApprovalResult>;
448
449
  }>;
@@ -1929,7 +1930,7 @@ function verifyRelease(
1929
1930
  roles: readonly ("files" | "dashboard" | "inbox" | "media" | "sessions" | "terminal")[];
1930
1931
  storage?: readonly Readonly<...>[];
1931
1932
  commands?: readonly Readonly<...>[];
1932
- gills?: readonly Readonly<...>[];
1933
+ gills?: readonly AppDeclaredGill[];
1933
1934
  backend?: Readonly<{
1934
1935
  bindings: ...;
1935
1936
  sync?: ...;
@@ -1999,7 +2000,7 @@ function verifyRelease(
1999
2000
  roles: readonly ("files" | "dashboard" | "inbox" | "media" | "sessions" | "terminal")[];
2000
2001
  storage?: readonly Readonly<...>[];
2001
2002
  commands?: readonly Readonly<...>[];
2002
- gills?: readonly Readonly<...>[];
2003
+ gills?: readonly AppDeclaredGill[];
2003
2004
  backend?: Readonly<{
2004
2005
  bindings: ...;
2005
2006
  sync?: ...;
@@ -2062,7 +2063,7 @@ function verifyRelease(
2062
2063
  roles: readonly ("files" | "dashboard" | "inbox" | "media" | "sessions" | "terminal")[];
2063
2064
  storage?: readonly Readonly<...>[];
2064
2065
  commands?: readonly Readonly<...>[];
2065
- gills?: readonly Readonly<...>[];
2066
+ gills?: readonly AppDeclaredGill[];
2066
2067
  backend?: Readonly<{
2067
2068
  bindings: ...;
2068
2069
  sync?: ...;
@@ -2164,14 +2165,7 @@ function verifyRelease(
2164
2165
  sigil?: ... | ...;
2165
2166
  projections?: ... | ...;
2166
2167
  }>[];
2167
- gills?: readonly Readonly<{
2168
- id: string;
2169
- source: string;
2170
- title: string;
2171
- params?: ... | ...;
2172
- watch?: ... | ...;
2173
- desktop?: ... | ...;
2174
- }>[];
2168
+ gills?: readonly AppDeclaredGill[];
2175
2169
  backend?: Readonly<{
2176
2170
  bindings: readonly Readonly<...>[];
2177
2171
  sync?: Readonly<...>;
@@ -2237,7 +2231,7 @@ standalone HTML.
2237
2231
  readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly (`"files"` \|
2238
2232
  `"dashboard"` \| `"inbox"` \| `"media"` \| `"sessions"` \| `"terminal"`)[];
2239
2233
  `storage?`: readonly `Readonly`\<...\>[]; `commands?`: readonly
2240
- `Readonly`\<...\>[]; `gills?`: readonly `Readonly`\<...\>[]; `backend?`:
2234
+ `Readonly`\<...\>[]; `gills?`: readonly `AppDeclaredGill`[]; `backend?`:
2241
2235
  `Readonly`\<\{ `bindings`: ...; `sync?`: ...; \}\>; \}\>; `format`:
2242
2236
  `"fungi-app-v1"`; `ui`: \{ `mediaType`: `"text/html; charset=utf-8"` \|
2243
2237
  `"application/vnd.fungi.app-assets+json"`; `artifactRef`: `ArtifactRef`;
@@ -2261,7 +2255,7 @@ readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly (`"files"` \|
2261
2255
  `roles`: readonly (`"files"` \| `"dashboard"` \| `"inbox"` \| `"media"` \|
2262
2256
  `"sessions"` \| `"terminal"`)[]; `storage?`: readonly `Readonly`\<...\>[];
2263
2257
  `commands?`: readonly `Readonly`\<...\>[]; `gills?`: readonly
2264
- `Readonly`\<...\>[]; `backend?`: `Readonly`\<\{ `bindings`: ...; `sync?`: ...;
2258
+ `AppDeclaredGill`[]; `backend?`: `Readonly`\<\{ `bindings`: ...; `sync?`: ...;
2265
2259
  \}\>; \}\>; `format`: `"fungi-app-v1"`; `ui`: \{ `mediaType`:
2266
2260
  `"text/html; charset=utf-8"` \| `"application/vnd.fungi.app-assets+json"`;
2267
2261
  `artifactRef`: `ArtifactRef`; `digest`: `Sha256Digest`; `version`: `string`;
@@ -2282,7 +2276,7 @@ readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly (`"files"` \|
2282
2276
  `roles`: readonly (`"files"` \| `"dashboard"` \| `"inbox"` \| `"media"` \|
2283
2277
  `"sessions"` \| `"terminal"`)[]; `storage?`: readonly `Readonly`\<...\>[];
2284
2278
  `commands?`: readonly `Readonly`\<...\>[]; `gills?`: readonly
2285
- `Readonly`\<...\>[]; `backend?`: `Readonly`\<\{ `bindings`: ...; `sync?`: ...;
2279
+ `AppDeclaredGill`[]; `backend?`: `Readonly`\<\{ `bindings`: ...; `sync?`: ...;
2286
2280
  \}\>; \}\>; `format`: `"fungi-app-v1"`; `backend`: \{ `mediaType`:
2287
2281
  `"application/vnd.fungi.app-backend+json"`; `artifactRef`: `ArtifactRef`;
2288
2282
  `digest`: `Sha256Digest`; `version`: `string`; `byteLength`: `number`; \}; \};
@@ -2313,15 +2307,14 @@ readonly `"file.open"`[]; `receives?`: readonly `"git.push"`[]; `icon?`:
2313
2307
  `Readonly`\<\{ `key`: `string`; `scopes`: readonly ...[]; `maxBytes`: `number`;
2314
2308
  \}\>[]; `commands?`: readonly `Readonly`\<\{ `id`: `string`; `title`: `string`;
2315
2309
  `category`: `string`; `description?`: ... \| ...; `sigil?`: ... \| ...;
2316
- `projections?`: ... \| ...; \}\>[]; `gills?`: readonly `Readonly`\<\{ `id`:
2317
- `string`; `source`: `string`; `title`: `string`; `params?`: ... \| ...;
2318
- `watch?`: ... \| ...; `desktop?`: ... \| ...; \}\>[]; `backend?`: `Readonly`\<\{
2319
- `bindings`: readonly `Readonly`\<...\>[]; `sync?`: `Readonly`\<...\>; \}\>; \}\>
2320
- \| `null`; `ui`: \| `Readonly`\<\{ `kind`: `"html"`; `artifactRef`:
2321
- `ArtifactRef`; `digest`: `Sha256Digest`; \}\> \| `Readonly`\<\{ `kind`:
2322
- `"assets"`; `build`: \{ `format`: `"fungi-assets-v1"`; `base`: `string`;
2323
- `assets`: readonly `object`[]; \}; \}\> \| `null`; `backend`: \| `Readonly`\<\{
2324
- `artifactRef`: `ArtifactRef`; `digest`: `Sha256Digest`; \}\> \| `null`; \}\>\>
2310
+ `projections?`: ... \| ...; \}\>[]; `gills?`: readonly `AppDeclaredGill`[];
2311
+ `backend?`: `Readonly`\<\{ `bindings`: readonly `Readonly`\<...\>[]; `sync?`:
2312
+ `Readonly`\<...\>; \}\>; \}\> \| `null`; `ui`: \| `Readonly`\<\{ `kind`:
2313
+ `"html"`; `artifactRef`: `ArtifactRef`; `digest`: `Sha256Digest`; \}\> \|
2314
+ `Readonly`\<\{ `kind`: `"assets"`; `build`: \{ `format`: `"fungi-assets-v1"`;
2315
+ `base`: `string`; `assets`: readonly `object`[]; \}; \}\> \| `null`; `backend`:
2316
+ \| `Readonly`\<\{ `artifactRef`: `ArtifactRef`; `digest`: `Sha256Digest`; \}\>
2317
+ \| `null`; \}\>\>
2325
2318
 
2326
2319
  ---
2327
2320
 
@@ -2393,14 +2386,7 @@ function resolveBackend(store, release): Promise<
2393
2386
  sigil?: ...;
2394
2387
  projections?: ...;
2395
2388
  }>[];
2396
- gills?: readonly Readonly<{
2397
- id: ...;
2398
- source: ...;
2399
- title: ...;
2400
- params?: ...;
2401
- watch?: ...;
2402
- desktop?: ...;
2403
- }>[];
2389
+ gills?: readonly AppDeclaredGill[];
2404
2390
  backend?: Readonly<{
2405
2391
  bindings: readonly ...[];
2406
2392
  sync?: ... | ...;
@@ -2443,9 +2429,8 @@ root artifact, then the backend descriptor it names.
2443
2429
  `Readonly`\<\{ `key`: ...; `scopes`: ...; `maxBytes`: ...; \}\>[]; `commands?`:
2444
2430
  readonly `Readonly`\<\{ `id`: ...; `title`: ...; `category`: ...;
2445
2431
  `description?`: ...; `sigil?`: ...; `projections?`: ...; \}\>[]; `gills?`:
2446
- readonly `Readonly`\<\{ `id`: ...; `source`: ...; `title`: ...; `params?`: ...;
2447
- `watch?`: ...; `desktop?`: ...; \}\>[]; `backend?`: `Readonly`\<\{ `bindings`:
2448
- readonly ...[]; `sync?`: ... \| ...; \}\>; \}\> \| `null`; \}\> \| `null`\>
2432
+ readonly `AppDeclaredGill`[]; `backend?`: `Readonly`\<\{ `bindings`: readonly
2433
+ ...[]; `sync?`: ... \| ...; \}\>; \}\> \| `null`; \}\> \| `null`\>
2449
2434
 
2450
2435
  ## References
2451
2436