@finalai/agent-protocol 0.1.0

package/dist/modules/agent-platform/conversations.mjs

@@ -0,0 +1,378 @@
+import * as z from "zod";
+import { jsonValueSchema } from "../json.mjs";
+import { tolerantStringEnum } from "../tolerance.mjs";
+import { contentBlockSchema, contentInputSchema, nullableString } from "./common.mjs";
+import { permissionOptionSchema } from "./sessions.mjs";
+import {
+  AgentTurnPolicy,
+  CardKind,
+  CardState,
+  ConversationKind,
+  ConversationMessageKind,
+  MessageDeliveryState,
+  MessageStreamingState,
+  ParticipantKind,
+  ParticipantRole,
+  RoutingMode,
+  SystemParticipantKind
+} from "./enums.mjs";
+const participantSummarySchema = z.object({
+  id: z.string(),
+  kind: tolerantStringEnum(ParticipantKind),
+  displayName: z.string(),
+  avatarUrl: nullableString(),
+  userId: nullableString(),
+  agentId: nullableString()
+});
+const participantSchema = participantSummarySchema.extend({
+  conversationId: z.string(),
+  agentSlug: nullableString(),
+  systemKind: tolerantStringEnum(SystemParticipantKind).nullable().default(null),
+  role: tolerantStringEnum(ParticipantRole).nullable().default(null),
+  routingMode: tolerantStringEnum(RoutingMode).nullable().default(null),
+  sessionId: nullableString(),
+  joinedAt: nullableString(),
+  leftAt: nullableString()
+});
+const conversationSchema = z.object({
+  id: z.string(),
+  organizationId: z.string(),
+  kind: tolerantStringEnum(ConversationKind),
+  title: nullableString(),
+  isHome: z.boolean().default(false),
+  turnPolicy: tolerantStringEnum(AgentTurnPolicy),
+  lastMessageSeq: z.number().default(0),
+  lastMessagePreview: nullableString(),
+  lastMessageAt: nullableString(),
+  unreadCount: z.number().default(0),
+  participants: z.array(participantSummarySchema).default([]),
+  archivedAt: nullableString(),
+  createdAt: z.string(),
+  updatedAt: nullableString()
+});
+const messageAuthorSchema = z.object({
+  participantId: z.string(),
+  kind: tolerantStringEnum(ParticipantKind),
+  displayName: z.string(),
+  avatarUrl: nullableString(),
+  userId: nullableString(),
+  agentId: nullableString()
+});
+const reactionSchema = z.object({
+  emoji: z.string(),
+  count: z.number(),
+  /** Whether the caller reacted; false in realtime broadcasts, which are not per viewer. */
+  mine: z.boolean().default(false)
+});
+const attachmentSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  contentType: z.string(),
+  sizeBytes: z.number(),
+  url: nullableString(),
+  thumbnailUrl: nullableString()
+});
+const entityLinkSchema = z.object({
+  kind: z.string(),
+  id: z.string(),
+  title: nullableString(),
+  url: nullableString(),
+  description: z.string().nullable().optional(),
+  imageUrl: z.string().nullable().optional()
+});
+const cardResolutionSchema = z.object({
+  outcome: jsonValueSchema.nullable().default(null),
+  resolvedByParticipantId: nullableString(),
+  resolvedAt: nullableString()
+});
+const cardSchema = z.object({
+  id: z.string(),
+  kind: tolerantStringEnum(CardKind),
+  pendingRequestId: nullableString(),
+  sessionId: nullableString(),
+  title: nullableString(),
+  body: nullableString(),
+  options: z.array(permissionOptionSchema).default([]),
+  /** Elicitation form schema (JSON Schema). */
+  form: jsonValueSchema.nullable().default(null),
+  entityLinks: z.array(entityLinkSchema).default([]),
+  /** Optional renderer hint; unrecognized presentations keep the generic card. */
+  presentation: jsonValueSchema.nullable().default(null),
+  answerMessageId: nullableString(),
+  audienceParticipantIds: z.array(z.string()).default([]),
+  state: tolerantStringEnum(CardState),
+  resolution: cardResolutionSchema.nullable().default(null)
+});
+const replyToSchema = z.object({
+  messageId: z.string(),
+  authorDisplayName: nullableString(),
+  excerpt: nullableString()
+});
+const messageStreamingSchema = z.object({
+  state: tolerantStringEnum(MessageStreamingState),
+  turnId: nullableString()
+});
+const messageDeliveryStateSchema = z.object({
+  participantId: z.string(),
+  state: tolerantStringEnum(MessageDeliveryState),
+  error: nullableString()
+});
+const conversationMessageSchema = z.object({
+  id: z.string(),
+  conversationId: z.string(),
+  seq: z.number(),
+  author: messageAuthorSchema,
+  kind: tolerantStringEnum(ConversationMessageKind),
+  /** Plain-text rendering of `content`. */
+  body: z.string().default(""),
+  content: z.array(contentBlockSchema).default([]),
+  replyTo: replyToSchema.nullable().default(null),
+  /** Earlier messages the author quoted, in order; deleted ones have a null excerpt. */
+  quotes: z.array(replyToSchema).default([]),
+  threadRootId: nullableString(),
+  replyCount: z.number().default(0),
+  mentions: z.array(z.string()).default([]),
+  reactions: z.array(reactionSchema).default([]),
+  attachments: z.array(attachmentSchema).default([]),
+  card: cardSchema.nullable().default(null),
+  /** Set on agent replies while projected from a running turn; null on human messages. */
+  streaming: messageStreamingSchema.nullable().default(null),
+  sourceTurnId: nullableString(),
+  clientMessageId: nullableString(),
+  deletedAt: nullableString(),
+  createdAt: z.string(),
+  /** Bumped on every change (streaming text, finalize, delete, reactions, card state). */
+  updatedAt: nullableString(),
+  /**
+   * Per-message counter the server increments on every change: the order of
+   * copies of one message. `updatedAt` has only millisecond precision here.
+   */
+  revision: z.number().nullable().default(null),
+  /** Agent recipients the message was routed to, with failures (empty for agent replies routed to nobody). */
+  deliveryStates: z.array(messageDeliveryStateSchema).default([])
+});
+const readStateSchema = z.object({
+  conversationId: z.string(),
+  participantId: z.string(),
+  lastReadSeq: z.number(),
+  unreadCount: z.number().default(0)
+});
+const conversationListSchema = z.object({
+  conversations: z.array(conversationSchema),
+  nextCursor: nullableString()
+});
+const conversationMessagesPageSchema = z.object({
+  messages: z.array(conversationMessageSchema),
+  hasMoreBefore: z.boolean().default(false),
+  hasMoreAfter: z.boolean().default(false),
+  /** With `updatedAfter` or `updatedCursor`: pass as `updatedCursor` to continue; null otherwise. */
+  nextUpdatedCursor: nullableString(),
+  recoverySince: nullableString().optional()
+});
+const messageDeliverySchema = z.object({
+  participantId: z.string(),
+  sessionId: nullableString(),
+  delivery: z.string(),
+  turnId: nullableString(),
+  fromSeq: z.number().nullable().default(null)
+});
+const messageDeliveriesSchema = z.object({
+  deliveries: z.array(messageDeliverySchema)
+});
+const sendMessageResponseSchema = z.object({
+  message: conversationMessageSchema,
+  deliveries: z.array(messageDeliverySchema).default([])
+});
+const reactionsResponseSchema = z.object({
+  messageId: z.string(),
+  reactions: z.array(reactionSchema)
+});
+const participantListSchema = z.object({
+  participants: z.array(participantSchema)
+});
+const attachmentUploadSchema = z.object({
+  attachmentId: z.string(),
+  uploadUrl: z.string(),
+  method: z.string().default("PUT"),
+  headers: z.record(z.string(), z.string()).default({}),
+  expiresAt: nullableString()
+});
+const attachmentDownloadSchema = z.object({
+  attachmentId: z.string(),
+  url: z.string(),
+  expiresAt: nullableString()
+});
+const participantInputSchema = z.union([
+  z.strictObject({ apiKeyPrincipal: z.string().min(1) }),
+  z.strictObject({ user: z.string().min(1) }),
+  z.strictObject({ agent: z.string().min(1), routingMode: z.enum(RoutingMode).optional() })
+]);
+const createConversationRequestSchema = z.strictObject({
+  kind: z.enum(ConversationKind),
+  title: z.string().max(200).optional(),
+  participants: z.array(participantInputSchema),
+  turnPolicy: z.enum(AgentTurnPolicy).optional()
+});
+const createDirectConversationRequestSchema = z.strictObject({
+  agent: z.string().min(1)
+});
+const updateConversationRequestSchema = z.strictObject({
+  title: z.string().max(200).nullable().optional(),
+  turnPolicy: z.enum(AgentTurnPolicy).optional(),
+  archived: z.boolean().optional()
+});
+const listConversationsQuerySchema = z.strictObject({
+  includeArchived: z.stringbool({ truthy: ["true"], falsy: ["false"], case: "sensitive" }).optional(),
+  cursor: z.string().optional(),
+  limit: z.coerce.number().int().positive().max(200).optional()
+});
+const listMessagesQuerySchema = z.strictObject({
+  before: z.coerce.number().int().nonnegative().optional(),
+  after: z.coerce.number().int().nonnegative().optional(),
+  limit: z.coerce.number().int().positive().max(200).optional(),
+  /**
+   * Thread root message id (that thread's replies) or `MessageThreadFilter.All`
+   * (timeline and every thread's replies). Omitted lists the timeline only.
+   */
+  thread: z.string().optional(),
+  /**
+   * Messages created or updated (finalized, deleted, reacted to) after this instant,
+   * oldest update first; page forward with the newest `updatedAt` returned.
+   */
+  updatedAfter: z.string().datetime({ offset: true }).optional(),
+  /**
+   * Opaque change-stream position from a previous page's `nextUpdatedCursor`:
+   * messages changed after it, ordered by change. Ties on the change time are
+   * broken by id, so no message is skipped between pages.
+   */
+  updatedCursor: z.string().min(1).max(200).optional()
+});
+const MAX_MESSAGE_QUOTES = 20;
+const sendMessageRequestSchema = z.strictObject({
+  content: contentInputSchema,
+  clientMessageId: z.string().min(1).max(200),
+  replyTo: z.string().min(1).optional(),
+  threadRootId: z.string().min(1).optional(),
+  /** Ids of earlier messages in this conversation the message quotes, in order. */
+  quotes: z.array(z.string().min(1)).max(MAX_MESSAGE_QUOTES).optional(),
+  /** Mentioned participant ids. */
+  mentions: z.array(z.string().min(1)).optional(),
+  attachmentIds: z.array(z.string().min(1)).optional(),
+  /** The client's clock when the person submitted (prompt-to-inference trace). */
+  clientSubmittedAtMs: z.number().int().nonnegative().optional()
+});
+const CONVERSATION_EVENT_SOURCE_KINDS = {
+  Webhook: SystemParticipantKind.Webhook,
+  Goal: SystemParticipantKind.Goal,
+  Tool: SystemParticipantKind.Tool
+};
+const CONVERSATION_EVENT_TEXT_MAX_CHARS = 8e3;
+const postConversationEventRequestSchema = z.strictObject({
+  source: z.strictObject({
+    kind: z.nativeEnum(CONVERSATION_EVENT_SOURCE_KINDS),
+    /** The source's own id; one participant per source kind, id and poster. */
+    id: z.string().min(1).max(200)
+  }),
+  text: z.string().min(1).max(CONVERSATION_EVENT_TEXT_MAX_CHARS),
+  eventId: z.string().min(1).max(200)
+});
+const reactionRequestSchema = z.strictObject({
+  emoji: z.string().min(1).max(64)
+});
+const markReadRequestSchema = z.strictObject({
+  throughSeq: z.number().int().nonnegative()
+});
+const typingRequestSchema = z.strictObject({
+  typing: z.boolean()
+});
+const removeParticipantRequestSchema = z.strictObject({
+  participantId: z.string().min(1)
+});
+const createAttachmentUploadRequestSchema = z.strictObject({
+  name: z.string().min(1).max(500),
+  contentType: z.string().min(1),
+  sizeBytes: z.number().int().nonnegative()
+});
+const updateParticipantRequestSchema = z.strictObject({
+  routingMode: z.enum(RoutingMode).optional(),
+  role: z.enum(ParticipantRole).optional()
+}).refine((patch) => patch.routingMode != null || patch.role != null, {
+  message: "routingMode or role is required"
+});
+const searchMessagesQuerySchema = z.strictObject({
+  q: z.string().min(1).max(500),
+  /** Limit to one conversation. */
+  conversationId: z.string().optional(),
+  /** `nextCursor` of the previous page. */
+  cursor: z.string().min(1).max(200).optional(),
+  limit: z.coerce.number().int().positive().max(100).optional()
+});
+const searchMessagesPageSchema = z.object({
+  messages: z.array(conversationMessageSchema),
+  nextCursor: nullableString()
+});
+const listDecisionsQuerySchema = z.strictObject({
+  cursor: z.string().min(1).max(200).optional(),
+  limit: z.coerce.number().int().positive().max(100).optional()
+});
+const decisionSchema = z.object({
+  conversationId: z.string(),
+  conversationTitle: nullableString(),
+  isHome: z.boolean().default(false),
+  /** The card message; `card` carries the request, entity links and audience. */
+  message: conversationMessageSchema
+});
+const decisionsPageSchema = z.object({
+  decisions: z.array(decisionSchema),
+  nextCursor: nullableString()
+});
+const pushDeliveryOpenResponseSchema = z.object({ recorded: z.boolean() });
+export {
+  CONVERSATION_EVENT_SOURCE_KINDS,
+  CONVERSATION_EVENT_TEXT_MAX_CHARS,
+  MAX_MESSAGE_QUOTES,
+  attachmentDownloadSchema,
+  attachmentSchema,
+  attachmentUploadSchema,
+  cardResolutionSchema,
+  cardSchema,
+  conversationListSchema,
+  conversationMessageSchema,
+  conversationMessagesPageSchema,
+  conversationSchema,
+  createAttachmentUploadRequestSchema,
+  createConversationRequestSchema,
+  createDirectConversationRequestSchema,
+  decisionSchema,
+  decisionsPageSchema,
+  entityLinkSchema,
+  listConversationsQuerySchema,
+  listDecisionsQuerySchema,
+  listMessagesQuerySchema,
+  markReadRequestSchema,
+  messageAuthorSchema,
+  messageDeliveriesSchema,
+  messageDeliverySchema,
+  messageDeliveryStateSchema,
+  messageStreamingSchema,
+  participantInputSchema,
+  participantListSchema,
+  participantSchema,
+  participantSummarySchema,
+  postConversationEventRequestSchema,
+  pushDeliveryOpenResponseSchema,
+  reactionRequestSchema,
+  reactionSchema,
+  reactionsResponseSchema,
+  readStateSchema,
+  removeParticipantRequestSchema,
+  replyToSchema,
+  searchMessagesPageSchema,
+  searchMessagesQuerySchema,
+  sendMessageRequestSchema,
+  sendMessageResponseSchema,
+  typingRequestSchema,
+  updateConversationRequestSchema,
+  updateParticipantRequestSchema
+};
+//# sourceMappingURL=conversations.mjs.map

package/dist/modules/agent-platform/conversations.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-platform/conversations.ts"],
+  "sourcesContent": ["import * as z from 'zod';\n\nimport { jsonValueSchema } from \"../json.mjs\";\n\nimport { tolerantStringEnum } from \"../tolerance.mjs\";\n\nimport { contentBlockSchema, contentInputSchema, nullableString } from \"./common.mjs\";\n\nimport { permissionOptionSchema } from \"./sessions.mjs\";\n\nimport {\n  AgentTurnPolicy,\n  CardKind,\n  CardState,\n  ConversationKind,\n  ConversationMessageKind,\n  MessageDeliveryState,\n  MessageStreamingState,\n  ParticipantKind,\n  ParticipantRole,\n  RoutingMode,\n  SystemParticipantKind,\n} from \"./enums.mjs\";\n\n// Conversations: the messaging surface (`/api/v1/conversations`) and the\n// `conversation:<id>` realtime topic.\n\nexport const participantSummarySchema = z.object({\n  id: z.string(),\n  kind: tolerantStringEnum(ParticipantKind),\n  displayName: z.string(),\n  avatarUrl: nullableString(),\n  userId: nullableString(),\n  agentId: nullableString(),\n});\n\nexport type ParticipantSummaryIface = z.infer<typeof participantSummarySchema>;\n\nexport const participantSchema = participantSummarySchema.extend({\n  conversationId: z.string(),\n  agentSlug: nullableString(),\n  systemKind: tolerantStringEnum(SystemParticipantKind).nullable().default(null),\n  role: tolerantStringEnum(ParticipantRole).nullable().default(null),\n  routingMode: tolerantStringEnum(RoutingMode).nullable().default(null),\n  sessionId: nullableString(),\n  joinedAt: nullableString(),\n  leftAt: nullableString(),\n});\n\nexport type ParticipantIface = z.infer<typeof participantSchema>;\n\nexport const conversationSchema = z.object({\n  id: z.string(),\n  organizationId: z.string(),\n  kind: tolerantStringEnum(ConversationKind),\n  title: nullableString(),\n  isHome: z.boolean().default(false),\n  turnPolicy: tolerantStringEnum(AgentTurnPolicy),\n  lastMessageSeq: z.number().default(0),\n  lastMessagePreview: nullableString(),\n  lastMessageAt: nullableString(),\n  unreadCount: z.number().default(0),\n  participants: z.array(participantSummarySchema).default([]),\n  archivedAt: nullableString(),\n  createdAt: z.string(),\n  updatedAt: nullableString(),\n});\n\nexport type ConversationIface = z.infer<typeof conversationSchema>;\n\nexport const messageAuthorSchema = z.object({\n  participantId: z.string(),\n  kind: tolerantStringEnum(ParticipantKind),\n  displayName: z.string(),\n  avatarUrl: nullableString(),\n  userId: nullableString(),\n  agentId: nullableString(),\n});\n\nexport type MessageAuthorIface = z.infer<typeof messageAuthorSchema>;\n\nexport const reactionSchema = z.object({\n  emoji: z.string(),\n  count: z.number(),\n  /** Whether the caller reacted; false in realtime broadcasts, which are not per viewer. */\n  mine: z.boolean().default(false),\n});\n\nexport type ReactionIface = z.infer<typeof reactionSchema>;\n\nexport const attachmentSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  contentType: z.string(),\n  sizeBytes: z.number(),\n  url: nullableString(),\n  thumbnailUrl: nullableString(),\n});\n\nexport type AttachmentIface = z.infer<typeof attachmentSchema>;\n\nexport const entityLinkSchema = z.object({\n  kind: z.string(),\n  id: z.string(),\n  title: nullableString(),\n  url: nullableString(),\n  description: z.string().nullable().optional(),\n  imageUrl: z.string().nullable().optional(),\n});\n\nexport type EntityLinkIface = z.infer<typeof entityLinkSchema>;\n\nexport const cardResolutionSchema = z.object({\n  outcome: jsonValueSchema.nullable().default(null),\n  resolvedByParticipantId: nullableString(),\n  resolvedAt: nullableString(),\n});\n\nexport const cardSchema = z.object({\n  id: z.string(),\n  kind: tolerantStringEnum(CardKind),\n  pendingRequestId: nullableString(),\n  sessionId: nullableString(),\n  title: nullableString(),\n  body: nullableString(),\n  options: z.array(permissionOptionSchema).default([]),\n  /** Elicitation form schema (JSON Schema). */\n  form: jsonValueSchema.nullable().default(null),\n  entityLinks: z.array(entityLinkSchema).default([]),\n  /** Optional renderer hint; unrecognized presentations keep the generic card. */\n  presentation: jsonValueSchema.nullable().default(null),\n  answerMessageId: nullableString(),\n  audienceParticipantIds: z.array(z.string()).default([]),\n  state: tolerantStringEnum(CardState),\n  resolution: cardResolutionSchema.nullable().default(null),\n});\n\nexport type CardIface = z.infer<typeof cardSchema>;\n\nexport const replyToSchema = z.object({\n  messageId: z.string(),\n  authorDisplayName: nullableString(),\n  excerpt: nullableString(),\n});\n\nexport const messageStreamingSchema = z.object({\n  state: tolerantStringEnum(MessageStreamingState),\n  turnId: nullableString(),\n});\n\n/**\n * One agent recipient's delivery of the message. A failed one is retried by\n * sending again with the same `clientMessageId`.\n */\nexport const messageDeliveryStateSchema = z.object({\n  participantId: z.string(),\n  state: tolerantStringEnum(MessageDeliveryState),\n  error: nullableString(),\n});\n\nexport type MessageDeliveryStateIface = z.infer<typeof messageDeliveryStateSchema>;\n\nexport const conversationMessageSchema = z.object({\n  id: z.string(),\n  conversationId: z.string(),\n  seq: z.number(),\n  author: messageAuthorSchema,\n  kind: tolerantStringEnum(ConversationMessageKind),\n  /** Plain-text rendering of `content`. */\n  body: z.string().default(''),\n  content: z.array(contentBlockSchema).default([]),\n  replyTo: replyToSchema.nullable().default(null),\n  /** Earlier messages the author quoted, in order; deleted ones have a null excerpt. */\n  quotes: z.array(replyToSchema).default([]),\n  threadRootId: nullableString(),\n  replyCount: z.number().default(0),\n  mentions: z.array(z.string()).default([]),\n  reactions: z.array(reactionSchema).default([]),\n  attachments: z.array(attachmentSchema).default([]),\n  card: cardSchema.nullable().default(null),\n  /** Set on agent replies while projected from a running turn; null on human messages. */\n  streaming: messageStreamingSchema.nullable().default(null),\n  sourceTurnId: nullableString(),\n  clientMessageId: nullableString(),\n  deletedAt: nullableString(),\n  createdAt: z.string(),\n  /** Bumped on every change (streaming text, finalize, delete, reactions, card state). */\n  updatedAt: nullableString(),\n  /**\n   * Per-message counter the server increments on every change: the order of\n   * copies of one message. `updatedAt` has only millisecond precision here.\n   */\n  revision: z.number().nullable().default(null),\n  /** Agent recipients the message was routed to, with failures (empty for agent replies routed to nobody). */\n  deliveryStates: z.array(messageDeliveryStateSchema).default([]),\n});\n\nexport type ConversationMessageIface = z.infer<typeof conversationMessageSchema>;\n\nexport const readStateSchema = z.object({\n  conversationId: z.string(),\n  participantId: z.string(),\n  lastReadSeq: z.number(),\n  unreadCount: z.number().default(0),\n});\n\nexport type ReadStateIface = z.infer<typeof readStateSchema>;\n\nexport const conversationListSchema = z.object({\n  conversations: z.array(conversationSchema),\n  nextCursor: nullableString(),\n});\n\nexport type ConversationListIface = z.infer<typeof conversationListSchema>;\n\nexport const conversationMessagesPageSchema = z.object({\n  messages: z.array(conversationMessageSchema),\n  hasMoreBefore: z.boolean().default(false),\n  hasMoreAfter: z.boolean().default(false),\n  /** With `updatedAfter` or `updatedCursor`: pass as `updatedCursor` to continue; null otherwise. */\n  nextUpdatedCursor: nullableString(),\n  recoverySince: nullableString().optional(),\n});\n\nexport type ConversationMessagesPageIface = z.infer<typeof conversationMessagesPageSchema>;\n\n/** Where a posted message went: one entry per agent participant that was prompted. */\nexport const messageDeliverySchema = z.object({\n  participantId: z.string(),\n  sessionId: nullableString(),\n  delivery: z.string(),\n  turnId: nullableString(),\n  fromSeq: z.number().nullable().default(null),\n});\n\nexport type MessageDeliveryIface = z.infer<typeof messageDeliverySchema>;\n\nexport const messageDeliveriesSchema = z.object({\n  deliveries: z.array(messageDeliverySchema),\n});\n\nexport const sendMessageResponseSchema = z.object({\n  message: conversationMessageSchema,\n  deliveries: z.array(messageDeliverySchema).default([]),\n});\n\nexport type SendMessageResponseIface = z.infer<typeof sendMessageResponseSchema>;\n\nexport const reactionsResponseSchema = z.object({\n  messageId: z.string(),\n  reactions: z.array(reactionSchema),\n});\n\nexport const participantListSchema = z.object({\n  participants: z.array(participantSchema),\n});\n\nexport const attachmentUploadSchema = z.object({\n  attachmentId: z.string(),\n  uploadUrl: z.string(),\n  method: z.string().default('PUT'),\n  headers: z.record(z.string(), z.string()).default({}),\n  expiresAt: nullableString(),\n});\n\nexport type AttachmentUploadIface = z.infer<typeof attachmentUploadSchema>;\n\n/** `GET /conversations/:id/attachments/:attachmentId`: a fresh download URL (410 once its message is deleted). */\nexport const attachmentDownloadSchema = z.object({\n  attachmentId: z.string(),\n  url: z.string(),\n  expiresAt: nullableString(),\n});\n\nexport type AttachmentDownloadIface = z.infer<typeof attachmentDownloadSchema>;\n\n// Client-to-server requests.\n\nexport const participantInputSchema = z.union([\n  z.strictObject({ apiKeyPrincipal: z.string().min(1) }),\n  z.strictObject({ user: z.string().min(1) }),\n  z.strictObject({ agent: z.string().min(1), routingMode: z.enum(RoutingMode).optional() }),\n]);\n\nexport type ParticipantInput = z.infer<typeof participantInputSchema>;\n\nexport const createConversationRequestSchema = z.strictObject({\n  kind: z.enum(ConversationKind),\n  title: z.string().max(200).optional(),\n  participants: z.array(participantInputSchema),\n  turnPolicy: z.enum(AgentTurnPolicy).optional(),\n});\n\nexport type CreateConversationRequestIface = z.infer<typeof createConversationRequestSchema>;\n\nexport const createDirectConversationRequestSchema = z.strictObject({\n  agent: z.string().min(1),\n});\n\nexport const updateConversationRequestSchema = z.strictObject({\n  title: z.string().max(200).nullable().optional(),\n  turnPolicy: z.enum(AgentTurnPolicy).optional(),\n  archived: z.boolean().optional(),\n});\n\nexport type UpdateConversationRequestIface = z.infer<typeof updateConversationRequestSchema>;\n\nexport const listConversationsQuerySchema = z.strictObject({\n  includeArchived: z\n    .stringbool({ truthy: ['true'], falsy: ['false'], case: 'sensitive' })\n    .optional(),\n  cursor: z.string().optional(),\n  limit: z.coerce.number().int().positive().max(200).optional(),\n});\n\nexport const listMessagesQuerySchema = z.strictObject({\n  before: z.coerce.number().int().nonnegative().optional(),\n  after: z.coerce.number().int().nonnegative().optional(),\n  limit: z.coerce.number().int().positive().max(200).optional(),\n  /**\n   * Thread root message id (that thread's replies) or `MessageThreadFilter.All`\n   * (timeline and every thread's replies). Omitted lists the timeline only.\n   */\n  thread: z.string().optional(),\n  /**\n   * Messages created or updated (finalized, deleted, reacted to) after this instant,\n   * oldest update first; page forward with the newest `updatedAt` returned.\n   */\n  updatedAfter: z.string().datetime({ offset: true }).optional(),\n  /**\n   * Opaque change-stream position from a previous page's `nextUpdatedCursor`:\n   * messages changed after it, ordered by change. Ties on the change time are\n   * broken by id, so no message is skipped between pages.\n   */\n  updatedCursor: z.string().min(1).max(200).optional(),\n});\n\nexport const MAX_MESSAGE_QUOTES = 20;\n\nexport const sendMessageRequestSchema = z.strictObject({\n  content: contentInputSchema,\n  clientMessageId: z.string().min(1).max(200),\n  replyTo: z.string().min(1).optional(),\n  threadRootId: z.string().min(1).optional(),\n  /** Ids of earlier messages in this conversation the message quotes, in order. */\n  quotes: z.array(z.string().min(1)).max(MAX_MESSAGE_QUOTES).optional(),\n  /** Mentioned participant ids. */\n  mentions: z.array(z.string().min(1)).optional(),\n  attachmentIds: z.array(z.string().min(1)).optional(),\n  /** The client's clock when the person submitted (prompt-to-inference trace). */\n  clientSubmittedAtMs: z.number().int().nonnegative().optional(),\n});\n\nexport type SendMessageRequestIface = z.infer<typeof sendMessageRequestSchema>;\n\n/** The system sources an outside system may post conversation events as. */\nexport const CONVERSATION_EVENT_SOURCE_KINDS = {\n  Webhook: SystemParticipantKind.Webhook,\n  Goal: SystemParticipantKind.Goal,\n  Tool: SystemParticipantKind.Tool,\n} as const;\n\nexport const CONVERSATION_EVENT_TEXT_MAX_CHARS = 8_000;\n\n/**\n * `POST /conversations/:id/events`: something that happened outside the\n * conversation (a Goal changed state, a long tool run finished, a webhook\n * arrived), posted by a participant's integration. It becomes a message from\n * the source's system participant and routes like one: system authors prompt\n * the Default agent, and every human in the conversation may answer what that\n * turn asks. The source is scoped to its authenticated poster and displays that\n * person's name; it does not assert platform-verified origin. Redelivering the\n * same `eventId` from the same source and poster posts once.\n */\nexport const postConversationEventRequestSchema = z.strictObject({\n  source: z.strictObject({\n    kind: z.nativeEnum(CONVERSATION_EVENT_SOURCE_KINDS),\n    /** The source's own id; one participant per source kind, id and poster. */\n    id: z.string().min(1).max(200),\n  }),\n  text: z.string().min(1).max(CONVERSATION_EVENT_TEXT_MAX_CHARS),\n  eventId: z.string().min(1).max(200),\n});\n\nexport type PostConversationEventRequestIface = z.infer<typeof postConversationEventRequestSchema>;\n\nexport const reactionRequestSchema = z.strictObject({\n  emoji: z.string().min(1).max(64),\n});\n\nexport const markReadRequestSchema = z.strictObject({\n  throughSeq: z.number().int().nonnegative(),\n});\n\n/** `POST /conversations/:id/typing`: realtime only; a `true` lapses after a few seconds. */\nexport const typingRequestSchema = z.strictObject({\n  typing: z.boolean(),\n});\n\nexport const removeParticipantRequestSchema = z.strictObject({\n  participantId: z.string().min(1),\n});\n\nexport const createAttachmentUploadRequestSchema = z.strictObject({\n  name: z.string().min(1).max(500),\n  contentType: z.string().min(1),\n  sizeBytes: z.number().int().nonnegative(),\n});\n\nexport type CreateAttachmentUploadRequestIface = z.infer<\n  typeof createAttachmentUploadRequestSchema\n>;\n\n// Participants: an agent's routing mode (owners and admins) or a person's\n// role (owners; groups only). At least one field.\n\nexport const updateParticipantRequestSchema = z\n  .strictObject({\n    routingMode: z.enum(RoutingMode).optional(),\n    role: z.enum(ParticipantRole).optional(),\n  })\n  .refine((patch) => patch.routingMode != null || patch.role != null, {\n    message: 'routingMode or role is required',\n  });\n\nexport type UpdateParticipantRequestIface = z.infer<typeof updateParticipantRequestSchema>;\n\n// Search: full text over the caller's conversations, newest first.\n\nexport const searchMessagesQuerySchema = z.strictObject({\n  q: z.string().min(1).max(500),\n  /** Limit to one conversation. */\n  conversationId: z.string().optional(),\n  /** `nextCursor` of the previous page. */\n  cursor: z.string().min(1).max(200).optional(),\n  limit: z.coerce.number().int().positive().max(100).optional(),\n});\n\nexport type SearchMessagesQueryIface = z.infer<typeof searchMessagesQuerySchema>;\n\nexport const searchMessagesPageSchema = z.object({\n  messages: z.array(conversationMessageSchema),\n  nextCursor: nullableString(),\n});\n\nexport type SearchMessagesPageIface = z.infer<typeof searchMessagesPageSchema>;\n\n// Decisions: everything awaiting the caller's answer across conversations: the\n// cards of open pending requests (permission and elicitation) whose audience\n// includes the caller. A Goal confirmation is an elicitation like any other.\n\nexport const listDecisionsQuerySchema = z.strictObject({\n  cursor: z.string().min(1).max(200).optional(),\n  limit: z.coerce.number().int().positive().max(100).optional(),\n});\n\nexport const decisionSchema = z.object({\n  conversationId: z.string(),\n  conversationTitle: nullableString(),\n  isHome: z.boolean().default(false),\n  /** The card message; `card` carries the request, entity links and audience. */\n  message: conversationMessageSchema,\n});\n\nexport type DecisionIface = z.infer<typeof decisionSchema>;\n\nexport const decisionsPageSchema = z.object({\n  decisions: z.array(decisionSchema),\n  nextCursor: nullableString(),\n});\n\nexport type DecisionsPageIface = z.infer<typeof decisionsPageSchema>;\n\n/** A notification delivery was opened by its authenticated recipient. */\nexport const pushDeliveryOpenResponseSchema = z.object({ recorded: z.boolean() });\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/agent-platform/enums.d.mts

@@ -0,0 +1,231 @@
+export declare enum AgentSessionState {
+    Idle = "idle",
+    Running = "running",
+    RequiresAction = "requires_action",
+    Parked = "parked",
+    Closed = "closed",
+    Failed = "failed"
+}
+export declare enum AgentTurnPolicy {
+    Steer = "steer",
+    Queue = "queue"
+}
+export declare enum AcpFrameDirection {
+    ClientToAgent = "client_to_agent",
+    AgentToClient = "agent_to_client"
+}
+export declare enum PendingRequestKind {
+    Permission = "permission",
+    Elicitation = "elicitation"
+}
+export declare enum PendingEventState {
+    Created = "created",
+    Resolved = "resolved"
+}
+export declare enum AcpPreviewKind {
+    AgentMessage = "agent_message",
+    AgentThought = "agent_thought"
+}
+export declare enum ConversationKind {
+    Direct = "direct",
+    Group = "group"
+}
+export declare enum ParticipantKind {
+    User = "user",
+    Agent = "agent",
+    System = "system"
+}
+export declare enum SystemParticipantKind {
+    Schedule = "schedule",
+    Webhook = "webhook",
+    Goal = "goal",
+    Tool = "tool",
+    ApiKey = "api-key"
+}
+export declare enum ParticipantRole {
+    Owner = "owner",
+    Admin = "admin",
+    Member = "member"
+}
+export declare enum RoutingMode {
+    Mention = "mention",
+    All = "all",
+    Default = "default"
+}
+export declare enum ConversationMessageKind {
+    Message = "message",
+    System = "system",
+    Card = "card"
+}
+/** Special values of `GET /conversations/:id/messages?thread=`. */
+export declare enum MessageThreadFilter {
+    All = "all"
+}
+/** Whether an agent recipient got a conversation message. */
+export declare enum MessageDeliveryState {
+    Pending = "pending",
+    Delivered = "delivered",
+    Failed = "failed"
+}
+export declare enum MessageStreamingState {
+    Streaming = "streaming",
+    Final = "final"
+}
+export declare enum CardKind {
+    Permission = "permission",
+    Elicitation = "elicitation",
+    Notice = "notice"
+}
+export declare enum CardState {
+    Open = "open",
+    Resolved = "resolved",
+    Answered = "answered",
+    Cancelled = "cancelled",
+    Expired = "expired"
+}
+export declare enum ParticipantChange {
+    Joined = "joined",
+    Left = "left",
+    Updated = "updated"
+}
+export declare enum ConversationListChange {
+    Created = "created",
+    Updated = "updated",
+    Removed = "removed"
+}
+export declare enum AgentHealthStatus {
+    Ready = "ready",
+    Degraded = "degraded",
+    Starting = "starting"
+}
+export declare enum ProviderRefKind {
+    Package = "package",
+    Bundle = "bundle"
+}
+export declare enum ProviderKind {
+    Harness = "harness",
+    Sandbox = "sandbox",
+    Channel = "channel"
+}
+export declare enum ToolApproval {
+    Allow = "allow",
+    Ask = "ask"
+}
+export declare enum SandboxAccess {
+    Read = "read",
+    Execute = "execute",
+    Write = "write"
+}
+export declare enum SandboxAttach {
+    Lazy = "lazy",
+    OnPrompt = "on-prompt"
+}
+export declare enum DefinitionRepositoryKind {
+    CodeStorage = "code-storage",
+    GitHub = "github"
+}
+/** The starter a new Final-hosted definition's repository is created from (Build's templates). */
+export declare enum DefinitionStarterTemplate {
+    /** Chats and uses its tools; no base tools. */
+    Assistant = "assistant",
+    /** Shell and file tools on a computer. */
+    Coding = "coding"
+}
+export declare enum CommitFileEncoding {
+    Utf8 = "utf8",
+    Base64 = "base64"
+}
+/** One path of a revision diff (`GET /definitions/:id/revisions/diff`). */
+export declare enum ManifestChangeKind {
+    Added = "added",
+    Removed = "removed",
+    Changed = "changed"
+}
+export declare enum DiagnosticSeverity {
+    Error = "error",
+    Warning = "warning",
+    Info = "info"
+}
+export declare enum CompatibilityCategory {
+    HarnessConfig = "harness-config",
+    McpServer = "mcp-server",
+    BaseTool = "base-tool",
+    Platform = "platform",
+    UnusedFile = "unused-file"
+}
+export declare enum CompatibilityResult {
+    Valid = "valid",
+    Applies = "applies",
+    Degraded = "degraded",
+    Invalid = "invalid",
+    Unsupported = "unsupported",
+    Unused = "unused",
+    Transformed = "transformed",
+    Unavailable = "unavailable",
+    Host = "host",
+    Absent = "absent",
+    Dynamic = "dynamic"
+}
+export declare enum CompatibilitySummary {
+    Compatible = "compatible",
+    Degraded = "degraded",
+    Incompatible = "incompatible"
+}
+export declare enum SetupGuideBuildState {
+    Pending = "pending",
+    Building = "building",
+    Ready = "ready",
+    Failed = "failed"
+}
+export declare enum ScheduleTarget {
+    OwnerDirect = "owner-direct",
+    BoundConversation = "bound-conversation"
+}
+export declare enum ScheduleTriggerType {
+    Once = "once",
+    Cron = "cron"
+}
+export declare enum ScheduleDelivery {
+    Always = "always",
+    IfNeeded = "if_needed"
+}
+export declare enum ScheduleSource {
+    Definition = "definition",
+    Runtime = "runtime"
+}
+/** Error codes the API returns in `{ error: { code } }`; unknown codes are kept as strings. */
+export declare enum AgentApiErrorCode {
+    Unauthorized = "unauthorized",
+    Forbidden = "forbidden",
+    NotFound = "not_found",
+    InvalidRequest = "invalid_request",
+    Conflict = "conflict",
+    RateLimited = "rate_limited",
+    Internal = "internal",
+    TurnRejected = "turn_rejected",
+    PendingNotFound = "pending_not_found",
+    PendingNotInAudience = "pending_not_in_audience",
+    PendingAlreadyResolved = "pending_already_resolved",
+    PendingExpired = "pending_expired",
+    CredentialUnavailable = "credential_unavailable"
+}
+/** Realtime event kinds (SPEC 4.2); the gateway envelope's `kind`. */
+export declare enum AgentRealtimeKind {
+    AcpFrame = "acp.frame",
+    AcpLiveFrame = "acp.frame.live",
+    AcpLiveReset = "acp.live.reset",
+    AcpPreview = "acp.preview",
+    AcpPending = "acp.pending",
+    SessionState = "session.state",
+    MessageCreated = "conversation.message.created",
+    MessageUpdated = "conversation.message.updated",
+    MessageDeleted = "conversation.message.deleted",
+    ReactionChanged = "conversation.reaction.changed",
+    ParticipantChanged = "conversation.participant.changed",
+    ConversationUpdated = "conversation.updated",
+    ConversationRead = "conversation.read",
+    ConversationTyping = "conversation.typing",
+    TurnStarted = "conversation.turn.started",
+    TurnEnded = "conversation.turn.ended",
+    ConversationListChanged = "conversation.list.changed"
+}