narai-primitives 2.0.0-rc.1

package/dist/connectors/confluence/lib/confluence_client.js

@@ -0,0 +1,329 @@
+/**
+ * confluence_client.ts — read-only Atlassian Confluence REST v1 HTTP client.
+ * Shares the Basic-auth + rate-limit + retry design with jira_client.ts.
+ */
+import { validateUrl } from "narai-primitives/toolkit";
+import { resolveSecret } from "@narai/credential-providers";
+const ALLOWED_METHODS = new Set(["GET"]);
+const DEFAULT_CONNECT_TIMEOUT_MS = 10_000;
+const DEFAULT_READ_TIMEOUT_MS = 30_000;
+const DEFAULT_RATE_LIMIT_PER_MIN = 60;
+const MAX_ATTEMPTS = 4;
+export async function loadConfluenceCredentials() {
+    const siteUrl = process.env["CONFLUENCE_SITE_URL"] ?? null;
+    const email = (await resolveSecret("CONFLUENCE_EMAIL")) ??
+        process.env["CONFLUENCE_EMAIL"] ??
+        null;
+    const apiToken = (await resolveSecret("CONFLUENCE_API_TOKEN")) ??
+        process.env["CONFLUENCE_API_TOKEN"] ??
+        null;
+    if (!siteUrl || !email || !apiToken)
+        return null;
+    return { siteUrl, email, apiToken };
+}
+export class ConfluenceClient {
+    _site;
+    _authHeader;
+    _rateLimitPerMin;
+    _connectTimeoutMs;
+    _readTimeoutMs;
+    _fetch;
+    _sleep;
+    _requestTimestamps = [];
+    constructor(opts) {
+        if (!validateUrl(opts.siteUrl)) {
+            throw new Error(`Invalid Confluence site URL: ${opts.siteUrl}`);
+        }
+        this._site = opts.siteUrl.replace(/\/+$/, "");
+        const basic = Buffer.from(`${opts.email}:${opts.apiToken}`, "utf-8").toString("base64");
+        this._authHeader = `Basic ${basic}`;
+        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._fetch = opts.fetchImpl ?? globalThis.fetch.bind(globalThis);
+        this._sleep =
+            opts.sleepImpl ??
+                ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    }
+    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 relative = path.startsWith("/") ? path : `/${path}`;
+        const base = `${this._site}${relative}`;
+        if (!query)
+            return base;
+        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 ? `${base}?${qs}` : base;
+    }
+    async request(method, path, init = {}) {
+        if (!ALLOWED_METHODS.has(method)) {
+            return {
+                ok: false,
+                code: "METHOD_NOT_ALLOWED",
+                message: `Method ${method} is not permitted`,
+                retriable: false,
+            };
+        }
+        const url = this.buildUrl(path, init.query);
+        if (!validateUrl(url)) {
+            return {
+                ok: false,
+                code: "INVALID_URL",
+                message: `URL rejected: ${url}`,
+                retriable: false,
+            };
+        }
+        let lastError = null;
+        for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
+            await this._throttle();
+            const readCtrl = new AbortController();
+            const readTimer = setTimeout(() => readCtrl.abort(), this._connectTimeoutMs + this._readTimeoutMs);
+            try {
+                const response = await this._fetch(url, {
+                    method,
+                    headers: {
+                        Authorization: this._authHeader,
+                        Accept: "application/json",
+                        ...(init.headers ?? {}),
+                    },
+                    signal: readCtrl.signal,
+                });
+                const status = response.status;
+                if (status === 429 || status >= 500) {
+                    const retryAfter = parseRetryAfter(response.headers.get("retry-after"));
+                    lastError = {
+                        ok: false,
+                        code: status === 429 ? "RATE_LIMITED" : "SERVER_ERROR",
+                        message: `Confluence returned HTTP ${status}`,
+                        retriable: true,
+                        status,
+                    };
+                    if (attempt < MAX_ATTEMPTS - 1) {
+                        await this._sleep(retryAfter ?? Math.min(30_000, 500 * 2 ** attempt));
+                        continue;
+                    }
+                    return lastError;
+                }
+                if (!response.ok) {
+                    let body = "";
+                    try {
+                        body = await response.text();
+                    }
+                    catch { /* ignore */ }
+                    return {
+                        ok: false,
+                        code: classifyHttpStatus(status),
+                        message: `Confluence HTTP ${status}: ${truncate(body, 200)}`,
+                        retriable: false,
+                        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 < MAX_ATTEMPTS - 1) {
+                    await this._sleep(Math.min(30_000, 500 * 2 ** attempt));
+                    continue;
+                }
+                return lastError;
+            }
+            finally {
+                clearTimeout(readTimer);
+            }
+        }
+        return (lastError ?? {
+            ok: false,
+            code: "UNKNOWN",
+            message: "Exhausted retries without a response",
+            retriable: true,
+        });
+    }
+    async searchCql(cql, limit, start = 0) {
+        return this.request("GET", "/wiki/rest/api/content/search", { query: { cql, limit, start, expand: "space,version" } });
+    }
+    async getContent(id, expand = ["body.storage", "space", "version"]) {
+        return this.request("GET", `/wiki/rest/api/content/${id}`, { query: { expand: expand.join(",") } });
+    }
+    async getSpace(spaceKey) {
+        return this.request("GET", `/wiki/rest/api/space/${spaceKey}`, { query: { expand: "description,homepage" } });
+    }
+    async listAttachments(pageId, limit = 25, start = 0) {
+        return this.request("GET", `/wiki/rest/api/content/${pageId}/child/attachment`, { query: { limit, start } });
+    }
+    async getComments(pageId, limit = 50) {
+        const raw = await this.request("GET", `/wiki/rest/api/content/${pageId}/child/comment`, { query: { expand: "body.view,history,version", limit } });
+        if (!raw.ok)
+            return raw;
+        const results = (raw.data.results ?? []).map((c) => ({
+            id: c.id,
+            author: c.history?.createdBy?.displayName ?? "",
+            created: c.history?.createdDate ?? "",
+            version: c.version?.number ?? 0,
+            body_plain: htmlToPlain(c.body?.view?.value ?? ""),
+        }));
+        return {
+            ok: true,
+            status: raw.status,
+            data: {
+                results,
+                ...(raw.data.size !== undefined ? { size: raw.data.size } : {}),
+                ...(raw.data.start !== undefined ? { start: raw.data.start } : {}),
+                ...(raw.data.limit !== undefined ? { limit: raw.data.limit } : {}),
+            },
+        };
+    }
+    async getAttachmentDownload(downloadPath) {
+        // Atlassian Cloud serves Confluence at `/wiki/...`; the `_links.download`
+        // value the API returns is relative to that mount, e.g.
+        // `/download/attachments/65859/file.txt?...`. Prepend `/wiki` if missing
+        // so we don't request the apex path (which 404s).
+        const normalized = downloadPath.startsWith("/")
+            ? downloadPath
+            : `/${downloadPath}`;
+        const withMount = normalized.startsWith("/wiki/")
+            ? normalized
+            : `/wiki${normalized}`;
+        const url = this.buildUrl(withMount);
+        if (!validateUrl(url)) {
+            return {
+                ok: false,
+                code: "INVALID_URL",
+                message: `URL rejected: ${url}`,
+                retriable: false,
+            };
+        }
+        await this._throttle();
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), this._connectTimeoutMs + this._readTimeoutMs);
+        try {
+            const response = await this._fetch(url, {
+                method: "GET",
+                headers: {
+                    Authorization: this._authHeader,
+                    Accept: "*/*",
+                },
+                signal: ctrl.signal,
+            });
+            const status = response.status;
+            if (!response.ok) {
+                return {
+                    ok: false,
+                    code: classifyHttpStatus(status),
+                    message: `Confluence HTTP ${status} while downloading ${downloadPath}`,
+                    retriable: status === 429 || status >= 500,
+                    status,
+                };
+            }
+            const buf = await response.arrayBuffer();
+            const bytes = new Uint8Array(buf);
+            const contentType = response.headers.get("content-type") ?? "application/octet-stream";
+            const filename = parseContentDispositionFilename(response.headers.get("content-disposition")) ?? filenameFromPath(downloadPath);
+            return { ok: true, data: { bytes, contentType, filename }, status };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const aborted = err instanceof DOMException || /abort/i.test(message);
+            return {
+                ok: false,
+                code: aborted ? "TIMEOUT" : "NETWORK_ERROR",
+                message: aborted ? "Request timed out" : message,
+                retriable: true,
+            };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    get siteUrl() {
+        return this._site;
+    }
+    get authHeader() {
+        return this._authHeader;
+    }
+}
+function parseRetryAfter(value) {
+    if (!value)
+        return null;
+    const seconds = Number(value);
+    if (Number.isFinite(seconds) && seconds >= 0)
+        return seconds * 1000;
+    return null;
+}
+function classifyHttpStatus(status) {
+    if (status === 401 || status === 403)
+        return "UNAUTHORIZED";
+    if (status === 404)
+        return "NOT_FOUND";
+    if (status === 400)
+        return "BAD_REQUEST";
+    return "HTTP_ERROR";
+}
+function truncate(s, n) {
+    return s.length > n ? s.slice(0, n) + "…" : s;
+}
+function parseContentDispositionFilename(header) {
+    if (!header)
+        return null;
+    const match = /filename\*?=(?:UTF-8'')?"?([^";]+)"?/i.exec(header);
+    return match && match[1] ? match[1].trim() : null;
+}
+function filenameFromPath(p) {
+    const tail = p.split("/").filter(Boolean).pop() ?? "attachment";
+    try {
+        return decodeURIComponent(tail);
+    }
+    catch {
+        return tail;
+    }
+}
+const BLOCK_TAGS_RE = /<\s*\/?(p|div|br|li|h[1-6]|blockquote|tr|pre)[^>]*>/gi;
+const TAG_RE = /<[^>]+>/g;
+const ENTITY_MAP = {
+    "&amp;": "&",
+    "&lt;": "<",
+    "&gt;": ">",
+    "&quot;": '"',
+    "&#39;": "'",
+    "&#x27;": "'",
+    "&nbsp;": " ",
+};
+function decodeEntities(s) {
+    return s
+        .replace(/&[a-zA-Z#0-9]+;/g, (m) => ENTITY_MAP[m] ?? m)
+        .replace(/&#(\d+);/g, (_, d) => String.fromCharCode(Number(d)));
+}
+export function htmlToPlain(html) {
+    if (!html)
+        return "";
+    const withBreaks = html.replace(BLOCK_TAGS_RE, "\n\n");
+    const stripped = withBreaks.replace(TAG_RE, "");
+    const decoded = decodeEntities(stripped);
+    return decoded.replace(/\n{3,}/g, "\n\n").replace(/[ \t]+\n/g, "\n").trim();
+}
+//# sourceMappingURL=confluence_client.js.map

package/dist/connectors/confluence/lib/confluence_client.js.map

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

package/dist/connectors/confluence/lib/confluence_error.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Error class bridging the ConfluenceClient's `{ok: false, code, ...}` result
+ * shape into the handler-throws-an-Error contract that `createConnector`
+ * expects. The factory's `mapError` hook unwraps these back into a proper
+ * error envelope with the canonical toolkit error codes.
+ */
+export declare class ConfluenceError extends Error {
+    readonly code: string;
+    readonly retriable: boolean;
+    readonly httpStatus: number | undefined;
+    constructor(code: string, message: string, retriable: boolean, httpStatus?: number);
+}
+//# sourceMappingURL=confluence_error.d.ts.map

package/dist/connectors/confluence/lib/confluence_error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confluence_error.d.ts","sourceRoot":"","sources":["../../../../src/connectors/confluence/lib/confluence_error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAGtC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,OAAO,EAClB,UAAU,CAAC,EAAE,MAAM;CAQtB"}

package/dist/connectors/confluence/lib/confluence_error.js

@@ -0,0 +1,19 @@
+/**
+ * Error class bridging the ConfluenceClient's `{ok: false, code, ...}` result
+ * shape into the handler-throws-an-Error contract that `createConnector`
+ * expects. The factory's `mapError` hook unwraps these back into a proper
+ * error envelope with the canonical toolkit error codes.
+ */
+export class ConfluenceError extends Error {
+    code;
+    retriable;
+    httpStatus;
+    constructor(code, message, retriable, httpStatus) {
+        super(message);
+        this.name = "ConfluenceError";
+        this.code = code;
+        this.retriable = retriable;
+        this.httpStatus = httpStatus;
+    }
+}
+//# sourceMappingURL=confluence_error.js.map

package/dist/connectors/confluence/lib/confluence_error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confluence_error.js","sourceRoot":"","sources":["../../../../src/connectors/confluence/lib/confluence_error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAS;IACb,SAAS,CAAU;IACnB,UAAU,CAAqB;IAExC,YACE,IAAY,EACZ,OAAe,EACf,SAAkB,EAClB,UAAmB;QAEnB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF"}

package/dist/connectors/db/cli.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+export declare const main: (argv: readonly string[]) => Promise<number>;
+export declare const fetch: (action: string, params: unknown) => Promise<import("../../toolkit/index.js").Envelope>;
+export declare const VALID_ACTIONS: ReadonlySet<string>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/connectors/db/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/connectors/db/cli.ts"],"names":[],"mappings":";AAeA,eAAO,MAAM,IAAI,8CAAiB,CAAC;AACnC,eAAO,MAAM,KAAK,yFAAkB,CAAC;AACrC,eAAO,MAAM,aAAa,qBAAyB,CAAC"}

package/dist/connectors/db/cli.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+/**
+ * db-agent-connector CLI bin entry.
+ *
+ * Framework-backed: main() + fetch() come from `buildDbConnector()` (see
+ * connector.ts). The internal dispatcher still handles all DB-specific
+ * work; this file is just the CLI harness.
+ *
+ * `main` is re-exported so existing tests can invoke it programmatically.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import connector from "./index.js";
+export const main = connector.main;
+export const fetch = connector.fetch;
+export const VALID_ACTIONS = connector.validActions;
+function isCliEntry() {
+    const argv1 = process.argv[1];
+    if (!argv1)
+        return false;
+    try {
+        const scriptPath = fs.realpathSync(path.resolve(argv1));
+        const modulePath = fs.realpathSync(fileURLToPath(import.meta.url));
+        return scriptPath === modulePath;
+    }
+    catch {
+        return false;
+    }
+}
+if (isCliEntry()) {
+    void main(process.argv.slice(2)).then((code) => process.exit(code));
+}
+//# sourceMappingURL=cli.js.map

package/dist/connectors/db/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/connectors/db/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,SAAS,MAAM,YAAY,CAAC;AAEnC,MAAM,CAAC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;AACnC,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC,YAAY,CAAC;AAEpD,SAAS,UAAU;IACjB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACnE,OAAO,UAAU,KAAK,UAAU,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,IAAI,UAAU,EAAE,EAAE,CAAC;IACjB,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/connectors/db/config.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/** A config dict. Kept loose on purpose to mirror the dynamic dict shape. */
+export type WikiConfig = Record<string, unknown>;
+/** Thrown when the config path does not exist. */
+export declare class ConfigFileNotFoundError extends Error {
+    constructor(message: string);
+}
+/**
+ * Parse and validate a YAML config file.
+ *
+ * @param configPath Path to the YAML config file.
+ * @returns Validated config dict.
+ * @throws {ConfigFileNotFoundError} If the config file does not exist.
+ * @throws {Error} If the YAML is malformed.
+ */
+export declare function parseConfig(configPath: string): WikiConfig;
+export declare function main(argv?: readonly string[]): number;
+//# sourceMappingURL=config.d.ts.map

package/dist/connectors/db/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/connectors/db/config.ts"],"names":[],"mappings":";AAkBA,6EAA6E;AAC7E,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,kDAAkD;AAClD,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAQD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAyB1D;AAyDD,wBAAgB,IAAI,CAAC,IAAI,GAAE,SAAS,MAAM,EAA0B,GAAG,MAAM,CA8B5E"}

package/dist/connectors/db/config.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+/**
+ * config.ts — Parse and validate a YAML config file, outputting as JSON.
+ *
+ * Standalone fork of doc-wiki's parse_config.ts with wiki-specific
+ * validation removed. Accepts any valid YAML mapping; the `wiki` section
+ * is optional. The `ecosystem.database` section is the primary consumer.
+ *
+ * Usage:
+ *     node config.js --config <path-to-config.yaml>
+ *
+ * Exits 0 on success (JSON to stdout), 1 on validation failure (error to stderr).
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import * as yaml from "js-yaml";
+/** Thrown when the config path does not exist. */
+export class ConfigFileNotFoundError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ConfigFileNotFoundError";
+    }
+}
+function isPlainObject(v) {
+    return (typeof v === "object" && v !== null && !Array.isArray(v) && v.constructor === Object);
+}
+/**
+ * Parse and validate a YAML config file.
+ *
+ * @param configPath Path to the YAML config file.
+ * @returns Validated config dict.
+ * @throws {ConfigFileNotFoundError} If the config file does not exist.
+ * @throws {Error} If the YAML is malformed.
+ */
+export function parseConfig(configPath) {
+    if (!fs.existsSync(configPath)) {
+        throw new ConfigFileNotFoundError(`Config file not found: ${configPath}`);
+    }
+    const raw = fs.readFileSync(configPath, { encoding: "utf-8" });
+    let config;
+    try {
+        config = yaml.load(raw);
+    }
+    catch (exc) {
+        const msg = exc instanceof Error ? exc.message : String(exc);
+        throw new Error(`Failed to parse YAML: ${msg}`);
+    }
+    if (!isPlainObject(config)) {
+        const typeName = config === null
+            ? "NoneType"
+            : Array.isArray(config)
+                ? "list"
+                : typeof config;
+        throw new Error(`Config must be a YAML mapping, got: ${typeName}`);
+    }
+    return config;
+}
+function parseArgs(argv) {
+    const out = {};
+    let i = 0;
+    while (i < argv.length) {
+        const a = argv[i];
+        if (a === undefined) {
+            i++;
+            continue;
+        }
+        if (a === "-h" || a === "--help") {
+            out.help = true;
+            i++;
+            continue;
+        }
+        let name;
+        let value;
+        if (a.startsWith("--")) {
+            const eq = a.indexOf("=");
+            if (eq >= 0) {
+                name = a.slice(2, eq);
+                value = a.slice(eq + 1);
+                i++;
+            }
+            else {
+                name = a.slice(2);
+                value = argv[i + 1];
+                i += 2;
+            }
+        }
+        else {
+            throw new Error(`unrecognized argument: ${a}`);
+        }
+        switch (name) {
+            case "config":
+                out.config = value ?? "";
+                break;
+            default:
+                throw new Error(`unrecognized argument: --${name}`);
+        }
+    }
+    return out;
+}
+const HELP_TEXT = `usage: config.js [-h] --config CONFIG
+
+Parse a YAML config file
+
+options:
+  -h, --help       show this help message and exit
+  --config CONFIG  Path to config YAML file
+`;
+export function main(argv = process.argv.slice(2)) {
+    let args;
+    try {
+        args = parseArgs(argv);
+    }
+    catch (e) {
+        process.stderr.write(`${e.message}\n`);
+        return 2;
+    }
+    if (args.help) {
+        process.stdout.write(HELP_TEXT);
+        return 0;
+    }
+    if (!args.config) {
+        process.stderr.write("the following arguments are required: --config\n");
+        return 2;
+    }
+    try {
+        const config = parseConfig(args.config);
+        process.stdout.write(JSON.stringify(config, null, 2) + "\n");
+        return 0;
+    }
+    catch (exc) {
+        const msg = exc instanceof Error ? exc.message : String(exc);
+        process.stderr.write(JSON.stringify({ error: msg }) + "\n");
+        return 1;
+    }
+}
+// CLI entry point: run main() when this file is executed directly.
+const thisFile = fileURLToPath(import.meta.url);
+if (process.argv[1] && path.resolve(process.argv[1]) === thisFile) {
+    process.exit(main());
+}
+//# sourceMappingURL=config.js.map

package/dist/connectors/db/config.js.map

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

package/dist/connectors/db/connector.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Framework wrapper for `db-agent-connector`.
+ *
+ * Wraps the internal `fetch(action, params)` dispatcher (see `dispatcher.ts`)
+ * in a `@narai/connector-toolkit` `createConnector` shell. The toolkit
+ * provides the CLI harness, `--curate` slash-command entry, hardship logging,
+ * and SessionStart reminder helper; the internal dispatcher still owns all
+ * DB-specific work (SQL classification, policy gate, per-server config
+ * merging, driver lazy-loading, audit JSONL, approval grants).
+ *
+ * Envelope translation at the boundary: the internal dispatcher emits
+ * `{status: "ok"|"denied"|"escalate"|"present_only"|"error", ...}`; the
+ * framework's canonical envelope uses `success` in place of `ok`. The
+ * handler unwraps `ok` into the success envelope's `data` and uses the
+ * toolkit's `EnvelopeOverride` escape hatch to emit `denied` / `escalate`
+ * / `present_only` envelopes verbatim (with their rich shape intact).
+ *
+ * The toolkit's own policy gate runs over `{kind: "read"}` for every call
+ * — a pass-through — because the real, SQL-aware policy logic lives in the
+ * dispatcher. The YAML config shape (V2.0: under `connectors.db.*` with
+ * `servers` + `policy` + `unbounded_select` etc.) is owned by the
+ * dispatcher's call into `@narai/connector-config`.
+ */
+import { type Connector } from "narai-primitives/toolkit";
+import { fetch as dispatcherFetch } from "./dispatcher.js";
+export interface BuildOptions {
+    /** Test hook — override the dispatcher used by handlers. */
+    dispatch?: typeof dispatcherFetch;
+}
+export declare function buildDbConnector(overrides?: BuildOptions): Connector;
+//# sourceMappingURL=connector.d.ts.map

package/dist/connectors/db/connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/connectors/db/connector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAqC,KAAK,SAAS,EAAyB,MAAM,0BAA0B,CAAC;AAEpH,OAAO,EAAE,KAAK,IAAI,eAAe,EAAoB,MAAM,iBAAiB,CAAC;AA4F7E,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,eAAe,CAAC;CACnC;AAED,wBAAgB,gBAAgB,CAAC,SAAS,GAAE,YAAiB,GAAG,SAAS,CA+CxE"}