narai-primitives 2.0.0-rc.1

package/dist/connectors/notion/lib/notion_client.js

@@ -0,0 +1,377 @@
+/**
+ * notion_client.ts — read-only Notion Public API client.
+ *
+ * Notion's API uses POST for `/v1/search` and `/v1/databases/{id}/query`
+ * (body-bound filters) even though they are logically read-only; the
+ * method whitelist therefore permits these two named endpoints via a
+ * `POST_READ_ONLY` pseudo-method in addition to the standard GETs.
+ */
+import { validateUrl } from "narai-primitives/toolkit";
+import { resolveSecret } from "@narai/credential-providers";
+const ALLOWED_METHODS = new Set([
+    "GET",
+    "POST_READ_ONLY",
+]);
+const ALLOWED_POST_PATHS = new Set([
+    "/v1/search",
+    // Database query paths match `/v1/databases/{id}/query` — checked via prefix/suffix.
+]);
+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;
+const NOTION_API_BASE = "https://api.notion.com";
+const NOTION_VERSION = "2022-06-28";
+export async function loadNotionCredentials() {
+    const token = (await resolveSecret("NOTION_TOKEN")) ??
+        process.env["NOTION_TOKEN"] ??
+        null;
+    if (!token)
+        return null;
+    return { token };
+}
+function isAllowedPostPath(path) {
+    if (ALLOWED_POST_PATHS.has(path))
+        return true;
+    // Database query: /v1/databases/{id}/query
+    return /^\/v1\/databases\/[0-9a-fA-F-]{32,}\/query$/.test(path);
+}
+export class NotionClient {
+    _apiBase;
+    _token;
+    _rateLimitPerMin;
+    _connectTimeoutMs;
+    _readTimeoutMs;
+    _fetch;
+    _sleep;
+    _requestTimestamps = [];
+    _workspaceId = null;
+    get workspaceId() {
+        return this._workspaceId;
+    }
+    /**
+     * Best-effort lookup of the workspace id via `GET /v1/users/me`. Never
+     * throws: on any failure `workspaceId` remains `null` and the scope
+     * callback demotes to the global tier.
+     */
+    async init() {
+        try {
+            const result = await this.request("GET", "/v1/users/me");
+            if (result.ok) {
+                this._workspaceId = result.data.bot?.workspace_id ?? null;
+            }
+            else {
+                process.stderr.write(`[notion] init: workspaceId lookup failed (${result.code})\n`);
+                this._workspaceId = null;
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`[notion] init: workspaceId lookup threw (${msg})\n`);
+            this._workspaceId = null;
+        }
+    }
+    constructor(opts) {
+        const base = opts.apiBase ?? NOTION_API_BASE;
+        if (!validateUrl(base)) {
+            throw new Error(`Invalid Notion API base: ${base}`);
+        }
+        this._apiBase = base.replace(/\/+$/, "");
+        this._token = opts.token;
+        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());
+    }
+    async request(method, relPath, body = null) {
+        if (!ALLOWED_METHODS.has(method)) {
+            return {
+                ok: false,
+                code: "METHOD_NOT_ALLOWED",
+                message: `Method ${method} not allowed`,
+                retriable: false,
+            };
+        }
+        if (method === "POST_READ_ONLY" && !isAllowedPostPath(relPath)) {
+            return {
+                ok: false,
+                code: "METHOD_NOT_ALLOWED",
+                message: `POST is only permitted on read-only endpoints; got ${relPath}`,
+                retriable: false,
+            };
+        }
+        const url = `${this._apiBase}${relPath}`;
+        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 init = {
+                    method: method === "POST_READ_ONLY" ? "POST" : "GET",
+                    headers: {
+                        Authorization: `Bearer ${this._token}`,
+                        "Notion-Version": NOTION_VERSION,
+                        Accept: "application/json",
+                        ...(body ? { "Content-Type": "application/json" } : {}),
+                    },
+                    signal: readCtrl.signal,
+                };
+                if (body)
+                    init.body = JSON.stringify(body);
+                const response = await this._fetch(url, init);
+                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: `Notion 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 bodyText = "";
+                    try {
+                        bodyText = await response.text();
+                    }
+                    catch { /* ignore */ }
+                    return {
+                        ok: false,
+                        code: classifyHttpStatus(status),
+                        message: `Notion HTTP ${status}: ${truncate(bodyText, 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 search(query, filterType, pageSize) {
+        const body = { query, page_size: pageSize };
+        if (filterType)
+            body["filter"] = { property: "object", value: filterType };
+        return this.request("POST_READ_ONLY", "/v1/search", body);
+    }
+    async getPage(pageId) {
+        return this.request("GET", `/v1/pages/${pageId}`);
+    }
+    async getDatabase(databaseId) {
+        return this.request("GET", `/v1/databases/${databaseId}`);
+    }
+    async queryDatabase(databaseId, filter, pageSize) {
+        const body = { page_size: pageSize };
+        if (filter)
+            body["filter"] = filter;
+        return this.request("POST_READ_ONLY", `/v1/databases/${databaseId}/query`, body);
+    }
+    async listPageFileBlocks(pageId, pageSize = 100) {
+        const raw = await this.request("GET", `/v1/blocks/${pageId}/children?page_size=${pageSize}`);
+        if (!raw.ok)
+            return raw;
+        const blocks = raw.data.results ?? [];
+        const results = [];
+        for (const b of blocks) {
+            const fb = normalizeFileBlock(b);
+            if (fb)
+                results.push(fb);
+        }
+        return {
+            ok: true,
+            status: raw.status,
+            data: {
+                results,
+                has_more: raw.data.has_more ?? false,
+            },
+        };
+    }
+    async getBlock(blockId) {
+        return this.request("GET", `/v1/blocks/${blockId}`);
+    }
+    async getComments(blockId, pageSize = 100) {
+        const raw = await this.request("GET", `/v1/comments?block_id=${blockId}&page_size=${pageSize}`);
+        if (!raw.ok)
+            return raw;
+        const results = (raw.data.results ?? []).map((c) => ({
+            id: c.id,
+            author_id: c.created_by?.id ?? "",
+            created: c.created_time ?? "",
+            body_plain: (c.rich_text ?? [])
+                .map((rt) => rt.plain_text ?? "")
+                .join(""),
+            parent_page_id: c.parent?.page_id ?? null,
+        }));
+        return {
+            ok: true,
+            status: raw.status,
+            data: { results, has_more: raw.data.has_more ?? false },
+        };
+    }
+}
+const FILE_BLOCK_TYPES = new Set([
+    "file",
+    "image",
+    "pdf",
+    "audio",
+    "video",
+]);
+function normalizeFileBlock(block) {
+    if (typeof block.type !== "string" || !FILE_BLOCK_TYPES.has(block.type)) {
+        return null;
+    }
+    const type = block.type;
+    const payload = block[type];
+    if (!payload || typeof payload !== "object")
+        return null;
+    const p = payload;
+    const urlType = p["type"];
+    if (urlType !== "file" && urlType !== "external")
+        return null;
+    let url = "";
+    let expiry = null;
+    if (urlType === "file") {
+        const f = p["file"];
+        if (f && typeof f === "object") {
+            const obj = f;
+            if (typeof obj["url"] === "string")
+                url = obj["url"];
+            if (typeof obj["expiry_time"] === "string")
+                expiry = obj["expiry_time"];
+        }
+    }
+    else {
+        const e = p["external"];
+        if (e && typeof e === "object") {
+            const obj = e;
+            if (typeof obj["url"] === "string")
+                url = obj["url"];
+        }
+    }
+    if (!url)
+        return null;
+    const captionArr = Array.isArray(p["caption"]) ? p["caption"] : [];
+    const caption = captionArr
+        .map((rt) => {
+        if (rt && typeof rt === "object") {
+            const t = rt["plain_text"];
+            return typeof t === "string" ? t : "";
+        }
+        return "";
+    })
+        .join("");
+    const filename = typeof p["name"] === "string" ? p["name"] : null;
+    return {
+        id: block.id,
+        type,
+        url_type: urlType,
+        url,
+        expiry_time: expiry,
+        caption,
+        filename,
+    };
+}
+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)
+        return "UNAUTHORIZED";
+    if (status === 403)
+        return "FORBIDDEN";
+    if (status === 404)
+        return "NOT_FOUND";
+    if (status === 400)
+        return "BAD_REQUEST";
+    if (status === 422)
+        return "UNPROCESSABLE";
+    return "HTTP_ERROR";
+}
+function truncate(s, n) {
+    return s.length > n ? s.slice(0, n) + "…" : s;
+}
+export function extractTitleFromPage(page) {
+    const props = page.properties ?? {};
+    for (const value of Object.values(props)) {
+        if (value &&
+            typeof value === "object" &&
+            !Array.isArray(value) &&
+            value["type"] === "title") {
+            const titleProp = value;
+            const title = titleProp["title"];
+            if (Array.isArray(title)) {
+                return title
+                    .map((t) => {
+                    if (t && typeof t === "object") {
+                        const pt = t["plain_text"];
+                        return typeof pt === "string" ? pt : "";
+                    }
+                    return "";
+                })
+                    .join("");
+            }
+        }
+    }
+    return "";
+}
+//# sourceMappingURL=notion_client.js.map

package/dist/connectors/notion/lib/notion_client.js.map

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

package/dist/connectors/notion/lib/notion_error.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Bridges NotionClient's `{ok: false, code, ...}` result shape to the
+ * handler-throws-an-Error contract the factory expects. `mapError` unwraps
+ * these back into canonical error envelopes.
+ */
+export declare class NotionError extends Error {
+    readonly code: string;
+    readonly retriable: boolean;
+    readonly httpStatus: number | undefined;
+    constructor(code: string, message: string, retriable: boolean, httpStatus?: number);
+}
+//# sourceMappingURL=notion_error.d.ts.map

package/dist/connectors/notion/lib/notion_error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notion_error.d.ts","sourceRoot":"","sources":["../../../../src/connectors/notion/lib/notion_error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,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/notion/lib/notion_error.js

@@ -0,0 +1,18 @@
+/**
+ * Bridges NotionClient's `{ok: false, code, ...}` result shape to the
+ * handler-throws-an-Error contract the factory expects. `mapError` unwraps
+ * these back into canonical error envelopes.
+ */
+export class NotionError extends Error {
+    code;
+    retriable;
+    httpStatus;
+    constructor(code, message, retriable, httpStatus) {
+        super(message);
+        this.name = "NotionError";
+        this.code = code;
+        this.retriable = retriable;
+        this.httpStatus = httpStatus;
+    }
+}
+//# sourceMappingURL=notion_error.js.map

package/dist/connectors/notion/lib/notion_error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notion_error.js","sourceRoot":"","sources":["../../../../src/connectors/notion/lib/notion_error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,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,aAAa,CAAC;QAC1B,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/hub/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+/** CLI entrypoint: parses argv, calls `gather`, prints the JSON output. */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/hub/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/hub/cli.ts"],"names":[],"mappings":";AACA,2EAA2E"}

package/dist/hub/cli.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+/** CLI entrypoint: parses argv, calls `gather`, prints the JSON output. */
+import { gather } from "./index.js";
+const HELP = `Usage: connector-hub --prompt <text> [--consumer <name>] [--environment <name>] [--extra-context <text>]
+
+Options:
+  --prompt <text>           Natural-language prompt (required).
+  --consumer <name>         Apply consumers.<name> overrides from config.yaml.
+  --environment <name>      Apply environments.<name> overrides from config.yaml.
+  --extra-context <text>    Extra context appended after the prompt.
+  -h, --help                Show this help.
+`;
+// TODO: fold this back into parseAgentArgs once the toolkit supports arbitrary string flags.
+/** Tiny extension of `parseAgentArgs` that accepts arbitrary string flags. */
+function parseHubArgs(argv) {
+    // We cannot reuse `parseAgentArgs` directly because it only surfaces
+    // `action` / `params` / `help`. Reimplement the same shape with the hub's
+    // flags. (Same throw-on-unknown semantics.)
+    const valid = new Set(["prompt", "consumer", "environment", "extra-context"]);
+    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;
+        }
+        if (!a.startsWith("--")) {
+            throw new Error(`unrecognized argument: ${a}`);
+        }
+        const eq = a.indexOf("=");
+        let name;
+        let value;
+        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;
+        }
+        if (!valid.has(name)) {
+            throw new Error(`unrecognized argument: --${name}`);
+        }
+        out[name] = value ?? "";
+    }
+    return out;
+}
+async function main() {
+    let args;
+    try {
+        args = parseHubArgs(process.argv.slice(2));
+    }
+    catch (err) {
+        process.stderr.write(`${err.message}\n${HELP}`);
+        process.exit(1);
+    }
+    if (args.help === true) {
+        process.stdout.write(HELP);
+        return;
+    }
+    if (args.prompt === undefined || args.prompt === "") {
+        process.stderr.write(`missing required --prompt\n${HELP}`);
+        process.exit(1);
+    }
+    const input = { prompt: args.prompt };
+    if (args.consumer !== undefined)
+        input.consumer = args.consumer;
+    if (args.environment !== undefined)
+        input.environment = args.environment;
+    if (args["extra-context"] !== undefined)
+        input.extraContext = args["extra-context"];
+    try {
+        const out = await gather(input);
+        process.stdout.write(`${JSON.stringify(out, null, 2)}\n`);
+    }
+    catch (err) {
+        process.stderr.write(`hub failed: ${err.message}\n`);
+        process.exit(1);
+    }
+}
+main().catch((err) => {
+    process.stderr.write(`hub crashed: ${String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/hub/cli.js.map

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

package/dist/hub/dispatch.d.ts

@@ -0,0 +1,33 @@
+/** Subprocess fan-out — run plan steps in parallel, returning per-step
+ *  envelopes or structured errors.
+ *
+ *  Memory & cancellation safeguards (added during the narai-primitives
+ *  consolidation):
+ *    - per-spawn timeout (default 60s; SIGTERM then SIGKILL after grace)
+ *    - stdout buffer cap (default 50 MB; runaway connectors can't OOM the parent)
+ *    - concurrency limit on plan dispatch (default 8; widely-fanned plans
+ *      don't spawn 50+ children at once)
+ *    - AbortSignal propagation: caller can cancel mid-`gather()`
+ *    - parent-exit child cleanup: SIGTERM all in-flight children when the
+ *      parent receives SIGINT/SIGTERM/exit
+ *
+ *  Every safeguard surfaces a structured error envelope on the affected step
+ *  rather than throwing, matching the `DispatchResult.error` contract that
+ *  callers like doc-wiki's `applyMermaid` already handle. */
+import type { DispatchResult, PlanStep, PreparedConnector, SpawnFn } from "./types.js";
+export interface DispatchOptions {
+    spawnProcess?: SpawnFn;
+    /** Hard timeout per spawned connector (ms). Default 60_000. */
+    timeoutMs?: number;
+    /** Max stdout bytes the parent will accumulate per connector. Default 50 MB. */
+    maxStdoutBytes?: number;
+    /** Maximum number of concurrent connector subprocesses. Default 8. */
+    concurrency?: number;
+    /** AbortSignal that cancels in-flight spawns and skips remaining steps. */
+    signal?: AbortSignal;
+}
+/** Dispatch a validated plan in parallel (bounded by `concurrency`). Each step
+ *  gets its own DispatchResult. `runStep` never rejects — every error path
+ *  resolves to a structured result. */
+export declare function dispatchPlan(plan: readonly PlanStep[], preparedByName: ReadonlyMap<string, PreparedConnector>, opts?: DispatchOptions): Promise<DispatchResult[]>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/hub/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/hub/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;6DAe6D;AAI7D,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACR,iBAAiB,EACjB,OAAO,EACR,MAAM,YAAY,CAAC;AAkBpB,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAyCD;;uCAEuC;AACvC,wBAAsB,YAAY,CAChC,IAAI,EAAE,SAAS,QAAQ,EAAE,EACzB,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACtD,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,cAAc,EAAE,CAAC,CA0C3B"}