experimental-ash 0.7.1 → 0.7.3

package/dist/src/chunks/{prewarm-DdHk68ib.js → prewarm-CcphIXc0.js}

@@ -1,4 +1,4 @@
-import{E as e,S as t,T as n,_ as r,a as i,c as a,d as o,g as s,h as c,l,m as u,p as ee,s as te,u as d,x as f,y as p}from"./paths-DvimrhJF.js";import{t as m}from"./authored-module-loader-CqZSviWm.js";import{t as h}from"./errors-DsO9xmQL.js";import{i as g,t as _}from"./package-DmsQgn4v.js";import{join as v,posix as y}from"node:path";import{mkdir as ne,readFile as re,readdir as ie,realpath as b,writeFile as x}from"node:fs/promises";import{createHash as S}from"node:crypto";import{existsSync as C}from"node:fs";function w(e){return e.dev?{appRoot:e.appRoot,dev:e.dev,moduleMapLoaderPath:g(`src/internal/authored-module-map-loader.ts`)}:{appRoot:e.appRoot,dev:e.dev}}const T=`#ash-channel/`;function E(e){let t=e.compileResult.manifest.channels,n=new Set,r=[],i=new Set,o=a();for(let e of t){if(e.kind===`disabled`){if(!o.has(e.name))throw Error(`agent/channels/${e.name}.ts exports disableRoute() but "${e.name}" is not a framework channel. Rename the file to one of: ${[...o].sort().join(`, `)}.`);i.add(e.name);continue}n.add(e.name),r.push({method:e.method,route:e.urlPath})}let s=l().filter(e=>!n.has(e.name)&&!i.has(e.name)).map(e=>({method:e.method,route:e.urlPath})),c=new Set,u=[];for(let e of[...s,...r]){let t=k(e);c.has(t)||(c.add(t),u.push(e))}return u}function D(e,t){for(let n of t.registrations)A(e,{artifactsConfig:t.artifactsConfig,method:n.method,route:n.route})}function O(e,t){return N(t.previous,t.next)?!1:(j(e),D(e,{artifactsConfig:t.artifactsConfig,registrations:t.next}),e.routing.sync(),!0)}function k(e){return`${e.method.toUpperCase()} ${e.route}`}function A(e,t){let r=k(t),i=`${T}${r}`,a=n(g(`src/internal/nitro/routes/channel-dispatch.ts`));e.options.handlers.push({handler:i,method:t.method,route:t.route}),e.options.virtual[i]=[`import { dispatchChannelRequest } from ${a};`,`const config = ${JSON.stringify(t.artifactsConfig)};`,`export default (event) => dispatchChannelRequest(event, ${JSON.stringify(r)}, config);`].join(`
+import{E as e,S as t,T as n,_ as r,a as i,c as a,d as o,g as s,h as c,l,m as u,p as ee,s as te,u as d,x as f,y as p}from"./paths-DQbfjCIS.js";import{t as m}from"./authored-module-loader-CqZSviWm.js";import{t as h}from"./errors-DsO9xmQL.js";import{i as g,t as _}from"./package-DmsQgn4v.js";import{join as v,posix as y}from"node:path";import{mkdir as ne,readFile as re,readdir as ie,realpath as b,writeFile as x}from"node:fs/promises";import{createHash as S}from"node:crypto";import{existsSync as C}from"node:fs";function w(e){return e.dev?{appRoot:e.appRoot,dev:e.dev,moduleMapLoaderPath:g(`src/internal/authored-module-map-loader.ts`)}:{appRoot:e.appRoot,dev:e.dev}}const T=`#ash-channel/`;function E(e){let t=e.compileResult.manifest.channels,n=new Set,r=[],i=new Set,o=a();for(let e of t){if(e.kind===`disabled`){if(!o.has(e.name))throw Error(`agent/channels/${e.name}.ts exports disableRoute() but "${e.name}" is not a framework channel. Rename the file to one of: ${[...o].sort().join(`, `)}.`);i.add(e.name);continue}n.add(e.name),r.push({method:e.method,route:e.urlPath})}let s=l().filter(e=>!n.has(e.name)&&!i.has(e.name)).map(e=>({method:e.method,route:e.urlPath})),c=new Set,u=[];for(let e of[...s,...r]){let t=k(e);c.has(t)||(c.add(t),u.push(e))}return u}function D(e,t){for(let n of t.registrations)A(e,{artifactsConfig:t.artifactsConfig,method:n.method,route:n.route})}function O(e,t){return N(t.previous,t.next)?!1:(j(e),D(e,{artifactsConfig:t.artifactsConfig,registrations:t.next}),e.routing.sync(),!0)}function k(e){return`${e.method.toUpperCase()} ${e.route}`}function A(e,t){let r=k(t),i=`${T}${r}`,a=n(g(`src/internal/nitro/routes/channel-dispatch.ts`));e.options.handlers.push({handler:i,method:t.method,route:t.route}),e.options.virtual[i]=[`import { dispatchChannelRequest } from ${a};`,`const config = ${JSON.stringify(t.artifactsConfig)};`,`export default (event) => dispatchChannelRequest(event, ${JSON.stringify(r)}, config);`].join(`
 `)}function j(e){for(let t=e.options.handlers.length-1;t>=0;--t){let n=e.options.handlers[t];n!==void 0&&M(n)&&e.options.handlers.splice(t,1)}for(let t of Object.keys(e.options.virtual))t.startsWith(T)&&delete e.options.virtual[t]}function M(e){return e.handler.startsWith(T)}function N(e,t){if(e.length!==t.length)return!1;for(let n=0;n<e.length;n+=1){let r=e[n],i=t[n];if(r===void 0||i===void 0||r.method!==i.method||r.route!==i.route)return!1}return!0}const P=`ash.schedule.`;var F=class extends Error{scheduleId;sourceId;taskName;constructor(e,t={}){super(e),this.name=`ScheduleRegistrationError`,t.scheduleId!==void 0&&(this.scheduleId=t.scheduleId),t.sourceId!==void 0&&(this.sourceId=t.sourceId),t.taskName!==void 0&&(this.taskName=t.taskName)}};function I(e){let t=e.map(e=>({cron:e.cron,description:`Run Ash schedule "${e.name}" from "${e.logicalPath}".`,logicalPath:e.logicalPath,scheduleId:e.name,sourceId:e.sourceId,taskName:R(e.sourceId)})).sort((e,t)=>e.sourceId.localeCompare(t.sourceId));return L(t),t}function L(e){let t=new Map;for(let n of e){let e=t.get(n.scheduleId);if(e===void 0){t.set(n.scheduleId,n);continue}throw new F(`Duplicate authored schedule id "${n.scheduleId}" found in "${e.logicalPath}" and "${n.logicalPath}".`,{scheduleId:n.scheduleId,sourceId:n.sourceId,taskName:n.taskName})}}function R(e){return`${P}${Buffer.from(e,`utf8`).toString(`base64url`)}`}const z=`#ash-schedule-task/`;function B(e,t){if(t.registrations.length!==0){e.options.experimental.tasks=!0;for(let n of t.registrations)U(e,{artifactsConfig:t.artifactsConfig,dispatchModulePath:t.dispatchModulePath,registration:n})}}function V(e,t){let n=!G(t.previous,t.next);return H(e),B(e,{artifactsConfig:t.artifactsConfig,dispatchModulePath:t.dispatchModulePath,registrations:t.next}),n}function H(e){for(let t of Object.keys(e.options.tasks))t.startsWith(`ash.schedule.`)&&delete e.options.tasks[t];for(let t of Object.keys(e.options.virtual))t.startsWith(z)&&delete e.options.virtual[t];for(let[t,n]of Object.entries(e.options.scheduledTasks)){let r=W(n).filter(e=>!e.startsWith(P));if(r.length===0){delete e.options.scheduledTasks[t];continue}if(r.length===1){let[n]=r;n!==void 0&&(e.options.scheduledTasks[t]=n);continue}e.options.scheduledTasks[t]=r}}function U(e,t){let r=`${z}${t.registration.taskName}`,i=n(t.dispatchModulePath);e.options.tasks[t.registration.taskName]={description:t.registration.description,handler:r},e.options.virtual[r]=[`import { dispatchScheduleTask } from ${i};`,`const config = ${JSON.stringify(t.artifactsConfig)};`,`export default {`,`  meta: { description: ${JSON.stringify(t.registration.description)} },`,`  async run(event) {`,`    return { result: await dispatchScheduleTask(event.name, config) };`,`  },`,`};`].join(`
 `),ae(e,t.registration.cron,t.registration.taskName)}function ae(e,t,n){let r=e.options.scheduledTasks[t];if(r===void 0){e.options.scheduledTasks[t]=n;return}if(typeof r==`string`){e.options.scheduledTasks[t]=[r,n];return}r.includes(n)||r.push(n)}function W(e){return typeof e==`string`?[e]:[...e]}function G(e,t){if(e.length!==t.length)return!1;for(let n=0;n<e.length;n+=1){let r=e[n],i=t[n];if(r===void 0||i===void 0||r.cron!==i.cron||r.description!==i.description||r.logicalPath!==i.logicalPath||r.scheduleId!==i.scheduleId||r.sourceId!==i.sourceId||r.taskName!==i.taskName)return!1}return!0}async function K(e){return[...e.manifest.schedules].map(e=>{let t={cron:e.cron,logicalPath:e.logicalPath,markdown:e.markdown,name:e.name,sourceId:e.sourceId,sourceKind:e.sourceKind};return e.channel===void 0?t:{...t,channel:e.channel}})}async function q(e){return await K({manifest:await o({compiledArtifactsSource:e.compiledArtifactsSource})})}async function J(e){let t=v(e.outDir,`compiled-artifacts-bootstrap.mjs`),n=v(e.outDir,`compiled-artifacts-instrumentation.mjs`),r=se(e.compileResult.manifest.agentRoot);await ne(e.outDir,{recursive:!0}),await x(t,await le({compileResult:e.compileResult,installModulePath:g(`src/runtime/loaders/bundled-artifacts.ts`),moduleMapPath:t,metadata:e.compileResult.metadata})),r!==void 0&&await x(n,ue({agentName:e.compileResult.manifest.config.name,instrumentationPath:r,registerConfigPath:g(`src/harness/instrumentation-config.ts`)}));let i={bootstrapPath:t};return r!==void 0&&(i.instrumentationPluginPath=n,i.instrumentationSourcePath=r),i}const oe=[`.ts`,`.mts`,`.js`,`.mjs`];function se(e){for(let t of oe){let n=v(e,`instrumentation${t}`);if(C(n))return n}}function ce(e){return e.replace(/^export const moduleMap = /m,`const moduleMap = `).replace(/\nexport default moduleMap;\n?$/,`
 `)}async function le(e){let r=ce(t({importSpecifierStyle:`absolute`,manifest:e.compileResult.manifest,moduleMapPath:e.moduleMapPath})).trim();return[`// Generated by Ash. Do not edit by hand.`,`import { installBundledCompiledArtifacts } from ${n(e.installModulePath)};`,``,r,``,`const metadata = ${JSON.stringify(e.metadata,null,2)};`,``,`const manifest = ${JSON.stringify(e.compileResult.manifest,null,2)};`,``,`export function installCompiledArtifactsBootstrap() {`,`  installBundledCompiledArtifacts({`,`    manifest,`,`    metadata,`,`    moduleMap,`,`  });`,`}`,``,`installCompiledArtifactsBootstrap();`,``,`// Default export satisfies the Nitro plugin contract so this file`,`// can be used directly as a Nitro plugin without a separate wrapper.`,`export default function installCompiledArtifactsPlugin() {`,`  // Already installed on import above.`,`}`,``,`export async function __ashInstallCompiledArtifactsStep() {`,`  "use step";`,`  return null;`,`}`,``].join(`

package/dist/src/cli/commands/info.js

@@ -1,2 +1,2 @@
-import{D as e,b as t,t as n,v as r,y as i}from"../../chunks/paths-DvimrhJF.js";import{d as a,f as o,g as s}from"../../chunks/types-D9Uv7nU4.js";import{createCliTheme as c,renderCliBanner as l,renderCliSection as u}from"../ui/output.js";async function d(e){let t=await f(e);return{application:n(t?.project.appRoot??e),compiledState:t,messaging:{createSessionRoutePath:o,continueSessionRoutePattern:a,streamRoutePattern:s}}}async function f(n){try{return await i({startPath:n})}catch(n){if(n instanceof r)return n.result;if(n instanceof e||n instanceof t)return null;throw n}}function p(e,t){return`${e} ${t}${e===1?``:`s`}`}function m(e,t){return`${`${e} error${e===1?``:`s`}`}, ${`${t} warning${t===1?``:`s`}`}`}function h(e){switch(e){case`ready`:return`success`;case`failed`:return`danger`;default:return`warning`}}async function g(e,t){let n=await d(t),r=n.compiledState,i=n.application,a=c(),o=[{label:`App Root`,value:i.appRoot}],s=[{label:`Workflow Build`,value:i.workflowBuildDir},{label:`Output`,value:i.outputDir}],f=[];r===null?o.push({label:`Compile`,tone:`warning`,value:`unavailable`}):(o.push({label:`Agent Root`,value:r.project.agentRoot},{label:`Layout`,value:r.project.layout},{label:`Compile`,tone:h(r.metadata.status),value:r.metadata.status},{label:`Diagnostics`,tone:r.metadata.discovery.summary.errors>0?`danger`:r.metadata.discovery.summary.warnings>0?`warning`:`success`,value:m(r.metadata.discovery.summary.errors,r.metadata.discovery.summary.warnings)},{label:`Instructions`,value:r.manifest.instructions?.logicalPath??`none`},{label:`Skills`,value:p(r.manifest.skills.length,`skill`)}),s.unshift({label:`Compiled Manifest`,value:r.paths.compiledManifestPath},{label:`Discovery Manifest`,value:r.paths.discoveryManifestPath},{label:`Diagnostics`,value:r.paths.diagnosticsPath},{label:`Module Map`,value:r.paths.moduleMapPath},{label:`Metadata`,value:r.paths.compileMetadataPath}),f.push(r.manifest.instructions===void 0?{label:`Instructions`,value:`No instructions prompt discovered.`}:{label:`Instructions`,value:r.manifest.instructions.logicalPath})),e.log([l(a,{subtitle:`Resolved application paths and the active message contract.`,title:`Ash Info`}),``,u(a,{rows:o,title:`Application`}),``,u(a,{rows:s,title:`Artifacts`}),...r===null?[]:[``,u(a,{rows:f,title:`Instructions`})],``,u(a,{rows:[{label:`Workflow ID`,value:i.workflowId},{label:`Source Dir`,value:i.workflowSourceDir},{label:`Create`,tone:`info`,value:`POST ${n.messaging.createSessionRoutePath}`},{label:`Continue`,tone:`info`,value:`POST ${n.messaging.continueSessionRoutePattern}`},{label:`Stream`,tone:`info`,value:`GET ${n.messaging.streamRoutePattern}`}],title:`Messaging`})].join(`
+import{D as e,b as t,t as n,v as r,y as i}from"../../chunks/paths-DQbfjCIS.js";import{d as a,f as o,g as s}from"../../chunks/types-D9Uv7nU4.js";import{createCliTheme as c,renderCliBanner as l,renderCliSection as u}from"../ui/output.js";async function d(e){let t=await f(e);return{application:n(t?.project.appRoot??e),compiledState:t,messaging:{createSessionRoutePath:o,continueSessionRoutePattern:a,streamRoutePattern:s}}}async function f(n){try{return await i({startPath:n})}catch(n){if(n instanceof r)return n.result;if(n instanceof e||n instanceof t)return null;throw n}}function p(e,t){return`${e} ${t}${e===1?``:`s`}`}function m(e,t){return`${`${e} error${e===1?``:`s`}`}, ${`${t} warning${t===1?``:`s`}`}`}function h(e){switch(e){case`ready`:return`success`;case`failed`:return`danger`;default:return`warning`}}async function g(e,t){let n=await d(t),r=n.compiledState,i=n.application,a=c(),o=[{label:`App Root`,value:i.appRoot}],s=[{label:`Workflow Build`,value:i.workflowBuildDir},{label:`Output`,value:i.outputDir}],f=[];r===null?o.push({label:`Compile`,tone:`warning`,value:`unavailable`}):(o.push({label:`Agent Root`,value:r.project.agentRoot},{label:`Layout`,value:r.project.layout},{label:`Compile`,tone:h(r.metadata.status),value:r.metadata.status},{label:`Diagnostics`,tone:r.metadata.discovery.summary.errors>0?`danger`:r.metadata.discovery.summary.warnings>0?`warning`:`success`,value:m(r.metadata.discovery.summary.errors,r.metadata.discovery.summary.warnings)},{label:`Instructions`,value:r.manifest.instructions?.logicalPath??`none`},{label:`Skills`,value:p(r.manifest.skills.length,`skill`)}),s.unshift({label:`Compiled Manifest`,value:r.paths.compiledManifestPath},{label:`Discovery Manifest`,value:r.paths.discoveryManifestPath},{label:`Diagnostics`,value:r.paths.diagnosticsPath},{label:`Module Map`,value:r.paths.moduleMapPath},{label:`Metadata`,value:r.paths.compileMetadataPath}),f.push(r.manifest.instructions===void 0?{label:`Instructions`,value:`No instructions prompt discovered.`}:{label:`Instructions`,value:r.manifest.instructions.logicalPath})),e.log([l(a,{subtitle:`Resolved application paths and the active message contract.`,title:`Ash Info`}),``,u(a,{rows:o,title:`Application`}),``,u(a,{rows:s,title:`Artifacts`}),...r===null?[]:[``,u(a,{rows:f,title:`Instructions`})],``,u(a,{rows:[{label:`Workflow ID`,value:i.workflowId},{label:`Source Dir`,value:i.workflowSourceDir},{label:`Create`,tone:`info`,value:`POST ${n.messaging.createSessionRoutePath}`},{label:`Continue`,tone:`info`,value:`POST ${n.messaging.continueSessionRoutePattern}`},{label:`Stream`,tone:`info`,value:`GET ${n.messaging.streamRoutePattern}`}],title:`Messaging`})].join(`
 `))}export{g as printApplicationInfo};

package/dist/src/cli/run.js

@@ -1,3 +1,3 @@
-import{t as e}from"../chunks/package-DmsQgn4v.js";import{createCliTheme as t,renderCliTaggedLine as n}from"./ui/output.js";import{i as r,n as i,r as a,t as o}from"../chunks/url-BVRhVE2O.js";import{resolve as s}from"node:path";async function c(){return(await import(`../chunks/host-CsF9KDv8.js`).then(e=>e.t)).buildHost}async function l(){return(await import(`./commands/info.js`)).printApplicationInfo}async function u(){return(await import(`./dev/repl.js`)).runDevelopmentRepl}async function d(){return(await import(`../evals/cli/eval.js`)).runEvalCommand}async function f(){return(await import(`../chunks/host-CsF9KDv8.js`).then(e=>e.t)).startHost}function p(e=process.cwd()){return s(e)}function m(e){return`Ash (v${e})`}function h(e){return e.name()===`info`||e.name()===`dev`}async function g(e){await new Promise((t,n)=>{let r=!1,i=()=>{process.off(`SIGINT`,a),process.off(`SIGTERM`,a)},a=()=>{r||(r=!0,i(),e.close().then(t,n))};process.once(`SIGINT`,a),process.once(`SIGTERM`,a)})}function _(e){if(!/^-?\d+$/.test(e))throw new r(`Expected a numeric port, received "${e}".`);let t=Number(e);if(!Number.isInteger(t))throw new r(`Expected a numeric port, received "${e}".`);if(t<0||t>65535)throw new r(`Expected a port between 0 and 65535, received "${e}".`);return t}function v(){return!!(process.stdin.isTTY&&process.stdout.isTTY)}function y(e){let t=e[1];return e[0]!==`dev`||e.length!==2||t===void 0||t.startsWith(`-`)?[...e]:[`dev`,`--url`,t]}function b(e){if(e.url){if(e.host!==void 0)throw new r(`The --host option cannot be used with --url.`);if(e.port!==void 0)throw new r(`The --port option cannot be used with --url.`);if(e.repl===!1)throw new r(`The --no-repl option cannot be used with --url.`);return e.url}}function x(r,a){let s=p(),y=e().version,x=new i,S=t();return x.name(`ash`).description(`Build and run an Ash application.`).version(y).showHelpAfterError().exitOverride().hook(`preAction`,(e,t)=>{h(t)&&r.log(m(y))}).configureOutput({writeErr:e=>{r.error(e.trimEnd())},writeOut:e=>{r.log(e.trimEnd())}}),x.command(`build`).description(`Build the current Ash application.`).action(async()=>{let e=await(a.buildHost??await c())(s);r.log(n(S,{message:`built output at ${e}`,tag:`build`,tone:`success`}))}),x.command(`dev`).description(`Start the Ash development server or connect the REPL to an existing URL.`).option(`--host <host>`,`Host interface to bind`).option(`--no-repl`,`Start the server without the interactive REPL`).option(`--port <port>`,`Port to listen on (defaults to $PORT, then 3000)`,_).option(`--schedules`,`Run scheduled tasks during development (off by default)`).option(`-u, --url <url>`,`Connect the REPL to an existing server URL`,o).addHelpText(`after`,`
+import{t as e}from"../chunks/package-DmsQgn4v.js";import{createCliTheme as t,renderCliTaggedLine as n}from"./ui/output.js";import{i as r,n as i,r as a,t as o}from"../chunks/url-BVRhVE2O.js";import{resolve as s}from"node:path";async function c(){return(await import(`../chunks/host-CQ7AZID3.js`).then(e=>e.t)).buildHost}async function l(){return(await import(`./commands/info.js`)).printApplicationInfo}async function u(){return(await import(`./dev/repl.js`)).runDevelopmentRepl}async function d(){return(await import(`../evals/cli/eval.js`)).runEvalCommand}async function f(){return(await import(`../chunks/host-CQ7AZID3.js`).then(e=>e.t)).startHost}function p(e=process.cwd()){return s(e)}function m(e){return`Ash (v${e})`}function h(e){return e.name()===`info`||e.name()===`dev`}async function g(e){await new Promise((t,n)=>{let r=!1,i=()=>{process.off(`SIGINT`,a),process.off(`SIGTERM`,a)},a=()=>{r||(r=!0,i(),e.close().then(t,n))};process.once(`SIGINT`,a),process.once(`SIGTERM`,a)})}function _(e){if(!/^-?\d+$/.test(e))throw new r(`Expected a numeric port, received "${e}".`);let t=Number(e);if(!Number.isInteger(t))throw new r(`Expected a numeric port, received "${e}".`);if(t<0||t>65535)throw new r(`Expected a port between 0 and 65535, received "${e}".`);return t}function v(){return!!(process.stdin.isTTY&&process.stdout.isTTY)}function y(e){let t=e[1];return e[0]!==`dev`||e.length!==2||t===void 0||t.startsWith(`-`)?[...e]:[`dev`,`--url`,t]}function b(e){if(e.url){if(e.host!==void 0)throw new r(`The --host option cannot be used with --url.`);if(e.port!==void 0)throw new r(`The --port option cannot be used with --url.`);if(e.repl===!1)throw new r(`The --no-repl option cannot be used with --url.`);return e.url}}function x(r,a){let s=p(),y=e().version,x=new i,S=t();return x.name(`ash`).description(`Build and run an Ash application.`).version(y).showHelpAfterError().exitOverride().hook(`preAction`,(e,t)=>{h(t)&&r.log(m(y))}).configureOutput({writeErr:e=>{r.error(e.trimEnd())},writeOut:e=>{r.log(e.trimEnd())}}),x.command(`build`).description(`Build the current Ash application.`).action(async()=>{let e=await(a.buildHost??await c())(s);r.log(n(S,{message:`built output at ${e}`,tag:`build`,tone:`success`}))}),x.command(`dev`).description(`Start the Ash development server or connect the REPL to an existing URL.`).option(`--host <host>`,`Host interface to bind`).option(`--no-repl`,`Start the server without the interactive REPL`).option(`--port <port>`,`Port to listen on (defaults to $PORT, then 3000)`,_).option(`--schedules`,`Run scheduled tasks during development (off by default)`).option(`-u, --url <url>`,`Connect the REPL to an existing server URL`,o).addHelpText(`after`,`
 You can also pass a bare URL as the only argument, for example: ash dev https://example.com
 `).action(async e=>{let t=b(e),{loadDevelopmentEnvironmentFiles:i}=await import(`./dev/environment.js`);if(i(s),t){if(r.log(n(S,{message:`REPL connecting to ${t}`,tag:`dev`,tone:`info`})),!v()){r.log(n(S,{message:`Interactive REPL disabled because the current terminal is not a TTY.`,tag:`dev`,tone:`warning`}));return}r.log(``),await(a.runDevelopmentRepl??await u())({serverUrl:t});return}let o=await(a.startHost??await f())(s,{host:e.host,port:e.port,schedules:e.schedules===!0}),c=!1,l=async()=>{c||(c=!0,await o.close())};try{if(r.log(n(S,{message:`server listening at ${o.url}`,tag:`dev`,tone:`success`})),e.repl===!1)return await g({close:l});if(!v())return r.log(n(S,{message:`Interactive REPL disabled because the current terminal is not a TTY.`,tag:`dev`,tone:`warning`})),await g({close:l});r.log(``),await(a.runDevelopmentRepl??await u())({serverUrl:o.url})}finally{await l()}}),x.command(`info`).description(`Print resolved application information.`).action(async()=>{await(a.printApplicationInfo??await l())(r,s)}),x.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(a.runEvalCommand??await d())(e,r)}),x}async function S(e=process.argv.slice(2),t=console,n={}){let r=x(t,n),i=e.length===0?[`info`]:y(e);try{await r.parseAsync(i,{from:`user`})}catch(e){if(e instanceof a){if(e.exitCode===0)return;throw Error(e.message)}throw e}}export{S as runCli};

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

@@ -9,10 +9,10 @@ import type { ChannelRouteIdentityMap } from "#compiler/normalize-schedule.js";
  * entry so the runtime can short-circuit channel registration without
  * losing the source path for diagnostics.
  *
- * For CompiledChannel values (produced by `defineChannel()`), each route
- * in the `routes` array becomes a separate compiled channel entry. The
- * channel name is derived from the filesystem path as before; the URL
- * path comes from the route's `path` field.
+ * Authored channels are always `CompiledChannel` values (from
+ * `defineChannel`). Each route in the channel's `routes` array becomes
+ * a separate compiled channel entry. The channel name is derived from
+ * 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[]>;
 /**

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

@@ -1,9 +1,8 @@
 import { join, resolve } from "node:path";
 import { stripLogicalPathExtension } from "#discover/filesystem.js";
-import { isCompiledChannel, normalizeChannelDefinition, } from "#internal/authored-definition/channel.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 { deriveChannelUrlPath } from "#compiler/channel-url.js";
 import { loadModuleBackedDefinition } from "#compiler/normalize-helpers.js";
 /**
  * Compiles one authored channel module into the normalized channel
@@ -13,10 +12,10 @@ import { loadModuleBackedDefinition } from "#compiler/normalize-helpers.js";
  * entry so the runtime can short-circuit channel registration without
  * losing the source path for diagnostics.
  *
- * For CompiledChannel values (produced by `defineChannel()`), each route
- * in the `routes` array becomes a separate compiled channel entry. The
- * channel name is derived from the filesystem path as before; the URL
- * path comes from the route's `path` field.
+ * Authored channels are always `CompiledChannel` values (from
+ * `defineChannel`). Each route in the channel's `routes` array becomes
+ * a separate compiled channel entry. The channel name is derived from
+ * the filesystem path; the URL path comes from the route's `path` field.
  */
 export async function compileChannelDefinition(agentRoot, source) {
     const rawValue = await loadModuleBackedDefinition({
@@ -33,28 +32,16 @@ export async function compileChannelDefinition(agentRoot, source) {
         };
     }
     const definition = normalizeChannelDefinition(rawValue, `Expected the channel export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public Ash shape.`);
-    if (isCompiledChannel(definition)) {
-        return definition.routes.map((route) => ({
-            kind: "channel",
-            name: channelName,
-            logicalPath: source.logicalPath,
-            method: route.method.toUpperCase(),
-            urlPath: route.path,
-            sourceId: source.sourceId,
-            sourceKind: "module",
-            exportName: source.exportName,
-        }));
-    }
-    return {
+    return definition.routes.map((route) => ({
         kind: "channel",
         name: channelName,
         logicalPath: source.logicalPath,
-        method: definition.method ?? "POST",
-        urlPath: deriveChannelUrlPath(channelName),
+        method: route.method.toUpperCase(),
+        urlPath: route.path,
         sourceId: source.sourceId,
         sourceKind: "module",
         exportName: source.exportName,
-    };
+    }));
 }
 /**
  * Loads all channel modules and builds a map from route object identity

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

@@ -1 +1 @@
-import{n as e}from"../../chunks/paths-DvimrhJF.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-CsF9KDv8.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.1";
+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/{http.d.ts → ash.d.ts}

@@ -1,8 +1,8 @@
 import { type AuthFn } from "#public/channels/auth.js";
 import { type UploadPolicy } from "#public/channels/upload-policy.js";
 import { type Channel } from "#public/definitions/defineChannel.js";
-export interface HttpRouteInput {
+export interface AshChannelInput {
     readonly auth: AuthFn<Request>;
     readonly uploadPolicy?: Partial<UploadPolicy>;
 }
-export declare function httpChannel(input: HttpRouteInput): Channel;
+export declare function ashChannel(input: AshChannelInput): Channel;

package/dist/src/public/channels/{http.js → ash.js}

@@ -3,7 +3,7 @@ import { isInputResponse } from "#runtime/input/types.js";
 import { createUnauthorizedResponse } from "#public/channels/auth.js";
 import { collectUploadPolicyViolations, formatUploadPolicyViolation, mergeUploadPolicy, } from "#public/channels/upload-policy.js";
 import { defineChannel, POST, GET } from "#public/definitions/defineChannel.js";
-export function httpChannel(input) {
+export function ashChannel(input) {
     const uploadPolicy = mergeUploadPolicy(input.uploadPolicy);
     return defineChannel({
         routes: [
@@ -28,7 +28,7 @@ export function httpChannel(input) {
                 const policyRejection = checkUploadPolicy(body, uploadPolicy);
                 if (policyRejection !== null)
                     return policyRejection;
-                const token = `http:${crypto.randomUUID()}`;
+                const token = `ash:${crypto.randomUUID()}`;
                 const messageText = typeof body.message === "string"
                     ? body.message
                     : body.message

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/framework-channels/index.d.ts

@@ -1,4 +1,4 @@
 import type { ResolvedChannelDefinition } from "#runtime/types.js";
-export declare const HTTP_CHANNEL_NAME = "default";
+export declare const ASH_CHANNEL_NAME = "ash";
 export declare function getFrameworkChannelDefinitions(): readonly ResolvedChannelDefinition[];
 export declare function getAllFrameworkChannelNames(): ReadonlySet<string>;

package/dist/src/runtime/framework-channels/index.js

@@ -1,14 +1,14 @@
 import { none, vercelOidc } from "#public/channels/auth.js";
-import { httpChannel } from "#public/channels/http.js";
+import { ashChannel } from "#public/channels/ash.js";
 import { getConnectionCallbackChannelDefinitions, getConnectionCallbackChannelNames, } from "#runtime/connections/callback-route.js";
-export const HTTP_CHANNEL_NAME = "default";
+export const ASH_CHANNEL_NAME = "ash";
 export function getFrameworkChannelDefinitions() {
-    const auth = resolveFrameworkHttpAuth();
-    const compiled = httpChannel({ auth });
+    const auth = resolveFrameworkAshAuth();
+    const compiled = ashChannel({ auth });
     const result = [];
     for (const route of compiled.routes) {
         result.push({
-            name: HTTP_CHANNEL_NAME,
+            name: ASH_CHANNEL_NAME,
             method: route.method.toUpperCase(),
             urlPath: route.path,
             fetch: async (req, ctx) => route.handler(req, ctx),
@@ -23,9 +23,9 @@ export function getFrameworkChannelDefinitions() {
     return result;
 }
 export function getAllFrameworkChannelNames() {
-    return new Set([HTTP_CHANNEL_NAME, ...getConnectionCallbackChannelNames()]);
+    return new Set([ASH_CHANNEL_NAME, ...getConnectionCallbackChannelNames()]);
 }
-function resolveFrameworkHttpAuth() {
+function resolveFrameworkAshAuth() {
     if (process.env.VERCEL) {
         return vercelOidc();
     }

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>;