experimental-ash 0.26.0 → 0.27.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # experimental-ash
 
+## 0.27.0
+
+### Minor Changes
+
+- df26312: Rebuilt the published package with a single rolldown asset pipeline (oxc-minify under the hood). All shipped JS is now minified and comment-stripped. `picocolors`, `commander`, `chokidar`, `gray-matter`, and `@vercel/oidc` are now vendored under `#compiled/*` rather than relied on as devDependencies. Public API and dist file layout are unchanged; tarball is smaller.
+- 7edf12e: Add remote Ash subagents through `defineRemoteAgent({ url, description, auth, headers, path })`. Remote subagents are authored under `agent/subagents/`, lower to the same `{ message: string }` tool shape as local subagents, start task-mode sessions on another Ash deployment, and resume the caller through the framework callback route. The smoke suite now covers happy-path remote delegation, non-destructive remote start failures, and callee terminal callback retry.
+
 ## 0.26.0
 
 ### Minor Changes

package/dist/docs/public/subagents.md

@@ -46,6 +46,44 @@ export default defineAgent({
 not declare one — without it, the parent agent has nothing to read when deciding whether to
 delegate.
 
+## Remote Ash Subagents
+
+Use `defineRemoteAgent` when the child agent is another Ash deployment instead of a local directory.
+The file still lives under `agent/subagents/`, so its tool name is still derived from the path.
+
+`agent/subagents/weather.ts`
+
+```ts
+import { defineRemoteAgent } from "experimental-ash";
+import { vercelOidc } from "experimental-ash/agents/auth";
+
+export default defineRemoteAgent({
+  url: "https://weather-agent.example.com",
+  description: "Answers weather, temperature, forecast, wind, rain, and snow questions.",
+  auth: vercelOidc(),
+});
+```
+
+Remote agents use the same lowered `{ message: string }` tool shape as local subagents. The
+difference is dispatch: the parent starts a task-mode session on the remote agent's
+`POST /ash/v1/session`, passes a framework callback URL, parks the parent turn, and resumes when
+the remote agent posts a terminal callback back to the parent. The parent sees the same
+`subagent.called`, `action.result`, and successful `subagent.completed` stream events used by local
+delegation. For remote calls, `subagent.called.data.remote.url` records the target URL.
+
+`defineRemoteAgent` accepts:
+
+- `url` — remote Ash deployment root.
+- `description` — model-visible delegation description.
+- `auth` — optional outbound auth helper from `experimental-ash/agents/auth`.
+- `headers` — optional static or lazy request headers.
+- `path` — optional session-create path; defaults to `/ash/v1/session`.
+
+Remote start failures are returned to the parent as failed tool results, so the caller agent can
+explain or recover from the failure in the same session. Terminal callback delivery runs as a
+durable Workflow step on the callee; callback POST failures are rethrown so Workflow retry policy
+owns redelivery instead of marking the remote task complete.
+
 ## What The Parent Sees
 
 Ash lowers every subagent into a model-visible tool on the parent agent.

package/dist/src/_virtual/_rolldown/runtime.js

@@ -0,0 +1 @@
+import"node:module";var __create=Object.create,__defProp=Object.defineProperty,__getOwnPropDesc=Object.getOwnPropertyDescriptor,__getOwnPropNames=Object.getOwnPropertyNames,__getProtoOf=Object.getPrototypeOf,__hasOwnProp=Object.prototype.hasOwnProperty,__commonJSMin=(e,t)=>()=>(t||(e((t={exports:{}}).exports,t),e=null),t.exports),__exportAll=(e,n)=>{let r={};for(var i in e)__defProp(r,i,{get:e[i],enumerable:!0});return n||__defProp(r,Symbol.toStringTag,{value:`Module`}),r},__copyProps=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=__getOwnPropNames(i),l=0,u=c.length,d;l<u;l++)d=c[l],!__hasOwnProp.call(e,d)&&d!==o&&__defProp(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=__getOwnPropDesc(i,d))||s.enumerable});return e},__toESM=(n,r,a)=>(a=n==null?{}:__create(__getProtoOf(n)),__copyProps(r||!n||!n.__esModule?__defProp(a,`default`,{value:n,enumerable:!0}):a,n));import.meta.url;export{__commonJSMin,__exportAll,__toESM};

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

@@ -1,24 +1 @@
-import { buildSessionHandle } from "#channel/session.js";
-/**
- * Builds the {@link ChannelAdapterContext} the runtime hands to an
- * adapter's `deliver` hook, event handlers, and attachment resolver.
- *
- * Populates `session` with a live {@link SessionHandle} backed by the
- * supplied accessor so handlers can read identity / auth and call
- * `setContinuationToken(...)` to re-key the parked session.
- */
-export function buildAdapterContext(adapter, accessor) {
-    // `adapter.state` is stored loosely (`Record<string, unknown>`)
-    // because it round-trips through JSON at step boundaries. The
-    // adapter is responsible for seeding state in the shape its
-    // `createAdapterContext` / handlers expect, so the cast to the
-    // narrower `TCtx`-derived state is safe at this seam.
-    const baseCtx = {
-        ctx: accessor,
-        state: adapter.state ?? {},
-        session: buildSessionHandle(accessor),
-    };
-    return adapter.createAdapterContext
-        ? adapter.createAdapterContext(baseCtx)
-        : baseCtx;
-}
+import{buildSessionHandle}from"#channel/session.js";function buildAdapterContext(e,t){let n={ctx:t,state:e.state??{},session:buildSessionHandle(t)};return e.createAdapterContext?e.createAdapterContext(n):n}export{buildAdapterContext};

package/dist/src/channel/adapter.js

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

package/dist/src/channel/compiled-channel.js

@@ -1,6 +1 @@
-export const CHANNEL_SENTINEL = "ash:channel";
-export function isCompiledChannel(value) {
-    return (typeof value === "object" &&
-        value !== null &&
-        value.__kind === "ash:channel");
-}
+var CHANNEL_SENTINEL=`ash:channel`;function isCompiledChannel(e){return typeof e==`object`&&!!e&&e.__kind===`ash:channel`}export{CHANNEL_SENTINEL,isCompiledChannel};

package/dist/src/channel/cross-channel-receive.js

@@ -1,108 +1,2 @@
-import { isCompiledChannel } from "#channel/compiled-channel.js";
-import { createSendFn } from "#channel/send.js";
-/**
- * Projects an agent's resolved channels into the receiver-input shape.
- *
- * Framework-internal fetch-only channels carry no `definition` reference
- * and are filtered out at this boundary — only authored channels backed
- * by a `defineChannel` value can be receive targets.
- */
-export function toCrossChannelTargets(channels) {
-    return channels.flatMap((channel) => channel.definition === undefined
-        ? []
-        : [
-            {
-                name: channel.name,
-                definition: channel.definition,
-                receive: channel.receive,
-                adapter: channel.adapter,
-            },
-        ]);
-}
-/**
- * Builds the `args.receive` closure used by every route handler. The
- * closure resolves the target channel by reference identity against
- * the request-scoped channel bundle, then delegates to the target's
- * authored `receive` hook with a per-target `send` factory.
- */
-export function createCrossChannelReceiveFn(runtime, channels) {
-    return async (channel, options) => {
-        const target = resolveTargetByReference(channel, channels);
-        return await invokeChannelReceive({
-            runtime,
-            target,
-            input: {
-                message: options.message,
-                args: (options.args ?? {}),
-                auth: options.auth,
-            },
-            describeMissingReceive: () => `args.receive(): channel "${target.name}" does not implement receive(). ` +
-                `Declare a receive hook on the channel to accept cross-channel sessions.`,
-            describeMissingAdapter: () => `args.receive(): channel "${target.name}" has no adapter — cannot build send().`,
-        });
-    };
-}
-/**
- * Shared `receive(input, { send })` invocation used by both the route-
- * handler cross-channel surface and the schedule dispatcher. Owns the
- * receive/adapter precondition checks and the per-target `send`
- * factory so both call sites stay byte-identical.
- */
-export async function invokeChannelReceive(args) {
-    if (!args.target.receive) {
-        throw new Error(args.describeMissingReceive());
-    }
-    if (!args.target.adapter) {
-        throw new Error(args.describeMissingAdapter());
-    }
-    const send = createSendFn(args.runtime, args.target.adapter, args.target.name);
-    return await args.target.receive(args.input, { send });
-}
-function resolveTargetByReference(ref, channels) {
-    for (const channel of channels) {
-        if (channel.definition === ref) {
-            return channel;
-        }
-    }
-    const structurallyMatchedTarget = resolveTargetByRouteFingerprint(ref, channels);
-    if (structurallyMatchedTarget !== null) {
-        return structurallyMatchedTarget;
-    }
-    throw new Error("args.receive(): the channel passed as the first argument is not registered " +
-        "in this agent's channels/. Import the channel module's default export from " +
-        "agent/channels/<name>.ts and pass that value.");
-}
-function resolveTargetByRouteFingerprint(ref, channels) {
-    if (!isCompiledChannel(ref)) {
-        return null;
-    }
-    const refFingerprint = createRouteFingerprint(ref);
-    if (refFingerprint === null) {
-        return null;
-    }
-    const matches = new Map();
-    for (const channel of channels) {
-        if (createRouteFingerprint(channel.definition) !== refFingerprint) {
-            continue;
-        }
-        matches.set(channel.name, channel);
-    }
-    if (matches.size === 1) {
-        return [...matches.values()][0];
-    }
-    if (matches.size > 1) {
-        throw new Error("args.receive(): the channel passed as the first argument matches multiple " +
-            "registered channels by route shape. Import a channel with a unique route set " +
-            "from agent/channels/<name>.ts before passing it to args.receive().");
-    }
-    return null;
-}
-function createRouteFingerprint(channel) {
-    if (channel.routes.length === 0) {
-        return null;
-    }
-    const routes = channel.routes
-        .map((route) => `${route.method.toUpperCase()} ${route.path}`)
-        .sort();
-    return routes.join("\n");
-}
+import{isCompiledChannel}from"#channel/compiled-channel.js";import{createSendFn}from"#channel/send.js";function toCrossChannelTargets(e){return e.flatMap(e=>e.definition===void 0?[]:[{name:e.name,definition:e.definition,receive:e.receive,adapter:e.adapter}])}function createCrossChannelReceiveFn(e,t){return async(n,r)=>{let i=resolveTargetByReference(n,t);return await invokeChannelReceive({runtime:e,target:i,input:{message:r.message,args:r.args??{},auth:r.auth},describeMissingReceive:()=>`args.receive(): channel "${i.name}" does not implement receive(). Declare a receive hook on the channel to accept cross-channel sessions.`,describeMissingAdapter:()=>`args.receive(): channel "${i.name}" has no adapter — cannot build send().`})}}async function invokeChannelReceive(e){if(!e.target.receive)throw Error(e.describeMissingReceive());if(!e.target.adapter)throw Error(e.describeMissingAdapter());let n=createSendFn(e.runtime,e.target.adapter,e.target.name);return await e.target.receive(e.input,{send:n})}function resolveTargetByReference(e,t){for(let n of t)if(n.definition===e)return n;let n=resolveTargetByRouteFingerprint(e,t);if(n!==null)return n;throw Error(`args.receive(): the channel passed as the first argument is not registered in this agent's channels/. Import the channel module's default export from agent/channels/<name>.ts and pass that value.`)}function resolveTargetByRouteFingerprint(t,n){if(!isCompiledChannel(t))return null;let r=createRouteFingerprint(t);if(r===null)return null;let i=new Map;for(let e of n)createRouteFingerprint(e.definition)===r&&i.set(e.name,e);if(i.size===1)return[...i.values()][0];if(i.size>1)throw Error(`args.receive(): the channel passed as the first argument matches multiple registered channels by route shape. Import a channel with a unique route set from agent/channels/<name>.ts before passing it to args.receive().`);return null}function createRouteFingerprint(e){return e.routes.length===0?null:e.routes.map(e=>`${e.method.toUpperCase()} ${e.path}`).sort().join(`
+`)}export{createCrossChannelReceiveFn,invokeChannelReceive,toCrossChannelTargets};

package/dist/src/channel/http.js

@@ -1,30 +1 @@
-/**
- * Durable adapter kind for the canonical session channel and for every
- * behaviorless user-authored channel returned by the `defineChannel`
- * fast-path (no state, no `context()`, no event handlers, no `fetchFile`).
- *
- * The value is locked at `"http"` because it is persisted into durable
- * workflow state under `serializedContext["ash.channel"].kind` and into
- * sandbox telemetry tags as `channel: "http"`. Renaming the value would
- * break rehydration for every in-flight session started under any prior
- * build with "Unknown adapter kind: \"http\"". The `httpChannel` →
- * `ashChannel` rename (commit `bd3d1b43`) intentionally renamed the
- * channel identifier (file name, function name, framework constant) but
- * deliberately left this adapter kind alone — the kind labels the
- * adapter's transport class, not the channel's name, and the same slot
- * is the rehydration target for every behaviorless authored channel
- * regardless of which protocol it speaks.
- */
-export const HTTP_ADAPTER_KIND = "http";
-/**
- * Framework adapter installed for the canonical session channel and
- * for every behaviorless user-authored channel.
- *
- * Carries no behavior — it is a bare discriminator that the runtime
- * adapter registry uses to rehydrate `{ kind: "http" }` at every
- * workflow step boundary. Registered in `FRAMEWORK_ADAPTERS`
- * (`runtime/channels/registry.ts`).
- */
-export const HTTP_ADAPTER = {
-    kind: HTTP_ADAPTER_KIND,
-};
+var HTTP_ADAPTER_KIND=`http`,HTTP_ADAPTER={kind:HTTP_ADAPTER_KIND};export{HTTP_ADAPTER,HTTP_ADAPTER_KIND};

package/dist/src/channel/receive-args.js

@@ -1 +1 @@
-export {};
+export{};

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

@@ -1,59 +1 @@
-/**
- * Maps freeform text to an {@link InputResponse} for a single request.
- *
- * Emitters import this utility to resolve text-based user input against
- * pending request options. The harness and runtime do not call it.
- *
- * Resolution order:
- * 1. Exact option ID (case-insensitive)
- * 2. Exact option label (case-insensitive)
- * 3. 1-based numeric index into the options array
- * 4. Freeform text if {@link InputRequest.allowFreeform} is not `false`
- */
-export function resolveTextToResponse(text, request) {
-    const trimmed = text.trim();
-    if (trimmed.length === 0) {
-        return undefined;
-    }
-    const normalized = trimmed.toLowerCase();
-    if (request.options !== undefined && request.options.length > 0) {
-        const matched = matchOption(normalized, request.options);
-        if (matched !== undefined) {
-            return { requestId: request.requestId, optionId: matched.id };
-        }
-    }
-    const acceptsFreeform = request.allowFreeform === true || request.options === undefined || request.options.length === 0;
-    if (acceptsFreeform && trimmed.length > 0) {
-        return { requestId: request.requestId, text: trimmed };
-    }
-    return undefined;
-}
-/**
- * Resolves text against all pending requests, returning one
- * {@link InputResponse} for each request that could be matched.
- */
-export function resolveTextToResponses(text, requests) {
-    const responses = [];
-    for (const request of requests) {
-        const response = resolveTextToResponse(text, request);
-        if (response !== undefined) {
-            responses.push(response);
-        }
-    }
-    return responses;
-}
-function matchOption(normalized, options) {
-    const byId = options.find((o) => o.id.toLowerCase() === normalized);
-    if (byId !== undefined) {
-        return byId;
-    }
-    const byLabel = options.find((o) => o.label.toLowerCase() === normalized);
-    if (byLabel !== undefined) {
-        return byLabel;
-    }
-    const numericIndex = Number(normalized);
-    if (Number.isInteger(numericIndex) && numericIndex > 0 && numericIndex <= options.length) {
-        return options[numericIndex - 1];
-    }
-    return undefined;
-}
+function resolveTextToResponse(e,t){let n=e.trim();if(n.length===0)return;let r=n.toLowerCase();if(t.options!==void 0&&t.options.length>0){let e=matchOption(r,t.options);if(e!==void 0)return{requestId:t.requestId,optionId:e.id}}if((t.allowFreeform===!0||t.options===void 0||t.options.length===0)&&n.length>0)return{requestId:t.requestId,text:n}}function resolveTextToResponses(e,t){let n=[];for(let r of t){let t=resolveTextToResponse(e,r);t!==void 0&&n.push(t)}return n}function matchOption(e,t){let n=t.find(t=>t.id.toLowerCase()===e);if(n!==void 0)return n;let r=t.find(t=>t.label.toLowerCase()===e);if(r!==void 0)return r;let i=Number(e);if(Number.isInteger(i)&&i>0&&i<=t.length)return t[i-1]}export{resolveTextToResponse,resolveTextToResponses};

package/dist/src/channel/routes.js

@@ -1,15 +1 @@
-export function GET(path, handler) {
-    return { method: "GET", path, handler };
-}
-export function POST(path, handler) {
-    return { method: "POST", path, handler };
-}
-export function PUT(path, handler) {
-    return { method: "PUT", path, handler };
-}
-export function PATCH(path, handler) {
-    return { method: "PATCH", path, handler };
-}
-export function DELETE(path, handler) {
-    return { method: "DELETE", path, handler };
-}
+function GET(e,t){return{method:`GET`,path:e,handler:t}}function POST(e,t){return{method:`POST`,path:e,handler:t}}function PUT(e,t){return{method:`PUT`,path:e,handler:t}}function PATCH(e,t){return{method:`PATCH`,path:e,handler:t}}function DELETE(e,t){return{method:`DELETE`,path:e,handler:t}}export{DELETE,GET,PATCH,POST,PUT};

package/dist/src/channel/schedule.js

@@ -1,81 +1 @@
-import { createCrossChannelReceiveFn, toCrossChannelTargets, } from "#channel/cross-channel-receive.js";
-import { createSession } from "#channel/session.js";
-import { expectFunction } from "#internal/authored-module.js";
-/**
- * Pre-built application auth context handed to schedules. Schedules
- * run on behalf of the agent itself, not a downstream user.
- */
-export const SCHEDULE_APP_AUTH = {
-    attributes: {},
-    authenticator: "app",
-    principalId: "ash:app",
-    principalType: "runtime",
-};
-/**
- * Durable adapter kind used when a schedule fires without targeting a
- * channel — the markdown form, and the synthesized run the dispatcher
- * builds for it.
- *
- * Framework-owned — authored code never constructs a schedule adapter
- * directly. Registered in `FRAMEWORK_ADAPTERS`.
- */
-export const SCHEDULE_ADAPTER_KIND = "schedule";
-export const SCHEDULE_ADAPTER = {
-    kind: SCHEDULE_ADAPTER_KIND,
-};
-export class ScheduleDispatcher {
-    runtime;
-    channels;
-    constructor(config) {
-        this.runtime = config.runtime;
-        this.channels = config.channels;
-    }
-    async trigger(input) {
-        const sessions = [];
-        const waitUntilTasks = [];
-        const receive = createCrossChannelReceiveFn(this.runtime, toCrossChannelTargets(this.channels));
-        const args = {
-            appAuth: SCHEDULE_APP_AUTH,
-            receive: async (channel, options) => {
-                const session = await receive(channel, options);
-                sessions.push(session);
-                return session;
-            },
-            waitUntil(task) {
-                waitUntilTasks.push(task);
-            },
-        };
-        if (input.run) {
-            await input.run(args);
-        }
-        else if (input.markdown !== undefined) {
-            const session = await this.runMarkdown(input.markdown);
-            sessions.push(session);
-        }
-        else {
-            throw new Error(`Schedule "${input.scheduleId}" has neither "run" nor "markdown" — at least one must be set.`);
-        }
-        return { sessions, waitUntilTasks };
-    }
-    async runMarkdown(markdown) {
-        const handle = await this.runtime.run({
-            adapter: SCHEDULE_ADAPTER,
-            auth: SCHEDULE_APP_AUTH,
-            input: { message: markdown },
-            mode: "task",
-        });
-        return createSession(handle.sessionId, handle.continuationToken, this.runtime);
-    }
-}
-/**
- * Convenience: extract a `run` function from one loaded schedule module
- * value, or throw with the file path so misconfigured modules fail
- * obviously instead of crashing deep inside the dispatcher.
- */
-export function expectScheduleRun(value, logicalPath, exportName) {
-    const definition = value;
-    if (definition === null || typeof definition !== "object") {
-        throw new Error(`Schedule export "${exportName ?? "default"}" from "${logicalPath}" must be an object.`);
-    }
-    return expectFunction(definition.run, `Expected the schedule export "${exportName ?? "default"}" from "${logicalPath}" to export a \`run\` handler function.`);
-}
+import{createSession}from"#channel/session.js";import{createCrossChannelReceiveFn,toCrossChannelTargets}from"#channel/cross-channel-receive.js";import{expectFunction}from"#internal/authored-module.js";var SCHEDULE_APP_AUTH={attributes:{},authenticator:`app`,principalId:`ash:app`,principalType:`runtime`},SCHEDULE_ADAPTER_KIND=`schedule`,SCHEDULE_ADAPTER={kind:SCHEDULE_ADAPTER_KIND},ScheduleDispatcher=class{runtime;channels;constructor(e){this.runtime=e.runtime,this.channels=e.channels}async trigger(e){let r=[],a=[],o=createCrossChannelReceiveFn(this.runtime,toCrossChannelTargets(this.channels)),s={appAuth:SCHEDULE_APP_AUTH,receive:async(e,t)=>{let n=await o(e,t);return r.push(n),n},waitUntil(e){a.push(e)}};if(e.run)await e.run(s);else if(e.markdown!==void 0){let t=await this.runMarkdown(e.markdown);r.push(t)}else throw Error(`Schedule "${e.scheduleId}" has neither "run" nor "markdown" — at least one must be set.`);return{sessions:r,waitUntilTasks:a}}async runMarkdown(t){let n=await this.runtime.run({adapter:SCHEDULE_ADAPTER,auth:SCHEDULE_APP_AUTH,input:{message:t},mode:`task`});return createSession(n.sessionId,n.continuationToken,this.runtime)}};function expectScheduleRun(e,t,n){let i=e;if(typeof i!=`object`||!i)throw Error(`Schedule export "${n??`default`}" from "${t}" must be an object.`);return expectFunction(i.run,`Expected the schedule export "${n??`default`}" from "${t}" to export a \`run\` handler function.`)}export{SCHEDULE_ADAPTER,SCHEDULE_ADAPTER_KIND,SCHEDULE_APP_AUTH,ScheduleDispatcher,expectScheduleRun};

package/dist/src/channel/send.js

@@ -1,81 +1 @@
-import { createSession } from "#channel/session.js";
-import { isRuntimeNoActiveSessionError } from "#execution/runtime-errors.js";
-import { serializeUrlFilePart } from "#internal/attachments/url-refs.js";
-import { createErrorId, createLogger } from "#internal/logging.js";
-import { toErrorMessage } from "#shared/errors.js";
-const log = createLogger("channel.send");
-export function createSendFn(runtime, adapter, channelName) {
-    return async (input, options) => {
-        const auth = options.auth;
-        const callback = options.callback;
-        const mode = options.mode ?? "conversation";
-        const state = options.state;
-        const rawToken = options.continuationToken;
-        const continuationToken = `${channelName}:${rawToken}`;
-        const { message: rawMessage, inputResponses, modelContext } = normalizeSendInput(input);
-        const message = serializeUrlFilePartsInMessage(rawMessage);
-        try {
-            const { sessionId } = await runtime.deliver({
-                auth,
-                continuationToken,
-                payload: { inputResponses, message, modelContext },
-            });
-            return createSession(sessionId, rawToken, runtime);
-        }
-        catch (error) {
-            // No-active-session is the expected resume-or-start signal; only
-            // warn when the runtime surfaces a different delivery failure.
-            if (!isRuntimeNoActiveSessionError(error)) {
-                log.warn("deliver failed, falling back to starting a new session", {
-                    continuationToken,
-                    errorId: createErrorId(),
-                    message: toErrorMessage(error),
-                });
-            }
-        }
-        if (inputResponses && inputResponses.length > 0) {
-            throw new Error("Cannot deliver inputResponses — the target session was not found via continuation token.");
-        }
-        const sessionAdapter = state
-            ? { ...adapter, state: { ...adapter.state, ...state } }
-            : adapter;
-        const handle = await runtime.run({
-            adapter: sessionAdapter,
-            auth,
-            capabilities: mode === "conversation" ? { requestInput: true } : undefined,
-            callback,
-            continuationToken,
-            input: { message: message ?? "", modelContext },
-            mode,
-        });
-        return createSession(handle.sessionId, rawToken, runtime);
-    };
-}
-/**
- * Serializes `URL` objects in `FilePart.data` to `ash-url:` strings
- * before the message crosses the queue boundary. The staging pipeline
- * reconstitutes them on the other side.
- */
-function serializeUrlFilePartsInMessage(message) {
-    if (message === undefined || typeof message === "string") {
-        return message;
-    }
-    let changed = false;
-    const result = message.map((part) => {
-        if (part.type === "file" && part.data instanceof URL && part.data.protocol !== "data:") {
-            changed = true;
-            return { ...part, data: serializeUrlFilePart(part.data) };
-        }
-        return part;
-    });
-    return changed ? result : message;
-}
-function normalizeSendInput(input) {
-    if (typeof input === "string") {
-        return { message: input };
-    }
-    if (Array.isArray(input)) {
-        return { message: input };
-    }
-    return input;
-}
+import{createSession}from"#channel/session.js";import{createErrorId,createLogger}from"#internal/logging.js";import{isRuntimeNoActiveSessionError}from"#execution/runtime-errors.js";import{serializeUrlFilePart}from"#internal/attachments/url-refs.js";import{toErrorMessage}from"#shared/errors.js";var log=createLogger(`channel.send`);function createSendFn(n,r,i){return async(a,o)=>{let s=o.auth,c=o.callback,l=o.mode??`conversation`,u=o.state,d=o.continuationToken,f=`${i}:${d}`,{message:p,inputResponses:m,modelContext:h}=normalizeSendInput(a),g=serializeUrlFilePartsInMessage(p);try{let{sessionId:t}=await n.deliver({auth:s,continuationToken:f,payload:{inputResponses:m,message:g,modelContext:h}});return createSession(t,d,n)}catch(e){isRuntimeNoActiveSessionError(e)||log.warn(`deliver failed, falling back to starting a new session`,{continuationToken:f,errorId:createErrorId(),message:toErrorMessage(e)})}if(m&&m.length>0)throw Error(`Cannot deliver inputResponses — the target session was not found via continuation token.`);let _=u?{...r,state:{...r.state,...u}}:r;return createSession((await n.run({adapter:_,auth:s,capabilities:l===`conversation`?{requestInput:!0}:void 0,callback:c,continuationToken:f,input:{message:g??``,modelContext:h},mode:l})).sessionId,d,n)}}function serializeUrlFilePartsInMessage(e){if(e===void 0||typeof e==`string`)return e;let t=!1,n=e.map(e=>e.type===`file`&&e.data instanceof URL&&e.data.protocol!==`data:`?(t=!0,{...e,data:serializeUrlFilePart(e.data)}):e);return t?n:e}function normalizeSendInput(e){return typeof e==`string`||Array.isArray(e)?{message:e}:e}export{createSendFn};

package/dist/src/channel/session-callback.js

@@ -1,65 +1 @@
-import { z } from "#compiled/zod/index.js";
-import { createAshCallbackRoutePath } from "#protocol/routes.js";
-const sessionCallbackSchema = z
-    .object({
-    callId: z.string().min(1),
-    subagentName: z.string().min(1),
-    token: z.string().min(1),
-    url: z.string().min(1),
-})
-    .strict()
-    .superRefine((callback, ctx) => {
-    let url;
-    try {
-        url = new URL(callback.url);
-    }
-    catch {
-        ctx.addIssue({
-            code: "custom",
-            message: "Callback url must be absolute.",
-            path: ["url"],
-        });
-        return;
-    }
-    if (readCallbackUrlToken(url) !== callback.token) {
-        ctx.addIssue({
-            code: "custom",
-            message: "Callback url token must match callback token.",
-            path: ["url"],
-        });
-    }
-});
-export function parseSessionCallback(value) {
-    const parsed = sessionCallbackSchema.safeParse(value);
-    if (parsed.success) {
-        return { callback: parsed.data, ok: true };
-    }
-    return {
-        cause: parsed.error,
-        message: formatSessionCallbackParseError(parsed.error),
-        ok: false,
-    };
-}
-function readCallbackUrlToken(url) {
-    const tokenPrefix = createAshCallbackRoutePath("");
-    if (!url.pathname.startsWith(tokenPrefix)) {
-        return null;
-    }
-    const encodedToken = url.pathname.slice(tokenPrefix.length);
-    if (encodedToken.length === 0 || encodedToken.includes("/")) {
-        return null;
-    }
-    try {
-        return decodeURIComponent(encodedToken);
-    }
-    catch {
-        return null;
-    }
-}
-function formatSessionCallbackParseError(error) {
-    const messages = error.issues.map((issue) => {
-        const path = issue.path.length === 0 ? "callback" : `callback.${issue.path.join(".")}`;
-        return `${path}: ${issue.message}`;
-    });
-    return `Invalid callback metadata: ${messages.join("; ")}`;
-}
+import{z}from"#compiled/zod/index.js";import{createAshCallbackRoutePath}from"#protocol/routes.js";var sessionCallbackSchema=z.object({callId:z.string().min(1),subagentName:z.string().min(1),token:z.string().min(1),url:z.string().min(1)}).strict().superRefine((e,t)=>{let n;try{n=new URL(e.url)}catch{t.addIssue({code:`custom`,message:`Callback url must be absolute.`,path:[`url`]});return}readCallbackUrlToken(n)!==e.token&&t.addIssue({code:`custom`,message:`Callback url token must match callback token.`,path:[`url`]})});function parseSessionCallback(e){let t=sessionCallbackSchema.safeParse(e);return t.success?{callback:t.data,ok:!0}:{cause:t.error,message:formatSessionCallbackParseError(t.error),ok:!1}}function readCallbackUrlToken(e){let n=createAshCallbackRoutePath(``);if(!e.pathname.startsWith(n))return null;let r=e.pathname.slice(n.length);if(r.length===0||r.includes(`/`))return null;try{return decodeURIComponent(r)}catch{return null}}function formatSessionCallbackParseError(e){return`Invalid callback metadata: ${e.issues.map(e=>`${e.path.length===0?`callback`:`callback.${e.path.join(`.`)}`}: ${e.message}`).join(`; `)}`}export{parseSessionCallback};