@finalai/final-agent-provider 0.6.2 → 0.7.0

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@finalai/final-agent-provider",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "private": false,
-  "description": "Final's provider package: serverless, remote and local harnesses; the computer and device sandboxes; the messaging, schedule and event channels.",
+  "description": "Final provider helpers for harnesses, computer and device sandboxes, the Final room surface, and external provider channels.",
   "license": "Apache-2.0",
   "files": [
     "dist",
@@ -101,16 +101,6 @@
       "import": "./dist/modules/channels/group-messaging.mjs",
       "default": "./dist/modules/channels/group-messaging.mjs"
     },
-    "./channels/agent-schedules": {
-      "types": "./dist/modules/channels/agent-schedules.d.mts",
-      "import": "./dist/modules/channels/agent-schedules.mjs",
-      "default": "./dist/modules/channels/agent-schedules.mjs"
-    },
-    "./channels/agent-events": {
-      "types": "./dist/modules/channels/agent-events.d.mts",
-      "import": "./dist/modules/channels/agent-events.mjs",
-      "default": "./dist/modules/channels/agent-events.mjs"
-    },
     "./package.json": "./package.json",
     "./channel-factories": {
       "types": "./dist/modules/channel-factories.d.mts",
@@ -211,6 +201,41 @@
       "types": "./dist/modules/sandboxes/egress-bootstrap.d.mts",
       "import": "./dist/modules/sandboxes/egress-bootstrap.mjs",
       "default": "./dist/modules/sandboxes/egress-bootstrap.mjs"
+    },
+    "./channels/slack": {
+      "types": "./dist/modules/channels/slack.d.mts",
+      "import": "./dist/modules/channels/slack.mjs",
+      "default": "./dist/modules/channels/slack.mjs"
+    },
+    "./channels/discord": {
+      "types": "./dist/modules/channels/discord.d.mts",
+      "import": "./dist/modules/channels/discord.mjs",
+      "default": "./dist/modules/channels/discord.mjs"
+    },
+    "./channels/github": {
+      "types": "./dist/modules/channels/github.d.mts",
+      "import": "./dist/modules/channels/github.mjs",
+      "default": "./dist/modules/channels/github.mjs"
+    },
+    "./channels/linear": {
+      "types": "./dist/modules/channels/linear.d.mts",
+      "import": "./dist/modules/channels/linear.mjs",
+      "default": "./dist/modules/channels/linear.mjs"
+    },
+    "./channels/webhook": {
+      "types": "./dist/modules/channels/webhook.d.mts",
+      "import": "./dist/modules/channels/webhook.mjs",
+      "default": "./dist/modules/channels/webhook.mjs"
+    },
+    "./channels/voice": {
+      "types": "./dist/modules/channels/voice.d.mts",
+      "import": "./dist/modules/channels/voice.mjs",
+      "default": "./dist/modules/channels/voice.mjs"
+    },
+    "./channels/phone": {
+      "types": "./dist/modules/channels/phone.d.mts",
+      "import": "./dist/modules/channels/phone.mjs",
+      "default": "./dist/modules/channels/phone.mjs"
     }
   },
   "publishConfig": {
@@ -219,14 +244,15 @@
   },
   "dependencies": {
     "@agentclientprotocol/sdk": "1.8.0",
-    "@finalai/acp-session": "0.1.10",
-    "@finalai/agent-protocol": "0.6.1",
-    "@finalai/agent-provider": "0.5.1",
-    "@finalai/computers": "0.3.0",
-    "@finalai/websockets": "0.1.6",
+    "@finalai/acp-session": "0.1.11",
+    "@finalai/agent-protocol": "0.7.0",
+    "@finalai/agent-provider": "0.6.0",
+    "@finalai/computers": "0.3.1",
+    "@finalai/websockets": "0.1.7",
     "ws": "^8.21.3",
-    "zod": "4.6.5",
-    "@finalai/agent-definition": "0.5.1"
+    "zod": "4.6.6",
+    "@finalai/agent-definition": "0.6.0",
+    "gemoji": "^8.1.0"
   },
   "engines": {
     "node": ">=26"

package/dist/modules/channels/address-context.d.mts

@@ -1,7 +0,0 @@
-import { TurnPolicy, type ChannelAddressContextIface, type ChannelPlatformIface } from '@finalai/agent-provider';
-export interface FinalAddressContextArgsIface {
-    platform: ChannelPlatformIface;
-    definitionId: string;
-    turnPolicy: TurnPolicy;
-}
-export declare const finalAddressContext: (args: FinalAddressContextArgsIface) => ChannelAddressContextIface;

package/dist/modules/channels/address-context.mjs

@@ -1,80 +0,0 @@
-import {
-  channelAccessors,
-  ParticipantKind,
-  TurnPolicy
-} from "@finalai/agent-provider";
-const finalAddressContext = (args) => {
-  const generic = channelAccessors(args.platform);
-  const operations = () => {
-    if (args.platform.channelSessions == null)
-      throw new Error("channel session operations are unavailable");
-    return args.platform.channelSessions;
-  };
-  const agentIn = async (address) => {
-    const participants = await args.platform.conversations.participants(address);
-    return participants.find(
-      (participant) => !participant.left && participant.kind === ParticipantKind.Agent && participant.definitionId === args.definitionId
-    ) ?? null;
-  };
-  const handle = (address, pinnedId) => {
-    const resolve = async () => {
-      if (pinnedId != null) return generic.attachSession(pinnedId).resolveSession();
-      const room = await address();
-      return room == null ? null : (await agentIn(room))?.sessionId ?? null;
-    };
-    const existing = async () => {
-      const sessionId = await resolve();
-      if (sessionId == null) throw new Error("Final channel address has no session");
-      return generic.attachSession(sessionId);
-    };
-    return {
-      inspect: async () => {
-        const sessionId = await resolve();
-        return sessionId == null ? null : generic.attachSession(sessionId).inspect();
-      },
-      resolveSession: resolve,
-      // Input to the room's agent from the sender's principal, never a message:
-      // accepted at once, delivered by the platform, the reply captioned in the room.
-      send: async (input) => {
-        const room = await address();
-        if (room == null) throw new Error("Final channel session has no room");
-        const agent = await agentIn(room);
-        if (agent == null) throw new Error("Final channel address is unavailable");
-        if (pinnedId != null && agent.sessionId !== pinnedId)
-          throw new Error("pinned Final session no longer owns this room");
-        return operations().send(
-          { conversationId: room, participantId: agent.id },
-          {
-            ...input,
-            turnPolicy: input.turnPolicy ?? args.turnPolicy,
-            source: input.source
-          }
-        );
-      },
-      respond: async (input) => (await existing()).respond(input),
-      cancel: async () => {
-        const sessionId = await resolve();
-        return sessionId == null ? { accepted: false } : generic.attachSession(sessionId).cancel();
-      },
-      close: async () => {
-        const sessionId = await resolve();
-        if (sessionId != null) await generic.attachSession(sessionId).close();
-      },
-      observe: async (input) => (await existing()).observe(input),
-      setConfigOption: async (input) => (await existing()).setConfigOption(input),
-      park: async () => (await existing()).park(),
-      getState: async () => (await existing()).getState(),
-      setState: async (state) => (await existing()).setState(state)
-    };
-  };
-  return {
-    from: (address) => handle(async () => address),
-    resolveSession: async (address) => (await agentIn(address))?.sessionId ?? null,
-    attachSession: (id) => handle(async () => (await generic.attachSession(id).inspect())?.conversationId ?? null, id),
-    to: generic.to
-  };
-};
-export {
-  finalAddressContext
-};
-//# sourceMappingURL=address-context.mjs.map

package/dist/modules/channels/address-context.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../src/channels/address-context.ts"],
-  "sourcesContent": ["import {\n  channelAccessors,\n  ParticipantKind,\n  TurnPolicy,\n  type ChannelAddressContextIface,\n  type ChannelPlatformIface,\n  type ChannelSessionHandleIface,\n} from '@finalai/agent-provider';\n\nexport interface FinalAddressContextArgsIface {\n  platform: ChannelPlatformIface;\n  definitionId: string;\n  turnPolicy: TurnPolicy;\n}\n\n// Final addresses are room IDs. The existing participant/session association\n// owns the room's session; a pinned handle never follows a replacement.\nexport const finalAddressContext = (\n  args: FinalAddressContextArgsIface,\n): ChannelAddressContextIface => {\n  const generic = channelAccessors(args.platform);\n  const operations = () => {\n    if (args.platform.channelSessions == null)\n      throw new Error('channel session operations are unavailable');\n    return args.platform.channelSessions;\n  };\n  const agentIn = async (address: string) => {\n    const participants = await args.platform.conversations.participants(address);\n    return (\n      participants.find(\n        (participant) =>\n          !participant.left &&\n          participant.kind === ParticipantKind.Agent &&\n          participant.definitionId === args.definitionId,\n      ) ?? null\n    );\n  };\n  const handle = (\n    address: () => Promise<string | null>,\n    pinnedId?: string,\n  ): ChannelSessionHandleIface => {\n    const resolve = async () => {\n      if (pinnedId != null) return generic.attachSession(pinnedId).resolveSession();\n      const room = await address();\n      return room == null ? null : ((await agentIn(room))?.sessionId ?? null);\n    };\n    const existing = async () => {\n      const sessionId = await resolve();\n      if (sessionId == null) throw new Error('Final channel address has no session');\n      return generic.attachSession(sessionId);\n    };\n    return {\n      inspect: async () => {\n        const sessionId = await resolve();\n        return sessionId == null ? null : generic.attachSession(sessionId).inspect();\n      },\n      resolveSession: resolve,\n      // Input to the room's agent from the sender's principal, never a message:\n      // accepted at once, delivered by the platform, the reply captioned in the room.\n      send: async (input) => {\n        const room = await address();\n        if (room == null) throw new Error('Final channel session has no room');\n        const agent = await agentIn(room);\n        if (agent == null) throw new Error('Final channel address is unavailable');\n        if (pinnedId != null && agent.sessionId !== pinnedId)\n          throw new Error('pinned Final session no longer owns this room');\n        return operations().send(\n          { conversationId: room, participantId: agent.id },\n          {\n            ...input,\n            turnPolicy: input.turnPolicy ?? args.turnPolicy,\n            source: input.source,\n          },\n        );\n      },\n      respond: async (input) => (await existing()).respond(input),\n      cancel: async () => {\n        const sessionId = await resolve();\n        return sessionId == null ? { accepted: false } : generic.attachSession(sessionId).cancel();\n      },\n      close: async () => {\n        const sessionId = await resolve();\n        if (sessionId != null) await generic.attachSession(sessionId).close();\n      },\n      observe: async (input) => (await existing()).observe(input),\n      setConfigOption: async (input) => (await existing()).setConfigOption(input),\n      park: async () => (await existing()).park(),\n      getState: async () => (await existing()).getState(),\n      setState: async (state) => (await existing()).setState(state),\n    };\n  };\n  return {\n    from: (address) => handle(async () => address),\n    resolveSession: async (address) => (await agentIn(address))?.sessionId ?? null,\n    attachSession: (id) =>\n      handle(async () => (await generic.attachSession(id).inspect())?.conversationId ?? null, id),\n    to: generic.to,\n  };\n};\n"],
-  "mappings": "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",
-  "names": []
-}

package/dist/modules/channels/agent-events.d.mts

@@ -1,103 +0,0 @@
-import { SandboxEventKind, TurnPolicy, type ChannelDefinitionIface, type ChannelReceiveContextIface, type ConversationRefIface, type JsonValue, type RouteArgsIface, type RouteDecisionIface } from '@finalai/agent-provider';
-import * as z from 'zod';
-export declare const AGENT_EVENTS_SPECIFIER = "@finalai/final-agent-provider/channels/agent-events";
-export declare const AGENT_EVENTS_TURN_POLICY = TurnPolicy.Steer;
-export declare const WEBHOOK_SECRET_NAME = "webhook";
-export declare const WEBHOOK_BODY_MAX_CHARS = 8000;
-export declare enum AgentEventKind {
-    Webhook = "webhook",
-    LinkedConversation = "linked-conversation",
-    Sandbox = "sandbox"
-}
-export { SandboxEventKind } from '@finalai/agent-provider';
-export declare const SYSTEM_EVENT_TEXT_MAX_CHARS = 4000;
-export declare enum LinkedConversationEvent {
-    Replied = "replied",
-    WaitingForPerson = "waiting_for_person",
-    Failed = "failed"
-}
-export declare const LINKED_CONVERSATION_TEXT_MAX_CHARS = 4000;
-declare const linkedConversationEventSchema: z.ZodObject<{
-    kind: z.ZodLiteral<AgentEventKind.LinkedConversation>;
-    conversationId: z.ZodString;
-    participantId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    linkId: z.ZodString;
-    linkedConversationId: z.ZodString;
-    linkedTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    event: z.ZodEnum<typeof LinkedConversationEvent>;
-    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    eventId: z.ZodString;
-    originTurnId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
-declare const sandboxEventSchema: z.ZodObject<{
-    kind: z.ZodLiteral<AgentEventKind.Sandbox>;
-    conversationId: z.ZodString;
-    participantId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    bindingId: z.ZodString;
-    sandboxName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    event: z.ZodEnum<typeof SandboxEventKind>;
-    processId: z.ZodString;
-    command: z.ZodString;
-    exitCode: z.ZodNullable<z.ZodNumber>;
-    stdout: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    stderr: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    eventId: z.ZodString;
-}, z.core.$strip>;
-export declare const agentEventInboundSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    kind: z.ZodLiteral<AgentEventKind.Webhook>;
-    body: z.ZodString;
-    contentType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    event: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    deliveryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<AgentEventKind.LinkedConversation>;
-    conversationId: z.ZodString;
-    participantId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    linkId: z.ZodString;
-    linkedConversationId: z.ZodString;
-    linkedTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    event: z.ZodEnum<typeof LinkedConversationEvent>;
-    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    eventId: z.ZodString;
-    originTurnId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<AgentEventKind.Sandbox>;
-    conversationId: z.ZodString;
-    participantId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    bindingId: z.ZodString;
-    sandboxName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    event: z.ZodEnum<typeof SandboxEventKind>;
-    processId: z.ZodString;
-    command: z.ZodString;
-    exitCode: z.ZodNullable<z.ZodNumber>;
-    stdout: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    stderr: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    eventId: z.ZodString;
-}, z.core.$strip>], "kind">;
-export type SandboxEventInboundIface = z.infer<typeof sandboxEventSchema>;
-export type AgentEventInboundIface = z.infer<typeof agentEventInboundSchema>;
-export declare enum ReceiveTargetKind {
-    BoundConversation = "bound-conversation",
-    OwnerDirect = "owner-direct"
-}
-export declare const targetedInboundSchema: z.ZodObject<{
-    target: z.ZodObject<{
-        kind: z.ZodEnum<typeof ReceiveTargetKind>;
-    }, z.core.$strip>;
-    content: z.ZodArray<z.ZodType<import("@finalai/agent-provider").JsonObject, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonObject, unknown>>>;
-    deliveryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
-export type TargetedInboundIface = z.infer<typeof targetedInboundSchema>;
-export type ChannelReceiveIface = (input: JsonValue, ctx: ChannelReceiveContextIface) => Promise<ConversationRefIface>;
-export declare const createTargetedInputReceive: (turnPolicy?: TurnPolicy) => ChannelReceiveIface;
-export declare const renderLinkedConversationEvent: (event: Pick<z.infer<typeof linkedConversationEventSchema>, "linkedTitle" | "event" | "text">) => string;
-export declare const renderSandboxEvent: (event: Pick<SandboxEventInboundIface, "processId" | "command" | "exitCode" | "stdout" | "stderr">) => string;
-export declare const routeToOwner: (participantId: string) => (args: RouteArgsIface) => RouteDecisionIface[];
-export declare const receiveAgentEvent: ChannelReceiveIface;
-export declare const hmacSha256Hex: (secret: string, body: string) => Promise<string>;
-export declare const verifyWebhookSignature: (args: {
-    secret: string;
-    body: string;
-    headers: Headers;
-}) => Promise<boolean>;
-export declare const createAgentEventsChannel: () => ChannelDefinitionIface<JsonValue, JsonValue>;

package/dist/modules/channels/agent-events.mjs

@@ -1,341 +0,0 @@
-import {
-  defineChannel,
-  Delivery,
-  jsonObjectSchema,
-  jsonValueSchema,
-  ParticipantKind,
-  SandboxEventKind,
-  TurnPolicy
-} from "@finalai/agent-provider";
-import * as z from "zod";
-import { contentBlocksOf } from "./content.mjs";
-import { textBlock } from "./prompt.mjs";
-import { routeMessage } from "./routing.mjs";
-import { sendServiceInput } from "./service-input.mjs";
-const AGENT_EVENTS_SPECIFIER = "@finalai/final-agent-provider/channels/agent-events";
-const AGENT_EVENTS_TURN_POLICY = TurnPolicy.Steer;
-const WEBHOOK_SECRET_NAME = "webhook";
-const WEBHOOK_BODY_MAX_CHARS = 8e3;
-var AgentEventKind = /* @__PURE__ */ ((AgentEventKind2) => {
-  AgentEventKind2["Webhook"] = "webhook";
-  AgentEventKind2["LinkedConversation"] = "linked-conversation";
-  AgentEventKind2["Sandbox"] = "sandbox";
-  return AgentEventKind2;
-})(AgentEventKind || {});
-import { SandboxEventKind as SandboxEventKind2 } from "@finalai/agent-provider";
-const SYSTEM_EVENT_TEXT_MAX_CHARS = 4e3;
-var LinkedConversationEvent = /* @__PURE__ */ ((LinkedConversationEvent2) => {
-  LinkedConversationEvent2["Replied"] = "replied";
-  LinkedConversationEvent2["WaitingForPerson"] = "waiting_for_person";
-  LinkedConversationEvent2["Failed"] = "failed";
-  return LinkedConversationEvent2;
-})(LinkedConversationEvent || {});
-const LINKED_CONVERSATION_TEXT_MAX_CHARS = 4e3;
-const webhookEventSchema = z.object({
-  kind: z.literal("webhook" /* Webhook */),
-  body: z.string(),
-  contentType: z.string().nullish(),
-  // A provider event name when the sender gives one (`x-github-event`).
-  event: z.string().nullish(),
-  deliveryId: z.string().nullish()
-});
-const linkedConversationEventSchema = z.object({
-  kind: z.literal("linked-conversation" /* LinkedConversation */),
-  // The conversation that linked the other: where its agent is prompted.
-  conversationId: z.string().min(1),
-  // The agent that handed the work off; the Default agent when absent.
-  participantId: z.string().min(1).nullish(),
-  linkId: z.string().min(1),
-  linkedConversationId: z.string().min(1),
-  linkedTitle: z.string().nullish(),
-  event: z.nativeEnum(LinkedConversationEvent),
-  // The reply (Replied) or what the agent asks for (WaitingForPerson).
-  text: z.string().nullish(),
-  // Makes a redelivered event post once (the turn or decision).
-  eventId: z.string().min(1),
-  originTurnId: z.string().nullish()
-});
-const sandboxEventSchema = z.object({
-  kind: z.literal("sandbox" /* Sandbox */),
-  conversationId: z.string().min(1),
-  // The agent participant whose session started the process: the only one told.
-  participantId: z.string().min(1).nullish(),
-  bindingId: z.string().min(1),
-  sandboxName: z.string().nullish(),
-  event: z.nativeEnum(SandboxEventKind),
-  processId: z.string().min(1),
-  command: z.string(),
-  // Null when the sandbox could not report one (the process was lost).
-  exitCode: z.number().int().nullable(),
-  // The end of the process's output.
-  stdout: z.string().nullish(),
-  stderr: z.string().nullish(),
-  // Makes a redelivered event post once (per binding).
-  eventId: z.string().min(1)
-});
-const agentEventInboundSchema = z.discriminatedUnion("kind", [
-  webhookEventSchema,
-  linkedConversationEventSchema,
-  sandboxEventSchema
-]);
-var ReceiveTargetKind = /* @__PURE__ */ ((ReceiveTargetKind2) => {
-  ReceiveTargetKind2["BoundConversation"] = "bound-conversation";
-  ReceiveTargetKind2["OwnerDirect"] = "owner-direct";
-  return ReceiveTargetKind2;
-})(ReceiveTargetKind || {});
-const targetedInboundSchema = z.object({
-  target: z.object({ kind: z.nativeEnum(ReceiveTargetKind) }),
-  content: z.array(jsonObjectSchema).min(1),
-  // Makes a redelivered input count once.
-  deliveryId: z.string().min(1).nullish()
-});
-const configSchema = z.looseObject({
-  displayName: z.string().min(1).nullish(),
-  // Owner direct conversation when the binding is attached to none; null for
-  // organization-owned agents, whose webhooks need a bound conversation.
-  ownerUserId: z.string().min(1).nullish()
-});
-const renderBody = (body, contentType) => {
-  let rendered = body;
-  if (contentType?.includes("json") === true) {
-    try {
-      rendered = JSON.stringify(jsonValueSchema.parse(JSON.parse(body)), null, 2);
-    } catch {
-      rendered = body;
-    }
-  }
-  return rendered.length <= WEBHOOK_BODY_MAX_CHARS ? rendered : `${rendered.slice(0, WEBHOOK_BODY_MAX_CHARS)}
-\u2026 (truncated)`;
-};
-const boundConversation = async (ctx) => ctx.bindingId == null ? null : ctx.platform.conversations.boundTo(ctx.bindingId);
-const ownerDirectConversation = async (ctx) => {
-  const config = configSchema.parse(ctx.config);
-  if (config.ownerUserId == null || ctx.definitionId == null) {
-    throw new Error(
-      `channel binding ${ctx.bindingId ?? "(none)"} is attached to no conversation and its agent has no owner to post to`
-    );
-  }
-  return ctx.platform.conversations.findOrCreateDirect({
-    organizationId: ctx.organizationId,
-    userId: config.ownerUserId,
-    definitionId: ctx.definitionId
-  });
-};
-const webhookConversation = async (ctx) => await boundConversation(ctx) ?? ownerDirectConversation(ctx);
-const targetConversation = async (target, ctx) => {
-  if (target === "owner-direct" /* OwnerDirect */) return ownerDirectConversation(ctx);
-  const bound = await boundConversation(ctx);
-  if (bound == null) {
-    throw new Error(`channel binding ${ctx.bindingId ?? "(none)"} is attached to no conversation`);
-  }
-  return bound;
-};
-const bindingAgent = async (conversation, ctx) => {
-  const agent = (await ctx.platform.conversations.participants(conversation.conversationId)).find(
-    (participant) => participant.kind === ParticipantKind.Agent && !participant.left && participant.definitionId === ctx.definitionId
-  );
-  if (agent == null) {
-    throw new Error(
-      `channel binding ${ctx.bindingId ?? "(none)"} has no agent in conversation ${conversation.conversationId}`
-    );
-  }
-  return agent.id;
-};
-const sendBindingInput = async (args) => {
-  const binding = args.ctx.bindingId ?? "none";
-  const name = configSchema.parse(args.ctx.config).displayName ?? "Webhook";
-  await sendServiceInput(args.ctx.platform, {
-    room: args.conversation.conversationId,
-    participantId: await bindingAgent(args.conversation, args.ctx),
-    content: args.content,
-    principal: { principalId: `binding:${binding}`, authenticator: "final" },
-    displayName: name,
-    idempotencyKey: `webhook:${binding}:${args.deliveryKey ?? crypto.randomUUID()}`,
-    label: `From ${name}`,
-    turnPolicy: args.turnPolicy
-  });
-  return { conversationId: args.conversation.conversationId };
-};
-const createTargetedInputReceive = (turnPolicy = TurnPolicy.Steer) => async (input, ctx) => {
-  const targeted = targetedInboundSchema.parse(input);
-  return sendBindingInput({
-    ctx,
-    conversation: await targetConversation(targeted.target.kind, ctx),
-    content: contentBlocksOf(targeted.content),
-    deliveryKey: targeted.deliveryId ?? null,
-    turnPolicy
-  });
-};
-const receiveTargetedInput = createTargetedInputReceive(AGENT_EVENTS_TURN_POLICY);
-const clip = (text) => text.length <= LINKED_CONVERSATION_TEXT_MAX_CHARS ? text : `${text.slice(0, LINKED_CONVERSATION_TEXT_MAX_CHARS)}
-\u2026 (truncated)`;
-const renderLinkedConversationEvent = (event) => {
-  const title = event.linkedTitle?.trim() ?? "";
-  const name = title.length === 0 ? "A linked conversation" : `"${title}"`;
-  const text = event.text?.trim() ?? "";
-  switch (event.event) {
-    case "replied" /* Replied */:
-      return text.length === 0 ? `${name} replied.` : `${name} replied:
-
-${clip(text)}`;
-    case "waiting_for_person" /* WaitingForPerson */:
-      return text.length === 0 ? `${name} is waiting for a person.` : `${name} is waiting for a person: ${clip(text)}`;
-    case "failed" /* Failed */:
-      return text.length === 0 ? `${name} stopped with an error.` : `${name} stopped with an error.
-
-${clip(text)}`;
-  }
-};
-const receiveLinkedConversationEvent = async (event, ctx) => {
-  const title = event.linkedTitle?.trim() ?? "";
-  await sendServiceInput(ctx.platform, {
-    room: event.conversationId,
-    participantId: event.participantId ?? void 0,
-    content: [textBlock(renderLinkedConversationEvent(event))],
-    principal: { principalId: `link:${event.linkId}`, authenticator: "final" },
-    displayName: title.length === 0 ? "Linked conversation" : title,
-    originTurnId: event.originTurnId ?? void 0,
-    idempotencyKey: `link:${event.linkId}:${event.eventId}`,
-    label: title.length === 0 ? "From a linked conversation" : `From \u201C${title}\u201D`
-  });
-  return { conversationId: event.conversationId };
-};
-const clipEnd = (text) => text.length <= SYSTEM_EVENT_TEXT_MAX_CHARS ? text : `\u2026 (truncated)
-${text.slice(text.length - SYSTEM_EVENT_TEXT_MAX_CHARS)}`;
-const outputSection = (label, output) => {
-  const text = output?.trimEnd() ?? "";
-  return text.length === 0 ? [] : [`${label}:
-\`\`\`
-${clipEnd(text)}
-\`\`\``];
-};
-const renderSandboxEvent = (event) => {
-  const outcome = event.exitCode == null ? "stopped without an exit code" : `exited with code ${event.exitCode}`;
-  return [
-    `Background process ${event.processId} (\`${event.command}\`) ${outcome}.`,
-    ...outputSection("stdout", event.stdout),
-    ...outputSection("stderr", event.stderr)
-  ].join("\n\n");
-};
-const routeToOwner = (participantId) => (args) => args.participants.some(
-  (participant) => participant.id === participantId && participant.kind === ParticipantKind.Agent && !participant.left
-) ? [{ participantId, delivery: Delivery.Prompt }] : [];
-const nonEmptyOr = (value, fallback) => {
-  const trimmed = value?.trim() ?? "";
-  return trimmed.length === 0 ? fallback : trimmed;
-};
-const receiveSandboxEvent = async (event, ctx) => {
-  const name = nonEmptyOr(event.sandboxName, "Sandbox");
-  const args = {
-    room: event.conversationId,
-    participantId: event.participantId ?? void 0,
-    content: [textBlock(renderSandboxEvent(event))],
-    principal: { principalId: `sandbox:${event.bindingId}`, authenticator: "final" },
-    displayName: name,
-    idempotencyKey: `sandbox:${event.bindingId}:${event.eventId}`,
-    label: `After a process in ${name} finished`
-  };
-  await sendServiceInput(ctx.platform, args);
-  return { conversationId: event.conversationId };
-};
-const receiveAgentEvent = async (input, ctx) => {
-  if (targetedInboundSchema.safeParse(input).success) return receiveTargetedInput(input, ctx);
-  const event = agentEventInboundSchema.parse(input);
-  if (event.kind === "webhook" /* Webhook */) {
-    const name = configSchema.parse(ctx.config).displayName ?? "Webhook";
-    const heading = event.event == null ? `${name} event` : `${name} event: ${event.event}`;
-    return sendBindingInput({
-      ctx,
-      conversation: await webhookConversation(ctx),
-      content: [textBlock(`${heading}
-
-${renderBody(event.body, event.contentType ?? null)}`)],
-      deliveryKey: event.deliveryId ?? null
-    });
-  }
-  if (event.kind === "linked-conversation" /* LinkedConversation */) {
-    return receiveLinkedConversationEvent(event, ctx);
-  }
-  return receiveSandboxEvent(event, ctx);
-};
-const hex = (bytes) => [...new Uint8Array(bytes)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
-const constantTimeEqual = (left, right) => {
-  if (left.length !== right.length) return false;
-  let difference = 0;
-  for (let index = 0; index < left.length; index += 1) {
-    difference |= left.charCodeAt(index) ^ right.charCodeAt(index);
-  }
-  return difference === 0;
-};
-const hmacSha256Hex = async (secret, body) => {
-  const encoder = new TextEncoder();
-  const key = await crypto.subtle.importKey(
-    "raw",
-    encoder.encode(secret),
-    { name: "HMAC", hash: "SHA-256" },
-    false,
-    ["sign"]
-  );
-  return hex(await crypto.subtle.sign("HMAC", key, encoder.encode(body)));
-};
-const verifyWebhookSignature = async (args) => {
-  const header = args.headers.get("x-final-signature") ?? args.headers.get("x-hub-signature-256");
-  if (header == null) return false;
-  const provided = header.startsWith("sha256=") ? header.slice("sha256=".length) : header;
-  return constantTimeEqual(provided.toLowerCase(), await hmacSha256Hex(args.secret, args.body));
-};
-const webhookRoute = {
-  method: "POST",
-  path: "/",
-  handler: async ({ request, secrets, receive }) => {
-    const secret = await secrets.get(WEBHOOK_SECRET_NAME);
-    if (secret == null) {
-      return Response.json({ error: "webhook secret is not configured" }, { status: 503 });
-    }
-    const body = await request.text();
-    if (!await verifyWebhookSignature({ secret, body, headers: request.headers })) {
-      return Response.json({ error: "invalid signature" }, { status: 401 });
-    }
-    const ref = await receive({
-      kind: "webhook" /* Webhook */,
-      body,
-      contentType: request.headers.get("content-type"),
-      event: request.headers.get("x-github-event") ?? request.headers.get("x-final-event"),
-      deliveryId: request.headers.get("x-github-delivery") ?? request.headers.get("x-final-delivery")
-    });
-    if (ref == null || !("conversationId" in ref))
-      throw new Error("agent event channel returned no conversation");
-    return Response.json({ ok: true, conversationId: ref.conversationId }, { status: 202 });
-  }
-};
-const createAgentEventsChannel = () => defineChannel({
-  routes: [webhookRoute],
-  receive: receiveAgentEvent,
-  route: routeMessage,
-  turnPolicy: AGENT_EVENTS_TURN_POLICY,
-  project: async () => {
-  }
-});
-export {
-  AGENT_EVENTS_SPECIFIER,
-  AGENT_EVENTS_TURN_POLICY,
-  AgentEventKind,
-  LINKED_CONVERSATION_TEXT_MAX_CHARS,
-  LinkedConversationEvent,
-  ReceiveTargetKind,
-  SYSTEM_EVENT_TEXT_MAX_CHARS,
-  SandboxEventKind2 as SandboxEventKind,
-  WEBHOOK_BODY_MAX_CHARS,
-  WEBHOOK_SECRET_NAME,
-  agentEventInboundSchema,
-  createAgentEventsChannel,
-  createTargetedInputReceive,
-  hmacSha256Hex,
-  receiveAgentEvent,
-  renderLinkedConversationEvent,
-  renderSandboxEvent,
-  routeToOwner,
-  targetedInboundSchema,
-  verifyWebhookSignature
-};
-//# sourceMappingURL=agent-events.mjs.map