narai-primitives 2.0.0-rc.1

package/dist/connectors/confluence/index.js

@@ -0,0 +1,295 @@
+/**
+ * @narai/confluence-agent-connector — read-only Confluence connector.
+ *
+ * Built on @narai/connector-toolkit. The default export is a ready-to-use
+ * `Connector` instance; `buildConfluenceConnector(overrides?)` is exposed
+ * for tests that want to inject a fake Confluence client.
+ */
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { createHash, randomUUID } from "node:crypto";
+import { createConnector, extractBinary, FORMAT_MAP, sanitizeLabel, } from "narai-primitives/toolkit";
+import { z } from "zod";
+import { ConfluenceClient, loadConfluenceCredentials, } from "./lib/confluence_client.js";
+import { ConfluenceError } from "./lib/confluence_error.js";
+// ───────────────────────────────────────────────────────────────────────────
+// Param schemas
+// ───────────────────────────────────────────────────────────────────────────
+const MAX_RESULTS_DEFAULT = 25;
+const MAX_RESULTS_CAP = 500;
+const cqlSearchParams = z.object({
+    cql: z.string().min(1, "cql_search requires a non-empty 'cql' string"),
+    max_results: z.coerce
+        .number()
+        .int()
+        .positive()
+        .default(MAX_RESULTS_DEFAULT),
+});
+const getPageParams = z.object({
+    page_id: z
+        .union([z.string(), z.number()])
+        .transform((v) => String(v))
+        .pipe(z.string().regex(/^\d+$/, "Invalid page_id — expected numeric ID")),
+    expand: z.array(z.string()).default([]),
+});
+const getSpaceParams = z.object({
+    space_key: z
+        .string()
+        .regex(/^[A-Z][A-Z0-9]{1,19}$/, "Invalid space_key — expected uppercase key like DEV"),
+});
+const pageIdOnly = z.object({
+    page_id: z
+        .union([z.string(), z.number()])
+        .transform((v) => String(v))
+        .pipe(z.string().regex(/^\d+$/, "Invalid page_id — expected numeric ID")),
+});
+const listAttachmentsParams = pageIdOnly.extend({
+    limit: z.coerce.number().int().positive().default(25),
+});
+const getAttachmentParams = pageIdOnly.extend({
+    attachment_id: z.string().min(1, "attachment_id is required"),
+});
+const getCommentsParams = pageIdOnly.extend({
+    limit: z.coerce.number().int().positive().default(50),
+});
+// ───────────────────────────────────────────────────────────────────────────
+// Error-code translation: Confluence client codes → toolkit canonical codes
+// ───────────────────────────────────────────────────────────────────────────
+const CODE_MAP = {
+    UNAUTHORIZED: "AUTH_ERROR",
+    NOT_FOUND: "NOT_FOUND",
+    RATE_LIMITED: "RATE_LIMITED",
+    TIMEOUT: "TIMEOUT",
+    NETWORK_ERROR: "CONNECTION_ERROR",
+    SERVER_ERROR: "CONNECTION_ERROR",
+    BAD_REQUEST: "VALIDATION_ERROR",
+    INVALID_URL: "VALIDATION_ERROR",
+    METHOD_NOT_ALLOWED: "VALIDATION_ERROR",
+    HTTP_ERROR: "CONNECTION_ERROR",
+    CONFIG_ERROR: "CONFIG_ERROR",
+};
+/** Throw a ConfluenceError for a failed client result; type-narrows to the ok branch. */
+function throwIfError(result) {
+    if (!result.ok) {
+        throw new ConfluenceError(result.code, result.message, result.retriable, result.status);
+    }
+}
+export function buildConfluenceConnector(overrides = {}) {
+    const defaultCredentials = async () => {
+        const creds = await loadConfluenceCredentials();
+        return creds ?? {};
+    };
+    const defaultSdk = async () => {
+        const creds = await loadConfluenceCredentials();
+        if (!creds) {
+            throw new ConfluenceError("CONFIG_ERROR", "Confluence credentials not configured. Set CONFLUENCE_SITE_URL, " +
+                "CONFLUENCE_EMAIL, and CONFLUENCE_API_TOKEN (or register a credential " +
+                "provider via @narai/credential-providers).", false);
+        }
+        return new ConfluenceClient(creds);
+    };
+    return createConnector({
+        name: "confluence",
+        version: "3.0.0",
+        scope: (ctx) => ctx.sdk.siteUrl,
+        credentials: overrides.credentials ?? defaultCredentials,
+        sdk: overrides.sdk ?? defaultSdk,
+        actions: {
+            cql_search: {
+                description: "Search Confluence pages with a CQL query",
+                params: cqlSearchParams,
+                classify: { kind: "read" },
+                handler: async (p, ctx) => {
+                    const limit = Math.min(p.max_results, MAX_RESULTS_CAP);
+                    const result = await ctx.sdk.searchCql(p.cql, limit);
+                    throwIfError(result);
+                    const results = Array.isArray(result.data.results)
+                        ? result.data.results
+                        : [];
+                    const total = result.data.totalSize ?? results.length;
+                    return {
+                        total,
+                        pages: results.map((page) => ({
+                            id: page.id,
+                            title: page.title ?? "",
+                            space_key: page.space?.key ?? "",
+                            version: page.version?.number ?? 0,
+                            last_modified: page.version?.when ?? null,
+                        })),
+                        truncated: results.length >= limit && total > results.length,
+                    };
+                },
+            },
+            get_page: {
+                description: "Fetch a single page by numeric id",
+                params: getPageParams,
+                classify: { kind: "read" },
+                handler: async (p, ctx) => {
+                    const expand = p.expand.length > 0
+                        ? p.expand
+                        : ["body.storage", "space", "version"];
+                    const result = await ctx.sdk.getContent(p.page_id, expand);
+                    throwIfError(result);
+                    const data = result.data;
+                    return {
+                        id: data.id,
+                        title: data.title ?? "",
+                        space_key: data.space?.key ?? "",
+                        version: data.version?.number ?? 0,
+                        body_markdown: data.body?.storage?.value ?? "",
+                        last_modified: data.version?.when ?? null,
+                    };
+                },
+            },
+            get_space: {
+                description: "Fetch space metadata by uppercase space_key",
+                params: getSpaceParams,
+                classify: { kind: "read" },
+                handler: async (p, ctx) => {
+                    const result = await ctx.sdk.getSpace(p.space_key);
+                    throwIfError(result);
+                    const data = result.data;
+                    return {
+                        key: data.key,
+                        name: data.name ?? "",
+                        description: data.description?.plain?.value ?? "",
+                        type: data.type ?? "global",
+                        homepage_id: data.homepage?.id ?? null,
+                    };
+                },
+            },
+            list_attachments: {
+                description: "List attachments on a Confluence page",
+                params: listAttachmentsParams,
+                classify: { kind: "read" },
+                handler: async (p, ctx) => {
+                    const result = await ctx.sdk.listAttachments(p.page_id, p.limit);
+                    throwIfError(result);
+                    const results = result.data.results ?? [];
+                    return {
+                        page_id: p.page_id,
+                        total: result.data.size ?? results.length,
+                        attachments: results.map((a) => ({
+                            attachment_id: a.id,
+                            filename: a.title ?? "",
+                            media_type: a.metadata?.mediaType ?? "application/octet-stream",
+                            size_bytes: a.extensions?.fileSize ?? 0,
+                            version: a.version?.number ?? 0,
+                            last_modified: a.version?.when ?? null,
+                            download_path: a._links?.download ?? null,
+                        })),
+                    };
+                },
+            },
+            get_attachment: {
+                description: "Download and extract a Confluence attachment to text",
+                params: getAttachmentParams,
+                classify: { kind: "read" },
+                handler: async (p, ctx) => {
+                    const list = await ctx.sdk.listAttachments(p.page_id, 500);
+                    throwIfError(list);
+                    const match = (list.data.results ?? []).find((a) => a.id === p.attachment_id);
+                    if (!match) {
+                        throw new ConfluenceError("NOT_FOUND", `Attachment ${p.attachment_id} not found on page ${p.page_id}`, false, 404);
+                    }
+                    const downloadPath = match._links?.download;
+                    if (!downloadPath) {
+                        throw new ConfluenceError("BAD_REQUEST", `Attachment ${p.attachment_id} has no download link`, false);
+                    }
+                    const dl = await ctx.sdk.getAttachmentDownload(downloadPath);
+                    throwIfError(dl);
+                    const { bytes, contentType, filename } = dl.data;
+                    const ext = path.extname(filename).toLowerCase();
+                    const fmt = FORMAT_MAP[ext];
+                    let extracted;
+                    if (contentType.startsWith("text/")) {
+                        extracted = {
+                            format: "text",
+                            text: new TextDecoder("utf-8").decode(bytes),
+                        };
+                    }
+                    else if (fmt) {
+                        const tmp = path.join(os.tmpdir(), `conf-attach-${randomUUID()}${ext}`);
+                        try {
+                            fs.writeFileSync(tmp, bytes);
+                            const r = await extractBinary(tmp, fmt);
+                            extracted = { format: r.format, text: r.text };
+                        }
+                        catch (e) {
+                            extracted = {
+                                format: "skipped",
+                                text: null,
+                                warning: e instanceof Error ? e.message : String(e),
+                            };
+                        }
+                        finally {
+                            try {
+                                fs.unlinkSync(tmp);
+                            }
+                            catch {
+                                /* best-effort */
+                            }
+                        }
+                    }
+                    else {
+                        extracted = {
+                            format: "skipped",
+                            text: null,
+                            warning: `Unsupported media type '${contentType}'`,
+                        };
+                    }
+                    const checksum = createHash("sha256").update(bytes).digest("hex");
+                    return {
+                        attachment_id: match.id,
+                        filename: sanitizeLabel(filename, 255),
+                        media_type: contentType,
+                        size_bytes: bytes.byteLength,
+                        checksum,
+                        extracted,
+                        source_url: `${ctx.sdk.siteUrl}${downloadPath}`,
+                    };
+                },
+            },
+            get_comments: {
+                description: "List comments on a Confluence page (plain-text body)",
+                params: getCommentsParams,
+                classify: { kind: "read" },
+                handler: async (p, ctx) => {
+                    const result = await ctx.sdk.getComments(p.page_id, p.limit);
+                    throwIfError(result);
+                    const results = result.data.results ?? [];
+                    return {
+                        page_id: p.page_id,
+                        total: result.data.size ?? results.length,
+                        comments: results.map((c) => ({
+                            comment_id: c.id,
+                            author: c.author,
+                            created: c.created,
+                            version: c.version,
+                            body_plain: c.body_plain,
+                        })),
+                    };
+                },
+            },
+        },
+        mapError: (err) => {
+            if (err instanceof ConfluenceError) {
+                return {
+                    error_code: CODE_MAP[err.code] ?? "CONNECTION_ERROR",
+                    message: err.message,
+                    retriable: err.retriable,
+                };
+            }
+            return undefined;
+        },
+    });
+}
+// Default production connector — most consumers import from here.
+const connector = buildConfluenceConnector();
+export default connector;
+export const { main, fetch, validActions } = connector;
+// Re-exports for advanced consumers.
+export { ConfluenceClient, loadConfluenceCredentials, } from "./lib/confluence_client.js";
+export { ConfluenceError } from "./lib/confluence_error.js";
+//# sourceMappingURL=index.js.map

package/dist/connectors/confluence/index.js.map

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

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

@@ -0,0 +1,135 @@
+type HttpMethod = "GET";
+export interface ConfluenceClientOptions {
+    siteUrl: string;
+    email: string;
+    apiToken: string;
+    rateLimitPerMin?: number;
+    connectTimeoutMs?: number;
+    readTimeoutMs?: number;
+    fetchImpl?: typeof globalThis.fetch;
+    sleepImpl?: (ms: number) => Promise<void>;
+}
+export interface ConfluenceErrorPayload {
+    ok: false;
+    code: string;
+    message: string;
+    retriable: boolean;
+    status?: number;
+}
+export interface ConfluenceSuccessPayload<T> {
+    ok: true;
+    data: T;
+    status: number;
+}
+export type ConfluenceResult<T> = ConfluenceSuccessPayload<T> | ConfluenceErrorPayload;
+export declare function loadConfluenceCredentials(): Promise<{
+    siteUrl: string;
+    email: string;
+    apiToken: string;
+} | null>;
+export declare class ConfluenceClient {
+    private readonly _site;
+    private readonly _authHeader;
+    private readonly _rateLimitPerMin;
+    private readonly _connectTimeoutMs;
+    private readonly _readTimeoutMs;
+    private readonly _fetch;
+    private readonly _sleep;
+    private _requestTimestamps;
+    constructor(opts: ConfluenceClientOptions);
+    private _throttle;
+    buildUrl(path: string, query?: Record<string, unknown>): string;
+    request<T = unknown>(method: HttpMethod, path: string, init?: {
+        query?: Record<string, unknown>;
+        headers?: Record<string, string>;
+    }): Promise<ConfluenceResult<T>>;
+    searchCql(cql: string, limit: number, start?: number): Promise<ConfluenceResult<ConfluenceSearchResponse>>;
+    getContent(id: string, expand?: string[]): Promise<ConfluenceResult<ConfluenceContent>>;
+    getSpace(spaceKey: string): Promise<ConfluenceResult<ConfluenceSpace>>;
+    listAttachments(pageId: string, limit?: number, start?: number): Promise<ConfluenceResult<ConfluenceAttachmentList>>;
+    getComments(pageId: string, limit?: number): Promise<ConfluenceResult<ConfluenceCommentList>>;
+    getAttachmentDownload(downloadPath: string): Promise<ConfluenceResult<{
+        bytes: Uint8Array;
+        contentType: string;
+        filename: string;
+    }>>;
+    get siteUrl(): string;
+    get authHeader(): string;
+}
+export interface ConfluenceContent {
+    id: string;
+    title?: string;
+    version?: {
+        number?: number;
+        when?: string;
+    };
+    space?: {
+        key?: string;
+    };
+    body?: {
+        storage?: {
+            value?: string;
+        };
+    };
+}
+export interface ConfluenceSearchResponse {
+    size?: number;
+    totalSize?: number;
+    results: ConfluenceContent[];
+    limit?: number;
+    start?: number;
+}
+export interface ConfluenceSpace {
+    key: string;
+    name?: string;
+    type?: string;
+    description?: {
+        plain?: {
+            value?: string;
+        };
+    };
+    homepage?: {
+        id?: string;
+    };
+}
+export interface ConfluenceAttachment {
+    id: string;
+    title?: string;
+    metadata?: {
+        mediaType?: string;
+    };
+    extensions?: {
+        fileSize?: number;
+        comment?: string;
+    };
+    version?: {
+        number?: number;
+        when?: string;
+    };
+    _links?: {
+        download?: string;
+        webui?: string;
+    };
+}
+export interface ConfluenceAttachmentList {
+    results: ConfluenceAttachment[];
+    size?: number;
+    start?: number;
+    limit?: number;
+}
+export interface ConfluenceComment {
+    id: string;
+    author: string;
+    created: string;
+    version: number;
+    body_plain: string;
+}
+export interface ConfluenceCommentList {
+    results: ConfluenceComment[];
+    size?: number;
+    start?: number;
+    limit?: number;
+}
+export declare function htmlToPlain(html: string): string;
+export {};
+//# sourceMappingURL=confluence_client.d.ts.map

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

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