@copilotkit/core 1.63.1 → 1.63.2-canary.1784918757

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { Throttler } from "@tanstack/pacer";
-import { AbstractAgent, EventType, HttpAgent, randomUUID, runHttpRequest, structuredClone_, transformChunks, transformHttpEventStream } from "@ag-ui/client";
+import { AbstractAgent, EventType, HttpAgent, buildResumeArray, isInterruptExpired, randomUUID, runHttpRequest, structuredClone_, transformChunks, transformHttpEventStream } from "@ag-ui/client";
 import { RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE, logger, partialJSONParse, phoenixExponentialBackoff, randomUUID as randomUUID$1, resolveDebugConfig, schemaToJsonSchema } from "@copilotkit/shared";
 import { BehaviorSubject, EMPTY, NEVER, Notification, Observable, Subject, Subscription, asapScheduler, combineLatest, concat, defer, dematerialize, firstValueFrom, from, lastValueFrom, merge, observeOn, of, switchMap, throwError } from "rxjs";
 import { catchError, concatWith, delay, distinctUntilChanged, endWith, filter, finalize, ignoreElements, map, mergeMap, observeOn as observeOn$1, scan, share, shareReplay, switchMap as switchMap$1, take, takeUntil, tap, timeout, withLatestFrom } from "rxjs/operators";
@@ -601,6 +601,12 @@ var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends HttpAg
 	get capabilities() {
 		return this._capabilities;
 	}
+	requestInit(input) {
+		return {
+			...super.requestInit(input),
+			...this.credentials ? { credentials: this.credentials } : {}
+		};
+	}
 	async getCapabilities() {
 		return this._capabilities ?? {};
 	}
@@ -694,10 +700,12 @@ var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends HttpAg
 		}
 	}
 	connect(input) {
+		if (this.runtimeMode === "pending" || this.transport === "auto" && this.runtimeMode !== RUNTIME_MODE_INTELLIGENCE) return defer(() => from(this.ensureRuntimeConfiguration())).pipe(switchMap$1(() => this.connect(input)));
 		if (this.runtimeMode === RUNTIME_MODE_INTELLIGENCE) return this.#connectViaDelegate(input);
 		return this.#connectViaHttp(input);
 	}
 	run(input) {
+		if (this.runtimeMode === "pending" || this.transport === "auto" && this.runtimeMode !== RUNTIME_MODE_INTELLIGENCE) return defer(() => from(this.ensureRuntimeConfiguration())).pipe(switchMap$1(() => this.run(input)));
 		if (this.runtimeMode === RUNTIME_MODE_INTELLIGENCE) return this.#runViaDelegate(input);
 		return this.#runViaHttp(input);
 	}
@@ -767,7 +775,7 @@ var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends HttpAg
 		this.delegate?.clearReconnectCursor?.(threadId);
 	}
 	async resolveDelegate() {
-		await this.ensureRuntimeMode();
+		await this.ensureRuntimeConfiguration();
 		if (!this.delegate) {
 			if (this.runtimeMode !== RUNTIME_MODE_INTELLIGENCE) throw new Error("A delegate is only created for Intelligence mode");
 			this.delegate = this.createIntelligenceDelegate();
@@ -775,14 +783,21 @@ var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends HttpAg
 		this.syncDelegate(this.delegate);
 		return this.delegate;
 	}
-	async ensureRuntimeMode() {
-		if (this.runtimeMode !== "pending") return;
+	/** Resolve transport and runtime mode before the first outbound request. */
+	async ensureRuntimeConfiguration() {
+		if (this.runtimeMode === RUNTIME_MODE_INTELLIGENCE || this.runtimeMode !== "pending" && this.transport !== "auto") return;
 		if (!this.runtimeUrl) throw new Error("Runtime URL is not set");
-		this.runtimeInfoPromise ??= this.fetchRuntimeInfo().then((runtimeInfo) => {
+		const runtimeInfoPromise = this.runtimeInfoPromise ?? this.fetchRuntimeInfo().then((runtimeInfo) => {
 			this.runtimeMode = runtimeInfo.mode ?? RUNTIME_MODE_SSE;
 			this.intelligence = runtimeInfo.intelligence;
 		});
-		await this.runtimeInfoPromise;
+		this.runtimeInfoPromise = runtimeInfoPromise;
+		try {
+			await runtimeInfoPromise;
+		} catch (error) {
+			if (this.runtimeInfoPromise === runtimeInfoPromise) this.runtimeInfoPromise = void 0;
+			throw error;
+		}
 	}
 	async fetchRuntimeInfo() {
 		const headers = { ...this.headers };
@@ -1737,6 +1752,19 @@ const SUGGEST_TOOL = {
 //#endregion
 //#region src/core/run-handler.ts
 /**
+* Absolute safety cap on the depth of recursive follow-up runs triggered by
+* `processAgentResult`. Without this, any scenario that keeps
+* `needsFollowUp = true` (e.g. the LLM repeatedly calling the same tool, a
+* backend that errors after receiving tool results, or input processors that
+* reprocess tool messages) would loop indefinitely, silently consuming API
+* quota and potentially DOS'ing the backend.
+*
+* The cap is deliberately high so that legitimate multi-step agent workflows
+* (search → fill form → confirm → update → send email, etc.) are never
+* affected; it only trips on runaway recursion.
+*/
+const MAX_FOLLOW_UP_DEPTH = 100;
+/**
 * Handles agent execution, tool calling, and agent connectivity for CopilotKitCore.
 * Manages the complete lifecycle of agent runs including tool execution and follow-ups.
 */
@@ -1991,7 +2019,8 @@ var RunHandler = class {
 				}
 			}
 		}
-		if (needsFollowUp && !this._runAbortController?.signal.aborted) {
+		if (needsFollowUp && !this._runAbortController?.signal.aborted) if (this._runDepth >= MAX_FOLLOW_UP_DEPTH) logger.warn(`[CopilotKit] Follow-up depth limit (${MAX_FOLLOW_UP_DEPTH}) reached for agent "${agentId}". Stopping recursive follow-up runs to prevent an infinite loop. This usually indicates a tool that keeps requesting a follow-up (e.g. the LLM repeatedly calling the same tool). Consider setting "followUp: false" on the offending tool.`);
+		else {
 			await this._internal.waitForPendingFrameworkUpdates();
 			return await this.runAgent({ agent });
 		}
@@ -2314,6 +2343,7 @@ var RunHandler = class {
 				await emitAgentError(error, error instanceof AgentThreadLockedError ? CopilotKitCoreErrorCode.AGENT_THREAD_LOCKED : CopilotKitCoreErrorCode.AGENT_RUN_FAILED_EVENT, { source: "onRunFailed" });
 			},
 			onRunErrorEvent: async ({ event }) => {
+				if (this._runAbortController?.signal.aborted === true || event?.code === "abort") return;
 				const eventError = event?.rawEvent instanceof Error ? event.rawEvent : event?.rawEvent?.error instanceof Error ? event.rawEvent.error : void 0;
 				const errorMessage = typeof event?.rawEvent?.error === "string" ? event.rawEvent.error : event?.message ?? "Agent run error";
 				const rawError = eventError ?? new Error(errorMessage);
@@ -5248,5 +5278,110 @@ function ɵisCopilotKitFeature(name) {
 }
 
 //#endregion
-export { AgentRegistry, AgentThreadLockedError, ContextStore, CopilotKitCore, CopilotKitCoreErrorCode, CopilotKitCoreRuntimeConnectionStatus, IntelligenceAgent, MEMORY_ERROR_REGISTRY, MemoryError, ProxiedCopilotRuntimeAgent, RunHandler, StateManager, SuggestionEngine, ToolCallStatus, completePartialMarkdown, createActionGroup, createEffect, createReducer, createSelector, createStore, empty, ensureObjectArgs, isAbortError, isRunCompletionAware, ofType, on, parseToolArguments, props, select, ɵCOPILOTKIT_FEATURES, ɵMAX_SOCKET_RETRIES, createMemoryStore as ɵcreateMemoryStore, ɵcreateThreadSelectors, createThreadStore as ɵcreateThreadStore, ɵisCopilotKitFeature, isRetryableStatus as ɵisRetryableMemoryStatus, ɵjoinPhoenixChannel$, ɵmapMemoryMetadataEvent, ɵmemoryAdapterEvents, ɵmemoryDomainEvents, ɵmemoryReducer, ɵmemoryRestEvents, ɵobservePhoenixEvent$, ɵobservePhoenixJoinOutcome$, ɵobservePhoenixSocketHealth$, ɵobservePhoenixSocketSignals$, ɵphoenixChannel$, ɵphoenixSocket$, ɵselectFetchMoreError, ɵselectHasNextPage, ɵselectIsFetchingNextPage, ɵselectIsMutating, ɵselectMemories, ɵselectMemoriesAvailable, ɵselectMemoriesError, ɵselectMemoriesIsLoading, ɵselectMemoriesIsMutating, ɵselectMemoriesRealtimeStatus, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading, ɵthreadAdapterEvents };
+//#region src/interrupt-state.ts
+function toolResultContent(response) {
+	if (response.status === "cancelled") return JSON.stringify({ status: "cancelled" });
+	return JSON.stringify(response.payload ?? { status: "resolved" });
+}
+/**
+* @internal Framework-neutral interrupt response state shared by framework
+* adapters. Application authors must not depend on this API.
+*/
+var ɵInterruptState = class {
+	#responses = {};
+	#pending = null;
+	#sealed = false;
+	/** Return the active normalized interrupt without exposing mutable state. */
+	get pending() {
+		const pending = this.#pending;
+		if (pending?.kind === "standard") return {
+			kind: "standard",
+			interrupts: [...pending.interrupts]
+		};
+		return pending;
+	}
+	/** Replace the current interrupt with a legacy custom-event interrupt. */
+	setLegacy(event) {
+		this.#replace({
+			kind: "legacy",
+			event
+		});
+	}
+	/** Replace the current interrupt with an AG-UI standard interrupt set. */
+	setStandard(interrupts) {
+		this.#replace({
+			kind: "standard",
+			interrupts: [...interrupts]
+		});
+	}
+	/** Clear all pending interrupt data and accumulated responses. */
+	clear() {
+		this.#pending = null;
+		this.#sealed = false;
+		for (const id of Object.keys(this.#responses)) delete this.#responses[id];
+	}
+	/** Record a resolved response and return the next framework action. */
+	resolve(payload, interruptId) {
+		const pending = this.#pending;
+		if (!pending || this.#sealed) return { kind: "ignored" };
+		if (pending.kind === "legacy") {
+			this.#sealed = true;
+			return {
+				kind: "legacy-resume",
+				payload,
+				interruptValue: pending.event.value
+			};
+		}
+		return this.#respond(pending.interrupts, interruptId, {
+			status: "resolved",
+			payload
+		});
+	}
+	/** Record a cancelled response and return the next framework action. */
+	cancel(interruptId) {
+		const pending = this.#pending;
+		if (!pending || this.#sealed) return { kind: "ignored" };
+		if (pending.kind === "legacy") {
+			this.#sealed = true;
+			return { kind: "dismiss" };
+		}
+		return this.#respond(pending.interrupts, interruptId, { status: "cancelled" });
+	}
+	#replace(pending) {
+		this.clear();
+		this.#pending = pending;
+	}
+	#respond(interrupts, interruptId, response) {
+		const id = interruptId ?? interrupts[0]?.id;
+		if (!id || !interrupts.some((interrupt) => interrupt.id === id)) return { kind: "ignored" };
+		this.#responses[id] = response;
+		if (!interrupts.every((interrupt) => this.#responses[interrupt.id])) return { kind: "waiting" };
+		const expired = interrupts.find((interrupt) => isInterruptExpired(interrupt));
+		if (expired) {
+			this.#sealed = true;
+			return {
+				kind: "expired",
+				interrupt: expired
+			};
+		}
+		const mutableInterrupts = [...interrupts];
+		const resume = buildResumeArray(mutableInterrupts, this.#responses);
+		const toolResults = mutableInterrupts.flatMap((interrupt) => {
+			if (!interrupt.toolCallId) return [];
+			return [{
+				toolCallId: interrupt.toolCallId,
+				content: toolResultContent(this.#responses[interrupt.id])
+			}];
+		});
+		this.#sealed = true;
+		return {
+			kind: "resume",
+			resume,
+			toolResults
+		};
+	}
+};
+
+//#endregion
+export { AgentRegistry, AgentThreadLockedError, ContextStore, CopilotKitCore, CopilotKitCoreErrorCode, CopilotKitCoreRuntimeConnectionStatus, IntelligenceAgent, MEMORY_ERROR_REGISTRY, MemoryError, ProxiedCopilotRuntimeAgent, RunHandler, StateManager, SuggestionEngine, ToolCallStatus, completePartialMarkdown, createActionGroup, createEffect, createReducer, createSelector, createStore, empty, ensureObjectArgs, isAbortError, isRunCompletionAware, ofType, on, parseToolArguments, props, select, ɵCOPILOTKIT_FEATURES, ɵInterruptState, ɵMAX_SOCKET_RETRIES, createMemoryStore as ɵcreateMemoryStore, ɵcreateThreadSelectors, createThreadStore as ɵcreateThreadStore, ɵisCopilotKitFeature, isRetryableStatus as ɵisRetryableMemoryStatus, ɵjoinPhoenixChannel$, ɵmapMemoryMetadataEvent, ɵmemoryAdapterEvents, ɵmemoryDomainEvents, ɵmemoryReducer, ɵmemoryRestEvents, ɵobservePhoenixEvent$, ɵobservePhoenixJoinOutcome$, ɵobservePhoenixSocketHealth$, ɵobservePhoenixSocketSignals$, ɵphoenixChannel$, ɵphoenixSocket$, ɵselectFetchMoreError, ɵselectHasNextPage, ɵselectIsFetchingNextPage, ɵselectIsMutating, ɵselectMemories, ɵselectMemoriesAvailable, ɵselectMemoriesError, ɵselectMemoriesIsLoading, ɵselectMemoriesIsMutating, ɵselectMemoriesRealtimeStatus, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading, ɵthreadAdapterEvents };
 //# sourceMappingURL=index.mjs.map