experimental-ash 0.16.3 → 0.18.0

package/dist/src/compiler/manifest.d.ts

@@ -80,11 +80,6 @@ export type CompiledInstructions = z.infer<typeof compiledInstructionsSchema>;
  * Normalized authored skill preserved in the compiled manifest.
  */
 export type CompiledSkillDefinition = InternalSkillDefinition & (Omit<MarkdownSourceRef<undefined>, "definition"> | ModuleSourceRef | SkillPackageSourceRef);
-/**
- * Compiled channel target reference produced by `receive(channel, args)`
- * on the authored schedule definition.
- */
-export type CompiledScheduleChannelRef = z.infer<typeof compiledScheduleChannelRefSchema>;
 /**
  * Normalized authored schedule preserved in the compiled manifest.
  */
@@ -162,19 +157,12 @@ declare const compiledInstructionsSchema: z.ZodObject<{
     sourceId: z.ZodString;
     sourceKind: z.ZodUnion<readonly [z.ZodLiteral<"markdown">, z.ZodLiteral<"module">]>;
 }, z.core.$strict>;
-declare const compiledScheduleChannelRefSchema: z.ZodObject<{
-    name: z.ZodString;
-    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-}, z.core.$strict>;
 declare const compiledScheduleDefinitionSchema: z.ZodObject<{
-    channel: z.ZodOptional<z.ZodObject<{
-        name: z.ZodString;
-        args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-    }, z.core.$strict>>;
     cron: z.ZodString;
+    hasRun: z.ZodBoolean;
     name: z.ZodString;
     logicalPath: z.ZodString;
-    markdown: z.ZodString;
+    markdown: z.ZodOptional<z.ZodString>;
     sourceId: z.ZodString;
     sourceKind: z.ZodUnion<readonly [z.ZodLiteral<"markdown">, z.ZodLiteral<"module">]>;
 }, z.core.$strict>;
@@ -247,14 +235,11 @@ export declare const compiledAgentNodeManifestSchema: z.ZodObject<{
         sourcePath: z.ZodString;
     }, z.core.$strict>>;
     schedules: z.ZodArray<z.ZodObject<{
-        channel: z.ZodOptional<z.ZodObject<{
-            name: z.ZodString;
-            args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-        }, z.core.$strict>>;
         cron: z.ZodString;
+        hasRun: z.ZodBoolean;
         name: z.ZodString;
         logicalPath: z.ZodString;
-        markdown: z.ZodString;
+        markdown: z.ZodOptional<z.ZodString>;
         sourceId: z.ZodString;
         sourceKind: z.ZodUnion<readonly [z.ZodLiteral<"markdown">, z.ZodLiteral<"module">]>;
     }, z.core.$strict>>;
@@ -321,14 +306,11 @@ export declare const compiledAgentManifestSchema: z.ZodObject<{
         sourcePath: z.ZodString;
     }, z.core.$strict>>;
     schedules: z.ZodArray<z.ZodObject<{
-        channel: z.ZodOptional<z.ZodObject<{
-            name: z.ZodString;
-            args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-        }, z.core.$strict>>;
         cron: z.ZodString;
+        hasRun: z.ZodBoolean;
         name: z.ZodString;
         logicalPath: z.ZodString;
-        markdown: z.ZodString;
+        markdown: z.ZodOptional<z.ZodString>;
         sourceId: z.ZodString;
         sourceKind: z.ZodUnion<readonly [z.ZodLiteral<"markdown">, z.ZodLiteral<"module">]>;
     }, z.core.$strict>>;

package/dist/src/compiler/manifest.js

@@ -127,19 +127,13 @@ const compiledSkillSourceSchema = z.discriminatedUnion("sourceKind", [
     })
         .strict(),
 ]);
-const compiledScheduleChannelRefSchema = z
-    .object({
-    name: z.string(),
-    args: z.record(z.string(), z.unknown()),
-})
-    .strict();
 const compiledScheduleDefinitionSchema = z
     .object({
-    channel: compiledScheduleChannelRefSchema.optional(),
     cron: z.string(),
+    hasRun: z.boolean(),
     name: z.string(),
     logicalPath: z.string(),
-    markdown: z.string(),
+    markdown: z.string().optional(),
     sourceId: z.string(),
     sourceKind: z.union([z.literal("markdown"), z.literal("module")]),
 })

package/dist/src/compiler/normalize-channel.d.ts

@@ -1,6 +1,5 @@
 import type { ChannelSourceRef } from "#discover/manifest.js";
 import type { CompiledChannelEntry } from "#compiler/manifest.js";
-import type { ChannelRouteIdentityMap } from "#compiler/normalize-schedule.js";
 /**
  * Compiles one authored channel module into the normalized channel
  * entries stored on the compiled agent manifest.
@@ -15,10 +14,3 @@ import type { ChannelRouteIdentityMap } from "#compiler/normalize-schedule.js";
  * the filesystem path; the URL path comes from the route's `path` field.
  */
 export declare function compileChannelDefinition(agentRoot: string, source: ChannelSourceRef): Promise<CompiledChannelEntry | readonly CompiledChannelEntry[]>;
-/**
- * Loads all channel modules and builds a map from route object identity
- * to channel name. Schedule modules import channels, so by the time a
- * schedule is compiled the channel module is already in Node's module
- * cache — the route object the schedule sees is the same instance.
- */
-export declare function buildChannelRouteIdentityMap(agentRoot: string, channels: readonly ChannelSourceRef[]): Promise<ChannelRouteIdentityMap>;

package/dist/src/compiler/normalize-channel.js

@@ -1,7 +1,5 @@
-import { join, resolve } from "node:path";
 import { stripLogicalPathExtension } from "#discover/filesystem.js";
 import { normalizeChannelDefinition } from "#internal/authored-definition/channel.js";
-import { registerChannelModuleInCache } from "#internal/authored-module-loader.js";
 import { isDisabledRouteSentinel } from "#public/definitions/channel.js";
 import { loadModuleBackedDefinition } from "#compiler/normalize-helpers.js";
 /**
@@ -51,28 +49,3 @@ function extractAdapterKind(adapter) {
     const kind = adapter.kind;
     return typeof kind === "string" && kind.length > 0 ? kind : undefined;
 }
-/**
- * Loads all channel modules and builds a map from route object identity
- * to channel name. Schedule modules import channels, so by the time a
- * schedule is compiled the channel module is already in Node's module
- * cache — the route object the schedule sees is the same instance.
- */
-export async function buildChannelRouteIdentityMap(agentRoot, channels) {
-    const map = new Map();
-    for (const source of channels) {
-        const rawValue = await loadModuleBackedDefinition({
-            agentRoot,
-            kind: "channel",
-            source,
-        });
-        if (isDisabledRouteSentinel(rawValue))
-            continue;
-        const channelName = stripLogicalPathExtension(source.logicalPath).replace(/^channels\//, "");
-        if (typeof rawValue === "object" && rawValue !== null) {
-            map.set(rawValue, channelName);
-            const absolutePath = resolve(join(agentRoot, source.logicalPath));
-            registerChannelModuleInCache(absolutePath, rawValue);
-        }
-    }
-    return map;
-}

package/dist/src/compiler/normalize-manifest.js

@@ -7,7 +7,6 @@ import { compileHookEntry } from "#compiler/normalize-hook.js";
 import { compileSandboxDefinition } from "#compiler/normalize-sandbox.js";
 import { compileInstructions } from "#compiler/normalize-instructions.js";
 import { compileScheduleDefinition } from "#compiler/normalize-schedule.js";
-import { buildChannelRouteIdentityMap } from "#compiler/normalize-channel.js";
 import { compileSkillSource } from "#compiler/normalize-skill.js";
 import { compileSubagentGraph } from "#compiler/normalize-subagent.js";
 import { compileToolEntry } from "#compiler/normalize-tool.js";
@@ -46,14 +45,7 @@ async function compileAgentNodeManifest(manifest, context) {
             disabledFrameworkTools.push(entry.name);
         }
     }
-    // Channels must be loaded before schedules because schedule modules
-    // import channel modules to get typed receive args. Loading channels
-    // first populates Node's module cache so the schedule sees the same
-    // route object instance the identity map was built from.
-    const [compiledChannelResults, channelRouteIdentityMap] = await Promise.all([
-        Promise.all(manifest.channels.map((channelSource) => compileChannelDefinition(manifest.agentRoot, channelSource))),
-        buildChannelRouteIdentityMap(manifest.agentRoot, manifest.channels),
-    ]);
+    const compiledChannelResults = await Promise.all(manifest.channels.map((channelSource) => compileChannelDefinition(manifest.agentRoot, channelSource)));
     // compileChannelDefinition returns a single entry for old-style routes
     // or an array of entries for CompiledChannel (one per route). Flatten.
     const compiledChannels = compiledChannelResults.flat();
@@ -75,7 +67,7 @@ async function compileAgentNodeManifest(manifest, context) {
             sourceId: workspace.sourceId,
             sourcePath: workspace.sourcePath,
         })),
-        schedules: await Promise.all(manifest.schedules.map((scheduleSource) => compileScheduleDefinition(manifest.agentRoot, scheduleSource, channelRouteIdentityMap))),
+        schedules: await Promise.all(manifest.schedules.map((scheduleSource) => compileScheduleDefinition(manifest.agentRoot, scheduleSource))),
         skills: await Promise.all(manifest.skills.map((skillSource) => compileSkillSource(manifest.agentRoot, skillSource))),
         instructions: manifest.instructions === undefined
             ? undefined

package/dist/src/compiler/normalize-schedule.d.ts

@@ -1,20 +1,14 @@
 import type { ScheduleSourceRef } from "#discover/manifest.js";
 import type { CompiledScheduleDefinition } from "#compiler/manifest.js";
-/**
- * Identity map from route objects to channel names. Built by the
- * manifest compiler after loading channel modules so schedule modules
- * (which import channels) can resolve channel names at compile time.
- */
-export type ChannelRouteIdentityMap = Map<object, string>;
 /**
  * Compiles one authored schedule into the normalized shape consumed by
  * the runtime scheduler.
  *
- * Schedules are single files: `schedules/<name>.{ts,md}`. The TS form
- * may declare an optional `channel` (a route object resolved through the
- * identity map); the markdown form never declares a channel. The
- * schedule name is derived from the relative file path under
- * `schedules/` minus the extension
+ * Schedules are single files: `schedules/<name>.{ts,md}`. The markdown
+ * form always produces a fire-and-forget schedule (`markdown` body, no
+ * `run`). The TypeScript form may declare either `markdown` or `run`
+ * (exactly one). The schedule name is derived from the relative file
+ * path under `schedules/` minus the extension
  * (`schedules/billing/invoice-sweep.ts` → `"billing/invoice-sweep"`).
  */
-export declare function compileScheduleDefinition(agentRoot: string, source: ScheduleSourceRef, channelIdentityMap: ChannelRouteIdentityMap): Promise<CompiledScheduleDefinition>;
+export declare function compileScheduleDefinition(agentRoot: string, source: ScheduleSourceRef): Promise<CompiledScheduleDefinition>;

package/dist/src/compiler/normalize-schedule.js

@@ -5,14 +5,14 @@ import { loadModuleBackedDefinition } from "#compiler/normalize-helpers.js";
  * Compiles one authored schedule into the normalized shape consumed by
  * the runtime scheduler.
  *
- * Schedules are single files: `schedules/<name>.{ts,md}`. The TS form
- * may declare an optional `channel` (a route object resolved through the
- * identity map); the markdown form never declares a channel. The
- * schedule name is derived from the relative file path under
- * `schedules/` minus the extension
+ * Schedules are single files: `schedules/<name>.{ts,md}`. The markdown
+ * form always produces a fire-and-forget schedule (`markdown` body, no
+ * `run`). The TypeScript form may declare either `markdown` or `run`
+ * (exactly one). The schedule name is derived from the relative file
+ * path under `schedules/` minus the extension
  * (`schedules/billing/invoice-sweep.ts` → `"billing/invoice-sweep"`).
  */
-export async function compileScheduleDefinition(agentRoot, source, channelIdentityMap) {
+export async function compileScheduleDefinition(agentRoot, source) {
     const definition = source.sourceKind === "markdown"
         ? normalizeScheduleDefinition(source.definition, `Expected the compiled schedule definition at "${source.logicalPath}" to match the public Ash shape.`)
         : normalizeScheduleDefinition(await loadModuleBackedDefinition({
@@ -22,40 +22,17 @@ export async function compileScheduleDefinition(agentRoot, source, channelIdenti
         }), `Expected the schedule export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public Ash shape.`);
     const compiled = {
         cron: definition.cron,
+        hasRun: definition.run !== undefined,
         logicalPath: source.logicalPath,
-        markdown: definition.markdown.trim(),
         name: deriveScheduleName(source.logicalPath),
         sourceId: source.sourceId,
         sourceKind: source.sourceKind,
     };
-    if (definition.channel !== undefined) {
-        compiled.channel = resolveScheduleChannel({
-            channel: definition.channel,
-            channelIdentityMap,
-            logicalPath: source.logicalPath,
-        });
+    if (definition.markdown !== undefined) {
+        return { ...compiled, markdown: definition.markdown.trim() };
     }
     return compiled;
 }
-function resolveScheduleChannel(input) {
-    const channelRef = input.channel;
-    const routeObject = channelRef.__route ?? channelRef;
-    const channelArgs = channelRef.args ?? {};
-    // Resolve the channel name:
-    // 1. Route object identity via __route — the channel-identity
-    //    plugin ensures the route object matches the identity map.
-    // 2. Plain { name, args } fallback for test fixtures.
-    let channelName = input.channelIdentityMap.get(routeObject);
-    if (!channelName && typeof channelRef.name === "string") {
-        channelName = channelRef.name;
-    }
-    if (!channelName) {
-        throw new Error(`Schedule at "${input.logicalPath}" references a channel that was not ` +
-            `discovered in agent/channels/. Import a channel module or pass ` +
-            `{ name: "<channel-name>", args: { ... } } as the channel field.`);
-    }
-    return { name: channelName, args: channelArgs };
-}
 function deriveScheduleName(logicalPath) {
     return stripLogicalPathExtension(logicalPath).replace(/^schedules\//, "");
 }

package/dist/src/evals/cli/eval.js

@@ -1 +1 @@
-import{n as e}from"../../chunks/paths-KCBJzXn2.js";import{loadDevelopmentEnvironmentFiles as t}from"../../cli/dev/environment.js";import{a as n,n as r,t as i}from"../../chunks/client-BeZ_W7vl.js";import{n as a}from"../../chunks/host-C83crl7k.js";import{discoverAndImportSuites as o,discoverSuiteFiles as s,importSuiteFile as c}from"../runner/discover.js";import{executeSuite as l}from"../runner/execute-suite.js";import{ConsoleReporter as u}from"../runner/reporters/console.js";var d=n();function f(e,t){e.command(`eval`).description(`Run eval suites against an Ash agent.`).option(`--suite <id...>`,`Suite IDs to run (repeatable)`).option(`--all`,`Run all discovered suites`).option(`--url <url>`,`Remote agent URL (skip local host startup)`).option(`--timeout <ms>`,`Per-case timeout in milliseconds`).option(`--max-concurrency <n>`,`Max concurrent case executions per suite`).option(`--json`,`Output results as JSON`).option(`--list-suites`,`List discovered suites and exit`).option(`--skip-report`,`Skip suite-defined reporters (e.g. Braintrust)`).action(async e=>{await p(e,t)})}async function p(n,r){let i=e();if(t(i),n.listSuites){await y(i,r);return}let s=n.suite,c=await o(i,s);if(c.length===0){s&&s.length>0?r.error(`No suites found matching: ${s.join(`, `)}`):r.error(`No eval suites found. Create suite files under evals/ with the *.eval.ts extension.`),process.exitCode=1;return}let u,d;n.url?d={kind:`remote`,url:n.url}:(u=await a(i,{host:`127.0.0.1`,port:0}),d={kind:`local`,url:u.url});let f=m(d);try{let e=[];for(let t of c){let r=_(t,n),a=v(r,{json:n.json===!0,skipReport:n.skipReport===!0}),o=await l({suite:r,target:d,reporters:a,appRoot:i,client:f});e.push(o)}n.json&&r.log(JSON.stringify(e,null,2)),e.some(e=>e.errored>0)&&(process.exitCode=1)}finally{u&&await u.close()}process.exit(process.exitCode??0)}function m(e){if(e.kind===`local`)return new i({host:e.url});let t={},n=process.env.VERCEL_AUTOMATION_BYPASS_SECRET?.trim();return n&&(t[r]=n),new i({auth:h(),headers:Object.keys(t).length>0?t:void 0,host:e.url})}function h(){let e=process.env.ASH_EVAL_AUTH_TOKEN?.trim();return e?{bearer:e}:{bearer:g}}async function g(){try{let e=(await(0,d.getVercelOidcToken)()).trim();if(e.length>0)return e}catch{}return process.env.VERCEL_OIDC_TOKEN?.trim()??``}function _(e,t){let n=t.maxConcurrency?Number.parseInt(t.maxConcurrency,10):void 0,r=t.timeout?Number.parseInt(t.timeout,10):void 0;if(n===void 0&&r===void 0)return e;let i={...e};return n!==void 0&&(i.maxConcurrency=n),r!==void 0&&(i.timeoutMs=r),i}function v(e,t){let n=t.json?[]:[new u];return!t.skipReport&&e.reporters&&n.push(...e.reporters),n}async function y(e,t){let n=await s(e);if(n.length===0){t.log(`No eval suites found.`);return}t.log(`Found ${n.length} eval suite file(s):\n`);for(let r of n){let n=await c(e,r);t.log(`  ${n.id}${n.description?`  - ${n.description}`:``}`)}}export{f as registerEvalCommand,p as runEvalCommand};
+import{n as e}from"../../chunks/paths-CvbqpwTh.js";import{loadDevelopmentEnvironmentFiles as t}from"../../cli/dev/environment.js";import{a as n,n as r,t as i}from"../../chunks/client-BeZ_W7vl.js";import{n as a}from"../../chunks/host-CIU0NATc.js";import{discoverAndImportSuites as o,discoverSuiteFiles as s,importSuiteFile as c}from"../runner/discover.js";import{executeSuite as l}from"../runner/execute-suite.js";import{ConsoleReporter as u}from"../runner/reporters/console.js";var d=n();function f(e,t){e.command(`eval`).description(`Run eval suites against an Ash agent.`).option(`--suite <id...>`,`Suite IDs to run (repeatable)`).option(`--all`,`Run all discovered suites`).option(`--url <url>`,`Remote agent URL (skip local host startup)`).option(`--timeout <ms>`,`Per-case timeout in milliseconds`).option(`--max-concurrency <n>`,`Max concurrent case executions per suite`).option(`--json`,`Output results as JSON`).option(`--list-suites`,`List discovered suites and exit`).option(`--skip-report`,`Skip suite-defined reporters (e.g. Braintrust)`).action(async e=>{await p(e,t)})}async function p(n,r){let i=e();if(t(i),n.listSuites){await y(i,r);return}let s=n.suite,c=await o(i,s);if(c.length===0){s&&s.length>0?r.error(`No suites found matching: ${s.join(`, `)}`):r.error(`No eval suites found. Create suite files under evals/ with the *.eval.ts extension.`),process.exitCode=1;return}let u,d;n.url?d={kind:`remote`,url:n.url}:(u=await a(i,{host:`127.0.0.1`,port:0}),d={kind:`local`,url:u.url});let f=m(d);try{let e=[];for(let t of c){let r=_(t,n),a=v(r,{json:n.json===!0,skipReport:n.skipReport===!0}),o=await l({suite:r,target:d,reporters:a,appRoot:i,client:f});e.push(o)}n.json&&r.log(JSON.stringify(e,null,2)),e.some(e=>e.errored>0)&&(process.exitCode=1)}finally{u&&await u.close()}process.exit(process.exitCode??0)}function m(e){if(e.kind===`local`)return new i({host:e.url});let t={},n=process.env.VERCEL_AUTOMATION_BYPASS_SECRET?.trim();return n&&(t[r]=n),new i({auth:h(),headers:Object.keys(t).length>0?t:void 0,host:e.url})}function h(){let e=process.env.ASH_EVAL_AUTH_TOKEN?.trim();return e?{bearer:e}:{bearer:g}}async function g(){try{let e=(await(0,d.getVercelOidcToken)()).trim();if(e.length>0)return e}catch{}return process.env.VERCEL_OIDC_TOKEN?.trim()??``}function _(e,t){let n=t.maxConcurrency?Number.parseInt(t.maxConcurrency,10):void 0,r=t.timeout?Number.parseInt(t.timeout,10):void 0;if(n===void 0&&r===void 0)return e;let i={...e};return n!==void 0&&(i.maxConcurrency=n),r!==void 0&&(i.timeoutMs=r),i}function v(e,t){let n=t.json?[]:[new u];return!t.skipReport&&e.reporters&&n.push(...e.reporters),n}async function y(e,t){let n=await s(e);if(n.length===0){t.log(`No eval suites found.`);return}t.log(`Found ${n.length} eval suite file(s):\n`);for(let r of n){let n=await c(e,r);t.log(`  ${n.id}${n.description?`  - ${n.description}`:``}`)}}export{f as registerEvalCommand,p as runEvalCommand};

package/dist/src/evals/runner/discover.js

@@ -1 +1 @@
-import{t as e}from"../../chunks/authored-module-loader-Pt_g8xX2.js";import{join as t,relative as n}from"node:path";import{readdir as r}from"node:fs/promises";const i=`.eval.ts`;async function a(e){let r=t(e,`evals`),i=[];try{await u(r,i)}catch(e){if(d(e))return[];throw e}return i.sort((e,t)=>n(r,e).localeCompare(n(r,t))),i}function o(e,r){let a=n(t(e,`evals`),r).split(/[\\/]/u).join(`/`);return a.endsWith(i)?a.slice(0,-8):a}async function s(t,n){let r=(await e(n)).default;if(!l(r))throw Error(`Suite file "${n}" does not export a valid AshEvalSuite as its default export. Use defineEvalSuite() to create the suite.`);return{...r,id:o(t,n)}}async function c(e,t){let n=await a(e);if(n.length===0)return[];let r=[];for(let i of n){let n=await s(e,i);(t===void 0||t.length===0||t.includes(n.id))&&r.push(n)}return r}function l(e){return typeof e==`object`&&!!e&&`_tag`in e&&e._tag===`AshEvalSuite`}async function u(e,n){let a=await r(e,{withFileTypes:!0});for(let r of a){let a=t(e,r.name);r.isDirectory()?await u(a,n):r.isFile()&&r.name.endsWith(i)&&n.push(a)}}function d(e){return typeof e==`object`&&!!e&&`code`in e&&e.code===`ENOENT`}export{o as deriveSuiteId,c as discoverAndImportSuites,a as discoverSuiteFiles,s as importSuiteFile};
+import{t as e}from"../../chunks/authored-module-loader-XcFLnl49.js";import{join as t,relative as n}from"node:path";import{readdir as r}from"node:fs/promises";const i=`.eval.ts`;async function a(e){let r=t(e,`evals`),i=[];try{await u(r,i)}catch(e){if(d(e))return[];throw e}return i.sort((e,t)=>n(r,e).localeCompare(n(r,t))),i}function o(e,r){let a=n(t(e,`evals`),r).split(/[\\/]/u).join(`/`);return a.endsWith(i)?a.slice(0,-8):a}async function s(t,n){let r=(await e(n)).default;if(!l(r))throw Error(`Suite file "${n}" does not export a valid AshEvalSuite as its default export. Use defineEvalSuite() to create the suite.`);return{...r,id:o(t,n)}}async function c(e,t){let n=await a(e);if(n.length===0)return[];let r=[];for(let i of n){let n=await s(e,i);(t===void 0||t.length===0||t.includes(n.id))&&r.push(n)}return r}function l(e){return typeof e==`object`&&!!e&&`_tag`in e&&e._tag===`AshEvalSuite`}async function u(e,n){let a=await r(e,{withFileTypes:!0});for(let r of a){let a=t(e,r.name);r.isDirectory()?await u(a,n):r.isFile()&&r.name.endsWith(i)&&n.push(a)}}function d(e){return typeof e==`object`&&!!e&&`code`in e&&e.code===`ENOENT`}export{o as deriveSuiteId,c as discoverAndImportSuites,a as discoverSuiteFiles,s as importSuiteFile};

package/dist/src/execution/sandbox/bindings/vercel.d.ts

@@ -1,7 +1,7 @@
 import type * as VercelSandboxSdk from "#compiled/@vercel/sandbox/index.js";
 import type { Sandbox as SdkSandbox } from "#compiled/@vercel/sandbox/index.js";
 import type { SandboxBackend } from "#public/definitions/sandbox-backend.js";
-import type { VercelSandbox, VercelSandboxSessionUseOptions } from "#public/sandbox/vercel-sandbox.js";
+import type { VercelSandbox, VercelSandboxBootstrapUseOptions, VercelSandboxSessionUseOptions } from "#public/sandbox/vercel-sandbox.js";
 type VercelSandboxModule = typeof VercelSandboxSdk;
 /**
  * User-controllable subset of `Sandbox.create` parameters.
@@ -18,5 +18,5 @@ export interface CreateVercelSandboxBackendInput {
 /**
  * Creates the Vercel-backed sandbox backend.
  */
-export declare function createVercelSandboxBackend(input?: CreateVercelSandboxBackendInput): SandboxBackend<VercelSandbox, VercelSandboxSessionUseOptions>;
+export declare function createVercelSandboxBackend(input?: CreateVercelSandboxBackendInput): SandboxBackend<VercelSandbox, VercelSandboxBootstrapUseOptions, VercelSandboxSessionUseOptions>;
 export {};

package/dist/src/execution/sandbox/bindings/vercel.js

@@ -119,7 +119,14 @@ async function ensureTemplate(input) {
     await ensureSandboxWorkingDirectory(sandbox, input.createOptions);
     const templateSession = buildSandboxSession(createVercelInternalSandboxSession(sandbox, input.templateKey));
     if (input.bootstrap !== undefined) {
-        await input.bootstrap({ use: async () => templateSession });
+        await input.bootstrap({
+            use: async (options) => {
+                if (options !== undefined) {
+                    await sandbox.update(options);
+                }
+                return templateSession;
+            },
+        });
     }
     for (const file of input.seedFiles) {
         if (typeof file.content === "string") {

package/dist/src/internal/application/package.js

@@ -6,7 +6,7 @@ import { ASH_PACKAGE_NAME } from "#package-name.js";
 let cachedPackageInfo;
 // The package build stamps the published version into `dist` so bundled
 // deployments can still report package metadata without resolving package.json.
-const BUNDLED_FALLBACK_PACKAGE_VERSION = "0.16.3";
+const BUNDLED_FALLBACK_PACKAGE_VERSION = "0.18.0";
 const BUNDLED_FALLBACK_PACKAGE_VERSION_PLACEHOLDER = "__ASH_PACKAGE_VERSION_PLACEHOLDER__";
 const WORKFLOW_MODULE_ALIASES = {
     "workflow/api": "src/compiled/@workflow/core/runtime.js",

package/dist/src/internal/authored-definition/core.d.ts

@@ -36,8 +36,9 @@ export declare function normalizeSkillDefinition(value: unknown, message: string
  * shape.
  *
  * Authored `name` fields are rejected — schedule identity is derived from
- * the file path under `agent/schedules/`. The `channel` field is optional;
- * a schedule without a channel runs the agent and discards its output.
+ * the file path under `agent/schedules/`. Exactly one of `markdown` (the
+ * fire-and-forget agent prompt) or `run` (the cron handler function)
+ * must be provided.
  */
 export declare function normalizeScheduleDefinition(value: unknown, message: string): ScheduleDefinition;
 export {};

package/dist/src/internal/authored-definition/core.js

@@ -1,4 +1,4 @@
-import { expectObjectRecord, expectOnlyKnownKeys, expectProviderOptions, expectString, getOptionalStringRecordProperty, } from "#internal/authored-module.js";
+import { expectFunction, expectObjectRecord, expectOnlyKnownKeys, expectProviderOptions, expectString, getOptionalStringRecordProperty, } from "#internal/authored-module.js";
 /**
  * Normalizes one authored agent definition into the canonical internal shape.
  *
@@ -138,18 +138,28 @@ export function normalizeSkillDefinition(value, message) {
  * shape.
  *
  * Authored `name` fields are rejected — schedule identity is derived from
- * the file path under `agent/schedules/`. The `channel` field is optional;
- * a schedule without a channel runs the agent and discards its output.
+ * the file path under `agent/schedules/`. Exactly one of `markdown` (the
+ * fire-and-forget agent prompt) or `run` (the cron handler function)
+ * must be provided.
  */
 export function normalizeScheduleDefinition(value, message) {
     const record = expectObjectRecord(value, message);
-    expectOnlyKnownKeys(record, ["channel", "cron", "markdown"], message);
-    const definition = {
-        cron: expectString(record.cron, message),
-        markdown: expectString(record.markdown, message),
-    };
-    if (record.channel !== undefined && record.channel !== null) {
-        definition.channel = record.channel;
+    expectOnlyKnownKeys(record, ["cron", "markdown", "run"], message);
+    const cron = expectString(record.cron, message);
+    const hasMarkdown = record.markdown !== undefined;
+    const hasRun = record.run !== undefined;
+    if (hasMarkdown && hasRun) {
+        throw new Error(`${message} Pass either "markdown" (fire-and-forget) or "run" (handler) — not both.`);
+    }
+    if (!hasMarkdown && !hasRun) {
+        throw new Error(`${message} Must provide either "markdown" (fire-and-forget) or "run" (handler).`);
+    }
+    const definition = { cron };
+    if (hasMarkdown) {
+        definition.markdown = expectString(record.markdown, message);
+    }
+    else {
+        definition.run = expectFunction(record.run, message);
     }
     return definition;
 }

package/dist/src/internal/authored-module-loader.d.ts

@@ -1,9 +1,3 @@
-/**
- * Registers a loaded channel module in the global cache so Rolldown-
- * bundled schedule modules that import the same channel get the exact
- * same route object instance.
- */
-export declare function registerChannelModuleInCache(absolutePath: string, moduleDefault: unknown): void;
 /**
  * Loads one authored module namespace from disk during compile-time
  * discovery. Concurrent loads of the same `modulePath` share a single

package/dist/src/internal/authored-module-loader.js

@@ -17,42 +17,22 @@ const RESOLVE_EXTENSIONS = [
     ".cjs",
     ".json",
 ];
-const CHANNEL_MODULE_CACHE_KEY = "__ashChannelModuleCache__";
-const CACHED_CHANNEL_PREFIX = "ash-cached-channel:";
-/**
- * Registers a loaded channel module in the global cache so Rolldown-
- * bundled schedule modules that import the same channel get the exact
- * same route object instance.
- */
-export function registerChannelModuleInCache(absolutePath, moduleDefault) {
-    const cache = (globalThis[CHANNEL_MODULE_CACHE_KEY] ??= new Map());
-    cache.set(resolve(absolutePath), moduleDefault);
-}
-function getChannelModuleCache() {
-    return globalThis[CHANNEL_MODULE_CACHE_KEY];
-}
 /**
  * In-flight load deduplication map keyed by the absolute module path.
  *
- * The compiler walks every authored slot concurrently
- * (`compileChannelDefinition` and `buildChannelRouteIdentityMap` both
- * load the same channel module via `Promise.all`), so the same module
- * path is frequently loaded twice in parallel. Without dedup, both
- * callers race the bundler write/import pipeline against the
- * same `node_modules/.cache/.../<hash>.mjs` file: one call's
- * `writeFile` can truncate the bundle while another's `import()` is
- * still resolving it, surfacing as intermittent
+ * The compiler walks every authored slot concurrently via `Promise.all`,
+ * so the same module path is frequently loaded twice in parallel.
+ * Without dedup, both callers race the bundler write/import pipeline
+ * against the same `node_modules/.cache/.../<hash>.mjs` file: one
+ * call's `writeFile` can truncate the bundle while another's `import()`
+ * is still resolving it, surfacing as intermittent
  * "Expected … to match the public Ash shape" failures during
  * compilation.
  *
  * The map only holds in-flight promises; once a load settles the entry
- * is cleared so subsequent compiles (e.g. a dev-server reload after
- * the author edits a file) re-run the bundle pipeline against the
- * fresh source. Node's ESM cache then dedupes by content-hashed URL
- * for unchanged files. The companion "skip write when the cache file
- * already exists" check inside {@link loadBundledAuthoredModule}
- * eliminates the write/read race even when two non-concurrent compile
- * passes overlap on the same hashed bundle path.
+ * is cleared so subsequent compiles re-run the bundle pipeline against
+ * the fresh source. Node's ESM cache then dedupes by content-hashed
+ * URL for unchanged files.
  */
 const inFlightModuleLoads = new Map();
 /**
@@ -94,52 +74,15 @@ function createFileImportSpecifier(modulePath) {
     return normalizedPath;
 }
 async function loadBundledAuthoredModule(modulePath) {
-    const channelCache = getChannelModuleCache();
     const packageRoot = resolveAuthoredPackageRoot(modulePath);
     const tsconfigPath = join(packageRoot, "tsconfig.json");
     const tsconfigPathAliasPlugin = createTsconfigPathAliasPlugin({
         tsconfigPath,
     });
-    const channelIdentityPlugin = channelCache && channelCache.size > 0
-        ? {
-            name: "ash-channel-identity",
-            async resolveId(source, importer, options) {
-                if (!/channels[/\\]/.test(source) || options.kind !== "import-statement") {
-                    return undefined;
-                }
-                const resolved = await this.resolve(source, importer, {
-                    kind: options.kind,
-                    skipSelf: true,
-                });
-                if (resolved === null || typeof resolved.id !== "string") {
-                    return undefined;
-                }
-                const resolvedPath = resolve(resolved.id);
-                if (!channelCache.has(resolvedPath)) {
-                    return undefined;
-                }
-                return { id: `${CACHED_CHANNEL_PREFIX}${resolvedPath}` };
-            },
-            load(id) {
-                if (!id.startsWith(CACHED_CHANNEL_PREFIX)) {
-                    return undefined;
-                }
-                const cachedPath = id.slice(CACHED_CHANNEL_PREFIX.length);
-                return {
-                    code: [
-                        `const cache = globalThis["${CHANNEL_MODULE_CACHE_KEY}"];`,
-                        `export default cache.get(${JSON.stringify(cachedPath)});`,
-                    ].join("\n"),
-                    moduleType: "js",
-                };
-            },
-        }
-        : null;
     const plugins = [
         createNodeEsmCompatBannerPlugin({ includeRequire: true }),
         createPackageBoundaryPlugin(packageRoot),
         tsconfigPathAliasPlugin,
-        channelIdentityPlugin,
     ].filter((plugin) => plugin !== null);
     const result = await buildWithNitroRolldown({
         cwd: packageRoot,
@@ -190,11 +133,7 @@ function createPackageBoundaryPlugin(packageRoot) {
                     id: source,
                 };
             }
-            const importerPath = importer === undefined ||
-                importer.startsWith("\0") ||
-                importer.startsWith(CACHED_CHANNEL_PREFIX)
-                ? undefined
-                : resolve(importer);
+            const importerPath = importer === undefined || importer.startsWith("\0") ? undefined : resolve(importer);
             // Keep package imports authored directly by the app external by
             // default, but let symlinked/file workspace packages compile as
             // source. Those packages often export `.ts` files and rely on the
@@ -316,7 +255,7 @@ function isPackageImport(source) {
     if (source.startsWith("@/")) {
         return false;
     }
-    return !source.startsWith(CACHED_CHANNEL_PREFIX);
+    return true;
 }
 function isAshFrameworkImport(source) {
     return source === "experimental-ash" || source.startsWith("experimental-ash/");

package/dist/src/internal/nitro/routes/agent-info/build-agent-info-response.js

@@ -65,7 +65,9 @@ function renderScheduleRows(schedules) {
         cron: schedule.cron,
         logicalPath: schedule.logicalPath,
         name: schedule.name,
-        preview: truncateCopy(schedule.markdown.trim(), 220),
+        preview: schedule.markdown
+            ? truncateCopy(schedule.markdown.trim(), 220)
+            : "(handler-based schedule)",
     }));
 }
 function renderSubagentRows(manifest) {

package/dist/src/internal/nitro/routes/channel-dispatch.js

@@ -1,3 +1,4 @@
+import { createCrossChannelReceiveFn } from "#channel/cross-channel-receive.js";
 import { createSendFn } from "#channel/send.js";
 import { createGetSessionFn } from "#channel/session.js";
 import { resolveNitroChannelRuntimeBundle } from "#internal/nitro/routes/runtime-stack.js";
@@ -40,9 +41,11 @@ export async function dispatchChannelRequest(event, routeKey, config) {
         const adapter = matchedChannel.adapter ?? { kind: "channel" };
         const send = createSendFn(bundle.runtime, adapter, matchedChannel.name);
         const getSession = createGetSessionFn(bundle.runtime);
+        const receive = createCrossChannelReceiveFn(bundle.runtime, bundle.channels);
         const args = {
             send,
             getSession,
+            receive,
             params,
             waitUntil,
             requestIp,

package/dist/src/internal/nitro/routes/runtime-stack.d.ts

@@ -1,4 +1,3 @@
-import { ScheduleDispatcher } from "#channel/schedule.js";
 import type { Runtime } from "#channel/types.js";
 import type { ResolvedChannelDefinition } from "#runtime/types.js";
 import { type NitroArtifactsConfig } from "#internal/nitro/routes/runtime-artifacts.js";
@@ -25,13 +24,3 @@ export interface NitroChannelRuntimeBundle {
  * compiled bundle on each request.
  */
 export declare function resolveNitroChannelRuntimeBundle(config: NitroArtifactsConfig): Promise<NitroChannelRuntimeBundle>;
-/**
- * Builds and returns the schedule channel backed by the workflow runtime.
- *
- * Stateless — each cron trigger starts a fresh workflow with a unique
- * continuation token. Schedule channels remain a separate primitive
- * because they are triggered by a Nitro task scheduler rather than an
- * inbound HTTP request and do not fit the per-request `Channel.fetch`
- * shape.
- */
-export declare function resolveNitroScheduleDispatcher(config: NitroArtifactsConfig): ScheduleDispatcher;

package/dist/src/internal/nitro/routes/runtime-stack.js

@@ -1,4 +1,3 @@
-import { ScheduleDispatcher } from "#channel/schedule.js";
 import { createWorkflowRuntime } from "#execution/workflow-runtime.js";
 import { getCompiledRuntimeAgentBundle } from "#runtime/sessions/compiled-agent-cache.js";
 import { resolveNitroCompiledArtifactsSource, } from "#internal/nitro/routes/runtime-artifacts.js";
@@ -22,27 +21,3 @@ export async function resolveNitroChannelRuntimeBundle(config) {
         runtime,
     };
 }
-/**
- * Builds and returns the schedule channel backed by the workflow runtime.
- *
- * Stateless — each cron trigger starts a fresh workflow with a unique
- * continuation token. Schedule channels remain a separate primitive
- * because they are triggered by a Nitro task scheduler rather than an
- * inbound HTTP request and do not fit the per-request `Channel.fetch`
- * shape.
- */
-export function resolveNitroScheduleDispatcher(config) {
-    const compiledArtifactsSource = resolveNitroCompiledArtifactsSource(config);
-    const runtime = createWorkflowRuntime({ compiledArtifactsSource });
-    return new ScheduleDispatcher({
-        runtime,
-        async resolveChannel(channelName) {
-            const bundle = await resolveNitroChannelRuntimeBundle(config);
-            const channel = bundle.channels.find((ch) => ch.name === channelName);
-            if (!channel) {
-                throw new Error(`Channel "${channelName}" not found in agent/channels/.`);
-            }
-            return { receive: channel.receive, adapter: channel.adapter };
-        },
-    });
-}

package/dist/src/internal/nitro/routes/schedule-task.d.ts

@@ -3,10 +3,10 @@ import type { NitroArtifactsConfig } from "#internal/nitro/routes/runtime-artifa
  * Dispatches one Ash authored schedule via the execution engine.
  *
  * Fire-and-forget: the workflow runtime owns terminal completion and
- * its own failure observability. The task return value reports only
- * that the session was dispatched.
+ * its own failure observability. The task return value reports which
+ * session ids the handler started so Nitro / dev tools can correlate.
  */
 export declare function dispatchScheduleTask(taskName: string, config: NitroArtifactsConfig): Promise<{
     scheduleId: string;
-    sessionId: string;
+    sessionIds: readonly string[];
 }>;