copilotkit 1.54.0 → 2.0.0

package/src/services/cli-auth-diagnostics.d.ts

@@ -0,0 +1,71 @@
+/** Shared CLI diagnostics log path retained for auth-specific imports/tests. */
+export { CLI_LOG_PATH as CLI_AUTH_DIAGNOSTICS_LOG_PATH } from "./cli-logs.js";
+/** Sanitized hosted CLI auth event captured in the browser flow. */
+export interface HostedCliAuthDiagnosticEvent {
+    at: string;
+    details?: Record<string, unknown>;
+    phase: string;
+}
+/** Sanitized hosted CLI auth snapshot handed back to the local CLI callback. */
+export interface HostedCliAuthDiagnosticSnapshot {
+    events: HostedCliAuthDiagnosticEvent[];
+    flowId: string;
+}
+/** Active CLI auth diagnostics session. */
+export interface CliAuthDiagnostics {
+    readonly runId: string;
+    logError(phase: string, error: unknown, details?: Record<string, unknown>): void;
+    logHostedSnapshot(snapshot: HostedCliAuthDiagnosticSnapshot): void;
+    logPhase(phase: string, details?: Record<string, unknown>): void;
+}
+/**
+ * Summarizes a loopback callback URL without including auth query values.
+ *
+ * @param rawUrl - URL to summarize.
+ * @returns Safe callback metadata for diagnostics.
+ */
+export declare function summarizeCallbackUrl(rawUrl: string): Record<string, unknown>;
+/**
+ * Summarizes a state token without logging its full value.
+ *
+ * @param value - State token to summarize.
+ * @returns Redacted state metadata.
+ */
+export declare function summarizeState(value: string | null | undefined): Record<string, unknown>;
+/**
+ * Parses a hosted CLI auth diagnostics snapshot from the loopback callback.
+ *
+ * @param raw - Raw query parameter value.
+ * @returns A sanitized snapshot or null when absent/invalid.
+ */
+export declare function parseHostedCliAuthDiagnosticSnapshot(raw: string | null): HostedCliAuthDiagnosticSnapshot | null;
+/**
+ * Creates a temporary CLI auth diagnostics session.
+ *
+ * @param runId - Correlation id for the login attempt.
+ * @returns Logger that mirrors high-signal events to stderr and the CLI log.
+ */
+export declare function createCliAuthDiagnostics(runId: string): CliAuthDiagnostics;
+/**
+ * Controls whether CLI auth diagnostics are mirrored to stderr.
+ *
+ * Deprecated compatibility wrapper around the shared CLI logs setting.
+ *
+ * @param verbose - Whether stderr mirroring should be enabled.
+ */
+export declare function setCliAuthDiagnosticsVerbose(verbose: boolean): void;
+/**
+ * Returns whether CLI auth diagnostics are currently mirrored to stderr.
+ *
+ * @returns Current stderr mirroring state.
+ */
+export declare function isCliAuthDiagnosticsVerboseEnabled(): boolean;
+/**
+ * Returns a concrete error instance for user-facing CLI error propagation.
+ *
+ * @param error - Unknown thrown value.
+ * @param fallbackMessage - Message to use when no concrete error exists.
+ * @returns An Error instance.
+ */
+export declare function toConcreteError(error: unknown, fallbackMessage: string): Error;
+//# sourceMappingURL=cli-auth-diagnostics.d.ts.map

package/src/services/cli-auth-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-auth-diagnostics.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/services/cli-auth-diagnostics.ts"],"names":[],"mappings":"AAOA,gFAAgF;AAChF,OAAO,EAAE,YAAY,IAAI,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAE9E,oEAAoE;AACpE,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,gFAAgF;AAChF,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,4BAA4B,EAAE,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjF,iBAAiB,CAAC,QAAQ,EAAE,+BAA+B,GAAG,IAAI,CAAC;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAClE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAY5E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUxF;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,GAAG,EAAE,MAAM,GAAG,IAAI,GACjB,+BAA+B,GAAG,IAAI,CA8CxC;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAoD1E;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,IAAI,OAAO,CAE5D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,eAAe,EAAE,MAAM,GACtB,KAAK,CAUP"}

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

@@ -0,0 +1,45 @@
+/** Private per-user directory used by the CLI for structured diagnostics. */
+export declare const CLI_LOG_DIRECTORY: string;
+/** Shared per-user log file used by the CLI for structured diagnostics. */
+export declare const CLI_LOG_PATH: string;
+/**
+ * Returns the resolved filesystem path of the CLI log file.
+ *
+ * @returns Absolute CLI log path.
+ */
+export declare function getCliLogPath(): string;
+/**
+ * Controls whether high-signal CLI diagnostics are mirrored to stderr.
+ *
+ * @param verbose - Whether stderr mirroring should be enabled.
+ */
+export declare function setCliLogsVerbose(verbose: boolean): void;
+/**
+ * Returns whether CLI diagnostics are currently mirrored to stderr.
+ *
+ * @returns Current stderr mirroring state.
+ */
+export declare function isCliLogsVerboseEnabled(): boolean;
+/**
+ * Writes a structured log event to the shared CLI log file.
+ *
+ * @param level - Log level.
+ * @param payload - Structured payload to append.
+ */
+export declare function writeCliLog(level: "error" | "info", payload: Record<string, unknown>): void;
+/**
+ * Mirrors a formatted diagnostics line to stderr when verbose mode is enabled.
+ *
+ * @param prefix - User-facing log prefix.
+ * @param phase - Phase identifier.
+ * @param details - Sanitized metadata to render.
+ */
+export declare function maybeWriteCliVerboseLine(prefix: string, phase: string, details: Record<string, unknown>): void;
+/**
+ * Reads the last `count` lines from the shared CLI log file.
+ *
+ * @param count - Number of trailing lines to return.
+ * @returns Trailing log lines, or an empty array when the file does not exist.
+ */
+export declare function readCliLogTail(count: number): string[];
+//# sourceMappingURL=cli-logs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-logs.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/services/cli-logs.ts"],"names":[],"mappings":"AAKA,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,QAG7B,CAAC;AACF,2EAA2E;AAC3E,eAAO,MAAM,YAAY,QAA0C,CAAC;AAyDpE;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,GAAG,MAAM,EACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAMN;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA6BtD"}

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

@@ -0,0 +1,53 @@
+import type { StoredAuth } from '../types.js';
+/**
+ * Persistent store for CLI authentication credentials.
+ *
+ * Wraps the `copilotkit-auth` conf store and provides typed read/write access
+ * to the fields defined by {@link StoredAuth}.
+ */
+export declare const authStore: {
+    /**
+     * Persists all fields of the given {@link StoredAuth} to disk.
+     *
+     * @param auth - The authentication data to store.
+     */
+    save(auth: StoredAuth): void;
+    /**
+     * Reads all stored auth fields and returns them as a {@link StoredAuth} object.
+     *
+     * Returns `null` if no `cliToken` is present in the store.
+     */
+    get(): StoredAuth | null;
+    /**
+     * Reads and returns only the stored CLI token.
+     *
+     * Returns `null` if no token has been saved.
+     */
+    getToken(): string | null;
+    /**
+     * Removes all entries from the auth store.
+     */
+    clear(): void;
+};
+/**
+ * General-purpose persistent key/value store for CLI dev settings.
+ *
+ * Wraps the `copilotkit-config` conf store with generic typed accessors.
+ */
+export declare const configStore: {
+    /**
+     * Retrieves the value stored under the given key.
+     *
+     * @param key - The configuration key to look up.
+     * @returns The stored value cast to `T`, or `undefined` if not present.
+     */
+    get<T>(key: string): T | undefined;
+    /**
+     * Stores `value` under the given key.
+     *
+     * @param key - The configuration key to write.
+     * @param value - The value to store.
+     */
+    set(key: string, value: unknown): void;
+};
+//# sourceMappingURL=config.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.service.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/services/config.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK9C;;;;;GAKG;AACH,eAAO,MAAM,SAAS;IACpB;;;;OAIG;eACQ,UAAU,GAAG,IAAI;IAa5B;;;;OAIG;WACI,UAAU,GAAG,IAAI;IAcxB;;;;OAIG;gBACS,MAAM,GAAG,IAAI;IAIzB;;OAEG;aACM,IAAI;CAGd,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW;IACtB;;;;;OAKG;QACC,CAAC,OAAO,MAAM,GAAG,CAAC,GAAG,SAAS;IAIlC;;;;;OAKG;aACM,MAAM,SAAS,OAAO,GAAG,IAAI;CAGvC,CAAC"}

package/src/services/feature-flags.d.ts

@@ -0,0 +1,14 @@
+/** Hardcoded password for threads access (temporary). */
+export declare const THREADS_PASSWORD = "earlyaccess";
+/**
+ * Checks whether the user has previously unlocked threads access.
+ *
+ * Reads the `threads-access` key from the global config store.
+ * Returns `false` when the key is absent or not `true`.
+ */
+export declare function hasThreadsAccess(): boolean;
+/**
+ * Grants threads access by writing `threads-access: true` to the global config.
+ */
+export declare function grantThreadsAccess(): void;
+//# sourceMappingURL=feature-flags.d.ts.map

package/src/services/feature-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/services/feature-flags.ts"],"names":[],"mappings":"AAEA,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAE9C;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/src/services/kite-game-engine.d.ts

@@ -0,0 +1,99 @@
+/** Width of the default kite game board. */
+export declare const DEFAULT_KITE_GAME_WIDTH = 42;
+/** Height of the default kite game board. */
+export declare const DEFAULT_KITE_GAME_HEIGHT = 20;
+/** Initial X coordinate of the kite. */
+export declare const KITE_X = 8;
+/** Terminal glyph used to render the player kite. */
+export declare const KITE_PLAYER_GLYPH = "\uD83E\uDE81";
+/** Terminal glyph used to render cloud obstacles. */
+export declare const KITE_CLOUD_GLYPH = "\u2601\uFE0F";
+/** Function used to generate deterministic random values. */
+export type KiteGameRng = () => number;
+/** Cloud obstacle in the kite game board. */
+export interface KiteCloud {
+    /** Horizontal position of the cloud column. */
+    readonly x: number;
+    /** First open row in the cloud gap. */
+    readonly gapY: number;
+    /** Height of the open cloud gap. */
+    readonly gapHeight: number;
+    /** Whether the kite already scored for passing this cloud. */
+    readonly passed: boolean;
+}
+/** Complete deterministic kite game state. */
+export interface KiteGameState {
+    /** Board width in terminal cells. */
+    readonly width: number;
+    /** Board height in terminal rows. */
+    readonly height: number;
+    /** Current kite Y coordinate. */
+    readonly kiteY: number;
+    /** Current kite vertical velocity. */
+    readonly velocity: number;
+    /** Current score. */
+    readonly score: number;
+    /** Number of elapsed engine ticks. */
+    readonly tick: number;
+    /** Whether physics and cloud movement have started. */
+    readonly started: boolean;
+    /** Whether the current run has crashed. */
+    readonly crashed: boolean;
+    /** Active cloud obstacles. */
+    readonly clouds: readonly KiteCloud[];
+}
+/** Input options for creating a kite game. */
+export interface CreateKiteGameOptions {
+    /** Board width in terminal cells. */
+    readonly width?: number;
+    /** Board height in terminal rows. */
+    readonly height?: number;
+    /** Random source for deterministic tests. */
+    readonly rng?: KiteGameRng;
+}
+/** Difficulty values derived from the current score. */
+export interface KiteGameDifficulty {
+    /** Number of ticks between cloud movement steps. */
+    readonly moveEveryTicks: number;
+    /** Number of columns between newly spawned clouds. */
+    readonly cloudSpacing: number;
+    /** Height of the safe gap through each cloud. */
+    readonly gapHeight: number;
+}
+/**
+ * Derives progressive game difficulty from score.
+ *
+ * @param score - Current game score.
+ * @returns Difficulty values for the current score.
+ */
+export declare function getKiteGameDifficulty(score: number): KiteGameDifficulty;
+/**
+ * Creates the initial kite game state.
+ *
+ * @param options - Board size and deterministic RNG options.
+ * @returns A fresh kite game state.
+ */
+export declare function createKiteGame(options?: CreateKiteGameOptions): KiteGameState;
+/**
+ * Applies one flap impulse to the kite.
+ *
+ * @param state - Current game state.
+ * @returns Updated game state.
+ */
+export declare function flapKite(state: KiteGameState): KiteGameState;
+/**
+ * Advances the deterministic kite game by one tick.
+ *
+ * @param state - Current game state.
+ * @param rng - Random source for newly spawned clouds.
+ * @returns Updated game state.
+ */
+export declare function tickKiteGame(state: KiteGameState, rng?: KiteGameRng): KiteGameState;
+/**
+ * Renders the current game state into terminal text rows.
+ *
+ * @param state - Current game state.
+ * @returns Board rows suitable for Ink text rendering.
+ */
+export declare function renderKiteGameRows(state: KiteGameState): string[];
+//# sourceMappingURL=kite-game-engine.d.ts.map

package/src/services/kite-game-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kite-game-engine.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/services/kite-game-engine.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,6CAA6C;AAC7C,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,wCAAwC;AACxC,eAAO,MAAM,MAAM,IAAI,CAAC;AAExB,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,iBAAO,CAAC;AAEtC,qDAAqD;AACrD,eAAO,MAAM,gBAAgB,iBAAO,CAAC;AAErC,6DAA6D;AAC7D,MAAM,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC;AAEvC,6CAA6C;AAC7C,MAAM,WAAW,SAAS;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAEnB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,qBAAqB;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;CACvC;AAED,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB,qCAAqC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC;CAC5B;AAED,wDAAwD;AACxD,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,sDAAsD;IACtD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAQD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAMvE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAE,qBAA0B,GAClC,aAAa,CAiBf;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAK5D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,aAAa,EACpB,GAAG,GAAE,WAAyB,GAC7B,aAAa,CA0Cf;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,EAAE,CAcjE"}

package/src/services/kite-game-score.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+/** Config key used to persist the anonymous kite game high score. */
+export declare const KITE_GAME_HIGH_SCORE_KEY = "kite-game-high-score";
+declare const kiteGameHighScoreSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    score: z.ZodNumber;
+}, z.core.$strip>;
+/** Versioned high-score record stored in the CLI config store. */
+export type KiteGameHighScore = z.infer<typeof kiteGameHighScoreSchema>;
+/** Store contract used by the kite high-score service. */
+export interface KiteGameScoreStore {
+    /** Reads a raw value from the backing store. */
+    get<T>(key: string): T | undefined;
+    /** Writes a raw value to the backing store. */
+    set(key: string, value: unknown): void;
+}
+/**
+ * Reads the stored kite game high score.
+ *
+ * @param store - Backing store to read from.
+ * @returns The validated high score, or zero when unset or invalid.
+ */
+export declare function readKiteGameHighScore(store?: KiteGameScoreStore): number;
+/**
+ * Persists a new kite game high score when it beats the current score.
+ *
+ * @param score - Candidate score to save.
+ * @param store - Backing store to write to.
+ * @returns The stored high score after applying the candidate score.
+ */
+export declare function saveKiteGameHighScore(score: number, store?: KiteGameScoreStore): number;
+export {};
+//# sourceMappingURL=kite-game-score.d.ts.map

package/src/services/kite-game-score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kite-game-score.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/services/kite-game-score.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,qEAAqE;AACrE,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAE/D,QAAA,MAAM,uBAAuB;;;iBAG3B,CAAC;AAEH,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAEnC,+CAA+C;IAC/C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACxC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,GAAE,kBAAgC,GAAG,MAAM,CAGrF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,kBAAgC,GAAG,MAAM,CASpG"}

package/src/services/project-scaffold.d.ts

@@ -0,0 +1,49 @@
+import type { TemplateSource } from '../types.js';
+/**
+ * Options for scaffolding a new CopilotKit project directory.
+ */
+export interface ScaffoldOptions {
+    /** Absolute or relative path to the target project directory. */
+    projectDir: string;
+    /** Template source — either a GitHub URL string or explicit components. */
+    template: string | TemplateSource;
+}
+/**
+ * Scaffolds a new CopilotKit project by cloning a template from GitHub.
+ *
+ * @param options - {@link ScaffoldOptions} controlling scaffold behavior.
+ * @throws {Error} If `projectDir` already exists and is non-empty.
+ */
+export declare function scaffoldProject(options: ScaffoldOptions): Promise<void>;
+/**
+ * Copies `.env.example` to `.env` if `.env` does not already exist.
+ *
+ * @param projectDir - The project directory.
+ * @returns `true` when `.env` was created from `.env.example`.
+ */
+export declare function copyEnvExample(projectDir: string): boolean;
+/**
+ * Writes or appends the license key to the `.env` file in the project directory.
+ *
+ * If the template already contains a `.env.example`, copies it to `.env` first,
+ * then ensures `COPILOTKIT_LICENSE_TOKEN` is set. If no `.env.example` exists,
+ * creates a fresh `.env` with the license key.
+ *
+ * @param projectDir - The project directory.
+ * @param licenseKey - The license key value.
+ */
+export declare function writeEnvLicenseKey(projectDir: string, licenseKey: string): void;
+/**
+ * Checks whether a git user name and email are configured for `projectDir`.
+ *
+ * @param projectDir - Directory in which to check git identity.
+ * @returns `true` if both name and email are configured, `false` otherwise.
+ */
+export declare function checkGitIdentity(projectDir: string): boolean;
+/**
+ * Creates an initial git commit in `projectDir` staging all files.
+ *
+ * @param projectDir - Directory in which to create the initial commit.
+ */
+export declare function commitInitial(projectDir: string): Promise<void>;
+//# sourceMappingURL=project-scaffold.d.ts.map

package/src/services/project-scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-scaffold.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/services/project-scaffold.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB7E;AAuID;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAU1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,IAAI,CAsBN;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAkB5D;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrE"}

package/src/types.d.ts

@@ -0,0 +1,205 @@
+/**
+ * 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' | 'adk' | 'aws-strands-py' | 'a2a' | 'microsoft-agent-framework-dotnet' | 'microsoft-agent-framework-py';
+/**
+ * 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", "adk", "aws-strands-py", "a2a", "microsoft-agent-framework-dotnet", "microsoft-agent-framework-py"];
+/**
+ * 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;
+/**
+ * GitHub URL templates for each framework's example.
+ *
+ * Used by the scaffold service to download the appropriate starter template
+ * via git sparse checkout.
+ */
+export declare const TEMPLATE_REPOS: Record<AgentFramework, string>;
+/**
+ * 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[];
+}
+/** 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":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,cAAc,GACd,OAAO,GACP,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,MAAM,GAGN,KAAK,GACL,gBAAgB,GAChB,KAAK,GACL,kCAAkC,GAClC,8BAA8B,CAAC;AAGnC;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,uMAaiB,CAAC;AAE/C;;;;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,CAa1D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,CAAC;CACvB,CAiCA,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;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAsBzD,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;CAC3C;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;AA6FD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CACtC,cAAc,EACd,sBAAsB,CA8EvB,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"}