@finalai/final-agent-provider 0.10.1 → 0.12.0

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

@@ -1,36 +0,0 @@
-import type { ContentBlock, SessionUpdate } from '@agentclientprotocol/sdk/experimental/v2';
-import { TurnPolicy, type JsonValue, type ProjectionContextIface } from '@finalai/agent-provider';
-import * as z from 'zod';
-export declare const DEFAULT_PROJECTION_UPDATE_INTERVAL_MS = 300;
-export declare const projectionStateSchema: z.ZodObject<{
-    messageId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-    messageSeq: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
-    fromSeq: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
-    lastSeq: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
-    lastFlushAt: z.ZodDefault<z.ZodNumber>;
-    dirty: z.ZodDefault<z.ZodBoolean>;
-    segments: z.ZodArray<z.ZodObject<{
-        messageId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-        messageSeq: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
-        fromSeq: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
-        lastSeq: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
-        lastFlushAt: z.ZodDefault<z.ZodNumber>;
-        dirty: z.ZodDefault<z.ZodBoolean>;
-        acpMessageId: z.ZodString;
-        blocks: z.ZodArray<z.ZodType<import("@finalai/agent-provider").JsonObject, unknown, z.core.$ZodTypeInternals<import("@finalai/agent-provider").JsonObject, unknown>>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type ProjectionStateIface = z.infer<typeof projectionStateSchema>;
-export interface ProjectorConfigIface {
-    updateIntervalMs?: number;
-    now?: () => number;
-    turnPolicy?: TurnPolicy;
-}
-export declare const emptyProjectionState: () => ProjectionStateIface;
-export declare const projectionStateOf: (state: JsonValue | null) => ProjectionStateIface;
-export declare const visibleContent: (state: Pick<ProjectionStateIface, "segments">) => ContentBlock[];
-export declare const accumulateUpdate: (state: ProjectionStateIface, update: SessionUpdate) => ProjectionStateIface["segments"][number] | null;
-export interface ProjectorIface {
-    project(update: SessionUpdate, ctx: ProjectionContextIface): Promise<void>;
-}
-export declare const createProjector: (config?: ProjectorConfigIface) => ProjectorIface;

package/dist/modules/channels/projection.mjs

@@ -1,233 +0,0 @@
-import { textOfBlock } from "@finalai/acp-session";
-import {
-  jsonObjectSchema,
-  MessageKind,
-  turnEndOf,
-  TurnPolicy
-} from "@finalai/agent-provider";
-import * as z from "zod";
-import { contentBlockOf, jsonOfContentBlock } from "./content.mjs";
-const DEFAULT_PROJECTION_UPDATE_INTERVAL_MS = 300;
-const projectedMessageSchema = z.object({
-  messageId: z.string().nullable().default(null),
-  // The reply's conversation seq, so the finished reply is read back by
-  // position however many messages arrived meanwhile.
-  messageSeq: z.number().nullable().default(null),
-  fromSeq: z.number().nullable().default(null),
-  lastSeq: z.number().nullable().default(null),
-  lastFlushAt: z.number().default(0),
-  dirty: z.boolean().default(false)
-});
-const segmentSchema = projectedMessageSchema.extend({
-  acpMessageId: z.string(),
-  blocks: z.array(jsonObjectSchema)
-});
-const projectionStateSchema = projectedMessageSchema.extend({
-  segments: z.array(segmentSchema)
-});
-const agentChunkSchema = z.object({
-  sessionUpdate: z.literal("agent_message_chunk"),
-  messageId: z.string(),
-  content: jsonObjectSchema
-});
-const agentMessageSchema = z.object({
-  sessionUpdate: z.literal("agent_message"),
-  messageId: z.string(),
-  content: z.array(jsonObjectSchema).nullish()
-});
-const updateJson = (update) => {
-  const parsed = jsonObjectSchema.safeParse(JSON.parse(JSON.stringify(update)));
-  return parsed.success ? parsed.data : null;
-};
-const emptyProjectionState = () => ({
-  messageId: null,
-  messageSeq: null,
-  fromSeq: null,
-  lastSeq: null,
-  lastFlushAt: 0,
-  dirty: false,
-  segments: []
-});
-const projectionStateOf = (state) => {
-  const parsed = projectionStateSchema.safeParse(state);
-  return parsed.success ? parsed.data : emptyProjectionState();
-};
-const plainText = (block) => block == null || block._meta != null ? null : textOfBlock(block);
-const appendBlock = (blocks, block, separator) => {
-  const lastText = plainText(blocks.at(-1));
-  const nextText = plainText(block);
-  if (lastText != null && nextText != null) {
-    blocks[blocks.length - 1] = { type: "text", text: `${lastText}${separator}${nextText}` };
-  } else {
-    blocks.push(block);
-  }
-};
-const visibleContent = (state) => {
-  const content = [];
-  for (const segment of state.segments) {
-    const blocks = [];
-    for (const block of segment.blocks) {
-      const parsed = contentBlockOf(block);
-      if (parsed != null) appendBlock(blocks, parsed, "");
-    }
-    for (const block of blocks) appendBlock(content, block, "\n\n");
-  }
-  return content.flatMap((block) => {
-    const text = textOfBlock(block);
-    if (text == null) return [block];
-    const trimmed = text.trim();
-    return trimmed.length === 0 ? [] : [{ ...block, type: "text", text: trimmed }];
-  });
-};
-const segmentFor = (state, acpMessageId) => {
-  const existing = state.segments.find((segment2) => segment2.acpMessageId === acpMessageId);
-  if (existing != null) {
-    return existing;
-  }
-  const segment = segmentSchema.parse({ acpMessageId, blocks: [] });
-  state.segments.push(segment);
-  return segment;
-};
-const accumulateUpdate = (state, update) => {
-  const json = updateJson(update);
-  const chunk = agentChunkSchema.safeParse(json);
-  if (chunk.success) {
-    const block = contentBlockOf(chunk.data.content);
-    if (block == null) return null;
-    const segment = segmentFor(state, chunk.data.messageId);
-    const last = segment.blocks.at(-1);
-    const lastBlock = last == null ? null : contentBlockOf(last);
-    const lastText = lastBlock == null ? null : plainText(lastBlock);
-    const nextText = plainText(block);
-    if (lastText != null && nextText != null)
-      segment.blocks[segment.blocks.length - 1] = { type: "text", text: `${lastText}${nextText}` };
-    else segment.blocks.push(jsonOfContentBlock(block));
-    return segment;
-  }
-  const message = agentMessageSchema.safeParse(json);
-  if (message.success) {
-    if (message.data.content === void 0) return null;
-    const blocks = (message.data.content ?? []).flatMap((block) => {
-      const parsed = contentBlockOf(block);
-      return parsed == null ? [] : [jsonOfContentBlock(parsed)];
-    });
-    const segment = segmentFor(state, message.data.messageId);
-    segment.blocks = blocks;
-    return segment;
-  }
-  return null;
-};
-const createProjector = (config = {}) => {
-  const now = config.now ?? Date.now;
-  const interval = config.updateIntervalMs ?? DEFAULT_PROJECTION_UPDATE_INTERVAL_MS;
-  const fold = async (update, ctx) => {
-    const state = projectionStateOf(ctx.state.get());
-    const segment = accumulateUpdate(state, update);
-    if (state.messageId == null && (segment == null || segment.messageId == null)) {
-      for (const previous of state.segments) {
-        if (previous === segment || !previous.dirty || previous.messageId == null) continue;
-        await ctx.platform.conversations.updateMessage({
-          messageId: previous.messageId,
-          content: visibleContent({ segments: [previous] }),
-          final: false
-        });
-        previous.lastFlushAt = now();
-        previous.dirty = false;
-      }
-    }
-    if (segment == null) {
-      ctx.state.set(state);
-      return;
-    }
-    const target = state.messageId == null ? segment : state;
-    target.lastSeq = ctx.seq;
-    const content = () => visibleContent({ segments: target === state ? state.segments : [segment] });
-    if (target.messageId == null) {
-      const visible = content();
-      if (visible.length === 0) {
-        ctx.state.set(state);
-        return;
-      }
-      const message = await ctx.platform.conversations.postMessage({
-        conversationId: ctx.conversation.conversationId,
-        authorParticipantId: ctx.agentParticipant.id,
-        kind: MessageKind.Message,
-        content: visible,
-        source: { turnId: ctx.turn.id, fromSeq: ctx.seq, toSeq: ctx.seq }
-      });
-      target.messageId = message.messageId;
-      target.messageSeq = message.seq;
-      target.fromSeq = ctx.seq;
-      target.lastFlushAt = now();
-      target.dirty = false;
-    } else if (now() - target.lastFlushAt >= interval) {
-      await ctx.platform.conversations.updateMessage({
-        messageId: target.messageId,
-        content: content(),
-        final: false
-      });
-      target.lastFlushAt = now();
-      target.dirty = false;
-    } else {
-      target.dirty = true;
-    }
-    ctx.state.set(state);
-  };
-  const finish = async (ctx) => {
-    const state = projectionStateOf(ctx.state.get());
-    if (state.messageId != null) {
-      await finishMessage(ctx, state, visibleContent(state));
-      return;
-    }
-    for (const segment of state.segments) {
-      await finishMessage(ctx, segment, visibleContent({ segments: [segment] }));
-    }
-  };
-  const finishMessage = async (ctx, state, content) => {
-    if (state.messageId == null) {
-      return;
-    }
-    await ctx.platform.conversations.updateMessage({
-      messageId: state.messageId,
-      content,
-      final: true
-    });
-    const reply = state.messageSeq == null ? null : (await ctx.platform.conversations.recentMessages({
-      conversationId: ctx.conversation.conversationId,
-      beforeSeq: state.messageSeq + 1,
-      limit: 1
-    })).find((message) => message.messageId === state.messageId);
-    if (reply == null) {
-      ctx.platform.log("finished reply not found for routing", {
-        messageId: state.messageId,
-        seq: state.messageSeq
-      });
-    }
-    if (reply != null) {
-      if (ctx.platform.conversations.dispatchMessage == null)
-        throw new Error("channel dispatch is unavailable");
-      await ctx.platform.conversations.dispatchMessage({
-        conversationId: reply.conversationId,
-        messageId: reply.messageId
-      });
-    }
-  };
-  const project = async (update, ctx) => {
-    const { conversation, agentParticipant } = ctx;
-    if (conversation == null || agentParticipant == null)
-      throw new Error("Final rendering requires a Final conversation");
-    const context = { ...ctx, conversation, agentParticipant };
-    return turnEndOf(update) == null ? fold(update, context) : finish(context);
-  };
-  return { project };
-};
-export {
-  DEFAULT_PROJECTION_UPDATE_INTERVAL_MS,
-  accumulateUpdate,
-  createProjector,
-  emptyProjectionState,
-  projectionStateOf,
-  projectionStateSchema,
-  visibleContent
-};
-//# sourceMappingURL=projection.mjs.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../src/channels/projection.ts"],
-  "sourcesContent": ["import type { ContentBlock, SessionUpdate } from '@agentclientprotocol/sdk/experimental/v2';\nimport { textOfBlock } from '@finalai/acp-session';\nimport {\n  jsonObjectSchema,\n  MessageKind,\n  turnEndOf,\n  TurnPolicy,\n  type JsonValue,\n  type ProjectionContextIface,\n} from '@finalai/agent-provider';\nimport * as z from 'zod';\nimport { contentBlockOf, jsonOfContentBlock } from \"./content.mjs\";\n\n// Each ACP message ID owns a visible conversation message. The message is\n// created on its first visible chunk (streaming),\n// updated at most every `updateIntervalMs`, and finalized at the idle\n// state_update that ends the turn. The fold lives in the turn state the\n// platform keeps (ctx.state). An empty turn projects nothing.\n\nexport const DEFAULT_PROJECTION_UPDATE_INTERVAL_MS = 300;\n\nconst projectedMessageSchema = z.object({\n  messageId: z.string().nullable().default(null),\n  // The reply's conversation seq, so the finished reply is read back by\n  // position however many messages arrived meanwhile.\n  messageSeq: z.number().nullable().default(null),\n  fromSeq: z.number().nullable().default(null),\n  lastSeq: z.number().nullable().default(null),\n  lastFlushAt: z.number().default(0),\n  dirty: z.boolean().default(false),\n});\n\nconst segmentSchema = projectedMessageSchema.extend({\n  acpMessageId: z.string(),\n  blocks: z.array(jsonObjectSchema),\n});\n\n// Root message fields are retained for turns created by the old projector.\n// Those turns finish in their existing combined row; new turns use segment rows.\nexport const projectionStateSchema = projectedMessageSchema.extend({\n  segments: z.array(segmentSchema),\n});\n\nexport type ProjectionStateIface = z.infer<typeof projectionStateSchema>;\n\nexport interface ProjectorConfigIface {\n  updateIntervalMs?: number;\n  now?: () => number;\n  // The channel's turnPolicy, for routing finished replies (default steer).\n  turnPolicy?: TurnPolicy;\n}\n\nconst agentChunkSchema = z.object({\n  sessionUpdate: z.literal('agent_message_chunk'),\n  messageId: z.string(),\n  content: jsonObjectSchema,\n});\n\nconst agentMessageSchema = z.object({\n  sessionUpdate: z.literal('agent_message'),\n  messageId: z.string(),\n  content: z.array(jsonObjectSchema).nullish(),\n});\n\nconst updateJson = (update: SessionUpdate): JsonValue => {\n  const parsed = jsonObjectSchema.safeParse(JSON.parse(JSON.stringify(update)));\n  return parsed.success ? parsed.data : null;\n};\n\nexport const emptyProjectionState = (): ProjectionStateIface => ({\n  messageId: null,\n  messageSeq: null,\n  fromSeq: null,\n  lastSeq: null,\n  lastFlushAt: 0,\n  dirty: false,\n  segments: [],\n});\n\nexport const projectionStateOf = (state: JsonValue | null): ProjectionStateIface => {\n  const parsed = projectionStateSchema.safeParse(state);\n  return parsed.success ? parsed.data : emptyProjectionState();\n};\n\n// Plain text (no `_meta`) of a block, the only kind consecutive chunks merge into.\nconst plainText = (block: ContentBlock | undefined): string | null =>\n  block == null || block._meta != null ? null : textOfBlock(block);\n\nconst appendBlock = (blocks: ContentBlock[], block: ContentBlock, separator: string): void => {\n  const lastText = plainText(blocks.at(-1));\n  const nextText = plainText(block);\n  if (lastText != null && nextText != null) {\n    blocks[blocks.length - 1] = { type: 'text', text: `${lastText}${separator}${nextText}` };\n  } else {\n    blocks.push(block);\n  }\n};\n\n// The visible content of the turn: segments in order of first appearance,\n// separated by a blank line between text runs.\nexport const visibleContent = (state: Pick<ProjectionStateIface, 'segments'>): ContentBlock[] => {\n  const content: ContentBlock[] = [];\n  for (const segment of state.segments) {\n    const blocks: ContentBlock[] = [];\n    for (const block of segment.blocks) {\n      const parsed = contentBlockOf(block);\n      if (parsed != null) appendBlock(blocks, parsed, '');\n    }\n    for (const block of blocks) appendBlock(content, block, '\\n\\n');\n  }\n  return content.flatMap((block): ContentBlock[] => {\n    const text = textOfBlock(block);\n    if (text == null) return [block];\n    const trimmed = text.trim();\n    return trimmed.length === 0 ? [] : [{ ...block, type: 'text', text: trimmed }];\n  });\n};\n\nconst segmentFor = (\n  state: ProjectionStateIface,\n  acpMessageId: string,\n): ProjectionStateIface['segments'][number] => {\n  const existing = state.segments.find((segment) => segment.acpMessageId === acpMessageId);\n  if (existing != null) {\n    return existing;\n  }\n  const segment = segmentSchema.parse({ acpMessageId, blocks: [] });\n  state.segments.push(segment);\n  return segment;\n};\n\n// Folds one ACP update into the state and returns the affected segment, or null\n// for updates that are not visible output.\nexport const accumulateUpdate = (\n  state: ProjectionStateIface,\n  update: SessionUpdate,\n): ProjectionStateIface['segments'][number] | null => {\n  const json = updateJson(update);\n  const chunk = agentChunkSchema.safeParse(json);\n  if (chunk.success) {\n    const block = contentBlockOf(chunk.data.content);\n    if (block == null) return null;\n    const segment = segmentFor(state, chunk.data.messageId);\n    // Plain text joins the run before it as it arrives (visibleContent joins\n    // them the same way), so the state and each fold stay the same size\n    // however long the reply grows.\n    const last = segment.blocks.at(-1);\n    const lastBlock = last == null ? null : contentBlockOf(last);\n    const lastText = lastBlock == null ? null : plainText(lastBlock);\n    const nextText = plainText(block);\n    if (lastText != null && nextText != null)\n      segment.blocks[segment.blocks.length - 1] = { type: 'text', text: `${lastText}${nextText}` };\n    else segment.blocks.push(jsonOfContentBlock(block));\n    return segment;\n  }\n  const message = agentMessageSchema.safeParse(json);\n  if (message.success) {\n    // ACP v2 upsert: a concrete array replaces the message's content; omitted leaves it.\n    if (message.data.content === undefined) return null;\n    const blocks = (message.data.content ?? []).flatMap((block) => {\n      const parsed = contentBlockOf(block);\n      return parsed == null ? [] : [jsonOfContentBlock(parsed)];\n    });\n    const segment = segmentFor(state, message.data.messageId);\n    segment.blocks = blocks;\n    return segment;\n  }\n  return null;\n};\n\ninterface ConversationProjectionContextIface extends ProjectionContextIface {\n  conversation: NonNullable<ProjectionContextIface['conversation']>;\n  agentParticipant: NonNullable<ProjectionContextIface['agentParticipant']>;\n}\n\nexport interface ProjectorIface {\n  // RoomSurfaceDefinitionIface['project'] for the messaging channels: folds visible\n  // output into separate messages and, at the turn-ending idle state_update,\n  // finalizes and routes them in order of first appearance.\n  project(update: SessionUpdate, ctx: ProjectionContextIface): Promise<void>;\n}\n\nexport const createProjector = (config: ProjectorConfigIface = {}): ProjectorIface => {\n  const now = config.now ?? Date.now;\n  const interval = config.updateIntervalMs ?? DEFAULT_PROJECTION_UPDATE_INTERVAL_MS;\n\n  const fold = async (\n    update: SessionUpdate,\n    ctx: ConversationProjectionContextIface,\n  ): Promise<void> => {\n    const state = projectionStateOf(ctx.state.get());\n    const segment = accumulateUpdate(state, update);\n    if (state.messageId == null && (segment == null || segment.messageId == null)) {\n      for (const previous of state.segments) {\n        if (previous === segment || !previous.dirty || previous.messageId == null) continue;\n        await ctx.platform.conversations.updateMessage({\n          messageId: previous.messageId,\n          content: visibleContent({ segments: [previous] }),\n          final: false,\n        });\n        previous.lastFlushAt = now();\n        previous.dirty = false;\n      }\n    }\n    if (segment == null) {\n      ctx.state.set(state);\n      return;\n    }\n    const target = state.messageId == null ? segment : state;\n    target.lastSeq = ctx.seq;\n    // Built only when it is written: between flushes a chunk only folds.\n    const content = () =>\n      visibleContent({ segments: target === state ? state.segments : [segment] });\n    if (target.messageId == null) {\n      const visible = content();\n      if (visible.length === 0) {\n        ctx.state.set(state);\n        return;\n      }\n      const message = await ctx.platform.conversations.postMessage({\n        conversationId: ctx.conversation.conversationId,\n        authorParticipantId: ctx.agentParticipant.id,\n        kind: MessageKind.Message,\n        content: visible,\n        source: { turnId: ctx.turn.id, fromSeq: ctx.seq, toSeq: ctx.seq },\n      });\n      target.messageId = message.messageId;\n      target.messageSeq = message.seq;\n      target.fromSeq = ctx.seq;\n      target.lastFlushAt = now();\n      target.dirty = false;\n    } else if (now() - target.lastFlushAt >= interval) {\n      await ctx.platform.conversations.updateMessage({\n        messageId: target.messageId,\n        content: content(),\n        final: false,\n      });\n      target.lastFlushAt = now();\n      target.dirty = false;\n    } else {\n      target.dirty = true;\n    }\n    ctx.state.set(state);\n  };\n\n  const finish = async (ctx: ConversationProjectionContextIface): Promise<void> => {\n    const state = projectionStateOf(ctx.state.get());\n    if (state.messageId != null) {\n      await finishMessage(ctx, state, visibleContent(state));\n      return;\n    }\n    for (const segment of state.segments) {\n      await finishMessage(ctx, segment, visibleContent({ segments: [segment] }));\n    }\n  };\n\n  const finishMessage = async (\n    ctx: ConversationProjectionContextIface,\n    state: z.infer<typeof projectedMessageSchema>,\n    content: ContentBlock[],\n  ): Promise<void> => {\n    if (state.messageId == null) {\n      return;\n    }\n    await ctx.platform.conversations.updateMessage({\n      messageId: state.messageId,\n      content,\n      final: true,\n    });\n    // The finished reply is routed like any message: other agents may observe\n    // it or, when mentioned within the hop limit, be prompted.\n    const reply =\n      state.messageSeq == null\n        ? null\n        : (\n            await ctx.platform.conversations.recentMessages({\n              conversationId: ctx.conversation.conversationId,\n              beforeSeq: state.messageSeq + 1,\n              limit: 1,\n            })\n          ).find((message) => message.messageId === state.messageId);\n    if (reply == null) {\n      ctx.platform.log('finished reply not found for routing', {\n        messageId: state.messageId,\n        seq: state.messageSeq,\n      });\n    }\n    if (reply != null) {\n      if (ctx.platform.conversations.dispatchMessage == null)\n        throw new Error('channel dispatch is unavailable');\n      await ctx.platform.conversations.dispatchMessage({\n        conversationId: reply.conversationId,\n        messageId: reply.messageId,\n      });\n    }\n  };\n\n  const project: ProjectorIface['project'] = async (update, ctx) => {\n    const { conversation, agentParticipant } = ctx;\n    if (conversation == null || agentParticipant == null)\n      throw new Error('Final rendering requires a Final conversation');\n    const context = { ...ctx, conversation, agentParticipant };\n    return turnEndOf(update) == null ? fold(update, context) : finish(context);\n  };\n\n  return { project };\n};\n"],
-  "mappings": "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",
-  "names": ["segment"]
-}

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

@@ -1,72 +0,0 @@
-import type { ContentBlock } from '@agentclientprotocol/sdk/experimental/v2';
-import { type FinalAuthorIface, type FinalContextIface, type FinalMessageRefIface } from '@finalai/acp-session';
-import { type RoomAuthIface, type ConversationMessageIface, type ParticipantIface } from '@finalai/agent-provider/room-surface';
-export declare const EXCERPT_CHARS = 280;
-export declare const CATCH_UP_MAX_MESSAGES = 20;
-export declare const CATCH_UP_MAX_CHARS = 4000;
-export declare const textBlock: (text: string) => ContentBlock;
-export declare const contentText: (content: ContentBlock[]) => string;
-export declare const messageSummary: (content: ContentBlock[]) => string;
-export declare const excerpt: (text: string, maxChars?: number) => string;
-export declare const finalAuthorOf: (participant: ParticipantIface) => FinalAuthorIface;
-export declare const principalAuthorOf: (args: {
-    auth: RoomAuthIface;
-    agent?: boolean;
-}) => FinalAuthorIface;
-export interface AuthorPrefixedContentArgsIface {
-    content: ContentBlock[];
-    author: FinalAuthorIface;
-    rendersAuthorMeta: boolean;
-    context?: FinalContextIface;
-}
-export declare const authorPrefixedContent: (args: AuthorPrefixedContentArgsIface) => ContentBlock[];
-export interface ReplyContextArgsIface {
-    replyTo?: FinalMessageRefIface | null;
-    thread?: {
-        rootMessageId: string;
-        rootExcerpt: string;
-        rootAuthor?: FinalAuthorIface | null;
-    } | null;
-    quotes?: FinalMessageRefIface[];
-}
-export declare const finalContextOf: (args: ReplyContextArgsIface) => FinalContextIface | undefined;
-export declare const renderReplyContext: (args: ReplyContextArgsIface) => ContentBlock | null;
-export declare const messageRefOf: (message: ConversationMessageIface, participants: ParticipantIface[]) => FinalMessageRefIface;
-export declare enum CatchUpSince {
-    Start = "start",
-    LastContact = "last-contact"
-}
-export interface CatchUpArgsIface {
-    messages: ConversationMessageIface[];
-    participants: ParticipantIface[];
-    agentParticipantId: string;
-    since: CatchUpSince;
-    maxMessages?: number;
-    maxChars?: number;
-}
-export declare const buildCatchUpBlock: (args: CatchUpArgsIface) => ContentBlock | null;
-export declare const systemNoticeBlock: (args: {
-    text: string;
-}) => ContentBlock;
-export declare const catchUpFor: (args: {
-    recipient: ParticipantIface;
-    earlier: ConversationMessageIface[];
-    participants: ParticipantIface[];
-}) => ContentBlock | null;
-export interface PromptContentArgsIface {
-    message: ConversationMessageIface;
-    author: ParticipantIface;
-    recipient: ParticipantIface;
-    replyContext: ReplyContextArgsIface;
-    catchUp: ContentBlock | null;
-}
-export declare const buildPromptContent: (args: PromptContentArgsIface) => ContentBlock[];
-export interface ServiceInputPromptArgsIface {
-    content: ContentBlock[];
-    context?: string[];
-    author: FinalAuthorIface;
-    recipient: ParticipantIface;
-    earlier: ConversationMessageIface[];
-    participants: ParticipantIface[];
-}
-export declare const buildServiceInputPrompt: (args: ServiceInputPromptArgsIface) => ContentBlock[];

package/dist/modules/channels/prompt.mjs

@@ -1,208 +0,0 @@
-import {
-  FinalAuthorKind,
-  FinalContentRole,
-  promptTextWithAuthorPrefix,
-  textOf,
-  withFinalMeta
-} from "@finalai/acp-session";
-import {
-  RoomPrincipalType,
-  MessageKind,
-  ParticipantKind,
-  principalDisplayName,
-  RoutingMode
-} from "@finalai/agent-provider/room-surface";
-const EXCERPT_CHARS = 280;
-const CATCH_UP_MAX_MESSAGES = 20;
-const CATCH_UP_MAX_CHARS = 4e3;
-const textBlock = (text) => ({ type: "text", text });
-const contentText = (content) => textOf(content, { separator: "\n" }).trim();
-const messageSummary = (content) => {
-  const text = contentText(content);
-  if (text.length > 0) {
-    return text;
-  }
-  const attachments = content.filter((block) => block.type !== "text").length;
-  return attachments === 0 ? "" : `[${attachments} attachment${attachments === 1 ? "" : "s"}]`;
-};
-const excerpt = (text, maxChars = EXCERPT_CHARS) => {
-  const normalized = text.replace(/\s+/gu, " ").trim();
-  return normalized.length <= maxChars ? normalized : `${normalized.slice(0, maxChars - 1)}\u2026`;
-};
-const finalAuthorOf = (participant) => ({
-  participantId: participant.id,
-  kind: participant.kind === ParticipantKind.Agent ? FinalAuthorKind.Agent : FinalAuthorKind.User,
-  displayName: participant.displayName
-});
-const principalAuthorOf = (args) => ({
-  kind: args.agent === true ? FinalAuthorKind.Agent : args.auth.principalType === RoomPrincipalType.User ? FinalAuthorKind.User : FinalAuthorKind.Service,
-  displayName: principalDisplayName(args.auth),
-  principal: {
-    principalId: args.auth.principalId,
-    principalType: args.auth.principalType,
-    authenticator: args.auth.authenticator
-  }
-});
-const withContentRole = (block, context) => withFinalMeta(block, { role: FinalContentRole.Context, context });
-const authorPrefixedContent = (args) => {
-  const blocks = args.rendersAuthorMeta ? args.content : promptTextWithAuthorPrefix(args.content, args.author.displayName);
-  return blocks.map(
-    (block, index) => withFinalMeta(block, { author: args.author, context: index === 0 ? args.context : void 0 })
-  );
-};
-const finalContextOf = (args) => {
-  const context = {};
-  if (args.replyTo != null) context.replyTo = args.replyTo;
-  if (args.thread != null) {
-    context.thread = {
-      rootMessageId: args.thread.rootMessageId,
-      rootExcerpt: args.thread.rootExcerpt
-    };
-  }
-  if (args.quotes != null && args.quotes.length > 0) context.quotes = args.quotes;
-  return Object.keys(context).length === 0 ? void 0 : context;
-};
-const renderReplyContext = (args) => {
-  const context = finalContextOf(args);
-  if (context == null) {
-    return null;
-  }
-  const lines = [];
-  if (args.thread != null) {
-    const by = args.thread.rootAuthor == null ? "" : ` started by ${args.thread.rootAuthor.displayName}`;
-    lines.push(`In a thread${by}: "${args.thread.rootExcerpt}"`);
-  }
-  if (args.replyTo != null) {
-    lines.push(
-      `Replying to ${args.replyTo.author?.displayName ?? "a message"}: "${args.replyTo.excerpt}"`
-    );
-  }
-  for (const quote of args.quotes ?? []) {
-    lines.push(`Quoting ${quote.author?.displayName ?? "a message"}: "${quote.excerpt}"`);
-  }
-  return withContentRole(textBlock(lines.join("\n")), context);
-};
-const messageRefOf = (message, participants) => {
-  const author = participants.find((participant) => participant.id === message.authorParticipantId);
-  return {
-    messageId: message.messageId,
-    author: author == null ? null : finalAuthorOf(author),
-    excerpt: excerpt(messageSummary(message.content))
-  };
-};
-const transcriptLine = (message, participants) => {
-  const author = participants.find((participant) => participant.id === message.authorParticipantId);
-  return `${author?.displayName ?? "Someone"}: ${messageSummary(message.content)}`;
-};
-const visibleForTranscript = (message) => message.kind !== MessageKind.Card && messageSummary(message.content).length > 0;
-const boundedLines = (args) => {
-  const lines = [];
-  let chars = 0;
-  const ordered = [...args.messages].sort((left, right) => right.seq - left.seq);
-  for (const message of ordered) {
-    const line = transcriptLine(message, args.participants);
-    if (lines.length >= args.maxMessages || chars + line.length > args.maxChars) {
-      break;
-    }
-    lines.push(line);
-    chars += line.length + 1;
-  }
-  return { lines: lines.reverse(), omitted: ordered.length - lines.length };
-};
-var CatchUpSince = /* @__PURE__ */ ((CatchUpSince2) => {
-  CatchUpSince2["Start"] = "start";
-  CatchUpSince2["LastContact"] = "last-contact";
-  return CatchUpSince2;
-})(CatchUpSince || {});
-const buildCatchUpBlock = (args) => {
-  let unseen = args.messages.filter(
-    (message) => visibleForTranscript(message) && message.authorParticipantId !== args.agentParticipantId
-  );
-  if (args.since === "last-contact" /* LastContact */) {
-    const lastContactSeq = args.messages.reduce(
-      (latest, message) => message.authorParticipantId === args.agentParticipantId || message.mentionedParticipantIds.includes(args.agentParticipantId) ? Math.max(latest, message.seq) : latest,
-      -1
-    );
-    unseen = unseen.filter((message) => message.seq > lastContactSeq);
-  }
-  if (unseen.length === 0) {
-    return null;
-  }
-  const { lines, omitted } = boundedLines({
-    messages: unseen,
-    participants: args.participants,
-    maxMessages: args.maxMessages ?? CATCH_UP_MAX_MESSAGES,
-    maxChars: args.maxChars ?? CATCH_UP_MAX_CHARS
-  });
-  if (lines.length === 0) {
-    return null;
-  }
-  const header = "Earlier in this conversation, not previously shown:";
-  const omittedLine = omitted > 0 ? [`(${omitted} earlier message${omitted === 1 ? "" : "s"} omitted)`] : [];
-  return withContentRole(textBlock([header, ...omittedLine, ...lines].join("\n")));
-};
-const systemNoticeBlock = (args) => withFinalMeta(textBlock(args.text), {
-  author: { kind: FinalAuthorKind.Service, displayName: "Final" }
-});
-const catchUpFor = (args) => {
-  const since = args.recipient.sessionId == null ? "start" /* Start */ : args.recipient.routingMode === RoutingMode.Mention ? "last-contact" /* LastContact */ : null;
-  if (since == null) return null;
-  return buildCatchUpBlock({
-    messages: args.earlier,
-    participants: args.participants,
-    agentParticipantId: args.recipient.id,
-    since
-  });
-};
-const buildPromptContent = (args) => {
-  const contextBlock = renderReplyContext(args.replyContext);
-  const body = authorPrefixedContent({
-    content: args.message.content.length > 0 ? args.message.content : [textBlock(args.message.body)],
-    author: finalAuthorOf(args.author),
-    rendersAuthorMeta: args.recipient.rendersAuthorMeta ?? false,
-    context: finalContextOf(args.replyContext)
-  });
-  return [
-    ...args.catchUp == null ? [] : [args.catchUp],
-    ...contextBlock == null ? [] : [contextBlock],
-    ...body
-  ];
-};
-const buildServiceInputPrompt = (args) => {
-  const catchUp = catchUpFor({
-    recipient: args.recipient,
-    earlier: args.earlier,
-    participants: args.participants
-  });
-  return [
-    ...catchUp == null ? [] : [catchUp],
-    ...(args.context ?? []).map((text) => withContentRole(textBlock(text))),
-    ...authorPrefixedContent({
-      content: args.content,
-      author: args.author,
-      rendersAuthorMeta: args.recipient.rendersAuthorMeta ?? false
-    })
-  ];
-};
-export {
-  CATCH_UP_MAX_CHARS,
-  CATCH_UP_MAX_MESSAGES,
-  CatchUpSince,
-  EXCERPT_CHARS,
-  authorPrefixedContent,
-  buildCatchUpBlock,
-  buildPromptContent,
-  buildServiceInputPrompt,
-  catchUpFor,
-  contentText,
-  excerpt,
-  finalAuthorOf,
-  finalContextOf,
-  messageRefOf,
-  messageSummary,
-  principalAuthorOf,
-  renderReplyContext,
-  systemNoticeBlock,
-  textBlock
-};
-//# sourceMappingURL=prompt.mjs.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../src/channels/prompt.ts"],
-  "sourcesContent": ["import type { ContentBlock } from '@agentclientprotocol/sdk/experimental/v2';\nimport {\n  FinalAuthorKind,\n  FinalContentRole,\n  promptTextWithAuthorPrefix,\n  textOf,\n  withFinalMeta,\n  type FinalAuthorIface,\n  type FinalContextIface,\n  type FinalMessageRefIface,\n} from '@finalai/acp-session';\nimport {\n  RoomPrincipalType,\n  MessageKind,\n  ParticipantKind,\n  principalDisplayName,\n  RoutingMode,\n  type RoomAuthIface,\n  type ConversationMessageIface,\n  type ParticipantIface,\n} from '@finalai/agent-provider/room-surface';\n\nexport const EXCERPT_CHARS = 280;\nexport const CATCH_UP_MAX_MESSAGES = 20;\nexport const CATCH_UP_MAX_CHARS = 4_000;\n\nexport const textBlock = (text: string): ContentBlock => ({ type: 'text', text });\n\nexport const contentText = (content: ContentBlock[]): string =>\n  textOf(content, { separator: '\\n' }).trim();\n\n// A one-line description of a message for previews, excerpts and transcripts.\nexport const messageSummary = (content: ContentBlock[]): string => {\n  const text = contentText(content);\n  if (text.length > 0) {\n    return text;\n  }\n  const attachments = content.filter((block) => block.type !== 'text').length;\n  return attachments === 0 ? '' : `[${attachments} attachment${attachments === 1 ? '' : 's'}]`;\n};\n\nexport const excerpt = (text: string, maxChars: number = EXCERPT_CHARS): string => {\n  const normalized = text.replace(/\\s+/gu, ' ').trim();\n  return normalized.length <= maxChars ? normalized : `${normalized.slice(0, maxChars - 1)}\u2026`;\n};\n\nexport const finalAuthorOf = (participant: ParticipantIface): FinalAuthorIface => ({\n  participantId: participant.id,\n  kind: participant.kind === ParticipantKind.Agent ? FinalAuthorKind.Agent : FinalAuthorKind.User,\n  displayName: participant.displayName,\n});\n\n// The author an agent sees for channel input from no member: the principal the\n// channel authenticated, named as the channel named it. `agent` marks input an\n// agent wrote elsewhere (another chat), so the recipient knows it is not a person.\nexport const principalAuthorOf = (args: {\n  auth: RoomAuthIface;\n  agent?: boolean;\n}): FinalAuthorIface => ({\n  kind:\n    args.agent === true\n      ? FinalAuthorKind.Agent\n      : args.auth.principalType === RoomPrincipalType.User\n        ? FinalAuthorKind.User\n        : FinalAuthorKind.Service,\n  displayName: principalDisplayName(args.auth),\n  principal: {\n    principalId: args.auth.principalId,\n    principalType: args.auth.principalType,\n    authenticator: args.auth.authenticator,\n  },\n});\n\nconst withContentRole = (block: ContentBlock, context?: FinalContextIface): ContentBlock =>\n  withFinalMeta(block, { role: FinalContentRole.Context, context });\n\n// Attribution: `_meta[\"final.ai\"].author` on every block, plus a\n// `<name>: ` prefix for harnesses that do not render author meta.\nexport interface AuthorPrefixedContentArgsIface {\n  content: ContentBlock[];\n  author: FinalAuthorIface;\n  rendersAuthorMeta: boolean;\n  context?: FinalContextIface;\n}\n\nexport const authorPrefixedContent = (args: AuthorPrefixedContentArgsIface): ContentBlock[] => {\n  const blocks: ContentBlock[] = args.rendersAuthorMeta\n    ? args.content\n    : promptTextWithAuthorPrefix(args.content, args.author.displayName);\n  return blocks.map((block, index) =>\n    withFinalMeta(block, { author: args.author, context: index === 0 ? args.context : undefined }),\n  );\n};\n\nexport interface ReplyContextArgsIface {\n  replyTo?: FinalMessageRefIface | null;\n  thread?: {\n    rootMessageId: string;\n    rootExcerpt: string;\n    rootAuthor?: FinalAuthorIface | null;\n  } | null;\n  quotes?: FinalMessageRefIface[];\n}\n\nexport const finalContextOf = (args: ReplyContextArgsIface): FinalContextIface | undefined => {\n  const context: FinalContextIface = {};\n  if (args.replyTo != null) context.replyTo = args.replyTo;\n  if (args.thread != null) {\n    context.thread = {\n      rootMessageId: args.thread.rootMessageId,\n      rootExcerpt: args.thread.rootExcerpt,\n    };\n  }\n  if (args.quotes != null && args.quotes.length > 0) context.quotes = args.quotes;\n  return Object.keys(context).length === 0 ? undefined : context;\n};\n\n// The rendered reply/thread/quote block, for harnesses that ignore\n// `_meta`. Null when the message has no context.\nexport const renderReplyContext = (args: ReplyContextArgsIface): ContentBlock | null => {\n  const context = finalContextOf(args);\n  if (context == null) {\n    return null;\n  }\n  const lines: string[] = [];\n  if (args.thread != null) {\n    const by =\n      args.thread.rootAuthor == null ? '' : ` started by ${args.thread.rootAuthor.displayName}`;\n    lines.push(`In a thread${by}: \"${args.thread.rootExcerpt}\"`);\n  }\n  if (args.replyTo != null) {\n    lines.push(\n      `Replying to ${args.replyTo.author?.displayName ?? 'a message'}: \"${args.replyTo.excerpt}\"`,\n    );\n  }\n  for (const quote of args.quotes ?? []) {\n    lines.push(`Quoting ${quote.author?.displayName ?? 'a message'}: \"${quote.excerpt}\"`);\n  }\n  return withContentRole(textBlock(lines.join('\\n')), context);\n};\n\nexport const messageRefOf = (\n  message: ConversationMessageIface,\n  participants: ParticipantIface[],\n): FinalMessageRefIface => {\n  const author = participants.find((participant) => participant.id === message.authorParticipantId);\n  return {\n    messageId: message.messageId,\n    author: author == null ? null : finalAuthorOf(author),\n    excerpt: excerpt(messageSummary(message.content)),\n  };\n};\n\nconst transcriptLine = (\n  message: ConversationMessageIface,\n  participants: ParticipantIface[],\n): string => {\n  const author = participants.find((participant) => participant.id === message.authorParticipantId);\n  return `${author?.displayName ?? 'Someone'}: ${messageSummary(message.content)}`;\n};\n\nconst visibleForTranscript = (message: ConversationMessageIface): boolean =>\n  message.kind !== MessageKind.Card && messageSummary(message.content).length > 0;\n\ninterface BoundedLinesArgsIface {\n  messages: ConversationMessageIface[];\n  participants: ParticipantIface[];\n  maxMessages: number;\n  maxChars: number;\n}\n\ninterface BoundedLinesIface {\n  lines: string[];\n  omitted: number;\n}\n\n// Lines from newest backwards until a bound is hit, returned oldest first.\nconst boundedLines = (args: BoundedLinesArgsIface): BoundedLinesIface => {\n  const lines: string[] = [];\n  let chars = 0;\n  const ordered = [...args.messages].sort((left, right) => right.seq - left.seq);\n  for (const message of ordered) {\n    const line = transcriptLine(message, args.participants);\n    if (lines.length >= args.maxMessages || chars + line.length > args.maxChars) {\n      break;\n    }\n    lines.push(line);\n    chars += line.length + 1;\n  }\n  return { lines: lines.reverse(), omitted: ordered.length - lines.length };\n};\n\nexport enum CatchUpSince {\n  // A session that has never seen this conversation (new or reset).\n  Start = 'start',\n  // An agent that does not observe: since it last spoke or was mentioned.\n  LastContact = 'last-contact',\n}\n\nexport interface CatchUpArgsIface {\n  // Messages before the one being delivered, any order.\n  messages: ConversationMessageIface[];\n  participants: ParticipantIface[];\n  agentParticipantId: string;\n  since: CatchUpSince;\n  maxMessages?: number;\n  maxChars?: number;\n}\n\n// \"Earlier in this conversation, not previously shown: \u2026\", marked\n// as context. Null when there is nothing the agent has not seen.\nexport const buildCatchUpBlock = (args: CatchUpArgsIface): ContentBlock | null => {\n  let unseen = args.messages.filter(\n    (message) =>\n      visibleForTranscript(message) && message.authorParticipantId !== args.agentParticipantId,\n  );\n  if (args.since === CatchUpSince.LastContact) {\n    const lastContactSeq = args.messages.reduce(\n      (latest, message) =>\n        message.authorParticipantId === args.agentParticipantId ||\n        message.mentionedParticipantIds.includes(args.agentParticipantId)\n          ? Math.max(latest, message.seq)\n          : latest,\n      -1,\n    );\n    unseen = unseen.filter((message) => message.seq > lastContactSeq);\n  }\n  if (unseen.length === 0) {\n    return null;\n  }\n  const { lines, omitted } = boundedLines({\n    messages: unseen,\n    participants: args.participants,\n    maxMessages: args.maxMessages ?? CATCH_UP_MAX_MESSAGES,\n    maxChars: args.maxChars ?? CATCH_UP_MAX_CHARS,\n  });\n  if (lines.length === 0) {\n    return null;\n  }\n  const header = 'Earlier in this conversation, not previously shown:';\n  const omittedLine =\n    omitted > 0 ? [`(${omitted} earlier message${omitted === 1 ? '' : 's'} omitted)`] : [];\n  return withContentRole(textBlock([header, ...omittedLine, ...lines].join('\\n')));\n};\n\n// A notice from Final itself delivered by observe: reactions, membership changes.\nexport const systemNoticeBlock = (args: { text: string }): ContentBlock =>\n  withFinalMeta(textBlock(args.text), {\n    author: { kind: FinalAuthorKind.Service, displayName: 'Final' },\n  });\n\n// What a recipient has not seen of its conversation before a prompt: a fresh\n// session has seen nothing; a Mention agent sees only what it is prompted\n// with; everyone else has been observing.\nexport const catchUpFor = (args: {\n  recipient: ParticipantIface;\n  earlier: ConversationMessageIface[];\n  participants: ParticipantIface[];\n}): ContentBlock | null => {\n  const since =\n    args.recipient.sessionId == null\n      ? CatchUpSince.Start\n      : args.recipient.routingMode === RoutingMode.Mention\n        ? CatchUpSince.LastContact\n        : null;\n  if (since == null) return null;\n  return buildCatchUpBlock({\n    messages: args.earlier,\n    participants: args.participants,\n    agentParticipantId: args.recipient.id,\n    since,\n  });\n};\n\nexport interface PromptContentArgsIface {\n  message: ConversationMessageIface;\n  author: ParticipantIface;\n  recipient: ParticipantIface;\n  replyContext: ReplyContextArgsIface;\n  catchUp: ContentBlock | null;\n}\n\n// The ACP prompt one agent receives for a conversation message.\nexport const buildPromptContent = (args: PromptContentArgsIface): ContentBlock[] => {\n  const contextBlock = renderReplyContext(args.replyContext);\n  const body = authorPrefixedContent({\n    content:\n      args.message.content.length > 0 ? args.message.content : [textBlock(args.message.body)],\n    author: finalAuthorOf(args.author),\n    rendersAuthorMeta: args.recipient.rendersAuthorMeta ?? false,\n    context: finalContextOf(args.replyContext),\n  });\n  return [\n    ...(args.catchUp == null ? [] : [args.catchUp]),\n    ...(contextBlock == null ? [] : [contextBlock]),\n    ...body,\n  ];\n};\n\nexport interface ServiceInputPromptArgsIface {\n  content: ContentBlock[];\n  // Channel-supplied context lines, marked as context before the input.\n  context?: string[];\n  author: FinalAuthorIface;\n  recipient: ParticipantIface;\n  // The room's latest messages when the input is delivered, any order.\n  earlier: ConversationMessageIface[];\n  participants: ParticipantIface[];\n}\n\n// The ACP prompt a room's agent receives for channel input: what it has not seen\n// of the room up to its latest message, then the input attributed to its principal.\nexport const buildServiceInputPrompt = (args: ServiceInputPromptArgsIface): ContentBlock[] => {\n  const catchUp = catchUpFor({\n    recipient: args.recipient,\n    earlier: args.earlier,\n    participants: args.participants,\n  });\n  return [\n    ...(catchUp == null ? [] : [catchUp]),\n    ...(args.context ?? []).map((text) => withContentRole(textBlock(text))),\n    ...authorPrefixedContent({\n      content: args.content,\n      author: args.author,\n      rendersAuthorMeta: args.recipient.rendersAuthorMeta ?? false,\n    }),\n  ];\n};\n"],
-  "mappings": "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",
-  "names": ["CatchUpSince"]
-}

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

@@ -1,5 +0,0 @@
-import { type ParticipantIface, type RouteArgsIface, type RouteDecisionIface } from '@finalai/agent-provider/room-surface';
-export declare const MAX_AGENT_HOP_DEPTH = 2;
-export declare const effectiveDefaultAgent: (participants: ParticipantIface[]) => ParticipantIface | null;
-export declare const routeMessage: (args: RouteArgsIface) => RouteDecisionIface[];
-export declare const routeToParticipant: (participantId: string) => (args: RouteArgsIface) => RouteDecisionIface[];