experimental-ash 0.18.3 → 0.19.0

package/dist/src/chunks/{prewarm-CQYfka30.js → prewarm-DEymC5M-.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-Dwv0Eash.js";import{t as m}from"./authored-module-loader-XcFLnl49.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-BBleOGpa.js";import{t as m}from"./authored-module-loader-XcFLnl49.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,hasRun:e.hasRun,logicalPath:e.logicalPath,name:e.name,sourceId:e.sourceId,sourceKind:e.sourceKind};return e.markdown===void 0?t:{...t,markdown:e.markdown}})}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-Dwv0Eash.js";import{d as a,f as o,h as s}from"../../chunks/types-MZUhN0Zy.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-BBleOGpa.js";import{d as a,f as o,h as s}from"../../chunks/types-MZUhN0Zy.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-C19hLVqS.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-C19hLVqS.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{loadDevelopmentEnvironmentFiles:e}=await import(`./dev/environment.js`);e(s);let t=await(a.buildHost??await c())(s);r.log(n(S,{message:`built output at ${t}`,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-e2GUqnTr.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-e2GUqnTr.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{loadDevelopmentEnvironmentFiles:e}=await import(`./dev/environment.js`);e(s);let t=await(a.buildHost??await c())(s);r.log(n(S,{message:`built output at ${t}`,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/compiled/.vendor-stamp.json

@@ -20,5 +20,5 @@
     "zod": "4.4.3",
     "zod-validation-error": "5.0.0"
   },
-  "scriptHash": "643a5ee0bb5b169298d682303a7fae206d573de0d39408d97972b7c54602186b"
+  "scriptHash": "1244a77b7b22e52bfa6dbbec96a326a7ae4af318c49f1f947fb3e72ef19f65b9"
 }

package/dist/src/compiled/@vercel/sandbox/index.d.ts

@@ -38,11 +38,16 @@ export interface SandboxUpdateParams {
 }
 
 export interface SandboxCreateOptions {
+  env?: Record<string, string> | undefined;
   name?: string | undefined;
   networkPolicy?: NetworkPolicy | undefined;
   persistent?: boolean | undefined;
-  source?: unknown;
+  ports?: number[] | undefined;
+  resources?: { vcpus?: number | undefined } | undefined;
+  runtime?: string | undefined;
   signal?: AbortSignal | undefined;
+  snapshotExpiration?: number | undefined;
+  source?: unknown;
   tags?: Record<string, string> | undefined;
   timeout?: number | undefined;
 }

package/dist/src/context/hook-lifecycle.js

@@ -100,9 +100,13 @@ export async function dispatchHookLifecycle(input) {
             }
         }
     }
+    const channelContext = input.input.modelContext ?? [];
+    const mergedModelContext = channelContext.length === 0 ? modelContext : [...channelContext, ...modelContext];
     return {
         kind: "proceed",
-        input: modelContext.length > 0 ? { ...input.input, modelContext } : input.input,
+        input: mergedModelContext.length > 0
+            ? { ...input.input, modelContext: mergedModelContext }
+            : input.input,
         nextSession: input.session,
     };
 }

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

@@ -1 +1 @@
-import{n as e}from"../../chunks/paths-Dwv0Eash.js";import{loadDevelopmentEnvironmentFiles as t}from"../../cli/dev/environment.js";import{a as n,n as r,t as i}from"../../chunks/client-CKsU8Li3.js";import{n as a}from"../../chunks/host-C19hLVqS.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-BBleOGpa.js";import{loadDevelopmentEnvironmentFiles as t}from"../../cli/dev/environment.js";import{a as n,n as r,t as i}from"../../chunks/client-CKsU8Li3.js";import{n as a}from"../../chunks/host-e2GUqnTr.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/execution/sandbox/bindings/local.d.ts

@@ -1,9 +1,22 @@
 import type { SandboxBackend } from "#public/definitions/sandbox-backend.js";
+import type { LocalSandboxCreateOptions } from "#public/sandbox/local-sandbox.js";
+/**
+ * Construction input for {@link createLocalSandboxBackend}. Internal —
+ * the public surface is the `localBackend()` factory under
+ * `experimental-ash/sandbox`.
+ */
+export interface CreateLocalSandboxBackendInput {
+    readonly createOptions?: LocalSandboxCreateOptions;
+}
 /**
  * Creates the local just-bash-backed sandbox backend.
  *
  * The cache directory is derived from the runtime context's `appRoot`
  * on every `create` call so the backend stays stateless and matches
  * the framework's per-call dispatch contract.
+ *
+ * Accepts `createOptions` for parity with other backends; the local
+ * backend currently has no consumer-controllable create options so the
+ * value is reserved for future widening of {@link LocalSandboxCreateOptions}.
  */
-export declare function createLocalSandboxBackend(): SandboxBackend;
+export declare function createLocalSandboxBackend(_input?: CreateLocalSandboxBackendInput): SandboxBackend;

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

@@ -13,8 +13,12 @@ const LOCAL_SANDBOX_SNAPSHOT_VERSION = 1;
  * The cache directory is derived from the runtime context's `appRoot`
  * on every `create` call so the backend stays stateless and matches
  * the framework's per-call dispatch contract.
+ *
+ * Accepts `createOptions` for parity with other backends; the local
+ * backend currently has no consumer-controllable create options so the
+ * value is reserved for future widening of {@link LocalSandboxCreateOptions}.
  */
-export function createLocalSandboxBackend() {
+export function createLocalSandboxBackend(_input = {}) {
     return {
         name: "local",
         async prewarm(prewarmInput) {

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

@@ -13,10 +13,16 @@ export type VercelSandboxCreateOptions = Omit<NonNullable<Parameters<typeof SdkS
  * `experimental-ash/sandbox`.
  */
 export interface CreateVercelSandboxBackendInput {
+    readonly createOptions?: VercelSandboxCreateOptions;
     readonly loadSandboxModule?: () => Promise<VercelSandboxModule>;
 }
 /**
  * Creates the Vercel-backed sandbox backend.
+ *
+ * Any author-supplied `createOptions` are forwarded to the Vercel SDK
+ * `Sandbox.create(...)` for every fresh sandbox the framework creates
+ * (template at prewarm time, session at first-time session-create). On
+ * resume (`Sandbox.get`) no create happens, so they are not re-applied.
  */
 export declare function createVercelSandboxBackend(input?: CreateVercelSandboxBackendInput): SandboxBackend<VercelSandboxBootstrapUseOptions, VercelSandboxSessionUseOptions>;
 export {};

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

@@ -4,11 +4,17 @@ import { buildSandboxSession } from "#execution/sandbox/session.js";
 import { streamToBuffer } from "#execution/sandbox/stream-utils.js";
 /**
  * Creates the Vercel-backed sandbox backend.
+ *
+ * Any author-supplied `createOptions` are forwarded to the Vercel SDK
+ * `Sandbox.create(...)` for every fresh sandbox the framework creates
+ * (template at prewarm time, session at first-time session-create). On
+ * resume (`Sandbox.get`) no create happens, so they are not re-applied.
  */
 export function createVercelSandboxBackend(input = {}) {
     const loadSandboxModule = input.loadSandboxModule ?? (async () => await import("#compiled/@vercel/sandbox/index.js"));
     const createOptions = {
         timeout: DEFAULT_SANDBOX_TIMEOUT_MS,
+        ...input.createOptions,
     };
     const prewarmedTemplates = new Map();
     return {
@@ -150,8 +156,13 @@ async function ensureSession(input) {
         await ensureVercelSandboxTags(existing, input.tags);
         return existing;
     }
+    // The Vercel SDK rejects `runtime` when `source` is a snapshot — the
+    // runtime is already baked into the snapshot's filesystem. Strip it
+    // from the consumer-supplied create options for the session path
+    // only; template prewarm still honors `runtime`.
+    const { runtime: _runtime, ...sessionCreateOptions } = input.createOptions;
     const createParams = {
-        ...input.createOptions,
+        ...sessionCreateOptions,
         name: sandboxName,
         persistent: true,
         source: { snapshotId: input.snapshotId, type: "snapshot" },

package/dist/src/execution/sandbox/lazy-backend.d.ts

@@ -0,0 +1,15 @@
+import type { SandboxBackend } from "#public/definitions/sandbox-backend.js";
+/**
+ * Wraps a backend-producing function in a `SandboxBackend` proxy that
+ * invokes the function exactly once, on first access to any of `.name`,
+ * `.create`, or `.prewarm`. Subsequent accesses return the same cached
+ * underlying backend.
+ *
+ * Used by `defaultBackend()` for env-conditional selection, and by the
+ * authored-definition normalizer when an author passes a callback to
+ * `SandboxDefinition.backend` (e.g. `backend: () => vercelBackend({...})`)
+ * so the factory runs at first use rather than at module load — while
+ * still preserving backend-internal state (such as the Vercel backend's
+ * prewarmed-templates map) across every framework call.
+ */
+export declare function lazyBackend<BO, SO>(factory: () => SandboxBackend<BO, SO>): SandboxBackend<BO, SO>;

package/dist/src/execution/sandbox/lazy-backend.js

@@ -0,0 +1,33 @@
+/**
+ * Wraps a backend-producing function in a `SandboxBackend` proxy that
+ * invokes the function exactly once, on first access to any of `.name`,
+ * `.create`, or `.prewarm`. Subsequent accesses return the same cached
+ * underlying backend.
+ *
+ * Used by `defaultBackend()` for env-conditional selection, and by the
+ * authored-definition normalizer when an author passes a callback to
+ * `SandboxDefinition.backend` (e.g. `backend: () => vercelBackend({...})`)
+ * so the factory runs at first use rather than at module load — while
+ * still preserving backend-internal state (such as the Vercel backend's
+ * prewarmed-templates map) across every framework call.
+ */
+export function lazyBackend(factory) {
+    let resolved;
+    function resolve() {
+        if (resolved === undefined) {
+            resolved = factory();
+        }
+        return resolved;
+    }
+    return {
+        get name() {
+            return resolve().name;
+        },
+        create(input) {
+            return resolve().create(input);
+        },
+        async prewarm(input) {
+            await resolve().prewarm(input);
+        },
+    };
+}

package/dist/src/execution/workflow-entry.d.ts

@@ -1,4 +1,4 @@
-import type { UserContent } from "ai";
+import type { RunInput } from "#channel/types.js";
 /**
  * Serializable input for the workflow entrypoint.
  *
@@ -9,9 +9,7 @@ import type { UserContent } from "ai";
  * the serialized record.
  */
 export interface WorkflowEntryInput {
-    readonly input: {
-        readonly message: string | UserContent;
-    };
+    readonly input: RunInput["input"];
     readonly serializedContext: Record<string, unknown>;
 }
 /**

package/dist/src/execution/workflow-entry.js

@@ -41,7 +41,7 @@ export async function workflowEntry(input) {
             capabilities,
             initialInput: {
                 kind: "deliver",
-                payloads: [{ message: input.input.message }],
+                payloads: [{ message: input.input.message, modelContext: input.input.modelContext }],
             },
             mode,
             serializedContext: input.serializedContext,

package/dist/src/harness/messages.js

@@ -14,6 +14,10 @@ export function coalesceTurnInputs(a, b) {
         a: a.message,
         b: b.message,
     });
+    const modelContext = coalesceModelContext({
+        a: a.modelContext,
+        b: b.modelContext,
+    });
     const result = {};
     if (inputResponses !== undefined) {
         result.inputResponses = inputResponses;
@@ -21,6 +25,9 @@ export function coalesceTurnInputs(a, b) {
     if (message !== undefined) {
         result.message = message;
     }
+    if (modelContext !== undefined) {
+        result.modelContext = modelContext;
+    }
     return result;
 }
 /**
@@ -73,6 +80,14 @@ function coalesceInputResponses(input) {
     }
     return [...a, ...b];
 }
+function coalesceModelContext(input) {
+    const a = input.a ?? [];
+    const b = input.b ?? [];
+    if (a.length === 0 && b.length === 0) {
+        return undefined;
+    }
+    return [...a, ...b];
+}
 /**
  * Merges two optional turn messages into one.
  *

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

@@ -79,13 +79,12 @@ export interface StepInput {
     readonly inputResponses?: readonly InputResponse[];
     readonly message?: string | UserContent;
     /**
-     * Ephemeral messages contributed by lifecycle hooks (via the
-     * `modelContext` field on a {@link LifecycleHookResult}), appended to
-     * the next model call's message list and never persisted to durable
-     * session history.
-     *
-     * Internal to the execution/harness boundary; never produced by
-     * channels.
+     * Ephemeral messages appended to the next model call and never
+     * persisted to durable session history. Populated by channels via
+     * `SendPayload.modelContext` and by lifecycle hooks via the
+     * `modelContext` field on a `LifecycleHookResult`. Channel-provided
+     * messages appear first, then session-hook messages, then turn-hook
+     * messages.
      */
     readonly modelContext?: readonly ModelMessage[];
     /**

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.18.3";
+const BUNDLED_FALLBACK_PACKAGE_VERSION = "0.19.0";
 const BUNDLED_FALLBACK_PACKAGE_VERSION_PLACEHOLDER = "__ASH_PACKAGE_VERSION_PLACEHOLDER__";
 const WORKFLOW_MODULE_ALIASES = {
     "workflow/api": "src/compiled/@workflow/core/runtime.js",

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

@@ -1,9 +1,15 @@
+import type { SandboxBackend } from "#public/definitions/sandbox-backend.js";
 import type { SandboxDefinition } from "#public/definitions/sandbox.js";
-export type NormalizedSandboxDefinition = Readonly<SandboxDefinition> & {
+export type NormalizedSandboxDefinition = Readonly<Omit<SandboxDefinition, "backend">> & {
+    readonly backend?: SandboxBackend;
     readonly description?: string;
 };
 /**
  * Normalizes one authored sandbox definition into the canonical internal
- * shape.
+ * shape. If the author supplied a `backend` callback (e.g.
+ * `backend: () => vercelBackend({...})`), it is wrapped via
+ * {@link lazyBackend} so downstream consumers always see a plain
+ * `SandboxBackend` value — the callback fires exactly once on first
+ * access and the resulting backend is memoized.
  */
 export declare function normalizeSandboxDefinition(value: unknown, message: string): NormalizedSandboxDefinition;

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

@@ -1,7 +1,12 @@
 import { expectFunction, expectObjectRecord, expectOnlyKnownKeys, } from "#internal/authored-module.js";
+import { lazyBackend } from "#execution/sandbox/lazy-backend.js";
 /**
  * Normalizes one authored sandbox definition into the canonical internal
- * shape.
+ * shape. If the author supplied a `backend` callback (e.g.
+ * `backend: () => vercelBackend({...})`), it is wrapped via
+ * {@link lazyBackend} so downstream consumers always see a plain
+ * `SandboxBackend` value — the callback fires exactly once on first
+ * access and the resulting backend is memoized.
  */
 export function normalizeSandboxDefinition(value, message) {
     const record = expectObjectRecord(value, message);
@@ -25,7 +30,10 @@ export function normalizeSandboxDefinition(value, message) {
     return definition;
 }
 function expectSandboxBackend(value, message) {
-    const record = expectObjectRecord(value, `${message} The "backend" field must be a SandboxBackend value (use vercelBackend(), localBackend(), or your own factory).`);
+    if (typeof value === "function") {
+        return lazyBackend(value);
+    }
+    const record = expectObjectRecord(value, `${message} The "backend" field must be a SandboxBackend value (use vercelBackend(), localBackend(), or your own factory) or a zero-arg function returning one.`);
     if (typeof record.name !== "string" || record.name.length === 0) {
         throw new Error(`${message} The "backend" value must expose a non-empty string "name" identifier.`);
     }

package/dist/src/public/channels/slack/index.d.ts

@@ -1,6 +1,9 @@
+export type { ModelMessage } from "ai";
 export { slackChannel, type SlackApiResponse, type SlackBotToken, type SlackChannel, type SlackChannelConfig, type SlackChannelCredentials, type SlackChannelEvents, type SlackChannelState, type SlackContext, type SlackEventContext, type SlackHandle, type SlackInboundResult, type SlackInboundResultOrPromise, type SlackInitialMessage, type SlackInteractionAction, type SlackMentionResult, type SlackMentionResultOrPromise, type SlackReceiveArgs, type SlackThread, type SlackWebhookVerifier, } from "#public/channels/slack/slackChannel.js";
 export type { SlackAttachment, SlackAuthor, SlackInboundContext, SlackMessage, } from "#public/channels/slack/inbound.js";
 export { slackContinuationToken, type SlackPostInput, type SlackPostedMessage, type SlackThreadMessage, type SlackUploadFilesOptions, type SlackUploadFilesResult, } from "#public/channels/slack/api.js";
+export { defaultSlackAuth } from "#public/channels/slack/defaults.js";
+export { loadThreadContextMessages, type LoadThreadContextMessagesOptions, type ThreadContextSince, } from "#public/channels/slack/thread.js";
 export { cardToBlocks, cardToFallbackText, type BlockKitBlock, } from "#public/channels/slack/blocks.js";
 /**
  * Card builders and element types re-exported from the vendored chat

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

@@ -1,5 +1,7 @@
 export { slackChannel, } from "#public/channels/slack/slackChannel.js";
 export { slackContinuationToken, } from "#public/channels/slack/api.js";
+export { defaultSlackAuth } from "#public/channels/slack/defaults.js";
+export { loadThreadContextMessages, } from "#public/channels/slack/thread.js";
 export { cardToBlocks, cardToFallbackText, } from "#public/channels/slack/blocks.js";
 /**
  * Card builders and element types re-exported from the vendored chat

package/dist/src/public/channels/slack/slackChannel.d.ts

@@ -1,3 +1,4 @@
+import type { ModelMessage } from "ai";
 import type { TypedReceiveRoute } from "#channel/receive-args.js";
 import type { SessionHandle } from "#channel/session.js";
 import type { SessionAuthContext } from "#channel/types.js";
@@ -158,12 +159,19 @@ export interface SlackInteractionUser {
     readonly name?: string;
 }
 /**
- * Result of an `onAppMention` or `onDirectMessage` callback. Return
- * `{ auth }` (auth may be `null`) to dispatch a turn with that session
- * auth context, or `null` to silently drop the inbound message.
+ * Result of an `onAppMention` or `onDirectMessage` callback. Return an
+ * object (auth may be `null`) to dispatch a turn, or `null` to silently
+ * drop the inbound message.
+ *
+ * `modelContext` mirrors lifecycle hook results: it contributes
+ * ephemeral messages to the next model call only, without writing them
+ * to durable session history. Use `role: "system"` for Slack thread
+ * background context so it lands before the user's mention; see
+ * `docs/public/channels/slack.md`.
  */
 export type SlackMentionResult = {
-    auth: SessionAuthContext | null;
+    readonly auth: SessionAuthContext | null;
+    readonly modelContext?: readonly ModelMessage[];
 } | null;
 export type SlackMentionResultOrPromise = SlackMentionResult | Promise<SlackMentionResult>;
 /**

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

@@ -230,7 +230,10 @@ async function dispatchInboundMessage(input) {
         ? prependSlackContext(baseMessage, inboundContext)
         : baseMessage;
     try {
-        await input.send(turnMessage, {
+        await input.send({
+            message: turnMessage,
+            modelContext: result.modelContext,
+        }, {
             auth: result.auth,
             continuationToken: slackContinuationToken(message.channelId, message.threadTs),
             state: {

package/dist/src/public/channels/slack/thread.d.ts

@@ -0,0 +1,26 @@
+import type { SlackThread, SlackThreadMessage } from "#public/channels/slack/api.js";
+export type ThreadContextSince = "thread-root" | "last-agent-reply" | ((message: SlackThreadMessage) => boolean);
+export interface LoadThreadContextMessagesOptions {
+    /**
+     * Boundary for returned context messages. Defaults to `"thread-root"`.
+     *
+     * Use `"last-agent-reply"` to include only user/thread messages
+     * since the last agent-authored Slack reply. Pass a predicate
+     * function for custom boundaries, such as "since the last message
+     * that mentioned a particular user".
+     */
+    readonly since?: ThreadContextSince;
+}
+/**
+ * Loads messages that are useful as background context for the current
+ * Slack thread turn.
+ *
+ * Returns an empty array when `message` is the thread root. For thread
+ * replies, refreshes the bound Slack thread and returns its recent
+ * messages before the triggering message, filtered by {@link options}.
+ * Formatting and model-message role choice stay with the caller.
+ */
+export declare function loadThreadContextMessages(thread: Pick<SlackThread, "recentMessages" | "refresh">, message: {
+    readonly threadTs: string;
+    readonly ts: string;
+}, options?: LoadThreadContextMessagesOptions): Promise<SlackThreadMessage[]>;

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

@@ -0,0 +1,45 @@
+/**
+ * Loads messages that are useful as background context for the current
+ * Slack thread turn.
+ *
+ * Returns an empty array when `message` is the thread root. For thread
+ * replies, refreshes the bound Slack thread and returns its recent
+ * messages before the triggering message, filtered by {@link options}.
+ * Formatting and model-message role choice stay with the caller.
+ */
+export async function loadThreadContextMessages(thread, message, options = {}) {
+    if (isThreadRootMessage(message)) {
+        return [];
+    }
+    await thread.refresh();
+    const currentIndex = thread.recentMessages.findIndex((entry) => entry.ts === message.ts);
+    const candidateMessages = currentIndex === -1 ? thread.recentMessages : thread.recentMessages.slice(0, currentIndex);
+    const priorMessages = candidateMessages.filter((entry) => entry.threadTs === message.threadTs && entry.ts !== message.ts);
+    return applySinceBoundary(priorMessages, options.since);
+}
+function isThreadRootMessage(message) {
+    return message.threadTs === message.ts;
+}
+function findLastIndex(items, predicate) {
+    for (let index = items.length - 1; index >= 0; index -= 1) {
+        if (predicate(items[index])) {
+            return index;
+        }
+    }
+    return -1;
+}
+function applySinceBoundary(messages, since) {
+    const boundary = since ?? "thread-root";
+    if (typeof boundary === "function") {
+        const lastMatchingIndex = findLastIndex(messages, boundary);
+        return messages.slice(lastMatchingIndex + 1);
+    }
+    switch (boundary) {
+        case "thread-root":
+            return [...messages];
+        case "last-agent-reply": {
+            const lastAgentReplyIndex = findLastIndex(messages, (entry) => entry.isMe);
+            return messages.slice(lastAgentReplyIndex + 1);
+        }
+    }
+}

package/dist/src/public/sandbox/backends/default.d.ts

@@ -1,7 +1,22 @@
 import type { SandboxBackend } from "#public/definitions/sandbox-backend.js";
+import type { LocalSandboxCreateOptions } from "#public/sandbox/local-sandbox.js";
+import type { VercelSandboxCreateOptions } from "#public/sandbox/vercel-sandbox.js";
+/**
+ * Input to {@link defaultBackend}: a separate options bag per inner
+ * backend. The framework picks one bag at runtime based on `process.env.VERCEL`
+ * and passes it to the chosen factory; the other is ignored.
+ */
+export interface DefaultBackendOptions {
+    readonly local?: LocalSandboxCreateOptions;
+    readonly vercel?: VercelSandboxCreateOptions;
+}
 /**
  * Constructs an env-aware sandbox backend that delegates to
  * {@link vercelBackend} on hosted Vercel (where `process.env.VERCEL`
  * is truthy) and to {@link localBackend} everywhere else.
+ *
+ * Optionally accepts a keyed options bag (`{ local, vercel }`) so each
+ * inner backend receives its own typed create options without forcing
+ * authors to pin to one backend up front.
  */
-export declare function defaultBackend(): SandboxBackend;
+export declare function defaultBackend(opts?: DefaultBackendOptions): SandboxBackend;

package/dist/src/public/sandbox/backends/default.js

@@ -1,27 +1,15 @@
+import { lazyBackend } from "#execution/sandbox/lazy-backend.js";
 import { localBackend } from "#public/sandbox/backends/local.js";
 import { vercelBackend } from "#public/sandbox/backends/vercel.js";
 /**
  * Constructs an env-aware sandbox backend that delegates to
  * {@link vercelBackend} on hosted Vercel (where `process.env.VERCEL`
  * is truthy) and to {@link localBackend} everywhere else.
+ *
+ * Optionally accepts a keyed options bag (`{ local, vercel }`) so each
+ * inner backend receives its own typed create options without forcing
+ * authors to pin to one backend up front.
  */
-export function defaultBackend() {
-    let resolved;
-    function resolve() {
-        if (resolved === undefined) {
-            resolved = process.env.VERCEL ? vercelBackend() : localBackend();
-        }
-        return resolved;
-    }
-    return {
-        get name() {
-            return resolve().name;
-        },
-        create(input) {
-            return resolve().create(input);
-        },
-        async prewarm(input) {
-            await resolve().prewarm(input);
-        },
-    };
+export function defaultBackend(opts) {
+    return lazyBackend(() => process.env.VERCEL ? vercelBackend(opts?.vercel) : localBackend(opts?.local));
 }

package/dist/src/public/sandbox/backends/local.d.ts

@@ -1,4 +1,5 @@
 import type { SandboxBackend } from "#public/definitions/sandbox-backend.js";
+import type { LocalSandboxCreateOptions } from "#public/sandbox/local-sandbox.js";
 /**
  * Constructs the built-in local sandbox backend.
  *
@@ -7,8 +8,10 @@ import type { SandboxBackend } from "#public/definitions/sandbox-backend.js";
  * under the application root. It is the default backend on developer
  * machines (`pnpm ash dev`).
  *
- * Takes no arguments today — `just-bash` does not currently expose any
- * configuration that's worth surfacing through ash. New options would
- * be added here as the underlying runtime grows.
+ * Accepts an `opts` parameter for parity with other backends, but
+ * `LocalSandboxCreateOptions` is empty today — `just-bash` does not
+ * currently expose any configuration worth surfacing. New options would
+ * be added by widening `LocalSandboxCreateOptions` and routing them
+ * into the binding without changing this signature.
  */
-export declare function localBackend(): SandboxBackend;
+export declare function localBackend(opts?: LocalSandboxCreateOptions): SandboxBackend;