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

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/
@@ -128,4 +128,3 @@ Start here:
 - [`packages/ash/README.md`](packages/ash/README.md) is the package-facing overview
 - [`skills/agent/SKILL.md`](skills/agent/SKILL.md) is the app-authoring skill
 - [`skills/framework/SKILL.md`](skills/framework/SKILL.md) is the internals skill
-

package/bin/ash.d.ts

@@ -15,9 +15,9 @@ export interface BootstrapOptions {
   packageRoot?: string;
 
   /**
-   * Absolute path to the TypeScript CLI entrypoint used for bootstrap builds.
+   * Absolute path to the tsgo CLI entrypoint used for bootstrap builds.
    */
-  tscCliPath?: string;
+  tsgoCliPath?: string;
 }
 
 export interface BootstrapCommandOptions {

package/bin/ash.js

@@ -18,7 +18,7 @@ function createBootstrapOptions(overrides = {}) {
     copyAssetsScriptPath:
       overrides.copyAssetsScriptPath ?? resolve(packageRoot, "scripts", "copy-static-assets.mjs"),
     packageRoot,
-    tscCliPath: overrides.tscCliPath,
+    tsgoCliPath: overrides.tsgoCliPath,
   };
 }
 
@@ -105,8 +105,17 @@ function inputTsconfigPath({ packageRoot }) {
   return resolve(packageRoot, "tsconfig.json");
 }
 
-function resolveTscCliPath({ tscCliPath }) {
-  return tscCliPath ?? require.resolve("typescript/bin/tsc");
+function resolveTsgoCliPath({ tsgoCliPath }) {
+  if (tsgoCliPath) {
+    return tsgoCliPath;
+  }
+
+  // The `@typescript/native-preview` package only exports `./package.json`
+  // in its `exports` map, so `require.resolve("@typescript/native-preview/bin/tsgo.js")`
+  // fails with ERR_PACKAGE_PATH_NOT_EXPORTED. Resolve the package.json
+  // (which is exported) and join to the binary path manually.
+  const packageJsonPath = require.resolve("@typescript/native-preview/package.json");
+  return resolve(dirname(packageJsonPath), "bin", "tsgo.js");
 }
 
 async function runCommand(command, args, options) {
@@ -174,7 +183,7 @@ export async function ensureBuiltCli(overrides = {}, dependencies = {}) {
 
   await executeCommand(
     process.execPath,
-    [resolveTscCliPath({ tscCliPath: options.tscCliPath }), "-p", "tsconfig.json"],
+    [resolveTsgoCliPath({ tsgoCliPath: options.tsgoCliPath }), "-p", "tsconfig.json"],
     {
       cwd: options.packageRoot,
     },

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

@@ -0,0 +1,178 @@
+import type { ContextAccessor } from "../context/key.js";
+import type { ContextProvider } from "../context/provider.js";
+import type { StepInput } from "../harness/types.js";
+import type { AttachmentRef } from "../internal/attachments/refs.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>;
+};
+/**
+ * Channel-owned resolver that turns an opaque {@link AttachmentRef} back
+ * into raw bytes.
+ *
+ * Attachment refs are the wire format channels use to carry inbound
+ * file identity across step boundaries without inlining the payload
+ * (inline bytes trip the Vercel Queue 8 KB per-field multipart cap).
+ * A channel that ingests file attachments must provide a resolver so
+ * the staging layer can re-fetch the bytes on demand at turn time.
+ *
+ * The resolver is called once per inbound file per turn, inside a
+ * workflow step boundary. It has full Node access and can reach any
+ * credential the adapter captured at construction time via closure
+ * (route options, adapter state, env-derived tokens, etc.).
+ *
+ * Throw {@link import("../internal/attachments/errors.js").AshAttachmentError}
+ * to surface structured failures to observability. Uncategorized
+ * throws are wrapped as `resolver-threw` by the staging dispatch.
+ */
+export interface AttachmentResolver {
+    resolve(ref: AttachmentRef): Promise<Buffer>;
+}
+/**
+ * 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;
+    /**
+     * Optional resolver that turns an opaque {@link AttachmentRef}
+     * produced by this adapter into raw bytes.
+     *
+     * Channels that produce `FilePart`s whose `data` is an
+     * `ash-attachment:` URL must declare a resolver here so the
+     * staging layer can re-fetch the bytes at turn time. Channels that
+     * never emit refs (test adapters, framework `http` / `schedule` /
+     * `subagent` pass-throughs) omit it.
+     *
+     * Attachment resolvers are stateless handlers — all state (bot
+     * tokens, API credentials, cache) lives on the adapter and is
+     * captured by closure at construction time. Do not store
+     * per-resolve state on the handler.
+     */
+    readonly attachments?: AttachmentResolver;
+} & ChannelEventHandlers<TCtx>;
+/**
+ * Produces the default {@link StepInput} when no custom adapter `deliver`
+ * hook is defined.
+ *
+ * Passes through both `message` and `inputResponses` from the delivery
+ * payload so tool-approval responses (and other HITL replies) reach the
+ * harness even when the channel has no bespoke deliver logic.
+ */
+export declare function defaultDeliverResult(payload: DeliverPayload): StepInput | undefined;
+/**
+ * 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":"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"}

package/dist/src/channel/adapter.js

@@ -0,0 +1,47 @@
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Produces the default {@link StepInput} when no custom adapter `deliver`
+ * hook is defined.
+ *
+ * Passes through both `message` and `inputResponses` from the delivery
+ * payload so tool-approval responses (and other HITL replies) reach the
+ * harness even when the channel has no bespoke deliver logic.
+ */
+export function defaultDeliverResult(payload) {
+    if (payload.message !== undefined) {
+        return { inputResponses: payload.inputResponses, message: payload.message };
+    }
+    if (payload.inputResponses !== undefined && payload.inputResponses.length > 0) {
+        return { inputResponses: payload.inputResponses };
+    }
+    return undefined;
+}
+/**
+ * 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":"AAqLA,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAuB;IAC1D,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;IAC9E,CAAC;IAED,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9E,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;IACpD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;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;IAElC,YAAY,MAAM,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,EAEhD;IAEK,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC,CAS7D;CACF"}

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,116 @@
+/**
+ * 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 { FilePart } from "ai";
+import { type UploadPolicy } from "../public/channels/upload-policy.js";
+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>;
+    /**
+     * Effective upload policy for inbound Slack attachments. The Slack
+     * base layer filters disallowed parts out of the `FilePart` array
+     * before it reaches the harness; violations are logged and dropped
+     * rather than surfaced as an error so the text turn still goes
+     * through. Defaults to {@link DEFAULT_UPLOAD_POLICY}.
+     */
+    readonly uploadPolicy?: UploadPolicy;
+}): 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>>;
+/**
+ * Converts attachments on the most recent non-bot thread message into
+ * AI SDK `FilePart`s. Audio and video parts are skipped by default;
+ * failed byte fetches are silently dropped so a broken upload never
+ * prevents the text turn from going through.
+ *
+ * `uploadPolicy` filters out parts that exceed the size cap or fall
+ * outside the media-type allowlist. Dropped attachments emit a warning
+ * so operators can observe policy rejections without the turn failing.
+ *
+ * Exported so `slackRoute`'s new-session path can inject attachments on
+ * the initial bot mention (which goes through `agent.run`, bypassing
+ * the adapter's `deliver` hook).
+ */
+export declare function collectFilePartsFromMessages(messages: readonly SlackThreadMessage[], uploadPolicy?: UploadPolicy): Promise<FilePart[]>;
+//# 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;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAyB,MAAM,IAAI,CAAC;AAM1D,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,KAAK,EAEV,cAAc,EACd,qBAAqB,EAEtB,MAAM,cAAc,CAAC;AAUtB,OAAO,KAAK,EAAuB,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAEf,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAO1B;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB,CAClC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAChC,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;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;CACtC,GAAG,cAAc,CAoTjB;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;AAiDD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,4BAA4B,CAChD,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,YAAY,GAAE,YAAoC,GACjD,OAAO,CAAC,QAAQ,EAAE,CAAC,CAMrB"}