@copilotkitnext/core 0.0.19-threads-and-attachements.1 → 0.0.20

package/dist/index.d.mts

@@ -158,10 +158,6 @@ interface CopilotKitCoreRunAgentParams {
 }
 interface CopilotKitCoreConnectAgentParams {
     agent: AbstractAgent;
-    threadId?: string;
-}
-interface CopilotKitCoreDisconnectAgentParams {
-    agent: AbstractAgent;
 }
 interface CopilotKitCoreGetToolParams {
     toolName: string;
@@ -204,8 +200,7 @@ declare class RunHandler {
     /**
      * Connect an agent (establish initial connection)
      */
-    connectAgent({ agent, threadId }: CopilotKitCoreConnectAgentParams): Promise<RunAgentResult>;
-    disconnectAgent({ agent }: CopilotKitCoreDisconnectAgentParams): Promise<void>;
+    connectAgent({ agent }: CopilotKitCoreConnectAgentParams): Promise<RunAgentResult>;
     /**
      * Run an agent
      */
@@ -242,13 +237,6 @@ interface CopilotKitCoreConfig {
     headers?: Record<string, string>;
     /** Properties sent as `forwardedProps` to the AG-UI agent. */
     properties?: Record<string, unknown>;
-    /**
-     * Resource ID(s) for thread access control.
-     *
-     * This value is sent to the server as a hint for thread scoping.
-     * The server's `resolveThreadsScope` validates and enforces access control.
-     */
-    resourceId?: string | string[];
     /** Ordered collection of frontend tools available to the core. */
     tools?: FrontendTool<any>[];
     /** Suggestions config for the core. */
@@ -324,10 +312,6 @@ interface CopilotKitCoreSubscriber {
         copilotkit: CopilotKitCore;
         headers: Readonly<Record<string, string>>;
     }) => void | Promise<void>;
-    onResourceIdChanged?: (event: {
-        copilotkit: CopilotKitCore;
-        resourceId: string | string[] | undefined;
-    }) => void | Promise<void>;
     onError?: (event: {
         copilotkit: CopilotKitCore;
         error: Error;
@@ -365,14 +349,13 @@ interface CopilotKitCoreFriendsAccess {
 declare class CopilotKitCore {
     private _headers;
     private _properties;
-    private _resourceId;
     private subscribers;
     private agentRegistry;
     private contextStore;
     private suggestionEngine;
     private runHandler;
     private stateManager;
-    constructor({ runtimeUrl, headers, properties, resourceId, agents__unsafe_dev_only, tools, suggestionsConfig, }: CopilotKitCoreConfig);
+    constructor({ runtimeUrl, headers, properties, agents__unsafe_dev_only, tools, suggestionsConfig, }: CopilotKitCoreConfig);
     /**
      * Internal method used by delegate classes and subclasses to notify subscribers
      */
@@ -392,14 +375,12 @@ declare class CopilotKitCore {
     get runtimeVersion(): string | undefined;
     get headers(): Readonly<Record<string, string>>;
     get properties(): Readonly<Record<string, unknown>>;
-    get resourceId(): string | string[] | undefined;
     get runtimeConnectionStatus(): CopilotKitCoreRuntimeConnectionStatus;
     /**
      * Configuration updates
      */
     setHeaders(headers: Record<string, string>): void;
     setProperties(properties: Record<string, unknown>): void;
-    setResourceId(resourceId: string | string[] | undefined): void;
     /**
      * Agent management (delegated to AgentRegistry)
      */
@@ -437,7 +418,6 @@ declare class CopilotKitCore {
      */
     connectAgent(params: CopilotKitCoreConnectAgentParams): Promise<_ag_ui_client.RunAgentResult>;
     stopAgent(params: CopilotKitCoreStopAgentParams): void;
-    disconnectAgent(params: CopilotKitCoreDisconnectAgentParams): Promise<void>;
     runAgent(params: CopilotKitCoreRunAgentParams): Promise<_ag_ui_client.RunAgentResult>;
     /**
      * State management (delegated to StateManager)
@@ -445,42 +425,6 @@ declare class CopilotKitCore {
     getStateByRun(agentId: string, threadId: string, runId: string): State | undefined;
     getRunIdForMessage(agentId: string, threadId: string, messageId: string): string | undefined;
     getRunIdsForThread(agentId: string, threadId: string): string[];
-    /**
-     * Helper to format resourceId for HTTP header transport.
-     * Encodes each value with encodeURIComponent and joins with comma.
-     */
-    private formatResourceIdHeader;
-    /**
-     * Get headers with resourceId header included (if resourceId is set).
-     * Used internally by RunHandler for HttpAgent requests.
-     */
-    getHeadersWithResourceId(): Record<string, string>;
-    /**
-     * Thread management
-     */
-    listThreads(params?: {
-        limit?: number;
-        offset?: number;
-    }): Promise<{
-        threads: Array<{
-            threadId: string;
-            createdAt: number;
-            lastActivityAt: number;
-            isRunning: boolean;
-            messageCount: number;
-            firstMessage?: string;
-        }>;
-        total: number;
-    }>;
-    getThreadMetadata(threadId: string): Promise<{
-        threadId: string;
-        createdAt: number;
-        lastActivityAt: number;
-        isRunning: boolean;
-        messageCount: number;
-        firstMessage?: string;
-    } | null>;
-    deleteThread(threadId: string): Promise<void>;
     /**
      * Internal method used by RunHandler to build frontend tools
      */
@@ -681,4 +625,4 @@ declare class ProxiedCopilotRuntimeAgent extends HttpAgent {
 
 declare function completePartialMarkdown(input: string): string;
 
-export { AgentRegistry, ContextStore, CopilotKitCore, type CopilotKitCoreAddAgentParams, type CopilotKitCoreConfig, type CopilotKitCoreConnectAgentParams, type CopilotKitCoreDisconnectAgentParams, 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 DynamicSuggestionsConfig, type FrontendTool, ProxiedCopilotRuntimeAgent, type ProxiedCopilotRuntimeAgentConfig, RunHandler, StateManager, type StaticSuggestionsConfig, type Suggestion, type SuggestionAvailability, SuggestionEngine, type SuggestionsConfig, ToolCallStatus, completePartialMarkdown };

package/dist/index.d.ts

@@ -158,10 +158,6 @@ interface CopilotKitCoreRunAgentParams {
 }
 interface CopilotKitCoreConnectAgentParams {
     agent: AbstractAgent;
-    threadId?: string;
-}
-interface CopilotKitCoreDisconnectAgentParams {
-    agent: AbstractAgent;
 }
 interface CopilotKitCoreGetToolParams {
     toolName: string;
@@ -204,8 +200,7 @@ declare class RunHandler {
     /**
      * Connect an agent (establish initial connection)
      */
-    connectAgent({ agent, threadId }: CopilotKitCoreConnectAgentParams): Promise<RunAgentResult>;
-    disconnectAgent({ agent }: CopilotKitCoreDisconnectAgentParams): Promise<void>;
+    connectAgent({ agent }: CopilotKitCoreConnectAgentParams): Promise<RunAgentResult>;
     /**
      * Run an agent
      */
@@ -242,13 +237,6 @@ interface CopilotKitCoreConfig {
     headers?: Record<string, string>;
     /** Properties sent as `forwardedProps` to the AG-UI agent. */
     properties?: Record<string, unknown>;
-    /**
-     * Resource ID(s) for thread access control.
-     *
-     * This value is sent to the server as a hint for thread scoping.
-     * The server's `resolveThreadsScope` validates and enforces access control.
-     */
-    resourceId?: string | string[];
     /** Ordered collection of frontend tools available to the core. */
     tools?: FrontendTool<any>[];
     /** Suggestions config for the core. */
@@ -324,10 +312,6 @@ interface CopilotKitCoreSubscriber {
         copilotkit: CopilotKitCore;
         headers: Readonly<Record<string, string>>;
     }) => void | Promise<void>;
-    onResourceIdChanged?: (event: {
-        copilotkit: CopilotKitCore;
-        resourceId: string | string[] | undefined;
-    }) => void | Promise<void>;
     onError?: (event: {
         copilotkit: CopilotKitCore;
         error: Error;
@@ -365,14 +349,13 @@ interface CopilotKitCoreFriendsAccess {
 declare class CopilotKitCore {
     private _headers;
     private _properties;
-    private _resourceId;
     private subscribers;
     private agentRegistry;
     private contextStore;
     private suggestionEngine;
     private runHandler;
     private stateManager;
-    constructor({ runtimeUrl, headers, properties, resourceId, agents__unsafe_dev_only, tools, suggestionsConfig, }: CopilotKitCoreConfig);
+    constructor({ runtimeUrl, headers, properties, agents__unsafe_dev_only, tools, suggestionsConfig, }: CopilotKitCoreConfig);
     /**
      * Internal method used by delegate classes and subclasses to notify subscribers
      */
@@ -392,14 +375,12 @@ declare class CopilotKitCore {
     get runtimeVersion(): string | undefined;
     get headers(): Readonly<Record<string, string>>;
     get properties(): Readonly<Record<string, unknown>>;
-    get resourceId(): string | string[] | undefined;
     get runtimeConnectionStatus(): CopilotKitCoreRuntimeConnectionStatus;
     /**
      * Configuration updates
      */
     setHeaders(headers: Record<string, string>): void;
     setProperties(properties: Record<string, unknown>): void;
-    setResourceId(resourceId: string | string[] | undefined): void;
     /**
      * Agent management (delegated to AgentRegistry)
      */
@@ -437,7 +418,6 @@ declare class CopilotKitCore {
      */
     connectAgent(params: CopilotKitCoreConnectAgentParams): Promise<_ag_ui_client.RunAgentResult>;
     stopAgent(params: CopilotKitCoreStopAgentParams): void;
-    disconnectAgent(params: CopilotKitCoreDisconnectAgentParams): Promise<void>;
     runAgent(params: CopilotKitCoreRunAgentParams): Promise<_ag_ui_client.RunAgentResult>;
     /**
      * State management (delegated to StateManager)
@@ -445,42 +425,6 @@ declare class CopilotKitCore {
     getStateByRun(agentId: string, threadId: string, runId: string): State | undefined;
     getRunIdForMessage(agentId: string, threadId: string, messageId: string): string | undefined;
     getRunIdsForThread(agentId: string, threadId: string): string[];
-    /**
-     * Helper to format resourceId for HTTP header transport.
-     * Encodes each value with encodeURIComponent and joins with comma.
-     */
-    private formatResourceIdHeader;
-    /**
-     * Get headers with resourceId header included (if resourceId is set).
-     * Used internally by RunHandler for HttpAgent requests.
-     */
-    getHeadersWithResourceId(): Record<string, string>;
-    /**
-     * Thread management
-     */
-    listThreads(params?: {
-        limit?: number;
-        offset?: number;
-    }): Promise<{
-        threads: Array<{
-            threadId: string;
-            createdAt: number;
-            lastActivityAt: number;
-            isRunning: boolean;
-            messageCount: number;
-            firstMessage?: string;
-        }>;
-        total: number;
-    }>;
-    getThreadMetadata(threadId: string): Promise<{
-        threadId: string;
-        createdAt: number;
-        lastActivityAt: number;
-        isRunning: boolean;
-        messageCount: number;
-        firstMessage?: string;
-    } | null>;
-    deleteThread(threadId: string): Promise<void>;
     /**
      * Internal method used by RunHandler to build frontend tools
      */
@@ -681,4 +625,4 @@ declare class ProxiedCopilotRuntimeAgent extends HttpAgent {
 
 declare function completePartialMarkdown(input: string): string;
 
-export { AgentRegistry, ContextStore, CopilotKitCore, type CopilotKitCoreAddAgentParams, type CopilotKitCoreConfig, type CopilotKitCoreConnectAgentParams, type CopilotKitCoreDisconnectAgentParams, 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 DynamicSuggestionsConfig, type FrontendTool, ProxiedCopilotRuntimeAgent, type ProxiedCopilotRuntimeAgentConfig, RunHandler, StateManager, type StaticSuggestionsConfig, type Suggestion, type SuggestionAvailability, SuggestionEngine, type SuggestionsConfig, ToolCallStatus, completePartialMarkdown };

package/dist/index.js

@@ -443,7 +443,7 @@ var SuggestionEngine = class {
       const clonedAgent = suggestionsProviderAgent.clone();
       agent = clonedAgent;
       agent.agentId = suggestionId;
-      agent.threadId = "";
+      agent.threadId = suggestionId;
       agent.messages = JSON.parse(JSON.stringify(suggestionsConsumerAgent.messages));
       agent.state = JSON.parse(JSON.stringify(suggestionsConsumerAgent.state));
       this._suggestions[consumerAgentId] = {
@@ -751,47 +751,10 @@ var RunHandler = class {
   /**
    * Connect an agent (establish initial connection)
    */
-  async connectAgent({ agent, threadId }) {
+  async connectAgent({ agent }) {
     try {
       if (agent instanceof import_client3.HttpAgent) {
-        agent.headers = this.core.getHeadersWithResourceId();
-      }
-      if (threadId) {
-        agent.threadId = threadId;
-      }
-      const expectedThreadIdKey = "__copilotkitExpectedThreadId";
-      const guardKey = "__copilotkitThreadGuard";
-      agent[expectedThreadIdKey] = agent.threadId ?? threadId ?? null;
-      if (!agent[guardKey]) {
-        const guardSubscription = agent.subscribe({
-          onEvent: ({ event, input }) => {
-            const expectedThreadId = agent[expectedThreadIdKey];
-            const eventThreadId = input?.threadId;
-            if (!expectedThreadId) {
-              console.debug(
-                "CopilotKitCore: dropping event - no expected thread (disconnected state)",
-                "eventThread:",
-                eventThreadId,
-                "event:",
-                event.type
-              );
-              return { stopPropagation: true };
-            }
-            if (eventThreadId && eventThreadId !== expectedThreadId) {
-              console.debug(
-                "CopilotKitCore: dropping event from stale thread",
-                eventThreadId,
-                "expected",
-                expectedThreadId,
-                "event",
-                event.type
-              );
-              return { stopPropagation: true };
-            }
-            return;
-          }
-        });
-        agent[guardKey] = guardSubscription;
+        agent.headers = { ...this.core.headers };
       }
       const runAgentResult = await agent.connectAgent(
         {
@@ -800,7 +763,6 @@ var RunHandler = class {
         },
         this.createAgentErrorSubscriber(agent)
       );
-      agent.__copilotkitExpectedThreadId = agent.threadId ?? threadId ?? null;
       return this.processAgentResult({ runAgentResult, agent });
     } catch (error) {
       const connectError = error instanceof Error ? error : new Error(String(error));
@@ -816,17 +778,6 @@ var RunHandler = class {
       throw error;
     }
   }
-  async disconnectAgent({ agent }) {
-    const disconnectableAgent = agent;
-    agent.__copilotkitExpectedThreadId = null;
-    if (typeof disconnectableAgent.disconnectAgent === "function") {
-      try {
-        await disconnectableAgent.disconnectAgent();
-      } catch (error) {
-        console.debug("Error during agent disconnection (non-critical):", error);
-      }
-    }
-  }
   /**
    * Run an agent
    */
@@ -835,7 +786,7 @@ var RunHandler = class {
       void this.core.suggestionEngine.clearSuggestions(agent.agentId);
     }
     if (agent instanceof import_client3.HttpAgent) {
-      agent.headers = this.core.getHeadersWithResourceId();
+      agent.headers = { ...this.core.headers };
     }
     if (withMessages) {
       agent.addMessages(withMessages);
@@ -844,7 +795,8 @@ var RunHandler = class {
       const runAgentResult = await agent.runAgent(
         {
           forwardedProps: this.core.properties,
-          tools: this.buildFrontendTools(agent.agentId)
+          tools: this.buildFrontendTools(agent.agentId),
+          context: Object.values(this.core.context)
         },
         this.createAgentErrorSubscriber(agent)
       );
@@ -1390,7 +1342,6 @@ var CopilotKitCoreRuntimeConnectionStatus = /* @__PURE__ */ ((CopilotKitCoreRunt
 var CopilotKitCore = class {
   _headers;
   _properties;
-  _resourceId;
   subscribers = /* @__PURE__ */ new Set();
   // Delegate classes
   agentRegistry;
@@ -1402,14 +1353,12 @@ var CopilotKitCore = class {
     runtimeUrl,
     headers = {},
     properties = {},
-    resourceId,
     agents__unsafe_dev_only = {},
     tools = [],
     suggestionsConfig = []
   }) {
     this._headers = headers;
     this._properties = properties;
-    this._resourceId = resourceId;
     this.agentRegistry = new AgentRegistry(this);
     this.contextStore = new ContextStore(this);
     this.suggestionEngine = new SuggestionEngine(this);
@@ -1489,9 +1438,6 @@ var CopilotKitCore = class {
   get properties() {
     return this._properties;
   }
-  get resourceId() {
-    return this._resourceId;
-  }
   get runtimeConnectionStatus() {
     return this.agentRegistry.runtimeConnectionStatus;
   }
@@ -1519,16 +1465,6 @@ var CopilotKitCore = class {
       "Subscriber onPropertiesChanged error:"
     );
   }
-  setResourceId(resourceId) {
-    this._resourceId = resourceId;
-    void this.notifySubscribers(
-      (subscriber) => subscriber.onResourceIdChanged?.({
-        copilotkit: this,
-        resourceId: this.resourceId
-      }),
-      "Subscriber onResourceIdChanged error:"
-    );
-  }
   /**
    * Agent management (delegated to AgentRegistry)
    */
@@ -1607,9 +1543,6 @@ var CopilotKitCore = class {
   stopAgent(params) {
     params.agent.abortRun();
   }
-  async disconnectAgent(params) {
-    await this.runHandler.disconnectAgent(params);
-  }
   async runAgent(params) {
     return this.runHandler.runAgent(params);
   }
@@ -1625,105 +1558,6 @@ var CopilotKitCore = class {
   getRunIdsForThread(agentId, threadId) {
     return this.stateManager.getRunIdsForThread(agentId, threadId);
   }
-  /**
-   * Helper to format resourceId for HTTP header transport.
-   * Encodes each value with encodeURIComponent and joins with comma.
-   */
-  formatResourceIdHeader() {
-    if (!this._resourceId) {
-      return void 0;
-    }
-    const ids = Array.isArray(this._resourceId) ? this._resourceId : [this._resourceId];
-    return ids.map((id) => encodeURIComponent(id)).join(",");
-  }
-  /**
-   * Get headers with resourceId header included (if resourceId is set).
-   * Used internally by RunHandler for HttpAgent requests.
-   */
-  getHeadersWithResourceId() {
-    const resourceIdHeader = this.formatResourceIdHeader();
-    return {
-      ...this.headers,
-      ...resourceIdHeader && { "X-CopilotKit-Resource-ID": resourceIdHeader }
-    };
-  }
-  /**
-   * Thread management
-   */
-  async listThreads(params) {
-    const runtimeUrl = this.runtimeUrl;
-    if (!runtimeUrl) {
-      throw new Error("Runtime URL is required to list threads");
-    }
-    const baseUrl = runtimeUrl.endsWith("/") ? runtimeUrl.slice(0, -1) : runtimeUrl;
-    const urlString = `${baseUrl}/threads`;
-    const queryParams = new URLSearchParams();
-    if (params?.limit !== void 0) {
-      queryParams.set("limit", params.limit.toString());
-    }
-    if (params?.offset !== void 0) {
-      queryParams.set("offset", params.offset.toString());
-    }
-    const queryString = queryParams.toString();
-    const fullUrl = queryString ? `${urlString}?${queryString}` : urlString;
-    const resourceIdHeader = this.formatResourceIdHeader();
-    const response = await fetch(fullUrl, {
-      method: "GET",
-      headers: {
-        "Content-Type": "application/json",
-        ...this.headers,
-        ...resourceIdHeader && { "X-CopilotKit-Resource-ID": resourceIdHeader }
-      }
-    });
-    if (!response.ok) {
-      throw new Error(`Failed to list threads: ${response.statusText}`);
-    }
-    return await response.json();
-  }
-  async getThreadMetadata(threadId) {
-    const runtimeUrl = this.runtimeUrl;
-    if (!runtimeUrl) {
-      throw new Error("Runtime URL is required to get thread metadata");
-    }
-    const baseUrl = runtimeUrl.endsWith("/") ? runtimeUrl.slice(0, -1) : runtimeUrl;
-    const fullUrl = `${baseUrl}/threads/${threadId}`;
-    const resourceIdHeader = this.formatResourceIdHeader();
-    const response = await fetch(fullUrl, {
-      method: "GET",
-      headers: {
-        "Content-Type": "application/json",
-        ...this.headers,
-        ...resourceIdHeader && { "X-CopilotKit-Resource-ID": resourceIdHeader }
-      }
-    });
-    if (response.status === 404) {
-      return null;
-    }
-    if (!response.ok) {
-      throw new Error(`Failed to get thread metadata: ${response.statusText}`);
-    }
-    return await response.json();
-  }
-  async deleteThread(threadId) {
-    const runtimeUrl = this.runtimeUrl;
-    if (!runtimeUrl) {
-      throw new Error("Runtime URL is required to delete a thread");
-    }
-    const baseUrl = runtimeUrl.endsWith("/") ? runtimeUrl.slice(0, -1) : runtimeUrl;
-    const fullUrl = `${baseUrl}/threads/${threadId}`;
-    const resourceIdHeader = this.formatResourceIdHeader();
-    const response = await fetch(fullUrl, {
-      method: "DELETE",
-      headers: {
-        "Content-Type": "application/json",
-        ...this.headers,
-        ...resourceIdHeader && { "X-CopilotKit-Resource-ID": resourceIdHeader }
-      }
-    });
-    if (!response.ok) {
-      throw new Error(`Failed to delete thread: ${response.statusText}`);
-    }
-  }
   /**
    * Internal method used by RunHandler to build frontend tools
    */