@marktoflow/integrations 2.0.0-alpha.7 → 2.0.1

package/dist/reliability/schemas/zendesk.js.map

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

package/dist/reliability/wrapper.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Integration Reliability Wrapper
+ *
+ * Wraps raw SDK clients with:
+ * - Input validation via Zod schemas
+ * - Retry with exponential backoff (respects Retry-After)
+ * - Configurable timeout
+ * - Structured error normalization
+ * - Rate limit awareness
+ */
+import { z } from 'zod';
+export interface WrapperOptions {
+    /** Service name for error messages */
+    service: string;
+    /** Default timeout per action call in ms (default: 30000) */
+    timeout?: number;
+    /** HTTP status codes that trigger retry (default: [429, 500, 502, 503, 504]) */
+    retryOn?: number[];
+    /** Maximum retry attempts (default: 3) */
+    maxRetries?: number;
+    /** Initial retry delay in ms (default: 1000) */
+    initialRetryDelay?: number;
+    /** Maximum retry delay in ms (default: 30000) */
+    maxRetryDelay?: number;
+    /** Zod schemas for input validation per action */
+    inputSchemas?: Record<string, z.ZodTypeAny>;
+}
+export interface ActionCallOptions {
+    /** Override timeout for this call */
+    timeout?: number;
+    /** Override max retries for this call */
+    maxRetries?: number;
+    /** Skip input validation for this call */
+    skipValidation?: boolean;
+}
+/**
+ * Wrap an SDK client with reliability features.
+ *
+ * Returns a Proxy that intercepts method calls on the SDK,
+ * adding validation, retry, timeout, and error normalization.
+ *
+ * The wrapper is transparent — all original SDK properties and methods
+ * remain accessible. Only function calls get wrapped.
+ */
+export declare function wrapIntegration<T extends object>(service: string, sdk: T, options?: Omit<WrapperOptions, 'service'>): T;
+//# sourceMappingURL=wrapper.d.ts.map

package/dist/reliability/wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../../src/reliability/wrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAC9C,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,CAAC,EACN,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAM,GAC5C,CAAC,CAYH"}

package/dist/reliability/wrapper.js

@@ -0,0 +1,174 @@
+/**
+ * Integration Reliability Wrapper
+ *
+ * Wraps raw SDK clients with:
+ * - Input validation via Zod schemas
+ * - Retry with exponential backoff (respects Retry-After)
+ * - Configurable timeout
+ * - Structured error normalization
+ * - Rate limit awareness
+ */
+import { IntegrationRequestError, normalizeError } from './errors.js';
+// ============================================================================
+// Defaults
+// ============================================================================
+const DEFAULT_TIMEOUT = 30000;
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_INITIAL_RETRY_DELAY = 1000;
+const DEFAULT_MAX_RETRY_DELAY = 30000;
+const DEFAULT_RETRYABLE_CODES = [429, 500, 502, 503, 504];
+// ============================================================================
+// Wrapper Implementation
+// ============================================================================
+/**
+ * Wrap an SDK client with reliability features.
+ *
+ * Returns a Proxy that intercepts method calls on the SDK,
+ * adding validation, retry, timeout, and error normalization.
+ *
+ * The wrapper is transparent — all original SDK properties and methods
+ * remain accessible. Only function calls get wrapped.
+ */
+export function wrapIntegration(service, sdk, options = {}) {
+    const opts = {
+        service,
+        timeout: options.timeout ?? DEFAULT_TIMEOUT,
+        retryOn: options.retryOn ?? DEFAULT_RETRYABLE_CODES,
+        maxRetries: options.maxRetries ?? DEFAULT_MAX_RETRIES,
+        initialRetryDelay: options.initialRetryDelay ?? DEFAULT_INITIAL_RETRY_DELAY,
+        maxRetryDelay: options.maxRetryDelay ?? DEFAULT_MAX_RETRY_DELAY,
+        inputSchemas: options.inputSchemas ?? {},
+    };
+    return createProxy(sdk, opts, '');
+}
+function createProxy(target, opts, path) {
+    return new Proxy(target, {
+        get(obj, prop, receiver) {
+            // Skip symbol properties and internal methods
+            if (typeof prop === 'symbol')
+                return Reflect.get(obj, prop, receiver);
+            // Avoid treating the proxy as a Thenable
+            if (prop === 'then')
+                return undefined;
+            const value = Reflect.get(obj, prop, receiver);
+            // Respect Proxy invariants: if the property is non-configurable,
+            // we must return the original value unchanged to avoid TypeError
+            const desc = Object.getOwnPropertyDescriptor(obj, prop);
+            if (desc && !desc.configurable) {
+                return value;
+            }
+            // If the value is a function, wrap it with reliability
+            if (typeof value === 'function') {
+                const actionPath = path ? `${path}.${prop}` : String(prop);
+                return createWrappedFunction(obj, value, opts, actionPath);
+            }
+            // If the value is an object (namespace like sdk.chat), proxy it too
+            if (value && typeof value === 'object' && !Array.isArray(value)) {
+                const nestedPath = path ? `${path}.${prop}` : String(prop);
+                try {
+                    return createProxy(value, opts, nestedPath);
+                }
+                catch {
+                    // If we can't proxy it (frozen, sealed, etc.), return as-is
+                    return value;
+                }
+            }
+            return value;
+        },
+    });
+}
+function createWrappedFunction(thisArg, fn, opts, actionPath) {
+    return async (...args) => {
+        // 1. Input validation
+        const schema = opts.inputSchemas[actionPath];
+        if (schema && args.length > 0 && args[0] && typeof args[0] === 'object') {
+            const result = schema.safeParse(args[0]);
+            if (!result.success) {
+                throw new IntegrationRequestError({
+                    service: opts.service,
+                    action: actionPath,
+                    message: `Input validation failed: ${result.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; ')}`,
+                    retryable: false,
+                });
+            }
+        }
+        // 2. Retry loop with timeout
+        let lastError;
+        const maxAttempts = opts.maxRetries + 1;
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            // Delay before retry (not on first attempt)
+            if (attempt > 0 && lastError) {
+                const delay = calculateDelay(attempt - 1, opts.initialRetryDelay, opts.maxRetryDelay, lastError.retryAfter);
+                await sleep(delay);
+            }
+            try {
+                const result = await withTimeout(fn.apply(thisArg, args), opts.timeout, opts.service, actionPath);
+                return result;
+            }
+            catch (error) {
+                lastError = normalizeError(opts.service, actionPath, error);
+                // Determine if this error should be retried:
+                // 1. If status code is in our retryOn list, always retry
+                // 2. If no status code, fall back to the retryable flag (network errors etc.)
+                const shouldRetry = lastError.statusCode
+                    ? opts.retryOn.includes(lastError.statusCode)
+                    : lastError.retryable;
+                if (!shouldRetry) {
+                    throw lastError;
+                }
+                // Last attempt — throw
+                if (attempt === maxAttempts - 1) {
+                    throw lastError;
+                }
+            }
+        }
+        // Should not reach here, but just in case
+        throw lastError ?? new IntegrationRequestError({
+            service: opts.service,
+            action: actionPath,
+            message: `Request failed after ${maxAttempts} attempts`,
+            retryable: false,
+        });
+    };
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function calculateDelay(attempt, initialDelay, maxDelay, retryAfterSeconds) {
+    // If server told us when to retry, respect it
+    if (retryAfterSeconds && retryAfterSeconds > 0) {
+        return Math.min(retryAfterSeconds * 1000, maxDelay);
+    }
+    // Exponential backoff with jitter
+    const exponential = initialDelay * Math.pow(2, attempt);
+    const capped = Math.min(exponential, maxDelay);
+    const jitter = capped * 0.25 * (Math.random() * 2 - 1);
+    return Math.max(0, capped + jitter);
+}
+async function withTimeout(promise, timeoutMs, service, action) {
+    // If the function returned a non-promise, just return it
+    if (!promise || typeof promise.then !== 'function') {
+        return promise;
+    }
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new IntegrationRequestError({
+                service,
+                action,
+                message: `Request timed out after ${timeoutMs}ms`,
+                retryable: true,
+            }));
+        }, timeoutMs);
+        promise.then((result) => {
+            clearTimeout(timer);
+            resolve(result);
+        }, (error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+    });
+}
+//# sourceMappingURL=wrapper.js.map

package/dist/reliability/wrapper.js.map

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

package/dist/services/ai-browser.d.ts

@@ -0,0 +1,112 @@
+/**
+ * AI Browser Automation Client
+ *
+ * Provides AI-powered browser automation using GitHub Copilot or Claude Code SDK
+ * as backends instead of relying on external API services.
+ *
+ * This integrates with marktoflow's existing AI adapters to provide natural language
+ * browser control without additional API costs.
+ */
+import type { PlaywrightClient } from './playwright.js';
+import type { GitHubCopilotClient } from '../adapters/github-copilot.js';
+import type { ClaudeCodeClient } from '../adapters/claude-code.js';
+export type AIBackend = 'copilot' | 'claude-code';
+export interface AIBrowserConfig {
+    /** AI backend to use */
+    backend: AIBackend;
+    /** AI client instance */
+    aiClient: GitHubCopilotClient | ClaudeCodeClient;
+    /** Playwright client instance */
+    playwrightClient: PlaywrightClient;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+export interface ActOptions {
+    /** Natural language action to perform */
+    action: string;
+}
+export interface ActResult {
+    success: boolean;
+    message: string;
+    action: string;
+}
+export interface ObserveOptions {
+    /** Optional instruction to filter observations */
+    instruction?: string;
+}
+export interface ObservedElement {
+    selector?: string;
+    description?: string;
+    tagName?: string;
+    text?: string;
+    actions?: string[];
+}
+export interface AIExtractOptions {
+    /** Natural language instruction for what to extract */
+    instruction: string;
+    /** JSON schema for structured extraction */
+    schema?: Record<string, unknown>;
+}
+/**
+ * AI-powered browser automation client
+ *
+ * Uses GitHub Copilot or Claude Code SDK for AI reasoning instead of
+ * external API services like OpenAI or Anthropic.
+ */
+export declare class AIBrowserClient {
+    private backend;
+    private aiClient;
+    private playwrightClient;
+    private debug;
+    constructor(config: AIBrowserConfig);
+    /**
+     * Perform an action described in natural language
+     *
+     * @example
+     * await client.act({ action: 'Click the login button' });
+     * await client.act({ action: 'Type "john@example.com" into the email field' });
+     */
+    act(options: ActOptions): Promise<ActResult>;
+    /**
+     * Observe the current page and identify available actions
+     *
+     * @example
+     * const elements = await client.observe({ instruction: 'Find all form inputs' });
+     */
+    observe(options?: ObserveOptions): Promise<ObservedElement[]>;
+    /**
+     * Extract structured data using AI
+     *
+     * @example
+     * const data = await client.aiExtract({
+     *   instruction: 'Extract all product names and prices',
+     *   schema: {
+     *     type: 'object',
+     *     properties: {
+     *       products: {
+     *         type: 'array',
+     *         items: {
+     *           type: 'object',
+     *           properties: {
+     *             name: { type: 'string' },
+     *             price: { type: 'number' }
+     *           }
+     *         }
+     *       }
+     *     }
+     *   }
+     * });
+     */
+    aiExtract(options: AIExtractOptions): Promise<{
+        data: unknown;
+    }>;
+    private queryAI;
+    private buildActPrompt;
+    private buildObservePrompt;
+    private buildExtractPrompt;
+    private parseActionResponse;
+    private parseObserveResponse;
+    private parseExtractResponse;
+    private executeAction;
+}
+//# sourceMappingURL=ai-browser.d.ts.map

package/dist/services/ai-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-browser.d.ts","sourceRoot":"","sources":["../../src/services/ai-browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAMnE,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,OAAO,EAAE,SAAS,CAAC;IACnB,yBAAyB;IACzB,QAAQ,EAAE,mBAAmB,GAAG,gBAAgB,CAAC;IACjD,iCAAiC;IACjC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAMD;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,KAAK,CAAU;gBAEX,MAAM,EAAE,eAAe;IAOnC;;;;;;OAMG;IACG,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IA0ClD;;;;;OAKG;IACG,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA6BnE;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;YAmCxD,OAAO;IAcrB,OAAO,CAAC,cAAc;IAwCtB,OAAO,CAAC,kBAAkB;IAsC1B,OAAO,CAAC,kBAAkB;IAqC1B,OAAO,CAAC,mBAAmB;IAuB3B,OAAO,CAAC,oBAAoB;IAuB5B,OAAO,CAAC,oBAAoB;YAkBd,aAAa;CA+C5B"}