@rivet-dev/agentos 0.2.3 → 0.2.5-rc.1

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.js CHANGED
@@ -1,6 +1,12 @@
1
1
  // src/actor.ts
2
- import { sep } from "path";
2
+ import { readFileSync } from "fs";
3
+ import { dirname as dirname2, join as join2 } from "path";
4
+ import { fileURLToPath as fileURLToPath2 } from "url";
3
5
  import common from "@agentos-software/common";
6
+ import {
7
+ OPT_AGENTOS_BIN,
8
+ OPT_AGENTOS_ROOT
9
+ } from "@rivet-dev/agentos-core";
4
10
  import { getSidecarPath } from "@rivet-dev/agentos-sidecar";
5
11
  import {
6
12
  actor
@@ -124,85 +130,148 @@ function nodeModulesMount(hostNodeModulesDir, opts) {
124
130
  readOnly
125
131
  };
126
132
  }
127
- function nodeModulesRootOf(packageDir) {
128
- const parts = packageDir.split(sep);
129
- const idx = parts.lastIndexOf("node_modules");
130
- if (idx === -1) return void 0;
131
- return parts.slice(0, idx + 1).join(sep);
133
+ function toRecord(value) {
134
+ return value && typeof value === "object" && !Array.isArray(value) ? value : {};
135
+ }
136
+ function normalizePackageRef(value) {
137
+ if (typeof value === "string") {
138
+ return { dir: value };
139
+ }
140
+ const record = toRecord(value);
141
+ if (typeof record.packageDir === "string") {
142
+ return {
143
+ dir: record.packageDir,
144
+ legacyManifest: legacyPackageManifest(record)
145
+ };
146
+ }
147
+ if (typeof record.dir === "string") {
148
+ return {
149
+ dir: record.dir,
150
+ legacyManifest: legacyPackageManifest(record)
151
+ };
152
+ }
153
+ return void 0;
132
154
  }
133
- function withAutoAgentNodeModulesMount(mounts, descriptors) {
134
- if (mounts?.some((mount) => mount.path === "/root/node_modules")) {
135
- return mounts;
155
+ function legacyPackageManifest(record) {
156
+ if (typeof record.name !== "string") {
157
+ return void 0;
136
158
  }
137
- const roots = /* @__PURE__ */ new Set();
138
- for (const d of descriptors) {
139
- if (!d.agent || typeof d.packageDir !== "string") continue;
140
- const root = nodeModulesRootOf(d.packageDir);
141
- if (root) {
142
- roots.add(root);
143
- continue;
159
+ const manifest = { name: record.name };
160
+ const agent = toRecord(record.agent);
161
+ if (typeof agent.acpEntrypoint === "string") {
162
+ manifest.agent = {
163
+ acpEntrypoint: agent.acpEntrypoint,
164
+ ...isStringRecord(agent.env) ? { env: agent.env } : {},
165
+ ...Array.isArray(agent.launchArgs) && agent.launchArgs.every((arg) => typeof arg === "string") ? { launchArgs: agent.launchArgs } : {},
166
+ ...typeof agent.snapshot === "boolean" ? { snapshot: agent.snapshot } : {}
167
+ };
168
+ }
169
+ return manifest;
170
+ }
171
+ function readPackageManifestForClient(ref) {
172
+ return tryReadAgentosPackageManifest(ref.dir) ?? ref.legacyManifest;
173
+ }
174
+ function tryReadAgentosPackageManifest(dir) {
175
+ try {
176
+ return readAgentosPackageManifest(dir);
177
+ } catch (error) {
178
+ if (error instanceof Error && errorCode(error) === "ENOENT") {
179
+ return void 0;
144
180
  }
145
- const requires = d.requires?.length ? ` Required packages: ${d.requires.join(", ")}.` : "";
146
- throw new Error(
147
- `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
148
- );
181
+ throw error;
149
182
  }
150
- if (roots.size === 0) return mounts;
151
- if (roots.size > 1) {
152
- throw new Error(
153
- `agentOs() could not auto-mount agent node_modules: agents resolved to multiple node_modules roots (${[...roots].join(", ")}). Pass an explicit nodeModulesMount(...) in options.mounts.`
183
+ }
184
+ function readAgentosPackageManifest(dir) {
185
+ const manifestPath = join2(dir, "agentos-package.json");
186
+ let parsed;
187
+ try {
188
+ parsed = JSON.parse(readFileSync(manifestPath, "utf8"));
189
+ } catch (error) {
190
+ const wrapped = new Error(
191
+ `Failed to read agentOS package manifest at ${manifestPath}: ${error instanceof Error ? error.message : String(error)}`
154
192
  );
193
+ const code = errorCode(error);
194
+ if (code !== void 0) {
195
+ Object.assign(wrapped, { code });
196
+ }
197
+ throw wrapped;
198
+ }
199
+ return validateAgentosPackageManifest(parsed, manifestPath);
200
+ }
201
+ function errorCode(error) {
202
+ if (!isPlainObject(error)) {
203
+ return void 0;
204
+ }
205
+ return typeof error.code === "string" ? error.code : void 0;
206
+ }
207
+ function validateAgentosPackageManifest(value, source) {
208
+ if (!isPlainObject(value) || typeof value.name !== "string") {
209
+ throw new Error(`Invalid agentOS package manifest at ${source}: missing name`);
210
+ }
211
+ const manifest = { name: value.name };
212
+ if (value.agent !== void 0) {
213
+ if (!isPlainObject(value.agent) || typeof value.agent.acpEntrypoint !== "string") {
214
+ throw new Error(
215
+ `Invalid agentOS package manifest at ${source}: invalid agent.acpEntrypoint`
216
+ );
217
+ }
218
+ manifest.agent = {
219
+ acpEntrypoint: value.agent.acpEntrypoint,
220
+ ...isStringRecord(value.agent.env) ? { env: value.agent.env } : {},
221
+ ...Array.isArray(value.agent.launchArgs) && value.agent.launchArgs.every((arg) => typeof arg === "string") ? { launchArgs: value.agent.launchArgs } : {},
222
+ ...typeof value.agent.snapshot === "boolean" ? { snapshot: value.agent.snapshot } : {}
223
+ };
155
224
  }
156
- const [hostNodeModulesDir] = [...roots];
157
- return [...mounts ?? [], nodeModulesMount(hostNodeModulesDir)];
225
+ return manifest;
226
+ }
227
+ function isPlainObject(value) {
228
+ return typeof value === "object" && value !== null && !Array.isArray(value);
158
229
  }
159
- function softwareIdentity(d) {
160
- if (typeof d.commandDir === "string") return `dir:${d.commandDir}`;
161
- if (typeof d.packageDir === "string") return `dir:${d.packageDir}`;
162
- const name = d.name;
163
- if (typeof name === "string") return `name:${name}`;
164
- return JSON.stringify(d);
230
+ function isStringRecord(value) {
231
+ return value !== null && typeof value === "object" && !Array.isArray(value) && Object.values(value).every((entry) => typeof entry === "string");
232
+ }
233
+ function normalizedPackageRefs(software) {
234
+ const refs = [];
235
+ const seen = /* @__PURE__ */ new Set();
236
+ for (const entry of software.flat()) {
237
+ const ref = normalizePackageRef(entry);
238
+ if (!ref || seen.has(ref.dir)) continue;
239
+ seen.add(ref.dir);
240
+ refs.push(ref);
241
+ }
242
+ return refs;
165
243
  }
166
- function flattenSoftware(input, out) {
167
- if (input == null) return;
168
- if (Array.isArray(input)) {
169
- for (const item of input) flattenSoftware(item, out);
170
- return;
244
+ function serializedAgentConfigs(packageRefs) {
245
+ const configs = [];
246
+ for (const ref of packageRefs) {
247
+ const manifest = readPackageManifestForClient(ref);
248
+ if (!manifest?.agent) continue;
249
+ configs.push({
250
+ name: manifest.name,
251
+ adapterEntrypoint: `${OPT_AGENTOS_BIN}/${manifest.agent.acpEntrypoint}`,
252
+ launchArgs: manifest.agent.launchArgs,
253
+ defaultEnv: manifest.agent.env
254
+ });
171
255
  }
172
- if (typeof input === "object") out.push(input);
256
+ return configs;
173
257
  }
174
258
  function buildConfigJson(parsed) {
175
259
  const options = nativeAgentOsOptionsSchema.parse(
176
260
  parsed.options ?? {}
177
261
  );
178
- const descriptors = [];
179
- flattenSoftware(options.software, descriptors);
262
+ const softwareInput = Array.isArray(options.software) ? options.software : [];
180
263
  const defaultSoftwareEnabled = options.defaultSoftware !== false;
181
- if (defaultSoftwareEnabled) {
182
- const defaults = [];
183
- flattenSoftware(common, defaults);
184
- const seen = new Set(descriptors.map(softwareIdentity));
185
- const toPrepend = defaults.filter((d) => !seen.has(softwareIdentity(d)));
186
- descriptors.unshift(...toPrepend);
187
- }
188
- const software = [];
189
- for (const d of descriptors) {
190
- if (typeof d.commandDir === "string") {
191
- software.push({ package: d.commandDir });
192
- } else if (typeof d.packageDir === "string") {
193
- software.push({
194
- package: d.packageDir,
195
- kind: d.hostTool || d.toolkit ? "tool" : "agent"
196
- });
197
- }
198
- }
199
- const mounts = withAutoAgentNodeModulesMount(
200
- serializeNativeMounts(options.mounts),
201
- descriptors
264
+ const packageRefs = normalizedPackageRefs(
265
+ defaultSoftwareEnabled ? [common, ...softwareInput] : softwareInput
202
266
  );
267
+ const packages = packageRefs.map((ref) => ({ dir: ref.dir }));
268
+ const agentConfigs = serializedAgentConfigs(packageRefs);
269
+ const mounts = serializeNativeMounts(options.mounts);
203
270
  const sidecar = serializeSidecar(options.sidecar);
204
271
  return JSON.stringify({
205
- software,
272
+ packages,
273
+ packagesMountAt: OPT_AGENTOS_ROOT,
274
+ agentConfigs,
206
275
  additionalInstructions: options.additionalInstructions,
207
276
  moduleAccessCwd: options.moduleAccessCwd,
208
277
  loopbackExemptPorts: options.loopbackExemptPorts,
@@ -217,27 +286,27 @@ function buildConfigJson(parsed) {
217
286
  function serializeNativeMounts(input) {
218
287
  if (input == null) return void 0;
219
288
  if (!Array.isArray(input)) {
220
- throw new Error("agentOs() options.mounts must be an array");
289
+ throw new Error("agentOS() options.mounts must be an array");
221
290
  }
222
291
  return input.map((mount, index) => {
223
292
  if (!mount || typeof mount !== "object") {
224
- throw new Error(`agentOs() options.mounts[${index}] must be an object`);
293
+ throw new Error(`agentOS() options.mounts[${index}] must be an object`);
225
294
  }
226
295
  const record = mount;
227
296
  if (record.driver !== void 0) {
228
297
  throw new Error(
229
- "agentOs() only supports Native mounts across the NAPI boundary; Plain mounts with driver callbacks are not serializable"
298
+ "agentOS() only supports Native mounts across the NAPI boundary; Plain mounts with driver callbacks are not serializable"
230
299
  );
231
300
  }
232
301
  if (record.filesystem !== void 0) {
233
302
  throw new Error(
234
- "agentOs() only supports Native mounts across the NAPI boundary; Overlay mounts are not serializable"
303
+ "agentOS() only supports Native mounts across the NAPI boundary; Overlay mounts are not serializable"
235
304
  );
236
305
  }
237
306
  const plugin = record.plugin;
238
307
  if (typeof record.path !== "string" || !plugin || typeof plugin !== "object" || typeof plugin.id !== "string") {
239
308
  throw new Error(
240
- `agentOs() options.mounts[${index}] must be a Native mount with { path, plugin: { id, config? } }`
309
+ `agentOS() options.mounts[${index}] must be a Native mount with { path, plugin: { id, config? } }`
241
310
  );
242
311
  }
243
312
  return {
@@ -253,16 +322,16 @@ function serializeNativeMounts(input) {
253
322
  function serializeSidecar(input) {
254
323
  if (input == null) return void 0;
255
324
  if (!input || typeof input !== "object") {
256
- throw new Error("agentOs() options.sidecar must be an object");
325
+ throw new Error("agentOS() options.sidecar must be an object");
257
326
  }
258
327
  const record = input;
259
328
  if (record.kind === "explicit" || record.handle !== void 0) {
260
329
  throw new Error(
261
- "agentOs() only supports sidecar shared pool configuration across the NAPI boundary; explicit sidecar handles are not serializable"
330
+ "agentOS() only supports sidecar shared pool configuration across the NAPI boundary; explicit sidecar handles are not serializable"
262
331
  );
263
332
  }
264
333
  if (record.kind !== void 0 && record.kind !== "shared") {
265
- throw new Error('agentOs() options.sidecar.kind must be "shared"');
334
+ throw new Error('agentOS() options.sidecar.kind must be "shared"');
266
335
  }
267
336
  return typeof record.pool === "string" ? { pool: record.pool } : {};
268
337
  }
@@ -270,7 +339,7 @@ function buildNativeFactoryBuilder(parsed) {
270
339
  return (runtime) => {
271
340
  if (runtime.kind !== "napi") {
272
341
  throw new Error(
273
- `agentOs() is only supported on the native NAPI runtime (current runtime kind: ${runtime.kind})`
342
+ `agentOS() is only supported on the native NAPI runtime (current runtime kind: ${runtime.kind})`
274
343
  );
275
344
  }
276
345
  if (!runtime.createNativePluginFactory) {
@@ -287,7 +356,15 @@ function buildNativeFactoryBuilder(parsed) {
287
356
  // Resolve the prebuilt sidecar binary from the npm package so the plugin
288
357
  // spawns the bundled binary rather than relying on `agentos-sidecar`
289
358
  // being on PATH.
290
- sidecarPath: getSidecarPath()
359
+ sidecarPath: getSidecarPath(),
360
+ // Custom inspector tabs. The native-plugin path bypasses the normal
361
+ // actor-config assembly (`buildActorConfig`/`inspectorTabs`), so the
362
+ // tabs MUST ride on the plugin options: the Rust NAPI binding
363
+ // `from_native_plugin` forwards `inspectorTabs` into the actor config so
364
+ // the dashboard serves `/inspector/custom-tabs/<id>/` and advertises them
365
+ // in `tab-config`. (Setting `actor({ inspector })` alone does nothing for
366
+ // native-plugin actors.)
367
+ inspectorTabs: AGENTOS_INSPECTOR_CONFIG.tabs
291
368
  };
292
369
  return runtime.createNativePluginFactory(options);
293
370
  };
@@ -316,7 +393,25 @@ var DEFAULT_AGENTOS_ACTOR_OPTIONS = {
316
393
  maxQueueSize: 1e6,
317
394
  maxQueueMessageSize: ACTOR_NEVER_HIT_MESSAGE_BYTES
318
395
  };
319
- function agentOs(config) {
396
+ var INSPECTOR_TABS_ASSET_DIR = join2(
397
+ dirname2(fileURLToPath2(import.meta.url)),
398
+ "..",
399
+ "assets",
400
+ "inspector-tabs-app"
401
+ );
402
+ var AGENTOS_INSPECTOR_CONFIG = {
403
+ tabs: [
404
+ { id: "transcript", label: "Transcript", source: INSPECTOR_TABS_ASSET_DIR, icon: "comments" },
405
+ { id: "filesystem", label: "Filesystem", source: INSPECTOR_TABS_ASSET_DIR, icon: "folder-tree" },
406
+ { id: "processes", label: "Processes", source: INSPECTOR_TABS_ASSET_DIR, icon: "microchip" },
407
+ { id: "software", label: "Software", source: INSPECTOR_TABS_ASSET_DIR, icon: "box-archive" },
408
+ { id: "mounts", label: "Mounts", source: INSPECTOR_TABS_ASSET_DIR, icon: "hard-drive" },
409
+ ...["workflow", "database", "state", "queue", "connections", "console"].map(
410
+ (id) => ({ id, hidden: true })
411
+ )
412
+ ]
413
+ };
414
+ function createAgentOS(config) {
320
415
  const parsed = agentOsActorConfigSchema.parse(
321
416
  config
322
417
  );
@@ -327,7 +422,11 @@ function agentOs(config) {
327
422
  };
328
423
  const definition = actor({
329
424
  actions: {},
330
- options: actorOptions
425
+ options: actorOptions,
426
+ // Register the custom agent-os inspector tabs (and hide the built-in
427
+ // rivetkit tabs) so the dashboard renders the agent-os UI. Without this
428
+ // the shipped tab assets are never surfaced.
429
+ inspector: AGENTOS_INSPECTOR_CONFIG
331
430
  });
332
431
  definition.nativeFactoryBuilder = buildNativeFactoryBuilder(parsed);
333
432
  return definition;
@@ -350,7 +449,7 @@ function agentOS(config = {}) {
350
449
  onPermissionRequest,
351
450
  ...options
352
451
  } = config;
353
- return agentOs({
452
+ return createAgentOS({
354
453
  options,
355
454
  preview,
356
455
  onBeforeConnect,
@@ -360,7 +459,6 @@ function agentOS(config = {}) {
360
459
  }
361
460
  export {
362
461
  agentOS,
363
- agentOs,
364
462
  agentOsActorConfigSchema,
365
463
  buildConfigJson,
366
464
  defineSoftware,
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\tnativeAgentOsOptionsSchema,\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 options = nativeAgentOsOptionsSchema.parse(\n\t\tparsed.options ?? {},\n\t) as Record<string, unknown>;\n\tconst descriptors: SoftwareDescriptorLike[] = [];\n\tflattenSoftware(options.software, descriptors);\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 = options.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 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\tmoduleAccessCwd: options.moduleAccessCwd,\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\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\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 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} 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\tmoduleAccessCwd: agentOsOptionFieldSchemas.moduleAccessCwd,\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| \"moduleAccessCwd\"\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\tagentOs as createAgentOs,\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\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\";\nexport { createAgentOs as agentOs };\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":["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 { readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport common from \"@agentos-software/common\";\nimport {\n\tOPT_AGENTOS_BIN,\n\tOPT_AGENTOS_ROOT,\n} 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 PackageAgentManifest {\n\tacpEntrypoint: string;\n\tenv?: Record<string, string>;\n\tlaunchArgs?: string[];\n\tsnapshot?: boolean;\n}\n\ninterface PackageManifest {\n\tname: string;\n\tagent?: PackageAgentManifest;\n}\n\ninterface NormalizedPackageRef {\n\tdir: string;\n\tlegacyManifest?: PackageManifest;\n}\n\ninterface SerializedAgentConfig {\n\tname: string;\n\tadapterEntrypoint: string;\n\tlaunchArgs?: string[];\n\tdefaultEnv?: Record<string, 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\tif (typeof value === \"string\") {\n\t\treturn { dir: value };\n\t}\n\tconst record = toRecord(value);\n\tif (typeof record.packageDir === \"string\") {\n\t\treturn {\n\t\t\tdir: record.packageDir,\n\t\t\tlegacyManifest: legacyPackageManifest(record),\n\t\t};\n\t}\n\tif (typeof record.dir === \"string\") {\n\t\treturn {\n\t\t\tdir: record.dir,\n\t\t\tlegacyManifest: legacyPackageManifest(record),\n\t\t};\n\t}\n\treturn undefined;\n}\n\nfunction legacyPackageManifest(\n\trecord: Record<string, unknown>,\n): PackageManifest | undefined {\n\tif (typeof record.name !== \"string\") {\n\t\treturn undefined;\n\t}\n\tconst manifest: PackageManifest = { name: record.name };\n\tconst agent = toRecord(record.agent);\n\tif (typeof agent.acpEntrypoint === \"string\") {\n\t\tmanifest.agent = {\n\t\t\tacpEntrypoint: agent.acpEntrypoint,\n\t\t\t...(isStringRecord(agent.env) ? { env: agent.env } : {}),\n\t\t\t...(Array.isArray(agent.launchArgs) &&\n\t\t\tagent.launchArgs.every((arg) => typeof arg === \"string\")\n\t\t\t\t? { launchArgs: agent.launchArgs }\n\t\t\t\t: {}),\n\t\t\t...(typeof agent.snapshot === \"boolean\" ? { snapshot: agent.snapshot } : {}),\n\t\t};\n\t}\n\treturn manifest;\n}\n\nfunction readPackageManifestForClient(\n\tref: NormalizedPackageRef,\n): PackageManifest | undefined {\n\treturn tryReadAgentosPackageManifest(ref.dir) ?? ref.legacyManifest;\n}\n\nfunction tryReadAgentosPackageManifest(\n\tdir: string,\n): PackageManifest | undefined {\n\ttry {\n\t\treturn readAgentosPackageManifest(dir);\n\t} catch (error) {\n\t\tif (error instanceof Error && errorCode(error) === \"ENOENT\") {\n\t\t\treturn undefined;\n\t\t}\n\t\tthrow error;\n\t}\n}\n\nfunction readAgentosPackageManifest(dir: string): PackageManifest {\n\tconst manifestPath = join(dir, \"agentos-package.json\");\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(readFileSync(manifestPath, \"utf8\"));\n\t} catch (error) {\n\t\tconst wrapped = new Error(\n\t\t\t`Failed to read agentOS package manifest at ${manifestPath}: ${error instanceof Error ? error.message : String(error)}`,\n\t\t);\n\t\tconst code = errorCode(error);\n\t\tif (code !== undefined) {\n\t\t\tObject.assign(wrapped, { code });\n\t\t}\n\t\tthrow wrapped;\n\t}\n\treturn validateAgentosPackageManifest(parsed, manifestPath);\n}\n\nfunction errorCode(error: unknown): string | undefined {\n\tif (!isPlainObject(error)) {\n\t\treturn undefined;\n\t}\n\treturn typeof error.code === \"string\" ? error.code : undefined;\n}\n\nfunction validateAgentosPackageManifest(\n\tvalue: unknown,\n\tsource: string,\n): PackageManifest {\n\tif (!isPlainObject(value) || typeof value.name !== \"string\") {\n\t\tthrow new Error(`Invalid agentOS package manifest at ${source}: missing name`);\n\t}\n\tconst manifest: PackageManifest = { name: value.name };\n\tif (value.agent !== undefined) {\n\t\tif (\n\t\t\t!isPlainObject(value.agent) ||\n\t\t\ttypeof value.agent.acpEntrypoint !== \"string\"\n\t\t) {\n\t\t\tthrow new Error(\n\t\t\t\t`Invalid agentOS package manifest at ${source}: invalid agent.acpEntrypoint`,\n\t\t\t);\n\t\t}\n\t\tmanifest.agent = {\n\t\t\tacpEntrypoint: value.agent.acpEntrypoint,\n\t\t\t...(isStringRecord(value.agent.env) ? { env: value.agent.env } : {}),\n\t\t\t...(Array.isArray(value.agent.launchArgs) &&\n\t\t\tvalue.agent.launchArgs.every((arg) => typeof arg === \"string\")\n\t\t\t\t? { launchArgs: value.agent.launchArgs }\n\t\t\t\t: {}),\n\t\t\t...(typeof value.agent.snapshot === \"boolean\"\n\t\t\t\t? { snapshot: value.agent.snapshot }\n\t\t\t\t: {}),\n\t\t};\n\t}\n\treturn manifest;\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isStringRecord(value: unknown): value is Record<string, string> {\n\treturn (\n\t\tvalue !== null &&\n\t\ttypeof value === \"object\" &&\n\t\t!Array.isArray(value) &&\n\t\tObject.values(value).every((entry) => typeof entry === \"string\")\n\t);\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.dir)) continue;\n\t\tseen.add(ref.dir);\n\t\trefs.push(ref);\n\t}\n\treturn refs;\n}\n\nfunction serializedAgentConfigs(\n\tpackageRefs: NormalizedPackageRef[],\n): SerializedAgentConfig[] {\n\tconst configs: SerializedAgentConfig[] = [];\n\tfor (const ref of packageRefs) {\n\t\tconst manifest = readPackageManifestForClient(ref);\n\t\tif (!manifest?.agent) continue;\n\t\tconfigs.push({\n\t\t\tname: manifest.name,\n\t\t\tadapterEntrypoint: `${OPT_AGENTOS_BIN}/${manifest.agent.acpEntrypoint}`,\n\t\t\tlaunchArgs: manifest.agent.launchArgs,\n\t\t\tdefaultEnv: manifest.agent.env,\n\t\t});\n\t}\n\treturn configs;\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) => ({ dir: ref.dir }));\n\tconst agentConfigs = serializedAgentConfigs(packageRefs);\n\tconst mounts = serializeNativeMounts(options.mounts);\n\tconst sidecar = serializeSidecar(options.sidecar);\n\treturn JSON.stringify({\n\t\tpackages,\n\t\tpackagesMountAt: OPT_AGENTOS_ROOT,\n\t\tagentConfigs,\n\t\tadditionalInstructions: options.additionalInstructions,\n\t\tmoduleAccessCwd: options.moduleAccessCwd,\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\tmoduleAccessCwd: agentOsOptionFieldSchemas.moduleAccessCwd,\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| \"moduleAccessCwd\"\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\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\";\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.2.3",
3
+ "version": "0.2.5-rc.1",
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": "tsup src/index.ts src/client.ts src/react.ts",
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.3.0",
55
- "@rivet-dev/agentos-core": "0.2.3",
56
- "@rivet-dev/agentos-sidecar": "0.2.3",
57
- "@rivetkit/react": "0.0.0-feat-dylib-actor-plugin.c44621f",
58
- "rivetkit": "0.0.0-feat-dylib-actor-plugin.c44621f",
57
+ "@agentos-software/common": "0.3.1",
58
+ "@rivet-dev/agentos-core": "0.2.5-rc.1",
59
+ "@rivet-dev/agentos-sidecar": "0.2.5-rc.1",
60
+ "@rivetkit/react": "catalog:rivetkit",
61
+ "rivetkit": "catalog:rivetkit",
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.2.3",
81
- "@rivet-dev/agentos-plugin-darwin-x64": "0.2.3",
82
- "@rivet-dev/agentos-plugin-linux-arm64-gnu": "0.2.3",
83
- "@rivet-dev/agentos-plugin-linux-x64-gnu": "0.2.3"
98
+ "@rivet-dev/agentos-plugin-darwin-arm64": "0.2.5-rc.1",
99
+ "@rivet-dev/agentos-plugin-darwin-x64": "0.2.5-rc.1",
100
+ "@rivet-dev/agentos-plugin-linux-arm64-gnu": "0.2.5-rc.1",
101
+ "@rivet-dev/agentos-plugin-linux-x64-gnu": "0.2.5-rc.1"
84
102
  }
85
103
  }