@almadar/integrations 2.4.0 → 2.5.1

package/dist/{BaseIntegration-DNSuiUnG.d.ts → BaseIntegration-DjXCkytU.d.ts}

@@ -1,3 +1,5 @@
+import { LogMeta } from '@almadar/core';
+
 /**
  * Core types for Almadar integrations
  */
@@ -66,14 +68,23 @@ declare class IntegrationError extends Error {
         details: unknown;
     };
 }
+
 /**
  * Logger interface
  */
 interface IntegrationLogger {
-    debug(message: string, meta?: Record<string, unknown>): void;
-    info(message: string, meta?: Record<string, unknown>): void;
-    warn(message: string, meta?: Record<string, unknown>): void;
-    error(message: string, meta?: Record<string, unknown>): void;
+    debug(message: string, meta?: LogMeta): void;
+    info(message: string, meta?: LogMeta): void;
+    warn(message: string, meta?: LogMeta): void;
+    error(message: string, meta?: LogMeta): void;
+}
+/**
+ * Integration action parameters.
+ * Each integration's execute() method receives params as this type.
+ * Individual methods cast to specific param shapes from their contracts.
+ */
+interface IntegrationParams {
+    [key: string]: string | number | boolean | null | undefined | string[] | IntegrationParams;
 }
 /**
  * Validation result
@@ -93,7 +104,7 @@ interface ValidationError {
 /**
  * Validate action params against registry schema
  */
-declare function validateParams(integration: string, action: string, params: Record<string, unknown>): ValidationResult;
+declare function validateParams(integration: string, action: string, params: IntegrationParams): ValidationResult;
 
 /**
  * Base class for all integrations
@@ -105,11 +116,11 @@ declare abstract class BaseIntegration {
     /**
      * Execute an action
      */
-    abstract execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    abstract execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
     /**
      * Validate action params against registry
      */
-    protected validateParams(action: string, params: Record<string, unknown>): ReturnType<typeof validateParams>;
+    protected validateParams(action: string, params: IntegrationParams): ReturnType<typeof validateParams>;
     /**
      * Handle errors uniformly
      */
@@ -124,4 +135,4 @@ declare abstract class BaseIntegration {
     protected executeWithRetry<T>(fn: () => Promise<T>): Promise<T>;
 }
 
-export { BaseIntegration as B, type IntegrationLogger as I, type ValidationError as V, type IntegrationErrorCode as a, type IntegrationConfig as b, type IntegrationResult as c, IntegrationError as d, type ValidationResult as e, validateParams as v };
+export { BaseIntegration as B, type IntegrationParams as I, type ValidationError as V, type IntegrationLogger as a, type IntegrationErrorCode as b, type IntegrationConfig as c, type IntegrationResult as d, IntegrationError as e, type ValidationResult as f, validateParams as v };

package/dist/{factory-B1QtCI_c.d.ts → factory-BoDqQ89e.d.ts}

@@ -1,4 +1,4 @@
-import { b as IntegrationConfig, B as BaseIntegration, c as IntegrationResult } from './BaseIntegration-DNSuiUnG.js';
+import { c as IntegrationConfig, B as BaseIntegration, I as IntegrationParams, d as IntegrationResult } from './BaseIntegration-DjXCkytU.js';
 
 /**
  * Factory for creating and managing integration instances
@@ -17,11 +17,15 @@ declare class IntegrationFactory {
     /**
      * Execute an action on an integration
      */
-    execute(integration: string, action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    execute(integration: string, action: string, params: IntegrationParams): Promise<IntegrationResult>;
     /**
      * Check if integration is configured
      */
     isConfigured(name: string): boolean;
+    /**
+     * Register an integration instance directly (used by mock infrastructure)
+     */
+    registerInstance(name: string, instance: BaseIntegration): void;
     /**
      * Clear all instances (useful for testing)
      */

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { I as IntegrationLogger, a as IntegrationErrorCode, b as IntegrationConfig, B as BaseIntegration, c as IntegrationResult } from './BaseIntegration-DNSuiUnG.js';
-export { d as IntegrationError, V as ValidationError, e as ValidationResult, v as validateParams } from './BaseIntegration-DNSuiUnG.js';
-export { I as IntegrationFactory, g as getIntegrationFactory, r as resetIntegrationFactory } from './factory-B1QtCI_c.js';
+import { I as IntegrationParams, a as IntegrationLogger, b as IntegrationErrorCode, c as IntegrationConfig, B as BaseIntegration, d as IntegrationResult } from './BaseIntegration-DjXCkytU.js';
+export { e as IntegrationError, V as ValidationError, f as ValidationResult, v as validateParams } from './BaseIntegration-DjXCkytU.js';
+import { LogMeta } from '@almadar/core';
+export { I as IntegrationFactory, g as getIntegrationFactory, r as resetIntegrationFactory } from './factory-BoDqQ89e.js';
 export { GitHubIntegration } from './integrations/github/index.js';
 
 /**
@@ -174,10 +175,10 @@ type LLMIntegrationActions = {
     extract: {
         params: {
             text: string;
-            schema: Record<string, unknown>;
+            schema: IntegrationParams;
             model?: string;
         };
-        result: Record<string, unknown>;
+        result: IntegrationParams;
     };
     summarize: {
         params: {
@@ -386,7 +387,7 @@ type StorageActions = {
             key: string;
             content: unknown;
             contentType?: string;
-            metadata?: Record<string, unknown>;
+            metadata?: IntegrationParams;
         };
         result: {
             key: string;
@@ -404,7 +405,7 @@ type StorageActions = {
             content: unknown;
             contentType: string;
             size: number;
-            metadata: Record<string, unknown>;
+            metadata: IntegrationParams;
         };
     };
     list: {
@@ -660,7 +661,7 @@ type OtelActions = {
     startSpan: {
         params: {
             name: string;
-            attributes?: Record<string, unknown>;
+            attributes?: IntegrationParams;
             traceId?: string;
         };
         result: {
@@ -681,7 +682,7 @@ type OtelActions = {
         params: {
             spanId: string;
             name: string;
-            attributes?: Record<string, unknown>;
+            attributes?: IntegrationParams;
         };
         result: {
             added: boolean;
@@ -692,7 +693,7 @@ type OtelActions = {
             name: string;
             value: number;
             type?: 'counter' | 'gauge' | 'histogram';
-            labels?: Record<string, unknown>;
+            labels?: IntegrationParams;
         };
         result: {
             recorded: boolean;
@@ -709,7 +710,7 @@ type OtelActions = {
             startTime: number;
             endTime?: number;
             status?: 'ok' | 'error';
-            attributes: Record<string, unknown>;
+            attributes: IntegrationParams;
         } | null;
     };
     getMetrics: {
@@ -719,7 +720,7 @@ type OtelActions = {
             type: string;
             value: number;
             values: number[];
-            labels: Record<string, unknown>;
+            labels: IntegrationParams;
         }>;
     };
 };
@@ -742,7 +743,7 @@ type DeepAgentActions = {
             message: string;
             threadId?: string;
             skill?: string;
-            context?: Record<string, unknown>;
+            context?: IntegrationParams;
         };
         result: {
             response: string;
@@ -837,10 +838,10 @@ type IntegrationActionName<K extends IntegrationName> = keyof IntegrationContrac
 declare class ConsoleLogger implements IntegrationLogger {
     private level;
     constructor(level?: 'debug' | 'info' | 'warn' | 'error');
-    debug(message: string, meta?: Record<string, unknown>): void;
-    info(message: string, meta?: Record<string, unknown>): void;
-    warn(message: string, meta?: Record<string, unknown>): void;
-    error(message: string, meta?: Record<string, unknown>): void;
+    debug(message: string, meta?: LogMeta): void;
+    info(message: string, meta?: LogMeta): void;
+    warn(message: string, meta?: LogMeta): void;
+    error(message: string, meta?: LogMeta): void;
     private shouldLog;
 }
 
@@ -885,7 +886,7 @@ declare function getRegisteredIntegrations(): string[];
 declare class StripeIntegration extends BaseIntegration {
     private client;
     constructor(config: IntegrationConfig);
-    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
     private createPaymentIntent;
     private confirmPayment;
     private refund;
@@ -897,7 +898,7 @@ declare class StripeIntegration extends BaseIntegration {
 declare class YouTubeIntegration extends BaseIntegration {
     private client;
     constructor(config: IntegrationConfig);
-    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
     private search;
     private getVideo;
     private getChannel;
@@ -910,7 +911,7 @@ declare class TwilioIntegration extends BaseIntegration {
     private client;
     private phoneNumber;
     constructor(config: IntegrationConfig);
-    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
     private sendSMS;
     private sendWhatsApp;
 }
@@ -923,7 +924,7 @@ declare class EmailIntegration extends BaseIntegration {
     private fromEmail;
     private resendClient?;
     constructor(config: IntegrationConfig);
-    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
     private send;
     private sendViaSendGrid;
     private sendViaResend;
@@ -947,7 +948,7 @@ declare class LLMIntegration extends BaseIntegration {
      * The client will throw a clear error when actually used without a key.
      */
     private getClient;
-    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
     private generate;
     private classify;
     private extract;
@@ -961,7 +962,7 @@ declare class DeepAgentIntegration extends BaseIntegration {
     private apiUrl;
     private apiKey;
     constructor(config: IntegrationConfig);
-    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
     private sendMessage;
     private cancelGeneration;
     private validateSchema;
@@ -981,7 +982,7 @@ declare class DeepAgentIntegration extends BaseIntegration {
  */
 declare class CLIIntegration extends BaseIntegration {
     constructor(config: IntegrationConfig);
-    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
     private validate;
 }
 
@@ -998,7 +999,7 @@ declare class RedisIntegration extends BaseIntegration {
     private locks;
     private channels;
     constructor(config: IntegrationConfig);
-    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
     /** Remove expired entries on access and return whether a key is alive. */
     private isAlive;
     /** Generate a unique lock identifier. */
@@ -1026,7 +1027,7 @@ declare class QueueIntegration extends BaseIntegration {
     /** Map from job ID to job data */
     private jobs;
     constructor(config: IntegrationConfig);
-    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
     /** Generate a unique job identifier. */
     private generateJobId;
     /** Get or create the queue array for a given queue name. */
@@ -1050,7 +1051,7 @@ declare class OtelIntegration extends BaseIntegration {
     private spans;
     private metrics;
     constructor(config: IntegrationConfig);
-    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
     private startSpan;
     private endSpan;
     private addEvent;
@@ -1076,7 +1077,7 @@ declare class OAuthIntegration extends BaseIntegration {
     /** Maps access token -> mock user session */
     private sessions;
     constructor(config: IntegrationConfig);
-    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
     /** Generate a random hex token of the given byte length. */
     private generateToken;
     /** Generate a mock user profile from a provider and access token. */
@@ -1098,7 +1099,7 @@ declare class OAuthIntegration extends BaseIntegration {
 declare class StorageIntegration extends BaseIntegration {
     private objects;
     constructor(config: IntegrationConfig);
-    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
     /** Build a composite key from bucket and object key. */
     private compositeKey;
     /** Generate a deterministic etag from content. */
@@ -1123,7 +1124,7 @@ declare class DockerIntegration extends BaseIntegration {
     private containers;
     private images;
     constructor(config: IntegrationConfig);
-    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
     /** Generate a random hex container/image ID. */
     private generateId;
     /** Find a container by ID (prefix match supported). */

package/dist/index.js

@@ -156,7 +156,7 @@ var BaseIntegration = class {
    */
   handleError(action, error) {
     this.logger.error(`Integration error in ${this.config.name}.${action}`, {
-      error
+      error: error instanceof Error ? error : new Error(String(error))
     });
     const integrationError = error instanceof Error ? error : new Error(String(error));
     return {
@@ -258,6 +258,12 @@ var IntegrationFactory = class {
   isConfigured(name) {
     return this.configs.has(name);
   }
+  /**
+   * Register an integration instance directly (used by mock infrastructure)
+   */
+  registerInstance(name, instance) {
+    this.instances.set(name, instance);
+  }
   /**
    * Clear all instances (useful for testing)
    */
@@ -339,7 +345,7 @@ var StripeIntegration = class extends BaseIntegration {
   }
   async createPaymentIntent(params) {
     const { amount, currency, metadata } = params;
-    this.logger.debug("Creating payment intent", { amount, currency });
+    this.logger.debug("Creating payment intent", { amount: Number(amount), currency: String(currency ?? "") });
     return await this.client.paymentIntents.create({
       amount,
       currency,
@@ -348,12 +354,12 @@ var StripeIntegration = class extends BaseIntegration {
   }
   async confirmPayment(params) {
     const { paymentIntentId } = params;
-    this.logger.debug("Confirming payment", { paymentIntentId });
+    this.logger.debug("Confirming payment", { paymentIntentId: String(paymentIntentId ?? "") });
     return await this.client.paymentIntents.confirm(paymentIntentId);
   }
   async refund(params) {
     const { paymentIntentId, amount } = params;
-    this.logger.debug("Creating refund", { paymentIntentId, amount });
+    this.logger.debug("Creating refund", { paymentIntentId: String(paymentIntentId ?? ""), amount: Number(amount) });
     return await this.client.refunds.create({
       payment_intent: paymentIntentId,
       amount
@@ -416,7 +422,7 @@ var YouTubeIntegration = class extends BaseIntegration {
   }
   async search(params) {
     const { query, maxResults, type } = params;
-    this.logger.debug("Searching YouTube", { query, maxResults, type });
+    this.logger.debug("Searching YouTube", { query: String(query ?? ""), maxResults: Number(maxResults ?? 10), type: String(type ?? "") });
     const response = await this.client.search.list({
       part: ["snippet"],
       q: query,
@@ -432,7 +438,7 @@ var YouTubeIntegration = class extends BaseIntegration {
   }
   async getVideo(params) {
     const { videoId } = params;
-    this.logger.debug("Getting video details", { videoId });
+    this.logger.debug("Getting video details", { videoId: String(videoId ?? "") });
     const response = await this.client.videos.list({
       part: ["snippet", "statistics"],
       id: [videoId]
@@ -450,7 +456,7 @@ var YouTubeIntegration = class extends BaseIntegration {
   }
   async getChannel(params) {
     const { channelId } = params;
-    this.logger.debug("Getting channel details", { channelId });
+    this.logger.debug("Getting channel details", { channelId: String(channelId ?? "") });
     const response = await this.client.channels.list({
       part: ["snippet", "statistics"],
       id: [channelId]
@@ -518,7 +524,7 @@ var TwilioIntegration = class extends BaseIntegration {
   }
   async sendSMS(params) {
     const { to, body } = params;
-    this.logger.debug("Sending SMS", { to });
+    this.logger.debug("Sending SMS", { to: String(to ?? "") });
     const message = await this.client.messages.create({
       from: this.phoneNumber,
       to,
@@ -531,7 +537,7 @@ var TwilioIntegration = class extends BaseIntegration {
   }
   async sendWhatsApp(params) {
     const { to, body } = params;
-    this.logger.debug("Sending WhatsApp message", { to });
+    this.logger.debug("Sending WhatsApp message", { to: String(to ?? "") });
     const message = await this.client.messages.create({
       from: `whatsapp:${this.phoneNumber}`,
       to: `whatsapp:${to}`,
@@ -600,7 +606,7 @@ var EmailIntegration = class extends BaseIntegration {
   }
   async send(params) {
     const { to, subject, body, from } = params;
-    this.logger.debug("Sending email", { to, subject, provider: this.provider });
+    this.logger.debug("Sending email", { to: String(to), subject: String(subject), provider: this.provider });
     if (this.provider === "sendgrid") {
       return await this.sendViaSendGrid(
         to,
@@ -740,7 +746,7 @@ var LLMIntegration = class extends BaseIntegration {
   }
   async classify(params) {
     const { text, categories, model } = params;
-    this.logger.debug("Classifying text", { categories });
+    this.logger.debug("Classifying text", { categories: categories.join(", ") });
     const ClassificationSchema = z.object({
       category: z.enum(categories),
       confidence: z.number().min(0).max(1),
@@ -757,7 +763,7 @@ var LLMIntegration = class extends BaseIntegration {
   }
   async extract(params) {
     const { text, schema, model } = params;
-    this.logger.debug("Extracting structured data", { schema });
+    this.logger.debug("Extracting structured data", { schema: String(schema ?? "") });
     const ExtractSchema = z.record(z.unknown());
     const client = model ? new LLMClient({ provider: this.provider, model, temperature: 0.2 }) : this.getClient();
     const schemaDescription = JSON.stringify(schema, null, 2);
@@ -855,7 +861,7 @@ var DeepAgentIntegration = class extends BaseIntegration {
   }
   async sendMessage(params) {
     const { message, threadId, skill, context } = params;
-    this.logger.debug("Sending message to DeepAgent", { threadId, skill });
+    this.logger.debug("Sending message to DeepAgent", { threadId: String(threadId ?? ""), skill: String(skill ?? "") });
     const response = await this.request("/api/agent/message", {
       message,
       threadId,
@@ -866,7 +872,7 @@ var DeepAgentIntegration = class extends BaseIntegration {
   }
   async cancelGeneration(params) {
     const { threadId } = params;
-    this.logger.debug("Cancelling generation", { threadId });
+    this.logger.debug("Cancelling generation", { threadId: String(threadId ?? "") });
     const response = await this.request("/api/agent/cancel", {
       threadId
     });
@@ -882,7 +888,7 @@ var DeepAgentIntegration = class extends BaseIntegration {
   }
   async compileSchema(params) {
     const { schema, shell } = params;
-    this.logger.debug("Compiling schema", { shell });
+    this.logger.debug("Compiling schema", { shell: String(shell ?? "") });
     const response = await this.request("/api/schema/compile", {
       schema,
       shell
@@ -891,7 +897,7 @@ var DeepAgentIntegration = class extends BaseIntegration {
   }
   async getThreadHistory(params) {
     const { threadId } = params;
-    this.logger.debug("Getting thread history", { threadId });
+    this.logger.debug("Getting thread history", { threadId: String(threadId ?? "") });
     const response = await this.request("/api/agent/history", {
       threadId
     });
@@ -1363,7 +1369,7 @@ var GitHubIntegration = class extends BaseIntegration {
    * List issues
    */
   async listIssues(params) {
-    this.logger.debug("Listing issues", params);
+    this.logger.debug("Listing issues", { state: params.state, labels: params.labels?.join(", "), limit: params.limit });
     const apiConfig = this.getAPIConfig();
     const issues = await listIssues(params, apiConfig);
     return { issues };
@@ -2150,7 +2156,7 @@ var OAuthIntegration = class extends BaseIntegration {
     const provider = params.provider;
     const scopes = params.scopes;
     const redirectUri = params.redirectUri;
-    this.logger.debug("OAuth AUTHORIZE", { provider, scopes, redirectUri });
+    this.logger.debug("OAuth AUTHORIZE", { provider, scopes: scopes.join(", "), redirectUri });
     const state = this.generateToken(16);
     this.states.set(state, provider);
     const baseUrl = PROVIDER_AUTH_URLS[provider];
@@ -2547,7 +2553,7 @@ var DockerIntegration = class extends BaseIntegration {
     const env = params.env ?? {};
     const rawVolumes = params.volumes ?? [];
     const command = params.command ?? "";
-    this.logger.debug("Docker RUN", { image, name, ports: rawPorts, env, volumes: rawVolumes, command });
+    this.logger.debug("Docker RUN", { image, name, ports: rawPorts.map((p) => `${p.host}:${p.container}`).join(", "), volumes: rawVolumes.map((v) => `${v.host}:${v.container}`).join(", "), command });
     const containerId = this.generateId();
     const ports = rawPorts.map((p) => ({
       host: p.host,