@rivet-dev/agentos-core 0.2.5-rc.3 → 0.2.5-rc.5

package/README.md

@@ -112,7 +112,7 @@ await vm.dispose();
 
 | Method | Signature | Description |
 |--------|-----------|-------------|
-| `createSession` | `createSession(agentType: AgentType \| string, options?: CreateSessionOptions): Promise<{ sessionId: string }>` | Launch an agent and return a session ID |
+| `createSession` | `createSession(agentType: AgentType, options?: CreateSessionOptions): Promise<{ sessionId: string }>` | Launch an agent and return a session ID |
 | `listSessions` | `listSessions(): SessionInfo[]` | List active sessions |
 | `destroySession` | `destroySession(sessionId: string): Promise<void>` | Gracefully cancel and close a session |
 
@@ -157,7 +157,7 @@ await vm.dispose();
 - `MountConfigCustom` — Caller-provided VirtualFileSystem
 - `NativeMountConfig` — Declarative sidecar mount plugin configuration
 - `MountConfigOverlay` — Copy-on-write overlay (lower + upper layers)
-- `chunkedS3MountPlugin()` — Declarative S3-compatible native mount plugin descriptor (from `@secure-exec/core/descriptors`)
+- `chunkedS3MountPlugin()` — Declarative S3-compatible native mount plugin descriptor (from `@rivet-dev/agentos-runtime-core/descriptors`)
 
 **MCP Servers**
 - `McpServerConfig` — Union of local and remote MCP configs
@@ -177,8 +177,8 @@ await vm.dispose();
 - `BatchReadResult` — Result of a batch read (path, content, error?)
 
 **Agent**
-- `AgentType` — `"pi" | "pi-cli" | "opencode" | "claude"`
-- `AgentConfig` — Agent configuration (acpAdapter, agentPackage, prepareInstructions)
+- `AgentType` — `string` (a package manifest `name`, e.g. `"pi"`, `"claude"`); agents are resolved dynamically from the configured `/opt/agentos` package manifests, so any manifest `name` is valid
+- `AgentConfig` — Agent configuration (adapterEntrypoint, launchArgs, defaultEnv)
 - `AgentRegistryEntry` — Registry entry (id, acpAdapter, agentPackage, installed)
 
 **Session**

package/dist/agent-os.d.ts

@@ -1,9 +1,9 @@
-import type { NativeMountPluginDescriptor } from "@secure-exec/core/descriptors";
+import type { NativeMountPluginDescriptor } from "@rivet-dev/agentos-runtime-core/descriptors";
 import type { AgentCapabilities, AgentInfo, PermissionReply, PermissionRequestHandler, SessionConfigOption, SessionEventHandler, SessionModeState } from "./agent-session-types.js";
 import { type ToolKit } from "./host-tools.js";
 import type { JsonRpcResponse } from "./json-rpc.js";
 import type { ConnectTerminalOptions, Kernel, KernelExecOptions, KernelExecResult, ProcessInfo as KernelProcessInfo, KernelSpawnOptions, OpenShellOptions, Permissions, VirtualFileSystem, VirtualStat } from "./runtime-compat.js";
-export type { MountConfigJsonObject, MountConfigJsonPrimitive, MountConfigJsonValue, NativeMountPluginDescriptor, } from "@secure-exec/core/descriptors";
+export type { MountConfigJsonObject, MountConfigJsonPrimitive, MountConfigJsonValue, NativeMountPluginDescriptor, } from "@rivet-dev/agentos-runtime-core/descriptors";
 export type { AgentCapabilities, AgentInfo, PermissionReply, PermissionRequest, PermissionRequestHandler, SessionConfigOption, SessionEventHandler, SessionInitData, SessionMode, SessionModeState, } from "./agent-session-types.js";
 export type { AcpTimeoutErrorData, JsonRpcError, JsonRpcErrorData, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, } from "./json-rpc.js";
 export { isAcpTimeoutErrorData } from "./json-rpc.js";
@@ -46,15 +46,11 @@ export interface BatchReadResult {
 /** Entry in the agent registry, describing an available agent type. */
 export interface AgentRegistryEntry {
     id: string;
-    /** npm adapter package (legacy agents) — absent for `/opt/agentos` packages. */
-    acpAdapter?: string;
-    /** npm agent package (legacy agents) — absent for `/opt/agentos` packages. */
-    agentPackage?: string;
-    /** Pre-resolved adapter command path for an `/opt/agentos` agent package. */
-    adapterEntrypoint?: string;
     installed: boolean;
+    /** Guest entrypoint the sidecar launches for this agent (`/opt/agentos/bin/<acpEntrypoint>`). */
+    adapterEntrypoint: string;
 }
-import type { AgentType } from "./agents.js";
+import type { AgentType } from "./types.js";
 import type { ScheduleDriver } from "./cron/schedule-driver.js";
 import type { CronEventHandler, CronJob, CronJobInfo, CronJobOptions } from "./cron/types.js";
 import { type LayerStore, type OverlayFilesystemMode, type RootSnapshotExport, type SnapshotLayerHandle } from "./layers.js";
@@ -177,6 +173,10 @@ export interface AgentOsLimits {
     /** Guest JavaScript runtime buffering limits. */
     jsRuntime?: {
         v8HeapLimitMb?: number;
+        syncRpcWaitTimeoutMs?: number;
+        cpuTimeLimitMs?: number;
+        wallClockLimitMs?: number;
+        importCacheMaterializeTimeoutMs?: number;
         capturedOutputLimitBytes?: number;
         stdinBufferLimitBytes?: number;
         eventPayloadLimitBytes?: number;
@@ -186,6 +186,7 @@ export interface AgentOsLimits {
     python?: {
         outputBufferMaxBytes?: number;
         executionTimeoutMs?: number;
+        maxOldSpaceMb?: number;
         vfsRpcTimeoutMs?: number;
     };
     /** Guest WASM runtime limits. */
@@ -193,6 +194,8 @@ export interface AgentOsLimits {
         maxModuleFileBytes?: number;
         capturedOutputLimitBytes?: number;
         syncReadLimitBytes?: number;
+        prewarmTimeoutMs?: number;
+        runnerHeapLimitMb?: number;
     };
 }
 export interface AgentStderrEvent {
@@ -295,11 +298,6 @@ export interface AgentOsOptions {
     rootFilesystem?: RootFilesystemConfig;
     /** Filesystems to mount at boot time. */
     mounts?: MountConfig[];
-    /**
-     * @deprecated Use `mounts: [nodeModulesMount(path)]` instead.
-     * Compatibility alias for mounting `<moduleAccessCwd>/node_modules` at `/root/node_modules`.
-     */
-    moduleAccessCwd?: string;
     /** Additional instructions appended to the base OS system prompt injected at session start. */
     additionalInstructions?: string;
     /** Custom schedule driver for cron jobs. Defaults to TimerScheduleDriver. */
@@ -443,12 +441,9 @@ export declare class AgentOs {
     private _closedShellIds;
     private _pendingShellExitPromises;
     private _shellCounter;
-    /** Command names linked into `/opt/agentos/bin` at runtime (via the sidecar). */
-    private _linkedCommands;
     private _acpTerminals;
     private _acpTerminalCounter;
     private _softwareRoots;
-    private _softwareAgentConfigs;
     private _cronManager;
     private _toolKits;
     private _toolReference;
@@ -490,7 +485,6 @@ export declare class AgentOs {
     private _assertSafeAbsolutePath;
     private _assertWritableAbsolutePath;
     private _vfs;
-    private _copyPath;
     readFile(path: string): Promise<Uint8Array>;
     writeFile(path: string, content: string | Uint8Array): Promise<void>;
     writeFiles(entries: BatchWriteEntry[]): Promise<BatchWriteResult[]>;
@@ -558,8 +552,17 @@ export declare class AgentOs {
      * lifetime (and across a snapshot iff the volume persists).
      */
     linkSoftware(descriptor: PackageRef | SoftwarePackageRef): Promise<void>;
-    /** Returns all registered agents with their installation status. */
-    listAgents(): AgentRegistryEntry[];
+    providedCommands(): Promise<{
+        packageName: string;
+        commands: string[];
+    }[]>;
+    /**
+     * Returns all registered agents with their installation status. Thin forwarder:
+     * sends `AcpListAgentsRequest` and maps the response. The sidecar enumerates the
+     * projected `/opt/agentos` packages (the client parses no manifests). Every such
+     * agent is a package materialized into the VM, so `installed` is always `true`.
+     */
+    listAgents(): Promise<AgentRegistryEntry[]>;
     private _syncSessionState;
     private _applySessionUpdate;
     private _recordSessionNotification;
@@ -599,7 +602,7 @@ export declare class AgentOs {
     private _rejectPendingPermissionRepliesFromSession;
     private _closeSessionInternal;
     private _hydrateSessionState;
-    createSession(agentType: AgentType | string, options?: CreateSessionOptions): Promise<{
+    createSession(agentType: AgentType, options?: CreateSessionOptions): Promise<{
         sessionId: string;
     }>;
     /**
@@ -617,7 +620,7 @@ export declare class AgentOs {
      * Resume depends on a durable root; on a non-durable (default in-memory) root
      * there is no surviving store and the fallback tier always runs.
      */
-    resumeSession(sessionId: string, agentType: AgentType | string, options?: ResumeSessionOptions): Promise<ResumeSessionResult>;
+    resumeSession(sessionId: string, agentType: AgentType, options?: ResumeSessionOptions): Promise<ResumeSessionResult>;
     private _installSidecarRequestHandler;
     private _handleAcpExtSidecarRequest;
     private _dispatchAcpSidecarRequest;
@@ -644,12 +647,6 @@ export declare class AgentOs {
     private _handleAcpReleaseTerminal;
     private _handleAcpResizeTerminal;
     private _handleAcpPermissionCallback;
-    /**
-     * Resolve an agent config by ID. Agents are /opt/agentos packages
-     * registered from their manifests (explicit software at create, or lazily
-     * linked dependency agents) — there is no hardcoded fallback config.
-     */
-    private _resolveAgentConfig;
     /**
      * Gracefully destroy a session: cancel any pending work, close the client,
      * and remove from tracking. Unlike close() which is abrupt, this attempts