@aria-cli/tools 1.0.10 → 1.0.11

package/dist-cjs/quip/desktop-session.js

@@ -0,0 +1,354 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createQuipDesktopClient = createQuipDesktopClient;
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
+const QUIP_API_BASE = "https://platform.quip.com/1";
+const DEFAULT_BOOTSTRAP_TIMEOUT_MS = 30_000;
+// ── HTML → Markdown conversion (regex-based, no deps) ───────────────
+function htmlToMarkdown(html) {
+    let md = html;
+    // Block elements first
+    md = md.replace(/<h1[^>]*>([\s\S]*?)<\/h1>/gi, "\n# $1\n");
+    md = md.replace(/<h2[^>]*>([\s\S]*?)<\/h2>/gi, "\n## $1\n");
+    md = md.replace(/<h3[^>]*>([\s\S]*?)<\/h3>/gi, "\n### $1\n");
+    md = md.replace(/<h4[^>]*>([\s\S]*?)<\/h4>/gi, "\n#### $1\n");
+    md = md.replace(/<br\s*\/?>/gi, "\n");
+    md = md.replace(/<\/p>/gi, "\n\n");
+    md = md.replace(/<p[^>]*>/gi, "");
+    md = md.replace(/<li[^>]*>([\s\S]*?)<\/li>/gi, "- $1\n");
+    md = md.replace(/<\/?(ul|ol)[^>]*>/gi, "\n");
+    md = md.replace(/<blockquote[^>]*>([\s\S]*?)<\/blockquote>/gi, (_, content) => content
+        .split("\n")
+        .map((line) => `> ${line}`)
+        .join("\n"));
+    md = md.replace(/<pre[^>]*>([\s\S]*?)<\/pre>/gi, "\n```\n$1\n```\n");
+    md = md.replace(/<code[^>]*>([\s\S]*?)<\/code>/gi, "`$1`");
+    // Inline formatting
+    md = md.replace(/<(b|strong)[^>]*>([\s\S]*?)<\/\1>/gi, "**$2**");
+    md = md.replace(/<(i|em)[^>]*>([\s\S]*?)<\/\1>/gi, "*$2*");
+    md = md.replace(/<(s|del|strike)[^>]*>([\s\S]*?)<\/\1>/gi, "~~$2~~");
+    md = md.replace(/<a\s+href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi, "[$2]($1)");
+    // Strip remaining tags
+    md = md.replace(/<[^>]+>/g, "");
+    // Decode common HTML entities
+    md = md.replace(/&amp;/g, "&");
+    md = md.replace(/&lt;/g, "<");
+    md = md.replace(/&gt;/g, ">");
+    md = md.replace(/&quot;/g, '"');
+    md = md.replace(/&#39;/g, "'");
+    md = md.replace(/&nbsp;/g, " ");
+    // Collapse excessive blank lines
+    md = md.replace(/\n{3,}/g, "\n\n");
+    return md.trim();
+}
+async function extractKeychainDesktopToken() {
+    try {
+        // Use python3 to parse the bplist from Keychain — macOS ships python3
+        // and plutil requires a temp file; python3 one-liner is cleaner.
+        const { stdout } = await execFileAsync("python3", [
+            "-c",
+            `
+import subprocess, plistlib, sys
+from datetime import datetime, timedelta
+try:
+    raw = subprocess.check_output([
+        'security', 'find-generic-password', '-s', 'Quip', '-a', 'MultiAccount', '-g'
+    ], stderr=subprocess.STDOUT).decode()
+    import re
+    hex_match = re.search(r'password: 0x([0-9A-Fa-f]+)', raw)
+    if not hex_match:
+        sys.exit(1)
+    data = bytes.fromhex(hex_match.group(1))
+    plist = plistlib.loads(data)
+    import json
+    for uid, info in plist.get('accounts', {}).items():
+        exp = info.get('session_expiration', 0)
+        exp_date = datetime(2001, 1, 1) + timedelta(seconds=exp)
+        if exp_date > datetime.now():
+            json.dump({"token": info["session_id"], "userId": uid}, sys.stdout)
+            sys.exit(0)
+    sys.exit(1)
+except:
+    sys.exit(1)
+`.trim(),
+        ]);
+        const parsed = JSON.parse(stdout.trim());
+        if (parsed.token && parsed.userId) {
+            return parsed;
+        }
+    }
+    catch {
+        // Keychain extraction failed — fall through
+    }
+    return null;
+}
+async function extractManualKeychainToken() {
+    try {
+        const { stdout } = await execFileAsync("security", [
+            "find-generic-password",
+            "-a",
+            "aria",
+            "-s",
+            "quip-token",
+            "-w",
+        ]);
+        const token = stdout.trim();
+        return token || null;
+    }
+    catch {
+        return null;
+    }
+}
+async function extractPlaywrightToken(timeoutMs) {
+    const playwright = await Promise.resolve().then(() => __importStar(require("playwright")));
+    const browser = await playwright.chromium.launch({ headless: true });
+    try {
+        const context = await browser.newContext();
+        const page = await context.newPage();
+        const tokenPromise = new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                page.off("request", handleRequest);
+                reject(new Error("Timed out waiting for Quip API token via Playwright."));
+            }, timeoutMs);
+            const handleRequest = (request) => {
+                const url = request.url();
+                if (!url.includes("platform.quip.com"))
+                    return;
+                const authHeader = request.headers()["authorization"];
+                if (!authHeader?.startsWith("Bearer "))
+                    return;
+                clearTimeout(timer);
+                page.off("request", handleRequest);
+                resolve(authHeader.slice(7));
+            };
+            page.on("request", handleRequest);
+        });
+        await page.goto("https://quip.com", {
+            waitUntil: "domcontentloaded",
+            timeout: timeoutMs,
+        });
+        const token = await tokenPromise;
+        // Get user ID from /users/current
+        const resp = await context.request.get(`${QUIP_API_BASE}/users/current`, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        const userData = (await resp.json());
+        const userId = typeof userData.id === "string" ? userData.id : "unknown";
+        await page.close().catch(() => undefined);
+        await context.close().catch(() => undefined);
+        await browser.close().catch(() => undefined);
+        return { token, userId };
+    }
+    catch (error) {
+        await browser.close().catch(() => undefined);
+        throw error;
+    }
+}
+// ── Thread/document helpers ─────────────────────────────────────────
+function toDocumentSummary(thread) {
+    return {
+        threadId: typeof thread.id === "string" ? thread.id : "",
+        title: typeof thread.title === "string" ? thread.title : "",
+        link: typeof thread.link === "string" ? thread.link : "",
+        updatedUsec: typeof thread.updated_usec === "number" ? thread.updated_usec : 0,
+        createdUsec: typeof thread.created_usec === "number" ? thread.created_usec : 0,
+    };
+}
+// ── Client factory ──────────────────────────────────────────────────
+async function createQuipDesktopClient(options) {
+    const timeoutMs = options?.bootstrapTimeoutMs ?? DEFAULT_BOOTSTRAP_TIMEOUT_MS;
+    // Priority 1: Keychain desktop token (auto from Quip desktop app)
+    let keychainResult = await extractKeychainDesktopToken();
+    // Priority 2: Playwright web session (SSO handles auth)
+    if (!keychainResult) {
+        try {
+            keychainResult = await extractPlaywrightToken(timeoutMs);
+        }
+        catch {
+            // Playwright extraction failed — fall through
+        }
+    }
+    // Priority 3: Manual keychain token
+    let token;
+    let userId;
+    if (keychainResult) {
+        token = keychainResult.token;
+        userId = keychainResult.userId;
+    }
+    else {
+        const manualToken = await extractManualKeychainToken();
+        if (!manualToken) {
+            throw new Error("No Quip token available. Install the Quip desktop app, or add a manual token:\n" +
+                '  security add-generic-password -a aria -s quip-token -w "<token>"\n' +
+                "Get a token from https://quip.com/dev/token");
+        }
+        token = manualToken;
+        userId = "unknown";
+    }
+    // Verify token and resolve userId if unknown
+    const invokeApi = async (method, endpoint, body) => {
+        const url = `${QUIP_API_BASE}${endpoint}`;
+        const headers = {
+            Authorization: `Bearer ${token}`,
+        };
+        const fetchOptions = { method, headers };
+        if (body) {
+            headers["Content-Type"] = "application/x-www-form-urlencoded";
+            fetchOptions.body = new URLSearchParams(Object.entries(body).map(([k, v]) => [k, String(v)])).toString();
+        }
+        const resp = await fetch(url, fetchOptions);
+        const text = await resp.text();
+        let json;
+        try {
+            json = JSON.parse(text);
+        }
+        catch {
+            throw new Error(`Quip API ${endpoint} returned non-JSON (HTTP ${resp.status}).`);
+        }
+        if (!resp.ok) {
+            const errorCode = typeof json.error_code === "number" ? json.error_code : resp.status;
+            const errorMsg = typeof json.error_description === "string" ? json.error_description : `HTTP ${resp.status}`;
+            throw new Error(`Quip API ${endpoint} failed (${errorCode}): ${errorMsg}`);
+        }
+        return json;
+    };
+    // Resolve userId on first use if unknown
+    if (userId === "unknown") {
+        const user = await invokeApi("GET", "/users/current");
+        userId = typeof user.id === "string" ? user.id : "unknown";
+    }
+    return {
+        getUserId: () => userId,
+        listRecentDocuments: async ({ limit = 20 }) => {
+            const data = await invokeApi("GET", `/threads/recent?count=${Math.min(limit, 50)}`);
+            const threads = Array.isArray(data)
+                ? data
+                : typeof data === "object" && data !== null
+                    ? Object.values(data)
+                    : [];
+            const documents = [];
+            for (const entry of threads) {
+                if (!entry || typeof entry !== "object")
+                    continue;
+                const thread = "thread" in entry
+                    ? entry.thread
+                    : entry;
+                documents.push(toDocumentSummary(thread));
+            }
+            return { documents: documents.slice(0, limit) };
+        },
+        searchDocuments: async ({ query, limit = 20 }) => {
+            const params = new URLSearchParams({ query, count: String(Math.min(limit, 50)) });
+            const data = await invokeApi("GET", `/threads/search?${params}`);
+            const threads = Array.isArray(data)
+                ? data
+                : typeof data === "object" && data !== null
+                    ? Object.values(data)
+                    : [];
+            const documents = [];
+            for (const entry of threads) {
+                if (!entry || typeof entry !== "object")
+                    continue;
+                const thread = "thread" in entry
+                    ? entry.thread
+                    : entry;
+                documents.push(toDocumentSummary(thread));
+            }
+            return { documents: documents.slice(0, limit) };
+        },
+        readDocument: async ({ threadId }) => {
+            const data = await invokeApi("GET", `/threads/${threadId}`);
+            const thread = typeof data.thread === "object" && data.thread !== null
+                ? data.thread
+                : data;
+            const rawHtml = typeof data.html === "string" ? data.html : "";
+            return {
+                threadId: typeof thread.id === "string" ? thread.id : threadId,
+                title: typeof thread.title === "string" ? thread.title : "",
+                link: typeof thread.link === "string" ? thread.link : "",
+                markdown: htmlToMarkdown(rawHtml),
+                updatedUsec: typeof thread.updated_usec === "number" ? thread.updated_usec : 0,
+                createdUsec: typeof thread.created_usec === "number" ? thread.created_usec : 0,
+                authorId: typeof thread.author_id === "string" ? thread.author_id : "",
+            };
+        },
+        createDocument: async ({ title, content, format = "markdown", folderId }) => {
+            const body = { title, content, format };
+            if (folderId)
+                body.member_ids = folderId;
+            const data = await invokeApi("POST", "/threads/new-document", body);
+            const thread = typeof data.thread === "object" && data.thread !== null
+                ? data.thread
+                : data;
+            return {
+                threadId: typeof thread.id === "string" ? thread.id : "",
+                title: typeof thread.title === "string" ? thread.title : title,
+                link: typeof thread.link === "string" ? thread.link : "",
+            };
+        },
+        addComment: async ({ threadId, content }) => {
+            const data = await invokeApi("POST", "/messages/new", {
+                thread_id: threadId,
+                content,
+            });
+            return {
+                threadId,
+                commentId: typeof data.id === "string" ? data.id : "",
+            };
+        },
+        listComments: async ({ threadId }) => {
+            const data = await invokeApi("GET", `/messages/${threadId}`);
+            const rawMessages = Array.isArray(data) ? data : [];
+            const comments = rawMessages
+                .filter((m) => !!m && typeof m === "object")
+                .map((m) => ({
+                id: typeof m.id === "string" ? m.id : "",
+                authorId: typeof m.author_id === "string" ? m.author_id : "",
+                authorName: typeof m.author_name === "string" ? m.author_name : "",
+                text: typeof m.text === "string" ? m.text : "",
+                createdUsec: typeof m.created_usec === "number" ? m.created_usec : 0,
+            }));
+            return { threadId, comments };
+        },
+        close: async () => {
+            // No persistent resources to clean up (unlike Slack which keeps a browser open).
+            // Token-based client is stateless.
+        },
+    };
+}
+//# sourceMappingURL=desktop-session.js.map

package/dist-cjs/quip/desktop-session.js.map

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

package/dist-cjs/registry/index.d.ts

@@ -0,0 +1 @@
+export { ToolRegistry, validateToolInput } from "./registry.js";

package/dist-cjs/registry/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateToolInput = exports.ToolRegistry = void 0;
+var registry_js_1 = require("./registry.js");
+Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return registry_js_1.ToolRegistry; } });
+Object.defineProperty(exports, "validateToolInput", { enumerable: true, get: function () { return registry_js_1.validateToolInput; } });
+//# sourceMappingURL=index.js.map

package/dist-cjs/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":";;;AAAA,6CAAgE;AAAvD,2GAAA,YAAY,OAAA;AAAE,gHAAA,iBAAiB,OAAA"}

package/dist-cjs/registry/registry.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Tool Registry - Manages tool registration and discovery
+ */
+import type { Tool, ToolCategory, ToolContext, ToolResult, ToolMiddleware, RegisterOptions, ToolInfo, Logger } from "../types.js";
+import type { ToolItem } from "@aria-cli/types";
+import { MCPClient } from "../mcp/client.js";
+import type { MCPServerConfig } from "../mcp/types.js";
+export declare function validateToolInput(input: unknown, schema: Record<string, unknown>, path?: string): string | null;
+/**
+ * Memoria-like interface for tool discovery
+ */
+interface MemoriaLike {
+    recallTools(options: {
+        query: string;
+        limit?: number;
+        offset?: number;
+        minConfidence?: number;
+        matchAll?: boolean;
+        updateAccessStats?: boolean;
+    }): Promise<ToolItem[]>;
+    rememberTool(tool: {
+        name: string;
+        description: string;
+    } & Record<string, unknown>): Promise<string>;
+}
+export declare class ToolRegistry {
+    private tools;
+    private middleware;
+    private mcpClient?;
+    private logger;
+    constructor(options?: {
+        logger?: Logger;
+    });
+    /**
+     * Register a middleware to wrap tool execution.
+     * Middlewares are applied in registration order (first registered = outermost).
+     */
+    use(mw: ToolMiddleware): void;
+    /**
+     * Register a tool
+     * @throws Error if tool already registered and override not set
+     */
+    register(tool: Tool, options?: RegisterOptions): void;
+    /**
+     * Get a tool by name
+     */
+    get(name: string): Tool | undefined;
+    /**
+     * Check if a tool is registered
+     */
+    has(name: string): boolean;
+    /**
+     * List all tools, optionally filtered by category
+     */
+    list(category?: ToolCategory): Tool[];
+    /**
+     * Unregister a tool
+     * @returns true if tool was removed, false if not found
+     */
+    unregister(name: string): boolean;
+    /**
+     * Get count of registered tools
+     */
+    get size(): number;
+    /**
+     * Clear all registered tools
+     */
+    clear(): void;
+    /**
+     * Get all registered tools
+     */
+    getAll(): Tool[];
+    /**
+     * Execute a tool by name with input validation.
+     *
+     * Validates `input` against the tool's JSON Schema `parameters` before
+     * delegating to the tool's handler. Returns a structured error result
+     * for unknown tools or validation failures instead of throwing.
+     *
+     * Tools without a `parameters` schema (or with a non-object schema)
+     * skip validation and pass input directly to the handler.
+     */
+    execute(name: string, input: unknown, context: ToolContext): Promise<ToolResult>;
+    /**
+     * Convert a Tool to ToolInfo for system prompt
+     */
+    private toolToInfo;
+    /**
+     * Get tool info for all tools (for system prompt)
+     */
+    getToolInfos(): ToolInfo[];
+    /**
+     * Search for tools by name or description
+     */
+    search(query: string): Tool[];
+    /**
+     * Discover and load tools from Memoria knowledge base
+     *
+     * @param memoria - Memoria instance to query
+     * @returns Number of tools discovered and loaded
+     */
+    discoverFromMemoria(memoria: MemoriaLike): Promise<number>;
+    /**
+     * Save a tool definition to Memoria
+     *
+     * @param name - Name of the tool to save
+     * @param memoria - Memoria instance to save to
+     */
+    saveToMemoria(name: string, memoria: MemoriaLike): Promise<void>;
+    /**
+     * Create an executor for a tool loaded from Memoria.
+     *
+     * Supports template execution only (no eval, no arbitrary code):
+     *
+     * **Response template**: If `toolDef.responseTemplate` is a string,
+     *    `{{key}}` placeholders are replaced with values from the input object.
+     *
+     * Input is validated against the full declared JSON Schema before interpolation.
+     */
+    private createMemoriaToolExecutor;
+    /**
+     * Connect to MCP servers and register their tools
+     */
+    connectMCP(configs: MCPServerConfig[]): Promise<{
+        tools: number;
+        resources: number;
+        prompts: number;
+    }>;
+    /**
+     * Refresh tools from a specific MCP server
+     */
+    private refreshMCPTools;
+    /**
+     * Disconnect from all MCP servers
+     */
+    disconnectMCP(): Promise<void>;
+    /**
+     * Get the MCP client for direct resource/prompt access
+     */
+    getMCPClient(): MCPClient | undefined;
+    /**
+     * Dispose of the registry, cleaning up all MCP connections.
+     *
+     * Shuts down every MCP server connection and clears all registered tools.
+     * Safe to call multiple times (idempotent).
+     */
+    dispose(): Promise<void>;
+    /**
+     * Async disposable support for `await using registry = new ToolRegistry()`.
+     *
+     * Delegates to dispose() so that ToolRegistry works with the Explicit
+     * Resource Management proposal (using/await using).
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+}
+export {};