@xpert-ai/chatkit-types 0.2.3 → 0.3.1

package/dist/constants.cjs

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+var ChatMessageTypeEnum = /* @__PURE__ */ ((ChatMessageTypeEnum2) => {
+  ChatMessageTypeEnum2["MESSAGE"] = "message";
+  ChatMessageTypeEnum2["EVENT"] = "event";
+  return ChatMessageTypeEnum2;
+})(ChatMessageTypeEnum || {});
+var ChatMessageEventTypeEnum = /* @__PURE__ */ ((ChatMessageEventTypeEnum2) => {
+  ChatMessageEventTypeEnum2["ON_CONVERSATION_START"] = "on_conversation_start";
+  ChatMessageEventTypeEnum2["ON_CONVERSATION_END"] = "on_conversation_end";
+  ChatMessageEventTypeEnum2["ON_MESSAGE_START"] = "on_message_start";
+  ChatMessageEventTypeEnum2["ON_MESSAGE_END"] = "on_message_end";
+  ChatMessageEventTypeEnum2["ON_TOOL_START"] = "on_tool_start";
+  ChatMessageEventTypeEnum2["ON_TOOL_END"] = "on_tool_end";
+  ChatMessageEventTypeEnum2["ON_TOOL_ERROR"] = "on_tool_error";
+  ChatMessageEventTypeEnum2["ON_TOOL_MESSAGE"] = "on_tool_message";
+  ChatMessageEventTypeEnum2["ON_AGENT_START"] = "on_agent_start";
+  ChatMessageEventTypeEnum2["ON_AGENT_END"] = "on_agent_end";
+  ChatMessageEventTypeEnum2["ON_RETRIEVER_START"] = "on_retriever_start";
+  ChatMessageEventTypeEnum2["ON_RETRIEVER_END"] = "on_retriever_end";
+  ChatMessageEventTypeEnum2["ON_RETRIEVER_ERROR"] = "on_retriever_error";
+  ChatMessageEventTypeEnum2["ON_INTERRUPT"] = "on_interrupt";
+  ChatMessageEventTypeEnum2["ON_ERROR"] = "on_error";
+  ChatMessageEventTypeEnum2["ON_CHAT_EVENT"] = "on_chat_event";
+  ChatMessageEventTypeEnum2["ON_CLIENT_EFFECT"] = "on_client_effect";
+  return ChatMessageEventTypeEnum2;
+})(ChatMessageEventTypeEnum || {});
+var ChatMessageStepCategory = /* @__PURE__ */ ((ChatMessageStepCategory2) => {
+  ChatMessageStepCategory2["List"] = "list";
+  ChatMessageStepCategory2["WebSearch"] = "web_search";
+  ChatMessageStepCategory2["Files"] = "files";
+  ChatMessageStepCategory2["File"] = "file";
+  ChatMessageStepCategory2["Program"] = "program";
+  ChatMessageStepCategory2["Iframe"] = "iframe";
+  ChatMessageStepCategory2["Memory"] = "memory";
+  ChatMessageStepCategory2["Tasks"] = "tasks";
+  ChatMessageStepCategory2["Knowledges"] = "knowledges";
+  return ChatMessageStepCategory2;
+})(ChatMessageStepCategory || {});
+const STATE_VARIABLE_HUMAN = "human";
+const CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED = "follow_up_consumed";
+exports.CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED = CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED;
+exports.ChatMessageEventTypeEnum = ChatMessageEventTypeEnum;
+exports.ChatMessageStepCategory = ChatMessageStepCategory;
+exports.ChatMessageTypeEnum = ChatMessageTypeEnum;
+exports.STATE_VARIABLE_HUMAN = STATE_VARIABLE_HUMAN;
+//# sourceMappingURL=constants.cjs.map

package/dist/constants.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.cjs","sources":["../src/constants.ts"],"sourcesContent":["export enum ChatMessageTypeEnum {\n  // LOG = 'log',\n  MESSAGE = 'message',\n  EVENT = 'event',\n}\n\n/**\n * https://js.langchain.com/docs/how_to/streaming/#event-reference\n */\nexport enum ChatMessageEventTypeEnum {\n  ON_CONVERSATION_START = 'on_conversation_start',\n  ON_CONVERSATION_END = 'on_conversation_end',\n  ON_MESSAGE_START = 'on_message_start',\n  ON_MESSAGE_END = 'on_message_end',\n  ON_TOOL_START = 'on_tool_start',\n  ON_TOOL_END = 'on_tool_end',\n  ON_TOOL_ERROR = 'on_tool_error',\n  /**\n   * Step message in tool call\n   */\n  ON_TOOL_MESSAGE = 'on_tool_message',\n  ON_AGENT_START = 'on_agent_start',\n  ON_AGENT_END = 'on_agent_end',\n  ON_RETRIEVER_START = 'on_retriever_start',\n  ON_RETRIEVER_END = 'on_retriever_end',\n  ON_RETRIEVER_ERROR = 'on_retriever_error',\n  ON_INTERRUPT = 'on_interrupt',\n  ON_ERROR = 'on_error',\n  ON_CHAT_EVENT = 'on_chat_event',\n\n  ON_CLIENT_EFFECT = 'on_client_effect',\n}\n\n/**\n * Category of step message: determines the display components of computer use\n */\nexport enum ChatMessageStepCategory {\n  /**\n   * List of items: urls, files, etc.\n   */\n  List = 'list',\n  /**\n   * Websearch results\n   */\n  WebSearch = 'web_search',\n  /**\n   * Files list\n   */\n  Files = 'files',\n  /**\n   * View a file\n   */\n  File = 'file',\n  /**\n   * Program Execution\n   */\n  Program = 'program',\n  /**\n   * Iframe\n   */\n  Iframe = 'iframe',\n\n  Memory = 'memory',\n\n  Tasks = 'tasks',\n\n  /**\n   * Knowledges (knowledge base retriever results)\n   */\n  Knowledges = 'knowledges',\n}\n\nexport const STATE_VARIABLE_HUMAN = 'human';\n\nexport const CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED =\n  'follow_up_consumed' as const;\n"],"names":["ChatMessageTypeEnum","ChatMessageEventTypeEnum","ChatMessageStepCategory"],"mappings":";;AAAO,IAAK,wCAAAA,yBAAL;AAELA,uBAAA,SAAA,IAAU;AACVA,uBAAA,OAAA,IAAQ;AAHE,SAAAA;AAAA,GAAA,uBAAA,CAAA,CAAA;AASL,IAAK,6CAAAC,8BAAL;AACLA,4BAAA,uBAAA,IAAwB;AACxBA,4BAAA,qBAAA,IAAsB;AACtBA,4BAAA,kBAAA,IAAmB;AACnBA,4BAAA,gBAAA,IAAiB;AACjBA,4BAAA,eAAA,IAAgB;AAChBA,4BAAA,aAAA,IAAc;AACdA,4BAAA,eAAA,IAAgB;AAIhBA,4BAAA,iBAAA,IAAkB;AAClBA,4BAAA,gBAAA,IAAiB;AACjBA,4BAAA,cAAA,IAAe;AACfA,4BAAA,oBAAA,IAAqB;AACrBA,4BAAA,kBAAA,IAAmB;AACnBA,4BAAA,oBAAA,IAAqB;AACrBA,4BAAA,cAAA,IAAe;AACfA,4BAAA,UAAA,IAAW;AACXA,4BAAA,eAAA,IAAgB;AAEhBA,4BAAA,kBAAA,IAAmB;AArBT,SAAAA;AAAA,GAAA,4BAAA,CAAA,CAAA;AA2BL,IAAK,4CAAAC,6BAAL;AAILA,2BAAA,MAAA,IAAO;AAIPA,2BAAA,WAAA,IAAY;AAIZA,2BAAA,OAAA,IAAQ;AAIRA,2BAAA,MAAA,IAAO;AAIPA,2BAAA,SAAA,IAAU;AAIVA,2BAAA,QAAA,IAAS;AAETA,2BAAA,QAAA,IAAS;AAETA,2BAAA,OAAA,IAAQ;AAKRA,2BAAA,YAAA,IAAa;AAjCH,SAAAA;AAAA,GAAA,2BAAA,CAAA,CAAA;AAoCL,MAAM,uBAAuB;AAE7B,MAAM,qCACX;;;;;;"}

package/dist/constants.d.ts

@@ -0,0 +1,72 @@
+export declare const CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED: "follow_up_consumed";
+
+/**
+ * https://js.langchain.com/docs/how_to/streaming/#event-reference
+ */
+export declare enum ChatMessageEventTypeEnum {
+    ON_CONVERSATION_START = "on_conversation_start",
+    ON_CONVERSATION_END = "on_conversation_end",
+    ON_MESSAGE_START = "on_message_start",
+    ON_MESSAGE_END = "on_message_end",
+    ON_TOOL_START = "on_tool_start",
+    ON_TOOL_END = "on_tool_end",
+    ON_TOOL_ERROR = "on_tool_error",
+    /**
+     * Step message in tool call
+     */
+    ON_TOOL_MESSAGE = "on_tool_message",
+    ON_AGENT_START = "on_agent_start",
+    ON_AGENT_END = "on_agent_end",
+    ON_RETRIEVER_START = "on_retriever_start",
+    ON_RETRIEVER_END = "on_retriever_end",
+    ON_RETRIEVER_ERROR = "on_retriever_error",
+    ON_INTERRUPT = "on_interrupt",
+    ON_ERROR = "on_error",
+    ON_CHAT_EVENT = "on_chat_event",
+    ON_CLIENT_EFFECT = "on_client_effect"
+}
+
+/**
+ * Category of step message: determines the display components of computer use
+ */
+export declare enum ChatMessageStepCategory {
+    /**
+     * List of items: urls, files, etc.
+     */
+    List = "list",
+    /**
+     * Websearch results
+     */
+    WebSearch = "web_search",
+    /**
+     * Files list
+     */
+    Files = "files",
+    /**
+     * View a file
+     */
+    File = "file",
+    /**
+     * Program Execution
+     */
+    Program = "program",
+    /**
+     * Iframe
+     */
+    Iframe = "iframe",
+    Memory = "memory",
+    Tasks = "tasks",
+    /**
+     * Knowledges (knowledge base retriever results)
+     */
+    Knowledges = "knowledges"
+}
+
+export declare enum ChatMessageTypeEnum {
+    MESSAGE = "message",
+    EVENT = "event"
+}
+
+export declare const STATE_VARIABLE_HUMAN = "human";
+
+export { }

package/dist/constants.js

@@ -0,0 +1,47 @@
+var ChatMessageTypeEnum = /* @__PURE__ */ ((ChatMessageTypeEnum2) => {
+  ChatMessageTypeEnum2["MESSAGE"] = "message";
+  ChatMessageTypeEnum2["EVENT"] = "event";
+  return ChatMessageTypeEnum2;
+})(ChatMessageTypeEnum || {});
+var ChatMessageEventTypeEnum = /* @__PURE__ */ ((ChatMessageEventTypeEnum2) => {
+  ChatMessageEventTypeEnum2["ON_CONVERSATION_START"] = "on_conversation_start";
+  ChatMessageEventTypeEnum2["ON_CONVERSATION_END"] = "on_conversation_end";
+  ChatMessageEventTypeEnum2["ON_MESSAGE_START"] = "on_message_start";
+  ChatMessageEventTypeEnum2["ON_MESSAGE_END"] = "on_message_end";
+  ChatMessageEventTypeEnum2["ON_TOOL_START"] = "on_tool_start";
+  ChatMessageEventTypeEnum2["ON_TOOL_END"] = "on_tool_end";
+  ChatMessageEventTypeEnum2["ON_TOOL_ERROR"] = "on_tool_error";
+  ChatMessageEventTypeEnum2["ON_TOOL_MESSAGE"] = "on_tool_message";
+  ChatMessageEventTypeEnum2["ON_AGENT_START"] = "on_agent_start";
+  ChatMessageEventTypeEnum2["ON_AGENT_END"] = "on_agent_end";
+  ChatMessageEventTypeEnum2["ON_RETRIEVER_START"] = "on_retriever_start";
+  ChatMessageEventTypeEnum2["ON_RETRIEVER_END"] = "on_retriever_end";
+  ChatMessageEventTypeEnum2["ON_RETRIEVER_ERROR"] = "on_retriever_error";
+  ChatMessageEventTypeEnum2["ON_INTERRUPT"] = "on_interrupt";
+  ChatMessageEventTypeEnum2["ON_ERROR"] = "on_error";
+  ChatMessageEventTypeEnum2["ON_CHAT_EVENT"] = "on_chat_event";
+  ChatMessageEventTypeEnum2["ON_CLIENT_EFFECT"] = "on_client_effect";
+  return ChatMessageEventTypeEnum2;
+})(ChatMessageEventTypeEnum || {});
+var ChatMessageStepCategory = /* @__PURE__ */ ((ChatMessageStepCategory2) => {
+  ChatMessageStepCategory2["List"] = "list";
+  ChatMessageStepCategory2["WebSearch"] = "web_search";
+  ChatMessageStepCategory2["Files"] = "files";
+  ChatMessageStepCategory2["File"] = "file";
+  ChatMessageStepCategory2["Program"] = "program";
+  ChatMessageStepCategory2["Iframe"] = "iframe";
+  ChatMessageStepCategory2["Memory"] = "memory";
+  ChatMessageStepCategory2["Tasks"] = "tasks";
+  ChatMessageStepCategory2["Knowledges"] = "knowledges";
+  return ChatMessageStepCategory2;
+})(ChatMessageStepCategory || {});
+const STATE_VARIABLE_HUMAN = "human";
+const CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED = "follow_up_consumed";
+export {
+  CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED,
+  ChatMessageEventTypeEnum,
+  ChatMessageStepCategory,
+  ChatMessageTypeEnum,
+  STATE_VARIABLE_HUMAN
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sources":["../src/constants.ts"],"sourcesContent":["export enum ChatMessageTypeEnum {\n  // LOG = 'log',\n  MESSAGE = 'message',\n  EVENT = 'event',\n}\n\n/**\n * https://js.langchain.com/docs/how_to/streaming/#event-reference\n */\nexport enum ChatMessageEventTypeEnum {\n  ON_CONVERSATION_START = 'on_conversation_start',\n  ON_CONVERSATION_END = 'on_conversation_end',\n  ON_MESSAGE_START = 'on_message_start',\n  ON_MESSAGE_END = 'on_message_end',\n  ON_TOOL_START = 'on_tool_start',\n  ON_TOOL_END = 'on_tool_end',\n  ON_TOOL_ERROR = 'on_tool_error',\n  /**\n   * Step message in tool call\n   */\n  ON_TOOL_MESSAGE = 'on_tool_message',\n  ON_AGENT_START = 'on_agent_start',\n  ON_AGENT_END = 'on_agent_end',\n  ON_RETRIEVER_START = 'on_retriever_start',\n  ON_RETRIEVER_END = 'on_retriever_end',\n  ON_RETRIEVER_ERROR = 'on_retriever_error',\n  ON_INTERRUPT = 'on_interrupt',\n  ON_ERROR = 'on_error',\n  ON_CHAT_EVENT = 'on_chat_event',\n\n  ON_CLIENT_EFFECT = 'on_client_effect',\n}\n\n/**\n * Category of step message: determines the display components of computer use\n */\nexport enum ChatMessageStepCategory {\n  /**\n   * List of items: urls, files, etc.\n   */\n  List = 'list',\n  /**\n   * Websearch results\n   */\n  WebSearch = 'web_search',\n  /**\n   * Files list\n   */\n  Files = 'files',\n  /**\n   * View a file\n   */\n  File = 'file',\n  /**\n   * Program Execution\n   */\n  Program = 'program',\n  /**\n   * Iframe\n   */\n  Iframe = 'iframe',\n\n  Memory = 'memory',\n\n  Tasks = 'tasks',\n\n  /**\n   * Knowledges (knowledge base retriever results)\n   */\n  Knowledges = 'knowledges',\n}\n\nexport const STATE_VARIABLE_HUMAN = 'human';\n\nexport const CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED =\n  'follow_up_consumed' as const;\n"],"names":["ChatMessageTypeEnum","ChatMessageEventTypeEnum","ChatMessageStepCategory"],"mappings":"AAAO,IAAK,wCAAAA,yBAAL;AAELA,uBAAA,SAAA,IAAU;AACVA,uBAAA,OAAA,IAAQ;AAHE,SAAAA;AAAA,GAAA,uBAAA,CAAA,CAAA;AASL,IAAK,6CAAAC,8BAAL;AACLA,4BAAA,uBAAA,IAAwB;AACxBA,4BAAA,qBAAA,IAAsB;AACtBA,4BAAA,kBAAA,IAAmB;AACnBA,4BAAA,gBAAA,IAAiB;AACjBA,4BAAA,eAAA,IAAgB;AAChBA,4BAAA,aAAA,IAAc;AACdA,4BAAA,eAAA,IAAgB;AAIhBA,4BAAA,iBAAA,IAAkB;AAClBA,4BAAA,gBAAA,IAAiB;AACjBA,4BAAA,cAAA,IAAe;AACfA,4BAAA,oBAAA,IAAqB;AACrBA,4BAAA,kBAAA,IAAmB;AACnBA,4BAAA,oBAAA,IAAqB;AACrBA,4BAAA,cAAA,IAAe;AACfA,4BAAA,UAAA,IAAW;AACXA,4BAAA,eAAA,IAAgB;AAEhBA,4BAAA,kBAAA,IAAmB;AArBT,SAAAA;AAAA,GAAA,4BAAA,CAAA,CAAA;AA2BL,IAAK,4CAAAC,6BAAL;AAILA,2BAAA,MAAA,IAAO;AAIPA,2BAAA,WAAA,IAAY;AAIZA,2BAAA,OAAA,IAAQ;AAIRA,2BAAA,MAAA,IAAO;AAIPA,2BAAA,SAAA,IAAU;AAIVA,2BAAA,QAAA,IAAS;AAETA,2BAAA,QAAA,IAAS;AAETA,2BAAA,OAAA,IAAQ;AAKRA,2BAAA,YAAA,IAAa;AAjCH,SAAAA;AAAA,GAAA,2BAAA,CAAA,CAAA;AAoCL,MAAM,uBAAuB;AAE7B,MAAM,qCACX;"}

package/dist/index.cjs

@@ -0,0 +1,448 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const constants = require("./constants.cjs");
+require("@langchain/core/messages/tool");
+const REQUEST_USER_INPUT_TOOL_NAME = "request_user_input";
+const REQUEST_USER_INPUT_RESULT_TYPE = "request_user_input_result";
+const REQUEST_USER_INPUT_RESULT_PURPOSE_PLAN_CLARIFICATION = "plan_clarification";
+const REQUEST_USER_INPUT_RESULT_PURPOSE_IMPLEMENTATION_CONFIRMATION = "implementation_confirmation";
+const HITL_DECISION_TYPES = [
+  "approve",
+  "edit",
+  "reject",
+  "respond"
+];
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function readRecordField(value, ...keys) {
+  for (const key of keys) {
+    const field = value[key];
+    if (isRecord(field)) return field;
+  }
+  return null;
+}
+function readArrayField(value, ...keys) {
+  for (const key of keys) {
+    const field = value[key];
+    if (Array.isArray(field)) return field;
+  }
+  return null;
+}
+function readStringField(value, ...keys) {
+  for (const key of keys) {
+    const field = value[key];
+    if (typeof field === "string" && field.trim()) return field;
+  }
+  return null;
+}
+function isHITLDecisionType(value) {
+  return typeof value === "string" && HITL_DECISION_TYPES.includes(value);
+}
+function normalizeHITLActionRequest(value) {
+  if (!isRecord(value)) return null;
+  const name = readStringField(value, "name");
+  const args = readRecordField(value, "args", "arguments");
+  if (!name || !args) return null;
+  const description = typeof value.description === "string" ? value.description : void 0;
+  return {
+    name,
+    args,
+    ...description !== void 0 ? { description } : {}
+  };
+}
+function normalizeHITLReviewConfig(value) {
+  if (!isRecord(value)) return null;
+  const actionName = readStringField(value, "actionName", "action_name");
+  const allowedDecisions = readArrayField(
+    value,
+    "allowedDecisions",
+    "allowed_decisions"
+  );
+  if (!actionName || !allowedDecisions) return null;
+  const normalizedDecisions = allowedDecisions.filter(isHITLDecisionType);
+  if (normalizedDecisions.length !== allowedDecisions.length) return null;
+  const argsSchema = readRecordField(value, "argsSchema", "args_schema");
+  return {
+    actionName,
+    allowedDecisions: normalizedDecisions,
+    ...argsSchema ? { argsSchema } : {}
+  };
+}
+function normalizeHITLRequest(value) {
+  if (!isRecord(value)) return null;
+  const actionRequests = readArrayField(
+    value,
+    "actionRequests",
+    "action_requests"
+  );
+  const reviewConfigs = readArrayField(
+    value,
+    "reviewConfigs",
+    "review_configs"
+  );
+  if (!actionRequests || !reviewConfigs || actionRequests.length === 0 || reviewConfigs.length === 0) {
+    return null;
+  }
+  const normalizedActionRequests = actionRequests.map(
+    normalizeHITLActionRequest
+  );
+  const normalizedReviewConfigs = reviewConfigs.map(
+    normalizeHITLReviewConfig
+  );
+  if (normalizedActionRequests.some((request) => request === null) || normalizedReviewConfigs.some((config) => config === null)) {
+    return null;
+  }
+  return {
+    actionRequests: normalizedActionRequests,
+    reviewConfigs: normalizedReviewConfigs
+  };
+}
+function isClientToolRequest(value) {
+  return isRecord(value) && Array.isArray(value.clientToolCalls);
+}
+function isToolCallRequest(value) {
+  return isRecord(value) && Array.isArray(value.toolCalls);
+}
+function isHITLRequest(value) {
+  if (!isRecord(value)) return false;
+  if (!Array.isArray(value.actionRequests) || !Array.isArray(value.reviewConfigs)) {
+    return false;
+  }
+  return normalizeHITLRequest(value) !== null;
+}
+function isInterruptRequest(value) {
+  return isToolCallRequest(value) || isClientToolRequest(value) || isHITLRequest(value);
+}
+function isLangGraphInterrupt(value) {
+  return isRecord(value) && typeof value.id === "string" && Object.prototype.hasOwnProperty.call(value, "value");
+}
+function isLangGraphInterruptTask(value) {
+  if (!isRecord(value) || typeof value.id !== "string" || typeof value.name !== "string" || !Array.isArray(value.path) || !Array.isArray(value.interrupts)) {
+    return false;
+  }
+  return value.path.every(
+    (item) => typeof item === "string" || typeof item === "number"
+  ) && value.interrupts.every(isLangGraphInterrupt);
+}
+function isLangGraphInterruptPayload(value) {
+  return isRecord(value) && Array.isArray(value.tasks) && value.tasks.every(isLangGraphInterruptTask);
+}
+function isClientToolInterrupt(value) {
+  return isLangGraphInterrupt(value) && isClientToolRequest(value.value);
+}
+function isClientToolInterruptTask(value) {
+  return isLangGraphInterruptTask(value) && value.interrupts.every(isClientToolInterrupt);
+}
+function isClientToolInterruptPayload(value) {
+  return isLangGraphInterruptPayload(value) && value.tasks.every(isClientToolInterruptTask);
+}
+function isToolCallInterrupt(value) {
+  return isLangGraphInterrupt(value) && isToolCallRequest(value.value);
+}
+function isToolCallInterruptTask(value) {
+  return isLangGraphInterruptTask(value) && value.interrupts.every(isToolCallInterrupt);
+}
+function isToolCallInterruptPayload(value) {
+  return isLangGraphInterruptPayload(value) && value.tasks.every(isToolCallInterruptTask);
+}
+function isHITLInterrupt(value) {
+  return isLangGraphInterrupt(value) && isHITLRequest(value.value);
+}
+function isHITLInterruptTask(value) {
+  return isLangGraphInterruptTask(value) && value.interrupts.every(isHITLInterrupt);
+}
+function isHITLInterruptPayload(value) {
+  return isLangGraphInterruptPayload(value) && value.tasks.every(isHITLInterruptTask);
+}
+const PET_ANIMATION_NAMES = [
+  "idle",
+  "running-right",
+  "running-left",
+  "waving",
+  "jumping",
+  "failed",
+  "waiting",
+  "running",
+  "review"
+];
+const petSpriteAtlas = {
+  columns: 8,
+  rows: 9,
+  cellWidth: 192,
+  cellHeight: 208,
+  animations: {
+    idle: {
+      row: 0,
+      frames: 6,
+      frameDurations: [280, 110, 110, 140, 140, 320]
+    },
+    "running-right": {
+      row: 1,
+      frames: 8,
+      frameDurations: [120, 120, 120, 120, 120, 120, 120, 220]
+    },
+    "running-left": {
+      row: 2,
+      frames: 8,
+      frameDurations: [120, 120, 120, 120, 120, 120, 120, 220]
+    },
+    waving: {
+      row: 3,
+      frames: 4,
+      frameDurations: [140, 140, 140, 280]
+    },
+    jumping: {
+      row: 4,
+      frames: 5,
+      frameDurations: [140, 140, 140, 140, 280]
+    },
+    failed: {
+      row: 5,
+      frames: 8,
+      frameDurations: [140, 140, 140, 140, 140, 140, 140, 240]
+    },
+    waiting: {
+      row: 6,
+      frames: 6,
+      frameDurations: [150, 150, 150, 150, 150, 260]
+    },
+    running: {
+      row: 7,
+      frames: 6,
+      frameDurations: [120, 120, 120, 120, 120, 220]
+    },
+    review: {
+      row: 8,
+      frames: 6,
+      frameDurations: [150, 150, 150, 150, 150, 280]
+    }
+  }
+};
+const DEFAULT_PET_SIZE = {
+  width: petSpriteAtlas.cellWidth,
+  height: petSpriteAtlas.cellHeight
+};
+const DEFAULT_PET_BOUNDS_PADDING = {
+  top: 0,
+  right: 0,
+  bottom: 0,
+  left: 0
+};
+const DEFAULT_PET_STORAGE_KEY = "chatkit:pet:position:v1";
+const DEFAULT_PET_SPRITESHEET_URL = "/pets/boba/spritesheet.webp";
+const DEFAULT_PET_CHARACTER = {
+  type: "sprite-atlas",
+  src: DEFAULT_PET_SPRITESHEET_URL
+};
+const DEFAULT_POSITION = {
+  pin: "bottom-right",
+  draggable: true,
+  scale: 0.25,
+  persist: true,
+  zIndex: 40
+};
+function mergeFrameAnimation(base, override) {
+  return {
+    row: (override == null ? void 0 : override.row) ?? base.row,
+    frames: (override == null ? void 0 : override.frames) ?? base.frames,
+    frameDurations: (override == null ? void 0 : override.frameDurations) && override.frameDurations.length > 0 ? override.frameDurations : base.frameDurations
+  };
+}
+function mergePetSpriteAtlas(override) {
+  var _a;
+  const animations = {};
+  for (const name of PET_ANIMATION_NAMES) {
+    animations[name] = mergeFrameAnimation(
+      petSpriteAtlas.animations[name],
+      (_a = override == null ? void 0 : override.animations) == null ? void 0 : _a[name]
+    );
+  }
+  return {
+    columns: (override == null ? void 0 : override.columns) ?? petSpriteAtlas.columns,
+    rows: (override == null ? void 0 : override.rows) ?? petSpriteAtlas.rows,
+    cellWidth: (override == null ? void 0 : override.cellWidth) ?? petSpriteAtlas.cellWidth,
+    cellHeight: (override == null ? void 0 : override.cellHeight) ?? petSpriteAtlas.cellHeight,
+    animations
+  };
+}
+function normalizeCharacter(character) {
+  if (!character) {
+    return DEFAULT_PET_CHARACTER;
+  }
+  if (character.src) {
+    return character;
+  }
+  return DEFAULT_PET_CHARACTER;
+}
+function normalizePetOptions(pet) {
+  if (!pet) {
+    return null;
+  }
+  if (pet === true) {
+    return {
+      character: DEFAULT_PET_CHARACTER,
+      position: DEFAULT_POSITION,
+      behavior: "auto",
+      ariaLabel: "Animated pet",
+      imageRendering: "auto"
+    };
+  }
+  if (pet.enabled === false) {
+    return null;
+  }
+  return {
+    character: normalizeCharacter(pet.character),
+    position: {
+      ...DEFAULT_POSITION,
+      ...pet.position
+    },
+    behavior: pet.behavior ?? "auto",
+    ariaLabel: pet.ariaLabel ?? "Animated pet",
+    imageRendering: pet.imageRendering ?? "auto"
+  };
+}
+function resolvePetCharacter(character) {
+  if (!character.src) {
+    return null;
+  }
+  return {
+    kind: "atlas",
+    src: character.src,
+    atlas: mergePetSpriteAtlas(character.atlas)
+  };
+}
+function normalizeBoundsPadding(value) {
+  if (typeof value === "number") {
+    return {
+      top: value,
+      right: value,
+      bottom: value,
+      left: value
+    };
+  }
+  return {
+    top: (value == null ? void 0 : value.top) ?? DEFAULT_PET_BOUNDS_PADDING.top,
+    right: (value == null ? void 0 : value.right) ?? DEFAULT_PET_BOUNDS_PADDING.right,
+    bottom: (value == null ? void 0 : value.bottom) ?? DEFAULT_PET_BOUNDS_PADDING.bottom,
+    left: (value == null ? void 0 : value.left) ?? DEFAULT_PET_BOUNDS_PADDING.left
+  };
+}
+function clampPetPosition(position, size, viewport, padding) {
+  const minX = padding.left;
+  const minY = padding.top;
+  const maxX = Math.max(minX, viewport.width - size.width - padding.right);
+  const maxY = Math.max(minY, viewport.height - size.height - padding.bottom);
+  return {
+    x: Math.min(maxX, Math.max(minX, position.x)),
+    y: Math.min(maxY, Math.max(minY, position.y))
+  };
+}
+function getPinnedPetPosition(pin, size, viewport, padding) {
+  const horizontalCenter = (viewport.width - size.width) / 2;
+  const verticalCenter = (viewport.height - size.height) / 2;
+  const right = viewport.width - size.width - padding.right;
+  const bottom = viewport.height - size.height - padding.bottom;
+  switch (pin) {
+    case "top-left":
+      return clampPetPosition(
+        { x: padding.left, y: padding.top },
+        size,
+        viewport,
+        padding
+      );
+    case "top":
+      return clampPetPosition(
+        { x: horizontalCenter, y: padding.top },
+        size,
+        viewport,
+        padding
+      );
+    case "top-right":
+      return clampPetPosition(
+        { x: right, y: padding.top },
+        size,
+        viewport,
+        padding
+      );
+    case "left":
+      return clampPetPosition(
+        { x: padding.left, y: verticalCenter },
+        size,
+        viewport,
+        padding
+      );
+    case "center":
+      return clampPetPosition(
+        { x: horizontalCenter, y: verticalCenter },
+        size,
+        viewport,
+        padding
+      );
+    case "right":
+      return clampPetPosition(
+        { x: right, y: verticalCenter },
+        size,
+        viewport,
+        padding
+      );
+    case "bottom-left":
+      return clampPetPosition(
+        { x: padding.left, y: bottom },
+        size,
+        viewport,
+        padding
+      );
+    case "bottom":
+      return clampPetPosition(
+        { x: horizontalCenter, y: bottom },
+        size,
+        viewport,
+        padding
+      );
+    case "bottom-right":
+    default:
+      return clampPetPosition({ x: right, y: bottom }, size, viewport, padding);
+  }
+}
+exports.CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED = constants.CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED;
+exports.ChatMessageEventTypeEnum = constants.ChatMessageEventTypeEnum;
+exports.ChatMessageStepCategory = constants.ChatMessageStepCategory;
+exports.ChatMessageTypeEnum = constants.ChatMessageTypeEnum;
+exports.STATE_VARIABLE_HUMAN = constants.STATE_VARIABLE_HUMAN;
+exports.DEFAULT_PET_BOUNDS_PADDING = DEFAULT_PET_BOUNDS_PADDING;
+exports.DEFAULT_PET_SIZE = DEFAULT_PET_SIZE;
+exports.DEFAULT_PET_SPRITESHEET_URL = DEFAULT_PET_SPRITESHEET_URL;
+exports.DEFAULT_PET_STORAGE_KEY = DEFAULT_PET_STORAGE_KEY;
+exports.HITL_DECISION_TYPES = HITL_DECISION_TYPES;
+exports.PET_ANIMATION_NAMES = PET_ANIMATION_NAMES;
+exports.REQUEST_USER_INPUT_RESULT_PURPOSE_IMPLEMENTATION_CONFIRMATION = REQUEST_USER_INPUT_RESULT_PURPOSE_IMPLEMENTATION_CONFIRMATION;
+exports.REQUEST_USER_INPUT_RESULT_PURPOSE_PLAN_CLARIFICATION = REQUEST_USER_INPUT_RESULT_PURPOSE_PLAN_CLARIFICATION;
+exports.REQUEST_USER_INPUT_RESULT_TYPE = REQUEST_USER_INPUT_RESULT_TYPE;
+exports.REQUEST_USER_INPUT_TOOL_NAME = REQUEST_USER_INPUT_TOOL_NAME;
+exports.clampPetPosition = clampPetPosition;
+exports.getPinnedPetPosition = getPinnedPetPosition;
+exports.isClientToolInterrupt = isClientToolInterrupt;
+exports.isClientToolInterruptPayload = isClientToolInterruptPayload;
+exports.isClientToolInterruptTask = isClientToolInterruptTask;
+exports.isClientToolRequest = isClientToolRequest;
+exports.isHITLDecisionType = isHITLDecisionType;
+exports.isHITLInterrupt = isHITLInterrupt;
+exports.isHITLInterruptPayload = isHITLInterruptPayload;
+exports.isHITLInterruptTask = isHITLInterruptTask;
+exports.isHITLRequest = isHITLRequest;
+exports.isInterruptRequest = isInterruptRequest;
+exports.isLangGraphInterrupt = isLangGraphInterrupt;
+exports.isLangGraphInterruptPayload = isLangGraphInterruptPayload;
+exports.isLangGraphInterruptTask = isLangGraphInterruptTask;
+exports.isToolCallInterrupt = isToolCallInterrupt;
+exports.isToolCallInterruptPayload = isToolCallInterruptPayload;
+exports.isToolCallInterruptTask = isToolCallInterruptTask;
+exports.isToolCallRequest = isToolCallRequest;
+exports.mergePetSpriteAtlas = mergePetSpriteAtlas;
+exports.normalizeBoundsPadding = normalizeBoundsPadding;
+exports.normalizeHITLRequest = normalizeHITLRequest;
+exports.normalizePetOptions = normalizePetOptions;
+exports.petSpriteAtlas = petSpriteAtlas;
+exports.resolvePetCharacter = resolvePetCharacter;
+//# sourceMappingURL=index.cjs.map