experimental-ash 0.2.0-alpha.1 → 0.2.0-alpha.10

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

@@ -1,15 +1,17 @@
 import type { HandleMessageStreamEvent } from "../protocol/message.js";
-import type { ChannelEmitter, EventEmitFn } from "./types.js";
+import type { ChannelEmitter, DeliverPayload, EventEmitFn, ResolvedStepInput } from "./types.js";
 /**
  * Stateless emitter for the HTTP channel.
  *
  * Passes every event straight through to the stream. Consumers read events
- * from the stream endpoint.
+ * from the stream endpoint. Deliver payloads pass through untransformed —
+ * HTTP clients send structured {@link InputResponse} objects directly.
  */
 export declare class HttpChannelEmitter implements ChannelEmitter {
     static readonly kind = "http";
     readonly kind = "http";
     onEvent(event: HandleMessageStreamEvent, emit: EventEmitFn): Promise<void>;
+    onDeliver(payload: DeliverPayload): ResolvedStepInput;
     serialize(): Record<string, unknown>;
     static deserialize(_state: Record<string, unknown>): HttpChannelEmitter;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"http-emitter.d.ts","sourceRoot":"","sources":["../../../src/channel/http-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9D;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,QAAQ,CAAC,IAAI,UAAU;IAEjB,OAAO,CAAC,KAAK,EAAE,wBAAwB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhF,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIpC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,kBAAkB;CAGxE"}
+{"version":3,"file":"http-emitter.d.ts","sourceRoot":"","sources":["../../../src/channel/http-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEjG;;;;;;GAMG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,QAAQ,CAAC,IAAI,UAAU;IAEjB,OAAO,CAAC,KAAK,EAAE,wBAAwB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhF,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,iBAAiB;IAIrD,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIpC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,kBAAkB;CAGxE"}

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

@@ -3,7 +3,8 @@ import { registerChannelEmitter } from "./emitter-registry.js";
  * Stateless emitter for the HTTP channel.
  *
  * Passes every event straight through to the stream. Consumers read events
- * from the stream endpoint.
+ * from the stream endpoint. Deliver payloads pass through untransformed —
+ * HTTP clients send structured {@link InputResponse} objects directly.
  */
 export class HttpChannelEmitter {
     static kind = "http";
@@ -11,6 +12,9 @@ export class HttpChannelEmitter {
     async onEvent(event, emit) {
         await emit(event);
     }
+    onDeliver(payload) {
+        return payload;
+    }
     serialize() {
         return {};
     }

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

@@ -1 +1 @@
-{"version":3,"file":"http-emitter.js","sourceRoot":"","sources":["../../../src/channel/http-emitter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAG/D;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IAC7B,MAAM,CAAU,IAAI,GAAG,MAAM,CAAC;IACrB,IAAI,GAAG,MAAM,CAAC;IAEvB,KAAK,CAAC,OAAO,CAAC,KAA+B,EAAE,IAAiB;QAC9D,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,SAAS;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,MAA+B;QAChD,OAAO,IAAI,kBAAkB,EAAE,CAAC;IAClC,CAAC;;AAGH,sBAAsB,CAAC,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"http-emitter.js","sourceRoot":"","sources":["../../../src/channel/http-emitter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAG/D;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IAC7B,MAAM,CAAU,IAAI,GAAG,MAAM,CAAC;IACrB,IAAI,GAAG,MAAM,CAAC;IAEvB,KAAK,CAAC,OAAO,CAAC,KAA+B,EAAE,IAAiB;QAC9D,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,SAAS,CAAC,OAAuB;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,SAAS;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,MAA+B;QAChD,OAAO,IAAI,kBAAkB,EAAE,CAAC;IAClC,CAAC;;AAGH,sBAAsB,CAAC,kBAAkB,CAAC,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-emitter.d.ts

@@ -1,14 +1,16 @@
 import type { HandleMessageStreamEvent } from "../protocol/message.js";
-import type { ChannelEmitter, EventEmitFn } from "./types.js";
+import type { ChannelEmitter, DeliverPayload, EventEmitFn, ResolvedStepInput } from "./types.js";
 /**
  * Stateless emitter for the schedule channel.
  *
- * Passes every event straight through to the stream.
+ * Passes every event straight through to the stream. Deliver payloads
+ * pass through untransformed.
  */
 export declare class ScheduleChannelEmitter implements ChannelEmitter {
     static readonly kind = "schedule";
     readonly kind = "schedule";
     onEvent(event: HandleMessageStreamEvent, emit: EventEmitFn): Promise<void>;
+    onDeliver(payload: DeliverPayload): ResolvedStepInput;
     serialize(): Record<string, unknown>;
     static deserialize(_state: Record<string, unknown>): ScheduleChannelEmitter;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"schedule-emitter.d.ts","sourceRoot":"","sources":["../../../src/channel/schedule-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9D;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,MAAM,CAAC,QAAQ,CAAC,IAAI,cAAc;IAClC,QAAQ,CAAC,IAAI,cAAc;IAErB,OAAO,CAAC,KAAK,EAAE,wBAAwB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhF,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIpC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,sBAAsB;CAG5E"}
+{"version":3,"file":"schedule-emitter.d.ts","sourceRoot":"","sources":["../../../src/channel/schedule-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEjG;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,MAAM,CAAC,QAAQ,CAAC,IAAI,cAAc;IAClC,QAAQ,CAAC,IAAI,cAAc;IAErB,OAAO,CAAC,KAAK,EAAE,wBAAwB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhF,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,iBAAiB;IAIrD,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIpC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,sBAAsB;CAG5E"}

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

@@ -2,7 +2,8 @@ import { registerChannelEmitter } from "./emitter-registry.js";
 /**
  * Stateless emitter for the schedule channel.
  *
- * Passes every event straight through to the stream.
+ * Passes every event straight through to the stream. Deliver payloads
+ * pass through untransformed.
  */
 export class ScheduleChannelEmitter {
     static kind = "schedule";
@@ -10,6 +11,9 @@ export class ScheduleChannelEmitter {
     async onEvent(event, emit) {
         await emit(event);
     }
+    onDeliver(payload) {
+        return payload;
+    }
     serialize() {
         return {};
     }

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

@@ -1 +1 @@
-{"version":3,"file":"schedule-emitter.js","sourceRoot":"","sources":["../../../src/channel/schedule-emitter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAG/D;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IACjC,MAAM,CAAU,IAAI,GAAG,UAAU,CAAC;IACzB,IAAI,GAAG,UAAU,CAAC;IAE3B,KAAK,CAAC,OAAO,CAAC,KAA+B,EAAE,IAAiB;QAC9D,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,SAAS;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,MAA+B;QAChD,OAAO,IAAI,sBAAsB,EAAE,CAAC;IACtC,CAAC;;AAGH,sBAAsB,CAAC,sBAAsB,CAAC,CAAC"}
+{"version":3,"file":"schedule-emitter.js","sourceRoot":"","sources":["../../../src/channel/schedule-emitter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAG/D;;;;;GAKG;AACH,MAAM,OAAO,sBAAsB;IACjC,MAAM,CAAU,IAAI,GAAG,UAAU,CAAC;IACzB,IAAI,GAAG,UAAU,CAAC;IAE3B,KAAK,CAAC,OAAO,CAAC,KAA+B,EAAE,IAAiB;QAC9D,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,SAAS,CAAC,OAAuB;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,SAAS;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,MAA+B;QAChD,OAAO,IAAI,sBAAsB,EAAE,CAAC;IACtC,CAAC;;AAGH,sBAAsB,CAAC,sBAAsB,CAAC,CAAC"}

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

@@ -1,42 +1,58 @@
 import type { SerializedThread } from "chat";
 import type { HandleMessageStreamEvent } from "../protocol/message.js";
-import type { RuntimeInputRequest, RuntimeInputResult } from "../runtime/input/types.js";
-import type { ChannelEmitter, EventEmitFn } from "./types.js";
+import type { InputRequest } from "../runtime/input/types.js";
+import type { ChannelEmitter, DeliverPayload, EventEmitFn, ResolvedStepInput } from "./types.js";
 /**
  * Minimal serializable state for the Slack emitter.
  */
 export interface SlackChannelEmitterState {
     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[];
 }
-/**
- * Returns `true` when the lowercased, trimmed text is an affirmative
- * response. Used by {@link SlackChannelEmitter.resolveInput} to decide
- * whether a Slack reply approves or denies a pending tool call.
- */
-export declare function isAffirmativeText(text: string): boolean;
 /**
  * Emitter 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.
  */
 export declare class SlackChannelEmitter implements ChannelEmitter {
     static readonly kind = "slack";
     readonly kind = "slack";
-    private readonly _state;
+    private _state;
+    private _cardKit;
+    private _pendingToolCallMessage;
     private _thread;
     constructor(state: SlackChannelEmitterState);
     get botToken(): string | undefined;
     get serializedThread(): SerializedThread;
     serialize(): Record<string, unknown>;
     static deserialize(state: Record<string, unknown>): SlackChannelEmitter;
-    resolveInput(input: {
-        readonly message: string;
-        readonly requests: readonly RuntimeInputRequest[];
-    }): readonly RuntimeInputResult[] | undefined;
+    onDeliver(payload: DeliverPayload): ResolvedStepInput;
     onEvent(event: HandleMessageStreamEvent, emit: EventEmitFn): Promise<void>;
+    private consumePendingToolCallMessage;
+    private consumePendingToolCallStatus;
+    private clearPendingToolCallMessage;
+    private setPendingToolCallMessage;
     private post;
     private startTyping;
+    /**
+     * 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.
+     */
+    private getCardKit;
     /**
      * Lazily rehydrates the Chat SDK Thread from serialized state.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"slack-emitter.d.ts","sourceRoot":"","sources":["../../../src/channel/slack-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAC;AAE7C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEzF,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;CAC7C;AAmDD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAMD;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IACxD,MAAM,CAAC,QAAQ,CAAC,IAAI,WAAW;IAC/B,QAAQ,CAAC,IAAI,WAAW;IAExB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,OAAO,CAAiC;gBAEpC,KAAK,EAAE,wBAAwB;IAI3C,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED,IAAI,gBAAgB,IAAI,gBAAgB,CAEvC;IAED,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAOpC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,mBAAmB;IAOvE,YAAY,CAAC,KAAK,EAAE;QAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;KACnD,GAAG,SAAS,kBAAkB,EAAE,GAAG,SAAS;IA2CvC,OAAO,CAAC,KAAK,EAAE,wBAAwB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;YA4BlE,IAAI;YASJ,WAAW;IASzB;;;;;;;;OAQG;YACW,SAAS;CAexB"}
+{"version":3,"file":"slack-emitter.d.ts","sourceRoot":"","sources":["../../../src/channel/slack-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyD,gBAAgB,EAAE,MAAM,MAAM,CAAC;AAEpG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEjG;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CACpD;AA4DD;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IACxD,MAAM,CAAC,QAAQ,CAAC,IAAI,WAAW;IAC/B,QAAQ,CAAC,IAAI,WAAW;IAExB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,uBAAuB,CAAuB;IACtD,OAAO,CAAC,OAAO,CAAiC;gBAEpC,KAAK,EAAE,wBAAwB;IAI3C,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED,IAAI,gBAAgB,IAAI,gBAAgB,CAEvC;IAED,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQpC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,mBAAmB;IAUvE,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,iBAAiB;IAyB/C,OAAO,CAAC,KAAK,EAAE,wBAAwB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA2ChF,OAAO,CAAC,6BAA6B;IAMrC,OAAO,CAAC,4BAA4B;IAUpC,OAAO,CAAC,2BAA2B;IAInC,OAAO,CAAC,yBAAyB;YAKnB,IAAI;YAWJ,WAAW;IASzB;;;OAGG;YACW,mBAAmB;IAcjC;;OAEG;YACW,UAAU;IAiBxB;;;;;;;;OAQG;YACW,SAAS;CAexB"}

package/dist/src/channel/slack-emitter.js

@@ -1,4 +1,6 @@
 import { registerChannelEmitter } from "./emitter-registry.js";
+import { resolveTextToResponses } from "./resolve-text.js";
+const SLACK_MAX_TYPING_STATUS_LENGTH = 50;
 function labelForAction(action) {
     switch (action.kind) {
         case "activate-skill":
@@ -9,43 +11,22 @@ function labelForAction(action) {
             return action.toolName;
     }
 }
-function labelForInputRequest(request) {
-    switch (request.kind) {
-        case "question":
-            return "question";
-        case "tool-approval":
-            return request.toolName;
+function derivePendingToolCallStatus(text) {
+    const firstLine = text
+        .split(/\r?\n/u)
+        .map((line) => line.trim())
+        .find((line) => line.length > 0);
+    if (firstLine === undefined) {
+        return null;
     }
+    return firstLine.replace(/\s+/gu, " ");
 }
-// ---------------------------------------------------------------------------
-// Text classification
-// ---------------------------------------------------------------------------
-const AFFIRMATIVE_PATTERNS = new Set([
-    "y",
-    "yes",
-    "yeah",
-    "yep",
-    "yup",
-    "ok",
-    "okay",
-    "sure",
-    "approve",
-    "approved",
-    "confirm",
-    "confirmed",
-    "go",
-    "go ahead",
-    "do it",
-    "proceed",
-    "accept",
-]);
-/**
- * Returns `true` when the lowercased, trimmed text is an affirmative
- * response. Used by {@link SlackChannelEmitter.resolveInput} to decide
- * whether a Slack reply approves or denies a pending tool call.
- */
-export function isAffirmativeText(text) {
-    return AFFIRMATIVE_PATTERNS.has(text);
+function truncateTypingStatus(status) {
+    const normalized = status.trim().replace(/\s+/gu, " ");
+    if (normalized.length <= SLACK_MAX_TYPING_STATUS_LENGTH) {
+        return normalized;
+    }
+    return `${normalized.slice(0, SLACK_MAX_TYPING_STATUS_LENGTH - 3).trimEnd()}...`;
 }
 // ---------------------------------------------------------------------------
 // Emitter
@@ -54,11 +35,17 @@ export function isAffirmativeText(text) {
  * Emitter 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.
  */
 export class SlackChannelEmitter {
     static kind = "slack";
     kind = "slack";
     _state;
+    _cardKit = null;
+    _pendingToolCallMessage = null;
     _thread = null;
     constructor(state) {
         this._state = state;
@@ -72,84 +59,104 @@ export class SlackChannelEmitter {
     serialize() {
         return {
             botToken: this._state.botToken,
+            pendingRequests: this._state.pendingRequests,
             serializedThread: this._state.serializedThread,
         };
     }
     static deserialize(state) {
         return new SlackChannelEmitter({
             botToken: state.botToken,
+            pendingRequests: state.pendingRequests,
             serializedThread: state.serializedThread,
         });
     }
-    resolveInput(input) {
-        const text = input.message.trim().toLowerCase();
-        if (text.length === 0) {
-            return undefined;
+    // ── Inbound: transform delivered input ─────────────────
+    onDeliver(payload) {
+        // Structured responses (Slack button callback, HTTP client) —
+        // pass through untouched.
+        if (payload.inputResponses !== undefined && payload.inputResponses.length > 0) {
+            return payload;
         }
-        const approved = isAffirmativeText(text);
-        const results = [];
-        for (const request of input.requests) {
-            if (request.kind === "tool-approval") {
-                const result = approved
-                    ? { approvalId: request.approvalId, approved: true, kind: "tool-approval-result" }
-                    : {
-                        approvalId: request.approvalId,
-                        approved: false,
-                        kind: "tool-approval-result",
-                        reason: `User replied: "${input.message.trim()}"`,
-                    };
-                results.push(result);
-            }
-            else if (request.kind === "question") {
-                const matchedOption = request.options?.find((opt) => opt.id.toLowerCase() === text || opt.label.toLowerCase() === text);
-                if (matchedOption) {
-                    results.push({
-                        callId: request.action.callId,
-                        kind: "question-result",
-                        output: { optionId: matchedOption.id, status: "answered" },
-                    });
-                }
-                else if (request.allowFreeform !== false) {
-                    results.push({
-                        callId: request.action.callId,
-                        kind: "question-result",
-                        output: { status: "answered", text: input.message.trim() },
-                    });
-                }
+        // No pending requests — this is a normal conversation message.
+        if (this._state.pendingRequests === undefined || this._state.pendingRequests.length === 0) {
+            return { message: payload.message };
+        }
+        // Text with pending requests — resolve against stored options.
+        if (payload.message !== undefined) {
+            const responses = resolveTextToResponses(payload.message, this._state.pendingRequests);
+            if (responses.length > 0) {
+                return { inputResponses: responses };
             }
         }
-        return results.length > 0 ? results : undefined;
+        return { message: payload.message };
     }
+    // ── Outbound: render events to Slack ───────────────────
     async onEvent(event, emit) {
         await emit(event);
         switch (event.type) {
             case "turn.started":
+                this.clearPendingToolCallMessage();
                 await this.startTyping("Thinking…");
                 break;
             case "actions.requested": {
                 const labels = event.data.actions.map(labelForAction);
-                await this.startTyping(`Running ${labels.join(", ")}…`);
+                await this.startTyping(this.consumePendingToolCallStatus() ?? `Running ${labels.join(", ")}…`);
                 break;
             }
             case "input.requested": {
-                const labels = event.data.requests.map(labelForInputRequest);
-                await this.startTyping(`Waiting on ${labels.join(", ")}…`);
+                // Post any buffered narration before rendering the cards.
+                const pendingMessage = this.consumePendingToolCallMessage();
+                if (pendingMessage !== null) {
+                    await this.post(pendingMessage);
+                }
+                // Store for onDeliver
+                this._state = { ...this._state, pendingRequests: event.data.requests };
+                await this.renderInputRequests(event.data.requests);
                 break;
             }
             case "message.completed":
                 if (event.data.message !== null) {
-                    await this.post(event.data.message);
+                    if (event.data.finishReason === "tool-calls") {
+                        this.setPendingToolCallMessage(event.data.message);
+                    }
+                    else {
+                        this.clearPendingToolCallMessage();
+                        await this.post(event.data.message);
+                    }
                 }
                 break;
-            case "run.failed":
+            case "session.failed":
+                this.clearPendingToolCallMessage();
                 await this.post("Something went wrong.");
                 break;
         }
     }
+    consumePendingToolCallMessage() {
+        const message = this._pendingToolCallMessage;
+        this._pendingToolCallMessage = null;
+        return message;
+    }
+    consumePendingToolCallStatus() {
+        const message = this.consumePendingToolCallMessage();
+        if (message === null) {
+            return null;
+        }
+        const status = derivePendingToolCallStatus(message);
+        return status === null ? null : truncateTypingStatus(status);
+    }
+    clearPendingToolCallMessage() {
+        this._pendingToolCallMessage = null;
+    }
+    setPendingToolCallMessage(text) {
+        const normalized = text.trim();
+        this._pendingToolCallMessage = normalized.length > 0 ? normalized : null;
+    }
     async post(text) {
         try {
             const thread = await this.getThread();
-            await thread.post(text);
+            // Route assistant output through the chat SDK's markdown renderer so
+            // Slack-native mrkdwn and table blocks are used when available.
+            await thread.post({ markdown: text });
         }
         catch (error) {
             console.error("[ash] Slack message delivery failed.", error);
@@ -158,12 +165,47 @@ export class SlackChannelEmitter {
     async startTyping(status) {
         try {
             const thread = await this.getThread();
-            await thread.startTyping(status);
+            await thread.startTyping(truncateTypingStatus(status));
         }
         catch {
             // Best-effort — not all apps support typing status.
         }
     }
+    /**
+     * Renders each pending input request as a rich Card element with
+     * interactive buttons or select menus, posted to the Slack thread.
+     */
+    async renderInputRequests(requests) {
+        const kit = await this.getCardKit();
+        for (const request of requests) {
+            try {
+                const card = buildInputRequestCard(kit, request);
+                const thread = await this.getThread();
+                await thread.post(card);
+            }
+            catch (error) {
+                console.error("[ash] Slack input request render failed.", error);
+            }
+        }
+    }
+    /**
+     * Lazily imports the Chat SDK card element constructors.
+     */
+    async getCardKit() {
+        if (this._cardKit !== null) {
+            return this._cardKit;
+        }
+        const chatModule = (await import("chat"));
+        this._cardKit = {
+            Actions: chatModule.Actions,
+            Button: chatModule.Button,
+            Card: chatModule.Card,
+            CardText: chatModule.CardText,
+            Select: chatModule.Select,
+            SelectOption: chatModule.SelectOption,
+        };
+        return this._cardKit;
+    }
     /**
      * Lazily rehydrates the Chat SDK Thread from serialized state.
      *
@@ -188,4 +230,53 @@ export class SlackChannelEmitter {
     }
 }
 registerChannelEmitter(SlackChannelEmitter);
+const INPUT_OPTION_STYLE_TO_BUTTON_STYLE = {
+    danger: "danger",
+    default: undefined,
+    primary: "primary",
+};
+/**
+ * Builds a Chat SDK Card element for one input request.
+ *
+ * - `confirmation` → buttons (one per option)
+ * - `select` → static select menu
+ * - `text` → prompt text only (user replies in thread)
+ */
+function buildInputRequestCard(kit, request) {
+    if (request.display === "confirmation" && request.options !== undefined) {
+        return kit.Card({
+            children: [
+                kit.CardText(request.prompt),
+                kit.Actions(request.options.map((opt) => kit.Button({
+                    id: opt.id,
+                    label: opt.label,
+                    style: INPUT_OPTION_STYLE_TO_BUTTON_STYLE[opt.style ?? "default"],
+                    value: request.requestId,
+                }))),
+            ],
+        });
+    }
+    if (request.display === "select" && request.options !== undefined && request.options.length > 0) {
+        return kit.Card({
+            children: [
+                kit.CardText(request.prompt),
+                kit.Actions([
+                    kit.Select({
+                        id: `select_${request.requestId}`,
+                        label: "Choose an option",
+                        options: request.options.map((opt) => kit.SelectOption({
+                            description: opt.description,
+                            label: opt.label,
+                            value: opt.id,
+                        })),
+                    }),
+                ]),
+            ],
+        });
+    }
+    // Freeform text — just post the prompt. User replies in thread.
+    return kit.Card({
+        children: [kit.CardText(request.prompt)],
+    });
+}
 //# sourceMappingURL=slack-emitter.js.map