experimental-ash 0.60.0 → 0.61.0

package/dist/src/runtime/resolve-channel.js

@@ -1 +1 @@
-import{setChannelInstrumentationKind}from"#channel/compiled-channel.js";import{toErrorMessage}from"#shared/errors.js";import{normalizeChannelDefinition}from"#internal/authored-definition/channel.js";import{ResolveAgentError,createResolvedModuleSourceRef,loadResolvedModuleExport}from"#runtime/resolve-helpers.js";import{HTTP_ADAPTER_KIND}from"#channel/http.js";async function resolveChannelDefinition(r,i,a){try{let t=normalizeChannelDefinition(await loadResolvedModuleExport({definition:r,kindLabel:`channel`,moduleMap:i,nodeId:a}),`Expected the channel export "${r.exportName??`default`}" from "${r.logicalPath}" to match the public Ash shape.`),n=createResolvedModuleSourceRef({exportName:r.exportName,logicalPath:r.logicalPath,sourceId:r.sourceId}),o=t.routes.find(e=>e.method.toUpperCase()===r.method.toUpperCase()&&e.path===r.urlPath),s=`channel:${r.name}`;setChannelInstrumentationKind(t,s);let c=t.adapter;return c&&c.kind!==HTTP_ADAPTER_KIND&&(c.kind=s),{name:r.name,method:r.method,urlPath:r.urlPath,fetch:async(e,t)=>o?o.handler(e,t):Response.json({error:`No matching route handler.`,ok:!1},{status:404}),handler:o?.handler,receive:t.receive,definition:t,adapter:c,...n}}catch(e){throw e instanceof ResolveAgentError?e:new ResolveAgentError(`Failed to attach the channel definition from "${r.logicalPath}": ${toErrorMessage(e)}`,{logicalPath:r.logicalPath,sourceId:r.sourceId})}}export{resolveChannelDefinition};
+import{setChannelInstrumentationKind}from"#channel/compiled-channel.js";import{toErrorMessage}from"#shared/errors.js";import{normalizeChannelDefinition}from"#internal/authored-definition/channel.js";import{ResolveAgentError,createResolvedModuleSourceRef,loadResolvedModuleExport}from"#runtime/resolve-helpers.js";import{HTTP_ADAPTER_KIND}from"#channel/http.js";import{isHttpRouteDefinition,isWebSocketRouteDefinition}from"#channel/routes.js";async function resolveChannelDefinition(r,i,a){try{let t=normalizeChannelDefinition(await loadResolvedModuleExport({definition:r,kindLabel:`channel`,moduleMap:i,nodeId:a}),`Expected the channel export "${r.exportName??`default`}" from "${r.logicalPath}" to match the public Ash shape.`),n=createResolvedModuleSourceRef({exportName:r.exportName,logicalPath:r.logicalPath,sourceId:r.sourceId}),o=t.routes.find(e=>e.method.toUpperCase()===r.method.toUpperCase()&&e.path===r.urlPath),s=`channel:${r.name}`;setChannelInstrumentationKind(t,s);let c=t.adapter;c&&c.kind!==HTTP_ADAPTER_KIND&&(c.kind=s);let l=resolveHttpRoute(r,o),u=resolveWebSocketRoute(r,o);return{name:r.name,method:r.method,urlPath:r.urlPath,fetch:async(e,t)=>l?l.handler(e,t):Response.json({error:`No matching route handler.`,ok:!1},{status:404}),handler:l?.handler,websocket:u?.handler,receive:t.receive,definition:t,adapter:c,...n}}catch(e){throw e instanceof ResolveAgentError?e:new ResolveAgentError(`Failed to attach the channel definition from "${r.logicalPath}": ${toErrorMessage(e)}`,{logicalPath:r.logicalPath,sourceId:r.sourceId})}}function resolveHttpRoute(e,t){if(!(t===void 0||e.method===`WEBSOCKET`||!isHttpRouteDefinition(t)))return t}function resolveWebSocketRoute(e,t){if(!(t===void 0||e.method!==`WEBSOCKET`||!isWebSocketRouteDefinition(t)))return t}export{resolveChannelDefinition};

package/dist/src/runtime/types.d.ts

@@ -3,8 +3,8 @@ import type { ChannelAdapter } from "#channel/adapter.js";
 import type { CompiledChannel } from "#channel/compiled-channel.js";
 import type { HeadersValue } from "#client/types.js";
 import type { DiscoverDiagnosticsSummary } from "#discover/diagnostics.js";
-import type { ChannelMethod, RouteContext } from "#public/definitions/channel.js";
-import type { RouteHandler } from "#channel/routes.js";
+import type { ChannelRouteMethod, RouteContext } from "#public/definitions/channel.js";
+import type { RouteHandler, WebSocketRouteHandler } from "#channel/routes.js";
 import type { OutboundAuthFn } from "#public/agents/auth.js";
 import type { StreamEventHook } from "#public/definitions/hook.js";
 import type { CompactionInput, CompactionHookResult, NeedsApprovalContext, ToolModelOutput } from "#public/definitions/tool.js";
@@ -189,7 +189,7 @@ export interface ResolvedHookDefinition extends ResolvedModuleSourceRef {
  */
 export interface ResolvedChannelDefinition extends ResolvedModuleSourceRef {
     readonly name: string;
-    readonly method: ChannelMethod;
+    readonly method: ChannelRouteMethod;
     readonly adapter?: ChannelAdapter;
     readonly urlPath: string;
     readonly fetch: (req: Request, ctx: RouteContext) => Promise<Response>;
@@ -219,6 +219,11 @@ export interface ResolvedChannelDefinition extends ResolvedModuleSourceRef {
      * dispatch layer uses this instead of `fetch`.
      */
     readonly handler?: RouteHandler;
+    /**
+     * New-style websocket route handler from CompiledChannel. Present only for
+     * routes declared via `WS()`.
+     */
+    readonly websocket?: WebSocketRouteHandler;
 }
 /**
  * Runtime-owned local subagent node resolved from one compiled local

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "experimental-ash",
-  "version": "0.60.0",
+  "version": "0.61.0",
   "description": "Filesystem-first framework for durable backend AI agents that run anywhere.",
   "keywords": [
     "agent-framework",

package/dist/docs/public/channels/attachments.md

@@ -1,71 +0,0 @@
----
-title: "Channel file uploads"
-description: "Deliver inbound file attachments to the agent."
----
-
-This guide explains how channels deliver inbound files to the agent.
-
-## How it works
-
-`send()` accepts `string | UserContent`. To include file attachments,
-pass a `UserContent` array mixing text and file parts:
-
-### Inline bytes
-
-Use for small files where bytes are available in the route handler:
-
-```ts
-await send(
-  [
-    { type: "text", text: body.message },
-    { type: "file", data: imageBytes, mediaType: "image/png" },
-  ],
-  { auth, continuationToken },
-);
-```
-
-### URL-based files with fetchFile
-
-For platforms like Slack where files are behind authenticated URLs,
-put a `URL` object in `FilePart.data` and declare `fetchFile` on the
-channel config:
-
-```ts
-defineChannel({
-  fetchFile(url) {
-    if (!url.startsWith("https://files.slack.com/")) return null;
-    return fetch(url, { headers: { authorization: `Bearer ${token}` } })
-      .then((r) => r.arrayBuffer())
-      .then((b) => ({ bytes: Buffer.from(b) }));
-  },
-
-  routes: [
-    POST("/webhook", async (req, { send }) => {
-      await send(
-        [
-          { type: "text", text: message.text },
-          ...message.attachments.map((a) => ({
-            type: "file" as const,
-            data: new URL(a.url),
-            mediaType: a.mediaType,
-          })),
-        ],
-        { auth, continuationToken, state },
-      );
-    }),
-  ],
-});
-```
-
-The `URL` object survives the queue boundary as a string and is
-reconstituted inside the workflow step. The staging pipeline calls
-`fetchFile(url)` — return bytes to stage the file to the sandbox,
-or return `null` to let the URL pass through to the model provider.
-
-## What the framework handles
-
-- Staging bytes to the sandbox
-- Enforcing upload policy (size and media-type limits)
-- Hydrating files for the model call (inline bytes for images/PDFs, text
-  references for everything else)
-- Reconstituting `URL` objects after queue serialization