studiograph 1.1.2 → 1.2.0-beta.1

package/dist/mcp/connector-manager.js

@@ -0,0 +1,223 @@
+/**
+ * MCP Connector Manager
+ *
+ * Connects the Studiograph agent to third-party MCP servers so the agent can
+ * query external data sources on demand.
+ *
+ * Three transport types are supported:
+ *
+ *   http  — Remote streamable-HTTP server (e.g. Linear at https://mcp.linear.app/mcp).
+ *           Requires `url` and `token` fields. Token can be a literal string or a
+ *           $ENV_VAR reference resolved at runtime.
+ *
+ *   oauth — Remote streamable-HTTP server with OAuth (e.g. Figma at mcp.figma.com/mcp).
+ *           Requires `url` only. Uses dynamic client registration + PKCE — no client
+ *           secrets needed. Browser opens for user authorization on first connect.
+ *
+ *   stdio — Local stdio MCP server (e.g. granola-mcp spawned as a child process).
+ *           Requires `command` and optionally `args` / `env`. No token needed —
+ *           the server reads its own credentials from wherever it stores them.
+ *
+ * Connector configs are stored per-user at ~/.studiograph/connectors/<name>.json
+ * (mode 0600 — never committed to git).
+ *
+ * Each connector's tools are injected into the agent with a namespaced prefix:
+ *   linear__search_issues, granola__list_meetings, etc.
+ *
+ * Connection failures are non-fatal — the failing connector is skipped with a warning.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { auth } from '@modelcontextprotocol/sdk/client/auth.js';
+import { ConnectorOAuthProvider, waitForOAuthCallback } from './oauth-provider.js';
+export const CONNECTORS_DIR = join(homedir(), '.studiograph', 'connectors');
+// ── ConnectorManager ──────────────────────────────────────────────────────────
+export class ConnectorManager {
+    // ── config persistence ────────────────────────────────────────────────────
+    static loadConfigs() {
+        if (!existsSync(CONNECTORS_DIR))
+            return [];
+        let entries;
+        try {
+            entries = readdirSync(CONNECTORS_DIR);
+        }
+        catch {
+            return [];
+        }
+        const configs = [];
+        for (const entry of entries) {
+            if (!entry.endsWith('.json'))
+                continue;
+            try {
+                const raw = JSON.parse(readFileSync(join(CONNECTORS_DIR, entry), 'utf-8'));
+                if (typeof raw.name !== 'string' || !raw.name) {
+                    console.warn(`[connectors] Skipping malformed config (missing name): ${entry}`);
+                    continue;
+                }
+                const resolved = ConnectorManager._resolveType(raw);
+                if (!ConnectorManager._validate(resolved, entry))
+                    continue;
+                configs.push(resolved);
+            }
+            catch {
+                console.warn(`[connectors] Could not parse ${entry} — skipping`);
+            }
+        }
+        return configs;
+    }
+    static saveConfig(config) {
+        mkdirSync(CONNECTORS_DIR, { recursive: true });
+        const path = join(CONNECTORS_DIR, `${config.name}.json`);
+        writeFileSync(path, JSON.stringify(config, null, 2) + '\n', { mode: 0o600 });
+    }
+    static removeConfig(name) {
+        const path = join(CONNECTORS_DIR, `${name}.json`);
+        if (!existsSync(path))
+            return false;
+        unlinkSync(path);
+        return true;
+    }
+    // ── token resolution ──────────────────────────────────────────────────────
+    /** Expands $ENV_VAR references; returns the literal string otherwise. */
+    static resolveToken(token) {
+        if (token.startsWith('$')) {
+            return process.env[token.slice(1)] ?? token;
+        }
+        return token;
+    }
+    // ── tool building ─────────────────────────────────────────────────────────
+    /**
+     * For each connector config: connect to the MCP server, fetch its tool list,
+     * and return Pi-Mono-compatible tool objects with namespaced names.
+     *
+     * Failures are non-fatal — the connector is skipped with a console.warn.
+     */
+    static async buildTools(configs, timeoutMs = 10_000) {
+        const tools = [];
+        for (const config of configs) {
+            try {
+                const connectorTools = await Promise.race([
+                    ConnectorManager._buildConnectorTools(config),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error('Connection timed out')), timeoutMs)),
+                ]);
+                tools.push(...connectorTools);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                const isLocal = /^https?:\/\/(localhost|127\.0\.0\.1)(:|\/|$)/.test(config.url ?? '');
+                const isUnavailable = /timed out|ECONNREFUSED|fetch failed/i.test(msg);
+                if (isLocal && isUnavailable) {
+                    console.warn(`[connectors] ${config.name} skipped — local server not running (${config.url})`);
+                }
+                else {
+                    console.warn(`[connectors] Failed to connect to "${config.name}" (${config.type === 'stdio' ? config.command : config.url}): ${msg}`);
+                }
+            }
+        }
+        return tools;
+    }
+    // ── private helpers ───────────────────────────────────────────────────────
+    static _resolveType(config) {
+        if (config.type)
+            return config;
+        // Infer type from fields present
+        if (config.command)
+            return { ...config, type: 'stdio' };
+        return { ...config, type: 'http' };
+    }
+    static _validate(config, filename) {
+        if (config.type === 'stdio') {
+            if (!config.command) {
+                console.warn(`[connectors] stdio connector "${config.name}" missing "command" — skipping`);
+                return false;
+            }
+        }
+        else if (config.type === 'oauth') {
+            if (!config.url) {
+                console.warn(`[connectors] oauth connector "${config.name}" missing "url" — skipping`);
+                return false;
+            }
+        }
+        else {
+            if (!config.url) {
+                console.warn(`[connectors] http connector "${config.name}" missing "url" — skipping`);
+                return false;
+            }
+        }
+        return true;
+    }
+    static async _buildConnectorTools(config) {
+        let transport;
+        if (config.type === 'stdio') {
+            transport = new StdioClientTransport({
+                command: config.command,
+                args: config.args,
+                env: config.env,
+                stderr: 'ignore',
+            });
+        }
+        else if (config.type === 'oauth') {
+            // Pre-authorize before connecting.
+            // The SDK only auto-triggers OAuth on 401, but some servers (Figma) return 403
+            // for unauthenticated requests. We drive the flow manually to handle both.
+            const authProvider = new ConnectorOAuthProvider(config.name);
+            const result = await auth(authProvider, {
+                serverUrl: config.url,
+            });
+            if (result === 'REDIRECT') {
+                // Browser was opened — wait for the user to authorize
+                console.log(`[connectors] ${config.name} requires authorization — waiting for browser...`);
+                const code = await waitForOAuthCallback();
+                // Exchange the authorization code for tokens
+                await auth(authProvider, {
+                    serverUrl: config.url,
+                    authorizationCode: code,
+                });
+            }
+            transport = new StreamableHTTPClientTransport(new URL(config.url), {
+                authProvider,
+            });
+        }
+        else {
+            const requestInit = config.token
+                ? { headers: { Authorization: `Bearer ${ConnectorManager.resolveToken(config.token)}` } }
+                : {};
+            transport = new StreamableHTTPClientTransport(new URL(config.url), { requestInit });
+        }
+        const client = new Client({ name: 'studiograph', version: '1.0.0' });
+        await client.connect(transport);
+        const { tools: remoteTools } = await client.listTools();
+        const label = config.description ?? config.name;
+        return remoteTools.map(tool => ({
+            name: `${config.name}__${tool.name}`,
+            label: `${label}: ${tool.title ?? tool.name}`,
+            description: `[${config.name}] ${tool.description ?? tool.name}`,
+            parameters: tool.inputSchema,
+            execute: async (_toolCallId, params) => {
+                try {
+                    const result = await client.callTool({ name: tool.name, arguments: params });
+                    const text = result.content
+                        .filter((c) => c.type === 'text')
+                        .map((c) => c.text)
+                        .join('\n');
+                    return {
+                        content: [{ type: 'text', text: text || JSON.stringify(result, null, 2) }],
+                        details: result,
+                    };
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    return {
+                        content: [{ type: 'text', text: `Error calling ${config.name}__${tool.name}: ${msg}` }],
+                        isError: true,
+                    };
+                }
+            },
+        }));
+    }
+}
+//# sourceMappingURL=connector-manager.js.map

package/dist/mcp/connector-manager.js.map

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

package/dist/mcp/connectors/asana.d.ts

@@ -0,0 +1,2 @@
+import type { ConnectorDefinition } from './definitions.js';
+export declare const asana: ConnectorDefinition;

package/dist/mcp/connectors/asana.js

@@ -0,0 +1,20 @@
+export const asana = {
+    name: 'asana',
+    label: 'Asana',
+    description: 'Asana — tasks, projects, workspaces, team assignments',
+    type: 'stdio',
+    command: 'npx',
+    args: ['-y', '@roychri/mcp-server-asana'],
+    credentialFields: [
+        {
+            key: 'env.ASANA_ACCESS_TOKEN',
+            label: 'Asana personal access token',
+            description: 'My Profile Settings → Apps → Manage Developer Apps → New access token',
+            secret: true,
+            required: true,
+            placeholder: 'your-personal-access-token',
+        },
+    ],
+    docsUrl: 'https://developers.asana.com/docs/personal-access-token',
+};
+//# sourceMappingURL=asana.js.map

package/dist/mcp/connectors/asana.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asana.js","sourceRoot":"","sources":["../../../src/mcp/connectors/asana.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,KAAK,GAAwB;IACxC,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,uDAAuD;IACpE,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,CAAC,IAAI,EAAE,2BAA2B,CAAC;IACzC,gBAAgB,EAAE;QAChB;YACE,GAAG,EAAE,wBAAwB;YAC7B,KAAK,EAAE,6BAA6B;YACpC,WAAW,EAAE,uEAAuE;YACpF,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,4BAA4B;SAC1C;KACF;IACD,OAAO,EAAE,yDAAyD;CACnE,CAAC"}

package/dist/mcp/connectors/definitions.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Connector definitions for the core connector set.
+ *
+ * Each definition specifies the default transport config and the credential
+ * fields to prompt for during interactive `studiograph connector add <name>`.
+ *
+ * Credentials are stored per-user at ~/.studiograph/connectors/<name>.json
+ * (mode 0600 — never committed to git).
+ *
+ * Individual connector definitions live in separate files for modularity.
+ */
+/** A single credential field to prompt for during interactive setup. */
+export interface CredentialField {
+    /**
+     * Dot-path into the connector config where the value is stored.
+     * 'token'          → config.token
+     * 'env.KEY_NAME'   → config.env.KEY_NAME
+     */
+    key: string;
+    /** Display label shown in the interactive prompt */
+    label: string;
+    /** Help text shown below the prompt */
+    description: string;
+    /** Mask input (for tokens/passwords) */
+    secret: boolean;
+    required: boolean;
+    /** Example value shown as placeholder */
+    placeholder?: string;
+}
+export interface ConnectorDefinition {
+    name: string;
+    label: string;
+    description: string;
+    type: 'http' | 'oauth' | 'stdio';
+    /** Pre-filled URL for http connectors */
+    url?: string;
+    /** Pre-filled command for stdio connectors */
+    command?: string;
+    args?: string[];
+    /** Fields to prompt for during interactive setup */
+    credentialFields: CredentialField[];
+    /** Link to connector/API docs shown during setup */
+    docsUrl?: string;
+}
+export declare const CONNECTOR_DEFINITIONS: Record<string, ConnectorDefinition>;

package/dist/mcp/connectors/definitions.js

@@ -0,0 +1,32 @@
+/**
+ * Connector definitions for the core connector set.
+ *
+ * Each definition specifies the default transport config and the credential
+ * fields to prompt for during interactive `studiograph connector add <name>`.
+ *
+ * Credentials are stored per-user at ~/.studiograph/connectors/<name>.json
+ * (mode 0600 — never committed to git).
+ *
+ * Individual connector definitions live in separate files for modularity.
+ */
+import { linear } from './linear.js';
+import { granola } from './granola.js';
+import { slack } from './slack.js';
+import { pipedrive } from './pipedrive.js';
+import { gdrive } from './gdrive.js';
+import { asana } from './asana.js';
+import { figma, figmaRemote } from './figma.js';
+import { obsidian } from './obsidian.js';
+// ── Core connector set ────────────────────────────────────────────────────────
+export const CONNECTOR_DEFINITIONS = {
+    linear,
+    granola,
+    slack,
+    pipedrive,
+    gdrive,
+    asana,
+    figma,
+    'figma-remote': figmaRemote,
+    obsidian,
+};
+//# sourceMappingURL=definitions.js.map

package/dist/mcp/connectors/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../src/mcp/connectors/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAqCzC,iFAAiF;AAEjF,MAAM,CAAC,MAAM,qBAAqB,GAAwC;IACxE,MAAM;IACN,OAAO;IACP,KAAK;IACL,SAAS;IACT,MAAM;IACN,KAAK;IACL,KAAK;IACL,cAAc,EAAE,WAAW;IAC3B,QAAQ;CACT,CAAC"}

package/dist/mcp/connectors/figma.d.ts

@@ -0,0 +1,5 @@
+import type { ConnectorDefinition } from './definitions.js';
+/** Local desktop server — requires Figma desktop app running with Dev Mode MCP enabled. */
+export declare const figma: ConnectorDefinition;
+/** Remote OAuth server — full tool set including generate_figma_design. Requires Figma client approval. */
+export declare const figmaRemote: ConnectorDefinition;

package/dist/mcp/connectors/figma.js

@@ -0,0 +1,21 @@
+/** Local desktop server — requires Figma desktop app running with Dev Mode MCP enabled. */
+export const figma = {
+    name: 'figma',
+    label: 'Figma (desktop)',
+    description: 'Figma — read designs, generate FigJam diagrams, Code Connect mappings (via desktop app)',
+    type: 'http',
+    url: 'http://127.0.0.1:3845/mcp',
+    credentialFields: [],
+    docsUrl: 'https://developers.figma.com/docs/figma-mcp-server/local-server-installation/',
+};
+/** Remote OAuth server — full tool set including generate_figma_design. Requires Figma client approval. */
+export const figmaRemote = {
+    name: 'figma-remote',
+    label: 'Figma (remote)',
+    description: 'Figma — full tool set including design generation (via OAuth)',
+    type: 'oauth',
+    url: 'https://mcp.figma.com/mcp',
+    credentialFields: [],
+    docsUrl: 'https://developers.figma.com/docs/figma-mcp-server/remote-server-installation/',
+};
+//# sourceMappingURL=figma.js.map

package/dist/mcp/connectors/figma.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma.js","sourceRoot":"","sources":["../../../src/mcp/connectors/figma.ts"],"names":[],"mappings":"AAEA,2FAA2F;AAC3F,MAAM,CAAC,MAAM,KAAK,GAAwB;IACxC,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,iBAAiB;IACxB,WAAW,EAAE,yFAAyF;IACtG,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,2BAA2B;IAChC,gBAAgB,EAAE,EAAE;IACpB,OAAO,EAAE,+EAA+E;CACzF,CAAC;AAEF,2GAA2G;AAC3G,MAAM,CAAC,MAAM,WAAW,GAAwB;IAC9C,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE,+DAA+D;IAC5E,IAAI,EAAE,OAAO;IACb,GAAG,EAAE,2BAA2B;IAChC,gBAAgB,EAAE,EAAE;IACpB,OAAO,EAAE,gFAAgF;CAC1F,CAAC"}

package/dist/mcp/connectors/gdrive.d.ts

@@ -0,0 +1,2 @@
+import type { ConnectorDefinition } from './definitions.js';
+export declare const gdrive: ConnectorDefinition;

package/dist/mcp/connectors/gdrive.js

@@ -0,0 +1,20 @@
+export const gdrive = {
+    name: 'gdrive',
+    label: 'Google Drive',
+    description: 'Google Drive — read/write docs, sheets, folders, and file metadata',
+    type: 'stdio',
+    command: 'npx',
+    args: ['-y', '@anthropic-ai/google-docs-mcp@latest'],
+    credentialFields: [
+        {
+            key: 'env.GOOGLE_OAUTH_CREDENTIALS',
+            label: 'Path to Google OAuth credentials JSON',
+            description: 'Download from: Google Cloud Console → APIs & Services → Credentials → OAuth 2.0 Client',
+            secret: false,
+            required: true,
+            placeholder: '~/.config/google/credentials.json',
+        },
+    ],
+    docsUrl: 'https://www.npmjs.com/package/@anthropic-ai/google-docs-mcp',
+};
+//# sourceMappingURL=gdrive.js.map

package/dist/mcp/connectors/gdrive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gdrive.js","sourceRoot":"","sources":["../../../src/mcp/connectors/gdrive.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,MAAM,GAAwB;IACzC,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,cAAc;IACrB,WAAW,EAAE,oEAAoE;IACjF,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,CAAC,IAAI,EAAE,sCAAsC,CAAC;IACpD,gBAAgB,EAAE;QAChB;YACE,GAAG,EAAE,8BAA8B;YACnC,KAAK,EAAE,uCAAuC;YAC9C,WAAW,EAAE,wFAAwF;YACrG,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,mCAAmC;SACjD;KACF;IACD,OAAO,EAAE,6DAA6D;CACvE,CAAC"}

package/dist/mcp/connectors/granola.d.ts

@@ -0,0 +1,2 @@
+import type { ConnectorDefinition } from './definitions.js';
+export declare const granola: ConnectorDefinition;

package/dist/mcp/connectors/granola.js

@@ -0,0 +1,12 @@
+export const granola = {
+    name: 'granola',
+    label: 'Granola',
+    description: 'Granola — search and read AI-summarized meeting notes',
+    type: 'stdio',
+    command: 'npx',
+    args: ['-y', 'granola-mcp'],
+    // No credential fields — Granola reads auth from the installed Granola app
+    credentialFields: [],
+    docsUrl: 'https://granola.ai',
+};
+//# sourceMappingURL=granola.js.map

package/dist/mcp/connectors/granola.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"granola.js","sourceRoot":"","sources":["../../../src/mcp/connectors/granola.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAAwB;IAC1C,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,WAAW,EAAE,uDAAuD;IACpE,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC;IAC3B,2EAA2E;IAC3E,gBAAgB,EAAE,EAAE;IACpB,OAAO,EAAE,oBAAoB;CAC9B,CAAC"}

package/dist/mcp/connectors/linear.d.ts

@@ -0,0 +1,2 @@
+import type { ConnectorDefinition } from './definitions.js';
+export declare const linear: ConnectorDefinition;

package/dist/mcp/connectors/linear.js

@@ -0,0 +1,19 @@
+export const linear = {
+    name: 'linear',
+    label: 'Linear',
+    description: 'Linear issue tracking — create/update issues, search projects',
+    type: 'http',
+    url: 'https://mcp.linear.app/mcp',
+    credentialFields: [
+        {
+            key: 'token',
+            label: 'Linear API key',
+            description: 'Settings → API → Personal API keys → Create key',
+            secret: true,
+            required: true,
+            placeholder: 'lin_api_...',
+        },
+    ],
+    docsUrl: 'https://linear.app/docs/api',
+};
+//# sourceMappingURL=linear.js.map

package/dist/mcp/connectors/linear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear.js","sourceRoot":"","sources":["../../../src/mcp/connectors/linear.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,MAAM,GAAwB;IACzC,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,QAAQ;IACf,WAAW,EAAE,+DAA+D;IAC5E,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,4BAA4B;IACjC,gBAAgB,EAAE;QAChB;YACE,GAAG,EAAE,OAAO;YACZ,KAAK,EAAE,gBAAgB;YACvB,WAAW,EAAE,iDAAiD;YAC9D,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,aAAa;SAC3B;KACF;IACD,OAAO,EAAE,6BAA6B;CACvC,CAAC"}

package/dist/mcp/connectors/obsidian.d.ts

@@ -0,0 +1,2 @@
+import type { ConnectorDefinition } from './definitions.js';
+export declare const obsidian: ConnectorDefinition;

package/dist/mcp/connectors/obsidian.js

@@ -0,0 +1,19 @@
+export const obsidian = {
+    name: 'obsidian',
+    label: 'Obsidian',
+    description: 'Obsidian — read and search vault files via a user-provided MCP server',
+    type: 'stdio',
+    // No command/args — user provides their own MCP server binary
+    credentialFields: [
+        {
+            key: 'env.OBSIDIAN_VAULT',
+            label: 'Path to Obsidian vault',
+            description: 'Absolute path to the vault directory on disk',
+            secret: false,
+            required: false,
+            placeholder: '~/Vaults/MyVault',
+        },
+    ],
+    docsUrl: 'https://obsidian.md',
+};
+//# sourceMappingURL=obsidian.js.map

package/dist/mcp/connectors/obsidian.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"obsidian.js","sourceRoot":"","sources":["../../../src/mcp/connectors/obsidian.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAwB;IAC3C,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,uEAAuE;IACpF,IAAI,EAAE,OAAO;IACb,8DAA8D;IAC9D,gBAAgB,EAAE;QAChB;YACE,GAAG,EAAE,oBAAoB;YACzB,KAAK,EAAE,wBAAwB;YAC/B,WAAW,EAAE,8CAA8C;YAC3D,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,kBAAkB;SAChC;KACF;IACD,OAAO,EAAE,qBAAqB;CAC/B,CAAC"}

package/dist/mcp/connectors/pipedrive.d.ts

@@ -0,0 +1,2 @@
+import type { ConnectorDefinition } from './definitions.js';
+export declare const pipedrive: ConnectorDefinition;

package/dist/mcp/connectors/pipedrive.js

@@ -0,0 +1,20 @@
+export const pipedrive = {
+    name: 'pipedrive',
+    label: 'Pipedrive',
+    description: 'Pipedrive CRM — contacts, deals, activities, pipeline',
+    type: 'stdio',
+    command: 'npx',
+    args: ['-y', '@modelcontextprotocol/server-pipedrive'],
+    credentialFields: [
+        {
+            key: 'env.PIPEDRIVE_API_TOKEN',
+            label: 'Pipedrive API token',
+            description: 'Settings → Personal preferences → API → Your personal API token',
+            secret: true,
+            required: true,
+            placeholder: 'your-api-token',
+        },
+    ],
+    docsUrl: 'https://developers.pipedrive.com/docs/api/v1',
+};
+//# sourceMappingURL=pipedrive.js.map

package/dist/mcp/connectors/pipedrive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipedrive.js","sourceRoot":"","sources":["../../../src/mcp/connectors/pipedrive.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAwB;IAC5C,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,WAAW;IAClB,WAAW,EAAE,uDAAuD;IACpE,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,CAAC,IAAI,EAAE,wCAAwC,CAAC;IACtD,gBAAgB,EAAE;QAChB;YACE,GAAG,EAAE,yBAAyB;YAC9B,KAAK,EAAE,qBAAqB;YAC5B,WAAW,EAAE,iEAAiE;YAC9E,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,gBAAgB;SAC9B;KACF;IACD,OAAO,EAAE,8CAA8C;CACxD,CAAC"}

package/dist/mcp/connectors/slack.d.ts

@@ -0,0 +1,2 @@
+import type { ConnectorDefinition } from './definitions.js';
+export declare const slack: ConnectorDefinition;

package/dist/mcp/connectors/slack.js

@@ -0,0 +1,21 @@
+export const slack = {
+    name: 'slack',
+    label: 'Slack',
+    description: 'Slack — search messages, list channels, post updates',
+    type: 'stdio',
+    command: 'npx',
+    args: ['-y', '@modelcontextprotocol/server-slack'],
+    credentialFields: [
+        {
+            key: 'env.SLACK_BOT_TOKEN',
+            label: 'Slack token',
+            description: 'Bot token (xoxb-...) or User OAuth token (xoxp-...). ' +
+                'Create at: api.slack.com/apps → OAuth & Permissions',
+            secret: true,
+            required: true,
+            placeholder: 'xoxb-...',
+        },
+    ],
+    docsUrl: 'https://api.slack.com/authentication/token-types',
+};
+//# sourceMappingURL=slack.js.map

package/dist/mcp/connectors/slack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.js","sourceRoot":"","sources":["../../../src/mcp/connectors/slack.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,KAAK,GAAwB;IACxC,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,sDAAsD;IACnE,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,CAAC,IAAI,EAAE,oCAAoC,CAAC;IAClD,gBAAgB,EAAE;QAChB;YACE,GAAG,EAAE,qBAAqB;YAC1B,KAAK,EAAE,aAAa;YACpB,WAAW,EAAE,uDAAuD;gBAClE,qDAAqD;YACvD,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,UAAU;SACxB;KACF;IACD,OAAO,EAAE,kDAAkD;CAC5D,CAAC"}

package/dist/mcp/oauth-provider.d.ts

@@ -0,0 +1,41 @@
+/**
+ * OAuth Client Provider for MCP Connectors
+ *
+ * Implements OAuthClientProvider from the MCP SDK to support OAuth-based
+ * MCP servers (Figma, Linear, etc.) using dynamic client registration.
+ *
+ * Storage: ~/.studiograph/connectors/<name>.oauth.json (tokens, client info, PKCE verifier)
+ * Auth flow: opens browser → local callback server → exchanges code for tokens
+ *
+ * Works with any MCP server that supports RFC 8414 (OAuth metadata discovery)
+ * and RFC 7591 (dynamic client registration). No pre-registered client secrets needed.
+ */
+import type { OAuthClientProvider } from '@modelcontextprotocol/sdk/client/auth.js';
+import type { OAuthClientMetadata, OAuthClientInformationMixed, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
+/**
+ * File-backed OAuth provider for a single connector.
+ * Stores tokens and client info alongside the connector config.
+ */
+export declare class ConnectorOAuthProvider implements OAuthClientProvider {
+    private connectorName;
+    private storagePath;
+    constructor(connectorName: string);
+    get redirectUrl(): URL;
+    get clientMetadata(): OAuthClientMetadata;
+    clientInformation(): Promise<OAuthClientInformationMixed | undefined>;
+    saveClientInformation(info: OAuthClientInformationMixed): Promise<void>;
+    tokens(): Promise<OAuthTokens | undefined>;
+    saveTokens(tokens: OAuthTokens): Promise<void>;
+    redirectToAuthorization(authorizationUrl: URL): Promise<void>;
+    saveCodeVerifier(codeVerifier: string): Promise<void>;
+    codeVerifier(): Promise<string>;
+    invalidateCredentials(scope: 'all' | 'client' | 'tokens' | 'verifier'): Promise<void>;
+    private _load;
+    private _save;
+}
+/**
+ * Start a temporary local HTTP server to receive the OAuth callback.
+ * Returns a promise that resolves with the authorization code.
+ * Server auto-closes after receiving the callback or timing out.
+ */
+export declare function waitForOAuthCallback(timeoutMs?: number): Promise<string>;