@zixt/host 0.0.47 → 0.0.48

package/dist/index.js

@@ -31,7 +31,7 @@ import { homedir } from "node:os";
 // package.json
 var package_default = {
   name: "@zixt/host",
-  version: "0.0.47",
+  version: "0.0.48",
   type: "module",
   exports: {
     ".": "./src/client.ts",
@@ -14660,7 +14660,17 @@ var ID_PREFIXES = {
   /** One Manager inference call's token-metering row (MG-8). */
   managerUsage: "mgu",
   /** One ordered Manager reply awaiting Slack delivery. */
-  managerSlackOutbox: "mso"
+  managerSlackOutbox: "mso",
+  /** One organization phone line that reaches its Manager. */
+  voiceLine: "vln",
+  /** One member-owned phone number admitted to Manager calls. */
+  voiceCaller: "vcr",
+  /** One live or historical phone call with the Manager. */
+  voiceCall: "vca",
+  /** One durable caller-transcript or Manager-speech delivery. */
+  voiceTurn: "vtr",
+  /** One signed voice-provider webhook receipt. */
+  voiceWebhookEvent: "vwe"
 };
 var idPattern = (prefix) => new RegExp(`^${prefix}_[0-9a-f]{32}$`);
 function newId(prefix) {
@@ -14687,6 +14697,14 @@ var ManagerId = idSchema(ID_PREFIXES.manager, "manager id");
 var ManagerMemoryId = idSchema(ID_PREFIXES.managerMemory, "manager memory id");
 var ConversationId = idSchema(ID_PREFIXES.conversation, "conversation id");
 var ConversationEventId = idSchema(ID_PREFIXES.conversationEvent, "conversation event id");
+var VoiceLineId = idSchema(ID_PREFIXES.voiceLine, "voice line id");
+var VoiceCallerId = idSchema(ID_PREFIXES.voiceCaller, "voice caller id");
+var VoiceCallId = idSchema(ID_PREFIXES.voiceCall, "voice call id");
+var VoiceTurnId = idSchema(ID_PREFIXES.voiceTurn, "voice turn id");
+var VoiceWebhookEventId = idSchema(
+  ID_PREFIXES.voiceWebhookEvent,
+  "voice webhook event id"
+);
 
 // ../../packages/contracts/src/browser.ts
 var BrowserViewport = external_exports.object({
@@ -18752,7 +18770,7 @@ var ListManagerMemoriesResponse = external_exports.object({
   memories: external_exports.array(ManagerMemoryProjection).max(MANAGER_MEMORY_MAX_ITEMS),
   limit: external_exports.number().int().min(1)
 }).strict();
-var ConversationChannel = external_exports.enum(["web", "slack", "whatsapp"]);
+var ConversationChannel = external_exports.enum(["web", "slack", "whatsapp", "phone"]);
 var ConversationStatus = external_exports.enum(["idle", "thinking"]);
 var ConversationProjection = external_exports.object({
   id: ConversationId,
@@ -18790,6 +18808,10 @@ var ConversationEventProjection = external_exports.discriminatedUnion("kind", [
     text: external_exports.string(),
     /** Display attribution only; authentication subjects remain internal. */
     author: external_exports.object({ displayName: external_exports.string().nullable() }).strict(),
+    /** Transport that supplied this turn; legacy events omit it. */
+    sourceChannel: ConversationChannel.optional(),
+    /** Input affordance within the trusted transport; legacy/typed turns omit it. */
+    inputModality: external_exports.literal("voice").optional(),
     attachments: external_exports.array(TaskAttachmentRef).max(TASK_MESSAGE_MAX_ATTACHMENTS).optional()
   }).strict(),
   /** The Manager's prose reply. */
@@ -18931,6 +18953,231 @@ var ManagerStreamFrame = external_exports.discriminatedUnion("type", [
   external_exports.object({ type: external_exports.literal("conversation"), conversation: ConversationProjection }).strict()
 ]);
 
+// ../../packages/contracts/src/voice.ts
+var VOICE_MAX_CALL_MINUTES = 30;
+var VoiceE164Number = external_exports.string().regex(/^\+[1-9]\d{7,14}$/, "must be an international phone number");
+var VoicePhoneNumberInput = external_exports.string().trim().min(7).max(32).refine(
+  (value) => /^\+[1-9]\d{7,14}$/.test(value.replace(/[\s()\-.]/g, "")),
+  "must include a country code"
+);
+var VoiceAvailability = external_exports.enum(["unavailable", "setup_required", "setting_up", "ready", "needs_attention"]).describe(
+  "Local Zixt deployment and line configuration state; ready does not prove remote webhook delivery"
+);
+var VoiceLineProjection = external_exports.object({
+  id: VoiceLineId,
+  /** Full public number: a member needs this value in order to call it. */
+  dialInNumber: VoiceE164Number,
+  enabled: external_exports.boolean(),
+  readiness: external_exports.enum(["setting_up", "ready", "needs_attention"]).describe("Local line-resource state; ready does not prove remote webhook delivery")
+}).strict();
+var VoiceCallerProjection = external_exports.object({
+  id: VoiceCallerId,
+  memberId: MemberId,
+  memberDisplayName: external_exports.string().min(1).max(120),
+  /** Masked E.164 (for example +1 ••• ••• 7767), never the lookup key. */
+  phoneNumber: external_exports.string().regex(/^\+(?:1|••) ••• ••• \d{4}$/, "must be a masked phone number"),
+  status: external_exports.enum(["sending", "pending", "verified", "failed"]),
+  verifiedAt: external_exports.string().nullable(),
+  verificationExpiresAt: external_exports.string().nullable(),
+  /** Member can manage their own rows; Admin/Owner can manage every row. */
+  canManage: external_exports.boolean(),
+  isCurrentMember: external_exports.boolean()
+}).strict();
+var VoiceSettingsResponse = external_exports.object({
+  availability: VoiceAvailability,
+  enabled: external_exports.boolean(),
+  dialInNumber: VoiceE164Number.nullable(),
+  line: VoiceLineProjection.nullable(),
+  callers: external_exports.array(VoiceCallerProjection).max(500),
+  /** Admin/Owner can set up or enable the organization line. */
+  canManageLine: external_exports.boolean(),
+  /** Admin/Owner can start verification for another member. */
+  canManageCallers: external_exports.boolean(),
+  currentMemberId: MemberId,
+  maxCallMinutes: external_exports.literal(VOICE_MAX_CALL_MINUTES),
+  revision: external_exports.number().int().min(0)
+}).strict().superRefine((settings, context) => {
+  if (!settings.line && settings.dialInNumber !== null) {
+    context.addIssue({
+      code: "custom",
+      path: ["dialInNumber"],
+      message: "requires a line"
+    });
+    return;
+  }
+  if (settings.line && (settings.line.dialInNumber !== settings.dialInNumber || settings.line.enabled !== settings.enabled)) {
+    context.addIssue({
+      code: "custom",
+      path: ["line"],
+      message: "must match the top-level line state"
+    });
+  }
+});
+var SetupVoiceCallsRequest = external_exports.object({ requestId: external_exports.uuid() }).strict();
+var SetVoiceCallsEnabledRequest = external_exports.object({ enabled: external_exports.boolean(), expectedRevision: external_exports.number().int().min(0) }).strict();
+var StartVoiceCallerVerificationRequest = external_exports.object({
+  requestId: external_exports.uuid(),
+  phoneNumber: VoicePhoneNumberInput,
+  /** Omit to verify a number for the authenticated member. */
+  memberId: MemberId.optional()
+}).strict();
+var StartVoiceCallerVerificationResponse = external_exports.object({ verificationId: VoiceCallerId, caller: VoiceCallerProjection }).strict();
+var CheckVoiceCallerVerificationRequest = external_exports.object({
+  verificationId: VoiceCallerId,
+  /** Verification codes are transported to Twilio and are never persisted. */
+  code: external_exports.string().trim().regex(/^\d{4,10}$/, "enter the code from the text message")
+}).strict();
+var ResendVoiceCallerVerificationRequest = external_exports.object({ requestId: external_exports.uuid(), verificationId: VoiceCallerId }).strict();
+var RemoveVoiceCallerResponse = external_exports.object({ removed: external_exports.literal(true) }).strict();
+var StartVoiceCallRequest = external_exports.object({
+  requestId: external_exports.uuid(),
+  /** Must be a verified number owned by the authenticated member. */
+  callerId: VoiceCallerId,
+  /** Present when the call continues the exact open Manager Task/chat. */
+  conversationId: ConversationId.optional()
+}).strict();
+var VoiceCallStatus = external_exports.enum(["calling", "connected", "ending", "ended", "failed"]);
+var VoiceCallProjection = external_exports.object({
+  id: VoiceCallId,
+  status: VoiceCallStatus,
+  callerId: VoiceCallerId,
+  /** Bound as soon as a new-task call is admitted; never waits for first speech. */
+  conversationId: ConversationId.nullable(),
+  startedAt: IsoDate2,
+  /**
+   * Earliest time this member may start another call under the one-minute
+   * admission cooldown. Null means this attempt did not consume cooldown
+   * (for example, the carrier definitively rejected it before ringing).
+   * Optional only for rolling compatibility with an older cloud response.
+   */
+  outboundCooldownUntil: IsoDate2.nullable().optional(),
+  maxCallMinutes: external_exports.literal(VOICE_MAX_CALL_MINUTES),
+  /** Server-derived; only the mapped caller may end this call. */
+  canEnd: external_exports.boolean()
+}).strict();
+var VoiceCurrentCallQuery = external_exports.object({
+  conversationId: ConversationId.optional(),
+  /** Exact idempotency fence used only to recover this member's uncertain start. */
+  requestId: external_exports.uuid().optional()
+}).strict().refine((query) => !(query.conversationId && query.requestId), {
+  message: "choose a Task or an exact call request, not both"
+});
+var VoiceCurrentCallResponse = external_exports.object({ call: VoiceCallProjection.nullable() }).strict();
+var EndVoiceCallResponse = external_exports.object({ ended: external_exports.literal(true) }).strict();
+var BrowserVoiceReadinessResponse = external_exports.object({
+  ready: external_exports.boolean(),
+  reason: external_exports.enum(["manager_unavailable", "voice_unavailable", "voice_in_use"]).nullable()
+}).strict().superRefine((value, context) => {
+  if (value.ready !== (value.reason === null)) {
+    context.addIssue({
+      code: "custom",
+      path: ["reason"],
+      message: "must be null exactly when browser Voice mode is ready"
+    });
+  }
+});
+var BROWSER_VOICE_MAX_SDP_BYTES = 131072;
+function isAudioOnlyWebRtcSessionDescription(value) {
+  if (!/^v=0(?:\r?\n)/.test(value) || value.includes("\0") || /\r(?!\n)/.test(value)) {
+    return false;
+  }
+  const media = value.split(/\r?\n/).filter((line) => line.startsWith("m="));
+  if (media.length !== 1 || !/^m=audio [1-9]\d* UDP\/TLS\/RTP\/SAVPF(?: \d+)+$/.test(media[0])) {
+    return false;
+  }
+  const forbiddenAttribute = /^(?:a=inactive|a=(?:sctp-port|sctpmap|dcmap|dcsa|max-message-size):)/i;
+  return !value.split(/\r?\n/).some((line) => forbiddenAttribute.test(line) || /webrtc-datachannel/i.test(line));
+}
+var BrowserVoiceSessionDescription = external_exports.string().min(4).max(BROWSER_VOICE_MAX_SDP_BYTES).refine((value) => new TextEncoder().encode(value).byteLength <= BROWSER_VOICE_MAX_SDP_BYTES, {
+  message: "must fit within the WebRTC session description limit"
+}).refine(isAudioOnlyWebRtcSessionDescription, {
+  message: "must be an audio-only WebRTC session description"
+});
+var BrowserVoiceInitialRunner = TaskRunnerSelection.refine(
+  (selection) => selection.type !== void 0 || selection.model !== void 0 || selection.effort !== void 0,
+  "choose at least one runtime preference"
+);
+var StartBrowserVoiceSessionRequest = external_exports.object({
+  /** Stable client fence. A provider-create ambiguity is never resubmitted under this id. */
+  requestId: external_exports.uuid(),
+  offerSdp: BrowserVoiceSessionDescription,
+  conversationId: ConversationId.optional(),
+  /** Manager Browser teammate selected for spoken Browser-directed turns. */
+  browserAgentId: AgentId.optional(),
+  /** New-Task-only one-use runtime for its first successful delegation. */
+  initialDelegation: external_exports.object({ runner: BrowserVoiceInitialRunner }).strict().optional()
+}).strict().superRefine((value, context) => {
+  if (value.conversationId && value.initialDelegation) {
+    context.addIssue({
+      code: "custom",
+      path: ["initialDelegation"],
+      message: "is available only when voice mode opens a new Task"
+    });
+  }
+});
+var BrowserVoiceSessionStatus = external_exports.enum([
+  "connecting",
+  "connected",
+  "ending",
+  "ended",
+  "failed"
+]);
+var BrowserVoiceSessionProjection = external_exports.object({
+  id: VoiceCallId,
+  status: BrowserVoiceSessionStatus,
+  conversationId: ConversationId.nullable(),
+  startedAt: IsoDate2,
+  expiresAt: IsoDate2,
+  /** Server-derived from the authenticated member binding and terminal state. */
+  canEnd: external_exports.boolean()
+}).strict();
+var StartBrowserVoiceSessionResponse = external_exports.object({
+  session: BrowserVoiceSessionProjection,
+  /** Applied directly to the browser peer connection and never persisted by Zixt. */
+  answerSdp: BrowserVoiceSessionDescription
+}).strict();
+var AckBrowserVoiceSessionRequest = external_exports.object({ requestId: external_exports.uuid() }).strict();
+var AckBrowserVoiceSessionResponse = external_exports.object({ session: BrowserVoiceSessionProjection }).strict();
+var BrowserVoiceCurrentSessionQuery = external_exports.object({
+  conversationId: ConversationId.optional(),
+  /** Recover the exact uncertain start instead of whichever session is current. */
+  requestId: external_exports.uuid().optional()
+}).strict().refine((query) => !(query.conversationId && query.requestId), {
+  message: "choose a Task or an exact session request, not both"
+});
+var BrowserVoiceCurrentSessionResponse = external_exports.object({ session: BrowserVoiceSessionProjection.nullable() }).strict();
+var EndBrowserVoiceSessionResponse = external_exports.object({ ended: external_exports.literal(true) }).strict();
+var BrowserVoiceCaption = external_exports.string().max(4e3);
+var BrowserVoiceCallerIdentity = {
+  // Zixt-scoped presentation identity only. Provider item ids stay inside the
+  // voice service, and both fields remain optional across rolling deploys.
+  utteranceId: external_exports.string().min(1).max(128).regex(/^[A-Za-z0-9_-]+$/).optional(),
+  utteranceOrdinal: external_exports.number().int().min(1).optional()
+};
+var BrowserVoicePresentationFrame = external_exports.discriminatedUnion("type", [
+  external_exports.object({ type: external_exports.literal("caller_speech_started"), ...BrowserVoiceCallerIdentity }).strict(),
+  external_exports.object({ type: external_exports.literal("caller_speech_stopped"), ...BrowserVoiceCallerIdentity }).strict(),
+  external_exports.object({
+    type: external_exports.literal("user_caption"),
+    text: BrowserVoiceCaption,
+    final: external_exports.boolean(),
+    ...BrowserVoiceCallerIdentity
+  }).strict(),
+  external_exports.object({
+    type: external_exports.literal("manager_speech_started"),
+    speechId: VoiceTurnId,
+    text: BrowserVoiceCaption
+  }).strict(),
+  external_exports.object({ type: external_exports.literal("manager_speech_stopped"), speechId: VoiceTurnId }).strict(),
+  external_exports.object({ type: external_exports.literal("manager_speech_failed"), speechId: VoiceTurnId }).strict(),
+  external_exports.object({ type: external_exports.literal("manager_speech_idle") }).strict(),
+  external_exports.object({ type: external_exports.literal("transcription_failed"), ...BrowserVoiceCallerIdentity }).strict(),
+  external_exports.object({ type: external_exports.literal("session_ended") }).strict(),
+  external_exports.object({ type: external_exports.literal("session_failed") }).strict()
+]);
+var InterruptBrowserVoiceSessionRequest = external_exports.object({ speechId: VoiceTurnId }).strict();
+var InterruptBrowserVoiceSessionResponse = external_exports.object({ interrupted: external_exports.boolean() }).strict();
+
 // ../../packages/contracts/src/slack.ts
 var SlackInstallationProjection = external_exports.object({
   id: external_exports.string(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zixt/host",
-  "version": "0.0.47",
+  "version": "0.0.48",
   "type": "module",
   "exports": {
     ".": "./src/client.ts",