@copilotkit/web-inspector 1.68.3-canary.1787220377 → 1.69.0

package/dist/lib/home-briefing.cjs

@@ -0,0 +1,270 @@
+
+//#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
+	};
+}
+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
+	};
+	return {
+		state: input.runtimeConnectionState === "error" ? "error" : "offline",
+		label: input.runtimeConnectionState === "error" ? "Runtime error" : "Offline",
+		runtime: {
+			label: "Offline",
+			tone: "error"
+		},
+		liveUpdates: {
+			label: input.runtimeConnectionState === "error" ? "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
+exports.buildHomeModel = buildHomeModel;
+//# sourceMappingURL=home-briefing.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"home-briefing.cjs","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\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  return {\n    state: input.runtimeConnectionState === \"error\" ? \"error\" : \"offline\",\n    label:\n      input.runtimeConnectionState === \"error\" ? \"Runtime error\" : \"Offline\",\n    runtime: { label: \"Offline\", tone: \"error\" },\n    liveUpdates: {\n      label:\n        input.runtimeConnectionState === \"error\" ? \"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":";;AAoHA,MAAM,mBAAkD;CACtD,SAAS;CACT,QAAQ;CACR,MAAM;CACN,eAAe;CACf,aAAa;CACb,OAAO;CACP,WAAW;CACZ;;AAGD,SAAgB,2BAA2B,QAGxB;AACjB,KAAI,OAAO,SAAS,cAClB,QAAO;EAAE,MAAM,OAAO;EAAM,KAAK,OAAO;EAAK,OAAO;EAAe;AAGrE,KAAI,OAAO,SAAS,QAClB,QAAO;EAAE,MAAM,OAAO;EAAM,KAAK,OAAO;EAAK,OAAO;EAAc;AAGpE,QAAO;EACL,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,OAAO;EACR;;;AAIH,SAAgB,oBAAoB,UAAkB,YAAY,KAAa;CAC7E,MAAM,QAAQ,SACX,QAAQ,0BAA0B,KAAK,CACvC,QAAQ,WAAW,GAAG,CACtB,QAAQ,QAAQ,IAAI,CACpB,MAAM;AACT,KAAI,MAAM,UAAU,UAClB,QAAO;AAGT,QAAO,GAAG,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC;;AAGhD,SAAS,0BACP,QACA,YACA,cAC4B;AAC5B,KAAI,OACF,QAAO;AAGT,KAAI,eAAe,iBAAiB,UAAU,iBAAiB,WAC7D,QAAO,2BAA2B;EAChC,MAAM;EACN,KAAK;EACN,CAAC;;AAMN,SAAS,aAAa,MAKA;AACpB,KAAI,CAAC,KAAK,WAAW;EACnB,MAAM,WAAW,KAAK,QAAQ,SAAS;AACvC,SAAO;GACL,YAAY;GACZ,OAAO,WAAW,uBAAuB;GACzC,MAAM,WACF,iEACA;GACJ,QAAQ,0BACN,KAAK,QACL,KAAK,YACL,KAAK,aACN;GACF;;AAGH,QAAO;EACL,YAAY;EACZ,OAAO;EACP,MAAM;EACN,QACE,KAAK,QAAQ,SAAS,wBAAwB,SAAY,KAAK;EAClE;;AAGH,SAAS,kBAAkB,UAMb;CACZ,MAAM,QAAQ,SAAS;AACvB,KAAI,CAAC,MACH;AAGF,KAAI,MAAM,MAAM,SAAS,SACvB,QAAO;EACL,MAAM,MAAM;EACZ,YAAY,GAAG,MAAM,KAAK,KAAK,MAAM,MAAM;EAC3C,OAAO,MAAM,MAAM,UAAU,IAAI,IAAI,MAAM,OAAO,MAAM,MAAM;EAC/D;AAGH,KAAI,MAAM,MAAM,SAAS,YACvB,QAAO;EACL,MAAM,MAAM;EACZ,YAAY,GAAG,MAAM,KAAK;EAC3B;AAGH,QAAO;EACL,MAAM,MAAM;EACZ,YAAY,GAAG,MAAM,KAAK;EAC3B;;AAGH,SAAS,qBAAqB,MAIR;CACpB,MAAM,WAAW,KAAK,UAAU,MAAM;AACtC,KAAI,YAAY,KAAK,KAEnB,QAAO;EACL,OAFc,SAAS,MAAM,mBAAmB,GAAG,IAAI,MAAM,IAE3C;EAClB,aACE,KAAK,aAAa,MAAM,IAAI,oBAAoB,UAAU,IAAI;EAChE,cAAc,KAAK;EACnB,OAAO;EACR;AAGH,QAAO;EACL,OAAO;EACP,aAAa;EACb,OAAO;EACR;;AAGH,SAAS,mBACP,OAC6C;AAC7C,KAAI,CAAC,MACH,QAAO;EAAE,OAAO;EAAiB,MAAM;EAAS;CAGlD,MAAM,eAAe;EACnB,IAAI,MAAM;EACV,SAAS,MAAM;EACf,MAAM,MAAM;EACZ,WAAW,MAAM;EAClB;AAED,KAAI,MAAM,SAAS,eAAe,MAAM,SAAS,QAC/C,QAAO;EACL,OAAO,MAAM,SAAS,cAAc,cAAc;EAClD,MAAM;EACN,GAAG;EACJ;AAGH,KAAI,MAAM,SAAS,eACjB,QAAO;EACL,OAAO;EACP,MAAM;EACN,GAAG;EACJ;AAGH,KACE,MAAM,KAAK,SAAS,SAAS,IAC7B,MAAM,KAAK,SAAS,WAAW,IAC/B,MAAM,KAAK,SAAS,WAAW,IAC/B,MAAM,KAAK,SAAS,QAAQ,IAC5B,MAAM,KAAK,SAAS,SAAS,CAE7B,QAAO;EACL,OAAO;EACP,MAAM;EACN,GAAG;EACJ;AAGH,QAAO;EACL,OAAO;EACP,MAAM;EACN,GAAG;EACJ;;AAGH,SAAS,uBACP,OACgC;CAChC,MAAM,YAAY,mBAAmB,MAAM,iBAAiB;AAE5D,KAAI,MAAM,2BAA2B,YACnC,QAAO;EACL,OAAO,UAAU,SAAS,UAAU,UAAU;EAC9C,OAAO,UAAU,SAAS,UAAU,oBAAoB;EACxD,SAAS;GAAE,OAAO;GAAa,MAAM;GAAW;EAChD,aAAa;GAAE,OAAO;GAAS,MAAM;GAAW;EAChD;EACD;AAGH,KAAI,MAAM,2BAA2B,aACnC,QAAO;EACL,OAAO;EACP,OAAO;EACP,SAAS;GAAE,OAAO;GAAY,MAAM;GAAU;EAC9C,aAAa;GAAE,OAAO;GAAc,MAAM;GAAU;EACpD;EACD;AAGH,KAAI,MAAM,2BAA2B,cACnC,QAAO;EACL,OAAO;EACP,OAAO;EACP,SAAS;GAAE,OAAO;GAAe,MAAM;GAAS;EAChD,aAAa;GAAE,OAAO;GAAgB,MAAM;GAAS;EACrD;EACD;AAGH,QAAO;EACL,OAAO,MAAM,2BAA2B,UAAU,UAAU;EAC5D,OACE,MAAM,2BAA2B,UAAU,kBAAkB;EAC/D,SAAS;GAAE,OAAO;GAAW,MAAM;GAAS;EAC5C,aAAa;GACX,OACE,MAAM,2BAA2B,UAAU,UAAU;GACvD,MAAM;GACP;EACD;EACD;;;AAIH,SAAgB,eAAe,OAAqC;CAClE,MAAM,iBACJ,MAAM,SAAS,uBAAuB,MAAM,SAAS;CACvD,MAAM,SAAS,iBACX,2BAA2B;EACzB,MAAM,eAAe;EACrB,KAAK,eAAe;EACrB,CAAC,GACF;CAEJ,MAAM,WAAW,MAAM,SAAS;CAChC,MAAM,gBAAgB,QAAQ,SAAS;CACvC,MAAM,wBACJ,MAAM,SAAS,iBAAiB,WAC/B,MAAM,SAAS,iBAAiB,aAAa,MAAM;CACtD,MAAM,QAAQ,kBAAkB,MAAM,SAAS;AAE/C,QAAO;EACL,MAAM,aAAa;GACjB,WAAW;GACX;GACA,YAAY,MAAM;GAClB,cAAc,MAAM,SAAS;GAC9B,CAAC;EACF;EACA,SAAS,WACL;GACE,kBAAkB,SAAS;GAC3B,aAAa,SAAS;GACtB,WAAW,MAAM,SAAS,MAAM;GAChC,SAAS,MAAM,SAAS;GACxB;GACD,GACD,MAAM,SAAS,QAAQ,QACrB;GACE,kBAAkB;GAClB,aAAa;GACb,WAAW,MAAM,SAAS,MAAM;GAChC,SAAS,MAAM,SAAS;GACxB;GACD,GACD;EACN,SAAS;GACP,KAAK,MAAM;GACX,QAAQ,uBAAuB,MAAM;GACtC;EACD,UAAU;GACR;IACE,IAAI;IACJ,OAAO;IACP,SAAS,yBAAyB,MAAM;IACxC,KAAK,MAAM;IACX,SAAS,iBAAiB;IAC3B;GACD;IACE,IAAI;IACJ,OAAO;IACP,SAAS,yBAAyB,MAAM;IACxC,SAAS,iBAAiB;IAC3B;GACD;IACE,IAAI;IACJ,OAAO;IACP,SAAS,MAAM;IACf,SAAS,iBAAiB;IAC3B;GACD;IACE,IAAI;IACJ,OAAO;IACP,SAAS,MAAM;IACf,SAAS,iBAAiB;IAC3B;GACD;IACE,IAAI;IACJ,OAAO;IACP,SAAS,MAAM;IACf,SAAS,iBAAiB;IAC3B;GACD;IACE,IAAI;IACJ,OAAO;IACP,SAAS,MAAM;IACf,SAAS,iBAAiB;IAC3B;GACD;IACE,IAAI;IACJ,OAAO;IACP,SAAS,yBAAyB,QAAQ,MAAM,aAAa;IAC7D,KAAK,MAAM;IACX,SAAS,iBAAiB;IAC3B;GACF;EACD,MAAM,qBAAqB;GACzB,aAAa,MAAM;GACnB,UAAU,MAAM;GAChB,MAAM,MAAM,oBAAoB;GACjC,CAAC;EACH"}

package/dist/lib/home-briefing.mjs

@@ -0,0 +1,269 @@
+//#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
+	};
+}
+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
+	};
+	return {
+		state: input.runtimeConnectionState === "error" ? "error" : "offline",
+		label: input.runtimeConnectionState === "error" ? "Runtime error" : "Offline",
+		runtime: {
+			label: "Offline",
+			tone: "error"
+		},
+		liveUpdates: {
+			label: input.runtimeConnectionState === "error" ? "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 };
+//# 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\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  return {\n    state: input.runtimeConnectionState === \"error\" ? \"error\" : \"offline\",\n    label:\n      input.runtimeConnectionState === \"error\" ? \"Runtime error\" : \"Offline\",\n    runtime: { label: \"Offline\", tone: \"error\" },\n    liveUpdates: {\n      label:\n        input.runtimeConnectionState === \"error\" ? \"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":";AAoHA,MAAM,mBAAkD;CACtD,SAAS;CACT,QAAQ;CACR,MAAM;CACN,eAAe;CACf,aAAa;CACb,OAAO;CACP,WAAW;CACZ;;AAGD,SAAgB,2BAA2B,QAGxB;AACjB,KAAI,OAAO,SAAS,cAClB,QAAO;EAAE,MAAM,OAAO;EAAM,KAAK,OAAO;EAAK,OAAO;EAAe;AAGrE,KAAI,OAAO,SAAS,QAClB,QAAO;EAAE,MAAM,OAAO;EAAM,KAAK,OAAO;EAAK,OAAO;EAAc;AAGpE,QAAO;EACL,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,OAAO;EACR;;;AAIH,SAAgB,oBAAoB,UAAkB,YAAY,KAAa;CAC7E,MAAM,QAAQ,SACX,QAAQ,0BAA0B,KAAK,CACvC,QAAQ,WAAW,GAAG,CACtB,QAAQ,QAAQ,IAAI,CACpB,MAAM;AACT,KAAI,MAAM,UAAU,UAClB,QAAO;AAGT,QAAO,GAAG,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC;;AAGhD,SAAS,0BACP,QACA,YACA,cAC4B;AAC5B,KAAI,OACF,QAAO;AAGT,KAAI,eAAe,iBAAiB,UAAU,iBAAiB,WAC7D,QAAO,2BAA2B;EAChC,MAAM;EACN,KAAK;EACN,CAAC;;AAMN,SAAS,aAAa,MAKA;AACpB,KAAI,CAAC,KAAK,WAAW;EACnB,MAAM,WAAW,KAAK,QAAQ,SAAS;AACvC,SAAO;GACL,YAAY;GACZ,OAAO,WAAW,uBAAuB;GACzC,MAAM,WACF,iEACA;GACJ,QAAQ,0BACN,KAAK,QACL,KAAK,YACL,KAAK,aACN;GACF;;AAGH,QAAO;EACL,YAAY;EACZ,OAAO;EACP,MAAM;EACN,QACE,KAAK,QAAQ,SAAS,wBAAwB,SAAY,KAAK;EAClE;;AAGH,SAAS,kBAAkB,UAMb;CACZ,MAAM,QAAQ,SAAS;AACvB,KAAI,CAAC,MACH;AAGF,KAAI,MAAM,MAAM,SAAS,SACvB,QAAO;EACL,MAAM,MAAM;EACZ,YAAY,GAAG,MAAM,KAAK,KAAK,MAAM,MAAM;EAC3C,OAAO,MAAM,MAAM,UAAU,IAAI,IAAI,MAAM,OAAO,MAAM,MAAM;EAC/D;AAGH,KAAI,MAAM,MAAM,SAAS,YACvB,QAAO;EACL,MAAM,MAAM;EACZ,YAAY,GAAG,MAAM,KAAK;EAC3B;AAGH,QAAO;EACL,MAAM,MAAM;EACZ,YAAY,GAAG,MAAM,KAAK;EAC3B;;AAGH,SAAS,qBAAqB,MAIR;CACpB,MAAM,WAAW,KAAK,UAAU,MAAM;AACtC,KAAI,YAAY,KAAK,KAEnB,QAAO;EACL,OAFc,SAAS,MAAM,mBAAmB,GAAG,IAAI,MAAM,IAE3C;EAClB,aACE,KAAK,aAAa,MAAM,IAAI,oBAAoB,UAAU,IAAI;EAChE,cAAc,KAAK;EACnB,OAAO;EACR;AAGH,QAAO;EACL,OAAO;EACP,aAAa;EACb,OAAO;EACR;;AAGH,SAAS,mBACP,OAC6C;AAC7C,KAAI,CAAC,MACH,QAAO;EAAE,OAAO;EAAiB,MAAM;EAAS;CAGlD,MAAM,eAAe;EACnB,IAAI,MAAM;EACV,SAAS,MAAM;EACf,MAAM,MAAM;EACZ,WAAW,MAAM;EAClB;AAED,KAAI,MAAM,SAAS,eAAe,MAAM,SAAS,QAC/C,QAAO;EACL,OAAO,MAAM,SAAS,cAAc,cAAc;EAClD,MAAM;EACN,GAAG;EACJ;AAGH,KAAI,MAAM,SAAS,eACjB,QAAO;EACL,OAAO;EACP,MAAM;EACN,GAAG;EACJ;AAGH,KACE,MAAM,KAAK,SAAS,SAAS,IAC7B,MAAM,KAAK,SAAS,WAAW,IAC/B,MAAM,KAAK,SAAS,WAAW,IAC/B,MAAM,KAAK,SAAS,QAAQ,IAC5B,MAAM,KAAK,SAAS,SAAS,CAE7B,QAAO;EACL,OAAO;EACP,MAAM;EACN,GAAG;EACJ;AAGH,QAAO;EACL,OAAO;EACP,MAAM;EACN,GAAG;EACJ;;AAGH,SAAS,uBACP,OACgC;CAChC,MAAM,YAAY,mBAAmB,MAAM,iBAAiB;AAE5D,KAAI,MAAM,2BAA2B,YACnC,QAAO;EACL,OAAO,UAAU,SAAS,UAAU,UAAU;EAC9C,OAAO,UAAU,SAAS,UAAU,oBAAoB;EACxD,SAAS;GAAE,OAAO;GAAa,MAAM;GAAW;EAChD,aAAa;GAAE,OAAO;GAAS,MAAM;GAAW;EAChD;EACD;AAGH,KAAI,MAAM,2BAA2B,aACnC,QAAO;EACL,OAAO;EACP,OAAO;EACP,SAAS;GAAE,OAAO;GAAY,MAAM;GAAU;EAC9C,aAAa;GAAE,OAAO;GAAc,MAAM;GAAU;EACpD;EACD;AAGH,KAAI,MAAM,2BAA2B,cACnC,QAAO;EACL,OAAO;EACP,OAAO;EACP,SAAS;GAAE,OAAO;GAAe,MAAM;GAAS;EAChD,aAAa;GAAE,OAAO;GAAgB,MAAM;GAAS;EACrD;EACD;AAGH,QAAO;EACL,OAAO,MAAM,2BAA2B,UAAU,UAAU;EAC5D,OACE,MAAM,2BAA2B,UAAU,kBAAkB;EAC/D,SAAS;GAAE,OAAO;GAAW,MAAM;GAAS;EAC5C,aAAa;GACX,OACE,MAAM,2BAA2B,UAAU,UAAU;GACvD,MAAM;GACP;EACD;EACD;;;AAIH,SAAgB,eAAe,OAAqC;CAClE,MAAM,iBACJ,MAAM,SAAS,uBAAuB,MAAM,SAAS;CACvD,MAAM,SAAS,iBACX,2BAA2B;EACzB,MAAM,eAAe;EACrB,KAAK,eAAe;EACrB,CAAC,GACF;CAEJ,MAAM,WAAW,MAAM,SAAS;CAChC,MAAM,gBAAgB,QAAQ,SAAS;CACvC,MAAM,wBACJ,MAAM,SAAS,iBAAiB,WAC/B,MAAM,SAAS,iBAAiB,aAAa,MAAM;CACtD,MAAM,QAAQ,kBAAkB,MAAM,SAAS;AAE/C,QAAO;EACL,MAAM,aAAa;GACjB,WAAW;GACX;GACA,YAAY,MAAM;GAClB,cAAc,MAAM,SAAS;GAC9B,CAAC;EACF;EACA,SAAS,WACL;GACE,kBAAkB,SAAS;GAC3B,aAAa,SAAS;GACtB,WAAW,MAAM,SAAS,MAAM;GAChC,SAAS,MAAM,SAAS;GACxB;GACD,GACD,MAAM,SAAS,QAAQ,QACrB;GACE,kBAAkB;GAClB,aAAa;GACb,WAAW,MAAM,SAAS,MAAM;GAChC,SAAS,MAAM,SAAS;GACxB;GACD,GACD;EACN,SAAS;GACP,KAAK,MAAM;GACX,QAAQ,uBAAuB,MAAM;GACtC;EACD,UAAU;GACR;IACE,IAAI;IACJ,OAAO;IACP,SAAS,yBAAyB,MAAM;IACxC,KAAK,MAAM;IACX,SAAS,iBAAiB;IAC3B;GACD;IACE,IAAI;IACJ,OAAO;IACP,SAAS,yBAAyB,MAAM;IACxC,SAAS,iBAAiB;IAC3B;GACD;IACE,IAAI;IACJ,OAAO;IACP,SAAS,MAAM;IACf,SAAS,iBAAiB;IAC3B;GACD;IACE,IAAI;IACJ,OAAO;IACP,SAAS,MAAM;IACf,SAAS,iBAAiB;IAC3B;GACD;IACE,IAAI;IACJ,OAAO;IACP,SAAS,MAAM;IACf,SAAS,iBAAiB;IAC3B;GACD;IACE,IAAI;IACJ,OAAO;IACP,SAAS,MAAM;IACf,SAAS,iBAAiB;IAC3B;GACD;IACE,IAAI;IACJ,OAAO;IACP,SAAS,yBAAyB,QAAQ,MAAM,aAAa;IAC7D,KAAK,MAAM;IACX,SAAS,iBAAiB;IAC3B;GACF;EACD,MAAM,qBAAqB;GACzB,aAAa,MAAM;GACnB,UAAU,MAAM;GAChB,MAAM,MAAM,oBAAoB;GACjC,CAAC;EACH"}

package/dist/lib/inspector-nav.cjs

@@ -0,0 +1,58 @@
+
+//#region src/lib/inspector-nav.ts
+const INSPECTOR_GROUPS = {
+	home: ["home", "whats-new"],
+	workbench: [
+		"playground",
+		"threads",
+		"memories"
+	],
+	inspect: [
+		"agents",
+		"ag-ui-events",
+		"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