studiograph 1.3.3-next.9 → 1.3.4

package/dist/integrations/linear.js

@@ -0,0 +1,70 @@
+export const linear = {
+    name: 'linear',
+    connector: {
+        url: 'https://mcp.linear.app/mcp',
+        description: 'Linear issue tracker',
+        auth: 'oauth',
+    },
+    source: {
+        connector: 'linear',
+        filter_fields: [
+            {
+                key: 'project',
+                label: 'Project',
+                placeholder: 'e.g. My Project',
+                type: 'text',
+                mode: 'client',
+                fields: ['project', 'name'],
+                op: 'contains',
+            },
+        ],
+        entities: {
+            task: {
+                source_type: 'issue',
+                primary: true,
+                id_from: 'title',
+                content_from: 'description',
+                fetch_details: true,
+                field_map: {
+                    'title': 'name',
+                    'assignee': { field: 'assignee', transform: 'wikilink' },
+                    'dueDate': 'due_date',
+                    'project': { field: 'project', transform: 'wikilink' },
+                    'labels': { field: 'tags', transform: 'direct', subfield: 'name' },
+                    'url': 'url',
+                    'identifier': 'external_id',
+                },
+                status_map: {
+                    'Backlog': 'open',
+                    'Todo': 'open',
+                    'In Progress': 'in-progress',
+                    'In Review': 'in-progress',
+                    'Done': 'done',
+                    'Canceled': 'cancelled',
+                    'Duplicate': 'cancelled',
+                },
+            },
+            project: {
+                source_type: 'project',
+                id_from: 'name',
+                content_from: 'description',
+                field_map: {
+                    'name': 'name',
+                    'startDate': 'start_date',
+                    'targetDate': 'target_completion',
+                    'lead': { field: 'lead', transform: 'wikilink' },
+                    'url': 'url',
+                },
+                status_map: {
+                    'Backlog': 'planning',
+                    'Planned': 'planning',
+                    'Started': 'active',
+                    'Paused': 'on-hold',
+                    'Completed': 'completed',
+                    'Canceled': 'archived',
+                },
+            },
+        },
+    },
+};
+//# sourceMappingURL=linear.js.map

package/dist/integrations/linear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear.js","sourceRoot":"","sources":["../../src/integrations/linear.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,MAAM,GAAgB;IACjC,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE;QACT,GAAG,EAAE,4BAA4B;QACjC,WAAW,EAAE,sBAAsB;QACnC,IAAI,EAAE,OAAO;KACd;IACD,MAAM,EAAE;QACN,SAAS,EAAE,QAAQ;QACnB,aAAa,EAAE;YACb;gBACE,GAAG,EAAE,SAAS;gBACd,KAAK,EAAE,SAAS;gBAChB,WAAW,EAAE,iBAAiB;gBAC9B,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC;gBAC3B,EAAE,EAAE,UAAU;aACf;SACF;QACD,QAAQ,EAAE;YACR,IAAI,EAAE;gBACJ,WAAW,EAAE,OAAO;gBACpB,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,OAAO;gBAChB,YAAY,EAAE,aAAa;gBAC3B,aAAa,EAAE,IAAI;gBACnB,SAAS,EAAE;oBACT,OAAO,EAAE,MAAM;oBACf,UAAU,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE;oBACxD,SAAS,EAAE,UAAU;oBACrB,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE;oBACtD,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE;oBAClE,KAAK,EAAE,KAAK;oBACZ,YAAY,EAAE,aAAa;iBAC5B;gBACD,UAAU,EAAE;oBACV,SAAS,EAAE,MAAM;oBACjB,MAAM,EAAE,MAAM;oBACd,aAAa,EAAE,aAAa;oBAC5B,WAAW,EAAE,aAAa;oBAC1B,MAAM,EAAE,MAAM;oBACd,UAAU,EAAE,WAAW;oBACvB,WAAW,EAAE,WAAW;iBACzB;aACF;YACD,OAAO,EAAE;gBACP,WAAW,EAAE,SAAS;gBACtB,OAAO,EAAE,MAAM;gBACf,YAAY,EAAE,aAAa;gBAC3B,SAAS,EAAE;oBACT,MAAM,EAAE,MAAM;oBACd,WAAW,EAAE,YAAY;oBACzB,YAAY,EAAE,mBAAmB;oBACjC,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE;oBAChD,KAAK,EAAE,KAAK;iBACb;gBACD,UAAU,EAAE;oBACV,SAAS,EAAE,UAAU;oBACrB,SAAS,EAAE,UAAU;oBACrB,SAAS,EAAE,QAAQ;oBACnB,QAAQ,EAAE,SAAS;oBACnB,WAAW,EAAE,WAAW;oBACxB,UAAU,EAAE,UAAU;iBACvB;aACF;SACF;KACF;CACF,CAAC"}

package/dist/integrations/paper-local.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Paper — local design tool MCP connector.
+ *
+ * Agent:  MCP via localhost:29979 (no auth, requires Paper desktop app running)
+ *         Paper is a professional UI design tool. The MCP server provides tools for
+ *         reading designs, creating artboards, writing HTML, and managing styles.
+ *
+ * Sync:   None — design tool, interactive use only.
+ *
+ * Note: The port (29979) is determined by the Paper app, not configurable.
+ * Connection will fail gracefully if the app is not running.
+ */
+import type { Integration } from './types.js';
+export declare const paper: Integration;

package/dist/integrations/paper-local.js

@@ -0,0 +1,10 @@
+export const paper = {
+    name: 'paper',
+    connector: {
+        url: 'http://127.0.0.1:29979/mcp',
+        description: 'Paper design tool (local)',
+        auth: 'none',
+    },
+    // No sync source — Paper is a local design tool for interactive use only
+};
+//# sourceMappingURL=paper-local.js.map

package/dist/integrations/paper-local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paper-local.js","sourceRoot":"","sources":["../../src/integrations/paper-local.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,KAAK,GAAgB;IAChC,IAAI,EAAE,OAAO;IACb,SAAS,EAAE;QACT,GAAG,EAAE,4BAA4B;QACjC,WAAW,EAAE,2BAA2B;QACxC,IAAI,EAAE,MAAM;KACb;IACD,yEAAyE;CAC1E,CAAC"}

package/dist/integrations/paper.d.ts

@@ -0,0 +1,2 @@
+import type { Integration } from './types.js';
+export declare const paper: Integration;

package/dist/integrations/paper.js

@@ -0,0 +1,10 @@
+export const paper = {
+    name: 'paper',
+    connector: {
+        url: 'http://127.0.0.1:29979/mcp',
+        description: 'Paper design tool',
+        auth: 'none',
+    },
+    // No sync source — Paper is a local design tool for interactive use only
+};
+//# sourceMappingURL=paper.js.map

package/dist/integrations/paper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paper.js","sourceRoot":"","sources":["../../src/integrations/paper.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,KAAK,GAAgB;IAChC,IAAI,EAAE,OAAO;IACb,SAAS,EAAE;QACT,GAAG,EAAE,4BAA4B;QACjC,WAAW,EAAE,mBAAmB;QAChC,IAAI,EAAE,MAAM;KACb;IACD,yEAAyE;CAC1E,CAAC"}

package/dist/integrations/pipedrive.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Pipedrive — CRM integration.
+ *
+ * Agent:  MCP via mcp.pipedrive.com (OAuth, pre-registered app required)
+ *         OAuth app registered at developers.pipedrive.com.
+ *         Callback: https://auth.studiograph.com/callback/pipedrive
+ *         Env: PIPEDRIVE_CLIENT_SECRET
+ *         Custom OAuth endpoints required — Pipedrive's MCP server returns 500 on
+ *         .well-known discovery, so we provide synthetic metadata via createOAuthFetch().
+ *
+ * Sync:   REST adapter via api.pipedrive.com/v1 (API token as query param)
+ *         Env: PIPEDRIVE_API_TOKEN (personal API token from Settings > Personal > API)
+ *         The API token is separate from MCP OAuth — both can coexist.
+ *
+ * Entities: deal (primary), person, organization
+ * Filters:  status (server-side: open/won/lost/all_not_deleted),
+ *           filter_id (server-side: saved Pipedrive filter ID)
+ *
+ * Deal notes: Fetched via content_tool (/notes?deal_id=...). HTML content is
+ * converted to markdown (headings, bold, italic, links, lists). Deals without
+ * notes get metadata-only entities.
+ *
+ * Pagination: Offset-based (start/limit), max 500 per page, page_size set to 100.
+ */
+import type { Integration } from './types.js';
+export declare const pipedrive: Integration;

package/dist/integrations/pipedrive.js

@@ -0,0 +1,97 @@
+export const pipedrive = {
+    name: 'pipedrive',
+    connector: {
+        url: 'https://mcp.pipedrive.com/mcp',
+        description: 'Pipedrive CRM',
+        auth: 'oauth',
+        oauth: {
+            client_id: '9a3dbc40a7b5ce9d',
+            client_secret_env: 'PIPEDRIVE_CLIENT_SECRET',
+            authorization_endpoint: 'https://oauth.pipedrive.com/oauth/authorize',
+            token_endpoint: 'https://oauth.pipedrive.com/oauth/token',
+        },
+    },
+    source: {
+        connector: 'pipedrive',
+        adapter: 'rest',
+        rest: {
+            base_url: 'https://api.pipedrive.com/v1',
+            query_auth: { api_token: '$PIPEDRIVE_API_TOKEN' },
+        },
+        filter_fields: [
+            {
+                key: 'status',
+                label: 'Deal status',
+                placeholder: 'open, won, lost, or all_not_deleted',
+                type: 'text',
+                mode: 'server',
+            },
+            // To use a saved filter: Pipedrive > Deals > Filter icon > + Add new filter > Save.
+            // The filter ID appears in the URL (?filter_id=123) or via GET /v1/filters?type=deals.
+            // Set visibility to "shared" so the filter works regardless of which user's API token is used.
+            {
+                key: 'filter_id',
+                label: 'Pipedrive filter ID',
+                placeholder: 'Saved filter ID (e.g. 1068)',
+                type: 'text',
+                mode: 'server',
+            },
+        ],
+        entities: {
+            deal: {
+                source_type: 'deal',
+                primary: true,
+                list_endpoint: '/deals',
+                detail_endpoint: '/deals/{id}',
+                pagination: 'offset',
+                page_size: 100,
+                id_from: 'title',
+                field_map: {
+                    'title': 'name',
+                    'value': 'deal_value',
+                    'org_name': { field: 'client', transform: 'wikilink' },
+                    'person_name': { field: 'contacts', transform: 'wikilink-array' },
+                    'expected_close_date': 'expected_close',
+                    'add_time': { field: 'date', transform: 'date-iso' },
+                    'lost_reason': 'lost_reason',
+                },
+                status_map: {
+                    'open': 'scoping',
+                    'won': 'won',
+                    'lost': 'lost',
+                },
+                content_tool: {
+                    tool: '/notes',
+                    id_param: 'deal_id',
+                    id_from: 'id',
+                    content_field: 'content',
+                },
+            },
+            person: {
+                list_endpoint: '/persons',
+                detail_endpoint: '/persons/{id}',
+                pagination: 'offset',
+                page_size: 100,
+                id_from: 'name',
+                field_map: {
+                    'name': 'name',
+                    'org_name': { field: 'organization', transform: 'wikilink' },
+                    'owner_name': { field: 'owner', transform: 'wikilink' },
+                },
+            },
+            organization: {
+                list_endpoint: '/organizations',
+                detail_endpoint: '/organizations/{id}',
+                pagination: 'offset',
+                page_size: 100,
+                id_from: 'name',
+                field_map: {
+                    'name': 'name',
+                    'address': 'address',
+                    'owner_name': { field: 'owner', transform: 'wikilink' },
+                },
+            },
+        },
+    },
+};
+//# sourceMappingURL=pipedrive.js.map

package/dist/integrations/pipedrive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipedrive.js","sourceRoot":"","sources":["../../src/integrations/pipedrive.ts"],"names":[],"mappings":"AA0BA,MAAM,CAAC,MAAM,SAAS,GAAgB;IACpC,IAAI,EAAE,WAAW;IACjB,SAAS,EAAE;QACT,GAAG,EAAE,+BAA+B;QACpC,WAAW,EAAE,eAAe;QAC5B,IAAI,EAAE,OAAO;QACb,KAAK,EAAE;YACL,SAAS,EAAE,kBAAkB;YAC7B,iBAAiB,EAAE,yBAAyB;YAC5C,sBAAsB,EAAE,6CAA6C;YACrE,cAAc,EAAE,yCAAyC;SAC1D;KACF;IACD,MAAM,EAAE;QACN,SAAS,EAAE,WAAW;QACtB,OAAO,EAAE,MAAM;QACf,IAAI,EAAE;YACJ,QAAQ,EAAE,8BAA8B;YACxC,UAAU,EAAE,EAAE,SAAS,EAAE,sBAAsB,EAAE;SAClD;QACD,aAAa,EAAE;YACb;gBACE,GAAG,EAAE,QAAQ;gBACb,KAAK,EAAE,aAAa;gBACpB,WAAW,EAAE,qCAAqC;gBAClD,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,QAAQ;aACf;YACD,oFAAoF;YACpF,uFAAuF;YACvF,+FAA+F;YAC/F;gBACE,GAAG,EAAE,WAAW;gBAChB,KAAK,EAAE,qBAAqB;gBAC5B,WAAW,EAAE,6BAA6B;gBAC1C,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,QAAQ;aACf;SACF;QACD,QAAQ,EAAE;YACR,IAAI,EAAE;gBACJ,WAAW,EAAE,MAAM;gBACnB,OAAO,EAAE,IAAI;gBACb,aAAa,EAAE,QAAQ;gBACvB,eAAe,EAAE,aAAa;gBAC9B,UAAU,EAAE,QAAQ;gBACpB,SAAS,EAAE,GAAG;gBACd,OAAO,EAAE,OAAO;gBAChB,SAAS,EAAE;oBACT,OAAO,EAAE,MAAM;oBACf,OAAO,EAAE,YAAY;oBACrB,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE;oBACtD,aAAa,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE;oBACjE,qBAAqB,EAAE,gBAAgB;oBACvC,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE;oBACpD,aAAa,EAAE,aAAa;iBAC7B;gBACD,UAAU,EAAE;oBACV,MAAM,EAAE,SAAS;oBACjB,KAAK,EAAE,KAAK;oBACZ,MAAM,EAAE,MAAM;iBACf;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,IAAI;oBACb,aAAa,EAAE,SAAS;iBACzB;aACF;YACD,MAAM,EAAE;gBACN,aAAa,EAAE,UAAU;gBACzB,eAAe,EAAE,eAAe;gBAChC,UAAU,EAAE,QAAQ;gBACpB,SAAS,EAAE,GAAG;gBACd,OAAO,EAAE,MAAM;gBACf,SAAS,EAAE;oBACT,MAAM,EAAE,MAAM;oBACd,UAAU,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE;oBAC5D,YAAY,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE;iBACxD;aACF;YACD,YAAY,EAAE;gBACZ,aAAa,EAAE,gBAAgB;gBAC/B,eAAe,EAAE,qBAAqB;gBACtC,UAAU,EAAE,QAAQ;gBACpB,SAAS,EAAE,GAAG;gBACd,OAAO,EAAE,MAAM;gBACf,SAAS,EAAE;oBACT,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,SAAS;oBACpB,YAAY,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE;iBACxD;aACF;SACF;KACF;CACF,CAAC"}

package/dist/integrations/registry.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Integration registry — single source of truth for all built-in connectors.
+ *
+ * Derives KNOWN_CONNECTORS and SOURCE_DEFINITIONS from the integration modules.
+ * To add a new integration: create a file in src/integrations/, import it here.
+ */
+import type { Integration, ConnectorSpec } from './types.js';
+import type { SourceDefinition } from '../services/sync/types.js';
+export declare const INTEGRATIONS: Integration[];
+/** MCP connector configs, keyed by name. Used for pre-listed connectors in the UI. */
+export declare const KNOWN_CONNECTORS: Record<string, ConnectorSpec>;
+/** Built-in sync source definitions, keyed by name. Only integrations with a source. */
+export declare const SOURCE_DEFINITIONS: Record<string, SourceDefinition>;
+export type { Integration, ConnectorSpec } from './types.js';
+export type { SourceDefinition };

package/dist/integrations/registry.js

@@ -0,0 +1,27 @@
+/**
+ * Integration registry — single source of truth for all built-in connectors.
+ *
+ * Derives KNOWN_CONNECTORS and SOURCE_DEFINITIONS from the integration modules.
+ * To add a new integration: create a file in src/integrations/, import it here.
+ */
+import { linear } from './linear.js';
+import { granola } from './granola.js';
+import { asana } from './asana.js';
+import { figma } from './figma.js';
+import { figmaDesktop } from './figma-local.js';
+import { pipedrive } from './pipedrive.js';
+import { paper } from './paper-local.js';
+export const INTEGRATIONS = [
+    linear,
+    granola,
+    asana,
+    figma,
+    figmaDesktop,
+    pipedrive,
+    paper,
+];
+/** MCP connector configs, keyed by name. Used for pre-listed connectors in the UI. */
+export const KNOWN_CONNECTORS = Object.fromEntries(INTEGRATIONS.map(i => [i.name, i.connector]));
+/** Built-in sync source definitions, keyed by name. Only integrations with a source. */
+export const SOURCE_DEFINITIONS = Object.fromEntries(INTEGRATIONS.filter(i => i.source).map(i => [i.name, i.source]));
+//# sourceMappingURL=registry.js.map

package/dist/integrations/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/integrations/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,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,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,MAAM,CAAC,MAAM,YAAY,GAAkB;IACzC,MAAM;IACN,OAAO;IACP,KAAK;IACL,KAAK;IACL,YAAY;IACZ,SAAS;IACT,KAAK;CACN,CAAC;AAEF,sFAAsF;AACtF,MAAM,CAAC,MAAM,gBAAgB,GAC3B,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAEnE,wFAAwF;AACxF,MAAM,CAAC,MAAM,kBAAkB,GAC7B,MAAM,CAAC,WAAW,CAChB,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAO,CAAC,CAAC,CACjE,CAAC"}

package/dist/integrations/types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Integration — a single file defines everything about a third-party connector:
+ * MCP config, sync source definition, and metadata.
+ *
+ * The registry auto-collects all integrations and derives KNOWN_CONNECTORS
+ * and SOURCE_DEFINITIONS from them.
+ */
+import type { SourceDefinition } from '../services/sync/types.js';
+/** Pre-registered OAuth app credentials for connectors that don't support dynamic client registration. */
+export interface OAuthAppConfig {
+    /** OAuth client ID (public — safe to bake into code) */
+    client_id: string;
+    /** Env var name containing the client secret (e.g. 'PIPEDRIVE_CLIENT_SECRET') */
+    client_secret_env?: string;
+    /** Override authorization endpoint (when provider uses a different domain than the MCP server) */
+    authorization_endpoint?: string;
+    /** Override token endpoint */
+    token_endpoint?: string;
+}
+export interface ConnectorSpec {
+    url: string;
+    description: string;
+    auth: 'oauth' | 'none';
+    /** Pre-registered OAuth app credentials. Required for providers that don't support dynamic client registration. */
+    oauth?: OAuthAppConfig;
+}
+export interface Integration {
+    /** Unique name used as connector/source key (e.g. 'linear', 'granola') */
+    name: string;
+    /** MCP connector config */
+    connector: ConnectorSpec;
+    /** Sync source definition (optional — some connectors don't have sync, e.g. Paper) */
+    source?: SourceDefinition;
+}

package/dist/integrations/types.js

@@ -0,0 +1,9 @@
+/**
+ * Integration — a single file defines everything about a third-party connector:
+ * MCP config, sync source definition, and metadata.
+ *
+ * The registry auto-collects all integrations and derives KNOWN_CONNECTORS
+ * and SOURCE_DEFINITIONS from them.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/integrations/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/integrations/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/mcp/connector-manager.d.ts

@@ -4,54 +4,65 @@
  * Connects the Studiograph agent to third-party MCP servers so the agent can
  * query external data sources on demand.
  *
- * Three transport types are supported:
+ * Only HTTP transport is supported (Streamable HTTP). Connectors are configured
+ * with a URL and optional headers — same format as Cursor/Claude Code MCP configs.
  *
- *   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.
+ * Two-layer config:
  *
- *   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.
+ *   Workspace layer (.studiograph/connectors/<name>.json)
+ *     Non-secret transport config committed to git. Secrets replaced with
+ *     $ENV_VAR placeholders resolved at runtime.
  *
- *   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).
+ *   Homedir layer (~/.studiograph/connectors/<name>.json)
+ *     Full config with literal secrets (mode 0600, never committed).
+ *     When present, homedir fields override workspace fields.
  *
  * Each connector's tools are injected into the agent with a namespaced prefix:
- *   linear__search_issues, granola__list_meetings, etc.
+ *   linear__search_issues, etc.
  *
  * Connection failures are non-fatal — the failing connector is skipped with a warning.
  */
 export declare const CONNECTORS_DIR: string;
-export type ConnectorType = 'http' | 'oauth' | 'stdio';
 export interface ConnectorConfig {
     /** Unique name used as the tool prefix (e.g. "linear" → "linear__search_issues") */
     name: string;
-    /** Transport type — defaults to "http" if `url` is present, "stdio" if `command` is present */
-    type?: ConnectorType;
+    /** Remote MCP server URL */
+    url: string;
+    /** HTTP headers (e.g. { "Authorization": "Bearer ..." }) */
+    headers?: Record<string, string>;
     /** Human-readable description shown in tool labels */
     description?: string;
-    /** Remote MCP server URL (http type) */
-    url?: string;
-    /** Bearer token or $ENV_VAR reference (http type) */
-    token?: string;
-    /** Executable to spawn (stdio type) */
-    command?: string;
-    /** Arguments passed to the command (stdio type) */
-    args?: string[];
-    /** Extra environment variables for the child process (stdio type) */
-    env?: Record<string, string>;
+    /** Auth mode: 'oauth' uses per-user OAuth tokens, 'headers' uses manual headers, 'none' for local connectors */
+    auth?: 'headers' | 'oauth' | 'none';
 }
+/** Pre-listed connectors — derived from integration registry. */
+export { KNOWN_CONNECTORS } from '../integrations/registry.js';
 export declare class ConnectorManager {
-    static loadConfigs(): ConnectorConfig[];
+    /**
+     * Load all connector configs, merging workspace + homedir layers.
+     * When workspacePath is provided, reads .studiograph/connectors/ first,
+     * then overlays homedir configs (homedir fields win).
+     */
+    static loadConfigs(workspacePath?: string): ConnectorConfig[];
+    /**
+     * Load connector configs from workspace .studiograph/connectors/ only.
+     * Used by the config bundle export endpoint.
+     */
+    static loadWorkspaceConfigs(workspacePath: string): ConnectorConfig[];
+    /** Save full config to homedir (mode 0600, never committed). */
     static saveConfig(config: ConnectorConfig): void;
-    static removeConfig(name: string): boolean;
+    /** Save sanitized config to workspace .studiograph/connectors/ (git-tracked). */
+    static saveWorkspaceConfig(config: ConnectorConfig, workspacePath: string): void;
+    static removeConfig(name: string, workspacePath?: string): boolean;
+    /** Load a single connector, merging workspace + homedir layers. */
+    static loadConfig(name: string, workspacePath?: string): ConnectorConfig | null;
+    /**
+     * Strip secret fields from a connector config, replacing them with $ENV_VAR
+     * placeholders. Safe to commit to git.
+     */
+    static stripSecrets(config: ConnectorConfig): ConnectorConfig;
     /** Expands $ENV_VAR references; returns the literal string otherwise. */
-    static resolveToken(token: string): string;
+    static resolveEnvVar(value: string): string;
     /**
      * For each connector config: connect to the MCP server, fetch its tool list,
      * and return Pi-Mono-compatible tool objects with namespaced names.
@@ -59,7 +70,10 @@ export declare class ConnectorManager {
      * Failures are non-fatal — the connector is skipped with a console.warn.
      */
     static buildTools(configs: ConnectorConfig[], timeoutMs?: number): Promise<any[]>;
-    private static _resolveType;
+    /** Read all valid connector configs from a directory. */
+    private static _readDir;
+    /** Merge two configs for the same connector — overlay fields win over base. */
+    private static _merge;
     private static _validate;
     private static _buildConnectorTools;
 }