@finalai/agent-protocol 0.1.0

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

@@ -0,0 +1,157 @@
+import * as z from "zod";
+import { jsonObjectSchema, jsonValueSchema } from "../json.mjs";
+import { jsonRpcIdSchema } from "../json-rpc.mjs";
+import { tolerantStringEnum } from "../tolerance.mjs";
+import { AgentHealthStatus, ProviderRefKind } from "./enums.mjs";
+const nullableString = () => z.string().nullable().default(null);
+const nullableNumber = () => z.number().nullable().default(null);
+const contentBlockSchema = z.looseObject({
+  type: z.string(),
+  text: z.string().optional(),
+  mimeType: z.string().optional(),
+  data: z.string().optional(),
+  uri: z.string().nullable().optional(),
+  name: z.string().optional(),
+  title: z.string().nullable().optional(),
+  size: z.number().nullable().optional(),
+  resource: jsonValueSchema.optional(),
+  _meta: jsonValueSchema.optional()
+});
+const acpWireMessageSchema = z.looseObject({
+  jsonrpc: z.string().optional(),
+  id: jsonRpcIdSchema.optional(),
+  method: z.string().optional(),
+  params: jsonValueSchema.optional(),
+  result: jsonValueSchema.optional(),
+  error: z.looseObject({ code: z.number(), message: z.string(), data: jsonValueSchema.optional() }).optional()
+});
+const acpSessionUpdateParamsSchema = z.looseObject({
+  sessionId: z.string().optional(),
+  update: z.looseObject({
+    sessionUpdate: z.string(),
+    content: z.union([contentBlockSchema, z.array(contentBlockSchema)]).optional(),
+    messageId: z.string().optional(),
+    state: z.string().optional(),
+    stopReason: z.string().nullable().optional()
+  })
+});
+const providerRefSchema = z.object({
+  kind: tolerantStringEnum(ProviderRefKind),
+  specifier: nullableString(),
+  export: nullableString()
+});
+const okResponseSchema = z.object({ ok: z.boolean().default(true) });
+const healthResponseSchema = z.object({
+  ok: z.boolean(),
+  status: tolerantStringEnum(AgentHealthStatus),
+  version: nullableString()
+});
+const apiErrorDetailSchema = z.object({
+  code: z.string().default("unknown"),
+  message: z.string().default(""),
+  details: jsonValueSchema.nullable().default(null),
+  // Session state when a prompt was rejected (`turn_rejected`).
+  state: nullableString(),
+  sessionId: nullableString(),
+  pendingId: nullableString(),
+  // Why a credential could not be resolved (`credential_unavailable`).
+  reason: nullableString()
+});
+const apiErrorResponseSchema = z.object({
+  error: z.union([
+    apiErrorDetailSchema,
+    z.string().transform(
+      (message) => ({
+        code: "unknown",
+        message,
+        details: null,
+        state: null,
+        sessionId: null,
+        pendingId: null,
+        reason: null
+      })
+    )
+  ])
+});
+const realtimeSessionResponseSchema = z.object({
+  url: z.string(),
+  userId: z.string().nullable(),
+  apiKeyPrincipalId: z.string().optional(),
+  token: z.string(),
+  expiresAt: z.string()
+});
+const apiKeyRealtimeSessionResponseSchema = realtimeSessionResponseSchema.extend({
+  userId: z.null(),
+  apiKeyPrincipalId: z.string()
+});
+const acpTicketSchema = z.object({
+  ticket: z.string(),
+  expiresAt: z.string(),
+  /** The ACP WebSocket endpoint (the session service's own origin). */
+  url: nullableString()
+});
+const ACP_WS_SUBPROTOCOL = "acp.v1";
+const ACP_TICKET_SUBPROTOCOL_PREFIX = "final-acp-ticket.";
+const acpTicketRequestSchema = z.strictObject({
+  /** Binds the ticket's connection to this agent (slug or id); it is also the session/new default. */
+  agent: z.string().min(1).max(200).optional()
+});
+const metaInputSchema = jsonObjectSchema.optional();
+const contentBlockInputSchema = z.discriminatedUnion("type", [
+  z.strictObject({ type: z.literal("text"), text: z.string(), _meta: metaInputSchema }),
+  z.strictObject({
+    type: z.literal("image"),
+    data: z.string().optional(),
+    mimeType: z.string().min(1),
+    uri: z.string().optional(),
+    _meta: metaInputSchema
+  }),
+  z.strictObject({
+    type: z.literal("audio"),
+    data: z.string(),
+    mimeType: z.string().min(1),
+    _meta: metaInputSchema
+  }),
+  z.strictObject({
+    type: z.literal("resource_link"),
+    uri: z.string().min(1),
+    name: z.string().min(1),
+    title: z.string().optional(),
+    description: z.string().optional(),
+    mimeType: z.string().optional(),
+    size: z.number().int().nonnegative().optional(),
+    _meta: metaInputSchema
+  }),
+  z.strictObject({
+    type: z.literal("resource"),
+    resource: z.strictObject({
+      uri: z.string().min(1),
+      mimeType: z.string().optional(),
+      text: z.string().optional(),
+      blob: z.string().optional()
+    }),
+    _meta: metaInputSchema
+  })
+]);
+const contentInputSchema = z.union([z.string(), z.array(contentBlockInputSchema).min(1)]);
+export {
+  ACP_TICKET_SUBPROTOCOL_PREFIX,
+  ACP_WS_SUBPROTOCOL,
+  acpSessionUpdateParamsSchema,
+  acpTicketRequestSchema,
+  acpTicketSchema,
+  acpWireMessageSchema,
+  apiErrorDetailSchema,
+  apiErrorResponseSchema,
+  apiKeyRealtimeSessionResponseSchema,
+  contentBlockInputSchema,
+  contentBlockSchema,
+  contentInputSchema,
+  healthResponseSchema,
+  nullableNumber,
+  nullableString,
+  okResponseSchema,
+  providerRefSchema,
+  realtimeSessionResponseSchema
+};
+//# sourceMappingURL=common.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-platform/common.ts"],
+  "sourcesContent": ["import * as z from 'zod';\n\nimport { jsonObjectSchema, jsonValueSchema } from \"../json.mjs\";\n\nimport { jsonRpcIdSchema } from \"../json-rpc.mjs\";\n\nimport { tolerantStringEnum } from \"../tolerance.mjs\";\n\nimport { AgentHealthStatus, ProviderRefKind } from \"./enums.mjs\";\n\n// Shared shapes for the agent platform API. Ids are wire ids (`encodeId` on the\n// server) and stay plain strings here. Server-to-client objects strip unknown\n// fields except where content is passed through verbatim (ACP frames and\n// content blocks keep every field, including `_meta`).\n\n/** A nullable server field that a newer server may also omit. */\nexport const nullableString = () => z.string().nullable().default(null);\n\nexport const nullableNumber = () => z.number().nullable().default(null);\n\n/** An ACP content block as the server stored it; every field is kept. */\nexport const contentBlockSchema = z.looseObject({\n  type: z.string(),\n  text: z.string().optional(),\n  mimeType: z.string().optional(),\n  data: z.string().optional(),\n  uri: z.string().nullable().optional(),\n  name: z.string().optional(),\n  title: z.string().nullable().optional(),\n  size: z.number().nullable().optional(),\n  resource: jsonValueSchema.optional(),\n  _meta: jsonValueSchema.optional(),\n});\n\nexport type ContentBlockIface = z.infer<typeof contentBlockSchema>;\n\n/**\n * One ACP JSON-RPC message (request, response or notification) as logged by\n * the session service; every field is kept.\n */\nexport const acpWireMessageSchema = z.looseObject({\n  jsonrpc: z.string().optional(),\n  id: jsonRpcIdSchema.optional(),\n  method: z.string().optional(),\n  params: jsonValueSchema.optional(),\n  result: jsonValueSchema.optional(),\n  error: z\n    .looseObject({ code: z.number(), message: z.string(), data: jsonValueSchema.optional() })\n    .optional(),\n});\n\nexport type AcpWireMessageIface = z.infer<typeof acpWireMessageSchema>;\n\n/** `session/update` params, enough to branch on `sessionUpdate` without the full ACP schema. */\nexport const acpSessionUpdateParamsSchema = z.looseObject({\n  sessionId: z.string().optional(),\n  update: z.looseObject({\n    sessionUpdate: z.string(),\n    content: z.union([contentBlockSchema, z.array(contentBlockSchema)]).optional(),\n    messageId: z.string().optional(),\n    state: z.string().optional(),\n    stopReason: z.string().nullable().optional(),\n  }),\n});\n\nexport type AcpSessionUpdateParamsIface = z.infer<typeof acpSessionUpdateParamsSchema>;\n\nexport const providerRefSchema = z.object({\n  kind: tolerantStringEnum(ProviderRefKind),\n  specifier: nullableString(),\n  export: nullableString(),\n});\n\nexport type ProviderRefIface = z.infer<typeof providerRefSchema>;\n\nexport const okResponseSchema = z.object({ ok: z.boolean().default(true) });\n\nexport const healthResponseSchema = z.object({\n  ok: z.boolean(),\n  status: tolerantStringEnum(AgentHealthStatus),\n  version: nullableString(),\n});\n\nexport type HealthResponseIface = z.infer<typeof healthResponseSchema>;\n\nexport const apiErrorDetailSchema = z.object({\n  code: z.string().default('unknown'),\n  message: z.string().default(''),\n  details: jsonValueSchema.nullable().default(null),\n  // Session state when a prompt was rejected (`turn_rejected`).\n  state: nullableString(),\n  sessionId: nullableString(),\n  pendingId: nullableString(),\n  // Why a credential could not be resolved (`credential_unavailable`).\n  reason: nullableString(),\n});\n\nexport type ApiErrorDetailIface = z.infer<typeof apiErrorDetailSchema>;\n\n/** `{ error }` body of every non-2xx response; a bare string error parses as its message. */\nexport const apiErrorResponseSchema = z.object({\n  error: z.union([\n    apiErrorDetailSchema,\n    z.string().transform(\n      (message): ApiErrorDetailIface => ({\n        code: 'unknown',\n        message,\n        details: null,\n        state: null,\n        sessionId: null,\n        pendingId: null,\n        reason: null,\n      }),\n    ),\n  ]),\n});\n\nexport type ApiErrorResponseIface = z.infer<typeof apiErrorResponseSchema>;\n\n/** `POST /api/v1/realtime/session`: same shape as console-server's `/api/realtime/session`. */\nexport const realtimeSessionResponseSchema = z.object({\n  url: z.string(),\n  userId: z.string().nullable(),\n  apiKeyPrincipalId: z.string().optional(),\n  token: z.string(),\n  expiresAt: z.string(),\n});\n\nexport type RealtimeSessionResponseIface = z.infer<typeof realtimeSessionResponseSchema>;\n\n/** The organization/team-key bootstrap variant, introduced with API-key owner topics. */\nexport const apiKeyRealtimeSessionResponseSchema = realtimeSessionResponseSchema.extend({\n  userId: z.null(),\n  apiKeyPrincipalId: z.string(),\n});\n\n/**\n * `POST /api/v1/acp/tickets`: a single-use credential for opening `/acp/ws`\n * where a WebSocket cannot carry an authorization header (browsers). Offer it\n * as the `final-acp-ticket.<ticket>` subprotocol next to `ACP_WS_SUBPROTOCOL`,\n * or as `?ticket=`, at `url`.\n */\nexport const acpTicketSchema = z.object({\n  ticket: z.string(),\n  expiresAt: z.string(),\n  /** The ACP WebSocket endpoint (the session service's own origin). */\n  url: nullableString(),\n});\n\nexport type AcpTicketIface = z.infer<typeof acpTicketSchema>;\n\nexport const ACP_WS_SUBPROTOCOL = 'acp.v1';\n\nexport const ACP_TICKET_SUBPROTOCOL_PREFIX = 'final-acp-ticket.';\n\nexport const acpTicketRequestSchema = z.strictObject({\n  /** Binds the ticket's connection to this agent (slug or id); it is also the session/new default. */\n  agent: z.string().min(1).max(200).optional(),\n});\n\nexport type AcpTicketRequestIface = z.infer<typeof acpTicketRequestSchema>;\n\n// Client-to-server content: a string, or ACP content blocks.\nconst metaInputSchema = jsonObjectSchema.optional();\n\nexport const contentBlockInputSchema = z.discriminatedUnion('type', [\n  z.strictObject({ type: z.literal('text'), text: z.string(), _meta: metaInputSchema }),\n  z.strictObject({\n    type: z.literal('image'),\n    data: z.string().optional(),\n    mimeType: z.string().min(1),\n    uri: z.string().optional(),\n    _meta: metaInputSchema,\n  }),\n  z.strictObject({\n    type: z.literal('audio'),\n    data: z.string(),\n    mimeType: z.string().min(1),\n    _meta: metaInputSchema,\n  }),\n  z.strictObject({\n    type: z.literal('resource_link'),\n    uri: z.string().min(1),\n    name: z.string().min(1),\n    title: z.string().optional(),\n    description: z.string().optional(),\n    mimeType: z.string().optional(),\n    size: z.number().int().nonnegative().optional(),\n    _meta: metaInputSchema,\n  }),\n  z.strictObject({\n    type: z.literal('resource'),\n    resource: z.strictObject({\n      uri: z.string().min(1),\n      mimeType: z.string().optional(),\n      text: z.string().optional(),\n      blob: z.string().optional(),\n    }),\n    _meta: metaInputSchema,\n  }),\n]);\n\nexport type ContentBlockInputIface = z.infer<typeof contentBlockInputSchema>;\n\nexport const contentInputSchema = z.union([z.string(), z.array(contentBlockInputSchema).min(1)]);\n\nexport type ContentInput = z.infer<typeof contentInputSchema>;\n"],
+  "mappings": "AAAA,YAAY,OAAO;AAEnB,SAAS,kBAAkB,uBAAuB;AAElD,SAAS,uBAAuB;AAEhC,SAAS,0BAA0B;AAEnC,SAAS,mBAAmB,uBAAuB;AAQ5C,MAAM,iBAAiB,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,IAAI;AAE/D,MAAM,iBAAiB,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,IAAI;AAG/D,MAAM,qBAAqB,EAAE,YAAY;AAAA,EAC9C,MAAM,EAAE,OAAO;AAAA,EACf,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,UAAU,EAAE,OAAO,EAAE,SAAS;AAAA,EAC9B,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS;AAAA,EACpC,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS;AAAA,EACtC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS;AAAA,EACrC,UAAU,gBAAgB,SAAS;AAAA,EACnC,OAAO,gBAAgB,SAAS;AAClC,CAAC;AAQM,MAAM,uBAAuB,EAAE,YAAY;AAAA,EAChD,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,IAAI,gBAAgB,SAAS;AAAA,EAC7B,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,QAAQ,gBAAgB,SAAS;AAAA,EACjC,QAAQ,gBAAgB,SAAS;AAAA,EACjC,OAAO,EACJ,YAAY,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,EAAE,OAAO,GAAG,MAAM,gBAAgB,SAAS,EAAE,CAAC,EACvF,SAAS;AACd,CAAC;AAKM,MAAM,+BAA+B,EAAE,YAAY;AAAA,EACxD,WAAW,EAAE,OAAO,EAAE,SAAS;AAAA,EAC/B,QAAQ,EAAE,YAAY;AAAA,IACpB,eAAe,EAAE,OAAO;AAAA,IACxB,SAAS,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,kBAAkB,CAAC,CAAC,EAAE,SAAS;AAAA,IAC7E,WAAW,EAAE,OAAO,EAAE,SAAS;AAAA,IAC/B,OAAO,EAAE,OAAO,EAAE,SAAS;AAAA,IAC3B,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS;AAAA,EAC7C,CAAC;AACH,CAAC;AAIM,MAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,MAAM,mBAAmB,eAAe;AAAA,EACxC,WAAW,eAAe;AAAA,EAC1B,QAAQ,eAAe;AACzB,CAAC;AAIM,MAAM,mBAAmB,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,CAAC;AAEnE,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,IAAI,EAAE,QAAQ;AAAA,EACd,QAAQ,mBAAmB,iBAAiB;AAAA,EAC5C,SAAS,eAAe;AAC1B,CAAC;AAIM,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,MAAM,EAAE,OAAO,EAAE,QAAQ,SAAS;AAAA,EAClC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE;AAAA,EAC9B,SAAS,gBAAgB,SAAS,EAAE,QAAQ,IAAI;AAAA;AAAA,EAEhD,OAAO,eAAe;AAAA,EACtB,WAAW,eAAe;AAAA,EAC1B,WAAW,eAAe;AAAA;AAAA,EAE1B,QAAQ,eAAe;AACzB,CAAC;AAKM,MAAM,yBAAyB,EAAE,OAAO;AAAA,EAC7C,OAAO,EAAE,MAAM;AAAA,IACb;AAAA,IACA,EAAE,OAAO,EAAE;AAAA,MACT,CAAC,aAAkC;AAAA,QACjC,MAAM;AAAA,QACN;AAAA,QACA,SAAS;AAAA,QACT,OAAO;AAAA,QACP,WAAW;AAAA,QACX,WAAW;AAAA,QACX,QAAQ;AAAA,MACV;AAAA,IACF;AAAA,EACF,CAAC;AACH,CAAC;AAKM,MAAM,gCAAgC,EAAE,OAAO;AAAA,EACpD,KAAK,EAAE,OAAO;AAAA,EACd,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,mBAAmB,EAAE,OAAO,EAAE,SAAS;AAAA,EACvC,OAAO,EAAE,OAAO;AAAA,EAChB,WAAW,EAAE,OAAO;AACtB,CAAC;AAKM,MAAM,sCAAsC,8BAA8B,OAAO;AAAA,EACtF,QAAQ,EAAE,KAAK;AAAA,EACf,mBAAmB,EAAE,OAAO;AAC9B,CAAC;AAQM,MAAM,kBAAkB,EAAE,OAAO;AAAA,EACtC,QAAQ,EAAE,OAAO;AAAA,EACjB,WAAW,EAAE,OAAO;AAAA;AAAA,EAEpB,KAAK,eAAe;AACtB,CAAC;AAIM,MAAM,qBAAqB;AAE3B,MAAM,gCAAgC;AAEtC,MAAM,yBAAyB,EAAE,aAAa;AAAA;AAAA,EAEnD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AAC7C,CAAC;AAKD,MAAM,kBAAkB,iBAAiB,SAAS;AAE3C,MAAM,0BAA0B,EAAE,mBAAmB,QAAQ;AAAA,EAClE,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,MAAM,GAAG,MAAM,EAAE,OAAO,GAAG,OAAO,gBAAgB,CAAC;AAAA,EACpF,EAAE,aAAa;AAAA,IACb,MAAM,EAAE,QAAQ,OAAO;AAAA,IACvB,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,IAC1B,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,IAC1B,KAAK,EAAE,OAAO,EAAE,SAAS;AAAA,IACzB,OAAO;AAAA,EACT,CAAC;AAAA,EACD,EAAE,aAAa;AAAA,IACb,MAAM,EAAE,QAAQ,OAAO;AAAA,IACvB,MAAM,EAAE,OAAO;AAAA,IACf,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,IAC1B,OAAO;AAAA,EACT,CAAC;AAAA,EACD,EAAE,aAAa;AAAA,IACb,MAAM,EAAE,QAAQ,eAAe;AAAA,IAC/B,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,IACrB,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,IACtB,OAAO,EAAE,OAAO,EAAE,SAAS;AAAA,IAC3B,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,IACjC,UAAU,EAAE,OAAO,EAAE,SAAS;AAAA,IAC9B,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS;AAAA,IAC9C,OAAO;AAAA,EACT,CAAC;AAAA,EACD,EAAE,aAAa;AAAA,IACb,MAAM,EAAE,QAAQ,UAAU;AAAA,IAC1B,UAAU,EAAE,aAAa;AAAA,MACvB,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,MACrB,UAAU,EAAE,OAAO,EAAE,SAAS;AAAA,MAC9B,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,MAC1B,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,IAC5B,CAAC;AAAA,IACD,OAAO;AAAA,EACT,CAAC;AACH,CAAC;AAIM,MAAM,qBAAqB,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,EAAE,MAAM,uBAAuB,EAAE,IAAI,CAAC,CAAC,CAAC;",
+  "names": []
+}

package/dist/modules/agent-platform/conversation-schedules.d.mts

@@ -0,0 +1,98 @@
+import * as z from 'zod';
+import { ScheduleDelivery, ScheduleSource, ScheduleTriggerType } from "./enums.mjs";
+/** When a schedule fires: `once` sets `at`; `cron` sets `expression` and `timezone`. */
+export declare const scheduleTriggerSchema: z.ZodObject<{
+    type: z.ZodUnion<readonly [z.ZodEnum<typeof ScheduleTriggerType>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+    at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    expression: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    timezone: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type ScheduleTriggerIface = z.infer<typeof scheduleTriggerSchema>;
+export declare const conversationScheduleSchema: z.ZodObject<{
+    id: z.ZodString;
+    conversationId: z.ZodString;
+    agentId: z.ZodString;
+    ownerParticipantId: z.ZodString;
+    source: z.ZodUnion<readonly [z.ZodEnum<typeof ScheduleSource>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+    name: z.ZodString;
+    prompt: z.ZodString;
+    trigger: z.ZodObject<{
+        type: z.ZodUnion<readonly [z.ZodEnum<typeof ScheduleTriggerType>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+        at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        expression: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        timezone: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+    delivery: z.ZodUnion<readonly [z.ZodEnum<typeof ScheduleDelivery>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+    enabled: z.ZodBoolean;
+    nextRunAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    lastRunAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type ConversationScheduleIface = z.infer<typeof conversationScheduleSchema>;
+export declare const conversationScheduleListSchema: z.ZodObject<{
+    schedules: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        conversationId: z.ZodString;
+        agentId: z.ZodString;
+        ownerParticipantId: z.ZodString;
+        source: z.ZodUnion<readonly [z.ZodEnum<typeof ScheduleSource>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+        name: z.ZodString;
+        prompt: z.ZodString;
+        trigger: z.ZodObject<{
+            type: z.ZodUnion<readonly [z.ZodEnum<typeof ScheduleTriggerType>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+            at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            expression: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            timezone: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>;
+        delivery: z.ZodUnion<readonly [z.ZodEnum<typeof ScheduleDelivery>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+        enabled: z.ZodBoolean;
+        nextRunAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        lastRunAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ConversationScheduleListIface = z.infer<typeof conversationScheduleListSchema>;
+/** A trigger as a client sends it. */
+export declare const scheduleTriggerInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<ScheduleTriggerType.Once>;
+    at: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<ScheduleTriggerType.Cron>;
+    expression: z.ZodString;
+    timezone: z.ZodString;
+}, z.core.$strict>], "type">;
+export type ScheduleTriggerInputIface = z.infer<typeof scheduleTriggerInputSchema>;
+export declare const createConversationScheduleRequestSchema: z.ZodObject<{
+    name: z.ZodString;
+    prompt: z.ZodString;
+    trigger: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<ScheduleTriggerType.Once>;
+        at: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<ScheduleTriggerType.Cron>;
+        expression: z.ZodString;
+        timezone: z.ZodString;
+    }, z.core.$strict>], "type">;
+    delivery: z.ZodEnum<typeof ScheduleDelivery>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    agentParticipantId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type CreateConversationScheduleRequestIface = z.infer<typeof createConversationScheduleRequestSchema>;
+/** Omitted fields stay unchanged. */
+export declare const updateConversationScheduleRequestSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+    trigger: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<ScheduleTriggerType.Once>;
+        at: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<ScheduleTriggerType.Cron>;
+        expression: z.ZodString;
+        timezone: z.ZodString;
+    }, z.core.$strict>], "type">>;
+    delivery: z.ZodOptional<z.ZodEnum<typeof ScheduleDelivery>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type UpdateConversationScheduleRequestIface = z.infer<typeof updateConversationScheduleRequestSchema>;

package/dist/modules/agent-platform/conversation-schedules.mjs

@@ -0,0 +1,70 @@
+import * as z from "zod";
+import { tolerantStringEnum } from "../tolerance.mjs";
+import { nullableString } from "./common.mjs";
+import { ScheduleDelivery, ScheduleSource, ScheduleTriggerType } from "./enums.mjs";
+const scheduleTriggerSchema = z.object({
+  type: tolerantStringEnum(ScheduleTriggerType),
+  at: nullableString(),
+  expression: nullableString(),
+  timezone: nullableString()
+});
+const conversationScheduleSchema = z.object({
+  id: z.string(),
+  conversationId: z.string(),
+  agentId: z.string(),
+  // The agent participant the schedule belongs to.
+  ownerParticipantId: z.string(),
+  source: tolerantStringEnum(ScheduleSource),
+  name: z.string(),
+  prompt: z.string(),
+  trigger: scheduleTriggerSchema,
+  delivery: tolerantStringEnum(ScheduleDelivery),
+  // A one-time schedule turns itself off after it fires.
+  enabled: z.boolean(),
+  nextRunAt: nullableString(),
+  lastRunAt: nullableString(),
+  createdAt: z.string(),
+  updatedAt: nullableString()
+});
+const conversationScheduleListSchema = z.object({
+  schedules: z.array(conversationScheduleSchema)
+});
+const scheduleTriggerInputSchema = z.discriminatedUnion("type", [
+  z.strictObject({
+    type: z.literal(ScheduleTriggerType.Once),
+    // A future timestamp with `Z` or a UTC offset.
+    at: z.string().datetime({ offset: true })
+  }),
+  z.strictObject({
+    type: z.literal(ScheduleTriggerType.Cron),
+    expression: z.string().trim().min(1).max(120),
+    // An IANA timezone.
+    timezone: z.string().trim().min(1).max(120)
+  })
+]);
+const createConversationScheduleRequestSchema = z.strictObject({
+  name: z.string().trim().min(1).max(200),
+  prompt: z.string().trim().min(1).max(2e5),
+  trigger: scheduleTriggerInputSchema,
+  delivery: z.enum(ScheduleDelivery),
+  enabled: z.boolean().optional(),
+  // The agent participant the schedule belongs to. An agent creating its own
+  // schedule omits it; a person may omit it when the conversation has one agent.
+  agentParticipantId: z.string().min(1).optional()
+});
+const updateConversationScheduleRequestSchema = z.strictObject({
+  name: z.string().trim().min(1).max(200).optional(),
+  prompt: z.string().trim().min(1).max(2e5).optional(),
+  trigger: scheduleTriggerInputSchema.optional(),
+  delivery: z.enum(ScheduleDelivery).optional(),
+  enabled: z.boolean().optional()
+});
+export {
+  conversationScheduleListSchema,
+  conversationScheduleSchema,
+  createConversationScheduleRequestSchema,
+  scheduleTriggerInputSchema,
+  scheduleTriggerSchema,
+  updateConversationScheduleRequestSchema
+};
+//# sourceMappingURL=conversation-schedules.mjs.map

package/dist/modules/agent-platform/conversation-schedules.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-platform/conversation-schedules.ts"],
+  "sourcesContent": ["import * as z from 'zod';\n\nimport { tolerantStringEnum } from \"../tolerance.mjs\";\n\nimport { nullableString } from \"./common.mjs\";\n\nimport { ScheduleDelivery, ScheduleSource, ScheduleTriggerType } from \"./enums.mjs\";\n\n// Runtime schedules of a conversation (`/api/v1/conversations/:id/schedules`):\n// one-time reminders and recurring checks an agent, a person or a third-party\n// agent creates in the conversation. Each belongs to one agent participant,\n// whose session the firing prompts there.\n\n/** When a schedule fires: `once` sets `at`; `cron` sets `expression` and `timezone`. */\nexport const scheduleTriggerSchema = z.object({\n  type: tolerantStringEnum(ScheduleTriggerType),\n  at: nullableString(),\n  expression: nullableString(),\n  timezone: nullableString(),\n});\n\nexport type ScheduleTriggerIface = z.infer<typeof scheduleTriggerSchema>;\n\nexport const conversationScheduleSchema = z.object({\n  id: z.string(),\n  conversationId: z.string(),\n  agentId: z.string(),\n  // The agent participant the schedule belongs to.\n  ownerParticipantId: z.string(),\n  source: tolerantStringEnum(ScheduleSource),\n  name: z.string(),\n  prompt: z.string(),\n  trigger: scheduleTriggerSchema,\n  delivery: tolerantStringEnum(ScheduleDelivery),\n  // A one-time schedule turns itself off after it fires.\n  enabled: z.boolean(),\n  nextRunAt: nullableString(),\n  lastRunAt: nullableString(),\n  createdAt: z.string(),\n  updatedAt: nullableString(),\n});\n\nexport type ConversationScheduleIface = z.infer<typeof conversationScheduleSchema>;\n\nexport const conversationScheduleListSchema = z.object({\n  schedules: z.array(conversationScheduleSchema),\n});\n\nexport type ConversationScheduleListIface = z.infer<typeof conversationScheduleListSchema>;\n\n/** A trigger as a client sends it. */\nexport const scheduleTriggerInputSchema = z.discriminatedUnion('type', [\n  z.strictObject({\n    type: z.literal(ScheduleTriggerType.Once),\n    // A future timestamp with `Z` or a UTC offset.\n    at: z.string().datetime({ offset: true }),\n  }),\n  z.strictObject({\n    type: z.literal(ScheduleTriggerType.Cron),\n    expression: z.string().trim().min(1).max(120),\n    // An IANA timezone.\n    timezone: z.string().trim().min(1).max(120),\n  }),\n]);\n\nexport type ScheduleTriggerInputIface = z.infer<typeof scheduleTriggerInputSchema>;\n\nexport const createConversationScheduleRequestSchema = z.strictObject({\n  name: z.string().trim().min(1).max(200),\n  prompt: z.string().trim().min(1).max(200_000),\n  trigger: scheduleTriggerInputSchema,\n  delivery: z.enum(ScheduleDelivery),\n  enabled: z.boolean().optional(),\n  // The agent participant the schedule belongs to. An agent creating its own\n  // schedule omits it; a person may omit it when the conversation has one agent.\n  agentParticipantId: z.string().min(1).optional(),\n});\n\nexport type CreateConversationScheduleRequestIface = z.infer<\n  typeof createConversationScheduleRequestSchema\n>;\n\n/** Omitted fields stay unchanged. */\nexport const updateConversationScheduleRequestSchema = z.strictObject({\n  name: z.string().trim().min(1).max(200).optional(),\n  prompt: z.string().trim().min(1).max(200_000).optional(),\n  trigger: scheduleTriggerInputSchema.optional(),\n  delivery: z.enum(ScheduleDelivery).optional(),\n  enabled: z.boolean().optional(),\n});\n\nexport type UpdateConversationScheduleRequestIface = z.infer<\n  typeof updateConversationScheduleRequestSchema\n>;\n"],
+  "mappings": "AAAA,YAAY,OAAO;AAEnB,SAAS,0BAA0B;AAEnC,SAAS,sBAAsB;AAE/B,SAAS,kBAAkB,gBAAgB,2BAA2B;AAQ/D,MAAM,wBAAwB,EAAE,OAAO;AAAA,EAC5C,MAAM,mBAAmB,mBAAmB;AAAA,EAC5C,IAAI,eAAe;AAAA,EACnB,YAAY,eAAe;AAAA,EAC3B,UAAU,eAAe;AAC3B,CAAC;AAIM,MAAM,6BAA6B,EAAE,OAAO;AAAA,EACjD,IAAI,EAAE,OAAO;AAAA,EACb,gBAAgB,EAAE,OAAO;AAAA,EACzB,SAAS,EAAE,OAAO;AAAA;AAAA,EAElB,oBAAoB,EAAE,OAAO;AAAA,EAC7B,QAAQ,mBAAmB,cAAc;AAAA,EACzC,MAAM,EAAE,OAAO;AAAA,EACf,QAAQ,EAAE,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU,mBAAmB,gBAAgB;AAAA;AAAA,EAE7C,SAAS,EAAE,QAAQ;AAAA,EACnB,WAAW,eAAe;AAAA,EAC1B,WAAW,eAAe;AAAA,EAC1B,WAAW,EAAE,OAAO;AAAA,EACpB,WAAW,eAAe;AAC5B,CAAC;AAIM,MAAM,iCAAiC,EAAE,OAAO;AAAA,EACrD,WAAW,EAAE,MAAM,0BAA0B;AAC/C,CAAC;AAKM,MAAM,6BAA6B,EAAE,mBAAmB,QAAQ;AAAA,EACrE,EAAE,aAAa;AAAA,IACb,MAAM,EAAE,QAAQ,oBAAoB,IAAI;AAAA;AAAA,IAExC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,KAAK,CAAC;AAAA,EAC1C,CAAC;AAAA,EACD,EAAE,aAAa;AAAA,IACb,MAAM,EAAE,QAAQ,oBAAoB,IAAI;AAAA,IACxC,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA;AAAA,IAE5C,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EAC5C,CAAC;AACH,CAAC;AAIM,MAAM,0CAA0C,EAAE,aAAa;AAAA,EACpE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EACtC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAO;AAAA,EAC5C,SAAS;AAAA,EACT,UAAU,EAAE,KAAK,gBAAgB;AAAA,EACjC,SAAS,EAAE,QAAQ,EAAE,SAAS;AAAA;AAAA;AAAA,EAG9B,oBAAoB,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS;AACjD,CAAC;AAOM,MAAM,0CAA0C,EAAE,aAAa;AAAA,EACpE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,EACjD,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAO,EAAE,SAAS;AAAA,EACvD,SAAS,2BAA2B,SAAS;AAAA,EAC7C,UAAU,EAAE,KAAK,gBAAgB,EAAE,SAAS;AAAA,EAC5C,SAAS,EAAE,QAAQ,EAAE,SAAS;AAChC,CAAC;",
+  "names": []
+}