@finalai/final-agent-provider 0.11.0 → 0.13.0

package/dist/modules/channels/delivery.d.mts

@@ -1,54 +0,0 @@
-import { Delivery, TurnPolicy, type RoomPlatformIface, type ConversationIface, type ConversationMessageIface, type ParticipantIface, type RouteArgsIface, type RouteDecisionIface } from '@finalai/agent-provider';
-export declare const CONTEXT_WINDOW_MESSAGES = 50;
-export interface DeliveryOutcomeIface {
-    participantId: string;
-    delivery: Delivery;
-    sent: 'prompt' | 'observe' | 'silent-prompt' | 'skipped' | 'failed';
-    messageId: string | null;
-    error: string | null;
-}
-export interface DeliverMessageArgsIface {
-    platform: RoomPlatformIface;
-    route: (args: RouteArgsIface) => RouteDecisionIface[] | Promise<RouteDecisionIface[]>;
-    conversation: ConversationIface;
-    message: ConversationMessageIface;
-    participants?: ParticipantIface[];
-    turnPolicy: TurnPolicy;
-}
-export declare const effectiveTurnPolicy: (args: {
-    channel: TurnPolicy;
-    conversation: TurnPolicy;
-}) => TurnPolicy;
-export declare const humanAudience: (participants: ParticipantIface[]) => string[];
-export declare const audienceFor: (author: ParticipantIface | null, participants: ParticipantIface[]) => string[];
-export declare const deliveryIdempotencyKey: (messageId: string, participantId: string) => string;
-export declare const deliverMessage: (args: DeliverMessageArgsIface) => Promise<DeliveryOutcomeIface[]>;
-export interface ObserveNoticeArgsIface {
-    platform: RoomPlatformIface;
-    recipients: ParticipantIface[];
-    text: string;
-    idempotencyKey: string;
-}
-export declare const observeNotice: (args: ObserveNoticeArgsIface) => Promise<string[]>;
-export interface ReactionNoticeArgsIface {
-    platform: RoomPlatformIface;
-    participants: ParticipantIface[];
-    message: ConversationMessageIface;
-    isLatestOfAuthor: boolean;
-    reactorParticipantId: string;
-    emoji: string;
-    eventId?: string;
-}
-export declare const reactionNotice: (args: ReactionNoticeArgsIface) => Promise<string[]>;
-export declare enum MembershipChange {
-    Joined = "joined",
-    Left = "left"
-}
-export interface MembershipNoticeArgsIface {
-    platform: RoomPlatformIface;
-    participants: ParticipantIface[];
-    subject: ParticipantIface;
-    change: MembershipChange;
-    idempotencyKey: string;
-}
-export declare const membershipNotice: (args: MembershipNoticeArgsIface) => Promise<string[]>;

package/dist/modules/channels/delivery.mjs

@@ -1,243 +0,0 @@
-import {
-  Delivery,
-  ParticipantKind,
-  RoutingMode,
-  TurnPolicy
-} from "@finalai/agent-provider";
-import * as z from "zod";
-import {
-  authorPrefixedContent,
-  buildPromptContent,
-  catchUpFor,
-  excerpt,
-  finalAuthorOf,
-  finalContextOf,
-  messageRefOf,
-  messageSummary,
-  renderReplyContext,
-  systemNoticeBlock
-} from "./prompt.mjs";
-import { MAX_AGENT_HOP_DEPTH } from "./routing.mjs";
-const thrownMessageSchema = z.object({ message: z.string() });
-const CONTEXT_WINDOW_MESSAGES = 50;
-const effectiveTurnPolicy = (args) => args.conversation === TurnPolicy.Queue ? TurnPolicy.Queue : args.channel;
-const humanAudience = (participants) => participants.filter((participant) => !participant.left && participant.kind === ParticipantKind.User).map((participant) => participant.id);
-const audienceFor = (author, participants) => author?.kind === ParticipantKind.User ? [author.id] : humanAudience(participants);
-const replyContextFor = async (args) => {
-  const byId = new Map(args.earlier.map((message) => [message.messageId, message]));
-  const referenced = [
-    args.message.replyToMessageId,
-    args.message.threadRootId,
-    ...args.message.quotedMessageIds
-  ].flatMap((id) => id == null || byId.has(id) ? [] : [id]);
-  if (referenced.length > 0) {
-    const found = await args.platform.conversations.getMessages({
-      conversationId: args.message.conversationId,
-      messageIds: [...new Set(referenced)]
-    });
-    for (const message of found) byId.set(message.messageId, message);
-  }
-  const replyTo = args.message.replyToMessageId == null ? null : byId.get(args.message.replyToMessageId) ?? null;
-  const root = args.message.threadRootId == null ? null : byId.get(args.message.threadRootId) ?? null;
-  const rootAuthor = root == null ? null : args.participants.find((participant) => participant.id === root.authorParticipantId);
-  return {
-    replyTo: replyTo == null || replyTo.messageId === root?.messageId ? null : messageRefOf(replyTo, args.participants),
-    thread: args.message.threadRootId == null ? null : {
-      rootMessageId: args.message.threadRootId,
-      rootExcerpt: root == null ? "" : excerpt(messageSummary(root.content)),
-      rootAuthor: rootAuthor == null ? null : finalAuthorOf(rootAuthor)
-    },
-    quotes: args.message.quotedMessageIds.flatMap((id) => {
-      const quoted = byId.get(id);
-      return quoted == null ? [] : [messageRefOf(quoted, args.participants)];
-    })
-  };
-};
-const deliveryIdempotencyKey = (messageId, participantId) => `${messageId}:${participantId}`;
-const deliverMessage = async (args) => {
-  const { platform, conversation, message } = args;
-  const participants = args.participants ?? await platform.conversations.participants(conversation.conversationId);
-  const decisions = await args.route({ conversation, message, participants });
-  const author = participants.find((participant) => participant.id === message.authorParticipantId) ?? null;
-  for (const participant of participants) {
-    if (participant.kind !== ParticipantKind.Agent) continue;
-    const decision = decisions.find((candidate) => candidate.participantId === participant.id);
-    platform.log("channel route decision", {
-      observed_at: (/* @__PURE__ */ new Date()).toISOString(),
-      organization_id: conversation.organizationId,
-      conversation_id: conversation.conversationId,
-      conversation_kind: conversation.kind,
-      message_id: message.messageId,
-      author_kind: author?.kind ?? "",
-      participant_id: participant.id,
-      routing_mode: participant.routingMode ?? "",
-      delivery: decision?.delivery ?? "skipped",
-      reason: participant.left ? "left conversation" : participant.id === message.authorParticipantId ? "author" : decision == null ? "not selected by route" : "selected by route",
-      hop_depth: message.hopDepth
-    });
-  }
-  if (decisions.length === 0) return [];
-  const earlier = await platform.conversations.recentMessages({
-    conversationId: conversation.conversationId,
-    limit: CONTEXT_WINDOW_MESSAGES,
-    beforeSeq: message.seq
-  });
-  const replyContext = await replyContextFor({ platform, message, earlier, participants });
-  const turnPolicy = effectiveTurnPolicy({
-    channel: args.turnPolicy,
-    conversation: conversation.turnPolicy
-  });
-  const audience = audienceFor(author, participants);
-  const authorParticipant = author ?? {
-    id: message.authorParticipantId,
-    kind: ParticipantKind.User,
-    displayName: "Someone",
-    userId: null,
-    definitionId: null,
-    routingMode: null,
-    sessionId: null,
-    supportsObserve: null,
-    rendersAuthorMeta: null,
-    left: true
-  };
-  const deliverOne = async (decision) => {
-    const recipient = participants.find((participant) => participant.id === decision.participantId);
-    const base = { participantId: decision.participantId, delivery: decision.delivery };
-    if (recipient == null) {
-      return { ...base, sent: "skipped", messageId: null, error: null };
-    }
-    const idempotencyKey = deliveryIdempotencyKey(message.messageId, recipient.id);
-    const prompt = async (content, replyExpected) => {
-      const result = await platform.sessions.prompt({
-        participantId: recipient.id,
-        content,
-        turnPolicy,
-        replyExpected,
-        idempotencyKey,
-        authorParticipantId: message.authorParticipantId,
-        audienceParticipantIds: audience,
-        sourceMessageId: message.messageId
-      });
-      return result.messageId;
-    };
-    try {
-      if (decision.delivery === Delivery.Prompt) {
-        const content2 = buildPromptContent({
-          message,
-          author: authorParticipant,
-          recipient,
-          replyContext,
-          catchUp: catchUpFor({ recipient, earlier, participants })
-        });
-        return { ...base, sent: "prompt", messageId: await prompt(content2, true), error: null };
-      }
-      if (recipient.sessionId == null) {
-        return { ...base, sent: "skipped", messageId: null, error: null };
-      }
-      const contextBlock = renderReplyContext(replyContext);
-      const content = [
-        ...contextBlock == null ? [] : [contextBlock],
-        ...authorPrefixedContent({
-          content: message.content,
-          author: finalAuthorOf(authorParticipant),
-          rendersAuthorMeta: recipient.rendersAuthorMeta ?? false,
-          context: finalContextOf(replyContext)
-        })
-      ];
-      if (recipient.supportsObserve === false) {
-        if (message.hopDepth >= MAX_AGENT_HOP_DEPTH) {
-          return { ...base, sent: "skipped", messageId: null, error: null };
-        }
-        return {
-          ...base,
-          sent: "silent-prompt",
-          messageId: await prompt(content, false),
-          error: null
-        };
-      }
-      await platform.sessions.observe({ participantId: recipient.id, content, idempotencyKey });
-      return { ...base, sent: "observe", messageId: null, error: null };
-    } catch (error) {
-      const reason = error instanceof Error ? error.message : thrownMessageSchema.safeParse(error).data?.message ?? String(error);
-      platform.log("channel delivery failed", {
-        conversationId: conversation.conversationId,
-        messageId: message.messageId,
-        participantId: recipient.id,
-        delivery: decision.delivery,
-        error: reason
-      });
-      return { ...base, sent: "failed", messageId: null, error: reason };
-    }
-  };
-  return Promise.all(decisions.map(deliverOne));
-};
-const observeNotice = async (args) => {
-  const delivered = [];
-  for (const recipient of args.recipients) {
-    if (recipient.sessionId == null || recipient.supportsObserve === false || recipient.left)
-      continue;
-    try {
-      await args.platform.sessions.observe({
-        participantId: recipient.id,
-        content: [systemNoticeBlock({ text: args.text })],
-        idempotencyKey: `${args.idempotencyKey}:${recipient.id}`
-      });
-      delivered.push(recipient.id);
-    } catch (error) {
-      args.platform.log("channel notice failed", {
-        participantId: recipient.id,
-        error: error instanceof Error ? error.message : String(error)
-      });
-    }
-  }
-  return delivered;
-};
-const reactionNotice = async (args) => {
-  const author = args.participants.find(
-    (participant) => participant.id === args.message.authorParticipantId
-  );
-  const reactor = args.participants.find(
-    (participant) => participant.id === args.reactorParticipantId
-  );
-  if (author == null || author.kind !== ParticipantKind.Agent || reactor == null || reactor.id === author.id) {
-    return [];
-  }
-  const target = args.isLatestOfAuthor ? "your last message" : `your message "${excerpt(messageSummary(args.message.content), 120)}"`;
-  const reactionId = `reaction:${args.message.messageId}:${reactor.id}:${args.emoji}`;
-  return observeNotice({
-    platform: args.platform,
-    recipients: [author],
-    text: `${reactor.displayName} reacted ${args.emoji} to ${target}`,
-    idempotencyKey: args.eventId == null ? reactionId : `${reactionId}:${args.eventId}`
-  });
-};
-var MembershipChange = /* @__PURE__ */ ((MembershipChange2) => {
-  MembershipChange2["Joined"] = "joined";
-  MembershipChange2["Left"] = "left";
-  return MembershipChange2;
-})(MembershipChange || {});
-const membershipNotice = async (args) => {
-  const recipients = args.participants.filter(
-    (participant) => participant.kind === ParticipantKind.Agent && participant.id !== args.subject.id && (participant.routingMode === RoutingMode.All || participant.routingMode === RoutingMode.Default)
-  );
-  const verb = args.change === "joined" /* Joined */ ? "joined" : "left";
-  return observeNotice({
-    platform: args.platform,
-    recipients,
-    text: `${args.subject.displayName} ${verb} the conversation`,
-    idempotencyKey: args.idempotencyKey
-  });
-};
-export {
-  CONTEXT_WINDOW_MESSAGES,
-  MembershipChange,
-  audienceFor,
-  deliverMessage,
-  deliveryIdempotencyKey,
-  effectiveTurnPolicy,
-  humanAudience,
-  membershipNotice,
-  observeNotice,
-  reactionNotice
-};
-//# sourceMappingURL=delivery.mjs.map

package/dist/modules/channels/delivery.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../src/channels/delivery.ts"],
-  "sourcesContent": ["import type { ContentBlock } from '@agentclientprotocol/sdk/experimental/v2';\nimport {\n  Delivery,\n  ParticipantKind,\n  RoutingMode,\n  TurnPolicy,\n  type RoomPlatformIface,\n  type ConversationIface,\n  type ConversationMessageIface,\n  type ParticipantIface,\n  type RouteArgsIface,\n  type RouteDecisionIface,\n} from '@finalai/agent-provider';\nimport * as z from 'zod';\nimport {\n  authorPrefixedContent,\n  buildPromptContent,\n  catchUpFor,\n  excerpt,\n  finalAuthorOf,\n  finalContextOf,\n  messageRefOf,\n  messageSummary,\n  renderReplyContext,\n  systemNoticeBlock,\n  type ReplyContextArgsIface,\n} from \"./prompt.mjs\";\nimport { MAX_AGENT_HOP_DEPTH } from \"./routing.mjs\";\n\n// How a channel hands a conversation message to its agents: route, then build\n// each recipient's ACP content and call prompt or observe. Prompt construction,\n// not orchestration.\n\nconst thrownMessageSchema = z.object({ message: z.string() });\n\nexport const CONTEXT_WINDOW_MESSAGES = 50;\n\nexport interface DeliveryOutcomeIface {\n  participantId: string;\n  delivery: Delivery;\n  // What actually happened: an observe can fall back to a silent prompt, or be\n  // skipped for an agent with no session yet (its first prompt catches up).\n  sent: 'prompt' | 'observe' | 'silent-prompt' | 'skipped' | 'failed';\n  messageId: string | null;\n  error: string | null;\n}\n\nexport interface DeliverMessageArgsIface {\n  platform: RoomPlatformIface;\n  // A channel's pure route(), or a bundle channel's run in its isolate.\n  route: (args: RouteArgsIface) => RouteDecisionIface[] | Promise<RouteDecisionIface[]>;\n  conversation: ConversationIface;\n  message: ConversationMessageIface;\n  participants?: ParticipantIface[];\n  // The delivering channel's turnPolicy.\n  turnPolicy: TurnPolicy;\n}\n\n// A channel's policy applies unless the conversation is set to\n// queue, the per-conversation override.\nexport const effectiveTurnPolicy = (args: {\n  channel: TurnPolicy;\n  conversation: TurnPolicy;\n}): TurnPolicy => (args.conversation === TurnPolicy.Queue ? TurnPolicy.Queue : args.channel);\n\n// Every person in the room: who may answer what a turn no person prompted asks.\nexport const humanAudience = (participants: ParticipantIface[]): string[] =>\n  participants\n    .filter((participant) => !participant.left && participant.kind === ParticipantKind.User)\n    .map((participant) => participant.id);\n\n// A person answers their own prompt; an agent's prompt is answered by the room's people.\nexport const audienceFor = (\n  author: ParticipantIface | null,\n  participants: ParticipantIface[],\n): string[] => (author?.kind === ParticipantKind.User ? [author.id] : humanAudience(participants));\n\n// Reply, thread and quote context. A referenced message outside the\n// recent window is read by id, however old.\nconst replyContextFor = async (args: {\n  platform: RoomPlatformIface;\n  message: ConversationMessageIface;\n  earlier: ConversationMessageIface[];\n  participants: ParticipantIface[];\n}): Promise<ReplyContextArgsIface> => {\n  const byId = new Map(args.earlier.map((message) => [message.messageId, message]));\n  const referenced = [\n    args.message.replyToMessageId,\n    args.message.threadRootId,\n    ...args.message.quotedMessageIds,\n  ].flatMap((id) => (id == null || byId.has(id) ? [] : [id]));\n  if (referenced.length > 0) {\n    const found = await args.platform.conversations.getMessages({\n      conversationId: args.message.conversationId,\n      messageIds: [...new Set(referenced)],\n    });\n    for (const message of found) byId.set(message.messageId, message);\n  }\n  const replyTo =\n    args.message.replyToMessageId == null\n      ? null\n      : (byId.get(args.message.replyToMessageId) ?? null);\n  const root =\n    args.message.threadRootId == null ? null : (byId.get(args.message.threadRootId) ?? null);\n  const rootAuthor =\n    root == null\n      ? null\n      : args.participants.find((participant) => participant.id === root.authorParticipantId);\n  return {\n    replyTo:\n      replyTo == null || replyTo.messageId === root?.messageId\n        ? null\n        : messageRefOf(replyTo, args.participants),\n    thread:\n      args.message.threadRootId == null\n        ? null\n        : {\n            rootMessageId: args.message.threadRootId,\n            rootExcerpt: root == null ? '' : excerpt(messageSummary(root.content)),\n            rootAuthor: rootAuthor == null ? null : finalAuthorOf(rootAuthor),\n          },\n    quotes: args.message.quotedMessageIds.flatMap((id) => {\n      const quoted = byId.get(id);\n      return quoted == null ? [] : [messageRefOf(quoted, args.participants)];\n    }),\n  };\n};\n\nexport const deliveryIdempotencyKey = (messageId: string, participantId: string): string =>\n  `${messageId}:${participantId}`;\n\nexport const deliverMessage = async (\n  args: DeliverMessageArgsIface,\n): Promise<DeliveryOutcomeIface[]> => {\n  const { platform, conversation, message } = args;\n  const participants =\n    args.participants ?? (await platform.conversations.participants(conversation.conversationId));\n  const decisions = await args.route({ conversation, message, participants });\n  const author =\n    participants.find((participant) => participant.id === message.authorParticipantId) ?? null;\n  for (const participant of participants) {\n    if (participant.kind !== ParticipantKind.Agent) continue;\n    const decision = decisions.find((candidate) => candidate.participantId === participant.id);\n    platform.log('channel route decision', {\n      observed_at: new Date().toISOString(),\n      organization_id: conversation.organizationId,\n      conversation_id: conversation.conversationId,\n      conversation_kind: conversation.kind,\n      message_id: message.messageId,\n      author_kind: author?.kind ?? '',\n      participant_id: participant.id,\n      routing_mode: participant.routingMode ?? '',\n      delivery: decision?.delivery ?? 'skipped',\n      reason: participant.left\n        ? 'left conversation'\n        : participant.id === message.authorParticipantId\n          ? 'author'\n          : decision == null\n            ? 'not selected by route'\n            : 'selected by route',\n      hop_depth: message.hopDepth,\n    });\n  }\n  if (decisions.length === 0) return [];\n  const earlier = await platform.conversations.recentMessages({\n    conversationId: conversation.conversationId,\n    limit: CONTEXT_WINDOW_MESSAGES,\n    beforeSeq: message.seq,\n  });\n  const replyContext = await replyContextFor({ platform, message, earlier, participants });\n  const turnPolicy = effectiveTurnPolicy({\n    channel: args.turnPolicy,\n    conversation: conversation.turnPolicy,\n  });\n  const audience = audienceFor(author, participants);\n  const authorParticipant: ParticipantIface = author ?? {\n    id: message.authorParticipantId,\n    kind: ParticipantKind.User,\n    displayName: 'Someone',\n    userId: null,\n    definitionId: null,\n    routingMode: null,\n    sessionId: null,\n    supportsObserve: null,\n    rendersAuthorMeta: null,\n    left: true,\n  };\n\n  const deliverOne = async (decision: RouteDecisionIface): Promise<DeliveryOutcomeIface> => {\n    const recipient = participants.find((participant) => participant.id === decision.participantId);\n    const base = { participantId: decision.participantId, delivery: decision.delivery };\n    if (recipient == null) {\n      return { ...base, sent: 'skipped', messageId: null, error: null };\n    }\n    const idempotencyKey = deliveryIdempotencyKey(message.messageId, recipient.id);\n    const prompt = async (content: ContentBlock[], replyExpected: boolean): Promise<string> => {\n      const result = await platform.sessions.prompt({\n        participantId: recipient.id,\n        content,\n        turnPolicy,\n        replyExpected,\n        idempotencyKey,\n        authorParticipantId: message.authorParticipantId,\n        audienceParticipantIds: audience,\n        sourceMessageId: message.messageId,\n      });\n      return result.messageId;\n    };\n    try {\n      if (decision.delivery === Delivery.Prompt) {\n        const content = buildPromptContent({\n          message,\n          author: authorParticipant,\n          recipient,\n          replyContext,\n          catchUp: catchUpFor({ recipient, earlier, participants }),\n        });\n        return { ...base, sent: 'prompt', messageId: await prompt(content, true), error: null };\n      }\n      if (recipient.sessionId == null) {\n        return { ...base, sent: 'skipped', messageId: null, error: null };\n      }\n      const contextBlock = renderReplyContext(replyContext);\n      const content = [\n        ...(contextBlock == null ? [] : [contextBlock]),\n        ...authorPrefixedContent({\n          content: message.content,\n          author: finalAuthorOf(authorParticipant),\n          rendersAuthorMeta: recipient.rendersAuthorMeta ?? false,\n          context: finalContextOf(replyContext),\n        }),\n      ];\n      if (recipient.supportsObserve === false) {\n        if (message.hopDepth >= MAX_AGENT_HOP_DEPTH) {\n          return { ...base, sent: 'skipped', messageId: null, error: null };\n        }\n        return {\n          ...base,\n          sent: 'silent-prompt',\n          messageId: await prompt(content, false),\n          error: null,\n        };\n      }\n      await platform.sessions.observe({ participantId: recipient.id, content, idempotencyKey });\n      return { ...base, sent: 'observe', messageId: null, error: null };\n    } catch (error) {\n      // JSON-RPC failures arrive as plain `{ code, message }` objects.\n      const reason =\n        error instanceof Error\n          ? error.message\n          : (thrownMessageSchema.safeParse(error).data?.message ?? String(error));\n      platform.log('channel delivery failed', {\n        conversationId: conversation.conversationId,\n        messageId: message.messageId,\n        participantId: recipient.id,\n        delivery: decision.delivery,\n        error: reason,\n      });\n      return { ...base, sent: 'failed', messageId: null, error: reason };\n    }\n  };\n\n  return Promise.all(decisions.map(deliverOne));\n};\n\nexport interface ObserveNoticeArgsIface {\n  platform: RoomPlatformIface;\n  recipients: ParticipantIface[];\n  text: string;\n  idempotencyKey: string;\n}\n\n// System blocks with no model call. Agents without a session skip them (their\n// first prompt catches up); agents without observe support skip them too, since\n// a silent prompt per reaction is not worth a model call.\nexport const observeNotice = async (args: ObserveNoticeArgsIface): Promise<string[]> => {\n  const delivered: string[] = [];\n  for (const recipient of args.recipients) {\n    if (recipient.sessionId == null || recipient.supportsObserve === false || recipient.left)\n      continue;\n    try {\n      await args.platform.sessions.observe({\n        participantId: recipient.id,\n        content: [systemNoticeBlock({ text: args.text })],\n        idempotencyKey: `${args.idempotencyKey}:${recipient.id}`,\n      });\n      delivered.push(recipient.id);\n    } catch (error) {\n      args.platform.log('channel notice failed', {\n        participantId: recipient.id,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n  return delivered;\n};\n\nexport interface ReactionNoticeArgsIface {\n  platform: RoomPlatformIface;\n  participants: ParticipantIface[];\n  message: ConversationMessageIface;\n  // Whether the reacted message is the agent's latest one.\n  isLatestOfAuthor: boolean;\n  reactorParticipantId: string;\n  emoji: string;\n  eventId?: string;\n}\n\n// Only the agent whose message was reacted to hears about it.\nexport const reactionNotice = async (args: ReactionNoticeArgsIface): Promise<string[]> => {\n  const author = args.participants.find(\n    (participant) => participant.id === args.message.authorParticipantId,\n  );\n  const reactor = args.participants.find(\n    (participant) => participant.id === args.reactorParticipantId,\n  );\n  if (\n    author == null ||\n    author.kind !== ParticipantKind.Agent ||\n    reactor == null ||\n    reactor.id === author.id\n  ) {\n    return [];\n  }\n  const target = args.isLatestOfAuthor\n    ? 'your last message'\n    : `your message \"${excerpt(messageSummary(args.message.content), 120)}\"`;\n  const reactionId = `reaction:${args.message.messageId}:${reactor.id}:${args.emoji}`;\n  return observeNotice({\n    platform: args.platform,\n    recipients: [author],\n    text: `${reactor.displayName} reacted ${args.emoji} to ${target}`,\n    idempotencyKey: args.eventId == null ? reactionId : `${reactionId}:${args.eventId}`,\n  });\n};\n\nexport enum MembershipChange {\n  Joined = 'joined',\n  Left = 'left',\n}\n\nexport interface MembershipNoticeArgsIface {\n  platform: RoomPlatformIface;\n  participants: ParticipantIface[];\n  subject: ParticipantIface;\n  change: MembershipChange;\n  idempotencyKey: string;\n}\n\n// Membership changes reach agents that follow the whole conversation.\nexport const membershipNotice = async (args: MembershipNoticeArgsIface): Promise<string[]> => {\n  const recipients = args.participants.filter(\n    (participant) =>\n      participant.kind === ParticipantKind.Agent &&\n      participant.id !== args.subject.id &&\n      (participant.routingMode === RoutingMode.All ||\n        participant.routingMode === RoutingMode.Default),\n  );\n  const verb = args.change === MembershipChange.Joined ? 'joined' : 'left';\n  return observeNotice({\n    platform: args.platform,\n    recipients,\n    text: `${args.subject.displayName} ${verb} the conversation`,\n    idempotencyKey: args.idempotencyKey,\n  });\n};\n"],
-  "mappings": "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",
-  "names": ["content", "MembershipChange"]
-}

package/dist/modules/channels/direct-messaging.d.mts

@@ -1,5 +0,0 @@
-import type { RoomSurfaceDefinitionIface, JsonValue } from '@finalai/agent-provider';
-import { type MessagingChannelConfigIface } from "./messaging-channel.mjs";
-export type DirectMessagingChannelConfigIface = MessagingChannelConfigIface;
-export declare const DIRECT_MESSAGING_SPECIFIER = "@finalai/final-agent-provider/channels/direct-messaging";
-export declare const createDirectMessagingChannel: (config?: DirectMessagingChannelConfigIface) => RoomSurfaceDefinitionIface<JsonValue, JsonValue>;

package/dist/modules/channels/direct-messaging.mjs

@@ -1,8 +0,0 @@
-import { createMessagingChannel } from "./messaging-channel.mjs";
-const DIRECT_MESSAGING_SPECIFIER = "@finalai/final-agent-provider/channels/direct-messaging";
-const createDirectMessagingChannel = (config = {}) => createMessagingChannel(config);
-export {
-  DIRECT_MESSAGING_SPECIFIER,
-  createDirectMessagingChannel
-};
-//# sourceMappingURL=direct-messaging.mjs.map

package/dist/modules/channels/direct-messaging.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../src/channels/direct-messaging.ts"],
-  "sourcesContent": ["import type { RoomSurfaceDefinitionIface, JsonValue } from '@finalai/agent-provider';\nimport { createMessagingChannel, type MessagingChannelConfigIface } from \"./messaging-channel.mjs\";\n\nexport type DirectMessagingChannelConfigIface = MessagingChannelConfigIface;\n\nexport const DIRECT_MESSAGING_SPECIFIER = '@finalai/final-agent-provider/channels/direct-messaging';\n\n// One user and one agent; every human message prompts the agent.\nexport const createDirectMessagingChannel = (\n  config: DirectMessagingChannelConfigIface = {},\n): RoomSurfaceDefinitionIface<JsonValue, JsonValue> => createMessagingChannel(config);\n"],
-  "mappings": "AACA,SAAS,8BAAgE;AAIlE,MAAM,6BAA6B;AAGnC,MAAM,+BAA+B,CAC1C,SAA4C,CAAC,MACQ,uBAAuB,MAAM;",
-  "names": []
-}

package/dist/modules/channels/fake-platform.d.mts

@@ -1,36 +0,0 @@
-import { ConversationKind, ParticipantKind, TurnPolicy, type RoomPlatformIface, type ConversationIface, type ConversationMessageIface, type JsonObject, type ObserveArgsIface, type ParticipantIface, type PromptArgsIface } from '@finalai/agent-provider';
-export interface FakeMessageIface extends ConversationMessageIface {
-    final: boolean;
-    updates: number;
-    source: {
-        turnId: string;
-        fromSeq: number;
-        toSeq: number;
-    } | null;
-}
-export interface FakeCardIface {
-    messageId: string;
-    decisionId: string | null;
-    state: JsonObject;
-}
-export interface FakePlatformIface {
-    platform: RoomPlatformIface;
-    conversations: Map<string, ConversationIface>;
-    participants: Map<string, ParticipantIface[]>;
-    messages: FakeMessageIface[];
-    cards: FakeCardIface[];
-    prompts: PromptArgsIface[];
-    observes: ObserveArgsIface[];
-    logs: string[];
-    getMessagesCalls: string[][];
-    addConversation(args: {
-        conversationId: string;
-        kind: ConversationKind;
-        turnPolicy?: TurnPolicy;
-    }): ConversationIface;
-    addParticipant(conversationId: string, participant: Partial<ParticipantIface> & {
-        id: string;
-        kind: ParticipantKind;
-    }): ParticipantIface;
-}
-export declare const createFakePlatform: () => FakePlatformIface;

package/dist/modules/channels/fake-platform.mjs

@@ -1,168 +0,0 @@
-import {
-  ConversationKind,
-  MessageKind,
-  ParticipantKind,
-  TurnPolicy
-} from "@finalai/agent-provider";
-import { routeToParticipant } from "./routing.mjs";
-import { deliverMessage } from "./delivery.mjs";
-import { messageSummary } from "./prompt.mjs";
-import { routeMessage } from "./routing.mjs";
-const createFakePlatform = () => {
-  const conversations = /* @__PURE__ */ new Map();
-  const participants = /* @__PURE__ */ new Map();
-  const messages = [];
-  const cards = [];
-  const prompts = [];
-  const observes = [];
-  const logs = [];
-  const getMessagesCalls = [];
-  let nextId = 1;
-  const addConversation = (args) => {
-    const conversation = {
-      conversationId: args.conversationId,
-      organizationId: "org",
-      kind: args.kind,
-      title: null,
-      isHome: false,
-      turnPolicy: args.turnPolicy ?? TurnPolicy.Steer
-    };
-    conversations.set(args.conversationId, conversation);
-    participants.set(args.conversationId, []);
-    return conversation;
-  };
-  const addParticipant = (conversationId, partial) => {
-    const participant = {
-      displayName: partial.id,
-      userId: null,
-      definitionId: null,
-      routingMode: null,
-      sessionId: partial.kind === ParticipantKind.Agent ? `session-${partial.id}` : null,
-      supportsObserve: partial.kind === ParticipantKind.Agent ? true : null,
-      rendersAuthorMeta: partial.kind === ParticipantKind.Agent ? true : null,
-      left: false,
-      ...partial
-    };
-    participants.get(conversationId)?.push(participant);
-    return participant;
-  };
-  const nextSeq = (conversationId) => messages.filter((message) => message.conversationId === conversationId).length + 1;
-  const insert = (args) => {
-    const message = {
-      messageId: `m${nextId++}`,
-      seq: nextSeq(args.conversationId),
-      conversationId: args.conversationId,
-      authorParticipantId: args.authorParticipantId,
-      kind: args.kind,
-      body: messageSummary(args.content),
-      content: args.content,
-      replyToMessageId: args.replyToMessageId ?? null,
-      threadRootId: args.threadRootId ?? null,
-      quotedMessageIds: args.quotedMessageIds ?? [],
-      mentionedParticipantIds: args.mentionedParticipantIds ?? [],
-      hopDepth: args.hopDepth ?? 0,
-      createdAt: (/* @__PURE__ */ new Date(0)).toISOString(),
-      final: args.source == null,
-      updates: 0,
-      source: args.source ?? null
-    };
-    messages.push(message);
-    return message;
-  };
-  const platform = {
-    conversations: {
-      dispatchMessage: async (input) => {
-        const room = conversations.get(input.conversationId);
-        const message = messages.find((entry) => entry.messageId === input.messageId);
-        if (room == null || message == null) throw new Error("dispatch source missing");
-        await deliverMessage({
-          platform,
-          conversation: room,
-          message,
-          turnPolicy: room.turnPolicy,
-          route: input.participantId == null ? routeMessage : routeToParticipant(input.participantId)
-        });
-      },
-      get: async (conversationId) => conversations.get(conversationId) ?? null,
-      participants: async (conversationId) => participants.get(conversationId) ?? [],
-      postMessage: async (args) => {
-        if (args.clientMessageId != null) {
-          const existing = messages.find(
-            (message) => message.conversationId === args.conversationId && message.messageId === args.clientMessageId
-          );
-          if (existing != null) return existing;
-        }
-        return insert({ ...args, kind: args.kind ?? MessageKind.Message });
-      },
-      updateMessage: async (args) => {
-        const message = messages.find((candidate) => candidate.messageId === args.messageId);
-        if (message == null) throw new Error(`no message ${args.messageId}`);
-        message.content = args.content;
-        message.body = messageSummary(args.content);
-        message.final = args.final;
-        message.updates += 1;
-      },
-      postCard: async (args) => {
-        const message = insert({
-          conversationId: args.conversationId,
-          authorParticipantId: args.authorParticipantId,
-          kind: MessageKind.Card,
-          content: []
-        });
-        cards.push({
-          messageId: message.messageId,
-          decisionId: args.decisionId,
-          state: args.state
-        });
-        return message;
-      },
-      updateCard: async (args) => {
-        const card = cards.find(
-          (candidate) => candidate.messageId === args.messageId || candidate.decisionId === args.messageId
-        );
-        if (card == null) throw new Error(`no card ${args.messageId}`);
-        card.state = { ...card.state, ...args.state };
-      },
-      recentMessages: async (args) => messages.filter(
-        (message) => message.conversationId === args.conversationId && (args.beforeSeq == null || message.seq < args.beforeSeq) && (args.afterSeq == null || message.seq > args.afterSeq)
-      ).slice(-args.limit),
-      getMessages: async (args) => {
-        getMessagesCalls.push(args.messageIds);
-        return messages.filter(
-          (message) => message.conversationId === args.conversationId && args.messageIds.includes(message.messageId)
-        );
-      }
-    },
-    sessions: {
-      prompt: async (args) => {
-        prompts.push(args);
-        return { messageId: `acp-${prompts.length}` };
-      },
-      observe: async (args) => {
-        observes.push(args);
-      },
-      cancel: async () => {
-      }
-    },
-    log: (message) => {
-      logs.push(message);
-    }
-  };
-  return {
-    platform,
-    conversations,
-    participants,
-    messages,
-    cards,
-    prompts,
-    observes,
-    logs,
-    getMessagesCalls,
-    addConversation,
-    addParticipant
-  };
-};
-export {
-  createFakePlatform
-};
-//# sourceMappingURL=fake-platform.mjs.map

package/dist/modules/channels/fake-platform.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../src/channels/fake-platform.ts"],
-  "sourcesContent": ["import type { ContentBlock } from '@agentclientprotocol/sdk/experimental/v2';\nimport {\n  ConversationKind,\n  MessageKind,\n  ParticipantKind,\n  TurnPolicy,\n  type CardArgsIface,\n  type RoomPlatformIface,\n  type ConversationIface,\n  type ConversationMessageIface,\n  type JsonObject,\n  type ObserveArgsIface,\n  type ParticipantIface,\n  type PromptArgsIface,\n} from '@finalai/agent-provider';\nimport { routeToParticipant } from \"./routing.mjs\";\nimport { deliverMessage } from \"./delivery.mjs\";\nimport { messageSummary } from \"./prompt.mjs\";\nimport { routeMessage } from \"./routing.mjs\";\n\n// An in-memory RoomPlatformIface for channel tests (not exported from the\n// package index). Records every prompt, observe, channel input and\n// visible-message write.\n\nexport interface FakeMessageIface extends ConversationMessageIface {\n  final: boolean;\n  updates: number;\n  source: { turnId: string; fromSeq: number; toSeq: number } | null;\n}\n\nexport interface FakeCardIface {\n  messageId: string;\n  decisionId: string | null;\n  state: JsonObject;\n}\n\nexport interface FakePlatformIface {\n  platform: RoomPlatformIface;\n  conversations: Map<string, ConversationIface>;\n  participants: Map<string, ParticipantIface[]>;\n  messages: FakeMessageIface[];\n  cards: FakeCardIface[];\n  prompts: PromptArgsIface[];\n  observes: ObserveArgsIface[];\n  logs: string[];\n  // The message ids of each getMessages call.\n  getMessagesCalls: string[][];\n  addConversation(args: {\n    conversationId: string;\n    kind: ConversationKind;\n    turnPolicy?: TurnPolicy;\n  }): ConversationIface;\n  addParticipant(\n    conversationId: string,\n    participant: Partial<ParticipantIface> & { id: string; kind: ParticipantKind },\n  ): ParticipantIface;\n}\n\nexport const createFakePlatform = (): FakePlatformIface => {\n  const conversations = new Map<string, ConversationIface>();\n  const participants = new Map<string, ParticipantIface[]>();\n  const messages: FakeMessageIface[] = [];\n  const cards: FakeCardIface[] = [];\n  const prompts: PromptArgsIface[] = [];\n  const observes: ObserveArgsIface[] = [];\n  const logs: string[] = [];\n  const getMessagesCalls: string[][] = [];\n  let nextId = 1;\n\n  const addConversation: FakePlatformIface['addConversation'] = (args) => {\n    const conversation: ConversationIface = {\n      conversationId: args.conversationId,\n      organizationId: 'org',\n      kind: args.kind,\n      title: null,\n      isHome: false,\n      turnPolicy: args.turnPolicy ?? TurnPolicy.Steer,\n    };\n    conversations.set(args.conversationId, conversation);\n    participants.set(args.conversationId, []);\n    return conversation;\n  };\n\n  const addParticipant: FakePlatformIface['addParticipant'] = (conversationId, partial) => {\n    const participant: ParticipantIface = {\n      displayName: partial.id,\n      userId: null,\n      definitionId: null,\n      routingMode: null,\n      sessionId: partial.kind === ParticipantKind.Agent ? `session-${partial.id}` : null,\n      supportsObserve: partial.kind === ParticipantKind.Agent ? true : null,\n      rendersAuthorMeta: partial.kind === ParticipantKind.Agent ? true : null,\n      left: false,\n      ...partial,\n    };\n    participants.get(conversationId)?.push(participant);\n    return participant;\n  };\n\n  const nextSeq = (conversationId: string): number =>\n    messages.filter((message) => message.conversationId === conversationId).length + 1;\n\n  const insert = (args: {\n    conversationId: string;\n    authorParticipantId: string;\n    kind: MessageKind;\n    content: ContentBlock[];\n    replyToMessageId?: string | null;\n    threadRootId?: string | null;\n    quotedMessageIds?: string[];\n    mentionedParticipantIds?: string[];\n    hopDepth?: number;\n    source?: FakeMessageIface['source'];\n  }): FakeMessageIface => {\n    const message: FakeMessageIface = {\n      messageId: `m${nextId++}`,\n      seq: nextSeq(args.conversationId),\n      conversationId: args.conversationId,\n      authorParticipantId: args.authorParticipantId,\n      kind: args.kind,\n      body: messageSummary(args.content),\n      content: args.content,\n      replyToMessageId: args.replyToMessageId ?? null,\n      threadRootId: args.threadRootId ?? null,\n      quotedMessageIds: args.quotedMessageIds ?? [],\n      mentionedParticipantIds: args.mentionedParticipantIds ?? [],\n      hopDepth: args.hopDepth ?? 0,\n      createdAt: new Date(0).toISOString(),\n      final: args.source == null,\n      updates: 0,\n      source: args.source ?? null,\n    };\n    messages.push(message);\n    return message;\n  };\n\n  const platform: RoomPlatformIface = {\n    conversations: {\n      dispatchMessage: async (input) => {\n        const room = conversations.get(input.conversationId);\n        const message = messages.find((entry) => entry.messageId === input.messageId);\n        if (room == null || message == null) throw new Error('dispatch source missing');\n        await deliverMessage({\n          platform,\n          conversation: room,\n          message,\n          turnPolicy: room.turnPolicy,\n          route:\n            input.participantId == null ? routeMessage : routeToParticipant(input.participantId),\n        });\n      },\n      get: async (conversationId) => conversations.get(conversationId) ?? null,\n      participants: async (conversationId) => participants.get(conversationId) ?? [],\n      postMessage: async (args) => {\n        if (args.clientMessageId != null) {\n          const existing = messages.find(\n            (message) =>\n              message.conversationId === args.conversationId &&\n              message.messageId === args.clientMessageId,\n          );\n          if (existing != null) return existing;\n        }\n        return insert({ ...args, kind: args.kind ?? MessageKind.Message });\n      },\n      updateMessage: async (args) => {\n        const message = messages.find((candidate) => candidate.messageId === args.messageId);\n        if (message == null) throw new Error(`no message ${args.messageId}`);\n        message.content = args.content;\n        message.body = messageSummary(args.content);\n        message.final = args.final;\n        message.updates += 1;\n      },\n      postCard: async (args: CardArgsIface) => {\n        const message = insert({\n          conversationId: args.conversationId,\n          authorParticipantId: args.authorParticipantId,\n          kind: MessageKind.Card,\n          content: [],\n        });\n        cards.push({\n          messageId: message.messageId,\n          decisionId: args.decisionId,\n          state: args.state,\n        });\n        return message;\n      },\n      updateCard: async (args) => {\n        const card = cards.find(\n          (candidate) =>\n            candidate.messageId === args.messageId || candidate.decisionId === args.messageId,\n        );\n        if (card == null) throw new Error(`no card ${args.messageId}`);\n        card.state = { ...card.state, ...args.state };\n      },\n      recentMessages: async (args) =>\n        messages\n          .filter(\n            (message) =>\n              message.conversationId === args.conversationId &&\n              (args.beforeSeq == null || message.seq < args.beforeSeq) &&\n              (args.afterSeq == null || message.seq > args.afterSeq),\n          )\n          .slice(-args.limit),\n      getMessages: async (args) => {\n        getMessagesCalls.push(args.messageIds);\n        return messages.filter(\n          (message) =>\n            message.conversationId === args.conversationId &&\n            args.messageIds.includes(message.messageId),\n        );\n      },\n    },\n    sessions: {\n      prompt: async (args) => {\n        prompts.push(args);\n        return { messageId: `acp-${prompts.length}` };\n      },\n      observe: async (args) => {\n        observes.push(args);\n      },\n      cancel: async () => {},\n    },\n    log: (message) => {\n      logs.push(message);\n    },\n  };\n\n  return {\n    platform,\n    conversations,\n    participants,\n    messages,\n    cards,\n    prompts,\n    observes,\n    logs,\n    getMessagesCalls,\n    addConversation,\n    addParticipant,\n  };\n};\n"],
-  "mappings": "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",
-  "names": []
-}

package/dist/modules/channels/group-messaging.d.mts

@@ -1,5 +0,0 @@
-import type { RoomSurfaceDefinitionIface, JsonValue } from '@finalai/agent-provider';
-import { type MessagingChannelConfigIface } from "./messaging-channel.mjs";
-export type GroupMessagingChannelConfigIface = MessagingChannelConfigIface;
-export declare const GROUP_MESSAGING_SPECIFIER = "@finalai/final-agent-provider/channels/group-messaging";
-export declare const createGroupMessagingChannel: (config?: GroupMessagingChannelConfigIface) => RoomSurfaceDefinitionIface<JsonValue, JsonValue>;

package/dist/modules/channels/group-messaging.mjs

@@ -1,8 +0,0 @@
-import { createMessagingChannel } from "./messaging-channel.mjs";
-const GROUP_MESSAGING_SPECIFIER = "@finalai/final-agent-provider/channels/group-messaging";
-const createGroupMessagingChannel = (config = {}) => createMessagingChannel(config);
-export {
-  GROUP_MESSAGING_SPECIFIER,
-  createGroupMessagingChannel
-};
-//# sourceMappingURL=group-messaging.mjs.map

package/dist/modules/channels/group-messaging.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../src/channels/group-messaging.ts"],
-  "sourcesContent": ["import type { RoomSurfaceDefinitionIface, JsonValue } from '@finalai/agent-provider';\nimport { createMessagingChannel, type MessagingChannelConfigIface } from \"./messaging-channel.mjs\";\n\nexport type GroupMessagingChannelConfigIface = MessagingChannelConfigIface;\n\nexport const GROUP_MESSAGING_SPECIFIER = '@finalai/final-agent-provider/channels/group-messaging';\n\n// N users and M agents; routing modes and mentions decide prompt or observe.\nexport const createGroupMessagingChannel = (\n  config: GroupMessagingChannelConfigIface = {},\n): RoomSurfaceDefinitionIface<JsonValue, JsonValue> => createMessagingChannel(config);\n"],
-  "mappings": "AACA,SAAS,8BAAgE;AAIlE,MAAM,4BAA4B;AAGlC,MAAM,8BAA8B,CACzC,SAA2C,CAAC,MACS,uBAAuB,MAAM;",
-  "names": []
-}