narai-primitives 2.0.0-rc.1

package/dist/connectors/jira/index.js

@@ -0,0 +1,287 @@
+/**
+ * @narai/jira-agent-connector — read-only Jira connector.
+ *
+ * Built on @narai/connector-toolkit. The default export is a ready-to-use
+ * `Connector` instance; `buildJiraConnector(overrides?)` is exposed for
+ * tests that want to inject a fake Jira 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 { JiraClient, loadJiraCredentials, } from "./lib/jira_client.js";
+import { JiraError } from "./lib/jira_error.js";
+// ───────────────────────────────────────────────────────────────────────────
+// Param schemas
+// ───────────────────────────────────────────────────────────────────────────
+const MAX_RESULTS_DEFAULT = 50;
+const MAX_RESULTS_CAP = 500;
+const jqlSearchParams = z.object({
+    jql: z.string().min(1, "jql_search requires a non-empty 'jql' string"),
+    max_results: z.coerce
+        .number()
+        .int()
+        .positive()
+        .default(MAX_RESULTS_DEFAULT),
+});
+const getIssueParams = z.object({
+    issue_key: z
+        .string()
+        .regex(/^[A-Z][A-Z0-9]+-\d+$/, "Invalid issue_key — expected format like PROJ-123"),
+    expand: z.array(z.string()).default([]),
+});
+const getProjectParams = z.object({
+    project_key: z
+        .string()
+        .regex(/^[A-Z][A-Z0-9]+$/, "Invalid project_key — expected format like PROJ"),
+});
+const issueKeyRe = /^[A-Z][A-Z0-9]+-\d+$/;
+const listAttachmentsParams = z.object({
+    issue_key: z
+        .string()
+        .regex(issueKeyRe, "Invalid issue_key — expected format like PROJ-123"),
+});
+const getAttachmentParams = z.object({
+    issue_key: z
+        .string()
+        .regex(issueKeyRe, "Invalid issue_key — expected format like PROJ-123"),
+    attachment_id: z.string().min(1, "attachment_id is required"),
+});
+const getCommentsParams = z.object({
+    issue_key: z
+        .string()
+        .regex(issueKeyRe, "Invalid issue_key — expected format like PROJ-123"),
+    max_results: z.coerce.number().int().positive().default(50),
+});
+// ───────────────────────────────────────────────────────────────────────────
+// Error-code translation
+// ───────────────────────────────────────────────────────────────────────────
+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",
+};
+function throwIfError(result) {
+    if (!result.ok) {
+        throw new JiraError(result.code, result.message, result.retriable, result.status);
+    }
+}
+export function buildJiraConnector(overrides = {}) {
+    const defaultCredentials = async () => {
+        const creds = await loadJiraCredentials();
+        return creds ?? {};
+    };
+    const defaultSdk = async () => {
+        const creds = await loadJiraCredentials();
+        if (!creds) {
+            throw new JiraError("CONFIG_ERROR", "Jira credentials not configured. Set JIRA_SITE_URL, JIRA_EMAIL, and " +
+                "JIRA_API_TOKEN (or register a credential provider via " +
+                "@narai/credential-providers).", false);
+        }
+        return new JiraClient(creds);
+    };
+    return createConnector({
+        name: "jira",
+        version: "3.0.0",
+        scope: (ctx) => ctx.sdk.siteUrl,
+        credentials: overrides.credentials ?? defaultCredentials,
+        sdk: overrides.sdk ?? defaultSdk,
+        actions: {
+            jql_search: {
+                description: "Search Jira issues with a JQL query",
+                params: jqlSearchParams,
+                classify: { kind: "read" },
+                handler: async (p, ctx) => {
+                    const limit = Math.min(p.max_results, MAX_RESULTS_CAP);
+                    const result = await ctx.sdk.searchJql(p.jql, limit);
+                    throwIfError(result);
+                    const total = typeof result.data.total === "number" ? result.data.total : 0;
+                    const issues = Array.isArray(result.data.issues)
+                        ? result.data.issues
+                        : [];
+                    return {
+                        total,
+                        issues: issues.slice(0, limit).map((i) => ({
+                            key: i.key,
+                            summary: i.fields?.summary ?? "",
+                            status: i.fields?.status?.name ?? "",
+                            assignee: i.fields?.assignee?.displayName ?? null,
+                            labels: i.fields?.labels ?? [],
+                            updated: i.fields?.updated ?? null,
+                        })),
+                        truncated: issues.length > limit,
+                    };
+                },
+            },
+            get_issue: {
+                description: "Fetch a single Jira issue by key (e.g. PROJ-123)",
+                params: getIssueParams,
+                classify: { kind: "read" },
+                handler: async (p, ctx) => {
+                    const result = await ctx.sdk.getIssue(p.issue_key, p.expand);
+                    throwIfError(result);
+                    const fields = result.data.fields ?? {};
+                    return {
+                        key: result.data.key,
+                        summary: fields.summary ?? "",
+                        status: fields.status?.name ?? "",
+                        assignee: fields.assignee?.displayName ?? null,
+                        labels: fields.labels ?? [],
+                        updated: fields.updated ?? null,
+                    };
+                },
+            },
+            get_project: {
+                description: "Fetch Jira project metadata by key (e.g. PROJ)",
+                params: getProjectParams,
+                classify: { kind: "read" },
+                handler: async (p, ctx) => {
+                    const result = await ctx.sdk.getProject(p.project_key);
+                    throwIfError(result);
+                    return {
+                        key: result.data.key,
+                        name: result.data.name ?? "",
+                        description: result.data.description ?? "",
+                        lead: result.data.lead?.displayName ?? null,
+                        issue_types: (result.data.issueTypes ?? []).map((t) => t.name ?? ""),
+                    };
+                },
+            },
+            list_attachments: {
+                description: "List attachments on a Jira issue",
+                params: listAttachmentsParams,
+                classify: { kind: "read" },
+                handler: async (p, ctx) => {
+                    const result = await ctx.sdk.listAttachments(p.issue_key);
+                    throwIfError(result);
+                    return {
+                        issue_key: result.data.issueKey,
+                        total: result.data.results.length,
+                        attachments: result.data.results.map((a) => ({
+                            attachment_id: a.id,
+                            filename: a.filename,
+                            media_type: a.mediaType,
+                            size_bytes: a.sizeBytes,
+                            created: a.created,
+                            author: a.author,
+                        })),
+                    };
+                },
+            },
+            get_attachment: {
+                description: "Download and extract a Jira attachment to text",
+                params: getAttachmentParams,
+                classify: { kind: "read" },
+                handler: async (p, ctx) => {
+                    const list = await ctx.sdk.listAttachments(p.issue_key);
+                    throwIfError(list);
+                    const match = list.data.results.find((a) => a.id === p.attachment_id);
+                    if (!match) {
+                        throw new JiraError("NOT_FOUND", `Attachment ${p.attachment_id} not found on issue ${p.issue_key}`, false, 404);
+                    }
+                    const dl = await ctx.sdk.getAttachmentDownload(p.attachment_id);
+                    throwIfError(dl);
+                    const { bytes, contentType } = dl.data;
+                    const filename = dl.data.filename || match.filename;
+                    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(), `jira-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,
+                        issue_key: p.issue_key,
+                        filename: sanitizeLabel(filename, 255),
+                        media_type: contentType,
+                        size_bytes: bytes.byteLength,
+                        checksum,
+                        extracted,
+                        source_url: match.contentUrl,
+                    };
+                },
+            },
+            get_comments: {
+                description: "List comments on a Jira issue (plain-text from ADF)",
+                params: getCommentsParams,
+                classify: { kind: "read" },
+                handler: async (p, ctx) => {
+                    const result = await ctx.sdk.getComments(p.issue_key, p.max_results);
+                    throwIfError(result);
+                    return {
+                        issue_key: result.data.issueKey,
+                        total: result.data.total,
+                        comments: result.data.results.map((c) => ({
+                            comment_id: c.id,
+                            author: c.author,
+                            created: c.created,
+                            updated: c.updated,
+                            body_plain: c.body_plain,
+                        })),
+                    };
+                },
+            },
+        },
+        mapError: (err) => {
+            if (err instanceof JiraError) {
+                return {
+                    error_code: CODE_MAP[err.code] ?? "CONNECTION_ERROR",
+                    message: err.message,
+                    retriable: err.retriable,
+                };
+            }
+            return undefined;
+        },
+    });
+}
+// Default production connector.
+const connector = buildJiraConnector();
+export default connector;
+export const { main, fetch, validActions } = connector;
+export { JiraClient, loadJiraCredentials, } from "./lib/jira_client.js";
+export { JiraError } from "./lib/jira_error.js";
+//# sourceMappingURL=index.js.map

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

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

package/dist/connectors/jira/lib/adf.d.ts

@@ -0,0 +1,25 @@
+/**
+ * adf.ts — convert Atlassian Document Format (ADF) trees to plain text.
+ *
+ * ADF is a JSON document shape used for Jira comments, descriptions, and
+ * some custom field values. Each node has a `type` and optional `content`
+ * (child nodes), plus type-specific fields (`text` for text nodes, `attrs`
+ * for anchors, etc.).
+ *
+ * This converter is a best-effort walker that preserves paragraph / list
+ * boundaries by emitting newlines, prefixes list items with `- ` /
+ * `{n}. `, and drops marks. Full fidelity (bold/italic/color, mentions,
+ * embedded smart-links) is deferred — plain text is enough for grep /
+ * embedding indexes, which is what comments-to-text is for.
+ */
+export interface AdfNode {
+    type?: string;
+    text?: string;
+    content?: AdfNode[];
+    attrs?: Record<string, unknown>;
+    marks?: Array<{
+        type?: string;
+    }>;
+}
+export declare function adfToPlainText(doc: AdfNode | undefined | null): string;
+//# sourceMappingURL=adf.d.ts.map

package/dist/connectors/jira/lib/adf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adf.d.ts","sourceRoot":"","sources":["../../../../src/connectors/jira/lib/adf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClC;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAKtE"}

package/dist/connectors/jira/lib/adf.js

@@ -0,0 +1,105 @@
+/**
+ * adf.ts — convert Atlassian Document Format (ADF) trees to plain text.
+ *
+ * ADF is a JSON document shape used for Jira comments, descriptions, and
+ * some custom field values. Each node has a `type` and optional `content`
+ * (child nodes), plus type-specific fields (`text` for text nodes, `attrs`
+ * for anchors, etc.).
+ *
+ * This converter is a best-effort walker that preserves paragraph / list
+ * boundaries by emitting newlines, prefixes list items with `- ` /
+ * `{n}. `, and drops marks. Full fidelity (bold/italic/color, mentions,
+ * embedded smart-links) is deferred — plain text is enough for grep /
+ * embedding indexes, which is what comments-to-text is for.
+ */
+export function adfToPlainText(doc) {
+    if (!doc)
+        return "";
+    const out = [];
+    walk(doc, out, { listDepth: 0, orderedIndex: [] });
+    return out.join("").replace(/\n{3,}/g, "\n\n").trim();
+}
+function walk(node, out, state) {
+    const type = node.type ?? "";
+    switch (type) {
+        case "text":
+            if (node.text)
+                out.push(node.text);
+            return;
+        case "hardBreak":
+            out.push("\n");
+            return;
+        case "paragraph":
+            walkChildren(node, out, state);
+            out.push("\n\n");
+            return;
+        case "heading":
+            walkChildren(node, out, state);
+            out.push("\n\n");
+            return;
+        case "blockquote":
+            walkChildren(node, out, state);
+            out.push("\n\n");
+            return;
+        case "bulletList":
+        case "orderedList": {
+            const next = {
+                listDepth: state.listDepth + 1,
+                orderedIndex: [...state.orderedIndex],
+            };
+            if (type === "orderedList")
+                next.orderedIndex.push(0);
+            for (const child of node.content ?? [])
+                walk(child, out, next);
+            out.push("\n");
+            return;
+        }
+        case "listItem": {
+            const indent = "  ".repeat(Math.max(0, state.listDepth - 1));
+            let prefix = "- ";
+            if (state.orderedIndex.length > 0) {
+                const idx = state.orderedIndex.length - 1;
+                state.orderedIndex[idx] = (state.orderedIndex[idx] ?? 0) + 1;
+                prefix = `${state.orderedIndex[idx]}. `;
+            }
+            const inner = [];
+            walkChildren(node, inner, state);
+            const body = inner.join("").replace(/\n+$/, "");
+            out.push(indent + prefix + body + "\n");
+            return;
+        }
+        case "codeBlock":
+            walkChildren(node, out, state);
+            out.push("\n\n");
+            return;
+        case "rule":
+            out.push("\n---\n");
+            return;
+        case "mention": {
+            const text = node.attrs?.["text"] ?? "";
+            if (text)
+                out.push(text);
+            return;
+        }
+        case "inlineCard": {
+            const url = node.attrs?.["url"] ?? "";
+            if (url)
+                out.push(url);
+            return;
+        }
+        case "emoji": {
+            const shortName = node.attrs?.["shortName"] ?? "";
+            const text = node.attrs?.["text"] ?? shortName;
+            if (text)
+                out.push(text);
+            return;
+        }
+        default:
+            walkChildren(node, out, state);
+    }
+}
+function walkChildren(node, out, state) {
+    for (const child of node.content ?? [])
+        walk(child, out, state);
+}
+//# sourceMappingURL=adf.js.map

package/dist/connectors/jira/lib/adf.js.map

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

package/dist/connectors/jira/lib/jira_client.d.ts

@@ -0,0 +1,143 @@
+type HttpMethod = "GET";
+export interface JiraClientOptions {
+    /** Atlassian Cloud site URL — e.g. https://acme.atlassian.net. */
+    siteUrl: string;
+    /** User email for Basic auth. */
+    email: string;
+    /** API token for Basic auth. */
+    apiToken: string;
+    /** Per-client request-per-minute ceiling. Default 60. */
+    rateLimitPerMin?: number;
+    /** Connect timeout ms. Default 10_000. */
+    connectTimeoutMs?: number;
+    /** Read timeout ms. Default 30_000. */
+    readTimeoutMs?: number;
+    /** Optional fetch-override used by unit tests. */
+    fetchImpl?: typeof globalThis.fetch;
+    /** Optional sleep-override used by unit tests. */
+    sleepImpl?: (ms: number) => Promise<void>;
+}
+export interface JiraErrorPayload {
+    ok: false;
+    code: string;
+    message: string;
+    retriable: boolean;
+    status?: number;
+}
+export interface JiraSuccessPayload<T> {
+    ok: true;
+    data: T;
+    status: number;
+}
+export type JiraResult<T> = JiraSuccessPayload<T> | JiraErrorPayload;
+/** Resolve Jira credentials from the shared credential provider chain. */
+export declare function loadJiraCredentials(): Promise<{
+    siteUrl: string;
+    email: string;
+    apiToken: string;
+} | null>;
+export declare class JiraClient {
+    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: JiraClientOptions);
+    /** Reset the request-per-minute sliding window (test helper). */
+    resetRateLimiter(): void;
+    private _throttle;
+    /** Build a URL against the site root. */
+    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<JiraResult<T>>;
+    /**
+     * JQL search. Uses `/rest/api/3/search/jql` (Cloud) — the legacy
+     * `/rest/api/3/search` endpoint was decommissioned in 2025 and now returns
+     * HTTP 410. The new endpoint paginates with an opaque `nextPageToken` and
+     * does NOT return `total`; we synthesize a `total` from the issues length
+     * for backward-compatible callers, and treat the absence of `nextPageToken`
+     * as "no more pages".
+     */
+    searchJql(jql: string, maxResults: number, startAt?: number): Promise<JiraResult<JiraSearchResponse>>;
+    /** `/rest/api/3/issue/{issueKey}`. */
+    getIssue(issueKey: string, expand?: string[]): Promise<JiraResult<JiraIssue>>;
+    /** `/rest/api/3/project/{projectKey}`. */
+    getProject(projectKey: string): Promise<JiraResult<JiraProject>>;
+    /**
+     * List attachments on an issue. Uses `fields=attachment` on the issue
+     * endpoint because `fields.attachment` is the canonical list; there is
+     * no dedicated `/attachments` collection per issue.
+     */
+    listAttachments(issueKey: string): Promise<JiraResult<JiraAttachmentList>>;
+    /** Fetch raw attachment bytes. `GET /rest/api/3/attachment/content/{id}`. */
+    getAttachmentDownload(attachmentId: string): Promise<JiraResult<{
+        bytes: Uint8Array;
+        contentType: string;
+        filename: string;
+    }>>;
+    getComments(issueKey: string, maxResults?: number): Promise<JiraResult<JiraCommentList>>;
+    get siteUrl(): string;
+}
+export interface JiraIssue {
+    key: string;
+    fields?: {
+        summary?: string;
+        status?: {
+            name?: string;
+        };
+        assignee?: {
+            displayName?: string;
+        } | null;
+        labels?: string[];
+        updated?: string;
+    };
+}
+export interface JiraSearchResponse {
+    total: number;
+    issues: JiraIssue[];
+    maxResults?: number;
+    startAt?: number;
+}
+export interface JiraProject {
+    key: string;
+    name?: string;
+    description?: string;
+    lead?: {
+        displayName?: string;
+    } | null;
+    issueTypes?: Array<{
+        name?: string;
+    }>;
+}
+export interface JiraAttachment {
+    id: string;
+    filename: string;
+    mediaType: string;
+    sizeBytes: number;
+    created: string;
+    author: string;
+    contentUrl: string;
+}
+export interface JiraAttachmentList {
+    issueKey: string;
+    results: JiraAttachment[];
+}
+export interface JiraComment {
+    id: string;
+    author: string;
+    created: string;
+    updated: string;
+    body_plain: string;
+}
+export interface JiraCommentList {
+    issueKey: string;
+    results: JiraComment[];
+    total: number;
+}
+export {};
+//# sourceMappingURL=jira_client.d.ts.map

package/dist/connectors/jira/lib/jira_client.d.ts.map

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