@copilotkit/runtime 1.54.1 → 1.55.0-next.7

package/dist/v2/runtime/runner/intelligence.d.cts

@@ -0,0 +1,57 @@
+
+import { AgentRunner, AgentRunnerConnectRequest, AgentRunnerIsRunningRequest, AgentRunnerRunRequest, AgentRunnerStopRequest } from "./agent-runner.cjs";
+import { Observable } from "rxjs";
+import { BaseEvent } from "@ag-ui/client";
+
+//#region src/v2/runtime/runner/intelligence.d.ts
+interface IntelligenceAgentRunnerOptions {
+  /** Phoenix runner websocket URL, e.g. "ws://localhost:4000/runner" */
+  url: string;
+  /** Optional Phoenix socket auth token used during websocket connect. */
+  authToken?: string;
+}
+declare class IntelligenceAgentRunner extends AgentRunner {
+  private options;
+  private threads;
+  constructor(options: IntelligenceAgentRunnerOptions);
+  /**
+   * Create a new Phoenix socket with explicit exponential backoff.
+   *
+   * Each run/connect gets its own socket so that:
+   *  - A socket failure only affects a single thread, not all threads.
+   *  - Cleanup is simple: channel.leave() + socket.disconnect() tears
+   *    down everything for that run with no shared-state concerns.
+   *  - Each run gets its own independent retry budget.
+   *
+   * reconnectAfterMs — delay before Phoenix reconnects the WebSocket
+   *   after an unclean close. 100ms base, doubling up to a 10s cap.
+   *
+   * rejoinAfterMs — delay before Phoenix re-joins a channel that
+   *   entered the "errored" state. 1s base, doubling up to 30s cap.
+   *
+   * These are set explicitly because Phoenix's default schedule is a
+   * fixed stepped array (not exponential), and any code that calls
+   * socket.disconnect() in an onError handler will set
+   * closeWasClean = true and reset the reconnect timer — permanently
+   * killing retries.
+   */
+  private createSocket;
+  private createRunnerEventPayload;
+  private stampRunnerMetadata;
+  run(request: AgentRunnerRunRequest): Observable<BaseEvent>;
+  connect(request: AgentRunnerConnectRequest): Observable<BaseEvent>;
+  isRunning(request: AgentRunnerIsRunningRequest): Promise<boolean>;
+  stop(request: AgentRunnerStopRequest): Promise<boolean | undefined>;
+  private executeAgentRun;
+  /**
+   * Tear down all resources for a thread: leave the channel,
+   * disconnect the per-run socket, and remove the thread state.
+   *
+   * Idempotent — safe to call multiple times for the same threadId
+   * (e.g. from join error handlers, finalize, and Observable teardown).
+   */
+  private removeThread;
+}
+//#endregion
+export { IntelligenceAgentRunner, IntelligenceAgentRunnerOptions };
+//# sourceMappingURL=intelligence.d.cts.map

package/dist/v2/runtime/runner/intelligence.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intelligence.d.cts","names":[],"sources":["../../../../src/v2/runtime/runner/intelligence.ts"],"mappings":";;;;;;UAuBiB,8BAAA;;EAEf,GAAA;EAF6C;EAI7C,SAAA;AAAA;AAAA,cAcW,uBAAA,SAAgC,WAAA;EAAA,QACnC,OAAA;EAAA,QACA,OAAA;cAEI,OAAA,EAAS,8BAAA;EAAA;;;;;;;;;;;;;;;;;;;;;EAAA,QA2Bb,YAAA;EAAA,QAUA,wBAAA;EAAA,QAqBA,mBAAA;EA8BR,GAAA,CAAI,OAAA,EAAS,qBAAA,GAAwB,UAAA,CAAW,SAAA;EA8GhD,OAAA,CAAQ,OAAA,EAAS,yBAAA,GAA4B,UAAA,CAAW,SAAA;EA4CxD,SAAA,CAAU,OAAA,EAAS,2BAAA,GAA8B,OAAA;EAKjD,IAAA,CAAK,OAAA,EAAS,sBAAA,GAAyB,OAAA;EAAA,QAoB/B,eAAA;EArES;;;;;;;EAAA,QAqKT,YAAA;AAAA"}

package/dist/v2/runtime/runner/intelligence.d.mts

@@ -0,0 +1,57 @@
+import "reflect-metadata";
+import { AgentRunner, AgentRunnerConnectRequest, AgentRunnerIsRunningRequest, AgentRunnerRunRequest, AgentRunnerStopRequest } from "./agent-runner.mjs";
+import { Observable } from "rxjs";
+import { BaseEvent } from "@ag-ui/client";
+
+//#region src/v2/runtime/runner/intelligence.d.ts
+interface IntelligenceAgentRunnerOptions {
+  /** Phoenix runner websocket URL, e.g. "ws://localhost:4000/runner" */
+  url: string;
+  /** Optional Phoenix socket auth token used during websocket connect. */
+  authToken?: string;
+}
+declare class IntelligenceAgentRunner extends AgentRunner {
+  private options;
+  private threads;
+  constructor(options: IntelligenceAgentRunnerOptions);
+  /**
+   * Create a new Phoenix socket with explicit exponential backoff.
+   *
+   * Each run/connect gets its own socket so that:
+   *  - A socket failure only affects a single thread, not all threads.
+   *  - Cleanup is simple: channel.leave() + socket.disconnect() tears
+   *    down everything for that run with no shared-state concerns.
+   *  - Each run gets its own independent retry budget.
+   *
+   * reconnectAfterMs — delay before Phoenix reconnects the WebSocket
+   *   after an unclean close. 100ms base, doubling up to a 10s cap.
+   *
+   * rejoinAfterMs — delay before Phoenix re-joins a channel that
+   *   entered the "errored" state. 1s base, doubling up to 30s cap.
+   *
+   * These are set explicitly because Phoenix's default schedule is a
+   * fixed stepped array (not exponential), and any code that calls
+   * socket.disconnect() in an onError handler will set
+   * closeWasClean = true and reset the reconnect timer — permanently
+   * killing retries.
+   */
+  private createSocket;
+  private createRunnerEventPayload;
+  private stampRunnerMetadata;
+  run(request: AgentRunnerRunRequest): Observable<BaseEvent>;
+  connect(request: AgentRunnerConnectRequest): Observable<BaseEvent>;
+  isRunning(request: AgentRunnerIsRunningRequest): Promise<boolean>;
+  stop(request: AgentRunnerStopRequest): Promise<boolean | undefined>;
+  private executeAgentRun;
+  /**
+   * Tear down all resources for a thread: leave the channel,
+   * disconnect the per-run socket, and remove the thread state.
+   *
+   * Idempotent — safe to call multiple times for the same threadId
+   * (e.g. from join error handlers, finalize, and Observable teardown).
+   */
+  private removeThread;
+}
+//#endregion
+export { IntelligenceAgentRunner, IntelligenceAgentRunnerOptions };
+//# sourceMappingURL=intelligence.d.mts.map

package/dist/v2/runtime/runner/intelligence.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intelligence.d.mts","names":[],"sources":["../../../../src/v2/runtime/runner/intelligence.ts"],"mappings":";;;;;;UAuBiB,8BAAA;;EAEf,GAAA;EAF6C;EAI7C,SAAA;AAAA;AAAA,cAcW,uBAAA,SAAgC,WAAA;EAAA,QACnC,OAAA;EAAA,QACA,OAAA;cAEI,OAAA,EAAS,8BAAA;EAAA;;;;;;;;;;;;;;;;;;;;;EAAA,QA2Bb,YAAA;EAAA,QAUA,wBAAA;EAAA,QAqBA,mBAAA;EA8BR,GAAA,CAAI,OAAA,EAAS,qBAAA,GAAwB,UAAA,CAAW,SAAA;EA8GhD,OAAA,CAAQ,OAAA,EAAS,yBAAA,GAA4B,UAAA,CAAW,SAAA;EA4CxD,SAAA,CAAU,OAAA,EAAS,2BAAA,GAA8B,OAAA;EAKjD,IAAA,CAAK,OAAA,EAAS,sBAAA,GAAyB,OAAA;EAAA,QAoB/B,eAAA;EArES;;;;;;;EAAA,QAqKT,YAAA;AAAA"}

package/dist/v2/runtime/runner/intelligence.mjs

@@ -0,0 +1,245 @@
+import "reflect-metadata";
+import { AgentRunner } from "./agent-runner.mjs";
+import { AG_UI_CHANNEL_EVENT, finalizeRunEvents, phoenixExponentialBackoff } from "@copilotkit/shared";
+import { EMPTY, Observable, from } from "rxjs";
+import { randomUUID as randomUUID$1 } from "node:crypto";
+import { EventType } from "@ag-ui/client";
+import { catchError as catchError$1, finalize as finalize$1 } from "rxjs/operators";
+import { Socket } from "phoenix";
+
+//#region src/v2/runtime/runner/intelligence.ts
+var IntelligenceAgentRunner = class extends AgentRunner {
+	constructor(options) {
+		super();
+		this.threads = /* @__PURE__ */ new Map();
+		this.options = options;
+	}
+	/**
+	* Create a new Phoenix socket with explicit exponential backoff.
+	*
+	* Each run/connect gets its own socket so that:
+	*  - A socket failure only affects a single thread, not all threads.
+	*  - Cleanup is simple: channel.leave() + socket.disconnect() tears
+	*    down everything for that run with no shared-state concerns.
+	*  - Each run gets its own independent retry budget.
+	*
+	* reconnectAfterMs — delay before Phoenix reconnects the WebSocket
+	*   after an unclean close. 100ms base, doubling up to a 10s cap.
+	*
+	* rejoinAfterMs — delay before Phoenix re-joins a channel that
+	*   entered the "errored" state. 1s base, doubling up to 30s cap.
+	*
+	* These are set explicitly because Phoenix's default schedule is a
+	* fixed stepped array (not exponential), and any code that calls
+	* socket.disconnect() in an onError handler will set
+	* closeWasClean = true and reset the reconnect timer — permanently
+	* killing retries.
+	*/
+	createSocket() {
+		const socket = new Socket(this.options.url, {
+			...this.options.authToken ? { authToken: this.options.authToken } : {},
+			reconnectAfterMs: phoenixExponentialBackoff(100, 1e4),
+			rejoinAfterMs: phoenixExponentialBackoff(1e3, 3e4)
+		});
+		socket.connect();
+		return socket;
+	}
+	createRunnerEventPayload(event, request, state) {
+		const payload = { ...this.stampRunnerMetadata(event, state) };
+		payload.thread_id ??= request.threadId;
+		const runId = payload.runId ?? payload.run_id ?? request.input.runId;
+		if (runId) payload.run_id = runId;
+		return payload;
+	}
+	stampRunnerMetadata(event, state) {
+		const eventRecord = event;
+		const existingMetadata = eventRecord.metadata ?? {};
+		const hasEventId = typeof existingMetadata.cpki_event_id === "string";
+		const hasEventSeq = typeof existingMetadata.cpki_event_seq === "number";
+		if (hasEventId && hasEventSeq) {
+			const eventSeq = existingMetadata.cpki_event_seq;
+			state.nextEventSeq = Math.max(state.nextEventSeq, eventSeq + 1);
+			return eventRecord;
+		}
+		const eventSeq = state.nextEventSeq++;
+		return {
+			...eventRecord,
+			metadata: {
+				...existingMetadata,
+				cpki_event_id: typeof existingMetadata.cpki_event_id === "string" ? existingMetadata.cpki_event_id : randomUUID$1(),
+				cpki_event_seq: eventSeq
+			}
+		};
+	}
+	run(request) {
+		const { threadId, agent, input, joinCode } = request;
+		if (this.threads.get(threadId)?.isRunning) throw new Error("Thread already running");
+		return new Observable((observer) => {
+			const socket = this.createSocket();
+			const channelTopic = joinCode ?? threadId;
+			const channel = socket.channel(`ingestion:${channelTopic}`, { runId: input.runId });
+			const state = {
+				socket,
+				channel,
+				isRunning: true,
+				stopRequested: false,
+				agent,
+				currentEvents: [],
+				nextEventSeq: 1,
+				hasRunStarted: false
+			};
+			this.threads.set(threadId, state);
+			const MAX_CONSECUTIVE_ERRORS = 5;
+			let consecutiveErrors = 0;
+			socket.onError(() => {
+				consecutiveErrors++;
+				if (consecutiveErrors >= MAX_CONSECUTIVE_ERRORS && state.agent) try {
+					state.agent.abortRun();
+				} catch {}
+			});
+			socket.onOpen(() => {
+				consecutiveErrors = 0;
+			});
+			channel.on(AG_UI_CHANNEL_EVENT, (payload) => {
+				if (payload.type === EventType.CUSTOM && payload.name === "stop") this.stop({ threadId });
+			});
+			channel.join().receive("ok", () => {
+				this.executeAgentRun(request, state, threadId).subscribe({ complete: () => observer.complete() });
+			}).receive("error", (resp) => {
+				const errorEvent = {
+					type: EventType.RUN_ERROR,
+					message: `Failed to join channel: ${JSON.stringify(resp)}`,
+					code: "CHANNEL_JOIN_ERROR"
+				};
+				observer.next(errorEvent);
+				state.currentEvents.push(errorEvent);
+				this.removeThread(threadId);
+				observer.complete();
+			}).receive("timeout", () => {
+				const errorEvent = {
+					type: EventType.RUN_ERROR,
+					message: "Timed out joining channel",
+					code: "CHANNEL_JOIN_TIMEOUT"
+				};
+				observer.next(errorEvent);
+				state.currentEvents.push(errorEvent);
+				this.removeThread(threadId);
+				observer.complete();
+			});
+			return () => {
+				this.removeThread(threadId);
+			};
+		});
+	}
+	connect(request) {
+		const { threadId } = request;
+		return new Observable((observer) => {
+			const socket = this.createSocket();
+			const channel = socket.channel(`thread:${threadId}`);
+			channel.on("ag_ui_event", (payload) => {
+				observer.next(payload);
+				if (payload.type === EventType.RUN_FINISHED || payload.type === EventType.RUN_ERROR) observer.complete();
+			});
+			const cleanup = () => {
+				channel.leave();
+				socket.disconnect();
+			};
+			channel.join().receive("ok", () => void 0).receive("error", (resp) => {
+				observer.error(/* @__PURE__ */ new Error(`Failed to join channel: ${JSON.stringify(resp)}`));
+				cleanup();
+			}).receive("timeout", () => {
+				observer.error(/* @__PURE__ */ new Error("Timed out joining channel"));
+				cleanup();
+			});
+			return () => {
+				cleanup();
+			};
+		});
+	}
+	isRunning(request) {
+		const state = this.threads.get(request.threadId);
+		return Promise.resolve(state?.isRunning ?? false);
+	}
+	stop(request) {
+		const state = this.threads.get(request.threadId);
+		if (!state || !state.isRunning || state.stopRequested) return Promise.resolve(false);
+		state.stopRequested = true;
+		if (state.agent) try {
+			state.agent.abortRun();
+		} catch {}
+		return Promise.resolve(true);
+	}
+	executeAgentRun(request, state, threadId) {
+		const { currentEvents, channel } = state;
+		const pushCanonicalEvent = (event) => {
+			const canonicalEvent = this.stampRunnerMetadata(event, state);
+			currentEvents.push(canonicalEvent);
+			if (canonicalEvent.type === EventType.RUN_STARTED) state.hasRunStarted = true;
+			channel.push("event", this.createRunnerEventPayload(canonicalEvent, request, state));
+		};
+		const getPersistedInputMessages = () => request.persistedInputMessages ?? request.input.messages;
+		const buildRunStartedEvent = (source) => {
+			const baseInput = source?.input ?? request.input;
+			const persistedInputMessages = getPersistedInputMessages();
+			return {
+				...source ?? {
+					type: EventType.RUN_STARTED,
+					threadId: request.threadId,
+					runId: request.input.runId
+				},
+				input: {
+					...baseInput,
+					...persistedInputMessages !== void 0 ? { messages: persistedInputMessages } : {}
+				}
+			};
+		};
+		const ensureRunStarted = () => {
+			if (!state.hasRunStarted) {
+				state.hasRunStarted = true;
+				pushCanonicalEvent(buildRunStartedEvent());
+			}
+		};
+		return from(request.agent.runAgent(request.input, { onEvent: ({ event }) => {
+			if (event.type === EventType.RUN_STARTED) {
+				pushCanonicalEvent(buildRunStartedEvent(event));
+				return;
+			}
+			ensureRunStarted();
+			pushCanonicalEvent(event);
+		} })).pipe(catchError$1((error) => {
+			ensureRunStarted();
+			pushCanonicalEvent({
+				type: EventType.RUN_ERROR,
+				message: error instanceof Error ? error.message : String(error)
+			});
+			return EMPTY;
+		}), finalize$1(() => {
+			ensureRunStarted();
+			const appended = finalizeRunEvents(currentEvents, { stopRequested: state.stopRequested });
+			for (const event of appended) channel.push("event", this.createRunnerEventPayload(event, request, state));
+			this.removeThread(threadId);
+		}));
+	}
+	/**
+	* Tear down all resources for a thread: leave the channel,
+	* disconnect the per-run socket, and remove the thread state.
+	*
+	* Idempotent — safe to call multiple times for the same threadId
+	* (e.g. from join error handlers, finalize, and Observable teardown).
+	*/
+	removeThread(threadId) {
+		const state = this.threads.get(threadId);
+		if (!state) return;
+		this.threads.delete(threadId);
+		try {
+			state.channel.leave();
+		} catch {}
+		try {
+			state.socket.disconnect();
+		} catch {}
+	}
+};
+
+//#endregion
+export { IntelligenceAgentRunner };
+//# sourceMappingURL=intelligence.mjs.map

package/dist/v2/runtime/runner/intelligence.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"intelligence.mjs","names":["randomUUID","catchError","finalize"],"sources":["../../../../src/v2/runtime/runner/intelligence.ts"],"sourcesContent":["import {\n  AgentRunner,\n  AgentRunnerConnectRequest,\n  AgentRunnerIsRunningRequest,\n  AgentRunnerRunRequest,\n  type AgentRunnerStopRequest,\n} from \"./agent-runner\";\nimport { EMPTY, Observable, from } from \"rxjs\";\nimport { catchError, finalize } from \"rxjs/operators\";\nimport {\n  AbstractAgent,\n  BaseEvent,\n  EventType,\n  RunStartedEvent,\n} from \"@ag-ui/client\";\nimport {\n  finalizeRunEvents,\n  AG_UI_CHANNEL_EVENT,\n  phoenixExponentialBackoff,\n} from \"@copilotkit/shared\";\nimport { Socket, Channel } from \"phoenix\";\nimport { randomUUID } from \"node:crypto\";\n\nexport interface IntelligenceAgentRunnerOptions {\n  /** Phoenix runner websocket URL, e.g. \"ws://localhost:4000/runner\" */\n  url: string;\n  /** Optional Phoenix socket auth token used during websocket connect. */\n  authToken?: string;\n}\n\ninterface ThreadState {\n  socket: Socket;\n  channel: Channel;\n  isRunning: boolean;\n  stopRequested: boolean;\n  agent: AbstractAgent | null;\n  currentEvents: BaseEvent[];\n  nextEventSeq: number;\n  hasRunStarted: boolean;\n}\n\nexport class IntelligenceAgentRunner extends AgentRunner {\n  private options: IntelligenceAgentRunnerOptions;\n  private threads = new Map<string, ThreadState>();\n\n  constructor(options: IntelligenceAgentRunnerOptions) {\n    super();\n    // Store config — sockets are created per-run, not eagerly.\n    this.options = options;\n  }\n\n  /**\n   * Create a new Phoenix socket with explicit exponential backoff.\n   *\n   * Each run/connect gets its own socket so that:\n   *  - A socket failure only affects a single thread, not all threads.\n   *  - Cleanup is simple: channel.leave() + socket.disconnect() tears\n   *    down everything for that run with no shared-state concerns.\n   *  - Each run gets its own independent retry budget.\n   *\n   * reconnectAfterMs — delay before Phoenix reconnects the WebSocket\n   *   after an unclean close. 100ms base, doubling up to a 10s cap.\n   *\n   * rejoinAfterMs — delay before Phoenix re-joins a channel that\n   *   entered the \"errored\" state. 1s base, doubling up to 30s cap.\n   *\n   * These are set explicitly because Phoenix's default schedule is a\n   * fixed stepped array (not exponential), and any code that calls\n   * socket.disconnect() in an onError handler will set\n   * closeWasClean = true and reset the reconnect timer — permanently\n   * killing retries.\n   */\n  private createSocket(): Socket {\n    const socket = new Socket(this.options.url, {\n      ...(this.options.authToken ? { authToken: this.options.authToken } : {}),\n      reconnectAfterMs: phoenixExponentialBackoff(100, 10_000),\n      rejoinAfterMs: phoenixExponentialBackoff(1_000, 30_000),\n    });\n    socket.connect();\n    return socket;\n  }\n\n  private createRunnerEventPayload(\n    event: BaseEvent,\n    request: AgentRunnerRunRequest,\n    state: ThreadState,\n  ): Record<string, unknown> {\n    const canonicalEvent = this.stampRunnerMetadata(event, state);\n    const payload = {\n      ...(canonicalEvent as Record<string, unknown>),\n    };\n\n    payload.thread_id ??= request.threadId;\n\n    const runId = payload.runId ?? payload.run_id ?? request.input.runId;\n\n    if (runId) {\n      payload.run_id = runId;\n    }\n\n    return payload;\n  }\n\n  private stampRunnerMetadata(event: BaseEvent, state: ThreadState): BaseEvent {\n    const eventRecord = event as BaseEvent & {\n      metadata?: Record<string, unknown>;\n    };\n\n    const existingMetadata = eventRecord.metadata ?? {};\n    const hasEventId = typeof existingMetadata.cpki_event_id === \"string\";\n    const hasEventSeq = typeof existingMetadata.cpki_event_seq === \"number\";\n\n    if (hasEventId && hasEventSeq) {\n      const eventSeq = existingMetadata.cpki_event_seq as number;\n      state.nextEventSeq = Math.max(state.nextEventSeq, eventSeq + 1);\n      return eventRecord;\n    }\n\n    const eventSeq = state.nextEventSeq++;\n\n    return {\n      ...eventRecord,\n      metadata: {\n        ...existingMetadata,\n        cpki_event_id:\n          typeof existingMetadata.cpki_event_id === \"string\"\n            ? existingMetadata.cpki_event_id\n            : randomUUID(),\n        cpki_event_seq: eventSeq,\n      },\n    };\n  }\n\n  run(request: AgentRunnerRunRequest): Observable<BaseEvent> {\n    const { threadId, agent, input, joinCode } = request;\n\n    const existing = this.threads.get(threadId);\n    if (existing?.isRunning) {\n      throw new Error(\"Thread already running\");\n    }\n\n    return new Observable((observer) => {\n      const socket = this.createSocket();\n\n      const channelTopic = joinCode ?? threadId;\n      const channel = socket.channel(`ingestion:${channelTopic}`, {\n        runId: input.runId,\n      });\n\n      const state: ThreadState = {\n        socket,\n        channel,\n        isRunning: true,\n        stopRequested: false,\n        agent,\n        currentEvents: [],\n        nextEventSeq: 1,\n        hasRunStarted: false,\n      };\n      this.threads.set(threadId, state);\n\n      // Track consecutive socket errors for this run. Phoenix retries\n      // automatically via reconnectAfterMs, but if the connection fails\n      // repeatedly we abort the agent — otherwise runAgent() completes\n      // normally, finalization events buffer silently on the dead\n      // channel, and the client never receives them.\n      //\n      // Aborting the agent is the single trigger that cascades through\n      // the existing error pipeline: runAgent() rejects → catchError\n      // pushes RUN_ERROR → finalize calls finalizeRunEvents +\n      // removeThread → channel.leave() + socket.disconnect().\n      const MAX_CONSECUTIVE_ERRORS = 5;\n      let consecutiveErrors = 0;\n\n      socket.onError(() => {\n        consecutiveErrors++;\n        if (consecutiveErrors >= MAX_CONSECUTIVE_ERRORS && state.agent) {\n          try {\n            state.agent.abortRun();\n          } catch {\n            // Ignore abort errors.\n          }\n        }\n        // Otherwise: Phoenix retries automatically using the exponential\n        // backoff schedule configured in createSocket().\n      });\n\n      socket.onOpen(() => {\n        // A successful (re)connection resets the counter so transient\n        // network blips don't accumulate across recoveries.\n        consecutiveErrors = 0;\n      });\n\n      // Listen for custom \"stop\" events pushed by the client over the\n      // channel. This must be registered before channel.join() so the\n      // handler is in place by the time the server starts relaying messages.\n      // The client sends the stop event before leaving the channel, so the\n      // runner is guaranteed to receive it while still joined.\n      channel.on(AG_UI_CHANNEL_EVENT, (payload: BaseEvent) => {\n        if (\n          payload.type === EventType.CUSTOM &&\n          (payload as BaseEvent & { name?: string }).name === \"stop\"\n        ) {\n          this.stop({ threadId });\n        }\n      });\n\n      channel\n        .join()\n        .receive(\"ok\", () => {\n          this.executeAgentRun(request, state, threadId).subscribe({\n            complete: () => observer.complete(),\n          });\n        })\n        .receive(\"error\", (resp) => {\n          const errorEvent = {\n            type: EventType.RUN_ERROR,\n            message: `Failed to join channel: ${JSON.stringify(resp)}`,\n            code: \"CHANNEL_JOIN_ERROR\",\n          } as BaseEvent;\n          observer.next(errorEvent);\n          state.currentEvents.push(errorEvent);\n          this.removeThread(threadId);\n          observer.complete();\n        })\n        .receive(\"timeout\", () => {\n          const errorEvent = {\n            type: EventType.RUN_ERROR,\n            message: \"Timed out joining channel\",\n            code: \"CHANNEL_JOIN_TIMEOUT\",\n          } as BaseEvent;\n          observer.next(errorEvent);\n          state.currentEvents.push(errorEvent);\n          this.removeThread(threadId);\n          observer.complete();\n        });\n\n      return () => {\n        this.removeThread(threadId);\n      };\n    });\n  }\n\n  connect(request: AgentRunnerConnectRequest): Observable<BaseEvent> {\n    const { threadId } = request;\n\n    return new Observable((observer) => {\n      const socket = this.createSocket();\n\n      const channel = socket.channel(`thread:${threadId}`);\n\n      channel.on(\"ag_ui_event\", (payload: BaseEvent) => {\n        observer.next(payload);\n\n        if (\n          payload.type === EventType.RUN_FINISHED ||\n          payload.type === EventType.RUN_ERROR\n        ) {\n          observer.complete();\n        }\n      });\n\n      const cleanup = () => {\n        channel.leave();\n        socket.disconnect();\n      };\n\n      channel\n        .join()\n        .receive(\"ok\", () => undefined)\n        .receive(\"error\", (resp) => {\n          observer.error(\n            new Error(`Failed to join channel: ${JSON.stringify(resp)}`),\n          );\n          cleanup();\n        })\n        .receive(\"timeout\", () => {\n          observer.error(new Error(\"Timed out joining channel\"));\n          cleanup();\n        });\n\n      return () => {\n        cleanup();\n      };\n    });\n  }\n\n  isRunning(request: AgentRunnerIsRunningRequest): Promise<boolean> {\n    const state = this.threads.get(request.threadId);\n    return Promise.resolve(state?.isRunning ?? false);\n  }\n\n  stop(request: AgentRunnerStopRequest): Promise<boolean | undefined> {\n    const state = this.threads.get(request.threadId);\n    if (!state || !state.isRunning || state.stopRequested) {\n      return Promise.resolve(false);\n    }\n\n    state.stopRequested = true;\n\n    // Direct local abort — the runtime is the authority.\n    if (state.agent) {\n      try {\n        state.agent.abortRun();\n      } catch {\n        // Ignore abort errors.\n      }\n    }\n\n    return Promise.resolve(true);\n  }\n\n  private executeAgentRun(\n    request: AgentRunnerRunRequest,\n    state: ThreadState,\n    threadId: string,\n  ): Observable<void> {\n    const { currentEvents, channel } = state;\n    const pushCanonicalEvent = (event: BaseEvent): void => {\n      const canonicalEvent = this.stampRunnerMetadata(event, state);\n      currentEvents.push(canonicalEvent);\n\n      if (canonicalEvent.type === EventType.RUN_STARTED) {\n        state.hasRunStarted = true;\n      }\n\n      channel.push(\n        \"event\",\n        this.createRunnerEventPayload(canonicalEvent, request, state),\n      );\n    };\n\n    const getPersistedInputMessages = () =>\n      request.persistedInputMessages ?? request.input.messages;\n\n    const buildRunStartedEvent = (\n      source?: RunStartedEvent,\n    ): RunStartedEvent => {\n      const baseInput = source?.input ?? request.input;\n      const persistedInputMessages = getPersistedInputMessages();\n\n      return {\n        ...(source ?? {\n          type: EventType.RUN_STARTED,\n          threadId: request.threadId,\n          runId: request.input.runId,\n        }),\n        input: {\n          ...baseInput,\n          ...(persistedInputMessages !== undefined\n            ? { messages: persistedInputMessages }\n            : {}),\n        },\n      } as RunStartedEvent;\n    };\n\n    const ensureRunStarted = (): void => {\n      if (!state.hasRunStarted) {\n        state.hasRunStarted = true;\n        pushCanonicalEvent(buildRunStartedEvent());\n      }\n    };\n\n    return from(\n      request.agent.runAgent(request.input, {\n        onEvent: ({ event }: { event: BaseEvent }) => {\n          if (event.type === EventType.RUN_STARTED) {\n            pushCanonicalEvent(buildRunStartedEvent(event as RunStartedEvent));\n            return;\n          }\n\n          ensureRunStarted();\n          pushCanonicalEvent(event);\n        },\n      }),\n    ).pipe(\n      catchError((error) => {\n        ensureRunStarted();\n        const errorEvent = {\n          type: EventType.RUN_ERROR,\n          message: error instanceof Error ? error.message : String(error),\n        } as BaseEvent;\n        pushCanonicalEvent(errorEvent);\n        return EMPTY;\n      }),\n      finalize(() => {\n        ensureRunStarted();\n        const appended = finalizeRunEvents(currentEvents, {\n          stopRequested: state.stopRequested,\n        });\n        for (const event of appended) {\n          channel.push(\n            \"event\",\n            this.createRunnerEventPayload(event, request, state),\n          );\n        }\n        this.removeThread(threadId);\n      }),\n    );\n  }\n\n  /**\n   * Tear down all resources for a thread: leave the channel,\n   * disconnect the per-run socket, and remove the thread state.\n   *\n   * Idempotent — safe to call multiple times for the same threadId\n   * (e.g. from join error handlers, finalize, and Observable teardown).\n   */\n  private removeThread(threadId: string): void {\n    const state = this.threads.get(threadId);\n    if (!state) {\n      return;\n    }\n\n    // Delete first so concurrent calls see the entry as already removed.\n    this.threads.delete(threadId);\n\n    try {\n      state.channel.leave();\n    } catch {\n      // Channel may already be closed/left.\n    }\n    try {\n      state.socket.disconnect();\n    } catch {\n      // Socket may already be disconnected.\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/v2/runtime/runtime.cjs

@@ -0,0 +1,101 @@
+require("reflect-metadata");
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_package$1 = require('../../package.cjs');
+const require_in_memory = require('./runner/in-memory.cjs');
+const require_intelligence = require('./runner/intelligence.cjs');
+let _copilotkit_shared = require("@copilotkit/shared");
+
+//#region src/v2/runtime/runtime.ts
+var import_package = /* @__PURE__ */ require_runtime.__toESM(require_package$1.default);
+const VERSION = import_package.default.version;
+var BaseCopilotRuntime = class {
+	constructor(options, runner) {
+		const { agents, transcriptionService, beforeRequestMiddleware, afterRequestMiddleware, a2ui, mcpApps } = options;
+		this.agents = agents;
+		this.transcriptionService = transcriptionService;
+		this.beforeRequestMiddleware = beforeRequestMiddleware;
+		this.afterRequestMiddleware = afterRequestMiddleware;
+		this.a2ui = a2ui;
+		this.mcpApps = mcpApps;
+		this.runner = runner;
+		this.licenseChecker = (0, _copilotkit_shared.createLicenseChecker)(options.licenseToken);
+	}
+};
+var CopilotSseRuntime = class extends BaseCopilotRuntime {
+	constructor(options) {
+		super(options, options.runner ?? new require_in_memory.InMemoryAgentRunner());
+		this.intelligence = void 0;
+		this.mode = _copilotkit_shared.RUNTIME_MODE_SSE;
+	}
+};
+var CopilotIntelligenceRuntime = class extends BaseCopilotRuntime {
+	constructor(options) {
+		super(options, new require_intelligence.IntelligenceAgentRunner({
+			url: options.intelligence.ɵgetRunnerWsUrl(),
+			authToken: options.intelligence.ɵgetRunnerAuthToken()
+		}));
+		this.mode = _copilotkit_shared.RUNTIME_MODE_INTELLIGENCE;
+		this.intelligence = options.intelligence;
+		this.identifyUser = options.identifyUser;
+		this.generateThreadNames = options.generateThreadNames ?? true;
+	}
+};
+function hasIntelligenceOptions(options) {
+	return "intelligence" in options && !!options.intelligence;
+}
+function isIntelligenceRuntime(runtime) {
+	return runtime.mode === _copilotkit_shared.RUNTIME_MODE_INTELLIGENCE && !!runtime.intelligence;
+}
+/**
+* Compatibility shim that preserves the legacy `CopilotRuntime` entrypoint.
+* New code should prefer `CopilotSseRuntime` or `CopilotIntelligenceRuntime`.
+*/
+var CopilotRuntime = class {
+	constructor(options) {
+		this.delegate = hasIntelligenceOptions(options) ? new CopilotIntelligenceRuntime(options) : new CopilotSseRuntime(options);
+	}
+	get agents() {
+		return this.delegate.agents;
+	}
+	get transcriptionService() {
+		return this.delegate.transcriptionService;
+	}
+	get beforeRequestMiddleware() {
+		return this.delegate.beforeRequestMiddleware;
+	}
+	get afterRequestMiddleware() {
+		return this.delegate.afterRequestMiddleware;
+	}
+	get runner() {
+		return this.delegate.runner;
+	}
+	get a2ui() {
+		return this.delegate.a2ui;
+	}
+	get mcpApps() {
+		return this.delegate.mcpApps;
+	}
+	get intelligence() {
+		return this.delegate.intelligence;
+	}
+	get generateThreadNames() {
+		return isIntelligenceRuntime(this.delegate) ? this.delegate.generateThreadNames : void 0;
+	}
+	get identifyUser() {
+		return isIntelligenceRuntime(this.delegate) ? this.delegate.identifyUser : void 0;
+	}
+	get mode() {
+		return this.delegate.mode;
+	}
+	get licenseChecker() {
+		return this.delegate.licenseChecker;
+	}
+};
+
+//#endregion
+exports.CopilotIntelligenceRuntime = CopilotIntelligenceRuntime;
+exports.CopilotRuntime = CopilotRuntime;
+exports.CopilotSseRuntime = CopilotSseRuntime;
+exports.VERSION = VERSION;
+exports.isIntelligenceRuntime = isIntelligenceRuntime;
+//# sourceMappingURL=runtime.cjs.map

package/dist/v2/runtime/runtime.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.cjs","names":["pkg","InMemoryAgentRunner","RUNTIME_MODE_SSE","IntelligenceAgentRunner","RUNTIME_MODE_INTELLIGENCE"],"sources":["../../../src/v2/runtime/runtime.ts"],"sourcesContent":["import {\n  MaybePromise,\n  NonEmptyRecord,\n  RuntimeMode,\n  RUNTIME_MODE_SSE,\n  RUNTIME_MODE_INTELLIGENCE,\n  createLicenseChecker,\n  type LicenseChecker,\n} from \"@copilotkit/shared\";\nimport { AbstractAgent } from \"@ag-ui/client\";\nimport type { MCPClientConfig } from \"@ag-ui/mcp-apps-middleware\";\nimport { A2UIMiddlewareConfig } from \"@ag-ui/a2ui-middleware\";\nimport pkg from \"../../../package.json\";\nimport type {\n  BeforeRequestMiddleware,\n  AfterRequestMiddleware,\n} from \"./middleware\";\nimport { TranscriptionService } from \"./transcription-service/transcription-service\";\nimport { AgentRunner } from \"./runner/agent-runner\";\nimport { InMemoryAgentRunner } from \"./runner/in-memory\";\nimport { IntelligenceAgentRunner } from \"./runner/intelligence\";\nimport { CopilotKitIntelligence } from \"./intelligence-platform\";\n\nexport const VERSION = pkg.version;\n\ninterface BaseCopilotRuntimeMiddlewareOptions {\n  /** If set, middleware only applies to these named agents. Applies to all agents if omitted. */\n  agents?: string[];\n}\n\nexport type McpAppsServerConfig = MCPClientConfig & {\n  /** Agent to bind this server to. If omitted, the server is available to all agents. */\n  agentId?: string;\n};\n\nexport interface McpAppsConfig {\n  /** List of MCP server configurations. */\n  servers: McpAppsServerConfig[];\n}\n\ninterface CopilotRuntimeMiddlewares {\n  /** Auto-apply A2UIMiddleware to agents at run time. */\n  a2ui?: BaseCopilotRuntimeMiddlewareOptions & A2UIMiddlewareConfig;\n  /** Auto-apply MCPAppsMiddleware to agents at run time. */\n  mcpApps?: McpAppsConfig;\n}\n\ninterface BaseCopilotRuntimeOptions extends CopilotRuntimeMiddlewares {\n  /** Map of available agents (loaded lazily is fine). */\n  agents: MaybePromise<NonEmptyRecord<Record<string, AbstractAgent>>>;\n  /** Optional transcription service for audio processing. */\n  transcriptionService?: TranscriptionService;\n  /** Optional *before* middleware – callback function or webhook URL. */\n  beforeRequestMiddleware?: BeforeRequestMiddleware;\n  /** Optional *after* middleware – callback function or webhook URL. */\n  afterRequestMiddleware?: AfterRequestMiddleware;\n  /** Signed license token for server-side feature verification. Falls back to COPILOTKIT_LICENSE_TOKEN env var. */\n  licenseToken?: string;\n}\n\nexport interface CopilotRuntimeUser {\n  id: string;\n}\n\nexport type IdentifyUserCallback = (\n  request: Request,\n) => MaybePromise<CopilotRuntimeUser>;\n\nexport interface CopilotSseRuntimeOptions extends BaseCopilotRuntimeOptions {\n  /** The runner to use for running agents in SSE mode. */\n  runner?: AgentRunner;\n  intelligence?: undefined;\n  generateThreadNames?: undefined;\n}\n\nexport interface CopilotIntelligenceRuntimeOptions extends BaseCopilotRuntimeOptions {\n  /** Configures Intelligence mode for durable threads and realtime events. */\n  intelligence: CopilotKitIntelligence;\n  /** Resolves the authenticated user for intelligence requests. */\n  identifyUser: IdentifyUserCallback;\n  /** Auto-generate short names for newly created threads. */\n  generateThreadNames?: boolean;\n}\n\nexport type CopilotRuntimeOptions =\n  | CopilotSseRuntimeOptions\n  | CopilotIntelligenceRuntimeOptions;\n\nexport interface CopilotRuntimeLike {\n  agents: CopilotRuntimeOptions[\"agents\"];\n  transcriptionService: CopilotRuntimeOptions[\"transcriptionService\"];\n  beforeRequestMiddleware: CopilotRuntimeOptions[\"beforeRequestMiddleware\"];\n  afterRequestMiddleware: CopilotRuntimeOptions[\"afterRequestMiddleware\"];\n  runner: AgentRunner;\n  a2ui: CopilotRuntimeOptions[\"a2ui\"];\n  mcpApps: CopilotRuntimeOptions[\"mcpApps\"];\n  intelligence?: CopilotKitIntelligence;\n  identifyUser?: IdentifyUserCallback;\n  mode: RuntimeMode;\n  licenseChecker?: LicenseChecker;\n}\n\nexport interface CopilotSseRuntimeLike extends CopilotRuntimeLike {\n  intelligence?: undefined;\n  mode: RUNTIME_MODE_SSE;\n}\n\nexport interface CopilotIntelligenceRuntimeLike extends CopilotRuntimeLike {\n  intelligence: CopilotKitIntelligence;\n  identifyUser: IdentifyUserCallback;\n  generateThreadNames: boolean;\n  mode: RUNTIME_MODE_INTELLIGENCE;\n}\n\nabstract class BaseCopilotRuntime implements CopilotRuntimeLike {\n  public agents: CopilotRuntimeOptions[\"agents\"];\n  public transcriptionService: CopilotRuntimeOptions[\"transcriptionService\"];\n  public beforeRequestMiddleware: CopilotRuntimeOptions[\"beforeRequestMiddleware\"];\n  public afterRequestMiddleware: CopilotRuntimeOptions[\"afterRequestMiddleware\"];\n  public runner: AgentRunner;\n  public a2ui: CopilotRuntimeOptions[\"a2ui\"];\n  public mcpApps: CopilotRuntimeOptions[\"mcpApps\"];\n  public licenseChecker?: LicenseChecker;\n\n  abstract readonly intelligence?: CopilotKitIntelligence;\n  abstract readonly mode: RuntimeMode;\n\n  constructor(options: BaseCopilotRuntimeOptions, runner: AgentRunner) {\n    const {\n      agents,\n      transcriptionService,\n      beforeRequestMiddleware,\n      afterRequestMiddleware,\n      a2ui,\n      mcpApps,\n    } = options;\n\n    this.agents = agents;\n    this.transcriptionService = transcriptionService;\n    this.beforeRequestMiddleware = beforeRequestMiddleware;\n    this.afterRequestMiddleware = afterRequestMiddleware;\n    this.a2ui = a2ui;\n    this.mcpApps = mcpApps;\n    this.runner = runner;\n    this.licenseChecker = createLicenseChecker(options.licenseToken);\n  }\n}\n\nexport class CopilotSseRuntime\n  extends BaseCopilotRuntime\n  implements CopilotSseRuntimeLike\n{\n  readonly intelligence = undefined;\n  readonly mode = RUNTIME_MODE_SSE;\n\n  constructor(options: CopilotSseRuntimeOptions) {\n    super(options, options.runner ?? new InMemoryAgentRunner());\n  }\n}\n\nexport class CopilotIntelligenceRuntime\n  extends BaseCopilotRuntime\n  implements CopilotIntelligenceRuntimeLike\n{\n  readonly intelligence: CopilotKitIntelligence;\n  readonly identifyUser: IdentifyUserCallback;\n  readonly generateThreadNames: boolean;\n  readonly mode = RUNTIME_MODE_INTELLIGENCE;\n\n  constructor(options: CopilotIntelligenceRuntimeOptions) {\n    super(\n      options,\n      new IntelligenceAgentRunner({\n        url: options.intelligence.ɵgetRunnerWsUrl(),\n        authToken: options.intelligence.ɵgetRunnerAuthToken(),\n      }),\n    );\n    this.intelligence = options.intelligence;\n    this.identifyUser = options.identifyUser;\n    this.generateThreadNames = options.generateThreadNames ?? true;\n  }\n}\n\nfunction hasIntelligenceOptions(\n  options: CopilotRuntimeOptions,\n): options is CopilotIntelligenceRuntimeOptions {\n  return \"intelligence\" in options && !!options.intelligence;\n}\n\nexport function isIntelligenceRuntime(\n  runtime: CopilotRuntimeLike,\n): runtime is CopilotIntelligenceRuntimeLike {\n  return runtime.mode === RUNTIME_MODE_INTELLIGENCE && !!runtime.intelligence;\n}\n\n/**\n * Compatibility shim that preserves the legacy `CopilotRuntime` entrypoint.\n * New code should prefer `CopilotSseRuntime` or `CopilotIntelligenceRuntime`.\n */\nexport class CopilotRuntime implements CopilotRuntimeLike {\n  private delegate: CopilotRuntimeLike;\n\n  constructor(options: CopilotRuntimeOptions) {\n    this.delegate = hasIntelligenceOptions(options)\n      ? new CopilotIntelligenceRuntime(options)\n      : new CopilotSseRuntime(options);\n  }\n\n  get agents(): CopilotRuntimeOptions[\"agents\"] {\n    return this.delegate.agents;\n  }\n\n  get transcriptionService(): CopilotRuntimeOptions[\"transcriptionService\"] {\n    return this.delegate.transcriptionService;\n  }\n\n  get beforeRequestMiddleware(): CopilotRuntimeOptions[\"beforeRequestMiddleware\"] {\n    return this.delegate.beforeRequestMiddleware;\n  }\n\n  get afterRequestMiddleware(): CopilotRuntimeOptions[\"afterRequestMiddleware\"] {\n    return this.delegate.afterRequestMiddleware;\n  }\n\n  get runner(): AgentRunner {\n    return this.delegate.runner;\n  }\n\n  get a2ui(): CopilotRuntimeOptions[\"a2ui\"] {\n    return this.delegate.a2ui;\n  }\n\n  get mcpApps(): CopilotRuntimeOptions[\"mcpApps\"] {\n    return this.delegate.mcpApps;\n  }\n\n  get intelligence(): CopilotKitIntelligence | undefined {\n    return this.delegate.intelligence;\n  }\n\n  get generateThreadNames(): boolean | undefined {\n    return isIntelligenceRuntime(this.delegate)\n      ? this.delegate.generateThreadNames\n      : undefined;\n  }\n\n  get identifyUser(): IdentifyUserCallback | undefined {\n    return isIntelligenceRuntime(this.delegate)\n      ? this.delegate.identifyUser\n      : undefined;\n  }\n\n  get mode(): RuntimeMode {\n    return this.delegate.mode;\n  }\n\n  get licenseChecker() {\n    return this.delegate.licenseChecker;\n  }\n}\n"],"mappings":";;;;;;;;;AAuBA,MAAa,UAAUA,uBAAI;AA2F3B,IAAe,qBAAf,MAAgE;CAa9D,YAAY,SAAoC,QAAqB;EACnE,MAAM,EACJ,QACA,sBACA,yBACA,wBACA,MACA,YACE;AAEJ,OAAK,SAAS;AACd,OAAK,uBAAuB;AAC5B,OAAK,0BAA0B;AAC/B,OAAK,yBAAyB;AAC9B,OAAK,OAAO;AACZ,OAAK,UAAU;AACf,OAAK,SAAS;AACd,OAAK,8DAAsC,QAAQ,aAAa;;;AAIpE,IAAa,oBAAb,cACU,mBAEV;CAIE,YAAY,SAAmC;AAC7C,QAAM,SAAS,QAAQ,UAAU,IAAIC,uCAAqB,CAAC;sBAJrC;cACRC;;;AAOlB,IAAa,6BAAb,cACU,mBAEV;CAME,YAAY,SAA4C;AACtD,QACE,SACA,IAAIC,6CAAwB;GAC1B,KAAK,QAAQ,aAAa,iBAAiB;GAC3C,WAAW,QAAQ,aAAa,qBAAqB;GACtD,CAAC,CACH;cATaC;AAUd,OAAK,eAAe,QAAQ;AAC5B,OAAK,eAAe,QAAQ;AAC5B,OAAK,sBAAsB,QAAQ,uBAAuB;;;AAI9D,SAAS,uBACP,SAC8C;AAC9C,QAAO,kBAAkB,WAAW,CAAC,CAAC,QAAQ;;AAGhD,SAAgB,sBACd,SAC2C;AAC3C,QAAO,QAAQ,SAASA,gDAA6B,CAAC,CAAC,QAAQ;;;;;;AAOjE,IAAa,iBAAb,MAA0D;CAGxD,YAAY,SAAgC;AAC1C,OAAK,WAAW,uBAAuB,QAAQ,GAC3C,IAAI,2BAA2B,QAAQ,GACvC,IAAI,kBAAkB,QAAQ;;CAGpC,IAAI,SAA0C;AAC5C,SAAO,KAAK,SAAS;;CAGvB,IAAI,uBAAsE;AACxE,SAAO,KAAK,SAAS;;CAGvB,IAAI,0BAA4E;AAC9E,SAAO,KAAK,SAAS;;CAGvB,IAAI,yBAA0E;AAC5E,SAAO,KAAK,SAAS;;CAGvB,IAAI,SAAsB;AACxB,SAAO,KAAK,SAAS;;CAGvB,IAAI,OAAsC;AACxC,SAAO,KAAK,SAAS;;CAGvB,IAAI,UAA4C;AAC9C,SAAO,KAAK,SAAS;;CAGvB,IAAI,eAAmD;AACrD,SAAO,KAAK,SAAS;;CAGvB,IAAI,sBAA2C;AAC7C,SAAO,sBAAsB,KAAK,SAAS,GACvC,KAAK,SAAS,sBACd;;CAGN,IAAI,eAAiD;AACnD,SAAO,sBAAsB,KAAK,SAAS,GACvC,KAAK,SAAS,eACd;;CAGN,IAAI,OAAoB;AACtB,SAAO,KAAK,SAAS;;CAGvB,IAAI,iBAAiB;AACnB,SAAO,KAAK,SAAS"}

package/dist/v2/runtime/runtime.d.cts

@@ -0,0 +1,132 @@
+
+import { AfterRequestMiddleware, BeforeRequestMiddleware } from "./middleware.cjs";
+import { TranscriptionService } from "./transcription-service/transcription-service.cjs";
+import { AgentRunner } from "./runner/agent-runner.cjs";
+import { CopilotKitIntelligence } from "./intelligence-platform/client.cjs";
+import { LicenseChecker, MaybePromise, NonEmptyRecord, RuntimeMode } from "@copilotkit/shared";
+import { AbstractAgent } from "@ag-ui/client";
+import { MCPClientConfig } from "@ag-ui/mcp-apps-middleware";
+import { A2UIMiddlewareConfig } from "@ag-ui/a2ui-middleware";
+
+//#region src/v2/runtime/runtime.d.ts
+declare const VERSION: string;
+interface BaseCopilotRuntimeMiddlewareOptions {
+  /** If set, middleware only applies to these named agents. Applies to all agents if omitted. */
+  agents?: string[];
+}
+type McpAppsServerConfig = MCPClientConfig & {
+  /** Agent to bind this server to. If omitted, the server is available to all agents. */agentId?: string;
+};
+interface McpAppsConfig {
+  /** List of MCP server configurations. */
+  servers: McpAppsServerConfig[];
+}
+interface CopilotRuntimeMiddlewares {
+  /** Auto-apply A2UIMiddleware to agents at run time. */
+  a2ui?: BaseCopilotRuntimeMiddlewareOptions & A2UIMiddlewareConfig;
+  /** Auto-apply MCPAppsMiddleware to agents at run time. */
+  mcpApps?: McpAppsConfig;
+}
+interface BaseCopilotRuntimeOptions extends CopilotRuntimeMiddlewares {
+  /** Map of available agents (loaded lazily is fine). */
+  agents: MaybePromise<NonEmptyRecord<Record<string, AbstractAgent>>>;
+  /** Optional transcription service for audio processing. */
+  transcriptionService?: TranscriptionService;
+  /** Optional *before* middleware – callback function or webhook URL. */
+  beforeRequestMiddleware?: BeforeRequestMiddleware;
+  /** Optional *after* middleware – callback function or webhook URL. */
+  afterRequestMiddleware?: AfterRequestMiddleware;
+  /** Signed license token for server-side feature verification. Falls back to COPILOTKIT_LICENSE_TOKEN env var. */
+  licenseToken?: string;
+}
+interface CopilotRuntimeUser {
+  id: string;
+}
+type IdentifyUserCallback = (request: Request) => MaybePromise<CopilotRuntimeUser>;
+interface CopilotSseRuntimeOptions extends BaseCopilotRuntimeOptions {
+  /** The runner to use for running agents in SSE mode. */
+  runner?: AgentRunner;
+  intelligence?: undefined;
+  generateThreadNames?: undefined;
+}
+interface CopilotIntelligenceRuntimeOptions extends BaseCopilotRuntimeOptions {
+  /** Configures Intelligence mode for durable threads and realtime events. */
+  intelligence: CopilotKitIntelligence;
+  /** Resolves the authenticated user for intelligence requests. */
+  identifyUser: IdentifyUserCallback;
+  /** Auto-generate short names for newly created threads. */
+  generateThreadNames?: boolean;
+}
+type CopilotRuntimeOptions = CopilotSseRuntimeOptions | CopilotIntelligenceRuntimeOptions;
+interface CopilotRuntimeLike {
+  agents: CopilotRuntimeOptions["agents"];
+  transcriptionService: CopilotRuntimeOptions["transcriptionService"];
+  beforeRequestMiddleware: CopilotRuntimeOptions["beforeRequestMiddleware"];
+  afterRequestMiddleware: CopilotRuntimeOptions["afterRequestMiddleware"];
+  runner: AgentRunner;
+  a2ui: CopilotRuntimeOptions["a2ui"];
+  mcpApps: CopilotRuntimeOptions["mcpApps"];
+  intelligence?: CopilotKitIntelligence;
+  identifyUser?: IdentifyUserCallback;
+  mode: RuntimeMode;
+  licenseChecker?: LicenseChecker;
+}
+interface CopilotSseRuntimeLike extends CopilotRuntimeLike {
+  intelligence?: undefined;
+  mode: RUNTIME_MODE_SSE;
+}
+interface CopilotIntelligenceRuntimeLike extends CopilotRuntimeLike {
+  intelligence: CopilotKitIntelligence;
+  identifyUser: IdentifyUserCallback;
+  generateThreadNames: boolean;
+  mode: RUNTIME_MODE_INTELLIGENCE;
+}
+declare abstract class BaseCopilotRuntime implements CopilotRuntimeLike {
+  agents: CopilotRuntimeOptions["agents"];
+  transcriptionService: CopilotRuntimeOptions["transcriptionService"];
+  beforeRequestMiddleware: CopilotRuntimeOptions["beforeRequestMiddleware"];
+  afterRequestMiddleware: CopilotRuntimeOptions["afterRequestMiddleware"];
+  runner: AgentRunner;
+  a2ui: CopilotRuntimeOptions["a2ui"];
+  mcpApps: CopilotRuntimeOptions["mcpApps"];
+  licenseChecker?: LicenseChecker;
+  abstract readonly intelligence?: CopilotKitIntelligence;
+  abstract readonly mode: RuntimeMode;
+  constructor(options: BaseCopilotRuntimeOptions, runner: AgentRunner);
+}
+declare class CopilotSseRuntime extends BaseCopilotRuntime implements CopilotSseRuntimeLike {
+  readonly intelligence: any;
+  readonly mode: "sse";
+  constructor(options: CopilotSseRuntimeOptions);
+}
+declare class CopilotIntelligenceRuntime extends BaseCopilotRuntime implements CopilotIntelligenceRuntimeLike {
+  readonly intelligence: CopilotKitIntelligence;
+  readonly identifyUser: IdentifyUserCallback;
+  readonly generateThreadNames: boolean;
+  readonly mode: "intelligence";
+  constructor(options: CopilotIntelligenceRuntimeOptions);
+}
+declare function isIntelligenceRuntime(runtime: CopilotRuntimeLike): runtime is CopilotIntelligenceRuntimeLike;
+/**
+ * Compatibility shim that preserves the legacy `CopilotRuntime` entrypoint.
+ * New code should prefer `CopilotSseRuntime` or `CopilotIntelligenceRuntime`.
+ */
+declare class CopilotRuntime implements CopilotRuntimeLike {
+  private delegate;
+  constructor(options: CopilotRuntimeOptions);
+  get agents(): CopilotRuntimeOptions["agents"];
+  get transcriptionService(): CopilotRuntimeOptions["transcriptionService"];
+  get beforeRequestMiddleware(): CopilotRuntimeOptions["beforeRequestMiddleware"];
+  get afterRequestMiddleware(): CopilotRuntimeOptions["afterRequestMiddleware"];
+  get runner(): AgentRunner;
+  get a2ui(): CopilotRuntimeOptions["a2ui"];
+  get mcpApps(): CopilotRuntimeOptions["mcpApps"];
+  get intelligence(): CopilotKitIntelligence | undefined;
+  get generateThreadNames(): boolean | undefined;
+  get identifyUser(): IdentifyUserCallback | undefined;
+  get mode(): RuntimeMode;
+  get licenseChecker(): LicenseChecker;
+}
+//#endregion
+export { CopilotIntelligenceRuntime, CopilotIntelligenceRuntimeLike, CopilotIntelligenceRuntimeOptions, CopilotRuntime, CopilotRuntimeLike, CopilotRuntimeOptions, CopilotRuntimeUser, CopilotSseRuntime, CopilotSseRuntimeLike, CopilotSseRuntimeOptions, IdentifyUserCallback, McpAppsConfig, McpAppsServerConfig, VERSION, isIntelligenceRuntime };
+//# sourceMappingURL=runtime.d.cts.map