chat-agent-toolkit 1.2.72 → 1.2.74

package/dist/connectors/index.d.ts

@@ -0,0 +1,84 @@
+/**
+ * OpenConnector Integration for OOMOL SaaS
+ *
+ * Multi-tenant connector platform for OAuth & credential management.
+ * Allows users to link external accounts (Gmail, Slack, GitHub, Airtable, etc.)
+ * securely managed by OOMOL Cloud.
+ *
+ * @module connectors
+ * @see {@link https://connector.oomol.com}
+ * @example
+ * ```ts
+ * import { ProjectConnector } from "chat-agent-toolkit/connectors";
+ *
+ * const project = new ProjectConnector({
+ *   apiKey: process.env.OOMOL_PROJECT_API_KEY,
+ * });
+ *
+ * const user = project.forUser(userId);
+ * const oauth = await user.connect.oauth({
+ *   service: "gmail",
+ *   returnUri: "https://myapp.com/oauth-callback",
+ * });
+ * ```
+ */
+export type { ConnectorError as OOMOLConnectorError, ProjectConnector as OOMOLProjectConnector, } from '@oomol-lab/connector';
+export { ConnectorError, ProjectConnector } from '@oomol-lab/connector';
+export type CatalogProvider = {
+    service: string;
+    displayName: string;
+    categories: string[];
+    authTypes: ("oauth2" | "api_key" | "custom_credential" | "no_auth")[];
+    actionCount: number;
+};
+export type ProviderIndexEntry = CatalogProvider & {
+    homepageUrl?: string;
+    actions?: string[];
+};
+/**
+ * Lightweight provider catalog (basic info: service, display name, auth types).
+ * ~900 providers, fast catalog search and picker UI.
+ */
+export declare const catalog: CatalogProvider[];
+/**
+ * Detailed provider index with action lists and metadata.
+ * Use for deep integration: listing available actions, mapping capabilities.
+ */
+export declare const providerIndex: ProviderIndexEntry[];
+/**
+ * Search the catalog by service name or display name.
+ * @param query Search term (case-insensitive)
+ * @param limit Max results
+ * @returns Matching providers
+ */
+export declare function searchCatalog(query: string, limit?: number): CatalogProvider[];
+/**
+ * Get a provider by service ID.
+ * @param serviceId The provider's service identifier (e.g., "gmail", "slack")
+ * @returns Provider info or undefined
+ */
+export declare function getCatalogProvider(serviceId: string): CatalogProvider | undefined;
+/**
+ * Get detailed provider info including actions.
+ * @param serviceId The provider's service identifier
+ * @returns Detailed provider entry or undefined
+ */
+export declare function getProviderDetails(serviceId: string): ProviderIndexEntry | undefined;
+/**
+ * Filter catalog by authentication type.
+ * @param authType The auth type to filter by
+ * @returns Providers supporting this auth type
+ */
+export declare function getCatalogByAuthType(authType: "oauth2" | "api_key" | "custom_credential" | "no_auth"): CatalogProvider[];
+/**
+ * Filter catalog by category.
+ * @param category The category to filter by (e.g., "Communication", "Productivity")
+ * @returns Providers in this category
+ */
+export declare function getCatalogByCategory(category: string): CatalogProvider[];
+/**
+ * Get all unique categories in the catalog.
+ * @returns Sorted list of category names
+ */
+export declare function getCatalogCategories(): string[];
+export type { Express } from 'express';

package/dist/connectors/server.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Multi-tenant connector server on OOMOL Cloud.
+ *
+ * This is a standalone Node.js Express server that manages OAuth credentials
+ * and API key connections for your app's users. It's NOT for browser/client code.
+ *
+ * OOMOL handles everything server-side:
+ * - OAuth apps & client secrets
+ * - Credential vault (encrypted storage)
+ * - Token refresh
+ * - Provider API calls
+ *
+ * Your app's users link THEIR OWN accounts (Gmail, Slack, GitHub, ...) via
+ * ProjectConnector — similar to Composio or Pipedream's "managed auth" model.
+ *
+ * @fileoverview OOMOL SaaS Connector Server
+ * @module connectors/server
+ *
+ * Setup:
+ *   1. Create a project in the OOMOL console and copy its API key (oo_proj_...).
+ *   2. Set OOMOL_PROJECT_API_KEY=oo_proj_... and run:
+ *      ```bash
+ *      cd packages/agent-toolkit/src/connectors
+ *      npm install
+ *      npm start
+ *      ```
+ *
+ * Environment variables:
+ *   - OOMOL_PROJECT_API_KEY: Your OOMOL project API key (required)
+ *   - PORT: Server port (default: 8787)
+ *   - APP_ORIGIN: Your app's origin for OAuth redirect (default: http://localhost:8787)
+ *
+ * API Endpoints:
+ *   GET    /api/catalog             - List/search providers
+ *   POST   /api/connections         - Start OAuth or API-key connection
+ *   GET    /api/connections/requests/:id - Poll OAuth status
+ *   POST   /api/actions/:actionId   - Execute a provider action
+ *   GET    /connected               - OAuth redirect landing page
+ *
+ * SECURITY: externalUserId = your app's own user id (from auth/session layer).
+ * NEVER let the client pick another user's id — derive it server-side from
+ * the authenticated session.
+ */
+declare const app: any;
+declare const server: any;
+export { app, server };

package/dist/connectors/smoke-test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Build-time smoke test: verify the OOMOL SDK imports, client constructs, and routes register.
+ * Run with: npm run build (from the connectors directory)
+ */
+export {};

package/dist/index.d.ts

@@ -23,3 +23,5 @@ export { configManager, ModelRegistry, getEnv, getModelProvidersUIConfigSection
 export type { Config, ConfigModelProvider, MCPServerConfig, UIConfigSections, Model, ModelWithProvider } from './config';
 export { cropProvider, cropProviderAsBlob, cropProviderAsDataURL, getProviderImage, getProviderNames } from './utils/provider-image-cropper';
 export type { Provider } from './utils/provider-image-cropper';
+export * from './connectors';
+export * as connectors from './connectors';