@fungi.computer/oyster 0.25.0 → 0.27.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 (49) hide show
  1. package/dist/agents.d.ts +24 -8
  2. package/dist/agents.js +12 -5
  3. package/dist/app-builds.d.ts +4 -2
  4. package/dist/app-builds.js +14 -0
  5. package/dist/apps/catalog.js +1 -1
  6. package/dist/boot-host-script.js +1 -1
  7. package/dist/build/build-memory.d.ts +13 -0
  8. package/dist/build/build-memory.js +29 -0
  9. package/dist/build/candidate-cli.mjs +25 -2
  10. package/dist/build/local-build.js +4 -5
  11. package/dist/cloudflare.d.ts +2 -2
  12. package/dist/cloudflare.js +3 -0
  13. package/dist/computer-control-port.d.ts +2 -0
  14. package/dist/embed-metafiles.js +2 -2
  15. package/dist/embed-scripts.js +1 -1
  16. package/dist/hello-app-script.js +1 -1
  17. package/dist/mcp.d.ts +26 -0
  18. package/dist/mcp.js +12 -2
  19. package/dist/media.d.ts +5 -0
  20. package/dist/media.js +1 -0
  21. package/dist/page-script.js +2 -2
  22. package/dist/release.d.ts +5 -0
  23. package/dist/standalone/agent-computers.js +17 -1
  24. package/dist/standalone/agents.d.ts +16 -8
  25. package/dist/standalone/agents.js +88 -25
  26. package/dist/standalone/app-set.d.ts +11 -3
  27. package/dist/standalone/app-set.js +26 -8
  28. package/dist/standalone/computer-control.js +7 -1
  29. package/dist/standalone/computer-fleet.d.ts +6 -0
  30. package/dist/standalone/computer-fleet.js +9 -1
  31. package/dist/standalone/computer-skill-source.d.ts +20 -0
  32. package/dist/standalone/computer-skill-source.js +165 -0
  33. package/dist/standalone/computer.d.ts +30 -4
  34. package/dist/standalone/computer.js +60 -3
  35. package/dist/standalone/install-apps-cli.js +9 -3
  36. package/dist/standalone/media.d.ts +9 -4
  37. package/dist/standalone/media.js +76 -7
  38. package/dist/standalone/registry.d.ts +8 -1
  39. package/dist/standalone/registry.js +10 -1
  40. package/docs/api/agents.md +204 -214
  41. package/docs/api/apps.md +33 -33
  42. package/docs/api/cloudflare.md +4 -1
  43. package/docs/api/mcp.md +52 -46
  44. package/docs/api/media.md +4 -0
  45. package/docs/api/workers-git.md +7 -7
  46. package/examples/standalone/wrangler.jsonc +3 -0
  47. package/package.json +19 -23
  48. package/dist/agent-instructions.d.ts +0 -35
  49. package/dist/agent-instructions.js +0 -42
@@ -10,6 +10,24 @@
10
10
 
11
11
  ## Type Aliases
12
12
 
13
+ ### OysterAgentInstructions
14
+
15
+ ```ts
16
+ type OysterAgentInstructions = Readonly<{
17
+ home: Readonly<{
18
+ name: string;
19
+ }> | null;
20
+ content: string | null;
21
+ bytes: number;
22
+ limit: number;
23
+ }>;
24
+ ```
25
+
26
+ An Agent's AGENTS.md on its Home Computer, with the byte limit the host
27
+ enforces.
28
+
29
+ ---
30
+
13
31
  ### OysterAgent
14
32
 
15
33
  ```ts
@@ -189,243 +207,215 @@ This Agent's App-tool policy, in the shape Apps read it.
189
207
 
190
208
  ```ts
191
209
  type OysterAgents = Readonly<{
192
- list: Promise<
193
- readonly Readonly<{
194
- agentId: string;
195
- name: string;
196
- avatar: Avatar;
197
- sessionOperations: readonly (
198
- "agent.read" | "agent.send" | "agent.manage"
199
- )[];
200
- }>[]
201
- >;
210
+ list: Promise<readonly Readonly<{
211
+ agentId: string;
212
+ name: string;
213
+ avatar: Avatar;
214
+ sessionOperations: readonly ("agent.read" | "agent.send" | "agent.manage")[];
215
+ }>[]>;
202
216
  ensureStarter: Promise<StarterOutcome>;
203
217
  setArchived: Promise<
204
- | Readonly<{
205
- archived: boolean;
206
- revision: number;
207
- }>
208
- | Readonly<{
209
- error:
210
- | "not_found"
211
- | "not_granted"
212
- | "self"
213
- | "not_creator"
214
- | "running"
215
- | "pending"
216
- | "unreadable"
217
- | "archived";
218
- message?: string;
219
- archived?: boolean;
220
- revision?: number;
221
- }>
222
- >;
223
- create: Promise<
224
- Readonly<{
225
- agentId: string;
226
- name: string;
227
- avatar: Avatar;
228
- sessionOperations: readonly (
229
- "agent.read" | "agent.send" | "agent.manage"
230
- )[];
231
- }>
232
- >;
218
+ | Readonly<{
219
+ archived: boolean;
220
+ revision: number;
221
+ }>
222
+ | Readonly<{
223
+ error: | "not_found"
224
+ | "not_granted"
225
+ | "self"
226
+ | "not_creator"
227
+ | "running"
228
+ | "pending"
229
+ | "unreadable"
230
+ | "archived";
231
+ message?: string;
232
+ archived?: boolean;
233
+ revision?: number;
234
+ }>>;
235
+ create: Promise<Readonly<{
236
+ agentId: string;
237
+ name: string;
238
+ avatar: Avatar;
239
+ sessionOperations: readonly ("agent.read" | "agent.send" | "agent.manage")[];
240
+ }>>;
233
241
  rename: Promise<
234
- | Readonly<{
235
- agentId: string;
236
- name: string;
237
- avatar: Avatar;
238
- sessionOperations: readonly (
239
- "agent.read" | "agent.send" | "agent.manage"
240
- )[];
241
- }>
242
- | Readonly<{
243
- error: "not_found" | "name_taken" | "not_granted";
244
- }>
245
- >;
242
+ | Readonly<{
243
+ agentId: string;
244
+ name: string;
245
+ avatar: Avatar;
246
+ sessionOperations: readonly ("agent.read" | "agent.send" | "agent.manage")[];
247
+ }>
248
+ | Readonly<{
249
+ error: "not_found" | "name_taken" | "not_granted";
250
+ }>>;
246
251
  setAvatar: Promise<
247
- | Readonly<{
248
- agentId: string;
249
- name: string;
250
- avatar: Avatar;
251
- sessionOperations: readonly (
252
- "agent.read" | "agent.send" | "agent.manage"
253
- )[];
254
- }>
255
- | Readonly<{
256
- error: "not_found" | "not_granted";
257
- }>
258
- >;
259
- readModelChoice: Promise<{
260
- keySource: "workers-ai" | "ai-gateway" | "byok";
261
- model: {
262
- providerId: Schema.String;
263
- modelId: Schema.String;
264
- reasoning?: Schema.optional<
265
- Schema.Literals<
266
- readonly ["minimal", "low", "medium", "high", "xhigh", "max"]
267
- >
268
- >;
269
- };
270
- keyId?: string;
271
- } | null>;
252
+ | Readonly<{
253
+ agentId: string;
254
+ name: string;
255
+ avatar: Avatar;
256
+ sessionOperations: readonly ("agent.read" | "agent.send" | "agent.manage")[];
257
+ }>
258
+ | Readonly<{
259
+ error: "not_found" | "not_granted";
260
+ }>>;
261
+ readModelChoice: Promise<
262
+ | {
263
+ keySource: "workers-ai" | "ai-gateway" | "byok";
264
+ model: {
265
+ providerId: Schema.String;
266
+ modelId: Schema.String;
267
+ reasoning?: Schema.optional<Schema.Literals<readonly ["minimal", "low", "medium", "high", "xhigh", "max"]>>;
268
+ };
269
+ keyId?: string;
270
+ }
271
+ | null>;
272
272
  readInstructions: Promise<
273
- | Readonly<{
274
- agentId: string;
275
- instructions: string;
276
- }>
277
- | Readonly<{
278
- error: "not_found" | "not_granted";
273
+ | Readonly<object & Readonly<{
274
+ home: | Readonly<{
275
+ name: ...;
279
276
  }>
280
- >;
277
+ | null;
278
+ content: string | null;
279
+ bytes: number;
280
+ limit: number;
281
+ }>>
282
+ | Readonly<{
283
+ error: "not_found" | "not_granted";
284
+ }>>;
281
285
  setInstructions: Promise<
282
- | Readonly<{
283
- agentId: string;
284
- instructions: string;
285
- }>
286
- | Readonly<{
287
- error: "not_found" | "not_granted";
286
+ | Readonly<object & Readonly<{
287
+ home: | Readonly<{
288
+ name: ...;
288
289
  }>
289
- >;
290
- decodeModelChoice: {
291
- keySource: "workers-ai" | "ai-gateway" | "byok";
292
- model: {
293
- providerId: Schema.String;
294
- modelId: Schema.String;
295
- reasoning?: Schema.optional<
296
- Schema.Literals<
297
- readonly ["minimal", "low", "medium", "high", "xhigh", "max"]
298
- >
299
- >;
300
- };
301
- keyId?: string;
302
- } | null;
290
+ | null;
291
+ content: string | null;
292
+ bytes: number;
293
+ limit: number;
294
+ }>>
295
+ | Readonly<{
296
+ error: "not_found" | "not_granted" | "conflict" | "too_large" | "no_home";
297
+ }>>;
298
+ decodeModelChoice: | {
299
+ keySource: "workers-ai" | "ai-gateway" | "byok";
300
+ model: {
301
+ providerId: Schema.String;
302
+ modelId: Schema.String;
303
+ reasoning?: Schema.optional<Schema.Literals<readonly ["minimal", "low", "medium", "high", "xhigh", "max"]>>;
304
+ };
305
+ keyId?: string;
306
+ }
307
+ | null;
303
308
  setModelChoice: Promise<
304
- | {
305
- keySource: "workers-ai" | "ai-gateway" | "byok";
306
- model: {
307
- providerId: Schema.String;
308
- modelId: Schema.String;
309
- reasoning?: Schema.optional<
310
- Schema.Literals<
311
- readonly ["minimal", "low", "medium", "high", "xhigh", "max"]
312
- >
313
- >;
314
- };
315
- keyId?: string;
316
- }
317
- | Readonly<{
318
- error: "not_found" | "not_granted" | AgentModelRefusal;
319
- }>
320
- >;
321
- policyStatus: Promise<Readonly<{
322
- status: "pending" | "approved";
323
- revision: string;
324
- }> | null>;
325
- appToolPolicy: Promise<{
326
- level: "read" | "write";
327
- revision: string;
328
- grantedBy: string;
329
- } | null>;
309
+ | {
310
+ keySource: "workers-ai" | "ai-gateway" | "byok";
311
+ model: {
312
+ providerId: Schema.String;
313
+ modelId: Schema.String;
314
+ reasoning?: Schema.optional<Schema.Literals<readonly ["minimal", "low", "medium", "high", "xhigh", "max"]>>;
315
+ };
316
+ keyId?: string;
317
+ }
318
+ | Readonly<{
319
+ error: "not_found" | "not_granted" | AgentModelRefusal;
320
+ }>>;
321
+ policyStatus: Promise<
322
+ | Readonly<{
323
+ status: "pending" | "approved";
324
+ revision: string;
325
+ }>
326
+ | null>;
327
+ appToolPolicy: Promise<
328
+ | {
329
+ level: "read" | "write";
330
+ revision: string;
331
+ grantedBy: string;
332
+ }
333
+ | null>;
330
334
  policyRevision: Promise<string | null>;
331
335
  approveAppToolPolicy: Promise<
332
- | {
333
- level: "read" | "write";
334
- revision: string;
335
- grantedBy: string;
336
- }
337
- | Readonly<{
338
- status: "pending";
339
- revision: string;
340
- }>
341
- | Readonly<{
342
- error: "not_found" | "revision_conflict" | "not_granted";
343
- }>
344
- >;
345
- setup: Promise<
346
- Readonly<{
347
- models: "ready" | "missing";
348
- media: "ready" | "missing";
349
- }>
350
- >;
351
- modelKeys: Promise<
352
- readonly Readonly<{
353
- keyId: string;
354
- provider: StandaloneModelKeyProvider;
355
- label: string;
356
- createdAt: number;
357
- validatedAt: number;
358
- }>[]
359
- >;
336
+ | {
337
+ level: "read" | "write";
338
+ revision: string;
339
+ grantedBy: string;
340
+ }
341
+ | Readonly<{
342
+ status: "pending";
343
+ revision: string;
344
+ }>
345
+ | Readonly<{
346
+ error: "not_found" | "revision_conflict" | "not_granted";
347
+ }>>;
348
+ setup: Promise<Readonly<{
349
+ models: "ready" | "missing";
350
+ media: "ready" | "missing";
351
+ }>>;
352
+ modelKeys: Promise<readonly Readonly<{
353
+ keyId: string;
354
+ provider: StandaloneModelKeyProvider;
355
+ label: string;
356
+ createdAt: number;
357
+ validatedAt: number;
358
+ }>[]>;
360
359
  sealModelKey: Promise<
361
- | Readonly<{
362
- keyId: string;
363
- provider: StandaloneModelKeyProvider;
364
- label: string;
365
- createdAt: number;
366
- validatedAt: number;
367
- }>
368
- | Readonly<{
369
- error: ModelKeyRefusal;
370
- }>
371
- >;
360
+ | Readonly<{
361
+ keyId: string;
362
+ provider: StandaloneModelKeyProvider;
363
+ label: string;
364
+ createdAt: number;
365
+ validatedAt: number;
366
+ }>
367
+ | Readonly<{
368
+ error: ModelKeyRefusal;
369
+ }>>;
372
370
  removeModelKey: Promise<"deleted" | "absent">;
373
- connections: Promise<
374
- readonly Readonly<{
375
- connectionId: string;
376
- name: string;
377
- label: string;
378
- kind: "mcp" | "openapi";
379
- url: string;
380
- auth: "none" | "token" | "oauth";
381
- state: "connected" | "pending" | "reconnect_required";
382
- grants: readonly Readonly<{
371
+ connections: Promise<readonly Readonly<{
372
+ connectionId: string;
373
+ name: string;
374
+ label: string;
375
+ kind: "mcp" | "openapi";
376
+ url: string;
377
+ auth: "none" | "token" | "oauth";
378
+ state: "connected" | "pending" | "reconnect_required";
379
+ grants: readonly Readonly<{
383
380
  agentId: string;
384
381
  access: ConnectionAccess;
385
- }>[];
386
- }>[]
387
- >;
382
+ }>[];
383
+ }>[]>;
388
384
  addConnection: Promise<
389
- | Readonly<{
390
- connectionId: string;
391
- authorizeUrl: string | null;
392
- }>
393
- | Readonly<{
394
- error: "not_found" | "duplicate_name" | "limit" | "invalid_endpoint";
395
- }>
396
- >;
385
+ | Readonly<{
386
+ connectionId: string;
387
+ authorizeUrl: string | null;
388
+ }>
389
+ | Readonly<{
390
+ error: "not_found" | "duplicate_name" | "limit" | "invalid_endpoint";
391
+ }>>;
397
392
  grantConnection: Promise<
398
- | Readonly<{
399
- error: "not_found" | "duplicate_name" | "limit" | "invalid_endpoint";
400
- }>
401
- | Readonly<{
402
- ok: true;
403
- }>
404
- >;
393
+ | Readonly<{
394
+ error: "not_found" | "duplicate_name" | "limit" | "invalid_endpoint";
395
+ }>
396
+ | Readonly<{
397
+ ok: true;
398
+ }>>;
405
399
  ungrantConnection: Promise<boolean>;
406
400
  removeConnection: Promise<boolean>;
407
401
  connectionTools: Promise<
408
- | readonly string[]
409
- | Readonly<{
410
- error: "not_found" | "duplicate_name" | "limit" | "invalid_endpoint";
411
- }>
412
- >;
402
+ | readonly string[]
403
+ | Readonly<{
404
+ error: "not_found" | "duplicate_name" | "limit" | "invalid_endpoint";
405
+ }>>;
413
406
  completeMcpConnection: Promise<
414
- | Readonly<{
415
- ok: true;
416
- }>
417
- | Readonly<{
418
- error: string;
419
- }>
420
- >;
407
+ | Readonly<{
408
+ ok: true;
409
+ }>
410
+ | Readonly<{
411
+ error: string;
412
+ }>>;
421
413
  mcpCallbackUrl: string;
422
414
  fetch: Promise<Response | null>;
423
- inbox: Promise<
424
- Readonly<{
425
- items: readonly OysterInboxItem[];
426
- revision: number;
427
- }>
428
- >;
415
+ inbox: Promise<Readonly<{
416
+ items: readonly OysterInboxItem[];
417
+ revision: number;
418
+ }>>;
429
419
  revision: Promise<number>;
430
420
  visit: Promise<boolean>;
431
421
  }>;