experimental-ash 0.27.0 → 0.28.1

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # experimental-ash
 
+## 0.28.1
+
+### Patch Changes
+
+- 9be5b5c: Fix `TypeError: Cannot read properties of undefined (reading 'name')` thrown from `resolveRuntimeAgentNode` on Vercel deployments by splitting `#context/keys.ts` along its layering seam and dropping the rolldown setting that hid the bug.
+
+  A static-import cycle through `BundleKey.codec` (`#context/keys` → `#runtime/sessions/compiled-agent-cache` → `#runtime/resolve-agent-graph` → `#runtime/framework-tools/index` → `#runtime/framework-tools/bash` → `#execution/sandbox/bash-tool` → `#execution/sandbox/require-sandbox` → `#context/keys`) interacted badly with the rolldown build's `topLevelVar: true` setting. When Nitro re-bundled ash's dist into a single concatenated `_libs/experimental-ash.mjs` for a Vercel function, it could land `var BASH_TOOL_DEFINITION = {...}` _after_ the `ALL_FRAMEWORK_TOOLS` array that referenced it. `var` hoisting then silently filled the slot with `undefined` (no TDZ `ReferenceError`), and every downstream `.map(t => t.name)` over that array crashed inside `resolveRuntimeAgentNode`.
+
+  The structural fix: `#context/keys.ts` was doing two unrelated jobs in one file. The leaf job (declaring `SandboxKey`, `SessionKey`, etc.) is widely imported across the codebase. The heavy job (owning the `ChannelKey` and `BundleKey` codecs that materialize values by calling back into the runtime) drags in the entire runtime layer. Because JS evaluates modules whole, every leaf caller was paying the heavy job's transitive import cost, which is how the cycle got seeded.
+
+  - Split `#context/keys.ts` into two files. `#context/keys.ts` now only declares leaf context keys (no codec, no runtime imports — safe to import from any tier). `#runtime/sessions/runtime-context-keys.ts` owns `ChannelKey`, `BundleKey`, and `CompiledBundle` next to the modules whose state they carry.
+  - Drop `topLevelVar: true` from `packages/ash/scripts/build-rolldown.mjs`. The setting was masking module-evaluation cycles; with `let`/`const` they now surface as a loud `ReferenceError` at module load instead of silent `undefined` reads.
+
+## 0.28.0
+
+### Minor Changes
+
+- 2e8ebcb: Add a native Microsoft Teams channel backed by the Bot Framework Activity and Connector protocols, including inbound verification, Teams conversation state, Adaptive Card HITL, proactive receive support, docs, tests, and smoke coverage.
+- 70018bd: Add a native Telegram channel for verified Bot API webhooks, Telegram delivery, HITL interactions, attachments, and proactive sessions.
+
 ## 0.27.0
 
 ### Minor Changes

package/dist/docs/internals/hooks.md

@@ -129,7 +129,7 @@ catches them and emits the recoverable `turn.failed` cascade.
 
 ## `SessionPreparedKey`
 
-Lives in `src/context/seed-keys.ts`. JSON-safe boolean, no codec. Set
+Lives in `src/context/keys.ts`. JSON-safe boolean, no codec. Set
 **before** the `lifecycle.session` chain runs so a thrown hook leaves
 the flag set — the next turn does not retry. Compaction does not clear
 the flag.

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

@@ -1,6 +1,6 @@
 ---
 title: "Channels"
-description: "Deliver your agent over HTTP, Slack, Discord, Twilio, and custom transports."
+description: "Deliver your agent over HTTP, Slack, Discord, Twilio, Telegram, Microsoft Teams, and custom transports."
 url: /channels
 ---
 
@@ -23,7 +23,7 @@ Ash ships the public HTTP protocol as channels:
 - `ashChannel({ auth })` for the built-in Ash protocol channel
 
 Ash also supports authored channels under `agent/channels/` for platform-specific integrations such
-as Slack, Discord, Twilio, or custom webhooks.
+as Slack, Discord, Twilio, Telegram, Microsoft Teams, or custom webhooks.
 
 ## Filesystem Shape
 
@@ -279,6 +279,53 @@ resolver when the allowed phone numbers come from dynamic state. Use `allowFrom:
 
 See [Twilio channel setup](./twilio.md) for webhook URLs, environment variables, and overrides.
 
+## Telegram Channels
+
+Telegram channels are authored with `telegramChannel()`:
+
+```ts
+import { telegramChannel } from "experimental-ash/channels/telegram";
+
+export default telegramChannel({
+  botUsername: "my_bot",
+});
+```
+
+The channel verifies Telegram's `X-Telegram-Bot-Api-Secret-Token` webhook header, accepts updates at
+`/ash/v1/telegram`, dispatches private messages and addressed group messages, and resolves HITL
+inline-keyboard callbacks and ForceReply answers back into Ash input responses. Private chats use
+chat-wide continuation tokens. Group, supergroup, and forum-topic sessions include the chat id,
+optional `message_thread_id`, and a conversation anchor so multiple bot conversations in the same
+chat do not collapse.
+
+Default delivery sends plain text through Telegram `sendMessage` with no `parse_mode`, splits text
+at Telegram's 4096-character limit, and uses best-effort `sendChatAction("typing")` progress
+indicators. Photos and documents are exposed as file parts and fetched through Telegram `getFile`
+when the model needs the bytes.
+
+See [Telegram channel setup](./telegram.md) for webhook registration, environment variables, group
+privacy notes, HITL behavior, attachments, and proactive sessions.
+
+## Microsoft Teams Channels
+
+Teams channels are authored with `teamsChannel()`:
+
+```ts
+import { teamsChannel } from "experimental-ash/channels/teams";
+
+export default teamsChannel();
+```
+
+The channel verifies Bot Connector bearer JWTs, accepts Teams Bot Framework Activity POSTs at
+`/ash/v1/teams`, dispatches personal messages and direct bot mentions, renders HITL prompts as
+Adaptive Cards, and sends agent replies through the Bot Framework Connector REST API. Personal chats
+resume by conversation id; channel and group-chat threads resume by conversation id plus root
+activity id.
+
+Proactive `receive(teams, args)` sessions require an existing conversation reference
+(`serviceUrl` and `conversationId`). See [Microsoft Teams channel setup](./teams.md) for Azure Bot
+setup, environment variables, proactive handoff, HITL, and file options.
+
 ## Cross-Channel Hand-off
 
 Route handlers can start a session on a different channel via `args.receive(channel, ...)`.
@@ -472,6 +519,7 @@ See [Channel file uploads](./attachments.md) for the full guide.
 ## What To Read Next
 
 - [Slack channel setup](./slack.md)
+- [Telegram channel setup](./telegram.md)
 - [Channel file uploads](./attachments.md)
 - [Project Layout](../project-layout.md)
 - [TypeScript API](../typescript-api.md)

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

@@ -132,19 +132,27 @@ Component and modal submissions resume the parked Ash session automatically.
 
 ## Proactive Sessions
 
-Use `receive(discord, args)` from schedules or another channel to start a Discord session:
+Use `receive(discord, { message, args, auth })` from a schedule `run` handler, or
+`args.receive(discord, ...)` from another channel, to start a Discord session:
 
 ```ts
-import { defineSchedule, receive } from "experimental-ash/schedules";
+import { defineSchedule } from "experimental-ash/schedules";
 import discord from "../channels/discord.js";
 
 export default defineSchedule({
   cron: "0 9 * * 1-5",
-  markdown: "Post the daily summary.",
-  channel: receive(discord, {
-    channelId: "123456789012345678",
-    initialMessage: "Daily summary",
-  }),
+  async run({ receive, waitUntil, appAuth }) {
+    waitUntil(
+      receive(discord, {
+        message: "Post the daily summary.",
+        args: {
+          channelId: "123456789012345678",
+          initialMessage: "Daily summary",
+        },
+        auth: appAuth,
+      }),
+    );
+  },
 });
 ```
 

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

@@ -0,0 +1,121 @@
+---
+title: "Microsoft Teams channel setup"
+description: "Create a Microsoft Teams-backed Ash channel with the Bot Framework Activity protocol."
+---
+
+# Microsoft Teams Channel Setup
+
+The Teams channel accepts Bot Framework Activity POSTs from Microsoft Teams, verifies Bot
+Connector bearer JWTs, dispatches message activities to Ash, renders HITL prompts as Adaptive
+Cards, and delivers agent responses through the Bot Framework Connector REST API.
+
+## Add The Channel
+
+Create `agent/channels/teams.ts`:
+
+```ts
+import { teamsChannel } from "experimental-ash/channels/teams";
+
+export default teamsChannel();
+```
+
+Set the credentials Ash needs:
+
+```bash
+MICROSOFT_APP_ID=...
+MICROSOFT_APP_PASSWORD=...
+# Optional for single-tenant bots:
+MICROSOFT_TENANT_ID=...
+```
+
+By default, the channel mounts `POST /ash/v1/teams`. Configure your Azure Bot or Teams app
+messaging endpoint to that public URL.
+
+Use `route` when the bot endpoint needs a different path:
+
+```ts
+export default teamsChannel({
+  route: "/api/teams/activity",
+});
+```
+
+## Message Dispatch
+
+The default `onMessage` behavior dispatches personal-chat messages and channel/group-chat messages
+that directly mention the bot. Ambient messages delivered through Teams resource-specific consent
+are parsed but ignored unless you override `onMessage`.
+
+```ts
+import { teamsChannel, defaultTeamsAuth } from "experimental-ash/channels/teams";
+
+export default teamsChannel({
+  onMessage(ctx, message) {
+    if (message.scope !== "personal" && !message.isBotMentioned) return null;
+    return { auth: defaultTeamsAuth(message) };
+  },
+});
+```
+
+Ash strips the bot mention from channel/group prompts, adds a compact `<teams_context>` block, and
+keeps personal chats scoped to one Ash session per Teams conversation. Channel and group-chat
+threads are scoped by the root activity id (`replyToId ?? id`).
+
+## Delivery And HITL
+
+Default delivery posts Markdown messages with `textFormat: "markdown"`, splits oversized text, and
+sends typing indicators on turn start and action requests. `input.requested` renders Adaptive Cards:
+buttons/options use `Action.Submit`, select requests use `Input.ChoiceSet`, and freeform requests
+use `Input.Text`.
+
+Adaptive Card submit activities are converted into Ash `inputResponses` automatically. Non-HITL
+invoke activities can be handled with `onInvoke(ctx, activity)`.
+
+## Proactive Sessions
+
+Use `receive(teams, args)` only when you already have a Teams conversation reference. Teams v1 does
+not create new chats by AAD user id.
+
+```ts
+import { defineSchedule, receive } from "experimental-ash/schedules";
+import teams from "../channels/teams.js";
+
+export default defineSchedule({
+  cron: "0 9 * * 1-5",
+  markdown: "Post the daily summary.",
+  channel: receive(teams, {
+    serviceUrl: "https://smba.trafficmanager.net/teams",
+    conversationId: "19:...",
+    conversationType: "channel",
+    tenantId: "tenant-id",
+    initialMessage: "Daily summary",
+  }),
+});
+```
+
+For channel/group-chat proactive sessions without `replyToActivityId`, the first posted message
+becomes the thread anchor and the channel re-keys the Ash continuation token to that activity id.
+
+## Files
+
+Text support is enabled by default. Inbound file parts are opt-in:
+
+```ts
+export default teamsChannel({
+  files: {
+    enabled: true,
+    allowedHosts: ["contoso.sharepoint.com"],
+  },
+});
+```
+
+This covers personal-scope Teams file download attachments and simple public media URLs. Graph-based
+channel file retrieval and outbound file-consent upload are intentionally outside v1.
+
+## Teams References
+
+- [Teams conversational bots](https://learn.microsoft.com/en-us/microsoftteams/platform/bots/build-conversational-capability)
+- [Teams channel and group chat bot conversations](https://learn.microsoft.com/en-us/microsoftteams/platform/bots/how-to/conversations/channel-and-group-conversations)
+- [Bot Connector authentication](https://learn.microsoft.com/en-us/azure/bot-service/rest-api/bot-framework-rest-connector-authentication?view=azure-bot-service-4.0)
+- [Bot Connector REST API reference](https://learn.microsoft.com/sr-latn-rs/azure/bot-service/rest-api/bot-framework-rest-connector-api-reference?view=azure-bot-service-4.0)
+- [Teams proactive messages](https://learn.microsoft.com/en-us/microsoftteams/platform/bots/how-to/conversations/send-proactive-messages)
+- [Teams card actions](https://learn.microsoft.com/en-us/microsoftteams/platform/task-modules-and-cards/cards/cards-actions)

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

@@ -0,0 +1,201 @@
+---
+title: "Telegram channel setup"
+description: "Create a Telegram-backed Ash channel for bot webhooks, replies, HITL, and attachments."
+---
+
+# Telegram Channel Setup
+
+The Telegram channel accepts Telegram Bot API webhooks. It verifies Telegram's
+`X-Telegram-Bot-Api-Secret-Token` header before parsing the update, dispatches private messages and
+addressed group messages, and sends default replies through `sendMessage`.
+
+## Add The Channel
+
+Create `agent/channels/telegram.ts`:
+
+```ts
+import { telegramChannel } from "experimental-ash/channels/telegram";
+
+export default telegramChannel({
+  botUsername: "my_bot",
+});
+```
+
+Set the credentials Ash needs for inbound verification and outbound replies:
+
+```bash
+TELEGRAM_BOT_TOKEN=123456:...
+TELEGRAM_WEBHOOK_SECRET_TOKEN=...
+```
+
+- `TELEGRAM_BOT_TOKEN` sends replies, typing indicators, callback acknowledgements, and proactive
+  messages.
+- `TELEGRAM_WEBHOOK_SECRET_TOKEN` must match the `secret_token` value you register with Telegram's
+  `setWebhook`.
+
+You can also pass the same values in config:
+
+```ts
+export default telegramChannel({
+  botUsername: "my_bot",
+  credentials: {
+    botToken: process.env.TELEGRAM_BOT_TOKEN,
+    webhookSecretToken: process.env.TELEGRAM_WEBHOOK_SECRET_TOKEN,
+  },
+});
+```
+
+By default, the channel mounts `POST /ash/v1/telegram`.
+
+## Register The Webhook
+
+Register the deployed public URL with Telegram's Bot API:
+
+```bash
+curl -X POST "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/setWebhook" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "url": "https://your-app.example.com/ash/v1/telegram",
+    "secret_token": "'"$TELEGRAM_WEBHOOK_SECRET_TOKEN"'",
+    "allowed_updates": ["message", "callback_query"]
+  }'
+```
+
+Webhook setup is external to Ash; the runtime does not call `setWebhook` for you.
+
+## Message Dispatch
+
+Private chats dispatch normal text, captions, photos, and documents by default. The default
+`onMessage` derives Telegram user auth, starts a typing indicator, and returns `{ auth }`.
+
+Groups and supergroups are gated more narrowly:
+
+- bot commands dispatch, including `/ask` and `/ask@my_bot`
+- `@my_bot` mentions dispatch when `botUsername` is configured
+- replies to bot messages dispatch
+- unaddressed group chatter is ignored
+
+For Telegram forum topics, the channel includes `message_thread_id` in the continuation token and
+outbound messages so separate topics do not collapse into one session.
+
+Override `onMessage` when you need custom auth or additional filtering:
+
+```ts
+import { telegramChannel } from "experimental-ash/channels/telegram";
+
+export default telegramChannel({
+  botUsername: "my_bot",
+  onMessage(ctx, message) {
+    if (message.chat.type !== "private" && !message.text.includes("@my_bot")) return null;
+    return {
+      auth: {
+        authenticator: "telegram",
+        principalType: "user",
+        principalId: message.from?.id ?? message.chat.id,
+        attributes: {
+          chat_id: message.chat.id,
+          chat_type: message.chat.type,
+        },
+      },
+    };
+  },
+});
+```
+
+Telegram group privacy is controlled by BotFather. With privacy mode enabled, Telegram only sends
+commands, replies, and service messages to the bot. Disable privacy mode only if your bot should see
+all group messages; Ash still applies the group dispatch gate above.
+
+## Delivery
+
+The default `"message.completed"` handler sends plain text with `sendMessage`. Ash does not set
+`parse_mode`, so generated Markdown is delivered as literal text rather than being parsed by
+Telegram. Messages longer than Telegram's 4096-character text limit are split into multiple
+`sendMessage` calls.
+
+Default progress handlers call `sendChatAction` with `typing`. Typing failures are logged and
+swallowed because the indicator is only a UX hint.
+
+Custom event handlers can use `ctx.telegram`:
+
+```ts
+export default telegramChannel({
+  events: {
+    async "message.completed"(event, ctx) {
+      if (event.finishReason === "tool-calls" || !event.message) return;
+      await ctx.telegram.sendMessage(`Result:\n${event.message}`);
+    },
+  },
+});
+```
+
+## Human Input
+
+Pending Ash input requests render in Telegram:
+
+- option requests render as inline keyboard buttons
+- freeform requests render as `ForceReply` prompts
+
+Telegram caps `callback_data` at 64 bytes, so Ash stores compact callback ids in durable channel
+state and remaps them to the original Ash input response when the callback query arrives. Freeform
+answers resume when the user replies to the specific prompt message.
+
+Callback queries generated by Ash are acknowledged with `answerCallbackQuery` automatically. Other
+callback queries are passed to `onCallbackQuery` when you provide one.
+
+## Attachments
+
+Inbound photos and documents become AI SDK file parts with internal `telegram-file:` URLs. When the
+model needs the bytes, the channel calls Telegram `getFile`, downloads the file through the Bot API
+file endpoint, and enforces the channel upload policy.
+
+```ts
+export default telegramChannel({
+  uploadPolicy: {
+    allowedMediaTypes: ["image/*", "application/pdf"],
+    maxBytes: 10 * 1024 * 1024,
+  },
+});
+```
+
+V1 supports inbound photos and documents. Polling, inline mode, payments, business-account updates,
+channel posts, stickers, and outbound sandbox-file sharing are not included.
+
+## Proactive Sessions
+
+Use `receive(telegram, { message, args, auth })` from a schedule `run` handler, or
+`args.receive(telegram, ...)` from another channel, to start a Telegram session:
+
+```ts
+import { defineSchedule } from "experimental-ash/schedules";
+import telegram from "../channels/telegram.js";
+
+export default defineSchedule({
+  cron: "0 9 * * 1-5",
+  async run({ receive, waitUntil, appAuth }) {
+    waitUntil(
+      receive(telegram, {
+        message: "Post the daily summary.",
+        args: {
+          chatId: "123456789",
+          initialMessage: "Daily summary",
+        },
+        auth: appAuth,
+      }),
+    );
+  },
+});
+```
+
+`chatId` is required. Pass `messageThreadId` for forum topics. Pass `conversationId` to resume a
+known group conversation, or `initialMessage` to post an anchor message first; those two options are
+mutually exclusive.
+
+## Telegram References
+
+- [Telegram Bot API](https://core.telegram.org/bots/api)
+- [setWebhook](https://core.telegram.org/bots/api#setwebhook)
+- [sendMessage](https://core.telegram.org/bots/api#sendmessage)
+- [sendChatAction](https://core.telegram.org/bots/api#sendchataction)
+- [answerCallbackQuery](https://core.telegram.org/bots/api#answercallbackquery)
+- [getFile](https://core.telegram.org/bots/api#getfile)

package/dist/docs/public/typescript-api.md

@@ -30,7 +30,9 @@ for `defineAgent`.
 - `defineChannel(...)` - HTTP channel entrypoints in `channels/` with `routes`, `state`, `context()`, and typed event handlers (`experimental-ash/channels`)
 - `defineHook(...)` - lifecycle and stream-event subscriber in `hooks/<slug>.ts` (`experimental-ash/hooks`)
 - `defineSandbox(...)` - override the agent's single sandbox in `sandbox.ts` (or `sandbox/sandbox.ts` when paired with a `workspace/` folder) (`experimental-ash/sandbox`)
-- `defineSchedule(...)` - recurring jobs in `schedules/<name>.ts` or `schedules/<name>.md`; requires `cron` and `markdown`, `channel` is optional (`experimental-ash/schedules`)
+- `defineSchedule(...)` - recurring jobs in `schedules/<name>.ts` or `schedules/<name>.md`;
+  TypeScript schedules require `cron` and exactly one of `markdown` or `run`
+  (`experimental-ash/schedules`)
 - `defineSkill(...)` - module-authored skills (`experimental-ash/skills`)
 - `defineInstructions(...)` - module-authored instructions prompt (`experimental-ash/instructions`)
 - `defineTool(...)` - typed executable integration in `tools/<name>.ts` (`experimental-ash/tools`)
@@ -109,6 +111,43 @@ Channel and Twilio types exported from `experimental-ash/channels/twilio`:
   `confidence`, ...)
 - `verifyTwilioRequest`, `signTwilioRequest` - Ash-owned Twilio webhook signature helpers
 
+Channel and Telegram types exported from `experimental-ash/channels/telegram`:
+
+- `telegramChannel` - Telegram Bot API webhook channel factory for messages, callback queries,
+  HITL, attachments, typing indicators, and proactive sessions
+- `telegramContinuationToken` - helper for the channel-local raw token
+  (`chatId:messageThreadId:conversationId`)
+- `TelegramChannelConfig` - config type for credentials, route, Bot API overrides, upload policy,
+  `botUsername`, hooks, and event handlers
+- `TelegramContext` - pre-dispatch context for `onMessage` and `onCallbackQuery` (`telegram`)
+- `TelegramEventContext` - event-handler context (`telegram`, `session`, plus mutable `state`)
+- `TelegramHandle` - Telegram handle with `request()`, `post()`, `sendMessage()`,
+  `startTyping()`, `answerCallbackQuery()`, and `editMessageReplyMarkup()`
+- `TelegramMessage` - parsed inbound message payload (`text`, `caption`, `chat`, `from`,
+  `attachments`, reply context, ...)
+- `TelegramCallbackQuery` - parsed callback query payload passed to `onCallbackQuery`
+- `TelegramAttachment` - parsed inbound photo or document metadata
+- `TelegramReceiveArgs` - arguments accepted by proactive `receive(telegram, ...)`
+- `verifyTelegramRequest` - Ash-owned webhook secret-token verification helper
+
+Channel and Microsoft Teams types exported from `experimental-ash/channels/teams`:
+
+- `teamsChannel` - Teams channel factory for Bot Framework Activity webhooks and Connector delivery
+- `TeamsChannelConfig` - config type for credentials, route, event handlers, message/invoke hooks,
+  Adaptive Card version, and opt-in file handling
+- `TeamsContext` - pre-dispatch context for `onMessage` and `onInvoke` (`thread`, `teams`)
+- `TeamsEventContext` - event-handler context (`thread`, `teams`, mutable `state`)
+- `TeamsHandle` - low-level Connector handle with `sendActivity`, `replyToActivity`,
+  `updateActivity`, `startTyping`, and `request`
+- `TeamsThread` - conversation-scoped `post`, `update`, `startTyping`, and `mentionUser`
+- `TeamsMessageActivity` / `TeamsInvokeActivity` - parsed inbound Activity payloads
+- `TeamsReceiveArgs` - proactive/cross-channel handoff args requiring `serviceUrl` and
+  `conversationId`
+- `teamsContinuationToken` - channel-local Teams continuation-token helper
+- `defaultTeamsAuth` - default Teams actor-to-session-auth projection
+- `verifyTeamsRequest`, `verifyTeamsJwt` - Ash-owned Bot Connector request/JWT verification helpers
+- `sendTeamsActivity`, `replyToTeamsActivity`, `updateTeamsActivity` - Connector REST helpers
+
 Channel types exported from `experimental-ash/channels`:
 
 - `defineChannel` - channel primitive with `routes`, `state`, `context()`, and event handlers
@@ -138,6 +177,7 @@ import { defineChannel, POST, GET } from "experimental-ash/channels";
 import { ashChannel } from "experimental-ash/channels/ash";
 import { vercelOidc } from "experimental-ash/channels/auth";
 import { slackChannel } from "experimental-ash/channels/slack";
+import { telegramChannel } from "experimental-ash/channels/telegram";
 ```
 
 Inside a route handler, the helpers object exposes:

package/dist/src/channel/adapter.js

@@ -1 +1 @@
-import{createLogger}from"#internal/logging.js";var log=createLogger(`channel.adapter`);function defaultDeliverResult(e){if(e.message!==void 0)return{inputResponses:e.inputResponses,message:e.message,modelContext:e.modelContext};if(e.inputResponses!==void 0&&e.inputResponses.length>0)return{inputResponses:e.inputResponses,modelContext:e.modelContext};if(e.modelContext!==void 0&&e.modelContext.length>0)return{modelContext:e.modelContext}}function getAdapterKind(e){return e.kind}async function callAdapterEventHandler(e,t,n){let r=e[t.type];if(r===void 0)return t;try{await r(`data`in t?t.data:void 0,n)}catch(n){log.error(`adapter event handler threw — event swallowed`,{adapterKind:getAdapterKind(e),eventType:t.type,error:n})}return t}export{callAdapterEventHandler,defaultDeliverResult,getAdapterKind};
+import{createLogger}from"#internal/logging.js";const log=createLogger(`channel.adapter`);function defaultDeliverResult(e){if(e.message!==void 0)return{inputResponses:e.inputResponses,message:e.message,modelContext:e.modelContext};if(e.inputResponses!==void 0&&e.inputResponses.length>0)return{inputResponses:e.inputResponses,modelContext:e.modelContext};if(e.modelContext!==void 0&&e.modelContext.length>0)return{modelContext:e.modelContext}}function getAdapterKind(e){return e.kind}async function callAdapterEventHandler(e,t,n){let r=e[t.type];if(r===void 0)return t;try{await r(`data`in t?t.data:void 0,n)}catch(n){log.error(`adapter event handler threw — event swallowed`,{adapterKind:getAdapterKind(e),eventType:t.type,error:n})}return t}export{callAdapterEventHandler,defaultDeliverResult,getAdapterKind};

package/dist/src/channel/compiled-channel.js

@@ -1 +1 @@
-var CHANNEL_SENTINEL=`ash:channel`;function isCompiledChannel(e){return typeof e==`object`&&!!e&&e.__kind===`ash:channel`}export{CHANNEL_SENTINEL,isCompiledChannel};
+const CHANNEL_SENTINEL=`ash:channel`;function isCompiledChannel(e){return typeof e==`object`&&!!e&&e.__kind===`ash:channel`}export{CHANNEL_SENTINEL,isCompiledChannel};

package/dist/src/channel/http.js

@@ -1 +1 @@
-var HTTP_ADAPTER_KIND=`http`,HTTP_ADAPTER={kind:HTTP_ADAPTER_KIND};export{HTTP_ADAPTER,HTTP_ADAPTER_KIND};
+const HTTP_ADAPTER_KIND=`http`,HTTP_ADAPTER={kind:HTTP_ADAPTER_KIND};export{HTTP_ADAPTER,HTTP_ADAPTER_KIND};

package/dist/src/channel/schedule.js

@@ -1 +1 @@
-import{createSession}from"#channel/session.js";import{createCrossChannelReceiveFn,toCrossChannelTargets}from"#channel/cross-channel-receive.js";import{expectFunction}from"#internal/authored-module.js";var SCHEDULE_APP_AUTH={attributes:{},authenticator:`app`,principalId:`ash:app`,principalType:`runtime`},SCHEDULE_ADAPTER_KIND=`schedule`,SCHEDULE_ADAPTER={kind:SCHEDULE_ADAPTER_KIND},ScheduleDispatcher=class{runtime;channels;constructor(e){this.runtime=e.runtime,this.channels=e.channels}async trigger(e){let r=[],a=[],o=createCrossChannelReceiveFn(this.runtime,toCrossChannelTargets(this.channels)),s={appAuth:SCHEDULE_APP_AUTH,receive:async(e,t)=>{let n=await o(e,t);return r.push(n),n},waitUntil(e){a.push(e)}};if(e.run)await e.run(s);else if(e.markdown!==void 0){let t=await this.runMarkdown(e.markdown);r.push(t)}else throw Error(`Schedule "${e.scheduleId}" has neither "run" nor "markdown" — at least one must be set.`);return{sessions:r,waitUntilTasks:a}}async runMarkdown(t){let n=await this.runtime.run({adapter:SCHEDULE_ADAPTER,auth:SCHEDULE_APP_AUTH,input:{message:t},mode:`task`});return createSession(n.sessionId,n.continuationToken,this.runtime)}};function expectScheduleRun(e,t,n){let i=e;if(typeof i!=`object`||!i)throw Error(`Schedule export "${n??`default`}" from "${t}" must be an object.`);return expectFunction(i.run,`Expected the schedule export "${n??`default`}" from "${t}" to export a \`run\` handler function.`)}export{SCHEDULE_ADAPTER,SCHEDULE_ADAPTER_KIND,SCHEDULE_APP_AUTH,ScheduleDispatcher,expectScheduleRun};
+import{createSession}from"#channel/session.js";import{createCrossChannelReceiveFn,toCrossChannelTargets}from"#channel/cross-channel-receive.js";import{expectFunction}from"#internal/authored-module.js";const SCHEDULE_APP_AUTH={attributes:{},authenticator:`app`,principalId:`ash:app`,principalType:`runtime`},SCHEDULE_ADAPTER_KIND=`schedule`,SCHEDULE_ADAPTER={kind:SCHEDULE_ADAPTER_KIND};var ScheduleDispatcher=class{runtime;channels;constructor(e){this.runtime=e.runtime,this.channels=e.channels}async trigger(e){let r=[],a=[],o=createCrossChannelReceiveFn(this.runtime,toCrossChannelTargets(this.channels)),s={appAuth:SCHEDULE_APP_AUTH,receive:async(e,t)=>{let n=await o(e,t);return r.push(n),n},waitUntil(e){a.push(e)}};if(e.run)await e.run(s);else if(e.markdown!==void 0){let t=await this.runMarkdown(e.markdown);r.push(t)}else throw Error(`Schedule "${e.scheduleId}" has neither "run" nor "markdown" — at least one must be set.`);return{sessions:r,waitUntilTasks:a}}async runMarkdown(t){let n=await this.runtime.run({adapter:SCHEDULE_ADAPTER,auth:SCHEDULE_APP_AUTH,input:{message:t},mode:`task`});return createSession(n.sessionId,n.continuationToken,this.runtime)}};function expectScheduleRun(e,t,n){let i=e;if(typeof i!=`object`||!i)throw Error(`Schedule export "${n??`default`}" from "${t}" must be an object.`);return expectFunction(i.run,`Expected the schedule export "${n??`default`}" from "${t}" to export a \`run\` handler function.`)}export{SCHEDULE_ADAPTER,SCHEDULE_ADAPTER_KIND,SCHEDULE_APP_AUTH,ScheduleDispatcher,expectScheduleRun};

package/dist/src/channel/send.js

@@ -1 +1 @@
-import{createSession}from"#channel/session.js";import{createErrorId,createLogger}from"#internal/logging.js";import{isRuntimeNoActiveSessionError}from"#execution/runtime-errors.js";import{serializeUrlFilePart}from"#internal/attachments/url-refs.js";import{toErrorMessage}from"#shared/errors.js";var log=createLogger(`channel.send`);function createSendFn(n,r,i){return async(a,o)=>{let s=o.auth,c=o.callback,l=o.mode??`conversation`,u=o.state,d=o.continuationToken,f=`${i}:${d}`,{message:p,inputResponses:m,modelContext:h}=normalizeSendInput(a),g=serializeUrlFilePartsInMessage(p);try{let{sessionId:t}=await n.deliver({auth:s,continuationToken:f,payload:{inputResponses:m,message:g,modelContext:h}});return createSession(t,d,n)}catch(e){isRuntimeNoActiveSessionError(e)||log.warn(`deliver failed, falling back to starting a new session`,{continuationToken:f,errorId:createErrorId(),message:toErrorMessage(e)})}if(m&&m.length>0)throw Error(`Cannot deliver inputResponses — the target session was not found via continuation token.`);let _=u?{...r,state:{...r.state,...u}}:r;return createSession((await n.run({adapter:_,auth:s,capabilities:l===`conversation`?{requestInput:!0}:void 0,callback:c,continuationToken:f,input:{message:g??``,modelContext:h},mode:l})).sessionId,d,n)}}function serializeUrlFilePartsInMessage(e){if(e===void 0||typeof e==`string`)return e;let t=!1,n=e.map(e=>e.type===`file`&&e.data instanceof URL&&e.data.protocol!==`data:`?(t=!0,{...e,data:serializeUrlFilePart(e.data)}):e);return t?n:e}function normalizeSendInput(e){return typeof e==`string`||Array.isArray(e)?{message:e}:e}export{createSendFn};
+import{createSession}from"#channel/session.js";import{createErrorId,createLogger}from"#internal/logging.js";import{isRuntimeNoActiveSessionError}from"#execution/runtime-errors.js";import{serializeUrlFilePart}from"#internal/attachments/url-refs.js";import{toErrorMessage}from"#shared/errors.js";const log=createLogger(`channel.send`);function createSendFn(n,r,i){return async(a,o)=>{let s=o.auth,c=o.callback,l=o.mode??`conversation`,u=o.state,d=o.continuationToken,f=`${i}:${d}`,{message:p,inputResponses:m,modelContext:h}=normalizeSendInput(a),g=serializeUrlFilePartsInMessage(p);try{let{sessionId:t}=await n.deliver({auth:s,continuationToken:f,payload:{inputResponses:m,message:g,modelContext:h}});return createSession(t,d,n)}catch(e){isRuntimeNoActiveSessionError(e)||log.warn(`deliver failed, falling back to starting a new session`,{continuationToken:f,errorId:createErrorId(),message:toErrorMessage(e)})}if(m&&m.length>0)throw Error(`Cannot deliver inputResponses — the target session was not found via continuation token.`);let _=u?{...r,state:{...r.state,...u}}:r;return createSession((await n.run({adapter:_,auth:s,capabilities:l===`conversation`?{requestInput:!0}:void 0,callback:c,continuationToken:f,input:{message:g??``,modelContext:h},mode:l})).sessionId,d,n)}}function serializeUrlFilePartsInMessage(e){if(e===void 0||typeof e==`string`)return e;let t=!1,n=e.map(e=>e.type===`file`&&e.data instanceof URL&&e.data.protocol!==`data:`?(t=!0,{...e,data:serializeUrlFilePart(e.data)}):e);return t?n:e}function normalizeSendInput(e){return typeof e==`string`||Array.isArray(e)?{message:e}:e}export{createSendFn};

package/dist/src/channel/session-callback.js

@@ -1 +1 @@
-import{z}from"#compiled/zod/index.js";import{createAshCallbackRoutePath}from"#protocol/routes.js";var sessionCallbackSchema=z.object({callId:z.string().min(1),subagentName:z.string().min(1),token:z.string().min(1),url:z.string().min(1)}).strict().superRefine((e,t)=>{let n;try{n=new URL(e.url)}catch{t.addIssue({code:`custom`,message:`Callback url must be absolute.`,path:[`url`]});return}readCallbackUrlToken(n)!==e.token&&t.addIssue({code:`custom`,message:`Callback url token must match callback token.`,path:[`url`]})});function parseSessionCallback(e){let t=sessionCallbackSchema.safeParse(e);return t.success?{callback:t.data,ok:!0}:{cause:t.error,message:formatSessionCallbackParseError(t.error),ok:!1}}function readCallbackUrlToken(e){let n=createAshCallbackRoutePath(``);if(!e.pathname.startsWith(n))return null;let r=e.pathname.slice(n.length);if(r.length===0||r.includes(`/`))return null;try{return decodeURIComponent(r)}catch{return null}}function formatSessionCallbackParseError(e){return`Invalid callback metadata: ${e.issues.map(e=>`${e.path.length===0?`callback`:`callback.${e.path.join(`.`)}`}: ${e.message}`).join(`; `)}`}export{parseSessionCallback};
+import{z}from"#compiled/zod/index.js";import{createAshCallbackRoutePath}from"#protocol/routes.js";const sessionCallbackSchema=z.object({callId:z.string().min(1),subagentName:z.string().min(1),token:z.string().min(1),url:z.string().min(1)}).strict().superRefine((e,t)=>{let n;try{n=new URL(e.url)}catch{t.addIssue({code:`custom`,message:`Callback url must be absolute.`,path:[`url`]});return}readCallbackUrlToken(n)!==e.token&&t.addIssue({code:`custom`,message:`Callback url token must match callback token.`,path:[`url`]})});function parseSessionCallback(e){let t=sessionCallbackSchema.safeParse(e);return t.success?{callback:t.data,ok:!0}:{cause:t.error,message:formatSessionCallbackParseError(t.error),ok:!1}}function readCallbackUrlToken(e){let n=createAshCallbackRoutePath(``);if(!e.pathname.startsWith(n))return null;let r=e.pathname.slice(n.length);if(r.length===0||r.includes(`/`))return null;try{return decodeURIComponent(r)}catch{return null}}function formatSessionCallbackParseError(e){return`Invalid callback metadata: ${e.issues.map(e=>`${e.path.length===0?`callback`:`callback.${e.path.join(`.`)}`}: ${e.message}`).join(`; `)}`}export{parseSessionCallback};

package/dist/src/channel/session.js

@@ -1 +1 @@
-import{AuthKey,ContinuationTokenKey,InitiatorAuthKey,SessionIdKey}from"#context/seed-keys.js";function createSession(e,t,n){return{id:e,continuationToken:t,async getEventStream(t){return n.getEventStream(e,t)}}}function createGetSessionFn(e){return t=>createSession(t,``,e)}function buildSessionHandle(i){return{get id(){return i.get(SessionIdKey)??``},get continuationToken(){return i.get(ContinuationTokenKey)??``},get auth(){return i.get(AuthKey)??null},get initiatorAuth(){return i.get(InitiatorAuthKey)??null},setContinuationToken(e){let n=i.get(ContinuationTokenKey)??``,r=namespaceContinuationToken(n,e);n!==r&&i.set(ContinuationTokenKey,r)}}}function namespaceContinuationToken(e,t){let n=e.indexOf(`:`);if(n<=0)throw Error(`Cannot set session continuation token without an existing namespaced continuation token. Start the session with a placeholder continuationToken.`);return`${e.slice(0,n+1)}${t}`}export{buildSessionHandle,createGetSessionFn,createSession};
+import{AuthKey,ContinuationTokenKey,InitiatorAuthKey,SessionIdKey}from"#context/keys.js";function createSession(e,t,n){return{id:e,continuationToken:t,async getEventStream(t){return n.getEventStream(e,t)}}}function createGetSessionFn(e){return t=>createSession(t,``,e)}function buildSessionHandle(i){return{get id(){return i.get(SessionIdKey)??``},get continuationToken(){return i.get(ContinuationTokenKey)??``},get auth(){return i.get(AuthKey)??null},get initiatorAuth(){return i.get(InitiatorAuthKey)??null},setContinuationToken(e){let n=i.get(ContinuationTokenKey)??``,r=namespaceContinuationToken(n,e);n!==r&&i.set(ContinuationTokenKey,r)}}}function namespaceContinuationToken(e,t){let n=e.indexOf(`:`);if(n<=0)throw Error(`Cannot set session continuation token without an existing namespaced continuation token. Start the session with a placeholder continuationToken.`);return`${e.slice(0,n+1)}${t}`}export{buildSessionHandle,createGetSessionFn,createSession};

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

@@ -1,3 +1,3 @@
-import{isAshProject}from"../../packages/ash-scaffold/src/project.js";import{SLACK_CHANNEL_DEFAULT_ROUTE,ensureChannel,listAuthoredChannels}from"../../packages/ash-scaffold/src/channels.js";import"../../packages/ash-scaffold/src/index.js";import{relative}from"node:path";import{createInterface}from"node:readline/promises";var NOT_AN_AGENT_MESSAGE="No Ash agent in this directory. Run `pnpm create experimental-ash-agent`, then run this command from inside the new project.",KNOWN_CHANNEL_KINDS=[`slack`];function isChannelKind(e){return KNOWN_CHANNEL_KINDS.includes(e)}function parseChannelKind(e){if(!isChannelKind(e))throw Error(`Unknown channel kind "${e}". Known: ${KNOWN_CHANNEL_KINDS.join(`, `)}.`);return e}async function promptChannelKind(){if(!process.stdin.isTTY||!process.stdout.isTTY)throw Error("Pass a channel kind: `ash channels add slack`.");let e=createInterface({input:process.stdin,output:process.stdout});try{let t=(await e.question(`Channel to add (slack): `)).trim();return t.length===0?`slack`:parseChannelKind(t)}finally{e.close()}}function renderSlackNextSteps(e){return[`Next steps:`,`  pnpm i`,`  vercel deploy --prod`,`  # If Connect returns a different UID, use it below and in agent/channels/slack.ts.`,`  vercel connect create slack --name ${e} --triggers`,`  vercel connect detach slack/${e} --yes`,`  vercel connect attach slack/${e} --triggers --trigger-path ${SLACK_CHANNEL_DEFAULT_ROUTE} --yes`].join(`
+import{isAshProject}from"../../packages/ash-scaffold/src/project.js";import{SLACK_CHANNEL_DEFAULT_ROUTE,ensureChannel,listAuthoredChannels}from"../../packages/ash-scaffold/src/channels.js";import"../../packages/ash-scaffold/src/index.js";import{relative}from"node:path";import{createInterface}from"node:readline/promises";const NOT_AN_AGENT_MESSAGE="No Ash agent in this directory. Run `pnpm create experimental-ash-agent`, then run this command from inside the new project.",KNOWN_CHANNEL_KINDS=[`slack`];function isChannelKind(e){return KNOWN_CHANNEL_KINDS.includes(e)}function parseChannelKind(e){if(!isChannelKind(e))throw Error(`Unknown channel kind "${e}". Known: ${KNOWN_CHANNEL_KINDS.join(`, `)}.`);return e}async function promptChannelKind(){if(!process.stdin.isTTY||!process.stdout.isTTY)throw Error("Pass a channel kind: `ash channels add slack`.");let e=createInterface({input:process.stdin,output:process.stdout});try{let t=(await e.question(`Channel to add (slack): `)).trim();return t.length===0?`slack`:parseChannelKind(t)}finally{e.close()}}function renderSlackNextSteps(e){return[`Next steps:`,`  pnpm i`,`  vercel deploy --prod`,`  # If Connect returns a different UID, use it below and in agent/channels/slack.ts.`,`  vercel connect create slack --name ${e} --triggers`,`  vercel connect detach slack/${e} --yes`,`  vercel connect attach slack/${e} --triggers --trigger-path ${SLACK_CHANNEL_DEFAULT_ROUTE} --yes`].join(`
 `)}function renderExistingSlackChannelNextSteps(e){return[`Next steps:`,`  Review ${e} for the configured Slack connector UID.`,`  Run Vercel Connect commands only for the UID already used by that file.`].join(`
 `)}function formatProjectPath(e,t){let n=relative(e,t);return n.length===0||n.startsWith(`..`)?t:n}function logPackageJsonMutations(e,t,n){for(let r of n.packageJsonUpdated)e.log(`Updated ${formatProjectPath(t,r.path)} with ${r.dependencies.join(`, `)}.`)}function assertUnhandledChannelMutation(e){throw Error(`Unhandled channel mutation result: ${JSON.stringify(e)}`)}async function runChannelsAddCommand(t,r,i){if(!await isAshProject(r)){t.error(NOT_AN_AGENT_MESSAGE),process.exitCode=1;return}try{let e=i.kind===void 0?await promptChannelKind():parseChannelKind(i.kind),a=await ensureChannel({projectRoot:r,kind:e,force:i.options.force});switch(logPackageJsonMutations(t,r,a),a.action){case`created`:t.log(`Scaffolded channel: ${e}`),t.log(renderSlackNextSteps(a.slackConnectorSlug));break;case`overwritten`:t.log(`Overwrote channel: ${e}`),t.log(renderSlackNextSteps(a.slackConnectorSlug));break;case`skipped`:{let n=a.filesSkipped[0];t.log(`Channel "${e}" already exists; left existing files unchanged.`),t.log(renderExistingSlackChannelNextSteps(formatProjectPath(r,n)));break}default:assertUnhandledChannelMutation(a)}}catch(e){t.error(e instanceof Error?e.message:String(e)),process.exitCode=1}}async function runChannelsListCommand(t,n,i){if(!await isAshProject(n)){t.error(NOT_AN_AGENT_MESSAGE),process.exitCode=1;return}let a=await listAuthoredChannels(n);if(i.json){t.log(JSON.stringify({channels:a},null,2));return}if(a.length===0){t.log("No channels defined. Run `ash channels add slack` to add one.");return}for(let e of a)t.log(e)}export{runChannelsAddCommand,runChannelsListCommand};

package/dist/src/cli/dev/environment.js

@@ -1 +1 @@
-import{join,resolve}from"node:path";import{readFileSync}from"node:fs";import{parseEnv}from"node:util";import{isObject}from"#shared/guards.js";var DEVELOPMENT_ENV_FILE_NAMES=[`.env.development.local`,`.env.local`,`.env.development`,`.env`];function isMissingEnvironmentFileError(e){return isObject(e)&&e.code===`ENOENT`}var developmentEnvironmentLoaders=new Map;function getDevelopmentEnvironmentFilePaths(n){let r=resolve(n);return DEVELOPMENT_ENV_FILE_NAMES.map(t=>join(r,t))}function loadDevelopmentEnvironmentFiles(e){getDevelopmentEnvironmentLoader(e).reload()}function getDevelopmentEnvironmentLoader(e){let n=resolve(e),r=developmentEnvironmentLoaders.get(n);if(r!==void 0)return r;let i=createDevelopmentEnvironmentLoader(n);return developmentEnvironmentLoaders.set(n,i),i}function createDevelopmentEnvironmentLoader(e){let t=new Set(Object.keys(process.env)),n=new Map;return{reload(){let r=readDevelopmentEnvironmentValues(e);for(let[e,i]of n)r.has(e)||t.has(e)||(process.env[e]===i&&delete process.env[e],n.delete(e));for(let[e,i]of r)t.has(e)||(process.env[e]=i,n.set(e,i))}}}function readDevelopmentEnvironmentValues(t){let i=new Map;for(let o of[...DEVELOPMENT_ENV_FILE_NAMES].reverse())try{let a=parseEnv(readFileSync(join(t,o),`utf8`));for(let[e,t]of Object.entries(a))t!==void 0&&i.set(e,t)}catch(e){if(!isMissingEnvironmentFileError(e))throw e}return i}export{DEVELOPMENT_ENV_FILE_NAMES,getDevelopmentEnvironmentFilePaths,loadDevelopmentEnvironmentFiles};
+import{join,resolve}from"node:path";import{readFileSync}from"node:fs";import{parseEnv}from"node:util";import{isObject}from"#shared/guards.js";const DEVELOPMENT_ENV_FILE_NAMES=[`.env.development.local`,`.env.local`,`.env.development`,`.env`];function isMissingEnvironmentFileError(e){return isObject(e)&&e.code===`ENOENT`}const developmentEnvironmentLoaders=new Map;function getDevelopmentEnvironmentFilePaths(n){let r=resolve(n);return DEVELOPMENT_ENV_FILE_NAMES.map(t=>join(r,t))}function loadDevelopmentEnvironmentFiles(e){getDevelopmentEnvironmentLoader(e).reload()}function getDevelopmentEnvironmentLoader(e){let n=resolve(e),r=developmentEnvironmentLoaders.get(n);if(r!==void 0)return r;let i=createDevelopmentEnvironmentLoader(n);return developmentEnvironmentLoaders.set(n,i),i}function createDevelopmentEnvironmentLoader(e){let t=new Set(Object.keys(process.env)),n=new Map;return{reload(){let r=readDevelopmentEnvironmentValues(e);for(let[e,i]of n)r.has(e)||t.has(e)||(process.env[e]===i&&delete process.env[e],n.delete(e));for(let[e,i]of r)t.has(e)||(process.env[e]=i,n.set(e,i))}}}function readDevelopmentEnvironmentValues(t){let i=new Map;for(let o of[...DEVELOPMENT_ENV_FILE_NAMES].reverse())try{let a=parseEnv(readFileSync(join(t,o),`utf8`));for(let[e,t]of Object.entries(a))t!==void 0&&i.set(e,t)}catch(e){if(!isMissingEnvironmentFileError(e))throw e}return i}export{DEVELOPMENT_ENV_FILE_NAMES,getDevelopmentEnvironmentFilePaths,loadDevelopmentEnvironmentFiles};

package/dist/src/cli/dev/input-requests.js

@@ -1 +1 @@
-import{renderCliTaggedLine}from"#cli/ui/output.js";import{resolveTextToResponse}from"#channel/resolve-text.js";var ESCAPED_RUNTIME_INPUT_PROMPT=Symbol(`ash.cli.runtime-input.escaped`);function extractPendingRuntimeInputRequests(e){for(let t=e.length-1;t>=0;--t){let n=e[t];if(n?.type===`input.requested`)return n.data.requests}return[]}async function promptForRuntimeInputRequests(t){let n=[];t.print(renderCliTaggedLine(t.theme,{message:`pending input request${t.requests.length===1?``:`s`}: reply now, press Escape, or type "skip" to return to the normal prompt`,tag:`input`,tone:`info`}));for(let e of t.requests){let r=await promptForRuntimeInputRequest({ask:t.ask,print:t.print,request:e,theme:t.theme});if(r.kind!==`submitted`)return r;n.push(r.inputResponse)}return{inputResponses:n,kind:`submitted`}}function isApprovalRequest(e){return e.display===`confirmation`}async function promptForRuntimeInputRequest(e){return isApprovalRequest(e.request)?await promptForApprovalInputRequest({ask:e.ask,print:e.print,request:e.request,theme:e.theme}):await promptForQuestionInputRequest({ask:e.ask,print:e.print,request:e.request,theme:e.theme})}async function promptForApprovalInputRequest(t){for(t.print(renderCliTaggedLine(t.theme,{message:`approve tool "${t.request.action.toolName}"? (yes/no)`,tag:`approval`,tone:`warning`})),t.print(renderCliTaggedLine(t.theme,{message:JSON.stringify(t.request.action.input,null,2),tag:`tool`,tone:`muted`}));;){let r=await t.ask(`approval> `);if(r===void 0)return{kind:`aborted`};if(r===ESCAPED_RUNTIME_INPUT_PROMPT)return{kind:`deferred`};let i=r.trim().toLowerCase();if(i===`skip`||i===`/skip`)return{kind:`deferred`};if(i===`a`||i===`approve`||i===`y`||i===`yes`)return{inputResponse:{optionId:`approve`,requestId:t.request.requestId},kind:`submitted`};if(i===`d`||i===`deny`||i===`n`||i===`no`)return{inputResponse:{optionId:`deny`,requestId:t.request.requestId},kind:`submitted`};t.print(renderCliTaggedLine(t.theme,{message:`enter "yes" to approve, "no" to deny, press Escape, or type "skip" to return to the normal prompt`,tag:`input`,tone:`warning`}))}}async function promptForQuestionInputRequest(r){r.print(renderCliTaggedLine(r.theme,{message:r.request.prompt,tag:`question`,tone:`info`}));for(let[t,n]of(r.request.options??[]).entries())r.print(renderCliTaggedLine(r.theme,{message:`${t+1}. ${n.label}${n.description===void 0?``:` - ${n.description}`}`,tag:`option`,tone:`muted`}));let i=r.request.allowFreeform===!0||(r.request.options?.length??0)===0;for(;;){let a=await r.ask(`answer> `);if(a===void 0)return{kind:`aborted`};if(a===ESCAPED_RUNTIME_INPUT_PROMPT)return{kind:`deferred`};let o=a.trim();if(o===`skip`||o===`/skip`)return{kind:`deferred`};let s=resolveTextToResponse(o,r.request);if(s!==void 0)return{inputResponse:s,kind:`submitted`};r.print(renderCliTaggedLine(r.theme,{message:r.request.options===void 0||r.request.options.length===0?`enter a response, press Escape, or type "skip" to return to the normal prompt`:i?`enter an option number/id, freeform text, press Escape, or type "skip" to return to the normal prompt`:`enter an option number/id, press Escape, or type "skip" to return to the normal prompt`,tag:`input`,tone:`warning`}))}}export{ESCAPED_RUNTIME_INPUT_PROMPT,extractPendingRuntimeInputRequests,promptForRuntimeInputRequests};
+import{renderCliTaggedLine}from"#cli/ui/output.js";import{resolveTextToResponse}from"#channel/resolve-text.js";const ESCAPED_RUNTIME_INPUT_PROMPT=Symbol(`ash.cli.runtime-input.escaped`);function extractPendingRuntimeInputRequests(e){for(let t=e.length-1;t>=0;--t){let n=e[t];if(n?.type===`input.requested`)return n.data.requests}return[]}async function promptForRuntimeInputRequests(t){let n=[];t.print(renderCliTaggedLine(t.theme,{message:`pending input request${t.requests.length===1?``:`s`}: reply now, press Escape, or type "skip" to return to the normal prompt`,tag:`input`,tone:`info`}));for(let e of t.requests){let r=await promptForRuntimeInputRequest({ask:t.ask,print:t.print,request:e,theme:t.theme});if(r.kind!==`submitted`)return r;n.push(r.inputResponse)}return{inputResponses:n,kind:`submitted`}}function isApprovalRequest(e){return e.display===`confirmation`}async function promptForRuntimeInputRequest(e){return isApprovalRequest(e.request)?await promptForApprovalInputRequest({ask:e.ask,print:e.print,request:e.request,theme:e.theme}):await promptForQuestionInputRequest({ask:e.ask,print:e.print,request:e.request,theme:e.theme})}async function promptForApprovalInputRequest(t){for(t.print(renderCliTaggedLine(t.theme,{message:`approve tool "${t.request.action.toolName}"? (yes/no)`,tag:`approval`,tone:`warning`})),t.print(renderCliTaggedLine(t.theme,{message:JSON.stringify(t.request.action.input,null,2),tag:`tool`,tone:`muted`}));;){let r=await t.ask(`approval> `);if(r===void 0)return{kind:`aborted`};if(r===ESCAPED_RUNTIME_INPUT_PROMPT)return{kind:`deferred`};let i=r.trim().toLowerCase();if(i===`skip`||i===`/skip`)return{kind:`deferred`};if(i===`a`||i===`approve`||i===`y`||i===`yes`)return{inputResponse:{optionId:`approve`,requestId:t.request.requestId},kind:`submitted`};if(i===`d`||i===`deny`||i===`n`||i===`no`)return{inputResponse:{optionId:`deny`,requestId:t.request.requestId},kind:`submitted`};t.print(renderCliTaggedLine(t.theme,{message:`enter "yes" to approve, "no" to deny, press Escape, or type "skip" to return to the normal prompt`,tag:`input`,tone:`warning`}))}}async function promptForQuestionInputRequest(r){r.print(renderCliTaggedLine(r.theme,{message:r.request.prompt,tag:`question`,tone:`info`}));for(let[t,n]of(r.request.options??[]).entries())r.print(renderCliTaggedLine(r.theme,{message:`${t+1}. ${n.label}${n.description===void 0?``:` - ${n.description}`}`,tag:`option`,tone:`muted`}));let i=r.request.allowFreeform===!0||(r.request.options?.length??0)===0;for(;;){let a=await r.ask(`answer> `);if(a===void 0)return{kind:`aborted`};if(a===ESCAPED_RUNTIME_INPUT_PROMPT)return{kind:`deferred`};let o=a.trim();if(o===`skip`||o===`/skip`)return{kind:`deferred`};let s=resolveTextToResponse(o,r.request);if(s!==void 0)return{inputResponse:s,kind:`submitted`};r.print(renderCliTaggedLine(r.theme,{message:r.request.options===void 0||r.request.options.length===0?`enter a response, press Escape, or type "skip" to return to the normal prompt`:i?`enter an option number/id, freeform text, press Escape, or type "skip" to return to the normal prompt`:`enter an option number/id, press Escape, or type "skip" to return to the normal prompt`,tag:`input`,tone:`warning`}))}}export{ESCAPED_RUNTIME_INPUT_PROMPT,extractPendingRuntimeInputRequests,promptForRuntimeInputRequests};