experimental-ash 0.2.0-alpha.2 → 0.2.0-alpha.21

package/dist/src/public/channels/http.js

@@ -1,33 +1,35 @@
 /**
- * Framework-shipped HTTP channel factories.
+ * Framework-shipped HTTP route factories.
  *
- * `httpMessageChannel()` returns the inbound message channel — the public
- * HTTP entry point for starting and resuming agent runs. Authored at the
+ * `httpRoute()` returns the inbound message route — the public
+ * HTTP entry point for starting and resuming agent sessions. Authored at the
  * logical filesystem path `agent/channels/.well-known/ash/v1/message.ts`,
  * mounted at `POST /.well-known/ash/v1/message`.
  *
- * `httpRunStreamChannel()` returns the outbound event stream channel.
+ * `httpRunStreamRoute()` returns the outbound event stream route.
  * Authored at the logical filesystem path
- * `agent/channels/.well-known/ash/v1/runs/[runId]/stream.ts`, mounted at
- * `GET /.well-known/ash/v1/runs/:runId/stream`. Reads run events from the
+ * `agent/channels/.well-known/ash/v1/sessions/[sessionId]/stream.ts`, mounted at
+ * `GET /.well-known/ash/v1/sessions/:sessionId/stream`. Reads session events from the
  * agent via {@link Agent.getEventStream}.
  *
- * Both channels are mounted automatically by the framework at their logical
+ * Both routes are mounted automatically by the framework at their logical
  * paths unless the user authors a file at the same path (override) or
- * exports `disableChannel()` from such a file (disable).
+ * exports `disableRoute()` from such a file (disable).
  *
- * Both factories require an `auth` argument — see {@link HttpChannelInput}.
- * The common case is `httpMessageChannel({ auth: vercelOidc() })`. Open
- * routes are an explicit choice via `httpMessageChannel({ auth: none() })`.
+ * Both factories require an `auth` argument — see {@link HttpRouteInput}
+ * and {@link HttpRunStreamRouteInput}.
+ * The common case is `httpRoute({ auth: vercelOidc() })`. Open
+ * routes are an explicit choice via `httpRoute({ auth: none() })`.
  */
-import { HttpChannelEmitter } from "../../channel/http-emitter.js";
-import { ASH_MESSAGE_STREAM_CONTENT_TYPE, ASH_MESSAGE_STREAM_FORMAT, ASH_MESSAGE_STREAM_VERSION, ASH_RUN_ID_HEADER, ASH_STREAM_FORMAT_HEADER, ASH_STREAM_VERSION_HEADER, } from "../../protocol/message.js";
+import { HttpChannel } from "../../channel/http-channel.js";
+import { ASH_MESSAGE_STREAM_CONTENT_TYPE, ASH_MESSAGE_STREAM_FORMAT, ASH_MESSAGE_STREAM_VERSION, ASH_SESSION_ID_HEADER, ASH_STREAM_FORMAT_HEADER, ASH_STREAM_VERSION_HEADER, } from "../../protocol/message.js";
 import { createAshMessageStreamRoutePath } from "../../protocol/routes.js";
-import { isRuntimeInputResult } from "../../runtime/input/types.js";
-import { defineChannel } from "../definitions/channel.js";
-import { createUnauthorizedResponse, withAuth } from "./auth.js";
+import { isInputResponse } from "../../runtime/input/types.js";
+import { defineRoute } from "../definitions/channel.js";
+import { createUnauthorizedResponse } from "./auth.js";
+export { HttpChannel };
 /**
- * Returns the framework-shipped HTTP message channel.
+ * Returns the framework-shipped HTTP message route.
  *
  * Accepts JSON bodies of the form:
  * ```json
@@ -35,23 +37,32 @@ import { createUnauthorizedResponse, withAuth } from "./auth.js";
  * { "continuationToken": "...", "message": "..." }     // resume an existing session
  * ```
  *
- * Responds with `202 Accepted` on a new session, including the run id in
- * the `x-ash-run-id` header and the stream URL in the `Location` header.
+ * Responds with `202 Accepted` on a new session, including the session id in
+ * the `x-ash-session-id` header and the stream URL in the `Location` header.
  * Responds with `200 OK` on a successful resume.
  *
  * Inbound auth is mandatory: pass `auth: vercelOidc()` for the standard
  * Vercel deployment, `auth: none()` for an explicit open route, or any
  * other {@link AuthFn} (or hand-written function) for custom verification.
  */
-export function httpMessageChannel(input) {
-    return defineChannel({
+export function httpRoute(input) {
+    if (input.channel !== undefined && !(input.channel.prototype instanceof HttpChannel)) {
+        throw new TypeError("httpRoute: `channel` must extend `HttpChannel`.");
+    }
+    if (input.channel !== undefined &&
+        input.channel !== HttpChannel &&
+        input.channel.kind === HttpChannel.kind) {
+        throw new TypeError('httpRoute: custom channel classes must declare a unique static `kind` instead of inheriting "http".');
+    }
+    return defineRoute({
         method: "POST",
+        serializableChannels: input.channel !== undefined ? [input.channel] : undefined,
         async fetch(request, ctx) {
-            const authResult = await runChannelAuth(input.auth, request, ctx);
+            const authResult = await runRouteAuth(input.auth, request, ctx);
             if (authResult instanceof Response) {
                 return authResult;
             }
-            const { agent } = authResult;
+            const sessionAuth = authResult;
             let payload;
             try {
                 payload = await request.json();
@@ -66,26 +77,27 @@ export function httpMessageChannel(input) {
             if (body instanceof Response) {
                 return body;
             }
-            // Resume an existing session. The verified principal (if any) was
-            // injected into `ctx.agent` by `runChannelAuth` via `withAuth`, so
-            // `agent.deliver` carries it automatically.
+            // Resume an existing session. Pass auth directly to deliver.
             if ("continuationToken" in body) {
                 const continuationToken = body.continuationToken;
-                await agent.deliver({
+                await ctx.agent.deliver({
+                    auth: sessionAuth,
                     continuationToken,
                     payload: {
-                        inputResults: "inputResults" in body ? body.inputResults : undefined,
+                        inputResponses: "inputResponses" in body ? body.inputResponses : undefined,
                         message: "message" in body ? body.message : undefined,
                     },
                 });
                 return Response.json({ continuationToken, ok: true }, { headers: { "cache-control": "no-store" }, status: 200 });
             }
-            // Start a new session. The HTTP channel uses a passthrough emitter
-            // because outbound delivery happens via the run-stream channel, not
+            // Start a new session. The HTTP route uses a passthrough channel
+            // because outbound delivery happens via the session-stream route, not
             // via an external API call.
             const continuationToken = `http:${crypto.randomUUID()}`;
-            const handle = await agent.run({
-                channelEmitter: new HttpChannelEmitter(),
+            const channelClass = input.channel ?? HttpChannel;
+            const handle = await ctx.agent.run({
+                auth: sessionAuth,
+                channel: new channelClass({}),
                 continuationToken,
                 input: { message: body.message },
                 mode: "conversation",
@@ -99,7 +111,7 @@ export function httpMessageChannel(input) {
                 headers: {
                     "cache-control": "no-store",
                     location: createAshMessageStreamRoutePath(handle.sessionId),
-                    [ASH_RUN_ID_HEADER]: handle.sessionId,
+                    [ASH_SESSION_ID_HEADER]: handle.sessionId,
                 },
                 status: 202,
             });
@@ -111,31 +123,31 @@ function parseHandleMessageRequestBody(payload) {
         ? payload.continuationToken
         : undefined;
     const message = typeof payload.message === "string" && payload.message.length > 0 ? payload.message : undefined;
-    const inputResults = parseRuntimeInputResults(payload.inputResults);
-    if (inputResults instanceof Response) {
-        return inputResults;
+    const inputResponses = parseInputResponses(payload.inputResponses);
+    if (inputResponses instanceof Response) {
+        return inputResponses;
     }
     if (continuationToken === undefined) {
         if (message === undefined) {
             return Response.json({ error: "Missing or empty 'message' field.", ok: false }, { status: 400 });
         }
-        if (inputResults !== undefined) {
-            return Response.json({ error: "'inputResults' may only be used with 'continuationToken'.", ok: false }, { status: 400 });
+        if (inputResponses !== undefined) {
+            return Response.json({ error: "'inputResponses' may only be used with 'continuationToken'.", ok: false }, { status: 400 });
         }
         return {
             message,
         };
     }
-    if (message === undefined && inputResults === undefined) {
+    if (message === undefined && inputResponses === undefined) {
         return Response.json({
-            error: "Expected a non-empty 'message', a non-empty 'inputResults' array, or both.",
+            error: "Expected a non-empty 'message', a non-empty 'inputResponses' array, or both.",
             ok: false,
         }, { status: 400 });
     }
-    if (message !== undefined && inputResults !== undefined) {
+    if (message !== undefined && inputResponses !== undefined) {
         return {
             continuationToken,
-            inputResults,
+            inputResponses,
             message,
         };
     }
@@ -147,57 +159,59 @@ function parseHandleMessageRequestBody(payload) {
     }
     return {
         continuationToken,
-        inputResults: inputResults ?? [],
+        inputResponses: inputResponses ?? [],
     };
 }
-function parseRuntimeInputResults(value) {
+function parseInputResponses(value) {
     if (value === undefined) {
         return undefined;
     }
     if (!Array.isArray(value) || value.length === 0) {
-        return Response.json({ error: "Expected 'inputResults' to be a non-empty array.", ok: false }, { status: 400 });
+        return Response.json({ error: "Expected 'inputResponses' to be a non-empty array.", ok: false }, { status: 400 });
     }
-    const inputResults = value.filter(isRuntimeInputResult);
-    if (inputResults.length !== value.length) {
-        return Response.json({ error: "Expected every 'inputResults' entry to match the HITL result schema.", ok: false }, { status: 400 });
+    const inputResponses = value.filter(isInputResponse);
+    if (inputResponses.length !== value.length) {
+        return Response.json({
+            error: "Expected every 'inputResponses' entry to match the HITL response schema.",
+            ok: false,
+        }, { status: 400 });
     }
-    return inputResults;
+    return inputResponses;
 }
 /**
- * Returns the framework-shipped HTTP run-stream channel.
+ * Returns the framework-shipped HTTP session-stream route.
  *
- * Reads `runId` from the path parameter (filesystem path
- * `runs/[runId]/stream`) and returns a long-lived NDJSON `Response` whose
- * body is the durable workflow event stream for that run.
+ * Reads `sessionId` from the path parameter (filesystem path
+ * `sessions/[sessionId]/stream`) and returns a long-lived NDJSON `Response`
+ * whose body is the durable workflow event stream for that session.
  *
  * Honors a `startIndex` query parameter so a reconnecting or resuming
- * client can skip events it already consumed for the current run. Without
+ * client can skip events it already consumed for the current session. Without
  * this, follow-up turns would replay every event from the start of the
- * run and the dev REPL would render the previous turn over and over.
+ * session and the dev REPL would render the previous turn over and over.
  *
  * Inbound auth is mandatory: pass `auth: vercelOidc()` for the standard
  * Vercel deployment, `auth: none()` for an explicit open route, or any
  * other {@link AuthFn} for custom verification.
  */
-export function httpRunStreamChannel(input) {
-    return defineChannel({
+export function httpRunStreamRoute(input) {
+    return defineRoute({
         method: "GET",
         async fetch(request, ctx) {
-            const authResult = await runChannelAuth(input.auth, request, ctx);
+            const authResult = await runRouteAuth(input.auth, request, ctx);
             if (authResult instanceof Response) {
                 return authResult;
             }
-            const { agent, params } = authResult;
-            const runId = params.runId;
-            if (typeof runId !== "string" || runId.length === 0) {
-                return Response.json({ error: "Missing run id.", ok: false }, { status: 400 });
+            const sessionId = ctx.params.sessionId;
+            if (typeof sessionId !== "string" || sessionId.length === 0) {
+                return Response.json({ error: "Missing session id.", ok: false }, { status: 400 });
             }
             const startIndex = parseRunStreamStartIndex(request);
             if (startIndex instanceof Response) {
                 return startIndex;
             }
             try {
-                const events = await agent.getEventStream(runId, { startIndex });
+                const events = await ctx.agent.getEventStream(sessionId, { startIndex });
                 // The runtime returns a parsed event stream; re-serialize each event
                 // back to NDJSON bytes for the wire protocol.
                 const ndjson = serializeEventStreamAsNdjson(events);
@@ -205,28 +219,28 @@ export function httpRunStreamChannel(input) {
                     headers: {
                         "cache-control": "no-store",
                         "content-type": ASH_MESSAGE_STREAM_CONTENT_TYPE,
-                        [ASH_RUN_ID_HEADER]: runId,
+                        [ASH_SESSION_ID_HEADER]: sessionId,
                         [ASH_STREAM_FORMAT_HEADER]: ASH_MESSAGE_STREAM_FORMAT,
                         [ASH_STREAM_VERSION_HEADER]: ASH_MESSAGE_STREAM_VERSION,
                     },
                 });
             }
             catch {
-                return Response.json({ error: "Run not found.", ok: false }, { status: 404 });
+                return Response.json({ error: "Session not found.", ok: false }, { status: 404 });
             }
         },
     });
 }
 /**
- * Runs the channel-level {@link AuthFn} and returns either a wrapped
- * {@link ChannelContext} carrying the verified principal, or a `Response`
+ * Runs the route-level {@link AuthFn} and returns either the resolved
+ * {@link SessionAuthContext} (or `null` for anonymous), or a `Response`
  * the caller should return verbatim (a 401 on rejection).
  *
- * Encapsulates the verify → 401 → `withAuth` flow shared by every
- * framework-shipped HTTP factory so each factory body stays focused on
- * its own request shape and dispatch logic.
+ * Encapsulates the verify → 401 flow shared by every framework-shipped
+ * HTTP route factory so each factory body stays focused on its own
+ * request shape and dispatch logic.
  */
-async function runChannelAuth(auth, request, ctx) {
+async function runRouteAuth(auth, request, _ctx) {
     const result = await auth(request);
     if (result === null) {
         return createUnauthorizedResponse({
@@ -234,15 +248,11 @@ async function runChannelAuth(auth, request, ctx) {
         });
     }
     // result is either a SessionAuthContext (authenticated) or undefined
-    // (anonymous, allowed through). withAuth(ctx, null) is safe to call in
-    // either case — it ensures the dispatched agent.run/deliver carry the
-    // verified principal (or explicit null) without the inner factory body
-    // having to know which path ran.
-    const sessionAuth = result ?? null;
-    return withAuth(ctx, sessionAuth);
+    // (anonymous, allowed through).
+    return result ?? null;
 }
 /**
- * Parses the `startIndex` query parameter on a run-stream request.
+ * Parses the `startIndex` query parameter on a session-stream request.
  *
  * Returns the parsed value (or `undefined` when absent), or a `400`
  * response when the value is not a non-negative integer. The framework

package/dist/src/public/channels/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../../src/public/channels/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,EACzB,0BAA0B,EAC1B,iBAAiB,EACjB,wBAAwB,EACxB,yBAAyB,GAE1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAA2B,MAAM,8BAA8B,CAAC;AAC7F,OAAO,EAAqC,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC7F,OAAO,EAAe,0BAA0B,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAmB9E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAuB;IACxD,OAAO,aAAa,CAAC;QACnB,MAAM,EAAE,MAAM;QACd,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG;YACtB,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;YAClE,IAAI,UAAU,YAAY,QAAQ,EAAE,CAAC;gBACnC,OAAO,UAAU,CAAC;YACpB,CAAC;YAED,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;YAE7B,IAAI,OAAgB,CAAC;YACrB,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;YACjC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,oBAAoB,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACpF,CAAC;YAED,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACpD,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACzF,CAAC;YAED,MAAM,IAAI,GAAG,6BAA6B,CAAC,OAAkC,CAAC,CAAC;YAE/E,IAAI,IAAI,YAAY,QAAQ,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAC;YACd,CAAC;YAED,kEAAkE;YAClE,mEAAmE;YACnE,4CAA4C;YAC5C,IAAI,mBAAmB,IAAI,IAAI,EAAE,CAAC;gBAChC,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;gBACjD,MAAM,KAAK,CAAC,OAAO,CAAC;oBAClB,iBAAiB;oBACjB,OAAO,EAAE;wBACP,YAAY,EAAE,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;wBACpE,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;qBACtD;iBACF,CAAC,CAAC;gBACH,OAAO,QAAQ,CAAC,IAAI,CAClB,EAAE,iBAAiB,EAAE,EAAE,EAAE,IAAI,EAAE,EAC/B,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAC1D,CAAC;YACJ,CAAC;YAED,mEAAmE;YACnE,oEAAoE;YACpE,4BAA4B;YAC5B,MAAM,iBAAiB,GAAG,QAAQ,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC;YACxD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC;gBAC7B,cAAc,EAAE,IAAI,kBAAkB,EAAE;gBACxC,iBAAiB;gBACjB,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;gBAChC,IAAI,EAAE,cAAc;gBACpB,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE;aAC/B,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC,IAAI,CAClB;gBACE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;gBAC3C,EAAE,EAAE,IAAI;gBACR,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,EACD;gBACE,OAAO,EAAE;oBACP,eAAe,EAAE,UAAU;oBAC3B,QAAQ,EAAE,+BAA+B,CAAC,MAAM,CAAC,SAAS,CAAC;oBAC3D,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,SAAS;iBACtC;gBACD,MAAM,EAAE,GAAG;aACZ,CACF,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,6BAA6B,CACpC,OAAgC;IAEhC,MAAM,iBAAiB,GACrB,OAAO,OAAO,CAAC,iBAAiB,KAAK,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC;QACnF,CAAC,CAAC,OAAO,CAAC,iBAAiB;QAC3B,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,OAAO,GACX,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAClG,MAAM,YAAY,GAAG,wBAAwB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAEpE,IAAI,YAAY,YAAY,QAAQ,EAAE,CAAC;QACrC,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;QACpC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,QAAQ,CAAC,IAAI,CAClB,EAAE,KAAK,EAAE,mCAAmC,EAAE,EAAE,EAAE,KAAK,EAAE,EACzD,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAC;QACJ,CAAC;QAED,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,QAAQ,CAAC,IAAI,CAClB,EAAE,KAAK,EAAE,2DAA2D,EAAE,EAAE,EAAE,KAAK,EAAE,EACjF,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO;SACR,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QACxD,OAAO,QAAQ,CAAC,IAAI,CAClB;YACE,KAAK,EAAE,4EAA4E;YACnF,EAAE,EAAE,KAAK;SACV,EACD,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QACxD,OAAO;YACL,iBAAiB;YACjB,YAAY;YACZ,OAAO;SACR,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO;YACL,iBAAiB;YACjB,OAAO;SACR,CAAC;IACJ,CAAC;IAED,OAAO;QACL,iBAAiB;QACjB,YAAY,EAAE,YAAY,IAAI,EAAE;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAC/B,KAAc;IAEd,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,QAAQ,CAAC,IAAI,CAClB,EAAE,KAAK,EAAE,kDAAkD,EAAE,EAAE,EAAE,KAAK,EAAE,EACxE,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAExD,IAAI,YAAY,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QACzC,OAAO,QAAQ,CAAC,IAAI,CAClB,EAAE,KAAK,EAAE,sEAAsE,EAAE,EAAE,EAAE,KAAK,EAAE,EAC5F,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAC;IACJ,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAuB;IAC1D,OAAO,aAAa,CAAC;QACnB,MAAM,EAAE,KAAK;QACb,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG;YACtB,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;YAClE,IAAI,UAAU,YAAY,QAAQ,EAAE,CAAC;gBACnC,OAAO,UAAU,CAAC;YACpB,CAAC;YAED,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;YACrC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YAE3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpD,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACjF,CAAC;YAED,MAAM,UAAU,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;YACrD,IAAI,UAAU,YAAY,QAAQ,EAAE,CAAC;gBACnC,OAAO,UAAU,CAAC;YACpB,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;gBACjE,qEAAqE;gBACrE,8CAA8C;gBAC9C,MAAM,MAAM,GAAG,4BAA4B,CAAC,MAAM,CAAC,CAAC;gBACpD,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE;oBAC1B,OAAO,EAAE;wBACP,eAAe,EAAE,UAAU;wBAC3B,cAAc,EAAE,+BAA+B;wBAC/C,CAAC,iBAAiB,CAAC,EAAE,KAAK;wBAC1B,CAAC,wBAAwB,CAAC,EAAE,yBAAyB;wBACrD,CAAC,yBAAyB,CAAC,EAAE,0BAA0B;qBACxD;iBACF,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YAChF,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,cAAc,CAC3B,IAAqB,EACrB,OAAgB,EAChB,GAAmB;IAEnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,0BAA0B,CAAC;YAChC,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;SACnC,CAAC,CAAC;IACL,CAAC;IACD,qEAAqE;IACrE,uEAAuE;IACvE,sEAAsE;IACtE,uEAAuE;IACvE,iCAAiC;IACjC,MAAM,WAAW,GAA8B,MAAM,IAAI,IAAI,CAAC;IAC9D,OAAO,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,wBAAwB,CAAC,OAAgB;IAChD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAEhE,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAExC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,OAAO,QAAQ,CAAC,IAAI,CAClB,EAAE,KAAK,EAAE,mDAAmD,EAAE,EAAE,EAAE,KAAK,EAAE,EACzE,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,4BAA4B,CAAC,MAA+B;IACnE,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,OAAO,MAAM,CAAC,WAAW,CACvB,IAAI,eAAe,CAAsB;QACvC,SAAS,CAAC,KAAK,EAAE,UAAU;YACzB,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACnE,CAAC;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../../src/public/channels/http.ts"],"names":[],"mappings":"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"}

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

@@ -1,30 +1,29 @@
 /**
- * Channel authoring helpers used inside `agent/channels/*.ts` files.
+ * Route authoring helpers used inside `agent/channels/*.ts` files.
  *
- * A channel is a Web-standard `(Request, ctx) => Response` handler whose
+ * A route is a Web-standard `(Request, ctx) => Response` handler whose
  * URL path is derived from the file's location under `agent/channels/`.
- * The framework mounts each authored channel as its own Nitro route.
+ * The framework mounts each authored route as its own Nitro route.
  *
  * Filename is identity. `agent/channels/slack.ts` mounts at `POST /slack`.
  * Nested directories produce nested URL segments
  * (`agent/channels/api/inbound.ts` → `POST /api/inbound`). Path parameters
  * use the Nitro `[name]` convention
- * (`agent/channels/runs/[runId]/stream.ts` → `GET /runs/:runId/stream`).
+ * (`agent/channels/sessions/[sessionId]/stream.ts` → `GET /sessions/:sessionId/stream`).
  *
  * @example
  * ```ts
  * // agent/channels/slack.ts → POST /slack
- * import { defineChannel } from "experimental-ash/channels";
+ * import { defineRoute } from "experimental-ash/channels";
  *
- * export default defineChannel({
- *   async fetch(request, { runtime, waitUntil }) {
+ * export default defineRoute({
+ *   async fetch(request, { agent, waitUntil }) {
  *     // ...
  *     return new Response("ok");
  *   },
  * });
  * ```
  */
-export { registerChannelEmitter } from "../../channel/emitter-registry.js";
-export type { ChannelEmitter, ChannelEmitterClass, EventEmitFn, } from "../../channel/types.js";
-export { type Agent, type Channel, type ChannelContext, type ChannelMethod, type DisabledChannelSentinel, defineChannel, disableChannel, isChannelDefinition, isDisabledChannelSentinel, } from "../definitions/channel.js";
+export { Channel, type ChannelClass, type EventEmitFn, } from "../../channel/types.js";
+export { type Agent, type ChannelMethod, type DisabledRouteSentinel, defineRoute, disableRoute, isDisabledRouteSentinel, isRouteDefinition, type Route, type RouteContext, } from "../definitions/channel.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/public/channels/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,KAAK,EACV,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/public/channels/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EACL,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,KAAK,EACV,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,WAAW,EACX,YAAY,EACZ,uBAAuB,EACvB,iBAAiB,EACjB,KAAK,KAAK,EACV,KAAK,YAAY,GAClB,MAAM,2BAA2B,CAAC"}

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

@@ -1,29 +1,29 @@
 /**
- * Channel authoring helpers used inside `agent/channels/*.ts` files.
+ * Route authoring helpers used inside `agent/channels/*.ts` files.
  *
- * A channel is a Web-standard `(Request, ctx) => Response` handler whose
+ * A route is a Web-standard `(Request, ctx) => Response` handler whose
  * URL path is derived from the file's location under `agent/channels/`.
- * The framework mounts each authored channel as its own Nitro route.
+ * The framework mounts each authored route as its own Nitro route.
  *
  * Filename is identity. `agent/channels/slack.ts` mounts at `POST /slack`.
  * Nested directories produce nested URL segments
  * (`agent/channels/api/inbound.ts` → `POST /api/inbound`). Path parameters
  * use the Nitro `[name]` convention
- * (`agent/channels/runs/[runId]/stream.ts` → `GET /runs/:runId/stream`).
+ * (`agent/channels/sessions/[sessionId]/stream.ts` → `GET /sessions/:sessionId/stream`).
  *
  * @example
  * ```ts
  * // agent/channels/slack.ts → POST /slack
- * import { defineChannel } from "experimental-ash/channels";
+ * import { defineRoute } from "experimental-ash/channels";
  *
- * export default defineChannel({
- *   async fetch(request, { runtime, waitUntil }) {
+ * export default defineRoute({
+ *   async fetch(request, { agent, waitUntil }) {
  *     // ...
  *     return new Response("ok");
  *   },
  * });
  * ```
  */
-export { registerChannelEmitter } from "../../channel/emitter-registry.js";
-export { defineChannel, disableChannel, isChannelDefinition, isDisabledChannelSentinel, } from "../definitions/channel.js";
+export { Channel, } from "../../channel/types.js";
+export { defineRoute, disableRoute, isDisabledRouteSentinel, isRouteDefinition, } from "../definitions/channel.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/public/channels/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAO3E,OAAO,EAML,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/public/channels/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EACL,OAAO,GAGR,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAIL,WAAW,EACX,YAAY,EACZ,uBAAuB,EACvB,iBAAiB,GAGlB,MAAM,2BAA2B,CAAC"}