copilotkit 1.54.0 → 2.0.1

package/src/types.d.ts

@@ -0,0 +1,227 @@
+/**
+ * Agent framework options — matches CopilotKit CLI supported frameworks.
+ *
+ * Each value corresponds to a supported agent integration target that
+ * CopilotKit Intelligence can scaffold or connect to.
+ */
+export type AgentFramework = 'langgraph-py' | 'langgraph-js' | 'flows' | 'mastra' | 'pydantic-ai' | 'llamaindex' | 'agno' | 'ag2' | 'adk' | 'aws-strands-py' | 'a2a' | 'microsoft-agent-framework-dotnet' | 'microsoft-agent-framework-py' | 'mcp-apps' | 'agentcore-langgraph' | 'agentcore-strands' | 'a2ui' | 'opengenui';
+/**
+ * Runtime list of all supported agent frameworks.
+ *
+ * Used for validation of CLI flags and any other user-provided framework
+ * values before they are used as template keys.
+ */
+export declare const AGENT_FRAMEWORKS: readonly ["langgraph-py", "langgraph-js", "flows", "mastra", "pydantic-ai", "llamaindex", "agno", "ag2", "adk", "aws-strands-py", "a2a", "microsoft-agent-framework-dotnet", "microsoft-agent-framework-py", "mcp-apps", "agentcore-langgraph", "agentcore-strands", "a2ui", "opengenui"];
+/**
+ * User-facing aliases for `--framework`/`-f` values.
+ *
+ * Alias keys resolve to canonical {@link AgentFramework} values before
+ * validation. Used to keep legacy or user-friendly names working without
+ * proliferating canonical IDs.
+ */
+export declare const FRAMEWORK_ALIASES: Record<string, AgentFramework>;
+/**
+ * Resolves a user-supplied framework string through {@link FRAMEWORK_ALIASES}.
+ *
+ * Returns the canonical framework value when an alias is matched, or the
+ * input unchanged. Validation against {@link AGENT_FRAMEWORKS} happens
+ * separately via {@link isAgentFramework}.
+ *
+ * @param value - User-provided framework identifier or alias.
+ * @returns The canonical framework string.
+ */
+export declare function resolveFrameworkAlias(value: string): string;
+/**
+ * Structured template source with explicit branch support.
+ *
+ * Used when the branch name contains `/` characters that break URL parsing.
+ */
+export interface TemplateSource {
+    owner: string;
+    repo: string;
+    branch: string;
+    path: string;
+}
+/**
+ * Emoji markers shown next to each framework in interactive prompts and
+ * completion messages. Mirrors the set used by the legacy CopilotKit CLI.
+ */
+export declare const FRAMEWORK_EMOJI: Record<AgentFramework, string>;
+/**
+ * Framework display labels for interactive prompts.
+ *
+ * Each entry pairs a human-readable label with its corresponding
+ * {@link AgentFramework} value for use in ink select-input components.
+ */
+export declare const FRAMEWORK_CHOICES: Array<{
+    label: string;
+    value: AgentFramework;
+}>;
+/**
+ * Checks whether a string is one of the supported CLI framework identifiers.
+ *
+ * @param value - User-provided framework string.
+ * @returns `true` when the value is a supported {@link AgentFramework}.
+ */
+export declare function isAgentFramework(value: string): value is AgentFramework;
+/**
+ * Builds the user-facing invalid-framework error for CLI validation failures.
+ *
+ * @param value - Unsupported framework string provided by the user.
+ * @returns A human-readable validation error message.
+ */
+export declare function formatInvalidFrameworkError(value: string): string;
+export declare const TEMPLATE_REPOS: Record<AgentFramework, string | TemplateSource>;
+/**
+ * Template metadata used by `copilotkit init` to resolve scaffold behavior.
+ */
+export interface InitTemplateDefinition {
+    /** Stable identifier for the template choice. */
+    id: string;
+    /** Source used by the scaffold service to fetch the template. */
+    template: string | TemplateSource;
+    /** Whether the scaffold path must authenticate and issue a license key. */
+    requiresLicense: boolean;
+    /** Success flair shown when scaffolding completes. */
+    successEmoji: string;
+    /** Runtime and setup prerequisites expected by the scaffolded template. */
+    prerequisites: InitTemplatePrerequisite[];
+    /** Command used to install project dependencies after scaffolding. */
+    installCommand: string;
+    /** Additional setup commands needed after dependency installation. */
+    postInstallCommands?: string[];
+    /** Command used to run the scaffolded project after dependencies are ready. */
+    runCommand: string;
+    /** Environment variables the user should set before running the template. */
+    environment: InitTemplateEnvironmentKey[];
+    /**
+     * Optional template-specific patcher run after files land but before git init.
+     *
+     * Used by frameworks like AgentCore that need to specialize a generic
+     * template into a framework-specific variant, or by showcase frameworks
+     * (a2ui, opengenui) that need a sidecar config file written into the
+     * scaffolded project.
+     */
+    postScaffold?: (projectDir: string) => Promise<void>;
+}
+/** Tool or runtime needed by an init template. */
+export interface InitTemplatePrerequisite {
+    /** Executable name used for PATH checks. */
+    command: string;
+    /** Human-readable prerequisite label. */
+    label: string;
+    /** Whether the prerequisite is needed during setup or only while running. */
+    phase: 'setup' | 'runtime';
+    /** Template-specific install guidance shown when the command is missing. */
+    installHint: string;
+}
+/** Environment variable metadata shown in init next steps. */
+export interface InitTemplateEnvironmentKey {
+    /** Environment variable name. */
+    key: string;
+    /** Whether the template cannot run usefully without this value. */
+    required: boolean;
+    /** Short user-facing note about how the value is used. */
+    note: string;
+}
+/**
+ * Catalog of standard framework templates.
+ *
+ * These templates scaffold without requiring CLI authentication or license
+ * issuance.
+ */
+export declare const FRAMEWORK_TEMPLATES: Record<AgentFramework, InitTemplateDefinition>;
+/**
+ * Explicit template metadata for the langgraph-python-threads example.
+ *
+ * Uses structured fields instead of a URL because the branch name contains a
+ * `/` which breaks URL-based parsing.
+ */
+export declare const THREADS_TEMPLATE: InitTemplateDefinition;
+/**
+ * Shape of user/org data returned by ops-api after successful CLI authentication.
+ *
+ * Received from the `/cli/auth/callback` endpoint and used to populate
+ * the local {@link StoredAuth} credential store.
+ */
+export interface AuthPayload {
+    /** Short-lived CLI session token issued by ops-api. */
+    cliToken: string;
+    /** Authenticated user record. */
+    user: {
+        id: string;
+        email: string;
+        name: string | null;
+    };
+    /** Organization the user authenticated under. */
+    organization: {
+        clerkOrgId: string;
+        organizationName?: string;
+    };
+}
+/**
+ * Scope accepted by CLI license listing requests.
+ */
+export type CliLicenseScope = 'org' | 'user';
+/**
+ * License metadata returned by the authenticated CLI license API.
+ */
+export interface CliLicenseRecord {
+    /** Stable license identifier. */
+    license_id: string;
+    /** Issued license tier. */
+    tier: string;
+    /** Maximum seat count for the license. */
+    seat_limit: number;
+    /** Feature flags embedded in the license payload. */
+    features: Record<string, boolean>;
+    /** Whether the license grants remove-branding rights. */
+    remove_branding: boolean;
+    /** Timestamp when the license was formally issued, or null when pending. */
+    issued_at: string | null;
+    /** Timestamp when the license expires. */
+    expires_at: string;
+    /** Timestamp when the license row was created. */
+    created_at: string;
+}
+/**
+ * Shape stored in the copilotkit-auth conf store on disk.
+ *
+ * Written after a successful login and read by subsequent CLI commands
+ * that require an authenticated session.
+ */
+export interface StoredAuth {
+    /** CLI session token used to authenticate requests to ops-api. */
+    cliToken: string;
+    /** Stable identifier for the authenticated user. */
+    userId: string;
+    /** Email address of the authenticated user. */
+    email: string;
+    /** Active Clerk organization identifier for the authenticated session. */
+    clerkOrgId: string;
+    /** Display name for the authenticated organization, when available. */
+    organizationName?: string;
+}
+/**
+ * Shape of init options after flag parsing and interactive prompts are resolved.
+ *
+ * Represents the fully-resolved configuration for a `copilotkit init` invocation,
+ * ready to be handed to the scaffold service.
+ */
+export interface InitOptions {
+    /** Human-readable name for the project being initialized. */
+    name: string;
+    /** Whether the user chose the Intelligence (threads) path. */
+    intelligence: boolean;
+    /** Target agent framework — only set when intelligence is false. */
+    framework: AgentFramework | null;
+}
+/**
+ * Resolves the init template metadata for the supplied scaffold options.
+ *
+ * @param options - Resolved init options that determine the scaffold path.
+ * @returns The template definition that should drive scaffolding.
+ * @throws {Error} When a non-threads scaffold is missing a framework.
+ */
+export declare function resolveInitTemplate(options: Pick<InitOptions, 'intelligence' | 'framework'>): InitTemplateDefinition;
+//# sourceMappingURL=types.d.ts.map

package/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../apps/cli/src/types.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,cAAc,GACd,OAAO,GACP,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,MAAM,GACN,KAAK,GACL,KAAK,GACL,gBAAgB,GAChB,KAAK,GACL,kCAAkC,GAClC,8BAA8B,GAC9B,UAAU,GACV,qBAAqB,GACrB,mBAAmB,GACnB,MAAM,GACN,WAAW,CAAC;AAEhB;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,2RAmBiB,CAAC;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAE5D,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAmB1D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,CAAC;CACvB,CA8CA,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjE;AA2BD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,cAAc,CA4B1E,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,iEAAiE;IACjE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAC;IAClC,2EAA2E;IAC3E,eAAe,EAAE,OAAO,CAAC;IACzB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,aAAa,EAAE,wBAAwB,EAAE,CAAC;IAC1C,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,WAAW,EAAE,0BAA0B,EAAE,CAAC;IAC1C;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,8DAA8D;AAC9D,MAAM,WAAW,0BAA0B;IACzC,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,QAAQ,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;CACd;AA8FD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CACtC,cAAc,EACd,sBAAsB,CA0HvB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,sBAc9B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACzD,iDAAiD;IACjD,YAAY,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,yDAAyD;IACzD,eAAe,EAAE,OAAO,CAAC;IACzB,4EAA4E;IAC5E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,YAAY,EAAE,OAAO,CAAC;IACtB,oEAAoE;IACpE,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,GAAG,WAAW,CAAC,GACvD,sBAAsB,CAgBxB"}

package/src/ui/banner.d.ts

@@ -0,0 +1,3 @@
+/** Renders the kite banner above interactive CLI flows. */
+export declare function Banner(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=banner.d.ts.map

package/src/ui/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/ui/banner.tsx"],"names":[],"mappings":"AAsBA,2DAA2D;AAC3D,wBAAgB,MAAM,4CAOrB"}

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

@@ -0,0 +1,71 @@
+import { type ReactElement, type ReactNode } from "react";
+import { login as defaultLogin } from "../services/auth.service.js";
+/** Message shown before the CLI opens the browser for authentication. */
+export declare const BROWSER_LOGIN_CONFIRMATION_MESSAGE = "Sign in to your \uD83E\uDE81 CopilotKit account in your browser.";
+/** Prompt shown after the pre-login explanation. */
+export declare const BROWSER_LOGIN_CONFIRMATION_PROMPT = "Press Enter to continue...";
+/** 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";
+/** User and organization data displayed after a successful login. */
+export interface BrowserLoginIdentity {
+    /** Authenticated user email. */
+    email: string;
+    /** Authenticated organization display name or Clerk organization id. */
+    organizationName: string;
+}
+/** Current state exposed by {@link useBrowserLogin}. */
+export interface BrowserLoginState {
+    /** Current interaction phase. */
+    phase: BrowserLoginPhase;
+    /** Authenticated identity, available after success. */
+    identity: BrowserLoginIdentity | null;
+    /** User-facing error message, available after failure. */
+    errorMessage: string;
+}
+/** Context value exposed by {@link BrowserLoginProvider}. */
+export interface BrowserLoginContextValue {
+    /** Runs the shared browser login flow, including confirmation when interactive. */
+    runLogin: BrowserLoginRunner;
+    /** Current browser login UI state. */
+    state: BrowserLoginState;
+    /** Confirms that the browser login may begin. */
+    confirmBrowserLoginStart: () => unknown;
+}
+/** Props for {@link BrowserLoginProvider}. */
+export interface BrowserLoginProviderProps {
+    /** Child Ink tree that can call {@link useBrowserLogin}. */
+    children: ReactNode;
+    /** Injectable login implementation, primarily for tests. */
+    loginRunner?: BrowserLoginRunner;
+    /** Overrides TTY detection, primarily for tests. */
+    isInteractive?: boolean;
+}
+/**
+ * Returns whether the CLI should pause for a browser-login confirmation.
+ *
+ * @returns True when both standard input and output are interactive TTYs.
+ */
+export declare function isBrowserLoginConfirmationInteractive(): boolean;
+/**
+ * Provides a shared browser-login runner and UI state to CLI Ink flows.
+ *
+ * @param props - Provider props.
+ * @returns Provider element for descendant command UI.
+ */
+export declare function BrowserLoginProvider({ children, loginRunner, isInteractive, }: BrowserLoginProviderProps): ReactElement;
+/**
+ * Reads the shared browser-login runner and UI state.
+ *
+ * @returns Browser-login context value.
+ * @throws When rendered outside {@link BrowserLoginProvider}.
+ */
+export declare function useBrowserLogin(): BrowserLoginContextValue;
+/**
+ * Renders the shared browser-login confirmation and result states.
+ *
+ * @returns Ink element for the current browser-login phase.
+ */
+export declare function BrowserLoginConfirmation(): ReactElement | null;
+//# sourceMappingURL=browser-login.d.ts.map

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

@@ -0,0 +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"}

package/src/ui/init-flow.d.ts

@@ -0,0 +1,35 @@
+import type { InitOptions } from "../types.js";
+/** Props for the {@link InitFlow} component. */
+export interface InitFlowProps {
+    /** Pre-filled project name from --name flag, or `null` to prompt. */
+    initialName: string | null;
+    /** Pre-selected via --intelligence flag, or `null` to prompt. */
+    initialIntelligence: boolean | null;
+    /** Pre-selected via --framework flag, or `null` to prompt. */
+    initialFramework: string | null;
+    /**
+     * Callback invoked when all prompts are complete.
+     *
+     * Receives a fully-resolved {@link InitOptions} object, or `null` when the
+     * user cancels (future extension point).
+     */
+    onComplete: (options: InitOptions | null) => void;
+    /**
+     * Callback invoked when the user wants to sign up for threads access.
+     *
+     * The init flow renders the mailing list screen; this callback fires the
+     * API request. When it resolves, the flow returns to the password screen.
+     */
+    onRequestThreadsAccess: () => Promise<void>;
+}
+/**
+ * Ink component that steps through the interactive `init` prompts.
+ *
+ * Flow:
+ * 1. Project name
+ * 2. Do you want Intelligence?
+ *    - Yes → password gate (or skip if already unlocked) → done with threads template
+ *    - No  → framework picker → done with framework template
+ */
+export declare function InitFlow({ initialName, initialIntelligence, initialFramework, onComplete, onRequestThreadsAccess, }: InitFlowProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=init-flow.d.ts.map

package/src/ui/init-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-flow.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/ui/init-flow.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,aAAa,CAAC;AA4B/D,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iEAAiE;IACjE,mBAAmB,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,8DAA8D;IAC9D,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;;;OAKG;IACH,UAAU,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAClD;;;;;OAKG;IACH,sBAAsB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AA0BD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,EACvB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,EACV,sBAAsB,GACvB,EAAE,aAAa,kDA4Of"}

package/src/ui/kite-game.d.ts

@@ -0,0 +1,26 @@
+import type { ReactElement } from 'react';
+import { type KiteGameRng } from '../services/kite-game-engine.js';
+/** Props for the {@link KiteGame} component. */
+export interface KiteGameProps {
+    /** Random source used by the deterministic game engine. */
+    readonly rng?: KiteGameRng;
+    /** Interval between engine ticks in milliseconds. */
+    readonly tickMs?: number;
+    /** Called when the player quits the game. */
+    readonly onExit?: () => void;
+}
+/**
+ * Renders the hidden terminal kite game.
+ *
+ * @param props - Component configuration.
+ * @returns The Ink game UI.
+ */
+export declare function KiteGame({ rng, tickMs, onExit, }: KiteGameProps): ReactElement;
+/**
+ * Converts terminal width into the playable board width.
+ *
+ * @param terminalWidth - Terminal column count.
+ * @returns Playable board width in terminal cells.
+ */
+export declare function getPlayableWidth(terminalWidth: number): number;
+//# sourceMappingURL=kite-game.d.ts.map

package/src/ui/kite-game.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kite-game.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/ui/kite-game.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,EAML,KAAK,WAAW,EAEjB,MAAM,iCAAiC,CAAC;AAMzC,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC;IAE3B,qDAAqD;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CAC9B;AAMD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,EACvB,GAAiB,EACjB,MAAwB,EACxB,MAAM,GACP,EAAE,aAAa,GAAG,YAAY,CA4G9B;AAuCD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/src/ui/login-flow.d.ts

@@ -0,0 +1,22 @@
+/** Props for the {@link LoginFlow} component. */
+interface LoginFlowProps {
+    /**
+     * Callback invoked once the login attempt has settled.
+     *
+     * @param result - Final login result.
+     */
+    onComplete: (result: {
+        error?: Error;
+        success: boolean;
+    }) => void;
+}
+/**
+ * Ink component that drives the browser-based login flow.
+ *
+ * On mount it calls the shared browser-login runner, renders the shared
+ * confirmation and status UI, then notifies the caller when the attempt has
+ * settled.
+ */
+export declare function LoginFlow({ onComplete }: LoginFlowProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=login-flow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"login-flow.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/ui/login-flow.tsx"],"names":[],"mappings":"AAMA,iDAAiD;AACjD,UAAU,cAAc;IACtB;;;;OAIG;IACH,UAAU,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CACnE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,EAAE,UAAU,EAAE,EAAE,cAAc,2CAoBvD"}

package/src/ui/spinner.d.ts

@@ -0,0 +1,9 @@
+/** Props for the {@link Spinner} component. */
+interface SpinnerProps {
+    /** Label displayed next to the spinner. */
+    label: string;
+}
+/** Spinner with a label, animated as a kite drifting on the wind. */
+export declare function Spinner({ label }: SpinnerProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=spinner.d.ts.map

package/src/ui/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/ui/spinner.tsx"],"names":[],"mappings":"AAGA,+CAA+C;AAC/C,UAAU,YAAY;IACpB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;CACf;AAoBD,qEAAqE;AACrE,wBAAgB,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,YAAY,2CAiB9C"}

package/LICENSE

@@ -1,21 +0,0 @@
-The MIT License
-
-Copyright (c) Atai Barkai
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.

package/README.md

@@ -1,83 +0,0 @@
-# 🪁 CopilotKit CLI
-
-> **NOTE:** The CopilotKit CLI is an optional tool that enhances the developer experience of CopilotKit. [It is not required to use CopilotKit. Click here to get started with CopilotKit](https://docs.copilotkit.ai)..
-
-[![Version](https://img.shields.io/npm/v/copilotkit.svg)](https://npmjs.org/package/copilotkit)
-[![Downloads/week](https://img.shields.io/npm/dw/copilotkit.svg)](https://npmjs.org/package/copilotkit)
-
-- [Installation](#installation)
-- [Commands](#commands)
-  - [init](#init-add-copilotkit-to-your-nextjs-project)
-  - [login](#login-authenticating-with-copilot-cloud)
-  - [dev](#dev-local-endpoint-development)
-- [Need help?](#need-help)
-
-## What is the CopilotKit CLI?
-
-The CopilotKit CLI boosts your [CopilotKit](https://github.com/copilotkit/copilotkit) development experience. It integrates neatly with Copilot Cloud.
-
-## Installation
-
-```sh
-# npm
-npm install -g copilotkit
-
-# pnpm
-pnpm install -g copilotkit
-
-# yarn
-yarn global add copilotkit
-```
-
-## Commands
-
-### `init`: Add CopilotKit to your Next.js project
-
-The fastest way to add CopilotKit to your Next.js project is with the init command:
-
-```sh
-# Navigate to your Next.js project
-cd my-nextjs-app
-
-# Run the init command
-copilotkit init
-```
-
-This interactive command will:
-
-- Set up the required UI components
-- Configure AI agents if desired (LangGraph, CrewAI)
-- Connect to Copilot Cloud (optional)
-- Create all necessary configuration files
-
-You can also pass flags to automate the setup:
-
-```sh
-copilotkit init --mode LangGraph
-```
-
-### `login`: Authenticating with Copilot Cloud
-
-First, ensure you have an account on [Copilot Cloud](https://cloud.copilotkit.ai).
-
-Then, run the following command to authenticate with Copilot Cloud:
-
-```sh
-copilotkit login
-```
-
-### `dev`: Local Endpoint Development
-
-The CopilotKit CLI allows you to create a local tunnel to your CopilotKit remote endpoints, agents, and LangGraph apps.
-
-For example, to create a local tunnel to an endpoint running locally on port 8000, you can run:
-
-```sh
-copilotkit dev --port 8000
-```
-
-## Need help?
-
-You can always run `copilotkit --help` to get help on the CopilotKit CLI.
-
-You're welcome to join our [Discord](https://discord.gg/copilotkit) to get help from the CopilotKit team and community.

package/bin/dev.cmd

@@ -1,3 +0,0 @@
-@echo off
-
-node --loader ts-node/esm --no-warnings=ExperimentalWarning "%~dp0\dev" %*

package/bin/dev.js

@@ -1,8 +0,0 @@
-#!/usr/bin/env -S node --loader ts-node/esm --disable-warning=ExperimentalWarning
-
-// eslint-disable-next-line n/shebang
-import {execute} from '@oclif/core'
-
-process.env.SENTRY_DISABLED = 'true'
-process.env.SEGMENT_DISABLED = 'true'
-await execute({development: true, dir: import.meta.url})

package/bin/run.cmd

@@ -1,3 +0,0 @@
-@echo off
-
-node "%~dp0\run" %*

package/bin/run.js

@@ -1,17 +0,0 @@
-#!/usr/bin/env node
-
-import {execute} from '@oclif/core'
-
-const main = async () => {
-  try {
-    await execute({dir: import.meta.url})
-  } catch (error) {
-    // Rely on command-level error handling to surface friendly messages.
-    // If we reach here it means something happened before oclif handed off to the command.
-    const message = error?.message || 'Unknown error'
-    console.error(message)
-    process.exitCode = 1
-  }
-}
-
-void main()

package/dist/commands/base-command.d.ts

@@ -1,12 +0,0 @@
-import { Command } from '@oclif/core';
-
-declare class BaseCommand extends Command {
-    init(): Promise<void>;
-    catch(err: any): Promise<void>;
-    finally(): Promise<void>;
-    run(): Promise<void>;
-    checkCLIVersion(): Promise<void>;
-    gracefulError(message: string): Promise<void>;
-}
-
-export { BaseCommand };

package/dist/commands/base-command.js

@@ -1,65 +0,0 @@
-// src/commands/base-command.ts
-import { Command } from "@oclif/core";
-import Sentry, { consoleIntegration } from "@sentry/node";
-
-// src/utils/version.ts
-var LIB_VERSION = "1.54.0";
-
-// src/utils/trpc.ts
-import { createTRPCClient as trpcClient, httpBatchLink } from "@trpc/client";
-import superjson from "superjson";
-var COPILOT_CLOUD_BASE_URL = process.env.COPILOT_CLOUD_BASE_URL || "https://cloud.copilotkit.ai";
-
-// src/commands/base-command.ts
-import chalk from "chalk";
-var BaseCommand = class extends Command {
-  async init() {
-    await this.checkCLIVersion();
-    if (process.env.SENTRY_DISABLED === "true") {
-      return;
-    }
-    Sentry.init({
-      dsn: process.env.SENTRY_DSN || "https://1eea15d32e2eacb0456a77db5e39aeeb@o4507288195170304.ingest.us.sentry.io/4508581448581120",
-      integrations: [consoleIntegration()],
-      // Tracing
-      tracesSampleRate: 1
-      //  Capture 100% of the transactions
-    });
-  }
-  async catch(err) {
-    if (process.env.SENTRY_DISABLED !== "true") {
-      Sentry.captureException(err);
-    }
-    const message = err?.message ?? "Unknown error";
-    this.log("\n" + chalk.red(message) + "\n");
-    const exitCode = err?.oclif?.exit ?? 1;
-    this.exit(exitCode);
-  }
-  async finally() {
-    if (process.env.SENTRY_DISABLED === "true") {
-      return;
-    }
-    Sentry.close();
-  }
-  async run() {
-  }
-  async checkCLIVersion() {
-    try {
-      const response = await fetch(`${COPILOT_CLOUD_BASE_URL}/api/healthz`);
-      const data = await response.json();
-      const cloudVersion = data.cliVersion;
-      if (!cloudVersion || cloudVersion === LIB_VERSION) {
-        return;
-      }
-    } catch {
-    }
-  }
-  async gracefulError(message) {
-    this.log("\n" + chalk.red(message));
-    process.exit(1);
-  }
-};
-export {
-  BaseCommand
-};
-//# sourceMappingURL=base-command.js.map