@rivet-dev/agentos 0.0.0-codex-agentos-native-platform-e2e.78ef941 → 0.0.0-codex-actor-plugin-contract-coverage.c7d8f87

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/index.d.ts CHANGED
@@ -1,6 +1,6 @@
1
- import { ActionContext, BeforeConnectContext, ActorContext, ActorDefinition, DatabaseProvider, RawAccess } from 'rivetkit';
2
- export { setup } from 'rivetkit';
3
- import { AgentOs, JsonRpcNotification, PermissionRequest, CronEvent, AgentCapabilities, AgentInfo, JsonRpcResponse, AgentOsOptions } from '@rivet-dev/agentos-core';
1
+ import { AgentExitEvent, AgentOs, JsonRpcResponse, JsonRpcNotification, PermissionRequest, AgentCapabilities, AgentInfo, AgentOsOptions, NativeMountConfig, VirtualStat, ExecResult, SpawnedProcessInfo, ProcessInfo, ProcessTreeNode, PermissionReply } from '@rivet-dev/agentos-core';
2
+ export { defineSoftware } from '@rivet-dev/agentos-core';
3
+ import { ActionContext, BeforeConnectContext, ActorContext, ActorDefinition, DatabaseProvider, RawAccess, setup as setup$1 } from 'rivetkit';
4
4
  import { z } from 'zod/v4';
5
5
 
6
6
  type AgentOsActorState = {};
@@ -20,6 +20,10 @@ interface PermissionRequestPayload {
20
20
  sessionId: string;
21
21
  request: PermissionRequest;
22
22
  }
23
+ interface AgentCrashedPayload {
24
+ sessionId: string;
25
+ event: AgentExitEvent;
26
+ }
23
27
  type VmBootedPayload = Record<string, never>;
24
28
  interface VmShutdownPayload {
25
29
  reason: "sleep" | "destroy" | "error";
@@ -37,17 +41,41 @@ interface ShellDataPayload {
37
41
  shellId: string;
38
42
  data: Uint8Array;
39
43
  }
44
+ interface ShellExitPayload {
45
+ shellId: string;
46
+ exitCode: number;
47
+ }
48
+ type SerializableCronEvent = {
49
+ type: "cron:fire";
50
+ jobId: string;
51
+ time: number;
52
+ } | {
53
+ type: "cron:complete";
54
+ jobId: string;
55
+ time: number;
56
+ durationMs: number;
57
+ } | {
58
+ type: "cron:error";
59
+ jobId: string;
60
+ time: number;
61
+ error: string;
62
+ };
40
63
  interface CronEventPayload {
41
- event: CronEvent;
64
+ event: SerializableCronEvent;
42
65
  }
43
66
  interface AgentOsEvents {
44
67
  sessionEvent: SessionEventPayload;
45
68
  permissionRequest: PermissionRequestPayload;
69
+ agentCrashed: AgentCrashedPayload;
46
70
  vmBooted: VmBootedPayload;
47
71
  vmShutdown: VmShutdownPayload;
48
72
  processOutput: ProcessOutputPayload;
49
73
  processExit: ProcessExitPayload;
50
74
  shellData: ShellDataPayload;
75
+ /** Shell stderr (the dedicated channel backing the TS `onStderr` option). */
76
+ shellStderr: ShellDataPayload;
77
+ /** Shell process exit (mirrors `waitShell` resolution). */
78
+ shellExit: ShellExitPayload;
51
79
  cronEvent: CronEventPayload;
52
80
  }
53
81
  /** Result from sendPrompt. */
@@ -66,9 +94,8 @@ interface SessionRecord {
66
94
  interface PersistedSessionRecord {
67
95
  sessionId: string;
68
96
  agentType: string;
69
- capabilities: AgentCapabilities;
70
- agentInfo: AgentInfo | null;
71
97
  createdAt: number;
98
+ status: "running" | "idle";
72
99
  }
73
100
  interface PersistedSessionEvent {
74
101
  sessionId: string;
@@ -95,17 +122,412 @@ interface SerializableCronJobOptions {
95
122
  interface SerializableCronJobInfo {
96
123
  id: string;
97
124
  schedule: string;
98
- action: SerializableCronAction;
99
125
  overlap: "allow" | "skip" | "queue";
100
- lastRun?: string;
101
- nextRun?: string;
102
- runCount: number;
103
- running: boolean;
126
+ lastRun?: number;
127
+ nextRun?: number;
104
128
  }
105
129
  type AgentOsActionContext<TConnParams = undefined> = ActionContext<AgentOsActorState, TConnParams, undefined, AgentOsActorVars, undefined, any>;
106
130
 
131
+ declare const nativeAgentOsOptionsSchema: z.ZodObject<{
132
+ software: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
133
+ defaultSoftware: z.ZodOptional<z.ZodBoolean>;
134
+ loopbackExemptPorts: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
135
+ allowedNodeBuiltins: z.ZodOptional<z.ZodArray<z.ZodString>>;
136
+ rootFilesystem: z.ZodOptional<z.ZodObject<{
137
+ type: z.ZodOptional<z.ZodLiteral<"overlay">>;
138
+ mode: z.ZodOptional<z.ZodEnum<{
139
+ ephemeral: "ephemeral";
140
+ "read-only": "read-only";
141
+ }>>;
142
+ disableDefaultBaseLayer: z.ZodOptional<z.ZodBoolean>;
143
+ lowers: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
144
+ kind: z.ZodLiteral<"bundled-base-filesystem">;
145
+ }, z.core.$strict>, z.ZodObject<{
146
+ kind: z.ZodLiteral<"snapshot-export">;
147
+ source: z.ZodUnknown;
148
+ }, z.core.$strict>]>>>;
149
+ }, z.core.$strict>>;
150
+ mounts: z.ZodOptional<z.ZodArray<z.ZodType<NativeMountConfig, unknown, z.core.$ZodTypeInternals<NativeMountConfig, unknown>>>>;
151
+ additionalInstructions: z.ZodOptional<z.ZodString>;
152
+ permissions: z.ZodOptional<z.ZodObject<{
153
+ fs: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
154
+ allow: "allow";
155
+ deny: "deny";
156
+ }>, z.ZodObject<{
157
+ default: z.ZodOptional<z.ZodEnum<{
158
+ allow: "allow";
159
+ deny: "deny";
160
+ }>>;
161
+ rules: z.ZodArray<z.ZodObject<{
162
+ mode: z.ZodEnum<{
163
+ allow: "allow";
164
+ deny: "deny";
165
+ }>;
166
+ operations: z.ZodOptional<z.ZodArray<z.ZodString>>;
167
+ paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
168
+ }, z.core.$strict>>;
169
+ }, z.core.$strict>]>>;
170
+ network: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
171
+ allow: "allow";
172
+ deny: "deny";
173
+ }>, z.ZodObject<{
174
+ default: z.ZodOptional<z.ZodEnum<{
175
+ allow: "allow";
176
+ deny: "deny";
177
+ }>>;
178
+ rules: z.ZodArray<z.ZodObject<{
179
+ mode: z.ZodEnum<{
180
+ allow: "allow";
181
+ deny: "deny";
182
+ }>;
183
+ operations: z.ZodOptional<z.ZodArray<z.ZodString>>;
184
+ patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
185
+ }, z.core.$strict>>;
186
+ }, z.core.$strict>]>>;
187
+ childProcess: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
188
+ allow: "allow";
189
+ deny: "deny";
190
+ }>, z.ZodObject<{
191
+ default: z.ZodOptional<z.ZodEnum<{
192
+ allow: "allow";
193
+ deny: "deny";
194
+ }>>;
195
+ rules: z.ZodArray<z.ZodObject<{
196
+ mode: z.ZodEnum<{
197
+ allow: "allow";
198
+ deny: "deny";
199
+ }>;
200
+ operations: z.ZodOptional<z.ZodArray<z.ZodString>>;
201
+ patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
202
+ }, z.core.$strict>>;
203
+ }, z.core.$strict>]>>;
204
+ process: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
205
+ allow: "allow";
206
+ deny: "deny";
207
+ }>, z.ZodObject<{
208
+ default: z.ZodOptional<z.ZodEnum<{
209
+ allow: "allow";
210
+ deny: "deny";
211
+ }>>;
212
+ rules: z.ZodArray<z.ZodObject<{
213
+ mode: z.ZodEnum<{
214
+ allow: "allow";
215
+ deny: "deny";
216
+ }>;
217
+ operations: z.ZodOptional<z.ZodArray<z.ZodString>>;
218
+ patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
219
+ }, z.core.$strict>>;
220
+ }, z.core.$strict>]>>;
221
+ env: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
222
+ allow: "allow";
223
+ deny: "deny";
224
+ }>, z.ZodObject<{
225
+ default: z.ZodOptional<z.ZodEnum<{
226
+ allow: "allow";
227
+ deny: "deny";
228
+ }>>;
229
+ rules: z.ZodArray<z.ZodObject<{
230
+ mode: z.ZodEnum<{
231
+ allow: "allow";
232
+ deny: "deny";
233
+ }>;
234
+ operations: z.ZodOptional<z.ZodArray<z.ZodString>>;
235
+ patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
236
+ }, z.core.$strict>>;
237
+ }, z.core.$strict>]>>;
238
+ binding: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
239
+ allow: "allow";
240
+ deny: "deny";
241
+ }>, z.ZodObject<{
242
+ default: z.ZodOptional<z.ZodEnum<{
243
+ allow: "allow";
244
+ deny: "deny";
245
+ }>>;
246
+ rules: z.ZodArray<z.ZodObject<{
247
+ mode: z.ZodEnum<{
248
+ allow: "allow";
249
+ deny: "deny";
250
+ }>;
251
+ operations: z.ZodOptional<z.ZodArray<z.ZodString>>;
252
+ patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
253
+ }, z.core.$strict>>;
254
+ }, z.core.$strict>]>>;
255
+ }, z.core.$strict>>;
256
+ sidecar: z.ZodOptional<z.ZodObject<{
257
+ kind: z.ZodLiteral<"shared">;
258
+ pool: z.ZodOptional<z.ZodString>;
259
+ }, z.core.$strict>>;
260
+ limits: z.ZodOptional<z.ZodObject<{
261
+ resources: z.ZodOptional<z.ZodObject<{
262
+ cpuCount: z.ZodOptional<z.ZodNumber>;
263
+ maxProcesses: z.ZodOptional<z.ZodNumber>;
264
+ maxOpenFds: z.ZodOptional<z.ZodNumber>;
265
+ maxPipes: z.ZodOptional<z.ZodNumber>;
266
+ maxPtys: z.ZodOptional<z.ZodNumber>;
267
+ maxSockets: z.ZodOptional<z.ZodNumber>;
268
+ maxConnections: z.ZodOptional<z.ZodNumber>;
269
+ maxSocketBufferedBytes: z.ZodOptional<z.ZodNumber>;
270
+ maxSocketDatagramQueueLen: z.ZodOptional<z.ZodNumber>;
271
+ maxFilesystemBytes: z.ZodOptional<z.ZodNumber>;
272
+ maxInodeCount: z.ZodOptional<z.ZodNumber>;
273
+ maxBlockingReadMs: z.ZodOptional<z.ZodNumber>;
274
+ maxPreadBytes: z.ZodOptional<z.ZodNumber>;
275
+ maxFdWriteBytes: z.ZodOptional<z.ZodNumber>;
276
+ maxProcessArgvBytes: z.ZodOptional<z.ZodNumber>;
277
+ maxProcessEnvBytes: z.ZodOptional<z.ZodNumber>;
278
+ maxReaddirEntries: z.ZodOptional<z.ZodNumber>;
279
+ maxWasmFuel: z.ZodOptional<z.ZodNumber>;
280
+ maxWasmMemoryBytes: z.ZodOptional<z.ZodNumber>;
281
+ maxWasmStackBytes: z.ZodOptional<z.ZodNumber>;
282
+ }, z.core.$strict>>;
283
+ http: z.ZodOptional<z.ZodObject<{
284
+ maxFetchResponseBytes: z.ZodOptional<z.ZodNumber>;
285
+ }, z.core.$strict>>;
286
+ tools: z.ZodOptional<z.ZodObject<{
287
+ defaultToolTimeoutMs: z.ZodOptional<z.ZodNumber>;
288
+ maxToolTimeoutMs: z.ZodOptional<z.ZodNumber>;
289
+ maxRegisteredToolkits: z.ZodOptional<z.ZodNumber>;
290
+ maxRegisteredToolsPerVm: z.ZodOptional<z.ZodNumber>;
291
+ maxToolsPerToolkit: z.ZodOptional<z.ZodNumber>;
292
+ maxToolSchemaBytes: z.ZodOptional<z.ZodNumber>;
293
+ maxToolExamplesPerTool: z.ZodOptional<z.ZodNumber>;
294
+ maxToolExampleInputBytes: z.ZodOptional<z.ZodNumber>;
295
+ }, z.core.$strict>>;
296
+ plugins: z.ZodOptional<z.ZodObject<{
297
+ maxPersistedManifestBytes: z.ZodOptional<z.ZodNumber>;
298
+ maxPersistedManifestFileBytes: z.ZodOptional<z.ZodNumber>;
299
+ }, z.core.$strict>>;
300
+ acp: z.ZodOptional<z.ZodObject<{
301
+ maxReadLineBytes: z.ZodOptional<z.ZodNumber>;
302
+ stdoutBufferByteLimit: z.ZodOptional<z.ZodNumber>;
303
+ }, z.core.$strict>>;
304
+ jsRuntime: z.ZodOptional<z.ZodObject<{
305
+ v8HeapLimitMb: z.ZodOptional<z.ZodNumber>;
306
+ syncRpcWaitTimeoutMs: z.ZodOptional<z.ZodNumber>;
307
+ cpuTimeLimitMs: z.ZodOptional<z.ZodNumber>;
308
+ wallClockLimitMs: z.ZodOptional<z.ZodNumber>;
309
+ importCacheMaterializeTimeoutMs: z.ZodOptional<z.ZodNumber>;
310
+ capturedOutputLimitBytes: z.ZodOptional<z.ZodNumber>;
311
+ stdinBufferLimitBytes: z.ZodOptional<z.ZodNumber>;
312
+ eventPayloadLimitBytes: z.ZodOptional<z.ZodNumber>;
313
+ v8IpcMaxFrameBytes: z.ZodOptional<z.ZodNumber>;
314
+ }, z.core.$strict>>;
315
+ python: z.ZodOptional<z.ZodObject<{
316
+ outputBufferMaxBytes: z.ZodOptional<z.ZodNumber>;
317
+ executionTimeoutMs: z.ZodOptional<z.ZodNumber>;
318
+ maxOldSpaceMb: z.ZodOptional<z.ZodNumber>;
319
+ vfsRpcTimeoutMs: z.ZodOptional<z.ZodNumber>;
320
+ }, z.core.$strict>>;
321
+ wasm: z.ZodOptional<z.ZodObject<{
322
+ maxModuleFileBytes: z.ZodOptional<z.ZodNumber>;
323
+ capturedOutputLimitBytes: z.ZodOptional<z.ZodNumber>;
324
+ syncReadLimitBytes: z.ZodOptional<z.ZodNumber>;
325
+ prewarmTimeoutMs: z.ZodOptional<z.ZodNumber>;
326
+ runnerHeapLimitMb: z.ZodOptional<z.ZodNumber>;
327
+ }, z.core.$strict>>;
328
+ }, z.core.$strict>>;
329
+ }, z.core.$strict>;
107
330
  declare const agentOsActorConfigSchema: z.ZodObject<{
108
- options: z.ZodOptional<z.ZodCustom<AgentOsOptions, AgentOsOptions>>;
331
+ options: z.ZodOptional<z.ZodObject<{
332
+ software: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
333
+ defaultSoftware: z.ZodOptional<z.ZodBoolean>;
334
+ loopbackExemptPorts: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
335
+ allowedNodeBuiltins: z.ZodOptional<z.ZodArray<z.ZodString>>;
336
+ rootFilesystem: z.ZodOptional<z.ZodObject<{
337
+ type: z.ZodOptional<z.ZodLiteral<"overlay">>;
338
+ mode: z.ZodOptional<z.ZodEnum<{
339
+ ephemeral: "ephemeral";
340
+ "read-only": "read-only";
341
+ }>>;
342
+ disableDefaultBaseLayer: z.ZodOptional<z.ZodBoolean>;
343
+ lowers: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
344
+ kind: z.ZodLiteral<"bundled-base-filesystem">;
345
+ }, z.core.$strict>, z.ZodObject<{
346
+ kind: z.ZodLiteral<"snapshot-export">;
347
+ source: z.ZodUnknown;
348
+ }, z.core.$strict>]>>>;
349
+ }, z.core.$strict>>;
350
+ mounts: z.ZodOptional<z.ZodArray<z.ZodType<NativeMountConfig, unknown, z.core.$ZodTypeInternals<NativeMountConfig, unknown>>>>;
351
+ additionalInstructions: z.ZodOptional<z.ZodString>;
352
+ permissions: z.ZodOptional<z.ZodObject<{
353
+ fs: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
354
+ allow: "allow";
355
+ deny: "deny";
356
+ }>, z.ZodObject<{
357
+ default: z.ZodOptional<z.ZodEnum<{
358
+ allow: "allow";
359
+ deny: "deny";
360
+ }>>;
361
+ rules: z.ZodArray<z.ZodObject<{
362
+ mode: z.ZodEnum<{
363
+ allow: "allow";
364
+ deny: "deny";
365
+ }>;
366
+ operations: z.ZodOptional<z.ZodArray<z.ZodString>>;
367
+ paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
368
+ }, z.core.$strict>>;
369
+ }, z.core.$strict>]>>;
370
+ network: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
371
+ allow: "allow";
372
+ deny: "deny";
373
+ }>, z.ZodObject<{
374
+ default: z.ZodOptional<z.ZodEnum<{
375
+ allow: "allow";
376
+ deny: "deny";
377
+ }>>;
378
+ rules: z.ZodArray<z.ZodObject<{
379
+ mode: z.ZodEnum<{
380
+ allow: "allow";
381
+ deny: "deny";
382
+ }>;
383
+ operations: z.ZodOptional<z.ZodArray<z.ZodString>>;
384
+ patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
385
+ }, z.core.$strict>>;
386
+ }, z.core.$strict>]>>;
387
+ childProcess: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
388
+ allow: "allow";
389
+ deny: "deny";
390
+ }>, z.ZodObject<{
391
+ default: z.ZodOptional<z.ZodEnum<{
392
+ allow: "allow";
393
+ deny: "deny";
394
+ }>>;
395
+ rules: z.ZodArray<z.ZodObject<{
396
+ mode: z.ZodEnum<{
397
+ allow: "allow";
398
+ deny: "deny";
399
+ }>;
400
+ operations: z.ZodOptional<z.ZodArray<z.ZodString>>;
401
+ patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
402
+ }, z.core.$strict>>;
403
+ }, z.core.$strict>]>>;
404
+ process: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
405
+ allow: "allow";
406
+ deny: "deny";
407
+ }>, z.ZodObject<{
408
+ default: z.ZodOptional<z.ZodEnum<{
409
+ allow: "allow";
410
+ deny: "deny";
411
+ }>>;
412
+ rules: z.ZodArray<z.ZodObject<{
413
+ mode: z.ZodEnum<{
414
+ allow: "allow";
415
+ deny: "deny";
416
+ }>;
417
+ operations: z.ZodOptional<z.ZodArray<z.ZodString>>;
418
+ patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
419
+ }, z.core.$strict>>;
420
+ }, z.core.$strict>]>>;
421
+ env: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
422
+ allow: "allow";
423
+ deny: "deny";
424
+ }>, z.ZodObject<{
425
+ default: z.ZodOptional<z.ZodEnum<{
426
+ allow: "allow";
427
+ deny: "deny";
428
+ }>>;
429
+ rules: z.ZodArray<z.ZodObject<{
430
+ mode: z.ZodEnum<{
431
+ allow: "allow";
432
+ deny: "deny";
433
+ }>;
434
+ operations: z.ZodOptional<z.ZodArray<z.ZodString>>;
435
+ patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
436
+ }, z.core.$strict>>;
437
+ }, z.core.$strict>]>>;
438
+ binding: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
439
+ allow: "allow";
440
+ deny: "deny";
441
+ }>, z.ZodObject<{
442
+ default: z.ZodOptional<z.ZodEnum<{
443
+ allow: "allow";
444
+ deny: "deny";
445
+ }>>;
446
+ rules: z.ZodArray<z.ZodObject<{
447
+ mode: z.ZodEnum<{
448
+ allow: "allow";
449
+ deny: "deny";
450
+ }>;
451
+ operations: z.ZodOptional<z.ZodArray<z.ZodString>>;
452
+ patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
453
+ }, z.core.$strict>>;
454
+ }, z.core.$strict>]>>;
455
+ }, z.core.$strict>>;
456
+ sidecar: z.ZodOptional<z.ZodObject<{
457
+ kind: z.ZodLiteral<"shared">;
458
+ pool: z.ZodOptional<z.ZodString>;
459
+ }, z.core.$strict>>;
460
+ limits: z.ZodOptional<z.ZodObject<{
461
+ resources: z.ZodOptional<z.ZodObject<{
462
+ cpuCount: z.ZodOptional<z.ZodNumber>;
463
+ maxProcesses: z.ZodOptional<z.ZodNumber>;
464
+ maxOpenFds: z.ZodOptional<z.ZodNumber>;
465
+ maxPipes: z.ZodOptional<z.ZodNumber>;
466
+ maxPtys: z.ZodOptional<z.ZodNumber>;
467
+ maxSockets: z.ZodOptional<z.ZodNumber>;
468
+ maxConnections: z.ZodOptional<z.ZodNumber>;
469
+ maxSocketBufferedBytes: z.ZodOptional<z.ZodNumber>;
470
+ maxSocketDatagramQueueLen: z.ZodOptional<z.ZodNumber>;
471
+ maxFilesystemBytes: z.ZodOptional<z.ZodNumber>;
472
+ maxInodeCount: z.ZodOptional<z.ZodNumber>;
473
+ maxBlockingReadMs: z.ZodOptional<z.ZodNumber>;
474
+ maxPreadBytes: z.ZodOptional<z.ZodNumber>;
475
+ maxFdWriteBytes: z.ZodOptional<z.ZodNumber>;
476
+ maxProcessArgvBytes: z.ZodOptional<z.ZodNumber>;
477
+ maxProcessEnvBytes: z.ZodOptional<z.ZodNumber>;
478
+ maxReaddirEntries: z.ZodOptional<z.ZodNumber>;
479
+ maxWasmFuel: z.ZodOptional<z.ZodNumber>;
480
+ maxWasmMemoryBytes: z.ZodOptional<z.ZodNumber>;
481
+ maxWasmStackBytes: z.ZodOptional<z.ZodNumber>;
482
+ }, z.core.$strict>>;
483
+ http: z.ZodOptional<z.ZodObject<{
484
+ maxFetchResponseBytes: z.ZodOptional<z.ZodNumber>;
485
+ }, z.core.$strict>>;
486
+ tools: z.ZodOptional<z.ZodObject<{
487
+ defaultToolTimeoutMs: z.ZodOptional<z.ZodNumber>;
488
+ maxToolTimeoutMs: z.ZodOptional<z.ZodNumber>;
489
+ maxRegisteredToolkits: z.ZodOptional<z.ZodNumber>;
490
+ maxRegisteredToolsPerVm: z.ZodOptional<z.ZodNumber>;
491
+ maxToolsPerToolkit: z.ZodOptional<z.ZodNumber>;
492
+ maxToolSchemaBytes: z.ZodOptional<z.ZodNumber>;
493
+ maxToolExamplesPerTool: z.ZodOptional<z.ZodNumber>;
494
+ maxToolExampleInputBytes: z.ZodOptional<z.ZodNumber>;
495
+ }, z.core.$strict>>;
496
+ plugins: z.ZodOptional<z.ZodObject<{
497
+ maxPersistedManifestBytes: z.ZodOptional<z.ZodNumber>;
498
+ maxPersistedManifestFileBytes: z.ZodOptional<z.ZodNumber>;
499
+ }, z.core.$strict>>;
500
+ acp: z.ZodOptional<z.ZodObject<{
501
+ maxReadLineBytes: z.ZodOptional<z.ZodNumber>;
502
+ stdoutBufferByteLimit: z.ZodOptional<z.ZodNumber>;
503
+ }, z.core.$strict>>;
504
+ jsRuntime: z.ZodOptional<z.ZodObject<{
505
+ v8HeapLimitMb: z.ZodOptional<z.ZodNumber>;
506
+ syncRpcWaitTimeoutMs: z.ZodOptional<z.ZodNumber>;
507
+ cpuTimeLimitMs: z.ZodOptional<z.ZodNumber>;
508
+ wallClockLimitMs: z.ZodOptional<z.ZodNumber>;
509
+ importCacheMaterializeTimeoutMs: z.ZodOptional<z.ZodNumber>;
510
+ capturedOutputLimitBytes: z.ZodOptional<z.ZodNumber>;
511
+ stdinBufferLimitBytes: z.ZodOptional<z.ZodNumber>;
512
+ eventPayloadLimitBytes: z.ZodOptional<z.ZodNumber>;
513
+ v8IpcMaxFrameBytes: z.ZodOptional<z.ZodNumber>;
514
+ }, z.core.$strict>>;
515
+ python: z.ZodOptional<z.ZodObject<{
516
+ outputBufferMaxBytes: z.ZodOptional<z.ZodNumber>;
517
+ executionTimeoutMs: z.ZodOptional<z.ZodNumber>;
518
+ maxOldSpaceMb: z.ZodOptional<z.ZodNumber>;
519
+ vfsRpcTimeoutMs: z.ZodOptional<z.ZodNumber>;
520
+ }, z.core.$strict>>;
521
+ wasm: z.ZodOptional<z.ZodObject<{
522
+ maxModuleFileBytes: z.ZodOptional<z.ZodNumber>;
523
+ capturedOutputLimitBytes: z.ZodOptional<z.ZodNumber>;
524
+ syncReadLimitBytes: z.ZodOptional<z.ZodNumber>;
525
+ prewarmTimeoutMs: z.ZodOptional<z.ZodNumber>;
526
+ runnerHeapLimitMb: z.ZodOptional<z.ZodNumber>;
527
+ }, z.core.$strict>>;
528
+ }, z.core.$strict>>;
529
+ }, z.core.$strict>>;
530
+ actorOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
109
531
  preview: z.ZodPrefault<z.ZodObject<{
110
532
  defaultExpiresInSeconds: z.ZodDefault<z.ZodNumber>;
111
533
  maxExpiresInSeconds: z.ZodDefault<z.ZodNumber>;
@@ -114,17 +536,166 @@ declare const agentOsActorConfigSchema: z.ZodObject<{
114
536
  onSessionEvent: z.ZodOptional<z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
115
537
  onPermissionRequest: z.ZodOptional<z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
116
538
  }, z.core.$strict>;
539
+ /**
540
+ * Type mirror of `nativeAgentOsOptionsSchema`.
541
+ *
542
+ * Keep this in sync with the schema above and the Rust serde mirror at
543
+ * `crates/agentos-actor-plugin/src/config.rs::AgentOsConfigJson`.
544
+ */
545
+ type NativeAgentOsOptions = Pick<AgentOsOptions, "software" | "defaultSoftware" | "loopbackExemptPorts" | "allowedNodeBuiltins" | "rootFilesystem" | "additionalInstructions" | "permissions" | "limits"> & {
546
+ mounts?: NativeMountConfig[];
547
+ sidecar?: {
548
+ kind: "shared";
549
+ pool?: string;
550
+ };
551
+ };
117
552
  type AgentOsActorContext<TConnParams> = ActorContext<AgentOsActorState, TConnParams, undefined, AgentOsActorVars, undefined, any>;
118
553
  interface AgentOsActorConfigCallbacks<TConnParams> {
119
554
  onBeforeConnect?: (c: BeforeConnectContext<AgentOsActorState, AgentOsActorVars, undefined, any>, params: TConnParams) => void | Promise<void>;
120
555
  onSessionEvent?: (c: AgentOsActorContext<TConnParams>, sessionId: string, event: JsonRpcNotification) => void | Promise<void>;
121
556
  onPermissionRequest?: (c: AgentOsActorContext<TConnParams>, sessionId: string, request: PermissionRequest) => void | Promise<void>;
122
557
  }
123
- type AgentOsActorConfig<TConnParams = undefined> = Omit<z.infer<typeof agentOsActorConfigSchema>, "onBeforeConnect" | "onSessionEvent" | "onPermissionRequest"> & AgentOsActorConfigCallbacks<TConnParams>;
124
- type AgentOsActorConfigInput<TConnParams = undefined> = Omit<z.input<typeof agentOsActorConfigSchema>, "onBeforeConnect" | "onSessionEvent" | "onPermissionRequest"> & AgentOsActorConfigCallbacks<TConnParams>;
558
+ type AgentOsActorConfig<TConnParams = undefined> = Omit<z.infer<typeof agentOsActorConfigSchema>, "options" | "onBeforeConnect" | "onSessionEvent" | "onPermissionRequest"> & {
559
+ options?: NativeAgentOsOptions;
560
+ } & AgentOsActorConfigCallbacks<TConnParams>;
561
+ type AgentOsActorConfigInput<TConnParams = undefined> = Omit<z.input<typeof agentOsActorConfigSchema>, "options" | "onBeforeConnect" | "onSessionEvent" | "onPermissionRequest"> & {
562
+ options?: NativeAgentOsOptions;
563
+ } & AgentOsActorConfigCallbacks<TConnParams>;
564
+
565
+ type Ctx = any;
566
+ interface DirEntry {
567
+ path: string;
568
+ type: "file" | "directory" | "symlink";
569
+ size: number;
570
+ }
571
+ interface ReaddirEntry {
572
+ name: string;
573
+ isDirectory: boolean;
574
+ isSymbolicLink: boolean;
575
+ }
576
+ interface SpawnedProcess {
577
+ pid: number;
578
+ }
579
+ interface ExecActionOptions {
580
+ env?: Record<string, string>;
581
+ cwd?: string;
582
+ }
583
+ interface SpawnActionOptions {
584
+ env?: Record<string, string>;
585
+ cwd?: string;
586
+ streamStdin?: boolean;
587
+ }
588
+ interface ScheduledCronJob {
589
+ id: string;
590
+ }
591
+ interface VmFetchOptions {
592
+ method?: string;
593
+ headers?: Record<string, string>;
594
+ body?: string | Uint8Array;
595
+ }
596
+ interface VmFetchResponse {
597
+ status: number;
598
+ statusText: string;
599
+ headers: Record<string, string>;
600
+ body: Uint8Array;
601
+ }
602
+ interface CreateSessionOptions {
603
+ cwd?: string;
604
+ env?: Record<string, string>;
605
+ skipOsInstructions?: boolean;
606
+ additionalInstructions?: string;
607
+ }
608
+ interface SignedPreviewUrl {
609
+ path: string;
610
+ token: string;
611
+ port: number;
612
+ expiresAt: number;
613
+ }
614
+ interface OpenShellActionOptions {
615
+ command?: string;
616
+ args?: string[];
617
+ env?: Record<string, string>;
618
+ cwd?: string;
619
+ cols?: number;
620
+ rows?: number;
621
+ }
622
+ interface OpenShellResult {
623
+ shellId: string;
624
+ }
625
+ interface WriteFileResult {
626
+ path: string;
627
+ success: boolean;
628
+ error?: string;
629
+ }
630
+ interface ReadFileResult {
631
+ path: string;
632
+ content?: Uint8Array;
633
+ error?: string;
634
+ }
635
+ interface MountInfo {
636
+ path: string;
637
+ kind: "host_dir" | "s3" | "google_drive" | "sandbox_agent";
638
+ config: unknown;
639
+ readOnly: boolean;
640
+ }
641
+ interface SoftwareInfo {
642
+ package: string;
643
+ kind: "wasm-commands" | "agent" | "tool";
644
+ version: string | null;
645
+ commands: string[];
646
+ }
647
+ type AgentOsActions = {
648
+ readFile: (c: Ctx, path: string) => Promise<Uint8Array>;
649
+ writeFile: (c: Ctx, path: string, content: string | Uint8Array) => Promise<void>;
650
+ stat: (c: Ctx, path: string) => Promise<VirtualStat>;
651
+ mkdir: (c: Ctx, path: string) => Promise<void>;
652
+ readdir: (c: Ctx, path: string) => Promise<string[]>;
653
+ readdirEntries: (c: Ctx, path: string) => Promise<ReaddirEntry[] | null>;
654
+ exists: (c: Ctx, path: string) => Promise<boolean>;
655
+ move: (c: Ctx, from: string, to: string) => Promise<void>;
656
+ deleteFile: (c: Ctx, path: string, options?: {
657
+ recursive?: boolean;
658
+ }) => Promise<void>;
659
+ writeFiles: (c: Ctx, entries: {
660
+ path: string;
661
+ content: string | Uint8Array;
662
+ }[]) => Promise<WriteFileResult[]>;
663
+ readFiles: (c: Ctx, paths: string[]) => Promise<ReadFileResult[]>;
664
+ readdirRecursive: (c: Ctx, path: string) => Promise<DirEntry[]>;
665
+ exec: (c: Ctx, command: string, options?: ExecActionOptions) => Promise<ExecResult>;
666
+ spawn: (c: Ctx, command: string, args: string[], options?: SpawnActionOptions) => Promise<SpawnedProcess>;
667
+ waitProcess: (c: Ctx, pid: number) => Promise<number>;
668
+ killProcess: (c: Ctx, pid: number) => Promise<void>;
669
+ stopProcess: (c: Ctx, pid: number) => Promise<void>;
670
+ listProcesses: (c: Ctx) => Promise<SpawnedProcessInfo[]>;
671
+ allProcesses: (c: Ctx) => Promise<ProcessInfo[]>;
672
+ processTree: (c: Ctx) => Promise<ProcessTreeNode[]>;
673
+ getProcess: (c: Ctx, pid: number) => Promise<SpawnedProcessInfo>;
674
+ writeProcessStdin: (c: Ctx, pid: number, data: string | Uint8Array) => Promise<void>;
675
+ closeProcessStdin: (c: Ctx, pid: number) => Promise<void>;
676
+ openShell: (c: Ctx, options?: OpenShellActionOptions) => Promise<OpenShellResult>;
677
+ writeShell: (c: Ctx, shellId: string, data: string | Uint8Array) => Promise<void>;
678
+ resizeShell: (c: Ctx, shellId: string, cols: number, rows: number) => Promise<void>;
679
+ closeShell: (c: Ctx, shellId: string) => Promise<void>;
680
+ waitShell: (c: Ctx, shellId: string) => Promise<number>;
681
+ vmFetch: (c: Ctx, port: number, url: string, options?: VmFetchOptions) => Promise<VmFetchResponse>;
682
+ scheduleCron: (c: Ctx, options: SerializableCronJobOptions) => Promise<ScheduledCronJob>;
683
+ listCronJobs: (c: Ctx) => Promise<SerializableCronJobInfo[]>;
684
+ cancelCronJob: (c: Ctx, id: string) => Promise<void>;
685
+ createSession: (c: Ctx, agentType: string, options?: CreateSessionOptions) => Promise<string>;
686
+ sendPrompt: (c: Ctx, sessionId: string, text: string) => Promise<PromptResult>;
687
+ closeSession: (c: Ctx, sessionId: string) => Promise<void>;
688
+ listPersistedSessions: (c: Ctx) => Promise<PersistedSessionRecord[]>;
689
+ getSessionEvents: (c: Ctx, sessionId: string) => Promise<PersistedSessionEvent[]>;
690
+ respondPermission: (c: Ctx, sessionId: string, permissionId: string, reply: PermissionReply) => Promise<void>;
691
+ createSignedPreviewUrl: (c: Ctx, port: number, ttlSeconds: number) => Promise<SignedPreviewUrl>;
692
+ expireSignedPreviewUrl: (c: Ctx, token: string) => Promise<void>;
693
+ listMounts: (c: Ctx) => Promise<MountInfo[]>;
694
+ listSoftware: (c: Ctx) => Promise<SoftwareInfo[]>;
695
+ };
125
696
 
126
697
  /**
127
- * Rust-backed `agentOs(...)` definition.
698
+ * Rust-backed `agentOS(...)` definition.
128
699
  *
129
700
  * Produces an `ActorDefinition` whose `nativeFactoryBuilder` constructs a
130
701
  * native-actor-plugin factory through `runtime.createNativePluginFactory(...)`
@@ -137,7 +708,7 @@ type AgentOsActorConfigInput<TConnParams = undefined> = Omit<z.input<typeof agen
137
708
 
138
709
  /**
139
710
  * A native `host_dir` mount of a host `node_modules` directory at
140
- * `/root/node_modules`, the serializable form `agentOs({ options: { mounts } })`
711
+ * `/root/node_modules`, the serializable form `agentOS({ options: { mounts } })`
141
712
  * accepts across the NAPI boundary.
142
713
  */
143
714
  interface NodeModulesMountConfig {
@@ -167,12 +738,14 @@ declare function nodeModulesMount(hostNodeModulesDir: string, opts?: {
167
738
  }): NodeModulesMountConfig;
168
739
  declare function buildConfigJson<TConnParams>(parsed: AgentOsActorConfig<TConnParams>): string;
169
740
  /**
170
- * Type alias for the `agentOs(...)` return type. Events are not typed at the
171
- * TS surface because the Rust plugin owns the broadcast set and the
172
- * test/client surface uses `any` for actions.
741
+ * Type alias for the `agentOS(...)` return type. Events are not typed at the TS
742
+ * surface because the Rust plugin owns the broadcast set, but the ACTIONS are
743
+ * typed via {@link AgentOsActions} — generated from the Rust dispatch contract
744
+ * table in `crates/agentos-actor-plugin/src/actions/contract_surface.rs`.
745
+ * That is what gives `createClient<typeof registry>()` a fully-typed handle
746
+ * (e.g. `handle.exec()` returns `ExecResult`, not `unknown`).
173
747
  */
174
- type AgentOsActorDefinition<TConnParams> = ActorDefinition<AgentOsActorState, TConnParams, undefined, AgentOsActorVars, undefined, DatabaseProvider<RawAccess>, Record<never, never>, Record<never, never>, any>;
175
- declare function agentOs<TConnParams = undefined>(config: AgentOsActorConfigInput<TConnParams>): AgentOsActorDefinition<TConnParams>;
748
+ type AgentOsActorDefinition<TConnParams> = ActorDefinition<AgentOsActorState, TConnParams, undefined, AgentOsActorVars, undefined, DatabaseProvider<RawAccess>, Record<never, never>, Record<never, never>, AgentOsActions>;
176
749
 
177
750
  /**
178
751
  * Resolve the absolute path to the agent-os actor plugin cdylib. RivetKit
@@ -180,7 +753,22 @@ declare function agentOs<TConnParams = undefined>(config: AgentOsActorConfigInpu
180
753
  */
181
754
  declare function getPluginPath(): string;
182
755
 
183
- type AgentOSActorConfigInput<TConnParams = undefined> = AgentOsActorConfigInput<TConnParams>["options"];
184
- declare function agentOS<TConnParams = undefined>(config?: AgentOSActorConfigInput<TConnParams>): AgentOsActorDefinition<TConnParams>;
756
+ /**
757
+ * `setup()` wrapper that defaults the registry transport message-size caps to
758
+ * never-hit-by-normal-use values for AgentOS apps, mirroring the per-actor crank
759
+ * in `DEFAULT_AGENTOS_ACTOR_OPTIONS`. Any caller-supplied value wins, so an app
760
+ * can still tighten the bound when it wants one.
761
+ */
762
+ declare const setup: typeof setup$1;
763
+
764
+ type AgentOSActorConfigInput<TConnParams = undefined> = NativeAgentOsOptions & Omit<AgentOsActorConfigInput<TConnParams>, "options">;
765
+ type AgentOSConfigInput<TConnParams = undefined> = AgentOsOptions & {
766
+ preview?: AgentOsActorConfigInput<TConnParams>["preview"];
767
+ actorOptions?: AgentOsActorConfigInput<TConnParams>["actorOptions"];
768
+ onBeforeConnect?: AgentOsActorConfigInput<TConnParams>["onBeforeConnect"];
769
+ onSessionEvent?: (sessionId: string, event: JsonRpcNotification) => void | Promise<void>;
770
+ onPermissionRequest?: (sessionId: string, request: PermissionRequest) => void | Promise<void>;
771
+ };
772
+ declare function agentOS<TConnParams = undefined>(config?: AgentOSConfigInput<TConnParams>): AgentOsActorDefinition<TConnParams>;
185
773
 
186
- export { type AgentOSActorConfigInput, type AgentOsActionContext, type AgentOsActorConfig, type AgentOsActorConfigInput, type AgentOsActorState, type AgentOsActorVars, type AgentOsEvents, type CronEventPayload, type NodeModulesMountConfig, type PermissionRequestPayload, type PersistedSessionEvent, type PersistedSessionRecord, type ProcessExitPayload, type ProcessOutputPayload, type PromptResult, type SerializableCronAction, type SerializableCronJobInfo, type SerializableCronJobOptions, type SessionEventPayload, type SessionRecord, type ShellDataPayload, type VmBootedPayload, type VmShutdownPayload, agentOS, agentOs, agentOsActorConfigSchema, buildConfigJson, getPluginPath, nodeModulesMount };
774
+ export { type AgentCrashedPayload, type AgentOSActorConfigInput, type AgentOSConfigInput, type AgentOsActionContext, type AgentOsActions, type AgentOsActorConfig, type AgentOsActorConfigInput, type AgentOsActorState, type AgentOsActorVars, type AgentOsEvents, type CreateSessionOptions, type CronEventPayload, type DirEntry, type NativeAgentOsOptions, type NodeModulesMountConfig, type PermissionRequestPayload, type PersistedSessionEvent, type PersistedSessionRecord, type ProcessExitPayload, type ProcessOutputPayload, type PromptResult, type ReadFileResult, type ScheduledCronJob, type SerializableCronAction, type SerializableCronEvent, type SerializableCronJobInfo, type SerializableCronJobOptions, type SessionEventPayload, type SessionRecord, type ShellDataPayload, type SignedPreviewUrl, type SpawnedProcess, type VmBootedPayload, type VmFetchOptions, type VmFetchResponse, type VmShutdownPayload, type WriteFileResult, agentOS, agentOsActorConfigSchema, buildConfigJson, getPluginPath, nativeAgentOsOptionsSchema, nodeModulesMount, setup };