@copilotkit/sdk-js 1.9.2-next.10 → 1.9.2-next.2

package/dist/chunk-Q5S2AURJ.mjs

@@ -1,311 +0,0 @@
-var __defProp = Object.defineProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-
-// src/langgraph.ts
-import { dispatchCustomEvent } from "@langchain/core/callbacks/dispatch";
-import { convertJsonSchemaToZodSchema, randomId, CopilotKitMisuseError } from "@copilotkit/shared";
-import { Annotation, MessagesAnnotation, interrupt } from "@langchain/langgraph";
-import { DynamicStructuredTool } from "@langchain/core/tools";
-import { AIMessage } from "@langchain/core/messages";
-var CopilotKitPropertiesAnnotation = Annotation.Root({
-  actions: Annotation
-});
-var CopilotKitStateAnnotation = Annotation.Root({
-  copilotkit: Annotation,
-  ...MessagesAnnotation.spec
-});
-function copilotkitCustomizeConfig(baseConfig, options) {
-  if (baseConfig && typeof baseConfig !== "object") {
-    throw new CopilotKitMisuseError({
-      message: "baseConfig must be an object or null/undefined"
-    });
-  }
-  if (options && typeof options !== "object") {
-    throw new CopilotKitMisuseError({
-      message: "options must be an object when provided"
-    });
-  }
-  if (options == null ? void 0 : options.emitIntermediateState) {
-    if (!Array.isArray(options.emitIntermediateState)) {
-      throw new CopilotKitMisuseError({
-        message: "emitIntermediateState must be an array when provided"
-      });
-    }
-    options.emitIntermediateState.forEach((state, index) => {
-      if (!state || typeof state !== "object") {
-        throw new CopilotKitMisuseError({
-          message: `emitIntermediateState[${index}] must be an object`
-        });
-      }
-      if (!state.stateKey || typeof state.stateKey !== "string") {
-        throw new CopilotKitMisuseError({
-          message: `emitIntermediateState[${index}] must have a valid 'stateKey' string property`
-        });
-      }
-      if (!state.tool || typeof state.tool !== "string") {
-        throw new CopilotKitMisuseError({
-          message: `emitIntermediateState[${index}] must have a valid 'tool' string property`
-        });
-      }
-      if (state.toolArgument && typeof state.toolArgument !== "string") {
-        throw new CopilotKitMisuseError({
-          message: `emitIntermediateState[${index}].toolArgument must be a string when provided`
-        });
-      }
-    });
-  }
-  try {
-    const metadata = (baseConfig == null ? void 0 : baseConfig.metadata) || {};
-    if (options == null ? void 0 : options.emitAll) {
-      metadata["copilotkit:emit-tool-calls"] = true;
-      metadata["copilotkit:emit-messages"] = true;
-    } else {
-      if ((options == null ? void 0 : options.emitToolCalls) !== void 0) {
-        metadata["copilotkit:emit-tool-calls"] = options.emitToolCalls;
-      }
-      if ((options == null ? void 0 : options.emitMessages) !== void 0) {
-        metadata["copilotkit:emit-messages"] = options.emitMessages;
-      }
-    }
-    if (options == null ? void 0 : options.emitIntermediateState) {
-      const snakeCaseIntermediateState = options.emitIntermediateState.map((state) => ({
-        tool: state.tool,
-        tool_argument: state.toolArgument,
-        state_key: state.stateKey
-      }));
-      metadata["copilotkit:emit-intermediate-state"] = snakeCaseIntermediateState;
-    }
-    baseConfig = baseConfig || {};
-    return {
-      ...baseConfig,
-      metadata
-    };
-  } catch (error) {
-    throw new CopilotKitMisuseError({
-      message: `Failed to customize config: ${error instanceof Error ? error.message : String(error)}`
-    });
-  }
-}
-__name(copilotkitCustomizeConfig, "copilotkitCustomizeConfig");
-async function copilotkitExit(config) {
-  if (!config) {
-    throw new CopilotKitMisuseError({
-      message: "LangGraph configuration is required for copilotkitExit"
-    });
-  }
-  try {
-    await dispatchCustomEvent("copilotkit_exit", {}, config);
-  } catch (error) {
-    throw new CopilotKitMisuseError({
-      message: `Failed to dispatch exit event: ${error instanceof Error ? error.message : String(error)}`
-    });
-  }
-}
-__name(copilotkitExit, "copilotkitExit");
-async function copilotkitEmitState(config, state) {
-  if (!config) {
-    throw new CopilotKitMisuseError({
-      message: "LangGraph configuration is required for copilotkitEmitState"
-    });
-  }
-  if (state === void 0) {
-    throw new CopilotKitMisuseError({
-      message: "State is required for copilotkitEmitState"
-    });
-  }
-  try {
-    await dispatchCustomEvent("copilotkit_manually_emit_intermediate_state", state, config);
-  } catch (error) {
-    throw new CopilotKitMisuseError({
-      message: `Failed to emit state: ${error instanceof Error ? error.message : String(error)}`
-    });
-  }
-}
-__name(copilotkitEmitState, "copilotkitEmitState");
-async function copilotkitEmitMessage(config, message) {
-  if (!config) {
-    throw new CopilotKitMisuseError({
-      message: "LangGraph configuration is required for copilotkitEmitMessage"
-    });
-  }
-  if (!message || typeof message !== "string") {
-    throw new CopilotKitMisuseError({
-      message: "Message must be a non-empty string for copilotkitEmitMessage"
-    });
-  }
-  try {
-    await dispatchCustomEvent("copilotkit_manually_emit_message", {
-      message,
-      message_id: randomId(),
-      role: "assistant"
-    }, config);
-  } catch (error) {
-    throw new CopilotKitMisuseError({
-      message: `Failed to emit message: ${error instanceof Error ? error.message : String(error)}`
-    });
-  }
-}
-__name(copilotkitEmitMessage, "copilotkitEmitMessage");
-async function copilotkitEmitToolCall(config, name, args) {
-  if (!config) {
-    throw new CopilotKitMisuseError({
-      message: "LangGraph configuration is required for copilotkitEmitToolCall"
-    });
-  }
-  if (!name || typeof name !== "string") {
-    throw new CopilotKitMisuseError({
-      message: "Tool name must be a non-empty string for copilotkitEmitToolCall"
-    });
-  }
-  if (args === void 0) {
-    throw new CopilotKitMisuseError({
-      message: "Tool arguments are required for copilotkitEmitToolCall"
-    });
-  }
-  try {
-    await dispatchCustomEvent("copilotkit_manually_emit_tool_call", {
-      name,
-      args,
-      id: randomId()
-    }, config);
-  } catch (error) {
-    throw new CopilotKitMisuseError({
-      message: `Failed to emit tool call '${name}': ${error instanceof Error ? error.message : String(error)}`
-    });
-  }
-}
-__name(copilotkitEmitToolCall, "copilotkitEmitToolCall");
-function convertActionToDynamicStructuredTool(actionInput) {
-  if (!actionInput) {
-    throw new CopilotKitMisuseError({
-      message: "Action input is required but was not provided"
-    });
-  }
-  if (!actionInput.name || typeof actionInput.name !== "string") {
-    throw new CopilotKitMisuseError({
-      message: "Action must have a valid 'name' property of type string"
-    });
-  }
-  if (!actionInput.description || typeof actionInput.description !== "string") {
-    throw new CopilotKitMisuseError({
-      message: `Action '${actionInput.name}' must have a valid 'description' property of type string`
-    });
-  }
-  if (!actionInput.parameters) {
-    throw new CopilotKitMisuseError({
-      message: `Action '${actionInput.name}' must have a 'parameters' property`
-    });
-  }
-  try {
-    return new DynamicStructuredTool({
-      name: actionInput.name,
-      description: actionInput.description,
-      schema: convertJsonSchemaToZodSchema(actionInput.parameters, true),
-      func: async () => {
-        return "";
-      }
-    });
-  } catch (error) {
-    throw new CopilotKitMisuseError({
-      message: `Failed to convert action '${actionInput.name}' to DynamicStructuredTool: ${error instanceof Error ? error.message : String(error)}`
-    });
-  }
-}
-__name(convertActionToDynamicStructuredTool, "convertActionToDynamicStructuredTool");
-function convertActionsToDynamicStructuredTools(actions) {
-  if (!Array.isArray(actions)) {
-    throw new CopilotKitMisuseError({
-      message: "Actions must be an array"
-    });
-  }
-  return actions.map((action, index) => {
-    try {
-      return convertActionToDynamicStructuredTool(action);
-    } catch (error) {
-      throw new CopilotKitMisuseError({
-        message: `Failed to convert action at index ${index}: ${error instanceof Error ? error.message : String(error)}`
-      });
-    }
-  });
-}
-__name(convertActionsToDynamicStructuredTools, "convertActionsToDynamicStructuredTools");
-function copilotKitInterrupt({ message, action, args }) {
-  if (!message && !action) {
-    throw new CopilotKitMisuseError({
-      message: "Either message or action (and optional arguments) must be provided for copilotKitInterrupt"
-    });
-  }
-  if (action && typeof action !== "string") {
-    throw new CopilotKitMisuseError({
-      message: "Action must be a string when provided to copilotKitInterrupt"
-    });
-  }
-  if (message && typeof message !== "string") {
-    throw new CopilotKitMisuseError({
-      message: "Message must be a string when provided to copilotKitInterrupt"
-    });
-  }
-  if (args && typeof args !== "object") {
-    throw new CopilotKitMisuseError({
-      message: "Args must be an object when provided to copilotKitInterrupt"
-    });
-  }
-  let interruptValues = null;
-  let interruptMessage = null;
-  let answer = null;
-  try {
-    if (message) {
-      interruptValues = message;
-      interruptMessage = new AIMessage({
-        content: message,
-        id: randomId()
-      });
-    } else {
-      const toolId = randomId();
-      interruptMessage = new AIMessage({
-        content: "",
-        tool_calls: [
-          {
-            id: toolId,
-            name: action,
-            args: args ?? {}
-          }
-        ]
-      });
-      interruptValues = {
-        action,
-        args: args ?? {}
-      };
-    }
-    const response = interrupt({
-      __copilotkit_interrupt_value__: interruptValues,
-      __copilotkit_messages__: [
-        interruptMessage
-      ]
-    });
-    answer = response[response.length - 1].content;
-    return {
-      answer,
-      messages: response
-    };
-  } catch (error) {
-    throw new CopilotKitMisuseError({
-      message: `Failed to create interrupt: ${error instanceof Error ? error.message : String(error)}`
-    });
-  }
-}
-__name(copilotKitInterrupt, "copilotKitInterrupt");
-
-export {
-  CopilotKitPropertiesAnnotation,
-  CopilotKitStateAnnotation,
-  copilotkitCustomizeConfig,
-  copilotkitExit,
-  copilotkitEmitState,
-  copilotkitEmitMessage,
-  copilotkitEmitToolCall,
-  convertActionToDynamicStructuredTool,
-  convertActionsToDynamicStructuredTools,
-  copilotKitInterrupt
-};
-//# sourceMappingURL=chunk-Q5S2AURJ.mjs.map

package/dist/chunk-Q5S2AURJ.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/langgraph.ts"],"sourcesContent":["import { RunnableConfig } from \"@langchain/core/runnables\";\nimport { dispatchCustomEvent } from \"@langchain/core/callbacks/dispatch\";\nimport { convertJsonSchemaToZodSchema, randomId, CopilotKitMisuseError } from \"@copilotkit/shared\";\nimport { Annotation, MessagesAnnotation, interrupt } from \"@langchain/langgraph\";\nimport { DynamicStructuredTool } from \"@langchain/core/tools\";\nimport { AIMessage } from \"@langchain/core/messages\";\n\ninterface IntermediateStateConfig {\n  stateKey: string;\n  tool: string;\n  toolArgument?: string;\n}\n\ninterface OptionsConfig {\n  emitToolCalls?: boolean | string | string[];\n  emitMessages?: boolean;\n  emitAll?: boolean;\n  emitIntermediateState?: IntermediateStateConfig[];\n}\n\nexport const CopilotKitPropertiesAnnotation = Annotation.Root({\n  actions: Annotation<any[]>,\n});\n\nexport const CopilotKitStateAnnotation = Annotation.Root({\n  copilotkit: Annotation<typeof CopilotKitPropertiesAnnotation.State>,\n  ...MessagesAnnotation.spec,\n});\n\nexport type CopilotKitState = typeof CopilotKitStateAnnotation.State;\nexport type CopilotKitProperties = typeof CopilotKitPropertiesAnnotation.State;\n\n/**\n * Customize the LangGraph configuration for use in CopilotKit.\n *\n * To the CopilotKit SDK, run:\n *\n * ```bash\n * npm install @copilotkit/sdk-js\n * ```\n *\n * ### Examples\n *\n * Disable emitting messages and tool calls:\n *\n * ```typescript\n * import { copilotkitCustomizeConfig } from \"@copilotkit/sdk-js\";\n *\n * config = copilotkitCustomizeConfig(\n *   config,\n *   emitMessages=false,\n *   emitToolCalls=false\n * )\n * ```\n *\n * To emit a tool call as streaming LangGraph state, pass the destination key in state,\n * the tool name and optionally the tool argument. (If you don't pass the argument name,\n * all arguments are emitted under the state key.)\n *\n * ```typescript\n * import { copilotkitCustomizeConfig } from \"@copilotkit/sdk-js\";\n *\n * config = copilotkitCustomizeConfig(\n *   config,\n *   emitIntermediateState=[\n *     {\n *       \"stateKey\": \"steps\",\n *       \"tool\": \"SearchTool\",\n *       \"toolArgument\": \"steps\",\n *     },\n *   ],\n * )\n * ```\n */\nexport function copilotkitCustomizeConfig(\n  /**\n   * The LangChain/LangGraph configuration to customize.\n   */\n  baseConfig: RunnableConfig,\n  /**\n   * Configuration options:\n   * - `emitMessages: boolean?`\n   *   Configure how messages are emitted. By default, all messages are emitted. Pass false to\n   *   disable emitting messages.\n   * - `emitToolCalls: boolean | string | string[]?`\n   *   Configure how tool calls are emitted. By default, all tool calls are emitted. Pass false to\n   *   disable emitting tool calls. Pass a string or list of strings to emit only specific tool calls.\n   * - `emitIntermediateState: IntermediateStateConfig[]?`\n   *   Lets you emit tool calls as streaming LangGraph state.\n   */\n  options?: OptionsConfig,\n): RunnableConfig {\n  if (baseConfig && typeof baseConfig !== \"object\") {\n    throw new CopilotKitMisuseError({\n      message: \"baseConfig must be an object or null/undefined\",\n    });\n  }\n\n  if (options && typeof options !== \"object\") {\n    throw new CopilotKitMisuseError({\n      message: \"options must be an object when provided\",\n    });\n  }\n\n  // Validate emitIntermediateState structure\n  if (options?.emitIntermediateState) {\n    if (!Array.isArray(options.emitIntermediateState)) {\n      throw new CopilotKitMisuseError({\n        message: \"emitIntermediateState must be an array when provided\",\n      });\n    }\n\n    options.emitIntermediateState.forEach((state, index) => {\n      if (!state || typeof state !== \"object\") {\n        throw new CopilotKitMisuseError({\n          message: `emitIntermediateState[${index}] must be an object`,\n        });\n      }\n\n      if (!state.stateKey || typeof state.stateKey !== \"string\") {\n        throw new CopilotKitMisuseError({\n          message: `emitIntermediateState[${index}] must have a valid 'stateKey' string property`,\n        });\n      }\n\n      if (!state.tool || typeof state.tool !== \"string\") {\n        throw new CopilotKitMisuseError({\n          message: `emitIntermediateState[${index}] must have a valid 'tool' string property`,\n        });\n      }\n\n      if (state.toolArgument && typeof state.toolArgument !== \"string\") {\n        throw new CopilotKitMisuseError({\n          message: `emitIntermediateState[${index}].toolArgument must be a string when provided`,\n        });\n      }\n    });\n  }\n\n  try {\n    const metadata = baseConfig?.metadata || {};\n\n    if (options?.emitAll) {\n      metadata[\"copilotkit:emit-tool-calls\"] = true;\n      metadata[\"copilotkit:emit-messages\"] = true;\n    } else {\n      if (options?.emitToolCalls !== undefined) {\n        metadata[\"copilotkit:emit-tool-calls\"] = options.emitToolCalls;\n      }\n      if (options?.emitMessages !== undefined) {\n        metadata[\"copilotkit:emit-messages\"] = options.emitMessages;\n      }\n    }\n\n    if (options?.emitIntermediateState) {\n      const snakeCaseIntermediateState = options.emitIntermediateState.map((state) => ({\n        tool: state.tool,\n        tool_argument: state.toolArgument,\n        state_key: state.stateKey,\n      }));\n\n      metadata[\"copilotkit:emit-intermediate-state\"] = snakeCaseIntermediateState;\n    }\n\n    baseConfig = baseConfig || {};\n\n    return {\n      ...baseConfig,\n      metadata: metadata,\n    };\n  } catch (error) {\n    throw new CopilotKitMisuseError({\n      message: `Failed to customize config: ${error instanceof Error ? error.message : String(error)}`,\n    });\n  }\n}\n/**\n * Exits the current agent after the run completes. Calling copilotkit_exit() will\n * not immediately stop the agent. Instead, it signals to CopilotKit to stop the agent after\n * the run completes.\n *\n * ### Examples\n *\n * ```typescript\n * import { copilotkitExit } from \"@copilotkit/sdk-js\";\n *\n * async function myNode(state: Any):\n *   await copilotkitExit(config)\n *   return state\n * ```\n */\nexport async function copilotkitExit(\n  /**\n   * The LangChain/LangGraph configuration.\n   */\n  config: RunnableConfig,\n) {\n  if (!config) {\n    throw new CopilotKitMisuseError({\n      message: \"LangGraph configuration is required for copilotkitExit\",\n    });\n  }\n\n  try {\n    await dispatchCustomEvent(\"copilotkit_exit\", {}, config);\n  } catch (error) {\n    throw new CopilotKitMisuseError({\n      message: `Failed to dispatch exit event: ${error instanceof Error ? error.message : String(error)}`,\n    });\n  }\n}\n/**\n * Emits intermediate state to CopilotKit. Useful if you have a longer running node and you want to\n * update the user with the current state of the node.\n *\n * ### Examples\n *\n * ```typescript\n * import { copilotkitEmitState } from \"@copilotkit/sdk-js\";\n *\n * for (let i = 0; i < 10; i++) {\n *   await someLongRunningOperation(i);\n *   await copilotkitEmitState(config, { progress: i });\n * }\n * ```\n */\nexport async function copilotkitEmitState(\n  /**\n   * The LangChain/LangGraph configuration.\n   */\n  config: RunnableConfig,\n  /**\n   * The state to emit.\n   */\n  state: any,\n) {\n  if (!config) {\n    throw new CopilotKitMisuseError({\n      message: \"LangGraph configuration is required for copilotkitEmitState\",\n    });\n  }\n\n  if (state === undefined) {\n    throw new CopilotKitMisuseError({\n      message: \"State is required for copilotkitEmitState\",\n    });\n  }\n\n  try {\n    await dispatchCustomEvent(\"copilotkit_manually_emit_intermediate_state\", state, config);\n  } catch (error) {\n    throw new CopilotKitMisuseError({\n      message: `Failed to emit state: ${error instanceof Error ? error.message : String(error)}`,\n    });\n  }\n}\n/**\n * Manually emits a message to CopilotKit. Useful in longer running nodes to update the user.\n * Important: You still need to return the messages from the node.\n *\n * ### Examples\n *\n * ```typescript\n * import { copilotkitEmitMessage } from \"@copilotkit/sdk-js\";\n *\n * const message = \"Step 1 of 10 complete\";\n * await copilotkitEmitMessage(config, message);\n *\n * // Return the message from the node\n * return {\n *   \"messages\": [AIMessage(content=message)]\n * }\n * ```\n */\nexport async function copilotkitEmitMessage(\n  /**\n   * The LangChain/LangGraph configuration.\n   */\n  config: RunnableConfig,\n  /**\n   * The message to emit.\n   */\n  message: string,\n) {\n  if (!config) {\n    throw new CopilotKitMisuseError({\n      message: \"LangGraph configuration is required for copilotkitEmitMessage\",\n    });\n  }\n\n  if (!message || typeof message !== \"string\") {\n    throw new CopilotKitMisuseError({\n      message: \"Message must be a non-empty string for copilotkitEmitMessage\",\n    });\n  }\n\n  try {\n    await dispatchCustomEvent(\n      \"copilotkit_manually_emit_message\",\n      { message, message_id: randomId(), role: \"assistant\" },\n      config,\n    );\n  } catch (error) {\n    throw new CopilotKitMisuseError({\n      message: `Failed to emit message: ${error instanceof Error ? error.message : String(error)}`,\n    });\n  }\n}\n/**\n * Manually emits a tool call to CopilotKit.\n *\n * ### Examples\n *\n * ```typescript\n * import { copilotkitEmitToolCall } from \"@copilotkit/sdk-js\";\n *\n * await copilotkitEmitToolCall(config, name=\"SearchTool\", args={\"steps\": 10})\n * ```\n */\nexport async function copilotkitEmitToolCall(\n  /**\n   * The LangChain/LangGraph configuration.\n   */\n  config: RunnableConfig,\n  /**\n   * The name of the tool to emit.\n   */\n  name: string,\n  /**\n   * The arguments to emit.\n   */\n  args: any,\n) {\n  if (!config) {\n    throw new CopilotKitMisuseError({\n      message: \"LangGraph configuration is required for copilotkitEmitToolCall\",\n    });\n  }\n\n  if (!name || typeof name !== \"string\") {\n    throw new CopilotKitMisuseError({\n      message: \"Tool name must be a non-empty string for copilotkitEmitToolCall\",\n    });\n  }\n\n  if (args === undefined) {\n    throw new CopilotKitMisuseError({\n      message: \"Tool arguments are required for copilotkitEmitToolCall\",\n    });\n  }\n\n  try {\n    await dispatchCustomEvent(\n      \"copilotkit_manually_emit_tool_call\",\n      { name, args, id: randomId() },\n      config,\n    );\n  } catch (error) {\n    throw new CopilotKitMisuseError({\n      message: `Failed to emit tool call '${name}': ${error instanceof Error ? error.message : String(error)}`,\n    });\n  }\n}\n\nexport function convertActionToDynamicStructuredTool(actionInput: any): DynamicStructuredTool<any> {\n  if (!actionInput) {\n    throw new CopilotKitMisuseError({\n      message: \"Action input is required but was not provided\",\n    });\n  }\n\n  if (!actionInput.name || typeof actionInput.name !== \"string\") {\n    throw new CopilotKitMisuseError({\n      message: \"Action must have a valid 'name' property of type string\",\n    });\n  }\n\n  if (!actionInput.description || typeof actionInput.description !== \"string\") {\n    throw new CopilotKitMisuseError({\n      message: `Action '${actionInput.name}' must have a valid 'description' property of type string`,\n    });\n  }\n\n  if (!actionInput.parameters) {\n    throw new CopilotKitMisuseError({\n      message: `Action '${actionInput.name}' must have a 'parameters' property`,\n    });\n  }\n\n  try {\n    return new DynamicStructuredTool({\n      name: actionInput.name,\n      description: actionInput.description,\n      schema: convertJsonSchemaToZodSchema(actionInput.parameters, true),\n      func: async () => {\n        return \"\";\n      },\n    });\n  } catch (error) {\n    throw new CopilotKitMisuseError({\n      message: `Failed to convert action '${actionInput.name}' to DynamicStructuredTool: ${error instanceof Error ? error.message : String(error)}`,\n    });\n  }\n}\n/**\n * Use this function to convert a list of actions you get from state\n * to a list of dynamic structured tools.\n *\n * ### Examples\n *\n * ```typescript\n * import { convertActionsToDynamicStructuredTools } from \"@copilotkit/sdk-js\";\n *\n * const tools = convertActionsToDynamicStructuredTools(state.copilotkit.actions);\n * ```\n */\nexport function convertActionsToDynamicStructuredTools(\n  /**\n   * The list of actions to convert.\n   */\n  actions: any[],\n): DynamicStructuredTool<any>[] {\n  if (!Array.isArray(actions)) {\n    throw new CopilotKitMisuseError({\n      message: \"Actions must be an array\",\n    });\n  }\n\n  return actions.map((action, index) => {\n    try {\n      return convertActionToDynamicStructuredTool(action);\n    } catch (error) {\n      throw new CopilotKitMisuseError({\n        message: `Failed to convert action at index ${index}: ${error instanceof Error ? error.message : String(error)}`,\n      });\n    }\n  });\n}\n\nexport function copilotKitInterrupt({\n  message,\n  action,\n  args,\n}: {\n  message?: string;\n  action?: string;\n  args?: Record<string, any>;\n}) {\n  if (!message && !action) {\n    throw new CopilotKitMisuseError({\n      message:\n        \"Either message or action (and optional arguments) must be provided for copilotKitInterrupt\",\n    });\n  }\n\n  if (action && typeof action !== \"string\") {\n    throw new CopilotKitMisuseError({\n      message: \"Action must be a string when provided to copilotKitInterrupt\",\n    });\n  }\n\n  if (message && typeof message !== \"string\") {\n    throw new CopilotKitMisuseError({\n      message: \"Message must be a string when provided to copilotKitInterrupt\",\n    });\n  }\n\n  if (args && typeof args !== \"object\") {\n    throw new CopilotKitMisuseError({\n      message: \"Args must be an object when provided to copilotKitInterrupt\",\n    });\n  }\n\n  let interruptValues = null;\n  let interruptMessage = null;\n  let answer = null;\n\n  try {\n    if (message) {\n      interruptValues = message;\n      interruptMessage = new AIMessage({ content: message, id: randomId() });\n    } else {\n      const toolId = randomId();\n      interruptMessage = new AIMessage({\n        content: \"\",\n        tool_calls: [{ id: toolId, name: action, args: args ?? {} }],\n      });\n      interruptValues = {\n        action,\n        args: args ?? {},\n      };\n    }\n\n    const response = interrupt({\n      __copilotkit_interrupt_value__: interruptValues,\n      __copilotkit_messages__: [interruptMessage],\n    });\n    answer = response[response.length - 1].content;\n\n    return {\n      answer,\n      messages: response,\n    };\n  } catch (error) {\n    throw new CopilotKitMisuseError({\n      message: `Failed to create interrupt: ${error instanceof Error ? error.message : String(error)}`,\n    });\n  }\n}\n"],"mappings":"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","names":["dispatchCustomEvent","convertJsonSchemaToZodSchema","randomId","CopilotKitMisuseError","Annotation","MessagesAnnotation","interrupt","DynamicStructuredTool","AIMessage","CopilotKitPropertiesAnnotation","Annotation","Root","actions","CopilotKitStateAnnotation","copilotkit","MessagesAnnotation","spec","copilotkitCustomizeConfig","baseConfig","options","CopilotKitMisuseError","message","emitIntermediateState","Array","isArray","forEach","state","index","stateKey","tool","toolArgument","metadata","emitAll","emitToolCalls","undefined","emitMessages","snakeCaseIntermediateState","map","tool_argument","state_key","error","Error","String","copilotkitExit","config","dispatchCustomEvent","copilotkitEmitState","copilotkitEmitMessage","message_id","randomId","role","copilotkitEmitToolCall","name","args","id","convertActionToDynamicStructuredTool","actionInput","description","parameters","DynamicStructuredTool","schema","convertJsonSchemaToZodSchema","func","convertActionsToDynamicStructuredTools","action","copilotKitInterrupt","interruptValues","interruptMessage","answer","AIMessage","content","toolId","tool_calls","response","interrupt","__copilotkit_interrupt_value__","__copilotkit_messages__","length","messages"]}

package/src/__tests__/error-handling.test.ts

@@ -1,207 +0,0 @@
-import { CopilotKitMisuseError } from "@copilotkit/shared";
-import {
-  copilotKitInterrupt,
-  convertActionToDynamicStructuredTool,
-  convertActionsToDynamicStructuredTools,
-  copilotkitCustomizeConfig,
-  copilotkitEmitMessage,
-  copilotkitEmitState,
-  copilotkitEmitToolCall,
-  copilotkitExit,
-} from "../langgraph";
-
-describe("SDK-JS Error Handling", () => {
-  describe("copilotKitInterrupt", () => {
-    it("should throw CopilotKitMisuseError when neither message nor action provided", () => {
-      expect(() => {
-        copilotKitInterrupt({});
-      }).toThrow(CopilotKitMisuseError);
-
-      expect(() => {
-        copilotKitInterrupt({});
-      }).toThrow(
-        "Either message or action (and optional arguments) must be provided for copilotKitInterrupt",
-      );
-    });
-
-    it("should throw CopilotKitMisuseError when action is not a string", () => {
-      expect(() => {
-        copilotKitInterrupt({ action: 123 as any });
-      }).toThrow(CopilotKitMisuseError);
-
-      expect(() => {
-        copilotKitInterrupt({ action: 123 as any });
-      }).toThrow("Action must be a string when provided to copilotKitInterrupt");
-    });
-
-    it("should throw CopilotKitMisuseError when message is not a string", () => {
-      expect(() => {
-        copilotKitInterrupt({ message: 123 as any });
-      }).toThrow(CopilotKitMisuseError);
-
-      expect(() => {
-        copilotKitInterrupt({ message: 123 as any });
-      }).toThrow("Message must be a string when provided to copilotKitInterrupt");
-    });
-
-    it("should throw CopilotKitMisuseError when args is not an object", () => {
-      expect(() => {
-        copilotKitInterrupt({ action: "test", args: "invalid" as any });
-      }).toThrow(CopilotKitMisuseError);
-
-      expect(() => {
-        copilotKitInterrupt({ action: "test", args: "invalid" as any });
-      }).toThrow("Args must be an object when provided to copilotKitInterrupt");
-    });
-  });
-
-  describe("convertActionToDynamicStructuredTool", () => {
-    it("should throw CopilotKitMisuseError when actionInput is null/undefined", () => {
-      expect(() => {
-        convertActionToDynamicStructuredTool(null);
-      }).toThrow(CopilotKitMisuseError);
-
-      expect(() => {
-        convertActionToDynamicStructuredTool(null);
-      }).toThrow("Action input is required but was not provided");
-    });
-
-    it("should throw CopilotKitMisuseError when name is missing", () => {
-      expect(() => {
-        convertActionToDynamicStructuredTool({ description: "test" });
-      }).toThrow(CopilotKitMisuseError);
-
-      expect(() => {
-        convertActionToDynamicStructuredTool({ description: "test" });
-      }).toThrow("Action must have a valid 'name' property of type string");
-    });
-
-    it("should throw CopilotKitMisuseError when description is missing", () => {
-      expect(() => {
-        convertActionToDynamicStructuredTool({ name: "test" });
-      }).toThrow(CopilotKitMisuseError);
-
-      expect(() => {
-        convertActionToDynamicStructuredTool({ name: "test" });
-      }).toThrow("Action 'test' must have a valid 'description' property of type string");
-    });
-
-    it("should throw CopilotKitMisuseError when parameters is missing", () => {
-      expect(() => {
-        convertActionToDynamicStructuredTool({ name: "test", description: "test desc" });
-      }).toThrow(CopilotKitMisuseError);
-
-      expect(() => {
-        convertActionToDynamicStructuredTool({ name: "test", description: "test desc" });
-      }).toThrow("Action 'test' must have a 'parameters' property");
-    });
-  });
-
-  describe("convertActionsToDynamicStructuredTools", () => {
-    it("should throw CopilotKitMisuseError when actions is not an array", () => {
-      expect(() => {
-        convertActionsToDynamicStructuredTools("not an array" as any);
-      }).toThrow(CopilotKitMisuseError);
-
-      expect(() => {
-        convertActionsToDynamicStructuredTools("not an array" as any);
-      }).toThrow("Actions must be an array");
-    });
-  });
-
-  describe("copilotkitCustomizeConfig", () => {
-    it("should throw CopilotKitMisuseError when baseConfig is not an object", () => {
-      expect(() => {
-        copilotkitCustomizeConfig("invalid" as any);
-      }).toThrow(CopilotKitMisuseError);
-
-      expect(() => {
-        copilotkitCustomizeConfig("invalid" as any);
-      }).toThrow("baseConfig must be an object or null/undefined");
-    });
-
-    it("should throw CopilotKitMisuseError when options is not an object", () => {
-      expect(() => {
-        copilotkitCustomizeConfig({}, "invalid" as any);
-      }).toThrow(CopilotKitMisuseError);
-
-      expect(() => {
-        copilotkitCustomizeConfig({}, "invalid" as any);
-      }).toThrow("options must be an object when provided");
-    });
-
-    it("should throw CopilotKitMisuseError when emitIntermediateState is not an array", () => {
-      expect(() => {
-        copilotkitCustomizeConfig({}, { emitIntermediateState: "invalid" as any });
-      }).toThrow(CopilotKitMisuseError);
-
-      expect(() => {
-        copilotkitCustomizeConfig({}, { emitIntermediateState: "invalid" as any });
-      }).toThrow("emitIntermediateState must be an array when provided");
-    });
-
-    it("should throw CopilotKitMisuseError when emitIntermediateState item is invalid", () => {
-      expect(() => {
-        copilotkitCustomizeConfig({}, { emitIntermediateState: [{ invalidKey: "value" }] as any });
-      }).toThrow(CopilotKitMisuseError);
-
-      expect(() => {
-        copilotkitCustomizeConfig({}, { emitIntermediateState: [{ invalidKey: "value" }] as any });
-      }).toThrow("emitIntermediateState[0] must have a valid 'stateKey' string property");
-    });
-  });
-
-  describe("emit functions", () => {
-    const mockConfig = { metadata: {} };
-
-    it("should throw CopilotKitMisuseError when config is missing for copilotkitExit", async () => {
-      await expect(copilotkitExit(null as any)).rejects.toThrow(CopilotKitMisuseError);
-      await expect(copilotkitExit(null as any)).rejects.toThrow(
-        "LangGraph configuration is required for copilotkitExit",
-      );
-    });
-
-    it("should throw CopilotKitMisuseError when config is missing for copilotkitEmitState", async () => {
-      await expect(copilotkitEmitState(null as any, {})).rejects.toThrow(CopilotKitMisuseError);
-      await expect(copilotkitEmitState(null as any, {})).rejects.toThrow(
-        "LangGraph configuration is required for copilotkitEmitState",
-      );
-    });
-
-    it("should throw CopilotKitMisuseError when state is undefined for copilotkitEmitState", async () => {
-      await expect(copilotkitEmitState(mockConfig, undefined)).rejects.toThrow(
-        CopilotKitMisuseError,
-      );
-      await expect(copilotkitEmitState(mockConfig, undefined)).rejects.toThrow(
-        "State is required for copilotkitEmitState",
-      );
-    });
-
-    it("should throw CopilotKitMisuseError when message is invalid for copilotkitEmitMessage", async () => {
-      await expect(copilotkitEmitMessage(mockConfig, "" as any)).rejects.toThrow(
-        CopilotKitMisuseError,
-      );
-      await expect(copilotkitEmitMessage(mockConfig, "" as any)).rejects.toThrow(
-        "Message must be a non-empty string for copilotkitEmitMessage",
-      );
-    });
-
-    it("should throw CopilotKitMisuseError when tool name is invalid for copilotkitEmitToolCall", async () => {
-      await expect(copilotkitEmitToolCall(mockConfig, "", {})).rejects.toThrow(
-        CopilotKitMisuseError,
-      );
-      await expect(copilotkitEmitToolCall(mockConfig, "", {})).rejects.toThrow(
-        "Tool name must be a non-empty string for copilotkitEmitToolCall",
-      );
-    });
-
-    it("should throw CopilotKitMisuseError when args is undefined for copilotkitEmitToolCall", async () => {
-      await expect(copilotkitEmitToolCall(mockConfig, "testTool", undefined)).rejects.toThrow(
-        CopilotKitMisuseError,
-      );
-      await expect(copilotkitEmitToolCall(mockConfig, "testTool", undefined)).rejects.toThrow(
-        "Tool arguments are required for copilotkitEmitToolCall",
-      );
-    });
-  });
-});