@copilotkit/react-core 1.57.3 → 1.58.0

package/src/lib/status-checker.ts

@@ -1,67 +0,0 @@
-import {
-  COPILOT_CLOUD_API_URL,
-  COPILOT_CLOUD_PUBLIC_API_KEY_HEADER,
-  Severity,
-} from "@copilotkit/shared";
-
-const STATUS_CHECK_INTERVAL = 1000 * 60 * 5; // 5 minutes
-
-export type Status = {
-  severity: Severity;
-  message: string;
-};
-
-export class StatusChecker {
-  private activeKey: string | null = null;
-  private intervalId: ReturnType<typeof setInterval> | null = null;
-  private instanceCount = 0;
-  private lastResponse: Status | null = null;
-
-  async start(
-    publicApiKey: string,
-    onUpdate?: (status: Status | null) => void,
-  ) {
-    this.instanceCount++;
-    if (this.activeKey === publicApiKey) return;
-
-    if (this.intervalId) clearInterval(this.intervalId);
-
-    const checkStatus = async () => {
-      try {
-        const response = await fetch(`${COPILOT_CLOUD_API_URL}/ciu`, {
-          method: "GET",
-          headers: {
-            [COPILOT_CLOUD_PUBLIC_API_KEY_HEADER]: publicApiKey,
-          },
-        }).then((response) => response.json() as Promise<Status>);
-        this.lastResponse = response;
-        onUpdate?.(response);
-        return response;
-      } catch (error) {
-        // Silently fail
-        return null;
-      }
-    };
-
-    const initialResponse = await checkStatus();
-    this.intervalId = setInterval(checkStatus, STATUS_CHECK_INTERVAL);
-    this.activeKey = publicApiKey;
-    return initialResponse;
-  }
-
-  getLastResponse() {
-    return this.lastResponse;
-  }
-
-  stop() {
-    this.instanceCount--;
-    if (this.instanceCount === 0) {
-      if (this.intervalId) {
-        clearInterval(this.intervalId);
-        this.intervalId = null;
-        this.activeKey = null;
-        this.lastResponse = null;
-      }
-    }
-  }
-}

package/src/setupTests.ts

@@ -1,37 +0,0 @@
-import { vi } from "vitest";
-import { z } from "zod";
-
-// Mock modules that cause ES module issues
-vi.mock("@segment/analytics-node", () => ({
-  Analytics: vi.fn().mockImplementation(() => ({
-    track: vi.fn(),
-    identify: vi.fn(),
-    page: vi.fn(),
-    group: vi.fn(),
-    alias: vi.fn(),
-  })),
-}));
-
-vi.mock("@copilotkit/shared", async (importOriginal) => {
-  const actual = await importOriginal<typeof import("@copilotkit/shared")>();
-  return {
-    ...actual,
-    parseJson: vi.fn((jsonString, defaultValue) => {
-      try {
-        return JSON.parse(jsonString);
-      } catch {
-        return defaultValue;
-      }
-    }),
-    dataToUUID: vi.fn((data) => JSON.stringify(data)),
-    getZodParameters: vi.fn(() => z.object({})),
-    randomId: vi.fn(() => "test-random-id"),
-    CopilotKitAgentDiscoveryError: vi.fn(),
-    randomUUID: vi.fn(() => "mock-thread-id"),
-  };
-});
-
-// Mock react-dom/test-utils to avoid compatibility issues
-vi.mock("react-dom/test-utils", () => ({
-  act: vi.fn((fn) => fn()),
-}));

package/src/test-helpers/copilot-context.ts

@@ -1,91 +0,0 @@
-import type { CopilotContextParams, CopilotApiConfig } from "../context";
-
-const noop = () => {};
-
-const copilotApiConfig: CopilotApiConfig = {
-  chatApiEndpoint: "http://localhost",
-  headers: {},
-};
-
-export function createTestCopilotContext(
-  overrides: Partial<CopilotContextParams> = {},
-): CopilotContextParams {
-  return {
-    actions: {},
-    setAction: noop,
-    removeAction: noop,
-
-    setRegisteredActions: () => "action-id",
-    removeRegisteredAction: noop,
-
-    chatComponentsCache: { current: { actions: {}, coAgentStateRenders: {} } },
-    getFunctionCallHandler: () => async () => {},
-
-    addContext: () => "context-id",
-    removeContext: noop,
-    getAllContext: () => [],
-    getContextString: () => "",
-
-    addDocumentContext: () => "document-id",
-    removeDocumentContext: noop,
-    getDocumentsContext: () => [],
-
-    isLoading: false,
-    setIsLoading: noop,
-
-    chatSuggestionConfiguration: {},
-    addChatSuggestionConfiguration: noop,
-    removeChatSuggestionConfiguration: noop,
-
-    chatInstructions: "",
-    setChatInstructions: noop,
-
-    additionalInstructions: [],
-    setAdditionalInstructions: noop,
-
-    copilotApiConfig,
-
-    showDevConsole: false,
-
-    coagentStates: {},
-    setCoagentStates: noop,
-    coagentStatesRef: { current: {} },
-    setCoagentStatesWithRef: noop,
-
-    agentSession: null,
-    setAgentSession: noop,
-
-    agentLock: null,
-
-    threadId: "",
-    setThreadId: noop,
-
-    runId: null,
-    setRunId: noop,
-
-    chatAbortControllerRef: { current: null },
-
-    forwardedParameters: {},
-    availableAgents: [],
-
-    extensions: {},
-    setExtensions: noop,
-
-    interruptActions: {},
-    setInterruptAction: noop,
-    removeInterruptAction: noop,
-    interruptEventQueue: {},
-    addInterruptEvent: noop,
-    resolveInterruptEvent: noop,
-
-    onError: noop,
-
-    bannerError: null,
-    setBannerError: noop,
-    internalErrorHandlers: {},
-    setInternalErrorHandler: noop,
-    removeInternalErrorHandler: noop,
-
-    ...overrides,
-  };
-}

package/src/types/chat-suggestion-configuration.ts

@@ -1,23 +0,0 @@
-export interface CopilotChatSuggestionConfiguration {
-  /**
-   * A prompt or instructions for the GPT to generate suggestions.
-   */
-  instructions: string;
-
-  /**
-   * The minimum number of suggestions to generate. Defaults to `1`.
-   * @default 1
-   */
-  minSuggestions?: number;
-
-  /**
-   * The maximum number of suggestions to generate. Defaults to `3`.
-   * @default 1
-   */
-  maxSuggestions?: number;
-
-  /**
-   * An optional class name to apply to the suggestions.
-   */
-  className?: string;
-}

package/src/types/coagent-action.ts

@@ -1,35 +0,0 @@
-export type CoAgentStateRenderProps<T> = {
-  state: T;
-  nodeName: string;
-  status: "inProgress" | "complete";
-};
-
-export type CoAgentStateRenderHandlerArguments<T> = {
-  nodeName: string;
-  state: T;
-};
-
-export interface CoAgentStateRender<T = any> {
-  /**
-   * The name of the coagent.
-   */
-  name: string;
-  /**
-   * The node name of the coagent.
-   */
-  nodeName?: string;
-  /**
-   * The handler function to handle the state of the agent.
-   */
-  handler?: (
-    props: CoAgentStateRenderHandlerArguments<T>,
-  ) => void | Promise<void>;
-  /**
-   * The render function to handle the state of the agent.
-   */
-  render?:
-    | ((
-        props: CoAgentStateRenderProps<T>,
-      ) => string | React.ReactElement | undefined | null)
-    | string;
-}

package/src/types/coagent-state.ts

@@ -1,13 +0,0 @@
-export interface CoagentState {
-  name: string;
-  state: any;
-  running: boolean;
-  active: boolean;
-  threadId?: string;
-  config?: {
-    configurable?: Record<string, any>;
-    [key: string]: any;
-  };
-  nodeName?: string;
-  runId?: string;
-}

package/src/types/crew.ts

@@ -1,89 +0,0 @@
-/**
- * Status of a response or action that requires user input
- */
-export type CrewsResponseStatus = "inProgress" | "complete" | "executing";
-
-/**
- * Response data structure for the ResponseRenderer
- */
-export interface CrewsResponse {
-  /**
-   * Unique identifier for the response
-   */
-  id: string;
-
-  /**
-   * The content of the response to display
-   */
-  content: string;
-
-  /**
-   * Optional metadata for the response
-   */
-  metadata?: Record<string, any>;
-}
-
-/**
- * Base state item interface for agent state items
- */
-export interface CrewsStateItem {
-  /**
-   * Unique identifier for the item
-   */
-  id: string;
-
-  /**
-   * Timestamp when the item was created
-   */
-  timestamp: string;
-}
-
-/**
- * Tool execution state item
- */
-export interface CrewsToolStateItem extends CrewsStateItem {
-  /**
-   * Name of the tool that was executed
-   */
-  tool: string;
-
-  /**
-   * Optional thought process for the tool execution
-   */
-  thought?: string;
-
-  /**
-   * Result of the tool execution
-   */
-  result?: any;
-}
-
-/**
- * Task state item
- */
-export interface CrewsTaskStateItem extends CrewsStateItem {
-  /**
-   * Name of the task
-   */
-  name: string;
-
-  /**
-   * Description of the task
-   */
-  description?: string;
-}
-
-/**
- * AgentState containing information about steps and tasks
- */
-export interface CrewsAgentState {
-  /**
-   * Array of tool execution steps
-   */
-  steps?: CrewsToolStateItem[];
-
-  /**
-   * Array of tasks
-   */
-  tasks?: CrewsTaskStateItem[];
-}

package/src/types/document-pointer.ts

@@ -1,7 +0,0 @@
-export interface DocumentPointer {
-  id: string;
-  name: string;
-  sourceApplication: string;
-  iconImageUri: string;
-  getContents: () => string;
-}

package/src/types/frontend-action.ts

@@ -1,213 +0,0 @@
-import { ActionInputAvailability } from "@copilotkit/runtime-client-gql";
-import {
-  Action,
-  Parameter,
-  MappedParameterTypes,
-  actionParametersToJsonSchema,
-} from "@copilotkit/shared";
-import React from "react";
-
-interface InProgressState<T extends Parameter[] | [] = []> {
-  status: "inProgress";
-  args: Partial<MappedParameterTypes<T>>;
-  result: undefined;
-}
-
-interface ExecutingState<T extends Parameter[] | [] = []> {
-  status: "executing";
-  args: MappedParameterTypes<T>;
-  result: undefined;
-}
-
-interface CompleteState<T extends Parameter[] | [] = []> {
-  status: "complete";
-  args: MappedParameterTypes<T>;
-  result: any;
-}
-
-interface InProgressStateNoArgs<T extends Parameter[] | [] = []> {
-  status: "inProgress";
-  args: Partial<MappedParameterTypes<T>>;
-  result: undefined;
-}
-
-interface ExecutingStateNoArgs<T extends Parameter[] | [] = []> {
-  status: "executing";
-  args: MappedParameterTypes<T>;
-  result: undefined;
-}
-
-interface CompleteStateNoArgs<T extends Parameter[] | [] = []> {
-  status: "complete";
-  args: MappedParameterTypes<T>;
-  result: any;
-}
-
-interface InProgressStateWait<T extends Parameter[] | [] = []> {
-  status: "inProgress";
-  args: Partial<MappedParameterTypes<T>>;
-  /** @deprecated use respond instead */
-  handler: undefined;
-  respond: undefined;
-  result: undefined;
-}
-
-interface ExecutingStateWait<T extends Parameter[] | [] = []> {
-  status: "executing";
-  args: MappedParameterTypes<T>;
-  /** @deprecated use respond instead */
-  handler: (result: any) => void;
-  respond: (result: any) => void;
-  result: undefined;
-}
-
-interface CompleteStateWait<T extends Parameter[] | [] = []> {
-  status: "complete";
-  args: MappedParameterTypes<T>;
-  /** @deprecated use respond instead */
-  handler: undefined;
-  respond: undefined;
-  result: any;
-}
-
-interface InProgressStateNoArgsWait<T extends Parameter[] | [] = []> {
-  status: "inProgress";
-  args: Partial<MappedParameterTypes<T>>;
-  /** @deprecated use respond instead */
-  handler: undefined;
-  respond: undefined;
-  result: undefined;
-}
-
-interface ExecutingStateNoArgsWait<T extends Parameter[] | [] = []> {
-  status: "executing";
-  args: MappedParameterTypes<T>;
-  /** @deprecated use respond instead */
-  handler: (result: any) => void;
-  respond: (result: any) => void;
-  result: undefined;
-}
-
-interface CompleteStateNoArgsWait<T extends Parameter[] | [] = []> {
-  status: "complete";
-  args: MappedParameterTypes<T>;
-  /** @deprecated use respond instead */
-  handler: undefined;
-  respond: undefined;
-}
-
-export type ActionRenderProps<T extends Parameter[] | [] = []> =
-  | CompleteState<T>
-  | ExecutingState<T>
-  | InProgressState<T>;
-
-export type ActionRenderPropsNoArgs<T extends Parameter[] | [] = []> =
-  | CompleteStateNoArgs<T>
-  | ExecutingStateNoArgs<T>
-  | InProgressStateNoArgs<T>;
-
-export type ActionRenderPropsWait<T extends Parameter[] | [] = []> =
-  | CompleteStateWait<T>
-  | ExecutingStateWait<T>
-  | InProgressStateWait<T>;
-
-export type ActionRenderPropsNoArgsWait<T extends Parameter[] | [] = []> =
-  | CompleteStateNoArgsWait<T>
-  | ExecutingStateNoArgsWait<T>
-  | InProgressStateNoArgsWait<T>;
-
-export type CatchAllActionRenderProps<T extends Parameter[] | [] = []> =
-  | (CompleteState<T> & {
-      name: string;
-    })
-  | (ExecutingState<T> & {
-      name: string;
-    })
-  | (InProgressState<T> & {
-      name: string;
-    });
-
-export type FrontendActionAvailability =
-  | "disabled"
-  | "enabled"
-  | "remote"
-  | "frontend";
-
-export type FrontendAction<
-  T extends Parameter[] | [] = [],
-  N extends string = string,
-> = Action<T> & {
-  name: Exclude<N, "*">;
-  /**
-   * @deprecated Use `available` instead.
-   */
-  disabled?: boolean;
-  available?: FrontendActionAvailability;
-  pairedAction?: string;
-  followUp?: boolean;
-} & (
-    | {
-        render?:
-          | string
-          | (T extends []
-              ? (
-                  props: ActionRenderPropsNoArgs<T>,
-                ) => string | React.ReactElement
-              : (props: ActionRenderProps<T>) => string | React.ReactElement);
-        /** @deprecated use renderAndWaitForResponse instead */
-        renderAndWait?: never;
-        renderAndWaitForResponse?: never;
-      }
-    | {
-        render?: never;
-        /** @deprecated use renderAndWaitForResponse instead */
-        renderAndWait?: T extends []
-          ? (props: ActionRenderPropsNoArgsWait<T>) => React.ReactElement
-          : (props: ActionRenderPropsWait<T>) => React.ReactElement;
-        renderAndWaitForResponse?: T extends []
-          ? (props: ActionRenderPropsNoArgsWait<T>) => React.ReactElement
-          : (props: ActionRenderPropsWait<T>) => React.ReactElement;
-        handler?: never;
-      }
-  );
-
-export type CatchAllFrontendAction = {
-  name: "*";
-  render: (props: CatchAllActionRenderProps<any>) => React.ReactElement;
-};
-
-export type RenderFunctionStatus = ActionRenderProps<any>["status"];
-
-export function processActionsForRuntimeRequest(
-  actions: FrontendAction<any>[],
-) {
-  const filteredActions = actions
-    .filter(
-      (action) =>
-        action.available !== ActionInputAvailability.Disabled &&
-        action.disabled !== true &&
-        action.name !== "*" &&
-        action.available != "frontend" &&
-        !action.pairedAction,
-    )
-    .map((action) => {
-      let available: ActionInputAvailability | undefined =
-        ActionInputAvailability.Enabled;
-      if (action.disabled) {
-        available = ActionInputAvailability.Disabled;
-      } else if (action.available === "disabled") {
-        available = ActionInputAvailability.Disabled;
-      } else if (action.available === "remote") {
-        available = ActionInputAvailability.Remote;
-      }
-      return {
-        name: action.name,
-        description: action.description || "",
-        jsonSchema: JSON.stringify(
-          actionParametersToJsonSchema(action.parameters || []),
-        ),
-        available,
-      };
-    });
-  return filteredActions;
-}

package/src/types/index.ts

@@ -1,17 +0,0 @@
-export type { DocumentPointer } from "./document-pointer";
-export type { SystemMessageFunction } from "./system-message";
-export type {
-  ActionRenderProps,
-  ActionRenderPropsNoArgs,
-  ActionRenderPropsWait,
-  ActionRenderPropsNoArgsWait,
-  FrontendAction,
-  FrontendActionAvailability,
-  RenderFunctionStatus,
-  CatchAllActionRenderProps,
-  CatchAllFrontendAction,
-} from "./frontend-action";
-
-export type { CopilotChatSuggestionConfiguration } from "./chat-suggestion-configuration";
-export * from "./crew";
-export * from "./interrupt-action";

package/src/types/interrupt-action.ts

@@ -1,58 +0,0 @@
-import { LangGraphInterruptEvent } from "@copilotkit/runtime-client-gql";
-import { AgentSession } from "../context/copilot-context";
-
-export interface LangGraphInterruptRenderHandlerProps<TEventValue = any> {
-  event: LangGraphInterruptEvent<TEventValue>;
-  resolve: (resolution: string) => void;
-}
-
-export interface LangGraphInterruptRenderProps<TEventValue = any> {
-  result: unknown;
-  event: LangGraphInterruptEvent<TEventValue>;
-  resolve: (resolution: string) => void;
-}
-
-export interface LangGraphInterruptRender<TEventValue = any> {
-  id: string;
-  /**
-   * The handler function to handle the event.
-   */
-  handler?: (
-    props: LangGraphInterruptRenderHandlerProps<TEventValue>,
-  ) => any | Promise<any>;
-  /**
-   * The render function to handle the event.
-   */
-  render?: (
-    props: LangGraphInterruptRenderProps<TEventValue>,
-  ) => string | React.ReactElement;
-  /**
-   * Method that returns a boolean, indicating if the interrupt action should run
-   * Useful when using multiple interrupts
-   */
-  enabled?: (args: {
-    eventValue: TEventValue;
-    agentMetadata: AgentSession;
-  }) => boolean;
-  /**
-   * Optional agent ID to scope this interrupt to a specific agent.
-   * Defaults to the agent configured in the CopilotKit chat configuration.
-   */
-  agentId?: string;
-}
-
-export type LangGraphInterruptAction = LangGraphInterruptRender & {
-  event?: LangGraphInterruptEvent;
-};
-
-export type LangGraphInterruptActionSetterArgs =
-  Partial<LangGraphInterruptRender> | null;
-export type LangGraphInterruptActionSetter = (
-  action: LangGraphInterruptActionSetterArgs,
-) => void;
-
-export interface QueuedInterruptEvent {
-  eventId: string; // Generated unique ID for tracking
-  threadId: string;
-  event: LangGraphInterruptEvent;
-}

package/src/types/system-message.ts

@@ -1,4 +0,0 @@
-export type SystemMessageFunction = (
-  contextString: string,
-  additionalInstructions?: string,
-) => string;

package/src/utils/dev-console.ts

@@ -1,19 +0,0 @@
-function isLocalhost(): boolean {
-  if (typeof window === "undefined") return false;
-
-  return (
-    window.location.hostname === "localhost" ||
-    window.location.hostname === "127.0.0.1" ||
-    window.location.hostname === "0.0.0.0"
-  );
-}
-
-export function shouldShowDevConsole(showDevConsole?: boolean): boolean {
-  // If explicitly set, use that value
-  if (showDevConsole !== undefined) {
-    return showDevConsole;
-  }
-
-  // If not set, default to true on localhost
-  return isLocalhost();
-}

package/src/utils/index.ts

@@ -1,2 +0,0 @@
-export { SUGGESTION_RETRY_CONFIG } from "./suggestions-constants";
-export * from "./dev-console";

package/src/utils/suggestions-constants.ts

@@ -1,8 +0,0 @@
-/**
- * Constants for suggestions retry logic
- */
-
-export const SUGGESTION_RETRY_CONFIG = {
-  MAX_RETRIES: 3,
-  COOLDOWN_MS: 5000, // 5 seconds
-} as const;