studiograph 1.1.3 → 1.2.0-beta.10

package/dist/mcp/connectors/definitions.js

@@ -6,135 +6,27 @@
  *
  * 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: {
-        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',
-    },
-    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',
-    },
-    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',
-    },
-    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',
-    },
-    gdrive: {
-        name: 'gdrive',
-        label: 'Google Drive',
-        description: 'Google Drive — search and read files, docs, sheets, slides',
-        type: 'stdio',
-        command: 'npx',
-        args: ['-y', '@modelcontextprotocol/server-gdrive'],
-        // OAuth flow required — credentials come from GDRIVE_CREDENTIALS_FILE env var
-        // pointing to an OAuth2 client_secret.json downloaded from Google Cloud Console.
-        // See docsUrl for setup steps.
-        credentialFields: [
-            {
-                key: 'env.GDRIVE_CREDENTIALS_FILE',
-                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://github.com/modelcontextprotocol/servers/tree/main/src/gdrive',
-    },
-    asana: {
-        name: 'asana',
-        label: 'Asana',
-        description: 'Asana — tasks, projects, workspaces, team assignments',
-        type: 'stdio',
-        command: 'npx',
-        args: ['-y', 'asana-mcp'],
-        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',
-    },
-    figma: {
-        name: 'figma',
-        label: 'Figma',
-        description: 'Figma — read files, components, variables, design tokens',
-        type: 'http',
-        url: 'https://mcp.figma.com/mcp',
-        credentialFields: [
-            {
-                key: 'token',
-                label: 'Figma personal access token',
-                description: 'Settings → Account → Personal access tokens → Generate new token',
-                secret: true,
-                required: true,
-                placeholder: 'figd_...',
-            },
-        ],
-        docsUrl: 'https://www.figma.com/developers/api#access-tokens',
-    },
+    linear,
+    granola,
+    slack,
+    pipedrive,
+    gdrive,
+    asana,
+    figma,
+    'figma-remote': figmaRemote,
+    obsidian,
 };
 //# sourceMappingURL=definitions.js.map

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

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

package/dist/mcp/oauth-provider.js

@@ -0,0 +1,160 @@
+/**
+ * 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 { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { createServer } from 'http';
+import { CONNECTORS_DIR } from './connector-manager.js';
+const CALLBACK_PORT = 38741; // Fixed port for OAuth callbacks
+const CALLBACK_PATH = '/oauth/callback';
+const REDIRECT_URI = `http://localhost:${CALLBACK_PORT}${CALLBACK_PATH}`;
+/**
+ * File-backed OAuth provider for a single connector.
+ * Stores tokens and client info alongside the connector config.
+ */
+export class ConnectorOAuthProvider {
+    connectorName;
+    storagePath;
+    constructor(connectorName) {
+        this.connectorName = connectorName;
+        this.storagePath = join(CONNECTORS_DIR, `${connectorName}.oauth.json`);
+    }
+    get redirectUrl() {
+        return new URL(REDIRECT_URI);
+    }
+    get clientMetadata() {
+        return {
+            redirect_uris: [REDIRECT_URI],
+            client_name: 'Studiograph',
+            grant_types: ['authorization_code', 'refresh_token'],
+            response_types: ['code'],
+            token_endpoint_auth_method: 'none', // public client — no secret
+        };
+    }
+    async clientInformation() {
+        return this._load().clientInfo;
+    }
+    async saveClientInformation(info) {
+        const data = this._load();
+        data.clientInfo = info;
+        this._save(data);
+    }
+    async tokens() {
+        return this._load().tokens;
+    }
+    async saveTokens(tokens) {
+        const data = this._load();
+        data.tokens = tokens;
+        this._save(data);
+    }
+    async redirectToAuthorization(authorizationUrl) {
+        // Open browser to authorization URL
+        const { exec } = await import('child_process');
+        const url = authorizationUrl.toString();
+        const platform = process.platform;
+        if (platform === 'darwin') {
+            exec(`open "${url}"`);
+        }
+        else if (platform === 'win32') {
+            exec(`start "" "${url}"`);
+        }
+        else {
+            exec(`xdg-open "${url}"`);
+        }
+        console.log(`[connectors] Opening browser for ${this.connectorName} authorization...`);
+    }
+    async saveCodeVerifier(codeVerifier) {
+        const data = this._load();
+        data.codeVerifier = codeVerifier;
+        this._save(data);
+    }
+    async codeVerifier() {
+        const data = this._load();
+        return data.codeVerifier ?? '';
+    }
+    async invalidateCredentials(scope) {
+        const data = this._load();
+        if (scope === 'all' || scope === 'tokens')
+            data.tokens = undefined;
+        if (scope === 'all' || scope === 'client')
+            data.clientInfo = undefined;
+        if (scope === 'all' || scope === 'verifier')
+            data.codeVerifier = undefined;
+        this._save(data);
+    }
+    // ── storage helpers ──────────────────────────────────────────────────────
+    _load() {
+        if (!existsSync(this.storagePath))
+            return {};
+        try {
+            return JSON.parse(readFileSync(this.storagePath, 'utf-8'));
+        }
+        catch {
+            return {};
+        }
+    }
+    _save(data) {
+        mkdirSync(CONNECTORS_DIR, { recursive: true });
+        writeFileSync(this.storagePath, JSON.stringify(data, null, 2) + '\n', { mode: 0o600 });
+    }
+}
+// ── Callback server ──────────────────────────────────────────────────────────
+/**
+ * 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 function waitForOAuthCallback(timeoutMs = 120_000) {
+    return new Promise((resolve, reject) => {
+        let server;
+        const timeout = setTimeout(() => {
+            server?.close();
+            reject(new Error('OAuth callback timed out (2 minutes)'));
+        }, timeoutMs);
+        server = createServer((req, res) => {
+            const url = new URL(req.url ?? '/', `http://localhost:${CALLBACK_PORT}`);
+            if (url.pathname !== CALLBACK_PATH) {
+                res.writeHead(404);
+                res.end('Not found');
+                return;
+            }
+            const code = url.searchParams.get('code');
+            const error = url.searchParams.get('error');
+            if (error) {
+                res.writeHead(200, { 'Content-Type': 'text/html' });
+                res.end(`<html><body><h2>Authorization failed</h2><p>${error}</p><p>You can close this tab.</p></body></html>`);
+                clearTimeout(timeout);
+                server.close();
+                reject(new Error(`OAuth authorization denied: ${error}`));
+                return;
+            }
+            if (!code) {
+                res.writeHead(400, { 'Content-Type': 'text/html' });
+                res.end('<html><body><h2>Missing authorization code</h2><p>You can close this tab.</p></body></html>');
+                return;
+            }
+            res.writeHead(200, { 'Content-Type': 'text/html' });
+            res.end('<html><body><h2>Authorization successful</h2><p>You can close this tab and return to Studiograph.</p></body></html>');
+            clearTimeout(timeout);
+            server.close();
+            resolve(code);
+        });
+        server.listen(CALLBACK_PORT, () => {
+            // Server ready — browser will be opened by redirectToAuthorization()
+        });
+        server.on('error', (err) => {
+            clearTimeout(timeout);
+            reject(new Error(`Failed to start OAuth callback server: ${err.message}`));
+        });
+    });
+}
+//# sourceMappingURL=oauth-provider.js.map

package/dist/mcp/oauth-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-provider.js","sourceRoot":"","sources":["../../src/mcp/oauth-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAe,MAAM,MAAM,CAAC;AASjD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,iCAAiC;AAC9D,MAAM,aAAa,GAAG,iBAAiB,CAAC;AACxC,MAAM,YAAY,GAAG,oBAAoB,aAAa,GAAG,aAAa,EAAE,CAAC;AAQzE;;;GAGG;AACH,MAAM,OAAO,sBAAsB;IAGb;IAFZ,WAAW,CAAS;IAE5B,YAAoB,aAAqB;QAArB,kBAAa,GAAb,aAAa,CAAQ;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,GAAG,aAAa,aAAa,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,cAAc;QAChB,OAAO;YACL,aAAa,EAAE,CAAC,YAAY,CAAC;YAC7B,WAAW,EAAE,aAAa;YAC1B,WAAW,EAAE,CAAC,oBAAoB,EAAE,eAAe,CAAC;YACpD,cAAc,EAAE,CAAC,MAAM,CAAC;YACxB,0BAA0B,EAAE,MAAM,EAAE,4BAA4B;SACjE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,UAAU,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,IAAiC;QAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAmB;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,uBAAuB,CAAC,gBAAqB;QACjD,oCAAoC;QACpC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAC;QAExC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClC,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1B,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC;QACxB,CAAC;aAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YAChC,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,oCAAoC,IAAI,CAAC,aAAa,mBAAmB,CAAC,CAAC;IACzF,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,YAAoB;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,KAA+C;QACzE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,QAAQ;YAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACnE,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,QAAQ;YAAE,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QACvE,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,UAAU;YAAE,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAC3E,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,4EAA4E;IAEpE,KAAK;QACX,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC;YAAE,OAAO,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAqB;QACjC,SAAS,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzF,CAAC;CACF;AAED,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAS,GAAG,OAAO;IACtD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAc,CAAC;QAEnB,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,MAAM,EAAE,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC,CAAC;QAC5D,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,MAAM,GAAG,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACjC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,oBAAoB,aAAa,EAAE,CAAC,CAAC;YAEzE,IAAI,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;gBACnC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBACnB,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YAED,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAE5C,IAAI,KAAK,EAAE,CAAC;gBACV,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;gBACpD,GAAG,CAAC,GAAG,CAAC,+CAA+C,KAAK,kDAAkD,CAAC,CAAC;gBAChH,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,MAAM,CAAC,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC1D,OAAO;YACT,CAAC;YAED,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;gBACpD,GAAG,CAAC,GAAG,CAAC,6FAA6F,CAAC,CAAC;gBACvG,OAAO;YACT,CAAC;YAED,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;YACpD,GAAG,CAAC,GAAG,CAAC,qHAAqH,CAAC,CAAC;YAC/H,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,EAAE;YAChC,qEAAqE;QACvE,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACzB,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,MAAM,CAAC,IAAI,KAAK,CAAC,0CAA0C,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC7E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}