@objectstack/spec 0.3.2 → 0.4.1

package/dist/automation/connector.zod.d.ts

@@ -0,0 +1,1284 @@
+import { z } from 'zod';
+/**
+ * Connector Registry Protocol
+ *
+ * Inspired by Zapier, n8n, and Workato connector architectures.
+ *
+ * Connectors are reusable components that provide pre-built integrations with
+ * external systems (SaaS, databases, APIs, etc.).
+ *
+ * ## Use Cases
+ *
+ * 1. **SaaS Integration**
+ *    - Connect to Salesforce, HubSpot, Stripe, etc.
+ *    - Pre-built authentication and API clients
+ *    - Standard operations (CRUD, search, etc.)
+ *
+ * 2. **Database Connectivity**
+ *    - Connect to PostgreSQL, MySQL, MongoDB, etc.
+ *    - Query builders and connection pooling
+ *    - Schema introspection
+ *
+ * 3. **Third-Party Services**
+ *    - Payment processors (Stripe, PayPal)
+ *    - Communication (Twilio, SendGrid, Slack)
+ *    - Storage (S3, Google Drive, Dropbox)
+ *
+ * @see https://zapier.com/developer/documentation/v2/
+ * @see https://docs.n8n.io/integrations/creating-nodes/
+ *
+ * @example
+ * ```typescript
+ * const stripeConnector: Connector = {
+ *   id: 'stripe',
+ *   name: 'Stripe',
+ *   category: 'payment',
+ *   authentication: {
+ *     type: 'apiKey',
+ *     fields: [{ name: 'api_key', label: 'API Key', type: 'password' }]
+ *   },
+ *   operations: [
+ *     { id: 'create_customer', name: 'Create Customer', type: 'write' }
+ *   ]
+ * }
+ * ```
+ */
+/**
+ * Connector Category
+ */
+export declare const ConnectorCategorySchema: z.ZodEnum<["crm", "payment", "communication", "storage", "analytics", "database", "marketing", "accounting", "hr", "productivity", "ecommerce", "support", "devtools", "social", "other"]>;
+export type ConnectorCategory = z.infer<typeof ConnectorCategorySchema>;
+/**
+ * Authentication Type
+ */
+export declare const AuthenticationTypeSchema: z.ZodEnum<["none", "apiKey", "basic", "bearer", "oauth1", "oauth2", "custom"]>;
+export type AuthenticationType = z.infer<typeof AuthenticationTypeSchema>;
+/**
+ * Authentication Field Schema
+ */
+export declare const AuthFieldSchema: z.ZodObject<{
+    /**
+     * Field name (machine name)
+     */
+    name: z.ZodString;
+    /**
+     * Field label
+     */
+    label: z.ZodString;
+    /**
+     * Field type
+     */
+    type: z.ZodDefault<z.ZodEnum<["text", "password", "url", "select"]>>;
+    /**
+     * Field description
+     */
+    description: z.ZodOptional<z.ZodString>;
+    /**
+     * Whether field is required
+     */
+    required: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Default value
+     */
+    default: z.ZodOptional<z.ZodString>;
+    /**
+     * Options for select fields
+     */
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        label: string;
+    }, {
+        value: string;
+        label: string;
+    }>, "many">>;
+    /**
+     * Placeholder text
+     */
+    placeholder: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "text" | "url" | "password" | "select";
+    required: boolean;
+    label: string;
+    name: string;
+    options?: {
+        value: string;
+        label: string;
+    }[] | undefined;
+    default?: string | undefined;
+    description?: string | undefined;
+    placeholder?: string | undefined;
+}, {
+    label: string;
+    name: string;
+    options?: {
+        value: string;
+        label: string;
+    }[] | undefined;
+    type?: "text" | "url" | "password" | "select" | undefined;
+    required?: boolean | undefined;
+    default?: string | undefined;
+    description?: string | undefined;
+    placeholder?: string | undefined;
+}>;
+export type AuthField = z.infer<typeof AuthFieldSchema>;
+/**
+ * OAuth 2.0 Configuration
+ */
+export declare const OAuth2ConfigSchema: z.ZodObject<{
+    /**
+     * Authorization URL
+     */
+    authorizationUrl: z.ZodString;
+    /**
+     * Token URL
+     */
+    tokenUrl: z.ZodString;
+    /**
+     * Scopes to request
+     */
+    scopes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Client ID field name
+     */
+    clientIdField: z.ZodDefault<z.ZodString>;
+    /**
+     * Client secret field name
+     */
+    clientSecretField: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    authorizationUrl: string;
+    tokenUrl: string;
+    clientIdField: string;
+    clientSecretField: string;
+    scopes?: string[] | undefined;
+}, {
+    authorizationUrl: string;
+    tokenUrl: string;
+    scopes?: string[] | undefined;
+    clientIdField?: string | undefined;
+    clientSecretField?: string | undefined;
+}>;
+export type OAuth2Config = z.infer<typeof OAuth2ConfigSchema>;
+/**
+ * Authentication Configuration
+ */
+export declare const AuthenticationSchema: z.ZodObject<{
+    /**
+     * Authentication type
+     */
+    type: z.ZodEnum<["none", "apiKey", "basic", "bearer", "oauth1", "oauth2", "custom"]>;
+    /**
+     * Authentication fields
+     * Configuration fields needed for this auth type
+     */
+    fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /**
+         * Field name (machine name)
+         */
+        name: z.ZodString;
+        /**
+         * Field label
+         */
+        label: z.ZodString;
+        /**
+         * Field type
+         */
+        type: z.ZodDefault<z.ZodEnum<["text", "password", "url", "select"]>>;
+        /**
+         * Field description
+         */
+        description: z.ZodOptional<z.ZodString>;
+        /**
+         * Whether field is required
+         */
+        required: z.ZodDefault<z.ZodBoolean>;
+        /**
+         * Default value
+         */
+        default: z.ZodOptional<z.ZodString>;
+        /**
+         * Options for select fields
+         */
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            label: string;
+        }, {
+            value: string;
+            label: string;
+        }>, "many">>;
+        /**
+         * Placeholder text
+         */
+        placeholder: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "text" | "url" | "password" | "select";
+        required: boolean;
+        label: string;
+        name: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        default?: string | undefined;
+        description?: string | undefined;
+        placeholder?: string | undefined;
+    }, {
+        label: string;
+        name: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        type?: "text" | "url" | "password" | "select" | undefined;
+        required?: boolean | undefined;
+        default?: string | undefined;
+        description?: string | undefined;
+        placeholder?: string | undefined;
+    }>, "many">>;
+    /**
+     * OAuth 2.0 configuration (when type is oauth2)
+     */
+    oauth2: z.ZodOptional<z.ZodObject<{
+        /**
+         * Authorization URL
+         */
+        authorizationUrl: z.ZodString;
+        /**
+         * Token URL
+         */
+        tokenUrl: z.ZodString;
+        /**
+         * Scopes to request
+         */
+        scopes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * Client ID field name
+         */
+        clientIdField: z.ZodDefault<z.ZodString>;
+        /**
+         * Client secret field name
+         */
+        clientSecretField: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        authorizationUrl: string;
+        tokenUrl: string;
+        clientIdField: string;
+        clientSecretField: string;
+        scopes?: string[] | undefined;
+    }, {
+        authorizationUrl: string;
+        tokenUrl: string;
+        scopes?: string[] | undefined;
+        clientIdField?: string | undefined;
+        clientSecretField?: string | undefined;
+    }>>;
+    /**
+     * Test authentication instructions
+     */
+    test: z.ZodOptional<z.ZodObject<{
+        url: z.ZodOptional<z.ZodString>;
+        method: z.ZodDefault<z.ZodEnum<["GET", "POST", "PUT", "DELETE"]>>;
+    }, "strip", z.ZodTypeAny, {
+        method: "GET" | "POST" | "PUT" | "DELETE";
+        url?: string | undefined;
+    }, {
+        url?: string | undefined;
+        method?: "GET" | "POST" | "PUT" | "DELETE" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "custom" | "none" | "apiKey" | "basic" | "bearer" | "oauth2" | "oauth1";
+    fields?: {
+        type: "text" | "url" | "password" | "select";
+        required: boolean;
+        label: string;
+        name: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        default?: string | undefined;
+        description?: string | undefined;
+        placeholder?: string | undefined;
+    }[] | undefined;
+    test?: {
+        method: "GET" | "POST" | "PUT" | "DELETE";
+        url?: string | undefined;
+    } | undefined;
+    oauth2?: {
+        authorizationUrl: string;
+        tokenUrl: string;
+        clientIdField: string;
+        clientSecretField: string;
+        scopes?: string[] | undefined;
+    } | undefined;
+}, {
+    type: "custom" | "none" | "apiKey" | "basic" | "bearer" | "oauth2" | "oauth1";
+    fields?: {
+        label: string;
+        name: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        type?: "text" | "url" | "password" | "select" | undefined;
+        required?: boolean | undefined;
+        default?: string | undefined;
+        description?: string | undefined;
+        placeholder?: string | undefined;
+    }[] | undefined;
+    test?: {
+        url?: string | undefined;
+        method?: "GET" | "POST" | "PUT" | "DELETE" | undefined;
+    } | undefined;
+    oauth2?: {
+        authorizationUrl: string;
+        tokenUrl: string;
+        scopes?: string[] | undefined;
+        clientIdField?: string | undefined;
+        clientSecretField?: string | undefined;
+    } | undefined;
+}>;
+export type Authentication = z.infer<typeof AuthenticationSchema>;
+/**
+ * Connector Operation Type
+ */
+export declare const OperationTypeSchema: z.ZodEnum<["read", "write", "delete", "search", "trigger", "action"]>;
+export type OperationType = z.infer<typeof OperationTypeSchema>;
+/**
+ * Operation Parameter Schema
+ */
+export declare const OperationParameterSchema: z.ZodObject<{
+    /**
+     * Parameter name
+     */
+    name: z.ZodString;
+    /**
+     * Parameter label
+     */
+    label: z.ZodString;
+    /**
+     * Parameter description
+     */
+    description: z.ZodOptional<z.ZodString>;
+    /**
+     * Parameter type
+     */
+    type: z.ZodEnum<["string", "number", "boolean", "array", "object", "date", "file"]>;
+    /**
+     * Whether parameter is required
+     */
+    required: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Default value
+     */
+    default: z.ZodOptional<z.ZodAny>;
+    /**
+     * Validation schema
+     */
+    validation: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    /**
+     * Dynamic options function
+     */
+    dynamicOptions: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "string" | "number" | "boolean" | "object" | "date" | "array" | "file";
+    required: boolean;
+    label: string;
+    name: string;
+    validation?: Record<string, any> | undefined;
+    default?: any;
+    description?: string | undefined;
+    dynamicOptions?: string | undefined;
+}, {
+    type: "string" | "number" | "boolean" | "object" | "date" | "array" | "file";
+    label: string;
+    name: string;
+    validation?: Record<string, any> | undefined;
+    required?: boolean | undefined;
+    default?: any;
+    description?: string | undefined;
+    dynamicOptions?: string | undefined;
+}>;
+export type OperationParameter = z.infer<typeof OperationParameterSchema>;
+/**
+ * Connector Operation Schema
+ */
+export declare const ConnectorOperationSchema: z.ZodObject<{
+    /**
+     * Operation identifier
+     */
+    id: z.ZodString;
+    /**
+     * Operation name
+     */
+    name: z.ZodString;
+    /**
+     * Operation description
+     */
+    description: z.ZodOptional<z.ZodString>;
+    /**
+     * Operation type
+     */
+    type: z.ZodEnum<["read", "write", "delete", "search", "trigger", "action"]>;
+    /**
+     * Input parameters
+     */
+    inputSchema: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /**
+         * Parameter name
+         */
+        name: z.ZodString;
+        /**
+         * Parameter label
+         */
+        label: z.ZodString;
+        /**
+         * Parameter description
+         */
+        description: z.ZodOptional<z.ZodString>;
+        /**
+         * Parameter type
+         */
+        type: z.ZodEnum<["string", "number", "boolean", "array", "object", "date", "file"]>;
+        /**
+         * Whether parameter is required
+         */
+        required: z.ZodDefault<z.ZodBoolean>;
+        /**
+         * Default value
+         */
+        default: z.ZodOptional<z.ZodAny>;
+        /**
+         * Validation schema
+         */
+        validation: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        /**
+         * Dynamic options function
+         */
+        dynamicOptions: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "string" | "number" | "boolean" | "object" | "date" | "array" | "file";
+        required: boolean;
+        label: string;
+        name: string;
+        validation?: Record<string, any> | undefined;
+        default?: any;
+        description?: string | undefined;
+        dynamicOptions?: string | undefined;
+    }, {
+        type: "string" | "number" | "boolean" | "object" | "date" | "array" | "file";
+        label: string;
+        name: string;
+        validation?: Record<string, any> | undefined;
+        required?: boolean | undefined;
+        default?: any;
+        description?: string | undefined;
+        dynamicOptions?: string | undefined;
+    }>, "many">>;
+    /**
+     * Output schema
+     */
+    outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    /**
+     * Sample output for documentation
+     */
+    sampleOutput: z.ZodOptional<z.ZodAny>;
+    /**
+     * Whether operation supports pagination
+     */
+    supportsPagination: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Whether operation supports filtering
+     */
+    supportsFiltering: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "delete" | "search" | "read" | "write" | "action" | "trigger";
+    name: string;
+    id: string;
+    supportsPagination: boolean;
+    supportsFiltering: boolean;
+    description?: string | undefined;
+    inputSchema?: {
+        type: "string" | "number" | "boolean" | "object" | "date" | "array" | "file";
+        required: boolean;
+        label: string;
+        name: string;
+        validation?: Record<string, any> | undefined;
+        default?: any;
+        description?: string | undefined;
+        dynamicOptions?: string | undefined;
+    }[] | undefined;
+    outputSchema?: Record<string, any> | undefined;
+    sampleOutput?: any;
+}, {
+    type: "delete" | "search" | "read" | "write" | "action" | "trigger";
+    name: string;
+    id: string;
+    description?: string | undefined;
+    inputSchema?: {
+        type: "string" | "number" | "boolean" | "object" | "date" | "array" | "file";
+        label: string;
+        name: string;
+        validation?: Record<string, any> | undefined;
+        required?: boolean | undefined;
+        default?: any;
+        description?: string | undefined;
+        dynamicOptions?: string | undefined;
+    }[] | undefined;
+    outputSchema?: Record<string, any> | undefined;
+    sampleOutput?: any;
+    supportsPagination?: boolean | undefined;
+    supportsFiltering?: boolean | undefined;
+}>;
+export type ConnectorOperation = z.infer<typeof ConnectorOperationSchema>;
+/**
+ * Connector Trigger Schema
+ *
+ * Triggers are special operations that watch for events and initiate workflows.
+ */
+export declare const ConnectorTriggerSchema: z.ZodObject<{
+    /**
+     * Trigger identifier
+     */
+    id: z.ZodString;
+    /**
+     * Trigger name
+     */
+    name: z.ZodString;
+    /**
+     * Trigger description
+     */
+    description: z.ZodOptional<z.ZodString>;
+    /**
+     * Trigger type
+     */
+    type: z.ZodEnum<["webhook", "polling", "stream"]>;
+    /**
+     * Trigger configuration
+     */
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    /**
+     * Output schema
+     */
+    outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    /**
+     * Polling interval (for polling triggers)
+     * In milliseconds
+     */
+    pollingIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "webhook" | "polling" | "stream";
+    name: string;
+    id: string;
+    description?: string | undefined;
+    config?: Record<string, any> | undefined;
+    outputSchema?: Record<string, any> | undefined;
+    pollingIntervalMs?: number | undefined;
+}, {
+    type: "webhook" | "polling" | "stream";
+    name: string;
+    id: string;
+    description?: string | undefined;
+    config?: Record<string, any> | undefined;
+    outputSchema?: Record<string, any> | undefined;
+    pollingIntervalMs?: number | undefined;
+}>;
+export type ConnectorTrigger = z.infer<typeof ConnectorTriggerSchema>;
+/**
+ * Connector Schema
+ *
+ * Complete definition of a connector to an external system.
+ */
+export declare const ConnectorSchema: z.ZodObject<{
+    /**
+     * Connector identifier
+     * Must be globally unique
+     */
+    id: z.ZodString;
+    /**
+     * Connector name
+     */
+    name: z.ZodString;
+    /**
+     * Connector description
+     */
+    description: z.ZodOptional<z.ZodString>;
+    /**
+     * Connector version (semver)
+     */
+    version: z.ZodOptional<z.ZodString>;
+    /**
+     * Connector icon URL or name
+     */
+    icon: z.ZodOptional<z.ZodString>;
+    /**
+     * Connector category
+     */
+    category: z.ZodEnum<["crm", "payment", "communication", "storage", "analytics", "database", "marketing", "accounting", "hr", "productivity", "ecommerce", "support", "devtools", "social", "other"]>;
+    /**
+     * Base URL for API calls
+     */
+    baseUrl: z.ZodOptional<z.ZodString>;
+    /**
+     * Authentication configuration
+     */
+    authentication: z.ZodObject<{
+        /**
+         * Authentication type
+         */
+        type: z.ZodEnum<["none", "apiKey", "basic", "bearer", "oauth1", "oauth2", "custom"]>;
+        /**
+         * Authentication fields
+         * Configuration fields needed for this auth type
+         */
+        fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            /**
+             * Field name (machine name)
+             */
+            name: z.ZodString;
+            /**
+             * Field label
+             */
+            label: z.ZodString;
+            /**
+             * Field type
+             */
+            type: z.ZodDefault<z.ZodEnum<["text", "password", "url", "select"]>>;
+            /**
+             * Field description
+             */
+            description: z.ZodOptional<z.ZodString>;
+            /**
+             * Whether field is required
+             */
+            required: z.ZodDefault<z.ZodBoolean>;
+            /**
+             * Default value
+             */
+            default: z.ZodOptional<z.ZodString>;
+            /**
+             * Options for select fields
+             */
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                value: string;
+                label: string;
+            }, {
+                value: string;
+                label: string;
+            }>, "many">>;
+            /**
+             * Placeholder text
+             */
+            placeholder: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "text" | "url" | "password" | "select";
+            required: boolean;
+            label: string;
+            name: string;
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+            default?: string | undefined;
+            description?: string | undefined;
+            placeholder?: string | undefined;
+        }, {
+            label: string;
+            name: string;
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+            type?: "text" | "url" | "password" | "select" | undefined;
+            required?: boolean | undefined;
+            default?: string | undefined;
+            description?: string | undefined;
+            placeholder?: string | undefined;
+        }>, "many">>;
+        /**
+         * OAuth 2.0 configuration (when type is oauth2)
+         */
+        oauth2: z.ZodOptional<z.ZodObject<{
+            /**
+             * Authorization URL
+             */
+            authorizationUrl: z.ZodString;
+            /**
+             * Token URL
+             */
+            tokenUrl: z.ZodString;
+            /**
+             * Scopes to request
+             */
+            scopes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /**
+             * Client ID field name
+             */
+            clientIdField: z.ZodDefault<z.ZodString>;
+            /**
+             * Client secret field name
+             */
+            clientSecretField: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            authorizationUrl: string;
+            tokenUrl: string;
+            clientIdField: string;
+            clientSecretField: string;
+            scopes?: string[] | undefined;
+        }, {
+            authorizationUrl: string;
+            tokenUrl: string;
+            scopes?: string[] | undefined;
+            clientIdField?: string | undefined;
+            clientSecretField?: string | undefined;
+        }>>;
+        /**
+         * Test authentication instructions
+         */
+        test: z.ZodOptional<z.ZodObject<{
+            url: z.ZodOptional<z.ZodString>;
+            method: z.ZodDefault<z.ZodEnum<["GET", "POST", "PUT", "DELETE"]>>;
+        }, "strip", z.ZodTypeAny, {
+            method: "GET" | "POST" | "PUT" | "DELETE";
+            url?: string | undefined;
+        }, {
+            url?: string | undefined;
+            method?: "GET" | "POST" | "PUT" | "DELETE" | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "custom" | "none" | "apiKey" | "basic" | "bearer" | "oauth2" | "oauth1";
+        fields?: {
+            type: "text" | "url" | "password" | "select";
+            required: boolean;
+            label: string;
+            name: string;
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+            default?: string | undefined;
+            description?: string | undefined;
+            placeholder?: string | undefined;
+        }[] | undefined;
+        test?: {
+            method: "GET" | "POST" | "PUT" | "DELETE";
+            url?: string | undefined;
+        } | undefined;
+        oauth2?: {
+            authorizationUrl: string;
+            tokenUrl: string;
+            clientIdField: string;
+            clientSecretField: string;
+            scopes?: string[] | undefined;
+        } | undefined;
+    }, {
+        type: "custom" | "none" | "apiKey" | "basic" | "bearer" | "oauth2" | "oauth1";
+        fields?: {
+            label: string;
+            name: string;
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+            type?: "text" | "url" | "password" | "select" | undefined;
+            required?: boolean | undefined;
+            default?: string | undefined;
+            description?: string | undefined;
+            placeholder?: string | undefined;
+        }[] | undefined;
+        test?: {
+            url?: string | undefined;
+            method?: "GET" | "POST" | "PUT" | "DELETE" | undefined;
+        } | undefined;
+        oauth2?: {
+            authorizationUrl: string;
+            tokenUrl: string;
+            scopes?: string[] | undefined;
+            clientIdField?: string | undefined;
+            clientSecretField?: string | undefined;
+        } | undefined;
+    }>;
+    /**
+     * Available operations
+     */
+    operations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /**
+         * Operation identifier
+         */
+        id: z.ZodString;
+        /**
+         * Operation name
+         */
+        name: z.ZodString;
+        /**
+         * Operation description
+         */
+        description: z.ZodOptional<z.ZodString>;
+        /**
+         * Operation type
+         */
+        type: z.ZodEnum<["read", "write", "delete", "search", "trigger", "action"]>;
+        /**
+         * Input parameters
+         */
+        inputSchema: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            /**
+             * Parameter name
+             */
+            name: z.ZodString;
+            /**
+             * Parameter label
+             */
+            label: z.ZodString;
+            /**
+             * Parameter description
+             */
+            description: z.ZodOptional<z.ZodString>;
+            /**
+             * Parameter type
+             */
+            type: z.ZodEnum<["string", "number", "boolean", "array", "object", "date", "file"]>;
+            /**
+             * Whether parameter is required
+             */
+            required: z.ZodDefault<z.ZodBoolean>;
+            /**
+             * Default value
+             */
+            default: z.ZodOptional<z.ZodAny>;
+            /**
+             * Validation schema
+             */
+            validation: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            /**
+             * Dynamic options function
+             */
+            dynamicOptions: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "string" | "number" | "boolean" | "object" | "date" | "array" | "file";
+            required: boolean;
+            label: string;
+            name: string;
+            validation?: Record<string, any> | undefined;
+            default?: any;
+            description?: string | undefined;
+            dynamicOptions?: string | undefined;
+        }, {
+            type: "string" | "number" | "boolean" | "object" | "date" | "array" | "file";
+            label: string;
+            name: string;
+            validation?: Record<string, any> | undefined;
+            required?: boolean | undefined;
+            default?: any;
+            description?: string | undefined;
+            dynamicOptions?: string | undefined;
+        }>, "many">>;
+        /**
+         * Output schema
+         */
+        outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        /**
+         * Sample output for documentation
+         */
+        sampleOutput: z.ZodOptional<z.ZodAny>;
+        /**
+         * Whether operation supports pagination
+         */
+        supportsPagination: z.ZodDefault<z.ZodBoolean>;
+        /**
+         * Whether operation supports filtering
+         */
+        supportsFiltering: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "delete" | "search" | "read" | "write" | "action" | "trigger";
+        name: string;
+        id: string;
+        supportsPagination: boolean;
+        supportsFiltering: boolean;
+        description?: string | undefined;
+        inputSchema?: {
+            type: "string" | "number" | "boolean" | "object" | "date" | "array" | "file";
+            required: boolean;
+            label: string;
+            name: string;
+            validation?: Record<string, any> | undefined;
+            default?: any;
+            description?: string | undefined;
+            dynamicOptions?: string | undefined;
+        }[] | undefined;
+        outputSchema?: Record<string, any> | undefined;
+        sampleOutput?: any;
+    }, {
+        type: "delete" | "search" | "read" | "write" | "action" | "trigger";
+        name: string;
+        id: string;
+        description?: string | undefined;
+        inputSchema?: {
+            type: "string" | "number" | "boolean" | "object" | "date" | "array" | "file";
+            label: string;
+            name: string;
+            validation?: Record<string, any> | undefined;
+            required?: boolean | undefined;
+            default?: any;
+            description?: string | undefined;
+            dynamicOptions?: string | undefined;
+        }[] | undefined;
+        outputSchema?: Record<string, any> | undefined;
+        sampleOutput?: any;
+        supportsPagination?: boolean | undefined;
+        supportsFiltering?: boolean | undefined;
+    }>, "many">>;
+    /**
+     * Available triggers
+     */
+    triggers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /**
+         * Trigger identifier
+         */
+        id: z.ZodString;
+        /**
+         * Trigger name
+         */
+        name: z.ZodString;
+        /**
+         * Trigger description
+         */
+        description: z.ZodOptional<z.ZodString>;
+        /**
+         * Trigger type
+         */
+        type: z.ZodEnum<["webhook", "polling", "stream"]>;
+        /**
+         * Trigger configuration
+         */
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        /**
+         * Output schema
+         */
+        outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        /**
+         * Polling interval (for polling triggers)
+         * In milliseconds
+         */
+        pollingIntervalMs: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "webhook" | "polling" | "stream";
+        name: string;
+        id: string;
+        description?: string | undefined;
+        config?: Record<string, any> | undefined;
+        outputSchema?: Record<string, any> | undefined;
+        pollingIntervalMs?: number | undefined;
+    }, {
+        type: "webhook" | "polling" | "stream";
+        name: string;
+        id: string;
+        description?: string | undefined;
+        config?: Record<string, any> | undefined;
+        outputSchema?: Record<string, any> | undefined;
+        pollingIntervalMs?: number | undefined;
+    }>, "many">>;
+    /**
+     * Rate limiting information
+     */
+    rateLimit: z.ZodOptional<z.ZodObject<{
+        requestsPerSecond: z.ZodOptional<z.ZodNumber>;
+        requestsPerMinute: z.ZodOptional<z.ZodNumber>;
+        requestsPerHour: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        requestsPerMinute?: number | undefined;
+        requestsPerSecond?: number | undefined;
+        requestsPerHour?: number | undefined;
+    }, {
+        requestsPerMinute?: number | undefined;
+        requestsPerSecond?: number | undefined;
+        requestsPerHour?: number | undefined;
+    }>>;
+    /**
+     * Connector author
+     */
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Documentation URL
+     */
+    documentation: z.ZodOptional<z.ZodString>;
+    /**
+     * Homepage URL
+     */
+    homepage: z.ZodOptional<z.ZodString>;
+    /**
+     * License
+     */
+    license: z.ZodOptional<z.ZodString>;
+    /**
+     * Tags for discovery
+     */
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Whether connector is verified/certified
+     */
+    verified: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Custom metadata
+     */
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    category: "database" | "storage" | "other" | "analytics" | "crm" | "payment" | "communication" | "marketing" | "accounting" | "hr" | "productivity" | "ecommerce" | "support" | "devtools" | "social";
+    verified: boolean;
+    authentication: {
+        type: "custom" | "none" | "apiKey" | "basic" | "bearer" | "oauth2" | "oauth1";
+        fields?: {
+            type: "text" | "url" | "password" | "select";
+            required: boolean;
+            label: string;
+            name: string;
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+            default?: string | undefined;
+            description?: string | undefined;
+            placeholder?: string | undefined;
+        }[] | undefined;
+        test?: {
+            method: "GET" | "POST" | "PUT" | "DELETE";
+            url?: string | undefined;
+        } | undefined;
+        oauth2?: {
+            authorizationUrl: string;
+            tokenUrl: string;
+            clientIdField: string;
+            clientSecretField: string;
+            scopes?: string[] | undefined;
+        } | undefined;
+    };
+    tags?: string[] | undefined;
+    description?: string | undefined;
+    icon?: string | undefined;
+    version?: string | undefined;
+    author?: string | undefined;
+    documentation?: string | undefined;
+    license?: string | undefined;
+    metadata?: Record<string, any> | undefined;
+    baseUrl?: string | undefined;
+    rateLimit?: {
+        requestsPerMinute?: number | undefined;
+        requestsPerSecond?: number | undefined;
+        requestsPerHour?: number | undefined;
+    } | undefined;
+    homepage?: string | undefined;
+    operations?: {
+        type: "delete" | "search" | "read" | "write" | "action" | "trigger";
+        name: string;
+        id: string;
+        supportsPagination: boolean;
+        supportsFiltering: boolean;
+        description?: string | undefined;
+        inputSchema?: {
+            type: "string" | "number" | "boolean" | "object" | "date" | "array" | "file";
+            required: boolean;
+            label: string;
+            name: string;
+            validation?: Record<string, any> | undefined;
+            default?: any;
+            description?: string | undefined;
+            dynamicOptions?: string | undefined;
+        }[] | undefined;
+        outputSchema?: Record<string, any> | undefined;
+        sampleOutput?: any;
+    }[] | undefined;
+    triggers?: {
+        type: "webhook" | "polling" | "stream";
+        name: string;
+        id: string;
+        description?: string | undefined;
+        config?: Record<string, any> | undefined;
+        outputSchema?: Record<string, any> | undefined;
+        pollingIntervalMs?: number | undefined;
+    }[] | undefined;
+}, {
+    name: string;
+    id: string;
+    category: "database" | "storage" | "other" | "analytics" | "crm" | "payment" | "communication" | "marketing" | "accounting" | "hr" | "productivity" | "ecommerce" | "support" | "devtools" | "social";
+    authentication: {
+        type: "custom" | "none" | "apiKey" | "basic" | "bearer" | "oauth2" | "oauth1";
+        fields?: {
+            label: string;
+            name: string;
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+            type?: "text" | "url" | "password" | "select" | undefined;
+            required?: boolean | undefined;
+            default?: string | undefined;
+            description?: string | undefined;
+            placeholder?: string | undefined;
+        }[] | undefined;
+        test?: {
+            url?: string | undefined;
+            method?: "GET" | "POST" | "PUT" | "DELETE" | undefined;
+        } | undefined;
+        oauth2?: {
+            authorizationUrl: string;
+            tokenUrl: string;
+            scopes?: string[] | undefined;
+            clientIdField?: string | undefined;
+            clientSecretField?: string | undefined;
+        } | undefined;
+    };
+    tags?: string[] | undefined;
+    description?: string | undefined;
+    icon?: string | undefined;
+    version?: string | undefined;
+    author?: string | undefined;
+    documentation?: string | undefined;
+    license?: string | undefined;
+    metadata?: Record<string, any> | undefined;
+    baseUrl?: string | undefined;
+    rateLimit?: {
+        requestsPerMinute?: number | undefined;
+        requestsPerSecond?: number | undefined;
+        requestsPerHour?: number | undefined;
+    } | undefined;
+    homepage?: string | undefined;
+    verified?: boolean | undefined;
+    operations?: {
+        type: "delete" | "search" | "read" | "write" | "action" | "trigger";
+        name: string;
+        id: string;
+        description?: string | undefined;
+        inputSchema?: {
+            type: "string" | "number" | "boolean" | "object" | "date" | "array" | "file";
+            label: string;
+            name: string;
+            validation?: Record<string, any> | undefined;
+            required?: boolean | undefined;
+            default?: any;
+            description?: string | undefined;
+            dynamicOptions?: string | undefined;
+        }[] | undefined;
+        outputSchema?: Record<string, any> | undefined;
+        sampleOutput?: any;
+        supportsPagination?: boolean | undefined;
+        supportsFiltering?: boolean | undefined;
+    }[] | undefined;
+    triggers?: {
+        type: "webhook" | "polling" | "stream";
+        name: string;
+        id: string;
+        description?: string | undefined;
+        config?: Record<string, any> | undefined;
+        outputSchema?: Record<string, any> | undefined;
+        pollingIntervalMs?: number | undefined;
+    }[] | undefined;
+}>;
+export type Connector = z.infer<typeof ConnectorSchema>;
+/**
+ * Connector Instance Schema
+ *
+ * A configured instance of a connector with credentials.
+ */
+export declare const ConnectorInstanceSchema: z.ZodObject<{
+    /**
+     * Instance ID
+     */
+    id: z.ZodString;
+    /**
+     * Connector ID this instance uses
+     */
+    connectorId: z.ZodString;
+    /**
+     * Instance name
+     */
+    name: z.ZodString;
+    /**
+     * Instance description
+     */
+    description: z.ZodOptional<z.ZodString>;
+    /**
+     * Authentication credentials (encrypted)
+     */
+    credentials: z.ZodRecord<z.ZodString, z.ZodAny>;
+    /**
+     * Additional configuration
+     */
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    /**
+     * Whether instance is active
+     */
+    active: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Created timestamp
+     */
+    createdAt: z.ZodOptional<z.ZodString>;
+    /**
+     * Last tested timestamp
+     */
+    lastTestedAt: z.ZodOptional<z.ZodString>;
+    /**
+     * Test status
+     */
+    testStatus: z.ZodDefault<z.ZodEnum<["unknown", "success", "failed"]>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    active: boolean;
+    id: string;
+    credentials: Record<string, any>;
+    connectorId: string;
+    testStatus: "unknown" | "success" | "failed";
+    description?: string | undefined;
+    config?: Record<string, any> | undefined;
+    createdAt?: string | undefined;
+    lastTestedAt?: string | undefined;
+}, {
+    name: string;
+    id: string;
+    credentials: Record<string, any>;
+    connectorId: string;
+    description?: string | undefined;
+    active?: boolean | undefined;
+    config?: Record<string, any> | undefined;
+    createdAt?: string | undefined;
+    lastTestedAt?: string | undefined;
+    testStatus?: "unknown" | "success" | "failed" | undefined;
+}>;
+export type ConnectorInstance = z.infer<typeof ConnectorInstanceSchema>;
+/**
+ * Helper factory for creating connectors
+ */
+export declare const Connector: {
+    /**
+     * Create a basic API key connector
+     */
+    readonly apiKey: (params: {
+        id: string;
+        name: string;
+        category: ConnectorCategory;
+        baseUrl: string;
+    }) => Connector;
+    /**
+     * Create an OAuth 2.0 connector
+     */
+    readonly oauth2: (params: {
+        id: string;
+        name: string;
+        category: ConnectorCategory;
+        baseUrl: string;
+        authUrl: string;
+        tokenUrl: string;
+        scopes?: string[];
+    }) => Connector;
+};
+//# sourceMappingURL=connector.zod.d.ts.map