@rivet-dev/agentos 0.0.0-codex-agentos-native-platform-e2e.78ef941 → 0.0.0-glibc.4af31c1
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/assets/inspector-tabs-app/assets/badge-Coq9s9H6.js +1 -0
- package/assets/inspector-tabs-app/assets/filesystem-_yeTmDH7.js +1 -0
- package/assets/inspector-tabs-app/assets/index-C50G2vhD.js +125 -0
- package/assets/inspector-tabs-app/assets/index-Dt5XhJ9h.css +1 -0
- package/assets/inspector-tabs-app/assets/mounts-C0eJmxpt.js +1 -0
- package/assets/inspector-tabs-app/assets/processes-CvN1MFLy.js +1 -0
- package/assets/inspector-tabs-app/assets/scroll-area-DzL-iGyn.js +1 -0
- package/assets/inspector-tabs-app/assets/software-BjGEcqMs.js +1 -0
- package/assets/inspector-tabs-app/assets/transcript-BKLxbOF5.js +1 -0
- package/assets/inspector-tabs-app/assets/useQuery-RSkOi56s.js +1 -0
- package/assets/inspector-tabs-app/assets/useSuspenseQuery-CpwiXRj_.js +1 -0
- package/assets/inspector-tabs-app/index.html +13 -0
- package/dist/index.d.ts +654 -24
- package/dist/index.js +154 -90
- package/dist/index.js.map +1 -1
- package/package.json +29 -11
package/dist/index.js
CHANGED
|
@@ -1,19 +1,37 @@
|
|
|
1
1
|
// src/actor.ts
|
|
2
|
-
import {
|
|
2
|
+
import { dirname as dirname2, join as join2 } from "path";
|
|
3
|
+
import { fileURLToPath as fileURLToPath2 } from "url";
|
|
3
4
|
import common from "@agentos-software/common";
|
|
5
|
+
import { OPT_AGENTOS_ROOT } from "@rivet-dev/agentos-core";
|
|
4
6
|
import { getSidecarPath } from "@rivet-dev/agentos-sidecar";
|
|
5
7
|
import {
|
|
6
8
|
actor
|
|
7
9
|
} from "rivetkit";
|
|
8
10
|
|
|
9
11
|
// src/config.ts
|
|
12
|
+
import {
|
|
13
|
+
agentOsOptionFieldSchemas,
|
|
14
|
+
nativeMountConfigSchema,
|
|
15
|
+
sharedSidecarConfigSchema
|
|
16
|
+
} from "@rivet-dev/agentos-core";
|
|
10
17
|
import { z } from "zod/v4";
|
|
11
18
|
var zFunction = () => z.custom((val) => typeof val === "function");
|
|
12
|
-
var
|
|
13
|
-
|
|
14
|
-
|
|
19
|
+
var nativeAgentOsOptionsSchema = z.object({
|
|
20
|
+
software: agentOsOptionFieldSchemas.software,
|
|
21
|
+
defaultSoftware: agentOsOptionFieldSchemas.defaultSoftware,
|
|
22
|
+
loopbackExemptPorts: agentOsOptionFieldSchemas.loopbackExemptPorts,
|
|
23
|
+
allowedNodeBuiltins: agentOsOptionFieldSchemas.allowedNodeBuiltins,
|
|
24
|
+
rootFilesystem: agentOsOptionFieldSchemas.rootFilesystem,
|
|
25
|
+
mounts: z.array(nativeMountConfigSchema).optional(),
|
|
26
|
+
additionalInstructions: agentOsOptionFieldSchemas.additionalInstructions,
|
|
27
|
+
permissions: agentOsOptionFieldSchemas.permissions,
|
|
28
|
+
sidecar: sharedSidecarConfigSchema.optional(),
|
|
29
|
+
limits: agentOsOptionFieldSchemas.limits
|
|
30
|
+
}).strict();
|
|
31
|
+
var agentOsActorOptionsSchema = z.record(z.string(), z.unknown()).optional();
|
|
15
32
|
var agentOsActorConfigSchema = z.object({
|
|
16
|
-
options:
|
|
33
|
+
options: nativeAgentOsOptionsSchema.optional(),
|
|
34
|
+
actorOptions: agentOsActorOptionsSchema,
|
|
17
35
|
preview: z.object({
|
|
18
36
|
defaultExpiresInSeconds: z.number().positive().default(3600),
|
|
19
37
|
maxExpiresInSeconds: z.number().positive().default(86400)
|
|
@@ -107,86 +125,55 @@ function nodeModulesMount(hostNodeModulesDir, opts) {
|
|
|
107
125
|
readOnly
|
|
108
126
|
};
|
|
109
127
|
}
|
|
110
|
-
function
|
|
111
|
-
|
|
112
|
-
const idx = parts.lastIndexOf("node_modules");
|
|
113
|
-
if (idx === -1) return void 0;
|
|
114
|
-
return parts.slice(0, idx + 1).join(sep);
|
|
128
|
+
function toRecord(value) {
|
|
129
|
+
return value && typeof value === "object" && !Array.isArray(value) ? value : {};
|
|
115
130
|
}
|
|
116
|
-
function
|
|
117
|
-
if (
|
|
118
|
-
return
|
|
131
|
+
function normalizePackageRef(value) {
|
|
132
|
+
if (typeof value === "string") {
|
|
133
|
+
return { path: value };
|
|
119
134
|
}
|
|
120
|
-
const
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
const root = nodeModulesRootOf(d.packageDir);
|
|
124
|
-
if (root) {
|
|
125
|
-
roots.add(root);
|
|
126
|
-
continue;
|
|
127
|
-
}
|
|
128
|
-
const requires = d.requires?.length ? ` Required packages: ${d.requires.join(", ")}.` : "";
|
|
129
|
-
throw new Error(
|
|
130
|
-
`agentOs() could not auto-mount agent node_modules: agent packageDir ${d.packageDir} is not inside a node_modules install. Run from an npm-installed package tree, or pass an explicit nodeModulesMount(<absolute node_modules path>) in options.mounts.` + requires
|
|
131
|
-
);
|
|
135
|
+
const record = toRecord(value);
|
|
136
|
+
if (typeof record.packagePath === "string") {
|
|
137
|
+
return { path: record.packagePath };
|
|
132
138
|
}
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
139
|
+
for (const legacy of ["packageTar", "packageDir", "commandDir", "dir"]) {
|
|
140
|
+
if (typeof record[legacy] === "string") {
|
|
141
|
+
throw new Error(
|
|
142
|
+
`agentOS package ref uses removed field "${legacy}"; packages are referenced by a single \`packagePath\` \u2014 rebuild @agentos-software/* dependencies or pass { packagePath }`
|
|
143
|
+
);
|
|
144
|
+
}
|
|
138
145
|
}
|
|
139
|
-
|
|
140
|
-
return [...mounts ?? [], nodeModulesMount(hostNodeModulesDir)];
|
|
141
|
-
}
|
|
142
|
-
function softwareIdentity(d) {
|
|
143
|
-
if (typeof d.commandDir === "string") return `dir:${d.commandDir}`;
|
|
144
|
-
if (typeof d.packageDir === "string") return `dir:${d.packageDir}`;
|
|
145
|
-
const name = d.name;
|
|
146
|
-
if (typeof name === "string") return `name:${name}`;
|
|
147
|
-
return JSON.stringify(d);
|
|
146
|
+
return void 0;
|
|
148
147
|
}
|
|
149
|
-
function
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
148
|
+
function normalizedPackageRefs(software) {
|
|
149
|
+
const refs = [];
|
|
150
|
+
const seen = /* @__PURE__ */ new Set();
|
|
151
|
+
for (const entry of software.flat()) {
|
|
152
|
+
const ref = normalizePackageRef(entry);
|
|
153
|
+
if (!ref || seen.has(ref.path)) continue;
|
|
154
|
+
seen.add(ref.path);
|
|
155
|
+
refs.push(ref);
|
|
154
156
|
}
|
|
155
|
-
|
|
157
|
+
return refs;
|
|
156
158
|
}
|
|
157
159
|
function buildConfigJson(parsed) {
|
|
158
|
-
const
|
|
159
|
-
|
|
160
|
-
parsed.options?.software,
|
|
161
|
-
descriptors
|
|
160
|
+
const options = nativeAgentOsOptionsSchema.parse(
|
|
161
|
+
parsed.options ?? {}
|
|
162
162
|
);
|
|
163
|
-
const
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
const seen = new Set(descriptors.map(softwareIdentity));
|
|
168
|
-
const toPrepend = defaults.filter((d) => !seen.has(softwareIdentity(d)));
|
|
169
|
-
descriptors.unshift(...toPrepend);
|
|
170
|
-
}
|
|
171
|
-
const software = [];
|
|
172
|
-
for (const d of descriptors) {
|
|
173
|
-
if (typeof d.commandDir === "string") {
|
|
174
|
-
software.push({ package: d.commandDir });
|
|
175
|
-
} else if (typeof d.packageDir === "string") {
|
|
176
|
-
software.push({
|
|
177
|
-
package: d.packageDir,
|
|
178
|
-
kind: d.hostTool || d.toolkit ? "tool" : "agent"
|
|
179
|
-
});
|
|
180
|
-
}
|
|
181
|
-
}
|
|
182
|
-
const options = parsed.options ?? {};
|
|
183
|
-
const mounts = withAutoAgentNodeModulesMount(
|
|
184
|
-
serializeNativeMounts(options.mounts),
|
|
185
|
-
descriptors
|
|
163
|
+
const softwareInput = Array.isArray(options.software) ? options.software : [];
|
|
164
|
+
const defaultSoftwareEnabled = options.defaultSoftware !== false;
|
|
165
|
+
const packageRefs = normalizedPackageRefs(
|
|
166
|
+
defaultSoftwareEnabled ? [common, ...softwareInput] : softwareInput
|
|
186
167
|
);
|
|
168
|
+
const packages = packageRefs.map((ref) => ({ packagePath: ref.path }));
|
|
169
|
+
const mounts = serializeNativeMounts(options.mounts);
|
|
187
170
|
const sidecar = serializeSidecar(options.sidecar);
|
|
188
171
|
return JSON.stringify({
|
|
189
|
-
|
|
172
|
+
// The actor forwards ONLY package dirs; the sidecar resolves each agent from
|
|
173
|
+
// the projected `/opt/agentos/<name>/current/agentos-package.json` (no
|
|
174
|
+
// client-side adapter-entrypoint resolution — see root CLAUDE.md).
|
|
175
|
+
packages,
|
|
176
|
+
packagesMountAt: OPT_AGENTOS_ROOT,
|
|
190
177
|
additionalInstructions: options.additionalInstructions,
|
|
191
178
|
loopbackExemptPorts: options.loopbackExemptPorts,
|
|
192
179
|
allowedNodeBuiltins: options.allowedNodeBuiltins,
|
|
@@ -200,27 +187,27 @@ function buildConfigJson(parsed) {
|
|
|
200
187
|
function serializeNativeMounts(input) {
|
|
201
188
|
if (input == null) return void 0;
|
|
202
189
|
if (!Array.isArray(input)) {
|
|
203
|
-
throw new Error("
|
|
190
|
+
throw new Error("agentOS() options.mounts must be an array");
|
|
204
191
|
}
|
|
205
192
|
return input.map((mount, index) => {
|
|
206
193
|
if (!mount || typeof mount !== "object") {
|
|
207
|
-
throw new Error(`
|
|
194
|
+
throw new Error(`agentOS() options.mounts[${index}] must be an object`);
|
|
208
195
|
}
|
|
209
196
|
const record = mount;
|
|
210
197
|
if (record.driver !== void 0) {
|
|
211
198
|
throw new Error(
|
|
212
|
-
"
|
|
199
|
+
"agentOS() only supports Native mounts across the NAPI boundary; Plain mounts with driver callbacks are not serializable"
|
|
213
200
|
);
|
|
214
201
|
}
|
|
215
202
|
if (record.filesystem !== void 0) {
|
|
216
203
|
throw new Error(
|
|
217
|
-
"
|
|
204
|
+
"agentOS() only supports Native mounts across the NAPI boundary; Overlay mounts are not serializable"
|
|
218
205
|
);
|
|
219
206
|
}
|
|
220
207
|
const plugin = record.plugin;
|
|
221
208
|
if (typeof record.path !== "string" || !plugin || typeof plugin !== "object" || typeof plugin.id !== "string") {
|
|
222
209
|
throw new Error(
|
|
223
|
-
`
|
|
210
|
+
`agentOS() options.mounts[${index}] must be a Native mount with { path, plugin: { id, config? } }`
|
|
224
211
|
);
|
|
225
212
|
}
|
|
226
213
|
return {
|
|
@@ -236,16 +223,16 @@ function serializeNativeMounts(input) {
|
|
|
236
223
|
function serializeSidecar(input) {
|
|
237
224
|
if (input == null) return void 0;
|
|
238
225
|
if (!input || typeof input !== "object") {
|
|
239
|
-
throw new Error("
|
|
226
|
+
throw new Error("agentOS() options.sidecar must be an object");
|
|
240
227
|
}
|
|
241
228
|
const record = input;
|
|
242
229
|
if (record.kind === "explicit" || record.handle !== void 0) {
|
|
243
230
|
throw new Error(
|
|
244
|
-
"
|
|
231
|
+
"agentOS() only supports sidecar shared pool configuration across the NAPI boundary; explicit sidecar handles are not serializable"
|
|
245
232
|
);
|
|
246
233
|
}
|
|
247
234
|
if (record.kind !== void 0 && record.kind !== "shared") {
|
|
248
|
-
throw new Error('
|
|
235
|
+
throw new Error('agentOS() options.sidecar.kind must be "shared"');
|
|
249
236
|
}
|
|
250
237
|
return typeof record.pool === "string" ? { pool: record.pool } : {};
|
|
251
238
|
}
|
|
@@ -253,7 +240,7 @@ function buildNativeFactoryBuilder(parsed) {
|
|
|
253
240
|
return (runtime) => {
|
|
254
241
|
if (runtime.kind !== "napi") {
|
|
255
242
|
throw new Error(
|
|
256
|
-
`
|
|
243
|
+
`agentOS() is only supported on the native NAPI runtime (current runtime kind: ${runtime.kind})`
|
|
257
244
|
);
|
|
258
245
|
}
|
|
259
246
|
if (!runtime.createNativePluginFactory) {
|
|
@@ -270,37 +257,114 @@ function buildNativeFactoryBuilder(parsed) {
|
|
|
270
257
|
// Resolve the prebuilt sidecar binary from the npm package so the plugin
|
|
271
258
|
// spawns the bundled binary rather than relying on `agentos-sidecar`
|
|
272
259
|
// being on PATH.
|
|
273
|
-
sidecarPath: getSidecarPath()
|
|
260
|
+
sidecarPath: getSidecarPath(),
|
|
261
|
+
// Custom inspector tabs. The native-plugin path bypasses the normal
|
|
262
|
+
// actor-config assembly (`buildActorConfig`/`inspectorTabs`), so the
|
|
263
|
+
// tabs MUST ride on the plugin options: the Rust NAPI binding
|
|
264
|
+
// `from_native_plugin` forwards `inspectorTabs` into the actor config so
|
|
265
|
+
// the dashboard serves `/inspector/custom-tabs/<id>/` and advertises them
|
|
266
|
+
// in `tab-config`. (Setting `actor({ inspector })` alone does nothing for
|
|
267
|
+
// native-plugin actors.)
|
|
268
|
+
inspectorTabs: AGENTOS_INSPECTOR_CONFIG.tabs
|
|
274
269
|
};
|
|
275
270
|
return runtime.createNativePluginFactory(options);
|
|
276
271
|
};
|
|
277
272
|
}
|
|
278
|
-
|
|
273
|
+
var ACTOR_NEVER_HIT_MS = 60 * 60 * 1e3;
|
|
274
|
+
var ACTOR_NEVER_HIT_MESSAGE_BYTES = 512 * 1024 * 1024;
|
|
275
|
+
var DEFAULT_AGENTOS_ACTOR_OPTIONS = {
|
|
276
|
+
// Connection/setup lifecycle (stock 5s each) — the websocket setup path that
|
|
277
|
+
// was timing out at 5000ms and dropping all streamed events.
|
|
278
|
+
onBeforeConnectTimeout: ACTOR_NEVER_HIT_MS,
|
|
279
|
+
onConnectTimeout: ACTOR_NEVER_HIT_MS,
|
|
280
|
+
createVarsTimeout: ACTOR_NEVER_HIT_MS,
|
|
281
|
+
createConnStateTimeout: ACTOR_NEVER_HIT_MS,
|
|
282
|
+
onMigrateTimeout: ACTOR_NEVER_HIT_MS,
|
|
283
|
+
// Action/RPC lifecycle (stock 60s) — long multi-step prompt turns.
|
|
284
|
+
actionTimeout: ACTOR_NEVER_HIT_MS,
|
|
285
|
+
// Idle/keepalive — don't reap a live session or sleep mid-turn (stock
|
|
286
|
+
// connectionLivenessTimeout 2.5s, sleepTimeout 30s). The liveness *interval*
|
|
287
|
+
// (ping cadence) is intentionally left at its small default.
|
|
288
|
+
connectionLivenessTimeout: ACTOR_NEVER_HIT_MS,
|
|
289
|
+
sleepTimeout: ACTOR_NEVER_HIT_MS,
|
|
290
|
+
// Payload sizes — large prompts/results. `maxQueueMessageSize` is the
|
|
291
|
+
// per-actor message cap (stock 64 KiB); the transport-level
|
|
292
|
+
// max{Incoming,Outgoing}MessageSize live on the registry/setup config (see
|
|
293
|
+
// AGENTOS_REGISTRY_MESSAGE_SIZE_DEFAULTS), not on per-actor options.
|
|
294
|
+
maxQueueSize: 1e6,
|
|
295
|
+
maxQueueMessageSize: ACTOR_NEVER_HIT_MESSAGE_BYTES
|
|
296
|
+
};
|
|
297
|
+
var INSPECTOR_TABS_ASSET_DIR = join2(
|
|
298
|
+
dirname2(fileURLToPath2(import.meta.url)),
|
|
299
|
+
"..",
|
|
300
|
+
"assets",
|
|
301
|
+
"inspector-tabs-app"
|
|
302
|
+
);
|
|
303
|
+
var AGENTOS_INSPECTOR_CONFIG = {
|
|
304
|
+
tabs: [
|
|
305
|
+
{ id: "transcript", label: "Transcript", source: INSPECTOR_TABS_ASSET_DIR, icon: "comments" },
|
|
306
|
+
{ id: "filesystem", label: "Filesystem", source: INSPECTOR_TABS_ASSET_DIR, icon: "folder-tree" },
|
|
307
|
+
{ id: "processes", label: "Processes", source: INSPECTOR_TABS_ASSET_DIR, icon: "microchip" },
|
|
308
|
+
{ id: "software", label: "Software", source: INSPECTOR_TABS_ASSET_DIR, icon: "box-archive" },
|
|
309
|
+
{ id: "mounts", label: "Mounts", source: INSPECTOR_TABS_ASSET_DIR, icon: "hard-drive" },
|
|
310
|
+
...["workflow", "database", "state", "queue", "connections", "console"].map(
|
|
311
|
+
(id) => ({ id, hidden: true })
|
|
312
|
+
)
|
|
313
|
+
]
|
|
314
|
+
};
|
|
315
|
+
function createAgentOS(config) {
|
|
279
316
|
const parsed = agentOsActorConfigSchema.parse(
|
|
280
317
|
config
|
|
281
318
|
);
|
|
282
|
-
const
|
|
319
|
+
const userActorOptions = parsed.actorOptions;
|
|
320
|
+
const actorOptions = {
|
|
321
|
+
...DEFAULT_AGENTOS_ACTOR_OPTIONS,
|
|
322
|
+
...userActorOptions ?? {}
|
|
323
|
+
};
|
|
283
324
|
const definition = actor({
|
|
284
325
|
actions: {},
|
|
285
|
-
|
|
326
|
+
options: actorOptions,
|
|
327
|
+
// Register the custom agent-os inspector tabs (and hide the built-in
|
|
328
|
+
// rivetkit tabs) so the dashboard renders the agent-os UI. Without this
|
|
329
|
+
// the shipped tab assets are never surfaced.
|
|
330
|
+
inspector: AGENTOS_INSPECTOR_CONFIG
|
|
286
331
|
});
|
|
287
332
|
definition.nativeFactoryBuilder = buildNativeFactoryBuilder(parsed);
|
|
288
333
|
return definition;
|
|
289
334
|
}
|
|
290
335
|
|
|
291
336
|
// src/index.ts
|
|
292
|
-
import { setup } from "rivetkit";
|
|
337
|
+
import { setup as rivetkitSetup } from "rivetkit";
|
|
338
|
+
import { defineSoftware } from "@rivet-dev/agentos-core";
|
|
339
|
+
var AGENTOS_REGISTRY_MESSAGE_SIZE_DEFAULT = 512 * 1024 * 1024;
|
|
340
|
+
var setup = ((input) => rivetkitSetup({
|
|
341
|
+
maxIncomingMessageSize: AGENTOS_REGISTRY_MESSAGE_SIZE_DEFAULT,
|
|
342
|
+
maxOutgoingMessageSize: AGENTOS_REGISTRY_MESSAGE_SIZE_DEFAULT,
|
|
343
|
+
...input
|
|
344
|
+
}));
|
|
293
345
|
function agentOS(config = {}) {
|
|
294
|
-
|
|
295
|
-
|
|
346
|
+
const {
|
|
347
|
+
preview,
|
|
348
|
+
onBeforeConnect,
|
|
349
|
+
onSessionEvent,
|
|
350
|
+
onPermissionRequest,
|
|
351
|
+
...options
|
|
352
|
+
} = config;
|
|
353
|
+
return createAgentOS({
|
|
354
|
+
options,
|
|
355
|
+
preview,
|
|
356
|
+
onBeforeConnect,
|
|
357
|
+
onSessionEvent: onSessionEvent ? (_ctx, sessionId, event) => onSessionEvent(sessionId, event) : void 0,
|
|
358
|
+
onPermissionRequest: onPermissionRequest ? (_ctx, sessionId, request) => onPermissionRequest(sessionId, request) : void 0
|
|
296
359
|
});
|
|
297
360
|
}
|
|
298
361
|
export {
|
|
299
362
|
agentOS,
|
|
300
|
-
agentOs,
|
|
301
363
|
agentOsActorConfigSchema,
|
|
302
364
|
buildConfigJson,
|
|
365
|
+
defineSoftware,
|
|
303
366
|
getPluginPath,
|
|
367
|
+
nativeAgentOsOptionsSchema,
|
|
304
368
|
nodeModulesMount,
|
|
305
369
|
setup
|
|
306
370
|
};
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/actor.ts","../src/config.ts","../src/plugin-binary.ts","../src/index.ts"],"sourcesContent":["/**\n * Rust-backed `agentOs(...)` definition.\n *\n * Produces an `ActorDefinition` whose `nativeFactoryBuilder` constructs a\n * native-actor-plugin factory through `runtime.createNativePluginFactory(...)`\n * (NAPI → `dlopen` of the agent-os actor plugin cdylib, the inverse of the\n * generic host loader). All lifecycle, state, and action dispatch live in the\n * Rust plugin (`crates/agentos-actor-plugin`). This JS shim only validates\n * configuration, resolves the plugin + sidecar binaries, and hands the opaque\n * config envelope across the bridge — it owns no agent-os runtime logic.\n */\n\nimport { sep } from \"node:path\";\nimport common from \"@agentos-software/common\";\nimport { getSidecarPath } from \"@rivet-dev/agentos-sidecar\";\nimport {\n\tactor,\n\ttype ActorDefinition,\n\ttype ActorFactoryHandle,\n\ttype CoreRuntime,\n\ttype DatabaseProvider,\n\ttype NapiNativePluginOptions,\n\ttype RawAccess,\n} from \"rivetkit\";\nimport {\n\ttype AgentOsActorConfig,\n\ttype AgentOsActorConfigInput,\n\tagentOsActorConfigSchema,\n} from \"./config.js\";\nimport { getPluginPath } from \"./plugin-binary.js\";\nimport type { AgentOsActorState, AgentOsActorVars } from \"./types.js\";\n\n/**\n * Build the JSON envelope the Rust plugin consumes. The Rust deserializer\n * uses `deny_unknown_fields`, so the envelope must stay in lock-step with\n * `crates/agentos-actor-plugin/src/config.rs::AgentOsConfigJson`.\n *\n * Software threading: each software descriptor is flattened (meta packages\n * such as `common` are arrays of descriptors) and mapped to the Rust\n * `SoftwareInput { package, kind }`. The agentos-client resolves an\n * ABSOLUTE `package` directly (its `resolve_software` lets an absolute path\n * bypass the `node_modules` prefix), so the descriptor's already-resolved\n * `commandDir` (wasm commands) / `packageDir` (agents/tools) is forwarded as\n * `package`.\n */\ninterface SoftwareDescriptorLike {\n\tcommandDir?: string;\n\tpackageDir?: string;\n\trequires?: string[];\n\tagent?: unknown;\n\thostTool?: unknown;\n\ttoolkit?: unknown;\n}\n\ninterface NativeMountLike {\n\tpath: string;\n\tplugin: {\n\t\tid: string;\n\t\tconfig?: unknown;\n\t};\n\treadOnly?: boolean;\n}\n\n/**\n * A native `host_dir` mount of a host `node_modules` directory at\n * `/root/node_modules`, the serializable form `agentOs({ options: { mounts } })`\n * accepts across the NAPI boundary.\n */\nexport interface NodeModulesMountConfig {\n\tpath: \"/root/node_modules\";\n\tplugin: { id: \"host_dir\"; config: { hostPath: string; readOnly: boolean } };\n\treadOnly: boolean;\n}\n\n/**\n * Mount a host `node_modules` directory into the VM at `/root/node_modules`.\n *\n * This is the explicit, mount-based replacement for the removed `moduleAccessCwd`\n * mechanism: the VM module resolver reads the mounted tree through the kernel\n * VFS, so the caller supplies exactly the `node_modules` directory whose\n * packages should resolve in the guest.\n *\n * @param hostNodeModulesDir Absolute host path to a `node_modules` directory.\n * @param opts.readOnly Defaults to `true`; the mount is read-only.\n */\nexport function nodeModulesMount(\n\thostNodeModulesDir: string,\n\topts?: { readOnly?: boolean },\n): NodeModulesMountConfig {\n\tconst readOnly = opts?.readOnly ?? true;\n\treturn {\n\t\tpath: \"/root/node_modules\",\n\t\tplugin: {\n\t\t\tid: \"host_dir\",\n\t\t\tconfig: { hostPath: hostNodeModulesDir, readOnly },\n\t\t},\n\t\treadOnly,\n\t};\n}\n\n/**\n * Derive the `node_modules` root that contains an installed package directory.\n * For an agent descriptor whose `packageDir` is `<root>/node_modules/@scope/pkg`,\n * this returns `<root>/node_modules` — the hoist root that also holds the agent's\n * `requires` (the ACP adapter + agent SDK) and their transitive deps under a\n * flat (npm) install. Returns `undefined` when `packageDir` is not inside a\n * `node_modules` tree (e.g. a linked monorepo checkout), where the caller must\n * supply an explicit `nodeModulesMount(...)`.\n */\nfunction nodeModulesRootOf(packageDir: string): string | undefined {\n\tconst parts = packageDir.split(sep);\n\tconst idx = parts.lastIndexOf(\"node_modules\");\n\tif (idx === -1) return undefined;\n\treturn parts.slice(0, idx + 1).join(sep);\n}\n\n/**\n * Agents run their ACP adapter + SDK inside the VM from `/root/node_modules`.\n * Rather than make the caller hand-write `nodeModulesMount(...)`, auto-derive a\n * read-only `host_dir` mount of the `node_modules` root that holds the agent\n * packages (`requires`) from each agent descriptor's installed `packageDir`.\n *\n * An explicit `/root/node_modules` mount in `options.mounts` always wins. If\n * agents resolve to more than one distinct `node_modules` root the derivation is\n * ambiguous and the caller must mount explicitly.\n */\nfunction withAutoAgentNodeModulesMount(\n\tmounts: NativeMountLike[] | undefined,\n\tdescriptors: SoftwareDescriptorLike[],\n): NativeMountLike[] | undefined {\n\tif (mounts?.some((mount) => mount.path === \"/root/node_modules\")) {\n\t\treturn mounts;\n\t}\n\n\tconst roots = new Set<string>();\n\tfor (const d of descriptors) {\n\t\tif (!d.agent || typeof d.packageDir !== \"string\") continue;\n\t\tconst root = nodeModulesRootOf(d.packageDir);\n\t\tif (root) {\n\t\t\troots.add(root);\n\t\t\tcontinue;\n\t\t}\n\t\tconst requires = d.requires?.length\n\t\t\t? ` Required packages: ${d.requires.join(\", \")}.`\n\t\t\t: \"\";\n\t\tthrow new Error(\n\t\t\t\"agentOs() could not auto-mount agent node_modules: agent \" +\n\t\t\t\t`packageDir ${d.packageDir} is not inside a node_modules install. ` +\n\t\t\t\t\"Run from an npm-installed package tree, or pass an explicit \" +\n\t\t\t\t\"nodeModulesMount(<absolute node_modules path>) in options.mounts.\" +\n\t\t\t\trequires,\n\t\t);\n\t}\n\n\tif (roots.size === 0) return mounts;\n\tif (roots.size > 1) {\n\t\tthrow new Error(\n\t\t\t\"agentOs() could not auto-mount agent node_modules: agents resolved to \" +\n\t\t\t\t`multiple node_modules roots (${[...roots].join(\", \")}). Pass an ` +\n\t\t\t\t\"explicit nodeModulesMount(...) in options.mounts.\",\n\t\t);\n\t}\n\n\tconst [hostNodeModulesDir] = [...roots];\n\treturn [...(mounts ?? []), nodeModulesMount(hostNodeModulesDir)];\n}\n\n/**\n * Stable identity for a software descriptor, used to de-duplicate the\n * auto-injected default bundle against software the caller passed explicitly.\n * Resolved `commandDir`/`packageDir` paths are the most reliable key; `name`\n * is the fallback for descriptors without a directory.\n */\nfunction softwareIdentity(d: SoftwareDescriptorLike): string {\n\tif (typeof d.commandDir === \"string\") return `dir:${d.commandDir}`;\n\tif (typeof d.packageDir === \"string\") return `dir:${d.packageDir}`;\n\tconst name = (d as { name?: unknown }).name;\n\tif (typeof name === \"string\") return `name:${name}`;\n\treturn JSON.stringify(d);\n}\n\nfunction flattenSoftware(input: unknown, out: SoftwareDescriptorLike[]): void {\n\tif (input == null) return;\n\tif (Array.isArray(input)) {\n\t\tfor (const item of input) flattenSoftware(item, out);\n\t\treturn;\n\t}\n\tif (typeof input === \"object\") out.push(input as SoftwareDescriptorLike);\n}\n\nexport function buildConfigJson<TConnParams>(\n\tparsed: AgentOsActorConfig<TConnParams>,\n): string {\n\tconst descriptors: SoftwareDescriptorLike[] = [];\n\tflattenSoftware(\n\t\t(parsed.options as { software?: unknown })?.software,\n\t\tdescriptors,\n\t);\n\n\t// Auto-include the default software bundle (`@agentos-software/common`: `sh` +\n\t// coreutils + the standard CLI tools agents rely on) unless the caller opted\n\t// out with `defaultSoftware: false`. Anything already listed in `software`\n\t// (e.g. an explicit `common`) is not duplicated. Prepended so the baseline\n\t// tools come first, matching the previous explicit `[common, ...]` ordering.\n\tconst defaultSoftwareEnabled =\n\t\t(parsed.options as { defaultSoftware?: unknown })?.defaultSoftware !== false;\n\tif (defaultSoftwareEnabled) {\n\t\tconst defaults: SoftwareDescriptorLike[] = [];\n\t\tflattenSoftware(common, defaults);\n\t\tconst seen = new Set(descriptors.map(softwareIdentity));\n\t\tconst toPrepend = defaults.filter((d) => !seen.has(softwareIdentity(d)));\n\t\tdescriptors.unshift(...toPrepend);\n\t}\n\n\tconst software: Array<{ package: string; kind?: string }> = [];\n\tfor (const d of descriptors) {\n\t\tif (typeof d.commandDir === \"string\") {\n\t\t\t// Wasm command directory (kind defaults to WasmCommands on the Rust side).\n\t\t\tsoftware.push({ package: d.commandDir });\n\t\t} else if (typeof d.packageDir === \"string\") {\n\t\t\t// Agent SDK / host-tool package: forwarded but not mounted as commands.\n\t\t\t// `kind` matches the kebab-case serde tags of the Rust `SoftwareKind`\n\t\t\t// enum (`wasm-commands` / `agent` / `tool`).\n\t\t\tsoftware.push({\n\t\t\t\tpackage: d.packageDir,\n\t\t\t\tkind: d.hostTool || d.toolkit ? \"tool\" : \"agent\",\n\t\t\t});\n\t\t}\n\t}\n\n\t// `/root/node_modules` (agent ACP adapter + SDK + transitive dep resolution)\n\t// is auto-derived from the agent descriptors so the standard quickstart needs\n\t// no manual `nodeModulesMount(...)`: see `withAutoAgentNodeModulesMount`. An\n\t// explicit `/root/node_modules` mount in `options.mounts` always wins. The VM\n\t// module resolver reads the mounted tree through the kernel VFS.\n\tconst options = (parsed.options ?? {}) as Record<string, unknown>;\n\tconst mounts = withAutoAgentNodeModulesMount(\n\t\tserializeNativeMounts(options.mounts),\n\t\tdescriptors,\n\t);\n\tconst sidecar = serializeSidecar(options.sidecar);\n\treturn JSON.stringify({\n\t\tsoftware,\n\t\tadditionalInstructions: options.additionalInstructions,\n\t\tloopbackExemptPorts: options.loopbackExemptPorts,\n\t\tallowedNodeBuiltins: options.allowedNodeBuiltins,\n\t\tpermissions: options.permissions,\n\t\trootFilesystem: options.rootFilesystem,\n\t\tmounts,\n\t\tlimits: options.limits,\n\t\tsidecar,\n\t});\n}\n\nfunction serializeNativeMounts(input: unknown): NativeMountLike[] | undefined {\n\tif (input == null) return undefined;\n\tif (!Array.isArray(input)) {\n\t\tthrow new Error(\"agentOs() options.mounts must be an array\");\n\t}\n\treturn input.map((mount, index) => {\n\t\tif (!mount || typeof mount !== \"object\") {\n\t\t\tthrow new Error(`agentOs() options.mounts[${index}] must be an object`);\n\t\t}\n\t\tconst record = mount as Record<string, unknown>;\n\t\tif (record.driver !== undefined) {\n\t\t\tthrow new Error(\n\t\t\t\t\"agentOs() only supports Native mounts across the NAPI boundary; Plain mounts with driver callbacks are not serializable\",\n\t\t\t);\n\t\t}\n\t\tif (record.filesystem !== undefined) {\n\t\t\tthrow new Error(\n\t\t\t\t\"agentOs() only supports Native mounts across the NAPI boundary; Overlay mounts are not serializable\",\n\t\t\t);\n\t\t}\n\t\tconst plugin = record.plugin;\n\t\tif (\n\t\t\ttypeof record.path !== \"string\" ||\n\t\t\t!plugin ||\n\t\t\ttypeof plugin !== \"object\" ||\n\t\t\ttypeof (plugin as Record<string, unknown>).id !== \"string\"\n\t\t) {\n\t\t\tthrow new Error(\n\t\t\t\t`agentOs() options.mounts[${index}] must be a Native mount with { path, plugin: { id, config? } }`,\n\t\t\t);\n\t\t}\n\t\treturn {\n\t\t\tpath: record.path,\n\t\t\tplugin: {\n\t\t\t\tid: (plugin as Record<string, unknown>).id as string,\n\t\t\t\tconfig: (plugin as Record<string, unknown>).config,\n\t\t\t},\n\t\t\treadOnly:\n\t\t\t\ttypeof record.readOnly === \"boolean\" ? record.readOnly : undefined,\n\t\t};\n\t});\n}\n\nfunction serializeSidecar(input: unknown): { pool?: string } | undefined {\n\tif (input == null) return undefined;\n\tif (!input || typeof input !== \"object\") {\n\t\tthrow new Error(\"agentOs() options.sidecar must be an object\");\n\t}\n\tconst record = input as Record<string, unknown>;\n\tif (record.kind === \"explicit\" || record.handle !== undefined) {\n\t\tthrow new Error(\n\t\t\t\"agentOs() only supports sidecar shared pool configuration across the NAPI boundary; explicit sidecar handles are not serializable\",\n\t\t);\n\t}\n\tif (record.kind !== undefined && record.kind !== \"shared\") {\n\t\tthrow new Error('agentOs() options.sidecar.kind must be \"shared\"');\n\t}\n\treturn typeof record.pool === \"string\" ? { pool: record.pool } : {};\n}\n\nfunction buildNativeFactoryBuilder<TConnParams>(\n\tparsed: AgentOsActorConfig<TConnParams>,\n): (runtime: CoreRuntime) => ActorFactoryHandle {\n\treturn (runtime) => {\n\t\tif (runtime.kind !== \"napi\") {\n\t\t\tthrow new Error(\n\t\t\t\t`agentOs() is only supported on the native NAPI runtime (current runtime kind: ${runtime.kind})`,\n\t\t\t);\n\t\t}\n\t\tif (!runtime.createNativePluginFactory) {\n\t\t\tthrow new Error(\n\t\t\t\t\"runtime.createNativePluginFactory is not implemented on the active CoreRuntime\",\n\t\t\t);\n\t\t}\n\t\tconst options: NapiNativePluginOptions = {\n\t\t\t// Resolve the prebuilt agent-os actor plugin cdylib; RivetKit `dlopen`s\n\t\t\t// it through the generic native-plugin ABI.\n\t\t\tpluginPath: getPluginPath(),\n\t\t\t// Opaque config envelope the plugin parses (config.rs::AgentOsConfigJson).\n\t\t\tconfigJson: buildConfigJson(parsed),\n\t\t\t// Resolve the prebuilt sidecar binary from the npm package so the plugin\n\t\t\t// spawns the bundled binary rather than relying on `agentos-sidecar`\n\t\t\t// being on PATH.\n\t\t\tsidecarPath: getSidecarPath(),\n\t\t};\n\t\treturn runtime.createNativePluginFactory(options);\n\t};\n}\n\n/**\n * Type alias for the `agentOs(...)` return type. Events are not typed at the\n * TS surface because the Rust plugin owns the broadcast set and the\n * test/client surface uses `any` for actions.\n */\nexport type AgentOsActorDefinition<TConnParams> = ActorDefinition<\n\tAgentOsActorState,\n\tTConnParams,\n\tundefined,\n\tAgentOsActorVars,\n\tundefined,\n\tDatabaseProvider<RawAccess>,\n\tRecord<never, never>,\n\tRecord<never, never>,\n\tany\n>;\n\nexport function agentOs<TConnParams = undefined>(\n\tconfig: AgentOsActorConfigInput<TConnParams>,\n): AgentOsActorDefinition<TConnParams> {\n\tconst parsed = agentOsActorConfigSchema.parse(\n\t\tconfig,\n\t) as AgentOsActorConfig<TConnParams>;\n\n\t// Construct a minimal definition through the existing actor() helper, then\n\t// attach the Rust factory builder marker. The actions block stays empty\n\t// because no JS-side action ever runs: the engine driver branches on\n\t// `nativeFactoryBuilder` before reaching the JS dispatch path.\n\tconst actorOptions = (parsed as { actorOptions?: Record<string, unknown> })\n\t\t.actorOptions;\n\tconst definition = actor({\n\t\tactions: {},\n\t\t...(actorOptions ? { options: actorOptions } : {}),\n\t} as Parameters<\n\t\ttypeof actor\n\t>[0]) as unknown as AgentOsActorDefinition<TConnParams>;\n\tdefinition.nativeFactoryBuilder = buildNativeFactoryBuilder(parsed);\n\treturn definition;\n}\n","import type {\n\tAgentOsOptions,\n\tJsonRpcNotification,\n\tPermissionRequest,\n} from \"@rivet-dev/agentos-core\";\nimport type { ActorContext, BeforeConnectContext } from \"rivetkit\";\nimport { z } from \"zod/v4\";\nimport type { AgentOsActorState, AgentOsActorVars } from \"./types.js\";\n\nconst zFunction = <\n\tT extends (...args: any[]) => any = (...args: unknown[]) => unknown,\n>() => z.custom<T>((val) => typeof val === \"function\");\n\nconst AgentOsOptionsSchema = z.custom<AgentOsOptions>(\n\t(val) => typeof val === \"object\" && val !== null,\n);\n\nexport const agentOsActorConfigSchema = z\n\t.object({\n\t\toptions: AgentOsOptionsSchema.optional(),\n\t\tpreview: z\n\t\t\t.object({\n\t\t\t\tdefaultExpiresInSeconds: z.number().positive().default(3600),\n\t\t\t\tmaxExpiresInSeconds: z.number().positive().default(86400),\n\t\t\t})\n\t\t\t.strict()\n\t\t\t.prefault(() => ({})),\n\t\tonBeforeConnect: zFunction().optional(),\n\t\tonSessionEvent: zFunction().optional(),\n\t\tonPermissionRequest: zFunction().optional(),\n\t})\n\t.strict();\n\n// --- Typed config types (generic callbacks overlaid on the Zod schema) ---\n\ntype AgentOsActorContext<TConnParams> = ActorContext<\n\tAgentOsActorState,\n\tTConnParams,\n\tundefined,\n\tAgentOsActorVars,\n\tundefined,\n\tany\n>;\n\ninterface AgentOsActorConfigCallbacks<TConnParams> {\n\tonBeforeConnect?: (\n\t\tc: BeforeConnectContext<\n\t\t\tAgentOsActorState,\n\t\t\tAgentOsActorVars,\n\t\t\tundefined,\n\t\t\tany\n\t\t>,\n\t\tparams: TConnParams,\n\t) => void | Promise<void>;\n\tonSessionEvent?: (\n\t\tc: AgentOsActorContext<TConnParams>,\n\t\tsessionId: string,\n\t\tevent: JsonRpcNotification,\n\t) => void | Promise<void>;\n\tonPermissionRequest?: (\n\t\tc: AgentOsActorContext<TConnParams>,\n\t\tsessionId: string,\n\t\trequest: PermissionRequest,\n\t) => void | Promise<void>;\n}\n\n// Parsed config (after Zod defaults/transforms applied).\nexport type AgentOsActorConfig<TConnParams = undefined> = Omit<\n\tz.infer<typeof agentOsActorConfigSchema>,\n\t\"onBeforeConnect\" | \"onSessionEvent\" | \"onPermissionRequest\"\n> &\n\tAgentOsActorConfigCallbacks<TConnParams>;\n\n// Input config (what users pass in before Zod transforms).\nexport type AgentOsActorConfigInput<TConnParams = undefined> = Omit<\n\tz.input<typeof agentOsActorConfigSchema>,\n\t\"onBeforeConnect\" | \"onSessionEvent\" | \"onPermissionRequest\"\n> &\n\tAgentOsActorConfigCallbacks<TConnParams>;\n","// Platform-specific resolver for the prebuilt agent-os actor plugin cdylib\n// (`libagentos_actor_plugin.{so,dylib,dll}`). Mirrors the sidecar-binary\n// resolver (`@rivet-dev/agentos-sidecar`): the library ships inside one of the\n// `@rivet-dev/agentos-plugin-<platform>` packages, declared as\n// optionalDependencies so npm installs only the one matching the current\n// `os`/`cpu`/`libc` at install time (spec phase 6).\n//\n// Resolution priority:\n// 1. `AGENTOS_PLUGIN_BIN` env var (absolute path override).\n// 2. A cargo build output under the repo `target/{release,debug}/` (dev).\n// 3. The platform-specific `@rivet-dev/agentos-plugin-<platform>` package.\n\nimport { existsSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst PLUGIN_BIN_ENV = \"AGENTOS_PLUGIN_BIN\";\n\n/** The cdylib filename for the current platform. */\nfunction libraryName(): string {\n\tswitch (process.platform) {\n\t\tcase \"darwin\":\n\t\t\treturn \"libagentos_actor_plugin.dylib\";\n\t\tcase \"win32\":\n\t\t\treturn \"agentos_actor_plugin.dll\";\n\t\tdefault:\n\t\t\treturn \"libagentos_actor_plugin.so\";\n\t}\n}\n\nfunction getPlatformPackageName(): string | null {\n\tconst { platform, arch } = process;\n\tswitch (platform) {\n\t\tcase \"linux\":\n\t\t\tif (arch === \"x64\") return \"@rivet-dev/agentos-plugin-linux-x64-gnu\";\n\t\t\tif (arch === \"arm64\") return \"@rivet-dev/agentos-plugin-linux-arm64-gnu\";\n\t\t\tbreak;\n\t\tcase \"darwin\":\n\t\t\tif (arch === \"x64\") return \"@rivet-dev/agentos-plugin-darwin-x64\";\n\t\t\tif (arch === \"arm64\") return \"@rivet-dev/agentos-plugin-darwin-arm64\";\n\t\t\tbreak;\n\t\tdefault:\n\t\t\tbreak;\n\t}\n\treturn null;\n}\n\n/**\n * Resolve the absolute path to the agent-os actor plugin cdylib. RivetKit\n * `dlopen`s this path through the generic native-plugin ABI.\n */\nexport function getPluginPath(): string {\n\tconst override = process.env[PLUGIN_BIN_ENV];\n\tif (override) {\n\t\tif (!existsSync(override)) {\n\t\t\tthrow new Error(\n\t\t\t\t`${PLUGIN_BIN_ENV} is set to ${override} but the file does not exist`,\n\t\t\t);\n\t\t}\n\t\treturn override;\n\t}\n\n\tconst lib = libraryName();\n\n\t// Dev: a cargo build output under the repo `target/`. `import.meta.url` is\n\t// `packages/agentos/dist/plugin-binary.js`, so the repo root is three levels up.\n\tconst here = dirname(fileURLToPath(import.meta.url));\n\tfor (const profile of [\"release\", \"debug\"]) {\n\t\tconst candidate = join(here, \"..\", \"..\", \"..\", \"target\", profile, lib);\n\t\tif (existsSync(candidate)) {\n\t\t\treturn candidate;\n\t\t}\n\t}\n\n\t// Prod: the platform-specific package.\n\tconst platformPkg = getPlatformPackageName();\n\tif (!platformPkg) {\n\t\tthrow new Error(\n\t\t\t`@rivet-dev/agentos: unsupported platform ${process.platform}/${process.arch}. ` +\n\t\t\t\t\"The Agent OS actor plugin currently supports linux and darwin on x64 and arm64. \" +\n\t\t\t\t`Set ${PLUGIN_BIN_ENV} to a local cdylib to override.`,\n\t\t);\n\t}\n\n\tconst require = createRequire(import.meta.url);\n\tlet pkgJsonPath: string;\n\ttry {\n\t\tpkgJsonPath = require.resolve(`${platformPkg}/package.json`);\n\t} catch {\n\t\tthrow new Error(\n\t\t\t`@rivet-dev/agentos: platform package ${platformPkg} is not installed.\\n` +\n\t\t\t\t\"This usually means the platform is unsupported or optionalDependencies\\n\" +\n\t\t\t\t`were skipped during install. Try: npm install --include=optional ${platformPkg}\\n` +\n\t\t\t\t`Or set ${PLUGIN_BIN_ENV} to a local cdylib, or build it with\\n` +\n\t\t\t\t\"`cargo build -p agentos-actor-plugin`.\",\n\t\t);\n\t}\n\n\treturn join(dirname(pkgJsonPath), lib);\n}\n","// Rust-backed agent-os actor surface (native actor plugin / cdylib).\n//\n// Only the `agentOs()` definition function, the config schema, the\n// `nodeModulesMount` helper, the plugin-path resolver, and the public domain\n// types are exported. All actor lifecycle + action dispatch live in the Rust\n// plugin (`crates/agentos-actor-plugin`), loaded by RivetKit via the generic\n// native-plugin ABI.\n\nimport {\n\tagentOs as createAgentOs,\n\ttype AgentOsActorDefinition,\n} from \"./actor.js\";\nimport type { AgentOsActorConfigInput } from \"./config.js\";\n\nexport { setup } from \"rivetkit\";\n\nexport {\n\tbuildConfigJson,\n\tnodeModulesMount,\n\ttype NodeModulesMountConfig,\n} from \"./actor.js\";\nexport { createAgentOs as agentOs };\n\nexport {\n\ttype AgentOsActorConfig,\n\ttype AgentOsActorConfigInput,\n\tagentOsActorConfigSchema,\n} from \"./config.js\";\n\nexport { getPluginPath } from \"./plugin-binary.js\";\n\nexport type {\n\tAgentOsActionContext,\n\tAgentOsActorState,\n\tAgentOsActorVars,\n\tAgentOsEvents,\n\tCronEventPayload,\n\tPermissionRequestPayload,\n\tPersistedSessionEvent,\n\tPersistedSessionRecord,\n\tProcessExitPayload,\n\tProcessOutputPayload,\n\tPromptResult,\n\tSerializableCronAction,\n\tSerializableCronJobInfo,\n\tSerializableCronJobOptions,\n\tSessionEventPayload,\n\tSessionRecord,\n\tShellDataPayload,\n\tVmBootedPayload,\n\tVmShutdownPayload,\n} from \"./types.js\";\n\nexport type AgentOSActorConfigInput<TConnParams = undefined> =\n\tAgentOsActorConfigInput<TConnParams>[\"options\"];\n\nexport function agentOS<TConnParams = undefined>(\n\tconfig: AgentOSActorConfigInput<TConnParams> = {},\n): AgentOsActorDefinition<TConnParams> {\n\treturn createAgentOs({\n\t\toptions: config,\n\t} as AgentOsActorConfigInput<TConnParams>);\n}\n"],"mappings":"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","names":["require"]}
|
|
1
|
+
{"version":3,"sources":["../src/actor.ts","../src/config.ts","../src/plugin-binary.ts","../src/index.ts"],"sourcesContent":["/**\n * Rust-backed `agentOS(...)` definition.\n *\n * Produces an `ActorDefinition` whose `nativeFactoryBuilder` constructs a\n * native-actor-plugin factory through `runtime.createNativePluginFactory(...)`\n * (NAPI → `dlopen` of the agent-os actor plugin cdylib, the inverse of the\n * generic host loader). All lifecycle, state, and action dispatch live in the\n * Rust plugin (`crates/agentos-actor-plugin`). This JS shim only validates\n * configuration, resolves the plugin + sidecar binaries, and hands the opaque\n * config envelope across the bridge — it owns no agent-os runtime logic.\n */\n\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport common from \"@agentos-software/common\";\nimport { OPT_AGENTOS_ROOT } from \"@rivet-dev/agentos-core\";\nimport { getSidecarPath } from \"@rivet-dev/agentos-sidecar\";\nimport {\n\tactor,\n\ttype ActorDefinition,\n\ttype ActorFactoryHandle,\n\ttype CoreRuntime,\n\ttype DatabaseProvider,\n\ttype NapiNativePluginOptions,\n\ttype RawAccess,\n} from \"rivetkit\";\nimport {\n\ttype AgentOsActorConfig,\n\ttype AgentOsActorConfigInput,\n\tagentOsActorConfigSchema,\n\tnativeAgentOsOptionsSchema,\n} from \"./config.js\";\nimport { getPluginPath } from \"./plugin-binary.js\";\nimport type { AgentOsActions } from \"./actor-actions.js\";\nimport type { AgentOsActorState, AgentOsActorVars } from \"./types.js\";\n\n/**\n * Build the JSON envelope the Rust plugin consumes. The Rust deserializer\n * uses `deny_unknown_fields`, so the envelope must stay in lock-step with\n * `crates/agentos-actor-plugin/src/config.rs::AgentOsConfigJson`.\n *\n * Software threading: each software ref is flattened (meta packages such as\n * `common` are arrays of refs), normalized to a package dir, and forwarded as\n * `{ dir }` so the sidecar owns the `/opt/agentos` projection. Agent configs\n * are derived from each package's `agentos-package.json`, mirroring\n * `packages/core/src/agent-os.ts`.\n */\ninterface NativeMountLike {\n\tpath: string;\n\tplugin: {\n\t\tid: string;\n\t\tconfig?: unknown;\n\t};\n\treadOnly?: boolean;\n}\n\ninterface NormalizedPackageRef {\n\tpath: string;\n}\n\n/**\n * A native `host_dir` mount of a host `node_modules` directory at\n * `/root/node_modules`, the serializable form `agentOS({ options: { mounts } })`\n * accepts across the NAPI boundary.\n */\nexport interface NodeModulesMountConfig {\n\tpath: \"/root/node_modules\";\n\tplugin: { id: \"host_dir\"; config: { hostPath: string; readOnly: boolean } };\n\treadOnly: boolean;\n}\n\n/**\n * Mount a host `node_modules` directory into the VM at `/root/node_modules`.\n *\n * This is the explicit, mount-based replacement for the removed `moduleAccessCwd`\n * mechanism: the VM module resolver reads the mounted tree through the kernel\n * VFS, so the caller supplies exactly the `node_modules` directory whose\n * packages should resolve in the guest.\n *\n * @param hostNodeModulesDir Absolute host path to a `node_modules` directory.\n * @param opts.readOnly Defaults to `true`; the mount is read-only.\n */\nexport function nodeModulesMount(\n\thostNodeModulesDir: string,\n\topts?: { readOnly?: boolean },\n): NodeModulesMountConfig {\n\tconst readOnly = opts?.readOnly ?? true;\n\treturn {\n\t\tpath: \"/root/node_modules\",\n\t\tplugin: {\n\t\t\tid: \"host_dir\",\n\t\t\tconfig: { hostPath: hostNodeModulesDir, readOnly },\n\t\t},\n\t\treadOnly,\n\t};\n}\n\nfunction toRecord(value: unknown): Record<string, unknown> {\n\treturn value && typeof value === \"object\" && !Array.isArray(value)\n\t\t? (value as Record<string, unknown>)\n\t\t: {};\n}\n\nfunction normalizePackageRef(value: unknown): NormalizedPackageRef | undefined {\n\t// Single package reference: `packagePath` (packed `.aospkg` file, or a\n\t// transition package dir); a raw string is shorthand for the same path.\n\tif (typeof value === \"string\") {\n\t\treturn { path: value };\n\t}\n\tconst record = toRecord(value);\n\tif (typeof record.packagePath === \"string\") {\n\t\treturn { path: record.packagePath };\n\t}\n\t// Recognizably-legacy shapes fail loudly instead of silently dropping the\n\t// package from the VM.\n\tfor (const legacy of [\"packageTar\", \"packageDir\", \"commandDir\", \"dir\"]) {\n\t\tif (typeof record[legacy] === \"string\") {\n\t\t\tthrow new Error(\n\t\t\t\t`agentOS package ref uses removed field \"${legacy}\"; packages are referenced ` +\n\t\t\t\t\t\"by a single `packagePath` — rebuild @agentos-software/* dependencies or pass { packagePath }\",\n\t\t\t);\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction normalizedPackageRefs(software: unknown[]): NormalizedPackageRef[] {\n\tconst refs: NormalizedPackageRef[] = [];\n\tconst seen = new Set<string>();\n\tfor (const entry of software.flat()) {\n\t\tconst ref = normalizePackageRef(entry);\n\t\tif (!ref || seen.has(ref.path)) continue;\n\t\tseen.add(ref.path);\n\t\trefs.push(ref);\n\t}\n\treturn refs;\n}\n\nexport function buildConfigJson<TConnParams>(\n\tparsed: AgentOsActorConfig<TConnParams>,\n): string {\n\tconst options = nativeAgentOsOptionsSchema.parse(\n\t\tparsed.options ?? {},\n\t) as Record<string, unknown>;\n\tconst softwareInput = Array.isArray(options.software) ? options.software : [];\n\tconst defaultSoftwareEnabled = options.defaultSoftware !== false;\n\tconst packageRefs = normalizedPackageRefs(\n\t\tdefaultSoftwareEnabled ? [common, ...softwareInput] : softwareInput,\n\t);\n\tconst packages = packageRefs.map((ref) => ({ packagePath: ref.path }));\n\tconst mounts = serializeNativeMounts(options.mounts);\n\tconst sidecar = serializeSidecar(options.sidecar);\n\treturn JSON.stringify({\n\t\t// The actor forwards ONLY package dirs; the sidecar resolves each agent from\n\t\t// the projected `/opt/agentos/<name>/current/agentos-package.json` (no\n\t\t// client-side adapter-entrypoint resolution — see root CLAUDE.md).\n\t\tpackages,\n\t\tpackagesMountAt: OPT_AGENTOS_ROOT,\n\t\tadditionalInstructions: options.additionalInstructions,\n\t\tloopbackExemptPorts: options.loopbackExemptPorts,\n\t\tallowedNodeBuiltins: options.allowedNodeBuiltins,\n\t\tpermissions: options.permissions,\n\t\trootFilesystem: options.rootFilesystem,\n\t\tmounts,\n\t\tlimits: options.limits,\n\t\tsidecar,\n\t});\n}\n\nfunction serializeNativeMounts(input: unknown): NativeMountLike[] | undefined {\n\tif (input == null) return undefined;\n\tif (!Array.isArray(input)) {\n\t\tthrow new Error(\"agentOS() options.mounts must be an array\");\n\t}\n\treturn input.map((mount, index) => {\n\t\tif (!mount || typeof mount !== \"object\") {\n\t\t\tthrow new Error(`agentOS() options.mounts[${index}] must be an object`);\n\t\t}\n\t\tconst record = mount as Record<string, unknown>;\n\t\tif (record.driver !== undefined) {\n\t\t\tthrow new Error(\n\t\t\t\t\"agentOS() only supports Native mounts across the NAPI boundary; Plain mounts with driver callbacks are not serializable\",\n\t\t\t);\n\t\t}\n\t\tif (record.filesystem !== undefined) {\n\t\t\tthrow new Error(\n\t\t\t\t\"agentOS() only supports Native mounts across the NAPI boundary; Overlay mounts are not serializable\",\n\t\t\t);\n\t\t}\n\t\tconst plugin = record.plugin;\n\t\tif (\n\t\t\ttypeof record.path !== \"string\" ||\n\t\t\t!plugin ||\n\t\t\ttypeof plugin !== \"object\" ||\n\t\t\ttypeof (plugin as Record<string, unknown>).id !== \"string\"\n\t\t) {\n\t\t\tthrow new Error(\n\t\t\t\t`agentOS() options.mounts[${index}] must be a Native mount with { path, plugin: { id, config? } }`,\n\t\t\t);\n\t\t}\n\t\treturn {\n\t\t\tpath: record.path,\n\t\t\tplugin: {\n\t\t\t\tid: (plugin as Record<string, unknown>).id as string,\n\t\t\t\tconfig: (plugin as Record<string, unknown>).config,\n\t\t\t},\n\t\t\treadOnly:\n\t\t\t\ttypeof record.readOnly === \"boolean\" ? record.readOnly : undefined,\n\t\t};\n\t});\n}\n\nfunction serializeSidecar(input: unknown): { pool?: string } | undefined {\n\tif (input == null) return undefined;\n\tif (!input || typeof input !== \"object\") {\n\t\tthrow new Error(\"agentOS() options.sidecar must be an object\");\n\t}\n\tconst record = input as Record<string, unknown>;\n\tif (record.kind === \"explicit\" || record.handle !== undefined) {\n\t\tthrow new Error(\n\t\t\t\"agentOS() only supports sidecar shared pool configuration across the NAPI boundary; explicit sidecar handles are not serializable\",\n\t\t);\n\t}\n\tif (record.kind !== undefined && record.kind !== \"shared\") {\n\t\tthrow new Error('agentOS() options.sidecar.kind must be \"shared\"');\n\t}\n\treturn typeof record.pool === \"string\" ? { pool: record.pool } : {};\n}\n\nfunction buildNativeFactoryBuilder<TConnParams>(\n\tparsed: AgentOsActorConfig<TConnParams>,\n): (runtime: CoreRuntime) => ActorFactoryHandle {\n\treturn (runtime) => {\n\t\tif (runtime.kind !== \"napi\") {\n\t\t\tthrow new Error(\n\t\t\t\t`agentOS() is only supported on the native NAPI runtime (current runtime kind: ${runtime.kind})`,\n\t\t\t);\n\t\t}\n\t\tif (!runtime.createNativePluginFactory) {\n\t\t\tthrow new Error(\n\t\t\t\t\"runtime.createNativePluginFactory is not implemented on the active CoreRuntime\",\n\t\t\t);\n\t\t}\n\t\tconst options: NapiNativePluginOptions = {\n\t\t\t// Resolve the prebuilt agent-os actor plugin cdylib; RivetKit `dlopen`s\n\t\t\t// it through the generic native-plugin ABI.\n\t\t\tpluginPath: getPluginPath(),\n\t\t\t// Opaque config envelope the plugin parses (config.rs::AgentOsConfigJson).\n\t\t\tconfigJson: buildConfigJson(parsed),\n\t\t\t// Resolve the prebuilt sidecar binary from the npm package so the plugin\n\t\t\t// spawns the bundled binary rather than relying on `agentos-sidecar`\n\t\t\t// being on PATH.\n\t\t\tsidecarPath: getSidecarPath(),\n\t\t\t// Custom inspector tabs. The native-plugin path bypasses the normal\n\t\t\t// actor-config assembly (`buildActorConfig`/`inspectorTabs`), so the\n\t\t\t// tabs MUST ride on the plugin options: the Rust NAPI binding\n\t\t\t// `from_native_plugin` forwards `inspectorTabs` into the actor config so\n\t\t\t// the dashboard serves `/inspector/custom-tabs/<id>/` and advertises them\n\t\t\t// in `tab-config`. (Setting `actor({ inspector })` alone does nothing for\n\t\t\t// native-plugin actors.)\n\t\t\tinspectorTabs: AGENTOS_INSPECTOR_CONFIG.tabs,\n\t\t} as NapiNativePluginOptions & {\n\t\t\tinspectorTabs: typeof AGENTOS_INSPECTOR_CONFIG.tabs;\n\t\t};\n\t\treturn runtime.createNativePluginFactory(options);\n\t};\n}\n\n/**\n * Type alias for the `agentOS(...)` return type. Events are not typed at the TS\n * surface because the Rust plugin owns the broadcast set, but the ACTIONS are\n * typed via {@link AgentOsActions} — a TS mirror of the Rust dispatch in\n * `crates/agentos-actor-plugin/src/actions/mod.rs`. That is what gives\n * `createClient<typeof registry>()` a fully-typed handle (e.g. `handle.exec()`\n * returns `ExecResult`, not `unknown`). Keep the two in sync.\n */\nexport type AgentOsActorDefinition<TConnParams> = ActorDefinition<\n\tAgentOsActorState,\n\tTConnParams,\n\tundefined,\n\tAgentOsActorVars,\n\tundefined,\n\tDatabaseProvider<RawAccess>,\n\tRecord<never, never>,\n\tRecord<never, never>,\n\tAgentOsActions\n>;\n\n// One hour — far past any normal agent turn, connection setup, or idle gap, but\n// still a finite bound (never `0`/Infinity) per the limits-and-observability\n// policy. Agent turns routinely run minutes; the stock RivetKit defaults\n// (actionTimeout 60s, on{Before,}ConnectTimeout 5s, sleepTimeout 30s) cut them\n// off mid-flight and broke live `sessionEvent` streaming with\n// \"actor websocket connection setup timed out after 5000 ms\".\nconst ACTOR_NEVER_HIT_MS = 60 * 60 * 1000;\n// 512 MiB — large prompts/results stream as single actor messages; the stock\n// 64 KiB incoming / 1 MiB outgoing caps truncate real agent payloads.\nconst ACTOR_NEVER_HIT_MESSAGE_BYTES = 512 * 1024 * 1024;\n\n/**\n * Never-hit-by-normal-use defaults for the AgentOS actor. Every value is a high\n * but finite bound so a long multi-step agent turn, a slow connection setup, a\n * large prompt/result, and live `sessionEvent` streaming all complete without\n * tripping a RivetKit actor default. Callers can still override any single knob\n * via `actorOptions` (their value wins over these defaults).\n */\nexport const DEFAULT_AGENTOS_ACTOR_OPTIONS = {\n\t// Connection/setup lifecycle (stock 5s each) — the websocket setup path that\n\t// was timing out at 5000ms and dropping all streamed events.\n\tonBeforeConnectTimeout: ACTOR_NEVER_HIT_MS,\n\tonConnectTimeout: ACTOR_NEVER_HIT_MS,\n\tcreateVarsTimeout: ACTOR_NEVER_HIT_MS,\n\tcreateConnStateTimeout: ACTOR_NEVER_HIT_MS,\n\tonMigrateTimeout: ACTOR_NEVER_HIT_MS,\n\t// Action/RPC lifecycle (stock 60s) — long multi-step prompt turns.\n\tactionTimeout: ACTOR_NEVER_HIT_MS,\n\t// Idle/keepalive — don't reap a live session or sleep mid-turn (stock\n\t// connectionLivenessTimeout 2.5s, sleepTimeout 30s). The liveness *interval*\n\t// (ping cadence) is intentionally left at its small default.\n\tconnectionLivenessTimeout: ACTOR_NEVER_HIT_MS,\n\tsleepTimeout: ACTOR_NEVER_HIT_MS,\n\t// Payload sizes — large prompts/results. `maxQueueMessageSize` is the\n\t// per-actor message cap (stock 64 KiB); the transport-level\n\t// max{Incoming,Outgoing}MessageSize live on the registry/setup config (see\n\t// AGENTOS_REGISTRY_MESSAGE_SIZE_DEFAULTS), not on per-actor options.\n\tmaxQueueSize: 1_000_000,\n\tmaxQueueMessageSize: ACTOR_NEVER_HIT_MESSAGE_BYTES,\n} as const;\n\n// Absolute path to the built inspector-tabs app (the shared Vite bundle). All\n// custom tabs share this one `source` dir; the app routes on the\n// `/inspector/custom-tabs/<id>/` URL segment. Resolves from both `src/` (tsx dev\n// / the demo) and the published `dist/`, since `assets/` sits at the package\n// root in both layouts.\nconst INSPECTOR_TABS_ASSET_DIR = join(\n\tdirname(fileURLToPath(import.meta.url)),\n\t\"..\",\n\t\"assets\",\n\t\"inspector-tabs-app\",\n);\n\n// Custom inspector tabs shipped by agent-os. Ids MUST match the `TABS` registry\n// in `src/inspector-tabs/main.tsx`. The built-in rivetkit tabs are hidden so the\n// dashboard shows only the agent-os tabs.\nconst AGENTOS_INSPECTOR_CONFIG = {\n\ttabs: [\n\t\t{ id: \"transcript\", label: \"Transcript\", source: INSPECTOR_TABS_ASSET_DIR, icon: \"comments\" },\n\t\t{ id: \"filesystem\", label: \"Filesystem\", source: INSPECTOR_TABS_ASSET_DIR, icon: \"folder-tree\" },\n\t\t{ id: \"processes\", label: \"Processes\", source: INSPECTOR_TABS_ASSET_DIR, icon: \"microchip\" },\n\t\t{ id: \"software\", label: \"Software\", source: INSPECTOR_TABS_ASSET_DIR, icon: \"box-archive\" },\n\t\t{ id: \"mounts\", label: \"Mounts\", source: INSPECTOR_TABS_ASSET_DIR, icon: \"hard-drive\" },\n\t\t...([\"workflow\", \"database\", \"state\", \"queue\", \"connections\", \"console\"].map(\n\t\t\t(id) => ({ id, hidden: true as const }),\n\t\t)),\n\t],\n};\n\nexport function createAgentOS<TConnParams = undefined>(\n\tconfig: AgentOsActorConfigInput<TConnParams>,\n): AgentOsActorDefinition<TConnParams> {\n\tconst parsed = agentOsActorConfigSchema.parse(\n\t\tconfig,\n\t) as AgentOsActorConfig<TConnParams>;\n\n\t// Construct a minimal definition through the existing actor() helper, then\n\t// attach the Rust factory builder marker. The actions block stays empty\n\t// because no JS-side action ever runs: the engine driver branches on\n\t// `nativeFactoryBuilder` before reaching the JS dispatch path.\n\tconst userActorOptions = (\n\t\tparsed as { actorOptions?: Record<string, unknown> }\n\t).actorOptions;\n\t// High never-hit defaults, with any caller-supplied option winning.\n\tconst actorOptions = {\n\t\t...DEFAULT_AGENTOS_ACTOR_OPTIONS,\n\t\t...(userActorOptions ?? {}),\n\t};\n\tconst definition = actor({\n\t\tactions: {},\n\t\toptions: actorOptions,\n\t\t// Register the custom agent-os inspector tabs (and hide the built-in\n\t\t// rivetkit tabs) so the dashboard renders the agent-os UI. Without this\n\t\t// the shipped tab assets are never surfaced.\n\t\tinspector: AGENTOS_INSPECTOR_CONFIG,\n\t} as Parameters<\n\t\ttypeof actor\n\t>[0]) as unknown as AgentOsActorDefinition<TConnParams>;\n\tdefinition.nativeFactoryBuilder = buildNativeFactoryBuilder(parsed);\n\treturn definition;\n}\n","import type {\n\tAgentOsOptions,\n\tJsonRpcNotification,\n\tNativeMountConfig,\n\tPermissionRequest,\n} from \"@rivet-dev/agentos-core\";\nimport {\n\tagentOsOptionFieldSchemas,\n\tnativeMountConfigSchema,\n\tsharedSidecarConfigSchema,\n} from \"@rivet-dev/agentos-core\";\nimport type { ActorContext, BeforeConnectContext } from \"rivetkit\";\nimport { z } from \"zod/v4\";\nimport type { AgentOsActorState, AgentOsActorVars } from \"./types.js\";\n\nconst zFunction = <\n\tT extends (...args: any[]) => any = (...args: unknown[]) => unknown,\n>() => z.custom<T>((val) => typeof val === \"function\");\n\nexport const nativeAgentOsOptionsSchema = z\n\t// Native actor options are a JSON-serializable subset of AgentOsOptions.\n\t// Keep this allow-list in sync with buildConfigJson() and\n\t// crates/agentos-actor-plugin/src/config.rs::AgentOsConfigJson.\n\t.object({\n\t\tsoftware: agentOsOptionFieldSchemas.software,\n\t\tdefaultSoftware: agentOsOptionFieldSchemas.defaultSoftware,\n\t\tloopbackExemptPorts: agentOsOptionFieldSchemas.loopbackExemptPorts,\n\t\tallowedNodeBuiltins: agentOsOptionFieldSchemas.allowedNodeBuiltins,\n\t\trootFilesystem: agentOsOptionFieldSchemas.rootFilesystem,\n\t\tmounts: z.array(nativeMountConfigSchema).optional(),\n\t\tadditionalInstructions: agentOsOptionFieldSchemas.additionalInstructions,\n\t\tpermissions: agentOsOptionFieldSchemas.permissions,\n\t\tsidecar: sharedSidecarConfigSchema.optional(),\n\t\tlimits: agentOsOptionFieldSchemas.limits,\n\t})\n\t.strict();\n\n/**\n * RivetKit actor lifecycle/transport options forwarded to `actor({ options })`.\n *\n * Validated downstream by RivetKit's own actor config schema, so this stays a\n * permissive pass-through allow-list. `agentOS()` overlays the never-hit\n * defaults in `DEFAULT_AGENTOS_ACTOR_OPTIONS` (see actor.ts) and lets any value\n * here win, so callers can still tighten a bound when they want one.\n */\nexport const agentOsActorOptionsSchema = z\n\t.record(z.string(), z.unknown())\n\t.optional();\n\nexport const agentOsActorConfigSchema = z\n\t.object({\n\t\toptions: nativeAgentOsOptionsSchema.optional(),\n\t\tactorOptions: agentOsActorOptionsSchema,\n\t\tpreview: z\n\t\t\t.object({\n\t\t\t\tdefaultExpiresInSeconds: z.number().positive().default(3600),\n\t\t\t\tmaxExpiresInSeconds: z.number().positive().default(86400),\n\t\t\t})\n\t\t\t.strict()\n\t\t\t.prefault(() => ({})),\n\t\tonBeforeConnect: zFunction().optional(),\n\t\tonSessionEvent: zFunction().optional(),\n\t\tonPermissionRequest: zFunction().optional(),\n\t})\n\t.strict();\n\n// --- Typed config types (generic callbacks overlaid on the Zod schema) ---\n\n/**\n * Type mirror of `nativeAgentOsOptionsSchema`.\n *\n * Keep this in sync with the schema above and the Rust serde mirror at\n * `crates/agentos-actor-plugin/src/config.rs::AgentOsConfigJson`.\n */\nexport type NativeAgentOsOptions = Pick<\n\tAgentOsOptions,\n\t| \"software\"\n\t| \"defaultSoftware\"\n\t| \"loopbackExemptPorts\"\n\t| \"allowedNodeBuiltins\"\n\t| \"rootFilesystem\"\n\t| \"additionalInstructions\"\n\t| \"permissions\"\n\t| \"limits\"\n> & {\n\tmounts?: NativeMountConfig[];\n\tsidecar?: { kind: \"shared\"; pool?: string };\n};\n\ntype AgentOsActorContext<TConnParams> = ActorContext<\n\tAgentOsActorState,\n\tTConnParams,\n\tundefined,\n\tAgentOsActorVars,\n\tundefined,\n\tany\n>;\n\ninterface AgentOsActorConfigCallbacks<TConnParams> {\n\tonBeforeConnect?: (\n\t\tc: BeforeConnectContext<\n\t\t\tAgentOsActorState,\n\t\t\tAgentOsActorVars,\n\t\t\tundefined,\n\t\t\tany\n\t\t>,\n\t\tparams: TConnParams,\n\t) => void | Promise<void>;\n\tonSessionEvent?: (\n\t\tc: AgentOsActorContext<TConnParams>,\n\t\tsessionId: string,\n\t\tevent: JsonRpcNotification,\n\t) => void | Promise<void>;\n\tonPermissionRequest?: (\n\t\tc: AgentOsActorContext<TConnParams>,\n\t\tsessionId: string,\n\t\trequest: PermissionRequest,\n\t) => void | Promise<void>;\n}\n\n// Parsed config (after Zod defaults/transforms applied).\nexport type AgentOsActorConfig<TConnParams = undefined> = Omit<\n\tz.infer<typeof agentOsActorConfigSchema>,\n\t\"options\" | \"onBeforeConnect\" | \"onSessionEvent\" | \"onPermissionRequest\"\n> &\n\t{ options?: NativeAgentOsOptions } &\n\tAgentOsActorConfigCallbacks<TConnParams>;\n\n// Input config (what users pass in before Zod transforms).\nexport type AgentOsActorConfigInput<TConnParams = undefined> = Omit<\n\tz.input<typeof agentOsActorConfigSchema>,\n\t\"options\" | \"onBeforeConnect\" | \"onSessionEvent\" | \"onPermissionRequest\"\n> &\n\t{ options?: NativeAgentOsOptions } &\n\tAgentOsActorConfigCallbacks<TConnParams>;\n","// Platform-specific resolver for the prebuilt agent-os actor plugin cdylib\n// (`libagentos_actor_plugin.{so,dylib,dll}`). Mirrors the sidecar-binary\n// resolver (`@rivet-dev/agentos-sidecar`): the library ships inside one of the\n// `@rivet-dev/agentos-plugin-<platform>` packages, declared as\n// optionalDependencies so npm installs only the one matching the current\n// `os`/`cpu`/`libc` at install time (spec phase 6).\n//\n// Resolution priority:\n// 1. `AGENTOS_PLUGIN_BIN` env var (absolute path override).\n// 2. A cargo build output under the repo `target/{release,debug}/` (dev).\n// 3. The platform-specific `@rivet-dev/agentos-plugin-<platform>` package.\n\nimport { existsSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst PLUGIN_BIN_ENV = \"AGENTOS_PLUGIN_BIN\";\n\n/** The cdylib filename for the current platform. */\nfunction libraryName(): string {\n\tswitch (process.platform) {\n\t\tcase \"darwin\":\n\t\t\treturn \"libagentos_actor_plugin.dylib\";\n\t\tcase \"win32\":\n\t\t\treturn \"agentos_actor_plugin.dll\";\n\t\tdefault:\n\t\t\treturn \"libagentos_actor_plugin.so\";\n\t}\n}\n\nfunction getPlatformPackageName(): string | null {\n\tconst { platform, arch } = process;\n\tswitch (platform) {\n\t\tcase \"linux\":\n\t\t\tif (arch === \"x64\") return \"@rivet-dev/agentos-plugin-linux-x64-gnu\";\n\t\t\tif (arch === \"arm64\") return \"@rivet-dev/agentos-plugin-linux-arm64-gnu\";\n\t\t\tbreak;\n\t\tcase \"darwin\":\n\t\t\tif (arch === \"x64\") return \"@rivet-dev/agentos-plugin-darwin-x64\";\n\t\t\tif (arch === \"arm64\") return \"@rivet-dev/agentos-plugin-darwin-arm64\";\n\t\t\tbreak;\n\t\tdefault:\n\t\t\tbreak;\n\t}\n\treturn null;\n}\n\n/**\n * Resolve the absolute path to the agent-os actor plugin cdylib. RivetKit\n * `dlopen`s this path through the generic native-plugin ABI.\n */\nexport function getPluginPath(): string {\n\tconst override = process.env[PLUGIN_BIN_ENV];\n\tif (override) {\n\t\tif (!existsSync(override)) {\n\t\t\tthrow new Error(\n\t\t\t\t`${PLUGIN_BIN_ENV} is set to ${override} but the file does not exist`,\n\t\t\t);\n\t\t}\n\t\treturn override;\n\t}\n\n\tconst lib = libraryName();\n\n\t// Dev: a cargo build output under the repo `target/`. `import.meta.url` is\n\t// `packages/agentos/dist/plugin-binary.js`, so the repo root is three levels up.\n\tconst here = dirname(fileURLToPath(import.meta.url));\n\tfor (const profile of [\"release\", \"debug\"]) {\n\t\tconst candidate = join(here, \"..\", \"..\", \"..\", \"target\", profile, lib);\n\t\tif (existsSync(candidate)) {\n\t\t\treturn candidate;\n\t\t}\n\t}\n\n\t// Prod: the platform-specific package.\n\tconst platformPkg = getPlatformPackageName();\n\tif (!platformPkg) {\n\t\tthrow new Error(\n\t\t\t`@rivet-dev/agentos: unsupported platform ${process.platform}/${process.arch}. ` +\n\t\t\t\t\"The Agent OS actor plugin currently supports linux and darwin on x64 and arm64. \" +\n\t\t\t\t`Set ${PLUGIN_BIN_ENV} to a local cdylib to override.`,\n\t\t);\n\t}\n\n\tconst require = createRequire(import.meta.url);\n\tlet pkgJsonPath: string;\n\ttry {\n\t\tpkgJsonPath = require.resolve(`${platformPkg}/package.json`);\n\t} catch {\n\t\tthrow new Error(\n\t\t\t`@rivet-dev/agentos: platform package ${platformPkg} is not installed.\\n` +\n\t\t\t\t\"This usually means the platform is unsupported or optionalDependencies\\n\" +\n\t\t\t\t`were skipped during install. Try: npm install --include=optional ${platformPkg}\\n` +\n\t\t\t\t`Or set ${PLUGIN_BIN_ENV} to a local cdylib, or build it with\\n` +\n\t\t\t\t\"`cargo build -p agentos-actor-plugin`.\",\n\t\t);\n\t}\n\n\treturn join(dirname(pkgJsonPath), lib);\n}\n","// Rust-backed agent-os actor surface (native actor plugin / cdylib).\n//\n// Only the `agentOS()` definition function, the config schema, the\n// `nodeModulesMount` helper, the plugin-path resolver, and the public domain\n// types are exported. All actor lifecycle + action dispatch live in the Rust\n// plugin (`crates/agentos-actor-plugin`), loaded by RivetKit via the generic\n// native-plugin ABI.\n\nimport type {\n\tAgentOsOptions,\n\tJsonRpcNotification,\n\tPermissionRequest,\n} from \"@rivet-dev/agentos-core\";\nimport {\n\ttype AgentOsActorDefinition,\n\tcreateAgentOS,\n} from \"./actor.js\";\nimport type {\n\tAgentOsActorConfigInput,\n\tNativeAgentOsOptions,\n} from \"./config.js\";\n\nimport { setup as rivetkitSetup } from \"rivetkit\";\n\n// 512 MiB — large agent prompts/results cross the actor websocket transport as\n// single messages; RivetKit's registry-level defaults (maxIncomingMessageSize\n// 64 KiB, maxOutgoingMessageSize 1 MiB) truncate real payloads. Still a finite\n// bound per the limits-and-observability policy.\nconst AGENTOS_REGISTRY_MESSAGE_SIZE_DEFAULT = 512 * 1024 * 1024;\n\n/**\n * `setup()` wrapper that defaults the registry transport message-size caps to\n * never-hit-by-normal-use values for AgentOS apps, mirroring the per-actor crank\n * in `DEFAULT_AGENTOS_ACTOR_OPTIONS`. Any caller-supplied value wins, so an app\n * can still tighten the bound when it wants one.\n */\nexport const setup: typeof rivetkitSetup = ((\n\tinput: Parameters<typeof rivetkitSetup>[0],\n) =>\n\trivetkitSetup({\n\t\tmaxIncomingMessageSize: AGENTOS_REGISTRY_MESSAGE_SIZE_DEFAULT,\n\t\tmaxOutgoingMessageSize: AGENTOS_REGISTRY_MESSAGE_SIZE_DEFAULT,\n\t\t...input,\n\t})) as typeof rivetkitSetup;\n\nexport {\n\tbuildConfigJson,\n\ttype NodeModulesMountConfig,\n\tnodeModulesMount,\n} from \"./actor.js\";\nexport {\n\ttype AgentOsActorConfig,\n\ttype AgentOsActorConfigInput,\n\ttype NativeAgentOsOptions,\n\tagentOsActorConfigSchema,\n\tnativeAgentOsOptionsSchema,\n} from \"./config.js\";\nexport { getPluginPath } from \"./plugin-binary.js\";\n\n// Re-export the software-definition helper so custom agents/tools/commands can\n// be defined without importing @rivet-dev/agentos-core directly.\nexport { defineSoftware } from \"@rivet-dev/agentos-core\";\n\nexport type {\n\tAgentOsActionContext,\n\tAgentOsActorState,\n\tAgentOsActorVars,\n\tAgentOsEvents,\n\tAgentCrashedPayload,\n\tCronEventPayload,\n\tPermissionRequestPayload,\n\tPersistedSessionEvent,\n\tPersistedSessionRecord,\n\tProcessExitPayload,\n\tProcessOutputPayload,\n\tPromptResult,\n\tSerializableCronAction,\n\tSerializableCronEvent,\n\tSerializableCronJobInfo,\n\tSerializableCronJobOptions,\n\tSessionEventPayload,\n\tSessionRecord,\n\tShellDataPayload,\n\tVmBootedPayload,\n\tVmShutdownPayload,\n} from \"./types.js\";\nexport type {\n\tAgentOsActions,\n\tCreateSessionOptions,\n\tDirEntry,\n\tReadFileResult,\n\tScheduledCronJob,\n\tSignedPreviewUrl,\n\tSpawnedProcess,\n\tVmFetchOptions,\n\tVmFetchResponse,\n\tWriteFileResult,\n} from \"./actor-actions.js\";\n\nexport type AgentOSActorConfigInput<TConnParams = undefined> =\n\tNativeAgentOsOptions &\n\t\tOmit<AgentOsActorConfigInput<TConnParams>, \"options\">;\n\nexport type AgentOSConfigInput<TConnParams = undefined> = AgentOsOptions & {\n\tpreview?: AgentOsActorConfigInput<TConnParams>[\"preview\"];\n\tonBeforeConnect?: AgentOsActorConfigInput<TConnParams>[\"onBeforeConnect\"];\n\tonSessionEvent?: (\n\t\tsessionId: string,\n\t\tevent: JsonRpcNotification,\n\t) => void | Promise<void>;\n\tonPermissionRequest?: (\n\t\tsessionId: string,\n\t\trequest: PermissionRequest,\n\t) => void | Promise<void>;\n};\n\nexport function agentOS<TConnParams = undefined>(\n\tconfig: AgentOSConfigInput<TConnParams> = {},\n): AgentOsActorDefinition<TConnParams> {\n\tconst {\n\t\tpreview,\n\t\tonBeforeConnect,\n\t\tonSessionEvent,\n\t\tonPermissionRequest,\n\t\t...options\n\t} = config;\n\n\treturn createAgentOS({\n\t\toptions,\n\t\tpreview,\n\t\tonBeforeConnect,\n\t\tonSessionEvent: onSessionEvent\n\t\t\t? (_ctx, sessionId, event) => onSessionEvent(sessionId, event)\n\t\t\t: undefined,\n\t\tonPermissionRequest: onPermissionRequest\n\t\t\t? (_ctx, sessionId, request) => onPermissionRequest(sessionId, request)\n\t\t\t: undefined,\n\t} as AgentOsActorConfigInput<TConnParams>);\n}\n"],"mappings":"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","names":["dirname","join","fileURLToPath","require","join","dirname","fileURLToPath"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@rivet-dev/agentos",
|
|
3
|
-
"version": "0.0.0-
|
|
3
|
+
"version": "0.0.0-glibc.4af31c1",
|
|
4
4
|
"description": "Agent OS actor for RivetKit - thin TS forwarder that loads the native actor plugin via RivetKit's native-plugin ABI.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"keywords": [
|
|
@@ -14,6 +14,7 @@
|
|
|
14
14
|
"sideEffects": false,
|
|
15
15
|
"files": [
|
|
16
16
|
"dist",
|
|
17
|
+
"assets",
|
|
17
18
|
"package.json",
|
|
18
19
|
"README.md"
|
|
19
20
|
],
|
|
@@ -46,16 +47,18 @@
|
|
|
46
47
|
"node": ">=22.0.0"
|
|
47
48
|
},
|
|
48
49
|
"scripts": {
|
|
49
|
-
"build": "
|
|
50
|
+
"build": "pnpm build:actor && pnpm build:tabs",
|
|
51
|
+
"build:actor": "tsup src/index.ts src/client.ts src/react.ts",
|
|
52
|
+
"build:tabs": "vite build --config vite.tabs.config.ts",
|
|
50
53
|
"check-types": "tsc --noEmit",
|
|
51
54
|
"test": "vitest run"
|
|
52
55
|
},
|
|
53
56
|
"dependencies": {
|
|
54
|
-
"@agentos-software/common": "0.
|
|
55
|
-
"@rivet-dev/agentos-core": "0.0.0-
|
|
56
|
-
"@rivet-dev/agentos-sidecar": "0.0.0-
|
|
57
|
-
"@rivetkit/react": "0.0.0-feat-
|
|
58
|
-
"rivetkit": "0.0.0-feat-
|
|
57
|
+
"@agentos-software/common": "0.0.0-glibc.4af31c1",
|
|
58
|
+
"@rivet-dev/agentos-core": "0.0.0-glibc.4af31c1",
|
|
59
|
+
"@rivet-dev/agentos-sidecar": "0.0.0-glibc.4af31c1",
|
|
60
|
+
"@rivetkit/react": "0.0.0-stack-feat-rivetkit-forward-inspector-tabs-to-native-plugin-actors-qkwmksyy.d2859b0",
|
|
61
|
+
"rivetkit": "0.0.0-stack-feat-rivetkit-forward-inspector-tabs-to-native-plugin-actors-qkwmksyy.d2859b0",
|
|
59
62
|
"zod": "^4.1.11"
|
|
60
63
|
},
|
|
61
64
|
"peerDependencies": {
|
|
@@ -71,15 +74,30 @@
|
|
|
71
74
|
}
|
|
72
75
|
},
|
|
73
76
|
"devDependencies": {
|
|
77
|
+
"@radix-ui/react-collapsible": "^1.1.2",
|
|
78
|
+
"@radix-ui/react-scroll-area": "^1.2.2",
|
|
79
|
+
"@tanstack/react-query": "^5.87.1",
|
|
74
80
|
"@types/node": "^22.19.15",
|
|
81
|
+
"@types/react": "^19.0.0",
|
|
82
|
+
"@types/react-dom": "^19.0.0",
|
|
83
|
+
"@vitejs/plugin-react": "^4.3.4",
|
|
84
|
+
"autoprefixer": "^10.4.20",
|
|
85
|
+
"class-variance-authority": "^0.7.1",
|
|
86
|
+
"clsx": "^2.1.1",
|
|
87
|
+
"postcss": "^8.4.49",
|
|
88
|
+
"react": "^19.0.0",
|
|
89
|
+
"react-dom": "^19.0.0",
|
|
90
|
+
"tailwind-merge": "^2.6.0",
|
|
91
|
+
"tailwindcss": "^3.4.17",
|
|
75
92
|
"tsup": "^8.4.0",
|
|
76
93
|
"typescript": "^5.7.3",
|
|
94
|
+
"vite": "^5.4.20",
|
|
77
95
|
"vitest": "^2.1.8"
|
|
78
96
|
},
|
|
79
97
|
"optionalDependencies": {
|
|
80
|
-
"@rivet-dev/agentos-plugin-darwin-arm64": "0.0.0-
|
|
81
|
-
"@rivet-dev/agentos-plugin-darwin-x64": "0.0.0-
|
|
82
|
-
"@rivet-dev/agentos-plugin-linux-arm64-gnu": "0.0.0-
|
|
83
|
-
"@rivet-dev/agentos-plugin-linux-x64-gnu": "0.0.0-
|
|
98
|
+
"@rivet-dev/agentos-plugin-darwin-arm64": "0.0.0-glibc.4af31c1",
|
|
99
|
+
"@rivet-dev/agentos-plugin-darwin-x64": "0.0.0-glibc.4af31c1",
|
|
100
|
+
"@rivet-dev/agentos-plugin-linux-arm64-gnu": "0.0.0-glibc.4af31c1",
|
|
101
|
+
"@rivet-dev/agentos-plugin-linux-x64-gnu": "0.0.0-glibc.4af31c1"
|
|
84
102
|
}
|
|
85
103
|
}
|