narai-primitives 2.1.3 → 2.2.0

package/dist/toolkit/http_client.d.ts

@@ -0,0 +1,134 @@
+/**
+ * http_client.ts — shared HTTP client used by every HTTP-based connector.
+ *
+ * Replaces the near-identical retry/throttle/timeout/auth machinery that
+ * previously lived in each connector's lib/<name>_client.ts. Connectors
+ * pass in their auth header and any service-specific defaults; the
+ * client handles the rest:
+ *
+ * - GET/POST/PUT/DELETE/PATCH allow-list (default GET-only)
+ * - URL validation via `validateUrl`
+ * - Per-client rate limit (60 req/min default)
+ * - Connect + read timeouts via AbortController (10s / 30s default)
+ * - 429/5xx retry with `Retry-After` honoured + exponential backoff
+ * - Test injection (`fetchImpl`, `sleepImpl`)
+ * - JSON / binary / text response handling
+ * - Custom retry signal (`shouldRetryResponse`) for service-specific
+ *   quirks like GitHub's `x-ratelimit-remaining=0` on a 403.
+ *
+ * GraphQL connectors layer their own `{data, errors}` unwrapping on top
+ * of `request("POST", "/graphql", { body: { query, variables } })`. The
+ * client itself remains protocol-agnostic.
+ */
+import type { ErrorCode } from "./policy/types.js";
+export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+export interface HttpResultOk<T> {
+    ok: true;
+    data: T;
+    status: number;
+}
+export interface HttpResultErr {
+    ok: false;
+    code: string;
+    message: string;
+    retriable: boolean;
+    status?: number;
+}
+export type HttpResult<T> = HttpResultOk<T> | HttpResultErr;
+export interface BinaryResponse {
+    bytes: Uint8Array;
+    contentType: string;
+    filename: string;
+}
+export type ResponseType = "json" | "binary" | "text";
+export interface HttpRequestOptions {
+    query?: Record<string, string | number | boolean | null | undefined> | undefined;
+    body?: unknown | undefined;
+    headers?: Record<string, string> | undefined;
+    responseType?: ResponseType | undefined;
+    /**
+     * For `responseType: "binary"`, the filename to use when the response
+     * has no Content-Disposition header. If omitted, falls back to the
+     * last path segment of the URL (or "download").
+     */
+    filenameFallback?: string | undefined;
+}
+export interface HttpClientOptions {
+    /** Absolute URL — relative paths in `request()` are joined to this. */
+    baseUrl: string;
+    /** Pre-formatted Authorization header value (e.g. `Bearer abc`, `Basic ...`). */
+    authHeader: string;
+    /** Used in error messages (e.g. "GitHub rate limit hit"). */
+    serviceName: string;
+    /** Allowed HTTP methods. Default: `["GET"]`. */
+    allowedMethods?: ReadonlySet<HttpMethod> | undefined;
+    /** Headers attached to every request (e.g. `Notion-Version`, custom `Accept`). */
+    defaultHeaders?: Record<string, string> | undefined;
+    rateLimitPerMin?: number | undefined;
+    connectTimeoutMs?: number | undefined;
+    readTimeoutMs?: number | undefined;
+    maxAttempts?: number | undefined;
+    fetchImpl?: typeof globalThis.fetch | undefined;
+    sleepImpl?: ((ms: number) => Promise<void>) | undefined;
+    /**
+     * Service-specific retry signal. Return `true` for non-429/non-5xx
+     * responses that should still trigger the retry loop. Example: GitHub's
+     * 403 with `x-ratelimit-remaining: 0` is a rate-limit in disguise.
+     */
+    shouldRetryResponse?: ((response: Response) => boolean) | undefined;
+}
+export declare function classifyHttpStatus(status: number): string;
+/**
+ * Default mapping from `HttpClient` `result.code` values to canonical
+ * `ErrorCode`s used by `createConnector`. Each connector typically
+ * spreads this and overrides a few connector-specific keys.
+ */
+export declare const DEFAULT_HTTP_CODE_MAP: Record<string, string>;
+export declare class HttpClient {
+    private readonly _baseUrl;
+    private readonly _authHeader;
+    private readonly _serviceName;
+    private readonly _allowedMethods;
+    private readonly _defaultHeaders;
+    private readonly _rateLimitPerMin;
+    private readonly _connectTimeoutMs;
+    private readonly _readTimeoutMs;
+    private readonly _maxAttempts;
+    private readonly _fetch;
+    private readonly _sleep;
+    private readonly _shouldRetryResponse;
+    private _requestTimestamps;
+    constructor(opts: HttpClientOptions);
+    get baseUrl(): string;
+    get host(): string;
+    request<T = unknown>(method: HttpMethod, path: string, opts?: HttpRequestOptions): Promise<HttpResult<T>>;
+    /** Clear the per-client rate-limit sliding window. Test-only convenience. */
+    resetRateLimiter(): void;
+    private _throttle;
+    private _buildUrl;
+    private _buildHeaders;
+}
+export declare function parseRetryAfter(header: string | null): number | null;
+export declare function truncate(s: string, n: number): string;
+export declare function parseContentDispositionFilename(header: string | null): string | null;
+export declare function filenameFromPath(path: string): string;
+/**
+ * Convert a `HttpResult.ok=false` into a thrown `ConnectorError` so action
+ * handlers can keep using the throw-on-error contract that `createConnector`
+ * expects. Eliminates the per-connector `throwIfError` helpers.
+ */
+export declare function throwIfHttpError<T>(result: HttpResult<T>): asserts result is Extract<HttpResult<T>, {
+    ok: true;
+}>;
+/**
+ * Build a `mapError` function suitable for passing to `createConnector`'s
+ * options. Translates `ConnectorError.code` through the supplied code map
+ * into a canonical `ErrorCode` envelope. Eliminates the per-connector
+ * `mapError: (err) => { if (err instanceof XxxError) ... }` boilerplate.
+ */
+export declare function mapHttpError(codeMap: Record<string, ErrorCode>, defaultCode?: ErrorCode): (err: unknown) => {
+    error_code: ErrorCode;
+    message: string;
+    retriable: boolean;
+} | undefined;
+//# sourceMappingURL=http_client.d.ts.map

package/dist/toolkit/http_client.d.ts.map

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

package/dist/toolkit/http_client.js

@@ -0,0 +1,385 @@
+/**
+ * http_client.ts — shared HTTP client used by every HTTP-based connector.
+ *
+ * Replaces the near-identical retry/throttle/timeout/auth machinery that
+ * previously lived in each connector's lib/<name>_client.ts. Connectors
+ * pass in their auth header and any service-specific defaults; the
+ * client handles the rest:
+ *
+ * - GET/POST/PUT/DELETE/PATCH allow-list (default GET-only)
+ * - URL validation via `validateUrl`
+ * - Per-client rate limit (60 req/min default)
+ * - Connect + read timeouts via AbortController (10s / 30s default)
+ * - 429/5xx retry with `Retry-After` honoured + exponential backoff
+ * - Test injection (`fetchImpl`, `sleepImpl`)
+ * - JSON / binary / text response handling
+ * - Custom retry signal (`shouldRetryResponse`) for service-specific
+ *   quirks like GitHub's `x-ratelimit-remaining=0` on a 403.
+ *
+ * GraphQL connectors layer their own `{data, errors}` unwrapping on top
+ * of `request("POST", "/graphql", { body: { query, variables } })`. The
+ * client itself remains protocol-agnostic.
+ */
+import { validateUrl } from "./security_check.js";
+import { ConnectorError } from "./connector_error.js";
+const DEFAULT_CONNECT_TIMEOUT_MS = 10_000;
+const DEFAULT_READ_TIMEOUT_MS = 30_000;
+const DEFAULT_RATE_LIMIT_PER_MIN = 60;
+const DEFAULT_MAX_ATTEMPTS = 4;
+const DEFAULT_ALLOWED_METHODS = new Set([
+    "GET",
+]);
+export function classifyHttpStatus(status) {
+    if (status === 401)
+        return "UNAUTHORIZED";
+    if (status === 403)
+        return "FORBIDDEN";
+    if (status === 404)
+        return "NOT_FOUND";
+    if (status === 422)
+        return "UNPROCESSABLE";
+    if (status === 400)
+        return "BAD_REQUEST";
+    return "HTTP_ERROR";
+}
+/**
+ * Default mapping from `HttpClient` `result.code` values to canonical
+ * `ErrorCode`s used by `createConnector`. Each connector typically
+ * spreads this and overrides a few connector-specific keys.
+ */
+export const DEFAULT_HTTP_CODE_MAP = {
+    UNAUTHORIZED: "AUTH_ERROR",
+    FORBIDDEN: "AUTH_ERROR",
+    NOT_FOUND: "NOT_FOUND",
+    RATE_LIMITED: "RATE_LIMITED",
+    TIMEOUT: "TIMEOUT",
+    NETWORK_ERROR: "CONNECTION_ERROR",
+    SERVER_ERROR: "CONNECTION_ERROR",
+    BAD_REQUEST: "VALIDATION_ERROR",
+    UNPROCESSABLE: "VALIDATION_ERROR",
+    INVALID_URL: "VALIDATION_ERROR",
+    METHOD_NOT_ALLOWED: "VALIDATION_ERROR",
+    HTTP_ERROR: "CONNECTION_ERROR",
+    CONFIG_ERROR: "CONFIG_ERROR",
+};
+export class HttpClient {
+    _baseUrl;
+    _authHeader;
+    _serviceName;
+    _allowedMethods;
+    _defaultHeaders;
+    _rateLimitPerMin;
+    _connectTimeoutMs;
+    _readTimeoutMs;
+    _maxAttempts;
+    _fetch;
+    _sleep;
+    _shouldRetryResponse;
+    _requestTimestamps = [];
+    constructor(opts) {
+        if (!validateUrl(opts.baseUrl)) {
+            throw new Error(`Invalid base URL: ${opts.baseUrl}`);
+        }
+        this._baseUrl = opts.baseUrl.replace(/\/+$/, "");
+        this._authHeader = opts.authHeader;
+        this._serviceName = opts.serviceName;
+        this._allowedMethods = opts.allowedMethods ?? DEFAULT_ALLOWED_METHODS;
+        this._defaultHeaders = opts.defaultHeaders ?? {};
+        this._rateLimitPerMin = opts.rateLimitPerMin ?? DEFAULT_RATE_LIMIT_PER_MIN;
+        this._connectTimeoutMs = opts.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS;
+        this._readTimeoutMs = opts.readTimeoutMs ?? DEFAULT_READ_TIMEOUT_MS;
+        this._maxAttempts = opts.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
+        this._fetch = opts.fetchImpl ?? globalThis.fetch.bind(globalThis);
+        this._sleep =
+            opts.sleepImpl ??
+                ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+        this._shouldRetryResponse = opts.shouldRetryResponse;
+    }
+    get baseUrl() {
+        return this._baseUrl;
+    }
+    get host() {
+        return new URL(this._baseUrl).host;
+    }
+    async request(method, path, opts = {}) {
+        if (!this._allowedMethods.has(method)) {
+            return {
+                ok: false,
+                code: "METHOD_NOT_ALLOWED",
+                message: `Method ${method} not allowed`,
+                retriable: false,
+            };
+        }
+        const url = this._buildUrl(path, opts.query);
+        if (!validateUrl(url)) {
+            return {
+                ok: false,
+                code: "INVALID_URL",
+                message: `URL rejected: ${url}`,
+                retriable: false,
+            };
+        }
+        const responseType = opts.responseType ?? "json";
+        let lastError = null;
+        for (let attempt = 0; attempt < this._maxAttempts; attempt++) {
+            await this._throttle();
+            const ctrl = new AbortController();
+            const timer = setTimeout(() => ctrl.abort(), this._connectTimeoutMs + this._readTimeoutMs);
+            try {
+                const headers = this._buildHeaders(opts, responseType);
+                // Pass FormData / Blob / ArrayBuffer / typed-array / string bodies
+                // through unchanged; fetch handles their encoding (and for FormData
+                // sets the multipart boundary, which is why we leave Content-Type
+                // off in that case — see _buildHeaders).
+                const hasBody = opts.body !== undefined && opts.body !== null;
+                const init = hasBody
+                    ? {
+                        method,
+                        headers,
+                        signal: ctrl.signal,
+                        body: isRawBody(opts.body)
+                            ? // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                                opts.body
+                            : JSON.stringify(opts.body),
+                    }
+                    : { method, headers, signal: ctrl.signal };
+                const response = await this._fetch(url, init);
+                const status = response.status;
+                const customRetry = this._shouldRetryResponse?.(response) ?? false;
+                if (status === 429 || customRetry) {
+                    const retryAfter = parseRetryAfter(response.headers.get("retry-after"));
+                    lastError = {
+                        ok: false,
+                        code: "RATE_LIMITED",
+                        message: `${this._serviceName} rate limit hit`,
+                        retriable: true,
+                        status,
+                    };
+                    if (attempt < this._maxAttempts - 1) {
+                        await this._sleep(retryAfter ?? Math.min(30_000, 500 * 2 ** attempt));
+                        continue;
+                    }
+                    return lastError;
+                }
+                if (status >= 500) {
+                    const retryAfter = parseRetryAfter(response.headers.get("retry-after"));
+                    lastError = {
+                        ok: false,
+                        code: "SERVER_ERROR",
+                        message: `${this._serviceName} returned HTTP ${status}`,
+                        retriable: true,
+                        status,
+                    };
+                    if (attempt < this._maxAttempts - 1) {
+                        await this._sleep(retryAfter ?? Math.min(30_000, 500 * 2 ** attempt));
+                        continue;
+                    }
+                    return lastError;
+                }
+                if (!response.ok) {
+                    let bodyText = "";
+                    try {
+                        bodyText = await response.text();
+                    }
+                    catch {
+                        /* ignore */
+                    }
+                    return {
+                        ok: false,
+                        code: classifyHttpStatus(status),
+                        message: `${this._serviceName} HTTP ${status}: ${truncate(bodyText, 200)}`,
+                        retriable: false,
+                        status,
+                    };
+                }
+                if (status === 204) {
+                    return { ok: true, data: {}, status };
+                }
+                if (responseType === "binary") {
+                    const buf = await response.arrayBuffer();
+                    const cdName = parseContentDispositionFilename(response.headers.get("content-disposition"));
+                    const data = {
+                        bytes: new Uint8Array(buf),
+                        contentType: response.headers.get("content-type") ??
+                            "application/octet-stream",
+                        filename: cdName ?? opts.filenameFallback ?? filenameFromPath(path),
+                    };
+                    return { ok: true, data: data, status };
+                }
+                if (responseType === "text") {
+                    const data = (await response.text());
+                    return { ok: true, data, status };
+                }
+                const data = (await response.json());
+                return { ok: true, data, status };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                const aborted = err instanceof DOMException || /abort/i.test(message);
+                lastError = {
+                    ok: false,
+                    code: aborted ? "TIMEOUT" : "NETWORK_ERROR",
+                    message: aborted ? "Request timed out" : message,
+                    retriable: true,
+                };
+                if (attempt < this._maxAttempts - 1) {
+                    await this._sleep(Math.min(30_000, 500 * 2 ** attempt));
+                    continue;
+                }
+                return lastError;
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        }
+        return (lastError ?? {
+            ok: false,
+            code: "UNKNOWN",
+            message: "Exhausted retries without a response",
+            retriable: true,
+        });
+    }
+    /** Clear the per-client rate-limit sliding window. Test-only convenience. */
+    resetRateLimiter() {
+        this._requestTimestamps = [];
+    }
+    async _throttle() {
+        const now = Date.now();
+        const cutoff = now - 60_000;
+        this._requestTimestamps = this._requestTimestamps.filter((t) => t > cutoff);
+        if (this._requestTimestamps.length >= this._rateLimitPerMin) {
+            const oldest = this._requestTimestamps[0] ?? now;
+            const waitMs = Math.max(0, 60_000 - (now - oldest));
+            if (waitMs > 0)
+                await this._sleep(waitMs);
+            this._requestTimestamps = this._requestTimestamps.filter((t) => t > Date.now() - 60_000);
+        }
+        this._requestTimestamps.push(Date.now());
+    }
+    _buildUrl(path, query) {
+        const isAbsolute = /^[a-z][a-z0-9+.\-]*:\/\//i.test(path);
+        const url = isAbsolute
+            ? path
+            : `${this._baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+        if (!query)
+            return url;
+        const params = new URLSearchParams();
+        for (const [k, v] of Object.entries(query)) {
+            if (v === undefined || v === null)
+                continue;
+            params.append(k, String(v));
+        }
+        const qs = params.toString();
+        return qs ? `${url}${url.includes("?") ? "&" : "?"}${qs}` : url;
+    }
+    _buildHeaders(opts, responseType) {
+        const accept = responseType === "binary"
+            ? "*/*"
+            : responseType === "text"
+                ? "text/plain"
+                : "application/json";
+        const headers = {
+            Authorization: this._authHeader,
+            Accept: accept,
+            ...this._defaultHeaders,
+            ...(opts.headers ?? {}),
+        };
+        const hasBody = opts.body !== undefined && opts.body !== null;
+        const headerHasCT = "Content-Type" in headers || "content-type" in headers;
+        // Only inject Content-Type for serialized JSON bodies. FormData/Blob/
+        // ArrayBuffer / typed-array bodies need fetch to set their own
+        // Content-Type (multipart boundary, binary mime, etc.).
+        if (hasBody && !headerHasCT && !isRawBody(opts.body)) {
+            headers["Content-Type"] = "application/json";
+        }
+        return headers;
+    }
+}
+function isRawBody(body) {
+    if (typeof body === "string")
+        return true;
+    if (body instanceof ArrayBuffer)
+        return true;
+    if (body instanceof Uint8Array)
+        return true;
+    if (typeof FormData !== "undefined" && body instanceof FormData)
+        return true;
+    if (typeof Blob !== "undefined" && body instanceof Blob)
+        return true;
+    if (typeof URLSearchParams !== "undefined" &&
+        body instanceof URLSearchParams) {
+        return true;
+    }
+    return false;
+}
+// ─── Helpers (internal but stable enough to export for tests) ────────────
+export function parseRetryAfter(header) {
+    if (!header)
+        return null;
+    const seconds = Number(header);
+    if (Number.isFinite(seconds) && seconds >= 0) {
+        return Math.round(seconds * 1000);
+    }
+    // Reject negative numeric values explicitly so they don't fall through
+    // into Date.parse (which would interpret "-5" as year 5 BC and emit 0).
+    if (Number.isFinite(seconds) && seconds < 0)
+        return null;
+    const date = Date.parse(header);
+    if (Number.isFinite(date)) {
+        const delta = date - Date.now();
+        return delta > 0 ? delta : null;
+    }
+    return null;
+}
+export function truncate(s, n) {
+    return s.length > n ? s.slice(0, n) + "…" : s;
+}
+export function parseContentDispositionFilename(header) {
+    if (!header)
+        return null;
+    const utf8 = header.match(/filename\*=UTF-8''([^;]+)/i);
+    if (utf8?.[1]) {
+        try {
+            return decodeURIComponent(utf8[1].trim());
+        }
+        catch {
+            /* fall through */
+        }
+    }
+    const plain = header.match(/filename="?([^";]+)"?/i);
+    return plain?.[1] ?? null;
+}
+export function filenameFromPath(path) {
+    const clean = path.split("?")[0] ?? path;
+    const segments = clean.split("/").filter(Boolean);
+    return segments[segments.length - 1] ?? "download";
+}
+/**
+ * Convert a `HttpResult.ok=false` into a thrown `ConnectorError` so action
+ * handlers can keep using the throw-on-error contract that `createConnector`
+ * expects. Eliminates the per-connector `throwIfError` helpers.
+ */
+export function throwIfHttpError(result) {
+    if (!result.ok) {
+        throw new ConnectorError(result.code, result.message, result.retriable, result.status);
+    }
+}
+/**
+ * Build a `mapError` function suitable for passing to `createConnector`'s
+ * options. Translates `ConnectorError.code` through the supplied code map
+ * into a canonical `ErrorCode` envelope. Eliminates the per-connector
+ * `mapError: (err) => { if (err instanceof XxxError) ... }` boilerplate.
+ */
+export function mapHttpError(codeMap, defaultCode = "CONNECTION_ERROR") {
+    return (err) => {
+        if (err instanceof ConnectorError) {
+            return {
+                error_code: codeMap[err.code] ?? defaultCode,
+                message: err.message,
+                retriable: err.retriable,
+            };
+        }
+        return undefined;
+    };
+}
+//# sourceMappingURL=http_client.js.map

package/dist/toolkit/http_client.js.map

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

package/dist/toolkit/index.d.ts

@@ -32,6 +32,7 @@ export { importOptional, isBinaryOnPath } from "./_optional.js";
 export { extract as extractBinary, extractPdf, extractDocx, extractPptx, normalizeExtracted, ExtractCapExceeded, FORMAT_MAP, type BinaryFormat, type ExtractOptions, type ExtractResult, } from "./extract_binary.js";
 export { dispatchMultimodal, type MultimodalConfig, type MultimodalFormat, type MultimodalMode, type MultimodalResult, } from "./extract_multimodal.js";
 export { fetchAttachment, type FetchAttachmentOptions, type FetchAttachmentResult, } from "./fetch_attachment.js";
+export { validateAdf, assertValidAdf, type ADFNode, type ADFDocument, type ValidateResult, } from "./atlassian/index.js";
 export { hashScopeKey, resolveTierPaths, type Tier, type TierPaths, type TierName, } from "./hardship/scope.js";
 export { loadPatterns, matchPattern, type Pattern, type PatternsFile, type PatternMatcher, type HardshipFacts, type MatchedPattern, } from "./hardship/patterns.js";
 export { readFirstMatchingPattern, type ReadFirstMatchingPatternOptions, type TierMatch, } from "./hardship/read.js";
@@ -39,4 +40,6 @@ export { renderSkillPreamble, type RenderSkillPreambleOptions, } from "./hardshi
 export * as usage from "./usage/index.js";
 export { resolveAgentCli, type ResolveAgentCliOptions, type ResolvedAgentCli, type ResolutionSource, } from "./agent_resolver.js";
 export { loadGuardrailManifest, findBlockingRule, defaultDenyMessage, type GuardrailRule, type GuardrailManifest, type BlockMatch, } from "./guardrail.js";
+export { ConnectorError } from "./connector_error.js";
+export { HttpClient, DEFAULT_HTTP_CODE_MAP, classifyHttpStatus, throwIfHttpError, mapHttpError, parseRetryAfter, truncate, parseContentDispositionFilename, filenameFromPath, type BinaryResponse, type HttpClientOptions, type HttpMethod, type HttpRequestOptions, type HttpResult, type HttpResultErr, type HttpResultOk, type ResponseType, } from "./http_client.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/toolkit/index.d.ts.map

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

package/dist/toolkit/index.js

@@ -38,6 +38,8 @@ export { importOptional, isBinaryOnPath } from "./_optional.js";
 export { extract as extractBinary, extractPdf, extractDocx, extractPptx, normalizeExtracted, ExtractCapExceeded, FORMAT_MAP, } from "./extract_binary.js";
 export { dispatchMultimodal, } from "./extract_multimodal.js";
 export { fetchAttachment, } from "./fetch_attachment.js";
+// ─── Atlassian helpers (shared by jira + confluence) ─────────────────────
+export { validateAdf, assertValidAdf, } from "./atlassian/index.js";
 // ─── Self-improvement layer (added in 3.0) ───────────────────────────────
 export { hashScopeKey, resolveTierPaths, } from "./hardship/scope.js";
 export { loadPatterns, matchPattern, } from "./hardship/patterns.js";
@@ -48,4 +50,7 @@ export * as usage from "./usage/index.js";
 // ─── Agent CLI resolution + guardrails (added in 3.3) ────────────────────
 export { resolveAgentCli, } from "./agent_resolver.js";
 export { loadGuardrailManifest, findBlockingRule, defaultDenyMessage, } from "./guardrail.js";
+// ─── HTTP client (added in 3.4) ──────────────────────────────────────────
+export { ConnectorError } from "./connector_error.js";
+export { HttpClient, DEFAULT_HTTP_CODE_MAP, classifyHttpStatus, throwIfHttpError, mapHttpError, parseRetryAfter, truncate, parseContentDispositionFilename, filenameFromPath, } from "./http_client.js";
 //# sourceMappingURL=index.js.map

package/dist/toolkit/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/toolkit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,8EAA8E;AAE9E,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,YAAY,GAOb,MAAM,gBAAgB,CAAC;AAExB,8EAA8E;AAE9E,OAAO,EACL,aAAa,EACb,cAAc,GAgBf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,gBAAgB,GAEjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,GAIrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,8EAA8E;AAE9E,OAAO,EACL,iBAAiB,EACjB,YAAY,GAGb,MAAM,mBAAmB,CAAC;AAW3B,8EAA8E;AAE9E,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GAKpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,GAEjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GAGpB,MAAM,sBAAsB,CAAC;AAE9B,8EAA8E;AAE9E,OAAO,EACL,aAAa,EACb,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,UAAU,GAEX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,aAAa,EACb,kBAAkB,GAGnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,mBAAmB,GAGpB,MAAM,wBAAwB,CAAC;AAEhC,8EAA8E;AAE9E,OAAO,EACL,cAAc,GAGf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,aAAa,GAEd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,8EAA8E;AAE9E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EACL,OAAO,IAAI,aAAa,EACxB,UAAU,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,GAIX,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,GAKnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,GAGhB,MAAM,uBAAuB,CAAC;AAE/B,4EAA4E;AAE5E,OAAO,EACL,YAAY,EACZ,gBAAgB,GAIjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,YAAY,EACZ,YAAY,GAMb,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,wBAAwB,GAGzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,mBAAmB,GAEpB,MAAM,wBAAwB,CAAC;AAEhC,4EAA4E;AAE5E,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAE1C,4EAA4E;AAE5E,OAAO,EACL,eAAe,GAIhB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GAInB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/toolkit/index.ts"],"names":[],"mappings":"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"}

package/dist/toolkit/usage/aggregate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../../src/toolkit/usage/aggregate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAGb,MAAM,YAAY,CAAC;AAEpB,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EAAE,GACrB,YAAY,CA+Ed;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAoC7D"}
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../../src/toolkit/usage/aggregate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAGb,MAAM,YAAY,CAAC;AAEpB,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EAAE,GACrB,YAAY,CAqGd;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAuC7D"}