@fungi.computer/oyster 0.47.3 → 0.47.4
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/dist/mcp.d.ts +31 -13
- package/dist/mcp.js +16 -3
- package/dist/page-script.js +1 -1
- package/docs/api/mcp.md +20 -8
- package/docs/api/workers.md +16 -16
- package/package.json +11 -11
package/docs/api/mcp.md
CHANGED
|
@@ -96,9 +96,15 @@ type ComputerControlPort = Readonly<{
|
|
|
96
96
|
running: "running";
|
|
97
97
|
sleeping: "sleeping";
|
|
98
98
|
starting: "starting";
|
|
99
|
-
start_failed: "start_failed";
|
|
100
99
|
}>;
|
|
101
100
|
}
|
|
101
|
+
| {
|
|
102
|
+
state: z.ZodLiteral<"start_failed">;
|
|
103
|
+
}
|
|
104
|
+
| {
|
|
105
|
+
state: z.ZodLiteral<"start_failed">;
|
|
106
|
+
reason: z.ZodString;
|
|
107
|
+
}
|
|
102
108
|
| {
|
|
103
109
|
state: z.ZodLiteral<"queued">;
|
|
104
110
|
position: z.ZodNumber;
|
|
@@ -110,9 +116,15 @@ type ComputerControlPort = Readonly<{
|
|
|
110
116
|
running: "running";
|
|
111
117
|
sleeping: "sleeping";
|
|
112
118
|
starting: "starting";
|
|
113
|
-
start_failed: "start_failed";
|
|
114
119
|
}>;
|
|
115
120
|
}
|
|
121
|
+
| {
|
|
122
|
+
state: z.ZodLiteral<"start_failed">;
|
|
123
|
+
}
|
|
124
|
+
| {
|
|
125
|
+
state: z.ZodLiteral<"start_failed">;
|
|
126
|
+
reason: z.ZodString;
|
|
127
|
+
}
|
|
116
128
|
| {
|
|
117
129
|
state: z.ZodLiteral<"queued">;
|
|
118
130
|
position: z.ZodNumber;
|
|
@@ -274,16 +286,16 @@ One set of schemas and operations for MCP and direct broker invocation.
|
|
|
274
286
|
| `state` | `object` | - | - |
|
|
275
287
|
| `state.replay` | `"safe"` | - | - |
|
|
276
288
|
| `state.access` | `"read"` | - | - |
|
|
277
|
-
| `state.description` | `string` | `"Read runtime state without waking a Computer, including its live admission queue position."`
|
|
278
|
-
| `state.input` | `ZodObject`\<\{ `computerId`: `ZodString`; \}, `$strict`\>
|
|
279
|
-
| `state.output` | `
|
|
280
|
-
| `state.execute()` | (`input`, `context`) => `Promise`\< \| \{ `state`: `"running"` \| `"sleeping"` \| `"starting"` \| `"start_failed"`; \} \| \{ `state`: `"queued"`; `position`: `number`; \}\>
|
|
289
|
+
| `state.description` | `string` | `"Read runtime state without waking a Computer, including its live admission queue position. Pass reason: true to get why a failed start failed."` | - |
|
|
290
|
+
| `state.input` | `ZodObject`\<\{ `computerId`: `ZodString`; `reason`: `ZodExactOptional`\<`ZodLiteral`\<`true`\>\>; \}, `$strict`\> | `fleetStateRead` | - |
|
|
291
|
+
| `state.output` | `ZodUnion`\<readonly \[`ZodObject`\<\{ `state`: `ZodEnum`\<\{ `running`: `"running"`; `sleeping`: `"sleeping"`; `starting`: `"starting"`; \}\>; \}, `$strict`\>, `ZodObject`\<\{ `state`: `ZodLiteral`\<`"start_failed"`\>; \}, `$strict`\>, `ZodObject`\<\{ `state`: `ZodLiteral`\<`"start_failed"`\>; `reason`: `ZodString`; \}, `$strict`\>, `ZodObject`\<\{ `state`: `ZodLiteral`\<`"queued"`\>; `position`: `ZodNumber`; \}, `$strict`\>\]\> | `computerStateSchema` | - |
|
|
292
|
+
| `state.execute()` | (`input`, `context`) => `Promise`\< \| \{ `state`: `"running"` \| `"sleeping"` \| `"starting"`; \} \| \{ `state`: `"start_failed"`; \} \| \{ `state`: `"start_failed"`; `reason`: `string`; \} \| \{ `state`: `"queued"`; `position`: `number`; \}\> | - | Return liveness without waking the runtime. |
|
|
281
293
|
| `start` | `object` | - | - |
|
|
282
294
|
| `start.replay` | `"unsafe"` | - | - |
|
|
283
295
|
| `start.description` | `string` | `"Start a hosted Computer through ordinary admission. Waits until connected; poll computers.state while queued. Safe to retry."` | - |
|
|
284
296
|
| `start.input` | `ZodObject`\<\{ `computerId`: `ZodString`; \}, `$strict`\> | `fleetComputerId` | - |
|
|
285
|
-
| `start.output` | `
|
|
286
|
-
| `start.execute()` | (`input`, `context`) => `Promise`\< \| \{ `state`: `"running"` \| `"sleeping"` \| `"starting"` \| `"start_failed"`; \} \| \{ `state`: `"queued"`; `position`: `number`; \}\>
|
|
297
|
+
| `start.output` | `ZodUnion`\<readonly \[`ZodObject`\<\{ `state`: `ZodEnum`\<\{ `running`: `"running"`; `sleeping`: `"sleeping"`; `starting`: `"starting"`; \}\>; \}, `$strict`\>, `ZodObject`\<\{ `state`: `ZodLiteral`\<`"start_failed"`\>; \}, `$strict`\>, `ZodObject`\<\{ `state`: `ZodLiteral`\<`"start_failed"`\>; `reason`: `ZodString`; \}, `$strict`\>, `ZodObject`\<\{ `state`: `ZodLiteral`\<`"queued"`\>; `position`: `ZodNumber`; \}, `$strict`\>\]\> | `computerStateSchema` | - |
|
|
298
|
+
| `start.execute()` | (`input`, `context`) => `Promise`\< \| \{ `state`: `"running"` \| `"sleeping"` \| `"starting"`; \} \| \{ `state`: `"start_failed"`; \} \| \{ `state`: `"start_failed"`; `reason`: `string`; \} \| \{ `state`: `"queued"`; `position`: `number`; \}\> | - | Admit and start this Computer. |
|
|
287
299
|
| `create` | `object` | - | - |
|
|
288
300
|
| `create.replay` | `"unsafe"` | - | - |
|
|
289
301
|
| `create.description` | `string` | `"Create a Computer with an optional friendly name and size (small, default or large; default when omitted). Request identity is generated automatically. If the outcome is uncertain, retry with its returned requestId and the original name and size input; do not start a second creation."` | - |
|