experimental-ash 0.7.0 → 0.7.2

package/dist/src/public/channels/slack/slackChannel.js

@@ -1,5 +1,8 @@
-import { defineChannel, POST, } from "#public/definitions/defineChannel.js";
 import { createLogger } from "#internal/logging.js";
+import { buildSlackTurnMessage, collectSlackFileParts, createSlackAttachmentResolver, } from "#public/channels/slack/attachments.js";
+import { deriveHitlResponse, isHitlAction, renderInputRequestBlocks, } from "#public/channels/slack/hitl.js";
+import { mergeUploadPolicy } from "#public/channels/upload-policy.js";
+import { defineChannel, POST, } from "#public/definitions/defineChannel.js";
 const log = createLogger("slack.channel");
 function decodeThreadId(id) {
     const parts = id.replace(/^slack:/u, "").split(":");
@@ -31,30 +34,6 @@ function buildSlackApiHandle(thread, botToken, teamId) {
         },
     };
 }
-function renderInputRequestBlocks(requests) {
-    const blocks = [];
-    for (const request of requests) {
-        blocks.push({ type: "section", text: { type: "mrkdwn", text: request.prompt } });
-        if (request.options && request.options.length > 0) {
-            blocks.push({
-                type: "actions",
-                elements: request.options.map((opt) => {
-                    const button = {
-                        type: "button",
-                        text: { type: "plain_text", text: opt.label },
-                        action_id: `ash_input_${request.requestId}_${opt.id}`,
-                        value: opt.id,
-                    };
-                    if (opt.style === "primary" || opt.style === "danger") {
-                        button.style = opt.style;
-                    }
-                    return button;
-                }),
-            });
-        }
-    }
-    return blocks;
-}
 function parseBlockActionsPayload(body) {
     const actions = body.actions;
     if (!Array.isArray(actions))
@@ -76,6 +55,7 @@ function parseBlockActionsPayload(body) {
             actionId: String(a.action_id ?? ""),
             value: a.value != null ? String(a.value) : undefined,
             blockId: a.block_id != null ? String(a.block_id) : undefined,
+            selectedOptionValue: extractSelectedOptionValue(a),
             messageTs,
         })),
         channelId: channel,
@@ -83,6 +63,16 @@ function parseBlockActionsPayload(body) {
         teamId,
     };
 }
+/**
+ * Reads `selected_option.value` off a `block_actions` action entry.
+ * Slack populates this on `radio_buttons` / `static_select` /
+ * `external_select` clicks. Multi-select widgets surface
+ * `selected_options[]` instead and are not consumed here.
+ */
+function extractSelectedOptionValue(action) {
+    const selected = action.selected_option;
+    return typeof selected?.value === "string" ? selected.value : undefined;
+}
 function rebuildSlackContext(state, botToken) {
     const chatModule = require("#compiled/chat/index.js");
     const thread = state.serializedThread
@@ -99,24 +89,29 @@ function rebuildSlackContext(state, botToken) {
     };
 }
 /**
- * Default input.requested handler — renders HITL option buttons
- * as Slack block_actions.
+ * Default `input.requested` handler — renders each pending HITL
+ * request as Slack `block_actions`. Buttons by default; radio for
+ * ≤6-option select requests; static_select for >6-option select
+ * requests. Override by declaring `events["input.requested"]`.
  */
 function defaultInputRequestedHandler() {
     return async (data, ctx) => {
-        const blocks = renderInputRequestBlocks(data.requests);
-        if (blocks.length > 0) {
-            const decoded = decodeThreadId(ctx.thread.id ?? "");
-            await ctx.slack.request("chat.postMessage", {
-                channel: decoded.channelId,
-                thread_ts: decoded.threadTs,
-                blocks,
-                text: data.requests.map((r) => r.prompt).join("\n"),
-            });
-        }
+        if (data.requests.length === 0)
+            return;
+        const decoded = decodeThreadId(ctx.thread.id ?? "");
+        await ctx.slack.request("chat.postMessage", {
+            channel: decoded.channelId,
+            thread_ts: decoded.threadTs,
+            blocks: data.requests.flatMap(renderInputRequestBlocks),
+            text: data.requests.map((r) => r.prompt).join("\n"),
+        });
     };
 }
 export function slackChannel(config = {}) {
+    const uploadPolicy = mergeUploadPolicy(config.uploadPolicy);
+    const slackAttachments = createSlackAttachmentResolver({
+        botToken: config.credentials?.botToken,
+    });
     let activeSend = null;
     let chatPromise = null;
     async function getChat() {
@@ -166,7 +161,9 @@ export function slackChannel(config = {}) {
                     return;
                 const decoded = decodeThreadId(thread.id ?? "");
                 const continuationToken = `slack:${decoded.channelId}:${decoded.threadTs}`;
-                await send(message.text, {
+                const fileParts = collectSlackFileParts(message, uploadPolicy);
+                const turnMessage = buildSlackTurnMessage(message.text, fileParts);
+                await send(turnMessage, {
                     auth: runOpts.auth,
                     continuationToken,
                     state: {
@@ -183,10 +180,10 @@ export function slackChannel(config = {}) {
         });
         return promise;
     }
-    // Build the effective event handlers, applying defaults
     const inputHandler = config.events?.["input.requested"] ?? defaultInputRequestedHandler();
     return defineChannel({
         state: { serializedThread: null, teamId: null },
+        attachments: slackAttachments,
         context(state) {
             return rebuildSlackContext(state, config.credentials?.botToken);
         },
@@ -206,13 +203,9 @@ export function slackChannel(config = {}) {
                                 const continuationToken = `slack:${interaction.channelId}:${interaction.threadTs}`;
                                 const inputResponses = [];
                                 for (const action of interaction.actions) {
-                                    if (action.actionId.startsWith("ash_input_")) {
-                                        const parts = action.actionId.split("_");
-                                        const requestId = parts[2];
-                                        const optionId = action.value;
-                                        if (requestId && optionId) {
-                                            inputResponses.push({ requestId, optionId });
-                                        }
+                                    const response = deriveHitlResponse(action);
+                                    if (response !== null) {
+                                        inputResponses.push(response);
                                     }
                                 }
                                 if (inputResponses.length > 0) {
@@ -228,7 +221,7 @@ export function slackChannel(config = {}) {
                                     }));
                                 }
                                 if (config.onInteraction) {
-                                    const customActions = interaction.actions.filter((a) => !a.actionId.startsWith("ash_input_"));
+                                    const customActions = interaction.actions.filter((a) => !isHitlAction(a.actionId));
                                     if (customActions.length > 0) {
                                         const chatModule = await import("#compiled/chat/index.js");
                                         const thread = new chatModule.ThreadImpl({

package/dist/src/public/definitions/defineChannel.d.ts

@@ -1,3 +1,4 @@
+import type { AttachmentResolver } from "#channel/adapter.js";
 import { CHANNEL_SENTINEL } from "#channel/compiled-channel.js";
 import type { HandleMessageStreamEvent } from "#protocol/message.js";
 import type { RouteDefinition, SendFn } from "#channel/routes.js";
@@ -5,6 +6,7 @@ import type { Session, SessionHandle } from "#channel/session.js";
 export type { Session, SessionHandle } from "#channel/session.js";
 export { POST, GET, PUT, DELETE } from "#channel/routes.js";
 export type { RouteDefinition, RouteHandlerArgs, SendFn, SendOptions, SendPayload, GetSessionFn, } from "#channel/routes.js";
+export type { AttachmentResolver } from "#channel/adapter.js";
 type EventData<T extends HandleMessageStreamEvent["type"]> = Extract<HandleMessageStreamEvent, {
     type: T;
 }> extends {
@@ -38,6 +40,13 @@ export interface ChannelConfig<TState = undefined, TCtx = void> {
         send: SendFn<TState>;
     }): Promise<Session>;
     readonly events?: ChannelEvents<TCtx>;
+    /**
+     * Resolver for `ash-attachment:` URLs this channel mints during
+     * inbound message handling. The framework's staging layer dispatches
+     * to `resolve(ref, ctx)` before each model call so the bytes can be
+     * written to the sandbox and rewritten as `ash-sandbox:` refs.
+     */
+    readonly attachments?: AttachmentResolver;
 }
 export interface Channel<TState = undefined> {
     readonly __kind: typeof CHANNEL_SENTINEL;

package/dist/src/public/definitions/defineChannel.js

@@ -14,6 +14,7 @@ export function defineChannel(config) {
 function buildAdapter(config) {
     const hasState = config.state != null;
     const hasContext = config.context != null;
+    const hasAttachments = config.attachments !== undefined;
     const hasBehavior = hasState || hasContext;
     const eventHandlers = {};
     let hasEventHandlers = false;
@@ -41,19 +42,20 @@ function buildAdapter(config) {
             };
         }
     }
-    // When the channel has no state, no context, and no event handlers,
-    // return a bare pass-through adapter with framework kind "http".
-    // This avoids the registry conflict when the adapter carries behavior
-    // on a reserved framework kind.
-    if (!hasBehavior && !hasEventHandlers) {
+    // When the channel carries no behavior at all, return a bare
+    // pass-through adapter with framework kind "http". This avoids the
+    // registry conflict when the adapter would otherwise reserve a
+    // framework kind with no behavior to register against it.
+    if (!hasBehavior && !hasEventHandlers && !hasAttachments) {
         return { kind: "http" };
     }
-    // Channels with state, context, or event handlers use a dedicated
-    // adapter kind so the registry can rehydrate behavior across step
-    // boundaries without conflicting with framework-reserved kinds.
+    // Channels with any authored behavior use a dedicated adapter kind so
+    // the registry can rehydrate it across step boundaries without
+    // conflicting with framework-reserved kinds.
     return {
         kind: "defineChannel",
         state: hasState ? { ...config.state } : {},
+        attachments: config.attachments,
         createAdapterContext(base) {
             const state = base.state;
             const channelCtx = hasContext ? config.context(state) : {};

package/dist/src/runtime/framework-channels/index.d.ts

@@ -1,4 +1,4 @@
 import type { ResolvedChannelDefinition } from "#runtime/types.js";
-export declare const HTTP_CHANNEL_NAME = "default";
+export declare const ASH_CHANNEL_NAME = "ash";
 export declare function getFrameworkChannelDefinitions(): readonly ResolvedChannelDefinition[];
 export declare function getAllFrameworkChannelNames(): ReadonlySet<string>;

package/dist/src/runtime/framework-channels/index.js

@@ -1,14 +1,14 @@
 import { none, vercelOidc } from "#public/channels/auth.js";
-import { httpChannel } from "#public/channels/http.js";
+import { ashChannel } from "#public/channels/ash.js";
 import { getConnectionCallbackChannelDefinitions, getConnectionCallbackChannelNames, } from "#runtime/connections/callback-route.js";
-export const HTTP_CHANNEL_NAME = "default";
+export const ASH_CHANNEL_NAME = "ash";
 export function getFrameworkChannelDefinitions() {
-    const auth = resolveFrameworkHttpAuth();
-    const compiled = httpChannel({ auth });
+    const auth = resolveFrameworkAshAuth();
+    const compiled = ashChannel({ auth });
     const result = [];
     for (const route of compiled.routes) {
         result.push({
-            name: HTTP_CHANNEL_NAME,
+            name: ASH_CHANNEL_NAME,
             method: route.method.toUpperCase(),
             urlPath: route.path,
             fetch: async (req, ctx) => route.handler(req, ctx),
@@ -23,9 +23,9 @@ export function getFrameworkChannelDefinitions() {
     return result;
 }
 export function getAllFrameworkChannelNames() {
-    return new Set([HTTP_CHANNEL_NAME, ...getConnectionCallbackChannelNames()]);
+    return new Set([ASH_CHANNEL_NAME, ...getConnectionCallbackChannelNames()]);
 }
-function resolveFrameworkHttpAuth() {
+function resolveFrameworkAshAuth() {
     if (process.env.VERCEL) {
         return vercelOidc();
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "experimental-ash",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "bin": {
     "ash": "./bin/ash.js",
     "experimental-ash": "./bin/ash.js"
@@ -120,10 +120,10 @@
       "import": "./dist/src/public/channels/index.js",
       "default": "./dist/src/public/channels/index.js"
     },
-    "./channels/http": {
-      "types": "./dist/src/public/channels/http.d.ts",
-      "import": "./dist/src/public/channels/http.js",
-      "default": "./dist/src/public/channels/http.js"
+    "./channels/ash": {
+      "types": "./dist/src/public/channels/ash.d.ts",
+      "import": "./dist/src/public/channels/ash.js",
+      "default": "./dist/src/public/channels/ash.js"
     },
     "./channels/auth": {
       "types": "./dist/src/public/channels/auth.d.ts",

package/dist/src/cli/commands/init.d.ts

@@ -1,13 +0,0 @@
-interface CliInitLogger {
-    log(message: string): void;
-}
-interface InitializeApplicationInput {
-    readonly logger: CliInitLogger;
-    readonly parentDirectoryPath: string;
-    readonly targetName: string;
-}
-/**
- * Scaffolds a new Ash application directory from the package-owned init template.
- */
-export declare function initializeApplication(input: InitializeApplicationInput): Promise<string>;
-export {};

package/dist/src/cli/commands/init.js

@@ -1 +0,0 @@
-import{r as e,t}from"../../chunks/package-DmsQgn4v.js";import{createCliTheme as n,renderCliTaggedLine as r}from"../ui/output.js";import{basename as i,dirname as a,extname as o,join as s,resolve as c}from"node:path";import{access as l,cp as u,mkdir as d,readFile as f,readdir as p,rm as m,writeFile as h}from"node:fs/promises";const g=new Set([`.json`,`.md`,`.ts`]),_=new Set([`.gitignore`,`.vercelignore`,`gitignore`]);function v(e){return _.has(e)||g.has(o(e))}async function y(e){try{return await l(e),!0}catch{return!1}}function b(){return e(`src/cli/templates/init-app`)}async function x(e,t){let n=await p(e,{withFileTypes:!0});await Promise.all(n.map(async n=>{let r=s(e,n.name);if(n.isDirectory()){await x(r,t);return}if(!n.isFile()||!v(n.name))return;let i=await f(r,`utf8`),a=s(e,n.name===`gitignore`?`.gitignore`:n.name);for(let[e,n]of Object.entries(t))i=i.replaceAll(e,n);await h(a,i,`utf8`),n.name===`gitignore`&&await m(r)}))}async function S(e){let o=c(e.parentDirectoryPath,e.targetName);if(await y(o))throw Error(`Cannot initialize Ash app because "${o}" already exists.`);let s=i(o);if(s.trim().length===0)throw Error(`Cannot initialize Ash app because "${e.targetName}" is not a valid name.`);let l=t();await d(a(o),{recursive:!0}),await u(b(),o,{recursive:!0}),await x(o,{__ASH_INIT_APP_NAME__:s,__ASH_INIT_PACKAGE_VERSION__:`^${l.version}`});let f=n();return e.logger.log(r(f,{message:`created ${o}`,tag:`init`,tone:`success`})),e.logger.log(r(f,{message:`next: cd ${o}\npnpm install\npnpm dev`,tag:`init`,tone:`info`})),o}export{S as initializeApplication};

package/dist/src/cli/templates/init-app/.vercelignore

@@ -1,11 +0,0 @@
-.output
-.swc
-.ash
-.turbo
-.agents
-.codex
-.github
-.workflow-data
-dist
-research
-node_modules

package/dist/src/cli/templates/init-app/agent/agent.ts

@@ -1,5 +0,0 @@
-import { defineAgent } from "experimental-ash";
-
-export default defineAgent({
-  model: "anthropic/claude-opus-4.7",
-});

package/dist/src/cli/templates/init-app/agent/instructions.md

@@ -1,3 +0,0 @@
-# Identity
-
-You are a helpful assistant.

package/dist/src/cli/templates/init-app/agent/tools/hello.ts

@@ -1,12 +0,0 @@
-import { defineTool } from "experimental-ash/tools";
-import z from "zod";
-
-export default defineTool({
-  description: "Say hello",
-  inputSchema: z.object({
-    greeting: z.string(),
-  }),
-  async execute(input) {
-    return `Hello, ${input.greeting}!`;
-  },
-});

package/dist/src/cli/templates/init-app/gitignore

@@ -1,8 +0,0 @@
-.ash
-.swc
-.output
-.vercel
-.env*
-.workflow-data
-.DS_Store
-node_modules

package/dist/src/cli/templates/init-app/package.json

@@ -1,18 +0,0 @@
-{
-  "name": "__ASH_INIT_APP_NAME__",
-  "version": "0.0.0",
-  "type": "module",
-  "scripts": {
-    "build": "ash build",
-    "dev": "ash dev",
-    "typecheck": "tsgo"
-  },
-  "dependencies": {
-    "ai": "7.0.0-canary.131",
-    "experimental-ash": "__ASH_INIT_PACKAGE_VERSION__",
-    "zod": "^4.3.6"
-  },
-  "devDependencies": {
-    "@typescript/native-preview": "7.0.0-dev.20260320.1"
-  }
-}

package/dist/src/cli/templates/init-app/tsconfig.json

@@ -1,16 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "outDir": "dist",
-    "rootDir": ".",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "declaration": true,
-    "noEmit": true
-  },
-  "include": ["agent/**/*.ts", "evals/**/*.ts", ".ash/**/*.d.ts"]
-}