experimental-ash 0.2.0-alpha.9 → 0.3.0-alpha.2

package/README.md

@@ -7,7 +7,7 @@ You author an agent as a directory on disk. The directory is the contract:
 - `system.md` and `system/` define always-on instructions
 - `skills/` define optional procedures
 - `tools/` define typed executable integrations
-- `sandboxes/` define isolated command environments
+- `sandbox/` overrides the agent's single sandbox (optional) and seeds workspace files
 - `channels/` define message ingress and delivery
 - `subagents/` define specialist child agents
 - `schedules/` define recurring jobs
@@ -22,7 +22,7 @@ The framework package is `experimental-ash`. The CLI binary is `ash`.
 - TypeScript where typed runtime behavior matters
 - Durable message runs and follow-up turns
 - Inspectable compiled artifacts under `.ash/`
-- Shared workspace state plus isolated authored sandboxes
+- Per-agent sandbox with optional authored overrides
 - A stable HTTP protocol with explicit `continuationToken` and `runId` contracts
 - A runtime model that keeps channels, harnesses, and workflow execution separate
 
@@ -51,7 +51,7 @@ my-agent/
     ├── system/
     ├── skills/
     ├── tools/
-    ├── sandboxes/
+    ├── sandbox/
     ├── channels/
     ├── subagents/
     ├── schedules/

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

@@ -0,0 +1,130 @@
+import type { ContextAccessor } from "../context/key.js";
+import type { ContextProvider } from "../context/provider.js";
+import type { StepInput } from "../harness/types.js";
+import type { HandleMessageStreamEvent } from "../protocol/message.js";
+import type { DeliverPayload } from "./types.js";
+/**
+ * Context available to every adapter handler (`deliver` and event handlers).
+ *
+ * `state` is a mutable reference to the adapter's durable state. The runtime
+ * auto-snapshots it at step boundaries — no manual `serialize()` needed.
+ *
+ * `ctx` provides read/write access to durable context keys (the same
+ * {@link ContextAccessor} that tools and providers use).
+ */
+export interface ChannelAdapterContext<TState = Record<string, unknown>> {
+    /**
+     * Mutable adapter state. Auto-serialized at step boundaries via
+     * JSON snapshot. The adapter reads and writes this directly.
+     */
+    state: TState;
+    /**
+     * Read/write access to durable context keys. Seed keys here for tools
+     * to read during the turn.
+     */
+    readonly ctx: ContextAccessor;
+}
+/**
+ * Extracts the `data` field type from a stream event by its `type` discriminant.
+ * Events that carry no `data` field (e.g. `session.completed`) resolve to `undefined`.
+ */
+type EventData<T extends HandleMessageStreamEvent["type"]> = Extract<HandleMessageStreamEvent, {
+    type: T;
+}> extends {
+    data: infer D;
+} ? D : undefined;
+/**
+ * A single outbound event handler. Receives the event's `data` (not the full
+ * envelope) and the adapter context. Void return — side effects only.
+ */
+type EventHandler<T extends HandleMessageStreamEvent["type"], TCtx extends ChannelAdapterContext<any> = ChannelAdapterContext> = (data: EventData<T>, ctx: TCtx) => void | Promise<void>;
+/**
+ * Map of outbound event handlers keyed by event type. The adapter declares
+ * handlers for the event types it cares about. For undeclared types, the
+ * route's base layer (e.g. `slackRoute`) runs default behavior.
+ */
+export type ChannelEventHandlers<TCtx extends ChannelAdapterContext<any> = ChannelAdapterContext> = {
+    [K in HandleMessageStreamEvent["type"]]?: EventHandler<K, TCtx>;
+};
+/**
+ * Plain-object adapter that replaces the `Channel` abstract class.
+ *
+ * An adapter carries:
+ * - `kind`: stable durable identifier (like the old static `Channel.kind`)
+ * - `state`: initial state shape, auto-serialized at step boundaries
+ * - `deliver`: inbound hook (side effects + optional message transform)
+ * - Event handlers: outbound, keyed by event type name
+ * - `contextProviders`: optional per-step virtual providers
+ *
+ * Adapters are created via `defineSlackAdapter`, `defineHttpAdapter`, or
+ * directly as plain objects. They are NOT classes — no inheritance, no
+ * `serialize()`, no constructor rehydration.
+ */
+export type ChannelAdapter<TCtx extends ChannelAdapterContext<any> = ChannelAdapterContext> = {
+    /**
+     * Stable durable identifier for serialization across step boundaries.
+     * Must be unique across all adapters visible to one runtime bundle.
+     *
+     * Optional — defaults to `"http"` for httpRoute, `"slack"` for slackRoute,
+     * or derived from the route file path.
+     */
+    readonly kind?: string;
+    /**
+     * Initial state shape. Auto-serialized at step boundaries via JSON
+     * snapshot. On rehydration, the runtime restores the serialized state
+     * and re-attaches the adapter's behavior functions from the registry.
+     */
+    readonly state?: Record<string, unknown>;
+    /**
+     * Inbound hook: fires once per delivery before the harness starts.
+     *
+     * Side effects (context seeding, thread refresh, custom interactions)
+     * plus optional message transformation. Return a string to override the
+     * message the model sees. Return void to use the original payload message.
+     *
+     * For Slack adapters, the route's base layer runs AFTER this:
+     *   1. Resolves HITL against the ORIGINAL payload.message (not the
+     *      returned string). Matched inputResponses go to the harness and
+     *      the return value is ignored.
+     *   2. If no HITL to resolve, uses the returned string (or
+     *      payload.message if void), prepends user context, and produces
+     *      the StepInput for the harness.
+     */
+    deliver?(payload: DeliverPayload, ctx: TCtx): StepInput | void | Promise<StepInput | void>;
+    /**
+     * Optional per-step virtual providers attached to this adapter.
+     *
+     * The runtime rebuilds these providers after deliver on every step for
+     * sessions using this adapter. Replaces the static `contextProviders`
+     * field on the old `ChannelClass` interface.
+     */
+    readonly contextProviders?: readonly ContextProvider<unknown>[];
+    /**
+     * Optional factory that builds the adapter context for this adapter.
+     *
+     * The runtime calls this before invoking `deliver` or event handlers.
+     * Default returns a bare `ChannelAdapterContext`. Slack adapters override
+     * this to return a `SlackAdapterContext` with `ctx.slack`.
+     *
+     * @internal — set by `createSlackBaseAdapter`, not authored by users.
+     */
+    readonly createAdapterContext?: (base: ChannelAdapterContext) => ChannelAdapterContext;
+} & ChannelEventHandlers<TCtx>;
+/**
+ * Returns the durable kind for an adapter, falling back to `"unknown"`.
+ */
+export declare function getAdapterKind(adapter: ChannelAdapter): string;
+/**
+ * Returns the adapter's context providers, defaulting to an empty array.
+ */
+export declare function getAdapterContextProviders(adapter: ChannelAdapter): readonly ContextProvider<unknown>[];
+/**
+ * Calls an adapter's event handler for a given event. Returns the event
+ * unchanged (adapters don't transform events — they perform side effects).
+ *
+ * If the adapter doesn't declare a handler for the event type, this is a
+ * no-op and returns the event as-is.
+ */
+export declare function callAdapterEventHandler(adapter: ChannelAdapter, event: HandleMessageStreamEvent, ctx: ChannelAdapterContext): Promise<HandleMessageStreamEvent>;
+export {};
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/channel/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrE;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;CAC/B;AAMD;;;GAGG;AACH,KAAK,SAAS,CAAC,CAAC,SAAS,wBAAwB,CAAC,MAAM,CAAC,IACvD,OAAO,CAAC,wBAAwB,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,SAAS,CAAC;AAE3F;;;GAGG;AACH,KAAK,YAAY,CACf,CAAC,SAAS,wBAAwB,CAAC,MAAM,CAAC,EAE1C,IAAI,SAAS,qBAAqB,CAAC,GAAG,CAAC,GAAG,qBAAqB,IAC7D,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5D;;;;GAIG;AAEH,MAAM,MAAM,oBAAoB,CAAC,IAAI,SAAS,qBAAqB,CAAC,GAAG,CAAC,GAAG,qBAAqB,IAC9F;KACG,CAAC,IAAI,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC;CAChE,CAAC;AAMJ;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,qBAAqB,CAAC,GAAG,CAAC,GAAG,qBAAqB,IAAI;IAC5F;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC;;;;;;;;;;;;;;OAcG;IAEH,OAAO,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAE3F;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;IAEhE;;;;;;;;OAQG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,qBAAqB,CAAC;CACxF,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;AAM/B;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,cAAc,GACtB,SAAS,eAAe,CAAC,OAAO,CAAC,EAAE,CAErC;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,wBAAwB,EAC/B,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,wBAAwB,CAAC,CAUnC"}

package/dist/src/channel/adapter.js

@@ -0,0 +1,30 @@
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Returns the durable kind for an adapter, falling back to `"unknown"`.
+ */
+export function getAdapterKind(adapter) {
+    return adapter.kind ?? "unknown";
+}
+/**
+ * Returns the adapter's context providers, defaulting to an empty array.
+ */
+export function getAdapterContextProviders(adapter) {
+    return adapter.contextProviders ?? [];
+}
+/**
+ * Calls an adapter's event handler for a given event. Returns the event
+ * unchanged (adapters don't transform events — they perform side effects).
+ *
+ * If the adapter doesn't declare a handler for the event type, this is a
+ * no-op and returns the event as-is.
+ */
+export async function callAdapterEventHandler(adapter, event, ctx) {
+    const handler = adapter[event.type];
+    if (handler !== undefined) {
+        await handler("data" in event ? event.data : undefined, ctx);
+    }
+    return event;
+}
+//# sourceMappingURL=adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/channel/adapter.ts"],"names":[],"mappings":"AA4IA,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,OAAO,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAuB;IAEvB,OAAO,OAAO,CAAC,gBAAgB,IAAI,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAuB,EACvB,KAA+B,EAC/B,GAA0B;IAE1B,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAErB,CAAC;IAEd,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -1,6 +1,4 @@
-import { ScheduleChannelEmitter } from "./schedule-emitter.js";
 import type { RunHandle, Runtime } from "./types.js";
-export { ScheduleChannelEmitter } from "./schedule-emitter.js";
 /**
  * Input for triggering a one-shot schedule run.
  */
@@ -9,23 +7,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":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAsB,MAAM,YAAY,CAAC;AAEzE;;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,28 @@
-import { ScheduleChannelEmitter } from "./schedule-emitter.js";
-export { ScheduleChannelEmitter } from "./schedule-emitter.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({
+            adapter: { kind: "schedule" },
             auth: createScheduleAuthContext(input.scheduleId),
-            channelEmitter: this.createEmitter(),
             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":"AAUA;;;;;;;;;;;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,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;YAC7B,IAAI,EAAE,yBAAyB,CAAC,KAAK,CAAC,UAAU,CAAC;YACjD,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-adapter.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Slack adapter context, base layer, and factory.
+ *
+ * The Slack adapter context extends the generic ChannelAdapterContext with
+ * a `slack` handle for Slack thread operations. The base layer provides
+ * default Slack behaviors (typing, posting, HITL cards) that user adapters
+ * can override per event type.
+ */
+import type { ChannelAdapter, ChannelAdapterContext } from "./adapter.js";
+import type { SlackUserContext } from "./slack-state.js";
+import type { SlackInteraction, SlackRenderable, SlackThreadMessage } from "./slack-types.js";
+/**
+ * Extended adapter context for Slack adapters. Provides a `slack` handle
+ * for posting messages, editing messages, typing indicators, and reading
+ * thread history.
+ *
+ * Constructed by the slack base layer before calling user adapter handlers.
+ */
+export interface SlackAdapterContext<TState = Record<string, unknown>> extends ChannelAdapterContext<TState> {
+    readonly slack: SlackHandle;
+}
+/**
+ * Platform handle for Slack operations. Injected into the adapter context
+ * by the slack base layer.
+ */
+export interface SlackHandle {
+    /** Post a renderable (markdown or card) to the thread. */
+    post(renderable: SlackRenderable): Promise<void>;
+    /** Edit an existing message by timestamp. */
+    editMessage(ts: string, renderable: SlackRenderable): Promise<void>;
+    /** Show a typing indicator with the given status text. */
+    startTyping(status: string): Promise<void>;
+    /** Refresh thread messages from Slack. */
+    refresh(): Promise<void>;
+    /** Get recent thread messages (call refresh first). */
+    listRecentMessages(): Promise<readonly SlackThreadMessage[]>;
+    /** Slack channel ID. */
+    readonly channelId: string;
+    /** Chat SDK thread ID. */
+    readonly threadId: string;
+    /** Thread root timestamp. */
+    readonly threadTs?: string;
+    /** Workspace ID. */
+    readonly teamId?: string;
+    /** User context from the inbound mention. */
+    readonly userContext?: SlackUserContext;
+}
+/**
+ * Creates a Slack adapter that wraps a user adapter with default Slack
+ * behaviors. User handlers override defaults per event type.
+ *
+ * Default behaviors (run when user adapter doesn't declare the event):
+ * - turn.started: startTyping("Thinking...")
+ * - actions.requested: startTyping("Running tool1, tool2...")
+ * - message.completed: post(message) or buffer for typing status
+ * - session.failed: post("Something went wrong.")
+ * - input.requested: render HITL Block Kit cards + store pendingRequests
+ */
+export declare function createSlackBaseAdapter(input: {
+    readonly userAdapter?: ChannelAdapter<any>;
+    readonly slackState: Record<string, unknown>;
+}): ChannelAdapter;
+/**
+ * Creates a SlackHandle from the Chat SDK thread, lazily initialized.
+ *
+ * The Chat SDK imports happen dynamically to avoid bundler issues (same
+ * pattern as the old SlackChannel.getThread()).
+ */
+export declare function createSlackHandle(input: {
+    readonly botToken?: string;
+    readonly serializedThread: unknown;
+    readonly userContext?: SlackUserContext;
+}): SlackHandle;
+/**
+ * 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 input responses, or an empty array when no actions could be mapped.
+ */
+export declare function deriveInputResponsesFromInteraction(interaction: SlackInteraction): readonly import("../runtime/input/types.js").InputResponse[];
+/**
+ * Defines a Slack adapter. Validates the shape and returns the adapter
+ * unchanged so it can be passed to `slackRoute({ adapter })`.
+ *
+ * This is a convenience — you can also pass a plain object literal.
+ */
+export declare function defineSlackAdapter<TState extends object = Record<string, unknown>>(adapter: ChannelAdapter<SlackAdapterContext<TState>>): ChannelAdapter<SlackAdapterContext<TState>>;
+//# sourceMappingURL=slack-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slack-adapter.d.ts","sourceRoot":"","sources":["../../../src/channel/slack-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAwB,MAAM,cAAc,CAAC;AAShG,OAAO,KAAK,EAAuB,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAO9F;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACnE,SAAQ,qBAAqB,CAAC,MAAM,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,IAAI,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,6CAA6C;IAC7C,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,0DAA0D;IAC1D,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,0CAA0C;IAC1C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,uDAAuD;IACvD,kBAAkB,IAAI,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAC;IAC7D,wBAAwB;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;CACzC;AAsDD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAE5C,QAAQ,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9C,GAAG,cAAc,CA0MjB;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;CACzC,GAAG,WAAW,CA8Fd;AAMD;;;;;;;;GAQG;AACH,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,gBAAgB,GAC5B,SAAS,OAAO,2BAA2B,EAAE,aAAa,EAAE,CA6B9D;AAUD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChF,OAAO,EAAE,cAAc,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,GACnD,cAAc,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAE7C"}