experimental-ash 0.3.0-alpha.2 → 0.3.0-alpha.22

package/README.md

@@ -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,
     },
@@ -229,5 +238,11 @@ if (await isDirectExecution()) {
     const message = error instanceof Error ? error.message : String(error);
     console.error(message);
     process.exitCode = 1;
+  } finally {
+    // The CLI bootstraps build/dev toolchains that can leave native service
+    // handles alive after the command has completed. Once the top-level
+    // command resolves, terminate the bin process explicitly so commands like
+    // `ash dev` + `/exit` do not hang on leaked implementation details.
+    process.exit(process.exitCode ?? 0);
   }
 }

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

@@ -0,0 +1,8 @@
+import type { ContextAccessor } from "../context/key.js";
+import type { ChannelAdapter, ChannelAdapterContext } from "./adapter.js";
+/**
+ * Builds the {@link ChannelAdapterContext} the runtime hands to an
+ * adapter's `deliver` hook, event handlers, and attachment resolver.
+ */
+export declare function buildAdapterContext<TCtx extends ChannelAdapterContext<any> = ChannelAdapterContext>(adapter: ChannelAdapter<TCtx>, accessor: ContextAccessor): TCtx;
+//# sourceMappingURL=adapter-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-context.d.ts","sourceRoot":"","sources":["../../../src/channel/adapter-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1E;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,SAAS,qBAAqB,CAAC,GAAG,CAAC,GAAG,qBAAqB,EAC/D,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAahE"}

package/dist/src/channel/adapter-context.js

@@ -0,0 +1,19 @@
+/**
+ * Builds the {@link ChannelAdapterContext} the runtime hands to an
+ * adapter's `deliver` hook, event handlers, and attachment resolver.
+ */
+export function buildAdapterContext(adapter, accessor) {
+    // `adapter.state` is stored loosely (`Record<string, unknown>`)
+    // because it round-trips through JSON at step boundaries. The
+    // adapter is responsible for seeding state in the shape its
+    // `createAdapterContext` / handlers expect, so the cast to the
+    // narrower `TCtx`-derived state is safe at this seam.
+    const baseCtx = {
+        ctx: accessor,
+        state: adapter.state ?? {},
+    };
+    return adapter.createAdapterContext
+        ? adapter.createAdapterContext(baseCtx)
+        : baseCtx;
+}
+//# sourceMappingURL=adapter-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-context.js","sourceRoot":"","sources":["../../../src/channel/adapter-context.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAEjC,OAA6B,EAAE,QAAyB;IACxD,gEAAgE;IAChE,8DAA8D;IAC9D,4DAA4D;IAC5D,+DAA+D;IAC/D,sDAAsD;IACtD,MAAM,OAAO,GAAG;QACd,GAAG,EAAE,QAAQ;QACb,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;KACiD,CAAC;IAC9E,OAAO,OAAO,CAAC,oBAAoB;QACjC,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC;QACvC,CAAC,CAAE,OAA2B,CAAC;AACnC,CAAC"}

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

@@ -1,6 +1,7 @@
 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";
 /**
@@ -24,6 +25,12 @@ export interface ChannelAdapterContext<TState = Record<string, unknown>> {
      */
     readonly ctx: ContextAccessor;
 }
+/**
+ * Extracts the state type from a {@link ChannelAdapterContext} generic.
+ * Used internally so adapter-level types can declare their state shape
+ * once (via `TCtx`) and have helpers narrow consistently.
+ */
+type StateOf<TCtx> = TCtx extends ChannelAdapterContext<infer S> ? S : Record<string, unknown>;
 /**
  * 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`.
@@ -47,20 +54,37 @@ export type ChannelEventHandlers<TCtx extends ChannelAdapterContext<any> = Chann
     [K in HandleMessageStreamEvent["type"]]?: EventHandler<K, TCtx>;
 };
 /**
- * Plain-object adapter that replaces the `Channel` abstract class.
+ * Enriched resolver return shape. A resolver can return either a bare
+ * {@link Buffer} or this record when it learns a more accurate
+ * `mediaType` or `filename` mid-fetch (e.g. from an HTTP
+ * `Content-Type` header or a storage-service listing).
  *
- * 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
+ * When fields are provided, staging prefers them over the values the
+ * channel populated at ingestion time — the resolver is the source of
+ * truth for bytes *and* for anything it discovers while fetching.
+ */
+export interface ResolvedAttachment {
+    readonly bytes: Buffer;
+    readonly mediaType?: string;
+    readonly filename?: string;
+}
+/**
+ * Channel-owned resolver that turns an opaque {@link AttachmentRef} back
+ * into raw bytes.
  *
- * Adapters are created via `defineSlackAdapter`, `defineHttpAdapter`, or
- * directly as plain objects. They are NOT classes — no inheritance, no
- * `serialize()`, no constructor rehydration.
+ * Channels that emit `ash-attachment:` refs provide this so staging can
+ * re-fetch bytes inside a step boundary. Return a bare {@link Buffer} or
+ * a {@link ResolvedAttachment} when fetch-time metadata should override
+ * the original file part.
+ */
+export interface AttachmentResolver<TParams = unknown, TCtx extends ChannelAdapterContext<any> = ChannelAdapterContext> {
+    resolve(ref: AttachmentRef<TParams>, ctx: TCtx): Promise<Buffer | ResolvedAttachment>;
+}
+/**
+ * Plain-object channel adapter with durable state, an optional inbound
+ * delivery hook, event handlers, and optional attachment resolution.
  */
-export type ChannelAdapter<TCtx extends ChannelAdapterContext<any> = ChannelAdapterContext> = {
+export type ChannelAdapter<TCtx extends ChannelAdapterContext<any> = ChannelAdapterContext, TAttachmentParams = unknown> = {
     /**
      * Stable durable identifier for serialization across step boundaries.
      * Must be unique across all adapters visible to one runtime bundle.
@@ -78,17 +102,8 @@ export type ChannelAdapter<TCtx extends ChannelAdapterContext<any> = ChannelAdap
     /**
      * 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.
+     * Return a {@link StepInput} to override the input the harness sees, or
+     * return void to use the default payload projection.
      */
     deliver?(payload: DeliverPayload, ctx: TCtx): StepInput | void | Promise<StepInput | void>;
     /**
@@ -102,14 +117,27 @@ export type ChannelAdapter<TCtx extends ChannelAdapterContext<any> = ChannelAdap
     /**
      * 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;
+    createAdapterContext?(base: ChannelAdapterContext<StateOf<TCtx>>): TCtx;
+    /**
+     * Optional resolver that turns an opaque {@link AttachmentRef}
+     * produced by this adapter into raw bytes.
+     *
+     * Required only for channels that put `ash-attachment:` URLs into
+     * `FilePart.data`.
+     */
+    readonly attachments?: AttachmentResolver<TAttachmentParams, TCtx>;
 } & 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"`.
  */
@@ -122,8 +150,8 @@ export declare function getAdapterContextProviders(adapter: ChannelAdapter): rea
  * 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.
+ * Throwing handlers are logged and swallowed so a downstream delivery
+ * failure does not corrupt the event stream write path.
  */
 export declare function callAdapterEventHandler(adapter: ChannelAdapter, event: HandleMessageStreamEvent, ctx: ChannelAdapterContext): Promise<HandleMessageStreamEvent>;
 export {};

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

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

package/dist/src/channel/adapter.js

@@ -1,6 +1,25 @@
+import { createLogger } from "../internal/logging.js";
+const log = createLogger("channel.adapter");
 // ---------------------------------------------------------------------------
 // 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"`.
  */
@@ -17,14 +36,24 @@ export function getAdapterContextProviders(adapter) {
  * 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.
+ * Throwing handlers are logged and swallowed so a downstream delivery
+ * failure does not corrupt the event stream write path.
  */
 export async function callAdapterEventHandler(adapter, event, ctx) {
     const handler = adapter[event.type];
-    if (handler !== undefined) {
+    if (handler === undefined) {
+        return event;
+    }
+    try {
         await handler("data" in event ? event.data : undefined, ctx);
     }
+    catch (error) {
+        log.error("adapter event handler threw — event swallowed", {
+            adapterKind: getAdapterKind(adapter),
+            eventType: event.type,
+            error,
+        });
+    }
     return event;
 }
 //# sourceMappingURL=adapter.js.map

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

@@ -1 +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"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/channel/adapter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAItD,MAAM,GAAG,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC;AAoK5C,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,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,KAAK,CAAC,+CAA+C,EAAE;YACzD,WAAW,EAAE,cAAc,CAAC,OAAO,CAAC;YACpC,SAAS,EAAE,KAAK,CAAC,IAAI;YACrB,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

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,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"}
+{"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/slack-adapter.d.ts

@@ -1,14 +1,12 @@
 /**
  * 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 { SerializedThread } from "chat";
+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";
+import type { SlackChannelState, SlackUserContext } from "./slack-state.js";
+import type { SlackInteraction, SlackRenderable, SlackThreadMessage, SlackResponse } from "./slack-types.js";
 /**
  * Extended adapter context for Slack adapters. Provides a `slack` handle
  * for posting messages, editing messages, typing indicators, and reading
@@ -16,9 +14,16 @@ import type { SlackInteraction, SlackRenderable, SlackThreadMessage } from "./sl
  *
  * Constructed by the slack base layer before calling user adapter handlers.
  */
-export interface SlackAdapterContext<TState = Record<string, unknown>> extends ChannelAdapterContext<TState> {
+export interface SlackAdapterContext<TState extends SlackChannelState = SlackChannelState> extends ChannelAdapterContext<TState> {
     readonly slack: SlackHandle;
 }
+/**
+ * Params carried by Slack `ash-attachment:` refs.
+ */
+export interface SlackAttachmentParams {
+    /** Authenticated `files.slack.com` URL to the raw attachment bytes. */
+    readonly url: string;
+}
 /**
  * Platform handle for Slack operations. Injected into the adapter context
  * by the slack base layer.
@@ -34,6 +39,8 @@ export interface SlackHandle {
     refresh(): Promise<void>;
     /** Get recent thread messages (call refresh first). */
     listRecentMessages(): Promise<readonly SlackThreadMessage[]>;
+    /** Perform a raw, authenticated request to the Slack API. */
+    request(operation: string, body: unknown): Promise<SlackResponse>;
     /** Slack channel ID. */
     readonly channelId: string;
     /** Chat SDK thread ID. */
@@ -58,8 +65,19 @@ export interface SlackHandle {
  */
 export declare function createSlackBaseAdapter(input: {
     readonly userAdapter?: ChannelAdapter<any>;
-    readonly slackState: Record<string, unknown>;
-}): ChannelAdapter;
+    /**
+     * Seed state for the route-time or session-time Slack adapter.
+     */
+    readonly slackState: Partial<SlackChannelState>;
+    /**
+     * 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<SlackAdapterContext, SlackAttachmentParams>;
 /**
  * Creates a SlackHandle from the Chat SDK thread, lazily initialized.
  *
@@ -67,8 +85,8 @@ export declare function createSlackBaseAdapter(input: {
  * pattern as the old SlackChannel.getThread()).
  */
 export declare function createSlackHandle(input: {
-    readonly botToken?: string;
-    readonly serializedThread: unknown;
+    readonly botToken: string;
+    readonly serializedThread: SerializedThread;
     readonly userContext?: SlackUserContext;
 }): SlackHandle;
 /**
@@ -85,7 +103,15 @@ export declare function deriveInputResponsesFromInteraction(interaction: SlackIn
  * 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.
+ * `TExtra` lets a user adapter declare the custom state fields it
+ * manages; Ash intersects it with framework-managed
+ * {@link SlackChannelState}.
+ */
+export declare function defineSlackAdapter<TExtra extends Record<string, unknown> = {}>(adapter: ChannelAdapter<SlackAdapterContext<TExtra & SlackChannelState>>): ChannelAdapter<SlackAdapterContext<TExtra & SlackChannelState>>;
+/**
+ * Converts attachments on the most recent non-bot thread message into
+ * AI SDK `FilePart`s. Disallowed or unreadable attachments are logged
+ * and dropped so the text turn can continue.
  */
-export declare function defineSlackAdapter<TState extends object = Record<string, unknown>>(adapter: ChannelAdapter<SlackAdapterContext<TState>>): ChannelAdapter<SlackAdapterContext<TState>>;
+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

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