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

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

@@ -1,6 +1,14 @@
+import type { ContextStoreKey } from "../context/key.js";
+import type { StepInput } from "../harness/types.js";
 import type { HandleMessageStreamEvent } from "../protocol/message.js";
 import type { RunMode } from "../run-mode.js";
-import type { RuntimeInputRequest, RuntimeInputResult } from "../runtime/input/types.js";
+import type { InputResponse } from "../runtime/input/types.js";
+/**
+ * Global symbol brand used to recognize Ash channel classes across
+ * independently-loaded copies of the package during compile/runtime tests.
+ */
+export declare const CHANNEL_CLASS_BRAND: unique symbol;
+export declare const CHANNEL_PROTOTYPE_BRAND: unique symbol;
 /**
  * Identifies one turn within a session.
  */
@@ -13,16 +21,15 @@ export interface SessionTurn {
  * delegated the current session.
  */
 export interface SessionParent {
-    readonly runId: string;
     readonly sessionId: string;
     readonly turn: SessionTurn;
 }
 /**
  * Authenticated caller principal attached to a request.
  *
- * Produced by the route-level auth strategies (JWT, OIDC, HTTP Basic, etc.)
- * and threaded through the channel into the runtime context via the
- * `AuthKey` seed on the {@link AshContext} handed to {@link Runtime.run}.
+ * Produced by route-level auth strategies (JWT, OIDC, HTTP Basic, etc.)
+ * and passed to the runtime on {@link RunInput.auth} and
+ * {@link DeliverInput.auth}.
  */
 export interface SessionAuthContext {
     readonly attributes: Readonly<Record<string, string | readonly string[]>>;
@@ -32,121 +39,183 @@ export interface SessionAuthContext {
     readonly principalType: string;
     readonly subject?: string;
 }
+/**
+ * Narrow accessor passed to {@link Channel.onDeliver} callbacks. Exposes only
+ * typed context operations — keeps channel code workflow-agnostic and
+ * prevents channels from depending on {@link AshContext} internals such as
+ * `entries()`.
+ */
+export interface ContextAccessor {
+    get<T>(key: ContextStoreKey<T>): T;
+    tryGet<T>(key: ContextStoreKey<T>): T | undefined;
+    has<T>(key: ContextStoreKey<T>): boolean;
+    set<T>(key: ContextStoreKey<T>, value: T): void;
+    ensure<T>(key: ContextStoreKey<T>, valueOrFactory: T | (() => T)): T;
+}
 /**
  * Function provided by the runtime that writes one event to the event stream.
  *
  * Backed by `getWritable()` in the workflow runtime or a `TransformStream`
- * in the continuous loop runtime.
+ * in the continuous loop runtime. Not part of the {@link Channel} interface —
+ * the runtime always writes events to the stream itself.
  */
 export type EventEmitFn = (event: HandleMessageStreamEvent) => Promise<void>;
 /**
- * Channel-owned emitter invoked by the runtime for each event during step
- * execution.
+ * Raw payload from a channel deliver call.
+ *
+ * For interactive channels (Slack button callbacks, HTTP clients), the
+ * payload may carry structured {@link InputResponse} objects alongside
+ * or instead of a text message. For text-only channels (Slack thread
+ * replies), only `message` is set.
+ */
+export interface DeliverPayload {
+    readonly inputResponses?: readonly InputResponse[];
+    readonly message?: string;
+}
+/**
+ * Serializable payload sent through the workflow `resumeHook` on deliver.
  *
- * The emitter receives the event and an `emit` function. Calling `emit`
- * writes the event to the runtime's event stream. The emitter may also
- * perform platform-specific side effects (e.g. posting a Slack thread reply)
- * or rewrite the event before writing it (e.g. wrapping every child event
- * in a `subagent.event` envelope, as {@link SubagentChannelEmitter} does).
+ * Wraps the raw {@link DeliverPayload} together with an optional auth
+ * update so deliver-time auth can cross the durable hook boundary
+ * without a process-local side-channel.
+ */
+export interface HookPayload {
+    readonly auth?: SessionAuthContext | null;
+    readonly payload: DeliverPayload;
+}
+/**
+ * Serializable conduit that owns the full lifecycle of one platform
+ * integration.
+ *
+ * A channel carries auth, renders outbound events to the platform,
+ * transforms inbound deliver payloads, and optionally sets custom
+ * context keys. It is serialized across workflow step boundaries via
+ * {@link serialize} plus constructor-based rehydration performed by the
+ * runtime-owned channel registry.
  *
- * Each emitter implementation owns its own serialization across workflow
- * step boundaries via {@link serialize} and {@link ChannelEmitterClass.deserialize}.
- * The framework's `ChannelEmitterKey` codec calls these methods through a
- * process-global registry keyed by `kind` — the registry is populated when
- * an emitter module is imported and calls `registerChannelEmitter`.
+ * Channels are class-based durable values. Authors define a concrete
+ * subclass, declare a unique static `kind`, and pass an instance on
+ * {@link RunInput.channel}. The runtime invokes {@link onEvent} /
+ * {@link onDeliver} during the step loop. Auth is separate from the
+ * channel — it lives on {@link RunInput.auth} and
+ * {@link DeliverInput.auth}.
  */
-export interface ChannelEmitter {
+export declare abstract class Channel {
     /**
-     * Stable identifier for this emitter class. Must match the `kind` static
-     * field on the corresponding {@link ChannelEmitterClass}.
+     * Runtime marker inherited by every channel subclass constructor.
+     * Used by route-definition validation without relying on `instanceof`
+     * across multiple loaded copies of the package.
      */
-    readonly kind: string;
+    static readonly [CHANNEL_CLASS_BRAND] = true;
+    /**
+     * Runtime marker inherited by every channel subclass prototype.
+     * Route-definition validation reads this through the subclass prototype
+     * chain so authored channels from another loaded package copy still
+     * register correctly.
+     */
+    protected get [CHANNEL_PROTOTYPE_BRAND](): true;
     /**
-     * Called by the runtime for every lifecycle event. Implementations must
-     * call `emit(event)` to forward the event to the runtime stream and may
-     * additionally perform platform-specific side effects.
+     * Nominal marker that prevents plain object literals from satisfying
+     * the channel contract. Durable channels must be real class instances.
      */
-    onEvent(event: HandleMessageStreamEvent, emit: EventEmitFn): Promise<void>;
+    protected readonly __channelBrand: undefined;
     /**
-     * Converts raw platform input into structured {@link RuntimeInputResult}s
-     * when the session has pending input requests.
+     * Stable identifier for this channel instance, derived from the
+     * subclass's static {@link ChannelClass.kind} field.
+     */
+    get kind(): string;
+    /**
+     * Outbound: called by the runtime for every lifecycle event. Returns
+     * the event to write to the stream — usually the same event passed
+     * in, but channels may transform it (e.g. the subagent channel wraps
+     * events in `subagent.event` envelopes).
      *
-     * Called by the harness just before resolving a pending input batch.
-     * Emitters for platforms that cannot send structured input results
-     * (e.g. Slack, where the user types "yes") implement this to map
-     * freeform text to approval or question responses. Emitters for
-     * platforms that already send structured results (e.g. HTTP) omit
-     * this method.
+     * Platform-specific side effects (Slack typing indicators, message
+     * posting, etc.) happen inside this method before returning.
+     */
+    abstract onEvent(event: HandleMessageStreamEvent): Promise<HandleMessageStreamEvent>;
+    /**
+     * Called once per turn — both the initial `run()` and each
+     * `deliver()` — after auth keys have been seeded on the context.
      *
-     * Return `undefined` to fall through to the default behavior (auto-
-     * generated "ignored" responses for each unresolved request).
+     * The channel receives a context accessor and the inbound payload.
+     * It can set custom context keys (e.g. thread history for tools to
+     * read) and transform the payload (e.g. resolve text against pending
+     * input request options). Returns the resolved step input that the
+     * harness will see.
+     *
+     * Async so channels can fetch platform data (thread history, user
+     * profiles, etc.) before the step runs.
      */
-    resolveInput?(input: {
-        readonly message: string;
-        readonly requests: readonly RuntimeInputRequest[];
-    }): readonly RuntimeInputResult[] | undefined;
+    abstract onDeliver(ctx: ContextAccessor, payload: DeliverPayload): Promise<StepInput>;
     /**
-     * Returns the JSON-serializable state needed to reconstruct this emitter
-     * after a workflow step boundary. The framework wraps the result in
-     * `{ kind, state }` and stores it on the durable workflow context.
+     * Returns the JSON-serializable state needed to reconstruct this
+     * channel after a workflow step boundary. The framework wraps the
+     * result in `{ kind, state }` and stores it on the durable workflow
+     * context.
      */
-    serialize(): Record<string, unknown>;
+    abstract serialize(): Record<string, unknown>;
 }
 /**
- * Static interface implemented by every {@link ChannelEmitter} class. Used by
- * the channel emitter registry to look up a class by `kind` and rebuild an
- * instance from previously-serialized state.
+ * Static interface implemented by every {@link Channel} class. Used by
+ * the runtime-owned channel registry to look up a class by `kind` and
+ * rebuild an instance from previously-serialized state.
  */
-export interface ChannelEmitterClass<E extends ChannelEmitter = ChannelEmitter> {
+export interface ChannelClass<C extends Channel = Channel> {
+    /**
+     * Stable durable identifier for the channel subclass. Must be unique
+     * across all serializable channel classes visible to one runtime bundle.
+     */
     readonly kind: string;
     /**
-     * Reconstructs an emitter instance from state previously returned by
-     * {@link ChannelEmitter.serialize}.
+     * Constructs a channel instance. Specific route helpers may constrain the
+     * constructor input shape further (for example Slack channel classes accept
+     * {@link import("./slack-channel.js").SlackChannelState}).
      */
-    deserialize(state: Record<string, unknown>): E;
+    new (...args: never[]): C;
 }
+/**
+ * Returns the static durable kind for a channel class.
+ */
+export declare function getChannelClassKind(channelClass: ChannelClass): string;
 /**
  * Single input shape consumed by {@link Runtime.run} for both root runs
- * (started by channels) and delegated child runs (started by the
+ * (started by routes) and delegated child runs (started by the
  * subagent tool wrapper).
  *
- * Channels build the platform-facing fields (`auth`, `channelEmitter`,
+ * Routes build the platform-facing fields (`auth`, `channel`,
  * `continuationToken`, `input`, `mode`, `sessionId`) from inbound
  * platform input and call `runtime.run(input)` directly. The subagent
  * tool wrapper builds the same shape and additionally sets
  * `initiatorAuth` and `parent` to forward the audit chain and record
- * lineage. The runtime is the one place that knows how to turn this
- * into a fully-seeded {@link AshContext} — channels and the wrapper
- * stay free of any compiled-bundle or context-building knowledge.
+ * lineage.
  *
- * `input.message` is the first user-visible message for this run.
+ * `input.message` is the first user-visible message for this session.
  * Subsequent deliveries via {@link Runtime.deliver} carry their own
- * messages, so the field is per-call rather than run-wide state.
+ * messages, so the field is per-call rather than session-wide state.
  */
 export interface RunInput {
     /**
-     * Authenticated caller principal for this run. `null` (or omitted)
-     * means the request was accepted with no credentials. For delegated
-     * runs this is the auth of whoever called the parent step that
-     * triggered the delegation.
+     * Authenticated caller principal for this session. `null` means the
+     * request was accepted with no credentials.
      */
-    readonly auth?: SessionAuthContext | null;
+    readonly auth: SessionAuthContext | null;
     /**
-     * Serializable channel emitter that owns event delivery policy for
-     * this run.
+     * The channel conduit for this session. Owns event delivery policy
+     * and is serialized across workflow step boundaries.
      */
-    readonly channelEmitter: ChannelEmitter;
+    readonly channel: Channel;
     readonly continuationToken: string;
-    readonly input: {
-        readonly message: string;
-    };
     /**
      * The original (top-level) caller's auth, forwarded down the
      * delegation chain so the child's `session.auth.initiator` always
-     * resolves back to whoever started the root run. Defaults to `auth`
-     * when omitted (root run behavior).
+     * resolves back to whoever started the root session. Defaults to
+     * {@link auth} when omitted (root session behavior).
      */
     readonly initiatorAuth?: SessionAuthContext | null;
+    readonly input: {
+        readonly message: string;
+    };
     /**
      * Execution mode for the run.
      *
@@ -157,7 +226,7 @@ export interface RunInput {
     readonly mode: RunMode;
     /**
      * Lineage metadata describing the immediate parent execution that
-     * delegated this run. Absent on root runs started by channels.
+     * delegated this run. Absent on root runs started by routes.
      */
     readonly parent?: SessionParent;
     /**
@@ -173,15 +242,13 @@ export interface RunInput {
 export interface DeliverInput {
     /**
      * Authenticated caller principal for this follow-up message.
-     * May differ from the session initiator when different users send messages
-     * to the same session.
+     * May differ from the session initiator when different users send
+     * messages to the same session. The runtime updates `AuthKey` from
+     * this field before calling the channel's hooks.
      */
     readonly auth?: SessionAuthContext | null;
     readonly continuationToken: string;
-    readonly payload: {
-        readonly inputResults?: readonly RuntimeInputResult[];
-        readonly message?: string;
-    };
+    readonly payload: DeliverPayload;
 }
 /**
  * Terminal outcome of a runtime turn, resolved via `RunHandle.result`.
@@ -206,14 +273,14 @@ export interface RunHandle {
     readonly sessionId: string;
 }
 /**
- * Runtime interface consumed by channels and the subagent tool wrapper.
+ * Runtime interface consumed by routes and the subagent tool wrapper.
  *
  * The runtime owns the compiled-bundle source and an optional node
  * selector (both passed at construction time). It is the only place
  * that knows how to load the compiled bundle, build a fully-seeded
  * {@link AshContext}, and drive the step loop.
  *
- * Channels construct a root runtime (no node selector) and call
+ * Routes construct a root runtime (no node selector) and call
  * `runtime.run(input)` with flat platform-shape input. The subagent
  * tool wrapper creates a child runtime pre-configured for the target
  * node via the `createChildRuntime` factory, then calls
@@ -233,19 +300,19 @@ export interface Runtime {
      */
     deliver(input: DeliverInput): Promise<void>;
     /**
-     * Returns a readable stream of lifecycle events for an existing run.
+     * Returns a readable stream of lifecycle events for an existing session.
      *
-     * Used by the framework's HTTP run-stream channel and any user-authored
-     * channel that exposes an event-streaming endpoint. Backed by the
-     * workflow API's per-run durable stream.
+     * Used by the framework's HTTP session-stream route and any
+     * user-authored route that exposes an event-streaming endpoint.
+     * Backed by the workflow API's per-session durable stream.
      *
-     * `options.startIndex` selects the zero-based position of the first event
-     * to yield, dropping any earlier events. The framework HTTP run-stream
-     * channel forwards the value from the `startIndex` query parameter so a
-     * reconnecting client can resume after the events it has already
-     * consumed without replaying the prior turn.
+     * `options.startIndex` selects the zero-based position of the first
+     * event to yield, dropping any earlier events. The framework HTTP
+     * session-stream route forwards the value from the `startIndex`
+     * query parameter so a reconnecting client can resume after the
+     * events it has already consumed without replaying the prior turn.
      */
-    getEventStream(runId: string, options?: GetEventStreamOptions): Promise<ReadableStream<HandleMessageStreamEvent>>;
+    getEventStream(sessionId: string, options?: GetEventStreamOptions): Promise<ReadableStream<HandleMessageStreamEvent>>;
 }
 /**
  * Options accepted by {@link Runtime.getEventStream}.

package/dist/src/channel/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/channel/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAMzF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE7E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,wBAAwB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,CAAC,KAAK,EAAE;QACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;KACnD,GAAG,SAAS,kBAAkB,EAAE,GAAG,SAAS,CAAC;IAC9C;;;;OAIG;IACH,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC1C;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnD;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;QACtD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,wBAAwB,CAAC,CAAC;IAC1D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,OAAO;IACtB;;;;;;OAMG;IACH,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEzC;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;;;;;;;;;;;OAYG;IACH,cAAc,CACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/channel/types.ts"],"names":[],"mappings":"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"}

package/dist/src/channel/types.js

@@ -1,2 +1,65 @@
-export {};
+/**
+ * Global symbol brand used to recognize Ash channel classes across
+ * independently-loaded copies of the package during compile/runtime tests.
+ */
+export const CHANNEL_CLASS_BRAND = Symbol.for("ash.channel.class");
+export const CHANNEL_PROTOTYPE_BRAND = Symbol.for("ash.channel.prototype");
+// ---------------------------------------------------------------------------
+// Channel
+// ---------------------------------------------------------------------------
+/**
+ * Serializable conduit that owns the full lifecycle of one platform
+ * integration.
+ *
+ * A channel carries auth, renders outbound events to the platform,
+ * transforms inbound deliver payloads, and optionally sets custom
+ * context keys. It is serialized across workflow step boundaries via
+ * {@link serialize} plus constructor-based rehydration performed by the
+ * runtime-owned channel registry.
+ *
+ * Channels are class-based durable values. Authors define a concrete
+ * subclass, declare a unique static `kind`, and pass an instance on
+ * {@link RunInput.channel}. The runtime invokes {@link onEvent} /
+ * {@link onDeliver} during the step loop. Auth is separate from the
+ * channel — it lives on {@link RunInput.auth} and
+ * {@link DeliverInput.auth}.
+ */
+export class Channel {
+    /**
+     * Runtime marker inherited by every channel subclass constructor.
+     * Used by route-definition validation without relying on `instanceof`
+     * across multiple loaded copies of the package.
+     */
+    static [CHANNEL_CLASS_BRAND] = true;
+    /**
+     * Runtime marker inherited by every channel subclass prototype.
+     * Route-definition validation reads this through the subclass prototype
+     * chain so authored channels from another loaded package copy still
+     * register correctly.
+     */
+    get [CHANNEL_PROTOTYPE_BRAND]() {
+        return true;
+    }
+    /**
+     * Nominal marker that prevents plain object literals from satisfying
+     * the channel contract. Durable channels must be real class instances.
+     */
+    __channelBrand;
+    /**
+     * Stable identifier for this channel instance, derived from the
+     * subclass's static {@link ChannelClass.kind} field.
+     */
+    get kind() {
+        return getChannelClassKind(this.constructor);
+    }
+}
+/**
+ * Returns the static durable kind for a channel class.
+ */
+export function getChannelClassKind(channelClass) {
+    if (typeof channelClass.kind !== "string" || channelClass.kind.length === 0) {
+        throw new TypeError("Channel classes must declare a non-empty static `kind` field.");
+    }
+    return channelClass.kind;
+}
 //# sourceMappingURL=types.js.map

package/dist/src/channel/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/channel/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/channel/types.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AACnE,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAuG3E,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAgB,OAAO;IAC3B;;;;OAIG;IACH,MAAM,CAAU,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC;IAC7C;;;;;OAKG;IACH,IAAc,CAAC,uBAAuB,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IACD;;;OAGG;IACgB,cAAc,CAAa;IAE9C;;;OAGG;IACH,IAAI,IAAI;QACN,OAAO,mBAAmB,CAAC,IAAI,CAAC,WAA2B,CAAC,CAAC;IAC/D,CAAC;;AAqDH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAA0B;IAC5D,IAAI,OAAO,YAAY,CAAC,IAAI,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,YAAY,CAAC,IAAI,CAAC;AAC3B,CAAC"}

package/dist/src/cli/dev/input-requests.d.ts

@@ -1,5 +1,5 @@
 import type { HandleMessageStreamEvent } from "../../protocol/message.js";
-import type { RuntimeInputRequest, RuntimeInputResult } from "../../runtime/input/types.js";
+import type { InputRequest, InputResponse } from "../../runtime/input/types.js";
 import { type CliTheme } from "../ui/output.js";
 /**
  * Sentinel returned when the CLI user pressed Escape while responding to a
@@ -15,7 +15,7 @@ export type RuntimeInputPromptValue = string | typeof ESCAPED_RUNTIME_INPUT_PROM
  * Outcome of one interactive CLI prompt pass for pending runtime input.
  */
 export type RuntimeInputPromptResult = {
-    readonly inputResults: readonly RuntimeInputResult[];
+    readonly inputResponses: readonly InputResponse[];
     readonly kind: "submitted";
 } | {
     readonly kind: "deferred";
@@ -25,7 +25,7 @@ export type RuntimeInputPromptResult = {
 /**
  * Returns the last pending runtime-input batch emitted in one turn, if any.
  */
-export declare function extractPendingRuntimeInputRequests(events: readonly HandleMessageStreamEvent[]): readonly RuntimeInputRequest[];
+export declare function extractPendingRuntimeInputRequests(events: readonly HandleMessageStreamEvent[]): readonly InputRequest[];
 /**
  * Interactively collects CLI-native responses for pending runtime input
  * requests.
@@ -33,7 +33,7 @@ export declare function extractPendingRuntimeInputRequests(events: readonly Hand
 export declare function promptForRuntimeInputRequests(input: {
     ask(prompt: string): Promise<RuntimeInputPromptValue>;
     print(message: string): void;
-    requests: readonly RuntimeInputRequest[];
+    requests: readonly InputRequest[];
     theme: CliTheme;
 }): Promise<RuntimeInputPromptResult>;
 //# sourceMappingURL=input-requests.d.ts.map

package/dist/src/cli/dev/input-requests.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input-requests.d.ts","sourceRoot":"","sources":["../../../../src/cli/dev/input-requests.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAGnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,KAAK,QAAQ,EAAuB,MAAM,iBAAiB,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,4BAA4B,eAA0C,CAAC;AAEpF;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,OAAO,4BAA4B,GAAG,SAAS,CAAC;AAE/F;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAChC;IACE,QAAQ,CAAC,YAAY,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CAC1B,CAAC;AAEN;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,SAAS,wBAAwB,EAAE,GAC1C,SAAS,mBAAmB,EAAE,CAUhC;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CAAC,KAAK,EAAE;IACzD,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACtD,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACzC,KAAK,EAAE,QAAQ,CAAC;CACjB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA8BpC"}
+{"version":3,"file":"input-requests.d.ts","sourceRoot":"","sources":["../../../../src/cli/dev/input-requests.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAE,KAAK,QAAQ,EAAuB,MAAM,iBAAiB,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,4BAA4B,eAA0C,CAAC;AAEpF;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,OAAO,4BAA4B,GAAG,SAAS,CAAC;AAE/F;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAChC;IACE,QAAQ,CAAC,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CAC1B,CAAC;AAEN;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,SAAS,wBAAwB,EAAE,GAC1C,SAAS,YAAY,EAAE,CAUzB;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CAAC,KAAK,EAAE;IACzD,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACtD,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAClC,KAAK,EAAE,QAAQ,CAAC;CACjB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA8BpC"}

package/dist/src/cli/dev/input-requests.js

@@ -1,3 +1,4 @@
+import { resolveTextToResponse } from "../../channel/resolve-text.js";
 import { renderCliTaggedLine } from "../ui/output.js";
 /**
  * Sentinel returned when the CLI user pressed Escape while responding to a
@@ -21,7 +22,7 @@ export function extractPendingRuntimeInputRequests(events) {
  * requests.
  */
 export async function promptForRuntimeInputRequests(input) {
-    const results = [];
+    const responses = [];
     input.print(renderCliTaggedLine(input.theme, {
         message: `pending input request${input.requests.length === 1 ? "" : "s"}: reply now, press Escape, or type "skip" to return to the normal prompt`,
         tag: "input",
@@ -37,34 +38,38 @@ export async function promptForRuntimeInputRequests(input) {
         if (result.kind !== "submitted") {
             return result;
         }
-        results.push(result.inputResult);
+        responses.push(result.inputResponse);
     }
     return {
-        inputResults: results,
+        inputResponses: responses,
         kind: "submitted",
     };
 }
+/**
+ * Returns true when the request represents a tool approval (confirmation).
+ */
+function isApprovalRequest(request) {
+    return request.display === "confirmation";
+}
 async function promptForRuntimeInputRequest(input) {
-    switch (input.request.kind) {
-        case "question":
-            return await promptForQuestionInputRequest({
-                ask: input.ask,
-                print: input.print,
-                request: input.request,
-                theme: input.theme,
-            });
-        case "tool-approval":
-            return await promptForToolApprovalInputRequest({
-                ask: input.ask,
-                print: input.print,
-                request: input.request,
-                theme: input.theme,
-            });
+    if (isApprovalRequest(input.request)) {
+        return await promptForApprovalInputRequest({
+            ask: input.ask,
+            print: input.print,
+            request: input.request,
+            theme: input.theme,
+        });
     }
+    return await promptForQuestionInputRequest({
+        ask: input.ask,
+        print: input.print,
+        request: input.request,
+        theme: input.theme,
+    });
 }
-async function promptForToolApprovalInputRequest(input) {
+async function promptForApprovalInputRequest(input) {
     input.print(renderCliTaggedLine(input.theme, {
-        message: `approve tool "${input.request.toolName}"?`,
+        message: `approve tool "${input.request.action.toolName}"? (yes/no)`,
         tag: "approval",
         tone: "warning",
     }));
@@ -90,20 +95,18 @@ async function promptForToolApprovalInputRequest(input) {
             normalized === "y" ||
             normalized === "yes") {
             return {
-                inputResult: {
-                    approvalId: input.request.approvalId,
-                    approved: true,
-                    kind: "tool-approval-result",
+                inputResponse: {
+                    optionId: "approve",
+                    requestId: input.request.requestId,
                 },
                 kind: "submitted",
             };
         }
         if (normalized === "d" || normalized === "deny" || normalized === "n" || normalized === "no") {
             return {
-                inputResult: {
-                    approvalId: input.request.approvalId,
-                    approved: false,
-                    kind: "tool-approval-result",
+                inputResponse: {
+                    optionId: "deny",
+                    requestId: input.request.requestId,
                 },
                 kind: "submitted",
             };
@@ -141,33 +144,10 @@ async function promptForQuestionInputRequest(input) {
         if (trimmedValue === "skip" || trimmedValue === "/skip") {
             return { kind: "deferred" };
         }
-        const selectedOption = resolveQuestionOption({
-            options: input.request.options,
-            value: trimmedValue,
-        });
-        if (selectedOption !== undefined) {
+        const response = resolveTextToResponse(trimmedValue, input.request);
+        if (response !== undefined) {
             return {
-                inputResult: {
-                    callId: input.request.action.callId,
-                    kind: "question-result",
-                    output: {
-                        optionId: selectedOption.id,
-                        status: "answered",
-                    },
-                },
-                kind: "submitted",
-            };
-        }
-        if (acceptsFreeform && trimmedValue.length > 0) {
-            return {
-                inputResult: {
-                    callId: input.request.action.callId,
-                    kind: "question-result",
-                    output: {
-                        status: "answered",
-                        text: trimmedValue,
-                    },
-                },
+                inputResponse: response,
                 kind: "submitted",
             };
         }
@@ -182,15 +162,4 @@ async function promptForQuestionInputRequest(input) {
         }));
     }
 }
-function resolveQuestionOption(input) {
-    if (input.options === undefined || input.options.length === 0) {
-        return undefined;
-    }
-    const numericIndex = Number(input.value);
-    if (Number.isInteger(numericIndex) && numericIndex > 0) {
-        return input.options[numericIndex - 1];
-    }
-    const normalizedValue = input.value.toLowerCase();
-    return input.options.find((option) => option.id.toLowerCase() === normalizedValue || option.label.toLowerCase() === normalizedValue);
-}
 //# sourceMappingURL=input-requests.js.map