@copilotkit/web-inspector 1.69.3 → 1.70.1

package/dist/lib/home-briefing.cjs

@@ -1,13 +1,26 @@
 
 //#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/premium/intelligence-platform",
+	memory: "https://docs.copilotkit.ai/intelligence/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",
+	suggestions: "https://docs.copilotkit.ai/reference/hooks/useConfigureSuggestions",
 	audio: "https://docs.copilotkit.ai/voice",
-	websocket: "https://docs.copilotkit.ai/premium/intelligence-platform"
+	websocket: "https://docs.copilotkit.ai/intelligence/intelligence-platform"
 };
 /** Return the Home hero button for a trusted metadata action. */
 function homeHeroActionFromMetadata(action) {
@@ -45,8 +58,8 @@ function heroForState(args) {
 		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.",
+			title: renewing ? "Renew Intelligence" : "CopilotKit Intelligence",
+			body: renewing ? "Renew Intelligence to restore persistent Threads and Memory." : "Intelligence keeps every thread your users have, finds evidence-backed patterns in them, and proposes skills you approve before your agent uses them.",
 			action: connectIntelligenceAction(args.action, args.connectUrl, args.licenseState)
 		};
 	}
@@ -240,7 +253,7 @@ function buildHomeModel(input) {
 			},
 			{
 				id: "memory",
-				label: "Memory",
+				label: "Learning",
 				enabled: intelligenceConnected && input.memoriesOn,
 				docsUrl: SERVICE_DOCS_URL.memory
 			},
@@ -264,7 +277,7 @@ function buildHomeModel(input) {
 			},
 			{
 				id: "audio",
-				label: "Audio",
+				label: "Voice",
 				enabled: input.audioOn,
 				docsUrl: SERVICE_DOCS_URL.audio
 			},
@@ -286,5 +299,6 @@ function buildHomeModel(input) {
 
 //#endregion
 exports.buildHomeModel = buildHomeModel;
+exports.homeFeatureImplementationPrompt = homeFeatureImplementationPrompt;
 exports.runtimeConnectionNeedsAttention = runtimeConnectionNeedsAttention;
 //# sourceMappingURL=home-briefing.cjs.map

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

@@ -1 +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\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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"}
+{"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 HomeFeatureImplementationPromptContext = {\n  onboardingRunId: string;\n};\n\n/**\n * A self-contained handoff for a coding agent. It answers the onboarding\n * workflow's session and feedback consent gates up front, while keeping the\n * feature guide—not a generic product-onboarding branch—in control of the\n * implementation plan.\n */\nexport function homeFeatureImplementationPrompt(\n  service: Pick<HomeServiceTile, \"label\" | \"docsUrl\">,\n  context: HomeFeatureImplementationPromptContext,\n): string {\n  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.\n\nThis 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.\n\nImplement 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.`;\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/intelligence/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:\n    \"https://docs.copilotkit.ai/reference/hooks/useConfigureSuggestions\",\n  audio: \"https://docs.copilotkit.ai/voice\",\n  websocket: \"https://docs.copilotkit.ai/intelligence/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      // Not \"Intelligence is not setup\" — that reads as a defect in the tool,\n      // and a defect gets dismissed. The heading names the product; the\n      // argument for it is made by the rotating copy on Home, which changes\n      // with the picture beside it.\n      title: renewing ? \"Renew Intelligence\" : \"CopilotKit Intelligence\",\n      // In install mode this is NOT the visible paragraph. The visible copy\n      // rotates every few seconds, which would make a screen reader announce a\n      // new sentence four times a loop, so the rotating text is hidden from\n      // assistive tech and this one stable sentence is exposed instead. It has\n      // to carry the whole chain on its own.\n      body: renewing\n        ? \"Renew Intelligence to restore persistent Threads and Memory.\"\n        : \"Intelligence keeps every thread your users have, finds evidence-backed patterns in them, and proposes skills you approve before your agent uses them.\",\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: \"Learning\",\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: \"Voice\",\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/home-briefing.mjs

@@ -1,12 +1,25 @@
 //#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/premium/intelligence-platform",
+	memory: "https://docs.copilotkit.ai/intelligence/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",
+	suggestions: "https://docs.copilotkit.ai/reference/hooks/useConfigureSuggestions",
 	audio: "https://docs.copilotkit.ai/voice",
-	websocket: "https://docs.copilotkit.ai/premium/intelligence-platform"
+	websocket: "https://docs.copilotkit.ai/intelligence/intelligence-platform"
 };
 /** Return the Home hero button for a trusted metadata action. */
 function homeHeroActionFromMetadata(action) {
@@ -44,8 +57,8 @@ function heroForState(args) {
 		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.",
+			title: renewing ? "Renew Intelligence" : "CopilotKit Intelligence",
+			body: renewing ? "Renew Intelligence to restore persistent Threads and Memory." : "Intelligence keeps every thread your users have, finds evidence-backed patterns in them, and proposes skills you approve before your agent uses them.",
 			action: connectIntelligenceAction(args.action, args.connectUrl, args.licenseState)
 		};
 	}
@@ -239,7 +252,7 @@ function buildHomeModel(input) {
 			},
 			{
 				id: "memory",
-				label: "Memory",
+				label: "Learning",
 				enabled: intelligenceConnected && input.memoriesOn,
 				docsUrl: SERVICE_DOCS_URL.memory
 			},
@@ -263,7 +276,7 @@ function buildHomeModel(input) {
 			},
 			{
 				id: "audio",
-				label: "Audio",
+				label: "Voice",
 				enabled: input.audioOn,
 				docsUrl: SERVICE_DOCS_URL.audio
 			},
@@ -284,5 +297,5 @@ function buildHomeModel(input) {
 }
 
 //#endregion
-export { buildHomeModel, runtimeConnectionNeedsAttention };
+export { buildHomeModel, homeFeatureImplementationPrompt, runtimeConnectionNeedsAttention };
 //# sourceMappingURL=home-briefing.mjs.map

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

@@ -1 +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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"}
+{"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 HomeFeatureImplementationPromptContext = {\n  onboardingRunId: string;\n};\n\n/**\n * A self-contained handoff for a coding agent. It answers the onboarding\n * workflow's session and feedback consent gates up front, while keeping the\n * feature guide—not a generic product-onboarding branch—in control of the\n * implementation plan.\n */\nexport function homeFeatureImplementationPrompt(\n  service: Pick<HomeServiceTile, \"label\" | \"docsUrl\">,\n  context: HomeFeatureImplementationPromptContext,\n): string {\n  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.\n\nThis 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.\n\nImplement 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.`;\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/intelligence/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:\n    \"https://docs.copilotkit.ai/reference/hooks/useConfigureSuggestions\",\n  audio: \"https://docs.copilotkit.ai/voice\",\n  websocket: \"https://docs.copilotkit.ai/intelligence/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      // Not \"Intelligence is not setup\" — that reads as a defect in the tool,\n      // and a defect gets dismissed. The heading names the product; the\n      // argument for it is made by the rotating copy on Home, which changes\n      // with the picture beside it.\n      title: renewing ? \"Renew Intelligence\" : \"CopilotKit Intelligence\",\n      // In install mode this is NOT the visible paragraph. The visible copy\n      // rotates every few seconds, which would make a screen reader announce a\n      // new sentence four times a loop, so the rotating text is hidden from\n      // assistive tech and this one stable sentence is exposed instead. It has\n      // to carry the whole chain on its own.\n      body: renewing\n        ? \"Renew Intelligence to restore persistent Threads and Memory.\"\n        : \"Intelligence keeps every thread your users have, finds evidence-backed patterns in them, and proposes skills you approve before your agent uses them.\",\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: \"Learning\",\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: \"Voice\",\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/onboarding-prompt.cjs

@@ -0,0 +1,48 @@
+
+//#region src/lib/onboarding-prompt.ts
+/**
+* The Intelligence install prompt the Inspector hands to a coding agent.
+*
+* Every other Intelligence call to action in the Inspector opens a page in a
+* new tab, which is where developers drop out: they leave the editor, meet a
+* signup form, and never come back. This prompt lets the install happen where
+* they already are.
+*
+* The wording is kept byte-identical to `INTELLIGENCE_ONBOARDING_PROMPT` in the
+* 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.
+*/
+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.`;
+/** Length and alphabet are the CLI's, so a run id copied here resolves there. */
+const RUN_ID_LENGTH = 12;
+/**
+* Mint the identifier that joins this copy to the CLI run it starts.
+*
+* The Intelligence app derives it from `crypto.randomUUID()`. The Inspector
+* runs inside whatever page embeds it, so neither `randomUUID` nor a secure
+* context is guaranteed; the two fallbacks keep the id present rather than
+* letting the button fail. Collision risk is irrelevant — this correlates
+* telemetry, it does not authorise anything.
+*/
+function createOnboardingRunId() {
+	const webCrypto = globalThis.crypto;
+	if (typeof webCrypto?.randomUUID === "function") return webCrypto.randomUUID().replaceAll("-", "").slice(0, RUN_ID_LENGTH);
+	if (typeof webCrypto?.getRandomValues === "function") {
+		const bytes = webCrypto.getRandomValues(new Uint8Array(RUN_ID_LENGTH / 2));
+		return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
+	}
+	let id = "";
+	while (id.length < RUN_ID_LENGTH) id += Math.floor(Math.random() * 16).toString(16);
+	return id.slice(0, RUN_ID_LENGTH);
+}
+/** Bind one run id into the prompt text that gets copied. */
+function createOnboardingPrompt(runId) {
+	return ONBOARDING_PROMPT_TEMPLATE.replace(RUN_ID_PLACEHOLDER, runId);
+}
+
+//#endregion
+exports.createOnboardingPrompt = createOnboardingPrompt;
+exports.createOnboardingRunId = createOnboardingRunId;
+//# sourceMappingURL=onboarding-prompt.cjs.map

package/dist/lib/onboarding-prompt.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-prompt.cjs","names":[],"sources":["../../src/lib/onboarding-prompt.ts"],"sourcesContent":["/**\n * The Intelligence install prompt the Inspector hands to a coding agent.\n *\n * Every other Intelligence call to action in the Inspector opens a page in a\n * new tab, which is where developers drop out: they leave the editor, meet a\n * signup form, and never come back. This prompt lets the install happen where\n * they already are.\n *\n * The wording is kept byte-identical to `INTELLIGENCE_ONBOARDING_PROMPT` in the\n * Intelligence app (`apps/app-frontend/react-shell/src/home/intelligence-home.tsx`).\n * The CLI resolves `onboard start` against a prompt graph, so the two surfaces\n * must not drift — if the CLI's entry point changes, both change together.\n */\nconst RUN_ID_PLACEHOLDER = \"<run-id>\";\n\nexport const ONBOARDING_PROMPT_TEMPLATE =\n  \"Identify which coding-agent product you are, using a short slug such as \" +\n  \"`codex` or `claude-code`. From the root of the project where you want \" +\n  \"CopilotKit, run `npx --yes copilotkit@latest onboard start --run \" +\n  `${RUN_ID_PLACEHOLDER}` +\n  \" --coding-agent <coding-agent-slug>`. Follow the Markdown instructions it \" +\n  \"prints until onboarding is complete.\";\n\n/** Length and alphabet are the CLI's, so a run id copied here resolves there. */\nconst RUN_ID_LENGTH = 12;\n\n/**\n * Mint the identifier that joins this copy to the CLI run it starts.\n *\n * The Intelligence app derives it from `crypto.randomUUID()`. The Inspector\n * runs inside whatever page embeds it, so neither `randomUUID` nor a secure\n * context is guaranteed; the two fallbacks keep the id present rather than\n * letting the button fail. Collision risk is irrelevant — this correlates\n * telemetry, it does not authorise anything.\n */\nexport function createOnboardingRunId(): string {\n  const webCrypto = globalThis.crypto;\n\n  if (typeof webCrypto?.randomUUID === \"function\") {\n    return webCrypto.randomUUID().replaceAll(\"-\", \"\").slice(0, RUN_ID_LENGTH);\n  }\n\n  if (typeof webCrypto?.getRandomValues === \"function\") {\n    const bytes = webCrypto.getRandomValues(new Uint8Array(RUN_ID_LENGTH / 2));\n    return Array.from(bytes, (byte) => byte.toString(16).padStart(2, \"0\")).join(\n      \"\",\n    );\n  }\n\n  let id = \"\";\n  while (id.length < RUN_ID_LENGTH) {\n    id += Math.floor(Math.random() * 16).toString(16);\n  }\n  return id.slice(0, RUN_ID_LENGTH);\n}\n\n/** Bind one run id into the prompt text that gets copied. */\nexport function createOnboardingPrompt(runId: string): string {\n  return ONBOARDING_PROMPT_TEMPLATE.replace(RUN_ID_PLACEHOLDER, runId);\n}\n"],"mappings":";;;;;;;;;;;;;;;AAaA,MAAM,qBAAqB;AAE3B,MAAa,6BACX,uNAGG;;AAKL,MAAM,gBAAgB;;;;;;;;;;AAWtB,SAAgB,wBAAgC;CAC9C,MAAM,YAAY,WAAW;AAE7B,KAAI,OAAO,WAAW,eAAe,WACnC,QAAO,UAAU,YAAY,CAAC,WAAW,KAAK,GAAG,CAAC,MAAM,GAAG,cAAc;AAG3E,KAAI,OAAO,WAAW,oBAAoB,YAAY;EACpD,MAAM,QAAQ,UAAU,gBAAgB,IAAI,WAAW,gBAAgB,EAAE,CAAC;AAC1E,SAAO,MAAM,KAAK,QAAQ,SAAS,KAAK,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,KACrE,GACD;;CAGH,IAAI,KAAK;AACT,QAAO,GAAG,SAAS,cACjB,OAAM,KAAK,MAAM,KAAK,QAAQ,GAAG,GAAG,CAAC,SAAS,GAAG;AAEnD,QAAO,GAAG,MAAM,GAAG,cAAc;;;AAInC,SAAgB,uBAAuB,OAAuB;AAC5D,QAAO,2BAA2B,QAAQ,oBAAoB,MAAM"}

package/dist/lib/onboarding-prompt.mjs

@@ -0,0 +1,46 @@
+//#region src/lib/onboarding-prompt.ts
+/**
+* The Intelligence install prompt the Inspector hands to a coding agent.
+*
+* Every other Intelligence call to action in the Inspector opens a page in a
+* new tab, which is where developers drop out: they leave the editor, meet a
+* signup form, and never come back. This prompt lets the install happen where
+* they already are.
+*
+* The wording is kept byte-identical to `INTELLIGENCE_ONBOARDING_PROMPT` in the
+* 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.
+*/
+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.`;
+/** Length and alphabet are the CLI's, so a run id copied here resolves there. */
+const RUN_ID_LENGTH = 12;
+/**
+* Mint the identifier that joins this copy to the CLI run it starts.
+*
+* The Intelligence app derives it from `crypto.randomUUID()`. The Inspector
+* runs inside whatever page embeds it, so neither `randomUUID` nor a secure
+* context is guaranteed; the two fallbacks keep the id present rather than
+* letting the button fail. Collision risk is irrelevant — this correlates
+* telemetry, it does not authorise anything.
+*/
+function createOnboardingRunId() {
+	const webCrypto = globalThis.crypto;
+	if (typeof webCrypto?.randomUUID === "function") return webCrypto.randomUUID().replaceAll("-", "").slice(0, RUN_ID_LENGTH);
+	if (typeof webCrypto?.getRandomValues === "function") {
+		const bytes = webCrypto.getRandomValues(new Uint8Array(RUN_ID_LENGTH / 2));
+		return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
+	}
+	let id = "";
+	while (id.length < RUN_ID_LENGTH) id += Math.floor(Math.random() * 16).toString(16);
+	return id.slice(0, RUN_ID_LENGTH);
+}
+/** Bind one run id into the prompt text that gets copied. */
+function createOnboardingPrompt(runId) {
+	return ONBOARDING_PROMPT_TEMPLATE.replace(RUN_ID_PLACEHOLDER, runId);
+}
+
+//#endregion
+export { createOnboardingPrompt, createOnboardingRunId };
+//# sourceMappingURL=onboarding-prompt.mjs.map

package/dist/lib/onboarding-prompt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-prompt.mjs","names":[],"sources":["../../src/lib/onboarding-prompt.ts"],"sourcesContent":["/**\n * The Intelligence install prompt the Inspector hands to a coding agent.\n *\n * Every other Intelligence call to action in the Inspector opens a page in a\n * new tab, which is where developers drop out: they leave the editor, meet a\n * signup form, and never come back. This prompt lets the install happen where\n * they already are.\n *\n * The wording is kept byte-identical to `INTELLIGENCE_ONBOARDING_PROMPT` in the\n * Intelligence app (`apps/app-frontend/react-shell/src/home/intelligence-home.tsx`).\n * The CLI resolves `onboard start` against a prompt graph, so the two surfaces\n * must not drift — if the CLI's entry point changes, both change together.\n */\nconst RUN_ID_PLACEHOLDER = \"<run-id>\";\n\nexport const ONBOARDING_PROMPT_TEMPLATE =\n  \"Identify which coding-agent product you are, using a short slug such as \" +\n  \"`codex` or `claude-code`. From the root of the project where you want \" +\n  \"CopilotKit, run `npx --yes copilotkit@latest onboard start --run \" +\n  `${RUN_ID_PLACEHOLDER}` +\n  \" --coding-agent <coding-agent-slug>`. Follow the Markdown instructions it \" +\n  \"prints until onboarding is complete.\";\n\n/** Length and alphabet are the CLI's, so a run id copied here resolves there. */\nconst RUN_ID_LENGTH = 12;\n\n/**\n * Mint the identifier that joins this copy to the CLI run it starts.\n *\n * The Intelligence app derives it from `crypto.randomUUID()`. The Inspector\n * runs inside whatever page embeds it, so neither `randomUUID` nor a secure\n * context is guaranteed; the two fallbacks keep the id present rather than\n * letting the button fail. Collision risk is irrelevant — this correlates\n * telemetry, it does not authorise anything.\n */\nexport function createOnboardingRunId(): string {\n  const webCrypto = globalThis.crypto;\n\n  if (typeof webCrypto?.randomUUID === \"function\") {\n    return webCrypto.randomUUID().replaceAll(\"-\", \"\").slice(0, RUN_ID_LENGTH);\n  }\n\n  if (typeof webCrypto?.getRandomValues === \"function\") {\n    const bytes = webCrypto.getRandomValues(new Uint8Array(RUN_ID_LENGTH / 2));\n    return Array.from(bytes, (byte) => byte.toString(16).padStart(2, \"0\")).join(\n      \"\",\n    );\n  }\n\n  let id = \"\";\n  while (id.length < RUN_ID_LENGTH) {\n    id += Math.floor(Math.random() * 16).toString(16);\n  }\n  return id.slice(0, RUN_ID_LENGTH);\n}\n\n/** Bind one run id into the prompt text that gets copied. */\nexport function createOnboardingPrompt(runId: string): string {\n  return ONBOARDING_PROMPT_TEMPLATE.replace(RUN_ID_PLACEHOLDER, runId);\n}\n"],"mappings":";;;;;;;;;;;;;;AAaA,MAAM,qBAAqB;AAE3B,MAAa,6BACX,uNAGG;;AAKL,MAAM,gBAAgB;;;;;;;;;;AAWtB,SAAgB,wBAAgC;CAC9C,MAAM,YAAY,WAAW;AAE7B,KAAI,OAAO,WAAW,eAAe,WACnC,QAAO,UAAU,YAAY,CAAC,WAAW,KAAK,GAAG,CAAC,MAAM,GAAG,cAAc;AAG3E,KAAI,OAAO,WAAW,oBAAoB,YAAY;EACpD,MAAM,QAAQ,UAAU,gBAAgB,IAAI,WAAW,gBAAgB,EAAE,CAAC;AAC1E,SAAO,MAAM,KAAK,QAAQ,SAAS,KAAK,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,KACrE,GACD;;CAGH,IAAI,KAAK;AACT,QAAO,GAAG,SAAS,cACjB,OAAM,KAAK,MAAM,KAAK,QAAQ,GAAG,GAAG,CAAC,SAAS,GAAG;AAEnD,QAAO,GAAG,MAAM,GAAG,cAAc;;;AAInC,SAAgB,uBAAuB,OAAuB;AAC5D,QAAO,2BAA2B,QAAQ,oBAAoB,MAAM"}

package/dist/lib/persistence.cjs

@@ -51,6 +51,50 @@ function isFiniteNumber(value) {
 function isValidDockMode(value) {
 	return value === "floating" || value === "docked-left";
 }
+const INSPECTOR_DISMISSAL_MIRROR_KEY = "cpk:inspector:dismissed_until";
+const INSPECTOR_DISMISSAL_COOKIE_NAME = "cpk_inspector_dismissed_until";
+const INSPECTOR_DISMISSAL_MAX_DURATION_MS = 10080 * 60 * 1e3;
+/** Return the active host-scoped Inspector dismissal deadline, if any. */
+function loadInspectorDismissedUntil(now = Date.now()) {
+	const until = parseInspectorDismissalPayload(readCookie(INSPECTOR_DISMISSAL_COOKIE_NAME)) ?? parseInspectorDismissalPayload(readLocalStorageItem(INSPECTOR_DISMISSAL_MIRROR_KEY));
+	if (until === null) return null;
+	if (until <= now) {
+		clearInspectorDismissal();
+		return null;
+	}
+	const maximumUntil = now + INSPECTOR_DISMISSAL_MAX_DURATION_MS;
+	if (until > maximumUntil) {
+		saveInspectorDismissedUntil(maximumUntil, now);
+		return maximumUntil;
+	}
+	return until;
+}
+/** Persist a dismissal across browser sessions and localhost ports. */
+function saveInspectorDismissedUntil(until, now = Date.now()) {
+	if (!Number.isFinite(until) || until <= now) {
+		clearInspectorDismissal();
+		return;
+	}
+	const boundedUntil = Math.min(until, now + INSPECTOR_DISMISSAL_MAX_DURATION_MS);
+	const payload = JSON.stringify({ until: boundedUntil });
+	writeCookie(INSPECTOR_DISMISSAL_COOKIE_NAME, payload, `Max-Age=${Math.max(1, Math.ceil((boundedUntil - now) / 1e3))}`);
+	writeLocalStorageItem(INSPECTOR_DISMISSAL_MIRROR_KEY, payload);
+}
+/** Clear both persistence layers, including an expired host cookie. */
+function clearInspectorDismissal() {
+	writeCookie(INSPECTOR_DISMISSAL_COOKIE_NAME, "", "Max-Age=0");
+	removeLocalStorageItem(INSPECTOR_DISMISSAL_MIRROR_KEY);
+}
+/** Parse a finite deadline from either persistence layer. */
+function parseInspectorDismissalPayload(raw) {
+	if (!raw) return null;
+	try {
+		const parsed = JSON.parse(raw);
+		return typeof parsed.until === "number" && Number.isFinite(parsed.until) ? parsed.until : null;
+	} catch {
+		return null;
+	}
+}
 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";
@@ -111,21 +155,27 @@ function parseTimestampPayload(raw) {
 	}
 }
 function readAnnouncementCookie() {
+	return readCookie(ANNOUNCEMENT_READ_COOKIE_NAME);
+}
+function writeAnnouncementCookie(value) {
+	writeCookie(ANNOUNCEMENT_READ_COOKIE_NAME, value, `Max-Age=${ANNOUNCEMENT_READ_COOKIE_MAX_AGE_SECONDS}`);
+}
+function readCookie(name) {
 	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;
+			if (entry.slice(0, separator).trim() !== name) continue;
 			return decodeURIComponent(entry.slice(separator + 1).trim());
 		}
 	} catch {}
 	return null;
 }
-function writeAnnouncementCookie(value) {
+function writeCookie(name, value, lifetime) {
 	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`;
+		document.cookie = `${name}=${encodeURIComponent(value)}; Path=/; ${lifetime}; SameSite=Lax`;
 	} catch {}
 }
 function readLocalStorageItem(key) {
@@ -195,6 +245,7 @@ function generateUuidV4() {
 }
 
 //#endregion
+exports.INSPECTOR_DISMISSAL_MAX_DURATION_MS = INSPECTOR_DISMISSAL_MAX_DURATION_MS;
 exports.clearLegacyAnnouncementReadState = clearLegacyAnnouncementReadState;
 exports.getOrCreateTelemetryDistinctId = getOrCreateTelemetryDistinctId;
 exports.hasTelemetryDisclosureBeenShown = hasTelemetryDisclosureBeenShown;
@@ -205,9 +256,11 @@ exports.isValidPosition = isValidPosition;
 exports.isValidSize = isValidSize;
 exports.loadAnnouncementPulsedTimestamp = loadAnnouncementPulsedTimestamp;
 exports.loadAnnouncementReadTimestamp = loadAnnouncementReadTimestamp;
+exports.loadInspectorDismissedUntil = loadInspectorDismissedUntil;
 exports.loadInspectorState = loadInspectorState;
 exports.markTelemetryDisclosureShown = markTelemetryDisclosureShown;
 exports.saveAnnouncementPulsedTimestamp = saveAnnouncementPulsedTimestamp;
 exports.saveAnnouncementReadTimestamp = saveAnnouncementReadTimestamp;
+exports.saveInspectorDismissedUntil = saveInspectorDismissedUntil;
 exports.saveInspectorState = saveInspectorState;
 //# sourceMappingURL=persistence.cjs.map