Method constructor

packages/core/src/core/core.ts:388–491

({
    runtimeUrl,
    runtimeTransport = "auto",
    headers = {},
    credentials,
    properties = {},
    agents__unsafe_dev_only = {},
    tools = [],
    suggestionsConfig = [],
    debug,
  }: CopilotKitCoreConfig)

  private previousAgentIds: Set<string> = new Set();

  constructor({
    runtimeUrl,
    runtimeTransport = "auto",
    headers = {},
    credentials,
    properties = {},
    agents__unsafe_dev_only = {},
    tools = [],
    suggestionsConfig = [],
    debug,
  }: CopilotKitCoreConfig) {
    this._headers = normalizeHeaders(headers);
    this._credentials = credentials;
    this._properties = properties;
    this._debug = debug;

    // Initialize delegate classes
    this.agentRegistry = new AgentRegistry(this);
    this.contextStore = new ContextStore(this);
    this.suggestionEngine = new SuggestionEngine(this);
    this.runHandler = new RunHandler(this);
    this.stateManager = new StateManager(this);
    this.threadStoreRegistry = new ThreadStoreRegistry(this);

    // Initialize each subsystem
    this.agentRegistry.initialize(agents__unsafe_dev_only);
    this.runHandler.initialize(tools);
    this.suggestionEngine.initialize(suggestionsConfig);
    this.stateManager.initialize();

    this.agentRegistry.setRuntimeTransport(runtimeTransport);
    this.agentRegistry.setRuntimeUrl(runtimeUrl);

    // Seed the previous-agents snapshot from the constructor-supplied agents.
    // `agentRegistry.initialize` does not emit `onAgentsChanged`, so the
    // subscriber below would otherwise see its first non-empty notification
    // as an "addition" relative to an empty baseline — and a later removal
    // of those same agents would NOT trigger the auto-unregister branch
    // because the guard would think the agentId was never previously
    // present. Seeding the set here keeps the guard honest.
    this.previousAgentIds = new Set(Object.keys(agents__unsafe_dev_only));

    // Subscribe to agent changes to track state for new agents
    this.subscribe({
      onAgentsChanged: ({ agents }) => {
        Object.values(agents).forEach((agent) => {
          if (agent.agentId) {
            this.stateManager.subscribeToAgent(agent);
          }
        });

        // Unregister thread stores for agents that have been removed.
        //
        // Critically, only unregister an agentId that was present in the
        // PREVIOUS agents snapshot AND is missing from the new one. Without
        // the "previously had" guard, the FIRST `onAgentsChanged({ agents: {} })`
        // delivered to a freshly-published core would tear out a thread store
        // that a consumer (e.g. useThreads) just registered — `core.agents`