copilotkit 2.0.2 → 2.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "copilotkit",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "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/services/auth.service.d.ts

@@ -30,6 +30,37 @@ export declare function startCallbackServer(expectedState: string): Promise<{
     resultPromise: Promise<CallbackResult>;
     server: http.Server;
 }>;
+/**
+ * Origin of the Clerk token resolved during a CLI login attempt.
+ */
+export type ClerkTokenSource = "callback" | "manual";
+/**
+ * Races the loopback callback against an optional manual paste promise so
+ * either path can complete the login flow.
+ *
+ * Both inputs are guarded with rejection handlers because the loser may stay
+ * pending or reject after the winner is consumed; a hanging or rejected loser
+ * must not produce an unhandled rejection or block cleanup.
+ *
+ * @param resultPromise - Loopback callback result for the CLI auth state.
+ * @param manualClerkToken - Optional manual paste promise.
+ * @returns The resolved Clerk token and the path that produced it.
+ */
+export declare function raceForClerkToken(resultPromise: Promise<CallbackResult>, manualClerkToken: Promise<string> | undefined): Promise<{
+    clerkToken: string;
+    source: ClerkTokenSource;
+}>;
+/**
+ * Optional inputs that adjust how {@link login} resolves the Clerk token.
+ */
+export interface LoginOptions {
+    /**
+     * Promise that resolves with a manually pasted Clerk token. Races against
+     * the loopback callback so the CLI can recover when the browser redirect
+     * never reaches the local callback server.
+     */
+    manualClerkToken?: Promise<string>;
+}
 /**
  * Launches the browser-based login flow, waits for the callback, exchanges
  * the Clerk token for a CLI session token, persists the credentials, and
@@ -39,13 +70,15 @@ export declare function startCallbackServer(expectedState: string): Promise<{
  * 1. Generate a random CSRF state token.
  * 2. Start a local callback server.
  * 3. Open the browser to the ops-frontend CLI auth page.
- * 4. Wait for the callback with the Clerk token.
+ * 4. Wait for the callback with the Clerk token, or accept a manually pasted
+ *    token from {@link LoginOptions.manualClerkToken} when supplied.
  * 5. Exchange the Clerk token for a CLI session via ops-api.
  * 6. Persist credentials to the auth store.
  *
+ * @param options - Optional login overrides such as a manual paste token.
  * @returns The authenticated user and organization from the ops-api response.
  */
-export declare function login(): Promise<{
+export declare function login(options?: LoginOptions): Promise<{
     user: {
         id: string;
         email: string;
@@ -55,6 +88,7 @@ export declare function login(): Promise<{
         clerkOrgId: string;
         organizationName?: string;
     };
+    source: ClerkTokenSource;
 }>;
 export interface VerifyAndRefreshOptions {
     /** When true, preserve the specific auth/session error instead of returning null. */

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

@@ -1 +1 @@
-{"version":3,"file":"auth.service.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/services/auth.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAmB,MAAM,iBAAiB,CAAC;AASlE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAI7D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACvC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;CACrB,CAAC,CA8ID;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,KAAK,IAAI,OAAO,CAAC;IACrC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACzD,YAAY,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE,CAAC,CA2GD;AAED,MAAM,WAAW,uBAAuB;IACtC,qFAAqF;IACrF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,gCAAgC,oFACsC,CAAC;AAEpF;;;;;;;;;GASG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,cAAc,CAOzB;AAED;;;;;;GAMG;AACH,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAO9E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CA2BvC;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAa5C"}
+{"version":3,"file":"auth.service.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/services/auth.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAmB,MAAM,iBAAiB,CAAC;AASlE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAI7D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACvC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;CACrB,CAAC,CA8ID;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,QAAQ,CAAC;AASrD;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,EACtC,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,GAC5C,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAqB3D;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC;IAC/D,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACzD,YAAY,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,MAAM,EAAE,gBAAgB,CAAC;CAC1B,CAAC,CAiID;AAED,MAAM,WAAW,uBAAuB;IACtC,qFAAqF;IACrF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,gCAAgC,oFACsC,CAAC;AAEpF;;;;;;;;;GASG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,cAAc,CAOzB;AAED;;;;;;GAMG;AACH,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAO9E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CA2BvC;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAa5C"}

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/ui/browser-login.d.ts

@@ -7,7 +7,7 @@ export declare const BROWSER_LOGIN_CONFIRMATION_PROMPT = "Press Enter to continu
 /** Browser login function shape shared by command flows. */
 export type BrowserLoginRunner = typeof defaultLogin;
 /** Rendered state for the shared browser-login interaction. */
-export type BrowserLoginPhase = "idle" | "confirming" | "waiting" | "success" | "error";
+export type BrowserLoginPhase = "idle" | "confirming" | "waiting" | "finalizing" | "success" | "error";
 /** User and organization data displayed after a successful login. */
 export interface BrowserLoginIdentity {
     /** Authenticated user email. */
@@ -32,6 +32,8 @@ export interface BrowserLoginContextValue {
     state: BrowserLoginState;
     /** Confirms that the browser login may begin. */
     confirmBrowserLoginStart: () => unknown;
+    /** Submits a manually pasted Clerk token to complete login when the loopback callback never fires. */
+    submitManualClerkToken: (clerkToken: string) => unknown;
 }
 /** Props for {@link BrowserLoginProvider}. */
 export interface BrowserLoginProviderProps {
@@ -62,6 +64,8 @@ export declare function BrowserLoginProvider({ children, loginRunner, isInteract
  * @throws When rendered outside {@link BrowserLoginProvider}.
  */
 export declare function useBrowserLogin(): BrowserLoginContextValue;
+/** Hint shown beneath the spinner so users know about the manual paste fallback. */
+export declare const BROWSER_LOGIN_MANUAL_PASTE_LABEL = "If your browser finished sign-in but the CLI didn't notice, paste the code shown in the browser:";
 /**
  * Renders the shared browser-login confirmation and result states.
  *

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;AAEf,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,SAAS,GACT,OAAO,CAAC;AAEZ,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;CACzC;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;AAmBD;;;;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,CA4F1C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,wBAAwB,CAO1D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,YAAY,GAAG,IAAI,CAiD9D"}
+{"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"}