pilot-ai 0.4.0 → 0.5.0

package/dist/utils/logger.js

@@ -0,0 +1,119 @@
+/**
+ * Structured JSON logger with correlation IDs, log levels, and file output.
+ * Replaces ad-hoc console.error() calls throughout the codebase.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { getPilotDir } from '../config/store.js';
+const LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+let currentCorrelationId;
+let minLevel = 'info';
+/** Metrics counters */
+const metrics = {
+    requestCount: 0,
+    errorCount: 0,
+    totalResponseTimeMs: 0,
+};
+/**
+ * Set the minimum log level (default: info).
+ */
+export function setLogLevel(level) {
+    minLevel = level;
+}
+/**
+ * Set the current correlation ID for request tracing.
+ */
+export function setCorrelationId(id) {
+    currentCorrelationId = id;
+}
+/**
+ * Generate a new correlation ID for a message processing cycle.
+ */
+export function generateCorrelationId() {
+    const id = `req-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    currentCorrelationId = id;
+    return id;
+}
+/**
+ * Get the current correlation ID.
+ */
+export function getCorrelationId() {
+    return currentCorrelationId;
+}
+function getLogDir() {
+    return path.join(getPilotDir(), 'logs');
+}
+function getLogFilePath() {
+    const today = new Date().toISOString().slice(0, 10);
+    return path.join(getLogDir(), `pilot-${today}.log`);
+}
+function writeLog(entry) {
+    if (LEVEL_PRIORITY[entry.level] < LEVEL_PRIORITY[minLevel])
+        return;
+    const line = JSON.stringify(entry);
+    // Write to file (sync append for reliability)
+    try {
+        const logDir = getLogDir();
+        fs.mkdirSync(logDir, { recursive: true });
+        fs.appendFileSync(getLogFilePath(), line + '\n');
+    }
+    catch {
+        // Best-effort logging
+    }
+    // Also write errors to stderr
+    if (entry.level === 'error') {
+        console.error(`[${entry.timestamp}] ERROR: ${entry.message}`);
+    }
+}
+export function log(level, message, extra) {
+    writeLog({
+        timestamp: new Date().toISOString(),
+        level,
+        message,
+        correlationId: currentCorrelationId,
+        ...extra,
+    });
+}
+export function debug(message, extra) {
+    log('debug', message, extra);
+}
+export function info(message, extra) {
+    log('info', message, extra);
+}
+export function warn(message, extra) {
+    log('warn', message, extra);
+}
+export function error(message, extra) {
+    log('error', message, extra);
+}
+// --- Metrics ---
+export function recordRequest() {
+    metrics.requestCount++;
+}
+export function recordError() {
+    metrics.errorCount++;
+}
+export function recordResponseTime(ms) {
+    metrics.totalResponseTimeMs += ms;
+}
+export function getMetrics() {
+    return {
+        requestCount: metrics.requestCount,
+        errorCount: metrics.errorCount,
+        avgResponseTimeMs: metrics.requestCount > 0
+            ? Math.round(metrics.totalResponseTimeMs / metrics.requestCount)
+            : 0,
+    };
+}
+/**
+ * No-op for backward compatibility. Sync writes need no cleanup.
+ */
+export function closeLogger() {
+    // No-op: using appendFileSync, no stream to close
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/oauth-manager.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Unified OAuth token manager with Keychain storage and automatic refresh.
+ * Consolidates token lifecycle management for all Google services.
+ */
+export interface OAuthTokens {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: number;
+}
+export interface OAuthManagerOptions {
+    /** Keychain key name for storing tokens */
+    keychainKey: string;
+    /** OAuth2 token endpoint URL */
+    tokenUrl: string;
+    /** OAuth2 client ID */
+    clientId: string;
+    /** OAuth2 client secret */
+    clientSecret: string;
+    /** Time in ms before expiry to trigger preemptive refresh (default: 5 minutes) */
+    refreshMarginMs?: number;
+}
+export declare class OAuthManager {
+    private tokens;
+    private readonly options;
+    constructor(options: OAuthManagerOptions);
+    /**
+     * Load tokens from Keychain.
+     */
+    loadTokens(): Promise<OAuthTokens | null>;
+    /**
+     * Save tokens to Keychain.
+     */
+    saveTokens(tokens: OAuthTokens): Promise<void>;
+    /**
+     * Delete tokens from Keychain.
+     */
+    deleteTokens(): Promise<void>;
+    /**
+     * Returns a valid access token, refreshing if expired or close to expiring.
+     * Uses retry with exponential backoff for refresh failures.
+     */
+    getAccessToken(): Promise<string>;
+    /**
+     * Exchange an authorization code for tokens.
+     */
+    exchangeCode(code: string, redirectUri: string, scopes?: string[]): Promise<OAuthTokens>;
+    private refreshToken;
+}
+//# sourceMappingURL=oauth-manager.d.ts.map

package/dist/utils/oauth-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-manager.d.ts","sourceRoot":"","sources":["../../src/utils/oauth-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,kFAAkF;IAClF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;gBAE5C,OAAO,EAAE,mBAAmB;IAOxC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAW/C;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAKnC;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAmBvC;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;YA8BhF,YAAY;CA0B3B"}

package/dist/utils/oauth-manager.js

@@ -0,0 +1,112 @@
+/**
+ * Unified OAuth token manager with Keychain storage and automatic refresh.
+ * Consolidates token lifecycle management for all Google services.
+ */
+import { getSecret, setSecret, deleteSecret } from '../config/keychain.js';
+import { withRetry } from './retry.js';
+const DEFAULT_REFRESH_MARGIN_MS = 5 * 60 * 1000; // 5 minutes
+export class OAuthManager {
+    tokens = null;
+    options;
+    constructor(options) {
+        this.options = {
+            ...options,
+            refreshMarginMs: options.refreshMarginMs ?? DEFAULT_REFRESH_MARGIN_MS,
+        };
+    }
+    /**
+     * Load tokens from Keychain.
+     */
+    async loadTokens() {
+        const secret = await getSecret(this.options.keychainKey);
+        if (!secret)
+            return null;
+        try {
+            this.tokens = JSON.parse(secret);
+            return this.tokens;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Save tokens to Keychain.
+     */
+    async saveTokens(tokens) {
+        this.tokens = tokens;
+        await setSecret(this.options.keychainKey, JSON.stringify(tokens));
+    }
+    /**
+     * Delete tokens from Keychain.
+     */
+    async deleteTokens() {
+        this.tokens = null;
+        await deleteSecret(this.options.keychainKey);
+    }
+    /**
+     * Returns a valid access token, refreshing if expired or close to expiring.
+     * Uses retry with exponential backoff for refresh failures.
+     */
+    async getAccessToken() {
+        if (!this.tokens) {
+            const loaded = await this.loadTokens();
+            if (!loaded)
+                throw new Error('No OAuth tokens available. Run OAuth flow first.');
+            this.tokens = loaded;
+        }
+        // Check if token is still valid (with margin for preemptive refresh)
+        if (Date.now() < this.tokens.expiresAt - this.options.refreshMarginMs) {
+            return this.tokens.accessToken;
+        }
+        // Refresh with retry
+        return withRetry(() => this.refreshToken(), { maxAttempts: 3, baseDelay: 1000, jitter: true });
+    }
+    /**
+     * Exchange an authorization code for tokens.
+     */
+    async exchangeCode(code, redirectUri, scopes) {
+        const res = await fetch(this.options.tokenUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: new URLSearchParams({
+                code,
+                client_id: this.options.clientId,
+                client_secret: this.options.clientSecret,
+                redirect_uri: redirectUri,
+                grant_type: 'authorization_code',
+            }),
+        });
+        const data = (await res.json());
+        if (data.error)
+            throw new Error(`OAuth exchange error: ${data.error}`);
+        const tokens = {
+            accessToken: data.access_token,
+            refreshToken: data.refresh_token,
+            expiresAt: Date.now() + data.expires_in * 1000,
+        };
+        await this.saveTokens(tokens);
+        return tokens;
+    }
+    async refreshToken() {
+        if (!this.tokens)
+            throw new Error('No tokens to refresh');
+        const res = await fetch(this.options.tokenUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: new URLSearchParams({
+                refresh_token: this.tokens.refreshToken,
+                client_id: this.options.clientId,
+                client_secret: this.options.clientSecret,
+                grant_type: 'refresh_token',
+            }),
+        });
+        const data = (await res.json());
+        if (data.error)
+            throw new Error(`OAuth refresh error: ${data.error}`);
+        this.tokens.accessToken = data.access_token;
+        this.tokens.expiresAt = Date.now() + data.expires_in * 1000;
+        await this.saveTokens(this.tokens);
+        return this.tokens.accessToken;
+    }
+}
+//# sourceMappingURL=oauth-manager.js.map

package/dist/utils/oauth-manager.js.map

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

package/dist/utils/rate-limiter.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Token bucket rate limiter for outbound message throttling.
+ */
+export declare class RateLimiter {
+    private tokens;
+    private readonly maxTokens;
+    private readonly refillRate;
+    private lastRefill;
+    /**
+     * @param maxTokens Maximum burst capacity
+     * @param refillRate Tokens added per second
+     */
+    constructor(maxTokens: number, refillRate: number);
+    /**
+     * Waits until a token is available, then consumes it.
+     */
+    acquire(): Promise<void>;
+    /**
+     * Tries to consume a token without waiting. Returns false if none available.
+     */
+    tryAcquire(): boolean;
+    private refill;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/utils/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,UAAU,CAAS;IAE3B;;;OAGG;gBACS,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAOjD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAa9B;;OAEG;IACH,UAAU,IAAI,OAAO;IASrB,OAAO,CAAC,MAAM;CAMf"}

package/dist/utils/rate-limiter.js

@@ -0,0 +1,52 @@
+/**
+ * Token bucket rate limiter for outbound message throttling.
+ */
+export class RateLimiter {
+    tokens;
+    maxTokens;
+    refillRate; // tokens per second
+    lastRefill;
+    /**
+     * @param maxTokens Maximum burst capacity
+     * @param refillRate Tokens added per second
+     */
+    constructor(maxTokens, refillRate) {
+        this.maxTokens = maxTokens;
+        this.tokens = maxTokens;
+        this.refillRate = refillRate;
+        this.lastRefill = Date.now();
+    }
+    /**
+     * Waits until a token is available, then consumes it.
+     */
+    async acquire() {
+        this.refill();
+        if (this.tokens >= 1) {
+            this.tokens -= 1;
+            return;
+        }
+        // Wait until a token is available
+        const waitMs = ((1 - this.tokens) / this.refillRate) * 1000;
+        await new Promise((resolve) => setTimeout(resolve, Math.ceil(waitMs)));
+        this.refill();
+        this.tokens -= 1;
+    }
+    /**
+     * Tries to consume a token without waiting. Returns false if none available.
+     */
+    tryAcquire() {
+        this.refill();
+        if (this.tokens >= 1) {
+            this.tokens -= 1;
+            return true;
+        }
+        return false;
+    }
+    refill() {
+        const now = Date.now();
+        const elapsed = (now - this.lastRefill) / 1000;
+        this.tokens = Math.min(this.maxTokens, this.tokens + elapsed * this.refillRate);
+        this.lastRefill = now;
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/utils/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,WAAW;IACd,MAAM,CAAS;IACN,SAAS,CAAS;IAClB,UAAU,CAAS,CAAC,oBAAoB;IACjD,UAAU,CAAS;IAE3B;;;OAGG;IACH,YAAY,SAAiB,EAAE,UAAkB;QAC/C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YACjB,OAAO;QACT,CAAC;QACD,kCAAkC;QAClC,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;QAC5D,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,MAAM;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QAChF,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;IACxB,CAAC;CACF"}

package/dist/utils/retry.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Retry utility with exponential backoff and jitter.
+ */
+export interface RetryOptions {
+    /** Maximum number of attempts (default: 3) */
+    maxAttempts?: number;
+    /** Base delay in ms (default: 1000) */
+    baseDelay?: number;
+    /** Maximum delay in ms (default: 30000) */
+    maxDelay?: number;
+    /** Whether to add jitter (default: true) */
+    jitter?: boolean;
+    /** Optional predicate to determine if the error is retryable */
+    isRetryable?: (error: unknown) => boolean;
+}
+/**
+ * Executes a function with retry logic using exponential backoff.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAC3C;AAUD;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,CAAC,CAAC,CAoBZ"}

package/dist/utils/retry.js

@@ -0,0 +1,45 @@
+/**
+ * Retry utility with exponential backoff and jitter.
+ */
+const DEFAULT_OPTIONS = {
+    maxAttempts: 3,
+    baseDelay: 1000,
+    maxDelay: 30_000,
+    jitter: true,
+    isRetryable: () => true,
+};
+/**
+ * Executes a function with retry logic using exponential backoff.
+ */
+export async function withRetry(fn, options) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    let lastError;
+    for (let attempt = 1; attempt <= opts.maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt >= opts.maxAttempts || !opts.isRetryable(error)) {
+                throw error;
+            }
+            const delay = calculateDelay(attempt, opts.baseDelay, opts.maxDelay, opts.jitter);
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
+function calculateDelay(attempt, baseDelay, maxDelay, jitter) {
+    // Exponential backoff: base * 2^(attempt-1)
+    let delay = baseDelay * Math.pow(2, attempt - 1);
+    delay = Math.min(delay, maxDelay);
+    if (jitter) {
+        // Full jitter: random value between 0 and delay
+        delay = Math.random() * delay;
+    }
+    return delay;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH,MAAM,eAAe,GAA2B;IAC9C,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,IAAI;IACZ,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,OAAsB;IAEtB,MAAM,IAAI,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;IAChD,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QAC7D,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAElB,IAAI,OAAO,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5D,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAClF,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,cAAc,CACrB,OAAe,EACf,SAAiB,EACjB,QAAgB,EAChB,MAAe;IAEf,4CAA4C;IAC5C,IAAI,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;IACjD,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAElC,IAAI,MAAM,EAAE,CAAC;QACX,gDAAgD;QAChD,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC;IAChC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pilot-ai",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Personal AI agent that controls your macOS via Slack or Telegram",
   "type": "module",
   "bin": {