experimental-ash 0.56.0 → 0.58.0

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

@@ -10,6 +10,7 @@ export interface SandboxSessionContext<O = Record<string, never>> {
     readonly ctx: SessionContext;
     readonly use: SandboxSessionUseFn<O>;
 }
+export type SandboxRevalidationKeyFn = () => Promise<string> | string;
 /**
  * Public sandbox definition authored in `agent/sandbox.ts` (shorthand)
  * or `agent/sandbox/sandbox.ts` (folder layout, when paired with an
@@ -23,7 +24,7 @@ export interface SandboxSessionContext<O = Record<string, never>> {
  * `subagents/<name>/sandbox.ts` (or the folder form) and do not inherit
  * their parent's sandbox (skill seeds differ per agent).
  */
-export interface SandboxDefinition<BO = Record<string, never>, SO = Record<string, never>> {
+interface SandboxDefinitionBase<BO = Record<string, never>, SO = Record<string, never>> {
     /**
      * Backend that runs this sandbox.
      *
@@ -49,6 +50,25 @@ export interface SandboxDefinition<BO = Record<string, never>, SO = Record<strin
      * specific backend regardless of environment.
      */
     readonly backend: SandboxBackend<BO, SO> | (() => SandboxBackend<BO, SO>);
-    bootstrap?(input: SandboxBootstrapContext<BO>): Promise<void> | void;
+    readonly description?: string;
     onSession?(input: SandboxSessionContext<SO>): Promise<void> | void;
 }
+export interface SandboxDefinitionWithBootstrap<BO = Record<string, never>, SO = Record<string, never>> extends SandboxDefinitionBase<BO, SO> {
+    bootstrap(input: SandboxBootstrapContext<BO>): Promise<void> | void;
+    /**
+     * Optional build-time revalidation key for the reusable sandbox
+     * snapshot produced by {@link bootstrap}. Ash evaluates this
+     * function during compile/build, stores the resolved string in
+     * compiled artifacts, and uses that frozen value for both prewarm and
+     * runtime session create. Authored sandbox source and
+     * framework-managed seed contents are included automatically; provide
+     * this key only for external inputs that affect bootstrap output.
+     */
+    readonly revalidationKey?: SandboxRevalidationKeyFn;
+}
+export interface SandboxDefinitionWithoutBootstrap<BO = Record<string, never>, SO = Record<string, never>> extends SandboxDefinitionBase<BO, SO> {
+    bootstrap?: undefined;
+    readonly revalidationKey?: never;
+}
+export type SandboxDefinition<BO = Record<string, never>, SO = Record<string, never>> = SandboxDefinitionWithBootstrap<BO, SO> | SandboxDefinitionWithoutBootstrap<BO, SO>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "experimental-ash",
-  "version": "0.56.0",
+  "version": "0.58.0",
   "description": "Filesystem-first framework for durable backend AI agents that run anywhere.",
   "keywords": [
     "agent-framework",
@@ -165,6 +165,11 @@
       "import": "./dist/src/public/channels/slack/index.js",
       "default": "./dist/src/public/channels/slack/index.js"
     },
+    "./channels/github": {
+      "types": "./dist/src/public/channels/github/index.d.ts",
+      "import": "./dist/src/public/channels/github/index.js",
+      "default": "./dist/src/public/channels/github/index.js"
+    },
     "./channels/discord": {
       "types": "./dist/src/public/channels/discord/index.d.ts",
       "import": "./dist/src/public/channels/discord/index.js",