@copilotkit/web-inspector 1.61.0 → 1.61.2

package/dist/index.umd.js

@@ -189,17 +189,45 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		});
 	}
 
+//#endregion
+//#region package.json
+	var version = "1.61.2";
+
 //#endregion
 //#region src/lib/telemetry.ts
 	const TELEMETRY_EVENTS = {
 		bannerViewed: "oss.inspector.banner_viewed",
 		bannerClicked: "oss.inspector.banner_clicked",
-		threadsTabClicked: "oss.inspector.threads_tab_clicked"
+		threadsTabClicked: "oss.inspector.threads_tab_clicked",
+		threadsLockedViewed: "oss.inspector.threads_locked_viewed",
+		threadsIntelligenceSignupClicked: "oss.inspector.threads_intelligence_signup_clicked",
+		threadsTalkToEngineerClicked: "oss.inspector.threads_talk_to_engineer_clicked",
+		talkToEngineerClicked: "oss.inspector.talk_to_engineer_clicked",
+		threadsEmptyEnabledViewed: "oss.inspector.threads_empty_enabled_viewed",
+		threadsEnabledViewed: "oss.inspector.threads_enabled_viewed"
 	};
 	const TELEMETRY_INGEST_URL = "https://telemetry.copilotkit.ai/ingest";
 	const TELEMETRY_DOCS_URL = "https://docs.copilotkit.ai/telemetry";
 	const PACKAGE_NAME = "@copilotkit/web-inspector";
+	const PACKAGE_VERSION = version;
 	const FETCH_TIMEOUT_MS = 3e3;
+	function isThreadsTelemetryEvent(event) {
+		return event === TELEMETRY_EVENTS.threadsTabClicked || event === TELEMETRY_EVENTS.threadsLockedViewed || event === TELEMETRY_EVENTS.threadsIntelligenceSignupClicked || event === TELEMETRY_EVENTS.threadsTalkToEngineerClicked || event === TELEMETRY_EVENTS.talkToEngineerClicked || event === TELEMETRY_EVENTS.threadsEmptyEnabledViewed || event === TELEMETRY_EVENTS.threadsEnabledViewed;
+	}
+	function getRuntimeUrlType(runtimeUrl) {
+		if (!runtimeUrl) return "missing";
+		if (runtimeUrl.startsWith("/") && !runtimeUrl.startsWith("//")) return "relative";
+		try {
+			const baseHref = typeof window !== "undefined" ? window.location.href : "https://copilotkit.ai";
+			const url = new URL(runtimeUrl, baseHref);
+			const baseUrl = new URL(baseHref);
+			const hostname = url.hostname.toLowerCase();
+			if (hostname === "localhost" || hostname === "127.0.0.1" || hostname === "[::1]") return "localhost";
+			return url.origin === baseUrl.origin ? "same_origin" : "remote";
+		} catch (_unused) {
+			return "invalid";
+		}
+	}
 	/**
 	* Fire-and-forget telemetry send. Returns synchronously; the network
 	* call is dispatched in the background and any failure is swallowed.
@@ -209,16 +237,32 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 	* inspector's mount lifecycle instead.
 	*/
 	function track(event, properties = {}) {
+		if (isTelemetryOptedOut()) return;
 		const distinctId = getOrCreateTelemetryDistinctId();
-		postBestEffort(TELEMETRY_INGEST_URL, JSON.stringify({
-			event,
-			properties: {
-				...properties,
-				distinct_id: distinctId
-			},
-			package: { name: PACKAGE_NAME },
-			ts: Math.floor(Date.now() / 1e3)
-		}), distinctId);
+		const threadsProperties = isThreadsTelemetryEvent(event) ? {
+			package_name: PACKAGE_NAME,
+			package_version: PACKAGE_VERSION,
+			inspector_distinct_id: distinctId
+		} : {};
+		let body;
+		try {
+			body = JSON.stringify({
+				event,
+				properties: {
+					...properties,
+					...threadsProperties,
+					distinct_id: distinctId
+				},
+				package: {
+					name: PACKAGE_NAME,
+					...isThreadsTelemetryEvent(event) ? { version: PACKAGE_VERSION } : {}
+				},
+				ts: Math.floor(Date.now() / 1e3)
+			});
+		} catch (_unused2) {
+			return;
+		}
+		postBestEffort(TELEMETRY_INGEST_URL, body, distinctId);
 	}
 	function trackBannerViewed(props) {
 		track(TELEMETRY_EVENTS.bannerViewed, props);
@@ -226,8 +270,26 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 	function trackBannerClicked(props) {
 		track(TELEMETRY_EVENTS.bannerClicked, props);
 	}
-	function trackThreadsTabClicked() {
-		track(TELEMETRY_EVENTS.threadsTabClicked);
+	function trackThreadsTabClicked(props = {}) {
+		track(TELEMETRY_EVENTS.threadsTabClicked, props);
+	}
+	function trackThreadsLockedViewed(props) {
+		track(TELEMETRY_EVENTS.threadsLockedViewed, props);
+	}
+	function trackThreadsIntelligenceSignupClicked(props) {
+		track(TELEMETRY_EVENTS.threadsIntelligenceSignupClicked, props);
+	}
+	function trackThreadsTalkToEngineerClicked(props) {
+		track(TELEMETRY_EVENTS.threadsTalkToEngineerClicked, props);
+	}
+	function trackTalkToEngineerClicked(props) {
+		track(TELEMETRY_EVENTS.talkToEngineerClicked, props);
+	}
+	function trackThreadsEmptyEnabledViewed(props) {
+		track(TELEMETRY_EVENTS.threadsEmptyEnabledViewed, props);
+	}
+	function trackThreadsEnabledViewed(props) {
+		track(TELEMETRY_EVENTS.threadsEnabledViewed, props);
 	}
 	/**
 	* Returns the inspector's anonymous distinct-ID for cross-domain
@@ -286,7 +348,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				body,
 				signal: controller.signal
 			});
-		} catch (_unused) {} finally {
+		} catch (_unused3) {} finally {
 			clearTimeout(timeoutId);
 		}
 	}
@@ -313,6 +375,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 	const DOCKED_LEFT_WIDTH = 500;
 	const MAX_AGENT_EVENTS = 200;
 	const MAX_TOTAL_EVENTS = 500;
+	const INTELLIGENCE_SIGNUP_URL = "https://go.copilotkit.ai/intelligence-signup";
+	const TALK_TO_ENGINEER_URL = "https://www.copilotkit.ai/talk-to-an-engineer";
 	const AGENT_EVENT_TYPES = [
 		"RUN_STARTED",
 		"RUN_FINISHED",
@@ -388,14 +452,14 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			bg: "rgba(190,194,255,0.102)",
 			fg: "#5558B2"
 		};
+		if (type === "RUN_ERROR" || type === "ERROR") return {
+			bg: "rgba(250,95,103,0.13)",
+			fg: "#c0333a"
+		};
 		if (type.startsWith("RUN_") || type.startsWith("STEP_")) return {
 			bg: "rgba(255,172,77,0.2)",
 			fg: "#996300"
 		};
-		if (type === "ERROR") return {
-			bg: "rgba(250,95,103,0.13)",
-			fg: "#c0333a"
-		};
 		return {
 			bg: "#F7F7F9",
 			fg: "#838389"
@@ -687,6 +751,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			this.thread = null;
 			this.runtimeUrl = "";
 			this.headers = {};
+			this.threadInspectionAvailable = false;
 			this.agentStateInput = null;
 			this.agentEventsInput = [];
 			this.liveMessageVersion = 0;
@@ -809,7 +874,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		* so users see an explicit loading indicator on first load.
 		*/
 		async fetchMessages(threadId, silent = false) {
-			if (!this.runtimeUrl) {
+			if (!this.runtimeUrl || !this.threadInspectionAvailable) {
 				if (!silent) this._conversation = [];
 				return;
 			}
@@ -820,7 +885,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				this._messagesError = null;
 			}
 			try {
-				const res = await fetch(`${this.runtimeUrl}/threads/${encodeURIComponent(threadId)}/messages`, {
+				const res = await fetch(this.getThreadInspectionUrl(threadId, "messages"), {
 					headers: { ...this.headers },
 					signal: controller.signal
 				});
@@ -841,7 +906,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		}
 		async fetchEvents(threadId) {
 			this._eventsNotAvailable = false;
-			if (!this.runtimeUrl) {
+			if (!this.runtimeUrl || !this.threadInspectionAvailable) {
 				this._fetchedEvents = null;
 				return;
 			}
@@ -850,7 +915,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			this._loadingEvents = true;
 			this._eventsError = null;
 			try {
-				const res = await fetch(`${this.runtimeUrl}/threads/${encodeURIComponent(threadId)}/events`, {
+				const res = await fetch(this.getThreadInspectionUrl(threadId, "events"), {
 					headers: { ...this.headers },
 					signal: controller.signal
 				});
@@ -875,7 +940,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		}
 		async fetchState(threadId) {
 			this._stateNotAvailable = false;
-			if (!this.runtimeUrl) {
+			if (!this.runtimeUrl || !this.threadInspectionAvailable) {
 				this._fetchedState = null;
 				return;
 			}
@@ -885,7 +950,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			this._stateError = null;
 			try {
 				var _data$state;
-				const res = await fetch(`${this.runtimeUrl}/threads/${encodeURIComponent(threadId)}/state`, {
+				const res = await fetch(this.getThreadInspectionUrl(threadId, "state"), {
 					headers: { ...this.headers },
 					signal: controller.signal
 				});
@@ -908,6 +973,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				if (!controller.signal.aborted && this.threadId === threadId) this._loadingState = false;
 			}
 		}
+		getThreadInspectionUrl(threadId, resource) {
+			return `${this.runtimeUrl.replace(/\/+$/, "")}/threads/${encodeURIComponent(threadId)}/${resource}`;
+		}
 		mapMessages(messages) {
 			const items = [];
 			const toolCallMap = /* @__PURE__ */ new Map();
@@ -1503,6 +1571,7 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(event.payload))}
 		thread: { attribute: false },
 		runtimeUrl: { attribute: false },
 		headers: { attribute: false },
+		threadInspectionAvailable: { attribute: false },
 		agentStateInput: { attribute: false },
 		agentEventsInput: { attribute: false },
 		liveMessageVersion: { attribute: false },
@@ -2165,6 +2234,7 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(event.payload))}
 			this.viewedBannerTimestamps = /* @__PURE__ */ new Set();
 			this.pendingBannerViewed = null;
 			this.clickedBannerIds = /* @__PURE__ */ new Set();
+			this.viewedThreadsTelemetryStates = /* @__PURE__ */ new Set();
 			this.contextState = {
 				button: {
 					position: {
@@ -2374,6 +2444,30 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(event.payload))}
 			this.expandedTools = /* @__PURE__ */ new Set();
 			this.expandedContextItems = /* @__PURE__ */ new Set();
 			this.copiedContextItems = /* @__PURE__ */ new Set();
+			this.handleTalkToEngineerClick = () => {
+				var _this$core;
+				if ((_this$core = this.core) === null || _this$core === void 0 ? void 0 : _this$core.telemetryDisabled) return;
+				trackTalkToEngineerClicked(this.getThreadsTelemetryProps({
+					cta: "talk_to_engineer",
+					cta_surface: "threads_header"
+				}, { includeUrlAttribution: true }));
+			};
+			this.handleThreadsIntelligenceSignupClick = () => {
+				var _this$core2;
+				if ((_this$core2 = this.core) === null || _this$core2 === void 0 ? void 0 : _this$core2.telemetryDisabled) return;
+				trackThreadsIntelligenceSignupClicked(this.getThreadsTelemetryProps({
+					cta: "signup",
+					cta_surface: "threads_locked"
+				}, { includeUrlAttribution: true }));
+			};
+			this.handleThreadsTalkToEngineerClick = () => {
+				var _this$core3;
+				if ((_this$core3 = this.core) === null || _this$core3 === void 0 ? void 0 : _this$core3.telemetryDisabled) return;
+				trackThreadsTalkToEngineerClicked(this.getThreadsTelemetryProps({
+					cta: "talk_to_engineer",
+					cta_surface: "threads_locked"
+				}, { includeUrlAttribution: true }));
+			};
 			this.handleThreadDividerPointerDown = (event) => {
 				this.threadDividerResizing = true;
 				this.threadDividerPointerId = event.pointerId;
@@ -2496,7 +2590,38 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(event.payload))}
 				}
 			];
 		}
+		getThreadServiceStatus() {
+			var _this$_core$threadEnd;
+			if (!this._core) return "unknown";
+			if (!this._core.threadEndpoints) return "unknown";
+			return ((_this$_core$threadEnd = this._core.threadEndpoints) === null || _this$_core$threadEnd === void 0 ? void 0 : _this$_core$threadEnd.list) === false ? "unavailable" : "available";
+		}
+		areThreadEndpointsAvailable() {
+			return this.getThreadServiceStatus() !== "unavailable";
+		}
+		getThreadsTelemetryProps(extra = {}, options = {}) {
+			var _this$core4, _this$core$licenseSta, _this$core5, _this$core$runtimeMod, _this$core6, _this$core7, _this$core$telemetryD, _this$core8;
+			const distinctId = options.includeUrlAttribution && !((_this$core4 = this.core) === null || _this$core4 === void 0 ? void 0 : _this$core4.telemetryDisabled) ? getTelemetryDistinctIdForUrl() : null;
+			const threadServiceStatus = this.getThreadServiceStatus();
+			return {
+				posthog_distinct_id: distinctId !== null && distinctId !== void 0 ? distinctId : void 0,
+				intelligence_status: threadServiceStatus === "available" ? "intelligence_enabled" : threadServiceStatus === "unavailable" ? "intelligence_not_enabled" : "unknown",
+				thread_service_status: threadServiceStatus,
+				license_status: (_this$core$licenseSta = (_this$core5 = this.core) === null || _this$core5 === void 0 ? void 0 : _this$core5.licenseStatus) !== null && _this$core$licenseSta !== void 0 ? _this$core$licenseSta : void 0,
+				runtime_mode: (_this$core$runtimeMod = (_this$core6 = this.core) === null || _this$core6 === void 0 ? void 0 : _this$core6.runtimeMode) !== null && _this$core$runtimeMod !== void 0 ? _this$core$runtimeMod : void 0,
+				runtime_url_type: getRuntimeUrlType((_this$core7 = this.core) === null || _this$core7 === void 0 ? void 0 : _this$core7.runtimeUrl),
+				telemetry_disabled: (_this$core$telemetryD = (_this$core8 = this.core) === null || _this$core8 === void 0 ? void 0 : _this$core8.telemetryDisabled) !== null && _this$core$telemetryD !== void 0 ? _this$core$telemetryD : false,
+				...extra
+			};
+		}
+		getIntelligenceSignupUrl() {
+			return this.appendRefParam(INTELLIGENCE_SIGNUP_URL, "cpk-inspector");
+		}
+		getTalkToEngineerUrl() {
+			return this.appendRefParam(TALK_TO_ENGINEER_URL, "cpk-inspector-threads");
+		}
 		subscribeToThreadStore(agentId, store) {
+			if (!this.areThreadEndpointsAvailable()) return;
 			if (this._threadStoreSubscriptions.has(agentId)) return;
 			const threadsSub = store.select(_copilotkit_core.ɵselectThreads).subscribe((threads) => {
 				this._threadsByAgent.set(agentId, threads);
@@ -2533,16 +2658,18 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(event.payload))}
 			this._threads = [];
 		}
 		ensureOwnedThreadStore(agentId) {
-			var _this$core;
+			var _this$core9, _core$intelligence;
 			if (this._ownedThreadStores.has(agentId)) return;
-			if ((_this$core = this.core) === null || _this$core === void 0 ? void 0 : _this$core.getThreadStore(agentId)) return;
+			if ((_this$core9 = this.core) === null || _this$core9 === void 0 ? void 0 : _this$core9.getThreadStore(agentId)) return;
 			const core = this.core;
 			if (!(core === null || core === void 0 ? void 0 : core.runtimeUrl)) return;
+			if (!this.areThreadEndpointsAvailable()) return;
 			const store = (0, _copilotkit_core.ɵcreateThreadStore)({ fetch: globalThis.fetch });
 			store.start();
 			store.setContext({
 				runtimeUrl: core.runtimeUrl,
-				headers: {},
+				headers: { ...core.headers },
+				wsUrl: (_core$intelligence = core.intelligence) === null || _core$intelligence === void 0 ? void 0 : _core$intelligence.wsUrl,
 				agentId
 			});
 			this._ownedThreadStores.set(agentId, store);
@@ -2554,19 +2681,32 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(event.payload))}
 			if (!store) return;
 			store.refresh();
 		}
+		updateOwnedThreadStoreHeaders(headers) {
+			const core = this.core;
+			if (!(core === null || core === void 0 ? void 0 : core.runtimeUrl)) return;
+			for (const [agentId, store] of this._ownedThreadStores) {
+				var _core$intelligence2;
+				store.setContext({
+					runtimeUrl: core.runtimeUrl,
+					headers: { ...headers },
+					wsUrl: (_core$intelligence2 = core.intelligence) === null || _core$intelligence2 === void 0 ? void 0 : _core$intelligence2.wsUrl,
+					agentId
+				});
+			}
+		}
 		removeOwnedThreadStore(agentId) {
-			var _this$core2;
+			var _this$core10;
 			const store = this._ownedThreadStores.get(agentId);
 			if (!store) return;
 			store.stop();
-			(_this$core2 = this.core) === null || _this$core2 === void 0 || _this$core2.unregisterThreadStore(agentId);
+			(_this$core10 = this.core) === null || _this$core10 === void 0 || _this$core10.unregisterThreadStore(agentId);
 			this._ownedThreadStores.delete(agentId);
 		}
 		teardownOwnedThreadStores() {
 			for (const [agentId, store] of this._ownedThreadStores) {
-				var _this$core3;
+				var _this$core11;
 				store.stop();
-				(_this$core3 = this.core) === null || _this$core3 === void 0 || _this$core3.unregisterThreadStore(agentId);
+				(_this$core11 = this.core) === null || _this$core11 === void 0 || _this$core11.unregisterThreadStore(agentId);
 			}
 			this._ownedThreadStores.clear();
 		}
@@ -2583,7 +2723,8 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(event.payload))}
 							maybeShowDisclosure();
 						}
 						this.flushPendingBannerViewed();
-						for (const agentId of this._ownedThreadStores.keys()) this.refreshOwnedThreadStore(agentId);
+						if (this.areThreadEndpointsAvailable()) for (const agentId of this._ownedThreadStores.keys()) this.refreshOwnedThreadStore(agentId);
+						else this.teardownOwnedThreadStores();
 					} else {
 						this._threadsByAgent.clear();
 						this._threads = [];
@@ -2594,6 +2735,9 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(event.payload))}
 					this.coreProperties = properties;
 					this.requestUpdate();
 				},
+				onHeadersChanged: ({ headers }) => {
+					this.updateOwnedThreadStoreHeaders(headers);
+				},
 				onError: ({ code, error }) => {
 					this.lastCoreError = {
 						code,
@@ -2626,6 +2770,13 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(event.payload))}
 			};
 			this.coreUnsubscribe = core.subscribe(this.coreSubscriber).unsubscribe;
 			this.processAgentsChanged(core.agents);
+			if (core.runtimeConnectionStatus === "connected") {
+				if (!core.telemetryDisabled) {
+					ensureTelemetryDistinctId();
+					maybeShowDisclosure();
+				}
+				this.flushPendingBannerViewed();
+			}
 			const threadStores = typeof core.getThreadStores === "function" ? core.getThreadStores() : {};
 			for (const [agentId, store] of Object.entries(threadStores)) this.subscribeToThreadStore(agentId, store);
 			if (core.context) this.contextStore = this.normalizeContextStore(core.context);
@@ -2715,10 +2866,10 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(event.payload))}
 				onRunStartedEvent: ({ event }) => {
 					this.recordAgentEvent(agentId, "RUN_STARTED", event);
 				},
-				onRunFinishedEvent: ({ event, result }) => {
+				onRunFinishedEvent: (params) => {
 					this.recordAgentEvent(agentId, "RUN_FINISHED", {
-						event,
-						result
+						event: params.event,
+						result: "result" in params ? params.result : void 0
 					});
 					this.refreshOwnedThreadStore(agentId);
 				},
@@ -3055,13 +3206,13 @@ ${argsString}</pre
 		}
 		getEventBadgeClasses(type) {
 			const base = "font-mono text-[10px] font-medium inline-flex items-center rounded-sm px-1.5 py-0.5 border";
+			if (type === "RUN_ERROR") return `${base} bg-rose-50 text-rose-700 border-rose-200`;
 			if (type.startsWith("RUN_")) return `${base} bg-blue-50 text-blue-700 border-blue-200`;
 			if (type.startsWith("TEXT_MESSAGE")) return `${base} bg-emerald-50 text-emerald-700 border-emerald-200`;
 			if (type.startsWith("TOOL_CALL")) return `${base} bg-amber-50 text-amber-700 border-amber-200`;
 			if (type.startsWith("REASONING")) return `${base} bg-fuchsia-50 text-fuchsia-700 border-fuchsia-200`;
 			if (type.startsWith("STATE")) return `${base} bg-violet-50 text-violet-700 border-violet-200`;
 			if (type.startsWith("MESSAGES")) return `${base} bg-sky-50 text-sky-700 border-sky-200`;
-			if (type === "RUN_ERROR") return `${base} bg-rose-50 text-rose-700 border-rose-200`;
 			return `${base} bg-gray-100 text-gray-600 border-gray-200`;
 		}
 		stringifyPayload(payload, pretty) {
@@ -3851,8 +4002,8 @@ ${argsString}</pre
 			return lit.nothing;
 		}
 		renderSettingsPanel() {
-			var _this$core$telemetryD, _this$core4;
-			const optedOut = (_this$core$telemetryD = (_this$core4 = this.core) === null || _this$core4 === void 0 ? void 0 : _this$core4.telemetryDisabled) !== null && _this$core$telemetryD !== void 0 ? _this$core$telemetryD : false;
+			var _this$core$telemetryD2, _this$core12;
+			const optedOut = (_this$core$telemetryD2 = (_this$core12 = this.core) === null || _this$core12 === void 0 ? void 0 : _this$core12.telemetryDisabled) !== null && _this$core$telemetryD2 !== void 0 ? _this$core$telemetryD2 : false;
 			return lit.html`
       <div class="flex h-full flex-col overflow-hidden">
         <div class="overflow-auto p-4">
@@ -3882,8 +4033,8 @@ ${argsString}</pre
     `;
 		}
 		trackBannerClickedOnce(opts) {
-			var _this$core5, _this$announcementCta;
-			if ((_this$core5 = this.core) === null || _this$core5 === void 0 ? void 0 : _this$core5.telemetryDisabled) return;
+			var _this$core13, _this$announcementCta;
+			if ((_this$core13 = this.core) === null || _this$core13 === void 0 ? void 0 : _this$core13.telemetryDisabled) return;
 			const id = this.announcementTimestamp;
 			if (!id) return;
 			const key = `${id}:${opts.cta}`;
@@ -3895,8 +4046,314 @@ ${argsString}</pre
 				cta_label: (_this$announcementCta = this.announcementCtaLabel) !== null && _this$announcementCta !== void 0 ? _this$announcementCta : void 0
 			});
 		}
+		trackThreadsViewStateOnce(state, threadCount) {
+			var _this$core14;
+			if ((_this$core14 = this.core) === null || _this$core14 === void 0 ? void 0 : _this$core14.telemetryDisabled) return;
+			const key = `${state}:${this.getThreadServiceStatus()}`;
+			if (this.viewedThreadsTelemetryStates.has(key)) return;
+			this.viewedThreadsTelemetryStates.add(key);
+			const props = this.getThreadsTelemetryProps({ thread_count: threadCount });
+			if (state === "locked") trackThreadsLockedViewed(props);
+			else if (state === "empty_enabled") trackThreadsEmptyEnabledViewed(props);
+			else trackThreadsEnabledViewed(props);
+		}
+		renderThreadsLockedBackgroundMockup() {
+			return lit.html`
+      <div
+        aria-hidden="true"
+        style="
+          position: absolute;
+          inset: 0;
+          display: grid;
+          grid-template-columns: minmax(180px, 28%) 1fr;
+          overflow: hidden;
+          opacity: 0.58;
+          pointer-events: none;
+        "
+      >
+        <div
+          style="
+            display: flex;
+            flex-direction: column;
+            gap: 12px;
+            padding: 28px 24px;
+            border-right: 1px solid #dbdbe5;
+            background: #fafafa;
+          "
+        >
+          ${[
+				{
+					width: 74,
+					accent: true
+				},
+				{ width: 92 },
+				{ width: 68 },
+				{ width: 84 },
+				{ width: 58 },
+				{ width: 76 }
+			].map((row) => lit.html`
+              <div
+                style="
+                  padding: 12px;
+                  border-radius: 8px;
+                  background: ${row.accent ? "#eee6fe" : "#ffffff"};
+                  box-shadow: inset 0 0 0 1px #eeeef4;
+                "
+              >
+                <div
+                  style="
+                    height: 8px;
+                    width: ${row.width}%;
+                    border-radius: 99px;
+                    background: ${row.accent ? "#a984f5" : "#d7d7df"};
+                  "
+                ></div>
+                <div
+                  style="
+                    height: 6px;
+                    width: 88%;
+                    margin-top: 10px;
+                    border-radius: 99px;
+                    background: #e3e3eb;
+                  "
+                ></div>
+                <div
+                  style="
+                    height: 6px;
+                    width: 62%;
+                    margin-top: 7px;
+                    border-radius: 99px;
+                    background: #e8e8ef;
+                  "
+                ></div>
+              </div>
+            `)}
+        </div>
+        <div
+          style="
+            min-width: 0;
+            padding: 42px 48px;
+            background: #ffffff;
+          "
+        >
+          <div
+            style="
+              height: 10px;
+              width: 180px;
+              border-radius: 99px;
+              background: #d7d7df;
+            "
+          ></div>
+          <div
+            style="
+              height: 8px;
+              width: min(520px, 58%);
+              margin-top: 28px;
+              border-radius: 99px;
+              background: #e3e3eb;
+            "
+          ></div>
+          <div
+            style="
+              height: 8px;
+              width: min(430px, 48%);
+              margin-top: 12px;
+              border-radius: 99px;
+              background: #e8e8ef;
+            "
+          ></div>
+          <div
+            style="
+              display: grid;
+              grid-template-columns: repeat(2, minmax(0, 1fr));
+              gap: 16px;
+              max-width: 620px;
+              margin-top: 30px;
+            "
+          >
+            <div
+              style="
+                height: 116px;
+                border-radius: 8px;
+                background: #f5f5f8;
+                box-shadow: inset 0 0 0 1px #eeeef4;
+              "
+            ></div>
+            <div
+              style="
+                height: 116px;
+                border-radius: 8px;
+                background: #f5f5f8;
+                box-shadow: inset 0 0 0 1px #eeeef4;
+              "
+            ></div>
+          </div>
+          <div
+            style="
+              height: 10px;
+              width: min(680px, 74%);
+              margin-top: 34px;
+              border-radius: 99px;
+              background: #e3e3eb;
+            "
+          ></div>
+          <div
+            style="
+              height: 10px;
+              width: min(560px, 60%);
+              margin-top: 14px;
+              border-radius: 99px;
+              background: #e8e8ef;
+            "
+          ></div>
+        </div>
+      </div>
+    `;
+		}
+		renderThreadsLockedView() {
+			this.trackThreadsViewStateOnce("locked", 0);
+			return lit.html`
+      <div
+        style="
+          position: relative;
+          height: 100%;
+          display: flex;
+          align-items: center;
+          justify-content: center;
+          padding: 32px;
+          overflow: hidden;
+          background: #ffffff;
+        "
+      >
+        ${this.renderThreadsLockedBackgroundMockup()}
+        <div
+          aria-hidden="true"
+          style="
+            position: absolute;
+            inset: 0;
+            pointer-events: none;
+            background:
+              radial-gradient(circle at center, rgba(255,255,255,0.9) 0, rgba(255,255,255,0.78) 24%, rgba(255,255,255,0.34) 48%, rgba(255,255,255,0.56) 100%);
+          "
+        ></div>
+        <div
+          style="
+            position: relative;
+            z-index: 1;
+            max-width: 440px;
+            text-align: center;
+            color: #57575b;
+          "
+        >
+          <div
+            aria-hidden="true"
+            style="
+              margin: 0 auto 18px;
+              display: flex;
+              justify-content: center;
+            "
+          >
+            <div
+              style="
+                display: flex;
+                height: 44px;
+                width: 44px;
+                align-items: center;
+                justify-content: center;
+                border: 1px solid #dfd6fb;
+                border-radius: 8px;
+                background: #eee6fe;
+                color: #57575b;
+                box-shadow: 0 8px 18px rgba(87, 87, 91, 0.14);
+              "
+            >
+              ${this.renderIcon("Lock")}
+            </div>
+          </div>
+          <h2
+            style="
+              margin: 0 0 8px;
+              font-size: 16px;
+              line-height: 1.35;
+              font-weight: 600;
+              color: #010507;
+            "
+          >
+            Enable Intelligence to inspect Threads.
+          </h2>
+          <p
+            style="
+              margin: 0 auto 18px;
+              max-width: 380px;
+              font-size: 13px;
+              line-height: 1.55;
+              color: #57575b;
+            "
+          >
+            Persist conversations and inspect saved thread history from the
+            Inspector.
+          </p>
+          <div
+            style="
+              display: flex;
+              flex-wrap: wrap;
+              justify-content: center;
+              gap: 8px;
+            "
+          >
+            <a
+              href=${this.getTalkToEngineerUrl()}
+              target="_blank"
+              rel="noopener"
+              style="
+                display: inline-flex;
+                min-height: 34px;
+                align-items: center;
+                justify-content: center;
+                gap: 6px;
+                border-radius: 6px;
+                background: #010507;
+                padding: 8px 12px;
+                font-size: 12px;
+                font-weight: 600;
+                color: #ffffff;
+                text-decoration: none;
+              "
+              @click=${this.handleThreadsTalkToEngineerClick}
+            >
+              Talk to an Engineer
+            </a>
+            <a
+              href=${this.getIntelligenceSignupUrl()}
+              target="_blank"
+              rel="noopener"
+              style="
+                display: inline-flex;
+                min-height: 34px;
+                align-items: center;
+                justify-content: center;
+                gap: 6px;
+                border-radius: 6px;
+                border: 1px solid #dbdbe5;
+                background: #ffffff;
+                padding: 8px 12px;
+                font-size: 12px;
+                font-weight: 600;
+                color: #57575b;
+                text-decoration: none;
+              "
+              @click=${this.handleThreadsIntelligenceSignupClick}
+            >
+              Sign up for Intelligence
+            </a>
+          </div>
+        </div>
+      </div>
+    `;
+		}
 		renderThreadsView() {
-			var _this$_threadsByAgent, _displayThreads$find, _this$_core$runtimeUr, _this$_core2, _this$_core$headers, _this$_core3, _this$liveMessageVers2, _this$agentEvents$get6;
+			var _this$_threadsByAgent, _displayThreads$find, _this$_core$runtimeUr, _this$_core2, _this$_core$headers, _this$_core3, _this$_core4, _this$liveMessageVers2, _this$agentEvents$get6;
+			if (!this.areThreadEndpointsAvailable()) return this.renderThreadsLockedView();
 			const displayThreads = this.selectedContext === "all-agents" ? this._threads : (_this$_threadsByAgent = this._threadsByAgent.get(this.selectedContext)) !== null && _this$_threadsByAgent !== void 0 ? _this$_threadsByAgent : [];
 			let threadsErrorMessage = null;
 			if (this.selectedContext === "all-agents") {
@@ -3908,71 +4365,88 @@ ${argsString}</pre
 				threadsErrorMessage = (_this$_threadsErrorBy = (_this$_threadsErrorBy2 = this._threadsErrorByAgent.get(this.selectedContext)) === null || _this$_threadsErrorBy2 === void 0 ? void 0 : _this$_threadsErrorBy2.message) !== null && _this$_threadsErrorBy !== void 0 ? _this$_threadsErrorBy : null;
 			}
 			const selectedThread = this.selectedThreadId != null ? (_displayThreads$find = displayThreads.find((t) => t.id === this.selectedThreadId)) !== null && _displayThreads$find !== void 0 ? _displayThreads$find : null : null;
+			if (!threadsErrorMessage) this.trackThreadsViewStateOnce(displayThreads.length === 0 ? "empty_enabled" : "enabled", displayThreads.length);
 			return lit.html`
-      <div style="display:flex;height:100%;overflow:hidden;">
-        <!-- Left sidebar: thread list -->
+      <div style="display:flex;height:100%;overflow:hidden;flex-direction:column;">
         <div
-          style="width:${this.threadListWidth}px;flex-shrink:0;overflow:hidden;display:flex;flex-direction:column;border-right:1px solid #DBDBE5;"
+          style="display:flex;align-items:center;justify-content:flex-end;border-bottom:1px solid #DBDBE5;background:#ffffff;padding:8px 12px;flex-shrink:0;"
         >
-          <cpk-thread-list
-            style="height:100%;"
-            .threads=${displayThreads}
-            .selectedThreadId=${this.selectedThreadId}
-            .errorMessage=${threadsErrorMessage}
-            @threadSelected=${(e) => {
+          <a
+            href=${this.getTalkToEngineerUrl()}
+            target="_blank"
+            rel="noopener"
+            style="display:inline-flex;align-items:center;gap:6px;border-radius:6px;border:1px solid #dbdbe5;background:#ffffff;padding:7px 10px;font-size:12px;font-weight:600;color:#57575b;text-decoration:none;"
+            @click=${this.handleTalkToEngineerClick}
+          >
+            Talk to an Engineer
+          </a>
+        </div>
+        <div style="display:flex;min-height:0;flex:1;overflow:hidden;">
+          <!-- Left sidebar: thread list -->
+          <div
+            style="width:${this.threadListWidth}px;flex-shrink:0;overflow:hidden;display:flex;flex-direction:column;border-right:1px solid #DBDBE5;"
+          >
+            <cpk-thread-list
+              style="height:100%;"
+              .threads=${displayThreads}
+              .selectedThreadId=${this.selectedThreadId}
+              .errorMessage=${threadsErrorMessage}
+              @threadSelected=${(e) => {
 				this.selectedThreadId = e.detail;
 				this.requestUpdate();
 			}}
-          ></cpk-thread-list>
-        </div>
-
-        <!-- Resize divider -->
-        <div
-          style="width:4px;flex-shrink:0;cursor:col-resize;background:transparent;position:relative;z-index:1;"
-          @pointerdown=${this.handleThreadDividerPointerDown}
-          @pointermove=${this.handleThreadDividerPointerMove}
-          @pointerup=${this.handleThreadDividerPointerUp}
-          @pointercancel=${this.handleThreadDividerPointerUp}
-        ></div>
+            ></cpk-thread-list>
+          </div>
 
-        <!-- Center + right: thread details or empty state -->
-        <div style="flex:1;min-width:0;overflow:hidden;display:flex;">
-          ${this.selectedThreadId ? lit.html`<cpk-thread-details
-                  style="flex:1;min-width:0;"
-                  .threadId=${this.selectedThreadId}
-                  .thread=${selectedThread}
-                  .runtimeUrl=${(_this$_core$runtimeUr = (_this$_core2 = this._core) === null || _this$_core2 === void 0 ? void 0 : _this$_core2.runtimeUrl) !== null && _this$_core$runtimeUr !== void 0 ? _this$_core$runtimeUr : ""}
-                  .headers=${(_this$_core$headers = (_this$_core3 = this._core) === null || _this$_core3 === void 0 ? void 0 : _this$_core3.headers) !== null && _this$_core$headers !== void 0 ? _this$_core$headers : {}}
-                  .liveMessageVersion=${this.selectedThreadId ? (_this$liveMessageVers2 = this.liveMessageVersion.get(this.selectedThreadId)) !== null && _this$liveMessageVers2 !== void 0 ? _this$liveMessageVers2 : 0 : 0}
-                  .agentStateInput=${selectedThread ? this.getLatestStateForAgent(selectedThread.agentId) : null}
-                  .agentEventsInput=${selectedThread ? (_this$agentEvents$get6 = this.agentEvents.get(selectedThread.agentId)) !== null && _this$agentEvents$get6 !== void 0 ? _this$agentEvents$get6 : [] : []}
-                ></cpk-thread-details>` : lit.html`
-                  <div
-                    style="
-                      flex: 1;
-                      display: flex;
-                      flex-direction: column;
-                      align-items: center;
-                      justify-content: center;
-                      gap: 8px;
-                      color: #838389;
-                    "
-                  >
-                    <svg
-                      width="32"
-                      height="32"
-                      viewBox="0 0 24 24"
-                      fill="none"
-                      stroke="#c0c0c8"
-                      stroke-width="1.5"
-                      stroke-linecap="round"
-                      stroke-linejoin="round"
+          <!-- Resize divider -->
+          <div
+            style="width:4px;flex-shrink:0;cursor:col-resize;background:transparent;position:relative;z-index:1;"
+            @pointerdown=${this.handleThreadDividerPointerDown}
+            @pointermove=${this.handleThreadDividerPointerMove}
+            @pointerup=${this.handleThreadDividerPointerUp}
+            @pointercancel=${this.handleThreadDividerPointerUp}
+          ></div>
+
+          <!-- Center + right: thread details or empty state -->
+          <div style="flex:1;min-width:0;overflow:hidden;display:flex;">
+            ${selectedThread ? lit.html`<cpk-thread-details
+                    style="flex:1;min-width:0;"
+                    .threadId=${selectedThread.id}
+                    .thread=${selectedThread}
+                    .runtimeUrl=${(_this$_core$runtimeUr = (_this$_core2 = this._core) === null || _this$_core2 === void 0 ? void 0 : _this$_core2.runtimeUrl) !== null && _this$_core$runtimeUr !== void 0 ? _this$_core$runtimeUr : ""}
+                    .headers=${(_this$_core$headers = (_this$_core3 = this._core) === null || _this$_core3 === void 0 ? void 0 : _this$_core3.headers) !== null && _this$_core$headers !== void 0 ? _this$_core$headers : {}}
+                    .threadInspectionAvailable=${((_this$_core4 = this._core) === null || _this$_core4 === void 0 || (_this$_core4 = _this$_core4.threadEndpoints) === null || _this$_core4 === void 0 ? void 0 : _this$_core4.inspect) !== false}
+                    .liveMessageVersion=${(_this$liveMessageVers2 = this.liveMessageVersion.get(selectedThread.id)) !== null && _this$liveMessageVers2 !== void 0 ? _this$liveMessageVers2 : 0}
+                    .agentStateInput=${this.getLatestStateForAgent(selectedThread.agentId)}
+                    .agentEventsInput=${(_this$agentEvents$get6 = this.agentEvents.get(selectedThread.agentId)) !== null && _this$agentEvents$get6 !== void 0 ? _this$agentEvents$get6 : []}
+                  ></cpk-thread-details>` : lit.html`
+                    <div
+                      style="
+                        flex: 1;
+                        display: flex;
+                        flex-direction: column;
+                        align-items: center;
+                        justify-content: center;
+                        gap: 8px;
+                        color: #838389;
+                      "
                     >
-                      <path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z" />
-                    </svg>
-                    <span style="font-size: 13px">${displayThreads.length === 0 ? "No threads yet" : "Select a thread to inspect"}</span>
-                  </div>
-                `}
+                      <svg
+                        width="32"
+                        height="32"
+                        viewBox="0 0 24 24"
+                        fill="none"
+                        stroke="#c0c0c8"
+                        stroke-width="1.5"
+                        stroke-linecap="round"
+                        stroke-linejoin="round"
+                      >
+                        <path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z" />
+                      </svg>
+                      <span style="font-size: 13px">${displayThreads.length === 0 ? "No threads yet" : "Select a thread to inspect"}</span>
+                    </div>
+                  `}
+          </div>
         </div>
       </div>
     `;
@@ -4500,8 +4974,8 @@ ${prettyEvent}</pre
 				if (this.contextOptions.filter((opt) => opt.key !== "all-agents").length > 1) this.selectedContext = "all-agents";
 			}
 			if (key === "threads") {
-				var _this$core6;
-				if (this.selectedMenu !== "threads" && !((_this$core6 = this.core) === null || _this$core6 === void 0 ? void 0 : _this$core6.telemetryDisabled)) trackThreadsTabClicked();
+				var _this$core15;
+				if (previousMenu !== "threads" && !((_this$core15 = this.core) === null || _this$core15 === void 0 ? void 0 : _this$core15.telemetryDisabled)) trackThreadsTabClicked(this.getThreadsTelemetryProps());
 				this.autoSelectLatestThread();
 			}
 			if (key === "ag-ui-events" || key === "agents") requestAnimationFrame(() => {
@@ -4934,6 +5408,22 @@ ${prettyEvent}</pre
                           ${this.copiedContextItems.has(id) ? "Copied" : "Copy JSON"}
                         </button>
                       </div>
+                      <pre
+                        style="
+                          margin: 0;
+                          max-height: 180px;
+                          overflow: auto;
+                          white-space: pre-wrap;
+                          word-break: break-word;
+                          border-radius: 6px;
+                          border: 1px solid #eeeef4;
+                          background: #f7f7f9;
+                          padding: 10px;
+                          font-size: 11px;
+                          line-height: 1.5;
+                          color: #2d2d30;
+                        "
+                      >${this.formatContextValue(context.value)}</pre>
                     ` : lit.html`
                         <div class="flex items-center justify-center py-4 text-xs text-gray-500">
                           <span>No value available</span>
@@ -5053,8 +5543,8 @@ ${prettyEvent}</pre
     </div>`;
 		}
 		flushPendingBannerViewed() {
-			var _this$core7;
-			if (!this.pendingBannerViewed || ((_this$core7 = this.core) === null || _this$core7 === void 0 ? void 0 : _this$core7.telemetryDisabled)) {
+			var _this$core16;
+			if (!this.pendingBannerViewed || ((_this$core16 = this.core) === null || _this$core16 === void 0 ? void 0 : _this$core16.telemetryDisabled)) {
 				this.pendingBannerViewed = null;
 				return;
 			}
@@ -5126,8 +5616,9 @@ ${prettyEvent}</pre
 		async convertMarkdownToHtml(markdown) {
 			const renderer = new marked.marked.Renderer();
 			renderer.link = (href, title, text) => {
-				return `<a href="${this.escapeHtmlAttr(this.appendRefParam(href !== null && href !== void 0 ? href : ""))}" target="_blank" rel="noopener"${title ? ` title="${this.escapeHtmlAttr(title)}"` : ""}>${text}</a>`;
+				return `<a href="${this.escapeHtmlAttr(this.isSafeAnnouncementHref(href !== null && href !== void 0 ? href : "") ? this.appendRefParam(href !== null && href !== void 0 ? href : "") : "#")}" target="_blank" rel="noopener"${title ? ` title="${this.escapeHtmlAttr(title)}"` : ""}>${text}</a>`;
 			};
+			renderer.html = (html) => escapeHtml(html);
 			renderer.code = (code, lang) => {
 				const safeLang = (lang !== null && lang !== void 0 ? lang : "").replace(/[^a-z0-9-]/gi, "");
 				return `<div class="announcement-code"><pre><code${safeLang ? ` class="language-${safeLang}"` : ""}>${escapeHtml(code)}</code></pre><div class="announcement-code__copy-shield"><button type="button" class="announcement-code__copy" data-copy="${this.encodeBase64(code)}" aria-label="Copy code">Copy</button></div></div>`;
@@ -5137,6 +5628,14 @@ ${prettyEvent}</pre
 				async: false
 			});
 		}
+		isSafeAnnouncementHref(href) {
+			try {
+				const url = new URL(href, typeof window !== "undefined" ? window.location.href : "https://copilotkit.ai");
+				return url.protocol === "http:" || url.protocol === "https:" || url.protocol === "mailto:";
+			} catch (_unused7) {
+				return false;
+			}
+		}
 		encodeBase64(value) {
 			if (typeof window === "undefined" || typeof window.btoa !== "function") return "";
 			const bytes = new TextEncoder().encode(value);
@@ -5151,20 +5650,26 @@ ${prettyEvent}</pre
 			for (let i = 0; i < decoded.length; i++) bytes[i] = decoded.charCodeAt(i);
 			return new TextDecoder().decode(bytes);
 		}
-		appendRefParam(href) {
+		appendRefParam(href, ref = "cpk-inspector") {
 			try {
-				var _this$core8;
+				var _this$core17;
+				const isRootRelative = href.startsWith("/") && !href.startsWith("//");
 				const url = new URL(href, typeof window !== "undefined" ? window.location.href : "https://copilotkit.ai");
-				if (!url.searchParams.has("ref")) url.searchParams.append("ref", "cpk-inspector");
-				if (!url.searchParams.has("posthog_distinct_id") && !((_this$core8 = this.core) === null || _this$core8 === void 0 ? void 0 : _this$core8.telemetryDisabled)) {
+				if (!url.searchParams.has("ref")) url.searchParams.append("ref", ref);
+				if (!url.searchParams.has("posthog_distinct_id") && !((_this$core17 = this.core) === null || _this$core17 === void 0 ? void 0 : _this$core17.telemetryDisabled) && this.isCopilotKitDestination(url)) {
 					const distinctId = getTelemetryDistinctIdForUrl();
 					if (distinctId) url.searchParams.append("posthog_distinct_id", distinctId);
 				}
+				if (isRootRelative) return `${url.pathname}${url.search}${url.hash}`;
 				return url.toString();
-			} catch (_unused7) {
+			} catch (_unused8) {
 				return href;
 			}
 		}
+		isCopilotKitDestination(url) {
+			const hostname = url.hostname.toLowerCase();
+			return hostname === "copilotkit.ai" || hostname.endsWith(".copilotkit.ai");
+		}
 		escapeHtmlAttr(value) {
 			return escapeHtml(value).replace(/"/g, "&quot;").replace(/'/g, "&#39;");
 		}
@@ -5176,7 +5681,7 @@ ${prettyEvent}</pre
 				const parsed = JSON.parse(raw);
 				if (parsed && typeof parsed.timestamp === "string") return parsed.timestamp;
 				return null;
-			} catch (_unused8) {}
+			} catch (_unused9) {}
 			return null;
 		}
 		persistAnnouncementTimestamp(timestamp) {
@@ -5184,7 +5689,7 @@ ${prettyEvent}</pre
 			try {
 				const payload = JSON.stringify({ timestamp });
 				window.localStorage.setItem(ANNOUNCEMENT_STORAGE_KEY, payload);
-			} catch (_unused9) {}
+			} catch (_unused10) {}
 		}
 		markAnnouncementSeen() {
 			this.hasUnseenAnnouncement = false;