@finalai/final-agent-provider 0.6.2 → 0.7.0

package/HOSTING.md

@@ -240,7 +240,7 @@ before running. Shared manifest resolution rejects null results for required slo
 even if a host catches a resolver exception and returns null. Hosts must propagate
 that failure to startup. Session-started values stay pinned across turns and resume.
 
-This PR adds no configuration UI. A host can use the compiled requirements to show
+Hosts can use the compiled requirements to show
 which names need configuration and return an actionable deployment-specific error.
 
 ## Host integration
@@ -269,6 +269,6 @@ Optional readers preserve source compatibility with existing hosts. Definitions
 requesting bindings fail clearly if hosting does not provide them. Installing these
 packages alone does not change Final's deployed service wiring or provision secrets.
 
-New compiles emit manifest version 3, so older hosts reject them rather than
-stripping required-binding metadata. Updated readers still accept persisted
-version 2 revisions. Upgrade hosting before publishing newly compiled agents.
+New compiles emit manifest version 4. Hosts and stored revisions must use v4;
+recompile older definitions before loading them. Upgrade hosting before
+publishing newly compiled agents.

package/README.md

@@ -1,7 +1,7 @@
 # @finalai/final-agent-provider
 
-Pure configuration helpers for Final harnesses, computer/device sandboxes, and
-channels. Import helpers from `/harnesses`, `/sandboxes`, or `/channels/final`.
+Provider helpers for harnesses, computer and device sandboxes, the Final room, and
+external channels. Import helpers from `/harnesses`, `/sandboxes`, or `/channels/final`.
 `/connections` provides `defineFinalConnection` for session-scoped Final MCP access.
 
 Optional Node ACP adapters are exposed under `/runtime/*`. Sandbox adapters use
@@ -41,3 +41,95 @@ In 0.4, passive Computer recovery follows the read-only viewer contract even wit
 a networking extension. Use ordinary resume for execution. The bundled adapters
 cache deferred setup failures per handle; reconnect to retry rather than replaying
 partially completed user setup commands on each MCP poll.
+
+## Provider channels
+
+Use the same provider package with your own app or a shared installation:
+
+```ts
+import { slackChannel } from '@finalai/final-agent-provider/channels/slack';
+export default slackChannel();
+```
+
+Factories also exist for Discord, GitHub, Linear, authenticated webhooks, voice,
+and Twilio phone calls. Slack uses a separate OpenID identity flow; Linear uses
+`actor=user` for identity proof and `actor=app` for application installation.
+Provider principals are never matched by email. Slack Enterprise Grid principals
+use the enterprise user/enterprise namespace when available.
+
+Slack installs are scoped to a workspace, including workspaces in Enterprise Grid. Organization-wide installs with no workspace claim are rejected; install the app in each workspace that should connect. Discord guilds share the installed application bot token. Slack group direct messages are not subscribed; use a direct message or mention the app in a workspace channel.
+
+Slack and Discord default to `history: 'none'`. Opt into `linked-members` to send
+only currently linked members' thread history to the agent. Shared places default
+to member-only input and origin-only replies. Configure `replies: all` explicitly
+to mirror the chat. Provider signature verification is required on `/webhook`;
+Discord also maintains a Gateway listener without the privileged message-content
+intent. Requests must still fit the provider application's installed scopes.
+
+`webhookChannel({secret})` verifies `X-Final-Signature: sha256=<HMAC hex>` over the
+raw body. Its envelope is `{place,label,content,idempotencyKey,context?}`. Connect
+its place before delivering events. Retries reuse the event's idempotency key.
+
+`voiceChannel()` verifies a Final OAuth identity with PKCE, then serves `/stream`.
+A JSON `start` frame selects PCM16 at 16 kHz and the authenticated principal;
+binary frames carry microphone samples. `cancel` interrupts a turn and `stop`
+finishes input while output drains. Only `speech.end` with `final: true` marks
+the drained terminal response; per-turn ends use `final: false`. Server frames report transcripts, speech
+boundaries, stage timestamps and errors, interleaved with binary PCM output.
+An `error` with `recoverable: true` is advisory; other error frames are terminal.
+A `notice` ends microphone capture while its spoken explanation drains. Stop
+sending audio, display the notice and continue playback until the terminal
+`speech.end`, including when the server ends the call without a client `stop`.
+Only final utterances are posted. Once-only permission choices and empty-schema
+confirmations can be answered by voice; other forms remain in Final. When recording is enabled, the channel attaches recordings without starting another turn.
+Clients opt in to recording in the start frame after displaying the recording notice.
+Saved recordings are PCM16 WAV attachments, split below 10 MiB including base64 serialization.
+
+`phoneChannel({accountSid,fromNumber})` adapts the same core to signed Twilio call
+webhooks and 8 kHz mu-law streams. It uses the declared `twilio-auth-token` secret
+and an SMS challenge for identity. An unlinked member caller receives the account-link
+URL by SMS, signs in and verifies their number, then calls again. Each linked call also requires a fresh SMS code
+entered on the call; caller ID alone cannot act as a member. Configure `audience:'anyone'` explicitly for
+anonymous support calls; those calls use captioned input and group defaults.
+
+Provider delivery receipts expire after 90 days; later provider edits may no longer find their original delivery.
+Provider mutation support varies: Slack, Discord and GitHub update bot-owned
+replies. Linear activities are emitted as separate entries and are not edited by
+this adapter. GitHub has no inbound reaction
+webhook. Final room customization remains `finalChannel` from `/channels/final`.
+
+Slack direct-message replies stay in a thread under the original request, so each
+reply, edit and reaction remains associated with its source message. Approvals
+show the requested action and the provider's one-time option names. Ambiguous
+spoken answers and decisions that require a form must be answered in Final;
+channels do not offer permanent approval choices.
+
+Slack Grid workspace removals revoke that workspace's routes and identities. An
+enterprise identity remains linked while another workspace has successfully
+proven an active grant. Tracking is bounded to 256 workspaces per enterprise;
+overflow conservatively requires enterprise identities to link again after the
+next workspace removal. Phone verification requests use a per-number cooldown.
+
+Configure Slack's `/final` slash command and interactivity callback in your app
+settings. Register Discord's `/final` application command with `connect`,
+`disconnect` and `unlink` subcommands. The SDK handles dispatched commands and
+keeps your application's command registry under your control.
+
+`replies: all` mirrors new messages. Slack, Discord, and GitHub can edit or remove
+existing copies and synchronize supported reactions while their delivery receipts
+are retained. Missing or deleted copies are not recreated by later mutations.
+Apps can modify only messages they own. The Linear adapter does not propagate
+Final edits, removals, or reactions to its activity entries. Provider permissions
+and receipt retention limit later synchronization.
+
+Hosts that terminate TLS upstream must give channel routes the public request URL,
+including its scheme; Twilio verifies the complete URL. Voice closes a connection
+if pending microphone audio exceeds 2 MiB instead of retaining an unbounded queue.
+Discord guild removal ends that guild's connections while preserving identity
+proofs usable in other guilds or direct messages.
+
+Discord guild history is limited to content the bot can read without privileged
+message-content access, such as mentions; unavailable content is omitted. GitHub
+installation suspension pauses incoming delivery without deleting connections;
+unsuspending resumes it. Voice synthesizes text replies through the configured
+speech service; audio attachments remain available in Final.

package/dist/modules/authoring-final-channel.mjs

@@ -1,9 +1,9 @@
-import { defineProviderChannel } from "@finalai/agent-definition/authoring";
+import { defineRoomSurface } from "@finalai/agent-definition/authoring";
 import {
   finalChannel as createFinalChannel
 } from "./channel-factories.mjs";
 export * from "./channel-factories.mjs";
-const finalChannel = (options = {}) => defineProviderChannel(createFinalChannel(options));
+const finalChannel = (options = {}) => defineRoomSurface(createFinalChannel(options));
 export {
   finalChannel
 };

package/dist/modules/authoring-final-channel.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/authoring-final-channel.ts"],
-  "sourcesContent": ["import { defineProviderChannel } from '@finalai/agent-definition/authoring';\nimport {\n  finalChannel as createFinalChannel,\n  type FinalChannelOptionsIface,\n} from \"./channel-factories.mjs\";\nexport * from \"./channel-factories.mjs\";\nexport const finalChannel = (\n  options: FinalChannelOptionsIface = {},\n): ReturnType<typeof createFinalChannel> => defineProviderChannel(createFinalChannel(options));\n"],
-  "mappings": "AAAA,SAAS,6BAA6B;AACtC;AAAA,EACE,gBAAgB;AAAA,OAEX;AACP,cAAc;AACP,MAAM,eAAe,CAC1B,UAAoC,CAAC,MACK,sBAAsB,mBAAmB,OAAO,CAAC;",
+  "sourcesContent": ["import { defineRoomSurface } from '@finalai/agent-definition/authoring';\nimport {\n  finalChannel as createFinalChannel,\n  type FinalChannelOptionsIface,\n} from \"./channel-factories.mjs\";\nexport * from \"./channel-factories.mjs\";\nexport const finalChannel = (\n  options: FinalChannelOptionsIface = {},\n): ReturnType<typeof createFinalChannel> => defineRoomSurface(createFinalChannel(options));\n"],
+  "mappings": "AAAA,SAAS,yBAAyB;AAClC;AAAA,EACE,gBAAgB;AAAA,OAEX;AACP,cAAc;AACP,MAAM,eAAe,CAC1B,UAAoC,CAAC,MACK,kBAAkB,mBAAmB,OAAO,CAAC;",
   "names": []
 }

package/dist/modules/channel-factories.d.mts

@@ -1,6 +1,5 @@
 import type { SessionUpdate } from '@agentclientprotocol/sdk/experimental/v2';
-import { TurnPolicy, type ChannelAddressContextIface, type ChannelAuthIface, type ChannelDefinitionIface, type ChannelInputReceiptIface, type ChannelInputResponseIface, type ChannelMessageCompletedDataIface, type ChannelMessageDeltaDataIface, type ChannelReceiveContextIface, type ChannelTurnEventDataIface, type ChannelTurnStateIface, type ConversationMessageIface, type DecisionCreatedDataIface, type DecisionResolvedDataIface, type JsonValue } from '@finalai/agent-provider';
-import { type ServiceInputArgsIface } from "./channels/service-input.mjs";
+import { TurnPolicy, type ChannelAuthIface, type RoomSurfaceDefinitionIface, type ChannelInputResponseIface, type ChannelMessageCompletedDataIface, type ChannelMessageDeltaDataIface, type RoomReceiveContextIface, type ChannelTurnEventDataIface, type ChannelTurnStateIface, type ConversationMessageIface, type DecisionCreatedDataIface, type DecisionResolvedDataIface, type JsonValue } from '@finalai/agent-provider';
 export declare const FINAL_CHANNEL_SPECIFIER = "@finalai/final-agent-provider/channels/final";
 export { ChannelPrincipalType, type ChannelAuthIface } from '@finalai/agent-provider';
 export interface ChannelAdmissionIface {
@@ -8,13 +7,12 @@ export interface ChannelAdmissionIface {
     context?: string[];
     title?: string;
 }
-export interface FinalMessageContextIface extends ChannelReceiveContextIface, ChannelAddressContextIface {
+export interface FinalMessageContextIface extends RoomReceiveContextIface {
     defaultAuth: ChannelAuthIface | null;
 }
-export interface FinalChannelContextIface extends ChannelAddressContextIface {
+export interface FinalChannelContextIface {
     final: {
         post(message: ChannelMessageCompletedDataIface['message']): Promise<ConversationMessageIface>;
-        sendServiceInput(args: ServiceInputArgsIface): Promise<ChannelInputReceiptIface>;
     };
 }
 export interface FinalSessionContextIface {
@@ -34,10 +32,10 @@ export interface FinalChannelEventHandlersIface {
 export interface FinalChannelOptionsIface {
     turnPolicy?: TurnPolicy | `${TurnPolicy}`;
     updateIntervalMs?: number;
-    route?: ChannelDefinitionIface<JsonValue, JsonValue>['route'];
+    route?: RoomSurfaceDefinitionIface<JsonValue, JsonValue>['route'];
     onMessage?: (ctx: FinalMessageContextIface, message: ConversationMessageIface) => ChannelAdmissionIface | null | Promise<ChannelAdmissionIface | null>;
     onInputResponse?: (ctx: FinalMessageContextIface, response: ChannelInputResponseIface) => ChannelAdmissionIface | null | Promise<ChannelAdmissionIface | null>;
     events?: FinalChannelEventHandlersIface;
     renderer?: (update: SessionUpdate, channel: FinalChannelContextIface, ctx: FinalSessionContextIface, next: () => Promise<void>) => void | Promise<void>;
 }
-export declare const finalChannel: (inputOptions?: FinalChannelOptionsIface) => ChannelDefinitionIface<JsonValue, JsonValue>;
+export declare const finalChannel: (inputOptions?: FinalChannelOptionsIface) => RoomSurfaceDefinitionIface<JsonValue, JsonValue>;

package/dist/modules/channel-factories.mjs

@@ -2,21 +2,18 @@ import {
   ChannelPrincipalType,
   SemanticChannelEventKind,
   TurnPolicy,
-  channelAccessors,
   channelAuthSchema,
   channelMessageCompletedSchema,
   decisionCreatedDataSchema,
   decisionResolvedDataSchema,
-  defineChannel,
+  defineRoomSurface,
   jsonObjectSchema,
   packageRef
 } from "@finalai/agent-provider";
 import * as z from "zod";
-import { finalAddressContext } from "./channels/address-context.mjs";
 import { contentBlocksOf } from "./channels/content.mjs";
 import { conversationEventInboundSchema, messageInboundSchema } from "./channels/inbound.mjs";
 import { createMessagingChannel } from "./channels/messaging-channel.mjs";
-import { sendServiceInput } from "./channels/service-input.mjs";
 const FINAL_CHANNEL_SPECIFIER = "@finalai/final-agent-provider/channels/final";
 import { ChannelPrincipalType as ChannelPrincipalType2 } from "@finalai/agent-provider";
 const admissionSchema = z.object({
@@ -38,21 +35,6 @@ const defaultAuthOf = (author) => {
     attributes: { participant_id: author.id }
   };
 };
-const handoffSchema = z.object({
-  target: z.object({
-    conversationId: z.string().min(1),
-    participantId: z.string().min(1).optional()
-  }),
-  content: z.array(jsonObjectSchema).min(1),
-  idempotencyKey: z.string().min(1),
-  auth: channelAuthSchema,
-  context: z.array(z.string()).optional(),
-  title: z.string().optional(),
-  actingUserId: z.string().min(1).optional(),
-  originTurnId: z.string().min(1).optional(),
-  source: z.object({ label: z.string().min(1) }).optional(),
-  turnPolicy: z.nativeEnum(TurnPolicy).optional()
-});
 const finalChannel = (inputOptions = {}) => {
   const options = {
     ...inputOptions,
@@ -82,20 +64,6 @@ const finalChannel = (inputOptions = {}) => {
   const base = createMessagingChannel({ ...config, route: options.route });
   const receive = async (input, ctx) => {
     if (conversationEventInboundSchema.safeParse(input).success) return base.receive(input, ctx);
-    const handoff = handoffSchema.safeParse(input);
-    if (handoff.success) {
-      if (ctx.platform.channelSessions == null)
-        throw new Error("channel session operations are unavailable");
-      const { target, ...rest } = handoff.data;
-      await ctx.platform.channelSessions.send(target, {
-        ...rest,
-        content: contentBlocksOf(rest.content),
-        source: rest.source,
-        // The sender's policy, else the receiving channel's.
-        turnPolicy: rest.turnPolicy ?? config.turnPolicy
-      });
-      return { conversationId: target.conversationId };
-    }
     const parsed = messageInboundSchema.parse(input);
     const participants = ctx.participants ?? await ctx.platform.conversations.participants(parsed.conversationId);
     const author = participants.find(
@@ -108,11 +76,6 @@ const finalChannel = (inputOptions = {}) => {
     if (ctx.definitionId == null) throw new Error("Final channel has no agent definition");
     const messageContext = {
       ...ctx,
-      ...finalAddressContext({
-        platform: ctx.platform,
-        definitionId: ctx.definitionId,
-        turnPolicy: config.turnPolicy
-      }),
       defaultAuth: defaultAuthOf(author)
     };
     const accepted = options.onMessage == null ? { auth: messageContext.defaultAuth } : await options.onMessage(messageContext, message);
@@ -147,11 +110,6 @@ const finalChannel = (inputOptions = {}) => {
     if (conversation == null || agentParticipant == null || agentParticipant.definitionId == null)
       throw new Error("Final platform context requires a Final conversation");
     return {
-      ...finalAddressContext({
-        platform: ctx.platform,
-        definitionId: agentParticipant.definitionId,
-        turnPolicy: config.turnPolicy
-      }),
       final: {
         post: async (message) => {
           if (ctx.platform.conversations.dispatchMessage == null)
@@ -168,8 +126,7 @@ const finalChannel = (inputOptions = {}) => {
             messageId: posted.messageId
           });
           return posted;
-        },
-        sendServiceInput: (input) => sendServiceInput(ctx.platform, input)
+        }
       }
     };
   };
@@ -203,7 +160,7 @@ const finalChannel = (inputOptions = {}) => {
   for (const [kind, handler] of Object.entries(authoredEvents))
     if (handler != null) events[kind] = handler;
   return Object.freeze(
-    defineChannel({
+    defineRoomSurface({
       ...base,
       config: jsonObjectSchema.parse(config),
       installed: options.onMessage == null && options.onInputResponse == null && options.events == null && options.renderer == null && options.route == null ? packageRef(FINAL_CHANNEL_SPECIFIER) : void 0,
@@ -218,10 +175,7 @@ const finalChannel = (inputOptions = {}) => {
         const defaultAuth = defaultAuthOf(author);
         let admission = { auth: defaultAuth };
         if (options.onInputResponse != null) {
-          const accepted = await options.onInputResponse(
-            { ...ctx, ...channelAccessors(ctx.platform), defaultAuth },
-            input
-          );
+          const accepted = await options.onInputResponse({ ...ctx, defaultAuth }, input);
           if (accepted == null) return { resolved: false };
           admission = admissionSchema.parse(accepted);
         }

package/dist/modules/channel-factories.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/channel-factories.ts"],
-  "sourcesContent": ["import type { ContentBlock, SessionUpdate } from '@agentclientprotocol/sdk/experimental/v2';\nimport {\n  ChannelPrincipalType,\n  SemanticChannelEventKind,\n  TurnPolicy,\n  channelAccessors,\n  channelAuthSchema,\n  channelMessageCompletedSchema,\n  decisionCreatedDataSchema,\n  decisionResolvedDataSchema,\n  defineChannel,\n  jsonObjectSchema,\n  packageRef,\n  type ChannelAddressContextIface,\n  type ChannelAuthIface,\n  type ChannelDefinitionIface,\n  type ChannelEventHandler,\n  type ChannelInputReceiptIface,\n  type ChannelInputResponseIface,\n  type ChannelMessageCompletedDataIface,\n  type ChannelMessageDeltaDataIface,\n  type ChannelReceiveContextIface,\n  type ChannelTurnEventDataIface,\n  type ChannelTurnStateIface,\n  type ConversationMessageIface,\n  type DecisionCreatedDataIface,\n  type DecisionResolvedDataIface,\n  type JsonValue,\n  type ProjectionContextIface,\n} from '@finalai/agent-provider';\nimport * as z from 'zod';\nimport { finalAddressContext } from \"./channels/address-context.mjs\";\nimport { contentBlocksOf } from \"./channels/content.mjs\";\nimport { conversationEventInboundSchema, messageInboundSchema } from \"./channels/inbound.mjs\";\nimport { createMessagingChannel } from \"./channels/messaging-channel.mjs\";\nimport { sendServiceInput, type ServiceInputArgsIface } from \"./channels/service-input.mjs\";\n\nexport const FINAL_CHANNEL_SPECIFIER = '@finalai/final-agent-provider/channels/final';\n\nexport { ChannelPrincipalType, type ChannelAuthIface } from '@finalai/agent-provider';\n\nexport interface ChannelAdmissionIface {\n  auth: ChannelAuthIface | null;\n  context?: string[];\n  title?: string;\n}\n\nexport interface FinalMessageContextIface\n  extends ChannelReceiveContextIface, ChannelAddressContextIface {\n  defaultAuth: ChannelAuthIface | null;\n}\n\nexport interface FinalChannelContextIface extends ChannelAddressContextIface {\n  final: {\n    post(message: ChannelMessageCompletedDataIface['message']): Promise<ConversationMessageIface>;\n    // Input to a room's agent from a principal that is no member of the room.\n    sendServiceInput(args: ServiceInputArgsIface): Promise<ChannelInputReceiptIface>;\n  };\n}\nexport interface FinalSessionContextIface {\n  sessionId: string | null;\n  turnId: string;\n  state: ChannelTurnStateIface<JsonValue>;\n}\nexport type FinalChannelEventHandler<Data> = (\n  data: Data,\n  channel: FinalChannelContextIface,\n  ctx: FinalSessionContextIface,\n) => void | Promise<void>;\nexport interface FinalChannelEventHandlersIface {\n  'message.delta'?: FinalChannelEventHandler<ChannelMessageDeltaDataIface>;\n  'message.completed'?: FinalChannelEventHandler<ChannelMessageCompletedDataIface>;\n  'turn.started'?: FinalChannelEventHandler<ChannelTurnEventDataIface>;\n  'turn.completed'?: FinalChannelEventHandler<ChannelTurnEventDataIface>;\n  'decision.created'?: FinalChannelEventHandler<DecisionCreatedDataIface>;\n  'decision.resolved'?: FinalChannelEventHandler<DecisionResolvedDataIface>;\n}\n\nexport interface FinalChannelOptionsIface {\n  turnPolicy?: TurnPolicy | `${TurnPolicy}`;\n  updateIntervalMs?: number;\n  route?: ChannelDefinitionIface<JsonValue, JsonValue>['route'];\n  onMessage?: (\n    ctx: FinalMessageContextIface,\n    message: ConversationMessageIface,\n  ) => ChannelAdmissionIface | null | Promise<ChannelAdmissionIface | null>;\n  onInputResponse?: (\n    ctx: FinalMessageContextIface,\n    response: ChannelInputResponseIface,\n  ) => ChannelAdmissionIface | null | Promise<ChannelAdmissionIface | null>;\n  events?: FinalChannelEventHandlersIface;\n  renderer?: (\n    update: SessionUpdate,\n    channel: FinalChannelContextIface,\n    ctx: FinalSessionContextIface,\n    next: () => Promise<void>,\n  ) => void | Promise<void>;\n}\n\nconst admissionSchema = z.object({\n  auth: channelAuthSchema.nullable(),\n  context: z.array(z.string()).optional(),\n  title: z.string().optional(),\n});\n\nconst optionsSchema = z.object({\n  turnPolicy: z.nativeEnum(TurnPolicy).default(TurnPolicy.Steer),\n  updateIntervalMs: z.number().finite().nonnegative().optional(),\n});\n\n// A room member as a principal: a person by user id, an agent by definition id.\nconst defaultAuthOf = (\n  author: import('@finalai/agent-provider').ParticipantIface | undefined,\n): ChannelAuthIface | null => {\n  if (author == null) return null;\n  return {\n    principalId: author.userId ?? author.definitionId ?? author.id,\n    principalType: author.userId == null ? ChannelPrincipalType.Service : ChannelPrincipalType.User,\n    authenticator: 'final',\n    displayName: author.displayName,\n    attributes: { participant_id: author.id },\n  };\n};\n\n// A handoff from another of the agent's channels (`ctx.to('final', target)`).\nconst handoffSchema = z.object({\n  target: z.object({\n    conversationId: z.string().min(1),\n    participantId: z.string().min(1).optional(),\n  }),\n  content: z.array(jsonObjectSchema).min(1),\n  idempotencyKey: z.string().min(1),\n  auth: channelAuthSchema,\n  context: z.array(z.string()).optional(),\n  title: z.string().optional(),\n  actingUserId: z.string().min(1).optional(),\n  originTurnId: z.string().min(1).optional(),\n  source: z.object({ label: z.string().min(1) }).optional(),\n  turnPolicy: z.nativeEnum(TurnPolicy).optional(),\n});\n\nexport const finalChannel = (\n  inputOptions: FinalChannelOptionsIface = {},\n): ChannelDefinitionIface<JsonValue, JsonValue> => {\n  const options = {\n    ...inputOptions,\n    events: inputOptions.events == null ? undefined : { ...inputOptions.events },\n  };\n  const callbacks = {\n    onMessage: options.onMessage,\n    onInputResponse: options.onInputResponse,\n    renderer: options.renderer,\n    route: options.route,\n    ...options.events,\n  };\n  for (const [name, callback] of Object.entries(callbacks))\n    if (callback != null && !z.function().safeParse(callback).success)\n      throw new Error(`Final channel ${name} must be a function`);\n  const supportedEvents = new Set([\n    'message.delta',\n    'message.completed',\n    'turn.started',\n    'turn.completed',\n    'decision.created',\n    'decision.resolved',\n  ]);\n  for (const kind of Object.keys(options.events ?? {}))\n    if (!supportedEvents.has(kind)) throw new Error(`unsupported Final channel event: ${kind}`);\n  const config = optionsSchema.parse(options);\n  const base = createMessagingChannel({ ...config, route: options.route });\n  const receive: typeof base.receive = async (input, ctx) => {\n    if (conversationEventInboundSchema.safeParse(input).success) return base.receive(input, ctx);\n    const handoff = handoffSchema.safeParse(input);\n    if (handoff.success) {\n      if (ctx.platform.channelSessions == null)\n        throw new Error('channel session operations are unavailable');\n      const { target, ...rest } = handoff.data;\n      await ctx.platform.channelSessions.send(target, {\n        ...rest,\n        content: contentBlocksOf(rest.content),\n        source: rest.source,\n        // The sender's policy, else the receiving channel's.\n        turnPolicy: rest.turnPolicy ?? config.turnPolicy,\n      });\n      return { conversationId: target.conversationId };\n    }\n    const parsed = messageInboundSchema.parse(input);\n    const participants =\n      ctx.participants ?? (await ctx.platform.conversations.participants(parsed.conversationId));\n    const author = participants.find(\n      (participant) => participant.id === parsed.authorParticipantId,\n    );\n    const message =\n      ctx.message ??\n      (await ctx.platform.conversations.postMessage({\n        ...parsed,\n        content: contentBlocksOf(parsed.content),\n      }));\n    if (ctx.definitionId == null) throw new Error('Final channel has no agent definition');\n    const messageContext: FinalMessageContextIface = {\n      ...ctx,\n      ...finalAddressContext({\n        platform: ctx.platform,\n        definitionId: ctx.definitionId,\n        turnPolicy: config.turnPolicy,\n      }),\n      defaultAuth: defaultAuthOf(author),\n    };\n    const accepted =\n      options.onMessage == null\n        ? { auth: messageContext.defaultAuth }\n        : await options.onMessage(messageContext, message);\n    const admission = accepted == null ? null : admissionSchema.parse(accepted);\n    if (admission == null) return { conversationId: parsed.conversationId };\n    const context = admission.context ?? [];\n    const injected: ContentBlock[] = context.map((text) => ({ type: 'text', text }));\n    return base.receive(\n      {\n        ...parsed,\n        content: [...context.map((text) => ({ type: 'text', text })), ...parsed.content],\n      },\n      {\n        ...ctx,\n        platform: {\n          ...ctx.platform,\n          sessions: {\n            ...ctx.platform.sessions,\n            prompt: (args) =>\n              ctx.platform.sessions.prompt({\n                ...args,\n                auth: admission.auth,\n                title: admission.title,\n              }),\n          },\n        },\n        message: { ...message, content: [...injected, ...message.content] },\n      },\n    );\n  };\n  const channelContext = (ctx: ProjectionContextIface): FinalChannelContextIface => {\n    const { conversation, agentParticipant } = ctx;\n    if (conversation == null || agentParticipant == null || agentParticipant.definitionId == null)\n      throw new Error('Final platform context requires a Final conversation');\n    return {\n      ...finalAddressContext({\n        platform: ctx.platform,\n        definitionId: agentParticipant.definitionId,\n        turnPolicy: config.turnPolicy,\n      }),\n      final: {\n        post: async (message) => {\n          if (ctx.platform.conversations.dispatchMessage == null)\n            throw new Error('channel dispatch is unavailable');\n          const posted = await ctx.platform.conversations.postMessage({\n            conversationId: conversation.conversationId,\n            authorParticipantId: agentParticipant.id,\n            content: contentBlocksOf(message.content),\n            clientMessageId: `channel:${ctx.turn.id}:${message.id}`,\n            originTurnId: ctx.turn.id,\n          });\n          await ctx.platform.conversations.dispatchMessage({\n            conversationId: posted.conversationId,\n            messageId: posted.messageId,\n          });\n          return posted;\n        },\n        sendServiceInput: (input) => sendServiceInput(ctx.platform, input),\n      },\n    };\n  };\n  const sessionContext = (ctx: ProjectionContextIface): FinalSessionContextIface => ({\n    sessionId: ctx.sessionId ?? null,\n    turnId: ctx.turn.id,\n    state: ctx.state,\n  });\n  const wrap = <Data>(\n    schema: z.ZodType<Data>,\n    handler: FinalChannelEventHandler<Data> | undefined,\n  ): ChannelEventHandler | undefined =>\n    handler == null\n      ? undefined\n      : async (event, ctx) =>\n          handler(schema.parse(event.data), channelContext(ctx), sessionContext(ctx));\n  const authoredEvents = {\n    [SemanticChannelEventKind.MessageCompleted]: wrap(\n      channelMessageCompletedSchema,\n      options.events?.['message.completed'],\n    ),\n    [SemanticChannelEventKind.MessageDelta]: wrap(\n      z.object({ messageId: z.string(), delta: jsonObjectSchema }),\n      options.events?.['message.delta'],\n    ),\n    [SemanticChannelEventKind.TurnStarted]: wrap(\n      z.object({ turnId: z.string() }),\n      options.events?.['turn.started'],\n    ),\n    [SemanticChannelEventKind.TurnCompleted]: wrap(\n      z.object({ turnId: z.string(), stopReason: z.string().nullable() }),\n      options.events?.['turn.completed'],\n    ),\n    'decision.created': wrap(decisionCreatedDataSchema, options.events?.['decision.created']),\n    'decision.resolved': wrap(decisionResolvedDataSchema, options.events?.['decision.resolved']),\n  };\n  const events = { ...base.events };\n  for (const [kind, handler] of Object.entries(authoredEvents))\n    if (handler != null) events[kind] = handler;\n  return Object.freeze(\n    defineChannel({\n      ...base,\n      config: jsonObjectSchema.parse(config),\n      installed:\n        options.onMessage == null &&\n        options.onInputResponse == null &&\n        options.events == null &&\n        options.renderer == null &&\n        options.route == null\n          ? packageRef(FINAL_CHANNEL_SPECIFIER)\n          : undefined,\n      configure: (next) =>\n        finalChannel({ ...options, ...optionsSchema.parse({ ...config, ...next }) }),\n      receive,\n      respond: async (input, ctx) => {\n        const conversation = z.string().min(1).parse(ctx.conversationId);\n        const participants = await ctx.platform.conversations.participants(conversation);\n        const author = participants.find(\n          (participant) => participant.id === input.actorParticipantId,\n        );\n        const defaultAuth = defaultAuthOf(author);\n        let admission: ChannelAdmissionIface = { auth: defaultAuth };\n        if (options.onInputResponse != null) {\n          const accepted = await options.onInputResponse(\n            { ...ctx, ...channelAccessors(ctx.platform), defaultAuth },\n            input,\n          );\n          if (accepted == null) return { resolved: false };\n          admission = admissionSchema.parse(accepted);\n        }\n        if (ctx.platform.sessions.respond == null)\n          throw new Error('response submission is unavailable');\n        return ctx.platform.sessions.respond({ ...input, auth: admission.auth });\n      },\n      cancel: async (ctx) => {\n        if (ctx.agentParticipantId == null) return { accepted: false };\n        const conversation = z.string().min(1).parse(ctx.conversationId);\n        const participants = await ctx.platform.conversations.participants(conversation);\n        const agent = participants.find((participant) => participant.id === ctx.agentParticipantId);\n        if (agent?.sessionId == null) return { accepted: false };\n        await ctx.platform.sessions.cancel({\n          participantId: agent.id,\n          reason: ctx.cancelReason,\n          throughMessageSeq: ctx.cancelThroughMessageSeq,\n        });\n        return { accepted: true };\n      },\n      project: async (update, ctx) => {\n        const next = () =>\n          options.events?.['message.completed'] == null\n            ? base.project(update, ctx)\n            : Promise.resolve();\n        if (options.renderer != null) {\n          await options.renderer(update, channelContext(ctx), sessionContext(ctx), next);\n          return;\n        }\n        await next();\n      },\n      events: Object.freeze(events),\n    }),\n  );\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { ContentBlock, SessionUpdate } from '@agentclientprotocol/sdk/experimental/v2';\nimport {\n  ChannelPrincipalType,\n  SemanticChannelEventKind,\n  TurnPolicy,\n  channelAuthSchema,\n  channelMessageCompletedSchema,\n  decisionCreatedDataSchema,\n  decisionResolvedDataSchema,\n  defineRoomSurface,\n  jsonObjectSchema,\n  packageRef,\n  type ChannelAuthIface,\n  type RoomSurfaceDefinitionIface,\n  type RoomEventHandler,\n  type ChannelInputResponseIface,\n  type ChannelMessageCompletedDataIface,\n  type ChannelMessageDeltaDataIface,\n  type RoomReceiveContextIface,\n  type ChannelTurnEventDataIface,\n  type ChannelTurnStateIface,\n  type ConversationMessageIface,\n  type DecisionCreatedDataIface,\n  type DecisionResolvedDataIface,\n  type JsonValue,\n  type ProjectionContextIface,\n} from '@finalai/agent-provider';\nimport * as z from 'zod';\nimport { contentBlocksOf } from \"./channels/content.mjs\";\nimport { conversationEventInboundSchema, messageInboundSchema } from \"./channels/inbound.mjs\";\nimport { createMessagingChannel } from \"./channels/messaging-channel.mjs\";\n\nexport const FINAL_CHANNEL_SPECIFIER = '@finalai/final-agent-provider/channels/final';\n\nexport { ChannelPrincipalType, type ChannelAuthIface } from '@finalai/agent-provider';\n\nexport interface ChannelAdmissionIface {\n  auth: ChannelAuthIface | null;\n  context?: string[];\n  title?: string;\n}\n\nexport interface FinalMessageContextIface extends RoomReceiveContextIface {\n  defaultAuth: ChannelAuthIface | null;\n}\n\nexport interface FinalChannelContextIface {\n  final: {\n    post(message: ChannelMessageCompletedDataIface['message']): Promise<ConversationMessageIface>;\n  };\n}\nexport interface FinalSessionContextIface {\n  sessionId: string | null;\n  turnId: string;\n  state: ChannelTurnStateIface<JsonValue>;\n}\nexport type FinalChannelEventHandler<Data> = (\n  data: Data,\n  channel: FinalChannelContextIface,\n  ctx: FinalSessionContextIface,\n) => void | Promise<void>;\nexport interface FinalChannelEventHandlersIface {\n  'message.delta'?: FinalChannelEventHandler<ChannelMessageDeltaDataIface>;\n  'message.completed'?: FinalChannelEventHandler<ChannelMessageCompletedDataIface>;\n  'turn.started'?: FinalChannelEventHandler<ChannelTurnEventDataIface>;\n  'turn.completed'?: FinalChannelEventHandler<ChannelTurnEventDataIface>;\n  'decision.created'?: FinalChannelEventHandler<DecisionCreatedDataIface>;\n  'decision.resolved'?: FinalChannelEventHandler<DecisionResolvedDataIface>;\n}\n\nexport interface FinalChannelOptionsIface {\n  turnPolicy?: TurnPolicy | `${TurnPolicy}`;\n  updateIntervalMs?: number;\n  route?: RoomSurfaceDefinitionIface<JsonValue, JsonValue>['route'];\n  onMessage?: (\n    ctx: FinalMessageContextIface,\n    message: ConversationMessageIface,\n  ) => ChannelAdmissionIface | null | Promise<ChannelAdmissionIface | null>;\n  onInputResponse?: (\n    ctx: FinalMessageContextIface,\n    response: ChannelInputResponseIface,\n  ) => ChannelAdmissionIface | null | Promise<ChannelAdmissionIface | null>;\n  events?: FinalChannelEventHandlersIface;\n  renderer?: (\n    update: SessionUpdate,\n    channel: FinalChannelContextIface,\n    ctx: FinalSessionContextIface,\n    next: () => Promise<void>,\n  ) => void | Promise<void>;\n}\n\nconst admissionSchema = z.object({\n  auth: channelAuthSchema.nullable(),\n  context: z.array(z.string()).optional(),\n  title: z.string().optional(),\n});\n\nconst optionsSchema = z.object({\n  turnPolicy: z.nativeEnum(TurnPolicy).default(TurnPolicy.Steer),\n  updateIntervalMs: z.number().finite().nonnegative().optional(),\n});\n\n// A room member as a principal: a person by user id, an agent by definition id.\nconst defaultAuthOf = (\n  author: import('@finalai/agent-provider').ParticipantIface | undefined,\n): ChannelAuthIface | null => {\n  if (author == null) return null;\n  return {\n    principalId: author.userId ?? author.definitionId ?? author.id,\n    principalType: author.userId == null ? ChannelPrincipalType.Service : ChannelPrincipalType.User,\n    authenticator: 'final',\n    displayName: author.displayName,\n    attributes: { participant_id: author.id },\n  };\n};\n\nexport const finalChannel = (\n  inputOptions: FinalChannelOptionsIface = {},\n): RoomSurfaceDefinitionIface<JsonValue, JsonValue> => {\n  const options = {\n    ...inputOptions,\n    events: inputOptions.events == null ? undefined : { ...inputOptions.events },\n  };\n  const callbacks = {\n    onMessage: options.onMessage,\n    onInputResponse: options.onInputResponse,\n    renderer: options.renderer,\n    route: options.route,\n    ...options.events,\n  };\n  for (const [name, callback] of Object.entries(callbacks))\n    if (callback != null && !z.function().safeParse(callback).success)\n      throw new Error(`Final channel ${name} must be a function`);\n  const supportedEvents = new Set([\n    'message.delta',\n    'message.completed',\n    'turn.started',\n    'turn.completed',\n    'decision.created',\n    'decision.resolved',\n  ]);\n  for (const kind of Object.keys(options.events ?? {}))\n    if (!supportedEvents.has(kind)) throw new Error(`unsupported Final channel event: ${kind}`);\n  const config = optionsSchema.parse(options);\n  const base = createMessagingChannel({ ...config, route: options.route });\n  const receive: typeof base.receive = async (input, ctx) => {\n    if (conversationEventInboundSchema.safeParse(input).success) return base.receive(input, ctx);\n    const parsed = messageInboundSchema.parse(input);\n    const participants =\n      ctx.participants ?? (await ctx.platform.conversations.participants(parsed.conversationId));\n    const author = participants.find(\n      (participant) => participant.id === parsed.authorParticipantId,\n    );\n    const message =\n      ctx.message ??\n      (await ctx.platform.conversations.postMessage({\n        ...parsed,\n        content: contentBlocksOf(parsed.content),\n      }));\n    if (ctx.definitionId == null) throw new Error('Final channel has no agent definition');\n    const messageContext: FinalMessageContextIface = {\n      ...ctx,\n      defaultAuth: defaultAuthOf(author),\n    };\n    const accepted =\n      options.onMessage == null\n        ? { auth: messageContext.defaultAuth }\n        : await options.onMessage(messageContext, message);\n    const admission = accepted == null ? null : admissionSchema.parse(accepted);\n    if (admission == null) return { conversationId: parsed.conversationId };\n    const context = admission.context ?? [];\n    const injected: ContentBlock[] = context.map((text) => ({ type: 'text', text }));\n    return base.receive(\n      {\n        ...parsed,\n        content: [...context.map((text) => ({ type: 'text', text })), ...parsed.content],\n      },\n      {\n        ...ctx,\n        platform: {\n          ...ctx.platform,\n          sessions: {\n            ...ctx.platform.sessions,\n            prompt: (args) =>\n              ctx.platform.sessions.prompt({\n                ...args,\n                auth: admission.auth,\n                title: admission.title,\n              }),\n          },\n        },\n        message: { ...message, content: [...injected, ...message.content] },\n      },\n    );\n  };\n  const channelContext = (ctx: ProjectionContextIface): FinalChannelContextIface => {\n    const { conversation, agentParticipant } = ctx;\n    if (conversation == null || agentParticipant == null || agentParticipant.definitionId == null)\n      throw new Error('Final platform context requires a Final conversation');\n    return {\n      final: {\n        post: async (message) => {\n          if (ctx.platform.conversations.dispatchMessage == null)\n            throw new Error('channel dispatch is unavailable');\n          const posted = await ctx.platform.conversations.postMessage({\n            conversationId: conversation.conversationId,\n            authorParticipantId: agentParticipant.id,\n            content: contentBlocksOf(message.content),\n            clientMessageId: `channel:${ctx.turn.id}:${message.id}`,\n            originTurnId: ctx.turn.id,\n          });\n          await ctx.platform.conversations.dispatchMessage({\n            conversationId: posted.conversationId,\n            messageId: posted.messageId,\n          });\n          return posted;\n        },\n      },\n    };\n  };\n  const sessionContext = (ctx: ProjectionContextIface): FinalSessionContextIface => ({\n    sessionId: ctx.sessionId ?? null,\n    turnId: ctx.turn.id,\n    state: ctx.state,\n  });\n  const wrap = <Data>(\n    schema: z.ZodType<Data>,\n    handler: FinalChannelEventHandler<Data> | undefined,\n  ): RoomEventHandler | undefined =>\n    handler == null\n      ? undefined\n      : async (event, ctx) =>\n          handler(schema.parse(event.data), channelContext(ctx), sessionContext(ctx));\n  const authoredEvents = {\n    [SemanticChannelEventKind.MessageCompleted]: wrap(\n      channelMessageCompletedSchema,\n      options.events?.['message.completed'],\n    ),\n    [SemanticChannelEventKind.MessageDelta]: wrap(\n      z.object({ messageId: z.string(), delta: jsonObjectSchema }),\n      options.events?.['message.delta'],\n    ),\n    [SemanticChannelEventKind.TurnStarted]: wrap(\n      z.object({ turnId: z.string() }),\n      options.events?.['turn.started'],\n    ),\n    [SemanticChannelEventKind.TurnCompleted]: wrap(\n      z.object({ turnId: z.string(), stopReason: z.string().nullable() }),\n      options.events?.['turn.completed'],\n    ),\n    'decision.created': wrap(decisionCreatedDataSchema, options.events?.['decision.created']),\n    'decision.resolved': wrap(decisionResolvedDataSchema, options.events?.['decision.resolved']),\n  };\n  const events = { ...base.events };\n  for (const [kind, handler] of Object.entries(authoredEvents))\n    if (handler != null) events[kind] = handler;\n  return Object.freeze(\n    defineRoomSurface({\n      ...base,\n      config: jsonObjectSchema.parse(config),\n      installed:\n        options.onMessage == null &&\n        options.onInputResponse == null &&\n        options.events == null &&\n        options.renderer == null &&\n        options.route == null\n          ? packageRef(FINAL_CHANNEL_SPECIFIER)\n          : undefined,\n      configure: (next) =>\n        finalChannel({ ...options, ...optionsSchema.parse({ ...config, ...next }) }),\n      receive,\n      respond: async (input, ctx) => {\n        const conversation = z.string().min(1).parse(ctx.conversationId);\n        const participants = await ctx.platform.conversations.participants(conversation);\n        const author = participants.find(\n          (participant) => participant.id === input.actorParticipantId,\n        );\n        const defaultAuth = defaultAuthOf(author);\n        let admission: ChannelAdmissionIface = { auth: defaultAuth };\n        if (options.onInputResponse != null) {\n          const accepted = await options.onInputResponse({ ...ctx, defaultAuth }, input);\n          if (accepted == null) return { resolved: false };\n          admission = admissionSchema.parse(accepted);\n        }\n        if (ctx.platform.sessions.respond == null)\n          throw new Error('response submission is unavailable');\n        return ctx.platform.sessions.respond({ ...input, auth: admission.auth });\n      },\n      cancel: async (ctx) => {\n        if (ctx.agentParticipantId == null) return { accepted: false };\n        const conversation = z.string().min(1).parse(ctx.conversationId);\n        const participants = await ctx.platform.conversations.participants(conversation);\n        const agent = participants.find((participant) => participant.id === ctx.agentParticipantId);\n        if (agent?.sessionId == null) return { accepted: false };\n        await ctx.platform.sessions.cancel({\n          participantId: agent.id,\n          reason: ctx.cancelReason,\n          throughMessageSeq: ctx.cancelThroughMessageSeq,\n        });\n        return { accepted: true };\n      },\n      project: async (update, ctx) => {\n        const next = () =>\n          options.events?.['message.completed'] == null\n            ? base.project(update, ctx)\n            : Promise.resolve();\n        if (options.renderer != null) {\n          await options.renderer(update, channelContext(ctx), sessionContext(ctx), next);\n          return;\n        }\n        await next();\n      },\n      events: Object.freeze(events),\n    }),\n  );\n};\n"],
+  "mappings": "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",
   "names": ["ChannelPrincipalType"]
 }

package/dist/modules/channels/channel-utils.d.mts

@@ -0,0 +1,132 @@
+import type { ChannelReceiveContextIface, ChannelReceiveResult, JsonObject, JsonValue, PersonHandle, PlaceRef, PrincipalRef, Refusal } from '@finalai/agent-provider';
+import * as z from 'zod';
+export declare const channelBaseUrl: (config: {
+    baseUrl?: string;
+}) => string;
+export declare const providerPlaceKey: (place: PlaceRef) => string;
+export declare const parseJson: (text: string) => unknown;
+export declare const textOf: (content: readonly JsonObject[]) => string;
+export declare const replyText: (data: {
+    messages?: {
+        content: JsonObject[];
+    }[];
+    content?: JsonObject[];
+}) => string;
+export declare const turnStatus: (data: {
+    stopReason?: string | null;
+}) => string | null;
+export declare const completionText: (data: {
+    messages?: {
+        content: JsonObject[];
+    }[];
+    content?: JsonObject[];
+    stopReason?: string | null;
+}, partial?: string) => string;
+export declare const hexBytes: (hex: string) => Uint8Array | null;
+export declare const verifyHmac: (args: {
+    secret: string;
+    body: string;
+    signature: string;
+    algorithm?: "SHA-256" | "SHA-1";
+    encoding?: "hex" | "base64";
+}) => Promise<boolean>;
+export declare const freshTimestamp: (timestamp: string | null, now?: number) => timestamp is string;
+export declare const refusal: (result: Refusal) => ChannelReceiveResult;
+export declare const receipt: (result: {
+    messageId: string;
+} | {
+    inputId: string;
+} | Refusal) => ChannelReceiveResult;
+export declare const personFor: <Config>(ctx: ChannelReceiveContextIface<Config>, principal: PrincipalRef) => Promise<PersonHandle | Refusal>;
+export interface ReceivePersonMessageIface<Config> {
+    ctx: ChannelReceiveContextIface<Config>;
+    principal: PrincipalRef;
+    place: PlaceRef;
+    routePlace?: PlaceRef;
+    text: string;
+    externalKey: string;
+    ref?: JsonObject;
+    context?: string[];
+    loadContext?: () => Promise<string[]>;
+    waitForAcceptance?: boolean;
+    onAccepted?: (result: {
+        turnId?: string;
+    }) => Promise<void>;
+    resumeAfterLink?: boolean;
+}
+export declare const receivePersonMessage: <Config>(args: ReceivePersonMessageIface<Config>) => Promise<ChannelReceiveResult>;
+export declare const externalKey: (place: PlaceRef, id: string) => string;
+export declare const refString: (ref: JsonObject | undefined, name: string) => string | null;
+export declare const responseJson: (response: Response) => Promise<unknown>;
+export declare const deliveryRetention: {
+    ttlSeconds: number;
+};
+export declare const stateKey: (prefix: string, ...values: (string | null)[]) => string;
+export declare const oauthStateSchema: z.ZodObject<{
+    ticket: z.ZodString;
+    principal: z.ZodObject<{
+        id: z.ZodString;
+        tenant: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    redirectUri: z.ZodString;
+    verifier: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const startOAuth: <Config>(args: {
+    ticket: string;
+    principal: PrincipalRef;
+    authorizeUrl: string;
+    clientId: string;
+    redirectUri: string;
+    scope: string;
+    extra?: Record<string, string>;
+    pkce?: boolean;
+}, ctx: ChannelReceiveContextIface<Config>) => Promise<URL>;
+export declare const takeOAuth: <Config>(request: Request, ctx: ChannelReceiveContextIface<Config>) => Promise<{
+    code: string;
+    ticket: string;
+    principal: {
+        id: string;
+        tenant?: string | undefined;
+        displayName?: string | undefined;
+    };
+    redirectUri: string;
+    verifier?: string | undefined;
+} | null>;
+export declare const confirmOAuth: <Config>(args: {
+    ticket: string;
+    expected: PrincipalRef;
+    actual: PrincipalRef;
+}, ctx: ChannelReceiveContextIface<Config>) => Promise<Response>;
+export interface DecisionChoiceIface {
+    label: string;
+    outcome: JsonValue;
+    answer: 'approve' | 'deny';
+}
+export declare const decisionSummary: (request: JsonObject) => string;
+export declare const decisionAnswer: (choices: DecisionChoiceIface[], text: string) => DecisionChoiceIface | undefined;
+export declare const decisionChoices: (request: JsonObject) => DecisionChoiceIface[];
+export declare const createQueue: <T>() => {
+    push: (value: T) => void;
+    close: () => void;
+    stream: AsyncGenerator<T, any, any>;
+};
+export declare const inTenant: <Config>(ctx: ChannelReceiveContextIface<Config>, tenant: string) => ChannelReceiveContextIface<Config>;
+export declare const providerOriginSchema: z.ZodObject<{
+    place: z.ZodLazy<z.ZodType<PlaceRef, unknown, z.core.$ZodTypeInternals<PlaceRef, unknown>>>;
+    externalKey: z.ZodString;
+    turnId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const abortable: <T>(source: AsyncIterable<T>, signal: AbortSignal) => AsyncGenerator<T>;
+interface SharedReactionArgsIface {
+    store: ChannelReceiveContextIface['store'];
+    key: string;
+    principal: PrincipalRef;
+}
+export declare const addSharedReaction: (args: SharedReactionArgsIface & {
+    add(): Promise<boolean>;
+}) => Promise<void>;
+export declare const removeSharedReaction: (args: SharedReactionArgsIface & {
+    remove(): Promise<void>;
+}) => Promise<void>;
+export {};