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

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

@@ -0,0 +1,320 @@
+import { PendingInputRequestsKey } from "../harness/input-requests.js";
+import { resolveTextToResponses } from "./resolve-text.js";
+import { Channel } from "./types.js";
+const SLACK_MAX_TYPING_STATUS_LENGTH = 50;
+function labelForAction(action) {
+    switch (action.kind) {
+        case "load-skill":
+            return "load-skill";
+        case "subagent-call":
+            return action.subagentName;
+        case "tool-call":
+            return action.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, " ");
+}
+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()}...`;
+}
+/**
+ * Formats user context as an XML block to prepend to messages.
+ */
+function formatUserContextBlock(ctx) {
+    const lines = [
+        "<slack_context>",
+        `user_id: ${ctx.userId}`,
+        `user_name: ${ctx.userName}`,
+        `full_name: ${ctx.fullName}`,
+        `channel_id: ${ctx.channelId}`,
+        `thread_ts: ${ctx.threadTs}`,
+    ];
+    if (ctx.teamId !== undefined) {
+        lines.push(`team_id: ${ctx.teamId}`);
+    }
+    lines.push("</slack_context>");
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Channel
+// ---------------------------------------------------------------------------
+/**
+ * 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 class SlackChannel extends Channel {
+    static kind = "slack";
+    _state;
+    _cardKit = null;
+    _pendingToolCallMessage = null;
+    _thread = null;
+    constructor(state) {
+        super();
+        this._state = state;
+    }
+    /**
+     * 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.
+     */
+    state() {
+        return this._state;
+    }
+    get botToken() {
+        return this._state.botToken;
+    }
+    get serializedThread() {
+        return this._state.serializedThread;
+    }
+    serialize() {
+        return { ...this._state };
+    }
+    // ── Inbound: transform delivered input ─────────────────
+    async onDeliver(_ctx, payload) {
+        const pendingRequests = _ctx.tryGet(PendingInputRequestsKey) ?? [];
+        // Structured responses (Slack button callback, HTTP client) —
+        // pass through untouched.
+        if (payload.inputResponses !== undefined && payload.inputResponses.length > 0) {
+            return payload;
+        }
+        // No pending requests — this is a normal conversation message.
+        if (pendingRequests.length === 0) {
+            return { message: this.prependUserContext(payload.message) };
+        }
+        // Text with pending requests — resolve against stored options.
+        if (payload.message !== undefined) {
+            const responses = resolveTextToResponses(payload.message, pendingRequests);
+            if (responses.length > 0) {
+                return { inputResponses: responses };
+            }
+        }
+        return { message: this.prependUserContext(payload.message) };
+    }
+    /**
+     * 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.
+     */
+    prependUserContext(message) {
+        if (message === undefined) {
+            return undefined;
+        }
+        if (this._state.userContext === undefined) {
+            return message;
+        }
+        return `${formatUserContextBlock(this._state.userContext)}\n\n${message}`;
+    }
+    // ── Outbound: render events to Slack ───────────────────
+    async onEvent(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(this.consumePendingToolCallStatus() ?? `Running ${labels.join(", ")}…`);
+                break;
+            }
+            case "input.requested": {
+                // Post any buffered narration before rendering the cards.
+                const pendingMessage = this.consumePendingToolCallMessage();
+                if (pendingMessage !== null) {
+                    await this.post(pendingMessage);
+                }
+                await this.renderInputRequests(event.data.requests);
+                break;
+            }
+            case "message.completed":
+                if (event.data.message !== null) {
+                    if (event.data.finishReason === "tool-calls") {
+                        this.setPendingToolCallMessage(event.data.message);
+                    }
+                    else {
+                        this.clearPendingToolCallMessage();
+                        await this.post(event.data.message);
+                    }
+                }
+                break;
+            case "session.failed":
+                this.clearPendingToolCallMessage();
+                await this.post("Something went wrong.");
+                break;
+        }
+        return event;
+    }
+    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();
+            // 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);
+        }
+    }
+    async startTyping(status) {
+        try {
+            const thread = await this.getThread();
+            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.
+     *
+     * `@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"`.
+     */
+    async getThread() {
+        if (this._thread !== null) {
+            return this._thread;
+        }
+        const [slackModule, chatModule] = (await Promise.all([
+            import("@chat-adapter/slack"),
+            import("chat"),
+        ]));
+        const adapter = slackModule.createSlackAdapter({ botToken: this.botToken });
+        const thread = chatModule.ThreadImpl.fromJSON(this.serializedThread, adapter);
+        this._thread = thread;
+        return thread;
+    }
+}
+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-channel.js.map

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

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

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

@@ -0,0 +1,41 @@
+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 the subagent channel.
+ *
+ * All fields are constant for the lifetime of one child run and are
+ * round-tripped through the {@link ChannelKey} codec so the
+ * channel can be reconstructed at every workflow step boundary.
+ */
+export interface SubagentChannelState {
+    readonly callId: string;
+    readonly subagentName: string;
+}
+/**
+ * Channel attached to a delegated subagent child run.
+ *
+ * Wraps every event in a `subagent.event` envelope tagged with the
+ * child's call id and subagent name and writes the envelope to the
+ * child's event stream. The parent's subagent tool wrapper drains
+ * that stream and forwards each pre-wrapped envelope verbatim to its
+ * own emit function — no envelope-construction logic in the pump.
+ *
+ * Holding the wrapping responsibility inside the channel
+ * (rather than in the parent-side pump) keeps delivery policy in the
+ * channel layer (CLAUDE.md rule 17) and makes the subagent channel
+ * structurally and behaviorally parallel to other channels
+ * like {@link SlackChannel} that hold serializable state and
+ * do real work in `onEvent`.
+ */
+export declare class SubagentChannel extends Channel {
+    static readonly kind = "subagent";
+    private readonly _state;
+    constructor(state: SubagentChannelState);
+    get callId(): string;
+    get subagentName(): string;
+    onEvent(event: HandleMessageStreamEvent): Promise<HandleMessageStreamEvent>;
+    onDeliver(_ctx: ContextAccessor, payload: DeliverPayload): Promise<StepInput>;
+    serialize(): Record<string, unknown>;
+}
+//# sourceMappingURL=subagent-channel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-channel.d.ts","sourceRoot":"","sources":["../../../src/channel/subagent-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAgB,SAAQ,OAAO;IAC1C,MAAM,CAAC,QAAQ,CAAC,IAAI,cAAc;IAElC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAElC,KAAK,EAAE,oBAAoB;IAKvC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAEK,OAAO,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAQ3E,SAAS,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAInF,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMrC"}

package/dist/src/channel/{subagent-emitter.js → subagent-channel.js}

@@ -1,7 +1,7 @@
 import { createSubagentChildEventEvent, } from "../protocol/message.js";
-import { registerChannelEmitter } from "./emitter-registry.js";
+import { Channel } from "./types.js";
 /**
- * Channel emitter attached to a delegated subagent child run.
+ * Channel attached to a delegated subagent child run.
  *
  * Wraps every event in a `subagent.event` envelope tagged with the
  * child's call id and subagent name and writes the envelope to the
@@ -9,18 +9,18 @@ import { registerChannelEmitter } from "./emitter-registry.js";
  * that stream and forwards each pre-wrapped envelope verbatim to its
  * own emit function — no envelope-construction logic in the pump.
  *
- * Holding the wrapping responsibility inside the channel emitter
+ * Holding the wrapping responsibility inside the channel
  * (rather than in the parent-side pump) keeps delivery policy in the
- * channel layer (CLAUDE.md rule 17) and makes the subagent emitter
- * structurally and behaviorally parallel to other channel emitters
- * like {@link SlackChannelEmitter} that hold serializable state and
+ * channel layer (CLAUDE.md rule 17) and makes the subagent channel
+ * structurally and behaviorally parallel to other channels
+ * like {@link SlackChannel} that hold serializable state and
  * do real work in `onEvent`.
  */
-export class SubagentChannelEmitter {
+export class SubagentChannel extends Channel {
     static kind = "subagent";
-    kind = "subagent";
     _state;
     constructor(state) {
+        super();
         this._state = state;
     }
     get callId() {
@@ -29,12 +29,15 @@ export class SubagentChannelEmitter {
     get subagentName() {
         return this._state.subagentName;
     }
-    async onEvent(event, emit) {
-        await emit(createSubagentChildEventEvent({
+    async onEvent(event) {
+        return createSubagentChildEventEvent({
             callId: this._state.callId,
             event,
             subagentName: this._state.subagentName,
-        }));
+        });
+    }
+    async onDeliver(_ctx, payload) {
+        return payload;
     }
     serialize() {
         return {
@@ -42,12 +45,5 @@ export class SubagentChannelEmitter {
             subagentName: this._state.subagentName,
         };
     }
-    static deserialize(state) {
-        return new SubagentChannelEmitter({
-            callId: state.callId,
-            subagentName: state.subagentName,
-        });
-    }
 }
-registerChannelEmitter(SubagentChannelEmitter);
-//# sourceMappingURL=subagent-emitter.js.map
+//# sourceMappingURL=subagent-channel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-channel.js","sourceRoot":"","sources":["../../../src/channel/subagent-channel.ts"],"names":[],"mappings":"AACA,OAAO,EACL,6BAA6B,GAE9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,OAAO,EAA6C,MAAM,YAAY,CAAC;AAchF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,eAAgB,SAAQ,OAAO;IAC1C,MAAM,CAAU,IAAI,GAAG,UAAU,CAAC;IAEjB,MAAM,CAAuB;IAE9C,YAAY,KAA2B;QACrC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAA+B;QAC3C,OAAO,6BAA6B,CAAC;YACnC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC1B,KAAK;YACL,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;SACvC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAqB,EAAE,OAAuB;QAC5D,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,SAAS;QACP,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC1B,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;SACvC,CAAC;IACJ,CAAC"}