@almadar/integrations 2.22.0 → 2.24.0

package/dist/{contracts-CYtxZXrR.d.ts → contracts-Dv9PM_Cz.d.ts}

@@ -258,6 +258,15 @@ type LLMIntegrationActions = {
             keyPoints: string[];
         };
     };
+    embed: {
+        params: {
+            texts: string[];
+            model?: string;
+        };
+        result: {
+            embeddings: number[][];
+        };
+    };
 };
 type MLActions = {
     infer: {
@@ -344,6 +353,21 @@ type EmailActions = {
         };
     };
 };
+type WebhookActions = {
+    send: {
+        params: {
+            url: string;
+            event: string;
+            payload?: Record<string, string>;
+            secret?: string;
+        };
+        result: {
+            status: number;
+            ok: boolean;
+            durationMs: number;
+        };
+    };
+};
 type DockerActions = {
     build: {
         params: {
@@ -964,6 +988,7 @@ type IntegrationContracts = {
     youtube: YouTubeActions;
     twilio: TwilioActions;
     email: EmailActions;
+    webhook: WebhookActions;
     docker: DockerActions;
     storage: StorageActions;
     queue: QueueActions;
@@ -990,4 +1015,4 @@ type IntegrationName = keyof IntegrationContracts;
  */
 type IntegrationActionName<K extends IntegrationName> = keyof IntegrationContracts[K] & string;
 
-export type { ArxivActions as A, CLIActions as C, DatabaseActions as D, EmailActions as E, GitHubActions as G, IconifyActions as I, LLMIntegrationActions as L, MLActions as M, OAuthActions as O, QueueActions as Q, RedisActions as R, StorageActions as S, TwilioActions as T, WikimediaActions as W, YouTubeActions as Y, DatabaseDriver as a, DatabaseQueryParamValue as b, DatabaseQueryParams as c, DatabaseQueryResult as d, DatabaseRow as e, DeepAgentActions as f, DockerActions as g, IntegrationActionName as h, IntegrationContracts as i, IntegrationName as j, OtelActions as k, StripeActions as l };
+export type { ArxivActions as A, CLIActions as C, DatabaseActions as D, EmailActions as E, GitHubActions as G, IconifyActions as I, LLMIntegrationActions as L, MLActions as M, OAuthActions as O, QueueActions as Q, RedisActions as R, StorageActions as S, TwilioActions as T, WebhookActions as W, YouTubeActions as Y, DatabaseDriver as a, DatabaseQueryParamValue as b, DatabaseQueryParams as c, DatabaseQueryResult as d, DatabaseRow as e, DeepAgentActions as f, DockerActions as g, IntegrationActionName as h, IntegrationContracts as i, IntegrationName as j, OtelActions as k, StripeActions as l, WikimediaActions as m };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { c as IntegrationLogger, b as IntegrationErrorCode, I as IntegrationConfig, B as BaseIntegration, e as IntegrationParams, f as IntegrationResult } from './BaseIntegration-MA-b4fh8.js';
 export { a as IntegrationError, d as IntegrationParamValue, V as ValidationError, g as ValidationResult, v as validateParams } from './BaseIntegration-MA-b4fh8.js';
-export { A as ArxivActions, C as CLIActions, D as DatabaseActions, a as DatabaseDriver, b as DatabaseQueryParamValue, c as DatabaseQueryParams, d as DatabaseQueryResult, e as DatabaseRow, f as DeepAgentActions, g as DockerActions, E as EmailActions, G as GitHubActions, I as IconifyActions, h as IntegrationActionName, i as IntegrationContracts, j as IntegrationName, L as LLMIntegrationActions, M as MLActions, O as OAuthActions, k as OtelActions, Q as QueueActions, R as RedisActions, S as StorageActions, l as StripeActions, T as TwilioActions, W as WikimediaActions, Y as YouTubeActions } from './contracts-CYtxZXrR.js';
+export { A as ArxivActions, C as CLIActions, D as DatabaseActions, a as DatabaseDriver, b as DatabaseQueryParamValue, c as DatabaseQueryParams, d as DatabaseQueryResult, e as DatabaseRow, f as DeepAgentActions, g as DockerActions, E as EmailActions, G as GitHubActions, I as IconifyActions, h as IntegrationActionName, i as IntegrationContracts, j as IntegrationName, L as LLMIntegrationActions, M as MLActions, O as OAuthActions, k as OtelActions, Q as QueueActions, R as RedisActions, S as StorageActions, l as StripeActions, T as TwilioActions, W as WebhookActions, m as WikimediaActions, Y as YouTubeActions } from './contracts-Dv9PM_Cz.js';
 import { LogMeta } from '@almadar/core';
 export { I as IntegrationFactory, g as getIntegrationFactory, r as resetIntegrationFactory } from './factory-DTdVeyAi.js';
 export { GitHubIntegration } from './integrations/github/index.js';
@@ -341,17 +341,30 @@ declare class EmailIntegration extends BaseIntegration {
     private sendViaResend;
 }
 
+/**
+ * Outbound webhook integration — signed HTTP POST notifications to external endpoints.
+ */
+declare class WebhookIntegration extends BaseIntegration {
+    private signingSecret;
+    private timeoutMs;
+    constructor(config: IntegrationConfig);
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
+    private send;
+}
+
 /**
  * LLM integration using @almadar/llm
  *
- * Provides 4 actions:
+ * Provides 5 actions:
  * - generate: Generate text content from a prompt
  * - classify: Classify text into predefined categories
  * - extract: Extract structured data from text using a schema
  * - summarize: Summarize long text content
+ * - embed: Generate embeddings for an array of texts
  */
 declare class LLMIntegration extends BaseIntegration {
     private client;
+    private embeddings;
     private provider;
     constructor(config: IntegrationConfig);
     /**
@@ -359,11 +372,20 @@ declare class LLMIntegration extends BaseIntegration {
      * The client will throw a clear error when actually used without a key.
      */
     private getClient;
+    /**
+     * Lazily create the embeddings client. Embeddings route through a dedicated
+     * embedding model (default OpenRouter `baai/bge-base-en-v1.5`, matching
+     * `@almadar/curation-core`), independent of the chat provider/key, because
+     * most chat providers do not expose an embeddings endpoint. Override via
+     * `EMBEDDING_PROVIDER` / `EMBEDDING_MODEL` / `EMBEDDING_API_KEY`.
+     */
+    private getEmbeddings;
     execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
     private generate;
     private classify;
     private extract;
     private summarize;
+    private embed;
 }
 
 declare class MLIntegration extends BaseIntegration {
@@ -636,4 +658,4 @@ declare class ArxivIntegration extends BaseIntegration {
     private search;
 }
 
-export { type AlmadarCheckoutSession, type AlmadarCustomer, type AlmadarInvoiceFailure, type AlmadarInvoicePayment, type AlmadarPortalSession, type AlmadarStripeEvent, type AlmadarStripeEventOk, type AlmadarSubscription, type AlmadarSubscriptionStatus, type AlmadarTier, ArxivIntegration, type ArxivResult, BaseIntegration, CLIIntegration, type CancelSubscriptionInput, ConsoleLogger, type CreateCheckoutInput, type CreateCustomerInput, type CreatePortalInput, DatabaseIntegration, DeepAgentIntegration, DockerIntegration, EmailIntegration, IconifyIntegration, IntegrationConfig, type IntegrationConstructor, IntegrationErrorCode, IntegrationLogger, IntegrationParams, IntegrationResult, LLMIntegration, MLIntegration, OAuthIntegration, OtelIntegration, QueueIntegration, RedisIntegration, type RetryConfig, type SqlGuardResult, StorageIntegration, StripeIntegration, type StripePriceMap, TwilioIntegration, type UpdateSubscriptionInput, type VerifyAndParseInput, WikimediaIntegration, YouTubeIntegration, assertReadOnlySelect, getIntegration, getRegisteredIntegrations, isKnownIntegration, registerIntegration, verifyAndParseStripeEvent, withRetry };
+export { type AlmadarCheckoutSession, type AlmadarCustomer, type AlmadarInvoiceFailure, type AlmadarInvoicePayment, type AlmadarPortalSession, type AlmadarStripeEvent, type AlmadarStripeEventOk, type AlmadarSubscription, type AlmadarSubscriptionStatus, type AlmadarTier, ArxivIntegration, type ArxivResult, BaseIntegration, CLIIntegration, type CancelSubscriptionInput, ConsoleLogger, type CreateCheckoutInput, type CreateCustomerInput, type CreatePortalInput, DatabaseIntegration, DeepAgentIntegration, DockerIntegration, EmailIntegration, IconifyIntegration, IntegrationConfig, type IntegrationConstructor, IntegrationErrorCode, IntegrationLogger, IntegrationParams, IntegrationResult, LLMIntegration, MLIntegration, OAuthIntegration, OtelIntegration, QueueIntegration, RedisIntegration, type RetryConfig, type SqlGuardResult, StorageIntegration, StripeIntegration, type StripePriceMap, TwilioIntegration, type UpdateSubscriptionInput, type VerifyAndParseInput, WebhookIntegration, WikimediaIntegration, YouTubeIntegration, assertReadOnlySelect, getIntegration, getRegisteredIntegrations, isKnownIntegration, registerIntegration, verifyAndParseStripeEvent, withRetry };

package/dist/index.js

@@ -5,7 +5,8 @@ import { google } from 'googleapis';
 import twilio from 'twilio';
 import sgMail from '@sendgrid/mail';
 import { Resend } from 'resend';
-import { getAvailableProvider, LLMClient } from '@almadar/llm';
+import { createHmac } from 'crypto';
+import { getAvailableProvider, LLMClient, EmbeddingClient } from '@almadar/llm';
 import { z } from 'zod';
 import { execSync, spawn } from 'child_process';
 import { mkdtempSync, writeFileSync, rmSync, promises } from 'fs';
@@ -993,10 +994,86 @@ var EmailIntegration = class extends BaseIntegration {
   }
 };
 registerIntegration("email", EmailIntegration);
+var WebhookIntegration = class extends BaseIntegration {
+  constructor(config) {
+    super(config);
+    this.signingSecret = config.env.WEBHOOK_SIGNING_SECRET || "";
+    this.timeoutMs = Number(config.env.WEBHOOK_TIMEOUT_MS) || 1e4;
+    this.logger.info("Webhook integration initialized");
+  }
+  async execute(action, params) {
+    const validation = this.validateParams(action, params);
+    if (!validation.valid) {
+      return {
+        success: false,
+        error: {
+          name: "IntegrationError",
+          message: "Validation failed",
+          code: "VALIDATION_ERROR",
+          details: validation.errors
+        },
+        metadata: this.createMetadata(action, 0)
+      };
+    }
+    const startTime = Date.now();
+    let retries = 0;
+    try {
+      let data;
+      switch (action) {
+        case "send":
+          data = await this.executeWithRetry(() => this.send(params));
+          break;
+        default:
+          throw new Error(`Unknown action: ${action}`);
+      }
+      return {
+        success: true,
+        data,
+        metadata: this.createMetadata(action, Date.now() - startTime, retries)
+      };
+    } catch (error) {
+      return this.handleError(action, error);
+    }
+  }
+  async send(params) {
+    const { url, event, payload, secret } = params;
+    const body = JSON.stringify({
+      event,
+      payload: payload ?? {},
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    const headers = {
+      "Content-Type": "application/json",
+      "X-Almadar-Event": event
+    };
+    const signingSecret = secret || this.signingSecret;
+    if (signingSecret) {
+      headers["X-Almadar-Signature"] = "sha256=" + createHmac("sha256", signingSecret).update(body).digest("hex");
+    }
+    this.logger.debug("Sending webhook", { url: String(url), event: String(event) });
+    const startTime = Date.now();
+    const response = await fetch(url, {
+      method: "POST",
+      headers,
+      body,
+      signal: AbortSignal.timeout(this.timeoutMs)
+    });
+    if (response.status >= 500) {
+      throw new Error(`Webhook endpoint returned ${response.status}`);
+    }
+    return {
+      status: response.status,
+      ok: response.ok,
+      durationMs: Date.now() - startTime
+    };
+  }
+};
+registerIntegration("webhook", WebhookIntegration);
 var LLMIntegration = class extends BaseIntegration {
   constructor(config) {
     super(config);
     this.client = null;
+    this.embeddings = null;
     const configuredProvider = config.env.PROVIDER;
     this.provider = configuredProvider || getAvailableProvider() || "anthropic";
     this.logger.info(`LLM integration initialized (provider: ${this.provider})`);
@@ -1015,6 +1092,23 @@ var LLMIntegration = class extends BaseIntegration {
     }
     return this.client;
   }
+  /**
+   * Lazily create the embeddings client. Embeddings route through a dedicated
+   * embedding model (default OpenRouter `baai/bge-base-en-v1.5`, matching
+   * `@almadar/curation-core`), independent of the chat provider/key, because
+   * most chat providers do not expose an embeddings endpoint. Override via
+   * `EMBEDDING_PROVIDER` / `EMBEDDING_MODEL` / `EMBEDDING_API_KEY`.
+   */
+  getEmbeddings() {
+    if (!this.embeddings) {
+      this.embeddings = new EmbeddingClient({
+        provider: this.config.env.EMBEDDING_PROVIDER ?? "openrouter",
+        model: this.config.env.EMBEDDING_MODEL ?? "baai/bge-base-en-v1.5",
+        apiKey: this.config.env.EMBEDDING_API_KEY
+      });
+    }
+    return this.embeddings;
+  }
   async execute(action, params) {
     const validation = this.validateParams(action, params);
     if (!validation.valid) {
@@ -1045,6 +1139,9 @@ var LLMIntegration = class extends BaseIntegration {
         case "summarize":
           data = await this.executeWithRetry(() => this.summarize(params));
           break;
+        case "embed":
+          data = await this.executeWithRetry(() => this.embed(params));
+          break;
         default:
           throw new Error(`Unknown action: ${action}`);
       }
@@ -1137,6 +1234,15 @@ Return ONLY valid JSON matching the schema.`,
     });
     return result;
   }
+  async embed(params) {
+    const { texts } = params;
+    if (!Array.isArray(texts)) {
+      throw new Error("llm.embed: `texts` must be an array of strings");
+    }
+    this.logger.debug("Embedding texts", { count: texts.length });
+    const batch = await this.getEmbeddings().embedBatch(texts);
+    return { embeddings: batch.embeddings };
+  }
 };
 registerIntegration("llm", LLMIntegration);
 
@@ -3653,6 +3759,6 @@ var ArxivIntegration = class extends BaseIntegration {
 };
 registerIntegration("arxiv", ArxivIntegration);
 
-export { ArxivIntegration, BaseIntegration, CLIIntegration, ConsoleLogger, DatabaseIntegration, DeepAgentIntegration, DockerIntegration, EmailIntegration, GitHubIntegration, IconifyIntegration, IntegrationError, IntegrationFactory, LLMIntegration, MLIntegration, OAuthIntegration, OtelIntegration, QueueIntegration, RedisIntegration, StorageIntegration, StripeIntegration, TwilioIntegration, WikimediaIntegration, YouTubeIntegration, assertReadOnlySelect, getIntegration, getIntegrationFactory, getRegisteredIntegrations, isKnownIntegration, registerIntegration, resetIntegrationFactory, validateParams, verifyAndParseStripeEvent, withRetry };
+export { ArxivIntegration, BaseIntegration, CLIIntegration, ConsoleLogger, DatabaseIntegration, DeepAgentIntegration, DockerIntegration, EmailIntegration, GitHubIntegration, IconifyIntegration, IntegrationError, IntegrationFactory, LLMIntegration, MLIntegration, OAuthIntegration, OtelIntegration, QueueIntegration, RedisIntegration, StorageIntegration, StripeIntegration, TwilioIntegration, WebhookIntegration, WikimediaIntegration, YouTubeIntegration, assertReadOnlySelect, getIntegration, getIntegrationFactory, getRegisteredIntegrations, isKnownIntegration, registerIntegration, resetIntegrationFactory, validateParams, verifyAndParseStripeEvent, withRetry };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map