@fungi.computer/oyster 0.50.4 → 0.51.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.
package/docs/api/git.md CHANGED
@@ -217,9 +217,9 @@ storage.
217
217
 
218
218
  #### Parameters
219
219
 
220
- | Parameter | Type |
221
- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
222
- | `ports` | `Readonly`\<\{ `currentInstallation`: `Promise`\< \| `Readonly`\<\{ `installationId`: `string`; `instanceId`: [`InstanceId`](index.md#instanceid) \| `null`; `appId`: `AppId`; `release`: \{ `releaseId`: `Schema.refine`\<`ReleaseId`, `Schema.String`\>; `appId`: `Schema.refine`\<`AppId`, `Schema.String`\>; `artifact`: `Schema.Struct`\<\{ `artifactRef`: `Schema.refine`\<`ArtifactRef`, `Schema.String`\>; `artifactDigest`: `Schema.refine`\<`Sha256Digest`, `Schema.String`\>; `provenance`: `Schema.Struct`\<\{ `sourceRevision`: ...; `sourceTreeDigest`: ...; `buildRecipeDigest`: ...; \}\>; \}\>; \}; `releasePin`: `"pinned"` \| `"floating"`; `authority`: \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ...; `capabilityApproved`: `true`; `operations`: readonly ...[]; `fingerprints`: `Readonly`\<...\>; `resources`: ... \| ...; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: ... \| ... \| ...; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \}; `status`: `"enabled"` \| `"disabled"` \| `"deleted"`; \}\> \| `null`\>; `declaration`: `Promise`\< \| `Readonly`\<\{ `api?`: `AppApi`; `displayName?`: `string`; `capabilities`: readonly `AppCapabilityId`[]; `calls?`: readonly `Readonly`\<\{ `appId`: ...; `methods`: ...; \}\>[]; `guidance?`: `string`; `handlers`: readonly `AppHandler`[]; `receives?`: readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly `AppRole`[]; `storage?`: readonly `AppStorageKey`[]; `commands?`: readonly `AppDeclaredCommand`[]; `gills?`: readonly `AppDeclaredGill`[]; `backend?`: `Readonly`\<\{ `bindings`: readonly ...[]; `sync?`: `Readonly`\<\{ `method`: ...; \}\>; \}\>; \}\> \| `null`\>; \}\> |
220
+ | Parameter | Type |
221
+ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
222
+ | `ports` | `Readonly`\<\{ `currentInstallation`: `Promise`\< \| `Readonly`\<\{ `installationId`: `string`; `instanceId`: [`InstanceId`](index.md#instanceid) \| `null`; `appId`: `AppId`; `release`: \{ `releaseId`: `Schema.refine`\<`ReleaseId`, `Schema.String`\>; `appId`: `Schema.refine`\<`AppId`, `Schema.String`\>; `artifact`: `Schema.Struct`\<\{ `artifactRef`: `Schema.refine`\<`ArtifactRef`, `Schema.String`\>; `artifactDigest`: `Schema.refine`\<`Sha256Digest`, `Schema.String`\>; `provenance`: `Schema.Struct`\<\{ `sourceRevision`: ...; `sourceTreeDigest`: ...; `buildRecipeDigest`: ...; \}\>; \}\>; \}; `releasePin`: `"pinned"` \| `"floating"`; `authority`: \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ...; `capabilityApproved`: `true`; `operations`: readonly ...[]; `fingerprints`: `Readonly`\<...\>; `resources`: ... \| ...; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: ... \| ... \| ...; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \}; `status`: `"enabled"` \| `"disabled"` \| `"deleted"`; \}\> \| `null`\>; `declaration`: `Promise`\< \| `Readonly`\<\{ `api?`: `AppApi`; `displayName?`: `string`; `capabilities`: readonly `AppCapabilityId`[]; `calls?`: readonly `Readonly`\<\{ `appId`: ...; `methods`: ...; \}\>[]; `guidance?`: `string`; `handlers`: readonly `AppHandler`[]; `receives?`: readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly `AppRole`[]; `storage?`: readonly `AppStorageKey`[]; `commands?`: readonly `AppDeclaredCommand`[]; `gills?`: readonly `AppDeclaredGill`[]; `backend?`: `Readonly`\<\{ `bindings`: readonly ...[]; `sync?`: `Readonly`\<\{ `method`: ...; \}\>; \}\>; \}\> \| `null`\>; \}\> |
223
223
 
224
224
  #### Returns
225
225
 
package/docs/api/host.md CHANGED
@@ -1393,6 +1393,7 @@ type InstallationOperations = Readonly<{
1393
1393
  | ...
1394
1394
  | ...
1395
1395
  | ...
1396
+ | ...
1396
1397
  | ...;
1397
1398
  capabilityApproved: true;
1398
1399
  operations: readonly ...[];
@@ -1905,6 +1906,7 @@ function verifyRelease(
1905
1906
  | "agent.avatar"
1906
1907
  | "agent.instructions"
1907
1908
  | "agent.toolPolicy"
1909
+ | "agent.stop"
1908
1910
  | "agent.read"
1909
1911
  | "agent.send"
1910
1912
  | "llm.generation"
@@ -1975,6 +1977,7 @@ function verifyRelease(
1975
1977
  | "agent.avatar"
1976
1978
  | "agent.instructions"
1977
1979
  | "agent.toolPolicy"
1980
+ | "agent.stop"
1978
1981
  | "agent.read"
1979
1982
  | "agent.send"
1980
1983
  | "llm.generation"
@@ -2038,6 +2041,7 @@ function verifyRelease(
2038
2041
  | "agent.avatar"
2039
2042
  | "agent.instructions"
2040
2043
  | "agent.toolPolicy"
2044
+ | "agent.stop"
2041
2045
  | "agent.read"
2042
2046
  | "agent.send"
2043
2047
  | "llm.generation"
@@ -2126,6 +2130,7 @@ function verifyRelease(
2126
2130
  | "agent.avatar"
2127
2131
  | "agent.instructions"
2128
2132
  | "agent.toolPolicy"
2133
+ | "agent.stop"
2129
2134
  | "agent.read"
2130
2135
  | "agent.send"
2131
2136
  | "llm.generation"
@@ -2223,12 +2228,12 @@ standalone HTML.
2223
2228
  `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \|
2224
2229
  `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \|
2225
2230
  `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \|
2226
- `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"`
2227
- \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \|
2228
- `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \|
2229
- `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \|
2230
- `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \|
2231
- `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
2231
+ `"agent.toolPolicy"` \| `"agent.stop"` \| `"agent.read"` \| `"agent.send"` \|
2232
+ `"llm.generation"` \| `"media.generation"` \| `"media.share"` \|
2233
+ `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \|
2234
+ `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \|
2235
+ `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \|
2236
+ `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
2232
2237
  `"channels.personal.manage"`)[]; `calls?`: readonly `Readonly`\<...\>[];
2233
2238
  `guidance?`: `string`; `handlers`: readonly `"file.open"`[]; `receives?`:
2234
2239
  readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly (`"files"` \|
@@ -2247,27 +2252,28 @@ readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly (`"files"` \|
2247
2252
  `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \|
2248
2253
  `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \|
2249
2254
  `"agent.avatar"` \| `"agent.instructions"` \| `"agent.toolPolicy"` \|
2250
- `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"`
2251
- \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"`
2252
- \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \|
2253
- `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \|
2254
- `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \|
2255
- `"channels.read"` \| `"channels.personal.manage"`)[]; `calls?`: readonly
2256
- `Readonly`\<...\>[]; `guidance?`: `string`; `handlers`: readonly
2257
- `"file.open"`[]; `receives?`: readonly `"git.push"`[]; `icon?`: `string`;
2258
- `roles`: readonly (`"files"` \| `"dashboard"` \| `"inbox"` \| `"media"` \|
2259
- `"sessions"` \| `"terminal"`)[]; `storage?`: readonly `Readonly`\<...\>[];
2260
- `commands?`: readonly `Readonly`\<...\>[]; `gills?`: readonly
2261
- `AppDeclaredGill`[]; `backend?`: `Readonly`\<\{ `bindings`: ...; `sync?`: ...;
2262
- \}\>; \}\>; `format`: `"fungi-app-v1"`; `ui`: \{ `mediaType`:
2263
- `"text/html; charset=utf-8"` \| `"application/vnd.fungi.app-assets+json"`;
2264
- `artifactRef`: `ArtifactRef`; `digest`: `Sha256Digest`; `version`: `string`;
2265
- `byteLength`: `number`; \}; \} \| \{ `declaration?`: `Readonly`\<\{ `api?`:
2266
- `Readonly`\<\{ `methods`: ...; `toolFamily?`: ...; `events?`: ...; \}\>;
2267
- `displayName?`: `string`; `capabilities`: readonly ( \| `"computer.list"` \|
2268
- `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \|
2269
- `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \|
2270
- `"agent.avatar"` \| `"agent.instructions"` \| `"agent.toolPolicy"` \|
2255
+ `"agent.stop"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \|
2256
+ `"media.generation"` \| `"media.share"` \| `"games:servers"` \|
2257
+ `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \|
2258
+ `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \|
2259
+ `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \|
2260
+ `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
2261
+ `"channels.personal.manage"`)[]; `calls?`: readonly `Readonly`\<...\>[];
2262
+ `guidance?`: `string`; `handlers`: readonly `"file.open"`[]; `receives?`:
2263
+ readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly (`"files"` \|
2264
+ `"dashboard"` \| `"inbox"` \| `"media"` \| `"sessions"` \| `"terminal"`)[];
2265
+ `storage?`: readonly `Readonly`\<...\>[]; `commands?`: readonly
2266
+ `Readonly`\<...\>[]; `gills?`: readonly `AppDeclaredGill`[]; `backend?`:
2267
+ `Readonly`\<\{ `bindings`: ...; `sync?`: ...; \}\>; \}\>; `format`:
2268
+ `"fungi-app-v1"`; `ui`: \{ `mediaType`: `"text/html; charset=utf-8"` \|
2269
+ `"application/vnd.fungi.app-assets+json"`; `artifactRef`: `ArtifactRef`;
2270
+ `digest`: `Sha256Digest`; `version`: `string`; `byteLength`: `number`; \}; \} \|
2271
+ \{ `declaration?`: `Readonly`\<\{ `api?`: `Readonly`\<\{ `methods`: ...;
2272
+ `toolFamily?`: ...; `events?`: ...; \}\>; `displayName?`: `string`;
2273
+ `capabilities`: readonly ( \| `"computer.list"` \| `"computer.readFile"` \|
2274
+ `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \|
2275
+ `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \|
2276
+ `"agent.instructions"` \| `"agent.toolPolicy"` \| `"agent.stop"` \|
2271
2277
  `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"`
2272
2278
  \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"`
2273
2279
  \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \|
@@ -2296,12 +2302,12 @@ readonly ...; `pending?`: ... \| ...; `hidden?`: ... \| ...; `present?`: ... \|
2296
2302
  `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \|
2297
2303
  `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \|
2298
2304
  `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \|
2299
- `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"`
2300
- \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \|
2301
- `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \|
2302
- `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \|
2303
- `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \|
2304
- `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
2305
+ `"agent.toolPolicy"` \| `"agent.stop"` \| `"agent.read"` \| `"agent.send"` \|
2306
+ `"llm.generation"` \| `"media.generation"` \| `"media.share"` \|
2307
+ `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \|
2308
+ `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \|
2309
+ `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \|
2310
+ `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
2305
2311
  `"channels.personal.manage"`)[]; `calls?`: readonly `Readonly`\<\{ `appId`:
2306
2312
  `string`; `methods`: readonly ...[]; \}\>[]; `guidance?`: `string`; `handlers`:
2307
2313
  readonly `"file.open"`[]; `receives?`: readonly `"git.push"`[]; `icon?`:
@@ -2347,6 +2353,7 @@ function resolveBackend(store, release): Promise<
2347
2353
  | "agent.avatar"
2348
2354
  | "agent.instructions"
2349
2355
  | "agent.toolPolicy"
2356
+ | "agent.stop"
2350
2357
  | "agent.read"
2351
2358
  | "agent.send"
2352
2359
  | "llm.generation"
@@ -2419,21 +2426,22 @@ root artifact, then the backend descriptor it names.
2419
2426
  \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \|
2420
2427
  `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \|
2421
2428
  `"agent.avatar"` \| `"agent.instructions"` \| `"agent.toolPolicy"` \|
2422
- `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"`
2423
- \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"`
2424
- \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \|
2425
- `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \|
2426
- `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \|
2427
- `"channels.read"` \| `"channels.personal.manage"`)[]; `calls?`: readonly
2428
- `Readonly`\<\{ `appId`: ...; `methods`: ...; \}\>[]; `guidance?`: `string`;
2429
- `handlers`: readonly `"file.open"`[]; `receives?`: readonly `"git.push"`[];
2430
- `icon?`: `string`; `roles`: readonly (`"files"` \| `"dashboard"` \| `"inbox"` \|
2431
- `"media"` \| `"sessions"` \| `"terminal"`)[]; `storage?`: readonly
2432
- `Readonly`\<\{ `key`: ...; `scopes`: ...; `maxBytes`: ...; \}\>[]; `commands?`:
2433
- readonly `Readonly`\<\{ `id`: ...; `title`: ...; `category`: ...;
2434
- `description?`: ...; `sigil?`: ...; `projections?`: ...; \}\>[]; `gills?`:
2435
- readonly `AppDeclaredGill`[]; `backend?`: `Readonly`\<\{ `bindings`: readonly
2436
- ...[]; `sync?`: ... \| ...; \}\>; \}\> \| `null`; \}\> \| `null`\>
2429
+ `"agent.stop"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \|
2430
+ `"media.generation"` \| `"media.share"` \| `"games:servers"` \|
2431
+ `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \|
2432
+ `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \|
2433
+ `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \|
2434
+ `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
2435
+ `"channels.personal.manage"`)[]; `calls?`: readonly `Readonly`\<\{ `appId`: ...;
2436
+ `methods`: ...; \}\>[]; `guidance?`: `string`; `handlers`: readonly
2437
+ `"file.open"`[]; `receives?`: readonly `"git.push"`[]; `icon?`: `string`;
2438
+ `roles`: readonly (`"files"` \| `"dashboard"` \| `"inbox"` \| `"media"` \|
2439
+ `"sessions"` \| `"terminal"`)[]; `storage?`: readonly `Readonly`\<\{ `key`: ...;
2440
+ `scopes`: ...; `maxBytes`: ...; \}\>[]; `commands?`: readonly `Readonly`\<\{
2441
+ `id`: ...; `title`: ...; `category`: ...; `description?`: ...; `sigil?`: ...;
2442
+ `projections?`: ...; \}\>[]; `gills?`: readonly `AppDeclaredGill`[]; `backend?`:
2443
+ `Readonly`\<\{ `bindings`: readonly ...[]; `sync?`: ... \| ...; \}\>; \}\> \|
2444
+ `null`; \}\> \| `null`\>
2437
2445
 
2438
2446
  ## References
2439
2447
 
package/docs/api/index.md CHANGED
@@ -363,94 +363,97 @@ The catalog-valid avatar an owner may choose for an Agent.
363
363
  ### agentAvatarProjectionSchema
364
364
 
365
365
  ```ts
366
- const agentAvatarProjectionSchema: ZodDiscriminatedUnion<
367
- [
368
- ZodObject<
369
- {
370
- v: ZodLiteral<1>;
371
- character: ZodLiteral<"mushroom">;
372
- appearance: ZodObject<
373
- {
374
- [key: string]: ZodOptional<
375
- ZodUnion<readonly [ZodString, ZodNumber, ZodBoolean]>
376
- >;
377
- },
378
- $strict
379
- >;
380
- expression: ZodString;
381
- renderStyle: ZodEnum<{
382
- plain: "plain";
383
- pencil: "pencil";
384
- manga: "manga";
385
- riso: "riso";
386
- halftone: "halftone";
387
- blueprint: "blueprint";
388
- crt: "crt";
389
- watercolor: "watercolor";
390
- }>;
391
- },
392
- $strict
393
- >,
394
- ZodObject<
395
- {
396
- v: ZodLiteral<1>;
397
- character: ZodLiteral<"cat">;
398
- appearance: ZodObject<
399
- {
400
- [key: string]: ZodOptional<
401
- ZodUnion<readonly [ZodString, ZodNumber, ZodBoolean]>
402
- >;
403
- },
404
- $strict
405
- >;
406
- expression: ZodString;
407
- renderStyle: ZodEnum<{
408
- plain: "plain";
409
- pencil: "pencil";
410
- manga: "manga";
411
- riso: "riso";
412
- halftone: "halftone";
413
- blueprint: "blueprint";
414
- crt: "crt";
415
- watercolor: "watercolor";
416
- }>;
417
- },
418
- $strict
419
- >,
420
- ZodObject<
421
- {
422
- v: ZodLiteral<1>;
423
- character: ZodLiteral<"burger">;
424
- appearance: ZodObject<
425
- {
426
- [key: string]: ZodOptional<
427
- ZodUnion<readonly [ZodString, ZodNumber, ZodBoolean]>
428
- >;
429
- },
430
- $strict
431
- >;
432
- expression: ZodString;
433
- renderStyle: ZodEnum<{
434
- plain: "plain";
435
- pencil: "pencil";
436
- manga: "manga";
437
- riso: "riso";
438
- halftone: "halftone";
439
- blueprint: "blueprint";
440
- crt: "crt";
441
- watercolor: "watercolor";
442
- }>;
443
- },
444
- $strict
445
- >,
446
- ],
447
- "character"
366
+ const agentAvatarProjectionSchema: ZodLazy<
367
+ ZodDiscriminatedUnion<
368
+ [
369
+ ZodObject<
370
+ {
371
+ v: ZodLiteral<1>;
372
+ character: ZodLiteral<"mushroom">;
373
+ appearance: ZodObject<
374
+ {
375
+ [key: string]: ZodOptional<
376
+ ZodUnion<readonly [ZodString, ZodNumber, ZodBoolean]>
377
+ >;
378
+ },
379
+ $strict
380
+ >;
381
+ expression: ZodString;
382
+ renderStyle: ZodEnum<{
383
+ plain: "plain";
384
+ pencil: "pencil";
385
+ manga: "manga";
386
+ riso: "riso";
387
+ halftone: "halftone";
388
+ blueprint: "blueprint";
389
+ crt: "crt";
390
+ watercolor: "watercolor";
391
+ }>;
392
+ },
393
+ $strict
394
+ >,
395
+ ZodObject<
396
+ {
397
+ v: ZodLiteral<1>;
398
+ character: ZodLiteral<"cat">;
399
+ appearance: ZodObject<
400
+ {
401
+ [key: string]: ZodOptional<
402
+ ZodUnion<readonly [ZodString, ZodNumber, ZodBoolean]>
403
+ >;
404
+ },
405
+ $strict
406
+ >;
407
+ expression: ZodString;
408
+ renderStyle: ZodEnum<{
409
+ plain: "plain";
410
+ pencil: "pencil";
411
+ manga: "manga";
412
+ riso: "riso";
413
+ halftone: "halftone";
414
+ blueprint: "blueprint";
415
+ crt: "crt";
416
+ watercolor: "watercolor";
417
+ }>;
418
+ },
419
+ $strict
420
+ >,
421
+ ZodObject<
422
+ {
423
+ v: ZodLiteral<1>;
424
+ character: ZodLiteral<"burger">;
425
+ appearance: ZodObject<
426
+ {
427
+ [key: string]: ZodOptional<
428
+ ZodUnion<readonly [ZodString, ZodNumber, ZodBoolean]>
429
+ >;
430
+ },
431
+ $strict
432
+ >;
433
+ expression: ZodString;
434
+ renderStyle: ZodEnum<{
435
+ plain: "plain";
436
+ pencil: "pencil";
437
+ manga: "manga";
438
+ riso: "riso";
439
+ halftone: "halftone";
440
+ blueprint: "blueprint";
441
+ crt: "crt";
442
+ watercolor: "watercolor";
443
+ }>;
444
+ },
445
+ $strict
446
+ >,
447
+ ],
448
+ "character"
449
+ >
448
450
  >;
449
451
  ```
450
452
 
451
453
  The avatar as a closed record, for contracts that refuse open maps (Hub
452
454
  projections): each character's appearance names only its own controls, then the
453
- catalog refines it exactly as `agentAvatarSchema` does.
455
+ catalog refines it exactly as `agentAvatarSchema` does. Built on first use:
456
+ constructing it is Worker startup cost no request there needs.
454
457
 
455
458
  ---
456
459
 
package/docs/api/mcp.md CHANGED
@@ -419,15 +419,15 @@ Derive the current principal's admitted App modules and grants.
419
419
 
420
420
  #### Parameters
421
421
 
422
- | Parameter | Type |
423
- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
424
- | `host` | `Pick`\<[`OysterHost`](host.md#oysterhost), \| `"tenantId"` \| `"installations"` \| `"instances"` \| `"artifacts"` \| `"guestLimits"` \| `"backgroundOriginKey"` \| `"computerId"` \| `"capabilities"` \| `"appToolPolicy"` \| `"keys"` \| `"approvals"`\> |
425
- | `surfaces` | [`AppSurfaceCache`](#appsurfacecache) |
426
- | `principal` | [`TenantPrincipal`](tenant.md#tenantprincipal) |
427
- | `installations` | readonly `Readonly`\<\{ `installationId`: `string`; `instanceId`: [`InstanceId`](index.md#instanceid) \| `null`; `appId`: `AppId`; `release`: \{ `releaseId`: `ReleaseId`; `appId`: `AppId`; `artifact`: \{ `artifactRef`: `ArtifactRef`; `artifactDigest`: `Sha256Digest`; `provenance`: \{ `sourceRevision`: `SourceRevision`; `sourceTreeDigest`: `Sha256Digest`; `buildRecipeDigest`: `Sha256Digest`; \}; \}; \}; `releasePin`: `"pinned"` \| `"floating"`; `authority`: \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| `"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"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `string`\>\>; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: ...; `id`: ...; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \}; `status`: `"enabled"` \| `"disabled"` \| `"deleted"`; \}\>[] |
428
- | `access` | [`OysterCallerAccess`](#oystercalleraccess) |
429
- | `sessionId` | `string` \| `null` |
430
- | `mode` | `"approval"` \| `"direct"` |
422
+ | Parameter | Type |
423
+ | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
424
+ | `host` | `Pick`\<[`OysterHost`](host.md#oysterhost), \| `"tenantId"` \| `"installations"` \| `"instances"` \| `"artifacts"` \| `"guestLimits"` \| `"backgroundOriginKey"` \| `"computerId"` \| `"capabilities"` \| `"appToolPolicy"` \| `"keys"` \| `"approvals"`\> |
425
+ | `surfaces` | [`AppSurfaceCache`](#appsurfacecache) |
426
+ | `principal` | [`TenantPrincipal`](tenant.md#tenantprincipal) |
427
+ | `installations` | readonly `Readonly`\<\{ `installationId`: `string`; `instanceId`: [`InstanceId`](index.md#instanceid) \| `null`; `appId`: `AppId`; `release`: \{ `releaseId`: `ReleaseId`; `appId`: `AppId`; `artifact`: \{ `artifactRef`: `ArtifactRef`; `artifactDigest`: `Sha256Digest`; `provenance`: \{ `sourceRevision`: `SourceRevision`; `sourceTreeDigest`: `Sha256Digest`; `buildRecipeDigest`: `Sha256Digest`; \}; \}; \}; `releasePin`: `"pinned"` \| `"floating"`; `authority`: \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"agent.toolPolicy"` \| `"agent.stop"` \| `"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"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `string`\>\>; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: ...; `id`: ...; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \}; `status`: `"enabled"` \| `"disabled"` \| `"deleted"`; \}\>[] |
428
+ | `access` | [`OysterCallerAccess`](#oystercalleraccess) |
429
+ | `sessionId` | `string` \| `null` |
430
+ | `mode` | `"approval"` \| `"direct"` |
431
431
 
432
432
  #### Returns
433
433
 
@@ -474,13 +474,13 @@ installation authority or the caller's own grants.
474
474
 
475
475
  #### Parameters
476
476
 
477
- | Parameter | Type |
478
- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
479
- | `host` | `Pick`\<[`OysterHost`](host.md#oysterhost), \| `"tenantId"` \| `"installations"` \| `"instances"` \| `"artifacts"` \| `"guestLimits"` \| `"backgroundOriginKey"` \| `"computerId"` \| `"capabilities"` \| `"appToolPolicy"` \| `"keys"` \| `"approvals"`\> |
480
- | `principal` | [`TenantPrincipal`](tenant.md#tenantprincipal) |
481
- | `access` | [`OysterCallerAccess`](#oystercalleraccess) |
482
- | `surfaces` | [`AppSurfaceCache`](#appsurfacecache) |
483
- | `preloadedInstallations?` | readonly `Readonly`\<\{ `installationId`: `string`; `instanceId`: [`InstanceId`](index.md#instanceid) \| `null`; `appId`: `AppId`; `release`: \{ `releaseId`: `ReleaseId`; `appId`: `AppId`; `artifact`: \{ `artifactRef`: `ArtifactRef`; `artifactDigest`: `Sha256Digest`; `provenance`: \{ `sourceRevision`: `SourceRevision`; `sourceTreeDigest`: `Sha256Digest`; `buildRecipeDigest`: `Sha256Digest`; \}; \}; \}; `releasePin`: `"pinned"` \| `"floating"`; `authority`: \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| `"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"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `string`\>\>; `resources`: `"tenant-scope"` \| readonly `Readonly`\<...\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \}; `status`: `"enabled"` \| `"disabled"` \| `"deleted"`; \}\>[] |
477
+ | Parameter | Type |
478
+ | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
479
+ | `host` | `Pick`\<[`OysterHost`](host.md#oysterhost), \| `"tenantId"` \| `"installations"` \| `"instances"` \| `"artifacts"` \| `"guestLimits"` \| `"backgroundOriginKey"` \| `"computerId"` \| `"capabilities"` \| `"appToolPolicy"` \| `"keys"` \| `"approvals"`\> |
480
+ | `principal` | [`TenantPrincipal`](tenant.md#tenantprincipal) |
481
+ | `access` | [`OysterCallerAccess`](#oystercalleraccess) |
482
+ | `surfaces` | [`AppSurfaceCache`](#appsurfacecache) |
483
+ | `preloadedInstallations?` | readonly `Readonly`\<\{ `installationId`: `string`; `instanceId`: [`InstanceId`](index.md#instanceid) \| `null`; `appId`: `AppId`; `release`: \{ `releaseId`: `ReleaseId`; `appId`: `AppId`; `artifact`: \{ `artifactRef`: `ArtifactRef`; `artifactDigest`: `Sha256Digest`; `provenance`: \{ `sourceRevision`: `SourceRevision`; `sourceTreeDigest`: `Sha256Digest`; `buildRecipeDigest`: `Sha256Digest`; \}; \}; \}; `releasePin`: `"pinned"` \| `"floating"`; `authority`: \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"agent.toolPolicy"` \| `"agent.stop"` \| `"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"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `string`\>\>; `resources`: `"tenant-scope"` \| readonly `Readonly`\<...\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \}; `status`: `"enabled"` \| `"disabled"` \| `"deleted"`; \}\>[] |
484
484
 
485
485
  #### Returns
486
486