experimental-ash 0.3.0-alpha.3 → 0.3.0-alpha.31

package/README.md

@@ -128,4 +128,3 @@ Start here:
 - [`packages/ash/README.md`](packages/ash/README.md) is the package-facing overview
 - [`skills/agent/SKILL.md`](skills/agent/SKILL.md) is the app-authoring skill
 - [`skills/framework/SKILL.md`](skills/framework/SKILL.md) is the internals skill
-

package/bin/ash.d.ts

@@ -15,9 +15,9 @@ export interface BootstrapOptions {
   packageRoot?: string;
 
   /**
-   * Absolute path to the TypeScript CLI entrypoint used for bootstrap builds.
+   * Absolute path to the tsgo CLI entrypoint used for bootstrap builds.
    */
-  tscCliPath?: string;
+  tsgoCliPath?: string;
 }
 
 export interface BootstrapCommandOptions {
@@ -41,6 +41,11 @@ export interface BootstrapCliModule {
 
 export interface BootstrapDependencies extends BootstrapBuildDependencies {
   importModule?: (specifier: string) => Promise<BootstrapCliModule>;
+
+  /**
+   * Node.js version string used by tests to exercise the bin version guard.
+   */
+  nodeVersion?: string;
 }
 
 /**

package/bin/ash.js

@@ -7,6 +7,7 @@ import { dirname, resolve } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 
 const require = createRequire(import.meta.url);
+const minimumNodeMajorVersion = 24;
 
 function createBootstrapOptions(overrides = {}) {
   const packageRoot =
@@ -18,7 +19,7 @@ function createBootstrapOptions(overrides = {}) {
     copyAssetsScriptPath:
       overrides.copyAssetsScriptPath ?? resolve(packageRoot, "scripts", "copy-static-assets.mjs"),
     packageRoot,
-    tscCliPath: overrides.tscCliPath,
+    tsgoCliPath: overrides.tsgoCliPath,
   };
 }
 
@@ -105,8 +106,38 @@ function inputTsconfigPath({ packageRoot }) {
   return resolve(packageRoot, "tsconfig.json");
 }
 
-function resolveTscCliPath({ tscCliPath }) {
-  return tscCliPath ?? require.resolve("typescript/bin/tsc");
+function parseNodeMajorVersion(version) {
+  const match = /^v?(\d+)/.exec(version);
+  return match ? Number(match[1]) : undefined;
+}
+
+function assertSupportedNodeVersion(version = process.version) {
+  const majorVersion = parseNodeMajorVersion(version);
+
+  if (majorVersion !== undefined && majorVersion >= minimumNodeMajorVersion) {
+    return;
+  }
+
+  throw new Error(
+    [
+      `Ash requires Node.js ${minimumNodeMajorVersion} or newer.`,
+      `You are running ${version}.`,
+      "Please upgrade Node.js and try again.",
+    ].join(" "),
+  );
+}
+
+function resolveTsgoCliPath({ tsgoCliPath }) {
+  if (tsgoCliPath) {
+    return tsgoCliPath;
+  }
+
+  // The `@typescript/native-preview` package only exports `./package.json`
+  // in its `exports` map, so `require.resolve("@typescript/native-preview/bin/tsgo.js")`
+  // fails with ERR_PACKAGE_PATH_NOT_EXPORTED. Resolve the package.json
+  // (which is exported) and join to the binary path manually.
+  const packageJsonPath = require.resolve("@typescript/native-preview/package.json");
+  return resolve(dirname(packageJsonPath), "bin", "tsgo.js");
 }
 
 async function runCommand(command, args, options) {
@@ -174,7 +205,7 @@ export async function ensureBuiltCli(overrides = {}, dependencies = {}) {
 
   await executeCommand(
     process.execPath,
-    [resolveTscCliPath({ tscCliPath: options.tscCliPath }), "-p", "tsconfig.json"],
+    [resolveTsgoCliPath({ tsgoCliPath: options.tsgoCliPath }), "-p", "tsconfig.json"],
     {
       cwd: options.packageRoot,
     },
@@ -194,6 +225,8 @@ export async function ensureBuiltCli(overrides = {}, dependencies = {}) {
  * Runs the compiled Ash CLI, building the workspace package on demand when needed.
  */
 export async function runAshCli(argv = process.argv.slice(2), overrides = {}, dependencies = {}) {
+  assertSupportedNodeVersion(dependencies.nodeVersion);
+
   const cliEntrypointPath = await ensureBuiltCli(overrides, dependencies);
   const importModule = dependencies.importModule ?? ((specifier) => import(specifier));
   const cliModule = await importModule(pathToFileURL(cliEntrypointPath).href);
@@ -229,5 +262,11 @@ if (await isDirectExecution()) {
     const message = error instanceof Error ? error.message : String(error);
     console.error(message);
     process.exitCode = 1;
+  } finally {
+    // The CLI bootstraps build/dev toolchains that can leave native service
+    // handles alive after the command has completed. Once the top-level
+    // command resolves, terminate the bin process explicitly so commands like
+    // `ash dev` + `/exit` do not hang on leaked implementation details.
+    process.exit(process.exitCode ?? 0);
   }
 }

package/dist/src/channel/adapter-context.d.ts

@@ -0,0 +1,8 @@
+import type { ContextAccessor } from "../context/key.js";
+import type { ChannelAdapter, ChannelAdapterContext } from "./adapter.js";
+/**
+ * Builds the {@link ChannelAdapterContext} the runtime hands to an
+ * adapter's `deliver` hook, event handlers, and attachment resolver.
+ */
+export declare function buildAdapterContext<TCtx extends ChannelAdapterContext<any> = ChannelAdapterContext>(adapter: ChannelAdapter<TCtx>, accessor: ContextAccessor): TCtx;
+//# sourceMappingURL=adapter-context.d.ts.map

package/dist/src/channel/adapter-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-context.d.ts","sourceRoot":"","sources":["../../../src/channel/adapter-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1E;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,SAAS,qBAAqB,CAAC,GAAG,CAAC,GAAG,qBAAqB,EAC/D,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAahE"}

package/dist/src/channel/adapter-context.js

@@ -0,0 +1,19 @@
+/**
+ * Builds the {@link ChannelAdapterContext} the runtime hands to an
+ * adapter's `deliver` hook, event handlers, and attachment resolver.
+ */
+export function buildAdapterContext(adapter, accessor) {
+    // `adapter.state` is stored loosely (`Record<string, unknown>`)
+    // because it round-trips through JSON at step boundaries. The
+    // adapter is responsible for seeding state in the shape its
+    // `createAdapterContext` / handlers expect, so the cast to the
+    // narrower `TCtx`-derived state is safe at this seam.
+    const baseCtx = {
+        ctx: accessor,
+        state: adapter.state ?? {},
+    };
+    return adapter.createAdapterContext
+        ? adapter.createAdapterContext(baseCtx)
+        : baseCtx;
+}
+//# sourceMappingURL=adapter-context.js.map

package/dist/src/channel/adapter-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-context.js","sourceRoot":"","sources":["../../../src/channel/adapter-context.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAEjC,OAA6B,EAAE,QAAyB;IACxD,gEAAgE;IAChE,8DAA8D;IAC9D,4DAA4D;IAC5D,+DAA+D;IAC/D,sDAAsD;IACtD,MAAM,OAAO,GAAG;QACd,GAAG,EAAE,QAAQ;QACb,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;KACiD,CAAC;IAC9E,OAAO,OAAO,CAAC,oBAAoB;QACjC,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC;QACvC,CAAC,CAAE,OAA2B,CAAC;AACnC,CAAC"}

package/dist/src/channel/adapter.d.ts

@@ -1,6 +1,7 @@
 import type { ContextAccessor } from "../context/key.js";
 import type { ContextProvider } from "../context/provider.js";
 import type { StepInput } from "../harness/types.js";
+import type { AttachmentRef } from "../internal/attachments/refs.js";
 import type { HandleMessageStreamEvent } from "../protocol/message.js";
 import type { DeliverPayload } from "./types.js";
 /**
@@ -24,6 +25,12 @@ export interface ChannelAdapterContext<TState = Record<string, unknown>> {
      */
     readonly ctx: ContextAccessor;
 }
+/**
+ * Extracts the state type from a {@link ChannelAdapterContext} generic.
+ * Used internally so adapter-level types can declare their state shape
+ * once (via `TCtx`) and have helpers narrow consistently.
+ */
+type StateOf<TCtx> = TCtx extends ChannelAdapterContext<infer S> ? S : Record<string, unknown>;
 /**
  * Extracts the `data` field type from a stream event by its `type` discriminant.
  * Events that carry no `data` field (e.g. `session.completed`) resolve to `undefined`.
@@ -47,20 +54,37 @@ export type ChannelEventHandlers<TCtx extends ChannelAdapterContext<any> = Chann
     [K in HandleMessageStreamEvent["type"]]?: EventHandler<K, TCtx>;
 };
 /**
- * Plain-object adapter that replaces the `Channel` abstract class.
+ * Enriched resolver return shape. A resolver can return either a bare
+ * {@link Buffer} or this record when it learns a more accurate
+ * `mediaType` or `filename` mid-fetch (e.g. from an HTTP
+ * `Content-Type` header or a storage-service listing).
  *
- * An adapter carries:
- * - `kind`: stable durable identifier (like the old static `Channel.kind`)
- * - `state`: initial state shape, auto-serialized at step boundaries
- * - `deliver`: inbound hook (side effects + optional message transform)
- * - Event handlers: outbound, keyed by event type name
- * - `contextProviders`: optional per-step virtual providers
+ * When fields are provided, staging prefers them over the values the
+ * channel populated at ingestion time — the resolver is the source of
+ * truth for bytes *and* for anything it discovers while fetching.
+ */
+export interface ResolvedAttachment {
+    readonly bytes: Buffer;
+    readonly mediaType?: string;
+    readonly filename?: string;
+}
+/**
+ * Channel-owned resolver that turns an opaque {@link AttachmentRef} back
+ * into raw bytes.
  *
- * Adapters are created via `defineSlackAdapter`, `defineHttpAdapter`, or
- * directly as plain objects. They are NOT classes — no inheritance, no
- * `serialize()`, no constructor rehydration.
+ * Channels that emit `ash-attachment:` refs provide this so staging can
+ * re-fetch bytes inside a step boundary. Return a bare {@link Buffer} or
+ * a {@link ResolvedAttachment} when fetch-time metadata should override
+ * the original file part.
  */
-export type ChannelAdapter<TCtx extends ChannelAdapterContext<any> = ChannelAdapterContext> = {
+export interface AttachmentResolver<TParams = unknown, TCtx extends ChannelAdapterContext<any> = ChannelAdapterContext> {
+    resolve(ref: AttachmentRef<TParams>, ctx: TCtx): Promise<Buffer | ResolvedAttachment>;
+}
+/**
+ * Plain-object channel adapter with durable state, an optional inbound
+ * delivery hook, event handlers, and optional attachment resolution.
+ */
+export type ChannelAdapter<TCtx extends ChannelAdapterContext<any> = ChannelAdapterContext, TAttachmentParams = unknown> = {
     /**
      * Stable durable identifier for serialization across step boundaries.
      * Must be unique across all adapters visible to one runtime bundle.
@@ -78,17 +102,8 @@ export type ChannelAdapter<TCtx extends ChannelAdapterContext<any> = ChannelAdap
     /**
      * Inbound hook: fires once per delivery before the harness starts.
      *
-     * Side effects (context seeding, thread refresh, custom interactions)
-     * plus optional message transformation. Return a string to override the
-     * message the model sees. Return void to use the original payload message.
-     *
-     * For Slack adapters, the route's base layer runs AFTER this:
-     *   1. Resolves HITL against the ORIGINAL payload.message (not the
-     *      returned string). Matched inputResponses go to the harness and
-     *      the return value is ignored.
-     *   2. If no HITL to resolve, uses the returned string (or
-     *      payload.message if void), prepends user context, and produces
-     *      the StepInput for the harness.
+     * Return a {@link StepInput} to override the input the harness sees, or
+     * return void to use the default payload projection.
      */
     deliver?(payload: DeliverPayload, ctx: TCtx): StepInput | void | Promise<StepInput | void>;
     /**
@@ -102,14 +117,37 @@ export type ChannelAdapter<TCtx extends ChannelAdapterContext<any> = ChannelAdap
     /**
      * Optional factory that builds the adapter context for this adapter.
      *
-     * The runtime calls this before invoking `deliver` or event handlers.
-     * Default returns a bare `ChannelAdapterContext`. Slack adapters override
-     * this to return a `SlackAdapterContext` with `ctx.slack`.
-     *
      * @internal — set by `createSlackBaseAdapter`, not authored by users.
      */
-    readonly createAdapterContext?: (base: ChannelAdapterContext) => ChannelAdapterContext;
+    createAdapterContext?(base: ChannelAdapterContext<StateOf<TCtx>>): TCtx;
+    /**
+     * Optional resolver that turns an opaque {@link AttachmentRef}
+     * produced by this adapter into raw bytes.
+     *
+     * Required only for channels that put `ash-attachment:` URLs into
+     * `FilePart.data`.
+     */
+    readonly attachments?: AttachmentResolver<TAttachmentParams, TCtx>;
+    /**
+     * Derives the continuation token from adapter state.
+     *
+     * The runtime calls this at park time when no explicit
+     * `continuationToken` was provided on {@link RunInput}. Returns
+     * `undefined` when the adapter's state does not yet contain enough
+     * information to form a token (e.g., a Slack adapter whose first
+     * post has not yet created the thread).
+     */
+    getContinuationToken?(): string | undefined;
 } & ChannelEventHandlers<TCtx>;
+/**
+ * Produces the default {@link StepInput} when no custom adapter `deliver`
+ * hook is defined.
+ *
+ * Passes through both `message` and `inputResponses` from the delivery
+ * payload so tool-approval responses (and other HITL replies) reach the
+ * harness even when the channel has no bespoke deliver logic.
+ */
+export declare function defaultDeliverResult(payload: DeliverPayload): StepInput | undefined;
 /**
  * Returns the durable kind for an adapter, falling back to `"unknown"`.
  */
@@ -122,8 +160,8 @@ export declare function getAdapterContextProviders(adapter: ChannelAdapter): rea
  * Calls an adapter's event handler for a given event. Returns the event
  * unchanged (adapters don't transform events — they perform side effects).
  *
- * If the adapter doesn't declare a handler for the event type, this is a
- * no-op and returns the event as-is.
+ * Throwing handlers are logged and swallowed so a downstream delivery
+ * failure does not corrupt the event stream write path.
  */
 export declare function callAdapterEventHandler(adapter: ChannelAdapter, event: HandleMessageStreamEvent, ctx: ChannelAdapterContext): Promise<HandleMessageStreamEvent>;
 export {};

package/dist/src/channel/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/channel/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrE;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;CAC/B;AAMD;;;GAGG;AACH,KAAK,SAAS,CAAC,CAAC,SAAS,wBAAwB,CAAC,MAAM,CAAC,IACvD,OAAO,CAAC,wBAAwB,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,SAAS,CAAC;AAE3F;;;GAGG;AACH,KAAK,YAAY,CACf,CAAC,SAAS,wBAAwB,CAAC,MAAM,CAAC,EAE1C,IAAI,SAAS,qBAAqB,CAAC,GAAG,CAAC,GAAG,qBAAqB,IAC7D,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5D;;;;GAIG;AAEH,MAAM,MAAM,oBAAoB,CAAC,IAAI,SAAS,qBAAqB,CAAC,GAAG,CAAC,GAAG,qBAAqB,IAC9F;KACG,CAAC,IAAI,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC;CAChE,CAAC;AAMJ;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,qBAAqB,CAAC,GAAG,CAAC,GAAG,qBAAqB,IAAI;IAC5F;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC;;;;;;;;;;;;;;OAcG;IAEH,OAAO,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAE3F;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;IAEhE;;;;;;;;OAQG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,qBAAqB,CAAC;CACxF,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;AAM/B;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,cAAc,GACtB,SAAS,eAAe,CAAC,OAAO,CAAC,EAAE,CAErC;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,wBAAwB,EAC/B,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,wBAAwB,CAAC,CAUnC"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/channel/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAQjD;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrE;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;CAC/B;AAED;;;;GAIG;AACH,KAAK,OAAO,CAAC,IAAI,IAAI,IAAI,SAAS,qBAAqB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAM/F;;;GAGG;AACH,KAAK,SAAS,CAAC,CAAC,SAAS,wBAAwB,CAAC,MAAM,CAAC,IACvD,OAAO,CAAC,wBAAwB,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,SAAS,CAAC;AAE3F;;;GAGG;AACH,KAAK,YAAY,CACf,CAAC,SAAS,wBAAwB,CAAC,MAAM,CAAC,EAC1C,IAAI,SAAS,qBAAqB,CAAC,GAAG,CAAC,GAAG,qBAAqB,IAC7D,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5D;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,CAAC,IAAI,SAAS,qBAAqB,CAAC,GAAG,CAAC,GAAG,qBAAqB,IAC9F;KACG,CAAC,IAAI,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC;CAChE,CAAC;AAMJ;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB,CACjC,OAAO,GAAG,OAAO,EACjB,IAAI,SAAS,qBAAqB,CAAC,GAAG,CAAC,GAAG,qBAAqB;IAE/D,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,kBAAkB,CAAC,CAAC;CACvF;AAMD;;;GAGG;AACH,MAAM,MAAM,cAAc,CACxB,IAAI,SAAS,qBAAqB,CAAC,GAAG,CAAC,GAAG,qBAAqB,EAC/D,iBAAiB,GAAG,OAAO,IACzB;IACF;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC;;;;;OAKG;IACH,OAAO,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAE3F;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;IAEhE;;;;OAIG;IACH,oBAAoB,CAAC,CAAC,IAAI,EAAE,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAExE;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;IAEnE;;;;;;;;OAQG;IACH,oBAAoB,CAAC,IAAI,MAAM,GAAG,SAAS,CAAC;CAC7C,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;AAM/B;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,SAAS,CAUnF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,cAAc,GACtB,SAAS,eAAe,CAAC,OAAO,CAAC,EAAE,CAErC;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,wBAAwB,EAC/B,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,wBAAwB,CAAC,CAoBnC"}

package/dist/src/channel/adapter.js

@@ -1,6 +1,25 @@
+import { createLogger } from "../internal/logging.js";
+const log = createLogger("channel.adapter");
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
+/**
+ * Produces the default {@link StepInput} when no custom adapter `deliver`
+ * hook is defined.
+ *
+ * Passes through both `message` and `inputResponses` from the delivery
+ * payload so tool-approval responses (and other HITL replies) reach the
+ * harness even when the channel has no bespoke deliver logic.
+ */
+export function defaultDeliverResult(payload) {
+    if (payload.message !== undefined) {
+        return { inputResponses: payload.inputResponses, message: payload.message };
+    }
+    if (payload.inputResponses !== undefined && payload.inputResponses.length > 0) {
+        return { inputResponses: payload.inputResponses };
+    }
+    return undefined;
+}
 /**
  * Returns the durable kind for an adapter, falling back to `"unknown"`.
  */
@@ -17,14 +36,24 @@ export function getAdapterContextProviders(adapter) {
  * Calls an adapter's event handler for a given event. Returns the event
  * unchanged (adapters don't transform events — they perform side effects).
  *
- * If the adapter doesn't declare a handler for the event type, this is a
- * no-op and returns the event as-is.
+ * Throwing handlers are logged and swallowed so a downstream delivery
+ * failure does not corrupt the event stream write path.
  */
 export async function callAdapterEventHandler(adapter, event, ctx) {
     const handler = adapter[event.type];
-    if (handler !== undefined) {
+    if (handler === undefined) {
+        return event;
+    }
+    try {
         await handler("data" in event ? event.data : undefined, ctx);
     }
+    catch (error) {
+        log.error("adapter event handler threw — event swallowed", {
+            adapterKind: getAdapterKind(adapter),
+            eventType: event.type,
+            error,
+        });
+    }
     return event;
 }
 //# sourceMappingURL=adapter.js.map

package/dist/src/channel/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/channel/adapter.ts"],"names":[],"mappings":"AA4IA,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,OAAO,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAuB;IAEvB,OAAO,OAAO,CAAC,gBAAgB,IAAI,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAuB,EACvB,KAA+B,EAC/B,GAA0B;IAE1B,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAErB,CAAC;IAEd,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/channel/adapter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAItD,MAAM,GAAG,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC;AA+K5C,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAuB;IAC1D,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;IAC9E,CAAC;IAED,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9E,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;IACpD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,OAAO,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAuB;IAEvB,OAAO,OAAO,CAAC,gBAAgB,IAAI,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAuB,EACvB,KAA+B,EAC/B,GAA0B;IAE1B,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAErB,CAAC;IAEd,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,KAAK,CAAC,+CAA+C,EAAE;YACzD,WAAW,EAAE,cAAc,CAAC,OAAO,CAAC;YACpC,SAAS,EAAE,KAAK,CAAC,IAAI;YACrB,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/channel/schedule.d.ts

@@ -1,27 +1,30 @@
+import type { Route } from "../public/definitions/channel.js";
 import type { RunHandle, Runtime } from "./types.js";
 /**
- * Input for triggering a one-shot schedule run.
+ * Input for triggering a schedule run.
  */
 export interface ScheduleTriggerInput {
+    readonly channel: {
+        readonly name: string;
+        readonly args: Readonly<Record<string, unknown>>;
+    };
     readonly markdown: string;
     readonly scheduleId: string;
 }
 /**
- * Dispatcher for one-shot scheduled task execution.
+ * Dispatcher for scheduled task execution.
  *
- * Each trigger generates a unique continuation token so every cron
- * invocation starts a fresh session. Schedule runs always use task
- * mode, so the runtime requires the harness to finish within the
- * current invocation instead of parking for follow-up messages.
- *
- * The dispatcher never touches the compiled bundle, the {@link AshContext},
- * or any execution-layer machinery — it speaks to the runtime through
- * `run` and `deliver` only.
+ * The dispatcher calls `route.receive()` on the target channel — the
+ * channel builds the adapter, starts the session, and handles output
+ * delivery through its normal code path. The schedule is just another
+ * message source.
  */
 export declare class ScheduleDispatcher {
     private readonly runtime;
+    private readonly resolveChannel;
     constructor(config: {
         readonly runtime: Runtime;
+        readonly resolveChannel: (channelName: string) => Promise<Route>;
     });
     trigger(input: ScheduleTriggerInput): Promise<RunHandle>;
 }

package/dist/src/channel/schedule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../../src/channel/schedule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAsB,MAAM,YAAY,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,MAAM,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IAI3C,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;CAU/D"}
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../../src/channel/schedule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAsB,MAAM,YAAY,CAAC;AASzE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KAClD,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0C;IAEzE,YAAY,MAAM,EAAE;QAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;KAClE,EAGA;IAEK,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC,CAyB7D;CACF"}

package/dist/src/channel/schedule.js

@@ -1,39 +1,45 @@
+const APP_AUTH = {
+    attributes: {},
+    authenticator: "app",
+    principalId: "ash:app",
+    principalType: "runtime",
+};
 /**
- * Dispatcher for one-shot scheduled task execution.
+ * Dispatcher for scheduled task execution.
  *
- * Each trigger generates a unique continuation token so every cron
- * invocation starts a fresh session. Schedule runs always use task
- * mode, so the runtime requires the harness to finish within the
- * current invocation instead of parking for follow-up messages.
- *
- * The dispatcher never touches the compiled bundle, the {@link AshContext},
- * or any execution-layer machinery — it speaks to the runtime through
- * `run` and `deliver` only.
+ * The dispatcher calls `route.receive()` on the target channel — the
+ * channel builds the adapter, starts the session, and handles output
+ * delivery through its normal code path. The schedule is just another
+ * message source.
  */
 export class ScheduleDispatcher {
     runtime;
+    resolveChannel;
     constructor(config) {
         this.runtime = config.runtime;
+        this.resolveChannel = config.resolveChannel;
     }
     async trigger(input) {
-        const continuationToken = `schedule:${input.scheduleId}:${crypto.randomUUID()}`;
-        return await this.runtime.run({
-            adapter: { kind: "schedule" },
-            auth: createScheduleAuthContext(input.scheduleId),
-            continuationToken,
-            input: { message: input.markdown },
-            mode: "task",
+        const { channel } = input;
+        const route = await this.resolveChannel(channel.name);
+        if (!route.receive) {
+            throw new Error(`Schedule "${input.scheduleId}" targets channel "${channel.name}" ` +
+                `but that channel does not implement receive().`);
+        }
+        const receiveInput = {
+            message: input.markdown,
+            args: channel.args,
+            auth: APP_AUTH,
+        };
+        const result = await route.receive(receiveInput, {
+            agent: this.runtime,
+            waitUntil: () => { },
         });
+        if (!result) {
+            throw new Error(`Schedule "${input.scheduleId}" channel "${channel.name}" ` +
+                `receive() returned void — expected a new session.`);
+        }
+        return result;
     }
 }
-function createScheduleAuthContext(scheduleId) {
-    return {
-        attributes: { scheduleId, trigger: "cron" },
-        authenticator: "schedule",
-        issuer: "ash://scheduler",
-        principalId: `ash:schedule:${scheduleId}`,
-        principalType: "runtime",
-        subject: scheduleId,
-    };
-}
 //# sourceMappingURL=schedule.js.map

package/dist/src/channel/schedule.js.map

@@ -1 +1 @@
-{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../../src/channel/schedule.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,kBAAkB;IACZ,OAAO,CAAU;IAElC,YAAY,MAAqC;QAC/C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAA2B;QACvC,MAAM,iBAAiB,GAAG,YAAY,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC;QAChF,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;YAC5B,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;YAC7B,IAAI,EAAE,yBAAyB,CAAC,KAAK,CAAC,UAAU,CAAC;YACjD,iBAAiB;YACjB,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE;YAClC,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,yBAAyB,CAAC,UAAkB;IACnD,OAAO;QACL,UAAU,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE;QAC3C,aAAa,EAAE,UAAU;QACzB,MAAM,EAAE,iBAAiB;QACzB,WAAW,EAAE,gBAAgB,UAAU,EAAE;QACzC,aAAa,EAAE,SAAS;QACxB,OAAO,EAAE,UAAU;KACpB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../../src/channel/schedule.ts"],"names":[],"mappings":"AAGA,MAAM,QAAQ,GAAuB;IACnC,UAAU,EAAE,EAAE;IACd,aAAa,EAAE,KAAK;IACpB,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;CACzB,CAAC;AAcF;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAkB;IACZ,OAAO,CAAU;IACjB,cAAc,CAA0C;IAEzE,YAAY,MAGX;QACC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAA2B;QACvC,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;QAC1B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,aAAa,KAAK,CAAC,UAAU,sBAAsB,OAAO,CAAC,IAAI,IAAI;gBACjE,gDAAgD,CACnD,CAAC;QACJ,CAAC;QACD,MAAM,YAAY,GAAiB;YACjC,OAAO,EAAE,KAAK,CAAC,QAAQ;YACvB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,QAAQ;SACf,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE;YAC/C,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;SACpB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,aAAa,KAAK,CAAC,UAAU,cAAc,OAAO,CAAC,IAAI,IAAI;gBACzD,mDAAmD,CACtD,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}