@copilotkit/runtime 1.54.1 → 1.55.0-next.8

package/dist/v2/runtime/intelligence-platform/client.mjs

@@ -0,0 +1,331 @@
+import "reflect-metadata";
+import { logger } from "@copilotkit/shared";
+
+//#region src/v2/runtime/intelligence-platform/client.ts
+/**
+* Error thrown when an Intelligence platform HTTP request returns a non-2xx
+* status. Carries the HTTP {@link status} code so callers can branch on
+* specific failures (e.g. 404 for "not found", 409 for "conflict") without
+* parsing the error message string.
+*
+* @example
+* ```ts
+* try {
+*   await intelligence.getThread({ threadId });
+* } catch (error) {
+*   if (error instanceof PlatformRequestError && error.status === 404) {
+*     // thread does not exist yet
+*   }
+* }
+* ```
+*/
+var PlatformRequestError = class extends Error {
+	constructor(message, status) {
+		super(message);
+		this.status = status;
+		this.name = "PlatformRequestError";
+	}
+};
+var CopilotKitIntelligence = class {
+	#apiUrl;
+	#runnerWsUrl;
+	#clientWsUrl;
+	#apiKey;
+	#organizationId;
+	#threadCreatedListeners = /* @__PURE__ */ new Set();
+	#threadUpdatedListeners = /* @__PURE__ */ new Set();
+	#threadDeletedListeners = /* @__PURE__ */ new Set();
+	constructor(config) {
+		const intelligenceWsUrl = normalizeIntelligenceWsUrl(config.wsUrl);
+		this.#apiUrl = config.apiUrl.replace(/\/$/, "");
+		this.#runnerWsUrl = deriveRunnerWsUrl(intelligenceWsUrl);
+		this.#clientWsUrl = deriveClientWsUrl(intelligenceWsUrl);
+		this.#apiKey = config.apiKey;
+		this.#organizationId = config.organizationId;
+		if (config.onThreadCreated) this.onThreadCreated(config.onThreadCreated);
+		if (config.onThreadUpdated) this.onThreadUpdated(config.onThreadUpdated);
+		if (config.onThreadDeleted) this.onThreadDeleted(config.onThreadDeleted);
+	}
+	/**
+	* Register a listener invoked whenever a thread is created.
+	*
+	* Multiple listeners can be registered. Each call returns an unsubscribe
+	* function that removes the listener when called.
+	*
+	* @param callback - Receives the newly created {@link ThreadSummary}.
+	* @returns A function that removes this listener when called.
+	*
+	* @example
+	* ```ts
+	* const unsubscribe = intelligence.onThreadCreated((thread) => {
+	*   console.log("Thread created:", thread.id);
+	* });
+	* // later…
+	* unsubscribe();
+	* ```
+	*/
+	onThreadCreated(callback) {
+		this.#threadCreatedListeners.add(callback);
+		return () => {
+			this.#threadCreatedListeners.delete(callback);
+		};
+	}
+	/**
+	* Register a listener invoked whenever a thread is updated (including archive).
+	*
+	* Multiple listeners can be registered. Each call returns an unsubscribe
+	* function that removes the listener when called.
+	*
+	* @param callback - Receives the updated {@link ThreadSummary}.
+	* @returns A function that removes this listener when called.
+	*/
+	onThreadUpdated(callback) {
+		this.#threadUpdatedListeners.add(callback);
+		return () => {
+			this.#threadUpdatedListeners.delete(callback);
+		};
+	}
+	/**
+	* Register a listener invoked whenever a thread is deleted.
+	*
+	* Multiple listeners can be registered. Each call returns an unsubscribe
+	* function that removes the listener when called.
+	*
+	* @param callback - Receives the {@link ThreadDeletedPayload} identifying
+	*   the deleted thread.
+	* @returns A function that removes this listener when called.
+	*/
+	onThreadDeleted(callback) {
+		this.#threadDeletedListeners.add(callback);
+		return () => {
+			this.#threadDeletedListeners.delete(callback);
+		};
+	}
+	ɵgetApiUrl() {
+		return this.#apiUrl;
+	}
+	ɵgetRunnerWsUrl() {
+		return this.#runnerWsUrl;
+	}
+	ɵgetClientWsUrl() {
+		return this.#clientWsUrl;
+	}
+	ɵgetOrganizationId() {
+		return this.#organizationId;
+	}
+	ɵgetRunnerAuthToken() {
+		return this.#apiKey;
+	}
+	async #request(method, path, body) {
+		const url = `${this.#apiUrl}${path}`;
+		const headers = {
+			Authorization: `Bearer ${this.#apiKey}`,
+			"Content-Type": "application/json",
+			"X-Organization-Id": this.#organizationId
+		};
+		const response = await fetch(url, {
+			method,
+			headers,
+			body: body ? JSON.stringify(body) : void 0
+		});
+		if (!response.ok) {
+			const text = await response.text().catch(() => "");
+			logger.error({
+				status: response.status,
+				body: text,
+				path
+			}, "Intelligence platform request failed");
+			throw new PlatformRequestError(`Intelligence platform error ${response.status}: ${text || response.statusText}`, response.status);
+		}
+		const text = await response.text();
+		if (!text) return;
+		return JSON.parse(text);
+	}
+	#invokeLifecycleCallback(callbackName, payload) {
+		const listeners = callbackName === "onThreadCreated" ? this.#threadCreatedListeners : callbackName === "onThreadUpdated" ? this.#threadUpdatedListeners : this.#threadDeletedListeners;
+		for (const callback of listeners) try {
+			callback(payload);
+		} catch (error) {
+			logger.error({
+				err: error,
+				callbackName,
+				payload
+			}, "Intelligence lifecycle callback failed");
+		}
+	}
+	/**
+	* List all non-archived threads for a given user and agent.
+	*
+	* @param params.userId - User whose threads to list.
+	* @param params.agentId - Agent whose threads to list.
+	* @returns The thread list along with realtime subscription credentials.
+	* @throws {@link PlatformRequestError} on non-2xx responses.
+	*/
+	async listThreads(params) {
+		const query = {
+			userId: params.userId,
+			agentId: params.agentId
+		};
+		if (params.includeArchived) query.includeArchived = "true";
+		if (params.limit != null) query.limit = String(params.limit);
+		if (params.cursor) query.cursor = params.cursor;
+		const qs = new URLSearchParams(query).toString();
+		return this.#request("GET", `/api/threads?${qs}`);
+	}
+	async ɵsubscribeToThreads(params) {
+		return this.#request("POST", "/api/threads/subscribe", { userId: params.userId });
+	}
+	/**
+	* Update thread metadata (e.g. name).
+	*
+	* Triggers the `onThreadUpdated` lifecycle callback on success.
+	*
+	* @returns The updated thread summary.
+	* @throws {@link PlatformRequestError} on non-2xx responses.
+	*/
+	async updateThread(params) {
+		const response = await this.#request("PATCH", `/api/threads/${encodeURIComponent(params.threadId)}`, {
+			userId: params.userId,
+			agentId: params.agentId,
+			...params.updates
+		});
+		this.#invokeLifecycleCallback("onThreadUpdated", response.thread);
+		return response.thread;
+	}
+	/**
+	* Create a new thread on the platform.
+	*
+	* Triggers the `onThreadCreated` lifecycle callback on success.
+	*
+	* @returns The newly created thread summary.
+	* @throws {@link PlatformRequestError} with status 409 if a thread with the
+	*   same `threadId` already exists.
+	*/
+	async createThread(params) {
+		const response = await this.#request("POST", `/api/threads`, {
+			threadId: params.threadId,
+			userId: params.userId,
+			agentId: params.agentId,
+			...params.name !== void 0 ? { name: params.name } : {}
+		});
+		this.#invokeLifecycleCallback("onThreadCreated", response.thread);
+		return response.thread;
+	}
+	/**
+	* Fetch a single thread by ID.
+	*
+	* @returns The thread summary.
+	* @throws {@link PlatformRequestError} with status 404 if the thread does
+	*   not exist.
+	*/
+	async getThread(params) {
+		return (await this.#request("GET", `/api/threads/${encodeURIComponent(params.threadId)}`)).thread;
+	}
+	/**
+	* Get an existing thread or create it if it does not exist.
+	*
+	* Handles the race where a concurrent request creates the thread between
+	* the initial 404 and the subsequent `createThread` call by catching the
+	* 409 Conflict and retrying the get.
+	*
+	* Triggers the `onThreadCreated` lifecycle callback when a new thread is
+	* created.
+	*
+	* @returns An object containing the thread and a `created` flag indicating
+	*   whether the thread was newly created (`true`) or already existed (`false`).
+	* @throws {@link PlatformRequestError} on non-2xx responses other than
+	*   404 (get) and 409 (create race).
+	*/
+	async getOrCreateThread(params) {
+		try {
+			return {
+				thread: await this.getThread({ threadId: params.threadId }),
+				created: false
+			};
+		} catch (error) {
+			if (!(error instanceof PlatformRequestError && error.status === 404)) throw error;
+		}
+		try {
+			return {
+				thread: await this.createThread(params),
+				created: true
+			};
+		} catch (error) {
+			if (error instanceof PlatformRequestError && error.status === 409) return {
+				thread: await this.getThread({ threadId: params.threadId }),
+				created: false
+			};
+			throw error;
+		}
+	}
+	/**
+	* Fetch the full message history for a thread.
+	*
+	* @returns All persisted messages in chronological order.
+	* @throws {@link PlatformRequestError} on non-2xx responses.
+	*/
+	async getThreadMessages(params) {
+		return this.#request("GET", `/api/threads/${encodeURIComponent(params.threadId)}/messages`);
+	}
+	/**
+	* Mark a thread as archived.
+	*
+	* Archived threads are excluded from {@link listThreads} results.
+	* Triggers the `onThreadUpdated` lifecycle callback on success.
+	*
+	* @throws {@link PlatformRequestError} on non-2xx responses.
+	*/
+	async archiveThread(params) {
+		const response = await this.#request("PATCH", `/api/threads/${encodeURIComponent(params.threadId)}`, {
+			userId: params.userId,
+			agentId: params.agentId,
+			archived: true
+		});
+		this.#invokeLifecycleCallback("onThreadUpdated", response.thread);
+	}
+	/**
+	* Permanently delete a thread and its message history.
+	*
+	* This is irreversible. Triggers the `onThreadDeleted` lifecycle callback
+	* on success.
+	*
+	* @throws {@link PlatformRequestError} on non-2xx responses.
+	*/
+	async deleteThread(params) {
+		await this.#request("DELETE", `/api/threads/${encodeURIComponent(params.threadId)}`, { reason: `Deleted via CopilotKit runtime (userId=${params.userId}, agentId=${params.agentId})` });
+		this.#invokeLifecycleCallback("onThreadDeleted", params);
+	}
+	async ɵacquireThreadLock(params) {
+		return this.#request("POST", `/api/threads/${encodeURIComponent(params.threadId)}/lock`, {
+			runId: params.runId,
+			userId: params.userId
+		});
+	}
+	async ɵgetActiveJoinCode(params) {
+		const qs = new URLSearchParams({ userId: params.userId }).toString();
+		return this.#request("GET", `/api/threads/${encodeURIComponent(params.threadId)}/join-code?${qs}`);
+	}
+	async ɵconnectThread(params) {
+		return await this.#request("POST", `/api/threads/${encodeURIComponent(params.threadId)}/connect`, {
+			userId: params.userId,
+			...params.lastSeenEventId !== void 0 ? { lastSeenEventId: params.lastSeenEventId } : {}
+		}) ?? null;
+	}
+};
+function normalizeIntelligenceWsUrl(wsUrl) {
+	return wsUrl.replace(/\/$/, "");
+}
+function deriveRunnerWsUrl(wsUrl) {
+	if (wsUrl.endsWith("/runner")) return wsUrl;
+	if (wsUrl.endsWith("/client")) return `${wsUrl.slice(0, -7)}/runner`;
+	return `${wsUrl}/runner`;
+}
+function deriveClientWsUrl(wsUrl) {
+	if (wsUrl.endsWith("/client")) return wsUrl;
+	if (wsUrl.endsWith("/runner")) return `${wsUrl.slice(0, -7)}/client`;
+	return `${wsUrl}/client`;
+}
+
+//#endregion
+export { CopilotKitIntelligence, PlatformRequestError };
+//# sourceMappingURL=client.mjs.map

package/dist/v2/runtime/intelligence-platform/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.mjs","names":["#apiUrl","#runnerWsUrl","#clientWsUrl","#apiKey","#organizationId","#threadCreatedListeners","#threadUpdatedListeners","#threadDeletedListeners","#request","#invokeLifecycleCallback"],"sources":["../../../../src/v2/runtime/intelligence-platform/client.ts"],"sourcesContent":["import { logger } from \"@copilotkit/shared\";\nimport type { BaseEvent } from \"@ag-ui/client\";\n\n/**\n * Error thrown when an Intelligence platform HTTP request returns a non-2xx\n * status. Carries the HTTP {@link status} code so callers can branch on\n * specific failures (e.g. 404 for \"not found\", 409 for \"conflict\") without\n * parsing the error message string.\n *\n * @example\n * ```ts\n * try {\n *   await intelligence.getThread({ threadId });\n * } catch (error) {\n *   if (error instanceof PlatformRequestError && error.status === 404) {\n *     // thread does not exist yet\n *   }\n * }\n * ```\n */\nexport class PlatformRequestError extends Error {\n  constructor(\n    message: string,\n    /** The HTTP status code returned by the platform (e.g. 404, 409, 500). */\n    public readonly status: number,\n  ) {\n    super(message);\n    this.name = \"PlatformRequestError\";\n  }\n}\n\n/**\n * Client for the CopilotKit Intelligence Platform REST API.\n *\n * Construct the client once and pass it to any consumers that need it\n * (e.g. `CopilotRuntime`, `IntelligenceAgentRunner`):\n *\n * ```ts\n * import { CopilotKitIntelligence, CopilotRuntime } from \"@copilotkit/runtime\";\n *\n * const intelligence = new CopilotKitIntelligence({\n *   apiUrl: \"https://api.copilotkit.ai\",\n *   wsUrl: \"wss://api.copilotkit.ai\",\n *   apiKey: process.env.COPILOTKIT_API_KEY!,\n *   organizationId: process.env.COPILOTKIT_ORGANIZATION_ID!,\n * });\n *\n * const runtime = new CopilotRuntime({\n *   agents,\n *   intelligence,\n * });\n * ```\n */\n\n/** Payload passed to `onThreadDeleted` listeners. */\nexport interface ThreadDeletedPayload {\n  threadId: string;\n  userId: string;\n  agentId: string;\n}\n\nexport interface CopilotKitIntelligenceConfig {\n  /** Base URL of the intelligence platform API, e.g. \"https://api.copilotkit.ai\" */\n  apiUrl: string;\n  /** Intelligence websocket base URL. Runner and client socket URLs are derived from this. */\n  wsUrl: string;\n  /** API key for authenticating with the intelligence platform */\n  apiKey: string;\n  /** Organization identifier used for self-hosted Intelligence instances */\n  organizationId: string;\n  /**\n   * Initial listener invoked after a thread is created.\n   * Prefer {@link CopilotKitIntelligence.onThreadCreated} for multiple listeners.\n   */\n  onThreadCreated?: (thread: ThreadSummary) => void;\n  /**\n   * Initial listener invoked after a thread is updated.\n   * Prefer {@link CopilotKitIntelligence.onThreadUpdated} for multiple listeners.\n   */\n  onThreadUpdated?: (thread: ThreadSummary) => void;\n  /**\n   * Initial listener invoked after a thread is deleted.\n   * Prefer {@link CopilotKitIntelligence.onThreadDeleted} for multiple listeners.\n   */\n  onThreadDeleted?: (params: ThreadDeletedPayload) => void;\n}\n\n/**\n * Summary metadata for a single thread returned by the platform.\n *\n * This is the shape returned by list, get, create, and update operations.\n * It does not include the thread's message history — use\n * {@link CopilotKitIntelligence.getThreadMessages} for that.\n */\nexport interface ThreadSummary {\n  /** Platform-assigned unique identifier. */\n  id: string;\n  /** Human-readable display name, or `null` if the thread has not been named. */\n  name: string | null;\n  /** ISO-8601 timestamp of the most recent agent run on this thread. */\n  lastRunAt?: string;\n  /** ISO-8601 timestamp of the most recent metadata update. */\n  lastUpdatedAt?: string;\n  /** ISO-8601 timestamp when the thread was created. */\n  createdAt?: string;\n  /** ISO-8601 timestamp when the thread was last updated. */\n  updatedAt?: string;\n  /** Whether the thread has been archived. Archived threads are excluded from default list results. */\n  archived?: boolean;\n  /** The agent that owns this thread. */\n  agentId?: string;\n  /** The user who created this thread. */\n  createdById?: string;\n  /** The organization this thread belongs to. */\n  organizationId?: string;\n}\n\n/** Response from listing threads for a user/agent pair. */\nexport interface ListThreadsResponse {\n  /** The matching threads, sorted by the platform's default ordering. */\n  threads: ThreadSummary[];\n  /** Join code for subscribing to realtime metadata updates for these threads. */\n  joinCode: string;\n  /** Short-lived token for authenticating the realtime subscription. */\n  joinToken?: string;\n  /** Opaque cursor for fetching the next page. `null` or absent when there are no more pages. */\n  nextCursor?: string | null;\n}\n\n/**\n * Fields that can be updated on a thread via {@link CopilotKitIntelligence.updateThread}.\n *\n * Additional platform-specific fields can be passed as extra keys and will be\n * forwarded to the PATCH request body.\n */\nexport interface UpdateThreadRequest {\n  /** New human-readable display name for the thread. */\n  name?: string;\n  [key: string]: unknown;\n}\n\n/** Parameters for creating a new thread via {@link CopilotKitIntelligence.createThread}. */\nexport interface CreateThreadRequest {\n  /** Client-generated unique identifier for the new thread. */\n  threadId: string;\n  /** The user creating the thread. Used for authorization and scoping. */\n  userId: string;\n  /** The agent this thread belongs to. */\n  agentId: string;\n  /** Optional initial display name. If omitted, the thread is unnamed until explicitly renamed. */\n  name?: string;\n}\n\n/** Credentials returned when locking or joining a thread's realtime channel. */\nexport interface ThreadConnectionResponse {\n  /** Short-lived token for authenticating the Phoenix channel join. */\n  joinToken: string;\n  /** Optional join code that can be shared with other clients to join the same channel. */\n  joinCode?: string;\n}\n\nexport interface SubscribeToThreadsRequest {\n  userId: string;\n}\n\nexport interface SubscribeToThreadsResponse {\n  joinToken: string;\n}\n\nexport interface ConnectThreadBootstrapResponse {\n  mode: \"bootstrap\";\n  latestEventId: string | null;\n  events: BaseEvent[];\n}\n\nexport interface ConnectThreadLiveResponse {\n  mode: \"live\";\n  joinToken: string;\n  joinFromEventId: string | null;\n  events: BaseEvent[];\n}\n\nexport type ConnectThreadResponse =\n  | ConnectThreadBootstrapResponse\n  | ConnectThreadLiveResponse\n  | null;\n\n/** A single message within a thread's persisted history. */\nexport interface ThreadMessage {\n  /** Unique identifier for this message. */\n  id: string;\n  /** Message role, e.g. `\"user\"`, `\"assistant\"`, `\"tool\"`. */\n  role: string;\n  /** Text content of the message. May be absent for tool-call-only messages. */\n  content?: string;\n  /** Tool calls initiated by this message (assistant role only). */\n  toolCalls?: Array<{\n    id: string;\n    name: string;\n    /** JSON-encoded arguments passed to the tool. */\n    args: string;\n  }>;\n  /** For tool-result messages, the ID of the tool call this message responds to. */\n  toolCallId?: string;\n}\n\n/** Response from {@link CopilotKitIntelligence.getThreadMessages}. */\nexport interface ThreadMessagesResponse {\n  messages: ThreadMessage[];\n}\n\nexport interface AcquireThreadLockRequest {\n  threadId: string;\n  runId: string;\n  userId: string;\n}\n\ninterface ThreadEnvelope {\n  thread: ThreadSummary;\n}\n\nexport class CopilotKitIntelligence {\n  #apiUrl: string;\n  #runnerWsUrl: string;\n  #clientWsUrl: string;\n  #apiKey: string;\n  #organizationId: string;\n  #threadCreatedListeners = new Set<(thread: ThreadSummary) => void>();\n  #threadUpdatedListeners = new Set<(thread: ThreadSummary) => void>();\n  #threadDeletedListeners = new Set<(params: ThreadDeletedPayload) => void>();\n\n  constructor(config: CopilotKitIntelligenceConfig) {\n    const intelligenceWsUrl = normalizeIntelligenceWsUrl(config.wsUrl);\n\n    this.#apiUrl = config.apiUrl.replace(/\\/$/, \"\");\n    this.#runnerWsUrl = deriveRunnerWsUrl(intelligenceWsUrl);\n    this.#clientWsUrl = deriveClientWsUrl(intelligenceWsUrl);\n    this.#apiKey = config.apiKey;\n    this.#organizationId = config.organizationId;\n\n    if (config.onThreadCreated) {\n      this.onThreadCreated(config.onThreadCreated);\n    }\n    if (config.onThreadUpdated) {\n      this.onThreadUpdated(config.onThreadUpdated);\n    }\n    if (config.onThreadDeleted) {\n      this.onThreadDeleted(config.onThreadDeleted);\n    }\n  }\n\n  /**\n   * Register a listener invoked whenever a thread is created.\n   *\n   * Multiple listeners can be registered. Each call returns an unsubscribe\n   * function that removes the listener when called.\n   *\n   * @param callback - Receives the newly created {@link ThreadSummary}.\n   * @returns A function that removes this listener when called.\n   *\n   * @example\n   * ```ts\n   * const unsubscribe = intelligence.onThreadCreated((thread) => {\n   *   console.log(\"Thread created:\", thread.id);\n   * });\n   * // later…\n   * unsubscribe();\n   * ```\n   */\n  onThreadCreated(callback: (thread: ThreadSummary) => void): () => void {\n    this.#threadCreatedListeners.add(callback);\n    return () => {\n      this.#threadCreatedListeners.delete(callback);\n    };\n  }\n\n  /**\n   * Register a listener invoked whenever a thread is updated (including archive).\n   *\n   * Multiple listeners can be registered. Each call returns an unsubscribe\n   * function that removes the listener when called.\n   *\n   * @param callback - Receives the updated {@link ThreadSummary}.\n   * @returns A function that removes this listener when called.\n   */\n  onThreadUpdated(callback: (thread: ThreadSummary) => void): () => void {\n    this.#threadUpdatedListeners.add(callback);\n    return () => {\n      this.#threadUpdatedListeners.delete(callback);\n    };\n  }\n\n  /**\n   * Register a listener invoked whenever a thread is deleted.\n   *\n   * Multiple listeners can be registered. Each call returns an unsubscribe\n   * function that removes the listener when called.\n   *\n   * @param callback - Receives the {@link ThreadDeletedPayload} identifying\n   *   the deleted thread.\n   * @returns A function that removes this listener when called.\n   */\n  onThreadDeleted(\n    callback: (params: ThreadDeletedPayload) => void,\n  ): () => void {\n    this.#threadDeletedListeners.add(callback);\n    return () => {\n      this.#threadDeletedListeners.delete(callback);\n    };\n  }\n\n  ɵgetApiUrl(): string {\n    return this.#apiUrl;\n  }\n\n  ɵgetRunnerWsUrl(): string {\n    return this.#runnerWsUrl;\n  }\n\n  ɵgetClientWsUrl(): string {\n    return this.#clientWsUrl;\n  }\n\n  ɵgetOrganizationId(): string {\n    return this.#organizationId;\n  }\n\n  ɵgetRunnerAuthToken(): string {\n    return this.#apiKey;\n  }\n\n  async #request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const url = `${this.#apiUrl}${path}`;\n\n    const headers: Record<string, string> = {\n      Authorization: `Bearer ${this.#apiKey}`,\n      \"Content-Type\": \"application/json\",\n      \"X-Organization-Id\": this.#organizationId,\n    };\n\n    const response = await fetch(url, {\n      method,\n      headers,\n      body: body ? JSON.stringify(body) : undefined,\n    });\n\n    if (!response.ok) {\n      const text = await response.text().catch(() => \"\");\n      logger.error(\n        { status: response.status, body: text, path },\n        \"Intelligence platform request failed\",\n      );\n      throw new PlatformRequestError(\n        `Intelligence platform error ${response.status}: ${text || response.statusText}`,\n        response.status,\n      );\n    }\n\n    const text = await response.text();\n    if (!text) {\n      return undefined as T;\n    }\n    return JSON.parse(text) as T;\n  }\n\n  #invokeLifecycleCallback(\n    callbackName: \"onThreadCreated\" | \"onThreadUpdated\" | \"onThreadDeleted\",\n    payload: ThreadSummary | ThreadDeletedPayload,\n  ): void {\n    const listeners =\n      callbackName === \"onThreadCreated\"\n        ? this.#threadCreatedListeners\n        : callbackName === \"onThreadUpdated\"\n          ? this.#threadUpdatedListeners\n          : this.#threadDeletedListeners;\n\n    for (const callback of listeners) {\n      try {\n        void (callback as (p: typeof payload) => void)(payload);\n      } catch (error) {\n        logger.error(\n          { err: error, callbackName, payload },\n          \"Intelligence lifecycle callback failed\",\n        );\n      }\n    }\n  }\n\n  /**\n   * List all non-archived threads for a given user and agent.\n   *\n   * @param params.userId - User whose threads to list.\n   * @param params.agentId - Agent whose threads to list.\n   * @returns The thread list along with realtime subscription credentials.\n   * @throws {@link PlatformRequestError} on non-2xx responses.\n   */\n  async listThreads(params: {\n    userId: string;\n    agentId: string;\n    includeArchived?: boolean;\n    limit?: number;\n    cursor?: string;\n  }): Promise<ListThreadsResponse> {\n    const query: Record<string, string> = {\n      userId: params.userId,\n      agentId: params.agentId,\n    };\n    if (params.includeArchived) query.includeArchived = \"true\";\n    if (params.limit != null) query.limit = String(params.limit);\n    if (params.cursor) query.cursor = params.cursor;\n\n    const qs = new URLSearchParams(query).toString();\n    return this.#request<ListThreadsResponse>(\"GET\", `/api/threads?${qs}`);\n  }\n\n  async ɵsubscribeToThreads(\n    params: SubscribeToThreadsRequest,\n  ): Promise<SubscribeToThreadsResponse> {\n    return this.#request<SubscribeToThreadsResponse>(\n      \"POST\",\n      \"/api/threads/subscribe\",\n      {\n        userId: params.userId,\n      },\n    );\n  }\n\n  /**\n   * Update thread metadata (e.g. name).\n   *\n   * Triggers the `onThreadUpdated` lifecycle callback on success.\n   *\n   * @returns The updated thread summary.\n   * @throws {@link PlatformRequestError} on non-2xx responses.\n   */\n  async updateThread(params: {\n    threadId: string;\n    userId: string;\n    agentId: string;\n    updates: UpdateThreadRequest;\n  }): Promise<ThreadSummary> {\n    const response = await this.#request<ThreadEnvelope>(\n      \"PATCH\",\n      `/api/threads/${encodeURIComponent(params.threadId)}`,\n      {\n        userId: params.userId,\n        agentId: params.agentId,\n        ...params.updates,\n      },\n    );\n    this.#invokeLifecycleCallback(\"onThreadUpdated\", response.thread);\n    return response.thread;\n  }\n\n  /**\n   * Create a new thread on the platform.\n   *\n   * Triggers the `onThreadCreated` lifecycle callback on success.\n   *\n   * @returns The newly created thread summary.\n   * @throws {@link PlatformRequestError} with status 409 if a thread with the\n   *   same `threadId` already exists.\n   */\n  async createThread(params: CreateThreadRequest): Promise<ThreadSummary> {\n    const response = await this.#request<ThreadEnvelope>(\n      \"POST\",\n      `/api/threads`,\n      {\n        threadId: params.threadId,\n        userId: params.userId,\n        agentId: params.agentId,\n        ...(params.name !== undefined ? { name: params.name } : {}),\n      },\n    );\n    this.#invokeLifecycleCallback(\"onThreadCreated\", response.thread);\n    return response.thread;\n  }\n\n  /**\n   * Fetch a single thread by ID.\n   *\n   * @returns The thread summary.\n   * @throws {@link PlatformRequestError} with status 404 if the thread does\n   *   not exist.\n   */\n  async getThread(params: { threadId: string }): Promise<ThreadSummary> {\n    const response = await this.#request<ThreadEnvelope>(\n      \"GET\",\n      `/api/threads/${encodeURIComponent(params.threadId)}`,\n    );\n    return response.thread;\n  }\n\n  /**\n   * Get an existing thread or create it if it does not exist.\n   *\n   * Handles the race where a concurrent request creates the thread between\n   * the initial 404 and the subsequent `createThread` call by catching the\n   * 409 Conflict and retrying the get.\n   *\n   * Triggers the `onThreadCreated` lifecycle callback when a new thread is\n   * created.\n   *\n   * @returns An object containing the thread and a `created` flag indicating\n   *   whether the thread was newly created (`true`) or already existed (`false`).\n   * @throws {@link PlatformRequestError} on non-2xx responses other than\n   *   404 (get) and 409 (create race).\n   */\n  async getOrCreateThread(\n    params: CreateThreadRequest,\n  ): Promise<{ thread: ThreadSummary; created: boolean }> {\n    try {\n      const thread = await this.getThread({ threadId: params.threadId });\n      return { thread, created: false };\n    } catch (error) {\n      if (!(error instanceof PlatformRequestError && error.status === 404)) {\n        throw error;\n      }\n    }\n\n    try {\n      const thread = await this.createThread(params);\n      return { thread, created: true };\n    } catch (error) {\n      // Another request created the thread between our get and create — retry get.\n      if (error instanceof PlatformRequestError && error.status === 409) {\n        const thread = await this.getThread({ threadId: params.threadId });\n        return { thread, created: false };\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Fetch the full message history for a thread.\n   *\n   * @returns All persisted messages in chronological order.\n   * @throws {@link PlatformRequestError} on non-2xx responses.\n   */\n  async getThreadMessages(params: {\n    threadId: string;\n  }): Promise<ThreadMessagesResponse> {\n    return this.#request<ThreadMessagesResponse>(\n      \"GET\",\n      `/api/threads/${encodeURIComponent(params.threadId)}/messages`,\n    );\n  }\n\n  /**\n   * Mark a thread as archived.\n   *\n   * Archived threads are excluded from {@link listThreads} results.\n   * Triggers the `onThreadUpdated` lifecycle callback on success.\n   *\n   * @throws {@link PlatformRequestError} on non-2xx responses.\n   */\n  async archiveThread(params: {\n    threadId: string;\n    userId: string;\n    agentId: string;\n  }): Promise<void> {\n    const response = await this.#request<ThreadEnvelope>(\n      \"PATCH\",\n      `/api/threads/${encodeURIComponent(params.threadId)}`,\n      { userId: params.userId, agentId: params.agentId, archived: true },\n    );\n    this.#invokeLifecycleCallback(\"onThreadUpdated\", response.thread);\n  }\n\n  /**\n   * Permanently delete a thread and its message history.\n   *\n   * This is irreversible. Triggers the `onThreadDeleted` lifecycle callback\n   * on success.\n   *\n   * @throws {@link PlatformRequestError} on non-2xx responses.\n   */\n  async deleteThread(params: {\n    threadId: string;\n    userId: string;\n    agentId: string;\n  }): Promise<void> {\n    await this.#request<void>(\n      \"DELETE\",\n      `/api/threads/${encodeURIComponent(params.threadId)}`,\n      {\n        reason: `Deleted via CopilotKit runtime (userId=${params.userId}, agentId=${params.agentId})`,\n      },\n    );\n    this.#invokeLifecycleCallback(\"onThreadDeleted\", params);\n  }\n\n  async ɵacquireThreadLock(\n    params: AcquireThreadLockRequest,\n  ): Promise<ThreadConnectionResponse> {\n    return this.#request<ThreadConnectionResponse>(\n      \"POST\",\n      `/api/threads/${encodeURIComponent(params.threadId)}/lock`,\n      { runId: params.runId, userId: params.userId },\n    );\n  }\n\n  async ɵgetActiveJoinCode(params: {\n    threadId: string;\n    userId: string;\n  }): Promise<ThreadConnectionResponse> {\n    const qs = new URLSearchParams({ userId: params.userId }).toString();\n    return this.#request<ThreadConnectionResponse>(\n      \"GET\",\n      `/api/threads/${encodeURIComponent(params.threadId)}/join-code?${qs}`,\n    );\n  }\n\n  async ɵconnectThread(params: {\n    threadId: string;\n    userId: string;\n    lastSeenEventId?: string | null;\n  }): Promise<ConnectThreadResponse> {\n    const result = await this.#request<\n      ConnectThreadBootstrapResponse | ConnectThreadLiveResponse\n    >(\"POST\", `/api/threads/${encodeURIComponent(params.threadId)}/connect`, {\n      userId: params.userId,\n      ...(params.lastSeenEventId !== undefined\n        ? { lastSeenEventId: params.lastSeenEventId }\n        : {}),\n    });\n\n    // request() returns undefined for empty/204 responses\n    return result ?? null;\n  }\n}\n\nfunction normalizeIntelligenceWsUrl(wsUrl: string): string {\n  return wsUrl.replace(/\\/$/, \"\");\n}\n\nfunction deriveRunnerWsUrl(wsUrl: string): string {\n  if (wsUrl.endsWith(\"/runner\")) {\n    return wsUrl;\n  }\n\n  if (wsUrl.endsWith(\"/client\")) {\n    return `${wsUrl.slice(0, -\"/client\".length)}/runner`;\n  }\n\n  return `${wsUrl}/runner`;\n}\n\nfunction deriveClientWsUrl(wsUrl: string): string {\n  if (wsUrl.endsWith(\"/client\")) {\n    return wsUrl;\n  }\n\n  if (wsUrl.endsWith(\"/runner\")) {\n    return `${wsUrl.slice(0, -\"/runner\".length)}/client`;\n  }\n\n  return `${wsUrl}/client`;\n}\n"],"mappings":"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"}

package/dist/v2/runtime/intelligence-platform/index.d.mts

@@ -0,0 +1,2 @@
+import "reflect-metadata";
+import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./client.mjs";

package/dist/v2/runtime/middleware-sse-parser.cjs

@@ -0,0 +1,138 @@
+require("reflect-metadata");
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+let _copilotkit_shared = require("@copilotkit/shared");
+
+//#region src/v2/runtime/middleware-sse-parser.ts
+/**
+* Parse a cloned SSE Response body into structured messages.
+* Returns empty results for non-SSE responses.
+*/
+async function parseSSEResponse(response) {
+	if (!(response.headers.get("content-type") ?? "").includes("text/event-stream")) return { messages: [] };
+	let text;
+	try {
+		text = await response.text();
+	} catch {
+		_copilotkit_shared.logger.warn("Failed to read SSE response body in afterRequestMiddleware");
+		return { messages: [] };
+	}
+	if (!text.trim()) return { messages: [] };
+	let threadId;
+	let runId;
+	const messagesById = /* @__PURE__ */ new Map();
+	const toolCallsById = /* @__PURE__ */ new Map();
+	const toolCallParent = /* @__PURE__ */ new Map();
+	let snapshotMessages;
+	for (const line of text.split("\n")) {
+		const trimmed = line.trim();
+		if (!trimmed.startsWith("data:")) continue;
+		let event;
+		try {
+			event = JSON.parse(trimmed.slice(5).trim());
+		} catch {
+			continue;
+		}
+		switch (event.type) {
+			case "RUN_STARTED":
+				threadId = event.threadId;
+				runId = event.runId;
+				break;
+			case "MESSAGES_SNAPSHOT":
+				if (Array.isArray(event.messages)) snapshotMessages = event.messages;
+				break;
+			case "TEXT_MESSAGE_START":
+				messagesById.set(event.messageId, {
+					id: event.messageId,
+					role: event.role ?? "assistant",
+					content: ""
+				});
+				break;
+			case "TEXT_MESSAGE_CONTENT": {
+				const msg = messagesById.get(event.messageId);
+				if (msg) msg.content = (msg.content ?? "") + (event.delta ?? "");
+				break;
+			}
+			case "TEXT_MESSAGE_CHUNK":
+				if (event.messageId) {
+					const existing = messagesById.get(event.messageId);
+					if (existing) existing.content = (existing.content ?? "") + (event.delta ?? "");
+					else messagesById.set(event.messageId, {
+						id: event.messageId,
+						role: event.role ?? "assistant",
+						content: event.delta ?? ""
+					});
+				}
+				break;
+			case "TOOL_CALL_START": {
+				const tc = {
+					id: event.toolCallId,
+					name: event.toolCallName,
+					args: ""
+				};
+				toolCallsById.set(event.toolCallId, tc);
+				if (event.parentMessageId) toolCallParent.set(event.toolCallId, event.parentMessageId);
+				break;
+			}
+			case "TOOL_CALL_ARGS": {
+				const tc = toolCallsById.get(event.toolCallId);
+				if (tc) tc.args += event.delta ?? "";
+				break;
+			}
+			case "TOOL_CALL_CHUNK":
+				if (event.toolCallId) {
+					let tc = toolCallsById.get(event.toolCallId);
+					if (!tc) {
+						tc = {
+							id: event.toolCallId,
+							name: event.toolCallName ?? "",
+							args: ""
+						};
+						toolCallsById.set(event.toolCallId, tc);
+						if (event.parentMessageId) toolCallParent.set(event.toolCallId, event.parentMessageId);
+					}
+					if (event.toolCallName) tc.name = event.toolCallName;
+					tc.args += event.delta ?? "";
+				}
+				break;
+			case "TOOL_CALL_END": {
+				const tc = toolCallsById.get(event.toolCallId);
+				const parentId = toolCallParent.get(event.toolCallId);
+				if (tc && parentId) {
+					const parent = messagesById.get(parentId);
+					if (parent) {
+						parent.toolCalls = parent.toolCalls ?? [];
+						parent.toolCalls.push(tc);
+					}
+				}
+				break;
+			}
+			case "TOOL_CALL_RESULT":
+				messagesById.set(event.messageId, {
+					id: event.messageId,
+					role: "tool",
+					content: event.content,
+					toolCallId: event.toolCallId
+				});
+				break;
+		}
+	}
+	for (const [toolCallId, tc] of toolCallsById) {
+		const parentId = toolCallParent.get(toolCallId);
+		if (!parentId) continue;
+		const parent = messagesById.get(parentId);
+		if (!parent) continue;
+		if (!parent.toolCalls?.some((t) => t.id === tc.id)) {
+			parent.toolCalls = parent.toolCalls ?? [];
+			parent.toolCalls.push(tc);
+		}
+	}
+	return {
+		messages: snapshotMessages ?? [...messagesById.values()],
+		threadId,
+		runId
+	};
+}
+
+//#endregion
+exports.parseSSEResponse = parseSSEResponse;
+//# sourceMappingURL=middleware-sse-parser.cjs.map

package/dist/v2/runtime/middleware-sse-parser.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-sse-parser.cjs","names":[],"sources":["../../../src/v2/runtime/middleware-sse-parser.ts"],"sourcesContent":["import { logger } from \"@copilotkit/shared\";\n\nexport interface ParsedSSEResult {\n  messages: Message[];\n  threadId?: string;\n  runId?: string;\n}\n\n/** Minimal message shape reconstructed from AG-UI events. */\nexport interface Message {\n  id: string;\n  role: string;\n  content?: string;\n  toolCalls?: ToolCall[];\n  toolCallId?: string;\n}\n\ninterface ToolCall {\n  id: string;\n  name: string;\n  args: string;\n}\n\n/**\n * Parse a cloned SSE Response body into structured messages.\n * Returns empty results for non-SSE responses.\n */\nexport async function parseSSEResponse(\n  response: Response,\n): Promise<ParsedSSEResult> {\n  const contentType = response.headers.get(\"content-type\") ?? \"\";\n  if (!contentType.includes(\"text/event-stream\")) {\n    return { messages: [] };\n  }\n\n  let text: string;\n  try {\n    text = await response.text();\n  } catch {\n    logger.warn(\"Failed to read SSE response body in afterRequestMiddleware\");\n    return { messages: [] };\n  }\n\n  if (!text.trim()) {\n    return { messages: [] };\n  }\n\n  let threadId: string | undefined;\n  let runId: string | undefined;\n  const messagesById = new Map<string, Message>();\n  const toolCallsById = new Map<string, ToolCall>();\n  const toolCallParent = new Map<string, string>(); // toolCallId → messageId\n  let snapshotMessages: Message[] | undefined;\n\n  for (const line of text.split(\"\\n\")) {\n    const trimmed = line.trim();\n    if (!trimmed.startsWith(\"data:\")) continue;\n\n    let event: Record<string, any>;\n    try {\n      event = JSON.parse(trimmed.slice(5).trim());\n    } catch {\n      continue;\n    }\n\n    switch (event.type) {\n      case \"RUN_STARTED\":\n        threadId = event.threadId;\n        runId = event.runId;\n        break;\n\n      case \"MESSAGES_SNAPSHOT\":\n        if (Array.isArray(event.messages)) {\n          snapshotMessages = event.messages;\n        }\n        break;\n\n      case \"TEXT_MESSAGE_START\":\n        messagesById.set(event.messageId, {\n          id: event.messageId,\n          role: event.role ?? \"assistant\",\n          content: \"\",\n        });\n        break;\n\n      case \"TEXT_MESSAGE_CONTENT\": {\n        const msg = messagesById.get(event.messageId);\n        if (msg) {\n          msg.content = (msg.content ?? \"\") + (event.delta ?? \"\");\n        }\n        break;\n      }\n\n      case \"TEXT_MESSAGE_CHUNK\": {\n        // Chunk format: combined start+content. First chunk creates the\n        // message, subsequent chunks append delta to content.\n        if (event.messageId) {\n          const existing = messagesById.get(event.messageId);\n          if (existing) {\n            existing.content = (existing.content ?? \"\") + (event.delta ?? \"\");\n          } else {\n            messagesById.set(event.messageId, {\n              id: event.messageId,\n              role: event.role ?? \"assistant\",\n              content: event.delta ?? \"\",\n            });\n          }\n        }\n        break;\n      }\n\n      case \"TOOL_CALL_START\": {\n        const tc: ToolCall = {\n          id: event.toolCallId,\n          name: event.toolCallName,\n          args: \"\",\n        };\n        toolCallsById.set(event.toolCallId, tc);\n        if (event.parentMessageId) {\n          toolCallParent.set(event.toolCallId, event.parentMessageId);\n        }\n        break;\n      }\n\n      case \"TOOL_CALL_ARGS\": {\n        const tc = toolCallsById.get(event.toolCallId);\n        if (tc) {\n          tc.args += event.delta ?? \"\";\n        }\n        break;\n      }\n\n      case \"TOOL_CALL_CHUNK\": {\n        // Chunk format: combined start+args. First chunk for a given\n        // toolCallId creates the tool call, subsequent chunks append delta.\n        if (event.toolCallId) {\n          let tc = toolCallsById.get(event.toolCallId);\n          if (!tc) {\n            tc = {\n              id: event.toolCallId,\n              name: event.toolCallName ?? \"\",\n              args: \"\",\n            };\n            toolCallsById.set(event.toolCallId, tc);\n            if (event.parentMessageId) {\n              toolCallParent.set(event.toolCallId, event.parentMessageId);\n            }\n          }\n          if (event.toolCallName) {\n            tc.name = event.toolCallName;\n          }\n          tc.args += event.delta ?? \"\";\n        }\n        break;\n      }\n\n      case \"TOOL_CALL_END\": {\n        const tc = toolCallsById.get(event.toolCallId);\n        const parentId = toolCallParent.get(event.toolCallId);\n        if (tc && parentId) {\n          const parent = messagesById.get(parentId);\n          if (parent) {\n            parent.toolCalls = parent.toolCalls ?? [];\n            parent.toolCalls.push(tc);\n          }\n        }\n        break;\n      }\n\n      case \"TOOL_CALL_RESULT\":\n        messagesById.set(event.messageId, {\n          id: event.messageId,\n          role: \"tool\",\n          content: event.content,\n          toolCallId: event.toolCallId,\n        });\n        break;\n    }\n  }\n\n  // Attach any tool calls not yet linked to their parent message.\n  // This handles TOOL_CALL_CHUNK flows which don't emit TOOL_CALL_END.\n  for (const [toolCallId, tc] of toolCallsById) {\n    const parentId = toolCallParent.get(toolCallId);\n    if (!parentId) continue;\n    const parent = messagesById.get(parentId);\n    if (!parent) continue;\n    const alreadyAttached = parent.toolCalls?.some((t) => t.id === tc.id);\n    if (!alreadyAttached) {\n      parent.toolCalls = parent.toolCalls ?? [];\n      parent.toolCalls.push(tc);\n    }\n  }\n\n  // Prefer MESSAGES_SNAPSHOT if present (contains full history).\n  // Otherwise reconstruct from individual events.\n  const messages = snapshotMessages ?? [...messagesById.values()];\n\n  return { messages, threadId, runId };\n}\n"],"mappings":"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"}

package/dist/v2/runtime/middleware-sse-parser.d.cts

@@ -0,0 +1,22 @@
+
+//#region src/v2/runtime/middleware-sse-parser.d.ts
+/** Minimal message shape reconstructed from AG-UI events. */
+interface Message {
+  id: string;
+  role: string;
+  content?: string;
+  toolCalls?: ToolCall[];
+  toolCallId?: string;
+}
+interface ToolCall {
+  id: string;
+  name: string;
+  args: string;
+}
+/**
+ * Parse a cloned SSE Response body into structured messages.
+ * Returns empty results for non-SSE responses.
+ */
+//#endregion
+export { Message };
+//# sourceMappingURL=middleware-sse-parser.d.cts.map

package/dist/v2/runtime/middleware-sse-parser.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-sse-parser.d.cts","names":[],"sources":["../../../src/v2/runtime/middleware-sse-parser.ts"],"mappings":";;;UASiB,OAAA;EACf,EAAA;EACA,IAAA;EACA,OAAA;EACA,SAAA,GAAY,QAAA;EACZ,UAAA;AAAA;AAAA,UAGQ,QAAA;EACR,EAAA;EACA,IAAA;EACA,IAAA;AAAA"}

package/dist/v2/runtime/middleware-sse-parser.d.mts

@@ -0,0 +1,22 @@
+import "reflect-metadata";
+//#region src/v2/runtime/middleware-sse-parser.d.ts
+/** Minimal message shape reconstructed from AG-UI events. */
+interface Message {
+  id: string;
+  role: string;
+  content?: string;
+  toolCalls?: ToolCall[];
+  toolCallId?: string;
+}
+interface ToolCall {
+  id: string;
+  name: string;
+  args: string;
+}
+/**
+ * Parse a cloned SSE Response body into structured messages.
+ * Returns empty results for non-SSE responses.
+ */
+//#endregion
+export { Message };
+//# sourceMappingURL=middleware-sse-parser.d.mts.map

package/dist/v2/runtime/middleware-sse-parser.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-sse-parser.d.mts","names":[],"sources":["../../../src/v2/runtime/middleware-sse-parser.ts"],"mappings":";;;UASiB,OAAA;EACf,EAAA;EACA,IAAA;EACA,OAAA;EACA,SAAA,GAAY,QAAA;EACZ,UAAA;AAAA;AAAA,UAGQ,QAAA;EACR,EAAA;EACA,IAAA;EACA,IAAA;AAAA"}