@copilotkit/web-inspector 1.71.0 → 1.71.1

package/dist/index.umd.js

@@ -2025,19 +2025,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 //#endregion
 //#region src/lib/home-briefing.ts
-/**
-	* A self-contained handoff for a coding agent. It answers the onboarding
-	* workflow's session and feedback consent gates up front, while keeping the
-	* feature guide—not a generic product-onboarding branch—in control of the
-	* implementation plan.
-	*/
-	function homeFeatureImplementationPrompt(service, context) {
-		return `Identify your coding-agent slug (for example, \`codex\` or \`claude-code\`). From the target project root, run \`npx copilotkit@latest onboard start --run ${context.onboardingRunId} --coding-agent <coding-agent-slug>\` and use its output as onboarding context. If it requires a CopilotKit CLI session check, you have permission to run it; never reveal credentials or send optional diagnostic feedback reports.
-
-This task is specifically to enable ${service.label}, not to re-onboard the application. First inspect the existing CopilotKit runtime, provider, agent, and UI wiring, and confirm that ${service.label} is not already enabled. Then read the ${service.label} guide (${service.docsUrl}) and make a short plan before editing. Preserve the project's framework, package manager, installed CopilotKit version, existing agent IDs, routes, provider layout, and working behavior. Do not create, select, or alter a CopilotKit Intelligence project—or add Intelligence configuration—unless this feature's official guide explicitly requires it or the user asks.
-
-Implement the smallest complete integration: wire every feature-required client and runtime configuration into the chat-to-agent path people already use, reuse local patterns, and do not invent environment values or hardcode secrets. Add or update focused tests and run the relevant project checks. Finish only after local validation proves ${service.label} works—not merely that the code compiles. Use a feature-specific runtime or Inspector capability check and, when the feature supports one, a representative UI interaction that proves the user-facing result. If the project overrides default rendering (for example, with a wildcard tool renderer), make that override compatible with this feature; a capability flag alone is not success. Summarize the changed files, validation, and any manual setup still required.`;
-	}
 	const SERVICE_DOCS_URL = {
 		threads: "https://docs.copilotkit.ai/threads",
 		memory: "https://docs.copilotkit.ai/intelligence/intelligence-platform",
@@ -2416,7 +2403,7 @@ Implement the smallest complete integration: wire every feature-required client
 
 //#endregion
 //#region package.json
-	var version = "1.71.0";
+	var version = "1.71.1";
 
 //#endregion
 //#region src/lib/telemetry.ts
@@ -2862,9 +2849,26 @@ Implement the smallest complete integration: wire every feature-required client
 	* Intelligence app (`apps/app-frontend/react-shell/src/home/intelligence-home.tsx`).
 	* The CLI resolves `onboard start` against a prompt graph, so the two surfaces
 	* must not drift — if the CLI's entry point changes, both change together.
+	*
+	* Two lines, and deliberately nothing else. It used to open by telling the
+	* agent to identify itself and pass the slug as a flag -- two sentences of
+	* instruction to a machine, in the one piece of text a human reads, decides on
+	* and pastes. The graph asks for the slug itself now, with `onboard identify`,
+	* which is the surface that talks to the agent for the rest of the run
+	* (Intelligence OSS-1157).
+	*
+	* This one stays generic, and so do the docs and Intelligence web-app copies
+	* of it (OSS-1150). Those three are entry points for a developer with no
+	* CopilotKit app yet, and every `--intent` route requires an existing app: it
+	* inspects for one first and reads `feature/stop` when it is missing. The
+	* feature buttons on Home are the surface that knows which feature the
+	* developer is looking at, so they are the surface that names an intent — see
+	* `FEATURE_ONBOARDING_PROMPT_TEMPLATE` below.
 	*/
 	const RUN_ID_PLACEHOLDER = "<run-id>";
-	const ONBOARDING_PROMPT_TEMPLATE = `Identify which coding-agent product you are, using a short slug such as \`codex\` or \`claude-code\`. From the root of the project where you want CopilotKit, run \`npx --yes copilotkit@latest onboard start --run ${RUN_ID_PLACEHOLDER} --coding-agent <coding-agent-slug>\`. Follow the Markdown instructions it prints until onboarding is complete.`;
+	const ONBOARDING_PROMPT_TEMPLATE = `Help me get started with CopilotKit. Run this command and follow the instructions:
+
+npx --yes copilotkit@latest onboard start --run ${RUN_ID_PLACEHOLDER}`;
 	/** Length and alphabet are the CLI's, so a run id copied here resolves there. */
 	const RUN_ID_LENGTH = 12;
 	/**
@@ -2891,6 +2895,53 @@ Implement the smallest complete integration: wire every feature-required client
 	function createOnboardingPrompt(runId) {
 		return ONBOARDING_PROMPT_TEMPLATE.replace(RUN_ID_PLACEHOLDER, runId);
 	}
+	/**
+	* Which feature outcome each Home tile asks the CLI for.
+	*
+	* The two vocabularies stay separate on purpose. A `HomeServiceId` names a
+	* tile and the pane behind it, so `websocket` and `audio` are the right words
+	* for it; an intent names the work to be done, so `add-realtime-sync` and
+	* `add-voice` are the right words for that. One table maps between them, and
+	* `Record<HomeServiceId, OnboardingIntent>` makes a new tile or a renamed
+	* slug a type error rather than a missing button.
+	*
+	* `memory` maps to `add-learning` because the tile is the Learning tile: it is
+	* enabled by a *configured Learning container* (see `learningOn` in
+	* `index.ts`), which is exactly what `feature/learning` sets up. The tile id
+	* and the `memories` menu key are older names for that same pane.
+	*/
+	const FEATURE_ONBOARDING_INTENT = {
+		threads: "add-rich-threads",
+		memory: "add-learning",
+		a2ui: "add-a2ui",
+		"open-gen-ui": "add-open-generative-ui",
+		suggestions: "add-chat-suggestions",
+		audio: "add-voice",
+		websocket: "add-realtime-sync"
+	};
+	const INTENT_PLACEHOLDER = "<intent>";
+	/**
+	* The prompt a Home feature button copies.
+	*
+	* It carries no feature-specific instruction, and it must not gain any. The
+	* `--intent` route owns the plan, the guide links, the per-phase check-ins,
+	* the refusal when a prerequisite is missing, and the proof step; prose copied
+	* here would duplicate all of that and then drift from it the next time the
+	* underlying API changes.
+	*
+	* What is left is the caller's own business: identify yourself, run this
+	* command, and the standing permission for the session check that the
+	* developer granted by copying the prompt.
+	*/
+	const FEATURE_ONBOARDING_PROMPT_TEMPLATE = `Help me set this up in my CopilotKit app. Run this command and follow the instructions:
+
+npx --yes copilotkit@latest onboard start --run ${RUN_ID_PLACEHOLDER} --intent ${INTENT_PLACEHOLDER}
+
+If it requires a CopilotKit CLI session check, you have permission to run it. Never reveal credentials or send optional diagnostic feedback reports.`;
+	/** Bind one run id and one tile's feature outcome into the copied prompt. */
+	function createFeatureOnboardingPrompt(serviceId, runId) {
+		return FEATURE_ONBOARDING_PROMPT_TEMPLATE.replace(RUN_ID_PLACEHOLDER, runId).replace(INTENT_PLACEHOLDER, FEATURE_ONBOARDING_INTENT[serviceId]);
+	}
 
 //#endregion
 //#region src/index.ts
@@ -3376,6 +3427,10 @@ Implement the smallest complete integration: wire every feature-required client
 		"ACTIVITY_SNAPSHOT",
 		"ACTIVITY_DELTA"
 	];
+	const THREADS_LOCKED_COPY = {
+		heading: "Production-grade chat threads without the complexity. Self hostable.",
+		description: "Chat threads that go beyond text with generative UI and multimodal inputs, built to replay missed events and stay in sync across tabs, sessions, and devices."
+	};
 	const EMPTY_INSPECTOR_MESSAGES = [];
 	function textFromUnknownContent(content) {
 		if (typeof content === "string") return content;
@@ -8170,7 +8225,7 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(parsed))}</pre
 				const clipboard = this.getClipboard(event);
 				if (!(clipboard === null || clipboard === void 0 ? void 0 : clipboard.writeText)) return false;
 				try {
-					await clipboard.writeText(homeFeatureImplementationPrompt(service, { onboardingRunId }));
+					await clipboard.writeText(createFeatureOnboardingPrompt(service.id, onboardingRunId));
 					return true;
 				} catch (_unused4) {
 					return false;
@@ -8178,7 +8233,7 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(parsed))}</pre
 			};
 			this.handleLearningSetupCopy = async (event, recopy = false) => {
 				var _this$core;
-				const service = this.getHomeFeaturePromptTarget("threads");
+				const service = this.getHomeFeaturePromptTarget("memory");
 				if (!service || !((_this$core = this.core) === null || _this$core === void 0 ? void 0 : _this$core.runtimeUrl)) return;
 				const request = ++this.learningSetupCopyRequest;
 				const copied = await this.copyFeaturePromptToClipboard(service, event, this.getOnboardingRunId());
@@ -10737,6 +10792,7 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(parsed))}</pre
 			return titleCharacters.length > HUD_ANNOUNCEMENT_TITLE_LIMIT ? `${titleCharacters.slice(0, HUD_ANNOUNCEMENT_TITLE_LIMIT).join("").trimEnd()}...` : title;
 		}
 		renderHudRow(args) {
+			if (args.connected) return lit.nothing;
 			const detailId = `cpk-hud-detail-${args.id}`;
 			return lit.html`
       <li
@@ -10808,11 +10864,13 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(parsed))}</pre
 			const learningOn = homeModel.services.some((service) => service.id === "memory" && service.enabled);
 			const announcementTitle = this.getUnreadAnnouncementTitle();
 			const featureBlockIntroIndex = announcementTitle ? 1 : 0;
+			const dismissOnly = !announcementTitle && threadsOn && learningOn;
 			return lit.html`
       <div
         class="cpk-launcher-hud"
         id="cpk-launcher-hud"
         data-cpk-launcher-hud
+        ?data-cpk-hud-dismiss-only=${dismissOnly}
         data-cpk-hud-side=${this.launcherHudSide}
         data-cpk-hud-vertical=${this.contextState.button.anchor.vertical}
         data-cpk-hud-intro=${this.launcherHudIntro ? "true" : lit.nothing}
@@ -10822,7 +10880,9 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(parsed))}</pre
 				"--cpk-launcher-hud-waterfall-duration": `${LAUNCHER_HUD_INTRO_MS.waterfallDuration}ms`
 			})}
       >
-        <span class="cpk-launcher-hud__arrow" aria-hidden="true"></span>
+        ${dismissOnly ? lit.nothing : lit.html`
+                <span class="cpk-launcher-hud__arrow" aria-hidden="true"></span>
+              `}
         <div class="cpk-launcher-hud__card">
           ${announcementTitle ? lit.html`
                   <div
@@ -10861,31 +10921,33 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(parsed))}</pre
                     </div>
                   </div>
                 ` : lit.nothing}
-          <ul
-            class="cpk-launcher-hud__list cpk-launcher-hud__feature-list"
-            role="list"
-            style=${(0, lit_directives_style_map_js.styleMap)({ "--cpk-hud-waterfall-delay": launcherHudWaterfallDelay(featureBlockIntroIndex) })}
-          >
-            ${this.renderHudRow({
+          ${threadsOn && learningOn ? lit.nothing : lit.html`
+                  <ul
+                    class="cpk-launcher-hud__list cpk-launcher-hud__feature-list"
+                    role="list"
+                    style=${(0, lit_directives_style_map_js.styleMap)({ "--cpk-hud-waterfall-delay": launcherHudWaterfallDelay(featureBlockIntroIndex) })}
+                  >
+                    ${this.renderHudRow({
 				id: "threads",
 				label: HUD_THREADS_LABEL,
 				icon: "MessageSquare",
 				connected: threadsOn,
 				introIndex: featureBlockIntroIndex + 1
 			})}
-            ${this.renderHudRow({
+                    ${this.renderHudRow({
 				id: "learning",
 				label: HUD_LEARNING_LABEL,
 				icon: "Brain",
 				connected: learningOn,
-				introIndex: featureBlockIntroIndex + 2
+				introIndex: featureBlockIntroIndex + (threadsOn ? 1 : 2)
 			})}
-          </ul>
+                  </ul>
+                `}
           <button
             type="button"
             class="cpk-launcher-hud__dismiss-day"
             data-cpk-dismiss-inspector="day"
-            style=${(0, lit_directives_style_map_js.styleMap)({ "--cpk-hud-waterfall-delay": launcherHudWaterfallDelay(featureBlockIntroIndex + 3) })}
+            style=${(0, lit_directives_style_map_js.styleMap)({ "--cpk-hud-waterfall-delay": launcherHudWaterfallDelay(dismissOnly ? 0 : featureBlockIntroIndex + Number(!threadsOn) + Number(!learningOn) + 1) })}
             @click=${this.handleHudDismissDayClick}
             @pointerdown=${(event) => event.stopPropagation()}
           >
@@ -14370,23 +14432,6 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(parsed))}</pre
       </div>
     `;
 		}
-		getThreadsLockedCopy() {
-			switch (this.inspectorMetadataProjection.licenseState) {
-				case "valid": return {
-					heading: "Finish setting up Rich Threads",
-					description: "Copy this prompt into your coding agent to finish the setup."
-				};
-				case "none":
-				case "unknown": return {
-					heading: "Production-grade chat threads without the complexity. Self hostable.",
-					description: "Chat threads that go beyond text with generative UI and multimodal inputs, built to replay missed events and stay in sync across tabs, sessions, and devices."
-				};
-				case "expired": return {
-					heading: "Renew Intelligence to inspect Threads.",
-					description: "Your Intelligence access has expired. Renew it to inspect saved thread history."
-				};
-			}
-		}
 		/**
 		* Renders the realtime-connection indicator in the memory-store header.
 		* Only `"connected"` shows the live (green-dot) state; `"connecting"` shows a
@@ -14437,7 +14482,7 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(parsed))}</pre
 				videoTitle: "CopilotKit Learning overview",
 				outlineItems: LEARNING_LOCKED_FEATURE_OUTLINE,
 				setupPrompt: {
-					serviceId: "threads",
+					serviceId: "memory",
 					copyState: this.learningPromptCopyState,
 					onClick: (event) => void this.handleLearningSetupCopy(event)
 				}
@@ -14453,7 +14498,7 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(parsed))}</pre
         .setupActive=${this.isLearningSetupActive()}
         .copyState=${this.learningPromptCopyState}
         .recopyState=${this.learningPromptRecopyState}
-        .setupPrompt=${this.getHomeFeaturePromptTarget("threads") ? homeFeatureImplementationPrompt(this.getHomeFeaturePromptTarget("threads"), { onboardingRunId: this.getOnboardingRunId() }) : ""}
+        .setupPrompt=${createFeatureOnboardingPrompt("memory", this.getOnboardingRunId())}
         @learning-retry=${() => this.refreshLearningSnapshot({ preserve: this.learningSnapshot !== null })}
         @learning-copy-setup=${(event) => this.handleLearningSetupCopy(event)}
         @learning-recopy-setup=${(event) => this.handleLearningSetupCopy(event, true)}
@@ -14699,12 +14744,11 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(parsed))}</pre
 			var _visibleThreads$find, _this$_core$runtimeUr2, _this$_core20, _this$_core$headers, _this$_core21, _this$_core22, _this$liveMessageVers2, _this$agentEvents$get6, _this$_core23;
 			if (!this.areThreadEndpointsAvailable()) {
 				this.trackThreadsViewStateOnce("locked");
-				const lockedCopy = this.getThreadsLockedCopy();
 				return this.renderLockedFeatureOverview({
 					serviceId: "threads",
 					featureName: "Rich Threads",
-					heading: lockedCopy.heading,
-					description: lockedCopy.description,
+					heading: THREADS_LOCKED_COPY.heading,
+					description: THREADS_LOCKED_COPY.description,
 					videoUrl: THREADS_LOCKED_VIDEO_URL,
 					videoTitle: "Rich Threads overview",
 					outlineItems: THREADS_LOCKED_FEATURE_OUTLINE
@@ -18051,6 +18095,24 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(parsed))}</pre
         );
       }
 
+      /* With no news or setup actions, the dismissal is the whole HUD. */
+      .cpk-launcher-hud[data-cpk-hud-dismiss-only] {
+        --hud-dismiss-day-height: 36px;
+        width: max-content;
+      }
+
+      .cpk-launcher-hud[data-cpk-hud-dismiss-only][data-cpk-hud-vertical="top"] {
+        top: calc((var(--cpk-launcher-size) - var(--hud-dismiss-day-height)) / 2);
+      }
+
+      .cpk-launcher-hud[data-cpk-hud-dismiss-only][data-cpk-hud-vertical="bottom"] {
+        bottom: calc((var(--cpk-launcher-size) - var(--hud-dismiss-day-height)) / 2);
+      }
+
+      .cpk-launcher-hud[data-cpk-hud-dismiss-only] .cpk-launcher-hud__card {
+        width: max-content;
+      }
+
       .cpk-launcher-hud__list {
         margin: 0;
         padding: 0;
@@ -18217,6 +18279,11 @@ ${(0, lit_directives_unsafe_html_js.unsafeHTML)(highlightedJson(parsed))}</pre
           color 120ms ease;
       }
 
+      .cpk-launcher-hud[data-cpk-hud-dismiss-only] .cpk-launcher-hud__dismiss-day {
+        font-size: 11px;
+        white-space: nowrap;
+      }
+
       .cpk-launcher-hud__dismiss-day:hover,
       .cpk-launcher-hud__dismiss-day:focus-visible {
         border-color: var(--hud-accent);