@aria-cli/tools 1.0.10 → 1.0.11

package/dist-cjs/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * @aria/tools - Tool system types
+ *
+ * Unified tool interface for all ARIA tools.
+ * All tools are LLM-callable with optional user confirmation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist-cjs/types.js.map

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

package/dist-cjs/utils/retry.d.ts

@@ -0,0 +1,11 @@
+export interface RetryOptions {
+    maxAttempts?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    retryableStatuses?: number[];
+    retryableCodes?: string[];
+    /** Custom fetch function for per-attempt wrappers (e.g., DNS pinning). */
+    fetchFn?: (url: string, init: RequestInit) => Promise<Response>;
+}
+export declare function fetchWithRetry(url: string, init: RequestInit, options?: RetryOptions): Promise<Response>;
+export declare function fetchWithSsrf(url: string, init: RequestInit, retryOptions?: RetryOptions): Promise<Response>;

package/dist-cjs/utils/retry.js

@@ -0,0 +1,170 @@
+"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.fetchWithRetry = fetchWithRetry;
+exports.fetchWithSsrf = fetchWithSsrf;
+function createAbortError() {
+    const err = new Error("AbortError");
+    err.name = "AbortError";
+    return err;
+}
+/**
+ * AbortSignal-aware sleep that rejects immediately if the signal fires during the delay.
+ */
+function abortAwareSleep(ms, signal) {
+    if (signal?.aborted) {
+        return Promise.reject(createAbortError());
+    }
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        let abortHandler;
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            if (signal && abortHandler) {
+                signal.removeEventListener("abort", abortHandler);
+            }
+            resolve();
+        }, ms);
+        if (signal) {
+            abortHandler = () => {
+                if (settled)
+                    return;
+                settled = true;
+                signal.removeEventListener("abort", abortHandler);
+                clearTimeout(timer);
+                reject(createAbortError());
+            };
+            signal.addEventListener("abort", abortHandler, { once: true });
+        }
+    });
+}
+function isAbortError(err) {
+    if (!(err instanceof Error))
+        return false;
+    const domErr = err;
+    return domErr.name === "AbortError" || err.message === "AbortError";
+}
+function getErrorCode(err) {
+    if (typeof err === "object" &&
+        err !== null &&
+        "code" in err &&
+        typeof err.code === "string") {
+        return err.code;
+    }
+    if (err instanceof Error && err.cause) {
+        const cause = err.cause;
+        if (typeof cause.code === "string") {
+            return cause.code;
+        }
+    }
+    return undefined;
+}
+async function fetchWithRetry(url, init, options) {
+    const maxAttempts = options?.maxAttempts ?? 3;
+    const baseDelayMs = options?.baseDelayMs ?? 1000;
+    const maxDelayMs = options?.maxDelayMs ?? 30000;
+    const retryableStatuses = options?.retryableStatuses ?? [429, 500, 502, 503, 504];
+    const retryableCodes = options?.retryableCodes ?? [
+        "ECONNRESET",
+        "ETIMEDOUT",
+        "EPIPE",
+        "ENETUNREACH",
+        "EHOSTUNREACH",
+        "ECONNREFUSED",
+        "EAI_AGAIN",
+        "UND_ERR_CONNECT_TIMEOUT",
+        "UND_ERR_SOCKET",
+    ];
+    const doFetch = options?.fetchFn ?? fetch;
+    const signal = init.signal ?? null;
+    if (signal?.aborted) {
+        throw createAbortError();
+    }
+    let lastError;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        try {
+            const response = await doFetch(url, init);
+            // Check for Cloudflare 403 challenge
+            if (response.status === 403 && response.headers.get("cf-mitigated") === "challenge") {
+                if (attempt < maxAttempts - 1) {
+                    // Retry with simplified UA
+                    const delay = Math.min(baseDelayMs * 2 ** attempt + Math.random() * 500, maxDelayMs);
+                    await abortAwareSleep(delay, signal);
+                    continue;
+                }
+                // Last attempt - throw
+                throw new Error(`Cloudflare challenge after ${maxAttempts} attempts: ${response.status}`);
+            }
+            // Check for retryable status codes
+            if (!response.ok && retryableStatuses.includes(response.status)) {
+                if (attempt < maxAttempts - 1) {
+                    const delay = Math.min(baseDelayMs * 2 ** attempt + Math.random() * 500, maxDelayMs);
+                    await abortAwareSleep(delay, signal);
+                    continue;
+                }
+                // Last attempt - throw
+                throw new Error(`Request failed after ${maxAttempts} attempts: ${response.status}`);
+            }
+            return response;
+        }
+        catch (err) {
+            // Re-throw AbortError immediately — do not retry aborted requests
+            if (isAbortError(err)) {
+                throw err;
+            }
+            const code = getErrorCode(err);
+            if (code && retryableCodes.includes(code) && attempt < maxAttempts - 1) {
+                const delay = Math.min(baseDelayMs * 2 ** attempt + Math.random() * 500, maxDelayMs);
+                await abortAwareSleep(delay, signal);
+                continue;
+            }
+            lastError = err;
+            throw err;
+        }
+    }
+    throw lastError ?? new Error("fetchWithRetry: unreachable");
+}
+async function fetchWithSsrf(url, init, retryOptions) {
+    const { fetchWithDnsPinning } = await Promise.resolve().then(() => __importStar(require("../security/dns-pinning.js")));
+    return fetchWithRetry(url, init, {
+        ...retryOptions,
+        fetchFn: async (attemptUrl, attemptInit) => {
+            return fetchWithDnsPinning(attemptUrl, attemptInit);
+        },
+    });
+}
+//# sourceMappingURL=retry.js.map

package/dist-cjs/utils/retry.js.map

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

package/dist-cjs/utils/safe-parse-json.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Safe JSON extraction and parsing utilities for LLM output.
+ *
+ * Handles code fences, preamble text, bare JSON, and validates against Zod schemas.
+ * NEVER throws -- always returns a typed Result.
+ */
+import type { ZodType } from "zod";
+export type JsonParseResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    reason: "no_json" | "parse_error" | "schema_mismatch";
+    raw: string;
+};
+/**
+ * Extract JSON substring from LLM output.
+ * Returns the first candidate found by robust balanced scanning.
+ */
+export declare function extractJson(raw: string): string | null;
+/**
+ * Safely extract and parse JSON from LLM output with Zod validation.
+ * Handles code fences, preamble text, bare JSON.
+ * NEVER throws -- always returns a typed Result.
+ */
+export declare function safeParseJson<T>(raw: string, schema: ZodType<T>): JsonParseResult<T>;

package/dist-cjs/utils/safe-parse-json.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * Safe JSON extraction and parsing utilities for LLM output.
+ *
+ * Handles code fences, preamble text, bare JSON, and validates against Zod schemas.
+ * NEVER throws -- always returns a typed Result.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractJson = extractJson;
+exports.safeParseJson = safeParseJson;
+const MAX_SCAN_CHARS = 12_000;
+const MAX_JSON_CANDIDATES = 16;
+function isJsonRootStart(char) {
+    return char === "{" || char === "[";
+}
+/**
+ * Find the end index of a balanced JSON root (object/array) starting at `start`.
+ * Returns -1 when no balanced root can be found.
+ */
+function findBalancedJsonEnd(input, start) {
+    if (start < 0 || start >= input.length)
+        return -1;
+    const first = input[start];
+    if (!isJsonRootStart(first))
+        return -1;
+    const stack = [];
+    let inString = false;
+    let escaped = false;
+    for (let i = start; i < input.length; i++) {
+        const char = input[i];
+        if (!char)
+            continue;
+        if (inString) {
+            if (escaped) {
+                escaped = false;
+                continue;
+            }
+            if (char === "\\") {
+                escaped = true;
+                continue;
+            }
+            if (char === '"') {
+                inString = false;
+            }
+            continue;
+        }
+        if (char === '"') {
+            inString = true;
+            continue;
+        }
+        if (char === "{" || char === "[") {
+            stack.push(char);
+            continue;
+        }
+        if (char === "}" || char === "]") {
+            const opener = stack.pop();
+            if (!opener)
+                return -1;
+            if ((opener === "{" && char !== "}") || (opener === "[" && char !== "]")) {
+                return -1;
+            }
+            if (stack.length === 0) {
+                return i;
+            }
+        }
+    }
+    return -1;
+}
+function collectJsonCandidates(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return [];
+    const seen = new Set();
+    const candidates = [];
+    const add = (candidate) => {
+        if (candidates.length >= MAX_JSON_CANDIDATES)
+            return;
+        const value = candidate.trim();
+        if (!value || !isJsonRootStart(value[0] ?? ""))
+            return;
+        if (seen.has(value))
+            return;
+        seen.add(value);
+        candidates.push(value);
+    };
+    const collectFromText = (text) => {
+        const bounded = text.slice(0, MAX_SCAN_CHARS);
+        for (let i = 0; i < bounded.length && candidates.length < MAX_JSON_CANDIDATES; i++) {
+            const char = bounded[i];
+            if (!char || !isJsonRootStart(char))
+                continue;
+            const end = findBalancedJsonEnd(bounded, i);
+            if (end === -1)
+                continue;
+            add(bounded.slice(i, end + 1));
+            i = end;
+        }
+    };
+    // 1) Prefer explicit code-fence blocks first.
+    const fenceRegex = /```(?:json|JSON)?\s*\n?([\s\S]*?)```/g;
+    for (const match of trimmed.matchAll(fenceRegex)) {
+        const fenced = match[1]?.trim();
+        if (!fenced)
+            continue;
+        if (isJsonRootStart(fenced[0] ?? "")) {
+            add(fenced);
+        }
+        else {
+            collectFromText(fenced);
+        }
+        if (candidates.length >= MAX_JSON_CANDIDATES)
+            break;
+    }
+    // 2) Full-text scan (handles preamble + trailing text + multiple snippets).
+    if (candidates.length < MAX_JSON_CANDIDATES) {
+        if (isJsonRootStart(trimmed[0] ?? "")) {
+            add(trimmed);
+        }
+        collectFromText(trimmed);
+    }
+    return candidates;
+}
+/**
+ * Extract JSON substring from LLM output.
+ * Returns the first candidate found by robust balanced scanning.
+ */
+function extractJson(raw) {
+    return collectJsonCandidates(raw)[0] ?? null;
+}
+/**
+ * Safely extract and parse JSON from LLM output with Zod validation.
+ * Handles code fences, preamble text, bare JSON.
+ * NEVER throws -- always returns a typed Result.
+ */
+function safeParseJson(raw, schema) {
+    const candidates = collectJsonCandidates(raw);
+    if (candidates.length === 0) {
+        return { ok: false, reason: "no_json", raw };
+    }
+    let parseErrorRaw = null;
+    let schemaMismatchRaw = null;
+    for (const jsonStr of candidates) {
+        let parsed;
+        try {
+            parsed = JSON.parse(jsonStr);
+        }
+        catch {
+            parseErrorRaw = jsonStr;
+            continue;
+        }
+        const validated = schema.safeParse(parsed);
+        if (validated.success) {
+            return { ok: true, data: validated.data };
+        }
+        schemaMismatchRaw = jsonStr;
+    }
+    if (schemaMismatchRaw) {
+        return { ok: false, reason: "schema_mismatch", raw: schemaMismatchRaw };
+    }
+    if (parseErrorRaw) {
+        return { ok: false, reason: "parse_error", raw: parseErrorRaw };
+    }
+    return { ok: false, reason: "no_json", raw };
+}
+//# sourceMappingURL=safe-parse-json.js.map

package/dist-cjs/utils/safe-parse-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-parse-json.js","sourceRoot":"","sources":["../../src/utils/safe-parse-json.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA+HH,kCAEC;AAOD,sCAkCC;AAlKD,MAAM,cAAc,GAAG,MAAM,CAAC;AAC9B,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,SAAS,eAAe,CAAC,IAAwB;IAC/C,OAAO,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAAC,KAAa,EAAE,KAAa;IACvD,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC;IAEvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,GAAG,KAAK,CAAC;gBAChB,SAAS;YACX,CAAC;YACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,OAAO,GAAG,IAAI,CAAC;gBACf,SAAS;YACX,CAAC;YACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,QAAQ,GAAG,KAAK,CAAC;YACnB,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,QAAQ,GAAG,IAAI,CAAC;YAChB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,CAAC,CAAC;YACvB,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACzE,OAAO,CAAC,CAAC,CAAC;YACZ,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC;AAED,SAAS,qBAAqB,CAAC,GAAW;IACxC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,GAAG,GAAG,CAAC,SAAiB,EAAE,EAAE;QAChC,IAAI,UAAU,CAAC,MAAM,IAAI,mBAAmB;YAAE,OAAO;QACrD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAAE,OAAO;QACvD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO;QAC5B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,EAAE;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;QAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,GAAG,mBAAmB,EAAE,CAAC,EAAE,EAAE,CAAC;YACnF,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACxB,IAAI,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC9C,MAAM,GAAG,GAAG,mBAAmB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC5C,IAAI,GAAG,KAAK,CAAC,CAAC;gBAAE,SAAS;YACzB,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YAC/B,CAAC,GAAG,GAAG,CAAC;QACV,CAAC;IACH,CAAC,CAAC;IAEF,8CAA8C;IAC9C,MAAM,UAAU,GAAG,uCAAuC,CAAC;IAC3D,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACrC,GAAG,CAAC,MAAM,CAAC,CAAC;QACd,CAAC;aAAM,CAAC;YACN,eAAe,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,IAAI,mBAAmB;YAAE,MAAM;IACtD,CAAC;IAED,4EAA4E;IAC5E,IAAI,UAAU,CAAC,MAAM,GAAG,mBAAmB,EAAE,CAAC;QAC5C,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACtC,GAAG,CAAC,OAAO,CAAC,CAAC;QACf,CAAC;QACD,eAAe,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CAAC,GAAW;IACrC,OAAO,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAI,GAAW,EAAE,MAAkB;IAC9D,MAAM,UAAU,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;IAC/C,CAAC;IAED,IAAI,aAAa,GAAkB,IAAI,CAAC;IACxC,IAAI,iBAAiB,GAAkB,IAAI,CAAC;IAE5C,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;QACjC,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,aAAa,GAAG,OAAO,CAAC;YACxB,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;YACtB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;QAC5C,CAAC;QAED,iBAAiB,GAAG,OAAO,CAAC;IAC9B,CAAC;IAED,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,EAAE,iBAAiB,EAAE,CAAC;IAC1E,CAAC;IACD,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC;IAClE,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;AAC/C,CAAC"}

package/dist-cjs/utils/url.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Convert GitHub blob URLs to raw.githubusercontent.com URLs.
+ * GitHub blob URLs return HTML wrappers; raw URLs return actual file content.
+ */
+export declare function normalizeGitHubUrl(url: string): string;
+/**
+ * Get configurable User-Agent string.
+ * Reads from ARIA_USER_AGENT env var, falls back to default.
+ */
+export declare function getUserAgent(): string;

package/dist-cjs/utils/url.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeGitHubUrl = normalizeGitHubUrl;
+exports.getUserAgent = getUserAgent;
+/**
+ * Convert GitHub blob URLs to raw.githubusercontent.com URLs.
+ * GitHub blob URLs return HTML wrappers; raw URLs return actual file content.
+ */
+function normalizeGitHubUrl(url) {
+    const match = url.match(/^https?:\/\/github\.com\/([^/]+)\/([^/]+)\/blob\/(.+)$/);
+    if (match) {
+        return `https://raw.githubusercontent.com/${match[1]}/${match[2]}/${match[3]}`;
+    }
+    return url;
+}
+/**
+ * Get configurable User-Agent string.
+ * Reads from ARIA_USER_AGENT env var, falls back to default.
+ */
+function getUserAgent() {
+    const DEFAULT_UA = `Mozilla/5.0 (compatible; ARIA/1.0.0; +https://github.com/aria)`;
+    return process.env.ARIA_USER_AGENT ?? DEFAULT_UA;
+}
+//# sourceMappingURL=url.js.map

package/dist-cjs/utils/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":";;AAIA,gDAMC;AAMD,oCAGC;AAnBD;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,GAAW;IAC5C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAClF,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,qCAAqC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY;IAC1B,MAAM,UAAU,GAAG,gEAAgE,CAAC;IACpF,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,UAAU,CAAC;AACnD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aria-cli/tools",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -31,12 +31,12 @@
     "vscode-languageserver-protocol": "^3.17.5",
     "zod": "^4.3.6",
     "zod-to-json-schema": "^3.25.1",
-    "@aria-cli/fastripgrep": "1.0.10",
+    "@aria-cli/fastripgrep": "1.0.11",
     "@aria-cli/search": "0.1.0",
-    "@aria-cli/types": "1.0.10"
+    "@aria-cli/types": "1.0.11"
   },
   "optionalDependencies": {
-    "@aria-cli/cli": "1.0.10"
+    "@aria-cli/cli": "1.0.11"
   },
   "devDependencies": {
     "@types/jsdom": "^28.0.0",
@@ -44,10 +44,11 @@
     "@types/turndown": "^5.0.6",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18",
-    "@aria-cli/memoria": "1.0.10"
+    "@aria-cli/memoria": "1.0.11"
   },
   "files": [
-    "dist/"
+    "dist/",
+    "dist-cjs/"
   ],
   "scripts": {
     "dev": "tsc --watch",