experimental-ash 0.7.2 → 0.7.3

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

@@ -1 +1 @@
-import{n as e}from"../../chunks/paths-BFX2EgQO.js";import{loadDevelopmentEnvironmentFiles as t}from"../../cli/dev/environment.js";import{a as n,n as r,t as i}from"../../chunks/client-DBMG7iuf.js";import{n as a}from"../../chunks/host-Ck0qkepf.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-DQbfjCIS.js";import{loadDevelopmentEnvironmentFiles as t}from"../../cli/dev/environment.js";import{a as n,n as r,t as i}from"../../chunks/client-DBMG7iuf.js";import{n as a}from"../../chunks/host-CQ7AZID3.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/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.7.2";
+const BUNDLED_FALLBACK_PACKAGE_VERSION = "0.7.3";
 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/channel.d.ts

@@ -1,4 +1,3 @@
-import type { Route } from "#public/definitions/channel.js";
 import { type CompiledChannel } from "#channel/compiled-channel.js";
 /**
  * Type guard: returns whether `value` is a {@link CompiledChannel} produced
@@ -9,15 +8,14 @@ export declare function isCompiledChannel(value: unknown): value is CompiledChan
  * Normalizes one authored channel definition into the canonical internal
  * shape consumed by the compiler.
  *
- * Accepts both:
- * - New CompiledChannel shape: `{ __kind: "ash:channel", routes, adapter, receive? }`
- * - Old Route shape: `{ fetch, method?, adapter?, receive? }`
- *
- * For CompiledChannel values, the normalizer returns the object as-is
- * since it is already validated by `defineChannel()`. Old Route shapes
- * are validated and returned as Route.
+ * Authored channels must go through {@link defineChannel} (or a wrapper
+ * like `slackChannel` / `ashChannel`) and therefore must be
+ * {@link CompiledChannel} values. The legacy plain-`{ fetch, receive? }`
+ * Route shape is no longer supported — drop a clear error for it so
+ * users on old patterns get a useful migration hint instead of a silent
+ * runtime crash deeper in dispatch.
  *
  * Disable sentinels are handled by the compiler before this function is
  * called.
  */
-export declare function normalizeChannelDefinition(value: unknown, message: string): Route | CompiledChannel;
+export declare function normalizeChannelDefinition(value: unknown, message: string): CompiledChannel;

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

@@ -1,12 +1,4 @@
 import { CHANNEL_SENTINEL } from "#channel/compiled-channel.js";
-import { expectFunction, expectObjectRecord, expectOnlyKnownKeys, } from "#internal/authored-module.js";
-const CHANNEL_METHODS = new Set([
-    "GET",
-    "POST",
-    "PUT",
-    "DELETE",
-    "PATCH",
-]);
 /**
  * Type guard: returns whether `value` is a {@link CompiledChannel} produced
  * by {@link defineChannel}.
@@ -20,35 +12,19 @@ export function isCompiledChannel(value) {
  * Normalizes one authored channel definition into the canonical internal
  * shape consumed by the compiler.
  *
- * Accepts both:
- * - New CompiledChannel shape: `{ __kind: "ash:channel", routes, adapter, receive? }`
- * - Old Route shape: `{ fetch, method?, adapter?, receive? }`
- *
- * For CompiledChannel values, the normalizer returns the object as-is
- * since it is already validated by `defineChannel()`. Old Route shapes
- * are validated and returned as Route.
+ * Authored channels must go through {@link defineChannel} (or a wrapper
+ * like `slackChannel` / `ashChannel`) and therefore must be
+ * {@link CompiledChannel} values. The legacy plain-`{ fetch, receive? }`
+ * Route shape is no longer supported — drop a clear error for it so
+ * users on old patterns get a useful migration hint instead of a silent
+ * runtime crash deeper in dispatch.
  *
  * Disable sentinels are handled by the compiler before this function is
  * called.
  */
 export function normalizeChannelDefinition(value, message) {
-    if (isCompiledChannel(value)) {
-        return value;
-    }
-    const record = expectObjectRecord(value, message);
-    expectOnlyKnownKeys(record, ["adapter", "fetch", "method", "receive"], message);
-    const fetchHandler = expectFunction(record.fetch, message);
-    let method;
-    if (record.method !== undefined) {
-        if (typeof record.method !== "string" || !CHANNEL_METHODS.has(record.method)) {
-            throw new Error(message);
-        }
-        method = record.method;
-    }
-    const adapter = record.adapter;
-    const receive = typeof record.receive === "function" ? record.receive : undefined;
-    if (method === undefined) {
-        return { adapter, fetch: fetchHandler, receive };
+    if (!isCompiledChannel(value)) {
+        throw new Error(`${message} Use \`defineChannel({ routes, ... })\` (or a wrapper like \`slackChannel\` / \`ashChannel\`) — bare \`{ fetch, receive? }\` channel objects are no longer supported.`);
     }
-    return { adapter, fetch: fetchHandler, method, receive };
+    return value;
 }

package/dist/src/internal/nitro/routes/channel-dispatch.d.ts

@@ -11,8 +11,10 @@ import type { NitroArtifactsConfig } from "#internal/nitro/routes/runtime-artifa
  * Nitro forwards that work to `event.waitUntil()` so webhook
  * acknowledgements can return immediately.
  *
- * For CompiledChannel routes (those with a `handler` field), the dispatch
- * builds RouteHandlerArgs with `send`, `getSession`, `params`, etc.
- * For old-style routes, it builds the legacy RouteContext with `agent`.
+ * Two dispatch shapes: authored channels (`defineChannel` and its
+ * wrappers) carry a `handler` field and receive `RouteHandlerArgs` with
+ * `send`, `getSession`, etc. Framework-internal channels (the
+ * connection callback route) build `ResolvedChannelDefinition` directly
+ * with just `fetch` and receive a `RouteContext` carrying `agent`.
  */
 export declare function dispatchChannelRequest(event: H3Event, routeKey: string, config: NitroArtifactsConfig): Promise<Response>;

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

@@ -12,9 +12,11 @@ import { resolveNitroChannelRuntimeBundle } from "#internal/nitro/routes/runtime
  * Nitro forwards that work to `event.waitUntil()` so webhook
  * acknowledgements can return immediately.
  *
- * For CompiledChannel routes (those with a `handler` field), the dispatch
- * builds RouteHandlerArgs with `send`, `getSession`, `params`, etc.
- * For old-style routes, it builds the legacy RouteContext with `agent`.
+ * Two dispatch shapes: authored channels (`defineChannel` and its
+ * wrappers) carry a `handler` field and receive `RouteHandlerArgs` with
+ * `send`, `getSession`, etc. Framework-internal channels (the
+ * connection callback route) build `ResolvedChannelDefinition` directly
+ * with just `fetch` and receive a `RouteContext` carrying `agent`.
  */
 export async function dispatchChannelRequest(event, routeKey, config) {
     const bundle = await resolveNitroChannelRuntimeBundle(config);
@@ -34,7 +36,7 @@ export async function dispatchChannelRequest(event, routeKey, config) {
     };
     let response;
     if (matchedChannel.handler) {
-        // New CompiledChannel route — build RouteHandlerArgs
+        // Authored CompiledChannel route — build RouteHandlerArgs.
         const adapter = matchedChannel.adapter ?? { kind: "channel" };
         const send = createSendFn(bundle.runtime, adapter, matchedChannel.name);
         const getSession = createGetSessionFn(bundle.runtime);
@@ -48,7 +50,8 @@ export async function dispatchChannelRequest(event, routeKey, config) {
         response = await matchedChannel.handler(event.req, args);
     }
     else {
-        // Old-style Route — build legacy RouteContext
+        // Framework-internal fetch-only channel (e.g. the connection
+        // callback route). Build a RouteContext with the agent handle.
         const ctx = {
             agent: bundle.runtime,
             waitUntil,

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

@@ -42,7 +42,7 @@ export function resolveNitroScheduleDispatcher(config) {
             if (!channel) {
                 throw new Error(`Channel "${channelName}" not found in agent/channels/.`);
             }
-            return { receive: channel.receive };
+            return { receive: channel.receive, adapter: channel.adapter };
         },
     });
 }

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

@@ -2,12 +2,11 @@ import type { NitroArtifactsConfig } from "#internal/nitro/routes/runtime-artifa
 /**
  * Dispatches one Ash authored schedule via the execution engine.
  *
- * Invoked by a Nitro virtual task handler that bakes in the artifacts
- * config so the dispatcher can resolve compiled artifacts without a global
- * runtime configuration store.
+ * 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.
  */
 export declare function dispatchScheduleTask(taskName: string, config: NitroArtifactsConfig): Promise<{
     scheduleId: string;
     sessionId: string;
-    status: string;
 }>;

package/dist/src/internal/nitro/routes/schedule-task.js

@@ -4,9 +4,9 @@ import { resolveNitroScheduleDispatcher } from "#internal/nitro/routes/runtime-s
 /**
  * Dispatches one Ash authored schedule via the execution engine.
  *
- * Invoked by a Nitro virtual task handler that bakes in the artifacts
- * config so the dispatcher can resolve compiled artifacts without a global
- * runtime configuration store.
+ * 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.
  */
 export async function dispatchScheduleTask(taskName, config) {
     const compiledArtifactsSource = resolveNitroCompiledArtifactsSource(config);
@@ -19,11 +19,9 @@ export async function dispatchScheduleTask(taskName, config) {
         markdown: schedule.markdown,
         scheduleId: schedule.name,
     };
-    const handle = await dispatcher.trigger(triggerInput);
-    const result = await handle.result;
+    const session = await dispatcher.trigger(triggerInput);
     return {
         scheduleId: schedule.name,
-        sessionId: handle.sessionId,
-        status: result.status,
+        sessionId: session.id,
     };
 }

package/dist/src/public/channels/slack/slackChannel.js

@@ -275,7 +275,7 @@ export function slackChannel(config = {}) {
                 isDM: false,
             });
             return send(input.message, {
-                auth: null,
+                auth: input.auth,
                 continuationToken: `slack:${channelId}:`,
                 state: {
                     serializedThread: thread.toJSON(),

package/dist/src/public/definitions/channel.d.ts

@@ -1,5 +1,4 @@
-import type { ChannelAdapter } from "#channel/adapter.js";
-import type { DeliverInput, GetEventStreamOptions, RunHandle, RunInput, SessionAuthContext } from "#channel/types.js";
+import type { DeliverInput, GetEventStreamOptions, RunHandle, RunInput } from "#channel/types.js";
 import type { HandleMessageStreamEvent } from "#protocol/message.js";
 export type { GetEventStreamOptions } from "#channel/types.js";
 /**
@@ -94,59 +93,6 @@ export interface Agent {
      */
     getEventStream(sessionId: string, options?: GetEventStreamOptions): Promise<ReadableStream<HandleMessageStreamEvent>>;
 }
-/**
- * Input for {@link Route.receive} — the universal entry point for
- * inbound messages to a channel.
- */
-export interface ReceiveInput {
-    readonly message: string;
-    readonly args: Readonly<Record<string, unknown>>;
-    readonly auth: SessionAuthContext | null;
-}
-/**
- * Context passed to {@link Route.receive}.
- */
-export interface ReceiveContext {
-    readonly agent: Agent;
-    readonly waitUntil: (task: Promise<unknown>) => void;
-}
-/**
- * Public authored route definition. A route is a Web-standard
- * `(Request, ctx) => Response` handler whose URL path is derived from the
- * file's location under `agent/channels/`.
- *
- * Filename is identity. `agent/channels/slack.ts` mounts at `POST /slack`.
- * Nested directories and Nitro `[name]` path parameters are preserved.
- */
-export interface Route {
-    /**
-     * HTTP method this route handles. Optional — defaults to `"POST"`.
-     */
-    readonly method?: ChannelMethod;
-    /**
-     * Optional adapter that this route attaches to sessions it starts.
-     *
-     * Declared here so the runtime can register the adapter's `kind` in
-     * the adapter registry and rehydrate it after workflow step boundaries.
-     * Routes that don't start sessions (e.g. stream readers) omit this.
-     */
-    readonly adapter?: ChannelAdapter<any>;
-    /**
-     * The request handler. Receives the inbound `Request` and a
-     * {@link RouteContext} carrying the agent handle and host helpers.
-     */
-    fetch(request: Request, ctx: RouteContext): Promise<Response>;
-    /**
-     * Universal entry point for inbound messages. Handles both new
-     * sessions (start) and continuations (deliver to existing session).
-     * Called by `fetch` after HTTP parsing and by the schedule dispatcher
-     * directly.
-     *
-     * Returns `RunHandle` for new sessions, `void` for deliveries to
-     * existing sessions.
-     */
-    receive?(input: ReceiveInput, ctx: ReceiveContext): Promise<RunHandle | void>;
-}
 /**
  * Marker discriminator written into every {@link DisabledRouteSentinel}.
  */
@@ -171,11 +117,3 @@ export declare function disableRoute(): DisabledRouteSentinel;
  * produced by {@link disableRoute}.
  */
 export declare function isDisabledRouteSentinel(value: unknown): value is DisabledRouteSentinel;
-/**
- * Type guard: returns whether `value` looks like a {@link Route} or a
- * `CompiledChannel` produced by `defineChannel()`.
- *
- * Used by the compiler to distinguish authored channel exports from
- * `DisabledRouteSentinel` exports.
- */
-export declare function isRouteDefinition(value: unknown): boolean;

package/dist/src/public/definitions/channel.js

@@ -22,19 +22,3 @@ export function isDisabledRouteSentinel(value) {
         value !== null &&
         value.kind === DISABLED_ROUTE_SENTINEL_KIND);
 }
-/**
- * Type guard: returns whether `value` looks like a {@link Route} or a
- * `CompiledChannel` produced by `defineChannel()`.
- *
- * Used by the compiler to distinguish authored channel exports from
- * `DisabledRouteSentinel` exports.
- */
-export function isRouteDefinition(value) {
-    if (typeof value !== "object" || value === null)
-        return false;
-    // New CompiledChannel shape from defineChannel()
-    if (value.__kind === "ash:channel")
-        return true;
-    // Old Route shape with fetch handler
-    return typeof value.fetch === "function";
-}

package/dist/src/public/definitions/defineChannel.d.ts

@@ -1,5 +1,6 @@
 import type { AttachmentResolver } from "#channel/adapter.js";
 import { CHANNEL_SENTINEL } from "#channel/compiled-channel.js";
+import type { SessionAuthContext } from "#channel/types.js";
 import type { HandleMessageStreamEvent } from "#protocol/message.js";
 import type { RouteDefinition, SendFn } from "#channel/routes.js";
 import type { Session, SessionHandle } from "#channel/session.js";
@@ -34,8 +35,9 @@ export interface ChannelConfig<TState = undefined, TCtx = void> {
     context?(state: NonNullable<TState>): TCtx;
     readonly routes: readonly RouteDefinition<TState>[];
     receive?(input: {
-        message: string;
-        args: Readonly<Record<string, unknown>>;
+        readonly message: string;
+        readonly args: Readonly<Record<string, unknown>>;
+        readonly auth: SessionAuthContext | null;
     }, args: {
         send: SendFn<TState>;
     }): Promise<Session>;
@@ -55,8 +57,9 @@ export interface Channel<TState = undefined> {
         path: string;
     }[];
     readonly receive?: (input: {
-        message: string;
-        args: Readonly<Record<string, unknown>>;
+        readonly message: string;
+        readonly args: Readonly<Record<string, unknown>>;
+        readonly auth: SessionAuthContext | null;
     }, args: {
         send: SendFn<TState>;
     }) => Promise<Session>;

package/dist/src/runtime/resolve-channel.d.ts

@@ -3,10 +3,15 @@ import type { CompiledModuleMap } from "#compiler/module-map.js";
 import type { ResolvedChannelDefinition } from "#runtime/types.js";
 /**
  * Resolves one compiled channel entry into a runtime-owned definition
- * with a live `fetch` or `handler` attached from the authored module.
+ * with a live `handler` (the per-route handler authored via `POST` /
+ * `GET` / etc. inside `defineChannel`) and the channel's `receive` hook
+ * if the author declared one.
  *
- * For CompiledChannel values (produced by `defineChannel()`), the
- * resolver finds the matching route by method + path and attaches its
- * `handler`. For old-style Route values, it attaches `fetch` directly.
+ * Every authored channel is a `CompiledChannel` from `defineChannel` —
+ * the bare `{ fetch, receive? }` Route shape is rejected by
+ * {@link normalizeChannelDefinition}. Framework-internal channels
+ * (the connection callback route, the `ash` session channel) build
+ * `ResolvedChannelDefinition` values directly and do not flow through
+ * this resolver.
  */
 export declare function resolveChannelDefinition(definition: CompiledChannelDefinition, moduleMap: CompiledModuleMap, nodeId: string | undefined): Promise<ResolvedChannelDefinition>;

package/dist/src/runtime/resolve-channel.js

@@ -1,13 +1,18 @@
-import { isCompiledChannel, normalizeChannelDefinition, } from "#internal/authored-definition/channel.js";
+import { normalizeChannelDefinition } from "#internal/authored-definition/channel.js";
 import { toErrorMessage } from "#shared/errors.js";
 import { createResolvedModuleSourceRef, loadResolvedModuleExport, ResolveAgentError, } from "#runtime/resolve-helpers.js";
 /**
  * Resolves one compiled channel entry into a runtime-owned definition
- * with a live `fetch` or `handler` attached from the authored module.
+ * with a live `handler` (the per-route handler authored via `POST` /
+ * `GET` / etc. inside `defineChannel`) and the channel's `receive` hook
+ * if the author declared one.
  *
- * For CompiledChannel values (produced by `defineChannel()`), the
- * resolver finds the matching route by method + path and attaches its
- * `handler`. For old-style Route values, it attaches `fetch` directly.
+ * Every authored channel is a `CompiledChannel` from `defineChannel` —
+ * the bare `{ fetch, receive? }` Route shape is rejected by
+ * {@link normalizeChannelDefinition}. Framework-internal channels
+ * (the connection callback route, the `ash` session channel) build
+ * `ResolvedChannelDefinition` values directly and do not flow through
+ * this resolver.
  */
 export async function resolveChannelDefinition(definition, moduleMap, nodeId) {
     try {
@@ -23,35 +28,23 @@ export async function resolveChannelDefinition(definition, moduleMap, nodeId) {
             logicalPath: definition.logicalPath,
             sourceId: definition.sourceId,
         });
-        if (isCompiledChannel(channelDefinition)) {
-            const matchedRoute = channelDefinition.routes.find((r) => r.method.toUpperCase() === definition.method.toUpperCase() &&
-                r.path === definition.urlPath);
-            const adapter = channelDefinition.adapter;
-            if (adapter && adapter.kind !== "http") {
-                adapter.kind = `channel:${definition.name}`;
-            }
-            return {
-                name: definition.name,
-                method: definition.method,
-                urlPath: definition.urlPath,
-                fetch: async (req, ctx) => {
-                    if (matchedRoute)
-                        return matchedRoute.handler(req, ctx);
-                    return Response.json({ error: "No matching route handler.", ok: false }, { status: 404 });
-                },
-                handler: matchedRoute?.handler,
-                receive: channelDefinition.receive,
-                adapter,
-                ...sourceRef,
-            };
+        const matchedRoute = channelDefinition.routes.find((r) => r.method.toUpperCase() === definition.method.toUpperCase() && r.path === definition.urlPath);
+        const adapter = channelDefinition.adapter;
+        if (adapter && adapter.kind !== "http") {
+            adapter.kind = `channel:${definition.name}`;
         }
         return {
             name: definition.name,
             method: definition.method,
             urlPath: definition.urlPath,
-            fetch: channelDefinition.fetch,
+            fetch: async (req, ctx) => {
+                if (matchedRoute)
+                    return matchedRoute.handler(req, ctx);
+                return Response.json({ error: "No matching route handler.", ok: false }, { status: 404 });
+            },
+            handler: matchedRoute?.handler,
             receive: channelDefinition.receive,
-            adapter: channelDefinition.adapter,
+            adapter,
             ...sourceRef,
         };
     }

package/dist/src/runtime/types.d.ts

@@ -1,7 +1,8 @@
 import type { FlexibleSchema } from "ai";
 import type { ChannelAdapter } from "#channel/adapter.js";
+import type { CompiledChannel } from "#channel/compiled-channel.js";
 import type { DiscoverDiagnosticsSummary } from "#discover/diagnostics.js";
-import type { ChannelMethod, Route, RouteContext } from "#public/definitions/channel.js";
+import type { ChannelMethod, RouteContext } from "#public/definitions/channel.js";
 import type { RouteHandler } from "#channel/routes.js";
 import type { LifecycleHooks, StreamEventHook } from "#public/definitions/hook.js";
 import type { CompactionHookInput, CompactionHookResult, NeedsApprovalContext, ToolRetentionPolicy } from "#public/definitions/tool.js";
@@ -172,16 +173,20 @@ export interface ResolvedChannelDefinition extends ResolvedModuleSourceRef {
     readonly method: ChannelMethod;
     readonly adapter?: ChannelAdapter;
     readonly urlPath: string;
-    readonly fetch: Route["fetch"] | ((req: Request, ctx: RouteContext) => Promise<Response>);
+    readonly fetch: (req: Request, ctx: RouteContext) => Promise<Response>;
     /**
-     * Old-style receive from Route or new-style receive from CompiledChannel.
-     * The schedule dispatcher adapts to whichever shape is present.
+     * Universal entry point for new sessions, called by cross-channel
+     * initiators (the schedule dispatcher today). Typed precisely as
+     * {@link CompiledChannel.receive} — `(input, { send }) => Session` —
+     * so any caller passing the wrong context shape is a typecheck error,
+     * not a runtime crash.
      *
-     * Both signatures accept a first arg with `{ message, args }`. The
-     * second arg differs: old uses `{ agent, waitUntil }`, new uses
-     * `{ send }`. The dispatcher passes the appropriate shape.
+     * Old Route-style channels do not flow `receive` through here. The
+     * resolver sets it to `undefined` for those; callers that need
+     * `receive` then throw with a clear error rather than silently
+     * accepting a different shape.
      */
-    readonly receive?: (...args: any[]) => Promise<any>;
+    readonly receive?: CompiledChannel["receive"];
     /**
      * New-style route handler from CompiledChannel. When present, the
      * dispatch layer uses this instead of `fetch`.

package/package.json

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