synthos 0.7.2 → 0.8.0

package/dist/agents/types.d.ts

@@ -0,0 +1,64 @@
+export interface AgentConfig {
+    id: string;
+    url: string;
+    name: string;
+    description: string;
+    iconUrl?: string;
+    enabled: boolean;
+    provider: 'a2a' | 'openclaw';
+    /** Auth token (openclaw only) */
+    token?: string;
+    /** Default session key for chat (openclaw only, e.g. "agent:main:main") */
+    sessionKey?: string;
+    capabilities?: {
+        streaming?: boolean;
+        pushNotifications?: boolean;
+    };
+    skills?: {
+        id: string;
+        name: string;
+        description: string;
+        tags: string[];
+    }[];
+    /** SSH tunnel config (openclaw only) — spawns an SSH tunnel before WebSocket connection */
+    sshTunnel?: {
+        enabled: boolean;
+        /** Full SSH command, e.g. "ssh -p 22 -N -L 18789:127.0.0.1:43901 root@1.2.3.4" */
+        command: string;
+        /** Password to pipe when prompted */
+        password: string;
+    };
+}
+export interface Attachment {
+    fileName: string;
+    mimeType: string;
+    /** base64 for binary, plain string for text */
+    content: string;
+}
+export interface ChatMessage {
+    role: 'user' | 'assistant';
+    content: string;
+    timestamp?: number;
+    /** Raw provider-specific payload for debugging */
+    raw?: unknown;
+}
+export interface AgentResponse {
+    kind: 'message' | 'task';
+    text?: string;
+    raw: unknown;
+    taskId?: string;
+    status?: string;
+}
+export interface AgentEvent {
+    kind: 'text' | 'status' | 'artifact' | 'done' | 'error';
+    data: unknown;
+}
+export interface AgentProvider {
+    send(agent: AgentConfig, message: string, attachments?: Attachment[]): Promise<AgentResponse>;
+    sendStream(agent: AgentConfig, message: string, attachments?: Attachment[]): AsyncIterable<AgentEvent>;
+    supportsStreaming(agent: AgentConfig): boolean;
+    getHistory?(agent: AgentConfig): Promise<ChatMessage[]>;
+    abortChat?(agent: AgentConfig): Promise<void>;
+    clearSession?(agent: AgentConfig): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,KAAK,GAAG,UAAU,CAAC;IAC7B,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACpE,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAC7E,2FAA2F;IAC3F,SAAS,CAAC,EAAE;QACR,OAAO,EAAE,OAAO,CAAC;QACjB,kFAAkF;QAClF,OAAO,EAAE,MAAM,CAAC;QAChB,qCAAqC;QACrC,QAAQ,EAAE,MAAM,CAAC;KACpB,CAAC;CACL;AAMD,MAAM,WAAW,UAAU;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,GAAG,CAAC,EAAE,OAAO,CAAC;CACjB;AAMD,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;IACxD,IAAI,EAAE,OAAO,CAAC;CACjB;AAMD,MAAM,WAAW,aAAa;IAC1B,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9F,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,EAAE,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IACvG,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IAG/C,UAAU,CAAC,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACxD,SAAS,CAAC,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,YAAY,CAAC,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD"}

package/dist/agents/types.js

@@ -0,0 +1,6 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// Agent configuration
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E"}

package/dist/connectors/airtable/connector.json

@@ -0,0 +1,27 @@
+{
+    "id": "airtable",
+    "name": "Airtable",
+    "category": "Productivity",
+    "description": "Cloud database and spreadsheet hybrid. Create, read, update, and manage structured data in Airtable bases.",
+    "baseUrl": "https://api.airtable.com",
+    "authStrategy": "bearer",
+    "authKey": "Authorization",
+    "fields": [
+        { "name": "apiKey", "label": "Personal Access Token", "type": "password" }
+    ],
+    "hints": [
+        "List records: GET /v0/{baseId}/{tableName}",
+        "Create record: POST /v0/{baseId}/{tableName} with body: { fields: { ... } }",
+        "Update record: PATCH /v0/{baseId}/{tableName}/{recordId} with body: { fields: { ... } }",
+        "Response: { records: [{ id, fields: { ... } }] }",
+        "Get your base ID from the Airtable API docs page for your base."
+    ],
+    "onboarding": {
+        "url": "https://airtable.com/create/tokens",
+        "steps": [
+            "Log in to your Airtable account",
+            "Go to airtable.com/create/tokens",
+            "Create a personal access token with the scopes you need and copy it"
+        ]
+    }
+}

package/dist/connectors/alpha-vantage/connector.json

@@ -0,0 +1,26 @@
+{
+    "id": "alpha-vantage",
+    "name": "Alpha Vantage",
+    "category": "Finance",
+    "description": "Stock market data, forex, crypto, and technical indicators. Real-time and historical financial data.",
+    "baseUrl": "https://www.alphavantage.co",
+    "authStrategy": "query",
+    "authKey": "apikey",
+    "fields": [
+        { "name": "apiKey", "label": "API Key", "type": "password" }
+    ],
+    "hints": [
+        "Stock quote: GET /query?function=GLOBAL_QUOTE&symbol={SYMBOL}",
+        "Daily time series: GET /query?function=TIME_SERIES_DAILY&symbol={SYMBOL}",
+        "Forex rate: GET /query?function=CURRENCY_EXCHANGE_RATE&from_currency=USD&to_currency=EUR",
+        "Free tier: 25 requests/day. Response is JSON with nested objects keyed by metadata labels."
+    ],
+    "onboarding": {
+        "url": "https://www.alphavantage.co/support/#api-key",
+        "steps": [
+            "Visit the Alpha Vantage API key page",
+            "Fill in your details and click Get Free API Key",
+            "Copy the API key shown on the page"
+        ]
+    }
+}

package/dist/connectors/brave-search/connector.json

@@ -0,0 +1,26 @@
+{
+    "id": "brave-search",
+    "name": "Brave Search",
+    "category": "Search",
+    "description": "Web search powered by the Brave Search API. Provides real-time search results from the web.",
+    "baseUrl": "https://api.search.brave.com",
+    "authStrategy": "header",
+    "authKey": "X-Subscription-Token",
+    "fields": [
+        { "name": "apiKey", "label": "API Key", "type": "password" }
+    ],
+    "hints": [
+        "Endpoint: GET /res/v1/web/search",
+        "Query params: q (required), count (1-20, default 10), country, freshness",
+        "Response: { web: { results: [{ title, url, description }] } }",
+        "Note: synthos.search.web() is a convenience wrapper — prefer it over raw connector calls for basic web search."
+    ],
+    "onboarding": {
+        "url": "https://brave.com/search/api/",
+        "steps": [
+            "Create an account at brave.com/search/api/",
+            "Subscribe to the Free plan (2,000 queries/mo)",
+            "Go to your dashboard and copy your API key"
+        ]
+    }
+}

package/dist/connectors/cloudinary/connector.json

@@ -0,0 +1,27 @@
+{
+    "id": "cloudinary",
+    "name": "Cloudinary",
+    "category": "Media",
+    "description": "Cloud-based image and video management. Upload, transform, optimize, and deliver media assets.",
+    "baseUrl": "https://api.cloudinary.com",
+    "authStrategy": "header",
+    "authKey": "Authorization",
+    "fields": [
+        { "name": "apiKey", "label": "Auth (Base64 key:secret)", "type": "password" }
+    ],
+    "hints": [
+        "Upload image: POST /v1_1/{cloud_name}/image/upload",
+        "  Body: { file: \"<url or base64>\", upload_preset: \"...\" }",
+        "List resources: GET /v1_1/{cloud_name}/resources/image",
+        "IMPORTANT: Cloudinary uses Basic auth. Save your key as 'Basic base64(API_KEY:API_SECRET)'.",
+        "Replace {cloud_name} in paths with your Cloudinary cloud name."
+    ],
+    "onboarding": {
+        "url": "https://cloudinary.com/users/register_free",
+        "steps": [
+            "Create a free Cloudinary account",
+            "Go to Settings > Access Keys",
+            "Base64-encode 'API_KEY:API_SECRET' and paste as your key"
+        ]
+    }
+}

package/dist/connectors/deepl/connector.json

@@ -0,0 +1,28 @@
+{
+    "id": "deepl",
+    "name": "DeepL",
+    "category": "Translation",
+    "description": "High-quality AI translation for 30+ languages. Translate text and documents with state-of-the-art neural machine translation.",
+    "baseUrl": "https://api-free.deepl.com",
+    "authStrategy": "header",
+    "authKey": "Authorization",
+    "fields": [
+        { "name": "apiKey", "label": "API Key", "type": "password" }
+    ],
+    "hints": [
+        "Translate text: POST /v2/translate",
+        "  Body: { text: [\"Hello\"], target_lang: \"DE\" }",
+        "  Response: { translations: [{ detected_source_language: \"EN\", text: \"Hallo\" }] }",
+        "Supported languages: GET /v2/languages",
+        "IMPORTANT: The auth header value must be: DeepL-Auth-Key YOUR_KEY. The proxy sends raw apiKey — prepend 'DeepL-Auth-Key ' when saving your key.",
+        "Free tier: 500,000 characters/month."
+    ],
+    "onboarding": {
+        "url": "https://www.deepl.com/pro-api",
+        "steps": [
+            "Sign up for a DeepL API Free account",
+            "Go to your Account > API Keys",
+            "Copy your Authentication Key"
+        ]
+    }
+}

package/dist/connectors/elevenlabs/connector.json

@@ -0,0 +1,30 @@
+{
+    "id": "elevenlabs",
+    "name": "ElevenLabs",
+    "category": "Audio",
+    "description": "AI-powered text-to-speech and voice synthesis. Generate natural-sounding audio from text.",
+    "baseUrl": "https://api.elevenlabs.io",
+    "authStrategy": "header",
+    "authKey": "xi-api-key",
+    "fields": [
+        { "name": "apiKey", "label": "API Key", "type": "password" }
+    ],
+    "hints": [
+        "List voices: GET /v1/voices → { voices: [{ voice_id, name, category }] }",
+        "Text-to-speech: POST /v1/text-to-speech/{voice_id}?output_format=mp3_44100_128",
+        "  Request headers: Accept: audio/mpeg, Content-Type: application/json",
+        "  Request body: { text: string, model_id: \"eleven_multilingual_v2\" }",
+        "  Response: raw audio/mpeg binary — use resp.arrayBuffer() then new Blob([buf], {type:\"audio/mpeg\"}) and URL.createObjectURL() to play",
+        "  IMPORTANT: The proxy returns raw binary, NOT JSON. Call fetch(\"/api/connectors\", ...) directly instead of synthos.connectors.call() for TTS, since the helper parses JSON.",
+        "Default voice: \"Rachel\" (voice_id: 21m00Tcm4TlvDq8ikWAM) is a good general-purpose voice.",
+        "Max text length: 5000 characters per request."
+    ],
+    "onboarding": {
+        "url": "https://elevenlabs.io/",
+        "steps": [
+            "Create an account at elevenlabs.io",
+            "Go to your Profile settings",
+            "Copy your API key from the API Key section"
+        ]
+    }
+}

package/dist/connectors/giphy/connector.json

@@ -0,0 +1,27 @@
+{
+    "id": "giphy",
+    "name": "Giphy",
+    "category": "Media",
+    "description": "Search and discover GIFs, stickers, and animated content. The world's largest GIF library.",
+    "baseUrl": "https://api.giphy.com",
+    "authStrategy": "query",
+    "authKey": "api_key",
+    "fields": [
+        { "name": "apiKey", "label": "API Key", "type": "password" }
+    ],
+    "hints": [
+        "Search GIFs: GET /v1/gifs/search?q={term}&limit=10",
+        "Trending: GET /v1/gifs/trending?limit=10",
+        "Random: GET /v1/gifs/random?tag={term}",
+        "Response: { data: [{ images: { original: { url }, fixed_height: { url } }, title }] }",
+        "Display with: <img src=\"{images.fixed_height.url}\">"
+    ],
+    "onboarding": {
+        "url": "https://developers.giphy.com/dashboard/",
+        "steps": [
+            "Create a GIPHY developer account",
+            "Create a new app on the dashboard",
+            "Copy the API key from your app settings"
+        ]
+    }
+}

package/dist/connectors/github/connector.json

@@ -0,0 +1,29 @@
+{
+    "id": "github",
+    "name": "GitHub",
+    "category": "Developer",
+    "description": "Access GitHub repositories, issues, pull requests, and more via the GitHub REST API.",
+    "baseUrl": "https://api.github.com",
+    "authStrategy": "bearer",
+    "authKey": "Authorization",
+    "fields": [
+        { "name": "apiKey", "label": "Personal Access Token", "type": "password" }
+    ],
+    "hints": [
+        "Get user: GET /user",
+        "List repos: GET /user/repos?sort=updated&per_page=10",
+        "Get repo: GET /repos/{owner}/{repo}",
+        "List issues: GET /repos/{owner}/{repo}/issues",
+        "Create issue: POST /repos/{owner}/{repo}/issues with body: { title, body }",
+        "All requests should include header Accept: application/vnd.github+json."
+    ],
+    "onboarding": {
+        "url": "https://github.com/settings/tokens",
+        "steps": [
+            "Go to github.com/settings/tokens",
+            "Generate a new token (classic or fine-grained)",
+            "Select the scopes you need (e.g. repo, read:user)",
+            "Copy the generated token"
+        ]
+    }
+}

package/dist/connectors/huggingface/connector.json

@@ -0,0 +1,27 @@
+{
+    "id": "huggingface",
+    "name": "Hugging Face",
+    "category": "AI",
+    "description": "Access thousands of AI models for text generation, image classification, NLP, and more via the Inference API.",
+    "baseUrl": "https://api-inference.huggingface.co",
+    "authStrategy": "bearer",
+    "authKey": "Authorization",
+    "fields": [
+        { "name": "apiKey", "label": "API Token", "type": "password" }
+    ],
+    "hints": [
+        "Run inference: POST /models/{model-id}",
+        "  Example (text generation): POST /models/gpt2 with body: { inputs: \"Hello world\" }",
+        "  Example (sentiment): POST /models/distilbert-base-uncased-finetuned-sst-2-english with body: { inputs: \"I love this!\" }",
+        "Response format varies by model task type.",
+        "Free tier: rate-limited, models may need to warm up (first request may be slow)."
+    ],
+    "onboarding": {
+        "url": "https://huggingface.co/join",
+        "steps": [
+            "Create an account at huggingface.co",
+            "Go to Settings > Access Tokens",
+            "Create a new token with read permissions and copy it"
+        ]
+    }
+}

package/dist/connectors/imgur/connector.json

@@ -0,0 +1,29 @@
+{
+    "id": "imgur",
+    "name": "Imgur",
+    "category": "Image",
+    "description": "Image hosting and sharing. Upload images, create albums, and browse the Imgur gallery.",
+    "baseUrl": "https://api.imgur.com",
+    "authStrategy": "header",
+    "authKey": "Authorization",
+    "fields": [
+        { "name": "apiKey", "label": "Client ID", "type": "password" }
+    ],
+    "hints": [
+        "Upload image: POST /3/image with body: { image: \"<base64 or URL>\", title: \"...\" }",
+        "Get image: GET /3/image/{imageHash}",
+        "Get album: GET /3/album/{albumHash}",
+        "Response (upload): { data: { id, link, deletehash, width, height } }",
+        "IMPORTANT: Save your key as 'Client-ID YOUR_CLIENT_ID' (the proxy sends raw header value).",
+        "Free tier: 1,250 uploads/day, 12,500 requests/day."
+    ],
+    "onboarding": {
+        "url": "https://api.imgur.com/oauth2/addclient",
+        "steps": [
+            "Create an Imgur account if you don't have one",
+            "Register an application at api.imgur.com/oauth2/addclient",
+            "Select 'OAuth 2 authorization without a callback URL'",
+            "Copy your Client ID from the confirmation page"
+        ]
+    }
+}

package/dist/connectors/index.d.ts

@@ -1,3 +1,3 @@
 export { CONNECTOR_REGISTRY } from './registry';
-export type { AuthStrategy, ConnectorField, ConnectorDefinition, ConnectorConfig, ConnectorOAuthConfig, ConnectorsConfig, ConnectorSummary, ConnectorDetail, ConnectorCallRequest } from './types';
+export type { AuthStrategy, ConnectorField, ConnectorOnboarding, ConnectorJson, ConnectorDefinition, ConnectorConfig, ConnectorOAuthConfig, ConnectorsConfig, ConnectorSummary, ConnectorDetail, ConnectorCallRequest } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/connectors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connectors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EACR,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACvB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connectors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EACR,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACvB,MAAM,SAAS,CAAC"}

package/dist/connectors/instagram/connector.json

@@ -0,0 +1,43 @@
+{
+    "id": "instagram",
+    "name": "Instagram",
+    "category": "Social",
+    "description": "Post photos and videos to Instagram via the Instagram Graph API.",
+    "baseUrl": "https://graph.facebook.com/v21.0",
+    "authStrategy": "oauth2",
+    "authKey": "access_token",
+    "authorizationUrl": "https://www.facebook.com/v21.0/dialog/oauth",
+    "tokenUrl": "https://graph.facebook.com/v21.0/oauth/access_token",
+    "scopes": [
+        "instagram_basic",
+        "instagram_content_publish",
+        "pages_show_list",
+        "pages_read_engagement"
+    ],
+    "fields": [
+        { "name": "clientId", "label": "App ID", "type": "text" },
+        { "name": "clientSecret", "label": "App Secret", "type": "password" }
+    ],
+    "hints": [
+        "Publishing flow (two-step):",
+        "  1. Create media container: POST /{ig-user-id}/media",
+        "     Body (photo): { image_url, caption }",
+        "     Body (reel/video): { video_url, caption, media_type: \"REELS\" }",
+        "     Response: { id: \"<container-id>\" }",
+        "  2. Publish container: POST /{ig-user-id}/media_publish",
+        "     Body: { creation_id: \"<container-id>\" }",
+        "     Response: { id: \"<media-id>\" }",
+        "IMPORTANT: Do NOT include access_token in body or query params — the proxy attaches it automatically.",
+        "IMPORTANT: Images must be publicly accessible URLs. Use a hosting service or the data API to serve local images.",
+        "Rate limit: 25 posts per 24-hour period.",
+        "Requires a Business or Creator Instagram account linked to a Facebook Page."
+    ],
+    "onboarding": {
+        "url": "https://developers.facebook.com/",
+        "steps": [
+            "Create a Meta developer account at developers.facebook.com",
+            "Create a new app and add the Instagram Graph API product",
+            "Get your App ID and App Secret from Settings > Basic"
+        ]
+    }
+}

package/dist/connectors/jira/connector.json

@@ -0,0 +1,28 @@
+{
+    "id": "jira",
+    "name": "Jira",
+    "category": "Developer",
+    "description": "Project management and issue tracking. Search, create, and update Jira issues via the REST API.",
+    "baseUrl": "https://your-domain.atlassian.net",
+    "authStrategy": "header",
+    "authKey": "Authorization",
+    "fields": [
+        { "name": "apiKey", "label": "Auth (Base64 email:token)", "type": "password" }
+    ],
+    "hints": [
+        "Search issues: GET /rest/api/3/search?jql={JQL}",
+        "Get issue: GET /rest/api/3/issue/{issueKey}",
+        "Create issue: POST /rest/api/3/issue with body: { fields: { project: { key }, summary, issuetype: { name } } }",
+        "IMPORTANT: Jira uses Basic auth. Save your key as 'Basic base64(email:api_token)'.",
+        "IMPORTANT: Update baseUrl to your Atlassian domain (e.g. https://mycompany.atlassian.net)."
+    ],
+    "onboarding": {
+        "url": "https://id.atlassian.com/manage-profile/security/api-tokens",
+        "steps": [
+            "Log in to your Atlassian account",
+            "Go to Account Settings > Security > API tokens",
+            "Create a new API token and copy it",
+            "Base64-encode 'your-email@example.com:api-token' and paste as your key"
+        ]
+    }
+}

package/dist/connectors/mapbox/connector.json

@@ -0,0 +1,26 @@
+{
+    "id": "mapbox",
+    "name": "Mapbox",
+    "category": "Geo",
+    "description": "Maps, geocoding, directions, and location search. Build location-aware applications.",
+    "baseUrl": "https://api.mapbox.com",
+    "authStrategy": "query",
+    "authKey": "access_token",
+    "fields": [
+        { "name": "apiKey", "label": "Access Token", "type": "password" }
+    ],
+    "hints": [
+        "Geocoding: GET /geocoding/v5/mapbox.places/{query}.json",
+        "Directions: GET /directions/v5/mapbox/driving/{lon1},{lat1};{lon2},{lat2}",
+        "Static map image: GET /styles/v1/mapbox/streets-v12/static/{lon},{lat},{zoom}/600x400",
+        "Response (geocoding): { features: [{ place_name, center: [lon, lat] }] }"
+    ],
+    "onboarding": {
+        "url": "https://account.mapbox.com/auth/signup/",
+        "steps": [
+            "Create an account at mapbox.com",
+            "Go to your Account page",
+            "Copy your default public token or create a new one"
+        ]
+    }
+}

package/dist/connectors/nasa/connector.json

@@ -0,0 +1,27 @@
+{
+    "id": "nasa",
+    "name": "NASA",
+    "category": "Science",
+    "description": "Access NASA's open data APIs including astronomy photos, Mars rover images, and asteroid tracking.",
+    "baseUrl": "https://api.nasa.gov",
+    "authStrategy": "query",
+    "authKey": "api_key",
+    "fields": [
+        { "name": "apiKey", "label": "API Key", "type": "password" }
+    ],
+    "hints": [
+        "Astronomy Picture of the Day: GET /planetary/apod",
+        "Mars Rover Photos: GET /mars-photos/api/v1/rovers/curiosity/photos?sol=1000",
+        "Asteroids NeoWS: GET /neo/rest/v1/feed?start_date=2024-01-01&end_date=2024-01-07",
+        "Response (APOD): { title, explanation, url, hdurl, media_type }",
+        "Free tier: 1,000 requests/hour. DEMO_KEY works for testing (30 req/hr)."
+    ],
+    "onboarding": {
+        "url": "https://api.nasa.gov/",
+        "steps": [
+            "Visit api.nasa.gov",
+            "Fill in the sign-up form to get an API key",
+            "Check your email for the API key"
+        ]
+    }
+}

package/dist/connectors/newsapi/connector.json

@@ -0,0 +1,27 @@
+{
+    "id": "newsapi",
+    "name": "NewsAPI",
+    "category": "News",
+    "description": "Search and retrieve news articles from thousands of sources worldwide. Headlines, everything search, and source discovery.",
+    "baseUrl": "https://newsapi.org",
+    "authStrategy": "header",
+    "authKey": "X-Api-Key",
+    "fields": [
+        { "name": "apiKey", "label": "API Key", "type": "password" }
+    ],
+    "hints": [
+        "Top headlines: GET /v2/top-headlines?country=us&category=technology",
+        "Everything search: GET /v2/everything?q={query}&sortBy=publishedAt",
+        "Sources: GET /v2/top-headlines/sources",
+        "Response: { articles: [{ title, description, url, urlToImage, publishedAt, source: { name } }] }",
+        "Free tier: 100 requests/day, 1-month-old articles only."
+    ],
+    "onboarding": {
+        "url": "https://newsapi.org/register",
+        "steps": [
+            "Create an account at newsapi.org",
+            "After registering, your API key is shown on the dashboard",
+            "Copy the API key"
+        ]
+    }
+}

package/dist/connectors/notion/connector.json

@@ -0,0 +1,28 @@
+{
+    "id": "notion",
+    "name": "Notion",
+    "category": "Productivity",
+    "description": "Workspace API for pages, databases, and blocks. Read and write Notion content programmatically.",
+    "baseUrl": "https://api.notion.com",
+    "authStrategy": "bearer",
+    "authKey": "Authorization",
+    "fields": [
+        { "name": "apiKey", "label": "Integration Token", "type": "password" }
+    ],
+    "hints": [
+        "Search: POST /v1/search with body: { query: \"...\", filter: { property: \"object\", value: \"page\" } }",
+        "Get page: GET /v1/pages/{page_id}",
+        "Query database: POST /v1/databases/{database_id}/query",
+        "IMPORTANT: All requests must include header Notion-Version: 2022-06-28.",
+        "Pages must be shared with your integration before they can be accessed."
+    ],
+    "onboarding": {
+        "url": "https://www.notion.so/my-integrations",
+        "steps": [
+            "Go to notion.so/my-integrations",
+            "Create a new internal integration",
+            "Copy the Internal Integration Token",
+            "Share your Notion pages/databases with the integration"
+        ]
+    }
+}

package/dist/connectors/open-exchange-rates/connector.json

@@ -0,0 +1,27 @@
+{
+    "id": "open-exchange-rates",
+    "name": "Open Exchange Rates",
+    "category": "Finance",
+    "description": "Currency exchange rates and conversion. Real-time and historical forex data for 170+ currencies.",
+    "baseUrl": "https://openexchangerates.org",
+    "authStrategy": "query",
+    "authKey": "app_id",
+    "fields": [
+        { "name": "apiKey", "label": "App ID", "type": "password" }
+    ],
+    "hints": [
+        "Latest rates: GET /api/latest.json",
+        "Historical: GET /api/historical/{YYYY-MM-DD}.json",
+        "Currencies list: GET /api/currencies.json",
+        "Response: { base: \"USD\", rates: { EUR: 0.92, GBP: 0.79, ... } }",
+        "Free tier: 1,000 requests/month, USD base only."
+    ],
+    "onboarding": {
+        "url": "https://openexchangerates.org/signup/free",
+        "steps": [
+            "Create a free account at openexchangerates.org",
+            "Go to your App IDs page in the dashboard",
+            "Copy your App ID"
+        ]
+    }
+}

package/dist/connectors/openweathermap/connector.json

@@ -0,0 +1,26 @@
+{
+    "id": "openweathermap",
+    "name": "OpenWeatherMap",
+    "category": "Weather",
+    "description": "Real-time weather data, forecasts, and historical weather information for any location worldwide.",
+    "baseUrl": "https://api.openweathermap.org",
+    "authStrategy": "query",
+    "authKey": "appid",
+    "fields": [
+        { "name": "apiKey", "label": "API Key", "type": "password" }
+    ],
+    "hints": [
+        "Current weather: GET /data/2.5/weather?q={city}&units=metric",
+        "5-day forecast: GET /data/2.5/forecast?q={city}&units=metric",
+        "Response: { main: { temp, humidity }, weather: [{ description }], wind: { speed } }",
+        "Use units=metric for Celsius or units=imperial for Fahrenheit."
+    ],
+    "onboarding": {
+        "url": "https://home.openweathermap.org/users/sign_up",
+        "steps": [
+            "Create an account at openweathermap.org",
+            "Go to API Keys in your account dashboard",
+            "Copy your default API key (or generate a new one)"
+        ]
+    }
+}