copilotkit 2.0.3 → 2.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "copilotkit",
-  "version": "2.0.3",
+  "version": "2.1.0",
   "type": "module",
   "bin": {
     "copilotkit": "./index.js"

package/src/commands/init.d.ts

@@ -1,7 +1,9 @@
+import { type ReactElement } from 'react';
 import type { InitOptions, InitTemplateDefinition } from '../types.js';
 import { login, verifyAndRefresh } from '../services/auth.service.js';
 import { createApiClient } from '../services/api-client.js';
 import { scaffoldProject, copyEnvExample } from '../services/project-scaffold.js';
+import { type BrowserLoginPhase } from '../ui/browser-login.js';
 import { getOpsApiUrl } from '../config.js';
 /**
  * Flags accepted by the `copilotkit init` command.
@@ -16,6 +18,13 @@ export interface InitFlags {
 }
 /** Phases of the scaffolding flow rendered after options are collected. */
 type ScaffoldPhase = 'auth' | 'scaffold' | 'license' | 'git' | 'success' | 'error';
+/**
+ * Returns whether the embedded init browser-login UI should take over rendering.
+ *
+ * @param phase - Current shared browser-login phase.
+ * @returns True when the browser-login component has an active visible state.
+ */
+export declare function shouldRenderInitBrowserLoginConfirmation(phase: BrowserLoginPhase): boolean;
 /** Writes a license key into the project's .env file. */
 declare function writeLicenseKey(projectDir: string, licenseKey: string): void;
 /** Runs git init and creates an initial commit if identity is configured. */
@@ -90,6 +99,36 @@ export declare function buildInitNextSteps(templateDefinition: InitTemplateDefin
  * @param onPhaseChange - Optional callback used by the Ink UI to update progress.
  */
 export declare function scaffoldInitProject(options: InitOptions, dependencies?: InitScaffoldDependencies, onPhaseChange?: (phase: Exclude<ScaffoldPhase, 'success' | 'error'>) => void, onTerminalSessionInvalidation?: () => void): Promise<InitScaffoldResult>;
+/**
+ * Root Ink component for the `init` command.
+ *
+ * Manages two phases:
+ * 1. **Prompts** — renders {@link InitFlow} to collect missing options.
+ * 2. **Scaffolding** — renders {@link ScaffoldProgress} to perform async work.
+ *
+ * A single `render()` call is used; internal state drives the transition
+ * between phases.
+ */
+/** Renders the scaffold progress UI for resolved init options. */
+type ScaffoldProgressRenderer = (options: InitOptions) => ReactElement;
+/** Props for {@link InitApp}. */
+export interface InitAppProps {
+    /** Project name supplied by flags, or `null` when interactive collection is required. */
+    initialName: string | null;
+    /** Intelligence selection supplied by flags, or `null` when interactive collection is required. */
+    initialIntelligence: boolean | null;
+    /** Framework supplied by flags, or `null` when interactive collection is required. */
+    initialFramework: string | null;
+    /** Injectable scaffold renderer, primarily for tests. */
+    renderScaffoldProgress?: ScaffoldProgressRenderer;
+}
+/**
+ * Resolves fully pre-filled flags into InitOptions without prompts.
+ *
+ * Returns `null` when interactive prompts are still needed.
+ */
+export declare function resolvePrefilledOptions(name: string | null, intelligence: boolean | null, framework: string | null): InitOptions | null;
+export declare function InitApp({ initialName, initialIntelligence, initialFramework, renderScaffoldProgress, }: InitAppProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Entry point for the `copilotkit init` command.
  *

package/src/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/commands/init.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/commands/init.tsx"],"names":[],"mappings":"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"}

package/src/commands/license.d.ts

@@ -1,3 +1,4 @@
+import { type BrowserLoginPhase } from "../ui/browser-login.js";
 import type { CliLicenseScope } from "../types.js";
 /**
  * Parsed `copilotkit license` command variants.
@@ -8,6 +9,13 @@ export type LicenseCommand = {
     action: "list";
     scope: CliLicenseScope;
 };
+/**
+ * Returns whether the embedded license-create browser-login UI should take over rendering.
+ *
+ * @param phase - Current shared browser-login phase.
+ * @returns True when the browser-login component has an active visible state.
+ */
+export declare function shouldRenderLicenseCreateBrowserLoginConfirmation(phase: BrowserLoginPhase): boolean;
 /**
  * Entry point for the `copilotkit license` command.
  *

package/src/commands/license.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"license.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/commands/license.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAEV,eAAe,EAChB,MAAM,aAAa,CAAC;AAIrB;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAC;AAuT/C;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBvE"}
+{"version":3,"file":"license.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/commands/license.tsx"],"names":[],"mappings":"AAWA,OAAO,EAGL,KAAK,iBAAiB,EAGvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAEV,eAAe,EAChB,MAAM,aAAa,CAAC;AAIrB;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAC;AAK/C;;;;;GAKG;AACH,wBAAgB,iDAAiD,CAC/D,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAET;AAmTD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBvE"}

package/src/config.d.ts

@@ -15,6 +15,18 @@ export declare function setOpsApiUrl(url: string): void;
 export declare function getOpsFrontendUrl(): string;
 /** Override the ops frontend URL at runtime. */
 export declare function setOpsFrontendUrl(url: string): void;
+/**
+ * Resolves the telemetry sink ingest endpoint URL.
+ *
+ * Honors the `COPILOTKIT_TELEMETRY_ENDPOINT` env var when set, otherwise falls
+ * back to the build-time default baked in via esbuild `define`. When neither
+ * is available (unbundled execution like `tsx` or unit tests), returns the
+ * production endpoint as a final fallback — the caller is expected to also
+ * gate sends on dev-mode detection via {@link getBuildInfo}.
+ *
+ * @returns Absolute URL of the telemetry ingest endpoint.
+ */
+export declare function getTelemetryEndpointUrl(): string;
 /**
  * Build identity for this CLI binary.
  *
@@ -22,6 +34,9 @@ export declare function setOpsFrontendUrl(url: string): void;
  * - `buildNumber` — GitHub Actions run id of the build, or `"dev"` for local builds.
  *   Maps back to a workflow run at github.com/<repo>/actions/runs/<buildNumber>.
  * - `commitSha` — git commit the binary was built from, or `"dev"` for local builds.
+ *
+ * Falls back to `"dev"` when running outside an esbuild bundle (e.g., `tsx`
+ * or vitest), so callers do not crash with a `ReferenceError`.
  */
 export declare function getBuildInfo(): {
     version: string;

package/src/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../apps/cli/src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,kDAAkD;AAClD,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,gDAAgD;AAChD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAMA"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../apps/cli/src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,kDAAkD;AAClD,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,gDAAgD;AAChD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAQhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,IAAI;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAMA"}

package/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../apps/cli/src/index.ts"],"names":[],"mappings":";AAoOA;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAIzE;AAgPD;;GAEG;AACH,wBAAsB,IAAI,CAAC,OAAO,WAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiEzE;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,SAAS,EAAE,MAAM,GAChB,OAAO,CAMT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../apps/cli/src/index.ts"],"names":[],"mappings":";AAgPA;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAIzE;AA8QD;;GAEG;AACH,wBAAsB,IAAI,CAAC,OAAO,WAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoFzE;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,SAAS,EAAE,MAAM,GAChB,OAAO,CAMT"}

package/src/services/cli-tips.d.ts

@@ -0,0 +1,45 @@
+/** User-facing CopilotKit guidance that can be rendered by future CLI surfaces. */
+export interface CliTip {
+    /** Stable identifier for analytics, tests, and renderer keys. */
+    id: string;
+    /** Tip copy shown to the user. */
+    text: string;
+    /** Numeric estimate of how relevant the tip is to common CLI users. */
+    relevancy: number;
+    /** Numeric estimate of how much implementation insight the tip provides. */
+    insight: number;
+}
+/** Options used to select a ranked subset of CLI tips. */
+export interface SelectCliTipsOptions {
+    /** Candidate tips to rank and filter. */
+    tips?: readonly CliTip[];
+    /** Maximum number of tips to return after ranking. */
+    limit?: number;
+    /** Minimum relevancy score required for inclusion. */
+    minimumRelevancy?: number;
+    /** Minimum insight score required for inclusion. */
+    minimumInsight?: number;
+}
+/** Reusable CopilotKit tip catalog for later CLI rendering. */
+export declare const CLI_TIPS: readonly CliTip[];
+/**
+ * Returns the reusable CopilotKit CLI tip catalog.
+ *
+ * @returns Read-only CopilotKit tip entries.
+ */
+export declare function getCliTips(): readonly CliTip[];
+/**
+ * Ranks CLI tips by relevancy, then insight, then stable identifier.
+ *
+ * @param tips - Candidate tips to rank.
+ * @returns A new ranked array without mutating the input.
+ */
+export declare function rankCliTips(tips?: readonly CliTip[]): readonly CliTip[];
+/**
+ * Selects ranked CLI tips using optional score thresholds and a limit.
+ *
+ * @param options - Selection options.
+ * @returns Ranked tips matching the provided filters.
+ */
+export declare function selectCliTips(options?: SelectCliTipsOptions): readonly CliTip[];
+//# sourceMappingURL=cli-tips.d.ts.map

package/src/services/cli-tips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-tips.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/services/cli-tips.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,WAAW,MAAM;IACrB,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,+DAA+D;AAC/D,eAAO,MAAM,QAAQ,EAAE,SAAS,MAAM,EAuPpC,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,SAAS,MAAM,EAAE,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAE,SAAS,MAAM,EAAa,GAAG,SAAS,MAAM,EAAE,CAcjF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,SAAS,MAAM,EAAE,CAYnF"}

package/src/services/telemetry/event-properties.d.ts

@@ -0,0 +1,102 @@
+/** Bounded enum of `command` values emitted on telemetry events. */
+export type TelemetryCommand = "init" | "login" | "logout" | "license" | "whoami" | "docs" | "help" | "version" | "unknown";
+/** Bounded enum of `outcome` values emitted on telemetry events. */
+export type TelemetryOutcome = "started" | "succeeded" | "failed";
+/** Bounded enum of `error_code` values emitted on failed events. */
+export type TelemetryErrorCode = "validation" | "auth" | "network" | "timeout" | "prerequisite_missing" | "template_fetch" | "git" | "filesystem" | "user_aborted" | "unknown";
+/**
+ * Minimal session payload read from the auth store when building base
+ * properties. Decouples this module from the full {@link StoredAuth} shape.
+ */
+export interface TelemetryAuthSnapshot {
+    userId: string;
+    email: string;
+}
+/**
+ * Build identity payload mirroring the shape of {@link getBuildInfo}.
+ */
+export interface TelemetryBuildInfo {
+    version: string;
+    buildNumber: string;
+    commitSha: string;
+}
+/** Injectable dependencies for {@link buildBaseProperties}. */
+export interface BaseDeps {
+    installationId: string;
+    sessionId: string;
+    buildInfo: TelemetryBuildInfo;
+    auth: TelemetryAuthSnapshot | null;
+    env: NodeJS.ProcessEnv;
+    nodeVersion: string;
+    platform: NodeJS.Platform | string;
+    arch: string;
+}
+/** Output shape of {@link buildBaseProperties}. */
+export interface BaseProperties {
+    installation_id: string;
+    session_id: string;
+    cli_version: string;
+    cli_build_number: string;
+    cli_commit_sha: string;
+    node_version: string;
+    platform: string;
+    arch: string;
+    is_ci: boolean;
+    is_authenticated: boolean;
+    clerk_user_id?: string;
+    email_hash?: string;
+}
+/**
+ * Detects whether the current process is running in a CI environment.
+ *
+ * @param env - Process environment variables.
+ * @returns `true` when any known CI indicator env var is set to a non-empty value.
+ */
+export declare function detectCi(env: NodeJS.ProcessEnv): boolean;
+/**
+ * Truncated SHA-256 hash of an email for PII-free correlation.
+ *
+ * Matches the wire format used by ops-api at
+ * `apps/ops-api/src/services/telemetry-sink.service.ts:68-70`.
+ *
+ * @param email - The email to hash.
+ * @returns A 16-character lowercase hex string.
+ */
+export declare function hashEmail(email: string): string;
+/**
+ * Builds the base property set emitted on every telemetry event.
+ *
+ * @param deps - Build identity, auth snapshot, env, and platform info.
+ * @returns The base properties object.
+ */
+export declare function buildBaseProperties(deps: BaseDeps): BaseProperties;
+/**
+ * Flag shape for {@link subcommandForInit}.
+ */
+export interface InitSubcommandFlags {
+    intelligence?: boolean;
+    framework?: string;
+}
+/**
+ * Derives the bounded `subcommand` property for the init/create command.
+ *
+ * Returns `"interactive"` when neither branching flag is set, `"intelligence"`
+ * for the intelligence branch, the framework value when `--framework` is set
+ * to a known {@link AgentFramework}, and `"invalid"` when an unknown framework
+ * value is supplied (to avoid leaking arbitrary user-typed strings).
+ *
+ * @param flags - The parsed init flags.
+ * @returns The bounded subcommand value.
+ */
+export declare function subcommandForInit(flags: InitSubcommandFlags): string;
+/**
+ * Classifies an unknown error value into a bounded {@link TelemetryErrorCode}.
+ *
+ * Inspects `Error.name`, status codes on `ApiClientError`-shaped errors, and
+ * `AbortError` for timeouts. Never returns or emits the raw error message.
+ *
+ * @param err - The thrown value.
+ * @returns A bounded error code suitable for the `error_code` property.
+ */
+export declare function classifyError(err: unknown): TelemetryErrorCode;
+//# sourceMappingURL=event-properties.d.ts.map

package/src/services/telemetry/event-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-properties.d.ts","sourceRoot":"","sources":["../../../../../../apps/cli/src/services/telemetry/event-properties.ts"],"names":[],"mappings":"AAGA,oEAAoE;AACpE,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,OAAO,GACP,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,MAAM,GACN,MAAM,GACN,SAAS,GACT,SAAS,CAAC;AAEd,oEAAoE;AACpE,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAElE,oEAAoE;AACpE,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,MAAM,GACN,SAAS,GACT,SAAS,GACT,sBAAsB,GACtB,gBAAgB,GAChB,KAAK,GACL,YAAY,GACZ,cAAc,GACd,SAAS,CAAC;AAEd;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+DAA+D;AAC/D,MAAM,WAAW,QAAQ;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAaD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAKxD;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAoBlE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAQpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CA6B9D"}

package/src/services/telemetry/index.d.ts

@@ -0,0 +1,48 @@
+import { type TelemetryEvent, type TelemetryEventProperties, type TelemetryService } from "./telemetry.service.js";
+/**
+ * Lazily constructs and returns the process-wide telemetry service.
+ *
+ * Generates a fresh `session_id` on first call, resolves opt-out state, and
+ * persists the anonymous `installation_id` if not already present.
+ *
+ * @returns The singleton telemetry service.
+ */
+export declare function getTelemetry(): TelemetryService;
+/**
+ * Records a telemetry event through the process-wide singleton.
+ *
+ * @param event - The event payload to send.
+ */
+export declare function recordTelemetryEvent(event: TelemetryEvent): void;
+/**
+ * Awaits in-flight telemetry sends up to a bounded timeout. No-op when the
+ * singleton has not been initialised.
+ *
+ * @param timeoutMs - Optional override for the flush ceiling.
+ */
+export declare function flushTelemetry(timeoutMs?: number): Promise<void>;
+/**
+ * Flushes telemetry then exits the process with the given code. Use this in
+ * place of bare `process.exit(N)` calls anywhere an event may have just been
+ * recorded.
+ *
+ * @param code - The exit code to use.
+ */
+export declare function exitWithFlush(code: number): Promise<never>;
+/**
+ * Wraps an async command runner with a `started` event on entry and a
+ * `succeeded` or `failed` event on exit. The wrapped function's return value
+ * and rejections pass through unchanged.
+ *
+ * @param base - The event properties common to both started and finished
+ *   events (typically `{ command, subcommand?, scope? }`).
+ * @param fn - The command runner to wrap.
+ * @returns The result of `fn`.
+ */
+export declare function withTelemetry<T>(base: Omit<TelemetryEventProperties, "outcome" | "duration_ms" | "error_code">, fn: () => Promise<T>): Promise<T>;
+/**
+ * Test-only helper that drops the singleton so each test sees a fresh state.
+ * Not part of the public production surface.
+ */
+export declare function __resetTelemetryForTests(): void;
+//# sourceMappingURL=index.d.ts.map

package/src/services/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../apps/cli/src/services/telemetry/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAE7B,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AA2BhC;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,gBAAgB,CA4B/C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAEhE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,SAAS,GAAE,MAAiC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAGhE;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,IAAI,EAAE,IAAI,CAAC,wBAAwB,EAAE,SAAS,GAAG,aAAa,GAAG,YAAY,CAAC,EAC9E,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAoBZ;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/src/services/telemetry/installation-id.d.ts

@@ -0,0 +1,22 @@
+/** Config-store key under which the persistent installation id is stored. */
+export declare const INSTALLATION_ID_KEY = "telemetry.installationId";
+/** Minimal config-store surface used to persist the installation id. */
+export interface ConfigStoreReadWrite {
+    get<T>(key: string): T | undefined;
+    set(key: string, value: unknown): void;
+}
+/** Injectable dependencies for {@link getOrCreateInstallationId}. */
+export interface InstallationIdDeps {
+    configStore: ConfigStoreReadWrite;
+    /** Injectable UUID generator for deterministic tests. Defaults to crypto. */
+    generateId?: () => string;
+}
+/**
+ * Reads the persistent anonymous installation id, generating and persisting
+ * a fresh UUID v4 on first call.
+ *
+ * @param deps - Injectable config store and id generator.
+ * @returns The installation id as a string.
+ */
+export declare function getOrCreateInstallationId(deps: InstallationIdDeps): string;
+//# sourceMappingURL=installation-id.d.ts.map

package/src/services/telemetry/installation-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installation-id.d.ts","sourceRoot":"","sources":["../../../../../../apps/cli/src/services/telemetry/installation-id.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,6BAA6B,CAAC;AAE9D,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACxC;AAED,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,oBAAoB,CAAC;IAClC,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAS1E"}

package/src/services/telemetry/opt-out.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Resolves whether telemetry should be disabled for this process.
+ *
+ * Honors, in order of precedence:
+ * 1. The `DO_NOT_TRACK` env var (consoledonottrack.com standard).
+ * 2. The `COPILOTKIT_TELEMETRY_DISABLED` env var.
+ * 3. A persisted `telemetry.optOut` boolean in {@link ConfigStoreReader}.
+ *
+ * Env values are matched case-insensitively against `1 | true | yes | on`.
+ * Empty or unset values are treated as not-set.
+ */
+/** Minimal config-store surface used to read the persisted opt-out flag. */
+export interface ConfigStoreReader {
+    get<T>(key: string): T | undefined;
+}
+/**
+ * Resolves the effective opt-out state for the current process.
+ *
+ * @param env - Process environment variables (defaults to `process.env`).
+ * @param configStore - Persistent config store with `telemetry.optOut`.
+ * @returns `true` when telemetry should be disabled.
+ */
+export declare function resolveOptOut(env: NodeJS.ProcessEnv, configStore: ConfigStoreReader): boolean;
+//# sourceMappingURL=opt-out.d.ts.map

package/src/services/telemetry/opt-out.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opt-out.d.ts","sourceRoot":"","sources":["../../../../../../apps/cli/src/services/telemetry/opt-out.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;CACpC;AAaD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAIT"}

package/src/services/telemetry/telemetry.service.d.ts

@@ -0,0 +1,74 @@
+import type { BaseProperties, TelemetryCommand, TelemetryErrorCode, TelemetryOutcome } from "./event-properties.js";
+/** Wire-shape event name; one allowlist entry covers every CLI event. */
+export declare const CLI_TELEMETRY_EVENT_NAME: "cli.command.invoked";
+/** Per-event property keys that may appear in addition to base properties. */
+export interface TelemetryEventProperties {
+    command: TelemetryCommand;
+    outcome: TelemetryOutcome;
+    subcommand?: string;
+    scope?: "org" | "user";
+    duration_ms?: number;
+    error_code?: TelemetryErrorCode;
+}
+/** Full event payload accepted by {@link TelemetryService.recordEvent}. */
+export interface TelemetryEvent {
+    properties: TelemetryEventProperties;
+}
+/** Maximum concurrent in-flight requests; excess events are dropped. */
+export declare const MAX_INFLIGHT = 32;
+/** Per-request hard timeout for the outbound POST. */
+export declare const DEFAULT_PER_REQUEST_TIMEOUT_MS = 2000;
+/** Default flush timeout used by {@link TelemetryService.flush}. */
+export declare const DEFAULT_FLUSH_TIMEOUT_MS = 1500;
+/**
+ * Minimal logger surface used by the telemetry service. Mirrors the subset of
+ * the CLI's `writeCliLog` signature so callers can pass a thin wrapper.
+ */
+export interface TelemetryLogger {
+    debug: (payload: Record<string, unknown>) => void;
+    warn: (payload: Record<string, unknown>) => void;
+    error: (payload: Record<string, unknown>) => void;
+}
+/** Injectable dependencies for {@link createTelemetryService}. */
+export interface TelemetryServiceDeps {
+    /** Master on/off; when `false`, `recordEvent` is a synchronous no-op. */
+    enabled: boolean;
+    /** Absolute URL of the telemetry ingest endpoint. */
+    endpointUrl: string;
+    /** Producer of the base properties merged into every event. */
+    buildBaseProperties: () => BaseProperties;
+    /** Structured logger for diagnostic events. */
+    logger: TelemetryLogger;
+    /** Injectable fetch for tests. Defaults to global `fetch`. */
+    fetch?: typeof fetch;
+    /** Per-request hard timeout. Defaults to {@link DEFAULT_PER_REQUEST_TIMEOUT_MS}. */
+    perRequestTimeoutMs?: number;
+    /** Cap on in-flight requests. Defaults to {@link MAX_INFLIGHT}. */
+    maxInFlight?: number;
+}
+/** Public surface of the telemetry service. */
+export interface TelemetryService {
+    /**
+     * Synchronously schedules a telemetry event for fire-and-forget delivery.
+     * Returns `void` and never throws — callers must not `await` this.
+     */
+    recordEvent(event: TelemetryEvent): void;
+    /**
+     * Awaits all in-flight requests up to a bounded timeout, then resolves.
+     * Safe to call multiple times; resolves immediately when the queue is empty.
+     */
+    flush(timeoutMs?: number): Promise<void>;
+}
+/**
+ * Constructs a CLI telemetry service.
+ *
+ * Sends `{ event: "cli.command.invoked", properties }` to the configured
+ * endpoint as fire-and-forget POSTs, with a bounded in-flight queue and a
+ * per-request `AbortController`. All failures are swallowed and logged via
+ * the injected `logger`.
+ *
+ * @param deps - Injectable configuration and collaborators.
+ * @returns The telemetry service instance.
+ */
+export declare function createTelemetryService(deps: TelemetryServiceDeps): TelemetryService;
+//# sourceMappingURL=telemetry.service.d.ts.map

package/src/services/telemetry/telemetry.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.service.d.ts","sourceRoot":"","sources":["../../../../../../apps/cli/src/services/telemetry/telemetry.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEpH,yEAAyE;AACzE,eAAO,MAAM,wBAAwB,EAAG,qBAA8B,CAAC;AAEvE,8EAA8E;AAC9E,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,wBAAwB,CAAC;CACtC;AAED,wEAAwE;AACxE,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B,sDAAsD;AACtD,eAAO,MAAM,8BAA8B,OAAQ,CAAC;AAEpD,oEAAoE;AACpE,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAClD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACnD;AAED,kEAAkE;AAClE,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,mBAAmB,EAAE,MAAM,cAAc,CAAC;IAC1C,+CAA+C;IAC/C,MAAM,EAAE,eAAe,CAAC;IACxB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,oFAAoF;IACpF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAEzC;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,CA6FnF"}

package/src/ui/browser-login.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-login.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/ui/browser-login.tsx"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,OAAO,EAAE,KAAK,IAAI,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAIpE,yEAAyE;AACzE,eAAO,MAAM,kCAAkC,qEACW,CAAC;AAE3D,oDAAoD;AACpD,eAAO,MAAM,iCAAiC,+BAChB,CAAC;AAE/B,4DAA4D;AAC5D,MAAM,MAAM,kBAAkB,GAAG,OAAO,YAAY,CAAC;AAErD,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,YAAY,GACZ,SAAS,GACT,YAAY,GACZ,SAAS,GACT,OAAO,CAAC;AAUZ,qEAAqE;AACrE,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,KAAK,EAAE,iBAAiB,CAAC;IACzB,uDAAuD;IACvD,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACtC,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,6DAA6D;AAC7D,MAAM,WAAW,wBAAwB;IACvC,mFAAmF;IACnF,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,sCAAsC;IACtC,KAAK,EAAE,iBAAiB,CAAC;IACzB,iDAAiD;IACjD,wBAAwB,EAAE,MAAM,OAAO,CAAC;IACxC,sGAAsG;IACtG,sBAAsB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;CACzD;AAED,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB;IACxC,4DAA4D;IAC5D,QAAQ,EAAE,SAAS,CAAC;IACpB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,oDAAoD;IACpD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AA2BD;;;;GAIG;AACH,wBAAgB,qCAAqC,IAAI,OAAO,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,WAA0B,EAC1B,aAAa,GACd,EAAE,yBAAyB,GAAG,YAAY,CAoJ1C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,wBAAwB,CAO1D;AAED,oFAAoF;AACpF,eAAO,MAAM,gCAAgC,qGACuD,CAAC;AAErG;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,YAAY,GAAG,IAAI,CAkF9D"}
+{"version":3,"file":"browser-login.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/ui/browser-login.tsx"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,OAAO,EAAE,KAAK,IAAI,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAKpE,yEAAyE;AACzE,eAAO,MAAM,kCAAkC,qEACW,CAAC;AAE3D,oDAAoD;AACpD,eAAO,MAAM,iCAAiC,+BAChB,CAAC;AAE/B,4DAA4D;AAC5D,MAAM,MAAM,kBAAkB,GAAG,OAAO,YAAY,CAAC;AAErD,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,YAAY,GACZ,SAAS,GACT,YAAY,GACZ,SAAS,GACT,OAAO,CAAC;AAUZ,qEAAqE;AACrE,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,KAAK,EAAE,iBAAiB,CAAC;IACzB,uDAAuD;IACvD,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACtC,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,6DAA6D;AAC7D,MAAM,WAAW,wBAAwB;IACvC,mFAAmF;IACnF,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,sCAAsC;IACtC,KAAK,EAAE,iBAAiB,CAAC;IACzB,iDAAiD;IACjD,wBAAwB,EAAE,MAAM,OAAO,CAAC;IACxC,sGAAsG;IACtG,sBAAsB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;CACzD;AAED,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB;IACxC,4DAA4D;IAC5D,QAAQ,EAAE,SAAS,CAAC;IACpB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,oDAAoD;IACpD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AA2BD;;;;GAIG;AACH,wBAAgB,qCAAqC,IAAI,OAAO,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,WAA0B,EAC1B,aAAa,GACd,EAAE,yBAAyB,GAAG,YAAY,CAoJ1C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,wBAAwB,CAO1D;AAED,oFAAoF;AACpF,eAAO,MAAM,gCAAgC,qGACuD,CAAC;AAErG;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,YAAY,GAAG,IAAI,CAoF9D"}

package/src/ui/cli-tip.d.ts

@@ -0,0 +1,111 @@
+import { type ReactElement } from 'react';
+import { type CliTip as CliTipEntry } from '../services/cli-tips.js';
+/** Default delay before a CLI tip appears in a dwell surface. */
+export declare const CLI_TIP_DEFAULT_DELAY_MS = 2500;
+/** Default quiet rotation interval after the first CLI tip is visible. */
+export declare const CLI_TIP_DEFAULT_ROTATION_MS = 12000;
+/** Default maximum number of top-ranked tips included in rotation. */
+export declare const CLI_TIP_DEFAULT_ROTATION_LIMIT = 5;
+/** Default size of the ranked pool eligible for randomized rotation. */
+export declare const CLI_TIP_DEFAULT_ROTATION_POOL_LIMIT = 20;
+/** Function used to generate a random number in the range [0, 1). */
+export type CliTipRandomNumberGenerator = () => number;
+/** Parsed segment of CLI tip text. */
+export interface CliTipTextSegment {
+    /** Segment rendering style. */
+    kind: 'text' | 'code';
+    /** Segment text content. */
+    text: string;
+}
+/** Options for selecting a CLI tip rotation subset. */
+export interface SelectCliTipRotationSubsetOptions {
+    /** Maximum number of top-ranked tips included in rotation. */
+    rotationLimit?: number;
+    /** Maximum number of top-ranked tips eligible for randomized selection. */
+    rotationPoolLimit?: number;
+    /** Whether to shuffle the ranked pool before taking the rotation subset. */
+    randomize?: boolean;
+    /** Random number generator used when randomizing the rotation subset. */
+    rng?: CliTipRandomNumberGenerator;
+}
+/** Props for {@link CliTip}. */
+export interface CliTipProps {
+    /** Optional candidate tips, primarily for tests. */
+    tips?: readonly CliTipEntry[];
+    /** Zero-based index into the deterministic ranked tip list. */
+    selectionIndex?: number;
+    /** Delay before rendering the selected tip. */
+    delayMs?: number;
+    /** Quiet rotation interval once the first tip is visible. */
+    rotationMs?: number;
+    /** Maximum number of top-ranked tips included in rotation. */
+    rotationLimit?: number;
+    /** Maximum number of top-ranked tips eligible for randomized selection. */
+    rotationPoolLimit?: number;
+    /** Whether to randomize the bounded rotation subset. */
+    randomize?: boolean;
+    /** Random number generator used when randomizing the rotation subset. */
+    rng?: CliTipRandomNumberGenerator;
+}
+/**
+ * Normalizes a numeric index for deterministic tip selection.
+ *
+ * @param selectionIndex - Candidate index.
+ * @returns A finite non-negative integer index.
+ */
+export declare function normalizeCliTipSelectionIndex(selectionIndex?: number): number;
+/**
+ * Normalizes a positive integer limit with a fallback.
+ *
+ * @param limit - Candidate limit.
+ * @param fallback - Fallback limit for non-finite values.
+ * @returns A finite non-negative integer limit.
+ */
+export declare function normalizeCliTipLimit(limit: number, fallback: number): number;
+/**
+ * Normalizes RNG output for bounded array indexing.
+ *
+ * @param randomValue - Candidate random number.
+ * @returns A finite number in the range [0, 1).
+ */
+export declare function normalizeCliTipRandomValue(randomValue: number): number;
+/**
+ * Shuffles tips using Fisher-Yates without mutating the input.
+ *
+ * @param tips - Tips to shuffle.
+ * @param rng - Random number generator.
+ * @returns Shuffled tip copy.
+ */
+export declare function shuffleCliTips(tips: readonly CliTipEntry[], rng?: CliTipRandomNumberGenerator): readonly CliTipEntry[];
+/**
+ * Selects a bounded subset from the ranked catalog.
+ *
+ * @param tips - Candidate tips to rank.
+ * @param options - Rotation subset options.
+ * @returns Tips included in rotation.
+ */
+export declare function selectCliTipRotationSubset(tips?: readonly CliTipEntry[], options?: SelectCliTipRotationSubsetOptions | number): readonly CliTipEntry[];
+/**
+ * Selects one deterministic CLI tip from the bounded ranked rotation subset.
+ *
+ * @param tips - Candidate tips to rank.
+ * @param selectionIndex - Zero-based initial offset into the rotation subset.
+ * @param rotationLimit - Maximum number of top-ranked tips to include.
+ * @returns The selected tip, or `null` when no tip is available.
+ */
+export declare function selectCliTipForRender(tips?: readonly CliTipEntry[], selectionIndex?: number, rotationLimit?: number): CliTipEntry | null;
+/**
+ * Parses matched backtick code spans while preserving unmatched backticks.
+ *
+ * @param text - Tip text to parse.
+ * @returns Ordered text and code segments.
+ */
+export declare function parseCliTipText(text: string): readonly CliTipTextSegment[];
+/**
+ * Renders a delayed CopilotKit CLI tip for intentional dwell moments.
+ *
+ * @param props - Component props.
+ * @returns Ink element once the delay has elapsed, otherwise `null`.
+ */
+export declare function CliTip({ tips, selectionIndex, delayMs, rotationMs, rotationLimit, rotationPoolLimit, randomize, rng, }: CliTipProps): ReactElement | null;
+//# sourceMappingURL=cli-tip.d.ts.map

package/src/ui/cli-tip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-tip.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/ui/cli-tip.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAExE,OAAO,EAEL,KAAK,MAAM,IAAI,WAAW,EAC3B,MAAM,yBAAyB,CAAC;AAEjC,iEAAiE;AACjE,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,0EAA0E;AAC1E,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAElD,sEAAsE;AACtE,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAEhD,wEAAwE;AACxE,eAAO,MAAM,mCAAmC,KAAK,CAAC;AAEtD,qEAAqE;AACrE,MAAM,MAAM,2BAA2B,GAAG,MAAM,MAAM,CAAC;AAEvD,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uDAAuD;AACvD,MAAM,WAAW,iCAAiC;IAChD,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yEAAyE;IACzE,GAAG,CAAC,EAAE,2BAA2B,CAAC;CACnC;AAED,gCAAgC;AAChC,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,IAAI,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9B,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yEAAyE;IACzE,GAAG,CAAC,EAAE,2BAA2B,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,cAAc,SAAI,GAAG,MAAM,CAIxE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,WAAW,EAAE,EAC5B,GAAG,GAAE,2BAAyC,GAC7C,SAAS,WAAW,EAAE,CAexB;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,CAAC,EAAE,SAAS,WAAW,EAAE,EAC7B,OAAO,GAAE,iCAAiC,GAAG,MAAW,GACvD,SAAS,WAAW,EAAE,CA4BxB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,CAAC,EAAE,SAAS,WAAW,EAAE,EAC7B,cAAc,SAAI,EAClB,aAAa,SAAiC,GAC7C,WAAW,GAAG,IAAI,CAOpB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,iBAAiB,EAAE,CAgC1E;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,EACrB,IAAI,EACJ,cAAkB,EAClB,OAAkC,EAClC,UAAwC,EACxC,aAA8C,EAC9C,iBAAuD,EACvD,SAAgB,EAChB,GAAiB,GAClB,EAAE,WAAW,GAAG,YAAY,GAAG,IAAI,CAsFnC"}