@copilotkit/web-inspector 1.68.3 → 1.69.1

package/dist/lib/home-briefing.mjs

@@ -0,0 +1,288 @@
+//#region src/lib/home-briefing.ts
+const SERVICE_DOCS_URL = {
+	threads: "https://docs.copilotkit.ai/threads",
+	memory: "https://docs.copilotkit.ai/premium/intelligence-platform",
+	a2ui: "https://docs.copilotkit.ai/generative-ui/a2ui",
+	"open-gen-ui": "https://docs.copilotkit.ai/generative-ui/open-generative-ui",
+	suggestions: "https://docs.copilotkit.ai/agentic-chat-ui",
+	audio: "https://docs.copilotkit.ai/voice",
+	websocket: "https://docs.copilotkit.ai/premium/intelligence-platform"
+};
+/** Return the Home hero button for a trusted metadata action. */
+function homeHeroActionFromMetadata(action) {
+	if (action.kind === "manage_plan") return {
+		kind: action.kind,
+		url: action.url,
+		label: "Manage plan"
+	};
+	if (action.kind === "renew") return {
+		kind: action.kind,
+		url: action.url,
+		label: "Renew plan"
+	};
+	return {
+		kind: action.kind,
+		url: action.url,
+		label: "Setup Intelligence"
+	};
+}
+/** Return a short preview from markdown, without links or headings. */
+function announcementPreview(markdown, maxLength = 140) {
+	const plain = markdown.replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/[#*_`]/g, "").replace(/\s+/g, " ").trim();
+	if (plain.length <= maxLength) return plain;
+	return `${plain.slice(0, maxLength).trimEnd()}…`;
+}
+function connectIntelligenceAction(action, connectUrl, licenseState) {
+	if (action) return action;
+	if (connectUrl && (licenseState === "none" || licenseState === "unknown")) return homeHeroActionFromMetadata({
+		kind: "enable_intelligence",
+		url: connectUrl
+	});
+}
+function heroForState(args) {
+	if (!args.connected) {
+		const renewing = args.action?.kind === "renew";
+		return {
+			connection: "disconnected",
+			title: renewing ? "Renew Intelligence" : "Intelligence is not setup",
+			body: renewing ? "Renew Intelligence to restore persistent Threads and Memory." : "Connect CopilotKit Intelligence to add persistent Threads, Learning and Analytics to your application. Inspect conversations and allow your agents to learn from real use.",
+			action: connectIntelligenceAction(args.action, args.connectUrl, args.licenseState)
+		};
+	}
+	return {
+		connection: "connected",
+		title: "Connected to Intelligence",
+		body: "Use Workbench to inspect threads and memory.",
+		action: args.action?.kind === "enable_intelligence" ? void 0 : args.action
+	};
+}
+function usageFromMetadata(metadata) {
+	const usage = metadata.usage;
+	if (!usage) return;
+	if (usage.limit.kind === "finite") return {
+		used: usage.used,
+		limitLabel: `${usage.used} / ${usage.limit.value}`,
+		ratio: usage.limit.value === 0 ? 1 : usage.used / usage.limit.value
+	};
+	if (usage.limit.kind === "unlimited") return {
+		used: usage.used,
+		limitLabel: `${usage.used} / unlimited`
+	};
+	return {
+		used: usage.used,
+		limitLabel: `${usage.used} used`
+	};
+}
+function newsFromAnnouncement(args) {
+	const markdown = args.markdown?.trim();
+	if (markdown && args.html) return {
+		title: markdown.match(/^#{1,3}\s+(.+)$/m)?.[1]?.trim() || "The latest from CopilotKit",
+		previewText: args.previewText?.trim() || announcementPreview(markdown, 160),
+		documentHtml: args.html,
+		empty: false
+	};
+	return {
+		title: "You're all caught up",
+		previewText: "Latest CopilotKit updates will appear here.",
+		empty: true
+	};
+}
+function runtimeEventSignal(event) {
+	if (!event) return {
+		label: "No events yet",
+		tone: "muted"
+	};
+	const eventDetails = {
+		id: event.id,
+		agentId: event.agentId,
+		type: event.type,
+		timestamp: event.timestamp
+	};
+	if (event.type === "RUN_ERROR" || event.type === "ERROR") return {
+		label: event.type === "RUN_ERROR" ? "Run error" : "Error",
+		tone: "error",
+		...eventDetails
+	};
+	if (event.type === "RUN_FINISHED") return {
+		label: "Run completed",
+		tone: "success",
+		...eventDetails
+	};
+	if (event.type.endsWith("_START") || event.type.endsWith("_STARTED") || event.type.endsWith("_CONTENT") || event.type.endsWith("_ARGS") || event.type.endsWith("_DELTA")) return {
+		label: "Last event is in progress",
+		tone: "active",
+		...eventDetails
+	};
+	return {
+		label: "Last event received",
+		tone: "success",
+		...eventDetails
+	};
+}
+/**
+* Whether the runtime *connection* needs attention — the single condition
+* shared by System Health and the launcher's error signal, so the two can
+* never disagree about whether the wiring is broken.
+*
+* Exactly one state counts. `disconnected` is also the initial value, so
+* counting it would raise the signal on every page load; `connecting` is a
+* normal startup step; `unavailable` means no Core is attached, which is not
+* a defect of the developer's wiring.
+*
+* Note the deliberate asymmetry with `health.state`: a failed *run* also
+* drives System Health to "Needs attention" while the connection is fine.
+* That is an event rather than a state, and it is excluded from the launcher
+* on purpose — see the launcher-signal comments in index.ts.
+*/
+function runtimeConnectionNeedsAttention(state) {
+	return state === "error";
+}
+function runtimeHealthFromInput(input) {
+	const lastEvent = runtimeEventSignal(input.lastRuntimeEvent);
+	if (input.runtimeConnectionState === "connected") return {
+		state: lastEvent.tone === "error" ? "error" : "healthy",
+		label: lastEvent.tone === "error" ? "Needs attention" : "Healthy",
+		runtime: {
+			label: "Available",
+			tone: "success"
+		},
+		liveUpdates: {
+			label: "Ready",
+			tone: "success"
+		},
+		lastEvent
+	};
+	if (input.runtimeConnectionState === "connecting") return {
+		state: "checking",
+		label: "Checking",
+		runtime: {
+			label: "Checking",
+			tone: "active"
+		},
+		liveUpdates: {
+			label: "Connecting",
+			tone: "active"
+		},
+		lastEvent
+	};
+	if (input.runtimeConnectionState === "unavailable") return {
+		state: "unavailable",
+		label: "Unavailable",
+		runtime: {
+			label: "Unavailable",
+			tone: "muted"
+		},
+		liveUpdates: {
+			label: "Not attached",
+			tone: "muted"
+		},
+		lastEvent
+	};
+	const needsAttention = runtimeConnectionNeedsAttention(input.runtimeConnectionState);
+	return {
+		state: needsAttention ? "error" : "offline",
+		label: needsAttention ? "Runtime error" : "Offline",
+		runtime: {
+			label: "Offline",
+			tone: "error"
+		},
+		liveUpdates: {
+			label: needsAttention ? "Error" : "Disconnected",
+			tone: "error"
+		},
+		lastEvent
+	};
+}
+/** Build the Home briefing from data the Inspector already has. */
+function buildHomeModel(input) {
+	const metadataAction = input.metadata.threadsFooterAction ?? input.metadata.lockedAction;
+	const action = metadataAction ? homeHeroActionFromMetadata({
+		kind: metadataAction.kind,
+		url: metadataAction.url
+	}) : void 0;
+	const identity = input.metadata.identity;
+	const projectLinked = Boolean(identity);
+	const intelligenceConnected = input.metadata.licenseState === "valid" || input.metadata.licenseState === "unknown" && input.intelligenceConnected;
+	const usage = usageFromMetadata(input.metadata);
+	return {
+		hero: heroForState({
+			connected: intelligenceConnected,
+			action,
+			connectUrl: input.intelligenceSignupUrl,
+			licenseState: input.metadata.licenseState
+		}),
+		projectLinked,
+		project: identity ? {
+			organizationName: identity.organizationName,
+			projectName: identity.projectName,
+			planLabel: input.metadata.plan?.label,
+			license: input.metadata.licenseState,
+			usage
+		} : input.metadata.plan || usage ? {
+			organizationName: "Not linked",
+			projectName: "This runtime is not linked to a project",
+			planLabel: input.metadata.plan?.label,
+			license: input.metadata.licenseState,
+			usage
+		} : void 0,
+		runtime: {
+			url: input.runtimeUrl,
+			health: runtimeHealthFromInput(input)
+		},
+		services: [
+			{
+				id: "threads",
+				label: "Threads",
+				enabled: intelligenceConnected && input.threadsAvailable,
+				url: input.runtimeUrl,
+				docsUrl: SERVICE_DOCS_URL.threads
+			},
+			{
+				id: "memory",
+				label: "Memory",
+				enabled: intelligenceConnected && input.memoriesOn,
+				docsUrl: SERVICE_DOCS_URL.memory
+			},
+			{
+				id: "a2ui",
+				label: "A2UI",
+				enabled: input.a2uiOn,
+				docsUrl: SERVICE_DOCS_URL.a2ui
+			},
+			{
+				id: "open-gen-ui",
+				label: "Open Gen UI",
+				enabled: input.openGenUiOn,
+				docsUrl: SERVICE_DOCS_URL["open-gen-ui"]
+			},
+			{
+				id: "suggestions",
+				label: "Suggestions",
+				enabled: input.suggestionsOn,
+				docsUrl: SERVICE_DOCS_URL.suggestions
+			},
+			{
+				id: "audio",
+				label: "Audio",
+				enabled: input.audioOn,
+				docsUrl: SERVICE_DOCS_URL.audio
+			},
+			{
+				id: "websocket",
+				label: "Websocket",
+				enabled: intelligenceConnected && Boolean(input.websocketUrl),
+				url: input.websocketUrl,
+				docsUrl: SERVICE_DOCS_URL.websocket
+			}
+		],
+		news: newsFromAnnouncement({
+			previewText: input.announcementPreviewText,
+			markdown: input.announcementMarkdown,
+			html: input.announcementHtml ?? void 0
+		})
+	};
+}
+
+//#endregion
+export { buildHomeModel, runtimeConnectionNeedsAttention };
+//# sourceMappingURL=home-briefing.mjs.map

package/dist/lib/home-briefing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-briefing.mjs","names":[],"sources":["../../src/lib/home-briefing.ts"],"sourcesContent":["import type { InspectorMetadataProjection } from \"./inspector-metadata.js\";\n\nexport type HomeHeroActionKind =\n  | \"enable_intelligence\"\n  | \"manage_plan\"\n  | \"renew\";\n\nexport type HomeHeroAction = {\n  kind: HomeHeroActionKind;\n  url: string;\n  label: string;\n};\n\nexport type HomeConnection = \"connected\" | \"disconnected\";\n\nexport type HomeRuntimeConnectionState =\n  | \"connected\"\n  | \"connecting\"\n  | \"disconnected\"\n  | \"error\"\n  | \"unavailable\";\n\nexport type HomeRuntimeHealthTone = \"success\" | \"active\" | \"error\" | \"muted\";\n\nexport type HomeServiceId =\n  | \"threads\"\n  | \"memory\"\n  | \"a2ui\"\n  | \"open-gen-ui\"\n  | \"suggestions\"\n  | \"audio\"\n  | \"websocket\";\n\nexport type HomeServiceTile = {\n  id: HomeServiceId;\n  label: string;\n  enabled: boolean;\n  url?: string;\n  docsUrl: string;\n};\n\nexport type HomeModel = {\n  hero: {\n    connection: HomeConnection;\n    title: string;\n    body: string;\n    action?: HomeHeroAction;\n  };\n  project?: {\n    organizationName: string;\n    projectName: string;\n    planLabel?: string;\n    license: string;\n    usage?: {\n      used: number;\n      limitLabel: string;\n      ratio?: number;\n    };\n  };\n  projectLinked: boolean;\n  runtime: {\n    url?: string;\n    health: {\n      state: \"healthy\" | \"checking\" | \"offline\" | \"error\" | \"unavailable\";\n      label: string;\n      runtime: {\n        label: string;\n        tone: HomeRuntimeHealthTone;\n      };\n      liveUpdates: {\n        label: string;\n        tone: HomeRuntimeHealthTone;\n      };\n      lastEvent: {\n        label: string;\n        tone: HomeRuntimeHealthTone;\n        id?: string;\n        agentId?: string;\n        type?: string;\n        timestamp?: number;\n      };\n    };\n  };\n  services: HomeServiceTile[];\n  news: {\n    title: string;\n    previewText: string;\n    documentHtml?: string;\n    empty: boolean;\n  };\n};\n\nexport type HomeBriefingInput = {\n  intelligenceConnected: boolean;\n  threadsAvailable: boolean;\n  metadata: InspectorMetadataProjection;\n  runtimeUrl?: string;\n  runtimeConnectionState: HomeRuntimeConnectionState;\n  lastRuntimeEvent?: {\n    id: string;\n    agentId: string;\n    type: string;\n    timestamp: number;\n  };\n  memoriesOn: boolean;\n  a2uiOn: boolean;\n  openGenUiOn: boolean;\n  suggestionsOn: boolean;\n  audioOn: boolean;\n  websocketUrl?: string;\n  announcementPreviewText?: string;\n  announcementMarkdown?: string;\n  announcementHtml?: string;\n  intelligenceSignupUrl?: string;\n};\n\nconst SERVICE_DOCS_URL: Record<HomeServiceId, string> = {\n  threads: \"https://docs.copilotkit.ai/threads\",\n  memory: \"https://docs.copilotkit.ai/premium/intelligence-platform\",\n  a2ui: \"https://docs.copilotkit.ai/generative-ui/a2ui\",\n  \"open-gen-ui\": \"https://docs.copilotkit.ai/generative-ui/open-generative-ui\",\n  suggestions: \"https://docs.copilotkit.ai/agentic-chat-ui\",\n  audio: \"https://docs.copilotkit.ai/voice\",\n  websocket: \"https://docs.copilotkit.ai/premium/intelligence-platform\",\n};\n\n/** Return the Home hero button for a trusted metadata action. */\nexport function homeHeroActionFromMetadata(action: {\n  kind: HomeHeroActionKind;\n  url: string;\n}): HomeHeroAction {\n  if (action.kind === \"manage_plan\") {\n    return { kind: action.kind, url: action.url, label: \"Manage plan\" };\n  }\n\n  if (action.kind === \"renew\") {\n    return { kind: action.kind, url: action.url, label: \"Renew plan\" };\n  }\n\n  return {\n    kind: action.kind,\n    url: action.url,\n    label: \"Setup Intelligence\",\n  };\n}\n\n/** Return a short preview from markdown, without links or headings. */\nexport function announcementPreview(markdown: string, maxLength = 140): string {\n  const plain = markdown\n    .replace(/\\[([^\\]]+)\\]\\([^)]+\\)/g, \"$1\")\n    .replace(/[#*_`]/g, \"\")\n    .replace(/\\s+/g, \" \")\n    .trim();\n  if (plain.length <= maxLength) {\n    return plain;\n  }\n\n  return `${plain.slice(0, maxLength).trimEnd()}…`;\n}\n\nfunction connectIntelligenceAction(\n  action: HomeHeroAction | undefined,\n  connectUrl?: string,\n  licenseState?: InspectorMetadataProjection[\"licenseState\"],\n): HomeHeroAction | undefined {\n  if (action) {\n    return action;\n  }\n\n  if (connectUrl && (licenseState === \"none\" || licenseState === \"unknown\")) {\n    return homeHeroActionFromMetadata({\n      kind: \"enable_intelligence\",\n      url: connectUrl,\n    });\n  }\n\n  return undefined;\n}\n\nfunction heroForState(args: {\n  connected: boolean;\n  action?: HomeHeroAction;\n  connectUrl?: string;\n  licenseState: InspectorMetadataProjection[\"licenseState\"];\n}): HomeModel[\"hero\"] {\n  if (!args.connected) {\n    const renewing = args.action?.kind === \"renew\";\n    return {\n      connection: \"disconnected\",\n      title: renewing ? \"Renew Intelligence\" : \"Intelligence is not setup\",\n      body: renewing\n        ? \"Renew Intelligence to restore persistent Threads and Memory.\"\n        : \"Connect CopilotKit Intelligence to add persistent Threads, Learning and Analytics to your application. Inspect conversations and allow your agents to learn from real use.\",\n      action: connectIntelligenceAction(\n        args.action,\n        args.connectUrl,\n        args.licenseState,\n      ),\n    };\n  }\n\n  return {\n    connection: \"connected\",\n    title: \"Connected to Intelligence\",\n    body: \"Use Workbench to inspect threads and memory.\",\n    action:\n      args.action?.kind === \"enable_intelligence\" ? undefined : args.action,\n  };\n}\n\nfunction usageFromMetadata(metadata: InspectorMetadataProjection):\n  | {\n      used: number;\n      limitLabel: string;\n      ratio?: number;\n    }\n  | undefined {\n  const usage = metadata.usage;\n  if (!usage) {\n    return undefined;\n  }\n\n  if (usage.limit.kind === \"finite\") {\n    return {\n      used: usage.used,\n      limitLabel: `${usage.used} / ${usage.limit.value}`,\n      ratio: usage.limit.value === 0 ? 1 : usage.used / usage.limit.value,\n    };\n  }\n\n  if (usage.limit.kind === \"unlimited\") {\n    return {\n      used: usage.used,\n      limitLabel: `${usage.used} / unlimited`,\n    };\n  }\n\n  return {\n    used: usage.used,\n    limitLabel: `${usage.used} used`,\n  };\n}\n\nfunction newsFromAnnouncement(args: {\n  previewText?: string;\n  markdown?: string;\n  html?: string;\n}): HomeModel[\"news\"] {\n  const markdown = args.markdown?.trim();\n  if (markdown && args.html) {\n    const heading = markdown.match(/^#{1,3}\\s+(.+)$/m)?.[1]?.trim();\n    return {\n      title: heading || \"The latest from CopilotKit\",\n      previewText:\n        args.previewText?.trim() || announcementPreview(markdown, 160),\n      documentHtml: args.html,\n      empty: false,\n    };\n  }\n\n  return {\n    title: \"You're all caught up\",\n    previewText: \"Latest CopilotKit updates will appear here.\",\n    empty: true,\n  };\n}\n\nfunction runtimeEventSignal(\n  event: HomeBriefingInput[\"lastRuntimeEvent\"],\n): HomeModel[\"runtime\"][\"health\"][\"lastEvent\"] {\n  if (!event) {\n    return { label: \"No events yet\", tone: \"muted\" };\n  }\n\n  const eventDetails = {\n    id: event.id,\n    agentId: event.agentId,\n    type: event.type,\n    timestamp: event.timestamp,\n  };\n\n  if (event.type === \"RUN_ERROR\" || event.type === \"ERROR\") {\n    return {\n      label: event.type === \"RUN_ERROR\" ? \"Run error\" : \"Error\",\n      tone: \"error\",\n      ...eventDetails,\n    };\n  }\n\n  if (event.type === \"RUN_FINISHED\") {\n    return {\n      label: \"Run completed\",\n      tone: \"success\",\n      ...eventDetails,\n    };\n  }\n\n  if (\n    event.type.endsWith(\"_START\") ||\n    event.type.endsWith(\"_STARTED\") ||\n    event.type.endsWith(\"_CONTENT\") ||\n    event.type.endsWith(\"_ARGS\") ||\n    event.type.endsWith(\"_DELTA\")\n  ) {\n    return {\n      label: \"Last event is in progress\",\n      tone: \"active\",\n      ...eventDetails,\n    };\n  }\n\n  return {\n    label: \"Last event received\",\n    tone: \"success\",\n    ...eventDetails,\n  };\n}\n\n/**\n * Whether the runtime *connection* needs attention — the single condition\n * shared by System Health and the launcher's error signal, so the two can\n * never disagree about whether the wiring is broken.\n *\n * Exactly one state counts. `disconnected` is also the initial value, so\n * counting it would raise the signal on every page load; `connecting` is a\n * normal startup step; `unavailable` means no Core is attached, which is not\n * a defect of the developer's wiring.\n *\n * Note the deliberate asymmetry with `health.state`: a failed *run* also\n * drives System Health to \"Needs attention\" while the connection is fine.\n * That is an event rather than a state, and it is excluded from the launcher\n * on purpose — see the launcher-signal comments in index.ts.\n */\nexport function runtimeConnectionNeedsAttention(\n  state: HomeRuntimeConnectionState,\n): boolean {\n  return state === \"error\";\n}\n\nfunction runtimeHealthFromInput(\n  input: HomeBriefingInput,\n): HomeModel[\"runtime\"][\"health\"] {\n  const lastEvent = runtimeEventSignal(input.lastRuntimeEvent);\n\n  if (input.runtimeConnectionState === \"connected\") {\n    return {\n      state: lastEvent.tone === \"error\" ? \"error\" : \"healthy\",\n      label: lastEvent.tone === \"error\" ? \"Needs attention\" : \"Healthy\",\n      runtime: { label: \"Available\", tone: \"success\" },\n      liveUpdates: { label: \"Ready\", tone: \"success\" },\n      lastEvent,\n    };\n  }\n\n  if (input.runtimeConnectionState === \"connecting\") {\n    return {\n      state: \"checking\",\n      label: \"Checking\",\n      runtime: { label: \"Checking\", tone: \"active\" },\n      liveUpdates: { label: \"Connecting\", tone: \"active\" },\n      lastEvent,\n    };\n  }\n\n  if (input.runtimeConnectionState === \"unavailable\") {\n    return {\n      state: \"unavailable\",\n      label: \"Unavailable\",\n      runtime: { label: \"Unavailable\", tone: \"muted\" },\n      liveUpdates: { label: \"Not attached\", tone: \"muted\" },\n      lastEvent,\n    };\n  }\n\n  const needsAttention = runtimeConnectionNeedsAttention(\n    input.runtimeConnectionState,\n  );\n  return {\n    state: needsAttention ? \"error\" : \"offline\",\n    label: needsAttention ? \"Runtime error\" : \"Offline\",\n    runtime: { label: \"Offline\", tone: \"error\" },\n    liveUpdates: {\n      label: needsAttention ? \"Error\" : \"Disconnected\",\n      tone: \"error\",\n    },\n    lastEvent,\n  };\n}\n\n/** Build the Home briefing from data the Inspector already has. */\nexport function buildHomeModel(input: HomeBriefingInput): HomeModel {\n  const metadataAction =\n    input.metadata.threadsFooterAction ?? input.metadata.lockedAction;\n  const action = metadataAction\n    ? homeHeroActionFromMetadata({\n        kind: metadataAction.kind,\n        url: metadataAction.url,\n      })\n    : undefined;\n\n  const identity = input.metadata.identity;\n  const projectLinked = Boolean(identity);\n  const intelligenceConnected =\n    input.metadata.licenseState === \"valid\" ||\n    (input.metadata.licenseState === \"unknown\" && input.intelligenceConnected);\n  const usage = usageFromMetadata(input.metadata);\n\n  return {\n    hero: heroForState({\n      connected: intelligenceConnected,\n      action,\n      connectUrl: input.intelligenceSignupUrl,\n      licenseState: input.metadata.licenseState,\n    }),\n    projectLinked,\n    project: identity\n      ? {\n          organizationName: identity.organizationName,\n          projectName: identity.projectName,\n          planLabel: input.metadata.plan?.label,\n          license: input.metadata.licenseState,\n          usage,\n        }\n      : input.metadata.plan || usage\n        ? {\n            organizationName: \"Not linked\",\n            projectName: \"This runtime is not linked to a project\",\n            planLabel: input.metadata.plan?.label,\n            license: input.metadata.licenseState,\n            usage,\n          }\n        : undefined,\n    runtime: {\n      url: input.runtimeUrl,\n      health: runtimeHealthFromInput(input),\n    },\n    services: [\n      {\n        id: \"threads\",\n        label: \"Threads\",\n        enabled: intelligenceConnected && input.threadsAvailable,\n        url: input.runtimeUrl,\n        docsUrl: SERVICE_DOCS_URL.threads,\n      },\n      {\n        id: \"memory\",\n        label: \"Memory\",\n        enabled: intelligenceConnected && input.memoriesOn,\n        docsUrl: SERVICE_DOCS_URL.memory,\n      },\n      {\n        id: \"a2ui\",\n        label: \"A2UI\",\n        enabled: input.a2uiOn,\n        docsUrl: SERVICE_DOCS_URL.a2ui,\n      },\n      {\n        id: \"open-gen-ui\",\n        label: \"Open Gen UI\",\n        enabled: input.openGenUiOn,\n        docsUrl: SERVICE_DOCS_URL[\"open-gen-ui\"],\n      },\n      {\n        id: \"suggestions\",\n        label: \"Suggestions\",\n        enabled: input.suggestionsOn,\n        docsUrl: SERVICE_DOCS_URL.suggestions,\n      },\n      {\n        id: \"audio\",\n        label: \"Audio\",\n        enabled: input.audioOn,\n        docsUrl: SERVICE_DOCS_URL.audio,\n      },\n      {\n        id: \"websocket\",\n        label: \"Websocket\",\n        enabled: intelligenceConnected && Boolean(input.websocketUrl),\n        url: input.websocketUrl,\n        docsUrl: SERVICE_DOCS_URL.websocket,\n      },\n    ],\n    news: newsFromAnnouncement({\n      previewText: input.announcementPreviewText,\n      markdown: input.announcementMarkdown,\n      html: input.announcementHtml ?? undefined,\n    }),\n  };\n}\n"],"mappings":"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"}

package/dist/lib/inspector-nav.cjs

@@ -0,0 +1,59 @@
+
+//#region src/lib/inspector-nav.ts
+const INSPECTOR_GROUPS = {
+	home: ["home", "whats-new"],
+	workbench: [
+		"playground",
+		"threads",
+		"memories"
+	],
+	inspect: [
+		"agents",
+		"ag-ui-events",
+		"event-snippets",
+		"frontend-tools",
+		"capabilities",
+		"agent-context"
+	]
+};
+const INSPECTOR_MENU_KEYS = [
+	...INSPECTOR_GROUPS.home,
+	...INSPECTOR_GROUPS.workbench,
+	...INSPECTOR_GROUPS.inspect
+];
+const INSPECTOR_NAV_SECTIONS = [
+	{
+		group: "home",
+		label: null
+	},
+	{
+		group: "workbench",
+		label: "Workbench"
+	},
+	{
+		group: "inspect",
+		label: "Inspect"
+	}
+];
+const ICON_RAIL_MAX_WIDTH_PX = 720;
+/** Return whether persisted state names a known Inspector leaf. */
+function isInspectorMenuKey(value) {
+	return typeof value === "string" && INSPECTOR_MENU_KEYS.some((menuKey) => menuKey === value);
+}
+/** Return the sidebar group that owns a leaf. */
+function getGroupForMenu(key) {
+	for (const group of Object.keys(INSPECTOR_GROUPS)) if (INSPECTOR_GROUPS[group].some((menuKey) => menuKey === key)) return group;
+	return "workbench";
+}
+/** Return whether the sidebar should collapse to an icon rail. */
+function shouldUseIconRail(args) {
+	return args.dockedLeft || args.width < ICON_RAIL_MAX_WIDTH_PX;
+}
+
+//#endregion
+exports.INSPECTOR_GROUPS = INSPECTOR_GROUPS;
+exports.INSPECTOR_NAV_SECTIONS = INSPECTOR_NAV_SECTIONS;
+exports.getGroupForMenu = getGroupForMenu;
+exports.isInspectorMenuKey = isInspectorMenuKey;
+exports.shouldUseIconRail = shouldUseIconRail;
+//# sourceMappingURL=inspector-nav.cjs.map

package/dist/lib/inspector-nav.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector-nav.cjs","names":[],"sources":["../../src/lib/inspector-nav.ts"],"sourcesContent":["import type { InspectorLeafKey } from \"./telemetry.js\";\n\nexport type ShellGroupKey = \"home\" | \"workbench\" | \"inspect\";\n\nexport const INSPECTOR_GROUPS = {\n  home: [\"home\", \"whats-new\"],\n  workbench: [\"playground\", \"threads\", \"memories\"],\n  inspect: [\n    \"agents\",\n    \"ag-ui-events\",\n    \"event-snippets\",\n    \"frontend-tools\",\n    \"capabilities\",\n    \"agent-context\",\n  ],\n} as const satisfies Record<ShellGroupKey, readonly InspectorLeafKey[]>;\n\nexport type InspectorNavGroupKey = keyof typeof INSPECTOR_GROUPS;\nexport type MenuKey = (typeof INSPECTOR_GROUPS)[InspectorNavGroupKey][number];\n\nexport const INSPECTOR_MENU_KEYS: ReadonlyArray<MenuKey> = [\n  ...INSPECTOR_GROUPS.home,\n  ...INSPECTOR_GROUPS.workbench,\n  ...INSPECTOR_GROUPS.inspect,\n];\n\nexport const INSPECTOR_NAV_SECTIONS: ReadonlyArray<{\n  group: InspectorNavGroupKey;\n  label: string | null;\n}> = [\n  { group: \"home\", label: null },\n  { group: \"workbench\", label: \"Workbench\" },\n  { group: \"inspect\", label: \"Inspect\" },\n];\n\nexport const ICON_RAIL_MAX_WIDTH_PX = 720;\n\n/** Return whether persisted state names a known Inspector leaf. */\nexport function isInspectorMenuKey(value: unknown): value is MenuKey {\n  return (\n    typeof value === \"string\" &&\n    INSPECTOR_MENU_KEYS.some((menuKey) => menuKey === value)\n  );\n}\n\n/** Return the sidebar group that owns a leaf. */\nexport function getGroupForMenu(key: MenuKey): InspectorNavGroupKey {\n  for (const group of Object.keys(INSPECTOR_GROUPS) as InspectorNavGroupKey[]) {\n    if (INSPECTOR_GROUPS[group].some((menuKey) => menuKey === key)) {\n      return group;\n    }\n  }\n\n  return \"workbench\";\n}\n\n/** Return whether the sidebar should collapse to an icon rail. */\nexport function shouldUseIconRail(args: {\n  dockedLeft: boolean;\n  width: number;\n}): boolean {\n  return args.dockedLeft || args.width < ICON_RAIL_MAX_WIDTH_PX;\n}\n"],"mappings":";;AAIA,MAAa,mBAAmB;CAC9B,MAAM,CAAC,QAAQ,YAAY;CAC3B,WAAW;EAAC;EAAc;EAAW;EAAW;CAChD,SAAS;EACP;EACA;EACA;EACA;EACA;EACA;EACD;CACF;AAKD,MAAa,sBAA8C;CACzD,GAAG,iBAAiB;CACpB,GAAG,iBAAiB;CACpB,GAAG,iBAAiB;CACrB;AAED,MAAa,yBAGR;CACH;EAAE,OAAO;EAAQ,OAAO;EAAM;CAC9B;EAAE,OAAO;EAAa,OAAO;EAAa;CAC1C;EAAE,OAAO;EAAW,OAAO;EAAW;CACvC;AAED,MAAa,yBAAyB;;AAGtC,SAAgB,mBAAmB,OAAkC;AACnE,QACE,OAAO,UAAU,YACjB,oBAAoB,MAAM,YAAY,YAAY,MAAM;;;AAK5D,SAAgB,gBAAgB,KAAoC;AAClE,MAAK,MAAM,SAAS,OAAO,KAAK,iBAAiB,CAC/C,KAAI,iBAAiB,OAAO,MAAM,YAAY,YAAY,IAAI,CAC5D,QAAO;AAIX,QAAO;;;AAIT,SAAgB,kBAAkB,MAGtB;AACV,QAAO,KAAK,cAAc,KAAK,QAAQ"}

package/dist/lib/inspector-nav.d.cts

@@ -0,0 +1,11 @@
+//#region src/lib/inspector-nav.d.ts
+declare const INSPECTOR_GROUPS: {
+  readonly home: readonly ["home", "whats-new"];
+  readonly workbench: readonly ["playground", "threads", "memories"];
+  readonly inspect: readonly ["agents", "ag-ui-events", "event-snippets", "frontend-tools", "capabilities", "agent-context"];
+};
+type InspectorNavGroupKey = keyof typeof INSPECTOR_GROUPS;
+type MenuKey = (typeof INSPECTOR_GROUPS)[InspectorNavGroupKey][number];
+//#endregion
+export { MenuKey };
+//# sourceMappingURL=inspector-nav.d.cts.map

package/dist/lib/inspector-nav.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector-nav.d.cts","names":[],"sources":["../../src/lib/inspector-nav.ts"],"mappings":";cAIa,gBAAA;EAAA;;;;KAaD,oBAAA,gBAAoC,gBAAA;AAAA,KACpC,OAAA,WAAkB,gBAAA,EAAkB,oBAAA"}

package/dist/lib/inspector-nav.d.mts

@@ -0,0 +1,11 @@
+//#region src/lib/inspector-nav.d.ts
+declare const INSPECTOR_GROUPS: {
+  readonly home: readonly ["home", "whats-new"];
+  readonly workbench: readonly ["playground", "threads", "memories"];
+  readonly inspect: readonly ["agents", "ag-ui-events", "event-snippets", "frontend-tools", "capabilities", "agent-context"];
+};
+type InspectorNavGroupKey = keyof typeof INSPECTOR_GROUPS;
+type MenuKey = (typeof INSPECTOR_GROUPS)[InspectorNavGroupKey][number];
+//#endregion
+export { MenuKey };
+//# sourceMappingURL=inspector-nav.d.mts.map

package/dist/lib/inspector-nav.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector-nav.d.mts","names":[],"sources":["../../src/lib/inspector-nav.ts"],"mappings":";cAIa,gBAAA;EAAA;;;;KAaD,oBAAA,gBAAoC,gBAAA;AAAA,KACpC,OAAA,WAAkB,gBAAA,EAAkB,oBAAA"}

package/dist/lib/inspector-nav.mjs

@@ -0,0 +1,54 @@
+//#region src/lib/inspector-nav.ts
+const INSPECTOR_GROUPS = {
+	home: ["home", "whats-new"],
+	workbench: [
+		"playground",
+		"threads",
+		"memories"
+	],
+	inspect: [
+		"agents",
+		"ag-ui-events",
+		"event-snippets",
+		"frontend-tools",
+		"capabilities",
+		"agent-context"
+	]
+};
+const INSPECTOR_MENU_KEYS = [
+	...INSPECTOR_GROUPS.home,
+	...INSPECTOR_GROUPS.workbench,
+	...INSPECTOR_GROUPS.inspect
+];
+const INSPECTOR_NAV_SECTIONS = [
+	{
+		group: "home",
+		label: null
+	},
+	{
+		group: "workbench",
+		label: "Workbench"
+	},
+	{
+		group: "inspect",
+		label: "Inspect"
+	}
+];
+const ICON_RAIL_MAX_WIDTH_PX = 720;
+/** Return whether persisted state names a known Inspector leaf. */
+function isInspectorMenuKey(value) {
+	return typeof value === "string" && INSPECTOR_MENU_KEYS.some((menuKey) => menuKey === value);
+}
+/** Return the sidebar group that owns a leaf. */
+function getGroupForMenu(key) {
+	for (const group of Object.keys(INSPECTOR_GROUPS)) if (INSPECTOR_GROUPS[group].some((menuKey) => menuKey === key)) return group;
+	return "workbench";
+}
+/** Return whether the sidebar should collapse to an icon rail. */
+function shouldUseIconRail(args) {
+	return args.dockedLeft || args.width < ICON_RAIL_MAX_WIDTH_PX;
+}
+
+//#endregion
+export { INSPECTOR_GROUPS, INSPECTOR_NAV_SECTIONS, getGroupForMenu, isInspectorMenuKey, shouldUseIconRail };
+//# sourceMappingURL=inspector-nav.mjs.map

package/dist/lib/inspector-nav.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector-nav.mjs","names":[],"sources":["../../src/lib/inspector-nav.ts"],"sourcesContent":["import type { InspectorLeafKey } from \"./telemetry.js\";\n\nexport type ShellGroupKey = \"home\" | \"workbench\" | \"inspect\";\n\nexport const INSPECTOR_GROUPS = {\n  home: [\"home\", \"whats-new\"],\n  workbench: [\"playground\", \"threads\", \"memories\"],\n  inspect: [\n    \"agents\",\n    \"ag-ui-events\",\n    \"event-snippets\",\n    \"frontend-tools\",\n    \"capabilities\",\n    \"agent-context\",\n  ],\n} as const satisfies Record<ShellGroupKey, readonly InspectorLeafKey[]>;\n\nexport type InspectorNavGroupKey = keyof typeof INSPECTOR_GROUPS;\nexport type MenuKey = (typeof INSPECTOR_GROUPS)[InspectorNavGroupKey][number];\n\nexport const INSPECTOR_MENU_KEYS: ReadonlyArray<MenuKey> = [\n  ...INSPECTOR_GROUPS.home,\n  ...INSPECTOR_GROUPS.workbench,\n  ...INSPECTOR_GROUPS.inspect,\n];\n\nexport const INSPECTOR_NAV_SECTIONS: ReadonlyArray<{\n  group: InspectorNavGroupKey;\n  label: string | null;\n}> = [\n  { group: \"home\", label: null },\n  { group: \"workbench\", label: \"Workbench\" },\n  { group: \"inspect\", label: \"Inspect\" },\n];\n\nexport const ICON_RAIL_MAX_WIDTH_PX = 720;\n\n/** Return whether persisted state names a known Inspector leaf. */\nexport function isInspectorMenuKey(value: unknown): value is MenuKey {\n  return (\n    typeof value === \"string\" &&\n    INSPECTOR_MENU_KEYS.some((menuKey) => menuKey === value)\n  );\n}\n\n/** Return the sidebar group that owns a leaf. */\nexport function getGroupForMenu(key: MenuKey): InspectorNavGroupKey {\n  for (const group of Object.keys(INSPECTOR_GROUPS) as InspectorNavGroupKey[]) {\n    if (INSPECTOR_GROUPS[group].some((menuKey) => menuKey === key)) {\n      return group;\n    }\n  }\n\n  return \"workbench\";\n}\n\n/** Return whether the sidebar should collapse to an icon rail. */\nexport function shouldUseIconRail(args: {\n  dockedLeft: boolean;\n  width: number;\n}): boolean {\n  return args.dockedLeft || args.width < ICON_RAIL_MAX_WIDTH_PX;\n}\n"],"mappings":";AAIA,MAAa,mBAAmB;CAC9B,MAAM,CAAC,QAAQ,YAAY;CAC3B,WAAW;EAAC;EAAc;EAAW;EAAW;CAChD,SAAS;EACP;EACA;EACA;EACA;EACA;EACA;EACD;CACF;AAKD,MAAa,sBAA8C;CACzD,GAAG,iBAAiB;CACpB,GAAG,iBAAiB;CACpB,GAAG,iBAAiB;CACrB;AAED,MAAa,yBAGR;CACH;EAAE,OAAO;EAAQ,OAAO;EAAM;CAC9B;EAAE,OAAO;EAAa,OAAO;EAAa;CAC1C;EAAE,OAAO;EAAW,OAAO;EAAW;CACvC;AAED,MAAa,yBAAyB;;AAGtC,SAAgB,mBAAmB,OAAkC;AACnE,QACE,OAAO,UAAU,YACjB,oBAAoB,MAAM,YAAY,YAAY,MAAM;;;AAK5D,SAAgB,gBAAgB,KAAoC;AAClE,MAAK,MAAM,SAAS,OAAO,KAAK,iBAAiB,CAC/C,KAAI,iBAAiB,OAAO,MAAM,YAAY,YAAY,IAAI,CAC5D,QAAO;AAIX,QAAO;;;AAIT,SAAgB,kBAAkB,MAGtB;AACV,QAAO,KAAK,cAAc,KAAK,QAAQ"}

package/dist/lib/persistence.cjs

@@ -51,6 +51,103 @@ function isFiniteNumber(value) {
 function isValidDockMode(value) {
 	return value === "floating" || value === "docked-left";
 }
+const ANNOUNCEMENT_READ_COOKIE_NAME = "cpk_inspector_announcements";
+const ANNOUNCEMENT_READ_MIRROR_KEY = "cpk:inspector:announcement_read";
+const LEGACY_ANNOUNCEMENT_READ_KEY = "cpk:inspector:announcements";
+const ANNOUNCEMENT_PULSED_SESSION_KEY = "cpk:inspector:pulsed";
+const ANNOUNCEMENT_READ_COOKIE_MAX_AGE_SECONDS = 3600 * 24 * 365;
+/**
+* The announcement timestamp the user has already read, or `null` when
+* nothing has been read yet. Prefers the host-scoped cookie and falls back to
+* the origin-scoped mirror, so cookie-blocking browsers still remember the
+* read within the port they are on.
+*/
+function loadAnnouncementReadTimestamp() {
+	return parseTimestampPayload(readAnnouncementCookie()) ?? parseTimestampPayload(readLocalStorageItem(ANNOUNCEMENT_READ_MIRROR_KEY));
+}
+/**
+* Records an announcement as read in both the host-scoped cookie and the
+* origin-scoped mirror. The stored value is `{"timestamp":"…"}` — the same
+* shape the announcement state has always used.
+*/
+function saveAnnouncementReadTimestamp(timestamp) {
+	const payload = JSON.stringify({ timestamp });
+	writeAnnouncementCookie(payload);
+	writeLocalStorageItem(ANNOUNCEMENT_READ_MIRROR_KEY, payload);
+}
+/**
+* Deletes the superseded origin-scoped read state. Safe to call on every
+* startup: nothing writes that key any more, so the value cannot come back.
+*/
+function clearLegacyAnnouncementReadState() {
+	removeLocalStorageItem(LEGACY_ANNOUNCEMENT_READ_KEY);
+}
+/**
+* The announcement timestamp this browser tab has already pulsed for, or
+* `null` when it hasn't pulsed yet.
+*/
+function loadAnnouncementPulsedTimestamp() {
+	if (typeof window === "undefined") return null;
+	try {
+		return window.sessionStorage.getItem(ANNOUNCEMENT_PULSED_SESSION_KEY);
+	} catch {
+		return null;
+	}
+}
+/** Suppresses further pulses for this announcement in this browser tab. */
+function saveAnnouncementPulsedTimestamp(timestamp) {
+	if (typeof window === "undefined") return;
+	try {
+		window.sessionStorage.setItem(ANNOUNCEMENT_PULSED_SESSION_KEY, timestamp);
+	} catch {}
+}
+function parseTimestampPayload(raw) {
+	if (!raw) return null;
+	try {
+		const parsed = JSON.parse(raw);
+		return typeof parsed?.timestamp === "string" ? parsed.timestamp : null;
+	} catch {
+		return null;
+	}
+}
+function readAnnouncementCookie() {
+	if (typeof document === "undefined") return null;
+	try {
+		for (const entry of document.cookie.split(";")) {
+			const separator = entry.indexOf("=");
+			if (separator === -1) continue;
+			if (entry.slice(0, separator).trim() !== ANNOUNCEMENT_READ_COOKIE_NAME) continue;
+			return decodeURIComponent(entry.slice(separator + 1).trim());
+		}
+	} catch {}
+	return null;
+}
+function writeAnnouncementCookie(value) {
+	if (typeof document === "undefined") return;
+	try {
+		document.cookie = `${ANNOUNCEMENT_READ_COOKIE_NAME}=${encodeURIComponent(value)}; Path=/; Max-Age=${ANNOUNCEMENT_READ_COOKIE_MAX_AGE_SECONDS}; SameSite=Lax`;
+	} catch {}
+}
+function readLocalStorageItem(key) {
+	if (typeof window === "undefined") return null;
+	try {
+		return window.localStorage.getItem(key);
+	} catch {
+		return null;
+	}
+}
+function writeLocalStorageItem(key, value) {
+	if (typeof window === "undefined") return;
+	try {
+		window.localStorage.setItem(key, value);
+	} catch {}
+}
+function removeLocalStorageItem(key) {
+	if (typeof window === "undefined") return;
+	try {
+		window.localStorage.removeItem(key);
+	} catch {}
+}
 const TELEMETRY_DISTINCT_ID_KEY = "cpk:inspector:telemetry:distinct_id";
 const TELEMETRY_OPT_OUT_KEY = "cpk:inspector:telemetry:opt_out";
 const TELEMETRY_DISCLOSURE_SHOWN_KEY = "cpk:inspector:telemetry:disclosure_shown";
@@ -98,6 +195,7 @@ function generateUuidV4() {
 }
 
 //#endregion
+exports.clearLegacyAnnouncementReadState = clearLegacyAnnouncementReadState;
 exports.getOrCreateTelemetryDistinctId = getOrCreateTelemetryDistinctId;
 exports.hasTelemetryDisclosureBeenShown = hasTelemetryDisclosureBeenShown;
 exports.isTelemetryOptedOut = isTelemetryOptedOut;
@@ -105,7 +203,11 @@ exports.isValidAnchor = isValidAnchor;
 exports.isValidDockMode = isValidDockMode;
 exports.isValidPosition = isValidPosition;
 exports.isValidSize = isValidSize;
+exports.loadAnnouncementPulsedTimestamp = loadAnnouncementPulsedTimestamp;
+exports.loadAnnouncementReadTimestamp = loadAnnouncementReadTimestamp;
 exports.loadInspectorState = loadInspectorState;
 exports.markTelemetryDisclosureShown = markTelemetryDisclosureShown;
+exports.saveAnnouncementPulsedTimestamp = saveAnnouncementPulsedTimestamp;
+exports.saveAnnouncementReadTimestamp = saveAnnouncementReadTimestamp;
 exports.saveInspectorState = saveInspectorState;
 //# sourceMappingURL=persistence.cjs.map