experimental-ash 0.2.0-alpha.3 → 0.2.0-alpha.31

package/dist/src/channel/http-channel.d.ts

@@ -0,0 +1,26 @@
+import type { StepInput } from "../harness/types.js";
+import type { HandleMessageStreamEvent } from "../protocol/message.js";
+import { Channel, type ContextAccessor, type DeliverPayload } from "./types.js";
+/**
+ * Serializable state for {@link HttpChannel}.
+ *
+ * The framework's built-in HTTP channel is stateless, so the default shape is
+ * an empty object. Custom HTTP channel subclasses may extend this with their
+ * own durable fields.
+ */
+export type HttpChannelState = Record<string, unknown>;
+/**
+ * Stateless channel for HTTP routes.
+ *
+ * Events pass straight through to the stream (no side effects). Deliver
+ * payloads pass through untransformed — HTTP clients send structured
+ * {@link InputResponse} objects directly.
+ */
+export declare class HttpChannel extends Channel {
+    static readonly kind: string;
+    constructor(_state?: HttpChannelState);
+    onEvent(event: HandleMessageStreamEvent): Promise<HandleMessageStreamEvent>;
+    onDeliver(_ctx: ContextAccessor, payload: DeliverPayload): Promise<StepInput>;
+    serialize(): Record<string, unknown>;
+}
+//# sourceMappingURL=http-channel.d.ts.map

package/dist/src/channel/http-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-channel.d.ts","sourceRoot":"","sources":["../../../src/channel/http-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvD;;;;;;GAMG;AACH,qBAAa,WAAY,SAAQ,OAAO;IACtC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAU;gBAE1B,MAAM,GAAE,gBAAqB;IAInC,OAAO,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAI3E,SAAS,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAInF,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAGrC"}

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

@@ -0,0 +1,24 @@
+import { Channel } from "./types.js";
+/**
+ * Stateless channel for HTTP routes.
+ *
+ * Events pass straight through to the stream (no side effects). Deliver
+ * payloads pass through untransformed — HTTP clients send structured
+ * {@link InputResponse} objects directly.
+ */
+export class HttpChannel extends Channel {
+    static kind = "http";
+    constructor(_state = {}) {
+        super();
+    }
+    async onEvent(event) {
+        return event;
+    }
+    async onDeliver(_ctx, payload) {
+        return payload;
+    }
+    serialize() {
+        return {};
+    }
+}
+//# sourceMappingURL=http-channel.js.map

package/dist/src/channel/http-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-channel.js","sourceRoot":"","sources":["../../../src/channel/http-channel.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAA6C,MAAM,YAAY,CAAC;AAWhF;;;;;;GAMG;AACH,MAAM,OAAO,WAAY,SAAQ,OAAO;IACtC,MAAM,CAAU,IAAI,GAAW,MAAM,CAAC;IAEtC,YAAY,SAA2B,EAAE;QACvC,KAAK,EAAE,CAAC;IACV,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAA+B;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAqB,EAAE,OAAuB;QAC5D,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,SAAS;QACP,OAAO,EAAE,CAAC;IACZ,CAAC"}

package/dist/src/channel/resolve-text.d.ts

@@ -0,0 +1,20 @@
+import type { InputRequest, InputResponse } from "../runtime/input/types.js";
+/**
+ * Maps freeform text to an {@link InputResponse} for a single request.
+ *
+ * Emitters import this utility to resolve text-based user input against
+ * pending request options. The harness and runtime do not call it.
+ *
+ * Resolution order:
+ * 1. Exact option ID (case-insensitive)
+ * 2. Exact option label (case-insensitive)
+ * 3. 1-based numeric index into the options array
+ * 4. Freeform text if {@link InputRequest.allowFreeform} is not `false`
+ */
+export declare function resolveTextToResponse(text: string, request: InputRequest): InputResponse | undefined;
+/**
+ * Resolves text against all pending requests, returning one
+ * {@link InputResponse} for each request that could be matched.
+ */
+export declare function resolveTextToResponses(text: string, requests: readonly InputRequest[]): readonly InputResponse[];
+//# sourceMappingURL=resolve-text.d.ts.map

package/dist/src/channel/resolve-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-text.d.ts","sourceRoot":"","sources":["../../../src/channel/resolve-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1F;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,aAAa,GAAG,SAAS,CAuB3B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,SAAS,YAAY,EAAE,GAChC,SAAS,aAAa,EAAE,CAW1B"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-text.js","sourceRoot":"","sources":["../../../src/channel/resolve-text.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAY,EACZ,OAAqB;IAErB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEzC,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChE,MAAM,OAAO,GAAG,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;QAChE,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GACnB,OAAO,CAAC,aAAa,KAAK,IAAI,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;IAElG,IAAI,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACzD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,QAAiC;IAEjC,MAAM,SAAS,GAAoB,EAAE,CAAC;IAEtC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACtD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,WAAW,CAAC,UAAkB,EAAE,OAA+B;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC;IACpE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC;IAC1E,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,CAAC,IAAI,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACzF,OAAO,OAAO,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/channel/schedule-channel.d.ts

@@ -0,0 +1,16 @@
+import type { StepInput } from "../harness/types.js";
+import type { HandleMessageStreamEvent } from "../protocol/message.js";
+import { Channel, type ContextAccessor, type DeliverPayload } from "./types.js";
+/**
+ * Stateless channel for scheduled runs.
+ *
+ * Events pass straight through to the stream (no side effects). Deliver
+ * payloads pass through untransformed.
+ */
+export declare class ScheduleChannel extends Channel {
+    static readonly kind = "schedule";
+    onEvent(event: HandleMessageStreamEvent): Promise<HandleMessageStreamEvent>;
+    onDeliver(_ctx: ContextAccessor, payload: DeliverPayload): Promise<StepInput>;
+    serialize(): Record<string, unknown>;
+}
+//# sourceMappingURL=schedule-channel.d.ts.map

package/dist/src/channel/schedule-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-channel.d.ts","sourceRoot":"","sources":["../../../src/channel/schedule-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEhF;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,OAAO;IAC1C,MAAM,CAAC,QAAQ,CAAC,IAAI,cAAc;IAE5B,OAAO,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAI3E,SAAS,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAInF,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAGrC"}

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

@@ -0,0 +1,20 @@
+import { Channel } from "./types.js";
+/**
+ * Stateless channel for scheduled runs.
+ *
+ * Events pass straight through to the stream (no side effects). Deliver
+ * payloads pass through untransformed.
+ */
+export class ScheduleChannel extends Channel {
+    static kind = "schedule";
+    async onEvent(event) {
+        return event;
+    }
+    async onDeliver(_ctx, payload) {
+        return payload;
+    }
+    serialize() {
+        return {};
+    }
+}
+//# sourceMappingURL=schedule-channel.js.map

package/dist/src/channel/schedule-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-channel.js","sourceRoot":"","sources":["../../../src/channel/schedule-channel.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAA6C,MAAM,YAAY,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,OAAO,eAAgB,SAAQ,OAAO;IAC1C,MAAM,CAAU,IAAI,GAAG,UAAU,CAAC;IAElC,KAAK,CAAC,OAAO,CAAC,KAA+B;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAqB,EAAE,OAAuB;QAC5D,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,SAAS;QACP,OAAO,EAAE,CAAC;IACZ,CAAC"}

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

@@ -1,6 +1,5 @@
-import { ScheduleChannelEmitter } from "./schedule-emitter.js";
 import type { RunHandle, Runtime } from "./types.js";
-export { ScheduleChannelEmitter } from "./schedule-emitter.js";
+export { ScheduleChannel } from "./schedule-channel.js";
 /**
  * Input for triggering a one-shot schedule run.
  */
@@ -9,23 +8,22 @@ export interface ScheduleTriggerInput {
     readonly scheduleId: string;
 }
 /**
- * Channel for one-shot scheduled task execution.
+ * Dispatcher for one-shot scheduled task execution.
  *
  * Each trigger generates a unique continuation token so every cron
  * invocation starts a fresh session. Schedule runs always use task
  * mode, so the runtime requires the harness to finish within the
  * current invocation instead of parking for follow-up messages.
  *
- * The channel never touches the compiled bundle, the {@link AshContext},
+ * The dispatcher never touches the compiled bundle, the {@link AshContext},
  * or any execution-layer machinery — it speaks to the runtime through
  * `run` and `deliver` only.
  */
-export declare class ScheduleChannel {
+export declare class ScheduleDispatcher {
     private readonly runtime;
     constructor(config: {
         readonly runtime: Runtime;
     });
-    createEmitter(): ScheduleChannelEmitter;
     trigger(input: ScheduleTriggerInput): Promise<RunHandle>;
 }
 //# sourceMappingURL=schedule.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../../src/channel/schedule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAsB,MAAM,YAAY,CAAC;AAEzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,MAAM,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IAIjD,aAAa,IAAI,sBAAsB;IAIjC,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;CAW/D"}
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../../src/channel/schedule.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAsB,MAAM,YAAY,CAAC;AAEzE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,MAAM,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IAI3C,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;CAU/D"}

package/dist/src/channel/schedule.js

@@ -1,34 +1,30 @@
-import { ScheduleChannelEmitter } from "./schedule-emitter.js";
-export { ScheduleChannelEmitter } from "./schedule-emitter.js";
+import { ScheduleChannel } from "./schedule-channel.js";
+export { ScheduleChannel } from "./schedule-channel.js";
 /**
- * Channel for one-shot scheduled task execution.
+ * Dispatcher for one-shot scheduled task execution.
  *
  * Each trigger generates a unique continuation token so every cron
  * invocation starts a fresh session. Schedule runs always use task
  * mode, so the runtime requires the harness to finish within the
  * current invocation instead of parking for follow-up messages.
  *
- * The channel never touches the compiled bundle, the {@link AshContext},
+ * The dispatcher never touches the compiled bundle, the {@link AshContext},
  * or any execution-layer machinery — it speaks to the runtime through
  * `run` and `deliver` only.
  */
-export class ScheduleChannel {
+export class ScheduleDispatcher {
     runtime;
     constructor(config) {
         this.runtime = config.runtime;
     }
-    createEmitter() {
-        return new ScheduleChannelEmitter();
-    }
     async trigger(input) {
         const continuationToken = `schedule:${input.scheduleId}:${crypto.randomUUID()}`;
         return await this.runtime.run({
             auth: createScheduleAuthContext(input.scheduleId),
-            channelEmitter: this.createEmitter(),
+            channel: new ScheduleChannel(),
             continuationToken,
             input: { message: input.markdown },
             mode: "task",
-            sessionId: crypto.randomUUID(),
         });
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../../src/channel/schedule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAG/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAU/D;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,eAAe;IACT,OAAO,CAAU;IAElC,YAAY,MAAqC;QAC/C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,aAAa;QACX,OAAO,IAAI,sBAAsB,EAAE,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAA2B;QACvC,MAAM,iBAAiB,GAAG,YAAY,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC;QAChF,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;YAC5B,IAAI,EAAE,yBAAyB,CAAC,KAAK,CAAC,UAAU,CAAC;YACjD,cAAc,EAAE,IAAI,CAAC,aAAa,EAAE;YACpC,iBAAiB;YACjB,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE;YAClC,IAAI,EAAE,MAAM;YACZ,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,yBAAyB,CAAC,UAAkB;IACnD,OAAO;QACL,UAAU,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE;QAC3C,aAAa,EAAE,UAAU;QACzB,MAAM,EAAE,iBAAiB;QACzB,WAAW,EAAE,gBAAgB,UAAU,EAAE;QACzC,aAAa,EAAE,SAAS;QACxB,OAAO,EAAE,UAAU;KACpB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../../src/channel/schedule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAUxD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,kBAAkB;IACZ,OAAO,CAAU;IAElC,YAAY,MAAqC;QAC/C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAA2B;QACvC,MAAM,iBAAiB,GAAG,YAAY,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC;QAChF,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;YAC5B,IAAI,EAAE,yBAAyB,CAAC,KAAK,CAAC,UAAU,CAAC;YACjD,OAAO,EAAE,IAAI,eAAe,EAAE;YAC9B,iBAAiB;YACjB,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE;YAClC,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,yBAAyB,CAAC,UAAkB;IACnD,OAAO;QACL,UAAU,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE;QAC3C,aAAa,EAAE,UAAU;QACzB,MAAM,EAAE,iBAAiB;QACzB,WAAW,EAAE,gBAAgB,UAAU,EAAE;QACzC,aAAa,EAAE,SAAS;QACxB,OAAO,EAAE,UAAU;KACpB,CAAC;AACJ,CAAC"}

package/dist/src/channel/slack-channel.d.ts

@@ -0,0 +1,146 @@
+import type { AdapterPostableMessage, SerializedThread, Thread } from "chat";
+import type { StepInput } from "../harness/types.js";
+import type { HandleMessageStreamEvent } from "../protocol/message.js";
+import type { InputRequest } from "../runtime/input/types.js";
+import { createSlackCardKit } from "./slack-render.js";
+import type { InteractionDelivery, SlackInteraction, SlackInteractionContext, SlackRenderable, SlackThreadHandle } from "./slack-types.js";
+import { Channel, type ContextAccessor, type DeliverPayload } from "./types.js";
+/**
+ * User context for the Slack message sender, stored in channel state so
+ * agents can understand who they are interacting with.
+ */
+export interface SlackUserContext {
+    /** Slack user id, e.g. `U0123ABC`. */
+    readonly userId: string;
+    /** Slack handle, e.g. `jane.smith`. */
+    readonly userName: string;
+    /** Display name, e.g. `Jane Smith`. */
+    readonly fullName: string;
+    /** Slack workspace (team) id, e.g. `T0123ABC`. */
+    readonly teamId?: string;
+    /** Slack channel id where the conversation is happening, e.g. `C0123ABC`. */
+    readonly channelId: string;
+    /** Thread root timestamp identifying the conversation. */
+    readonly threadTs: string;
+}
+/**
+ * Minimal serializable state for the Slack channel.
+ */
+export interface SlackChannelState {
+    readonly botToken?: string;
+    readonly serializedThread: SerializedThread;
+    /**
+     * Pending input requests stored by `onEvent("input.requested")` and
+     * read by `onDeliver` to resolve text-based replies against the
+     * request options.
+     */
+    readonly pendingRequests?: readonly InputRequest[];
+    /**
+     * Context about the current Slack user and thread. Included in every
+     * message so the agent knows who it is interacting with and can use
+     * the thread id for tool calls.
+     */
+    readonly userContext?: SlackUserContext;
+}
+/**
+ * Channel that rehydrates a Chat SDK `Thread` from serialized state and
+ * uses `thread.startTyping()` to show typing status with tool names while
+ * the agent is working, then posts the final reply via `thread.post()`.
+ *
+ * For HITL input requests, renders platform-native interactive elements
+ * (Block Kit buttons and select menus) and stores the pending requests
+ * in serializable state so `onDeliver` can resolve text replies.
+ *
+ * Subclasses may override the static {@link kind} field and extend the
+ * channel state shape by parameterizing {@link SlackChannel} with their own
+ * `TState extends SlackChannelState`. The inherited instance {@link kind}
+ * getter and {@link serialize} behavior follow the subclass automatically,
+ * so stateful subclasses do not need extra boilerplate just to preserve
+ * their durable identity and JSON-serializable state.
+ */
+export declare class SlackChannel<TState extends SlackChannelState = SlackChannelState> extends Channel {
+    static readonly kind: string;
+    private _state;
+    private _cardKitPromise;
+    private _pendingToolCallMessage;
+    private _threadPromise;
+    constructor(state: TState);
+    /**
+     * Typed serializable state for this channel instance.
+     *
+     * Subclasses can extend the state shape by parameterizing
+     * {@link SlackChannel} and reading or replacing the full state object
+     * through this accessor.
+     */
+    protected get state(): TState;
+    protected set state(value: TState);
+    get botToken(): string | undefined;
+    get serializedThread(): SerializedThread;
+    serialize(): Record<string, unknown>;
+    /**
+     * Interaction hook for Slack `block_actions`.
+     *
+     * Called when the route can rehydrate the channel from the last durable
+     * session snapshot. The return value controls what happens next:
+     *
+     * - `{ inputResponses }` — deliver structured HITL responses.
+     * - `{ message }` — wake the agent with a text message.
+     * - bare `return` (void) — nothing to deliver (handled inline or no-op).
+     *
+     * The default implementation calls `ctx.resolveInputResponses()` which
+     * maps button clicks and select menus to HITL input responses.
+     * Subclasses override to handle custom actions and call
+     * `ctx.resolveInputResponses()` for the explicit HITL path.
+     */
+    onInteraction(_interaction: SlackInteraction, ctx: SlackInteractionContext): Promise<InteractionDelivery | void>;
+    onDeliver(_ctx: ContextAccessor, payload: DeliverPayload): Promise<StepInput>;
+    /**
+     * Prepends the Slack user context XML block to a message if user context
+     * is available. This provides the agent with information about who sent
+     * the message and the thread context for potential use in tool calls.
+     */
+    private prependUserContext;
+    onEvent(event: HandleMessageStreamEvent): Promise<HandleMessageStreamEvent>;
+    private consumePendingToolCallMessage;
+    private consumePendingToolCallStatus;
+    private clearPendingToolCallMessage;
+    private setPendingToolCallMessage;
+    protected post(text: string): Promise<void>;
+    protected startTyping(status: string): Promise<void>;
+    /**
+     * Exposes an Ash-owned Slack thread surface for subclasses.
+     */
+    protected getSlackThread(): Promise<SlackThreadHandle>;
+    /**
+     * Lazily imports the Chat SDK card element constructors.
+     */
+    protected getCardKit(): Promise<ReturnType<typeof createSlackCardKit>>;
+    protected toPostableMessage(renderable: SlackRenderable): Promise<AdapterPostableMessage>;
+    /**
+     * Renders each pending input request as a rich Slack card with
+     * interactive buttons or select menus, posted to the thread.
+     */
+    private renderInputRequests;
+    /**
+     * Lazily rehydrates the Chat SDK Thread from serialized state.
+     *
+     * `@chat-adapter/slack` and `chat` are listed in
+     * `WORKFLOW_BUILDER_DEFERRED_PACKAGES` so the initial
+     * `@workflow/builders` pass externalizes them (avoiding `node:*`
+     * errors in the workflow VM). Nitro's hosted-function bundle pass
+     * then traces and resolves them for deployment output.
+     */
+    protected getThread(): Promise<Thread<Record<string, unknown>, unknown>>;
+}
+/**
+ * Maps Slack button clicks and select menus to HITL input responses.
+ *
+ * Buttons encode `requestId` as the button `value` and `optionId` as the
+ * `actionId`. Selects encode `requestId` as the `actionId` (prefixed with
+ * `select_`) and `optionId` as the `selectedOptionId`.
+ *
+ * Returns an {@link InteractionDelivery} with the mapped responses, or
+ * `null` when no actions could be mapped.
+ */
+export declare function deriveInputResponsesFromInteraction(interaction: SlackInteraction): InteractionDelivery | undefined;
+//# sourceMappingURL=slack-channel.d.ts.map

package/dist/src/channel/slack-channel.d.ts.map

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