@convai/web-sdk 1.8.0-beta.6 → 1.8.0-beta.7

package/dist/core/connectRequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"connectRequest.js","sourceRoot":"","sources":["../../src/core/connectRequest.ts"],"names":[],"mappings":"AAcA;;;;;;;GAOG;AACH,MAAM,UAAU,4BAA4B,CAC1C,MAAgE;IAEhE,MAAM,kBAAkB,GACtB,MAAM,CAAC,aAAa,KAAK,IAAI;QAC7B,MAAM,CAAC,gBAAgB,EAAE,oBAAoB,KAAK,KAAK,CAAC;IAE1D,OAAO;QACL,mBAAmB,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc;QACxE,iBAAiB,EAAE;YACjB,eAAe,EAAE,IAAI;YACrB,UAAU,EAAE,EAAE;YACd,MAAM,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,IAAI,KAAK;YAChD,sBAAsB,EACpB,MAAM,CAAC,gBAAgB,EAAE,sBAAsB,IAAI,GAAG;YACxD,yEAAyE;YACzE,qEAAqE;YACrE,wEAAwE;YACxE,gBAAgB;YAChB,UAAU,EAAE,kBAAkB;gBAC5B,CAAC,CAAC,MAAM,CAAC,gBAAgB,EAAE,UAAU,IAAI,EAAE;gBAC3C,CAAC,CAAC,EAAE;YACN,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,MAA6D;IAE7D,IAAI,MAAM,CAAC,aAAa,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACpD,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;IAC3C,IAAI,aAAa,EAAE,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACzC,OAAO;YACL,QAAQ,EAAE,aAAa,CAAC,QAAQ;YAChC,kBAAkB,EAAE,aAAa,CAAC,kBAAkB,IAAI,CAAC;YACzD,uBAAuB,EAAE,aAAa,CAAC,uBAAuB,IAAI,IAAI;YACtE,wBAAwB,EAAE,aAAa,CAAC,wBAAwB,IAAI,IAAI;SACzE,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,IAAI,KAAK,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,MAA0C;IAE1C,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IACzC,IAAI,CAAC,YAAY;QAAE,OAAO,SAAS,CAAC;IACpC,OAAO;QACL,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,GAAG,CAAC,YAAY,CAAC,wBAAwB,IAAI;YAC3C,wBAAwB,EAAE,YAAY,CAAC,wBAAwB;SAChE,CAAC;QACF,GAAG,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,YAA0C;IAE1C,IAAI,CAAC,YAAY;QAAE,OAAO,SAAS,CAAC;IACpC,OAAO;QACL,uBAAuB,EAAE,YAAY,CAAC,qBAAqB;QAC3D,GAAG,CAAC,YAAY,CAAC,kBAAkB,KAAK,SAAS;YAC/C,CAAC,CAAC,EAAE,oBAAoB,EAAE,YAAY,CAAC,kBAAkB,EAAE;YAC3D,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC","sourcesContent":["import type { ConvaiConfig } from \"./types\";\n\nexport interface BlendshapeConnectRequestConfig {\n  blendshape_provider: \"neurosync\" | \"not_provided\";\n  blendshape_config: {\n    enable_chunking: true;\n    chunk_size: number;\n    format: \"arkit\" | \"mha\" | \"cc4_extended\" | \"cc5_hd\" | \"visemes\";\n    frames_buffer_duration: number;\n    output_fps: number;\n    deliver_chunks_ahead?: true;\n  };\n}\n\n/**\n * Build the lipsync part of the /connect request.\n *\n * Ahead-delivery changes the client contract because frames can arrive before\n * bot-started-speaking and cancellation must be handled with owner metadata.\n * It is the default now that server support is verified; callers can fall back\n * to the legacy paced path with deliver_chunks_ahead: false.\n */\nexport function buildBlendshapeConnectConfig(\n  config: Pick<ConvaiConfig, \"enableLipsync\" | \"blendshapeConfig\">,\n): BlendshapeConnectRequestConfig {\n  const deliverChunksAhead =\n    config.enableLipsync === true &&\n    config.blendshapeConfig?.deliver_chunks_ahead !== false;\n\n  return {\n    blendshape_provider: config.enableLipsync ? \"neurosync\" : \"not_provided\",\n    blendshape_config: {\n      enable_chunking: true,\n      chunk_size: 10,\n      format: config.blendshapeConfig?.format || \"mha\",\n      frames_buffer_duration:\n        config.blendshapeConfig?.frames_buffer_duration ?? 0.1,\n      // In the legacy paced path, output_fps is a delivery cadence and the SDK\n      // player keeps its 60fps visual timeline. Only ahead-delivery treats\n      // output_fps as a client-visible timeline override because chunks carry\n      // fps metadata.\n      output_fps: deliverChunksAhead\n        ? config.blendshapeConfig?.output_fps ?? 60\n        : 90,\n      ...(deliverChunksAhead ? { deliver_chunks_ahead: true } : {}),\n    },\n  };\n}\n\nexport function buildEmotionConnectConfig(\n  config: Pick<ConvaiConfig, \"enableEmotion\" | \"emotionConfig\">,\n): Record<string, unknown> | undefined {\n  if (config.enableEmotion !== true) return undefined;\n  const emotionConfig = config.emotionConfig;\n  if (emotionConfig?.provider === \"nrclex\") {\n    return {\n      provider: emotionConfig.provider,\n      min_word_threshold: emotionConfig.min_word_threshold ?? 3,\n      low_intensity_threshold: emotionConfig.low_intensity_threshold ?? 0.33,\n      high_intensity_threshold: emotionConfig.high_intensity_threshold ?? 0.66,\n    };\n  }\n  return { provider: emotionConfig?.provider ?? \"llm\" };\n}\n\nexport function buildActionConnectConfig(\n  config: Pick<ConvaiConfig, \"actionConfig\">,\n): ConvaiConfig[\"actionConfig\"] | undefined {\n  const actionConfig = config.actionConfig;\n  if (!actionConfig) return undefined;\n  return {\n    actions: actionConfig.actions,\n    objects: actionConfig.objects,\n    characters: actionConfig.characters,\n    ...(actionConfig.current_attention_object && {\n      current_attention_object: actionConfig.current_attention_object,\n    }),\n    ...(actionConfig.tools && { tools: actionConfig.tools }),\n  };\n}\n\nexport function serializeActionProtocolCapabilities(\n  capabilities: ConvaiConfig[\"capabilities\"],\n): Record<string, number> | undefined {\n  if (!capabilities) return undefined;\n  return {\n    action_protocol_version: capabilities.actionProtocolVersion,\n    ...(capabilities.modelOutputVersion !== undefined\n      ? { model_output_version: capabilities.modelOutputVersion }\n      : {}),\n  };\n}\n"]}
+{"version":3,"file":"connectRequest.js","sourceRoot":"","sources":["../../src/core/connectRequest.ts"],"names":[],"mappings":"AA8BA;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAC3C,YAAoD;IAEpD,IAAI,CAAC,YAAY;QAAE,OAAO,SAAS,CAAC;IAEpC,MAAM,UAAU,GAAuC;QACrD,GAAG,CAAC,YAAY,CAAC,qBAAqB,KAAK,SAAS,IAAI;YACtD,uBAAuB,EAAE,YAAY,CAAC,qBAAqB;SAC5D,CAAC;QACF,GAAG,CAAC,YAAY,CAAC,kBAAkB,KAAK,SAAS,IAAI;YACnD,oBAAoB,EAAE,YAAY,CAAC,kBAAkB;SACtD,CAAC;KACH,CAAC;IAEF,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACrE,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,oBAAoB,CAClC,KAA8B;IAE9B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,IAAI,CAAC,WAAW;KAC/B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,+BAA+B,CAC7C,gBAAmC,EACnC,eAAwB;IAExB,IACE,eAAe,IAAI,IAAI;QACvB,eAAe,KAAK,CAAC;QACrB,eAAe,KAAK,CAAC,EACrB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,sDAAsD,MAAM,CAAC,eAAe,CAAC,EAAE,CAChF,CAAC;IACJ,CAAC;IACD,IAAI,gBAAgB,KAAK,CAAC,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,eAAe,KAAK,CAAC,IAAI,gBAAgB,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,mCAAmC,CACjD,gBAAmC,EACnC,eAAwB;IAExB,IACE,eAAe,IAAI,IAAI;QACvB,eAAe,KAAK,CAAC;QACrB,eAAe,KAAK,CAAC,EACrB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,mDAAmD,MAAM,CAAC,eAAe,CAAC,EAAE,CAC7E,CAAC;IACJ,CAAC;IACD,IAAI,gBAAgB,KAAK,CAAC,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,eAAe,KAAK,CAAC,IAAI,gBAAgB,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CACb,wEAAwE,CACzE,CAAC;IACJ,CAAC;IAED,OAAO,eAAe,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,4BAA4B,CAC1C,MAAgE;IAEhE,MAAM,kBAAkB,GACtB,MAAM,CAAC,aAAa,KAAK,IAAI;QAC7B,MAAM,CAAC,gBAAgB,EAAE,oBAAoB,KAAK,KAAK,CAAC;IAE1D,OAAO;QACL,mBAAmB,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc;QACxE,iBAAiB,EAAE;YACjB,eAAe,EAAE,IAAI;YACrB,UAAU,EAAE,EAAE;YACd,MAAM,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,IAAI,KAAK;YAChD,sBAAsB,EACpB,MAAM,CAAC,gBAAgB,EAAE,sBAAsB,IAAI,GAAG;YACxD,yEAAyE;YACzE,qEAAqE;YACrE,wEAAwE;YACxE,gBAAgB;YAChB,UAAU,EAAE,kBAAkB;gBAC5B,CAAC,CAAC,MAAM,CAAC,gBAAgB,EAAE,UAAU,IAAI,EAAE;gBAC3C,CAAC,CAAC,EAAE;YACN,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,MAA6D;IAE7D,IAAI,MAAM,CAAC,aAAa,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACpD,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;IAC3C,IAAI,aAAa,EAAE,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACzC,OAAO;YACL,QAAQ,EAAE,aAAa,CAAC,QAAQ;YAChC,kBAAkB,EAAE,aAAa,CAAC,kBAAkB,IAAI,CAAC;YACzD,uBAAuB,EAAE,aAAa,CAAC,uBAAuB,IAAI,IAAI;YACtE,wBAAwB,EAAE,aAAa,CAAC,wBAAwB,IAAI,IAAI;SACzE,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,IAAI,KAAK,EAAE,CAAC;AACxD,CAAC;AAWD,MAAM,UAAU,wBAAwB,CACtC,MAA0C;IAE1C,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IACzC,IAAI,CAAC,YAAY;QAAE,OAAO,SAAS,CAAC;IACpC,OAAO;QACL,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,GAAG,CAAC,YAAY,CAAC,wBAAwB,IAAI;YAC3C,wBAAwB,EAAE,YAAY,CAAC,wBAAwB;SAChE,CAAC;QACF,GAAG,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,oBAAoB,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;KAC/E,CAAC;AACJ,CAAC","sourcesContent":["import type {\n  ClientToolDeclaration,\n  ConvaiConfig,\n  JsonObject,\n  ProtocolCapabilitiesConfig,\n} from \"./types\";\n\nexport interface BlendshapeConnectRequestConfig {\n  blendshape_provider: \"neurosync\" | \"not_provided\";\n  blendshape_config: {\n    enable_chunking: true;\n    chunk_size: number;\n    format: \"arkit\" | \"mha\" | \"cc4_extended\" | \"cc5_hd\" | \"visemes\";\n    frames_buffer_duration: number;\n    output_fps: number;\n    deliver_chunks_ahead?: true;\n  };\n}\n\nexport interface ClientToolConnectRequestDeclaration {\n  name: string;\n  description: string;\n  input_schema: JsonObject;\n}\n\nexport interface ProtocolCapabilitiesConnectRequest {\n  action_protocol_version?: 1 | 2;\n  model_output_version?: 1 | 2;\n}\n\n/**\n * Serialize only explicitly selected capabilities.\n *\n * Returning undefined for an omitted or empty config keeps legacy /connect\n * request bodies unchanged, including for clients using strict wire snapshots.\n */\nexport function serializeProtocolCapabilities(\n  capabilities: ProtocolCapabilitiesConfig | undefined,\n): ProtocolCapabilitiesConnectRequest | undefined {\n  if (!capabilities) return undefined;\n\n  const serialized: ProtocolCapabilitiesConnectRequest = {\n    ...(capabilities.actionProtocolVersion !== undefined && {\n      action_protocol_version: capabilities.actionProtocolVersion,\n    }),\n    ...(capabilities.modelOutputVersion !== undefined && {\n      model_output_version: capabilities.modelOutputVersion,\n    }),\n  };\n\n  return Object.keys(serialized).length > 0 ? serialized : undefined;\n}\n\n/** Serialize the public camelCase SDK shape to Core's snake_case wire contract. */\nexport function serializeClientTools(\n  tools: ClientToolDeclaration[],\n): ClientToolConnectRequestDeclaration[] {\n  return tools.map((tool) => ({\n    name: tool.name,\n    description: tool.description,\n    input_schema: tool.inputSchema,\n  }));\n}\n\n/** Reject unsupported action versions, downgrades, and unsolicited v2 upgrades. */\nexport function validateActionProtocolSelection(\n  requestedVersion: 1 | 2 | undefined,\n  selectedVersion: unknown,\n): void {\n  if (\n    selectedVersion != null &&\n    selectedVersion !== 1 &&\n    selectedVersion !== 2\n  ) {\n    throw new Error(\n      `Core selected unsupported action protocol version: ${String(selectedVersion)}`,\n    );\n  }\n  if (requestedVersion === 2 && selectedVersion !== 2) {\n    throw new Error(\"Core did not select requested action protocol version 2\");\n  }\n  if (selectedVersion === 2 && requestedVersion !== 2) {\n    throw new Error(\n      \"Core selected action protocol version 2 without an explicit client opt-in\",\n    );\n  }\n}\n\n/** Reject unsupported model-output versions, downgrades, and unsolicited v2 upgrades. */\nexport function validateModelOutputVersionSelection(\n  requestedVersion: 1 | 2 | undefined,\n  selectedVersion: unknown,\n): 1 | 2 {\n  if (\n    selectedVersion != null &&\n    selectedVersion !== 1 &&\n    selectedVersion !== 2\n  ) {\n    throw new Error(\n      `Core selected unsupported model output version: ${String(selectedVersion)}`,\n    );\n  }\n  if (requestedVersion === 2 && selectedVersion !== 2) {\n    throw new Error(\"Core did not select requested model output version 2\");\n  }\n  if (selectedVersion === 2 && requestedVersion !== 2) {\n    throw new Error(\n      \"Core selected model output version 2 without an explicit client opt-in\",\n    );\n  }\n\n  return selectedVersion === 2 ? 2 : 1;\n}\n\n/**\n * Build the lipsync part of the /connect request.\n *\n * Ahead-delivery changes the client contract because frames can arrive before\n * bot-started-speaking and cancellation must be handled with owner metadata.\n * It is the default now that server support is verified; callers can fall back\n * to the legacy paced path with deliver_chunks_ahead: false.\n */\nexport function buildBlendshapeConnectConfig(\n  config: Pick<ConvaiConfig, \"enableLipsync\" | \"blendshapeConfig\">,\n): BlendshapeConnectRequestConfig {\n  const deliverChunksAhead =\n    config.enableLipsync === true &&\n    config.blendshapeConfig?.deliver_chunks_ahead !== false;\n\n  return {\n    blendshape_provider: config.enableLipsync ? \"neurosync\" : \"not_provided\",\n    blendshape_config: {\n      enable_chunking: true,\n      chunk_size: 10,\n      format: config.blendshapeConfig?.format || \"mha\",\n      frames_buffer_duration:\n        config.blendshapeConfig?.frames_buffer_duration ?? 0.1,\n      // In the legacy paced path, output_fps is a delivery cadence and the SDK\n      // player keeps its 60fps visual timeline. Only ahead-delivery treats\n      // output_fps as a client-visible timeline override because chunks carry\n      // fps metadata.\n      output_fps: deliverChunksAhead\n        ? config.blendshapeConfig?.output_fps ?? 60\n        : 90,\n      ...(deliverChunksAhead ? { deliver_chunks_ahead: true } : {}),\n    },\n  };\n}\n\nexport function buildEmotionConnectConfig(\n  config: Pick<ConvaiConfig, \"enableEmotion\" | \"emotionConfig\">,\n): Record<string, unknown> | undefined {\n  if (config.enableEmotion !== true) return undefined;\n  const emotionConfig = config.emotionConfig;\n  if (emotionConfig?.provider === \"nrclex\") {\n    return {\n      provider: emotionConfig.provider,\n      min_word_threshold: emotionConfig.min_word_threshold ?? 3,\n      low_intensity_threshold: emotionConfig.low_intensity_threshold ?? 0.33,\n      high_intensity_threshold: emotionConfig.high_intensity_threshold ?? 0.66,\n    };\n  }\n  return { provider: emotionConfig?.provider ?? \"llm\" };\n}\n\n/** The `action_config` block as sent on the wire; tools are already serialized. */\nexport interface ActionConnectRequestConfig {\n  actions: string[];\n  characters: { name: string; bio: string }[];\n  objects: { name: string; description: string }[];\n  current_attention_object?: string;\n  tools?: ClientToolConnectRequestDeclaration[];\n}\n\nexport function buildActionConnectConfig(\n  config: Pick<ConvaiConfig, \"actionConfig\">,\n): ActionConnectRequestConfig | undefined {\n  const actionConfig = config.actionConfig;\n  if (!actionConfig) return undefined;\n  return {\n    actions: actionConfig.actions,\n    objects: actionConfig.objects,\n    characters: actionConfig.characters,\n    ...(actionConfig.current_attention_object && {\n      current_attention_object: actionConfig.current_attention_object,\n    }),\n    ...(actionConfig.tools && { tools: serializeClientTools(actionConfig.tools) }),\n  };\n}\n\n"]}

package/dist/core/index.d.ts

@@ -1,4 +1,4 @@
-export { ConvaiClient } from './ConvaiClient.js';
+export { ActionResultAckError, ConvaiClient } from './ConvaiClient.js';
 export * from './types.js';
 export { getDisconnectReasonMessage } from './types.js';
 export type { ConvaiClient as ConvaiClientType } from './ConvaiClient.js';
@@ -15,4 +15,6 @@ export { parseCharacterReference, resolveCharacterReference, isCharacterVersionS
 export { BlendshapeQueue } from './BlendshapeQueue.js';
 export type { TurnStats, BlendshapeChunkMetadata } from './BlendshapeQueue.js';
 export { EventEmitter } from './EventEmitter.js';
+export { ModelOutputExtensionRegistry, isJsonObject, isJsonValue, parseModelOutputMessage, } from './modelOutput.js';
+export type { ExtensionRenderResult, ModelOutputExtensionRenderer, } from './modelOutput.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAGrD,YAAY,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,8BAA8B,EAC9B,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAG5E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGpE,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAGrD,YAAY,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,8BAA8B,EAC9B,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAG5E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EACL,4BAA4B,EAC5B,YAAY,EACZ,WAAW,EACX,uBAAuB,GACxB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,eAAe,CAAC"}

package/dist/core/index.js

@@ -1,5 +1,5 @@
 // Main client
-export { ConvaiClient } from './ConvaiClient.js';
+export { ActionResultAckError, ConvaiClient } from './ConvaiClient.js';
 // Types (including IConvaiClient interface)
 export * from './types.js';
 // Helper functions
@@ -20,4 +20,5 @@ export { parseCharacterReference, resolveCharacterReference, isCharacterVersionS
 export { BlendshapeQueue } from './BlendshapeQueue.js';
 // Event Emitter (for advanced usage)
 export { EventEmitter } from './EventEmitter.js';
+export { ModelOutputExtensionRegistry, isJsonObject, isJsonValue, parseModelOutputMessage, } from './modelOutput.js';
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,4CAA4C;AAC5C,cAAc,SAAS,CAAC;AAExB,mBAAmB;AACnB,OAAO,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAKrD,gCAAgC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,8BAA8B,EAC9B,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,kDAAkD;AAClD,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAE9B,+BAA+B;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,qCAAqC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC","sourcesContent":["// Main client\nexport { ConvaiClient } from './ConvaiClient';\n\n// Types (including IConvaiClient interface)\nexport * from './types';\n\n// Helper functions\nexport { getDisconnectReasonMessage } from './types';\n\n// Type alias for easier usage\nexport type { ConvaiClient as ConvaiClientType } from './ConvaiClient';\n\n// Managers (for advanced usage)\nexport { AudioManager } from './AudioManager';\nexport { VideoManager } from './VideoManager';\nexport { ScreenShareManager } from './ScreenShareManager';\nexport { MessageHandler } from './MessageHandler';\nexport { MemoryManager } from './MemoryManager';\nexport { CharacterRoster } from './CharacterRoster';\nexport { ConvaiRoomError } from './ConvaiRoomError';\nexport {\n  MULTI_CHARACTER_MAX_CHARACTERS,\n  isRosterConfig,\n} from './rosterRequest';\nexport {\n  CharacterVersionManager,\n  CharacterApiError,\n  DEFAULT_CHARACTER_API_URL,\n} from './CharacterVersionManager';\n\n// Character reference helpers (version selectors)\nexport {\n  parseCharacterReference,\n  resolveCharacterReference,\n  isCharacterVersionSelector,\n  isCharacterUuid,\n} from './characterReference';\n\n// Blendshape queue for lipsync\nexport { BlendshapeQueue } from './BlendshapeQueue';\nexport type { TurnStats, BlendshapeChunkMetadata } from './BlendshapeQueue';\n\n// Event Emitter (for advanced usage)\nexport { EventEmitter } from './EventEmitter';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEpE,4CAA4C;AAC5C,cAAc,SAAS,CAAC;AAExB,mBAAmB;AACnB,OAAO,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAKrD,gCAAgC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,8BAA8B,EAC9B,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,kDAAkD;AAClD,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAE9B,+BAA+B;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,qCAAqC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EACL,4BAA4B,EAC5B,YAAY,EACZ,WAAW,EACX,uBAAuB,GACxB,MAAM,eAAe,CAAC","sourcesContent":["// Main client\nexport { ActionResultAckError, ConvaiClient } from './ConvaiClient';\n\n// Types (including IConvaiClient interface)\nexport * from './types';\n\n// Helper functions\nexport { getDisconnectReasonMessage } from './types';\n\n// Type alias for easier usage\nexport type { ConvaiClient as ConvaiClientType } from './ConvaiClient';\n\n// Managers (for advanced usage)\nexport { AudioManager } from './AudioManager';\nexport { VideoManager } from './VideoManager';\nexport { ScreenShareManager } from './ScreenShareManager';\nexport { MessageHandler } from './MessageHandler';\nexport { MemoryManager } from './MemoryManager';\nexport { CharacterRoster } from './CharacterRoster';\nexport { ConvaiRoomError } from './ConvaiRoomError';\nexport {\n  MULTI_CHARACTER_MAX_CHARACTERS,\n  isRosterConfig,\n} from './rosterRequest';\nexport {\n  CharacterVersionManager,\n  CharacterApiError,\n  DEFAULT_CHARACTER_API_URL,\n} from './CharacterVersionManager';\n\n// Character reference helpers (version selectors)\nexport {\n  parseCharacterReference,\n  resolveCharacterReference,\n  isCharacterVersionSelector,\n  isCharacterUuid,\n} from './characterReference';\n\n// Blendshape queue for lipsync\nexport { BlendshapeQueue } from './BlendshapeQueue';\nexport type { TurnStats, BlendshapeChunkMetadata } from './BlendshapeQueue';\n\n// Event Emitter (for advanced usage)\nexport { EventEmitter } from './EventEmitter';\n\nexport {\n  ModelOutputExtensionRegistry,\n  isJsonObject,\n  isJsonValue,\n  parseModelOutputMessage,\n} from './modelOutput';\nexport type {\n  ExtensionRenderResult,\n  ModelOutputExtensionRenderer,\n} from './modelOutput';\n"]}

package/dist/core/logicalTurn.d.ts

@@ -1,5 +1,8 @@
 /** Maximum wire size for a logical turn identifier, in UTF-8 bytes. */
 export declare const LOGICAL_TURN_ID_MAX_UTF8_BYTES = 128;
-/** Return whether a logical turn identifier is safe to place on the wire. */
+/** Maximum wire size for a model invocation identifier, in UTF-8 bytes. */
+export declare const OUTPUT_ID_MAX_UTF8_BYTES = 128;
 export declare function isValidLogicalTurnId(value: unknown): value is string;
+/** Return whether a Core model invocation id is safe to retain and expose. */
+export declare function isValidOutputId(value: unknown): value is string;
 //# sourceMappingURL=logicalTurn.d.ts.map

package/dist/core/logicalTurn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logicalTurn.d.ts","sourceRoot":"","sources":["../../src/core/logicalTurn.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAOpE"}
+{"version":3,"file":"logicalTurn.d.ts","sourceRoot":"","sources":["../../src/core/logicalTurn.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD,2EAA2E;AAC3E,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAoC5C,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAKpE;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE/D"}

package/dist/core/logicalTurn.js

@@ -1,10 +1,41 @@
 /** Maximum wire size for a logical turn identifier, in UTF-8 bytes. */
 export const LOGICAL_TURN_ID_MAX_UTF8_BYTES = 128;
-/** Return whether a logical turn identifier is safe to place on the wire. */
-export function isValidLogicalTurnId(value) {
+/** Maximum wire size for a model invocation identifier, in UTF-8 bytes. */
+export const OUTPUT_ID_MAX_UTF8_BYTES = 128;
+/** Reject lone UTF-16 surrogates instead of silently encoding U+FFFD. */
+function isWellFormedUtf16(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const codeUnit = value.charCodeAt(index);
+        if (codeUnit >= 0xd800 && codeUnit <= 0xdbff) {
+            const next = value.charCodeAt(index + 1);
+            if (!(next >= 0xdc00 && next <= 0xdfff))
+                return false;
+            index += 1;
+            continue;
+        }
+        if (codeUnit >= 0xdc00 && codeUnit <= 0xdfff)
+            return false;
+    }
+    return true;
+}
+/**
+ * Return whether a logical turn identifier is safe to place on the wire.
+ *
+ * Identifiers are preserved exactly. They must contain at least one
+ * non-whitespace character and fit within the bounded RTVI field.
+ */
+function isValidBoundedCorrelationId(value, maxUtf8Bytes) {
     return (typeof value === "string" &&
         value.trim().length > 0 &&
-        value.length <= LOGICAL_TURN_ID_MAX_UTF8_BYTES &&
-        new TextEncoder().encode(value).byteLength <= LOGICAL_TURN_ID_MAX_UTF8_BYTES);
+        isWellFormedUtf16(value) &&
+        value.length <= maxUtf8Bytes &&
+        new TextEncoder().encode(value).byteLength <= maxUtf8Bytes);
+}
+export function isValidLogicalTurnId(value) {
+    return isValidBoundedCorrelationId(value, LOGICAL_TURN_ID_MAX_UTF8_BYTES);
+}
+/** Return whether a Core model invocation id is safe to retain and expose. */
+export function isValidOutputId(value) {
+    return isValidBoundedCorrelationId(value, OUTPUT_ID_MAX_UTF8_BYTES);
 }
 //# sourceMappingURL=logicalTurn.js.map

package/dist/core/logicalTurn.js.map

@@ -1 +1 @@
-{"version":3,"file":"logicalTurn.js","sourceRoot":"","sources":["../../src/core/logicalTurn.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAElD,6EAA6E;AAC7E,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QACvB,KAAK,CAAC,MAAM,IAAI,8BAA8B;QAC9C,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,IAAI,8BAA8B,CAC7E,CAAC;AACJ,CAAC","sourcesContent":["/** Maximum wire size for a logical turn identifier, in UTF-8 bytes. */\nexport const LOGICAL_TURN_ID_MAX_UTF8_BYTES = 128;\n\n/** Return whether a logical turn identifier is safe to place on the wire. */\nexport function isValidLogicalTurnId(value: unknown): value is string {\n  return (\n    typeof value === \"string\" &&\n    value.trim().length > 0 &&\n    value.length <= LOGICAL_TURN_ID_MAX_UTF8_BYTES &&\n    new TextEncoder().encode(value).byteLength <= LOGICAL_TURN_ID_MAX_UTF8_BYTES\n  );\n}\n"]}
+{"version":3,"file":"logicalTurn.js","sourceRoot":"","sources":["../../src/core/logicalTurn.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAElD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAE5C,yEAAyE;AACzE,SAAS,iBAAiB,CAAC,KAAa;IACtC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,QAAQ,IAAI,MAAM,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACzC,IAAI,CAAC,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC;YACtD,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,QAAQ,IAAI,MAAM,IAAI,QAAQ,IAAI,MAAM;YAAE,OAAO,KAAK,CAAC;IAC7D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAS,2BAA2B,CAClC,KAAc,EACd,YAAoB;IAEpB,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QACvB,iBAAiB,CAAC,KAAK,CAAC;QACxB,KAAK,CAAC,MAAM,IAAI,YAAY;QAC5B,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,IAAI,YAAY,CAC3D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,2BAA2B,CAChC,KAAK,EACL,8BAA8B,CAC/B,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,2BAA2B,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;AACtE,CAAC","sourcesContent":["/** Maximum wire size for a logical turn identifier, in UTF-8 bytes. */\nexport const LOGICAL_TURN_ID_MAX_UTF8_BYTES = 128;\n\n/** Maximum wire size for a model invocation identifier, in UTF-8 bytes. */\nexport const OUTPUT_ID_MAX_UTF8_BYTES = 128;\n\n/** Reject lone UTF-16 surrogates instead of silently encoding U+FFFD. */\nfunction isWellFormedUtf16(value: string): boolean {\n  for (let index = 0; index < value.length; index += 1) {\n    const codeUnit = value.charCodeAt(index);\n    if (codeUnit >= 0xd800 && codeUnit <= 0xdbff) {\n      const next = value.charCodeAt(index + 1);\n      if (!(next >= 0xdc00 && next <= 0xdfff)) return false;\n      index += 1;\n      continue;\n    }\n    if (codeUnit >= 0xdc00 && codeUnit <= 0xdfff) return false;\n  }\n  return true;\n}\n\n/**\n * Return whether a logical turn identifier is safe to place on the wire.\n *\n * Identifiers are preserved exactly. They must contain at least one\n * non-whitespace character and fit within the bounded RTVI field.\n */\nfunction isValidBoundedCorrelationId(\n  value: unknown,\n  maxUtf8Bytes: number,\n): value is string {\n  return (\n    typeof value === \"string\" &&\n    value.trim().length > 0 &&\n    isWellFormedUtf16(value) &&\n    value.length <= maxUtf8Bytes &&\n    new TextEncoder().encode(value).byteLength <= maxUtf8Bytes\n  );\n}\n\nexport function isValidLogicalTurnId(value: unknown): value is string {\n  return isValidBoundedCorrelationId(\n    value,\n    LOGICAL_TURN_ID_MAX_UTF8_BYTES,\n  );\n}\n\n/** Return whether a Core model invocation id is safe to retain and expose. */\nexport function isValidOutputId(value: unknown): value is string {\n  return isValidBoundedCorrelationId(value, OUTPUT_ID_MAX_UTF8_BYTES);\n}\n"]}

package/dist/core/modelOutput.d.ts

@@ -0,0 +1,40 @@
+import type { JsonObject, ModelOutputExtensionItem, ModelOutputMessage } from "./types.js";
+/**
+ * Normalize canonical model-output delivery across transports.
+ *
+ * LiveKit delivers the RTVI frame as a top-level message with its payload in
+ * `data`; WebSocket delivery wraps that same payload in `server-message`.
+ */
+export declare function extractModelOutputPayload(value: unknown): unknown | undefined;
+export declare function isJsonValue(value: unknown, ancestors?: Set<unknown>): value is import("./types.js").JsonValue;
+export declare function isJsonObject(value: unknown): value is JsonObject;
+/**
+ * Validate a canonical Core model-output message.
+ *
+ * Unknown item types and malformed executable items fail the whole envelope
+ * closed. The exact `raw` field is never parsed to discover actions.
+ */
+export declare function parseModelOutputMessage(value: unknown): ModelOutputMessage | null;
+export type ExtensionRenderResult<T> = {
+    status: "rendered";
+    value: T;
+} | {
+    status: "fallback";
+    fallback: string;
+} | {
+    status: "unhandled";
+};
+export type ModelOutputExtensionRenderer<T> = (item: ModelOutputExtensionItem) => T;
+/**
+ * UI-framework-neutral registry for developer extension renderers.
+ *
+ * The SDK never evaluates extension payloads. Applications explicitly
+ * register a renderer for one schema/version pair and receive JSON data.
+ */
+export declare class ModelOutputExtensionRegistry<T> {
+    private readonly renderers;
+    register(schema: string, version: number, renderer: ModelOutputExtensionRenderer<T>): () => void;
+    render(item: ModelOutputExtensionItem): ExtensionRenderResult<T>;
+    private key;
+}
+//# sourceMappingURL=modelOutput.d.ts.map

package/dist/core/modelOutput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelOutput.d.ts","sourceRoot":"","sources":["../../src/core/modelOutput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,wBAAwB,EAExB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAcjB;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAe7E;AAUD,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,SAAS,GAAE,GAAG,CAAC,OAAO,CAAa,GAClC,KAAK,IAAI,OAAO,SAAS,EAAE,SAAS,CAmBtC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AA0DD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CA6CjF;AAED,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAC/B;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAChC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAE5B,MAAM,MAAM,4BAA4B,CAAC,CAAC,IAAI,CAC5C,IAAI,EAAE,wBAAwB,KAC3B,CAAC,CAAC;AAEP;;;;;GAKG;AACH,qBAAa,4BAA4B,CAAC,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAGtB;IAEJ,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,4BAA4B,CAAC,CAAC,CAAC,GACxC,MAAM,IAAI;IAWb,MAAM,CAAC,IAAI,EAAE,wBAAwB,GAAG,qBAAqB,CAAC,CAAC,CAAC;IAShE,OAAO,CAAC,GAAG;CAGZ"}

package/dist/core/modelOutput.js

@@ -0,0 +1,187 @@
+import { isValidLogicalTurnId, isValidOutputId, } from "./logicalTurn.js";
+function isRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+/**
+ * Normalize canonical model-output delivery across transports.
+ *
+ * LiveKit delivers the RTVI frame as a top-level message with its payload in
+ * `data`; WebSocket delivery wraps that same payload in `server-message`.
+ */
+export function extractModelOutputPayload(value) {
+    if (!isRecord(value))
+        return undefined;
+    if (value.type === "model-output") {
+        return isRecord(value.data)
+            ? { ...value.data, type: "model-output" }
+            : value;
+    }
+    if (value.type === "server-message" &&
+        isRecord(value.data) &&
+        value.data.type === "model-output") {
+        return value.data;
+    }
+    return undefined;
+}
+function isOptionalString(value) {
+    return value === undefined || value === null || typeof value === "string";
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+export function isJsonValue(value, ancestors = new Set()) {
+    if (value === null ||
+        typeof value === "string" ||
+        typeof value === "boolean") {
+        return true;
+    }
+    if (typeof value === "number")
+        return Number.isFinite(value);
+    if (typeof value !== "object")
+        return false;
+    if (ancestors.has(value))
+        return false;
+    ancestors.add(value);
+    const valid = Array.isArray(value)
+        ? value.every((item) => isJsonValue(item, ancestors))
+        : isRecord(value) &&
+            Object.values(value).every((item) => isJsonValue(item, ancestors));
+    ancestors.delete(value);
+    return valid;
+}
+export function isJsonObject(value) {
+    return isRecord(value) && isJsonValue(value);
+}
+function parseModelOutputItem(value) {
+    if (!isRecord(value) || typeof value.type !== "string")
+        return null;
+    switch (value.type) {
+        case "message":
+            if (value.role !== "assistant" ||
+                (value.channel !== "final" && value.channel !== "commentary") ||
+                typeof value.content !== "string") {
+                return null;
+            }
+            return value;
+        case "emotion":
+            if (!isNonEmptyString(value.name) ||
+                (value.scale !== 1 && value.scale !== 2 && value.scale !== 3)) {
+                return null;
+            }
+            return value;
+        case "semantic_action":
+            if (!isNonEmptyString(value.id) ||
+                !isNonEmptyString(value.name) ||
+                !isOptionalString(value.target)) {
+                return null;
+            }
+            return value;
+        case "tool_call":
+            if (!isNonEmptyString(value.id) ||
+                !isNonEmptyString(value.name) ||
+                !isOptionalString(value.target) ||
+                !isJsonObject(value.arguments)) {
+                return null;
+            }
+            return value;
+        case "extension":
+            if (!isNonEmptyString(value.schema) ||
+                !Number.isInteger(value.version) ||
+                value.version < 1 ||
+                !isJsonObject(value.payload) ||
+                !isOptionalString(value.fallback)) {
+                return null;
+            }
+            return value;
+        default:
+            return null;
+    }
+}
+/**
+ * Validate a canonical Core model-output message.
+ *
+ * Unknown item types and malformed executable items fail the whole envelope
+ * closed. The exact `raw` field is never parsed to discover actions.
+ */
+export function parseModelOutputMessage(value) {
+    const hasLogicalTurnId = isRecord(value) &&
+        Object.prototype.hasOwnProperty.call(value, "logical_turn_id");
+    if (!isRecord(value) ||
+        value.type !== "model-output" ||
+        value.version !== 2 ||
+        !isValidOutputId(value.output_id) ||
+        (hasLogicalTurnId && !isValidLogicalTurnId(value.logical_turn_id)) ||
+        ![
+            "text",
+            "convai-combined-json",
+            "semantic-actions-json",
+            "client-tool-calls-json",
+        ].includes(value.format) ||
+        typeof value.raw !== "string" ||
+        value.final !== true ||
+        !Array.isArray(value.items)) {
+        return null;
+    }
+    const items = value.items.map(parseModelOutputItem);
+    if (items.some((item) => item === null))
+        return null;
+    const actionItemIds = new Set();
+    for (const item of items) {
+        if (item.type !== "semantic_action" && item.type !== "tool_call")
+            continue;
+        if (actionItemIds.has(item.id))
+            return null;
+        actionItemIds.add(item.id);
+    }
+    return {
+        type: "model-output",
+        version: 2,
+        output_id: value.output_id,
+        ...(hasLogicalTurnId && {
+            logical_turn_id: value.logical_turn_id,
+        }),
+        format: value.format,
+        raw: value.raw,
+        items: items,
+        final: true,
+    };
+}
+/**
+ * UI-framework-neutral registry for developer extension renderers.
+ *
+ * The SDK never evaluates extension payloads. Applications explicitly
+ * register a renderer for one schema/version pair and receive JSON data.
+ */
+export class ModelOutputExtensionRegistry {
+    constructor() {
+        this.renderers = new Map();
+    }
+    register(schema, version, renderer) {
+        if (!schema.trim() || !Number.isInteger(version) || version < 1) {
+            throw new Error("Extension schema and positive integer version are required");
+        }
+        const key = this.key(schema, version);
+        this.renderers.set(key, renderer);
+        return () => {
+            if (this.renderers.get(key) === renderer)
+                this.renderers.delete(key);
+        };
+    }
+    render(item) {
+        const renderer = this.renderers.get(this.key(item.schema, item.version));
+        if (renderer)
+            return { status: "rendered", value: renderer(item) };
+        if (item.fallback !== null && item.fallback !== undefined) {
+            return { status: "fallback", fallback: item.fallback };
+        }
+        return { status: "unhandled" };
+    }
+    key(schema, version) {
+        return `${schema}@${version}`;
+    }
+}
+//# sourceMappingURL=modelOutput.js.map

package/dist/core/modelOutput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelOutput.js","sourceRoot":"","sources":["../../src/core/modelOutput.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  JsonObject,\n  ModelOutputExtensionItem,\n  ModelOutputItem,\n  ModelOutputMessage,\n} from \"./types\";\nimport {\n  isValidLogicalTurnId,\n  isValidOutputId,\n} from \"./logicalTurn.js\";\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return false;\n  }\n  const prototype = Object.getPrototypeOf(value);\n  return prototype === Object.prototype || prototype === null;\n}\n\n/**\n * Normalize canonical model-output delivery across transports.\n *\n * LiveKit delivers the RTVI frame as a top-level message with its payload in\n * `data`; WebSocket delivery wraps that same payload in `server-message`.\n */\nexport function extractModelOutputPayload(value: unknown): unknown | undefined {\n  if (!isRecord(value)) return undefined;\n  if (value.type === \"model-output\") {\n    return isRecord(value.data)\n      ? { ...value.data, type: \"model-output\" }\n      : value;\n  }\n  if (\n    value.type === \"server-message\" &&\n    isRecord(value.data) &&\n    value.data.type === \"model-output\"\n  ) {\n    return value.data;\n  }\n  return undefined;\n}\n\nfunction isOptionalString(value: unknown): value is string | null | undefined {\n  return value === undefined || value === null || typeof value === \"string\";\n}\n\nfunction isNonEmptyString(value: unknown): value is string {\n  return typeof value === \"string\" && value.trim().length > 0;\n}\n\nexport function isJsonValue(\n  value: unknown,\n  ancestors: Set<unknown> = new Set(),\n): value is import(\"./types\").JsonValue {\n  if (\n    value === null ||\n    typeof value === \"string\" ||\n    typeof value === \"boolean\"\n  ) {\n    return true;\n  }\n  if (typeof value === \"number\") return Number.isFinite(value);\n  if (typeof value !== \"object\") return false;\n  if (ancestors.has(value)) return false;\n\n  ancestors.add(value);\n  const valid = Array.isArray(value)\n    ? value.every((item) => isJsonValue(item, ancestors))\n    : isRecord(value) &&\n      Object.values(value).every((item) => isJsonValue(item, ancestors));\n  ancestors.delete(value);\n  return valid;\n}\n\nexport function isJsonObject(value: unknown): value is JsonObject {\n  return isRecord(value) && isJsonValue(value);\n}\n\nfunction parseModelOutputItem(value: unknown): ModelOutputItem | null {\n  if (!isRecord(value) || typeof value.type !== \"string\") return null;\n\n  switch (value.type) {\n    case \"message\":\n      if (\n        value.role !== \"assistant\" ||\n        (value.channel !== \"final\" && value.channel !== \"commentary\") ||\n        typeof value.content !== \"string\"\n      ) {\n        return null;\n      }\n      return value as unknown as ModelOutputItem;\n    case \"emotion\":\n      if (\n        !isNonEmptyString(value.name) ||\n        (value.scale !== 1 && value.scale !== 2 && value.scale !== 3)\n      ) {\n        return null;\n      }\n      return value as unknown as ModelOutputItem;\n    case \"semantic_action\":\n      if (\n        !isNonEmptyString(value.id) ||\n        !isNonEmptyString(value.name) ||\n        !isOptionalString(value.target)\n      ) {\n        return null;\n      }\n      return value as unknown as ModelOutputItem;\n    case \"tool_call\":\n      if (\n        !isNonEmptyString(value.id) ||\n        !isNonEmptyString(value.name) ||\n        !isOptionalString(value.target) ||\n        !isJsonObject(value.arguments)\n      ) {\n        return null;\n      }\n      return value as unknown as ModelOutputItem;\n    case \"extension\":\n      if (\n        !isNonEmptyString(value.schema) ||\n        !Number.isInteger(value.version) ||\n        (value.version as number) < 1 ||\n        !isJsonObject(value.payload) ||\n        !isOptionalString(value.fallback)\n      ) {\n        return null;\n      }\n      return value as unknown as ModelOutputItem;\n    default:\n      return null;\n  }\n}\n\n/**\n * Validate a canonical Core model-output message.\n *\n * Unknown item types and malformed executable items fail the whole envelope\n * closed. The exact `raw` field is never parsed to discover actions.\n */\nexport function parseModelOutputMessage(value: unknown): ModelOutputMessage | null {\n  const hasLogicalTurnId =\n    isRecord(value) &&\n    Object.prototype.hasOwnProperty.call(value, \"logical_turn_id\");\n  if (\n    !isRecord(value) ||\n    value.type !== \"model-output\" ||\n    value.version !== 2 ||\n    !isValidOutputId(value.output_id) ||\n    (hasLogicalTurnId && !isValidLogicalTurnId(value.logical_turn_id)) ||\n    ![\n      \"text\",\n      \"convai-combined-json\",\n      \"semantic-actions-json\",\n      \"client-tool-calls-json\",\n    ].includes(value.format as string) ||\n    typeof value.raw !== \"string\" ||\n    value.final !== true ||\n    !Array.isArray(value.items)\n  ) {\n    return null;\n  }\n\n  const items = value.items.map(parseModelOutputItem);\n  if (items.some((item) => item === null)) return null;\n\n  const actionItemIds = new Set<string>();\n  for (const item of items as ModelOutputItem[]) {\n    if (item.type !== \"semantic_action\" && item.type !== \"tool_call\") continue;\n    if (actionItemIds.has(item.id)) return null;\n    actionItemIds.add(item.id);\n  }\n\n  return {\n    type: \"model-output\",\n    version: 2,\n    output_id: value.output_id,\n    ...(hasLogicalTurnId && {\n      logical_turn_id: value.logical_turn_id as string,\n    }),\n    format: value.format as ModelOutputMessage[\"format\"],\n    raw: value.raw,\n    items: items as ModelOutputItem[],\n    final: true,\n  };\n}\n\nexport type ExtensionRenderResult<T> =\n  | { status: \"rendered\"; value: T }\n  | { status: \"fallback\"; fallback: string }\n  | { status: \"unhandled\" };\n\nexport type ModelOutputExtensionRenderer<T> = (\n  item: ModelOutputExtensionItem,\n) => T;\n\n/**\n * UI-framework-neutral registry for developer extension renderers.\n *\n * The SDK never evaluates extension payloads. Applications explicitly\n * register a renderer for one schema/version pair and receive JSON data.\n */\nexport class ModelOutputExtensionRegistry<T> {\n  private readonly renderers = new Map<\n    string,\n    ModelOutputExtensionRenderer<T>\n  >();\n\n  register(\n    schema: string,\n    version: number,\n    renderer: ModelOutputExtensionRenderer<T>,\n  ): () => void {\n    if (!schema.trim() || !Number.isInteger(version) || version < 1) {\n      throw new Error(\"Extension schema and positive integer version are required\");\n    }\n    const key = this.key(schema, version);\n    this.renderers.set(key, renderer);\n    return () => {\n      if (this.renderers.get(key) === renderer) this.renderers.delete(key);\n    };\n  }\n\n  render(item: ModelOutputExtensionItem): ExtensionRenderResult<T> {\n    const renderer = this.renderers.get(this.key(item.schema, item.version));\n    if (renderer) return { status: \"rendered\", value: renderer(item) };\n    if (item.fallback !== null && item.fallback !== undefined) {\n      return { status: \"fallback\", fallback: item.fallback };\n    }\n    return { status: \"unhandled\" };\n  }\n\n  private key(schema: string, version: number): string {\n    return `${schema}@${version}`;\n  }\n}\n"]}

package/dist/core/publishedChat.d.ts

@@ -0,0 +1,9 @@
+import type { PublishedChatConnectOptions } from "./types.js";
+/**
+ * A widget obtains a new one-time launch token for every fresh session. An
+ * attempt id may only be reused while retrying that same token, which
+ * ConvaiClient handles internally. Preserve transport options but deliberately
+ * omit any caller-supplied id at this higher-level session boundary.
+ */
+export declare function freshPublicationGrantOptions(options?: PublishedChatConnectOptions): PublishedChatConnectOptions | undefined;
+//# sourceMappingURL=publishedChat.d.ts.map

package/dist/core/publishedChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publishedChat.d.ts","sourceRoot":"","sources":["../../src/core/publishedChat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,CAAC,EAAE,2BAA2B,GACpC,2BAA2B,GAAG,SAAS,CAKzC"}

package/dist/core/publishedChat.js

@@ -0,0 +1,13 @@
+/**
+ * A widget obtains a new one-time launch token for every fresh session. An
+ * attempt id may only be reused while retrying that same token, which
+ * ConvaiClient handles internally. Preserve transport options but deliberately
+ * omit any caller-supplied id at this higher-level session boundary.
+ */
+export function freshPublicationGrantOptions(options) {
+    if (!options)
+        return undefined;
+    const { connectAttemptId: _staleAttemptId, ...freshOptions } = options;
+    return freshOptions;
+}
+//# sourceMappingURL=publishedChat.js.map

package/dist/core/publishedChat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publishedChat.js","sourceRoot":"","sources":["../../src/core/publishedChat.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,OAAqC;IAErC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAE/B,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IACvE,OAAO,YAAY,CAAC;AACtB,CAAC","sourcesContent":["import type { PublishedChatConnectOptions } from \"./types\";\n\n/**\n * A widget obtains a new one-time launch token for every fresh session. An\n * attempt id may only be reused while retrying that same token, which\n * ConvaiClient handles internally. Preserve transport options but deliberately\n * omit any caller-supplied id at this higher-level session boundary.\n */\nexport function freshPublicationGrantOptions(\n  options?: PublishedChatConnectOptions,\n): PublishedChatConnectOptions | undefined {\n  if (!options) return undefined;\n\n  const { connectAttemptId: _staleAttemptId, ...freshOptions } = options;\n  return freshOptions;\n}\n"]}