@davidwoods/skylight-mcp 0.0.0-stage → 1.8.0

package/dist/api/oauth.js

@@ -0,0 +1,206 @@
+/**
+ * Browser-paste OAuth login and token refresh.
+ *
+ * The user signs in to Skylight in their own browser, then pastes the final
+ * https://ourskylight.com/welcome?code=... URL back into the CLI. The password
+ * never reaches this process. The authorization code is bound to a PKCE
+ * verifier and a random state value that are kept in a short-lived, 0600
+ * "pending login" file between the two CLI steps.
+ *
+ * Design informed by kamilio/skylight-calendar-agent (MIT); see
+ * THIRD_PARTY_NOTICES.md. Unlike that project's flow, this one uses PKCE (S256)
+ * and verifies the returned state against the pending login.
+ */
+import { createHash, randomBytes, randomUUID, timingSafeEqual } from "node:crypto";
+import { SKYLIGHT_BASE_URL, SKYLIGHT_WEB_APP_URL } from "./constants.js";
+export const OAUTH_CLIENT_ID = "skylight-mobile";
+const SCOPE = "everything";
+const REDIRECT_URI = `${SKYLIGHT_WEB_APP_URL}/welcome`;
+const REQUEST_TIMEOUT_MS = 30_000;
+const MAX_FIELD_LENGTH = 8_192;
+const DEFAULT_EXPIRES_IN_S = 3_600;
+/** How long a pending login stays valid between `auth login` and `auth complete`. */
+export const PENDING_LOGIN_TTL_MS = 10 * 60 * 1000;
+/** Refresh this long before the access token actually expires. */
+export const EXPIRY_SKEW_MS = 60 * 1000;
+export class OAuthError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "OAuthError";
+    }
+}
+function base64url(bytes) {
+    return bytes.toString("base64url");
+}
+function deviceMetadata(fingerprint) {
+    const hardware = process.platform === "darwin"
+        ? "Macintosh"
+        : process.platform === "win32"
+            ? "Windows"
+            : process.platform === "linux"
+                ? "Linux"
+                : process.platform;
+    return {
+        skylight_api_client_device_fingerprint: fingerprint,
+        skylight_api_client_device_platform: "web",
+        skylight_api_client_device_name: "unknown",
+        skylight_api_client_device_os_version: "unknown",
+        skylight_api_client_device_app_version: "unknown",
+        skylight_api_client_device_hardware: hardware,
+    };
+}
+/** The S256 challenge for a verifier. */
+export function codeChallengeFor(codeVerifier) {
+    return base64url(createHash("sha256").update(codeVerifier).digest());
+}
+/** Fresh PKCE verifier, state and device fingerprint for a new login. */
+export function newPendingLogin(now = Date.now(), overrides = {}) {
+    return {
+        state: overrides.state ?? randomBytes(16).toString("hex"),
+        codeVerifier: base64url(randomBytes(32)),
+        fingerprint: overrides.fingerprint ?? randomUUID(),
+        createdAt: now,
+    };
+}
+/** The Skylight authorize URL for a pending login. */
+export function authorizeUrlFor(pending) {
+    const url = new URL("/oauth/authorize", SKYLIGHT_BASE_URL);
+    url.searchParams.set("client_id", OAUTH_CLIENT_ID);
+    url.searchParams.set("response_type", "code");
+    url.searchParams.set("redirect_uri", REDIRECT_URI);
+    url.searchParams.set("scope", SCOPE);
+    url.searchParams.set("state", pending.state);
+    url.searchParams.set("code_challenge", codeChallengeFor(pending.codeVerifier));
+    url.searchParams.set("code_challenge_method", "S256");
+    url.searchParams.set("skylight_api_client_device_fingerprint", pending.fingerprint);
+    return url.toString();
+}
+/**
+ * Start a login: returns the URL the user must open in their browser and the
+ * pending-login record the caller must persist until `completeBrowserLogin`.
+ */
+export function beginBrowserLogin(now = Date.now(), overrides = {}) {
+    const pending = newPendingLogin(now, overrides);
+    return { loginUrl: authorizeUrlFor(pending), pending };
+}
+function safeEqual(a, b) {
+    const left = Buffer.from(a);
+    const right = Buffer.from(b);
+    return left.length === right.length && timingSafeEqual(left, right);
+}
+/** Extract and validate the authorization code from the pasted callback URL. */
+export function parseCallbackUrl(callbackUrl, pending, now = Date.now()) {
+    if (now - pending.createdAt > PENDING_LOGIN_TTL_MS) {
+        throw new OAuthError("The login attempt expired. Run `skylight-mcp auth login` again.");
+    }
+    let callback;
+    try {
+        callback = new URL(callbackUrl.trim());
+    }
+    catch {
+        throw new OAuthError("Paste the complete URL shown in your browser after signing in.");
+    }
+    const expected = new URL(REDIRECT_URI);
+    if (callback.protocol !== "https:" || callback.hostname !== expected.hostname || callback.pathname !== expected.pathname) {
+        throw new OAuthError(`The URL must start with ${REDIRECT_URI}.`);
+    }
+    const error = callback.searchParams.get("error");
+    if (error) {
+        throw new OAuthError(`Skylight returned an error during sign-in: ${error.slice(0, 100)}`);
+    }
+    const code = callback.searchParams.get("code");
+    const state = callback.searchParams.get("state");
+    if (!code || !state) {
+        throw new OAuthError("The URL did not contain a code and state. Run `skylight-mcp auth login` again.");
+    }
+    if (code.length > MAX_FIELD_LENGTH || state.length > MAX_FIELD_LENGTH) {
+        throw new OAuthError("The URL contained an unexpectedly long value.");
+    }
+    if (!safeEqual(state, pending.state)) {
+        throw new OAuthError("State mismatch: this URL does not belong to the pending login. Run `skylight-mcp auth login` again.");
+    }
+    return code;
+}
+async function tokenRequest(values, fingerprint, fetchImpl, now) {
+    const response = await fetchImpl(`${SKYLIGHT_BASE_URL}/oauth/token`, {
+        method: "POST",
+        headers: {
+            Accept: "application/json",
+            "Content-Type": "application/x-www-form-urlencoded",
+        },
+        body: values,
+        signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+    });
+    const text = await response.text();
+    if (!response.ok) {
+        // Error bodies carry OAuth error codes only; cap length defensively.
+        throw new OAuthError(`Skylight token request failed (HTTP ${response.status}): ${text.slice(0, 200)}`);
+    }
+    let json;
+    try {
+        json = JSON.parse(text);
+    }
+    catch {
+        throw new OAuthError("Skylight token response was not valid JSON.");
+    }
+    const accessToken = json.access_token ?? json.token;
+    if (typeof accessToken !== "string" || accessToken.length === 0 || accessToken.length > MAX_FIELD_LENGTH) {
+        throw new OAuthError("Skylight token response did not contain an access token.");
+    }
+    const refreshToken = json.refresh_token;
+    if (typeof refreshToken !== "string" || refreshToken.length === 0 || refreshToken.length > MAX_FIELD_LENGTH) {
+        throw new OAuthError("Skylight token response did not contain a refresh token.");
+    }
+    const expiresIn = typeof json.expires_in === "number" && Number.isFinite(json.expires_in) && json.expires_in > 0
+        ? json.expires_in
+        : DEFAULT_EXPIRES_IN_S;
+    return {
+        version: 1,
+        type: "oauth",
+        accessToken,
+        refreshToken,
+        fingerprint,
+        expiresAt: now + Math.floor(expiresIn * 1000),
+    };
+}
+/** Exchange the pasted callback URL for a credential. */
+export async function completeBrowserLogin(callbackUrl, pending, fetchImpl = fetch, now = Date.now()) {
+    const code = parseCallbackUrl(callbackUrl, pending, now);
+    return tokenRequest(new URLSearchParams({
+        grant_type: "authorization_code",
+        client_id: OAUTH_CLIENT_ID,
+        scope: SCOPE,
+        redirect_uri: REDIRECT_URI,
+        code,
+        code_verifier: pending.codeVerifier,
+        ...deviceMetadata(pending.fingerprint),
+    }), pending.fingerprint, fetchImpl, now);
+}
+/** Use the refresh token to obtain a new credential. Refresh tokens rotate. */
+export async function refreshCredential(credential, fetchImpl = fetch, now = Date.now()) {
+    return tokenRequest(new URLSearchParams({
+        grant_type: "refresh_token",
+        client_id: OAUTH_CLIENT_ID,
+        refresh_token: credential.refreshToken,
+        ...deviceMetadata(credential.fingerprint),
+    }), credential.fingerprint, fetchImpl, now);
+}
+export function isExpired(credential, now = Date.now()) {
+    return credential.expiresAt - EXPIRY_SKEW_MS <= now;
+}
+export function parseStoredCredential(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const record = value;
+    if (record.version !== 1 ||
+        record.type !== "oauth" ||
+        typeof record.accessToken !== "string" ||
+        typeof record.refreshToken !== "string" ||
+        typeof record.fingerprint !== "string" ||
+        typeof record.expiresAt !== "number" ||
+        !Number.isFinite(record.expiresAt)) {
+        return null;
+    }
+    return record;
+}
+//# sourceMappingURL=oauth.js.map

package/dist/api/oauth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.js","sourceRoot":"","sources":["../../src/api/oauth.ts"],"names":[],"mappings":"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"}

package/dist/api/types.d.ts

@@ -0,0 +1,291 @@
+/**
+ * TypeScript types for Skylight API responses (JSON:API format)
+ */
+export interface JsonApiResourceId {
+    type: string;
+    id: string;
+}
+export interface JsonApiResponse<D, I = unknown> {
+    data: D;
+    included?: I[];
+    meta?: Record<string, unknown>;
+}
+export interface CategoryAttributes {
+    label: string | null;
+    color: string | null;
+    selected_for_chore_chart: boolean | null;
+    linked_to_profile: boolean | null;
+    profile_pic_url: string | null;
+}
+export interface CategoryResource {
+    type: "category";
+    id: string;
+    attributes: CategoryAttributes;
+}
+export interface ChoreAttributes {
+    id?: number | null;
+    summary: string;
+    status: string;
+    start: string;
+    start_time: string | null;
+    completed_on: string | null;
+    is_future: boolean | null;
+    recurring: boolean;
+    recurring_until: string | null;
+    recurrence_set: string | null;
+    reward_points: number | null;
+    emoji_icon: string | null;
+    routine: boolean | null;
+    position: number | null;
+    up_for_grabs?: boolean | null;
+}
+export interface ChoreRelationships {
+    category?: {
+        data: JsonApiResourceId | null;
+    };
+}
+export interface ChoreResource {
+    type: "chore";
+    id: string;
+    attributes: ChoreAttributes;
+    relationships?: ChoreRelationships;
+}
+export interface ListAttributes {
+    label: string;
+    color: string | null;
+    kind: "shopping" | "to_do";
+    default_grocery_list: boolean;
+}
+export interface ListRelationships {
+    list_items?: {
+        data: JsonApiResourceId[];
+    };
+}
+export interface ListResource {
+    type: "list";
+    id: string;
+    attributes: ListAttributes;
+    relationships?: ListRelationships;
+}
+export interface ListItemAttributes {
+    label: string;
+    status: "pending" | "completed";
+    section: string | null;
+    position: number | null;
+    created_at: string | null;
+}
+export interface ListItemResource {
+    type: "list_item";
+    id: string;
+    attributes: ListItemAttributes;
+}
+export interface TaskBoxItemAttributes {
+    id?: number | null;
+    summary: string;
+    emoji_icon: string | null;
+    routine: boolean | null;
+    reward_points: number | null;
+}
+export interface TaskBoxItemResource {
+    type: "task_box_item";
+    id: string;
+    attributes: TaskBoxItemAttributes;
+}
+export interface FrameAttributes {
+    [key: string]: unknown;
+}
+export interface FrameResource {
+    type: "frame";
+    id: string;
+    attributes: FrameAttributes;
+}
+export interface SourceCalendarAttributes {
+    [key: string]: unknown;
+}
+export interface SourceCalendarResource {
+    type: "source_calendar";
+    id: string;
+    attributes: SourceCalendarAttributes;
+}
+export interface CalendarEventAttributes {
+    [key: string]: unknown;
+}
+export interface CalendarEventResource {
+    type: "calendar_event";
+    id: string;
+    attributes: CalendarEventAttributes;
+    relationships?: {
+        categories?: {
+            data?: Array<{
+                id: string;
+            }> | null;
+        };
+        category?: {
+            data?: {
+                id: string;
+            } | null;
+        };
+    };
+}
+export interface DeviceAttributes {
+    [key: string]: unknown;
+}
+export interface DeviceResource {
+    type: "device";
+    id: string;
+    attributes: DeviceAttributes;
+}
+export interface RewardAttributes {
+    [key: string]: unknown;
+}
+export interface RewardResource {
+    type: "reward";
+    id: string;
+    attributes: RewardAttributes;
+}
+export interface RewardPointAttributes {
+    [key: string]: unknown;
+}
+export interface RewardPointResource {
+    type: "reward_point";
+    id: string;
+    attributes: RewardPointAttributes;
+}
+export type TaskBoxItemsResponse = JsonApiResponse<TaskBoxItemResource[]>;
+export type ChoresResponse = JsonApiResponse<ChoreResource[], CategoryResource>;
+export type ChoreResponse = JsonApiResponse<ChoreResource, CategoryResource>;
+export type ListsResponse = JsonApiResponse<ListResource[]>;
+export type ListResponse = JsonApiResponse<ListResource, ListItemResource>;
+export type CategoriesResponse = JsonApiResponse<CategoryResource[]>;
+export type DevicesResponse = JsonApiResponse<DeviceResource[]>;
+export type FrameResponse = JsonApiResponse<FrameResource>;
+export type SourceCalendarsResponse = JsonApiResponse<SourceCalendarResource[]>;
+export type CalendarEventsResponse = JsonApiResponse<CalendarEventResource[], CategoryResource | SourceCalendarResource>;
+export type TaskBoxItemResponse = JsonApiResponse<TaskBoxItemResource>;
+export type RewardsResponse = JsonApiResponse<RewardResource[]>;
+export type RewardPointsResponse = JsonApiResponse<RewardPointResource[]>;
+export interface CreateChoreRequest {
+    data: {
+        type: "chore";
+        attributes: Partial<ChoreAttributes>;
+        relationships?: ChoreRelationships;
+    };
+}
+export interface CreateTaskBoxItemRequest {
+    data: {
+        type: "task_box_item";
+        attributes: Partial<TaskBoxItemAttributes>;
+    };
+}
+export interface CreateListRequest {
+    data: {
+        type: "list";
+        attributes: {
+            label: string;
+            kind: "shopping" | "to_do";
+            color?: string | null;
+        };
+    };
+}
+export interface UpdateListRequest {
+    data: {
+        type: "list";
+        attributes: Partial<{
+            label: string;
+            kind: "shopping" | "to_do";
+            color: string | null;
+        }>;
+    };
+}
+export interface CreateListItemRequest {
+    data: {
+        type: "list_item";
+        attributes: {
+            label: string;
+            section?: string | null;
+        };
+    };
+}
+export interface UpdateListItemRequest {
+    data: {
+        type: "list_item";
+        attributes: Partial<{
+            label: string;
+            status: "pending" | "completed";
+            section: string | null;
+            position: number | null;
+        }>;
+    };
+}
+export type ListItemResponse = JsonApiResponse<ListItemResource>;
+export interface CreateCalendarEventRequest {
+    summary: string;
+    starts_at: string;
+    ends_at: string;
+    all_day?: boolean;
+    description?: string;
+    location?: string;
+    category_ids?: string[];
+    calendar_account_id?: string;
+    calendar_id?: string;
+    rrule?: string[] | null;
+    timezone?: string;
+    countdown_enabled?: boolean;
+    kind?: string;
+}
+export interface UpdateCalendarEventRequest {
+    summary?: string;
+    starts_at?: string;
+    ends_at?: string;
+    all_day?: boolean;
+    description?: string;
+    location?: string;
+    category_ids?: string[];
+    rrule?: string[] | null;
+    timezone?: string;
+    countdown_enabled?: boolean;
+}
+export type CalendarEventResponse = JsonApiResponse<CalendarEventResource>;
+export interface UpdateChoreRequest {
+    data: {
+        type: "chore";
+        attributes: Partial<ChoreAttributes>;
+        relationships?: ChoreRelationships;
+    };
+}
+export interface CreateRewardRequest {
+    data: {
+        type: "reward";
+        attributes: {
+            name: string;
+            description?: string | null;
+            emoji_icon?: string | null;
+            point_value: number;
+            respawn_on_redemption?: boolean;
+        };
+        relationships?: {
+            categories?: {
+                data: JsonApiResourceId[];
+            };
+        };
+    };
+}
+export interface UpdateRewardRequest {
+    data: {
+        type: "reward";
+        attributes: Partial<{
+            name: string;
+            description: string | null;
+            emoji_icon: string | null;
+            point_value: number;
+            respawn_on_redemption: boolean;
+        }>;
+        relationships?: {
+            categories?: {
+                data: JsonApiResourceId[];
+            };
+        };
+    };
+}
+export type RewardResponse = JsonApiResponse<RewardResource>;
+//# sourceMappingURL=types.d.ts.map

package/dist/api/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"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"}

package/dist/api/types.js

@@ -0,0 +1,5 @@
+/**
+ * TypeScript types for Skylight API responses (JSON:API format)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/cli.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `skylight-mcp auth ...` commands. These are CLI-only on purpose: credential
+ * handling is never exposed as an MCP tool.
+ *
+ *   skylight-mcp auth login            print the sign-in URL
+ *   skylight-mcp auth complete [url]   paste the final redirect URL to finish
+ *   skylight-mcp auth status           show whether a credential is stored
+ *   skylight-mcp auth logout           delete the stored credential
+ */
+import { type CredentialStore } from "./api/credential-store.js";
+import { type PendingLogin, type StoredCredential } from "./api/oauth.js";
+export interface CliDeps {
+    store: CredentialStore;
+    out: (line: string) => void;
+    prompt: (question: string) => Promise<string>;
+    savePending: (pending: PendingLogin) => Promise<void>;
+    takePending: () => Promise<PendingLogin | null>;
+    complete: (url: string, pending: PendingLogin) => Promise<StoredCredential>;
+    refresh: (credential: StoredCredential) => Promise<StoredCredential>;
+    now: () => number;
+}
+export declare function runAuthCommand(args: readonly string[], overrides?: Partial<CliDeps>): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAA8D,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC7H,OAAO,EAOL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,eAAe,CAAC;IACvB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,WAAW,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,WAAW,EAAE,MAAM,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAChD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC5E,OAAO,EAAE,CAAC,UAAU,EAAE,gBAAgB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrE,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AA6BD,wBAAsB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,GAAE,OAAO,CAAC,OAAO,CAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwE/G"}

package/dist/cli.js

@@ -0,0 +1,106 @@
+/**
+ * `skylight-mcp auth ...` commands. These are CLI-only on purpose: credential
+ * handling is never exposed as an MCP tool.
+ *
+ *   skylight-mcp auth login            print the sign-in URL
+ *   skylight-mcp auth complete [url]   paste the final redirect URL to finish
+ *   skylight-mcp auth status           show whether a credential is stored
+ *   skylight-mcp auth logout           delete the stored credential
+ */
+import { createInterface } from "node:readline/promises";
+import { defaultCredentialStore, savePendingLogin, takePendingLogin } from "./api/credential-store.js";
+import { OAuthError, PENDING_LOGIN_TTL_MS, beginBrowserLogin, completeBrowserLogin, isExpired, refreshCredential, } from "./api/oauth.js";
+function defaultDeps() {
+    return {
+        store: defaultCredentialStore(),
+        out: (line) => console.log(line),
+        prompt: async (question) => {
+            const rl = createInterface({ input: process.stdin, output: process.stderr });
+            try {
+                return await rl.question(question);
+            }
+            finally {
+                rl.close();
+            }
+        },
+        savePending: (pending) => savePendingLogin(pending),
+        takePending: () => takePendingLogin(),
+        complete: (url, pending) => completeBrowserLogin(url, pending),
+        refresh: (credential) => refreshCredential(credential),
+        now: () => Date.now(),
+    };
+}
+const USAGE = `Usage: skylight-mcp auth <command>
+
+  login            Print a Skylight sign-in URL. Open it in your browser.
+  complete [url]   After signing in, paste the final URL (https://ourskylight.com/welcome?...).
+  status           Show whether you are signed in.
+  logout           Remove the stored credential.`;
+export async function runAuthCommand(args, overrides = {}) {
+    const deps = { ...defaultDeps(), ...overrides };
+    const [command, ...rest] = args;
+    try {
+        switch (command) {
+            case "login": {
+                const { loginUrl, pending } = beginBrowserLogin(deps.now());
+                await deps.savePending(pending);
+                deps.out("1. Open this URL in your browser and sign in to Skylight\n   (Windows Terminal: hold Ctrl and click it; otherwise copy it into your browser):\n");
+                deps.out(`   ${loginUrl}\n`);
+                deps.out("2. Skylight bounces the browser through https://ourskylight.com/welcome?code=... too fast");
+                deps.out("   to copy. Get it from browser history: Cmd-Y (Mac) / Ctrl-H (PC), search \"welcome?code\",");
+                deps.out("   right-click the Skylight result dated today (top of the list; older ones are earlier");
+                deps.out("   sign-ins and will not work), Copy link address.\n");
+                deps.out("3. Run the same command you just ran, with `complete` instead of `login`,");
+                deps.out(`   and paste the URL at the prompt. This login expires in ${PENDING_LOGIN_TTL_MS / 60_000} minutes.`);
+                return 0;
+            }
+            case "complete": {
+                const url = rest[0] ?? (await deps.prompt("Paste the full redirect URL: "));
+                if (!url.trim()) {
+                    deps.out("No URL provided.");
+                    return 1;
+                }
+                const pending = await deps.takePending();
+                if (!pending) {
+                    deps.out("No login in progress. Run `skylight-mcp auth login` first.");
+                    return 1;
+                }
+                const credential = await deps.complete(url, pending);
+                await deps.store.write(credential);
+                deps.out(`Signed in. Credential saved (${deps.store.name}).`);
+                deps.out("Restart your MCP client to pick it up.");
+                return 0;
+            }
+            case "status": {
+                const credential = await deps.store.read();
+                if (!credential) {
+                    deps.out("Not signed in. Run `skylight-mcp auth login`.");
+                    return 1;
+                }
+                const expiry = new Date(credential.expiresAt).toISOString();
+                deps.out(`Signed in. Storage: ${deps.store.name}.`);
+                deps.out(isExpired(credential, deps.now())
+                    ? `Access token expired at ${expiry}; it will refresh on next use.`
+                    : `Access token valid until ${expiry}.`);
+                return 0;
+            }
+            case "logout": {
+                const removed = await deps.store.delete();
+                deps.out(removed ? "Signed out. Stored credential removed." : "Nothing to remove.");
+                deps.out("Note: this does not revoke the session on Skylight's side.");
+                return 0;
+            }
+            default:
+                deps.out(USAGE);
+                return command === undefined || command === "help" || command === "--help" ? 0 : 1;
+        }
+    }
+    catch (error) {
+        if (error instanceof OAuthError || error instanceof Error) {
+            deps.out(`Error: ${error.message}`);
+            return 1;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=cli.js.map