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

package/bin/ash.d.ts

@@ -41,6 +41,11 @@ export interface BootstrapCliModule {
 
 export interface BootstrapDependencies extends BootstrapBuildDependencies {
   importModule?: (specifier: string) => Promise<BootstrapCliModule>;
+
+  /**
+   * Node.js version string used by tests to exercise the bin version guard.
+   */
+  nodeVersion?: string;
 }
 
 /**

package/bin/ash.js

@@ -7,6 +7,7 @@ import { dirname, resolve } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 
 const require = createRequire(import.meta.url);
+const minimumNodeMajorVersion = 24;
 
 function createBootstrapOptions(overrides = {}) {
   const packageRoot =
@@ -105,6 +106,27 @@ function inputTsconfigPath({ packageRoot }) {
   return resolve(packageRoot, "tsconfig.json");
 }
 
+function parseNodeMajorVersion(version) {
+  const match = /^v?(\d+)/.exec(version);
+  return match ? Number(match[1]) : undefined;
+}
+
+function assertSupportedNodeVersion(version = process.version) {
+  const majorVersion = parseNodeMajorVersion(version);
+
+  if (majorVersion !== undefined && majorVersion >= minimumNodeMajorVersion) {
+    return;
+  }
+
+  throw new Error(
+    [
+      `Ash requires Node.js ${minimumNodeMajorVersion} or newer.`,
+      `You are running ${version}.`,
+      "Please upgrade Node.js and try again.",
+    ].join(" "),
+  );
+}
+
 function resolveTsgoCliPath({ tsgoCliPath }) {
   if (tsgoCliPath) {
     return tsgoCliPath;
@@ -203,6 +225,8 @@ export async function ensureBuiltCli(overrides = {}, dependencies = {}) {
  * Runs the compiled Ash CLI, building the workspace package on demand when needed.
  */
 export async function runAshCli(argv = process.argv.slice(2), overrides = {}, dependencies = {}) {
+  assertSupportedNodeVersion(dependencies.nodeVersion);
+
   const cliEntrypointPath = await ensureBuiltCli(overrides, dependencies);
   const importModule = dependencies.importModule ?? ((specifier) => import(specifier));
   const cliModule = await importModule(pathToFileURL(cliEntrypointPath).href);

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

@@ -1,21 +1,36 @@
 /**
  * Slack adapter context, base layer, and factory.
+ *
+ * The adapter exposes the Chat SDK `Thread` directly on the context so
+ * user adapters interact with the Chat SDK without a wrapper layer.
  */
 import type { FilePart } from "ai";
-import type { SerializedThread } from "chat";
+import type { Message, Thread } from "chat";
 import { type UploadPolicy } from "../public/channels/upload-policy.js";
 import type { ChannelAdapter, ChannelAdapterContext } from "./adapter.js";
-import type { SlackChannelState, SlackUserContext } from "./slack-state.js";
-import type { SlackInteraction, SlackRenderable, SlackThreadMessage, SlackResponse } from "./slack-types.js";
+import type { SlackChannelState } from "./slack-state.js";
+import type { SlackInteraction, SlackResponse } from "./slack-types.js";
+export type { SlackInteraction } 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.
+ * Extended adapter context for Slack adapters. Provides the Chat SDK
+ * `Thread` directly so user adapters interact with the Chat SDK without
+ * a wrapper layer.
  *
  * Constructed by the slack base layer before calling user adapter handlers.
  */
 export interface SlackAdapterContext<TState extends SlackChannelState = SlackChannelState> extends ChannelAdapterContext<TState> {
-    readonly slack: SlackHandle;
+    readonly thread: Thread;
+    /** Authenticated Slack API request helper. */
+    readonly slack: SlackApiHandle;
+}
+/**
+ * Thin helper for raw Slack Web API calls that the Chat SDK Thread
+ * doesn't cover. Reads the bot token from `SLACK_BOT_TOKEN` at call
+ * time so credentials never enter serialized state.
+ */
+export interface SlackApiHandle {
+    /** Perform an authenticated POST to `https://slack.com/api/{operation}`. */
+    request(operation: string, body: unknown): Promise<SlackResponse>;
 }
 /**
  * Params carried by Slack `ash-attachment:` refs.
@@ -24,94 +39,28 @@ 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.
- */
-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[]>;
-    /** 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. */
-    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>;
-    /**
-     * 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.
- *
- * 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: SerializedThread;
-    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 })`.
- *
- * `TExtra` lets a user adapter declare the custom state fields it
- * manages; Ash intersects it with framework-managed
- * {@link SlackChannelState}.
+ * Defines a Slack adapter with typed context. Validates the shape and
+ * returns the adapter unchanged so it can be passed to
+ * `slackRoute({ adapter })`.
  */
 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.
+ * AI SDK `FilePart`s.
  */
-export declare function collectFilePartsFromMessages(messages: readonly SlackThreadMessage[], uploadPolicy?: UploadPolicy): Promise<FilePart[]>;
+export declare function collectFilePartsFromMessages(messages: readonly Message[], 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":"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"}
+{"version":3,"file":"slack-adapter.d.ts","sourceRoot":"","sources":["../../../src/channel/slack-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAyB,MAAM,IAAI,CAAC;AAE1D,OAAO,KAAK,EAAc,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAWxD,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,KAAK,EAEV,cAAc,EACd,qBAAqB,EAEtB,MAAM,cAAc,CAAC;AAQtB,OAAO,KAAK,EAAE,iBAAiB,EAAyC,MAAM,kBAAkB,CAAC;AACjG,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAExE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAkBzD;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB,CAClC,MAAM,SAAS,iBAAiB,GAAG,iBAAiB,CACpD,SAAQ,qBAAqB,CAAC,MAAM,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACnE;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AA+ED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;CACtC,GAAG,cAAc,CAAC,mBAAmB,EAAE,qBAAqB,CAAC,CAoX7D;AAMD;;GAEG;AACH,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,gBAAgB,GAC5B,SAAS,OAAO,2BAA2B,EAAE,aAAa,EAAE,CA6B9D;AAMD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,EAC5E,OAAO,EAAE,cAAc,CAAC,mBAAmB,CAAC,MAAM,GAAG,iBAAiB,CAAC,CAAC,GACvE,cAAc,CAAC,mBAAmB,CAAC,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAEjE;AA+BD;;;GAGG;AACH,wBAAsB,4BAA4B,CAChD,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,YAAY,GAAE,YAAoC,GACjD,OAAO,CAAC,QAAQ,EAAE,CAAC,CAMrB"}