@copilotkitnext/core 0.0.10 → 0.0.12

package/dist/index.d.mts

@@ -27,8 +27,8 @@ type FrontendTool<T extends Record<string, unknown> = Record<string, unknown>> =
 interface CopilotKitCoreConfig {
     /** The endpoint of the CopilotRuntime. */
     runtimeUrl?: string;
-    /** Mapping from agent name to its `AbstractAgent` instance. */
-    agents?: Record<string, AbstractAgent>;
+    /** Mapping from agent name to its `AbstractAgent` instance. For development only - production requires CopilotRuntime. */
+    agents__unsafe_dev_only?: Record<string, AbstractAgent>;
     /** Headers appended to every HTTP request made by `CopilotKitCore`. */
     headers?: Record<string, string>;
     /** Properties sent as `forwardedProps` to the AG-UI agent. */
@@ -112,8 +112,8 @@ declare enum CopilotKitCoreRuntimeConnectionStatus {
     Error = "error"
 }
 declare class CopilotKitCore {
-    headers: Record<string, string>;
-    properties: Record<string, unknown>;
+    private _headers;
+    private _properties;
     private _context;
     private _agents;
     private _tools;
@@ -123,7 +123,9 @@ declare class CopilotKitCore {
     private _runtimeUrl?;
     private _runtimeVersion?;
     private _runtimeConnectionStatus;
-    constructor({ runtimeUrl, headers, properties, agents, tools, }: CopilotKitCoreConfig);
+    constructor({ runtimeUrl, headers, properties, agents__unsafe_dev_only, tools, }: CopilotKitCoreConfig);
+    private applyHeadersToAgent;
+    private applyHeadersToAgents;
     private assignAgentIds;
     private notifySubscribers;
     private emitError;
@@ -137,6 +139,8 @@ declare class CopilotKitCore {
     get runtimeUrl(): string | undefined;
     setRuntimeUrl(runtimeUrl: string | undefined): void;
     get runtimeVersion(): string | undefined;
+    get headers(): Readonly<Record<string, string>>;
+    get properties(): Readonly<Record<string, unknown>>;
     get runtimeConnectionStatus(): CopilotKitCoreRuntimeConnectionStatus;
     /**
      * Runtime connection
@@ -147,9 +151,9 @@ declare class CopilotKitCore {
      */
     setHeaders(headers: Record<string, string>): void;
     setProperties(properties: Record<string, unknown>): void;
-    setAgents(agents: Record<string, AbstractAgent>): void;
-    addAgent({ id, agent }: CopilotKitCoreAddAgentParams): void;
-    removeAgent(id: string): void;
+    setAgents__unsafe_dev_only(agents: Record<string, AbstractAgent>): void;
+    addAgent__unsafe_dev_only({ id, agent }: CopilotKitCoreAddAgentParams): void;
+    removeAgent__unsafe_dev_only(id: string): void;
     getAgent(id: string): AbstractAgent | undefined;
     /**
      * Context management
@@ -179,8 +183,8 @@ declare class CopilotKitCore {
     /**
      * Agent connectivity
      */
-    connectAgent({ agent, agentId, }: CopilotKitCoreConnectAgentParams): Promise<RunAgentResult>;
-    runAgent({ agent, withMessages, agentId, }: CopilotKitCoreRunAgentParams): Promise<RunAgentResult>;
+    connectAgent({ agent, agentId }: CopilotKitCoreConnectAgentParams): Promise<RunAgentResult>;
+    runAgent({ agent, withMessages, agentId }: CopilotKitCoreRunAgentParams): Promise<RunAgentResult>;
     private processAgentResult;
     private buildFrontendTools;
     private createAgentErrorSubscriber;

package/dist/index.d.ts

@@ -27,8 +27,8 @@ type FrontendTool<T extends Record<string, unknown> = Record<string, unknown>> =
 interface CopilotKitCoreConfig {
     /** The endpoint of the CopilotRuntime. */
     runtimeUrl?: string;
-    /** Mapping from agent name to its `AbstractAgent` instance. */
-    agents?: Record<string, AbstractAgent>;
+    /** Mapping from agent name to its `AbstractAgent` instance. For development only - production requires CopilotRuntime. */
+    agents__unsafe_dev_only?: Record<string, AbstractAgent>;
     /** Headers appended to every HTTP request made by `CopilotKitCore`. */
     headers?: Record<string, string>;
     /** Properties sent as `forwardedProps` to the AG-UI agent. */
@@ -112,8 +112,8 @@ declare enum CopilotKitCoreRuntimeConnectionStatus {
     Error = "error"
 }
 declare class CopilotKitCore {
-    headers: Record<string, string>;
-    properties: Record<string, unknown>;
+    private _headers;
+    private _properties;
     private _context;
     private _agents;
     private _tools;
@@ -123,7 +123,9 @@ declare class CopilotKitCore {
     private _runtimeUrl?;
     private _runtimeVersion?;
     private _runtimeConnectionStatus;
-    constructor({ runtimeUrl, headers, properties, agents, tools, }: CopilotKitCoreConfig);
+    constructor({ runtimeUrl, headers, properties, agents__unsafe_dev_only, tools, }: CopilotKitCoreConfig);
+    private applyHeadersToAgent;
+    private applyHeadersToAgents;
     private assignAgentIds;
     private notifySubscribers;
     private emitError;
@@ -137,6 +139,8 @@ declare class CopilotKitCore {
     get runtimeUrl(): string | undefined;
     setRuntimeUrl(runtimeUrl: string | undefined): void;
     get runtimeVersion(): string | undefined;
+    get headers(): Readonly<Record<string, string>>;
+    get properties(): Readonly<Record<string, unknown>>;
     get runtimeConnectionStatus(): CopilotKitCoreRuntimeConnectionStatus;
     /**
      * Runtime connection
@@ -147,9 +151,9 @@ declare class CopilotKitCore {
      */
     setHeaders(headers: Record<string, string>): void;
     setProperties(properties: Record<string, unknown>): void;
-    setAgents(agents: Record<string, AbstractAgent>): void;
-    addAgent({ id, agent }: CopilotKitCoreAddAgentParams): void;
-    removeAgent(id: string): void;
+    setAgents__unsafe_dev_only(agents: Record<string, AbstractAgent>): void;
+    addAgent__unsafe_dev_only({ id, agent }: CopilotKitCoreAddAgentParams): void;
+    removeAgent__unsafe_dev_only(id: string): void;
     getAgent(id: string): AbstractAgent | undefined;
     /**
      * Context management
@@ -179,8 +183,8 @@ declare class CopilotKitCore {
     /**
      * Agent connectivity
      */
-    connectAgent({ agent, agentId, }: CopilotKitCoreConnectAgentParams): Promise<RunAgentResult>;
-    runAgent({ agent, withMessages, agentId, }: CopilotKitCoreRunAgentParams): Promise<RunAgentResult>;
+    connectAgent({ agent, agentId }: CopilotKitCoreConnectAgentParams): Promise<RunAgentResult>;
+    runAgent({ agent, withMessages, agentId }: CopilotKitCoreRunAgentParams): Promise<RunAgentResult>;
     private processAgentResult;
     private buildFrontendTools;
     private createAgentErrorSubscriber;

package/dist/index.js

@@ -73,8 +73,8 @@ var CopilotKitCoreRuntimeConnectionStatus = /* @__PURE__ */ ((CopilotKitCoreRunt
   return CopilotKitCoreRuntimeConnectionStatus2;
 })(CopilotKitCoreRuntimeConnectionStatus || {});
 var CopilotKitCore = class {
-  headers;
-  properties;
+  _headers;
+  _properties;
   _context = {};
   _agents = {};
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -89,16 +89,27 @@ var CopilotKitCore = class {
     runtimeUrl,
     headers = {},
     properties = {},
-    agents = {},
+    agents__unsafe_dev_only = {},
     tools = []
   }) {
-    this.headers = headers;
-    this.properties = properties;
-    this.localAgents = this.assignAgentIds(agents);
+    this._headers = headers;
+    this._properties = properties;
+    this.localAgents = this.assignAgentIds(agents__unsafe_dev_only);
+    this.applyHeadersToAgents(this.localAgents);
     this._agents = this.localAgents;
     this._tools = tools;
     this.setRuntimeUrl(runtimeUrl);
   }
+  applyHeadersToAgent(agent) {
+    if (agent instanceof import_client2.HttpAgent) {
+      agent.headers = { ...this.headers };
+    }
+  }
+  applyHeadersToAgents(agents) {
+    Object.values(agents).forEach((agent) => {
+      this.applyHeadersToAgent(agent);
+    });
+  }
   assignAgentIds(agents) {
     Object.entries(agents).forEach(([id, agent]) => {
       if (agent && !agent.agentId) {
@@ -176,6 +187,12 @@ var CopilotKitCore = class {
   get runtimeVersion() {
     return this._runtimeVersion;
   }
+  get headers() {
+    return this._headers;
+  }
+  get properties() {
+    return this._properties;
+  }
   get runtimeConnectionStatus() {
     return this._runtimeConnectionStatus;
   }
@@ -227,6 +244,7 @@ var CopilotKitCore = class {
             agentId: id,
             description
           });
+          this.applyHeadersToAgent(agent);
           return [id, agent];
         })
       );
@@ -268,9 +286,7 @@ var CopilotKitCore = class {
         "Subscriber onAgentsChanged error:"
       );
       const message = error instanceof Error ? error.message : JSON.stringify(error);
-      import_shared.logger.warn(
-        `Failed to load runtime info (${this.runtimeUrl}/info): ${message}`
-      );
+      import_shared.logger.warn(`Failed to load runtime info (${this.runtimeUrl}/info): ${message}`);
       const runtimeError = error instanceof Error ? error : new Error(String(error));
       await this.emitError({
         error: runtimeError,
@@ -285,7 +301,8 @@ var CopilotKitCore = class {
    * Configuration updates
    */
   setHeaders(headers) {
-    this.headers = headers;
+    this._headers = headers;
+    this.applyHeadersToAgents(this._agents);
     void this.notifySubscribers(
       (subscriber) => subscriber.onHeadersChanged?.({
         copilotkit: this,
@@ -295,7 +312,7 @@ var CopilotKitCore = class {
     );
   }
   setProperties(properties) {
-    this.properties = properties;
+    this._properties = properties;
     void this.notifySubscribers(
       (subscriber) => subscriber.onPropertiesChanged?.({
         copilotkit: this,
@@ -304,9 +321,10 @@ var CopilotKitCore = class {
       "Subscriber onPropertiesChanged error:"
     );
   }
-  setAgents(agents) {
+  setAgents__unsafe_dev_only(agents) {
     this.localAgents = this.assignAgentIds(agents);
     this._agents = { ...this.localAgents, ...this.remoteAgents };
+    this.applyHeadersToAgents(this._agents);
     void this.notifySubscribers(
       (subscriber) => subscriber.onAgentsChanged?.({
         copilotkit: this,
@@ -315,11 +333,12 @@ var CopilotKitCore = class {
       "Subscriber onAgentsChanged error:"
     );
   }
-  addAgent({ id, agent }) {
+  addAgent__unsafe_dev_only({ id, agent }) {
     this.localAgents[id] = agent;
     if (!agent.agentId) {
       agent.agentId = id;
     }
+    this.applyHeadersToAgent(agent);
     this._agents = { ...this.localAgents, ...this.remoteAgents };
     void this.notifySubscribers(
       (subscriber) => subscriber.onAgentsChanged?.({
@@ -329,7 +348,7 @@ var CopilotKitCore = class {
       "Subscriber onAgentsChanged error:"
     );
   }
-  removeAgent(id) {
+  removeAgent__unsafe_dev_only(id) {
     delete this.localAgents[id];
     this._agents = { ...this.localAgents, ...this.remoteAgents };
     void this.notifySubscribers(
@@ -380,13 +399,9 @@ var CopilotKitCore = class {
    * Tool management
    */
   addTool(tool) {
-    const existingToolIndex = this._tools.findIndex(
-      (t) => t.name === tool.name && t.agentId === tool.agentId
-    );
+    const existingToolIndex = this._tools.findIndex((t) => t.name === tool.name && t.agentId === tool.agentId);
     if (existingToolIndex !== -1) {
-      import_shared.logger.warn(
-        `Tool already exists: '${tool.name}' for agent '${tool.agentId || "global"}', skipping.`
-      );
+      import_shared.logger.warn(`Tool already exists: '${tool.name}' for agent '${tool.agentId || "global"}', skipping.`);
       return;
     }
     this._tools.push(tool);
@@ -407,9 +422,7 @@ var CopilotKitCore = class {
   getTool(params) {
     const { toolName, agentId } = params;
     if (agentId) {
-      const agentTool = this._tools.find(
-        (tool) => tool.name === toolName && tool.agentId === agentId
-      );
+      const agentTool = this._tools.find((tool) => tool.name === toolName && tool.agentId === agentId);
       if (agentTool) {
         return agentTool;
       }
@@ -437,10 +450,7 @@ var CopilotKitCore = class {
   /**
    * Agent connectivity
    */
-  async connectAgent({
-    agent,
-    agentId
-  }) {
+  async connectAgent({ agent, agentId }) {
     try {
       if (agent instanceof import_client2.HttpAgent) {
         agent.headers = { ...this.headers };
@@ -467,11 +477,7 @@ var CopilotKitCore = class {
       throw error;
     }
   }
-  async runAgent({
-    agent,
-    withMessages,
-    agentId
-  }) {
+  async runAgent({ agent, withMessages, agentId }) {
     if (agent instanceof import_client2.HttpAgent) {
       agent.headers = { ...this.headers };
     }
@@ -515,9 +521,7 @@ var CopilotKitCore = class {
     for (const message of newMessages) {
       if (message.role === "assistant") {
         for (const toolCall of message.toolCalls || []) {
-          if (newMessages.findIndex(
-            (m) => m.role === "tool" && m.toolCallId === toolCall.id
-          ) === -1) {
+          if (newMessages.findIndex((m) => m.role === "tool" && m.toolCallId === toolCall.id) === -1) {
             const tool = this.getTool({
               toolName: toolCall.function.name,
               agentId
@@ -562,10 +566,7 @@ var CopilotKitCore = class {
                 );
                 if (!errorMessage) {
                   try {
-                    const result = await tool.handler(
-                      parsedArgs,
-                      toolCall
-                    );
+                    const result = await tool.handler(parsedArgs, toolCall);
                     if (result === void 0 || result === null) {
                       toolCallResult = "";
                     } else if (typeof result === "string") {
@@ -609,9 +610,7 @@ var CopilotKitCore = class {
                 }
               }
               if (!errorMessage || !isArgumentError) {
-                const messageIndex = agent.messages.findIndex(
-                  (m) => m.id === message.id
-                );
+                const messageIndex = agent.messages.findIndex((m) => m.id === message.id);
                 const toolMessage = {
                   id: (0, import_shared.randomUUID)(),
                   role: "tool",
@@ -669,10 +668,7 @@ var CopilotKitCore = class {
                   );
                   if (!errorMessage) {
                     try {
-                      const result = await wildcardTool.handler(
-                        wildcardArgs,
-                        toolCall
-                      );
+                      const result = await wildcardTool.handler(wildcardArgs, toolCall);
                       if (result === void 0 || result === null) {
                         toolCallResult = "";
                       } else if (typeof result === "string") {
@@ -716,9 +712,7 @@ var CopilotKitCore = class {
                   }
                 }
                 if (!errorMessage || !isArgumentError) {
-                  const messageIndex = agent.messages.findIndex(
-                    (m) => m.id === message.id
-                  );
+                  const messageIndex = agent.messages.findIndex((m) => m.id === message.id);
                   const toolMessage = {
                     id: (0, import_shared.randomUUID)(),
                     role: "tool",
@@ -762,13 +756,9 @@ var CopilotKitCore = class {
     };
     return {
       onRunFailed: async ({ error }) => {
-        await emitAgentError(
-          error,
-          "agent_run_failed_event" /* AGENT_RUN_FAILED_EVENT */,
-          {
-            source: "onRunFailed"
-          }
-        );
+        await emitAgentError(error, "agent_run_failed_event" /* AGENT_RUN_FAILED_EVENT */, {
+          source: "onRunFailed"
+        });
       },
       onRunErrorEvent: async ({ event }) => {
         const eventError = event?.rawEvent instanceof Error ? event.rawEvent : event?.rawEvent?.error instanceof Error ? event.rawEvent.error : void 0;
@@ -777,15 +767,11 @@ var CopilotKitCore = class {
         if (event?.code && !rawError.code) {
           rawError.code = event.code;
         }
-        await emitAgentError(
-          rawError,
-          "agent_run_error_event" /* AGENT_RUN_ERROR_EVENT */,
-          {
-            source: "onRunErrorEvent",
-            event,
-            runtimeErrorCode: event?.code
-          }
-        );
+        await emitAgentError(rawError, "agent_run_error_event" /* AGENT_RUN_ERROR_EVENT */, {
+          source: "onRunErrorEvent",
+          event,
+          runtimeErrorCode: event?.code
+        });
       }
     };
   }