copilotkit 1.54.0 → 2.0.1

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

@@ -0,0 +1,107 @@
+import * as http from "http";
+import { ApiClientError } from "./api-client.js";
+import type { VerifySessionResponse } from "./api-client.js";
+/**
+ * Result of a successful callback from the browser-based login flow.
+ */
+export interface CallbackResult {
+    /** Short-lived Clerk token returned from the frontend callback. */
+    clerkToken: string;
+}
+/**
+ * Starts a temporary HTTP server on a random port bound to 127.0.0.1 that
+ * handles the CLI auth callback from the browser.
+ *
+ * The browser redirects (GET) to `/callback?clerkToken=…&state=…` after
+ * sign-in. The server validates `state`, resolves the result promise with
+ * the received `clerkToken`, and responds with a small HTML page telling
+ * the user they can close the tab. A full-page navigation is used rather
+ * than `fetch` so the flow works in Safari 15+ and Chrome 130+, which
+ * block HTTPS → private-network `fetch` requests.
+ *
+ * @param expectedState - The CSRF state token to validate against the callback
+ *   payload.
+ * @returns A promise that resolves once the server is listening, providing the
+ *   bound `port`, a `resultPromise` that resolves/rejects based on the callback
+ *   payload, and the raw `server` handle for cleanup.
+ */
+export declare function startCallbackServer(expectedState: string): Promise<{
+    port: number;
+    resultPromise: Promise<CallbackResult>;
+    server: http.Server;
+}>;
+/**
+ * Launches the browser-based login flow, waits for the callback, exchanges
+ * the Clerk token for a CLI session token, persists the credentials, and
+ * returns the authenticated user and organization.
+ *
+ * Steps:
+ * 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.
+ * 5. Exchange the Clerk token for a CLI session via ops-api.
+ * 6. Persist credentials to the auth store.
+ *
+ * @returns The authenticated user and organization from the ops-api response.
+ */
+export declare function login(): Promise<{
+    user: {
+        id: string;
+        email: string;
+        name: string | null;
+    };
+    organization: {
+        clerkOrgId: string;
+        organizationName?: string;
+    };
+}>;
+export interface VerifyAndRefreshOptions {
+    /** When true, preserve the specific auth/session error instead of returning null. */
+    throwOnInvalid?: boolean;
+}
+/**
+ * User-facing guidance shown when a stored CLI session is no longer usable
+ * after the Clerk cutover and the user must authenticate again.
+ */
+export declare const TERMINAL_SESSION_INVALID_MESSAGE = "Existing CLI sessions are invalid after the Clerk cutover. Please log in again.";
+/**
+ * Checks whether an API error means the current stored CLI auth is no longer
+ * recoverable and must be cleared before the user logs in again.
+ *
+ * Treats all CLI session retirement errors, plus Clerk active-organization
+ * resolution failures, as terminal invalidation signals.
+ *
+ * @param error - Error raised by the API client.
+ * @returns `true` when local auth should be cleared and the user reauthenticated.
+ */
+export declare function isTerminalSessionInvalidationError(error: unknown): error is ApiClientError;
+/**
+ * Clears the local auth store when the error represents a terminal CLI auth
+ * invalidation that requires a fresh login.
+ *
+ * @param error - Error raised by the API client.
+ * @returns `true` when local auth was cleared.
+ */
+export declare function clearAuthOnTerminalSessionInvalidation(error: unknown): boolean;
+/**
+ * Verifies the stored CLI session token against ops-api and refreshes the
+ * locally persisted credentials if still valid.
+ *
+ * Returns `null` and clears the local auth store only when the server confirms
+ * the session is invalid. Missing local auth also returns `null`. Transport or
+ * server failures are rethrown so the caller can preserve the local session.
+ *
+ * @param options - Controls how invalid sessions are surfaced to the caller.
+ * @returns The fresh session user/org data, or `null` if unauthenticated.
+ */
+export declare function verifyAndRefresh(options?: VerifyAndRefreshOptions): Promise<VerifySessionResponse | null>;
+/**
+ * Terminates the current CLI session on ops-api (best-effort) and clears all
+ * locally stored credentials.
+ *
+ * Any network error from the server-side logout is swallowed; the local
+ * credentials are always cleared.
+ */
+export declare function logout(): Promise<void>;
+//# sourceMappingURL=auth.service.d.ts.map

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

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

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;AAkJD;;;;;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/services/showcase-config.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Showcase identifiers consumed by the langgraph-python starter when run
+ * under one of the showcase frameworks (a2ui, opengenui).
+ *
+ * The starter reads `showcase.json` at runtime to swap out the demo it shows.
+ */
+export type ShowcaseId = 'a2ui' | 'opengenui';
+/**
+ * Writes a `showcase.json` sidecar file selecting the showcase variant.
+ *
+ * Mirrors the legacy CLI's `applyShowcaseConfig` behavior so that pointing
+ * the a2ui / opengenui frameworks at the langgraph-python starter still
+ * works without a dedicated template repo.
+ *
+ * @param projectDir - The freshly-scaffolded project directory.
+ * @param showcase - Showcase variant to record.
+ */
+export declare function writeShowcaseConfig(projectDir: string, showcase: ShowcaseId): Promise<void>;
+//# sourceMappingURL=showcase-config.d.ts.map

package/src/services/showcase-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"showcase-config.d.ts","sourceRoot":"","sources":["../../../../../apps/cli/src/services/showcase-config.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,CAAC;AAE9C;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,UAAU,GACnB,OAAO,CAAC,IAAI,CAAC,CAGf"}