@rivet-dev/agentos 0.2.7 → 0.2.8-rc.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -71,8 +71,9 @@ interface AgentOsEvents {
71
71
  vmShutdown: VmShutdownPayload;
72
72
  processOutput: ProcessOutputPayload;
73
73
  processExit: ProcessExitPayload;
74
+ /** Ordered PTY output containing stdout and stderr exactly once. */
74
75
  shellData: ShellDataPayload;
75
- /** Shell stderr (the dedicated channel backing the TS `onStderr` option). */
76
+ /** Optional stderr-only diagnostic tap; do not render it with `shellData`. */
76
77
  shellStderr: ShellDataPayload;
77
78
  /** Shell process exit (mirrors `waitShell` resolution). */
78
79
  shellExit: ShellExitPayload;
@@ -562,85 +563,55 @@ type AgentOsActorConfigInput<TConnParams = undefined> = Omit<z.input<typeof agen
562
563
  options?: NativeAgentOsOptions;
563
564
  } & AgentOsActorConfigCallbacks<TConnParams>;
564
565
 
565
- /**
566
- * Typed action surface for the agentOS VM actor.
567
- *
568
- * ⚠️ SOURCE OF TRUTH / KEEP IN SYNC ⚠️
569
- * The actual dispatch is implemented in Rust at
570
- * crates/agentos-actor-plugin/src/actions/mod.rs (fn `dispatch`)
571
- * This interface MUST mirror that match statement one-to-one: every `"name" =>`
572
- * arm there needs a corresponding method here with matching positional args and
573
- * the serialized return type. When you add/rename/retype an action in
574
- * `mod.rs`, update this interface in the same change (and vice-versa).
575
- *
576
- * RivetKit turns each `(ctx, ...args) => Promise<R>` entry into a client handle
577
- * method `(...args) => Promise<R>` (it strips the leading context arg). Wiring
578
- * this as the actions type param of `AgentOsActorDefinition` is what makes
579
- * `createClient<typeof registry>()` return a fully-typed handle instead of the
580
- * old `any`/`unknown` surface.
581
- */
582
-
583
- /** The leading actor context arg; stripped from the client-facing method. */
584
566
  type Ctx = any;
585
- /** Directory entry returned by `readdir` / `readdirRecursive`. */
586
567
  interface DirEntry {
587
568
  path: string;
588
569
  type: "file" | "directory" | "symlink";
589
570
  size: number;
590
571
  }
591
- /** Raw `readdirEntries` entry — one typed child in a single round-trip. */
592
572
  interface ReaddirEntry {
593
573
  name: string;
594
574
  isDirectory: boolean;
595
575
  isSymbolicLink: boolean;
596
576
  }
597
- /** A process started via `spawn` (mirrors the Rust spawn handle DTO). */
598
577
  interface SpawnedProcess {
599
578
  pid: number;
600
579
  }
601
- /** Options accepted by `exec` (mirrors the env/cwd subset of `ExecOptions`). */
602
580
  interface ExecActionOptions {
603
581
  env?: Record<string, string>;
604
582
  cwd?: string;
605
583
  }
606
- /** Options accepted by `spawn` (mirrors `SpawnActionOptions`). */
607
584
  interface SpawnActionOptions {
608
585
  env?: Record<string, string>;
609
586
  cwd?: string;
610
587
  streamStdin?: boolean;
611
588
  }
612
- /** Handle returned by `scheduleCron` (mirrors `ScheduledCronDto`). */
613
589
  interface ScheduledCronJob {
614
590
  id: string;
615
591
  }
616
- /** Options accepted by `vmFetch` (mirrors the Rust `FetchOptions`). */
617
592
  interface VmFetchOptions {
618
593
  method?: string;
619
594
  headers?: Record<string, string>;
620
595
  body?: string | Uint8Array;
621
596
  }
622
- /** Response from `vmFetch` (mirrors `FetchResponseDto`). */
623
597
  interface VmFetchResponse {
624
598
  status: number;
625
599
  statusText: string;
626
600
  headers: Record<string, string>;
627
601
  body: Uint8Array;
628
602
  }
629
- /** Options accepted by `createSession` (mirrors `CreateSessionOptionsDto`). */
630
603
  interface CreateSessionOptions {
631
604
  cwd?: string;
632
605
  env?: Record<string, string>;
633
606
  skipOsInstructions?: boolean;
634
607
  additionalInstructions?: string;
635
608
  }
636
- /** Result of `createSignedPreviewUrl` (mirrors `SignedPreviewUrlDto`). */
637
609
  interface SignedPreviewUrl {
638
610
  path: string;
639
611
  token: string;
640
612
  port: number;
641
613
  expiresAt: number;
642
614
  }
643
- /** Options accepted by `openShell` (mirrors `OpenShellActionOptions`). */
644
615
  interface OpenShellActionOptions {
645
616
  command?: string;
646
617
  args?: string[];
@@ -649,14 +620,12 @@ interface OpenShellActionOptions {
649
620
  cols?: number;
650
621
  rows?: number;
651
622
  }
652
- /** Handle returned by `openShell` (mirrors `OpenShellDto`). */
653
623
  interface OpenShellResult {
654
624
  shellId: string;
655
625
  }
656
- /** Per-entry result of the batch `writeFiles` / `readFiles` actions. */
657
626
  interface WriteFileResult {
658
627
  path: string;
659
- ok: boolean;
628
+ success: boolean;
660
629
  error?: string;
661
630
  }
662
631
  interface ReadFileResult {
@@ -664,29 +633,18 @@ interface ReadFileResult {
664
633
  content?: Uint8Array;
665
634
  error?: string;
666
635
  }
667
- /** One configured mount, returned by `listMounts`. Mirrors `MountInfoDto`. */
668
636
  interface MountInfo {
669
637
  path: string;
670
- /** Native mount plugin id. */
671
638
  kind: "host_dir" | "s3" | "google_drive" | "sandbox_agent";
672
- /** Provider-specific config detail (null when the plugin carries none). */
673
639
  config: unknown;
674
640
  readOnly: boolean;
675
641
  }
676
- /** One configured software package, returned by `listSoftware`. Mirrors `SoftwareInfoDto`. */
677
642
  interface SoftwareInfo {
678
643
  package: string;
679
- /** Kebab-case `SoftwareKind` tag. */
680
644
  kind: "wasm-commands" | "agent" | "tool";
681
645
  version: string | null;
682
646
  commands: string[];
683
647
  }
684
- /**
685
- * The agentOS VM actor's action map. Keep one method per Rust `dispatch` arm.
686
- *
687
- * Declared as a `type` (not `interface`) so it satisfies RivetKit's
688
- * `Actions<…>` constraint, which expects an implicit string index signature.
689
- */
690
648
  type AgentOsActions = {
691
649
  readFile: (c: Ctx, path: string) => Promise<Uint8Array>;
692
650
  writeFile: (c: Ctx, path: string, content: string | Uint8Array) => Promise<void>;
@@ -783,10 +741,10 @@ declare function buildConfigJson<TConnParams>(parsed: AgentOsActorConfig<TConnPa
783
741
  /**
784
742
  * Type alias for the `agentOS(...)` return type. Events are not typed at the TS
785
743
  * surface because the Rust plugin owns the broadcast set, but the ACTIONS are
786
- * typed via {@link AgentOsActions} — a TS mirror of the Rust dispatch in
787
- * `crates/agentos-actor-plugin/src/actions/mod.rs`. That is what gives
788
- * `createClient<typeof registry>()` a fully-typed handle (e.g. `handle.exec()`
789
- * returns `ExecResult`, not `unknown`). Keep the two in sync.
744
+ * typed via {@link AgentOsActions} — generated from the Rust dispatch contract
745
+ * table in `crates/agentos-actor-plugin/src/actions/contract_surface.rs`.
746
+ * That is what gives `createClient<typeof registry>()` a fully-typed handle
747
+ * (e.g. `handle.exec()` returns `ExecResult`, not `unknown`).
790
748
  */
791
749
  type AgentOsActorDefinition<TConnParams> = ActorDefinition<AgentOsActorState, TConnParams, undefined, AgentOsActorVars, undefined, DatabaseProvider<RawAccess>, Record<never, never>, Record<never, never>, AgentOsActions>;
792
750
 
@@ -807,6 +765,7 @@ declare const setup: typeof setup$1;
807
765
  type AgentOSActorConfigInput<TConnParams = undefined> = NativeAgentOsOptions & Omit<AgentOsActorConfigInput<TConnParams>, "options">;
808
766
  type AgentOSConfigInput<TConnParams = undefined> = AgentOsOptions & {
809
767
  preview?: AgentOsActorConfigInput<TConnParams>["preview"];
768
+ actorOptions?: AgentOsActorConfigInput<TConnParams>["actorOptions"];
810
769
  onBeforeConnect?: AgentOsActorConfigInput<TConnParams>["onBeforeConnect"];
811
770
  onSessionEvent?: (sessionId: string, event: JsonRpcNotification) => void | Promise<void>;
812
771
  onPermissionRequest?: (sessionId: string, request: PermissionRequest) => void | Promise<void>;
package/dist/index.js CHANGED
@@ -1,3 +1,6 @@
1
+ // src/index.ts
2
+ import { setup as rivetkitSetup } from "rivetkit";
3
+
1
4
  // src/actor.ts
2
5
  import { dirname as dirname2, join as join2 } from "path";
3
6
  import { fileURLToPath as fileURLToPath2 } from "url";
@@ -236,7 +239,7 @@ function serializeSidecar(input) {
236
239
  }
237
240
  return typeof record.pool === "string" ? { pool: record.pool } : {};
238
241
  }
239
- function buildNativeFactoryBuilder(parsed) {
242
+ function buildNativeFactoryBuilder(parsed, actorOptions) {
240
243
  return (runtime) => {
241
244
  if (runtime.kind !== "napi") {
242
245
  throw new Error(
@@ -254,6 +257,9 @@ function buildNativeFactoryBuilder(parsed) {
254
257
  pluginPath: getPluginPath(),
255
258
  // Opaque config envelope the plugin parses (config.rs::AgentOsConfigJson).
256
259
  configJson: buildConfigJson(parsed),
260
+ // RivetKit's native-plugin bridge owns the runtime ActorConfig for
261
+ // cdylib actors, so forward the merged per-actor lifecycle options too.
262
+ actorOptions,
257
263
  // Resolve the prebuilt sidecar binary from the npm package so the plugin
258
264
  // spawns the bundled binary rather than relying on `agentos-sidecar`
259
265
  // being on PATH.
@@ -302,11 +308,36 @@ var INSPECTOR_TABS_ASSET_DIR = join2(
302
308
  );
303
309
  var AGENTOS_INSPECTOR_CONFIG = {
304
310
  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" },
311
+ {
312
+ id: "transcript",
313
+ label: "Transcript",
314
+ source: INSPECTOR_TABS_ASSET_DIR,
315
+ icon: "comments"
316
+ },
317
+ {
318
+ id: "filesystem",
319
+ label: "Filesystem",
320
+ source: INSPECTOR_TABS_ASSET_DIR,
321
+ icon: "folder-tree"
322
+ },
323
+ {
324
+ id: "processes",
325
+ label: "Processes",
326
+ source: INSPECTOR_TABS_ASSET_DIR,
327
+ icon: "microchip"
328
+ },
329
+ {
330
+ id: "software",
331
+ label: "Software",
332
+ source: INSPECTOR_TABS_ASSET_DIR,
333
+ icon: "box-archive"
334
+ },
335
+ {
336
+ id: "mounts",
337
+ label: "Mounts",
338
+ source: INSPECTOR_TABS_ASSET_DIR,
339
+ icon: "hard-drive"
340
+ },
310
341
  ...["workflow", "database", "state", "queue", "connections", "console"].map(
311
342
  (id) => ({ id, hidden: true })
312
343
  )
@@ -329,12 +360,14 @@ function createAgentOS(config) {
329
360
  // the shipped tab assets are never surfaced.
330
361
  inspector: AGENTOS_INSPECTOR_CONFIG
331
362
  });
332
- definition.nativeFactoryBuilder = buildNativeFactoryBuilder(parsed);
363
+ definition.nativeFactoryBuilder = buildNativeFactoryBuilder(
364
+ parsed,
365
+ actorOptions
366
+ );
333
367
  return definition;
334
368
  }
335
369
 
336
370
  // src/index.ts
337
- import { setup as rivetkitSetup } from "rivetkit";
338
371
  import { defineSoftware } from "@rivet-dev/agentos-core";
339
372
  var AGENTOS_REGISTRY_MESSAGE_SIZE_DEFAULT = 512 * 1024 * 1024;
340
373
  var setup = ((input) => rivetkitSetup({
@@ -345,6 +378,7 @@ var setup = ((input) => rivetkitSetup({
345
378
  function agentOS(config = {}) {
346
379
  const {
347
380
  preview,
381
+ actorOptions,
348
382
  onBeforeConnect,
349
383
  onSessionEvent,
350
384
  onPermissionRequest,
@@ -352,6 +386,7 @@ function agentOS(config = {}) {
352
386
  } = config;
353
387
  return createAgentOS({
354
388
  options,
389
+ actorOptions,
355
390
  preview,
356
391
  onBeforeConnect,
357
392
  onSessionEvent: onSessionEvent ? (_ctx, sessionId, event) => onSessionEvent(sessionId, event) : void 0,
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 { 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"]}
1
+ {"version":3,"sources":["../src/index.ts","../src/actor.ts","../src/config.ts","../src/plugin-binary.ts"],"sourcesContent":["// 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 { setup as rivetkitSetup } from \"rivetkit\";\nimport { type AgentOsActorDefinition, createAgentOS } from \"./actor.js\";\nimport type {\n\tAgentOsActorConfigInput,\n\tNativeAgentOsOptions,\n} from \"./config.js\";\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\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\";\nexport {\n\tbuildConfigJson,\n\ttype NodeModulesMountConfig,\n\tnodeModulesMount,\n} from \"./actor.js\";\nexport {\n\ttype AgentOsActorConfig,\n\ttype AgentOsActorConfigInput,\n\tagentOsActorConfigSchema,\n\ttype NativeAgentOsOptions,\n\tnativeAgentOsOptionsSchema,\n} from \"./config.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 \"./generated/actor-actions.generated.js\";\nexport { getPluginPath } from \"./plugin-binary.js\";\nexport type {\n\tAgentCrashedPayload,\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\tSerializableCronEvent,\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\tNativeAgentOsOptions & Omit<AgentOsActorConfigInput<TConnParams>, \"options\">;\n\nexport type AgentOSConfigInput<TConnParams = undefined> = AgentOsOptions & {\n\tpreview?: AgentOsActorConfigInput<TConnParams>[\"preview\"];\n\tactorOptions?: AgentOsActorConfigInput<TConnParams>[\"actorOptions\"];\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\tactorOptions,\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\tactorOptions,\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","/**\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\ttype ActorDefinition,\n\ttype ActorFactoryHandle,\n\tactor,\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 type { AgentOsActions } from \"./generated/actor-actions.generated.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 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\tactorOptions: Record<string, unknown>,\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// RivetKit's native-plugin bridge owns the runtime ActorConfig for\n\t\t\t// cdylib actors, so forward the merged per-actor lifecycle options too.\n\t\t\tactorOptions,\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\tactorOptions?: Record<string, unknown>;\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} — generated from the Rust dispatch contract\n * table in `crates/agentos-actor-plugin/src/actions/contract_surface.rs`.\n * That is what gives `createClient<typeof registry>()` a fully-typed handle\n * (e.g. `handle.exec()` returns `ExecResult`, not `unknown`).\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{\n\t\t\tid: \"transcript\",\n\t\t\tlabel: \"Transcript\",\n\t\t\tsource: INSPECTOR_TABS_ASSET_DIR,\n\t\t\ticon: \"comments\",\n\t\t},\n\t\t{\n\t\t\tid: \"filesystem\",\n\t\t\tlabel: \"Filesystem\",\n\t\t\tsource: INSPECTOR_TABS_ASSET_DIR,\n\t\t\ticon: \"folder-tree\",\n\t\t},\n\t\t{\n\t\t\tid: \"processes\",\n\t\t\tlabel: \"Processes\",\n\t\t\tsource: INSPECTOR_TABS_ASSET_DIR,\n\t\t\ticon: \"microchip\",\n\t\t},\n\t\t{\n\t\t\tid: \"software\",\n\t\t\tlabel: \"Software\",\n\t\t\tsource: INSPECTOR_TABS_ASSET_DIR,\n\t\t\ticon: \"box-archive\",\n\t\t},\n\t\t{\n\t\t\tid: \"mounts\",\n\t\t\tlabel: \"Mounts\",\n\t\t\tsource: INSPECTOR_TABS_ASSET_DIR,\n\t\t\ticon: \"hard-drive\",\n\t\t},\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(\n\t\tparsed,\n\t\tactorOptions,\n\t);\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"],"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.7",
3
+ "version": "0.2.8-rc.2",
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": [
@@ -54,9 +54,10 @@
54
54
  "test": "vitest run"
55
55
  },
56
56
  "dependencies": {
57
- "@agentos-software/common": "0.2.7",
58
- "@rivet-dev/agentos-core": "0.2.7",
59
- "@rivet-dev/agentos-sidecar": "0.2.7",
57
+ "@agentos-software/common": "0.2.8-rc.2",
58
+ "@rivet-dev/agentos-core": "0.2.8-rc.2",
59
+ "@rivet-dev/agentos-plugin": "0.2.8-rc.2",
60
+ "@rivet-dev/agentos-sidecar": "0.2.8-rc.2",
60
61
  "@rivetkit/react": "0.0.0-stack-feat-rivetkit-forward-inspector-tabs-to-native-plugin-actors-qkwmksyy.d2859b0",
61
62
  "rivetkit": "0.0.0-stack-feat-rivetkit-forward-inspector-tabs-to-native-plugin-actors-qkwmksyy.d2859b0",
62
63
  "zod": "^4.1.11"
@@ -95,9 +96,9 @@
95
96
  "vitest": "^2.1.8"
96
97
  },
97
98
  "optionalDependencies": {
98
- "@rivet-dev/agentos-plugin-darwin-arm64": "0.2.7",
99
- "@rivet-dev/agentos-plugin-darwin-x64": "0.2.7",
100
- "@rivet-dev/agentos-plugin-linux-arm64-gnu": "0.2.7",
101
- "@rivet-dev/agentos-plugin-linux-x64-gnu": "0.2.7"
99
+ "@rivet-dev/agentos-plugin-darwin-arm64": "0.2.8-rc.2",
100
+ "@rivet-dev/agentos-plugin-darwin-x64": "0.2.8-rc.2",
101
+ "@rivet-dev/agentos-plugin-linux-arm64-gnu": "0.2.8-rc.2",
102
+ "@rivet-dev/agentos-plugin-linux-x64-gnu": "0.2.8-rc.2"
102
103
  }
103
104
  }