@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.
- package/README.md +34 -17
- package/dist/agents.d.ts +16 -1
- package/dist/agents.js +63 -3
- package/dist/apps/catalog.d.ts +11 -0
- package/dist/apps/catalog.js +1 -0
- package/dist/apps/gate.d.ts +2 -2
- package/dist/apps/installation.d.ts +7 -7
- package/dist/apps/permissions.d.ts +5 -5
- package/dist/boot-host-script.js +1 -1
- package/dist/build/candidate-cli.mjs +1 -0
- package/dist/computer-control-port.d.ts +20 -1
- package/dist/host.js +11 -4
- package/dist/installation-client.d.ts +6 -5
- package/dist/installation-client.js +21 -17
- package/dist/installation-execution.js +41 -8
- package/dist/installation-operations.d.ts +30 -8
- package/dist/installation-operations.js +122 -24
- package/dist/instance-refusal.d.ts +4 -2
- package/dist/instance-refusal.js +5 -1
- package/dist/mcp.d.ts +132 -2
- package/dist/mcp.js +63 -1
- package/dist/page/mount.d.ts +8 -1
- package/dist/page/mount.js +72 -6
- package/dist/page-script.js +3 -3
- package/dist/standalone/agent-computers.d.ts +12 -1
- package/dist/standalone/agent-computers.js +35 -0
- package/dist/standalone/agent-connections.d.ts +47 -0
- package/dist/standalone/agent-connections.js +170 -0
- package/dist/standalone/agent-model-choice.d.ts +7 -3
- package/dist/standalone/agent-model-choice.js +33 -4
- package/dist/standalone/agents.d.ts +70 -9
- package/dist/standalone/agents.js +187 -110
- package/dist/standalone/app-set.js +6 -7
- package/dist/standalone/browser.d.ts +4 -3
- package/dist/standalone/browser.js +4 -3
- package/dist/standalone/computer-control.js +55 -1
- package/dist/standalone/computer-fleet.d.ts +29 -2
- package/dist/standalone/computer-fleet.js +51 -23
- package/dist/standalone/computer.d.ts +20 -1
- package/dist/standalone/computer.js +63 -1
- package/dist/standalone/model-key-vault.d.ts +50 -0
- package/dist/standalone/model-key-vault.js +147 -0
- package/dist/standalone/registry.d.ts +23 -0
- package/dist/standalone/registry.js +39 -0
- package/dist/standalone/web.d.ts +10 -0
- package/dist/standalone/web.js +34 -0
- package/dist/standalone/worker-routes.d.ts +3 -1
- package/dist/standalone/worker-routes.js +1 -0
- package/dist/standalone/worker.js +9 -1
- package/dist/standalone/workflow-host.d.ts +5 -5
- package/dist/standalone/workflow-trigger-host.d.ts +1 -1
- package/dist/web/index.d.ts +3 -0
- package/dist/web/index.js +3 -0
- package/dist/web/search-contract.d.ts +19 -0
- package/dist/web/search-contract.js +14 -0
- package/dist/web/search.d.ts +25 -0
- package/dist/web/search.js +123 -0
- package/dist/web/source.d.ts +46 -0
- package/dist/web/source.js +335 -0
- package/dist/workers-git.js +2 -1
- package/docs/api/agents.md +81 -3
- package/docs/api/apps.md +160 -142
- package/docs/api/build-contract.md +27 -21
- package/docs/api/build.md +55 -54
- package/docs/api/git.md +3 -3
- package/docs/api/host.md +226 -60
- package/docs/api/mcp.md +83 -44
- package/docs/api/page/mount.md +6 -1
- package/docs/api/workers-git.md +6 -6
- package/docs/api/workers.md +53 -47
- package/docs/site/agent-quickstart.mdx +4 -2
- package/package.json +27 -22
package/docs/api/agents.md
CHANGED
|
@@ -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
|