@rivet-dev/agentos 0.0.0-agentos-dylib-plugin.f065be7 → 0.0.0-chdir-fix.3d9feab

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,4 +1,774 @@
1
- export { agentOs, type AgentOsActorDefinition, buildConfigJson, nodeModulesMount, type NodeModulesMountConfig, } from "./actor.js";
2
- export { type AgentOsActorConfig, type AgentOsActorConfigInput, agentOsActorConfigSchema, } from "./config.js";
3
- export { getPluginPath } from "./plugin-binary.js";
4
- export type { AgentOsActionContext, AgentOsActorState, AgentOsActorVars, AgentOsEvents, CronEventPayload, PermissionRequestPayload, PersistedSessionEvent, PersistedSessionRecord, ProcessExitPayload, ProcessOutputPayload, PromptResult, SerializableCronAction, SerializableCronJobInfo, SerializableCronJobOptions, SessionEventPayload, SessionRecord, ShellDataPayload, VmBootedPayload, VmShutdownPayload, } from "./types.js";
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
+ import { z } from 'zod/v4';
5
+
6
+ type AgentOsActorState = {};
7
+ interface AgentOsActorVars {
8
+ agentOs: AgentOs | null;
9
+ activeSessionIds: Set<string>;
10
+ activeProcesses: Set<number>;
11
+ activeHooks: Set<Promise<void>>;
12
+ activeShells: Set<string>;
13
+ sessions: Set<string>;
14
+ }
15
+ interface SessionEventPayload {
16
+ sessionId: string;
17
+ event: JsonRpcNotification;
18
+ }
19
+ interface PermissionRequestPayload {
20
+ sessionId: string;
21
+ request: PermissionRequest;
22
+ }
23
+ interface AgentCrashedPayload {
24
+ sessionId: string;
25
+ event: AgentExitEvent;
26
+ }
27
+ type VmBootedPayload = Record<string, never>;
28
+ interface VmShutdownPayload {
29
+ reason: "sleep" | "destroy" | "error";
30
+ }
31
+ interface ProcessOutputPayload {
32
+ pid: number;
33
+ stream: "stdout" | "stderr";
34
+ data: Uint8Array;
35
+ }
36
+ interface ProcessExitPayload {
37
+ pid: number;
38
+ exitCode: number;
39
+ }
40
+ interface ShellDataPayload {
41
+ shellId: string;
42
+ data: Uint8Array;
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
+ };
63
+ interface CronEventPayload {
64
+ event: SerializableCronEvent;
65
+ }
66
+ interface AgentOsEvents {
67
+ sessionEvent: SessionEventPayload;
68
+ permissionRequest: PermissionRequestPayload;
69
+ agentCrashed: AgentCrashedPayload;
70
+ vmBooted: VmBootedPayload;
71
+ vmShutdown: VmShutdownPayload;
72
+ processOutput: ProcessOutputPayload;
73
+ processExit: ProcessExitPayload;
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;
79
+ cronEvent: CronEventPayload;
80
+ }
81
+ /** Result from sendPrompt. */
82
+ interface PromptResult {
83
+ /** Raw JSON-RPC response from the ACP adapter. */
84
+ response: JsonRpcResponse;
85
+ /** Accumulated agent text output from streamed message chunks. */
86
+ text: string;
87
+ }
88
+ interface SessionRecord {
89
+ sessionId: string;
90
+ agentType: string;
91
+ capabilities: AgentCapabilities;
92
+ agentInfo: AgentInfo | null;
93
+ }
94
+ interface PersistedSessionRecord {
95
+ sessionId: string;
96
+ agentType: string;
97
+ createdAt: number;
98
+ status: "running" | "idle";
99
+ }
100
+ interface PersistedSessionEvent {
101
+ sessionId: string;
102
+ seq: number;
103
+ event: JsonRpcNotification;
104
+ createdAt: number;
105
+ }
106
+ type SerializableCronAction = {
107
+ type: "session";
108
+ agentType: string;
109
+ prompt: string;
110
+ cwd?: string;
111
+ } | {
112
+ type: "exec";
113
+ command: string;
114
+ args?: string[];
115
+ };
116
+ interface SerializableCronJobOptions {
117
+ id?: string;
118
+ schedule: string;
119
+ action: SerializableCronAction;
120
+ overlap?: "allow" | "skip" | "queue";
121
+ }
122
+ interface SerializableCronJobInfo {
123
+ id: string;
124
+ schedule: string;
125
+ overlap: "allow" | "skip" | "queue";
126
+ lastRun?: number;
127
+ nextRun?: number;
128
+ }
129
+ type AgentOsActionContext<TConnParams = undefined> = ActionContext<AgentOsActorState, TConnParams, undefined, AgentOsActorVars, undefined, any>;
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>;
330
+ declare const agentOsActorConfigSchema: z.ZodObject<{
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>>;
531
+ preview: z.ZodPrefault<z.ZodObject<{
532
+ defaultExpiresInSeconds: z.ZodDefault<z.ZodNumber>;
533
+ maxExpiresInSeconds: z.ZodDefault<z.ZodNumber>;
534
+ }, z.core.$strict>>;
535
+ onBeforeConnect: z.ZodOptional<z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
536
+ onSessionEvent: z.ZodOptional<z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
537
+ onPermissionRequest: z.ZodOptional<z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
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
+ };
552
+ type AgentOsActorContext<TConnParams> = ActorContext<AgentOsActorState, TConnParams, undefined, AgentOsActorVars, undefined, any>;
553
+ interface AgentOsActorConfigCallbacks<TConnParams> {
554
+ onBeforeConnect?: (c: BeforeConnectContext<AgentOsActorState, AgentOsActorVars, undefined, any>, params: TConnParams) => void | Promise<void>;
555
+ onSessionEvent?: (c: AgentOsActorContext<TConnParams>, sessionId: string, event: JsonRpcNotification) => void | Promise<void>;
556
+ onPermissionRequest?: (c: AgentOsActorContext<TConnParams>, sessionId: string, request: PermissionRequest) => void | Promise<void>;
557
+ }
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
+ };
696
+
697
+ /**
698
+ * Rust-backed `agentOS(...)` definition.
699
+ *
700
+ * Produces an `ActorDefinition` whose `nativeFactoryBuilder` constructs a
701
+ * native-actor-plugin factory through `runtime.createNativePluginFactory(...)`
702
+ * (NAPI → `dlopen` of the agent-os actor plugin cdylib, the inverse of the
703
+ * generic host loader). All lifecycle, state, and action dispatch live in the
704
+ * Rust plugin (`crates/agentos-actor-plugin`). This JS shim only validates
705
+ * configuration, resolves the plugin + sidecar binaries, and hands the opaque
706
+ * config envelope across the bridge — it owns no agent-os runtime logic.
707
+ */
708
+
709
+ /**
710
+ * A native `host_dir` mount of a host `node_modules` directory at
711
+ * `/root/node_modules`, the serializable form `agentOS({ options: { mounts } })`
712
+ * accepts across the NAPI boundary.
713
+ */
714
+ interface NodeModulesMountConfig {
715
+ path: "/root/node_modules";
716
+ plugin: {
717
+ id: "host_dir";
718
+ config: {
719
+ hostPath: string;
720
+ readOnly: boolean;
721
+ };
722
+ };
723
+ readOnly: boolean;
724
+ }
725
+ /**
726
+ * Mount a host `node_modules` directory into the VM at `/root/node_modules`.
727
+ *
728
+ * This is the explicit, mount-based replacement for the removed `moduleAccessCwd`
729
+ * mechanism: the VM module resolver reads the mounted tree through the kernel
730
+ * VFS, so the caller supplies exactly the `node_modules` directory whose
731
+ * packages should resolve in the guest.
732
+ *
733
+ * @param hostNodeModulesDir Absolute host path to a `node_modules` directory.
734
+ * @param opts.readOnly Defaults to `true`; the mount is read-only.
735
+ */
736
+ declare function nodeModulesMount(hostNodeModulesDir: string, opts?: {
737
+ readOnly?: boolean;
738
+ }): NodeModulesMountConfig;
739
+ declare function buildConfigJson<TConnParams>(parsed: AgentOsActorConfig<TConnParams>): string;
740
+ /**
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`).
747
+ */
748
+ type AgentOsActorDefinition<TConnParams> = ActorDefinition<AgentOsActorState, TConnParams, undefined, AgentOsActorVars, undefined, DatabaseProvider<RawAccess>, Record<never, never>, Record<never, never>, AgentOsActions>;
749
+
750
+ /**
751
+ * Resolve the absolute path to the agent-os actor plugin cdylib. RivetKit
752
+ * `dlopen`s this path through the generic native-plugin ABI.
753
+ */
754
+ declare function getPluginPath(): string;
755
+
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>;
773
+
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 };