@aria-cli/tools 1.0.0

package/dist-cjs/providers/jina.d.ts

@@ -0,0 +1,10 @@
+import type { SearchProvider, SearchOptions, SearchResult, SearchProviderEnv } from "./search-provider.js";
+export declare class JinaSearchProvider implements SearchProvider {
+    private readonly env;
+    readonly name = "jina";
+    readonly requiresApiKey = false;
+    readonly priority = 5;
+    constructor(env?: SearchProviderEnv | Record<string, string | undefined>);
+    isAvailable(): boolean;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+}

package/dist-cjs/providers/jina.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JinaSearchProvider = void 0;
+const search_provider_js_1 = require("./search-provider.js");
+class JinaSearchProvider {
+    env;
+    name = "jina";
+    requiresApiKey = false;
+    priority = 5;
+    constructor(env = process.env) {
+        this.env = env;
+    }
+    isAvailable() {
+        // Jina works without an API key (20 req/min), or with a key (200 req/min)
+        return true;
+    }
+    async search(query, options) {
+        const apiKey = (0, search_provider_js_1.resolveSearchProviderEnv)(this.env).JINA_API_KEY;
+        const limit = options?.limit ?? 5;
+        const url = new URL("https://s.jina.ai/");
+        url.searchParams.set("q", query);
+        const headers = {
+            Accept: "application/json",
+        };
+        if (apiKey) {
+            headers.Authorization = `Bearer ${apiKey}`;
+        }
+        const { signal, cleanup } = (0, search_provider_js_1.createProviderAbortSignal)(30_000, options?.signal);
+        try {
+            const response = await fetch(url.toString(), {
+                method: "GET",
+                headers,
+                signal,
+            });
+            if (!response.ok) {
+                throw new Error(`Jina Search API error: ${response.status} ${response.statusText}`);
+            }
+            const json = await response.json();
+            const results = (json.data || []);
+            // Apply limit client-side
+            return results.slice(0, limit).map((r) => ({
+                title: r.title,
+                url: r.url,
+                content: r.content,
+                score: r.score,
+            }));
+        }
+        finally {
+            cleanup();
+        }
+    }
+}
+exports.JinaSearchProvider = JinaSearchProvider;
+//# sourceMappingURL=jina.js.map

package/dist-cjs/providers/jina.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jina.js","sourceRoot":"","sources":["../../src/providers/jina.ts"],"names":[],"mappings":";;;AAMA,6DAA2F;AAE3F,MAAa,kBAAkB;IAMV;IALV,IAAI,GAAG,MAAM,CAAC;IACd,cAAc,GAAG,KAAK,CAAC;IACvB,QAAQ,GAAG,CAAC,CAAC;IAEtB,YACmB,MAA8D,OAAO,CAAC,GAAG;QAAzE,QAAG,GAAH,GAAG,CAAsE;IACzF,CAAC;IAEJ,WAAW;QACT,0EAA0E;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAuB;QACjD,MAAM,MAAM,GAAG,IAAA,6CAAwB,EAAC,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC;QAC/D,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;QAElC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAC1C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAEjC,MAAM,OAAO,GAAgB;YAC3B,MAAM,EAAE,kBAAkB;SAC3B,CAAC;QAEF,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,aAAa,GAAG,UAAU,MAAM,EAAE,CAAC;QAC7C,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAA,8CAAyB,EAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE/E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;gBAC3C,MAAM,EAAE,KAAK;gBACb,OAAO;gBACP,MAAM;aACP,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACtF,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAK9B,CAAC;YAEH,0BAA0B;YAC1B,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACzC,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,KAAK,EAAE,CAAC,CAAC,KAAK;aACf,CAAC,CAAC,CAAC;QACN,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF;AA7DD,gDA6DC"}

package/dist-cjs/providers/router.d.ts

@@ -0,0 +1,21 @@
+import type { SearchProvider, SearchOptions, SearchResult, SearchProviderEnv } from "./search-provider.js";
+export declare class SearchProviderRouter {
+    private _providers;
+    private readonly env;
+    constructor(_providers: SearchProvider[], env?: SearchProviderEnv | Record<string, string | undefined>);
+    /**
+     * Resolves the best available search provider.
+     * Priority:
+     * 1. Explicit override via ARIA_SEARCH_PROVIDER env var
+     * 2. Highest-priority available provider (lowest priority number)
+     * @throws {Error} if no providers are available or override is invalid
+     */
+    resolve(): SearchProvider;
+    /**
+     * Performs a search with automatic fallback.
+     * Tries providers in priority order (resolved provider first, then others).
+     * Circuit breaker: stops at first successful response.
+     * @throws {AggregateError} if all providers fail
+     */
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+}

package/dist-cjs/providers/router.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchProviderRouter = void 0;
+const types_1 = require("@aria/types");
+const search_provider_js_1 = require("./search-provider.js");
+class SearchProviderRouter {
+    _providers;
+    env;
+    constructor(_providers, env = process.env) {
+        this._providers = _providers;
+        this.env = env;
+    }
+    /**
+     * Resolves the best available search provider.
+     * Priority:
+     * 1. Explicit override via ARIA_SEARCH_PROVIDER env var
+     * 2. Highest-priority available provider (lowest priority number)
+     * @throws {Error} if no providers are available or override is invalid
+     */
+    resolve() {
+        const env = (0, search_provider_js_1.resolveSearchProviderEnv)(this.env);
+        // 1. Check for explicit override
+        const override = env.ARIA_SEARCH_PROVIDER;
+        if (override) {
+            const provider = this._providers.find((p) => p.name === override);
+            if (!provider) {
+                throw new Error(`ARIA_SEARCH_PROVIDER override '${override}' not found in provider registry`);
+            }
+            // Verify the overridden provider is actually available (e.g., has API key)
+            if (!provider.isAvailable()) {
+                // Fall through to default priority-based routing
+                types_1.log.debug(`[SearchProviderRouter] ARIA_SEARCH_PROVIDER override '${override}' is not available, falling back to priority routing`);
+            }
+            else {
+                return provider;
+            }
+        }
+        // 2. Select first available provider by priority (lower number = higher priority)
+        const sorted = [...this._providers].sort((a, b) => a.priority - b.priority);
+        const available = sorted.find((p) => p.isAvailable());
+        if (!available) {
+            throw new Error("No search providers available. Set at least one API key (BRAVE_API_KEY, TAVILY_API_KEY, etc.)");
+        }
+        return available;
+    }
+    /**
+     * Performs a search with automatic fallback.
+     * Tries providers in priority order (resolved provider first, then others).
+     * Circuit breaker: stops at first successful response.
+     * @throws {AggregateError} if all providers fail
+     */
+    async search(query, options) {
+        if (options?.signal?.aborted) {
+            throw new Error("Search aborted");
+        }
+        const env = (0, search_provider_js_1.resolveSearchProviderEnv)(this.env);
+        // Get all available providers sorted by priority
+        const availableProviders = [...this._providers]
+            .filter((p) => p.isAvailable())
+            .sort((a, b) => a.priority - b.priority);
+        if (availableProviders.length === 0) {
+            throw new Error("No search providers available");
+        }
+        // Honor ARIA_SEARCH_PROVIDER override: try the override provider first
+        const override = env.ARIA_SEARCH_PROVIDER;
+        if (override) {
+            const overrideProvider = availableProviders.find((p) => p.name === override);
+            if (overrideProvider) {
+                // Move override provider to front of the list
+                const reordered = [
+                    overrideProvider,
+                    ...availableProviders.filter((p) => p.name !== override),
+                ];
+                availableProviders.length = 0;
+                availableProviders.push(...reordered);
+            }
+        }
+        const errors = [];
+        // Try each provider in order
+        for (const provider of availableProviders) {
+            if (options?.signal?.aborted) {
+                throw new Error("Search aborted");
+            }
+            try {
+                const results = await provider.search(query, options);
+                return results; // Circuit breaker: return on first success
+            }
+            catch (error) {
+                if (options?.signal?.aborted) {
+                    throw error instanceof Error ? error : new Error("Search aborted");
+                }
+                errors.push(error instanceof Error ? error : new Error(`Unknown error from ${provider.name}`));
+                // Continue to next provider
+            }
+        }
+        // All providers failed
+        throw new AggregateError(errors, `All search providers failed (tried ${availableProviders.length} providers)`);
+    }
+}
+exports.SearchProviderRouter = SearchProviderRouter;
+//# sourceMappingURL=router.js.map

package/dist-cjs/providers/router.js.map

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

package/dist-cjs/providers/search-provider.d.ts

@@ -0,0 +1,35 @@
+export interface SearchOptions {
+    limit?: number;
+    topic?: "general" | "news";
+    domains?: string[];
+    excludeDomains?: string[];
+    timeRange?: "day" | "week" | "month" | "year";
+    signal?: AbortSignal;
+}
+export interface SearchResult {
+    title: string;
+    url: string;
+    content: string;
+    score?: number;
+    publishedDate?: string;
+}
+export interface SearchProviderEnv {
+    ARIA_SEARCH_PROVIDER?: string;
+    BRAVE_API_KEY?: string;
+    FIRECRAWL_API_KEY?: string;
+    EXA_API_KEY?: string;
+    TAVILY_API_KEY?: string;
+    JINA_API_KEY?: string;
+}
+export declare function resolveSearchProviderEnv(env?: SearchProviderEnv | Record<string, string | undefined>): SearchProviderEnv;
+export interface SearchProvider {
+    readonly name: string;
+    readonly requiresApiKey: boolean;
+    readonly priority: number;
+    isAvailable(): boolean;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+}
+export declare function createProviderAbortSignal(timeoutMs: number, callerSignal?: AbortSignal): {
+    signal: AbortSignal;
+    cleanup: () => void;
+};

package/dist-cjs/providers/search-provider.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSearchProviderEnv = resolveSearchProviderEnv;
+exports.createProviderAbortSignal = createProviderAbortSignal;
+function resolveSearchProviderEnv(env = process.env) {
+    return {
+        ARIA_SEARCH_PROVIDER: env.ARIA_SEARCH_PROVIDER,
+        BRAVE_API_KEY: env.BRAVE_API_KEY,
+        FIRECRAWL_API_KEY: env.FIRECRAWL_API_KEY,
+        EXA_API_KEY: env.EXA_API_KEY,
+        TAVILY_API_KEY: env.TAVILY_API_KEY,
+        JINA_API_KEY: env.JINA_API_KEY,
+    };
+}
+function createProviderAbortSignal(timeoutMs, callerSignal) {
+    const controller = new AbortController();
+    const onCallerAbort = () => controller.abort();
+    if (callerSignal) {
+        if (callerSignal.aborted) {
+            controller.abort();
+        }
+        else {
+            callerSignal.addEventListener("abort", onCallerAbort, { once: true });
+        }
+    }
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    return {
+        signal: controller.signal,
+        cleanup: () => {
+            clearTimeout(timeout);
+            if (callerSignal) {
+                callerSignal.removeEventListener("abort", onCallerAbort);
+            }
+        },
+    };
+}
+//# sourceMappingURL=search-provider.js.map

package/dist-cjs/providers/search-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-provider.js","sourceRoot":"","sources":["../../src/providers/search-provider.ts"],"names":[],"mappings":";;AA0BA,4DAWC;AAUD,8DA0BC;AA/CD,SAAgB,wBAAwB,CACtC,MAA8D,OAAO,CAAC,GAAG;IAEzE,OAAO;QACL,oBAAoB,EAAE,GAAG,CAAC,oBAAoB;QAC9C,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;QACxC,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,cAAc,EAAE,GAAG,CAAC,cAAc;QAClC,YAAY,EAAE,GAAG,CAAC,YAAY;KAC/B,CAAC;AACJ,CAAC;AAUD,SAAgB,yBAAyB,CACvC,SAAiB,EACjB,YAA0B;IAE1B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAE/C,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;YACzB,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAEhE,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,OAAO,EAAE,GAAG,EAAE;YACZ,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,IAAI,YAAY,EAAE,CAAC;gBACjB,YAAY,CAAC,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist-cjs/providers/tavily.d.ts

@@ -0,0 +1,10 @@
+import type { SearchProvider, SearchOptions, SearchResult, SearchProviderEnv } from "./search-provider.js";
+export declare class TavilySearchProvider implements SearchProvider {
+    private readonly env;
+    readonly name = "tavily";
+    readonly requiresApiKey = true;
+    readonly priority = 4;
+    constructor(env?: SearchProviderEnv | Record<string, string | undefined>);
+    isAvailable(): boolean;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+}

package/dist-cjs/providers/tavily.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TavilySearchProvider = void 0;
+const search_provider_js_1 = require("./search-provider.js");
+class TavilySearchProvider {
+    env;
+    name = "tavily";
+    requiresApiKey = true;
+    priority = 4;
+    constructor(env = process.env) {
+        this.env = env;
+    }
+    isAvailable() {
+        const apiKey = (0, search_provider_js_1.resolveSearchProviderEnv)(this.env).TAVILY_API_KEY;
+        return Boolean(apiKey && apiKey.trim().length > 0);
+    }
+    async search(query, options) {
+        const apiKey = (0, search_provider_js_1.resolveSearchProviderEnv)(this.env).TAVILY_API_KEY;
+        if (!apiKey) {
+            throw new Error("TAVILY_API_KEY environment variable is not set");
+        }
+        const limit = options?.limit ?? 5;
+        const body = {
+            api_key: apiKey,
+            query,
+            max_results: limit,
+            ...(options?.topic && { topic: options.topic }),
+            ...(options?.domains && { include_domains: options.domains }),
+            ...(options?.excludeDomains && { exclude_domains: options.excludeDomains }),
+        };
+        const { signal, cleanup } = (0, search_provider_js_1.createProviderAbortSignal)(30_000, options?.signal);
+        try {
+            const response = await fetch("https://api.tavily.com/search", {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(body),
+                signal,
+            });
+            if (!response.ok) {
+                throw new Error(`Tavily Search API error: ${response.status} ${response.statusText}`);
+            }
+            const json = await response.json();
+            const results = (json.results || []);
+            return results.map((r) => ({
+                title: r.title,
+                url: r.url,
+                content: r.content,
+                score: r.score,
+            }));
+        }
+        finally {
+            cleanup();
+        }
+    }
+}
+exports.TavilySearchProvider = TavilySearchProvider;
+//# sourceMappingURL=tavily.js.map

package/dist-cjs/providers/tavily.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tavily.js","sourceRoot":"","sources":["../../src/providers/tavily.ts"],"names":[],"mappings":";;;AAMA,6DAA2F;AAE3F,MAAa,oBAAoB;IAMZ;IALV,IAAI,GAAG,QAAQ,CAAC;IAChB,cAAc,GAAG,IAAI,CAAC;IACtB,QAAQ,GAAG,CAAC,CAAC;IAEtB,YACmB,MAA8D,OAAO,CAAC,GAAG;QAAzE,QAAG,GAAH,GAAG,CAAsE;IACzF,CAAC;IAEJ,WAAW;QACT,MAAM,MAAM,GAAG,IAAA,6CAAwB,EAAC,IAAI,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC;QACjE,OAAO,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAuB;QACjD,MAAM,MAAM,GAAG,IAAA,6CAAwB,EAAC,IAAI,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC;QACjE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG;YACX,OAAO,EAAE,MAAM;YACf,KAAK;YACL,WAAW,EAAE,KAAK;YAClB,GAAG,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;YAC/C,GAAG,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;YAC7D,GAAG,CAAC,OAAO,EAAE,cAAc,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;SAC5E,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAA,8CAAyB,EAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE/E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,+BAA+B,EAAE;gBAC5D,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM;aACP,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACxF,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAKjC,CAAC;YAEH,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACzB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,KAAK,EAAE,CAAC,CAAC,KAAK;aACf,CAAC,CAAC,CAAC;QACN,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF;AAjED,oDAiEC"}

package/dist-cjs/quip/desktop-session.d.ts

@@ -0,0 +1,69 @@
+export interface QuipDocumentSummary {
+    threadId: string;
+    title: string;
+    link: string;
+    updatedUsec: number;
+    createdUsec: number;
+}
+export interface QuipDocumentListResult {
+    documents: QuipDocumentSummary[];
+}
+export interface QuipDocumentDetail {
+    threadId: string;
+    title: string;
+    link: string;
+    markdown: string;
+    updatedUsec: number;
+    createdUsec: number;
+    authorId: string;
+}
+export interface QuipCreateResult {
+    threadId: string;
+    title: string;
+    link: string;
+}
+export interface QuipCommentView {
+    id: string;
+    authorId: string;
+    authorName: string;
+    text: string;
+    createdUsec: number;
+}
+export interface QuipCommentResult {
+    threadId: string;
+    commentId: string;
+}
+export interface QuipCommentListResult {
+    threadId: string;
+    comments: QuipCommentView[];
+}
+export interface QuipDesktopClient {
+    getUserId(): string;
+    listRecentDocuments(input: {
+        limit?: number;
+    }): Promise<QuipDocumentListResult>;
+    searchDocuments(input: {
+        query: string;
+        limit?: number;
+    }): Promise<QuipDocumentListResult>;
+    readDocument(input: {
+        threadId: string;
+    }): Promise<QuipDocumentDetail>;
+    createDocument(input: {
+        title: string;
+        content: string;
+        format?: "markdown" | "html";
+        folderId?: string;
+    }): Promise<QuipCreateResult>;
+    addComment(input: {
+        threadId: string;
+        content: string;
+    }): Promise<QuipCommentResult>;
+    listComments(input: {
+        threadId: string;
+    }): Promise<QuipCommentListResult>;
+    close(): Promise<void>;
+}
+export declare function createQuipDesktopClient(options?: {
+    bootstrapTimeoutMs?: number;
+}): Promise<QuipDesktopClient>;