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

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;CAW/D"}

package/dist/src/channel/schedule.js

@@ -1,30 +1,27 @@
-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",

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;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"}

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

@@ -0,0 +1,125 @@
+import type { Actions, Button, Card, CardText, Select, SelectOption, SerializedThread } from "chat";
+import type { StepInput } from "../harness/types.js";
+import type { HandleMessageStreamEvent } from "../protocol/message.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;
+    /**
+     * 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;
+}
+interface RehydratedThread {
+    post(message: string | {
+        readonly markdown: string;
+    } | unknown): Promise<unknown>;
+    startTyping(status?: string): Promise<void>;
+}
+/**
+ * Dynamically imported Chat SDK card element constructors.
+ * Loaded lazily alongside the adapter to avoid bundling `chat`
+ * in workflow VMs.
+ */
+interface CardKit {
+    Actions: typeof Actions;
+    Button: typeof Button;
+    Card: typeof Card;
+    CardText: typeof CardText;
+    Select: typeof Select;
+    SelectOption: typeof SelectOption;
+}
+/**
+ * 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). Pending input requests come from the
+ * runtime's per-step context, not from mutable serialized channel state, so
+ * `onDeliver` can resolve text replies after parked workflow resumes.
+ *
+ * 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 readonly _state;
+    private _cardKit;
+    private _pendingToolCallMessage;
+    private _thread;
+    constructor(state: TState);
+    /**
+     * Typed serializable state for this channel instance.
+     *
+     * Subclasses can extend the state shape by parameterizing
+     * {@link SlackChannel} and reading the full constructor state through this
+     * accessor. Keep serialized channel state immutable after the run starts.
+     */
+    protected state(): Readonly<TState>;
+    get botToken(): string | undefined;
+    get serializedThread(): SerializedThread;
+    serialize(): Record<string, unknown>;
+    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>;
+    /**
+     * Renders each pending input request as a rich Card element with
+     * interactive buttons or select menus, posted to the Slack thread.
+     */
+    private renderInputRequests;
+    /**
+     * Lazily imports the Chat SDK card element constructors.
+     */
+    protected getCardKit(): Promise<CardKit>;
+    /**
+     * 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). esbuild's final Vercel-function
+     * re-bundle resolves and inlines them with `platform: "node"`.
+     */
+    protected getThread(): Promise<RehydratedThread>;
+}
+export {};
+//# 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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"}