@fungi.computer/oyster 0.8.2 → 0.10.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 (72) hide show
  1. package/README.md +34 -17
  2. package/dist/agents.d.ts +16 -1
  3. package/dist/agents.js +63 -3
  4. package/dist/apps/catalog.d.ts +11 -0
  5. package/dist/apps/catalog.js +1 -0
  6. package/dist/apps/gate.d.ts +2 -2
  7. package/dist/apps/installation.d.ts +7 -7
  8. package/dist/apps/permissions.d.ts +5 -5
  9. package/dist/boot-host-script.js +1 -1
  10. package/dist/build/candidate-cli.mjs +1 -0
  11. package/dist/computer-control-port.d.ts +20 -1
  12. package/dist/host.js +11 -4
  13. package/dist/installation-client.d.ts +6 -5
  14. package/dist/installation-client.js +21 -17
  15. package/dist/installation-execution.js +41 -8
  16. package/dist/installation-operations.d.ts +30 -8
  17. package/dist/installation-operations.js +122 -24
  18. package/dist/instance-refusal.d.ts +4 -2
  19. package/dist/instance-refusal.js +5 -1
  20. package/dist/mcp.d.ts +132 -2
  21. package/dist/mcp.js +63 -1
  22. package/dist/page/mount.d.ts +8 -1
  23. package/dist/page/mount.js +72 -6
  24. package/dist/page-script.js +3 -3
  25. package/dist/standalone/agent-computers.d.ts +12 -1
  26. package/dist/standalone/agent-computers.js +35 -0
  27. package/dist/standalone/agent-connections.d.ts +47 -0
  28. package/dist/standalone/agent-connections.js +170 -0
  29. package/dist/standalone/agent-model-choice.d.ts +7 -3
  30. package/dist/standalone/agent-model-choice.js +33 -4
  31. package/dist/standalone/agents.d.ts +70 -9
  32. package/dist/standalone/agents.js +187 -110
  33. package/dist/standalone/app-set.js +6 -7
  34. package/dist/standalone/browser.d.ts +4 -3
  35. package/dist/standalone/browser.js +4 -3
  36. package/dist/standalone/computer-control.js +55 -1
  37. package/dist/standalone/computer-fleet.d.ts +29 -2
  38. package/dist/standalone/computer-fleet.js +51 -23
  39. package/dist/standalone/computer.d.ts +20 -1
  40. package/dist/standalone/computer.js +63 -1
  41. package/dist/standalone/model-key-vault.d.ts +50 -0
  42. package/dist/standalone/model-key-vault.js +147 -0
  43. package/dist/standalone/registry.d.ts +23 -0
  44. package/dist/standalone/registry.js +39 -0
  45. package/dist/standalone/web.d.ts +10 -0
  46. package/dist/standalone/web.js +34 -0
  47. package/dist/standalone/worker-routes.d.ts +3 -1
  48. package/dist/standalone/worker-routes.js +1 -0
  49. package/dist/standalone/worker.js +9 -1
  50. package/dist/standalone/workflow-host.d.ts +5 -5
  51. package/dist/standalone/workflow-trigger-host.d.ts +1 -1
  52. package/dist/web/index.d.ts +3 -0
  53. package/dist/web/index.js +3 -0
  54. package/dist/web/search-contract.d.ts +19 -0
  55. package/dist/web/search-contract.js +14 -0
  56. package/dist/web/search.d.ts +25 -0
  57. package/dist/web/search.js +123 -0
  58. package/dist/web/source.d.ts +46 -0
  59. package/dist/web/source.js +335 -0
  60. package/dist/workers-git.js +2 -1
  61. package/docs/api/agents.md +81 -3
  62. package/docs/api/apps.md +160 -142
  63. package/docs/api/build-contract.md +27 -21
  64. package/docs/api/build.md +55 -54
  65. package/docs/api/git.md +3 -3
  66. package/docs/api/host.md +226 -60
  67. package/docs/api/mcp.md +83 -44
  68. package/docs/api/page/mount.md +6 -1
  69. package/docs/api/workers-git.md +6 -6
  70. package/docs/api/workers.md +53 -47
  71. package/docs/site/agent-quickstart.mdx +4 -2
  72. package/package.json +27 -22
@@ -132,7 +132,7 @@ An owner's request to connect one remote MCP server to an Agent.
132
132
 
133
133
  ```ts
134
134
  type AgentMcpServerRefusal = Readonly<{
135
- error: "not_found" | "duplicate_name" | "limit";
135
+ error: "not_found" | "duplicate_name" | "limit" | "invalid_endpoint";
136
136
  }>;
137
137
  ```
138
138
 
@@ -234,6 +234,7 @@ type OysterAgents = Readonly<{
234
234
  >
235
235
  >;
236
236
  };
237
+ keyId?: string;
237
238
  } | null>;
238
239
  decodeModelChoice: {
239
240
  keySource: "workers-ai" | "ai-gateway" | "byok";
@@ -246,6 +247,7 @@ type OysterAgents = Readonly<{
246
247
  >
247
248
  >;
248
249
  };
250
+ keyId?: string;
249
251
  } | null;
250
252
  setModelChoice: Promise<
251
253
  | {
@@ -259,6 +261,7 @@ type OysterAgents = Readonly<{
259
261
  >
260
262
  >;
261
263
  };
264
+ keyId?: string;
262
265
  }
263
266
  | Readonly<{
264
267
  error: "not_found" | "not_granted" | AgentModelRefusal;
@@ -288,6 +291,28 @@ type OysterAgents = Readonly<{
288
291
  error: "not_found" | "revision_conflict" | "not_granted";
289
292
  }>
290
293
  >;
294
+ modelKeys: Promise<
295
+ readonly Readonly<{
296
+ keyId: string;
297
+ provider: ModelKeyProvider;
298
+ label: string;
299
+ createdAt: number;
300
+ validatedAt: number;
301
+ }>[]
302
+ >;
303
+ sealModelKey: Promise<
304
+ | Readonly<{
305
+ keyId: string;
306
+ provider: ModelKeyProvider;
307
+ label: string;
308
+ createdAt: number;
309
+ validatedAt: number;
310
+ }>
311
+ | Readonly<{
312
+ error: ModelKeyRefusal;
313
+ }>
314
+ >;
315
+ removeModelKey: Promise<"deleted" | "absent">;
291
316
  mcpServers: Promise<
292
317
  | readonly Readonly<{
293
318
  serverId: string;
@@ -305,7 +330,7 @@ type OysterAgents = Readonly<{
305
330
  hasBearer: boolean;
306
331
  }>
307
332
  | Readonly<{
308
- error: "not_found" | "duplicate_name" | "limit";
333
+ error: "not_found" | "duplicate_name" | "limit" | "invalid_endpoint";
309
334
  }>
310
335
  >;
311
336
  removeMcpServer: Promise<boolean>;
@@ -348,11 +373,43 @@ type AgentModelRefusal =
348
373
  | "unsupported_key_source"
349
374
  | "key_source_mismatch"
350
375
  | "model_unavailable"
351
- | "key_not_connected";
376
+ | "key_not_connected"
377
+ | "key_removed";
352
378
  ```
353
379
 
354
380
  Stable reason for rejecting a model or credential source before a run.
355
381
 
382
+ ---
383
+
384
+ ### ModelKeyRefusal
385
+
386
+ ```ts
387
+ type ModelKeyRefusal =
388
+ | "invalid_key"
389
+ | "key_rejected"
390
+ | "provider_unavailable"
391
+ | "custody_unavailable"
392
+ | "key_removed"
393
+ | "target_denied"
394
+ | "limit";
395
+ ```
396
+
397
+ Why a key could not be stored or used; stable, secret-free.
398
+
399
+ ---
400
+
401
+ ### ModelKeySealInput
402
+
403
+ ```ts
404
+ type ModelKeySealInput = Readonly<{
405
+ provider: string;
406
+ label: string;
407
+ apiKey: string;
408
+ }>;
409
+ ```
410
+
411
+ What the owner submits to seal one provider key.
412
+
356
413
  ## Variables
357
414
 
358
415
  ### maxAgentMcpServers
@@ -420,6 +477,27 @@ Host-owned direct approval under the admitted owner; never an App capability.
420
477
 
421
478
  ---
422
479
 
480
+ ### modelKeyRoutes()
481
+
482
+ ```ts
483
+ function modelKeyRoutes(agents): Routes<OysterEnv>;
484
+ ```
485
+
486
+ Host-owned model-key custody for the owner directly. A key goes in once and
487
+ never comes back out; listings carry provider, label and times only.
488
+
489
+ #### Parameters
490
+
491
+ | Parameter | Type |
492
+ | --------- | ------------------------------- |
493
+ | `agents` | [`OysterAgents`](#oysteragents) |
494
+
495
+ #### Returns
496
+
497
+ [`Routes`](authorization.md#routes)\<[`OysterEnv`](host.md#oysterenv)\>
498
+
499
+ ---
500
+
423
501
  ### agentMcpServerRoutes()
424
502
 
425
503
  ```ts