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

package/dist/src/protocol/message.js

@@ -1,31 +1,31 @@
 import { createAshMessageStreamRoutePath } from "./routes.js";
-export const ASH_RUN_ID_HEADER = "x-ash-run-id";
+export const ASH_SESSION_ID_HEADER = "x-ash-session-id";
 export const ASH_STREAM_FORMAT_HEADER = "x-ash-stream-format";
 export const ASH_STREAM_VERSION_HEADER = "x-ash-stream-version";
 export const ASH_WORKFLOW_ID_HEADER = "x-ash-workflow-id";
 export const ASH_MESSAGE_STREAM_CONTENT_TYPE = "application/x-ndjson; charset=utf-8";
 export const ASH_MESSAGE_STREAM_FORMAT = "ndjson";
-export const ASH_MESSAGE_STREAM_VERSION = "10";
+export const ASH_MESSAGE_STREAM_VERSION = "11";
 const textEncoder = new TextEncoder();
 /**
- * Returns the stable stream route path for one message workflow run.
+ * Returns the stable stream route path for one message workflow session.
  */
-export function createMessageRunStreamPath(runId) {
-    return createAshMessageStreamRoutePath(runId);
+export function createMessageSessionStreamPath(sessionId) {
+    return createAshMessageStreamRoutePath(sessionId);
 }
 /**
  * Returns true when the current stream has reached a turn boundary or terminal
- * run outcome.
+ * session outcome.
  */
 export function isCurrentTurnBoundaryEvent(event) {
-    return (event.type === "run.completed" ||
-        event.type === "run.failed" ||
+    return (event.type === "session.completed" ||
+        event.type === "session.failed" ||
         event.type === "session.waiting");
 }
 /**
- * Creates the `run.started` event for one session run.
+ * Creates the `session.started` event for one session.
  */
-export function createRunStartedEvent(input) {
+export function createSessionStartedEvent(input) {
     const data = {};
     if (input?.invocation !== undefined) {
         data.invocation = input.invocation;
@@ -35,7 +35,7 @@ export function createRunStartedEvent(input) {
     }
     return {
         data,
-        type: "run.started",
+        type: "session.started",
     };
 }
 /**
@@ -64,13 +64,14 @@ export function createMessageReceivedEvent(input) {
     };
 }
 /**
- * Creates the `actions.requested` event for one paused harness outcome.
+ * Creates the `actions.requested` event for one stable execution batch.
  */
 export function createActionsRequestedEvent(input) {
     return {
         data: {
             actions: input.actions,
             sequence: input.sequence,
+            stepIndex: input.stepIndex,
             turnId: input.turnId,
         },
         type: "actions.requested",
@@ -84,6 +85,7 @@ export function createInputRequestedEvent(input) {
         data: {
             requests: input.requests,
             sequence: input.sequence,
+            stepIndex: input.stepIndex,
             turnId: input.turnId,
         },
         type: "input.requested",
@@ -97,6 +99,7 @@ export function createActionResultEvent(input) {
         data: {
             result: input.result,
             sequence: input.sequence,
+            stepIndex: input.stepIndex,
             turnId: input.turnId,
         },
         type: "action.result",
@@ -117,14 +120,14 @@ export function createSubagentChildEventEvent(input) {
     };
 }
 /**
- * Creates the `subagent.called` event for one started child workflow run.
+ * Creates the `subagent.called` event for one started child workflow session.
  */
 export function createSubagentCalledEvent(input) {
     return {
         data: {
             callId: input.callId,
-            childRunId: input.childRunId,
-            runId: input.runId,
+            childSessionId: input.childSessionId,
+            sessionId: input.sessionId,
             sequence: input.sequence,
             name: input.name,
             toolName: input.toolName,
@@ -135,10 +138,7 @@ export function createSubagentCalledEvent(input) {
     };
 }
 /**
- * Creates the `message.completed` event for one completed assistant step.
- *
- * `finishReason` defaults to `"stop"` because most completed assistant steps
- * are terminal assistant replies.
+ * Creates the `message.completed` event for one completed assistant text chunk.
  */
 export function createMessageCompletedEvent(input) {
     return {
@@ -146,31 +146,47 @@ export function createMessageCompletedEvent(input) {
             finishReason: input.finishReason ?? "stop",
             message: input.message,
             sequence: input.sequence,
+            stepIndex: input.stepIndex,
             turnId: input.turnId,
         },
         type: "message.completed",
     };
 }
 /**
- * Creates the `thinking.completed` event for one completed reasoning block.
+ * Creates the `reasoning.completed` event for one completed reasoning block.
  */
-export function createThinkingCompletedEvent(input) {
+export function createReasoningCompletedEvent(input) {
     return {
         data: {
+            reasoning: input.reasoning,
             sequence: input.sequence,
-            text: input.text,
+            stepIndex: input.stepIndex,
             turnId: input.turnId,
         },
-        type: "thinking.completed",
+        type: "reasoning.completed",
     };
 }
 /**
- * Creates the `turn.completed` event for one terminal per-turn outcome.
+ * Creates the `step.started` event for one model call.
  */
-export function createTurnCompletedEvent(input) {
+export function createStepStartedEvent(input) {
+    return {
+        data: {
+            sequence: input.sequence,
+            stepIndex: input.stepIndex,
+            turnId: input.turnId,
+        },
+        type: "step.started",
+    };
+}
+/**
+ * Creates the `step.completed` event for one completed model call.
+ */
+export function createStepCompletedEvent(input) {
     const data = {
+        finishReason: input.finishReason,
         sequence: input.sequence,
-        status: input.status,
+        stepIndex: input.stepIndex,
         turnId: input.turnId,
     };
     if (input.usage !== undefined) {
@@ -178,9 +194,52 @@ export function createTurnCompletedEvent(input) {
     }
     return {
         data,
+        type: "step.completed",
+    };
+}
+/**
+ * Creates the `step.failed` event for one failed model call.
+ */
+export function createStepFailedEvent(input) {
+    return {
+        data: {
+            code: input.code,
+            details: input.details,
+            message: input.message,
+            sequence: input.sequence,
+            stepIndex: input.stepIndex,
+            turnId: input.turnId,
+        },
+        type: "step.failed",
+    };
+}
+/**
+ * Creates the `turn.completed` event for one terminal successful turn.
+ */
+export function createTurnCompletedEvent(input) {
+    return {
+        data: {
+            sequence: input.sequence,
+            turnId: input.turnId,
+        },
         type: "turn.completed",
     };
 }
+/**
+ * Creates the `turn.failed` event for one failed turn.
+ */
+export function createTurnFailedEvent(input) {
+    return {
+        data: {
+            code: input.code,
+            details: input.details,
+            message: input.message,
+            sequence: input.sequence,
+            turnId: input.turnId,
+        },
+        type: "turn.failed",
+    };
+}
 /**
  * Creates the `compaction.requested` event for one runtime compaction pass.
  */
@@ -188,7 +247,6 @@ export function createCompactionRequestedEvent(input) {
     return {
         data: {
             modelId: input.modelId,
-            runId: input.runId,
             sequence: input.sequence,
             sessionId: input.sessionId,
             thresholdPercent: input.thresholdPercent,
@@ -206,7 +264,6 @@ export function createCompactionCompletedEvent(input) {
         data: {
             lastCompactionIndex: input.lastCompactionIndex,
             modelId: input.modelId,
-            runId: input.runId,
             sequence: input.sequence,
             sessionId: input.sessionId,
             turnId: input.turnId,
@@ -227,25 +284,24 @@ export function createSessionWaitingEvent() {
     };
 }
 /**
- * Creates the `run.failed` event for one terminal workflow failure.
+ * Creates the `session.failed` event for one terminal session failure.
  */
-export function createRunFailedEvent(input) {
+export function createSessionFailedEvent(input) {
     return {
         data: {
-            details: input.details,
             code: input.code,
+            details: input.details,
             message: input.message,
-            runId: input.runId,
             sessionId: input.sessionId,
         },
-        type: "run.failed",
+        type: "session.failed",
     };
 }
 /**
- * Creates the `run.completed` event for one terminal workflow completion.
+ * Creates the `session.completed` event for one terminal session completion.
  */
-export function createRunCompletedEvent() {
-    return { type: "run.completed" };
+export function createSessionCompletedEvent() {
+    return { type: "session.completed" };
 }
 /**
  * Encodes one stream event as newline-delimited JSON.

package/dist/src/protocol/message.js.map

@@ -1 +1 @@
-{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/protocol/message.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/protocol/message.ts"],"names":[],"mappings":"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"}

package/dist/src/protocol/routes.d.ts

@@ -7,6 +7,10 @@ export declare const ASH_ROUTE_PREFIX = "/.well-known/ash/v1";
  * Stable framework-owned health route.
  */
 export declare const ASH_HEALTH_ROUTE_PATH = "/.well-known/ash/v1/health";
+/**
+ * Stable framework-owned route exposing home-page inspection JSON.
+ */
+export declare const ASH_HOME_ROUTE_PATH = "/.well-known/ash/v1/home";
 /**
  * Stable framework-owned message route.
  */
@@ -18,11 +22,15 @@ export declare const ASH_CHANNEL_WEBHOOK_ROUTE_PATTERN = "/.well-known/ash/v1/ch
 /**
  * Stable framework-owned message stream route pattern.
  */
-export declare const ASH_MESSAGE_STREAM_ROUTE_PATTERN = "/.well-known/ash/v1/runs/:runId/stream";
+export declare const ASH_MESSAGE_STREAM_ROUTE_PATTERN = "/.well-known/ash/v1/sessions/:sessionId/stream";
+/**
+ * Stable framework-owned route prefix for static home-page UI assets.
+ */
+export declare const ASH_HOME_PAGE_UI_ROUTE_PREFIX = "/.well-known/ash/v1/ui";
 /**
- * Creates the stable framework-owned message stream route path for one run.
+ * Creates the stable framework-owned message stream route path for one session.
  */
-export declare function createAshMessageStreamRoutePath(runId: string): string;
+export declare function createAshMessageStreamRoutePath(sessionId: string): string;
 /**
  * Creates the stable framework-owned authored channel webhook route path for
  * one channel.

package/dist/src/protocol/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/protocol/routes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,wBAAwB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,qBAAqB,+BAA+B,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,sBAAsB,gCAAgC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,iCAAiC,oDAAoD,CAAC;AAEnG;;GAEG;AACH,eAAO,MAAM,gCAAgC,2CAA2C,CAAC;AAEzF;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1E"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/protocol/routes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,wBAAwB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,qBAAqB,+BAA+B,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,mBAAmB,6BAA6B,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,sBAAsB,gCAAgC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,iCAAiC,oDAAoD,CAAC;AAEnG;;GAEG;AACH,eAAO,MAAM,gCAAgC,mDAAmD,CAAC;AAEjG;;GAEG;AACH,eAAO,MAAM,6BAA6B,2BAA2B,CAAC;AAEtE;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1E"}

package/dist/src/protocol/routes.js

@@ -7,6 +7,10 @@ export const ASH_ROUTE_PREFIX = "/.well-known/ash/v1";
  * Stable framework-owned health route.
  */
 export const ASH_HEALTH_ROUTE_PATH = `${ASH_ROUTE_PREFIX}/health`;
+/**
+ * Stable framework-owned route exposing home-page inspection JSON.
+ */
+export const ASH_HOME_ROUTE_PATH = `${ASH_ROUTE_PREFIX}/home`;
 /**
  * Stable framework-owned message route.
  */
@@ -18,12 +22,16 @@ export const ASH_CHANNEL_WEBHOOK_ROUTE_PATTERN = `${ASH_ROUTE_PREFIX}/channels/:
 /**
  * Stable framework-owned message stream route pattern.
  */
-export const ASH_MESSAGE_STREAM_ROUTE_PATTERN = `${ASH_ROUTE_PREFIX}/runs/:runId/stream`;
+export const ASH_MESSAGE_STREAM_ROUTE_PATTERN = `${ASH_ROUTE_PREFIX}/sessions/:sessionId/stream`;
+/**
+ * Stable framework-owned route prefix for static home-page UI assets.
+ */
+export const ASH_HOME_PAGE_UI_ROUTE_PREFIX = `${ASH_ROUTE_PREFIX}/ui`;
 /**
- * Creates the stable framework-owned message stream route path for one run.
+ * Creates the stable framework-owned message stream route path for one session.
  */
-export function createAshMessageStreamRoutePath(runId) {
-    return `${ASH_ROUTE_PREFIX}/runs/${encodeURIComponent(runId)}/stream`;
+export function createAshMessageStreamRoutePath(sessionId) {
+    return `${ASH_ROUTE_PREFIX}/sessions/${encodeURIComponent(sessionId)}/stream`;
 }
 /**
  * Creates the stable framework-owned authored channel webhook route path for

package/dist/src/protocol/routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/protocol/routes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,gBAAgB,SAAS,CAAC;AAElE;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,gBAAgB,UAAU,CAAC;AAEpE;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,GAAG,gBAAgB,8BAA8B,CAAC;AAEnG;;GAEG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,GAAG,gBAAgB,qBAAqB,CAAC;AAEzF;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAAC,KAAa;IAC3D,OAAO,GAAG,gBAAgB,SAAS,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAAC,SAAiB;IAChE,OAAO,GAAG,gBAAgB,aAAa,kBAAkB,CAAC,SAAS,CAAC,UAAU,CAAC;AACjF,CAAC"}
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/protocol/routes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,gBAAgB,SAAS,CAAC;AAElE;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,gBAAgB,OAAO,CAAC;AAE9D;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,gBAAgB,UAAU,CAAC;AAEpE;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,GAAG,gBAAgB,8BAA8B,CAAC;AAEnG;;GAEG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,GAAG,gBAAgB,6BAA6B,CAAC;AAEjG;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,gBAAgB,KAAK,CAAC;AAEtE;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAAC,SAAiB;IAC/D,OAAO,GAAG,gBAAgB,aAAa,kBAAkB,CAAC,SAAS,CAAC,SAAS,CAAC;AAChF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAAC,SAAiB;IAChE,OAAO,GAAG,gBAAgB,aAAa,kBAAkB,CAAC,SAAS,CAAC,UAAU,CAAC;AACjF,CAAC"}

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

@@ -1,13 +1,13 @@
 /**
- * Channel-level HTTP authentication primitives.
+ * Route-level HTTP authentication primitives.
  *
  * The framework exposes two layers here:
  *
  * 1. **Low-level verifier helpers** (`verifyHttpBasic`, `verifyJwtHmac`,
  *    `verifyJwtEcdsa`, `verifyOidc`, `verifyVercelOidc`,
  *    `extractBearerToken`, `createIpAllowList`, `isIpAllowed`,
- *    `createUnauthorizedResponse`, `withAuth`). These are pure functions
- *    that channels compose by hand inside a `fetch` handler. Use them
+ *    `createUnauthorizedResponse`). These are pure functions
+ *    that routes compose by hand inside a `fetch` handler. Use them
  *    when the strategy helpers don't fit — for example, when stacking
  *    custom rate limits or rendering a custom `WWW-Authenticate`
  *    challenge.
@@ -15,33 +15,32 @@
  * 2. **Strategy helpers** (`vercelOidc`, `httpBasic`, `jwtHmac`,
  *    `jwtEcdsa`, `oidc`, `none`). These return an {@link AuthFn} suitable
  *    for the required `auth` field on the framework's HTTP and Slack
- *    channel factories. Use them when you want a one-liner channel
+ *    route factories. Use them when you want a one-liner route
  *    declaration.
  *
  * @example
  * ```ts
  * // agent/channels/api/message.ts — strategy helper, the common case
- * import { httpMessageChannel } from "experimental-ash/channels/http";
+ * import { httpRoute } from "experimental-ash/channels/http";
  * import { vercelOidc } from "experimental-ash/channels/auth";
  *
- * export default httpMessageChannel({ auth: vercelOidc() });
+ * export default httpRoute({ auth: vercelOidc() });
  * ```
  *
  * @example
  * ```ts
  * // agent/channels/api/message.ts — low-level verifier composition
- * import { defineChannel } from "experimental-ash";
- * import { httpMessageChannel } from "experimental-ash/channels/http";
+ * import { defineRoute } from "experimental-ash";
+ * import { httpRoute } from "experimental-ash/channels/http";
  * import {
  *   createUnauthorizedResponse,
  *   none,
  *   verifyHttpBasic,
- *   withAuth,
  * } from "experimental-ash/channels/auth";
  *
- * const base = httpMessageChannel({ auth: none() });
+ * const base = httpRoute({ auth: none() });
  *
- * export default defineChannel({
+ * export default defineRoute({
  *   ...base,
  *   async fetch(request, ctx) {
  *     const auth = verifyHttpBasic(request.headers.get("authorization"), {
@@ -53,14 +52,14 @@
  *         challenges: [{ scheme: "Basic", parameters: { realm: "weather" } }],
  *       });
  *     }
- *     return base.fetch(request, withAuth(ctx, auth.sessionAuth));
+ *     // Construct channel with auth baked in and pass to agent.run
+ *     return base.fetch(request, ctx);
  *   },
  * });
  * ```
  */
 import type { SessionAuthContext } from "../../channel/types.js";
 import { type RuntimeIpAllowList } from "../../runtime/governance/network/ip-allow-list.js";
-import type { ChannelContext } from "../definitions/channel.js";
 /**
  * Result returned by the verifier helpers below.
  *
@@ -69,7 +68,7 @@ import type { ChannelContext } from "../definitions/channel.js";
  * `runtime.run({ auth })`. On failure, the helper returns `{ ok: false }`
  * with no further detail — distinguishing "no header" from "wrong
  * credentials" is intentionally omitted to discourage information
- * leakage and to keep the helper API minimal. Channels that want
+ * leakage and to keep the helper API minimal. Routes that want
  * different error messages per failure mode can switch on the source of
  * the failure (e.g. inspect the header themselves before calling the
  * verifier).
@@ -100,8 +99,8 @@ export declare function verifyHttpBasic(authorizationHeader: string | null, cred
  * Configuration for {@link verifyJwtHmac}.
  *
  * Mirrors the resolved HMAC strategy shape but takes optional fields with
- * sensible defaults so channels can call it without specifying every
- * matcher. `secret` is read by the channel from `process.env` (or wherever
+ * sensible defaults so adapters can call it without specifying every
+ * matcher. `secret` is read by the adapter from `process.env` (or wherever
  * its secret store lives) and passed in directly.
  */
 export interface VerifyJwtHmacConfig {
@@ -181,13 +180,13 @@ export type IpAllowList = RuntimeIpAllowList;
 export declare function createIpAllowList(entries: readonly string[]): IpAllowList;
 /**
  * Returns whether the supplied IP is permitted by `allowList`. `null`
- * inputs always return `false` — channels that need to allow unknown IPs
+ * inputs always return `false` — adapters that need to allow unknown IPs
  * should not call this helper at all.
  */
 export declare function isIpAllowed(ip: string | null, allowList: IpAllowList): boolean;
 /**
  * One challenge entry attached to the `www-authenticate` header on a
- * failure response. Channels that want a Basic+Bearer challenge prompt
+ * failure response. Adapters that want a Basic+Bearer challenge prompt
  * pass both:
  * `[{ scheme: "Basic", parameters: { realm: "agent" } }, { scheme: "Bearer" }]`
  */
@@ -226,66 +225,18 @@ export interface UnauthorizedResponseOptions {
  */
 export declare function createUnauthorizedResponse(opts?: UnauthorizedResponseOptions): Response;
 /**
- * Returns a {@link ChannelContext} whose agent handle auto-injects the
- * supplied `sessionAuth` into every `run()` and `deliver()` call. Use this
- * in a wrapping channel after verifying credentials so the inner channel's
- * `agent.run()` calls carry the authenticated principal without the inner
- * channel having to know auth happened.
- *
- * The returned context is shallow-spread from the input — `params`,
- * `requestIp`, and `waitUntil` come straight through. Only `agent` is
- * replaced with a wrapped version.
- *
- * @example
- * ```ts
- * import { defineChannel } from "experimental-ash";
- * import { httpMessageChannel } from "experimental-ash/channels/http";
- * import {
- *   createUnauthorizedResponse,
- *   none,
- *   verifyHttpBasic,
- *   withAuth,
- * } from "experimental-ash/channels/auth";
- *
- * const base = httpMessageChannel({ auth: none() });
- *
- * export default defineChannel({
- *   ...base,
- *   async fetch(request, ctx) {
- *     const result = verifyHttpBasic(request.headers.get("authorization"), {
- *       username: "ops",
- *       password: process.env.ROUTE_AUTH_BASIC_PASSWORD!,
- *     });
- *     if (!result.ok) {
- *       return createUnauthorizedResponse({
- *         challenges: [{ scheme: "Basic", parameters: { realm: "weather" } }],
- *       });
- *     }
- *     return base.fetch(request, withAuth(ctx, result.sessionAuth));
- *   },
- * });
- * ```
- *
- * Stacking multiple wrappers (auth, rate limiting, tracing, etc.) is
- * function composition — each wrapper substitutes the agent; the
- * innermost agent is the real one. The pattern is forward-compatible
- * with future middleware helpers (`withRateLimit`, `withTracing`, ...)
- * that follow the same shape.
- */
-export declare function withAuth(ctx: ChannelContext, sessionAuth: SessionAuthContext | null): ChannelContext;
-/**
- * Function shape consumed by channel factories that take a required `auth`
- * field. Receives a channel-typed event (`Request` for HTTP factories,
+ * Function shape consumed by route factories that take a required `auth`
+ * field. Receives a route-typed event (`Request` for HTTP factories,
  * `SlackEventContext` for Slack, etc.) and returns one of three states:
  *
- * - `SessionAuthContext` — **authenticated**. The factory wraps the
- *   channel context via {@link withAuth} and dispatches the request with
- *   the verified principal attached.
+ * - `SessionAuthContext` — **authenticated**. The factory constructs the
+ *   channel with auth baked in and dispatches the request with the
+ *   verified principal attached.
  * - `null` — **rejected**. The credential check failed. HTTP factories
  *   respond with a 401 carrying `WWW-Authenticate: Bearer`. Webhook-style
  *   factories (Slack) log the rejection and drop the message.
  * - `undefined` — **anonymous, allowed through**. The factory dispatches
- *   the request with `withAuth(ctx, null)`, so the harness sees
+ *   the request with `auth: null` on the channel, so the harness sees
  *   `getSession().auth === null`. This is what {@link none} returns.
  *
  * The three states map to the only three things a factory can do with an
@@ -295,19 +246,19 @@ export declare function withAuth(ctx: ChannelContext, sessionAuth: SessionAuthCo
 export type AuthFn<TEvent> = (event: TEvent) => SessionAuthContext | null | undefined | Promise<SessionAuthContext | null | undefined>;
 /**
  * Returns an {@link AuthFn} that always emits `undefined` — the explicit
- * "no auth" choice for channel factories.
+ * "no auth" choice for route factories.
  *
- * Channel factories require an `auth` argument; passing `none()` is the
+ * Route factories require an `auth` argument; passing `none()` is the
  * way to opt into an open route without an implicit default. The factory
- * then dispatches every request with `withAuth(ctx, null)` so the harness
- * sees `getSession().auth === null`.
+ * then dispatches every request with `auth: null` on the channel so the
+ * harness sees `getSession().auth === null`.
  *
  * @example
  * ```ts
- * import { httpMessageChannel } from "experimental-ash/channels/http";
+ * import { httpRoute } from "experimental-ash/channels/http";
  * import { none } from "experimental-ash/channels/auth";
  *
- * export default httpMessageChannel({ auth: none() });
+ * export default httpRoute({ auth: none() });
  * ```
  */
 export declare function none<TEvent = unknown>(): AuthFn<TEvent>;
@@ -337,7 +288,7 @@ export declare function verifyVercelOidc(token: string | null, opts?: {
  * Returns an {@link AuthFn} that verifies the inbound request against the
  * Vercel OIDC issuer via {@link verifyVercelOidc}.
  *
- * This is the recommended `auth` provider for channels deployed on
+ * This is the recommended `auth` provider for routes deployed on
  * Vercel. The dev client at `services/dev-client/request-headers.ts`
  * already attaches `Authorization: Bearer ${VERCEL_OIDC_TOKEN}` for
  * Ash-owned routes during local development, so the same provider works
@@ -345,10 +296,10 @@ export declare function verifyVercelOidc(token: string | null, opts?: {
  *
  * @example
  * ```ts
- * import { httpMessageChannel } from "experimental-ash/channels/http";
+ * import { httpRoute } from "experimental-ash/channels/http";
  * import { vercelOidc } from "experimental-ash/channels/auth";
  *
- * export default httpMessageChannel({ auth: vercelOidc() });
+ * export default httpRoute({ auth: vercelOidc() });
  * ```
  */
 export declare function vercelOidc(opts?: {

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

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../../src/public/channels/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAWjE,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,mDAAmD,CAAC;AAC3D,OAAO,KAAK,EAAS,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAMvE;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAA;CAAE,GAC/D;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC;AAM3B;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,mBAAmB,EAAE,MAAM,GAAG,IAAI,EAClC,WAAW,EAAE,oBAAoB,GAChC,YAAY,CAsBd;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;CAC/D;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAyBvB;AAMD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;CAC/D;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAyBvB;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9D;;;;;OAKG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,YAAY,CAAC,CA0BvB;AAMD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAOpF;AAMD;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,kBAAkB,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,WAAW,GAAG,OAAO,CAK9E;AAMD;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACxD;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,GAAE,2BAAgC,GAAG,QAAQ,CAuB3F;AAoBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,cAAc,EACnB,WAAW,EAAE,kBAAkB,GAAG,IAAI,GACrC,cAAc,CAYhB;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,MAAM,CAAC,MAAM,IAAI,CAC3B,KAAK,EAAE,MAAM,KACV,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAE5F;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,IAAI,CAAC,MAAM,GAAG,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,CAEvD;AAQD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,IAAI,GAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAO,GACnD,OAAO,CAAC,YAAY,CAAC,CAoBvB;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAMhG;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,oBAAoB,GAAG,MAAM,CAAC,OAAO,CAAC,CAK5E;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAAC,OAAO,CAAC,CAMpE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAAC,OAAO,CAAC,CAMtE;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,CAM9D"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../../src/public/channels/auth.ts"],"names":[],"mappings":"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"}