@aria-cli/tools 1.0.0

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

@@ -0,0 +1,367 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractCachedSlackDesktopState = extractCachedSlackDesktopState;
+exports.extractWorkspaceHostFromAppHtml = extractWorkspaceHostFromAppHtml;
+exports.extractLiveSlackTokenFromMultipartBody = extractLiveSlackTokenFromMultipartBody;
+exports.createSlackDesktopClient = createSlackDesktopClient;
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_util_1 = require("node:util");
+const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
+const SLACK_APP_SUPPORT_DIR = node_path_1.default.join(node_os_1.default.homedir(), "Library", "Application Support", "Slack");
+const SLACK_LEVELDB_DIR = node_path_1.default.join(SLACK_APP_SUPPORT_DIR, "Local Storage", "leveldb");
+const SLACK_COOKIE_DB_PATH = node_path_1.default.join(SLACK_APP_SUPPORT_DIR, "Cookies");
+const SLACK_SAFE_STORAGE_SERVICE = "Slack Safe Storage";
+const SLACK_APP_ORIGIN = "https://app.slack.com";
+const DEFAULT_BOOTSTRAP_TIMEOUT_MS = 30_000;
+const TEAM_ID_REGEX = /\bT[A-Z0-9]{8,}\b/g;
+const TOKEN_REGEX = /\bxoxc-[A-Za-z0-9-]{20,}\b/g;
+function extractCachedSlackDesktopState(levelDbText) {
+    const cachedToken = levelDbText.match(TOKEN_REGEX)?.[0] ?? null;
+    const teamIds = [];
+    const seen = new Set();
+    const localConfigSegments = [...levelDbText.matchAll(/localConfig_v2[\s\S]{0,8000}/g)].map((match) => match[0]);
+    const sources = localConfigSegments.length > 0 ? localConfigSegments : [levelDbText];
+    for (const source of sources) {
+        for (const teamId of source.match(TEAM_ID_REGEX) ?? []) {
+            if (seen.has(teamId))
+                continue;
+            seen.add(teamId);
+            teamIds.push(teamId);
+        }
+    }
+    return { cachedToken, teamIds };
+}
+function extractWorkspaceHostFromAppHtml(html) {
+    const enterpriseHosts = [...html.matchAll(/https:\/\/([A-Za-z0-9.-]+\.enterprise\.slack\.com)/g)]
+        .map((match) => match[1])
+        .filter(Boolean);
+    if (enterpriseHosts.length > 0) {
+        return enterpriseHosts[0] ?? null;
+    }
+    const workspaceHosts = [...html.matchAll(/https:\/\/([A-Za-z0-9.-]+\.slack\.com)/g)]
+        .map((match) => match[1])
+        .filter((host) => host !== "api.slack.com" && host !== "app.slack.com");
+    return workspaceHosts[0] ?? null;
+}
+function extractLiveSlackTokenFromMultipartBody(body) {
+    const match = body.match(/name="token"\r?\n\r?\n([^\r\n]+)/);
+    return match?.[1] ?? null;
+}
+function decryptChromiumCookieHex(cookieHex, safeStoragePassword) {
+    const encryptedValue = Buffer.from(cookieHex, "hex");
+    if (encryptedValue.length === 0) {
+        return "";
+    }
+    const versionPrefix = encryptedValue.subarray(0, 3).toString("utf8");
+    if (versionPrefix !== "v10" && versionPrefix !== "v11") {
+        return encryptedValue.toString("utf8");
+    }
+    const key = node_crypto_1.default.pbkdf2Sync(safeStoragePassword, "saltysalt", 1003, 16, "sha1");
+    const decipher = node_crypto_1.default.createDecipheriv("aes-128-cbc", key, Buffer.alloc(16, 0x20));
+    let decrypted = Buffer.concat([decipher.update(encryptedValue.subarray(3)), decipher.final()]);
+    const padLength = decrypted.at(-1) ?? 0;
+    if (padLength > 0 && padLength <= 16) {
+        decrypted = decrypted.subarray(0, decrypted.length - padLength);
+    }
+    // Chromium cookie DB version 24 prefixes SHA-256(host_key) before the plaintext value.
+    if (decrypted.length >= 32) {
+        decrypted = decrypted.subarray(32);
+    }
+    return decrypted.toString("utf8");
+}
+async function readSlackLevelDbText(levelDbDir = SLACK_LEVELDB_DIR) {
+    const entries = await node_fs_1.promises.readdir(levelDbDir);
+    const files = entries.filter((entry) => entry.endsWith(".ldb") || entry.endsWith(".log")).sort();
+    const chunks = await Promise.all(files.map(async (entry) => {
+        const fullPath = node_path_1.default.join(levelDbDir, entry);
+        return node_fs_1.promises.readFile(fullPath, "utf8").catch(async () => {
+            const bytes = await node_fs_1.promises.readFile(fullPath);
+            return bytes.toString("utf8");
+        });
+    }));
+    return chunks.join("\n");
+}
+async function readSeedCookies(cookieDbPath = SLACK_COOKIE_DB_PATH) {
+    const { stdout: passwordStdout } = await execFileAsync("security", [
+        "find-generic-password",
+        "-w",
+        "-s",
+        SLACK_SAFE_STORAGE_SERVICE,
+    ]);
+    const safeStoragePassword = passwordStdout.trim();
+    const sql = [
+        "SELECT host_key, name, path, is_secure, is_httponly, hex(encrypted_value)",
+        "FROM cookies",
+        "WHERE host_key IN ('.slack.com', 'app.slack.com')",
+        "AND name IN ('b', 'd')",
+        "ORDER BY name",
+    ].join(" ");
+    const { stdout } = await execFileAsync("sqlite3", ["-separator", "\t", cookieDbPath, sql]);
+    const cookies = stdout
+        .split("\n")
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .map((line) => {
+        const [domain, name, cookiePath, secureFlag, httpOnlyFlag, encryptedHex] = line.split("\t");
+        if (!domain || !name || !encryptedHex) {
+            throw new Error(`Unexpected sqlite3 cookie row shape: ${line}`);
+        }
+        return {
+            name,
+            value: decryptChromiumCookieHex(encryptedHex ?? "", safeStoragePassword),
+            domain,
+            path: cookiePath || "/",
+            secure: secureFlag === "1",
+            httpOnly: httpOnlyFlag === "1",
+        };
+    });
+    if (cookies.length === 0) {
+        throw new Error("Slack Desktop auth cookies were not found in the local Chromium cookie store.");
+    }
+    return cookies;
+}
+async function waitForLiveSlackBootstrap(page, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            page.off("request", handleRequest);
+            reject(new Error("Timed out while waiting for the live Slack Desktop API bootstrap request."));
+        }, timeoutMs);
+        const handleRequest = (request) => {
+            const requestUrl = request.url();
+            if (!requestUrl.includes("/api/")) {
+                return;
+            }
+            const liveToken = extractLiveSlackTokenFromMultipartBody(request.postData() ?? "");
+            if (!liveToken) {
+                return;
+            }
+            clearTimeout(timer);
+            page.off("request", handleRequest);
+            resolve({
+                workspaceHost: new URL(requestUrl).host,
+                liveToken,
+            });
+        };
+        page.on("request", handleRequest);
+    });
+}
+function normalizeRequestForm(liveToken, fields) {
+    const form = { token: liveToken };
+    for (const [key, value] of Object.entries(fields)) {
+        if (value === undefined)
+            continue;
+        if (typeof value === "string") {
+            form[key] = value;
+            continue;
+        }
+        if (typeof value === "number" || typeof value === "boolean") {
+            form[key] = String(value);
+            continue;
+        }
+        form[key] = JSON.stringify(value);
+    }
+    return form;
+}
+function normalizeChannelRef(channelRef) {
+    return channelRef.startsWith("#") ? channelRef.slice(1) : channelRef;
+}
+function looksLikeConversationId(channelRef) {
+    return /^[CDG][A-Z0-9]{8,}$/.test(channelRef);
+}
+function toSlackMessageView(message) {
+    return {
+        ts: typeof message.ts === "string" ? message.ts : "",
+        user: typeof message.user === "string"
+            ? message.user
+            : typeof message.bot_id === "string"
+                ? message.bot_id
+                : null,
+        text: typeof message.text === "string" ? message.text : "",
+        subtype: typeof message.subtype === "string" ? message.subtype : null,
+        threadTs: typeof message.thread_ts === "string" ? message.thread_ts : null,
+    };
+}
+async function createSlackDesktopClient(options) {
+    const cachedState = extractCachedSlackDesktopState(await readSlackLevelDbText());
+    const teamId = options?.teamId ?? cachedState.teamIds[0];
+    if (!teamId) {
+        throw new Error("No Slack workspace team id was discovered in the local Slack Desktop storage.");
+    }
+    const playwright = await Promise.resolve().then(() => __importStar(require("playwright")));
+    const browser = await playwright.chromium.launch({ headless: true });
+    const context = await browser.newContext();
+    await context.addCookies(await readSeedCookies());
+    const page = await context.newPage();
+    const bootstrapPromise = waitForLiveSlackBootstrap(page, options?.bootstrapTimeoutMs ?? DEFAULT_BOOTSTRAP_TIMEOUT_MS);
+    await page.goto(`${SLACK_APP_ORIGIN}/client/${teamId}`, {
+        waitUntil: "domcontentloaded",
+        timeout: options?.bootstrapTimeoutMs ?? DEFAULT_BOOTSTRAP_TIMEOUT_MS,
+    });
+    const bootstrap = await bootstrapPromise;
+    const invokeJsonApi = async (method, fields) => {
+        const response = await context.request.post(`https://${bootstrap.workspaceHost}/api/${method}`, {
+            form: normalizeRequestForm(bootstrap.liveToken, fields),
+            headers: {
+                Origin: SLACK_APP_ORIGIN,
+                Referer: `${SLACK_APP_ORIGIN}/client/${teamId}`,
+            },
+        });
+        const text = await response.text();
+        let json;
+        try {
+            json = JSON.parse(text);
+        }
+        catch {
+            throw new Error(`Slack API ${method} returned non-JSON response (HTTP ${response.status()}).`);
+        }
+        if (json.ok !== true) {
+            const errorCode = typeof json.error === "string" ? json.error : `http_${response.status()}`;
+            throw new Error(`Slack API ${method} failed: ${errorCode}`);
+        }
+        return json;
+    };
+    const resolveConversationId = async (channelRef) => {
+        const normalized = normalizeChannelRef(channelRef);
+        if (looksLikeConversationId(normalized)) {
+            return normalized;
+        }
+        let cursor;
+        for (let pageNumber = 0; pageNumber < 20; pageNumber += 1) {
+            const response = await invokeJsonApi("conversations.list", {
+                limit: 200,
+                exclude_archived: true,
+                types: "public_channel,private_channel,im,mpim",
+                cursor,
+            });
+            const channels = Array.isArray(response.channels) ? response.channels : [];
+            const match = channels.find((channel) => {
+                if (!channel || typeof channel !== "object")
+                    return false;
+                const name = typeof channel.name === "string" ? channel.name : null;
+                const nameNormalized = typeof channel.name_normalized === "string" ? channel.name_normalized : null;
+                return name === normalized || nameNormalized === normalized.toLowerCase();
+            });
+            if (match && typeof match.id === "string") {
+                return match.id;
+            }
+            const responseMetadata = response.response_metadata && typeof response.response_metadata === "object"
+                ? response.response_metadata
+                : undefined;
+            const nextCursor = responseMetadata && typeof responseMetadata.next_cursor === "string"
+                ? responseMetadata.next_cursor.trim()
+                : "";
+            if (!nextCursor) {
+                break;
+            }
+            cursor = nextCursor;
+        }
+        throw new Error(`Slack conversation "${channelRef}" was not found. Use a channel id like C..., G..., or D... if the name cannot be resolved.`);
+    };
+    return {
+        getTeamId: () => teamId,
+        getWorkspaceHost: () => bootstrap.workspaceHost,
+        listMessages: async ({ channel, limit = 20, threadTs }) => {
+            const channelId = await resolveConversationId(channel);
+            const method = threadTs ? "conversations.replies" : "conversations.history";
+            const response = await invokeJsonApi(method, {
+                channel: channelId,
+                limit: Math.max(1, Math.min(limit, 100)),
+                ...(threadTs ? { ts: threadTs } : {}),
+            });
+            const responseMetadata = response.response_metadata && typeof response.response_metadata === "object"
+                ? response.response_metadata
+                : undefined;
+            const nextCursor = responseMetadata && typeof responseMetadata.next_cursor === "string"
+                ? responseMetadata.next_cursor || null
+                : null;
+            const rawMessages = Array.isArray(response.messages) ? response.messages : [];
+            return {
+                teamId,
+                workspaceHost: bootstrap.workspaceHost,
+                channelId,
+                messages: rawMessages
+                    .filter((message) => !!message && typeof message === "object")
+                    .map(toSlackMessageView),
+                hasMore: response.has_more === true,
+                nextCursor,
+            };
+        },
+        sendMessage: async ({ channel, text, threadTs }) => {
+            const channelId = await resolveConversationId(channel);
+            const response = await invokeJsonApi("chat.postMessage", {
+                channel: channelId,
+                text,
+                ...(threadTs ? { thread_ts: threadTs } : {}),
+            });
+            const ts = typeof response.ts === "string" ? response.ts : null;
+            if (!ts) {
+                throw new Error("Slack API chat.postMessage did not return a message timestamp.");
+            }
+            return {
+                teamId,
+                workspaceHost: bootstrap.workspaceHost,
+                channelId,
+                ts,
+            };
+        },
+        addReaction: async ({ channel, timestamp, name }) => {
+            const channelId = await resolveConversationId(channel);
+            await invokeJsonApi("reactions.add", {
+                channel: channelId,
+                timestamp,
+                name,
+            });
+            return {
+                teamId,
+                workspaceHost: bootstrap.workspaceHost,
+                channelId,
+            };
+        },
+        close: async () => {
+            await page.close().catch(() => undefined);
+            await context.close().catch(() => undefined);
+            await browser.close().catch(() => undefined);
+        },
+    };
+}
+//# sourceMappingURL=desktop-session.js.map

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

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

package/dist-cjs/tool-factory.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @aria/tools - Tool factory function
+ *
+ * Creates Tool objects from Zod schemas with runtime validation.
+ */
+import type { ZodType } from "zod";
+import type { Tool, ToolCategory, ToolContext, ToolResult, RiskLevel, LoadingTier } from "./types.js";
+/** Options for the tool() factory function */
+export interface ToolFactoryOptions<T> {
+    /** Unique tool name */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Zod schema for parameter validation */
+    parameters: ZodType<T>;
+    /** Tool execution handler - receives Zod-validated input */
+    execute: (input: T, context: ToolContext) => Promise<ToolResult>;
+    /** Risk level for auto-approval (default: "safe") */
+    riskLevel?: RiskLevel;
+    /** Whether this tool only reads state (default: true) */
+    isReadOnly?: boolean;
+    /** Tool category (default: "meta") */
+    category?: ToolCategory;
+    /** Loading tier for TTFT optimization (default: "always") */
+    loadingTier?: LoadingTier;
+}
+/**
+ * Factory function for creating Tool objects from Zod schemas.
+ *
+ * Converts the Zod schema to JSON Schema 7 for LLM consumption,
+ * and wraps the execute handler with Zod validation.
+ *
+ * @example
+ * ```ts
+ * const getWeather = tool({
+ *   name: "get_weather",
+ *   description: "Get weather for a city",
+ *   parameters: z.object({ city: z.string(), units: z.enum(["F", "C"]) }),
+ *   execute: async (input) => ({
+ *     success: true,
+ *     message: `Weather in ${input.city}: sunny`,
+ *   }),
+ * });
+ * ```
+ */
+export declare function tool<T>(options: ToolFactoryOptions<T>): Tool;

package/dist-cjs/tool-factory.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * @aria/tools - Tool factory function
+ *
+ * Creates Tool objects from Zod schemas with runtime validation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tool = tool;
+const zod_1 = require("zod");
+/**
+ * Factory function for creating Tool objects from Zod schemas.
+ *
+ * Converts the Zod schema to JSON Schema 7 for LLM consumption,
+ * and wraps the execute handler with Zod validation.
+ *
+ * @example
+ * ```ts
+ * const getWeather = tool({
+ *   name: "get_weather",
+ *   description: "Get weather for a city",
+ *   parameters: z.object({ city: z.string(), units: z.enum(["F", "C"]) }),
+ *   execute: async (input) => ({
+ *     success: true,
+ *     message: `Weather in ${input.city}: sunny`,
+ *   }),
+ * });
+ * ```
+ */
+function tool(options) {
+    const { name, description, parameters: zodSchema, execute, riskLevel = "safe", isReadOnly = true, category = "meta", loadingTier = "always", } = options;
+    // Convert Zod schema to JSON Schema 7 using Zod v4's built-in conversion
+    const jsonSchema = zod_1.z.toJSONSchema(zodSchema);
+    // Remove the $schema key since the Tool interface expects a plain JSONSchema7 object
+    // describing the parameters, not a full standalone schema document
+    delete jsonSchema.$schema;
+    return {
+        name,
+        description,
+        category,
+        parameters: jsonSchema,
+        riskLevel,
+        isReadOnly,
+        loadingTier,
+        execute: async (input, context) => {
+            // Validate input with Zod before calling the handler
+            const parsed = zodSchema.parse(input);
+            return execute(parsed, context);
+        },
+    };
+}
+//# sourceMappingURL=tool-factory.js.map

package/dist-cjs/tool-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-factory.js","sourceRoot":"","sources":["../src/tool-factory.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAqDH,oBAiCC;AAnFD,6BAAwB;AA+BxB;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,IAAI,CAAI,OAA8B;IACpD,MAAM,EACJ,IAAI,EACJ,WAAW,EACX,UAAU,EAAE,SAAS,EACrB,OAAO,EACP,SAAS,GAAG,MAAM,EAClB,UAAU,GAAG,IAAI,EACjB,QAAQ,GAAG,MAAM,EACjB,WAAW,GAAG,QAAQ,GACvB,GAAG,OAAO,CAAC;IAEZ,yEAAyE;IACzE,MAAM,UAAU,GAAG,OAAC,CAAC,YAAY,CAAC,SAAS,CAAgB,CAAC;IAE5D,qFAAqF;IACrF,mEAAmE;IACnE,OAAO,UAAU,CAAC,OAAO,CAAC;IAE1B,OAAO;QACL,IAAI;QACJ,WAAW;QACX,QAAQ;QACR,UAAU,EAAE,UAAU;QACtB,SAAS;QACT,UAAU;QACV,WAAW;QACX,OAAO,EAAE,KAAK,EAAE,KAAc,EAAE,OAAoB,EAAuB,EAAE;YAC3E,qDAAqD;YACrD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC;YAC3C,OAAO,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC"}