experimental-ash 0.16.3 → 0.17.0

package/dist/src/shared/sandbox-backend.d.ts

@@ -7,9 +7,9 @@ import type { SandboxSession } from "#shared/sandbox-session.js";
  * runtime orchestrator can persist reconnect metadata and release
  * resources.
  */
-export interface SandboxBackendHandle<S extends SandboxSession = SandboxSession, O = Record<string, never>> {
+export interface SandboxBackendHandle<S extends SandboxSession = SandboxSession, SO = Record<string, never>> {
     readonly session: SandboxSession;
-    readonly useSessionFn: SandboxSessionUseFn<S, O>;
+    readonly useSessionFn: SandboxSessionUseFn<S, SO>;
     captureState(): Promise<SandboxBackendSessionState>;
     dispose(): Promise<void>;
 }
@@ -79,9 +79,9 @@ export interface SandboxBackendCreateInput {
  * `bootstrap` hook and `seedFiles`, then `backend.create(...)` opens
  * durable sessions from that snapshot.
  */
-export interface SandboxBackendPrewarmInput {
+export interface SandboxBackendPrewarmInput<BO = Record<string, never>> {
     readonly templateKey: string;
-    readonly bootstrap?: (input: SandboxBootstrapContext) => void | Promise<void>;
+    readonly bootstrap?: (input: SandboxBootstrapContext<BO>) => void | Promise<void>;
     readonly runtimeContext: SandboxBackendRuntimeContext;
     readonly seedFiles: ReadonlyArray<SandboxSeedFile>;
 }
@@ -97,7 +97,7 @@ export interface SandboxBackendPrewarmInput {
  * Each backend owns the full template-then-session lifecycle internally;
  * callers only need a single `create` call.
  */
-export interface SandboxBackend<S extends SandboxSession = SandboxSession, O = Record<string, never>> {
+export interface SandboxBackend<S extends SandboxSession = SandboxSession, BO = Record<string, never>, SO = Record<string, never>> {
     /**
      * Stable identifier for this backend implementation.
      *
@@ -113,12 +113,12 @@ export interface SandboxBackend<S extends SandboxSession = SandboxSession, O = R
      * {@link SandboxTemplateNotProvisionedError} when the requested
      * template is missing.
      */
-    create(input: SandboxBackendCreateInput): Promise<SandboxBackendHandle<S, O>>;
+    create(input: SandboxBackendCreateInput): Promise<SandboxBackendHandle<S, SO>>;
     /**
      * Build-time prewarm hook. Ash invokes this for every authored
      * sandbox in the compiled graph before serving traffic so the backend
      * can capture a reusable template snapshot. Idempotent against an
      * existing snapshot keyed by `templateKey`.
      */
-    prewarm(input: SandboxBackendPrewarmInput): Promise<void>;
+    prewarm(input: SandboxBackendPrewarmInput<BO>): Promise<void>;
 }

package/dist/src/shared/sandbox-definition.d.ts

@@ -1,14 +1,9 @@
 import type { SandboxSession } from "#shared/sandbox-session.js";
 import type { SandboxBackend } from "#shared/sandbox-backend.js";
-export interface SandboxBootstrapUseOptions {
-    readonly runtime?: string;
-    readonly ports?: number[];
-    readonly env?: Record<string, string>;
-}
-export type SandboxBootstrapUseFn = (options?: SandboxBootstrapUseOptions) => Promise<SandboxSession>;
+export type SandboxBootstrapUseFn<O = Record<string, never>> = (options?: O) => Promise<SandboxSession>;
 export type SandboxSessionUseFn<S extends SandboxSession = SandboxSession, O = Record<string, never>> = (options?: O) => Promise<S>;
-export interface SandboxBootstrapContext {
-    readonly use: SandboxBootstrapUseFn;
+export interface SandboxBootstrapContext<O = Record<string, never>> {
+    readonly use: SandboxBootstrapUseFn<O>;
 }
 export interface SandboxSessionContext<S extends SandboxSession = SandboxSession, O = Record<string, never>> {
     readonly use: SandboxSessionUseFn<S, O>;
@@ -26,7 +21,7 @@ export interface SandboxSessionContext<S extends SandboxSession = SandboxSession
  * `subagents/<name>/sandbox.ts` (or the folder form) and do not inherit
  * their parent's sandbox (skill seeds differ per agent).
  */
-export interface SandboxDefinition<S extends SandboxSession = SandboxSession, O = Record<string, never>> {
+export interface SandboxDefinition<S extends SandboxSession = SandboxSession, BO = Record<string, never>, SO = Record<string, never>> {
     /**
      * Backend that runs this sandbox.
      *
@@ -36,7 +31,7 @@ export interface SandboxDefinition<S extends SandboxSession = SandboxSession, O
      * everywhere else. Set `backend` explicitly to pin the sandbox to a
      * specific backend regardless of environment.
      */
-    backend: SandboxBackend<S, O>;
-    bootstrap?(input: SandboxBootstrapContext): Promise<void> | void;
-    onSession?(input: SandboxSessionContext<S, O>): Promise<void> | void;
+    backend: SandboxBackend<S, BO, SO>;
+    bootstrap?(input: SandboxBootstrapContext<BO>): Promise<void> | void;
+    onSession?(input: SandboxSessionContext<S, SO>): Promise<void> | void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "experimental-ash",
-  "version": "0.16.3",
+  "version": "0.17.0",
   "bin": {
     "ash": "./bin/ash.js",
     "experimental-ash": "./bin/ash.js"