@jini-ai/integrations 0.1.0

package/dist/composio/catalog.js

@@ -0,0 +1,126 @@
+import { getConnectorSchemaSupportError } from './json-schema.js';
+const destructiveHintPattern = /(?:^|[._:\-/\s])(?:ban|deactivate|delete|destroy|disconnect|drop|erase|purge|remove-all|remove_all|reset|revoke|terminate|truncate|unlink|wipe)(?:$|[._:\-/\s])/i;
+const writeHintPattern = /(?:^|[._:\-/\s])(?:add|admin|append|approve|archive|assign|cancel|close|comment|complete|copy|create|disable|edit|enable|import|invite|join|leave|like|manage|mark|merge|move|mute|post|publish|react|rename|reply|restore|schedule|send|set|share|star|submit|subscribe|transfer|unarchive|update|upload|upsert|write)(?:$|[._:\-/\s])/i;
+const readOnlyHintPattern = /(?:^|[._:\-/\s])(?:download|fetch|find|get|inspect|list|lookup|query|read|readonly|read-only|read_only|search|status|summary|view)(?:$|[._:\-/\s])/i;
+function connectorToolSafetyHaystack(input) {
+    return [input.name, input.providerToolId, input.title, input.description, ...(input.requiredScopes ?? [])]
+        .filter((value) => typeof value === 'string' && value.length > 0)
+        .join(' ');
+}
+/**
+ * Classifies a provider tool conservatively from its name, description, and
+ * scopes. Ambiguous tools require confirmation.
+ */
+export function classifyConnectorToolSafety(input) {
+    const haystack = connectorToolSafetyHaystack(input);
+    if (destructiveHintPattern.test(haystack)) {
+        return {
+            sideEffect: 'destructive',
+            approval: 'disabled',
+            reason: 'Tool name, scope, or description contains destructive hints; destructive tools are not refreshable.',
+        };
+    }
+    if (writeHintPattern.test(haystack)) {
+        return {
+            sideEffect: 'write',
+            approval: 'confirm',
+            reason: 'Tool name, scope, or description indicates write-capable behavior; explicit confirmation is required.',
+        };
+    }
+    if (readOnlyHintPattern.test(haystack)) {
+        return {
+            sideEffect: 'read',
+            approval: 'auto',
+            reason: 'Tool metadata consistently indicates explicit read-only behavior.',
+        };
+    }
+    return {
+        sideEffect: 'write',
+        approval: 'confirm',
+        reason: 'Tool safety could not be proven read-only; defaulting to confirmation-required write policy.',
+    };
+}
+/** Returns whether a tool is safe for unattended refresh execution. */
+export function isRefreshEligibleConnectorToolSafety(safety) {
+    return safety.sideEffect === 'read' && safety.approval === 'auto';
+}
+/**
+ * Builds a catalog tool and derives safety defaults when the caller omitted
+ * them.
+ *
+ * @overallScore 100/100
+ */
+export function defineConnectorTool(tool) {
+    const safety = tool.safety ?? classifyConnectorToolSafety(tool);
+    const inputSchemaUnsupportedReason = tool.inputSchemaUnsupportedReason
+        ?? (tool.inputSchemaJson === undefined
+            ? 'connector input schema is missing'
+            : getConnectorSchemaSupportError(tool.inputSchemaJson));
+    return {
+        ...tool,
+        safety,
+        ...(inputSchemaUnsupportedReason === undefined ? {} : { inputSchemaUnsupportedReason }),
+        refreshEligible: inputSchemaUnsupportedReason === undefined
+            && (tool.refreshEligible ?? isRefreshEligibleConnectorToolSafety(safety)),
+    };
+}
+function cloneJsonValue(value) {
+    if (Array.isArray(value))
+        return value.map((item) => cloneJsonValue(item));
+    if (value !== null && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, cloneJsonValue(entry)]));
+    }
+    return value;
+}
+function cloneJsonObject(value) {
+    return cloneJsonValue(value);
+}
+function toolDefinitionToDetail(tool) {
+    return {
+        name: tool.name,
+        title: tool.title,
+        ...(tool.description === undefined ? {} : { description: tool.description }),
+        ...(tool.inputSchemaJson === undefined ? {} : { inputSchemaJson: cloneJsonObject(tool.inputSchemaJson) }),
+        ...(tool.inputSchemaUnsupportedReason === undefined ? {} : { inputSchemaUnsupportedReason: tool.inputSchemaUnsupportedReason }),
+        ...(tool.outputSchemaJson === undefined ? {} : { outputSchemaJson: cloneJsonObject(tool.outputSchemaJson) }),
+        safety: { ...tool.safety },
+        refreshEligible: tool.refreshEligible,
+        ...(tool.curation === undefined
+            ? {}
+            : { curation: { ...(tool.curation.useCases === undefined ? {} : { useCases: [...tool.curation.useCases] }), ...(tool.curation.reason === undefined ? {} : { reason: tool.curation.reason }) } }),
+    };
+}
+/**
+ * Creates a detached wire detail from a catalog definition.
+ *
+ * @overallScore 100/100
+ */
+export function connectorDefinitionToDetail(definition) {
+    return {
+        id: definition.id,
+        name: definition.name,
+        provider: definition.provider,
+        category: definition.category,
+        ...(definition.description === undefined ? {} : { description: definition.description }),
+        status: definition.disabled ? 'disabled' : 'available',
+        tools: definition.tools.map((tool) => toolDefinitionToDetail(tool)),
+        allowedToolNames: [...definition.allowedToolNames],
+        // Fall back to `allowedToolNames` when `curatedToolNames` isn't
+        // explicitly set — non-Composio connectors don't go through a
+        // dynamic merge, so for them the two are equivalent and the badge
+        // is stable either way (issue #748).
+        curatedToolNames: [...(definition.curatedToolNames ?? definition.allowedToolNames)],
+        ...(definition.toolCount === undefined ? {} : { toolCount: definition.toolCount }),
+        ...(definition.toolsNextCursor === undefined ? {} : { toolsNextCursor: definition.toolsNextCursor }),
+        ...(definition.toolsHasMore === undefined ? {} : { toolsHasMore: definition.toolsHasMore }),
+        ...(definition.featuredToolNames === undefined
+            ? {}
+            : { featuredToolNames: [...definition.featuredToolNames] }),
+        ...(definition.minimumApproval === undefined ? {} : { minimumApproval: definition.minimumApproval }),
+        auth: {
+            provider: definition.authentication,
+            configured: definition.authentication === 'local' || definition.authentication === 'none',
+        },
+    };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/composio/catalog.js.map

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

package/dist/composio/composio-config.d.ts

@@ -0,0 +1,42 @@
+/** Secret Composio project configuration persisted by a host. */
+export interface ComposioConfig {
+    apiKey: string;
+    authConfigIds: Record<string, string>;
+}
+/** Safe configuration projection for status surfaces. */
+export interface PublicComposioConfig {
+    configured: boolean;
+    apiKeyTail: string;
+}
+/** Persistence boundary consumed by {@link ComposioConnectorProvider}. */
+export interface ComposioConfigStore {
+    read(): ComposioConfig;
+    readPublic(): PublicComposioConfig;
+    write(input: unknown): PublicComposioConfig;
+    setAuthConfigId(connectorId: string, authConfigId: string): void;
+    deleteAuthConfigId(connectorId: string): void;
+}
+/** File adapter options. */
+export interface FileComposioConfigStoreOptions {
+    /** Absolute or host-resolved path to the secret JSON file. */
+    filePath: string;
+}
+/**
+ * Creates an isolated file-backed config store.
+ *
+ * Writes use a same-directory temporary file followed by an atomic rename.
+ * Directories are created as `0700` and the final secret file is forced to
+ * `0600`.
+ *
+ * @example
+ * ```ts
+ * const store = createFileComposioConfigStore({
+ *   filePath: '/var/lib/example/composio/config.json',
+ * });
+ * store.write({ apiKey: 'project-key' });
+ * ```
+ *
+ * @overallScore 100/100
+ */
+export declare function createFileComposioConfigStore({ filePath }: FileComposioConfigStoreOptions): ComposioConfigStore;
+//# sourceMappingURL=composio-config.d.ts.map

package/dist/composio/composio-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composio-config.d.ts","sourceRoot":"","sources":["../../src/composio/composio-config.ts"],"names":[],"mappings":"AAeA,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,yDAAyD;AACzD,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,IAAI,IAAI,cAAc,CAAC;IACvB,UAAU,IAAI,oBAAoB,CAAC;IACnC,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAAC;IAC5C,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACjE,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/C;AAED,4BAA4B;AAC5B,MAAM,WAAW,8BAA8B;IAC7C,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,6BAA6B,CAC3C,EAAE,QAAQ,EAAE,EAAE,8BAA8B,GAC3C,mBAAmB,CA6CrB"}

package/dist/composio/composio-config.js

@@ -0,0 +1,145 @@
+/**
+ * @module composio-config
+ *
+ * Instance-scoped configuration persistence for the Composio adapter.
+ */
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { COMPOSIO_MAX_SECRET_STORE_BYTES, readPrivateBoundedUtf8File, } from './bounded-data.js';
+import { withExclusiveFileLock } from './file-lock.js';
+/**
+ * Creates an isolated file-backed config store.
+ *
+ * Writes use a same-directory temporary file followed by an atomic rename.
+ * Directories are created as `0700` and the final secret file is forced to
+ * `0600`.
+ *
+ * @example
+ * ```ts
+ * const store = createFileComposioConfigStore({
+ *   filePath: '/var/lib/example/composio/config.json',
+ * });
+ * store.write({ apiKey: 'project-key' });
+ * ```
+ *
+ * @overallScore 100/100
+ */
+export function createFileComposioConfigStore({ filePath }) {
+    if (!filePath.trim())
+        throw new TypeError('Composio config filePath must not be empty.');
+    const resolvedFilePath = path.resolve(filePath);
+    const read = () => normalizeComposioConfig(readRawConfig(resolvedFilePath));
+    const readPublic = () => toPublicComposioConfig(read());
+    const write = (input) => withExclusiveFileLock(resolvedFilePath, () => {
+        const prior = normalizeComposioConfig(readRawConfig(resolvedFilePath));
+        const record = asRecord(input);
+        const hasApiKey = Object.prototype.hasOwnProperty.call(record, 'apiKey');
+        const hasAuthConfigIds = Object.prototype.hasOwnProperty.call(record, 'authConfigIds');
+        const nextApiKey = hasApiKey ? normalizeOptionalString(record.apiKey) ?? '' : prior.apiKey;
+        const apiKeyChanged = prior.apiKey !== nextApiKey;
+        const next = normalizeComposioConfig({
+            apiKey: nextApiKey,
+            authConfigIds: apiKeyChanged ? {} : hasAuthConfigIds ? record.authConfigIds : prior.authConfigIds,
+        });
+        writeRawConfig(resolvedFilePath, next);
+        return toPublicComposioConfig(next);
+    });
+    const setAuthConfigId = (connectorId, authConfigId) => {
+        const normalizedConnectorId = normalizeOptionalString(connectorId);
+        const normalizedAuthConfigId = normalizeOptionalString(authConfigId);
+        if (!normalizedConnectorId || !normalizedAuthConfigId)
+            return;
+        withExclusiveFileLock(resolvedFilePath, () => {
+            const prior = normalizeComposioConfig(readRawConfig(resolvedFilePath));
+            writeRawConfig(resolvedFilePath, {
+                apiKey: prior.apiKey,
+                authConfigIds: { ...prior.authConfigIds, [normalizedConnectorId]: normalizedAuthConfigId },
+            });
+        });
+    };
+    const deleteAuthConfigId = (connectorId) => {
+        const normalizedConnectorId = normalizeOptionalString(connectorId);
+        if (!normalizedConnectorId)
+            return;
+        withExclusiveFileLock(resolvedFilePath, () => {
+            const prior = normalizeComposioConfig(readRawConfig(resolvedFilePath));
+            if (prior.authConfigIds[normalizedConnectorId] === undefined)
+                return;
+            const authConfigIds = { ...prior.authConfigIds };
+            delete authConfigIds[normalizedConnectorId];
+            writeRawConfig(resolvedFilePath, { apiKey: prior.apiKey, authConfigIds });
+        });
+    };
+    return { read, readPublic, write, setAuthConfigId, deleteAuthConfigId };
+}
+function readRawConfig(filePath) {
+    try {
+        return JSON.parse(readPrivateBoundedUtf8File(filePath, COMPOSIO_MAX_SECRET_STORE_BYTES));
+    }
+    catch (error) {
+        if (isErrno(error, 'ENOENT'))
+            return {};
+        throw error;
+    }
+}
+function writeRawConfig(filePath, config) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true, mode: 0o700 });
+    fs.chmodSync(path.dirname(filePath), 0o700);
+    const tempPath = `${filePath}.${process.pid}.${crypto.randomUUID()}.tmp`;
+    const serialized = `${JSON.stringify(config, null, 2)}\n`;
+    if (Buffer.byteLength(serialized, 'utf8') > COMPOSIO_MAX_SECRET_STORE_BYTES) {
+        throw new RangeError(`Composio config exceeds the ${COMPOSIO_MAX_SECRET_STORE_BYTES}-byte limit.`);
+    }
+    try {
+        fs.writeFileSync(tempPath, serialized, { encoding: 'utf8', mode: 0o600 });
+        fs.renameSync(tempPath, filePath);
+        fs.chmodSync(filePath, 0o600);
+    }
+    catch (error) {
+        try {
+            fs.unlinkSync(tempPath);
+        }
+        catch (cleanupError) {
+            if (!isErrno(cleanupError, 'ENOENT'))
+                throw cleanupError;
+        }
+        throw error;
+    }
+}
+function toPublicComposioConfig(config) {
+    return {
+        configured: Boolean(config.apiKey),
+        apiKeyTail: config.apiKey ? config.apiKey.slice(-4) : '',
+    };
+}
+function normalizeComposioConfig(value) {
+    const raw = asRecord(value);
+    return {
+        apiKey: normalizeOptionalString(raw.apiKey) ?? '',
+        authConfigIds: normalizeAuthConfigIds(raw.authConfigIds),
+    };
+}
+function normalizeAuthConfigIds(value) {
+    const raw = asRecord(value);
+    const next = {};
+    for (const [connectorId, authConfigId] of Object.entries(raw)) {
+        const normalizedConnectorId = normalizeOptionalString(connectorId);
+        const normalizedAuthConfigId = normalizeOptionalString(authConfigId);
+        if (normalizedConnectorId && normalizedAuthConfigId)
+            next[normalizedConnectorId] = normalizedAuthConfigId;
+    }
+    return next;
+}
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+function normalizeOptionalString(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
+}
+function isErrno(error, code) {
+    return Boolean(error && typeof error === 'object' && 'code' in error && error.code === code);
+}
+//# sourceMappingURL=composio-config.js.map

package/dist/composio/composio-config.js.map

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

package/dist/composio/composio-descriptions.d.ts

@@ -0,0 +1,16 @@
+export interface ComposioToolkitMetadata {
+    /** Human-authored description tailored to the SaaS/tool. */
+    description: string;
+    /** Preferred category tag for the connector card. */
+    category: string;
+    /** Snapshot count for first paint before live toolkit metadata loads. */
+    toolCount?: number;
+}
+export declare const COMPOSIO_TOOLKIT_METADATA: Record<string, ComposioToolkitMetadata>;
+/**
+ * Resolve curated metadata for a toolkit slug. Returns undefined when the
+ * toolkit has not been manually described yet — callers should fall back
+ * to a generic description in that case.
+ */
+export declare function getComposioToolkitMetadata(slug: string): ComposioToolkitMetadata | undefined;
+//# sourceMappingURL=composio-descriptions.d.ts.map

package/dist/composio/composio-descriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composio-descriptions.d.ts","sourceRoot":"","sources":["../../src/composio/composio-descriptions.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAswB7E,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAE5F"}