patchwork-os 0.2.0-alpha.3 → 0.2.0-alpha.4

package/dist/connectors/linear.js

@@ -1,167 +1,184 @@
 /**
- * Linear connector.
+ * Linear connector — routes through Linear's official MCP server.
  *
- * Uses Linear's GraphQL API with a personal API key (no OAuth app required).
- * Token stored at ~/.patchwork/tokens/linear.json (mode 0600).
- * Env var: LINEAR_API_KEY
+ * Endpoint: https://mcp.linear.app/mcp
+ * Auth:     OAuth 2.1 w/ PKCE; dynamic client registration (RFC 7591).
  *
- * HTTP routes registered in server.ts:
- *   POST   /connections/linear/connect   — store token + verify
- *   POST   /connections/linear/test      — verify stored token works
- *   DELETE /connections/linear           — delete stored token
+ * 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 { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync, } from "node:fs";
-import { homedir } from "node:os";
-import path from "node:path";
-const LINEAR_API = "https://api.linear.app/graphql";
-const TOKEN_PATH = path.join(homedir(), ".patchwork", "tokens", "linear.json");
-// ── Token storage ─────────────────────────────────────────────────────────────
+import { McpClient } from "./mcpClient.js";
+import { completeAuthorize, getAccessToken, loadTokenFile, revoke, startAuthorize, 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() };
     }
-    if (!existsSync(TOKEN_PATH))
-        return null;
-    try {
-        return JSON.parse(readFileSync(TOKEN_PATH, "utf-8"));
-    }
-    catch {
+    const file = loadTokenFile("linear");
+    if (!file)
         return null;
-    }
-}
-function saveTokens(tokens) {
-    mkdirSync(path.dirname(TOKEN_PATH), { recursive: true, mode: 0o700 });
-    writeFileSync(TOKEN_PATH, JSON.stringify(tokens, null, 2), { mode: 0o600 });
-}
-function deleteTokens() {
-    if (existsSync(TOKEN_PATH))
-        unlinkSync(TOKEN_PATH);
-}
-export function getStatus() {
-    const tokens = loadTokens();
     return {
-        id: "linear",
-        status: tokens ? "connected" : "disconnected",
-        lastSync: tokens?.connected_at,
-        workspace: tokens?.workspace,
+        api_key: file.access_token,
+        workspace: file.profile?.workspace,
+        connected_at: file.connected_at,
     };
 }
-// ── GraphQL helpers ───────────────────────────────────────────────────────────
-export async function linearQuery(query, variables, apiKey, signal) {
-    const res = await fetch(LINEAR_API, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/json",
-            Authorization: apiKey,
-        },
-        body: JSON.stringify({ query, variables }),
-        signal,
-    });
-    if (!res.ok) {
-        const body = await res.text();
-        throw new Error(`Linear API error ${res.status}: ${body.slice(0, 200)}`);
-    }
-    const json = (await res.json());
-    if (json.errors?.length) {
-        throw new Error(`Linear GraphQL error: ${json.errors.map((e) => e.message).join(", ")}`);
+export function getStatus() {
+    const envKey = process.env.LINEAR_API_KEY;
+    if (envKey) {
+        return { id: "linear", status: "connected" };
     }
-    return json.data;
-}
-const VIEWER_QUERY = `query { viewer { id name email organization { name urlKey } } }`;
-async function verifyToken(apiKey, signal) {
-    const data = await linearQuery(VIEWER_QUERY, {}, apiKey, signal);
+    const file = loadTokenFile("linear");
     return {
-        name: data.viewer.name,
-        email: data.viewer.email,
-        workspace: data.viewer.organization.urlKey,
+        id: "linear",
+        status: file ? "connected" : "disconnected",
+        lastSync: file?.connected_at,
+        workspace: file?.profile?.workspace,
     };
 }
-const ISSUE_QUERY = `
-  query GetIssue($id: String!) {
-    issue(id: $id) {
-      id
-      identifier
-      title
-      description
-      state { name type }
-      assignee { name email }
-      priority
-      priorityLabel
-      url
-      createdAt
-      updatedAt
-      team { name key }
-      labels { nodes { name } }
-    }
-  }
-`;
-/**
- * Fetch a Linear issue by ID or URL.
- * Accepts: "LIN-123", "abc123def456...", "https://linear.app/.../issue/LIN-123/..."
- */
-export async function fetchIssue(issueIdOrUrl, signal) {
-    const tokens = loadTokens();
-    if (!tokens) {
-        throw new Error("Linear not connected. POST /connections/linear/connect first.");
-    }
-    const id = extractIssueId(issueIdOrUrl);
-    const data = await linearQuery(ISSUE_QUERY, { id }, tokens.api_key, signal);
-    if (!data.issue) {
-        throw new Error(`Linear issue not found: ${id}`);
-    }
-    return data.issue;
-}
 function extractIssueId(issueIdOrUrl) {
-    // URL form: https://linear.app/org/issue/LIN-123/title
     const urlMatch = issueIdOrUrl.match(/\/issue\/([A-Z]+-\d+|[a-f0-9-]{36})/i);
     if (urlMatch)
         return urlMatch[1];
-    // Identifier form: LIN-123, TEAM-456
-    if (/^[A-Z]+-\d+$/i.test(issueIdOrUrl.trim()))
-        return issueIdOrUrl.trim();
-    // UUID form
-    if (/^[a-f0-9-]{36}$/i.test(issueIdOrUrl.trim()))
-        return issueIdOrUrl.trim();
+    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 handleLinearConnect(body) {
-    const { api_key } = (body ?? {});
-    if (!api_key || typeof api_key !== "string") {
+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: "api_key required" }),
+            body: JSON.stringify({
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            }),
         };
     }
-    try {
-        const { name, email, workspace } = await verifyToken(api_key);
-        const tokens = {
-            api_key,
-            workspace,
-            connected_at: new Date().toISOString(),
+}
+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>`,
         };
-        saveTokens(tokens);
+    }
+    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) {
+                const file = loadTokenFile("linear");
+                if (file) {
+                    const { writeFileSync, mkdirSync } = await import("node:fs");
+                    const { homedir } = await import("node:os");
+                    const path = await import("node:path");
+                    const p = path.join(homedir(), ".patchwork", "tokens", "linear-mcp.json");
+                    mkdirSync(path.dirname(p), { recursive: true, mode: 0o700 });
+                    file.profile = { ...(file.profile ?? {}), workspace };
+                    writeFileSync(p, JSON.stringify(file, null, 2), { mode: 0o600 });
+                }
+            }
+        }
+        catch {
+            // Profile fetch is best-effort
+        }
         return {
             status: 200,
-            contentType: "application/json",
-            body: JSON.stringify({ ok: true, name, email, workspace }),
+            contentType: "text/html",
+            body: `<html><body><h2>Linear connected</h2><script>window.close();</script></body></html>`,
         };
     }
     catch (err) {
         return {
             status: 400,
-            contentType: "application/json",
-            body: JSON.stringify({
-                ok: false,
-                error: err instanceof Error ? err.message : String(err),
-            }),
+            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() {
-    const tokens = loadTokens();
-    if (!tokens) {
+    if (!loadTokens()) {
         return {
             status: 400,
             contentType: "application/json",
@@ -169,11 +186,11 @@ export async function handleLinearTest() {
         };
     }
     try {
-        const { name, email } = await verifyToken(tokens.api_key);
+        const ok = await client().ping({ timeoutMs: 10_000 });
         return {
-            status: 200,
+            status: ok ? 200 : 400,
             contentType: "application/json",
-            body: JSON.stringify({ ok: true, name, email }),
+            body: JSON.stringify({ ok, message: ok ? "connected" : "ping failed" }),
         };
     }
     catch (err) {
@@ -187,12 +204,33 @@ export async function handleLinearTest() {
         };
     }
 }
-export function handleLinearDisconnect() {
-    deleteTokens();
+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 ?? [];
+}
+export async function createIssue(input, signal) {
+    const res = await client().callTool("save_issue", input, { signal });
+    const parsed = McpClient.extractJson(res);
+    const issue = parsed.issue ?? parsed;
+    return issue;
+}
 //# sourceMappingURL=linear.js.map

package/dist/connectors/linear.js.map

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