@copilotkit/runtime 1.9.2-next.9 → 1.9.3-next.0

package/dist/service-adapters/index.mjs

@@ -11,7 +11,7 @@ import {
   OpenAIAssistantAdapter,
   RemoteChain,
   UnifyAdapter
-} from "../chunk-4JBKY7XT.mjs";
+} from "../chunk-QLLV2QVK.mjs";
 import {
   convertServiceAdapterError
 } from "../chunk-AMUJQ6IR.mjs";

package/dist/{shared-bd953ebf.d.ts → shared-96b46379.d.ts}

@@ -2,8 +2,8 @@ import * as graphql from 'graphql';
 import * as createPinoLogger from 'pino';
 import createPinoLogger__default from 'pino';
 import { YogaInitialContext, createYoga } from 'graphql-yoga';
-import { Parameter, Action, CopilotTraceHandler } from '@copilotkit/shared';
-import { b as CopilotServiceAdapter, A as ActionInput, d as AgentSessionInput, e as AgentStateInput, F as ForwardedParametersInput, E as ExtensionsInput, R as RemoteChainParameters, f as RuntimeEventSource, g as ExtensionsResponse } from './langserve-fc5cac89.js';
+import { Parameter, Action, CopilotErrorHandler } from '@copilotkit/shared';
+import { b as CopilotServiceAdapter, A as ActionInput, d as AgentSessionInput, e as AgentStateInput, F as ForwardedParametersInput, E as ExtensionsInput, R as RemoteChainParameters, f as RuntimeEventSource, g as ExtensionsResponse } from './langserve-3e8d0e06.js';
 import { M as MessageInput, a as Message } from './index-d4614f9b.js';
 import { CopilotCloudOptions } from './lib/cloud/index.js';
 import { AbstractAgent } from '@ag-ui/client';
@@ -142,9 +142,7 @@ interface MCPTool {
         };
     };
     /** The function to call to execute the tool on the MCP server. */
-    execute(options: {
-        params: any;
-    }): Promise<any>;
+    execute(params: any): Promise<any>;
 }
 /**
  * Defines the contract for *any* MCP client implementation the user might provide.
@@ -340,23 +338,23 @@ interface CopilotRuntimeConstructorParams<T extends Parameter[] | [] = []> {
      */
     createMCPClient?: CreateMCPClientFunction;
     /**
-     * Optional trace handler for comprehensive debugging and observability.
+     * Optional error handler for comprehensive debugging and observability.
      *
-     * **Requires publicApiKey**: Tracing only works when requests include a valid publicApiKey.
+     * **Requires publicApiKey**: Error handling only works when requests include a valid publicApiKey.
      * This is a premium CopilotKit Cloud feature.
      *
-     * @param traceEvent - Structured trace event with rich debugging context
+     * @param errorEvent - Structured error event with rich debugging context
      *
      * @example
      * ```typescript
      * const runtime = new CopilotRuntime({
-     *   onTrace: (traceEvent) => {
-     *     debugDashboard.capture(traceEvent);
+     *   onError: (errorEvent) => {
+     *     debugDashboard.capture(errorEvent);
      *   }
      * });
      * ```
      */
-    onTrace?: CopilotTraceHandler;
+    onError?: CopilotErrorHandler;
 }
 declare class CopilotRuntime<const T extends Parameter[] | [] = []> {
     actions: ActionsConfiguration<T>;
@@ -368,8 +366,8 @@ declare class CopilotRuntime<const T extends Parameter[] | [] = []> {
     private delegateAgentProcessingToServiceAdapter;
     private observability?;
     private availableAgents;
-    private onTrace?;
-    private hasWarnedAboutTracing;
+    private onError?;
+    private hasWarnedAboutError;
     private readonly mcpServersConfig?;
     private mcpActionCache;
     private readonly createMCPClientImpl?;
@@ -378,18 +376,18 @@ declare class CopilotRuntime<const T extends Parameter[] | [] = []> {
     processRuntimeRequest(request: CopilotRuntimeRequest): Promise<CopilotRuntimeResponse>;
     getAllAgents(graphqlContext: GraphQLContext): Promise<(AgentWithEndpoint | Agent)[]>;
     discoverAgentsFromEndpoints(graphqlContext: GraphQLContext): Promise<AgentWithEndpoint[]>;
-    discoverAgentsFromAgui(): Promise<AgentWithEndpoint[]>;
+    discoverAgentsFromAgui(): Agent[];
     loadAgentState(graphqlContext: GraphQLContext, threadId: string, agentName: string): Promise<LoadAgentStateResponse>;
     private processAgentRequest;
     private getServerSideActions;
     private detectProvider;
     private convertStreamingErrorToStructured;
-    private trace;
+    private error;
     /**
-     * Public method to trace GraphQL validation errors
-     * This allows the GraphQL resolver to send validation errors through the trace system
+     * Public method to handle GraphQL validation errors
+     * This allows the GraphQL resolver to send validation errors through the error system
      */
-    traceGraphQLError(error: {
+    errorGraphQLError(error: {
         message: string;
         code: string;
         type: string;

package/package.json

@@ -9,7 +9,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.9.2-next.9",
+  "version": "1.9.3-next.0",
   "sideEffects": false,
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -37,11 +37,11 @@
     "tsconfig": "1.4.6"
   },
   "dependencies": {
-    "@ag-ui/client": "0.0.28",
-    "@ag-ui/core": "0.0.28",
-    "@ag-ui/encoder": "0.0.28",
-    "@ag-ui/langgraph": "0.0.4",
-    "@ag-ui/proto": "0.0.28",
+    "@ag-ui/client": "0.0.35",
+    "@ag-ui/core": "0.0.35",
+    "@ag-ui/encoder": "0.0.35",
+    "@ag-ui/langgraph": "0.0.7",
+    "@ag-ui/proto": "0.0.35",
     "@anthropic-ai/sdk": "^0.27.3",
     "@graphql-yoga/plugin-defer-stream": "^3.3.1",
     "@langchain/aws": "^0.1.9",
@@ -66,13 +66,13 @@
     "rxjs": "7.8.1",
     "type-graphql": "2.0.0-rc.1",
     "zod": "^3.23.3",
-    "@copilotkit/shared": "1.9.2-next.9"
+    "@copilotkit/shared": "1.9.3-next.0"
   },
   "peerDependencies": {
-    "@ag-ui/client": ">=0.0.28",
-    "@ag-ui/core": ">=0.0.28",
-    "@ag-ui/encoder": ">=0.0.28",
-    "@ag-ui/proto": ">=0.0.28"
+    "@ag-ui/client": ">=0.0.34",
+    "@ag-ui/core": ">=0.0.34",
+    "@ag-ui/encoder": ">=0.0.34",
+    "@ag-ui/proto": ">=0.0.34"
   },
   "keywords": [
     "copilotkit",

package/src/graphql/resolvers/copilot.resolver.ts

@@ -192,8 +192,7 @@ export class CopilotResolver {
       if (!copilotCloudPublicApiKey) {
         logger.error("Public API key not found in headers");
 
-        // Trace the validation error for debugging visibility
-        await copilotRuntime.traceGraphQLError(
+        await copilotRuntime.errorGraphQLError(
           {
             message: "X-CopilotCloud-Public-API-Key header is required",
             code: "MISSING_PUBLIC_API_KEY",

package/src/lib/runtime/__tests__/{copilot-runtime-trace.test.ts → copilot-runtime-error.test.ts}

@@ -1,8 +1,8 @@
-import { CopilotTraceEvent, CopilotRequestContext, CopilotTraceHandler } from "@copilotkit/shared";
+import { CopilotErrorEvent, CopilotRequestContext, CopilotErrorHandler } from "@copilotkit/shared";
 
-describe("CopilotRuntime onTrace types", () => {
+describe("CopilotRuntime onError types", () => {
   it("should have correct CopilotTraceEvent type structure", () => {
-    const traceEvent: CopilotTraceEvent = {
+    const errorEvent: CopilotErrorEvent = {
       type: "error",
       timestamp: Date.now(),
       context: {
@@ -18,10 +18,10 @@ describe("CopilotRuntime onTrace types", () => {
       error: new Error("Test error"),
     };
 
-    expect(traceEvent.type).toBe("error");
-    expect(traceEvent.timestamp).toBeGreaterThan(0);
-    expect(traceEvent.context.threadId).toBe("test-123");
-    expect(traceEvent.error).toBeInstanceOf(Error);
+    expect(errorEvent.type).toBe("error");
+    expect(errorEvent.timestamp).toBeGreaterThan(0);
+    expect(errorEvent.context.threadId).toBe("test-123");
+    expect(errorEvent.error).toBeInstanceOf(Error);
   });
 
   it("should have correct CopilotRequestContext type structure", () => {
@@ -76,8 +76,8 @@ describe("CopilotRuntime onTrace types", () => {
     expect(context.metadata?.testFlag).toBe(true);
   });
 
-  it("should support all trace event types", () => {
-    const eventTypes: CopilotTraceEvent["type"][] = [
+  it("should support all error event types", () => {
+    const eventTypes: CopilotErrorEvent["type"][] = [
       "error",
       "request",
       "response",
@@ -88,7 +88,7 @@ describe("CopilotRuntime onTrace types", () => {
     ];
 
     eventTypes.forEach((type) => {
-      const event: CopilotTraceEvent = {
+      const event: CopilotErrorEvent = {
         type,
         timestamp: Date.now(),
         context: {
@@ -108,37 +108,37 @@ describe("CopilotRuntime onTrace types", () => {
   });
 
   describe("publicApiKey gating logic", () => {
-    type ShouldTrace = (onTrace?: CopilotTraceHandler, publicApiKey?: string) => boolean;
+    type ShouldHandleError = (onError?: CopilotErrorHandler, publicApiKey?: string) => boolean;
 
-    const shouldTrace: ShouldTrace = (onTrace, publicApiKey) => {
-      return Boolean(onTrace && publicApiKey);
+    const shouldHandleError: ShouldHandleError = (onError, publicApiKey) => {
+      return Boolean(onError && publicApiKey);
     };
 
-    it("should return true when both onTrace and publicApiKey are provided", () => {
-      const onTrace = jest.fn();
-      const result = shouldTrace(onTrace, "valid-api-key");
+    it("should return true when both onError and publicApiKey are provided", () => {
+      const onError = jest.fn();
+      const result = shouldHandleError(onError, "valid-api-key");
       expect(result).toBe(true);
     });
 
-    it("should return false when onTrace is missing", () => {
-      const result = shouldTrace(undefined, "valid-api-key");
+    it("should return false when onError is missing", () => {
+      const result = shouldHandleError(undefined, "valid-api-key");
       expect(result).toBe(false);
     });
 
     it("should return false when publicApiKey is missing", () => {
-      const onTrace = jest.fn();
-      const result = shouldTrace(onTrace, undefined);
+      const onError = jest.fn();
+      const result = shouldHandleError(onError, undefined);
       expect(result).toBe(false);
     });
 
     it("should return false when publicApiKey is empty string", () => {
-      const onTrace = jest.fn();
-      const result = shouldTrace(onTrace, "");
+      const onError = jest.fn();
+      const result = shouldHandleError(onError, "");
       expect(result).toBe(false);
     });
 
     it("should return false when both are missing", () => {
-      const result = shouldTrace(undefined, undefined);
+      const result = shouldHandleError(undefined, undefined);
       expect(result).toBe(false);
     });
 
@@ -160,10 +160,10 @@ describe("CopilotRuntime onTrace types", () => {
       const nonCloudKey = extractPublicApiKey(mockHeaders, false);
       expect(nonCloudKey).toBe("test-key-123");
 
-      // Both should enable tracing when onTrace is present
-      const onTrace = jest.fn();
-      expect(shouldTrace(onTrace, cloudKey)).toBe(true);
-      expect(shouldTrace(onTrace, nonCloudKey)).toBe(true);
+      // Both should enable error handling when onError is present
+      const onError = jest.fn();
+      expect(shouldHandleError(onError, cloudKey)).toBe(true);
+      expect(shouldHandleError(onError, nonCloudKey)).toBe(true);
     });
   });
 });