eve 0.82.0 → 0.83.1

package/dist/src/public/channels/discord/gateway/connection.d.ts

@@ -0,0 +1,26 @@
+import { type DiscordFetch } from "#public/channels/discord/api.js";
+/** Raised when Discord refuses the bot outright, so reconnecting cannot help. */
+export declare class DiscordGatewayFatalError extends Error {
+}
+/** A Gateway dispatch (op 0) as Discord sends it. */
+export interface DiscordGatewayDispatch {
+    readonly op: 0;
+    readonly t: string;
+    readonly s: number;
+    readonly d: unknown;
+}
+export interface GatewayConnectionOptions {
+    readonly apiBaseUrl?: string;
+    readonly fetch?: DiscordFetch;
+    readonly intents: number;
+    readonly resolveToken: () => Promise<string>;
+    readonly onDispatch: (dispatch: DiscordGatewayDispatch) => void;
+    readonly signal: AbortSignal;
+}
+/**
+ * Holds one Discord Gateway session until `signal` aborts, resuming across
+ * reconnects so dispatches are not lost while the process lives.
+ */
+export declare function runGatewayConnection(options: GatewayConnectionOptions): Promise<void>;
+/** Resolves after `ms`, or as soon as `signal` aborts. */
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;

package/dist/src/public/channels/discord/gateway/connection.js

@@ -0,0 +1 @@
+import{createLogger}from"#internal/logging.js";import{isNonEmptyString,isObject}from"#shared/guards.js";import{callDiscordApi}from"#public/channels/discord/api.js";const log=createLogger(`discord.gateway`),RESUMABLE_CLOSE=4e3,FATAL_CLOSE_CODES=new Set([4004,4010,4011,4012,4013,4014]),SESSION_RESET_CLOSE_CODES=new Set([4007,4009]);var DiscordGatewayFatalError=class extends Error{};async function runGatewayConnection(e){let t,n=null,r=0,i;for(;!e.signal.aborted;){let a,o;try{if(a=await e.resolveToken(),t!==void 0)o=t.resumeUrl;else{let e=await discoverGatewayUrl(a);if(`fatal`in e)throw new DiscordGatewayFatalError(e.fatal);o=e.url}}catch(t){if(t instanceof DiscordGatewayFatalError)throw t;log.warn(`Discord Gateway connect failed`,{error:t}),await sleep(backoff(r++),e.signal);continue}if(e.signal.aborted)return;let s=await connect(o,a);if(e.signal.aborted)return;if(FATAL_CLOSE_CODES.has(s.code))throw new DiscordGatewayFatalError(`Discord closed the Gateway with ${s.code} (${s.reason}). Check the bot token and that every requested intent is enabled under Bot in the Discord Developer Portal.`);SESSION_RESET_CLOSE_CODES.has(s.code)&&(t=void 0,n=null);let c=i??backoff(r++);i=void 0,log.warn(`Discord Gateway closed`,{code:s.code,reason:s.reason,retryInMs:Math.round(c)}),await sleep(c,e.signal)}async function discoverGatewayUrl(t){let n=await callDiscordApi({apiBaseUrl:e.apiBaseUrl,botToken:t,fetch:e.fetch,method:`GET`,path:`/gateway/bot`});if(n.status===401)return{fatal:`Discord rejected the bot token while looking up the Gateway URL.`};if(!n.ok||!isObject(n.body)||!isNonEmptyString(n.body.url))throw Error(`Discord Gateway URL lookup failed with HTTP ${n.status}.`);return{url:n.body.url}}function connect(r,a){return new Promise(o=>{let s=new URL(r);s.searchParams.set(`v`,`10`),s.searchParams.set(`encoding`,`json`);let c=new WebSocket(s),l,u,d=!0,f=!1,settle=(t,n)=>{f||(f=!0,clearTimeout(l),clearTimeout(u),e.signal.removeEventListener(`abort`,onAbort),o({code:t,reason:n}))},send=e=>{c.readyState===WebSocket.OPEN&&c.send(JSON.stringify(e))},close=(e,t)=>{c.readyState!==WebSocket.CLOSING&&c.readyState!==WebSocket.CLOSED&&(c.close(e,t),u=setTimeout(()=>settle(e,t),3e3))},onAbort=()=>close(1e3,`shutdown`);e.signal.addEventListener(`abort`,onAbort,{once:!0});let heartbeat=e=>{if(!d){close(RESUMABLE_CLOSE,`heartbeat not acknowledged`);return}d=!1,send({op:1,d:n}),l=setTimeout(()=>heartbeat(e),e)},identifyOrResume=()=>{if(t!==void 0&&n!==null){send({op:6,d:{seq:n,session_id:t.id,token:a}});return}send({op:2,d:{intents:e.intents,properties:{browser:`eve`,device:`eve`,os:process.platform},token:a}})};c.addEventListener(`message`,e=>{if(f)return;let r;try{r=JSON.parse(String(e.data))}catch{log.warn(`Discord Gateway sent a payload that is not JSON`);return}switch(typeof r.s==`number`&&(n=r.s),r.op){case 0:onDispatch(r);return;case 1:send({op:1,d:n});return;case 7:i=0,close(RESUMABLE_CLOSE,`reconnect requested`);return;case 9:r.d!==!0&&(t=void 0,n=null),i=1e3+Math.random()*4e3,close(RESUMABLE_CLOSE,`invalid session`);return;case 10:{let e=Number(isObject(r.d)?r.d.heartbeat_interval:void 0);l=setTimeout(()=>heartbeat(e),e*Math.random()),identifyOrResume();return}case 11:d=!0;return}}),c.addEventListener(`close`,e=>settle(e.code,e.reason))})}function onDispatch(i){if(i.t===`READY`){let e=isObject(i.d)?i.d:{};isNonEmptyString(e.session_id)&&isNonEmptyString(e.resume_gateway_url)&&(t={id:e.session_id,resumeUrl:e.resume_gateway_url}),r=0,log.info(`Discord Gateway ready`,{sessionId:t?.id});return}if(i.t===`RESUMED`){r=0,log.info(`Discord Gateway resumed`,{sequence:n});return}typeof i.t==`string`&&typeof i.s==`number`&&e.onDispatch({d:i.d,op:0,s:i.s,t:i.t})}}function backoff(e){return Math.min(6e4,1e3*2**e)*(.5+Math.random()/2)}function sleep(e,t){return new Promise(n=>{let r=setTimeout(done,e);t?.addEventListener(`abort`,done,{once:!0});function done(){clearTimeout(r),t?.removeEventListener(`abort`,done),n()}})}export{DiscordGatewayFatalError,runGatewayConnection,sleep};

package/dist/src/public/channels/discord/gateway/forwarder.d.ts

@@ -0,0 +1,14 @@
+import type { DiscordGatewayDispatch } from "#public/channels/discord/gateway/connection.js";
+export interface Forwarder {
+    enqueue(dispatch: DiscordGatewayDispatch): void;
+    /** Resolves once the backlog is delivered or `timeoutMs` elapses. */
+    drain(timeoutMs: number): Promise<void>;
+}
+/**
+ * Delivers dispatches to eve one at a time, in Gateway order. A bounded
+ * backlog keeps a long eve outage from growing the relay's memory without limit.
+ */
+export declare function createForwarder(options: {
+    readonly url: URL;
+    readonly headers: () => Promise<Readonly<Record<string, string>>>;
+}): Forwarder;

package/dist/src/public/channels/discord/gateway/forwarder.js

@@ -0,0 +1 @@
+import{createLogger}from"#internal/logging.js";import{sleep}from"#public/channels/discord/gateway/connection.js";const log=createLogger(`discord.gateway`),UNSENT_ERROR_CODES=new Set([`ECONNREFUSED`,`ENOTFOUND`,`EAI_AGAIN`,`UND_ERR_CONNECT_TIMEOUT`]);function createForwarder(e){let t=Promise.resolve(),n=0;return{enqueue(e){if(n>=500){log.error(`Discord Gateway backlog is full; dropped a dispatch`,{event:e.t,sequence:e.s});return}n+=1,t=t.then(()=>deliver(e)).finally(()=>{--n})},async drain(e){if(n>0){let n=new AbortController;await Promise.race([t,sleep(e,n.signal)]),n.abort()}n>0&&log.warn(`Discord Gateway relay stopped with undelivered dispatches`,{pending:n})}};async function deliver(t){let n=JSON.stringify(t),r={event:t.t,sequence:t.s};for(let t=1;t<=5;t+=1){try{let i=await fetch(e.url,{body:n,headers:{"content-type":`application/json`,...await e.headers()},method:`POST`,signal:AbortSignal.timeout(3e4)});if(i.ok)return;let a=(await i.text()).slice(0,200);if(i.status>=500){log.error(`Gave up forwarding a Discord dispatch that eve may have received`,{...r,detail:a,status:i.status});return}if(i.status!==429){log.error(`eve rejected a forwarded Discord dispatch`,{...r,detail:a,hint:i.status===401||i.status===403?`eve did not accept the relay's credentials. On Vercel, check that the relay runs in the same project as the agent.`:`Check that ${e.url.href} is the agent's discordChannel({ gateway }) route.`,status:i.status});return}log.warn(`Retrying a forwarded Discord dispatch`,{...r,attempt:t,detail:a,status:i.status})}catch(e){if(!UNSENT_ERROR_CODES.has(errorCode(e))){log.error(`Gave up forwarding a Discord dispatch that eve may have received`,{...r,error:e});return}log.warn(`Retrying a forwarded Discord dispatch`,{...r,attempt:t,error:e})}t<5&&await sleep(Math.min(3e4,1e3*2**(t-1)))}log.error(`Gave up forwarding a Discord dispatch`,{...r,attempts:5})}}function errorCode(e){let t=(e instanceof Error?e.cause:void 0)?.code;return typeof t==`string`?t:``}export{createForwarder};

package/dist/src/public/channels/discord/gateway/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * A long-running relay that holds a Discord Gateway connection and forwards
+ * message dispatches to an eve agent's `discordChannel({ gateway })` route.
+ * Run it in a process that stays up, such as a Vercel Daemon; it does not
+ * belong in the agent itself.
+ */
+import { type OutboundAuthFn } from "#public/agents/auth.js";
+import { type DiscordApiOptions, type DiscordBotToken } from "#public/channels/discord/api.js";
+import { DiscordGatewayFatalError } from "#public/channels/discord/gateway/connection.js";
+export { DiscordGatewayFatalError };
+/** Options for {@link experimental_runDiscordGatewayRelay}. */
+export interface DiscordGatewayRelayOptions {
+    /**
+     * Bot credentials. Pass the same object as the agent's `discordChannel`,
+     * such as `connectDiscordCredentials(...)`. `botToken` falls back to
+     * `DISCORD_BOT_TOKEN`.
+     */
+    readonly credentials?: {
+        readonly botToken?: DiscordBotToken;
+    };
+    /** Discord REST API overrides. */
+    readonly api?: Omit<DiscordApiOptions, "credentials">;
+    /**
+     * Base URL of the eve deployment. Defaults to
+     * `https://$VERCEL_PROJECT_PRODUCTION_URL`, which a Vercel Daemon has. Set it
+     * to `http://localhost:<port>` to relay to `eve dev`.
+     */
+    readonly url?: string | URL;
+    /** Path of the agent's Gateway route. Defaults to `/eve/v1/discord/gateway`. */
+    readonly route?: string;
+    /**
+     * Headers that authenticate each forwarded dispatch. Defaults to this
+     * project's Vercel OIDC token, which the route accepts by default. Without a
+     * token, as on a laptop, requests go out unauthenticated, which `eve dev`
+     * accepts.
+     */
+    readonly auth?: OutboundAuthFn;
+    /**
+     * Also request the privileged Message Content intent, so messages that do
+     * not mention the bot, such as thread follow-ups, arrive with their text.
+     * Enable it under Bot in the Discord Developer Portal first, or Discord
+     * refuses the connection.
+     */
+    readonly messageContent?: boolean;
+    /** Stops the relay. Defaults to the process's `SIGTERM` and `SIGINT`. */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Connects to the Discord Gateway as the bot and forwards every
+ * `MESSAGE_CREATE` dispatch, unchanged and in order, to the agent's
+ * `discordChannel({ gateway })` route. Reconnects and resumes on its own.
+ * Resolves after `signal` aborts and in-flight deliveries drain; rejects with
+ * {@link DiscordGatewayFatalError} when Discord refuses the bot's token or
+ * intents.
+ *
+ * Run exactly one relay per bot: Discord sends every message to each
+ * connection, so a second relay makes the agent answer twice.
+ */
+export declare function experimental_runDiscordGatewayRelay(options?: DiscordGatewayRelayOptions): Promise<void>;

package/dist/src/public/channels/discord/gateway/index.js

@@ -0,0 +1 @@
+import{createLogger}from"#internal/logging.js";import{resolveDiscordBotToken}from"#public/channels/discord/api.js";import{DiscordGatewayFatalError,runGatewayConnection}from"#public/channels/discord/gateway/connection.js";import{vercelOidc}from"#public/agents/auth.js";import{createForwarder}from"#public/channels/discord/gateway/forwarder.js";const log=createLogger(`discord.gateway`);async function experimental_runDiscordGatewayRelay(e={}){let t=new URL(e.route??`/eve/v1/discord/gateway`,resolveBaseUrl(e.url)),n=e.signal===void 0?listenForShutdown():void 0,r=e.signal??n.signal,i=createForwarder({headers:outboundHeaders(e.auth),url:t});log.info(`Discord Gateway relay started`,{target:t.href});try{await runGatewayConnection({apiBaseUrl:e.api?.apiBaseUrl,fetch:e.api?.fetch,intents:4608|(e.messageContent===!0?32768:0),onDispatch:e=>{e.t===`MESSAGE_CREATE`&&i.enqueue(e)},resolveToken:()=>resolveDiscordBotToken(e.credentials?.botToken),signal:r})}finally{n?.dispose(),await i.drain(8e3)}}function resolveBaseUrl(e){if(e!==void 0)return new URL(e);let t=process.env.VERCEL_PROJECT_PRODUCTION_URL?.trim();if(t)return new URL(`https://${t}`);throw Error("experimental_runDiscordGatewayRelay needs the eve deployment's URL: pass `url`, such as http://localhost:2000 for eve dev, or run it where VERCEL_PROJECT_PRODUCTION_URL is set.")}function outboundHeaders(e){if(e!==void 0)return async()=>(await e()).headers;let t=vercelOidc(),n=!1;return async()=>{try{return(await t()).headers}catch(e){return n||(n=!0,log.warn(`No Vercel OIDC token; forwarding without credentials`,{error:e})),{}}}}function listenForShutdown(){let e=new AbortController,t=[`SIGTERM`,`SIGINT`],onSignal=t=>{log.info(`Discord Gateway relay shutting down`,{signal:t}),e.abort()};for(let e of t)process.once(e,onSignal);return{signal:e.signal,dispose:()=>{for(let e of t)process.off(e,onSignal)}}}export{DiscordGatewayFatalError,experimental_runDiscordGatewayRelay};

package/dist/src/public/channels/discord/inbound.d.ts

@@ -101,15 +101,18 @@ export interface DiscordModalSubmitInteraction extends DiscordInteractionBase {
 export type DiscordInteraction = DiscordCommandInteraction | DiscordComponentInteraction | DiscordModalSubmitInteraction;
 /**
  * Fields rendered into the model-visible `<discord_context>` block by
- * {@link formatDiscordContextBlock}. The optional fields (username, guildId,
- * commandName) are omitted from the block when not provided.
+ * {@link formatDiscordContextBlock}. Optional fields are omitted from the
+ * block when not provided.
  */
 export interface DiscordInboundContext {
     readonly applicationId?: string;
     readonly channelId: string;
     readonly commandName?: string;
     readonly guildId?: string;
-    readonly interactionId: string;
+    /** Set for interactions such as slash commands. */
+    readonly interactionId?: string;
+    /** Set for ordinary messages forwarded from the Discord Gateway. */
+    readonly messageId?: string;
     readonly userId: string;
     readonly username?: string;
 }
@@ -119,3 +122,7 @@ export declare function parseDiscordInteraction(value: unknown): DiscordInteract
 export declare function commandInteractionMessage(interaction: DiscordCommandInteraction): string;
 /** Renders one {@link DiscordInboundContext} as a deterministic context block. */
 export declare function formatDiscordContextBlock(context: DiscordInboundContext): string;
+/** Parses a raw Discord user object, as interactions and Gateway messages carry it. */
+export declare function parseDiscordUser(value: unknown): DiscordUser | null;
+/** Parses a raw Discord attachment object, as Gateway messages and resolved command data carry it. */
+export declare function parseDiscordAttachment(raw: unknown): DiscordAttachment | null;

package/dist/src/public/channels/discord/inbound.js

@@ -1,2 +1,2 @@
-import{isNonEmptyString,isObject}from"#shared/guards.js";const DISCORD_INTERACTION_TYPE={APPLICATION_COMMAND:2,MESSAGE_COMPONENT:3,MODAL_SUBMIT:5,PING:1},DISCORD_INTERACTION_RESPONSE_TYPE={CHANNEL_MESSAGE_WITH_SOURCE:4,DEFERRED_CHANNEL_MESSAGE_WITH_SOURCE:5,DEFERRED_UPDATE_MESSAGE:6,MODAL:9,PONG:1},DISCORD_EPHEMERAL_MESSAGE_FLAG=64;function parseDiscordInteraction(e){if(!isObject(e))return null;let t=e.type;return t===DISCORD_INTERACTION_TYPE.APPLICATION_COMMAND?parseCommandInteraction(e):t===DISCORD_INTERACTION_TYPE.MESSAGE_COMPONENT?parseComponentInteraction(e):t===DISCORD_INTERACTION_TYPE.MODAL_SUBMIT?parseModalSubmitInteraction(e):null}function commandInteractionMessage(e){let t=findOptionValue(e.options,`message`);if(typeof t==`string`&&t.trim().length>0)return t;let n=formatCommandOptions(e.options);return n?`/${e.commandName} ${n}`:`/${e.commandName}`}function formatDiscordContextBlock(e){return[`<discord_context>`,`response_medium: discord`,`response_instructions: Reply for Discord in concise Markdown. Avoid mass mentions, long tables, and messages that need more than a few short posts.`,...e.applicationId?[`application_id: ${e.applicationId}`]:[],`user_id: ${e.userId}`,...e.username?[`username: ${e.username}`]:[],`channel_id: ${e.channelId}`,...e.guildId?[`guild_id: ${e.guildId}`]:[],`interaction_id: ${e.interactionId}`,...e.commandName?[`command_name: ${e.commandName}`]:[],`</discord_context>`].join(`
-`)}function parseCommandInteraction(e){let t=parseInteractionBase(e),n=isObject(e.data)?e.data:null;if(!t||!n||!isNonEmptyString(n.name))return null;let r=parseOptions(n.options);return{...t,attachments:resolveAttachments(r,n.resolved),commandId:isNonEmptyString(n.id)?n.id:void 0,commandName:n.name,options:r,type:DISCORD_INTERACTION_TYPE.APPLICATION_COMMAND}}function parseComponentInteraction(e){let t=parseInteractionBase(e),n=isObject(e.data)?e.data:null,r=isObject(e.message)?e.message:null;if(!t||!n||!isNonEmptyString(n.custom_id))return null;let i=isNonEmptyString(r?.id)?r.id:``;return i?{...t,componentType:typeof n.component_type==`number`?n.component_type:0,customId:n.custom_id,messageId:i,type:DISCORD_INTERACTION_TYPE.MESSAGE_COMPONENT,values:Array.isArray(n.values)?n.values.filter(e=>typeof e==`string`):[]}:null}function parseModalSubmitInteraction(e){let t=parseInteractionBase(e),n=isObject(e.data)?e.data:null;if(!t||!n||!isNonEmptyString(n.custom_id))return null;let r=isObject(e.message)?e.message:null;return{...t,customId:n.custom_id,messageId:isNonEmptyString(r?.id)?r.id:void 0,textInputs:parseTextInputs(n.components),type:DISCORD_INTERACTION_TYPE.MODAL_SUBMIT}}function parseInteractionBase(e){if(!isNonEmptyString(e.id)||!isNonEmptyString(e.application_id)||!isNonEmptyString(e.channel_id)||!isNonEmptyString(e.token))return null;let t=parseInteractionUser(e);if(!t)return null;let n=isObject(e.channel)?e.channel:void 0;return{applicationId:e.application_id,channelId:e.channel_id,channelType:typeof n?.type==`number`?n.type:void 0,guildId:isNonEmptyString(e.guild_id)?e.guild_id:void 0,id:e.id,member:parseMember(e.member),raw:e,token:e.token,user:t}}function parseInteractionUser(e){return parseUser(e.user)||(parseMember(e.member)?.user??null)}function parseMember(e){if(!isObject(e))return;let t=parseUser(e.user);if(t)return{nick:isNonEmptyString(e.nick)?e.nick:void 0,roles:Array.isArray(e.roles)?e.roles.filter(e=>typeof e==`string`):[],user:t}}function parseUser(e){return!isObject(e)||!isNonEmptyString(e.id)||!isNonEmptyString(e.username)?null:{avatar:isNonEmptyString(e.avatar)?e.avatar:void 0,discriminator:isNonEmptyString(e.discriminator)?e.discriminator:void 0,globalName:isNonEmptyString(e.global_name)?e.global_name:void 0,id:e.id,isBot:e.bot===!0,username:e.username}}function parseOptions(e){if(!Array.isArray(e))return[];let t=[];for(let n of e){if(!isObject(n)||!isNonEmptyString(n.name))continue;let e={name:n.name,options:parseOptions(n.options),type:typeof n.type==`number`?n.type:void 0,value:parseOptionValue(n.value)};t.push(e)}return t}function resolveAttachments(e,t){let n=isObject(t)&&isObject(t.attachments)?t.attachments:void 0;return n===void 0?[]:attachmentOptionIds(e).flatMap(e=>{let t=n[e];return!isObject(t)||!isNonEmptyString(t.url)||!isNonEmptyString(t.filename)?[]:[{contentType:isNonEmptyString(t.content_type)?t.content_type:void 0,filename:t.filename,id:e,size:typeof t.size==`number`?t.size:void 0,url:t.url}]})}function attachmentOptionIds(e){return e.flatMap(e=>[...e.type===11&&typeof e.value==`string`?[e.value]:[],...attachmentOptionIds(e.options)])}function parseOptionValue(e){if(typeof e==`string`||typeof e==`number`||typeof e==`boolean`)return e}function parseTextInputs(e){let t={};if(!Array.isArray(e))return t;for(let n of e)if(isObject(n)&&Array.isArray(n.components))for(let e of n.components)isObject(e)&&isNonEmptyString(e.custom_id)&&typeof e.value==`string`&&(t[e.custom_id]=e.value);return t}function findOptionValue(e,t){for(let n of e){if(n.name===t&&n.value!==void 0)return n.value;let e=findOptionValue(n.options,t);if(e!==void 0)return e}}function formatCommandOptions(e){return e.map(formatOption).filter(e=>e.length>0).join(` `)}function formatOption(e){if(e.type===11)return``;if(e.value!==void 0)return`${e.name}:${String(e.value)}`;let t=formatCommandOptions(e.options);return t?`${e.name} ${t}`:e.name}export{DISCORD_EPHEMERAL_MESSAGE_FLAG,DISCORD_INTERACTION_RESPONSE_TYPE,DISCORD_INTERACTION_TYPE,commandInteractionMessage,formatDiscordContextBlock,parseDiscordInteraction};
+import{isNonEmptyString,isObject}from"#shared/guards.js";const DISCORD_INTERACTION_TYPE={APPLICATION_COMMAND:2,MESSAGE_COMPONENT:3,MODAL_SUBMIT:5,PING:1},DISCORD_INTERACTION_RESPONSE_TYPE={CHANNEL_MESSAGE_WITH_SOURCE:4,DEFERRED_CHANNEL_MESSAGE_WITH_SOURCE:5,DEFERRED_UPDATE_MESSAGE:6,MODAL:9,PONG:1},DISCORD_EPHEMERAL_MESSAGE_FLAG=64;function parseDiscordInteraction(e){if(!isObject(e))return null;let t=e.type;return t===DISCORD_INTERACTION_TYPE.APPLICATION_COMMAND?parseCommandInteraction(e):t===DISCORD_INTERACTION_TYPE.MESSAGE_COMPONENT?parseComponentInteraction(e):t===DISCORD_INTERACTION_TYPE.MODAL_SUBMIT?parseModalSubmitInteraction(e):null}function commandInteractionMessage(e){let t=findOptionValue(e.options,`message`);if(typeof t==`string`&&t.trim().length>0)return t;let n=formatCommandOptions(e.options);return n?`/${e.commandName} ${n}`:`/${e.commandName}`}function formatDiscordContextBlock(e){return[`<discord_context>`,`response_medium: discord`,`response_instructions: Reply for Discord in concise Markdown. Avoid mass mentions, long tables, and messages that need more than a few short posts.`,...e.applicationId?[`application_id: ${e.applicationId}`]:[],`user_id: ${e.userId}`,...e.username?[`username: ${e.username}`]:[],`channel_id: ${e.channelId}`,...e.guildId?[`guild_id: ${e.guildId}`]:[],...e.interactionId?[`interaction_id: ${e.interactionId}`]:[],...e.messageId?[`message_id: ${e.messageId}`]:[],...e.commandName?[`command_name: ${e.commandName}`]:[],`</discord_context>`].join(`
+`)}function parseCommandInteraction(e){let t=parseInteractionBase(e),n=isObject(e.data)?e.data:null;if(!t||!n||!isNonEmptyString(n.name))return null;let r=parseOptions(n.options);return{...t,attachments:resolveAttachments(r,n.resolved),commandId:isNonEmptyString(n.id)?n.id:void 0,commandName:n.name,options:r,type:DISCORD_INTERACTION_TYPE.APPLICATION_COMMAND}}function parseComponentInteraction(e){let t=parseInteractionBase(e),n=isObject(e.data)?e.data:null,r=isObject(e.message)?e.message:null;if(!t||!n||!isNonEmptyString(n.custom_id))return null;let i=isNonEmptyString(r?.id)?r.id:``;return i?{...t,componentType:typeof n.component_type==`number`?n.component_type:0,customId:n.custom_id,messageId:i,type:DISCORD_INTERACTION_TYPE.MESSAGE_COMPONENT,values:Array.isArray(n.values)?n.values.filter(e=>typeof e==`string`):[]}:null}function parseModalSubmitInteraction(e){let t=parseInteractionBase(e),n=isObject(e.data)?e.data:null;if(!t||!n||!isNonEmptyString(n.custom_id))return null;let r=isObject(e.message)?e.message:null;return{...t,customId:n.custom_id,messageId:isNonEmptyString(r?.id)?r.id:void 0,textInputs:parseTextInputs(n.components),type:DISCORD_INTERACTION_TYPE.MODAL_SUBMIT}}function parseInteractionBase(e){if(!isNonEmptyString(e.id)||!isNonEmptyString(e.application_id)||!isNonEmptyString(e.channel_id)||!isNonEmptyString(e.token))return null;let t=parseInteractionUser(e);if(!t)return null;let n=isObject(e.channel)?e.channel:void 0;return{applicationId:e.application_id,channelId:e.channel_id,channelType:typeof n?.type==`number`?n.type:void 0,guildId:isNonEmptyString(e.guild_id)?e.guild_id:void 0,id:e.id,member:parseMember(e.member),raw:e,token:e.token,user:t}}function parseInteractionUser(e){return parseDiscordUser(e.user)||(parseMember(e.member)?.user??null)}function parseMember(e){if(!isObject(e))return;let t=parseDiscordUser(e.user);if(t)return{nick:isNonEmptyString(e.nick)?e.nick:void 0,roles:Array.isArray(e.roles)?e.roles.filter(e=>typeof e==`string`):[],user:t}}function parseDiscordUser(e){return!isObject(e)||!isNonEmptyString(e.id)||!isNonEmptyString(e.username)?null:{avatar:isNonEmptyString(e.avatar)?e.avatar:void 0,discriminator:isNonEmptyString(e.discriminator)?e.discriminator:void 0,globalName:isNonEmptyString(e.global_name)?e.global_name:void 0,id:e.id,isBot:e.bot===!0,username:e.username}}function parseOptions(e){if(!Array.isArray(e))return[];let t=[];for(let n of e){if(!isObject(n)||!isNonEmptyString(n.name))continue;let e={name:n.name,options:parseOptions(n.options),type:typeof n.type==`number`?n.type:void 0,value:parseOptionValue(n.value)};t.push(e)}return t}function resolveAttachments(e,t){let n=isObject(t)&&isObject(t.attachments)?t.attachments:void 0;return n===void 0?[]:attachmentOptionIds(e).flatMap(e=>{let t=parseDiscordAttachment({...isObject(n[e])?n[e]:{},id:e});return t?[t]:[]})}function parseDiscordAttachment(e){return!isObject(e)||!isNonEmptyString(e.id)||!isNonEmptyString(e.url)||!isNonEmptyString(e.filename)?null:{contentType:isNonEmptyString(e.content_type)?e.content_type:void 0,filename:e.filename,id:e.id,size:typeof e.size==`number`?e.size:void 0,url:e.url}}function attachmentOptionIds(e){return e.flatMap(e=>[...e.type===11&&typeof e.value==`string`?[e.value]:[],...attachmentOptionIds(e.options)])}function parseOptionValue(e){if(typeof e==`string`||typeof e==`number`||typeof e==`boolean`)return e}function parseTextInputs(e){let t={};if(!Array.isArray(e))return t;for(let n of e)if(isObject(n)&&Array.isArray(n.components))for(let e of n.components)isObject(e)&&isNonEmptyString(e.custom_id)&&typeof e.value==`string`&&(t[e.custom_id]=e.value);return t}function findOptionValue(e,t){for(let n of e){if(n.name===t&&n.value!==void 0)return n.value;let e=findOptionValue(n.options,t);if(e!==void 0)return e}}function formatCommandOptions(e){return e.map(formatOption).filter(e=>e.length>0).join(` `)}function formatOption(e){if(e.type===11)return``;if(e.value!==void 0)return`${e.name}:${String(e.value)}`;let t=formatCommandOptions(e.options);return t?`${e.name} ${t}`:e.name}export{DISCORD_EPHEMERAL_MESSAGE_FLAG,DISCORD_INTERACTION_RESPONSE_TYPE,DISCORD_INTERACTION_TYPE,commandInteractionMessage,formatDiscordContextBlock,parseDiscordAttachment,parseDiscordInteraction,parseDiscordUser};

package/dist/src/public/channels/discord/index.d.ts

@@ -17,7 +17,8 @@ export interface DiscordInstrumentationMetadata extends Record<string, unknown>
 }
 export { discordChannel, type DiscordChannel, type DiscordChannelConfig, type DiscordChannelCredentials, type DiscordChannelEvents, type DiscordChannelState, type DiscordCommandResult, type DiscordCommandResultOrPromise, type DiscordContext, type DiscordEventContext, type DiscordHandle, type DiscordInputResponseContext, type DiscordInputResponseInteraction, type DiscordInputResponseResult, type DiscordReceiveTarget, type DiscordRequestOptions, } from "#public/channels/discord/discordChannel.js";
 export { callDiscordApi, createDiscordFollowupMessage, discordContinuationToken, DISCORD_MESSAGE_CONTENT_MAX_LENGTH, DISCORD_NO_MENTIONS, editDiscordOriginalResponse, resolveDiscordApplicationId, resolveDiscordBotToken, resolveDiscordPublicKey, sendDiscordChannelMessage, splitDiscordMessageContent, triggerDiscordTypingIndicator, type DiscordApiOptions, type DiscordApiResponse, type DiscordApplicationId, type DiscordBotToken, type DiscordCredentials, type DiscordFetch, type DiscordMessageBody, type DiscordPostedMessage, } from "#public/channels/discord/api.js";
-export { DISCORD_EPHEMERAL_MESSAGE_FLAG, DISCORD_INTERACTION_RESPONSE_TYPE, DISCORD_INTERACTION_TYPE, commandInteractionMessage, formatDiscordContextBlock, parseDiscordInteraction, type DiscordCommandInteraction, type DiscordCommandOption, type DiscordComponentInteraction, type DiscordInboundContext, type DiscordInteraction, type DiscordInteractionBase, type DiscordMember, type DiscordModalSubmitInteraction, type DiscordUser, } from "#public/channels/discord/inbound.js";
+export { DISCORD_EPHEMERAL_MESSAGE_FLAG, DISCORD_INTERACTION_RESPONSE_TYPE, DISCORD_INTERACTION_TYPE, commandInteractionMessage, formatDiscordContextBlock, parseDiscordInteraction, type DiscordAttachment, type DiscordCommandInteraction, type DiscordCommandOption, type DiscordComponentInteraction, type DiscordInboundContext, type DiscordInteraction, type DiscordInteractionBase, type DiscordMember, type DiscordModalSubmitInteraction, type DiscordUser, } from "#public/channels/discord/inbound.js";
 export { DISCORD_COMPONENT_TYPE, DISCORD_HITL_CUSTOM_ID_PREFIX, DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX, DISCORD_HITL_FREEFORM_TEXT_INPUT_ID, buildFreeformModalResponse, deriveComponentInputResponses, deriveModalInputResponses, isDiscordFreeformComponent, renderInputRequestComponents, } from "#public/channels/discord/hitl.js";
-export { defaultDiscordAuth } from "#public/channels/discord/defaults.js";
+export { defaultDiscordAuth, defaultDiscordMessageAuth, } from "#public/channels/discord/defaults.js";
+export type { DiscordGatewayConfig, DiscordGatewayMessage, DiscordMessageResult, DiscordMessageResultOrPromise, DiscordStartThreadOptions, DiscordThreadAutoArchiveMinutes, } from "#public/channels/discord/messages.js";
 export { verifyDiscordRequest, verifyDiscordSignature, type DiscordPublicKey, type DiscordVerifyOptions, type DiscordWebhookVerifier, } from "#public/channels/discord/verify.js";

package/dist/src/public/channels/discord/index.js

@@ -1 +1 @@
-import{verifyDiscordRequest,verifyDiscordSignature}from"#public/channels/discord/verify.js";import{DISCORD_MESSAGE_CONTENT_MAX_LENGTH,DISCORD_NO_MENTIONS,callDiscordApi,createDiscordFollowupMessage,discordContinuationToken,editDiscordOriginalResponse,resolveDiscordApplicationId,resolveDiscordBotToken,resolveDiscordPublicKey,sendDiscordChannelMessage,splitDiscordMessageContent,triggerDiscordTypingIndicator}from"#public/channels/discord/api.js";import{DISCORD_COMPONENT_TYPE,DISCORD_HITL_CUSTOM_ID_PREFIX,DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX,DISCORD_HITL_FREEFORM_TEXT_INPUT_ID,buildFreeformModalResponse,deriveComponentInputResponses,deriveModalInputResponses,isDiscordFreeformComponent,renderInputRequestComponents}from"#public/channels/discord/hitl.js";import{defaultDiscordAuth}from"#public/channels/discord/defaults.js";import{DISCORD_EPHEMERAL_MESSAGE_FLAG,DISCORD_INTERACTION_RESPONSE_TYPE,DISCORD_INTERACTION_TYPE,commandInteractionMessage,formatDiscordContextBlock,parseDiscordInteraction}from"#public/channels/discord/inbound.js";import{discordChannel}from"#public/channels/discord/discordChannel.js";export{DISCORD_COMPONENT_TYPE,DISCORD_EPHEMERAL_MESSAGE_FLAG,DISCORD_HITL_CUSTOM_ID_PREFIX,DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX,DISCORD_HITL_FREEFORM_TEXT_INPUT_ID,DISCORD_INTERACTION_RESPONSE_TYPE,DISCORD_INTERACTION_TYPE,DISCORD_MESSAGE_CONTENT_MAX_LENGTH,DISCORD_NO_MENTIONS,buildFreeformModalResponse,callDiscordApi,commandInteractionMessage,createDiscordFollowupMessage,defaultDiscordAuth,deriveComponentInputResponses,deriveModalInputResponses,discordChannel,discordContinuationToken,editDiscordOriginalResponse,formatDiscordContextBlock,isDiscordFreeformComponent,parseDiscordInteraction,renderInputRequestComponents,resolveDiscordApplicationId,resolveDiscordBotToken,resolveDiscordPublicKey,sendDiscordChannelMessage,splitDiscordMessageContent,triggerDiscordTypingIndicator,verifyDiscordRequest,verifyDiscordSignature};
+import{verifyDiscordRequest,verifyDiscordSignature}from"#public/channels/discord/verify.js";import{DISCORD_COMPONENT_TYPE,DISCORD_HITL_CUSTOM_ID_PREFIX,DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX,DISCORD_HITL_FREEFORM_TEXT_INPUT_ID,buildFreeformModalResponse,deriveComponentInputResponses,deriveModalInputResponses,isDiscordFreeformComponent,renderInputRequestComponents}from"#public/channels/discord/hitl.js";import{DISCORD_MESSAGE_CONTENT_MAX_LENGTH,DISCORD_NO_MENTIONS,callDiscordApi,createDiscordFollowupMessage,discordContinuationToken,editDiscordOriginalResponse,resolveDiscordApplicationId,resolveDiscordBotToken,resolveDiscordPublicKey,sendDiscordChannelMessage,splitDiscordMessageContent,triggerDiscordTypingIndicator}from"#public/channels/discord/api.js";import{defaultDiscordAuth,defaultDiscordMessageAuth}from"#public/channels/discord/defaults.js";import{DISCORD_EPHEMERAL_MESSAGE_FLAG,DISCORD_INTERACTION_RESPONSE_TYPE,DISCORD_INTERACTION_TYPE,commandInteractionMessage,formatDiscordContextBlock,parseDiscordInteraction}from"#public/channels/discord/inbound.js";import{discordChannel}from"#public/channels/discord/discordChannel.js";export{DISCORD_COMPONENT_TYPE,DISCORD_EPHEMERAL_MESSAGE_FLAG,DISCORD_HITL_CUSTOM_ID_PREFIX,DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX,DISCORD_HITL_FREEFORM_TEXT_INPUT_ID,DISCORD_INTERACTION_RESPONSE_TYPE,DISCORD_INTERACTION_TYPE,DISCORD_MESSAGE_CONTENT_MAX_LENGTH,DISCORD_NO_MENTIONS,buildFreeformModalResponse,callDiscordApi,commandInteractionMessage,createDiscordFollowupMessage,defaultDiscordAuth,defaultDiscordMessageAuth,deriveComponentInputResponses,deriveModalInputResponses,discordChannel,discordContinuationToken,editDiscordOriginalResponse,formatDiscordContextBlock,isDiscordFreeformComponent,parseDiscordInteraction,renderInputRequestComponents,resolveDiscordApplicationId,resolveDiscordBotToken,resolveDiscordPublicKey,sendDiscordChannelMessage,splitDiscordMessageContent,triggerDiscordTypingIndicator,verifyDiscordRequest,verifyDiscordSignature};

package/dist/src/public/channels/discord/messages.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Ordinary Discord messages, which Discord delivers only over its Gateway
+ * WebSocket. A relay such as `experimental_runDiscordGatewayRelay` from
+ * `eve/channels/discord/gateway` holds that connection and forwards each
+ * dispatch, unchanged, to the route this module mounts.
+ */
+import type { SessionAuthContext } from "#channel/types.js";
+import { type AuthFn } from "#public/channels/auth.js";
+import type { DiscordChannelConfig, DiscordChannelState, DiscordContext } from "#public/channels/discord/discordChannel.js";
+import { type DiscordAttachment, type DiscordUser } from "#public/channels/discord/inbound.js";
+import { type HttpRouteDefinition } from "#channel/routes.js";
+/** An ordinary Discord message forwarded from the Gateway. */
+export interface DiscordGatewayMessage {
+    readonly id: string;
+    readonly channelId: string;
+    /** Absent for direct messages. */
+    readonly guildId?: string;
+    /**
+     * Message text with the bot's own mention removed. Discord sends an empty
+     * string for messages that neither mention the bot nor arrive as a DM unless
+     * the bot has the Message Content intent.
+     */
+    readonly content: string;
+    readonly author: DiscordUser;
+    readonly attachments: readonly DiscordAttachment[];
+    /** ID of the message this one replies to, if any. */
+    readonly referencedMessageId?: string;
+    /**
+     * Whether the message is meant for the bot: a direct message, a mention, a
+     * reply to one of the bot's messages, or a message in a thread where the bot
+     * already has a conversation.
+     */
+    readonly addressed: boolean;
+    /** Discord's raw message object. */
+    readonly raw: Record<string, unknown>;
+}
+/** Minutes of inactivity before Discord archives a thread; the values Discord accepts. */
+export type DiscordThreadAutoArchiveMinutes = 60 | 1440 | 4320 | 10080;
+/** Options for starting a thread from a message; see {@link DiscordMessageResult.startThread}. */
+export interface DiscordStartThreadOptions {
+    /** Thread name. Defaults to the message's first line, then its first attachment's filename. */
+    readonly name?: string;
+    /** Defaults to the channel's own setting. */
+    readonly autoArchiveMinutes?: DiscordThreadAutoArchiveMinutes;
+}
+/**
+ * Result of the Gateway message hook. Return `null` to ignore the message.
+ * - `auth`: session auth context for the dispatched turn, or `null` for anonymous.
+ * - `context`: model-visible context lines appended after the Discord context block.
+ * - `title`: workflow run title override that does not change model input.
+ * - `conversation`: which session in the channel the message joins; see
+ *   {@link DiscordMessageResult.conversation}.
+ * - `startThread`: answer in a new thread off the message; see
+ *   {@link DiscordMessageResult.startThread}.
+ */
+export type DiscordMessageResult = {
+    readonly auth: SessionAuthContext | null;
+    readonly context?: readonly string[];
+    readonly title?: string;
+    /**
+     * Key of the session the message joins within its Discord channel. Messages
+     * with the same key share a session. A message ID is the key of the
+     * session that owns that message: the one it started, or the one whose bot
+     * reply it is. `"channel"` is one session for the whole channel. Any other
+     * string is your own grouping, such as `` `user:${message.author.id}` ``.
+     *
+     * Defaults to `"channel"` in DMs and threads, which includes the thread a
+     * text-channel mention starts; elsewhere, to the replied-to message's session
+     * when one owns it, or else a new session keyed by this message.
+     */
+    readonly conversation?: string;
+    /**
+     * Starts a thread from the message and moves the conversation into it, as
+     * one session for the thread. Applies only when the message would start a
+     * new session in a text channel: DMs, messages already in a thread, and
+     * replies that continue a session are left as they are. eve adds the author
+     * to the thread. When Discord refuses, for example because the bot lacks the
+     * Create Public Threads permission, the message is handled as if
+     * `startThread` were `false`. Defaults to `gateway.startThread`.
+     */
+    readonly startThread?: boolean | DiscordStartThreadOptions;
+} | null;
+/** Sync or async {@link DiscordMessageResult}. */
+export type DiscordMessageResultOrPromise = DiscordMessageResult | Promise<DiscordMessageResult>;
+/** Configuration for `discordChannel({ gateway })`. */
+export interface DiscordGatewayConfig {
+    /** Override the route that accepts forwarded dispatches (`/eve/v1/discord/gateway`). */
+    readonly route?: string;
+    /**
+     * Authenticates the relay. The body names the message author, so whoever
+     * passes can act as any Discord user. Defaults to `localDev()` plus Vercel
+     * OIDC tokens from this project's own runtime in the same environment,
+     * which is what `experimental_runDiscordGatewayRelay` sends from a Vercel Daemon.
+     */
+    readonly auth?: AuthFn<Request> | readonly AuthFn<Request>[];
+    /**
+     * Decides whether a message dispatches, under what `auth`, and which
+     * session it joins. Called for every conversational message from a person;
+     * bot authors never reach it. Defaults to dispatching addressed messages
+     * with `defaultDiscordMessageAuth` and the default `conversation`.
+     */
+    onMessage?(ctx: DiscordContext, message: DiscordGatewayMessage): DiscordMessageResultOrPromise;
+    /**
+     * Default for each accepted message's `startThread`. Defaults to `true`, so
+     * the bot answers a mention in a text channel in a new thread; set `false`
+     * to answer in the channel, where replies continue the conversation. An
+     * `onMessage` result's own `startThread` overrides it.
+     */
+    readonly startThread?: boolean | DiscordStartThreadOptions;
+}
+/** Mounts the route that turns forwarded `MESSAGE_CREATE` dispatches into turns. */
+export declare function createDiscordGatewayRoute(input: {
+    readonly config: DiscordChannelConfig;
+    readonly gateway: DiscordGatewayConfig;
+    readonly buildContext: (state: DiscordChannelState) => DiscordContext;
+}): HttpRouteDefinition<DiscordChannelState>;

package/dist/src/public/channels/discord/messages.js

@@ -0,0 +1,2 @@
+import{createLogger,logError}from"#internal/logging.js";import{isNonEmptyString,isObject}from"#shared/guards.js";import{localDev,routeAuth}from"#public/channels/auth.js";import{EveAttachmentError}from"#internal/attachments/errors.js";import{readLimitedBytes}from"#internal/attachments/limited-read.js";import{callDiscordApi,discordContinuationToken,resolveDiscordApplicationId,resolveDiscordBotToken}from"#public/channels/discord/api.js";import{defaultOnMessage}from"#public/channels/discord/defaults.js";import{formatDiscordContextBlock,parseDiscordAttachment,parseDiscordUser}from"#public/channels/discord/inbound.js";import{discordCommandContent}from"#public/channels/discord/attachments.js";import{sameEnvironmentVercelOidc}from"#public/channels/same-environment-oidc.js";import{discordAudience}from"#public/channels/discord/audience.js";import{POST}from"#channel/routes.js";const log=createLogger(`discord.gateway`),WHOLE_CHANNEL_CONVERSATION=`channel`,CONVERSATIONAL_MESSAGE_TYPES=new Set([0,19]),THREAD_CHANNEL_TYPES=new Set([10,11,12]);function createDiscordGatewayRoute(e){let{config:t,gateway:n}=e,r=n.auth??[localDev(),sameEnvironmentVercelOidc()],i=n.onMessage??defaultOnMessage;return POST(n.route??`/eve/v1/discord/gateway`,async(a,{from:o,resolveSession:s})=>{let c=await routeAuth(a,r);if(c instanceof Response)return c;let l;try{l=await readLimitedBytes(a,1048576,`discord`)}catch(e){if(!(e instanceof EveAttachmentError))throw e;return Response.json({error:`Body exceeds 1 MB.`},{status:413})}let u;try{u=JSON.parse(l.toString(`utf8`))}catch{return Response.json({error:`Body is not JSON.`},{status:400})}if(!isObject(u)||u.t!==`MESSAGE_CREATE`)return ignored(`unsupported_event`);let d=isObject(u.d)?u.d:null,f=d===null?null:parseGatewayMessage(d);if(f===null)return ignored(`invalid_message`);if(f.author.isBot)return ignored(`bot_author`);let p=await resolveDiscordApplicationId(t.credentials?.applicationId),m=stripMention(f.content,p);if(!m&&f.attachments.length===0)return ignored(`empty_message`);let h=f.guildId===void 0,g=h?void 0:await s(discordContinuationToken(f.channelId,WHOLE_CHANNEL_CONVERSATION)),_={...f,addressed:h||g!==void 0||mentions(f.raw,p)||repliesTo(f.raw,p),content:m},v={applicationId:p,channelId:_.channelId,conversationId:null,guildId:_.guildId??null,hasMessageAnchor:!0,initialResponseSent:!0,interactionToken:null};h&&(v.audience=discordAudience(1),v.directMessage=!0);let y;try{y=await i(e.buildContext(v),_)}catch(e){return logError(log,`Discord message handler failed`,e,{messageId:_.id}),Response.json({error:`The message handler failed.`},{status:500})}if(y===null)return ignored(`not_accepted`);let b=isNonEmptyString(y.conversation)?y.conversation:void 0,x=y.startThread??n.startThread??!0;v.conversationId=await routeMessage();async function routeMessage(){if(h||g!==void 0)return b??WHOLE_CHANNEL_CONVERSATION;if(b===void 0){let e=_.referencedMessageId;if(e!==void 0&&await s(discordContinuationToken(_.channelId,e))!==void 0)return e}else if(x===!1)return b;let e=await lookUpChannelType(t,_.channelId);if(e!==void 0&&(v.audience=discordAudience(e)),e!==void 0&&THREAD_CHANNEL_TYPES.has(e))return b??WHOLE_CHANNEL_CONVERSATION;if(x!==!1){let e=await startThreadFrom(t,_,x===!0?{}:x);if(e!==void 0)return v.channelId=e,v.audience=`unknown`,b??WHOLE_CHANNEL_CONVERSATION}return b??_.id}let S=formatDiscordContextBlock({applicationId:p,channelId:_.channelId,guildId:_.guildId,messageId:_.id,userId:_.author.id,username:_.author.username}),C=await o(discordContinuationToken(v.channelId??_.channelId,v.conversationId)).send(discordCommandContent(m,_.attachments),{auth:y.auth,context:[S,...y.context??[]],state:v,title:y.title});return Response.json({accepted:!0,sessionId:C.id},{status:202})})}function ignored(e){return Response.json({accepted:!1,reason:e})}function parseGatewayMessage(e){if(!isNonEmptyString(e.id)||!isNonEmptyString(e.channel_id)||typeof e.type==`number`&&!CONVERSATIONAL_MESSAGE_TYPES.has(e.type))return null;let t=parseDiscordUser(e.author);return t===null?null:{attachments:Array.isArray(e.attachments)?e.attachments.flatMap(e=>parseDiscordAttachment(e)??[]):[],author:t,channelId:e.channel_id,content:typeof e.content==`string`?e.content:``,guildId:isNonEmptyString(e.guild_id)?e.guild_id:void 0,id:e.id,raw:e,referencedMessageId:referencedMessageId(e)}}function referencedMessageId(e){let t=isObject(e.message_reference)?e.message_reference:null;if(!(t===null||t.type!==void 0&&t.type!==0))return isNonEmptyString(t.message_id)?t.message_id:void 0}function mentions(e,t){return Array.isArray(e.mentions)&&e.mentions.some(e=>isObject(e)&&e.id===t)}function repliesTo(e,t){let n=isObject(e.referenced_message)?e.referenced_message:null;return isObject(n?.author)&&n.author.id===t}function stripMention(e,t){return e.replaceAll(`<@${t}>`,``).replaceAll(`<@!${t}>`,``).trim()}async function startThreadFrom(e,t,n){let r={name:(n.name?.trim()||t.content.split(`
+`,1)[0]?.trim()||t.attachments[0]?.filename||`Conversation`).slice(0,100)};n.autoArchiveMinutes!==void 0&&(r.auto_archive_duration=n.autoArchiveMinutes);try{let n=await resolveDiscordBotToken(e.credentials?.botToken),i={apiBaseUrl:e.api?.apiBaseUrl,botToken:n,fetch:e.api?.fetch},a=await callDiscordApi({...i,body:r,path:`/channels/${encodeURIComponent(t.channelId)}/messages/${encodeURIComponent(t.id)}/threads`}),o=isObject(a.body)?a.body.id:void 0;if(!a.ok||!isNonEmptyString(o)){log.warn(`Discord thread creation failed; answering in the channel`,{channelId:t.channelId,status:a.status});return}let s=await callDiscordApi({...i,method:`PUT`,path:`/channels/${encodeURIComponent(o)}/thread-members/${encodeURIComponent(t.author.id)}`});return s.ok||log.warn(`Adding the author to a Discord thread failed`,{status:s.status,threadId:o}),o}catch(e){log.warn(`Discord thread creation failed; answering in the channel`,{channelId:t.channelId,error:e});return}}async function lookUpChannelType(e,t){try{let n=await callDiscordApi({apiBaseUrl:e.api?.apiBaseUrl,botToken:await resolveDiscordBotToken(e.credentials?.botToken),fetch:e.api?.fetch,method:`GET`,path:`/channels/${encodeURIComponent(t)}`});if(n.ok&&isObject(n.body)&&typeof n.body.type==`number`)return n.body.type;log.warn(`Discord channel lookup failed; treating the channel as a non-thread`,{channelId:t,status:n.status})}catch(e){log.warn(`Discord channel lookup failed; treating the channel as a non-thread`,{channelId:t,error:e})}}export{createDiscordGatewayRoute};

package/dist/src/public/channels/github/checkout.js

@@ -1 +1 @@
-import{shellQuote}from"#shared/shell-quote.js";import{resolveGitHubInstallationToken}from"#public/channels/github/auth.js";import{getGitHubPullRequest,getGitHubRepository}from"#public/channels/github/api.js";import{gitHubGitBrokerNetworkPolicy,gitHubRemoteUrl,isFullGitSha}from"#shared/git.js";async function checkoutGitHubRepository(e,t){let n=await resolveCheckoutDescriptor(t),r=e.resolvePath(t.path??`/workspace`),i=resolveCheckoutRef(t.ref,n);if(isFullGitSha(i)){let t=await readCheckoutHead(e,r);if(t===i)return{baseRef:n.baseRef,path:r,ref:i,sha:t}}let a=normalizeCheckoutDepth(t.depth),o=t.mode===`full`?``:` --depth ${a}`,s=await resolveGitHubInstallationToken({api:t.api,credentials:t.credentials,installationId:n.installationId}),c=gitHubRemoteUrl({owner:n.owner,repo:n.repo}),l=isFullGitSha(i)?i:`FETCH_HEAD`;await e.setNetworkPolicy(gitHubGitBrokerNetworkPolicy(s)),await runCheckoutCommand({command:`mkdir -p ${shellQuote(r)}`,label:`create checkout directory`,sandbox:e}),await runCheckoutCommand({command:`cd ${shellQuote(r)} && git init`,label:`initialize git repository`,sandbox:e}),await runCheckoutCommand({command:`cd ${shellQuote(r)} && git remote remove origin >/dev/null 2>&1 || true`,label:`reset git remote`,sandbox:e}),await runCheckoutCommand({command:`cd ${shellQuote(r)} && git remote add origin ${shellQuote(c)}`,label:`configure git remote`,sandbox:e}),await runCheckoutCommand({command:`cd ${shellQuote(r)} && GIT_TERMINAL_PROMPT=0 git fetch${o} origin ${shellQuote(i)}`,label:`fetch GitHub ref`,sandbox:e}),await runCheckoutCommand({command:`cd ${shellQuote(r)} && git checkout --detach ${shellQuote(l)}`,label:`checkout GitHub ref`,sandbox:e}),t.includeBase===!0&&n.baseSha!==null&&await runCheckoutCommand({command:`cd ${shellQuote(r)} && GIT_TERMINAL_PROMPT=0 git fetch${o} origin ${shellQuote(n.baseSha)}`,label:`fetch GitHub base ref`,sandbox:e});let u=(await runCheckoutCommand({command:`cd ${shellQuote(r)} && git rev-parse HEAD`,label:`resolve checked out commit`,sandbox:e})).stdout.trim()||n.headSha||i;return{baseRef:n.baseRef,path:r,ref:i,sha:u}}async function resolveCheckoutDescriptor(e){let t=readNonEmptyString(e.owner),n=readNonEmptyString(e.repo);if(t===void 0||n===void 0)throw Error(`GitHub checkout requires a repository owner and name.`);if(e.installationId===void 0||e.installationId===null)throw Error(`GitHub checkout requires a GitHub App installation id.`);let r=e.pullRequestNumber??null,i=readNonEmptyString(e.ref),a=null;r!==null&&(i===void 0&&((e.headSha===void 0||e.headSha===null)&&(e.headRef===void 0||e.headRef===null)||e.defaultBranch===void 0||e.defaultBranch===null)||e.includeBase===!0&&(e.baseSha===void 0||e.baseSha===null)||e.includeBase===!0&&(e.baseRef===void 0||e.baseRef===null))&&(a=await getGitHubPullRequest({api:e.api,credentials:e.credentials,installationId:e.installationId,owner:t,pullRequestNumber:r,repo:n}));let o=readNonEmptyString(e.defaultBranch)??a?.defaultBranch??await resolveRepositoryDefaultBranch(e,{owner:t,pullRequestNumber:r,repo:n});return{baseRef:e.baseRef??a?.base.ref??null,baseSha:e.baseSha??a?.base.sha??null,defaultBranch:o,headRef:e.headRef??a?.head.ref??null,headSha:e.headSha??a?.head.sha??null,installationId:e.installationId,owner:t,pullRequestNumber:r,repo:n}}async function resolveRepositoryDefaultBranch(e,t){return t.pullRequestNumber!==null||readNonEmptyString(e.ref)!==void 0||readNonEmptyString(e.headSha)!==void 0||readNonEmptyString(e.headRef)!==void 0?null:(await getGitHubRepository({api:e.api,credentials:e.credentials,installationId:e.installationId??void 0,owner:t.owner,repo:t.repo})).defaultBranch??null}function resolveCheckoutRef(e,t){if(e!==void 0&&e.trim().length>0)return e.trim();if(t.headSha!==null)return t.headSha;if(t.pullRequestNumber!==null)return`refs/pull/${t.pullRequestNumber}/head`;if(t.headRef!==null)return t.headRef;if(t.defaultBranch!==null)return t.defaultBranch;throw Error(`GitHub checkout could not resolve a ref to fetch.`)}async function readCheckoutHead(e,t){let n=await e.run({command:`cd ${shellQuote(t)} && git rev-parse HEAD 2>/dev/null`});if(n.exitCode!==0)return null;let r=String(n.stdout??``).trim();return isFullGitSha(r)?r:null}async function runCheckoutCommand(e){let t=await e.sandbox.run({command:e.command}),n=String(t.stderr??``),r=String(t.stdout??``);if(t.exitCode===0)return{stderr:n,stdout:r};throw Error([`GitHub checkout failed during ${e.label} (exit ${t.exitCode}).`,n?`stderr: ${n}`:void 0,r?`stdout: ${r}`:void 0,`Verify the GitHub App installation has access to this repository.`].filter(e=>e!==void 0).join(` `))}function normalizeCheckoutDepth(e){if(e===void 0)return 1;if(!Number.isFinite(e)||e<1)throw Error(`GitHub checkout depth must be a positive number.`);return Math.floor(e)}function readNonEmptyString(e){return typeof e==`string`&&e.trim().length>0?e.trim():void 0}export{checkoutGitHubRepository};
+import{shellQuote}from"#shared/shell-quote.js";import{resolveGitHubInstallationToken}from"#public/channels/github/auth.js";import{getGitHubPullRequest,getGitHubRepository}from"#public/channels/github/api.js";import{gitHubGitBrokerNetworkPolicy,gitHubRemoteUrl,isFullGitSha}from"#shared/git.js";async function checkoutGitHubRepository(e,t){let n=await resolveCheckoutDescriptor(t),r=e.resolvePath(t.path??`.`),i=resolveCheckoutRef(t.ref,n);if(isFullGitSha(i)){let t=await readCheckoutHead(e,r);if(t===i)return{baseRef:n.baseRef,path:r,ref:i,sha:t}}let a=normalizeCheckoutDepth(t.depth),o=t.mode===`full`?``:` --depth ${a}`,s=await resolveGitHubInstallationToken({api:t.api,credentials:t.credentials,installationId:n.installationId}),c=gitHubRemoteUrl({owner:n.owner,repo:n.repo}),l=isFullGitSha(i)?i:`FETCH_HEAD`;await e.setNetworkPolicy(gitHubGitBrokerNetworkPolicy(s)),await runCheckoutCommand({command:`mkdir -p ${shellQuote(r)}`,label:`create checkout directory`,sandbox:e}),await runCheckoutCommand({command:`cd ${shellQuote(r)} && git init`,label:`initialize git repository`,sandbox:e}),await runCheckoutCommand({command:`cd ${shellQuote(r)} && git remote remove origin >/dev/null 2>&1 || true`,label:`reset git remote`,sandbox:e}),await runCheckoutCommand({command:`cd ${shellQuote(r)} && git remote add origin ${shellQuote(c)}`,label:`configure git remote`,sandbox:e}),await runCheckoutCommand({command:`cd ${shellQuote(r)} && GIT_TERMINAL_PROMPT=0 git fetch${o} origin ${shellQuote(i)}`,label:`fetch GitHub ref`,sandbox:e}),await runCheckoutCommand({command:`cd ${shellQuote(r)} && git checkout --detach ${shellQuote(l)}`,label:`checkout GitHub ref`,sandbox:e}),t.includeBase===!0&&n.baseSha!==null&&await runCheckoutCommand({command:`cd ${shellQuote(r)} && GIT_TERMINAL_PROMPT=0 git fetch${o} origin ${shellQuote(n.baseSha)}`,label:`fetch GitHub base ref`,sandbox:e});let u=(await runCheckoutCommand({command:`cd ${shellQuote(r)} && git rev-parse HEAD`,label:`resolve checked out commit`,sandbox:e})).stdout.trim()||n.headSha||i;return{baseRef:n.baseRef,path:r,ref:i,sha:u}}async function resolveCheckoutDescriptor(e){let t=readNonEmptyString(e.owner),n=readNonEmptyString(e.repo);if(t===void 0||n===void 0)throw Error(`GitHub checkout requires a repository owner and name.`);if(e.installationId===void 0||e.installationId===null)throw Error(`GitHub checkout requires a GitHub App installation id.`);let r=e.pullRequestNumber??null,i=readNonEmptyString(e.ref),a=null;r!==null&&(i===void 0&&((e.headSha===void 0||e.headSha===null)&&(e.headRef===void 0||e.headRef===null)||e.defaultBranch===void 0||e.defaultBranch===null)||e.includeBase===!0&&(e.baseSha===void 0||e.baseSha===null)||e.includeBase===!0&&(e.baseRef===void 0||e.baseRef===null))&&(a=await getGitHubPullRequest({api:e.api,credentials:e.credentials,installationId:e.installationId,owner:t,pullRequestNumber:r,repo:n}));let o=readNonEmptyString(e.defaultBranch)??a?.defaultBranch??await resolveRepositoryDefaultBranch(e,{owner:t,pullRequestNumber:r,repo:n});return{baseRef:e.baseRef??a?.base.ref??null,baseSha:e.baseSha??a?.base.sha??null,defaultBranch:o,headRef:e.headRef??a?.head.ref??null,headSha:e.headSha??a?.head.sha??null,installationId:e.installationId,owner:t,pullRequestNumber:r,repo:n}}async function resolveRepositoryDefaultBranch(e,t){return t.pullRequestNumber!==null||readNonEmptyString(e.ref)!==void 0||readNonEmptyString(e.headSha)!==void 0||readNonEmptyString(e.headRef)!==void 0?null:(await getGitHubRepository({api:e.api,credentials:e.credentials,installationId:e.installationId??void 0,owner:t.owner,repo:t.repo})).defaultBranch??null}function resolveCheckoutRef(e,t){if(e!==void 0&&e.trim().length>0)return e.trim();if(t.headSha!==null)return t.headSha;if(t.pullRequestNumber!==null)return`refs/pull/${t.pullRequestNumber}/head`;if(t.headRef!==null)return t.headRef;if(t.defaultBranch!==null)return t.defaultBranch;throw Error(`GitHub checkout could not resolve a ref to fetch.`)}async function readCheckoutHead(e,t){let n=await e.run({command:`cd ${shellQuote(t)} && git rev-parse HEAD 2>/dev/null`});if(n.exitCode!==0)return null;let r=String(n.stdout??``).trim();return isFullGitSha(r)?r:null}async function runCheckoutCommand(e){let t=await e.sandbox.run({command:e.command}),n=String(t.stderr??``),r=String(t.stdout??``);if(t.exitCode===0)return{stderr:n,stdout:r};throw Error([`GitHub checkout failed during ${e.label} (exit ${t.exitCode}).`,n?`stderr: ${n}`:void 0,r?`stdout: ${r}`:void 0,`Verify the GitHub App installation has access to this repository.`].filter(e=>e!==void 0).join(` `))}function normalizeCheckoutDepth(e){if(e===void 0)return 1;if(!Number.isFinite(e)||e<1)throw Error(`GitHub checkout depth must be a positive number.`);return Math.floor(e)}function readNonEmptyString(e){return typeof e==`string`&&e.trim().length>0?e.trim():void 0}export{checkoutGitHubRepository};

package/dist/src/public/channels/linq/linqChannel.d.ts

@@ -30,7 +30,10 @@ export interface LinqChannelCredentials {
     readonly apiKey?: LinqCredentialValue;
     /** Signing secret for direct Linq webhook delivery. */
     readonly signingSecret?: LinqCredentialValue;
-    /** Trusted verifier for webhooks forwarded by a provider such as Vercel Connect. */
+    /**
+     * Trusted verifier for webhooks forwarded by a provider such as Vercel Connect.
+     * Return a falsy value or throw to reject the request.
+     */
     readonly webhookVerifier?: LinqWebhookVerifier;
 }
 /** Configuration for {@link linqChannel}. */

package/dist/src/public/channels/linq/linqChannel.js

@@ -1 +1 @@
-import{vercelOidc}from"#public/channels/auth.js";import{chatSdkChannel}from"#public/channels/chat-sdk/index.js";import{dispatchIMessageTapbacks,iMessageTapbackTool}from"#public/channels/imessage-tapbacks.js";import{createMemoryState}from"#compiled/@chat-adapter/state-memory/index.js";import{createLinqAdapter}from"#compiled/@linqapp/chat-sdk-adapter/index.js";import{formatReplyContext}from"#public/channels/chat-sdk/reply-context.js";import{linqInboundContent,linqQuotedMessage,rehydrateLinqAttachment}from"#public/channels/linq/inboundContent.js";function linqChannel(e){let t=normalizeCredentials(e.credentials);e.baseURL!==void 0&&(t.baseURL=e.baseURL);let n=createLinqAdapter(t);n.rehydrateAttachment=rehydrateLinqAttachment;let r=chatSdkChannel({adapters:{linq:n},concurrency:`concurrent`,events:e.events,routes:{linq:e.route??`/eve/v1/linq`},state:createMemoryState(),streaming:!1,turnPolicy:e.turnPolicy,userName:e.userName??`eve`}),i=e.onMessage??defaultOnMessage;r.bot.onDirectMessage(async(e,t)=>{await dispatchMessage(r,i,e,t)}),r.bot.onNewMessage(/[\s\S]*/,async(e,t)=>{await dispatchMessage(r,i,e,t)}),e.onTapback&&dispatchIMessageTapbacks(r,e.onTapback);let a=Object.assign(r.channel,{tapbackTool:()=>iMessageTapbackTool({adapterName:`linq`,bot:r.bot,channel:a,channelLabel:`Linq`})});return a}function normalizeCredentials(e){let{apiKey:t,signingSecret:n,webhookVerifier:r}=e??{},i={};return t!==void 0&&(i.credentials=createCredentialProvider(t,n)),r===void 0?n===void 0&&(i.webhookVerifier=vercelOidc()):i.webhookVerifier=r,i}function createCredentialProvider(e,t){return async()=>{let n={apiKey:await resolveCredentialValue(e)};return t!==void 0&&(n.signingSecret=await resolveCredentialValue(t)),n}}async function resolveCredentialValue(e){return typeof e==`function`?await e():e}function defaultLinqAuth(e){let t={};return e.author.userName!==void 0&&(t.user_name=e.author.userName),{attributes:t,authenticator:`linq-message`,issuer:`linq`,principalId:`linq:${e.author.userId}`,principalType:e.author.isBot?`service`:`user`,subject:e.author.userId}}async function defaultOnMessage(e,t){return{auth:defaultLinqAuth(t)}}async function dispatchMessage(e,t,n,r){let i=await t({thread:n},r);if(i===null)return;let a=e.bot.getAdapter(`linq`),o=linqInboundContent(r),[,s]=await Promise.all([markReadBestEffort(a,n,r),o===void 0?void 0:linqQuotedMessage(a,r)]);o!==void 0&&await e.send(o,{auth:i.auth,context:[...i.context??[],...s?[formatReplyContext(s,r.text)]:[]],history:i.history,thread:n,title:i.title})}async function markReadBestEffort(e,t,n){try{await e.markRead(t.id,n.id)}catch{}}export{defaultLinqAuth,linqChannel};
+import{sameEnvironmentVercelOidc}from"#public/channels/same-environment-oidc.js";import{chatSdkChannel}from"#public/channels/chat-sdk/index.js";import{dispatchIMessageTapbacks,iMessageTapbackTool}from"#public/channels/imessage-tapbacks.js";import{createMemoryState}from"#compiled/@chat-adapter/state-memory/index.js";import{createLinqAdapter}from"#compiled/@linqapp/chat-sdk-adapter/index.js";import{formatReplyContext}from"#public/channels/chat-sdk/reply-context.js";import{linqInboundContent,linqQuotedMessage,rehydrateLinqAttachment}from"#public/channels/linq/inboundContent.js";function linqChannel(e){let t=normalizeCredentials(e.credentials);e.baseURL!==void 0&&(t.baseURL=e.baseURL);let n=createLinqAdapter(t);n.rehydrateAttachment=rehydrateLinqAttachment;let r=chatSdkChannel({adapters:{linq:n},concurrency:`concurrent`,events:e.events,routes:{linq:e.route??`/eve/v1/linq`},state:createMemoryState(),streaming:!1,turnPolicy:e.turnPolicy,userName:e.userName??`eve`}),i=e.onMessage??defaultOnMessage;r.bot.onDirectMessage(async(e,t)=>{await dispatchMessage(r,i,e,t)}),r.bot.onNewMessage(/[\s\S]*/,async(e,t)=>{await dispatchMessage(r,i,e,t)}),e.onTapback&&dispatchIMessageTapbacks(r,e.onTapback);let a=Object.assign(r.channel,{tapbackTool:()=>iMessageTapbackTool({adapterName:`linq`,bot:r.bot,channel:a,channelLabel:`Linq`})});return a}function normalizeCredentials(e){let{apiKey:t,signingSecret:n,webhookVerifier:r}=e??{},i={};t!==void 0&&(i.credentials=createCredentialProvider(t,n));let a=r??(n===void 0?sameEnvironmentVercelOidc():void 0);return a!==void 0&&(i.webhookVerifier=rejectFalsyResults(a)),i}function rejectFalsyResults(e){return async(t,n)=>await e(t,n)||!1}function createCredentialProvider(e,t){return async()=>{let n={apiKey:await resolveCredentialValue(e)};return t!==void 0&&(n.signingSecret=await resolveCredentialValue(t)),n}}async function resolveCredentialValue(e){return typeof e==`function`?await e():e}function defaultLinqAuth(e){let t={};return e.author.userName!==void 0&&(t.user_name=e.author.userName),{attributes:t,authenticator:`linq-message`,issuer:`linq`,principalId:`linq:${e.author.userId}`,principalType:e.author.isBot?`service`:`user`,subject:e.author.userId}}async function defaultOnMessage(e,t){return{auth:defaultLinqAuth(t)}}async function dispatchMessage(e,t,n,r){let i=await t({thread:n},r);if(i===null)return;let a=e.bot.getAdapter(`linq`),o=linqInboundContent(r),[,s]=await Promise.all([markReadBestEffort(a,n,r),o===void 0?void 0:linqQuotedMessage(a,r)]);o!==void 0&&await e.send(o,{auth:i.auth,context:[...i.context??[],...s?[formatReplyContext(s,r.text)]:[]],history:i.history,thread:n,title:i.title})}async function markReadBestEffort(e,t,n){try{await e.markRead(t.id,n.id)}catch{}}export{defaultLinqAuth,linqChannel};

package/dist/src/public/channels/photon/photonIMessageChannel.js

@@ -1 +1 @@
-import{vercelOidc}from"#public/channels/auth.js";import{chatSdkChannel}from"#public/channels/chat-sdk/index.js";import{dispatchIMessageTapbacks,iMessageTapbackTool}from"#public/channels/imessage-tapbacks.js";import{createMemoryState}from"#compiled/@chat-adapter/state-memory/index.js";import{formatReplyContext}from"#public/channels/chat-sdk/reply-context.js";import{createiMessageAdapter}from"#compiled/@photon-ai/chat-adapter-imessage/index.js";import{addPhotonAttachmentDownloads,addPhotonAttachmentRehydration}from"#public/channels/photon/attachments.js";import{photonInboundContent,photonQuotedMessage}from"#public/channels/photon/inboundContent.js";function photonIMessageChannel(e){let t=e.webhookSecret??process.env.IMESSAGE_WEBHOOK_SECRET,n=createiMessageAdapter({credentials:e.credentials,...e.webhookVerifier?{webhookVerifier:e.webhookVerifier}:t?{webhookSecret:t}:{webhookVerifier:vercelOidc()}});addPhotonAttachmentRehydration(n);let r=chatSdkChannel({adapters:{imessage:n},concurrency:`concurrent`,events:e.events,routes:{imessage:e.route??`/eve/v1/photon`},state:createMemoryState(),streaming:!1,turnPolicy:e.turnPolicy,userName:e.userName??`eve`}),i=e.onMessage??defaultOnMessage;r.bot.onDirectMessage(async(e,t)=>{await dispatchMessage(r,i,e,t)}),r.bot.onNewMessage(/[\s\S]*/,async(e,t)=>{await dispatchMessage(r,i,e,t)}),e.onTapback&&dispatchIMessageTapbacks(r,e.onTapback);let a=Object.assign(r.channel,{tapbackTool:()=>iMessageTapbackTool({adapterName:`imessage`,bot:r.bot,channel:a,channelLabel:`Photon iMessage`,sendEmoji:sendPhotonEmojiTapback})});return a}async function sendPhotonEmojiTapback(e,t,n,r){let i=(await e.fetchMessage?.(t,n))?.raw;if(typeof i?.react!=`function`)throw Error(`Photon could not find the message to react to.`);await i.react(r)}function defaultPhotonAuth(e){let t={};return e.author.userName!==void 0&&(t.user_name=e.author.userName),{attributes:t,authenticator:`photon-imessage`,issuer:`photon`,principalId:`photon:${e.author.userId}`,principalType:e.author.isBot?`service`:`user`,subject:e.author.userId}}async function defaultOnMessage(e,t){return{auth:defaultPhotonAuth(t)}}async function dispatchMessage(e,t,n,r){let i=await t({thread:n},r);if(i===null)return;let a=e.bot.getAdapter(`imessage`);await markReadBestEffort(a,n,r),await addPhotonAttachmentDownloads(r,a);let o=photonInboundContent(r);if(o===void 0)return;let s=photonQuotedMessage(r);await e.send(o,{idempotencyKey:r.id,auth:i.auth,context:[...i.context??[],...s?[formatReplyContext(s,r.text)]:[]],history:i.history,thread:n,title:i.title})}async function markReadBestEffort(e,t,n){try{await e.markRead(t.id,n.id)}catch{}}export{defaultPhotonAuth,photonIMessageChannel};
+import{sameEnvironmentVercelOidc}from"#public/channels/same-environment-oidc.js";import{chatSdkChannel}from"#public/channels/chat-sdk/index.js";import{dispatchIMessageTapbacks,iMessageTapbackTool}from"#public/channels/imessage-tapbacks.js";import{createMemoryState}from"#compiled/@chat-adapter/state-memory/index.js";import{formatReplyContext}from"#public/channels/chat-sdk/reply-context.js";import{createiMessageAdapter}from"#compiled/@photon-ai/chat-adapter-imessage/index.js";import{addPhotonAttachmentDownloads,addPhotonAttachmentRehydration}from"#public/channels/photon/attachments.js";import{photonInboundContent,photonQuotedMessage}from"#public/channels/photon/inboundContent.js";function photonIMessageChannel(e){let t=e.webhookSecret??process.env.IMESSAGE_WEBHOOK_SECRET,n=createiMessageAdapter({credentials:e.credentials,...e.webhookVerifier?{webhookVerifier:e.webhookVerifier}:t?{webhookSecret:t}:{webhookVerifier:sameEnvironmentVercelOidc()}});addPhotonAttachmentRehydration(n);let r=chatSdkChannel({adapters:{imessage:n},concurrency:`concurrent`,events:e.events,routes:{imessage:e.route??`/eve/v1/photon`},state:createMemoryState(),streaming:!1,turnPolicy:e.turnPolicy,userName:e.userName??`eve`}),i=e.onMessage??defaultOnMessage;r.bot.onDirectMessage(async(e,t)=>{await dispatchMessage(r,i,e,t)}),r.bot.onNewMessage(/[\s\S]*/,async(e,t)=>{await dispatchMessage(r,i,e,t)}),e.onTapback&&dispatchIMessageTapbacks(r,e.onTapback);let a=Object.assign(r.channel,{tapbackTool:()=>iMessageTapbackTool({adapterName:`imessage`,bot:r.bot,channel:a,channelLabel:`Photon iMessage`,sendEmoji:sendPhotonEmojiTapback})});return a}async function sendPhotonEmojiTapback(e,t,n,r){let i=(await e.fetchMessage?.(t,n))?.raw;if(typeof i?.react!=`function`)throw Error(`Photon could not find the message to react to.`);await i.react(r)}function defaultPhotonAuth(e){let t={};return e.author.userName!==void 0&&(t.user_name=e.author.userName),{attributes:t,authenticator:`photon-imessage`,issuer:`photon`,principalId:`photon:${e.author.userId}`,principalType:e.author.isBot?`service`:`user`,subject:e.author.userId}}async function defaultOnMessage(e,t){return{auth:defaultPhotonAuth(t)}}async function dispatchMessage(e,t,n,r){let i=await t({thread:n},r);if(i===null)return;let a=e.bot.getAdapter(`imessage`);await markReadBestEffort(a,n,r),await addPhotonAttachmentDownloads(r,a);let o=photonInboundContent(r);if(o===void 0)return;let s=photonQuotedMessage(r);await e.send(o,{idempotencyKey:r.id,auth:i.auth,context:[...i.context??[],...s?[formatReplyContext(s,r.text)]:[]],history:i.history,thread:n,title:i.title})}async function markReadBestEffort(e,t,n){try{await e.markRead(t.id,n.id)}catch{}}export{defaultPhotonAuth,photonIMessageChannel};

package/dist/src/public/channels/same-environment-oidc.d.ts

@@ -0,0 +1,7 @@
+import { type AuthFn } from "#public/channels/auth.js";
+/**
+ * Vercel OIDC from this project in the current environment only. Tokens from
+ * the project's other environments, such as a preview deployment, authenticate
+ * as `service` and must not reach this deployment's inbound channel routes.
+ */
+export declare function sameEnvironmentVercelOidc(): AuthFn<Request>;

package/dist/src/public/channels/same-environment-oidc.js

@@ -0,0 +1 @@
+import{vercelOidc}from"#public/channels/auth.js";function sameEnvironmentVercelOidc(){let e=vercelOidc();return async t=>{let n=await e(t);return n?.principalType===`runtime`?n:null}}export{sameEnvironmentVercelOidc};

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

@@ -1 +1 @@
-import{SessionStrandedError}from"#channel/session-stranded-error.js";import{createMetadataAudienceProjector}from"#channel/audience.js";import{CHANNEL_SENTINEL}from"#channel/compiled-channel.js";import{defaultDeliverResult}from"#channel/adapter.js";import{buildCallbackContext}from"#context/build-callback-context.js";import{mergeUploadPolicy}from"#public/channels/upload-policy.js";import{normalizeChannelCors}from"#channel/cors.js";import{HTTP_ADAPTER_KIND}from"#channel/http.js";import{DELETE,GET,HEAD,OPTIONS,PATCH,POST,PUT,WS}from"#channel/routes.js";const DISABLED_ROUTE_SENTINEL_KIND=`eve:disabled-channel`;function disableRoute(){return{kind:DISABLED_ROUTE_SENTINEL_KIND}}function isDisabledRouteSentinel(e){return typeof e==`object`&&!!e&&e.kind===DISABLED_ROUTE_SENTINEL_KIND}function defineChannel(e){let t=buildAdapter(e),n=normalizeChannelCors(e.cors);return{__kind:CHANNEL_SENTINEL,routes:e.routes,adapter:t,cors:n,receive:e.receive,turnPolicy:e.turnPolicy}}const eventTypes=Object.keys({"approval.candidate":null,"approval.settled":null,"context.cleared":null,"compaction.requested":null,"compaction.completed":null,"turn.started":null,"actions.requested":null,"action.partial":null,"action.result":null,"message.completed":null,"message.appended":null,"reasoning.appended":null,"reasoning.completed":null,"step.started":null,"step.completed":null,"input.requested":null,"input.resolved":null,"task.started":null,"task.settled":null,"turn.waiting":null,"turn.failed":null,"turn.completed":null,"turn.cancelled":null,"session.failed":null,"session.completed":null,"session.waiting":null,"authorization.required":null,"authorization.completed":null});function buildAdapter(e){let t=e.state!=null,n=e.context!=null,r=e.fetchFile!==void 0,i=e.metadata,a=i!==void 0,o=e.audience,s=e.uploadPolicy===void 0?void 0:mergeUploadPolicy(e.uploadPolicy),c=t||n||a||s!==void 0,l={},u=!1,d={kind:e.kindHint??`defineChannel`},f=e.events;for(let e of eventTypes){let t=f?.[e];t&&(u=!0,l[e]=(n,r)=>{let{session:i,...a}=r,o={...a,continuation:i?.continuation===void 0?void 0:{token:i.continuation.token,alias:e=>i.continuation?.alias(e)}};if(e===`session.failed`)return t(n,o);let s=buildCallbackContext();return t(n,o,s)})}return!c&&!u&&!r?{kind:e.kindHint??HTTP_ADAPTER_KIND,...o===void 0?void 0:{instrumentation:{audience:o}}}:{kind:e.kindHint??`defineChannel`,state:t?{...e.state}:{},fetchFile:e.fetchFile,uploadPolicy:s,instrumentation:i===void 0&&o===void 0?void 0:{...i===void 0?void 0:{metadata(e){let{audience:t,...n}=i(e);return n}},...o===void 0?i===void 0?void 0:{audience:createMetadataAudienceProjector(d,i)}:{audience:o}},createAdapterContext(t){let r=t.state,i=t.session;return{...n?e.context(r,i):{},state:r,ctx:t.ctx,session:i}},deliver(t,n){return e.deliver===void 0?defaultDeliverResult(t):e.deliver(t,n)},...l}}export{DELETE,GET,HEAD,OPTIONS,PATCH,POST,PUT,SessionStrandedError,WS,defineChannel,disableRoute,isDisabledRouteSentinel};
+import{SessionStrandedError}from"#channel/session-stranded-error.js";import{createMetadataAudienceProjector}from"#channel/audience.js";import{CHANNEL_SENTINEL}from"#channel/compiled-channel.js";import{defaultDeliverResult}from"#channel/adapter.js";import{buildCallbackContext}from"#context/build-callback-context.js";import{mergeUploadPolicy}from"#public/channels/upload-policy.js";import{DELETE,GET,HEAD,OPTIONS,PATCH,POST,PUT,WS}from"#channel/routes.js";import{normalizeChannelCors}from"#channel/cors.js";import{HTTP_ADAPTER_KIND}from"#channel/http.js";const DISABLED_ROUTE_SENTINEL_KIND=`eve:disabled-channel`;function disableRoute(){return{kind:DISABLED_ROUTE_SENTINEL_KIND}}function isDisabledRouteSentinel(e){return typeof e==`object`&&!!e&&e.kind===DISABLED_ROUTE_SENTINEL_KIND}function defineChannel(e){let t=buildAdapter(e),n=normalizeChannelCors(e.cors);return{__kind:CHANNEL_SENTINEL,routes:e.routes,adapter:t,cors:n,receive:e.receive,turnPolicy:e.turnPolicy}}const eventTypes=Object.keys({"approval.candidate":null,"approval.settled":null,"context.cleared":null,"compaction.requested":null,"compaction.completed":null,"turn.started":null,"actions.requested":null,"action.partial":null,"action.result":null,"message.completed":null,"message.appended":null,"reasoning.appended":null,"reasoning.completed":null,"step.started":null,"step.completed":null,"input.requested":null,"input.resolved":null,"task.started":null,"task.settled":null,"turn.waiting":null,"turn.failed":null,"turn.completed":null,"turn.cancelled":null,"session.failed":null,"session.completed":null,"session.waiting":null,"authorization.required":null,"authorization.completed":null});function buildAdapter(e){let t=e.state!=null,n=e.context!=null,r=e.fetchFile!==void 0,i=e.metadata,a=i!==void 0,o=e.audience,s=e.uploadPolicy===void 0?void 0:mergeUploadPolicy(e.uploadPolicy),c=t||n||a||s!==void 0,l={},u=!1,d={kind:e.kindHint??`defineChannel`},f=e.events;for(let e of eventTypes){let t=f?.[e];t&&(u=!0,l[e]=(n,r)=>{let{session:i,...a}=r,o={...a,continuation:i?.continuation===void 0?void 0:{token:i.continuation.token,alias:e=>i.continuation?.alias(e)}};if(e===`session.failed`)return t(n,o);let s=buildCallbackContext();return t(n,o,s)})}return!c&&!u&&!r?{kind:e.kindHint??HTTP_ADAPTER_KIND,...o===void 0?void 0:{instrumentation:{audience:o}}}:{kind:e.kindHint??`defineChannel`,state:t?{...e.state}:{},fetchFile:e.fetchFile,uploadPolicy:s,instrumentation:i===void 0&&o===void 0?void 0:{...i===void 0?void 0:{metadata(e){let{audience:t,...n}=i(e);return n}},...o===void 0?i===void 0?void 0:{audience:createMetadataAudienceProjector(d,i)}:{audience:o}},createAdapterContext(t){let r=t.state,i=t.session;return{...n?e.context(r,i):{},state:r,ctx:t.ctx,session:i}},deliver(t,n){return e.deliver===void 0?defaultDeliverResult(t):e.deliver(t,n)},...l}}export{DELETE,GET,HEAD,OPTIONS,PATCH,POST,PUT,SessionStrandedError,WS,defineChannel,disableRoute,isDisabledRouteSentinel};

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

@@ -1,5 +1,5 @@
 import type { SandboxSelector } from "#shared/sandbox-environment.js";
-export type { SandboxCommandResult, SandboxProcess, SandboxReadBinaryFileOptions, SandboxReadFileOptions, SandboxRemovePathOptions, SandboxReadTextFileOptions, SandboxRunOptions, SandboxSession, RuntimeSandboxSession, RuntimeSandboxSessionFor, SandboxSpawnOptions, SandboxWriteBinaryFileOptions, SandboxWriteFileOptions, SandboxWriteTextFileOptions, } from "#shared/sandbox-session.js";
+export type { SandboxCommandResult, SandboxProcess, SandboxReadBinaryFileOptions, SandboxReadFileOptions, SandboxRemovePathOptions, SandboxReadTextFileOptions, SandboxRunOptions, SandboxSession, RuntimeSandboxSession, RuntimeSandboxSessionFor, SandboxSpawnOptions, SandboxWriteBinaryFileOptions, SandboxWriteFileOptions, SandboxWriteFilesOptions, SandboxWriteTextFileOptions, } from "#shared/sandbox-session.js";
 export type { SandboxOpenArguments, SandboxEnvironment, SandboxSelector, SandboxSelectorContext, } from "#shared/sandbox-environment.js";
 export declare function defineSandbox(definition: SandboxSelector): SandboxSelector;
 export declare function defineParentSandbox(): SandboxSelector;

package/dist/src/public/next/server.js

@@ -1 +1 @@
-import{resolveSharedEveDevServer,startEveProductionServer}from"#shared/framework-eve-server.js";const NEXT_PHASE_PRODUCTION_BUILD=`phase-production-build`,NEXT_PHASE_PRODUCTION_SERVER=`phase-production-server`,EVE_NEXT_HOST={label:`Next.js`,slug:`next`},globalStateSymbol=Symbol.for(`eve.next.state`);function getGlobalState(){let e=globalThis;return e[globalStateSymbol]??={servers:new Map},e[globalStateSymbol]}function readEveBaseUrlEnvironment(){let e=process.env.EVE_BASE_URL;if(e!==void 0&&e.trim().length!==0)return new URL(e).origin}async function ensureEveProductionServer(e){let t=getGlobalState(),n=`production:${e.appRoot}:${e.origin}`,r=t.servers.get(n);r===void 0&&(r=startEveProductionServer({appRoot:e.appRoot,host:EVE_NEXT_HOST,origin:e.origin}).catch(e=>{throw t.servers.delete(n),e}),t.servers.set(n,r)),await r}async function resolveEveDestinationPrefix(e){if(process.env.NODE_ENV===`production`)return e.productionDestinationPrefix;let t=readEveBaseUrlEnvironment();if(t!==void 0)return t;if(process.env.NODE_ENV!==`development`)return e.productionDestinationPrefix;let n=getGlobalState(),r=`dev:${e.appRoot}`,i=n.servers.get(r);return i===void 0&&(i=resolveSharedEveDevServer({appRoot:e.appRoot,host:EVE_NEXT_HOST,logLabel:e.logLabel,timeoutMs:e.devServerTimeoutMs,workspaceAgentName:e.workspaceAgentName}).catch(e=>{throw n.servers.delete(r),e}),n.servers.set(r,i)),(await i).origin}export{EVE_NEXT_HOST,NEXT_PHASE_PRODUCTION_BUILD,NEXT_PHASE_PRODUCTION_SERVER,ensureEveProductionServer,resolveEveDestinationPrefix};
+import{resolveSharedEveDevServer,startEveProductionServer}from"#shared/framework-eve-server.js";const NEXT_PHASE_PRODUCTION_BUILD=`phase-production-build`,NEXT_PHASE_PRODUCTION_SERVER=`phase-production-server`,EVE_NEXT_HOST={label:`Next.js`,slug:`next`},globalStateSymbol=Symbol.for(`eve.next.state`);function getGlobalState(){let e=globalThis;return e[globalStateSymbol]??={servers:new Map},e[globalStateSymbol]}function readEveBaseUrlEnvironment(){let e=process.env.EVE_BASE_URL;if(e!==void 0&&e.trim().length!==0)return new URL(e).origin}async function ensureEveProductionServer(e){let t=getGlobalState(),n=`production:${e.appRoot}:${e.origin}`,r=t.servers.get(n);r===void 0&&(r=startEveProductionServer({appRoot:e.appRoot,host:EVE_NEXT_HOST,origin:e.origin,portRetryHint:`set EVE_NEXT_PRODUCTION_PORT to another port`}).catch(e=>{throw t.servers.delete(n),e}),t.servers.set(n,r)),await r}async function resolveEveDestinationPrefix(e){if(process.env.NODE_ENV===`production`)return e.productionDestinationPrefix;let t=readEveBaseUrlEnvironment();if(t!==void 0)return t;if(process.env.NODE_ENV!==`development`)return e.productionDestinationPrefix;let n=getGlobalState(),r=`dev:${e.appRoot}`,i=n.servers.get(r);return i===void 0&&(i=resolveSharedEveDevServer({appRoot:e.appRoot,host:EVE_NEXT_HOST,logLabel:e.logLabel,timeoutMs:e.devServerTimeoutMs,workspaceAgentName:e.workspaceAgentName}).catch(e=>{throw n.servers.delete(r),e}),n.servers.set(r,i)),(await i).origin}export{EVE_NEXT_HOST,NEXT_PHASE_PRODUCTION_BUILD,NEXT_PHASE_PRODUCTION_SERVER,ensureEveProductionServer,resolveEveDestinationPrefix};

package/dist/src/public/sandbox/docker-sandbox.d.ts

@@ -4,6 +4,11 @@ import type { SandboxNetworkOptions, SandboxNetworkPolicy } from "#shared/sandbo
 export type DockerSandboxPullPolicy = "if-not-present" | "always" | "never";
 /** Coarse-grained egress policy for one live Docker sandbox. */
 export type DockerSandboxNetworkPolicy = Extract<SandboxNetworkPolicy, "allow-all" | "deny-all">;
+/** Live sandbox capabilities exposed by a Docker environment. */
+export interface DockerSandboxSession extends SandboxSession {
+    /** Applies a coarse egress policy to the live container. */
+    setNetworkPolicy(policy: DockerSandboxNetworkPolicy): Promise<void>;
+}
 /** Options shared by every sandbox created from one Docker environment. */
 export interface DockerSandboxEnvironmentOptions {
     /** Base container image. Defaults to eve's published sandbox image. */
@@ -13,7 +18,7 @@ export interface DockerSandboxEnvironmentOptions {
     /** Base image pull behavior. @default "if-not-present" */
     readonly pullPolicy?: DockerSandboxPullPolicy;
     /** Idempotent setup captured in the prepared image. */
-    readonly prepare?: (sandbox: SandboxSession) => Promise<void> | void;
+    readonly prepare?: (sandbox: DockerSandboxSession) => Promise<void> | void;
 }
 /** Options applied when eve creates one live Docker sandbox. */
 export interface DockerSandboxRuntimeOptions extends SandboxNetworkOptions {

package/dist/src/public/sandbox/docker.d.ts

@@ -1,9 +1,2 @@
-import type { SandboxSession } from "#shared/sandbox-session.js";
-import type { DockerSandboxNetworkPolicy } from "#public/sandbox/docker-sandbox.js";
-/** Live sandbox capabilities exposed by a Docker environment. */
-export interface DockerSandboxSession extends SandboxSession {
-    /** Applies a coarse egress policy to the live container. */
-    setNetworkPolicy(policy: DockerSandboxNetworkPolicy): Promise<void>;
-}
 export { DockerSandbox, type DockerSandboxEnvironmentOptions, type DockerSandboxRuntimeOptions, } from "#sandbox/providers/docker.js";
-export type { DockerSandboxNetworkPolicy, DockerSandboxPullPolicy, } from "#public/sandbox/docker-sandbox.js";
+export type { DockerSandboxNetworkPolicy, DockerSandboxPullPolicy, DockerSandboxSession, } from "#public/sandbox/docker-sandbox.js";

package/dist/src/public/sandbox/index.d.ts

@@ -1,4 +1,4 @@
-export { defineParentSandbox, defineSandbox, type SandboxOpenArguments, type SandboxEnvironment, type SandboxSelector, type SandboxSelectorContext, type SandboxCommandResult, type SandboxProcess, type SandboxReadBinaryFileOptions, type SandboxReadFileOptions, type SandboxReadTextFileOptions, type SandboxRunOptions, type SandboxSession, type RuntimeSandboxSession, type RuntimeSandboxSessionFor, type SandboxSpawnOptions, type SandboxWriteBinaryFileOptions, type SandboxWriteFileOptions, type SandboxWriteTextFileOptions, } from "#public/definitions/sandbox.js";
+export { defineParentSandbox, defineSandbox, type SandboxOpenArguments, type SandboxEnvironment, type SandboxSelector, type SandboxSelectorContext, type SandboxCommandResult, type SandboxProcess, type SandboxReadBinaryFileOptions, type SandboxReadFileOptions, type SandboxReadTextFileOptions, type SandboxRunOptions, type SandboxSession, type RuntimeSandboxSession, type RuntimeSandboxSessionFor, type SandboxSpawnOptions, type SandboxRemovePathOptions, type SandboxWriteBinaryFileOptions, type SandboxWriteFileOptions, type SandboxWriteFilesOptions, type SandboxWriteTextFileOptions, } from "#public/definitions/sandbox.js";
 export { DefaultSandbox } from "#sandbox/providers/default.js";
-export type { DefaultSandboxEnvironmentOptions } from "#sandbox/providers/default.js";
-export type { SandboxNetworkOptions, SandboxNetworkPolicy, } from "#shared/sandbox-network-policy.js";
+export type { DefaultSandboxEnvironmentOptions, DefaultSandboxRuntimeOptions, DefaultSandboxSession, } from "#sandbox/providers/default.js";
+export type { SandboxNetworkMatch, SandboxNetworkMatcher, SandboxNetworkOptions, SandboxNetworkPolicy, SandboxNetworkRule, } from "#shared/sandbox-network-policy.js";