@commandable/integration-data 0.0.1

package/dist/credentials-index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Static, browser-safe export of all integration credential configs and hints.
+ * Import this from @commandable/integration-data/credentials in browser/Vite contexts
+ * where Node.js fs access is not available.
+ */
+export interface CredentialConfig {
+    schema: {
+        type: string;
+        properties: Record<string, {
+            type: string;
+            title?: string;
+            description?: string;
+            items?: {
+                type: string;
+            };
+        }>;
+        required: string[];
+        additionalProperties: boolean;
+    };
+    injection: {
+        headers?: Record<string, string>;
+        query?: Record<string, string>;
+    };
+}
+export interface IntegrationCredentials {
+    config: CredentialConfig;
+    hint: string;
+}
+export declare const credentialConfigs: Record<string, IntegrationCredentials>;
+//# sourceMappingURL=credentials-index.d.ts.map

package/dist/credentials-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials-index.d.ts","sourceRoot":"","sources":["../src/credentials-index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;QACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;YACzB,IAAI,EAAE,MAAM,CAAA;YACZ,KAAK,CAAC,EAAE,MAAM,CAAA;YACd,WAAW,CAAC,EAAE,MAAM,CAAA;YACpB,KAAK,CAAC,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAA;aAAE,CAAA;SACzB,CAAC,CAAA;QACF,QAAQ,EAAE,MAAM,EAAE,CAAA;QAClB,oBAAoB,EAAE,OAAO,CAAA;KAC9B,CAAA;IACD,SAAS,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAChC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAC/B,CAAA;CACF;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,gBAAgB,CAAA;IACxB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAoSpE,CAAA"}

package/dist/credentials-index.js

@@ -0,0 +1,292 @@
+/**
+ * Static, browser-safe export of all integration credential configs and hints.
+ * Import this from @commandable/integration-data/credentials in browser/Vite contexts
+ * where Node.js fs access is not available.
+ */
+export const credentialConfigs = {
+    airtable: {
+        config: {
+            schema: {
+                type: 'object',
+                properties: {
+                    token: {
+                        type: 'string',
+                        title: 'Personal Access Token',
+                        description: 'Airtable personal access token.',
+                    },
+                },
+                required: ['token'],
+                additionalProperties: false,
+            },
+            injection: {
+                headers: { Authorization: 'Bearer {{token}}' },
+            },
+        },
+        hint: `Create an Airtable personal access token and paste it here.
+
+You can generate one in Airtable account settings under developer tools / personal access tokens.
+`,
+    },
+    github: {
+        config: {
+            schema: {
+                type: 'object',
+                properties: {
+                    token: {
+                        type: 'string',
+                        title: 'Personal Access Token',
+                        description: 'GitHub personal access token (classic or fine-grained) with appropriate scopes.',
+                    },
+                },
+                required: ['token'],
+                additionalProperties: false,
+            },
+            injection: {
+                headers: { Authorization: 'Bearer {{token}}' },
+            },
+        },
+        hint: `Create a GitHub personal access token and paste it here.
+
+- Fine-grained PAT: Settings → Developer settings → Personal access tokens → Fine-grained tokens
+- Classic PAT: Settings → Developer settings → Personal access tokens → Tokens (classic)
+
+Minimum scopes depend on the tools you use (repo read/write, issues, pull requests, etc.).
+`,
+    },
+    'google-calendar': {
+        config: {
+            schema: {
+                type: 'object',
+                properties: {
+                    token: {
+                        type: 'string',
+                        title: 'OAuth Access Token (optional)',
+                        description: 'Google OAuth access token to use as a Bearer token (typically short-lived).',
+                    },
+                    serviceAccountJson: {
+                        type: 'string',
+                        title: 'Service Account JSON (recommended)',
+                        description: 'Full service account key JSON (contents of the downloaded JSON file).',
+                    },
+                    subject: {
+                        type: 'string',
+                        title: 'Subject / impersonated user (optional)',
+                        description: 'Optional user email to impersonate when using Google Workspace domain-wide delegation.',
+                    },
+                    scopes: {
+                        type: 'array',
+                        title: 'OAuth scopes (optional)',
+                        description: 'Optional override for OAuth scopes.',
+                        items: { type: 'string' },
+                    },
+                },
+                required: [],
+                additionalProperties: false,
+            },
+            injection: {
+                headers: { Authorization: 'Bearer {{token}}' },
+            },
+        },
+        hint: `Recommended: use a Google service account.
+
+- Create a service account in Google Cloud
+- Download a JSON key
+- Paste the JSON into \`serviceAccountJson\` (or use \`env:GOOGLE_SERVICE_ACCOUNT_JSON\`)
+
+Note: Calendar often needs Google Workspace domain-wide delegation if you want to impersonate a user (\`subject\`).
+For simple setups, use a short-lived OAuth access token in \`token\`.
+`,
+    },
+    'google-docs': {
+        config: {
+            schema: {
+                type: 'object',
+                properties: {
+                    token: {
+                        type: 'string',
+                        title: 'OAuth Access Token (optional)',
+                        description: 'Google OAuth access token to use as a Bearer token (typically short-lived).',
+                    },
+                    serviceAccountJson: {
+                        type: 'string',
+                        title: 'Service Account JSON (recommended)',
+                        description: 'Full service account key JSON (contents of the downloaded JSON file).',
+                    },
+                    subject: {
+                        type: 'string',
+                        title: 'Subject / impersonated user (optional)',
+                        description: 'Optional user email to impersonate when using Google Workspace domain-wide delegation.',
+                    },
+                    scopes: {
+                        type: 'array',
+                        title: 'OAuth scopes (optional)',
+                        description: 'Optional override for OAuth scopes.',
+                        items: { type: 'string' },
+                    },
+                },
+                required: [],
+                additionalProperties: false,
+            },
+            injection: {
+                headers: { Authorization: 'Bearer {{token}}' },
+            },
+        },
+        hint: `Recommended: use a Google service account.
+
+- Create a service account in Google Cloud
+- Download a JSON key
+- Paste the JSON into \`serviceAccountJson\` (or use \`env:GOOGLE_SERVICE_ACCOUNT_JSON\`)
+- Share your test document with the service account \`client_email\`
+
+You can also paste a short-lived OAuth access token into \`token\`, but it will expire.
+`,
+    },
+    'google-sheet': {
+        config: {
+            schema: {
+                type: 'object',
+                properties: {
+                    token: {
+                        type: 'string',
+                        title: 'OAuth Access Token (optional)',
+                        description: 'Google OAuth access token to use as a Bearer token (typically short-lived).',
+                    },
+                    serviceAccountJson: {
+                        type: 'string',
+                        title: 'Service Account JSON (recommended)',
+                        description: 'Full service account key JSON (contents of the downloaded JSON file).',
+                    },
+                    subject: {
+                        type: 'string',
+                        title: 'Subject / impersonated user (optional)',
+                        description: 'Optional user email to impersonate when using Google Workspace domain-wide delegation.',
+                    },
+                    scopes: {
+                        type: 'array',
+                        title: 'OAuth scopes (optional)',
+                        description: 'Optional override for OAuth scopes.',
+                        items: { type: 'string' },
+                    },
+                },
+                required: [],
+                additionalProperties: false,
+            },
+            injection: {
+                headers: { Authorization: 'Bearer {{token}}' },
+            },
+        },
+        hint: `Recommended: use a Google service account.
+
+- Create a service account in Google Cloud
+- Download a JSON key
+- Paste the JSON into \`serviceAccountJson\` (or use \`env:GOOGLE_SERVICE_ACCOUNT_JSON\`)
+- Share your test spreadsheet with the service account \`client_email\`
+
+You can also paste a short-lived OAuth access token into \`token\`, but it will expire.
+`,
+    },
+    'google-slides': {
+        config: {
+            schema: {
+                type: 'object',
+                properties: {
+                    token: {
+                        type: 'string',
+                        title: 'OAuth Access Token (optional)',
+                        description: 'Google OAuth access token to use as a Bearer token (typically short-lived).',
+                    },
+                    serviceAccountJson: {
+                        type: 'string',
+                        title: 'Service Account JSON (recommended)',
+                        description: 'Full service account key JSON (contents of the downloaded JSON file).',
+                    },
+                    subject: {
+                        type: 'string',
+                        title: 'Subject / impersonated user (optional)',
+                        description: 'Optional user email to impersonate when using Google Workspace domain-wide delegation.',
+                    },
+                    scopes: {
+                        type: 'array',
+                        title: 'OAuth scopes (optional)',
+                        description: 'Optional override for OAuth scopes.',
+                        items: { type: 'string' },
+                    },
+                },
+                required: [],
+                additionalProperties: false,
+            },
+            injection: {
+                headers: { Authorization: 'Bearer {{token}}' },
+            },
+        },
+        hint: `Recommended: use a Google service account.
+
+- Create a service account in Google Cloud
+- Download a JSON key
+- Paste the JSON into \`serviceAccountJson\` (or use \`env:GOOGLE_SERVICE_ACCOUNT_JSON\`)
+- Share your test presentation with the service account \`client_email\`
+
+You can also paste a short-lived OAuth access token into \`token\`, but it will expire.
+`,
+    },
+    notion: {
+        config: {
+            schema: {
+                type: 'object',
+                properties: {
+                    token: {
+                        type: 'string',
+                        title: 'Internal Integration Token',
+                        description: 'Notion internal integration token (starts with "secret_").',
+                    },
+                },
+                required: ['token'],
+                additionalProperties: false,
+            },
+            injection: {
+                headers: {
+                    Authorization: 'Bearer {{token}}',
+                    'Notion-Version': '2022-06-28',
+                },
+            },
+        },
+        hint: `1. Go to \`https://www.notion.so/profile/integrations/internal\`
+2. Create a Notion integration in Notion's developer settings
+3. Share your target pages/databases with that integration so it has access
+4. Copy the **Internal Integration Token** (usually starts with \`secret_\`)
+`,
+    },
+    trello: {
+        config: {
+            schema: {
+                type: 'object',
+                properties: {
+                    apiKey: {
+                        type: 'string',
+                        title: 'API Key',
+                        description: 'Your Trello API key from https://trello.com/power-ups/admin',
+                    },
+                    apiToken: {
+                        type: 'string',
+                        title: 'API Token',
+                        description: 'Your Trello API token ("token" param). Generate one via Trello\'s authorize flow.',
+                    },
+                },
+                required: ['apiKey', 'apiToken'],
+                additionalProperties: false,
+            },
+            injection: {
+                query: {
+                    key: '{{apiKey}}',
+                    token: '{{apiToken}}',
+                },
+            },
+        },
+        hint: `1. Go to \`https://trello.com/power-ups/admin\`
+2. Create a new app
+3. Navigate to **API Key** and copy your API key
+4. Click **Generate a Token** and copy the token value
+`,
+    },
+};
+//# sourceMappingURL=credentials-index.js.map

package/dist/credentials-index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { IntegrationCredentialConfig, DisplayCardData, ToolData, IntegrationCatalogItem, } from './loader.js';
+export { integrationDataRoot, loadIntegrationManifest, loadIntegrationPrompt, loadIntegrationTools, loadIntegrationDisplayCards, loadIntegrationCredentialConfig, listIntegrationTypes, listIntegrationCatalog, } from './loader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,2BAA2B,EAC3B,eAAe,EACf,QAAQ,EACR,sBAAsB,GACvB,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,EAC3B,+BAA+B,EAC/B,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { integrationDataRoot, loadIntegrationManifest, loadIntegrationPrompt, loadIntegrationTools, loadIntegrationDisplayCards, loadIntegrationCredentialConfig, listIntegrationTypes, listIntegrationCatalog, } from './loader.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,EAC3B,+BAA+B,EAC/B,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,aAAa,CAAA"}

package/dist/loader.d.ts

@@ -0,0 +1,69 @@
+import type { JSONSchema7 } from 'json-schema';
+export interface IntegrationCredentialConfig {
+    schema: JSONSchema7;
+    injection: {
+        headers?: Record<string, string>;
+        query?: Record<string, string>;
+    };
+}
+interface ToolRef {
+    name: string;
+    description: string;
+    inputSchema: string;
+    handler: string;
+    scope?: 'read' | 'write' | 'admin';
+}
+type FlatTools = ToolRef[];
+interface DisplayCardRef {
+    name: string;
+    description: string;
+    inputSchema: string;
+    component: string;
+}
+export interface DisplayCardData {
+    name: string;
+    description: string;
+    inputSchema: JSONSchema7;
+    component: string;
+}
+export interface ToolData {
+    name: string;
+    displayName?: string;
+    description: string;
+    inputSchema: JSONSchema7 | Record<string, unknown>;
+    handlerCode: string;
+}
+interface Manifest {
+    name: string;
+    version?: string;
+    baseUrl?: string;
+    tools: FlatTools;
+    displayCards?: DisplayCardRef[];
+}
+/**
+ * Returns the root directory of the bundled integration-data files.
+ * Can be overridden via COMMANDABLE_INTEGRATION_DATA_DIR for testing or
+ * custom deployments.
+ *
+ * Resolution: dist/loader.js -> ../integrations/ (i.e. packages/integration-data/integrations/)
+ * When installed as an npm package: node_modules/@commandable/integration-data/dist/loader.js
+ * -> node_modules/@commandable/integration-data/integrations/
+ */
+export declare function integrationDataRoot(): string;
+export declare function loadIntegrationManifest(type: string): Manifest | null;
+export declare function loadIntegrationPrompt(type: string): string | null;
+export declare function loadIntegrationDisplayCards(type: string): DisplayCardData[];
+export declare function loadIntegrationTools(type: string): {
+    read: ToolData[];
+    write: ToolData[];
+    admin: ToolData[];
+} | null;
+export declare function loadIntegrationCredentialConfig(type: string): IntegrationCredentialConfig | null;
+export interface IntegrationCatalogItem {
+    type: string;
+    name: string;
+}
+export declare function listIntegrationTypes(): string[];
+export declare function listIntegrationCatalog(): IntegrationCatalogItem[];
+export {};
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAK9C,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,WAAW,CAAA;IACnB,SAAS,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAChC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAC/B,CAAA;CACF;AAED,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;CACnC;AAED,KAAK,SAAS,GAAG,OAAO,EAAE,CAAA;AAE1B,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,WAAW,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClD,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,SAAS,CAAA;IAChB,YAAY,CAAC,EAAE,cAAc,EAAE,CAAA;CAChC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAK5C;AAqBD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAMrE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWjE;AAkBD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CAe3E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAAC,KAAK,EAAE,QAAQ,EAAE,CAAA;CAAE,GAAG,IAAI,CAoBpH;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,2BAA2B,GAAG,IAAI,CAsBhG;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAe/C;AAED,wBAAgB,sBAAsB,IAAI,sBAAsB,EAAE,CAejE"}

package/dist/loader.js

@@ -0,0 +1,164 @@
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Returns the root directory of the bundled integration-data files.
+ * Can be overridden via COMMANDABLE_INTEGRATION_DATA_DIR for testing or
+ * custom deployments.
+ *
+ * Resolution: dist/loader.js -> ../integrations/ (i.e. packages/integration-data/integrations/)
+ * When installed as an npm package: node_modules/@commandable/integration-data/dist/loader.js
+ * -> node_modules/@commandable/integration-data/integrations/
+ */
+export function integrationDataRoot() {
+    if (process.env.COMMANDABLE_INTEGRATION_DATA_DIR)
+        return resolve(process.env.COMMANDABLE_INTEGRATION_DATA_DIR);
+    return resolve(fileURLToPath(new URL('../integrations/', import.meta.url)));
+}
+function integrationDir(type) {
+    return resolve(integrationDataRoot(), type);
+}
+function readJsonFile(path) {
+    const content = readFileSync(path, 'utf8');
+    return JSON.parse(content);
+}
+function ensureSchemaObject(schema) {
+    if (!schema)
+        return {};
+    if (typeof schema === 'string') {
+        try {
+            return JSON.parse(schema);
+        }
+        catch {
+            return {};
+        }
+    }
+    return schema;
+}
+export function loadIntegrationManifest(type) {
+    const dir = integrationDir(type);
+    const manifestPath = resolve(dir, 'manifest.json');
+    if (!existsSync(manifestPath))
+        return null;
+    return readJsonFile(manifestPath);
+}
+export function loadIntegrationPrompt(type) {
+    const dir = integrationDir(type);
+    const promptPath = resolve(dir, 'prompt.md');
+    if (!existsSync(promptPath))
+        return null;
+    try {
+        return readFileSync(promptPath, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+function materializeTool(type, ref) {
+    const dir = integrationDir(type);
+    const schemaPath = resolve(dir, ref.inputSchema);
+    const handlerPath = resolve(dir, ref.handler);
+    const schema = readJsonFile(schemaPath);
+    const handlerCode = readFileSync(handlerPath, 'utf8').trim();
+    return {
+        name: ref.name,
+        description: ref.description,
+        inputSchema: ensureSchemaObject(schema),
+        handlerCode,
+    };
+}
+export function loadIntegrationDisplayCards(type) {
+    const manifest = loadIntegrationManifest(type);
+    if (!manifest?.displayCards?.length)
+        return [];
+    const dir = integrationDir(type);
+    return manifest.displayCards.map((ref) => {
+        const schemaPath = resolve(dir, ref.inputSchema);
+        const schema = existsSync(schemaPath) ? ensureSchemaObject(readJsonFile(schemaPath)) : {};
+        return {
+            name: ref.name,
+            description: ref.description,
+            inputSchema: schema,
+            component: ref.component,
+        };
+    });
+}
+export function loadIntegrationTools(type) {
+    const manifest = loadIntegrationManifest(type);
+    if (!manifest)
+        return null;
+    const flat = manifest.tools;
+    const readRefs = [];
+    const writeRefs = [];
+    const adminRefs = [];
+    for (const t of flat) {
+        const scope = t.scope || 'read';
+        if (scope === 'read')
+            readRefs.push(t);
+        else if (scope === 'write')
+            writeRefs.push(t);
+        else if (scope === 'admin')
+            adminRefs.push(t);
+        else
+            readRefs.push(t);
+    }
+    const read = readRefs.map(t => materializeTool(type, t));
+    const write = writeRefs.map(t => materializeTool(type, t));
+    const admin = adminRefs.map(t => materializeTool(type, t));
+    return { read, write, admin };
+}
+export function loadIntegrationCredentialConfig(type) {
+    const dir = integrationDir(type);
+    const path = resolve(dir, 'credentials.json');
+    if (!existsSync(path))
+        return null;
+    try {
+        const raw = readJsonFile(path);
+        const schema = ensureSchemaObject(raw?.schema);
+        const injection = raw?.injection || {};
+        const cfg = {
+            schema,
+            injection: {
+                headers: injection?.headers || undefined,
+                query: injection?.query || undefined,
+            },
+        };
+        return cfg;
+    }
+    catch {
+        return null;
+    }
+}
+export function listIntegrationTypes() {
+    const root = integrationDataRoot();
+    try {
+        return readdirSync(root).filter((entry) => {
+            try {
+                return statSync(resolve(root, entry)).isDirectory();
+            }
+            catch {
+                return false;
+            }
+        });
+    }
+    catch {
+        return [];
+    }
+}
+export function listIntegrationCatalog() {
+    const types = listIntegrationTypes();
+    const items = [];
+    for (const type of types) {
+        try {
+            const manifest = loadIntegrationManifest(type);
+            if (!manifest)
+                continue;
+            items.push({ type, name: manifest.name || type });
+        }
+        catch {
+            // ignore broken integration directories
+        }
+    }
+    return items;
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/integrations/README.md

@@ -0,0 +1,52 @@
+Integration Data
+================
+
+Purpose
+-------
+
+This directory contains per-integration metadata and tool templates to inject standard read/write capabilities into tasks.
+
+Structure
+---------
+
+Each integration lives under its own folder, e.g. `lib/integration-data/trello/`, with:
+
+- `manifest.json`: declarative index of tools and files
+- `schemas/*.json`: JSON Schemas for tool inputs
+- `handlers/*.js`: JavaScript handlers executed in the sandbox; use `integration.fetch()`
+- `prompt.md` (optional): extra prompt notes shown to the LLM
+- `openapi.json` (optional): reference spec; not used at runtime
+
+Manifest format
+---------------
+
+```
+{
+  "name": string,
+  "version": string,
+  "baseUrl"?: string,
+  "tools": {
+    "read": [ToolRef],
+    "write": [ToolRef]
+  }
+}
+
+ToolRef := {
+  "name": string,
+  "description": string,
+  "inputSchema": string,   // path to JSON schema file
+  "handler": string        // path to JS handler file
+}
+```
+
+Handler pattern
+---------------
+
+Handlers use the `integration.fetch(path, options?)` pattern rather than binding to a concrete integration id. At runtime, the host binds the task's selected integration instance as `integration` in the sandbox.
+
+Notes
+-----
+
+- Keep schemas strict and aligned with handler expectations.
+- Read tools MUST be side-effect free (GET only). Write tools include POST/PUT/DELETE.
+- Prefer small, composable tools that mirror API resources.