@copilotkit/sdk-js 1.9.2-next.7 → 1.9.2-next.9

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @copilotkit/sdk-js
 
+## 1.9.2-next.9
+
+### Patch Changes
+
+- 1d1c51d: - feat: surface all errors in structured format
+- Updated dependencies [1d1c51d]
+  - @copilotkit/shared@1.9.2-next.9
+
+## 1.9.2-next.8
+
+### Patch Changes
+
+- @copilotkit/shared@1.9.2-next.8
+
 ## 1.9.2-next.7
 
 ### Patch Changes

package/dist/chunk-Q5S2AURJ.mjs

@@ -0,0 +1,311 @@
+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

@@ -0,0 +1 @@
+{"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/dist/langchain.js

@@ -46,70 +46,218 @@ var CopilotKitStateAnnotation = import_langgraph.Annotation.Root({
   ...import_langgraph.MessagesAnnotation.spec
 });
 function copilotkitCustomizeConfig(baseConfig, options) {
-  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 (baseConfig && typeof baseConfig !== "object") {
+    throw new import_shared.CopilotKitMisuseError({
+      message: "baseConfig must be an object or null/undefined"
+    });
+  }
+  if (options && typeof options !== "object") {
+    throw new import_shared.CopilotKitMisuseError({
+      message: "options must be an object when provided"
+    });
+  }
+  if (options == null ? void 0 : options.emitIntermediateState) {
+    if (!Array.isArray(options.emitIntermediateState)) {
+      throw new import_shared.CopilotKitMisuseError({
+        message: "emitIntermediateState must be an array when provided"
+      });
     }
-    if ((options == null ? void 0 : options.emitMessages) !== void 0) {
-      metadata["copilotkit:emit-messages"] = options.emitMessages;
+    options.emitIntermediateState.forEach((state, index) => {
+      if (!state || typeof state !== "object") {
+        throw new import_shared.CopilotKitMisuseError({
+          message: `emitIntermediateState[${index}] must be an object`
+        });
+      }
+      if (!state.stateKey || typeof state.stateKey !== "string") {
+        throw new import_shared.CopilotKitMisuseError({
+          message: `emitIntermediateState[${index}] must have a valid 'stateKey' string property`
+        });
+      }
+      if (!state.tool || typeof state.tool !== "string") {
+        throw new import_shared.CopilotKitMisuseError({
+          message: `emitIntermediateState[${index}] must have a valid 'tool' string property`
+        });
+      }
+      if (state.toolArgument && typeof state.toolArgument !== "string") {
+        throw new import_shared.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 import_shared.CopilotKitMisuseError({
+      message: `Failed to customize config: ${error instanceof Error ? error.message : String(error)}`
+    });
   }
-  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
-  };
 }
 __name(copilotkitCustomizeConfig, "copilotkitCustomizeConfig");
 async function copilotkitExit(config) {
-  await (0, import_dispatch.dispatchCustomEvent)("copilotkit_exit", {}, config);
+  if (!config) {
+    throw new import_shared.CopilotKitMisuseError({
+      message: "LangGraph configuration is required for copilotkitExit"
+    });
+  }
+  try {
+    await (0, import_dispatch.dispatchCustomEvent)("copilotkit_exit", {}, config);
+  } catch (error) {
+    throw new import_shared.CopilotKitMisuseError({
+      message: `Failed to dispatch exit event: ${error instanceof Error ? error.message : String(error)}`
+    });
+  }
 }
 __name(copilotkitExit, "copilotkitExit");
 async function copilotkitEmitState(config, state) {
-  await (0, import_dispatch.dispatchCustomEvent)("copilotkit_manually_emit_intermediate_state", state, config);
+  if (!config) {
+    throw new import_shared.CopilotKitMisuseError({
+      message: "LangGraph configuration is required for copilotkitEmitState"
+    });
+  }
+  if (state === void 0) {
+    throw new import_shared.CopilotKitMisuseError({
+      message: "State is required for copilotkitEmitState"
+    });
+  }
+  try {
+    await (0, import_dispatch.dispatchCustomEvent)("copilotkit_manually_emit_intermediate_state", state, config);
+  } catch (error) {
+    throw new import_shared.CopilotKitMisuseError({
+      message: `Failed to emit state: ${error instanceof Error ? error.message : String(error)}`
+    });
+  }
 }
 __name(copilotkitEmitState, "copilotkitEmitState");
 async function copilotkitEmitMessage(config, message) {
-  await (0, import_dispatch.dispatchCustomEvent)("copilotkit_manually_emit_message", {
-    message,
-    message_id: (0, import_shared.randomId)(),
-    role: "assistant"
-  }, config);
+  if (!config) {
+    throw new import_shared.CopilotKitMisuseError({
+      message: "LangGraph configuration is required for copilotkitEmitMessage"
+    });
+  }
+  if (!message || typeof message !== "string") {
+    throw new import_shared.CopilotKitMisuseError({
+      message: "Message must be a non-empty string for copilotkitEmitMessage"
+    });
+  }
+  try {
+    await (0, import_dispatch.dispatchCustomEvent)("copilotkit_manually_emit_message", {
+      message,
+      message_id: (0, import_shared.randomId)(),
+      role: "assistant"
+    }, config);
+  } catch (error) {
+    throw new import_shared.CopilotKitMisuseError({
+      message: `Failed to emit message: ${error instanceof Error ? error.message : String(error)}`
+    });
+  }
 }
 __name(copilotkitEmitMessage, "copilotkitEmitMessage");
 async function copilotkitEmitToolCall(config, name, args) {
-  await (0, import_dispatch.dispatchCustomEvent)("copilotkit_manually_emit_tool_call", {
-    name,
-    args,
-    id: (0, import_shared.randomId)()
-  }, config);
+  if (!config) {
+    throw new import_shared.CopilotKitMisuseError({
+      message: "LangGraph configuration is required for copilotkitEmitToolCall"
+    });
+  }
+  if (!name || typeof name !== "string") {
+    throw new import_shared.CopilotKitMisuseError({
+      message: "Tool name must be a non-empty string for copilotkitEmitToolCall"
+    });
+  }
+  if (args === void 0) {
+    throw new import_shared.CopilotKitMisuseError({
+      message: "Tool arguments are required for copilotkitEmitToolCall"
+    });
+  }
+  try {
+    await (0, import_dispatch.dispatchCustomEvent)("copilotkit_manually_emit_tool_call", {
+      name,
+      args,
+      id: (0, import_shared.randomId)()
+    }, config);
+  } catch (error) {
+    throw new import_shared.CopilotKitMisuseError({
+      message: `Failed to emit tool call '${name}': ${error instanceof Error ? error.message : String(error)}`
+    });
+  }
 }
 __name(copilotkitEmitToolCall, "copilotkitEmitToolCall");
 function convertActionToDynamicStructuredTool(actionInput) {
-  return new import_tools.DynamicStructuredTool({
-    name: actionInput.name,
-    description: actionInput.description,
-    schema: (0, import_shared.convertJsonSchemaToZodSchema)(actionInput.parameters, true),
-    func: async () => {
-      return "";
-    }
-  });
+  if (!actionInput) {
+    throw new import_shared.CopilotKitMisuseError({
+      message: "Action input is required but was not provided"
+    });
+  }
+  if (!actionInput.name || typeof actionInput.name !== "string") {
+    throw new import_shared.CopilotKitMisuseError({
+      message: "Action must have a valid 'name' property of type string"
+    });
+  }
+  if (!actionInput.description || typeof actionInput.description !== "string") {
+    throw new import_shared.CopilotKitMisuseError({
+      message: `Action '${actionInput.name}' must have a valid 'description' property of type string`
+    });
+  }
+  if (!actionInput.parameters) {
+    throw new import_shared.CopilotKitMisuseError({
+      message: `Action '${actionInput.name}' must have a 'parameters' property`
+    });
+  }
+  try {
+    return new import_tools.DynamicStructuredTool({
+      name: actionInput.name,
+      description: actionInput.description,
+      schema: (0, import_shared.convertJsonSchemaToZodSchema)(actionInput.parameters, true),
+      func: async () => {
+        return "";
+      }
+    });
+  } catch (error) {
+    throw new import_shared.CopilotKitMisuseError({
+      message: `Failed to convert action '${actionInput.name}' to DynamicStructuredTool: ${error instanceof Error ? error.message : String(error)}`
+    });
+  }
 }
 __name(convertActionToDynamicStructuredTool, "convertActionToDynamicStructuredTool");
 function convertActionsToDynamicStructuredTools(actions) {
-  return actions.map((action) => convertActionToDynamicStructuredTool(action));
+  if (!Array.isArray(actions)) {
+    throw new import_shared.CopilotKitMisuseError({
+      message: "Actions must be an array"
+    });
+  }
+  return actions.map((action, index) => {
+    try {
+      return convertActionToDynamicStructuredTool(action);
+    } catch (error) {
+      throw new import_shared.CopilotKitMisuseError({
+        message: `Failed to convert action at index ${index}: ${error instanceof Error ? error.message : String(error)}`
+      });
+    }
+  });
 }
 __name(convertActionsToDynamicStructuredTools, "convertActionsToDynamicStructuredTools");