@copilotkitnext/core 0.0.20 → 0.0.21

package/dist/index.d.mts

@@ -11,6 +11,7 @@ declare enum ToolCallStatus {
     Executing = "executing",
     Complete = "complete"
 }
+type CopilotRuntimeTransport = "rest" | "single";
 type FrontendTool<T extends Record<string, unknown> = Record<string, unknown>> = {
     name: string;
     description?: string;
@@ -90,6 +91,7 @@ declare class AgentRegistry {
     private _runtimeUrl?;
     private _runtimeVersion?;
     private _runtimeConnectionStatus;
+    private _runtimeTransport;
     constructor(core: CopilotKitCore);
     /**
      * Get all agents as a readonly record
@@ -98,6 +100,7 @@ declare class AgentRegistry {
     get runtimeUrl(): string | undefined;
     get runtimeVersion(): string | undefined;
     get runtimeConnectionStatus(): CopilotKitCoreRuntimeConnectionStatus;
+    get runtimeTransport(): CopilotRuntimeTransport;
     /**
      * Initialize agents from configuration
      */
@@ -106,6 +109,7 @@ declare class AgentRegistry {
      * Set the runtime URL and update connection
      */
     setRuntimeUrl(runtimeUrl: string | undefined): void;
+    setRuntimeTransport(runtimeTransport: CopilotRuntimeTransport): void;
     /**
      * Set all agents at once (for development use)
      */
@@ -134,6 +138,7 @@ declare class AgentRegistry {
      * Update runtime connection and fetch remote agents
      */
     private updateRuntimeConnection;
+    private fetchRuntimeInfo;
     /**
      * Assign agent IDs to a record of agents
      */
@@ -231,6 +236,8 @@ declare class RunHandler {
 interface CopilotKitCoreConfig {
     /** The endpoint of the CopilotRuntime. */
     runtimeUrl?: string;
+    /** Transport style for CopilotRuntime endpoints. Defaults to REST. */
+    runtimeTransport?: CopilotRuntimeTransport;
     /** 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`. */
@@ -355,7 +362,7 @@ declare class CopilotKitCore {
     private suggestionEngine;
     private runHandler;
     private stateManager;
-    constructor({ runtimeUrl, headers, properties, agents__unsafe_dev_only, tools, suggestionsConfig, }: CopilotKitCoreConfig);
+    constructor({ runtimeUrl, runtimeTransport, headers, properties, agents__unsafe_dev_only, tools, suggestionsConfig, }: CopilotKitCoreConfig);
     /**
      * Internal method used by delegate classes and subclasses to notify subscribers
      */
@@ -372,6 +379,8 @@ declare class CopilotKitCore {
     get tools(): Readonly<FrontendTool<any>[]>;
     get runtimeUrl(): string | undefined;
     setRuntimeUrl(runtimeUrl: string | undefined): void;
+    get runtimeTransport(): CopilotRuntimeTransport;
+    setRuntimeTransport(runtimeTransport: CopilotRuntimeTransport): void;
     get runtimeVersion(): string | undefined;
     get headers(): Readonly<Record<string, string>>;
     get properties(): Readonly<Record<string, unknown>>;
@@ -615,14 +624,19 @@ declare class StateManager {
 
 interface ProxiedCopilotRuntimeAgentConfig extends Omit<HttpAgentConfig, "url"> {
     runtimeUrl?: string;
+    transport?: CopilotRuntimeTransport;
 }
 declare class ProxiedCopilotRuntimeAgent extends HttpAgent {
     runtimeUrl?: string;
+    private transport;
+    private singleEndpointUrl?;
     constructor(config: ProxiedCopilotRuntimeAgentConfig);
     abortRun(): void;
     connect(input: RunAgentInput): Observable<BaseEvent>;
+    run(input: RunAgentInput): Observable<BaseEvent>;
+    private createSingleRouteRequestInit;
 }
 
 declare function completePartialMarkdown(input: string): string;
 
-export { AgentRegistry, ContextStore, CopilotKitCore, type CopilotKitCoreAddAgentParams, type CopilotKitCoreConfig, type CopilotKitCoreConnectAgentParams, CopilotKitCoreErrorCode, type CopilotKitCoreFriendsAccess, type CopilotKitCoreGetSuggestionsResult, type CopilotKitCoreGetToolParams, type CopilotKitCoreRunAgentParams, CopilotKitCoreRuntimeConnectionStatus, type CopilotKitCoreStopAgentParams, type CopilotKitCoreSubscriber, type DynamicSuggestionsConfig, type FrontendTool, ProxiedCopilotRuntimeAgent, type ProxiedCopilotRuntimeAgentConfig, RunHandler, StateManager, type StaticSuggestionsConfig, type Suggestion, type SuggestionAvailability, SuggestionEngine, type SuggestionsConfig, ToolCallStatus, completePartialMarkdown };
+export { AgentRegistry, ContextStore, CopilotKitCore, type CopilotKitCoreAddAgentParams, type CopilotKitCoreConfig, type CopilotKitCoreConnectAgentParams, CopilotKitCoreErrorCode, type CopilotKitCoreFriendsAccess, type CopilotKitCoreGetSuggestionsResult, type CopilotKitCoreGetToolParams, type CopilotKitCoreRunAgentParams, CopilotKitCoreRuntimeConnectionStatus, type CopilotKitCoreStopAgentParams, type CopilotKitCoreSubscriber, type CopilotRuntimeTransport, type DynamicSuggestionsConfig, type FrontendTool, ProxiedCopilotRuntimeAgent, type ProxiedCopilotRuntimeAgentConfig, RunHandler, StateManager, type StaticSuggestionsConfig, type Suggestion, type SuggestionAvailability, SuggestionEngine, type SuggestionsConfig, ToolCallStatus, completePartialMarkdown };

package/dist/index.d.ts

@@ -11,6 +11,7 @@ declare enum ToolCallStatus {
     Executing = "executing",
     Complete = "complete"
 }
+type CopilotRuntimeTransport = "rest" | "single";
 type FrontendTool<T extends Record<string, unknown> = Record<string, unknown>> = {
     name: string;
     description?: string;
@@ -90,6 +91,7 @@ declare class AgentRegistry {
     private _runtimeUrl?;
     private _runtimeVersion?;
     private _runtimeConnectionStatus;
+    private _runtimeTransport;
     constructor(core: CopilotKitCore);
     /**
      * Get all agents as a readonly record
@@ -98,6 +100,7 @@ declare class AgentRegistry {
     get runtimeUrl(): string | undefined;
     get runtimeVersion(): string | undefined;
     get runtimeConnectionStatus(): CopilotKitCoreRuntimeConnectionStatus;
+    get runtimeTransport(): CopilotRuntimeTransport;
     /**
      * Initialize agents from configuration
      */
@@ -106,6 +109,7 @@ declare class AgentRegistry {
      * Set the runtime URL and update connection
      */
     setRuntimeUrl(runtimeUrl: string | undefined): void;
+    setRuntimeTransport(runtimeTransport: CopilotRuntimeTransport): void;
     /**
      * Set all agents at once (for development use)
      */
@@ -134,6 +138,7 @@ declare class AgentRegistry {
      * Update runtime connection and fetch remote agents
      */
     private updateRuntimeConnection;
+    private fetchRuntimeInfo;
     /**
      * Assign agent IDs to a record of agents
      */
@@ -231,6 +236,8 @@ declare class RunHandler {
 interface CopilotKitCoreConfig {
     /** The endpoint of the CopilotRuntime. */
     runtimeUrl?: string;
+    /** Transport style for CopilotRuntime endpoints. Defaults to REST. */
+    runtimeTransport?: CopilotRuntimeTransport;
     /** 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`. */
@@ -355,7 +362,7 @@ declare class CopilotKitCore {
     private suggestionEngine;
     private runHandler;
     private stateManager;
-    constructor({ runtimeUrl, headers, properties, agents__unsafe_dev_only, tools, suggestionsConfig, }: CopilotKitCoreConfig);
+    constructor({ runtimeUrl, runtimeTransport, headers, properties, agents__unsafe_dev_only, tools, suggestionsConfig, }: CopilotKitCoreConfig);
     /**
      * Internal method used by delegate classes and subclasses to notify subscribers
      */
@@ -372,6 +379,8 @@ declare class CopilotKitCore {
     get tools(): Readonly<FrontendTool<any>[]>;
     get runtimeUrl(): string | undefined;
     setRuntimeUrl(runtimeUrl: string | undefined): void;
+    get runtimeTransport(): CopilotRuntimeTransport;
+    setRuntimeTransport(runtimeTransport: CopilotRuntimeTransport): void;
     get runtimeVersion(): string | undefined;
     get headers(): Readonly<Record<string, string>>;
     get properties(): Readonly<Record<string, unknown>>;
@@ -615,14 +624,19 @@ declare class StateManager {
 
 interface ProxiedCopilotRuntimeAgentConfig extends Omit<HttpAgentConfig, "url"> {
     runtimeUrl?: string;
+    transport?: CopilotRuntimeTransport;
 }
 declare class ProxiedCopilotRuntimeAgent extends HttpAgent {
     runtimeUrl?: string;
+    private transport;
+    private singleEndpointUrl?;
     constructor(config: ProxiedCopilotRuntimeAgentConfig);
     abortRun(): void;
     connect(input: RunAgentInput): Observable<BaseEvent>;
+    run(input: RunAgentInput): Observable<BaseEvent>;
+    private createSingleRouteRequestInit;
 }
 
 declare function completePartialMarkdown(input: string): string;
 
-export { AgentRegistry, ContextStore, CopilotKitCore, type CopilotKitCoreAddAgentParams, type CopilotKitCoreConfig, type CopilotKitCoreConnectAgentParams, CopilotKitCoreErrorCode, type CopilotKitCoreFriendsAccess, type CopilotKitCoreGetSuggestionsResult, type CopilotKitCoreGetToolParams, type CopilotKitCoreRunAgentParams, CopilotKitCoreRuntimeConnectionStatus, type CopilotKitCoreStopAgentParams, type CopilotKitCoreSubscriber, type DynamicSuggestionsConfig, type FrontendTool, ProxiedCopilotRuntimeAgent, type ProxiedCopilotRuntimeAgentConfig, RunHandler, StateManager, type StaticSuggestionsConfig, type Suggestion, type SuggestionAvailability, SuggestionEngine, type SuggestionsConfig, ToolCallStatus, completePartialMarkdown };
+export { AgentRegistry, ContextStore, CopilotKitCore, type CopilotKitCoreAddAgentParams, type CopilotKitCoreConfig, type CopilotKitCoreConnectAgentParams, CopilotKitCoreErrorCode, type CopilotKitCoreFriendsAccess, type CopilotKitCoreGetSuggestionsResult, type CopilotKitCoreGetToolParams, type CopilotKitCoreRunAgentParams, CopilotKitCoreRuntimeConnectionStatus, type CopilotKitCoreStopAgentParams, type CopilotKitCoreSubscriber, type CopilotRuntimeTransport, type DynamicSuggestionsConfig, type FrontendTool, ProxiedCopilotRuntimeAgent, type ProxiedCopilotRuntimeAgentConfig, RunHandler, StateManager, type StaticSuggestionsConfig, type Suggestion, type SuggestionAvailability, SuggestionEngine, type SuggestionsConfig, ToolCallStatus, completePartialMarkdown };

package/dist/index.js

@@ -42,20 +42,55 @@ var import_shared = require("@copilotkitnext/shared");
 var import_client = require("@ag-ui/client");
 var ProxiedCopilotRuntimeAgent = class extends import_client.HttpAgent {
   runtimeUrl;
+  transport;
+  singleEndpointUrl;
   constructor(config) {
+    const normalizedRuntimeUrl = config.runtimeUrl ? config.runtimeUrl.replace(/\/$/, "") : void 0;
+    const transport = config.transport ?? "rest";
+    const runUrl = transport === "single" ? normalizedRuntimeUrl ?? config.runtimeUrl ?? "" : `${normalizedRuntimeUrl ?? config.runtimeUrl}/agent/${encodeURIComponent(config.agentId ?? "")}/run`;
+    if (!runUrl) {
+      throw new Error("ProxiedCopilotRuntimeAgent requires a runtimeUrl when transport is set to 'single'.");
+    }
     super({
       ...config,
-      url: `${config.runtimeUrl}/agent/${config.agentId}/run`
+      url: runUrl
     });
-    this.runtimeUrl = config.runtimeUrl;
+    this.runtimeUrl = normalizedRuntimeUrl ?? config.runtimeUrl;
+    this.transport = transport;
+    if (this.transport === "single") {
+      this.singleEndpointUrl = this.runtimeUrl;
+    }
   }
   abortRun() {
-    if (!this.runtimeUrl || !this.agentId || !this.threadId) {
+    if (!this.agentId || !this.threadId) {
       return;
     }
     if (typeof fetch === "undefined") {
       return;
     }
+    if (this.transport === "single") {
+      if (!this.singleEndpointUrl) {
+        return;
+      }
+      const headers = new Headers({ ...this.headers, "Content-Type": "application/json" });
+      void fetch(this.singleEndpointUrl, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+          method: "agent/stop",
+          params: {
+            agentId: this.agentId,
+            threadId: this.threadId
+          }
+        })
+      }).catch((error) => {
+        console.error("ProxiedCopilotRuntimeAgent: stop request failed", error);
+      });
+      return;
+    }
+    if (!this.runtimeUrl) {
+      return;
+    }
     const stopPath = `${this.runtimeUrl}/agent/${encodeURIComponent(this.agentId)}/stop/${encodeURIComponent(this.threadId)}`;
     const origin = typeof window !== "undefined" && window.location ? window.location.origin : "http://localhost";
     const base = new URL(this.runtimeUrl, origin);
@@ -71,9 +106,64 @@ var ProxiedCopilotRuntimeAgent = class extends import_client.HttpAgent {
     });
   }
   connect(input) {
+    if (this.transport === "single") {
+      if (!this.singleEndpointUrl) {
+        throw new Error("Single endpoint transport requires a runtimeUrl");
+      }
+      const requestInit = this.createSingleRouteRequestInit(input, "agent/connect", {
+        agentId: this.agentId
+      });
+      const httpEvents2 = (0, import_client.runHttpRequest)(this.singleEndpointUrl, requestInit);
+      return (0, import_client.transformHttpEventStream)(httpEvents2);
+    }
     const httpEvents = (0, import_client.runHttpRequest)(`${this.runtimeUrl}/agent/${this.agentId}/connect`, this.requestInit(input));
     return (0, import_client.transformHttpEventStream)(httpEvents);
   }
+  run(input) {
+    if (this.transport === "single") {
+      if (!this.singleEndpointUrl) {
+        throw new Error("Single endpoint transport requires a runtimeUrl");
+      }
+      const requestInit = this.createSingleRouteRequestInit(input, "agent/run", {
+        agentId: this.agentId
+      });
+      const httpEvents = (0, import_client.runHttpRequest)(this.singleEndpointUrl, requestInit);
+      return (0, import_client.transformHttpEventStream)(httpEvents);
+    }
+    return super.run(input);
+  }
+  createSingleRouteRequestInit(input, method, params) {
+    if (!this.agentId) {
+      throw new Error("ProxiedCopilotRuntimeAgent requires agentId to make runtime requests");
+    }
+    const baseInit = super.requestInit(input);
+    const headers = new Headers(baseInit.headers ?? {});
+    headers.set("Content-Type", "application/json");
+    headers.set("Accept", headers.get("Accept") ?? "text/event-stream");
+    let originalBody = void 0;
+    if (typeof baseInit.body === "string") {
+      try {
+        originalBody = JSON.parse(baseInit.body);
+      } catch (error) {
+        console.warn("ProxiedCopilotRuntimeAgent: failed to parse request body for single route transport", error);
+        originalBody = void 0;
+      }
+    }
+    const envelope = {
+      method
+    };
+    if (params && Object.keys(params).length > 0) {
+      envelope.params = params;
+    }
+    if (originalBody !== void 0) {
+      envelope.body = originalBody;
+    }
+    return {
+      ...baseInit,
+      headers,
+      body: JSON.stringify(envelope)
+    };
+  }
 };
 
 // src/core/agent-registry.ts
@@ -87,6 +177,7 @@ var AgentRegistry = class {
   _runtimeUrl;
   _runtimeVersion;
   _runtimeConnectionStatus = "disconnected" /* Disconnected */;
+  _runtimeTransport = "rest";
   /**
    * Get all agents as a readonly record
    */
@@ -102,6 +193,9 @@ var AgentRegistry = class {
   get runtimeConnectionStatus() {
     return this._runtimeConnectionStatus;
   }
+  get runtimeTransport() {
+    return this._runtimeTransport;
+  }
   /**
    * Initialize agents from configuration
    */
@@ -121,6 +215,13 @@ var AgentRegistry = class {
     this._runtimeUrl = normalizedRuntimeUrl;
     void this.updateRuntimeConnection();
   }
+  setRuntimeTransport(runtimeTransport) {
+    if (this._runtimeTransport === runtimeTransport) {
+      return;
+    }
+    this._runtimeTransport = runtimeTransport;
+    void this.updateRuntimeConnection();
+  }
   /**
    * Set all agents at once (for development use)
    */
@@ -201,20 +302,19 @@ var AgentRegistry = class {
     this._runtimeConnectionStatus = "connecting" /* Connecting */;
     await this.notifyRuntimeStatusChanged("connecting" /* Connecting */);
     try {
-      const response = await fetch(`${this.runtimeUrl}/info`, {
-        headers: this.core.headers
-      });
+      const runtimeInfoResponse = await this.fetchRuntimeInfo();
       const {
         version,
         ...runtimeInfo
-      } = await response.json();
+      } = runtimeInfoResponse;
       const agents = Object.fromEntries(
         Object.entries(runtimeInfo.agents).map(([id, { description }]) => {
           const agent = new ProxiedCopilotRuntimeAgent({
             runtimeUrl: this.runtimeUrl,
             agentId: id,
             // Runtime agents always have their ID set correctly
-            description
+            description,
+            transport: this._runtimeTransport
           });
           this.applyHeadersToAgent(agent);
           return [id, agent];
@@ -245,6 +345,36 @@ var AgentRegistry = class {
       });
     }
   }
+  async fetchRuntimeInfo() {
+    if (!this.runtimeUrl) {
+      throw new Error("Runtime URL is not set");
+    }
+    const baseHeaders = this.core.headers;
+    const headers = {
+      ...baseHeaders
+    };
+    if (this._runtimeTransport === "single") {
+      if (!headers["Content-Type"]) {
+        headers["Content-Type"] = "application/json";
+      }
+      const response2 = await fetch(this.runtimeUrl, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ method: "info" })
+      });
+      if ("ok" in response2 && !response2.ok) {
+        throw new Error(`Runtime info request failed with status ${response2.status}`);
+      }
+      return await response2.json();
+    }
+    const response = await fetch(`${this.runtimeUrl}/info`, {
+      headers
+    });
+    if ("ok" in response && !response.ok) {
+      throw new Error(`Runtime info request failed with status ${response.status}`);
+    }
+    return await response.json();
+  }
   /**
    * Assign agent IDs to a record of agents
    */
@@ -1351,6 +1481,7 @@ var CopilotKitCore = class {
   stateManager;
   constructor({
     runtimeUrl,
+    runtimeTransport = "rest",
     headers = {},
     properties = {},
     agents__unsafe_dev_only = {},
@@ -1368,6 +1499,7 @@ var CopilotKitCore = class {
     this.runHandler.initialize(tools);
     this.suggestionEngine.initialize(suggestionsConfig);
     this.stateManager.initialize();
+    this.agentRegistry.setRuntimeTransport(runtimeTransport);
     this.agentRegistry.setRuntimeUrl(runtimeUrl);
     this.subscribe({
       onAgentsChanged: ({ agents }) => {
@@ -1429,6 +1561,12 @@ var CopilotKitCore = class {
   setRuntimeUrl(runtimeUrl) {
     this.agentRegistry.setRuntimeUrl(runtimeUrl);
   }
+  get runtimeTransport() {
+    return this.agentRegistry.runtimeTransport;
+  }
+  setRuntimeTransport(runtimeTransport) {
+    this.agentRegistry.setRuntimeTransport(runtimeTransport);
+  }
   get runtimeVersion() {
     return this.agentRegistry.runtimeVersion;
   }