patchwork-os 0.2.0-alpha.2 → 0.2.0-alpha.22

package/dist/connectors/linear.js

@@ -0,0 +1,239 @@
+/**
+ * Linear connector — routes through Linear's official MCP server.
+ *
+ * Endpoint: https://mcp.linear.app/mcp
+ * Auth:     OAuth 2.1 w/ PKCE; dynamic client registration (RFC 7591).
+ *
+ * HTTP routes (wired in src/server.ts):
+ *   GET    /connections/linear/authorize — returns { url } for popup
+ *   GET    /connections/linear/callback  — token exchange
+ *   POST   /connections/linear/test      — ping MCP server
+ *   DELETE /connections/linear           — revoke + delete token
+ *
+ * Back-compat: loadTokens() returns a shape compatible with legacy code
+ * that expected { api_key }. Set LINEAR_API_KEY to bypass OAuth for CI/headless.
+ */
+import { McpClient } from "./mcpClient.js";
+import { completeAuthorize, getAccessToken, loadTokenFile, revoke, startAuthorize, updateTokenProfile, vendorConfig, } from "./mcpOAuth.js";
+const LINEAR_MCP_ENDPOINT = "https://mcp.linear.app/mcp";
+// ── MCP client ───────────────────────────────────────────────────────────────
+let _client = null;
+function client() {
+    if (!_client) {
+        _client = new McpClient(LINEAR_MCP_ENDPOINT, async () => {
+            const envKey = process.env.LINEAR_API_KEY;
+            if (envKey)
+                return envKey;
+            return getAccessToken("linear");
+        });
+    }
+    return _client;
+}
+// ── Back-compat token loader ─────────────────────────────────────────────────
+export function loadTokens() {
+    const envKey = process.env.LINEAR_API_KEY;
+    if (envKey) {
+        return { api_key: envKey, connected_at: new Date().toISOString() };
+    }
+    const file = loadTokenFile("linear");
+    if (!file)
+        return null;
+    return {
+        api_key: file.access_token,
+        workspace: file.profile?.workspace,
+        connected_at: file.connected_at,
+    };
+}
+export function getStatus() {
+    const envKey = process.env.LINEAR_API_KEY;
+    if (envKey) {
+        return { id: "linear", status: "connected" };
+    }
+    const file = loadTokenFile("linear");
+    return {
+        id: "linear",
+        status: file ? "connected" : "disconnected",
+        lastSync: file?.connected_at,
+        workspace: file?.profile?.workspace,
+    };
+}
+function extractIssueId(issueIdOrUrl) {
+    const urlMatch = issueIdOrUrl.match(/\/issue\/([A-Z]+-\d+|[a-f0-9-]{36})/i);
+    if (urlMatch)
+        return urlMatch[1];
+    const trimmed = issueIdOrUrl.trim();
+    if (/^[A-Z]+-\d+$/i.test(trimmed))
+        return trimmed;
+    if (/^[a-f0-9-]{36}$/i.test(trimmed))
+        return trimmed;
+    throw new Error(`Cannot parse Linear issue ID from: ${issueIdOrUrl}`);
+}
+export async function fetchIssue(issueIdOrUrl, signal) {
+    if (!loadTokens())
+        throw new Error("Linear not connected. GET /connections/linear/authorize first.");
+    const id = extractIssueId(issueIdOrUrl);
+    const res = await client().callTool("get_issue", { id }, { signal });
+    const parsed = McpClient.extractJson(res);
+    const issue = parsed.issue ?? parsed;
+    if (!issue)
+        throw new Error(`Linear issue not found: ${id}`);
+    return issue;
+}
+export async function listIssues(opts = {}, signal) {
+    if (!loadTokens())
+        return [];
+    const args = {
+        limit: Math.min(opts.limit ?? 20, 50),
+    };
+    if (opts.team)
+        args.team = opts.team;
+    if (opts.assigneeMe)
+        args.assignee = "me";
+    if (opts.states?.length)
+        args.stateTypes = opts.states;
+    try {
+        const res = await client().callTool("list_issues", args, {
+            signal,
+            cacheKey: `linear:issues:${JSON.stringify(args)}`,
+            cacheTtlMs: 60_000,
+        });
+        const parsed = McpClient.extractJson(res);
+        if (Array.isArray(parsed))
+            return parsed;
+        return parsed.issues ?? parsed.nodes ?? [];
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.includes("not connected"))
+            throw err;
+        return [];
+    }
+}
+// ── HTTP handlers ────────────────────────────────────────────────────────────
+export async function handleLinearAuthorize() {
+    try {
+        const { url } = await startAuthorize(vendorConfig("linear"));
+        return { status: 302, body: "", redirect: url };
+    }
+    catch (err) {
+        return {
+            status: 400,
+            contentType: "application/json",
+            body: JSON.stringify({
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            }),
+        };
+    }
+}
+export async function handleLinearCallback(code, state, error) {
+    if (error) {
+        return {
+            status: 400,
+            contentType: "text/html",
+            body: `<html><body><h2>Linear connect failed</h2><pre>${error}</pre></body></html>`,
+        };
+    }
+    if (!code || !state) {
+        return {
+            status: 400,
+            contentType: "text/html",
+            body: `<html><body><h2>Linear connect failed</h2><pre>missing code/state</pre></body></html>`,
+        };
+    }
+    try {
+        await completeAuthorize(vendorConfig("linear"), code, state);
+        // Best-effort profile capture (workspace name)
+        try {
+            const res = await client().callTool("get_viewer", {}, { timeoutMs: 10_000 });
+            const viewer = McpClient.extractJson(res);
+            const workspace = viewer.organization?.urlKey ?? viewer.organization?.name ?? "";
+            if (workspace) {
+                updateTokenProfile("linear", { workspace });
+            }
+        }
+        catch {
+            // Profile fetch is best-effort
+        }
+        return {
+            status: 200,
+            contentType: "text/html",
+            body: `<html><body><h2>Linear connected</h2><script>window.close();</script></body></html>`,
+        };
+    }
+    catch (err) {
+        return {
+            status: 400,
+            contentType: "text/html",
+            body: `<html><body><h2>Linear connect failed</h2><pre>${err instanceof Error ? err.message : String(err)}</pre></body></html>`,
+        };
+    }
+}
+export async function handleLinearTest() {
+    if (!loadTokens()) {
+        return {
+            status: 400,
+            contentType: "application/json",
+            body: JSON.stringify({ ok: false, error: "Linear not connected" }),
+        };
+    }
+    try {
+        const ok = await client().ping({ timeoutMs: 10_000 });
+        return {
+            status: ok ? 200 : 400,
+            contentType: "application/json",
+            body: JSON.stringify({ ok, message: ok ? "connected" : "ping failed" }),
+        };
+    }
+    catch (err) {
+        return {
+            status: 400,
+            contentType: "application/json",
+            body: JSON.stringify({
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            }),
+        };
+    }
+}
+export async function handleLinearDisconnect() {
+    await revoke("linear");
+    _client = null;
+    return {
+        status: 200,
+        contentType: "application/json",
+        body: JSON.stringify({ ok: true }),
+    };
+}
+export async function listTeams(signal) {
+    const res = await client().callTool("list_teams", {}, { signal });
+    const parsed = McpClient.extractJson(res);
+    if (Array.isArray(parsed))
+        return parsed;
+    return parsed.teams ?? parsed.nodes ?? [];
+}
+export async function listLabels(signal) {
+    const res = await client().callTool("list_issue_labels", {}, { signal });
+    const parsed = McpClient.extractJson(res);
+    if (Array.isArray(parsed))
+        return parsed;
+    return parsed.labels ?? parsed.nodes ?? [];
+}
+async function callSaveIssue(args, signal) {
+    const res = await client().callTool("save_issue", args, { signal });
+    const parsed = McpClient.extractJson(res);
+    return (parsed.issue ?? parsed);
+}
+export async function createIssue(input, signal) {
+    return callSaveIssue(input, signal);
+}
+export async function updateIssue(input, signal) {
+    return callSaveIssue(input, signal);
+}
+export async function addComment(issueId, body, signal) {
+    const id = extractIssueId(issueId);
+    const res = await client().callTool("create_comment", { issueId: id, body }, { signal });
+    const parsed = McpClient.extractJson(res);
+    return (parsed
+        .comment ?? parsed);
+}
+//# sourceMappingURL=linear.js.map

package/dist/connectors/linear.js.map

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

package/dist/connectors/mcpClient.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Minimal Streamable-HTTP MCP client for calling upstream MCP servers
+ * (GitHub, Linear, Sentry) from Patchwork connectors.
+ *
+ * Supports:
+ *   - initialize handshake
+ *   - tools/list
+ *   - tools/call (with argument object)
+ *   - SSE response parsing (when server returns text/event-stream)
+ *   - Bearer token auth (OAuth access token)
+ *   - 15s default timeout
+ *   - Best-effort 60s in-memory result cache (opt-in per call)
+ *
+ * Wire format reference: MCP spec 2024-11-05 / 2025-03-26, Streamable HTTP transport.
+ */
+type JsonValue = string | number | boolean | null | {
+    [k: string]: JsonValue;
+} | JsonValue[];
+export interface McpCallOptions {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    /** If set, cache the result under this key for `cacheTtlMs` ms. */
+    cacheKey?: string;
+    cacheTtlMs?: number;
+}
+export interface McpToolResult {
+    content: Array<{
+        type: string;
+        text?: string;
+        [k: string]: unknown;
+    }>;
+    isError?: boolean;
+    structuredContent?: JsonValue;
+}
+export declare function clearMcpCache(): void;
+export declare class McpClient {
+    private readonly endpoint;
+    private readonly getAccessToken;
+    private sessionId;
+    private initialized;
+    private nextId;
+    constructor(endpoint: string, getAccessToken: () => Promise<string>);
+    private post;
+    private ensureInitialized;
+    listTools(opts?: McpCallOptions): Promise<Array<{
+        name: string;
+        description?: string;
+        inputSchema?: JsonValue;
+    }>>;
+    callTool(name: string, args: Record<string, unknown>, opts?: McpCallOptions): Promise<McpToolResult>;
+    /** Convenience: extract the first `structuredContent` object, or parse the first text block as JSON. */
+    static extractJson<T = unknown>(result: McpToolResult): T;
+    /** Ping by listing tools; returns true if reachable + authorized. */
+    ping(opts?: McpCallOptions): Promise<boolean>;
+}
+export {};

package/dist/connectors/mcpClient.js

@@ -0,0 +1,189 @@
+/**
+ * Minimal Streamable-HTTP MCP client for calling upstream MCP servers
+ * (GitHub, Linear, Sentry) from Patchwork connectors.
+ *
+ * Supports:
+ *   - initialize handshake
+ *   - tools/list
+ *   - tools/call (with argument object)
+ *   - SSE response parsing (when server returns text/event-stream)
+ *   - Bearer token auth (OAuth access token)
+ *   - 15s default timeout
+ *   - Best-effort 60s in-memory result cache (opt-in per call)
+ *
+ * Wire format reference: MCP spec 2024-11-05 / 2025-03-26, Streamable HTTP transport.
+ */
+const cache = new Map();
+const DEFAULT_TIMEOUT = 15_000;
+function getCached(key) {
+    const e = cache.get(key);
+    if (!e)
+        return null;
+    if (Date.now() > e.expiresAt) {
+        cache.delete(key);
+        return null;
+    }
+    return e.value;
+}
+function setCached(key, value, ttlMs) {
+    cache.set(key, { value, expiresAt: Date.now() + ttlMs });
+}
+export function clearMcpCache() {
+    cache.clear();
+}
+/**
+ * Parse a Streamable-HTTP response body. The server may reply with:
+ *   - application/json  → single JSON-RPC response
+ *   - text/event-stream → SSE frames, last `data:` line is the response
+ */
+async function parseMcpResponse(res) {
+    const ct = res.headers.get("content-type") ?? "";
+    const text = await res.text();
+    if (ct.includes("text/event-stream")) {
+        // Find last `data:` line carrying a JSON payload
+        const lines = text.split(/\r?\n/);
+        let last = null;
+        for (const l of lines) {
+            if (l.startsWith("data:")) {
+                const payload = l.slice(5).trim();
+                if (payload && payload !== "[DONE]")
+                    last = payload;
+            }
+        }
+        if (!last)
+            throw new Error("MCP SSE response had no data frame");
+        return JSON.parse(last);
+    }
+    if (!text)
+        return null;
+    return JSON.parse(text);
+}
+function withTimeout(signal, ms) {
+    const ctl = new AbortController();
+    const onAbort = () => ctl.abort(signal?.reason);
+    if (signal) {
+        if (signal.aborted)
+            ctl.abort(signal.reason);
+        else
+            signal.addEventListener("abort", onAbort, { once: true });
+    }
+    const t = setTimeout(() => ctl.abort(new Error("MCP request timeout")), ms);
+    ctl.signal.addEventListener("abort", () => clearTimeout(t), { once: true });
+    return ctl.signal;
+}
+export class McpClient {
+    endpoint;
+    getAccessToken;
+    sessionId = null;
+    initialized = false;
+    nextId = 1;
+    constructor(endpoint, getAccessToken) {
+        this.endpoint = endpoint;
+        this.getAccessToken = getAccessToken;
+    }
+    async post(body, opts = {}) {
+        const token = await this.getAccessToken();
+        const signal = withTimeout(opts.signal, opts.timeoutMs ?? DEFAULT_TIMEOUT);
+        const headers = {
+            "Content-Type": "application/json",
+            Accept: "application/json, text/event-stream",
+            Authorization: `Bearer ${token}`,
+        };
+        if (this.sessionId)
+            headers["Mcp-Session-Id"] = this.sessionId;
+        const res = await fetch(this.endpoint, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(body),
+            signal,
+        });
+        // Pick up session id if server issued one
+        const sid = res.headers.get("mcp-session-id");
+        if (sid)
+            this.sessionId = sid;
+        if (!res.ok) {
+            const snippet = (await res.text()).slice(0, 300);
+            throw new Error(`MCP HTTP ${res.status} at ${this.endpoint}: ${snippet}`);
+        }
+        return parseMcpResponse(res);
+    }
+    async ensureInitialized(opts = {}) {
+        if (this.initialized)
+            return;
+        const id = this.nextId++;
+        const resp = (await this.post({
+            jsonrpc: "2.0",
+            id,
+            method: "initialize",
+            params: {
+                protocolVersion: "2025-03-26",
+                capabilities: {},
+                clientInfo: { name: "patchwork-os", version: "0.1" },
+            },
+        }, opts));
+        if (resp?.error)
+            throw new Error(`MCP initialize failed: ${resp.error.message}`);
+        // Notify initialized (fire-and-forget, no id)
+        await this.post({ jsonrpc: "2.0", method: "notifications/initialized" }, opts).catch(() => { });
+        this.initialized = true;
+    }
+    async listTools(opts = {}) {
+        await this.ensureInitialized(opts);
+        const id = this.nextId++;
+        const resp = (await this.post({ jsonrpc: "2.0", id, method: "tools/list" }, opts));
+        if (resp?.error)
+            throw new Error(`tools/list: ${resp.error.message}`);
+        return resp.result?.tools ?? [];
+    }
+    async callTool(name, args, opts = {}) {
+        if (opts.cacheKey) {
+            const hit = getCached(opts.cacheKey);
+            if (hit)
+                return hit;
+        }
+        await this.ensureInitialized(opts);
+        const id = this.nextId++;
+        const resp = (await this.post({
+            jsonrpc: "2.0",
+            id,
+            method: "tools/call",
+            params: { name, arguments: args },
+        }, opts));
+        if (resp?.error)
+            throw new Error(`tools/call ${name}: ${resp.error.message}`);
+        const result = resp.result ?? { content: [] };
+        if (result.isError) {
+            const msg = result.content
+                .map((c) => c.text)
+                .filter(Boolean)
+                .join(" ")
+                .slice(0, 300);
+            throw new Error(`MCP tool ${name} returned error: ${msg || "unknown"}`);
+        }
+        if (opts.cacheKey && opts.cacheTtlMs) {
+            setCached(opts.cacheKey, result, opts.cacheTtlMs);
+        }
+        return result;
+    }
+    /** Convenience: extract the first `structuredContent` object, or parse the first text block as JSON. */
+    static extractJson(result) {
+        if (result.structuredContent !== undefined) {
+            return result.structuredContent;
+        }
+        const text = result.content.find((c) => c.type === "text")?.text;
+        if (!text)
+            throw new Error("MCP result had no text content");
+        return JSON.parse(text);
+    }
+    /** Ping by listing tools; returns true if reachable + authorized. */
+    async ping(opts = {}) {
+        try {
+            await this.listTools(opts);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=mcpClient.js.map

package/dist/connectors/mcpClient.js.map

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

package/dist/connectors/mcpOAuth.d.ts

@@ -0,0 +1,84 @@
+/**
+ * OAuth 2.1 PKCE helper for upstream MCP servers.
+ *
+ * Supports two vendor modes:
+ *   - dyn-reg (Linear, Sentry): RFC 7591 dynamic client registration.
+ *     Registration data cached alongside tokens so we don't re-register every run.
+ *   - preregistered (GitHub): uses a hardcoded client_id + PKCE-only flow.
+ *
+ * Token files: ~/.patchwork/tokens/<vendor>-mcp.json (mode 0600)
+ *
+ * Flow:
+ *   1. startAuthorize({ vendor, config }) -> { url, state }
+ *      Dashboard opens `url` in a popup; stores `state` to correlate callback.
+ *   2. server.ts callback route calls completeAuthorize({ vendor, config, code, state })
+ *      -> persisted token file.
+ *   3. getAccessToken({ vendor }) reads token, refreshes if needed.
+ *   4. revoke({ vendor }) hits the revocation endpoint + deletes file.
+ */
+export type VendorId = "github" | "linear" | "sentry";
+export interface VendorConfig {
+    vendor: VendorId;
+    /** Base issuer (authorization server), used for discovery. */
+    issuer: string;
+    /** Explicit endpoints (overrides discovery). */
+    authorizationEndpoint?: string;
+    tokenEndpoint?: string;
+    registrationEndpoint?: string;
+    revocationEndpoint?: string;
+    /** Scopes requested in authorize URL. */
+    scopes: string[];
+    /** Redirect URI — must match what's registered / what the dashboard uses. */
+    redirectUri: string;
+    /** If true, use RFC 7591 dynamic client registration. */
+    useDynamicRegistration: boolean;
+    /** If useDynamicRegistration=false, this client_id is used. */
+    preregisteredClientId?: string;
+    /** Client secret for pre-registered clients (e.g. GitHub OAuth Apps). */
+    preregisteredClientSecret?: string;
+    /** Human-friendly client name for dyn-reg. */
+    clientName?: string;
+}
+export declare function vendorConfig(vendor: VendorId): VendorConfig;
+export interface McpTokenFile {
+    vendor: VendorId;
+    client_id: string;
+    client_secret?: string;
+    access_token: string;
+    refresh_token?: string;
+    expires_at?: number;
+    scope?: string;
+    connected_at: string;
+    /** Vendor-specific profile info captured at connect-time for UI display. */
+    profile?: Record<string, string>;
+}
+export declare function loadTokenFile(vendor: VendorId): McpTokenFile | null;
+export declare function updateTokenProfile(vendor: VendorId, profile: Record<string, string>): void;
+/**
+ * Returns the authorize URL for the popup, and a `state` cookie value
+ * the callback must match. For dyn-reg vendors, registers a fresh client
+ * if we don't have one yet (re-uses existing one from token file on reconnect).
+ */
+export declare function startAuthorize(config: VendorConfig): Promise<{
+    url: string;
+    state: string;
+}>;
+export interface CompleteResult {
+    ok: true;
+    profile?: Record<string, string>;
+}
+/** Complete the authorize flow. Persists token file. */
+export declare function completeAuthorize(config: VendorConfig, code: string, state: string, profile?: Record<string, string>): Promise<CompleteResult>;
+export interface ConnectorStatus {
+    vendor: VendorId;
+    connected: boolean;
+    expiresAt?: number;
+    expiresInMs?: number;
+    needsReauth: boolean;
+    profile?: Record<string, string>;
+}
+export declare function getConnectorStatus(vendor: VendorId): ConnectorStatus;
+export declare function getAllConnectorStatuses(): ConnectorStatus[];
+export declare function getAccessToken(vendor: VendorId): Promise<string>;
+export declare function revoke(vendor: VendorId): Promise<void>;
+export declare function isConnected(vendor: VendorId): boolean;