@almadar/integrations 2.17.0 → 2.19.0

package/dist/{contracts-DMzkrcLB.d.ts → contracts-B28G_7ur.d.ts}

@@ -1,4 +1,4 @@
-import { ServiceParams } from '@almadar/core';
+import { ServiceParamsValue, ServiceParams } from '@almadar/core';
 import { d as IntegrationParams } from './BaseIntegration-B9lSTRQm.js';
 
 /**
@@ -235,6 +235,19 @@ type LLMIntegrationActions = {
         };
     };
 };
+type MLActions = {
+    infer: {
+        params: {
+            model: string;
+            input: ServiceParamsValue;
+        };
+        result: {
+            output: ServiceParamsValue;
+            confidence: number;
+            violations: ServiceParamsValue[];
+        };
+    };
+};
 type YouTubeActions = {
     search: {
         params: {
@@ -852,6 +865,7 @@ type IntegrationContracts = {
     github: GitHubActions;
     stripe: StripeActions;
     llm: LLMIntegrationActions;
+    ml: MLActions;
     youtube: YouTubeActions;
     twilio: TwilioActions;
     email: EmailActions;
@@ -877,4 +891,4 @@ type IntegrationName = keyof IntegrationContracts;
  */
 type IntegrationActionName<K extends IntegrationName> = keyof IntegrationContracts[K] & string;
 
-export type { CLIActions as C, DeepAgentActions as D, EmailActions as E, GitHubActions as G, IntegrationActionName as I, LLMIntegrationActions as L, OAuthActions as O, QueueActions as Q, RedisActions as R, StorageActions as S, TwilioActions as T, YouTubeActions as Y, DockerActions as a, IntegrationContracts as b, IntegrationName as c, OtelActions as d, StripeActions as e };
+export type { CLIActions as C, DeepAgentActions as D, EmailActions as E, GitHubActions as G, IntegrationActionName as I, LLMIntegrationActions as L, MLActions as M, OAuthActions as O, QueueActions as Q, RedisActions as R, StorageActions as S, TwilioActions as T, YouTubeActions as Y, DockerActions as a, IntegrationContracts as b, IntegrationName as c, OtelActions as d, StripeActions as e };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { c as IntegrationLogger, b as IntegrationErrorCode, I as IntegrationConfig, B as BaseIntegration, d as IntegrationParams, e as IntegrationResult } from './BaseIntegration-B9lSTRQm.js';
 export { a as IntegrationError, V as ValidationError, f as ValidationResult, v as validateParams } from './BaseIntegration-B9lSTRQm.js';
-export { C as CLIActions, D as DeepAgentActions, a as DockerActions, E as EmailActions, G as GitHubActions, I as IntegrationActionName, b as IntegrationContracts, c as IntegrationName, L as LLMIntegrationActions, O as OAuthActions, d as OtelActions, Q as QueueActions, R as RedisActions, S as StorageActions, e as StripeActions, T as TwilioActions, Y as YouTubeActions } from './contracts-DMzkrcLB.js';
+export { C as CLIActions, D as DeepAgentActions, a as DockerActions, E as EmailActions, G as GitHubActions, I as IntegrationActionName, b as IntegrationContracts, c as IntegrationName, L as LLMIntegrationActions, M as MLActions, O as OAuthActions, d as OtelActions, Q as QueueActions, R as RedisActions, S as StorageActions, e as StripeActions, T as TwilioActions, Y as YouTubeActions } from './contracts-B28G_7ur.js';
 import { LogMeta } from '@almadar/core';
 export { I as IntegrationFactory, g as getIntegrationFactory, r as resetIntegrationFactory } from './factory-TNgVDujm.js';
 export { GitHubIntegration } from './integrations/github/index.js';
@@ -366,6 +366,15 @@ declare class LLMIntegration extends BaseIntegration {
     private summarize;
 }
 
+declare class MLIntegration extends BaseIntegration {
+    private readonly eventsUrl;
+    private readonly timeoutMs;
+    constructor(config: IntegrationConfig);
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
+    private infer;
+    private postEvent;
+}
+
 /**
  * DeepAgent integration for AI code generation
  */
@@ -551,4 +560,4 @@ declare class DockerIntegration extends BaseIntegration {
     private list;
 }
 
-export { type AlmadarCheckoutSession, type AlmadarCustomer, type AlmadarInvoiceFailure, type AlmadarInvoicePayment, type AlmadarPortalSession, type AlmadarStripeEvent, type AlmadarStripeEventOk, type AlmadarSubscription, type AlmadarSubscriptionStatus, type AlmadarTier, BaseIntegration, CLIIntegration, type CancelSubscriptionInput, ConsoleLogger, type CreateCheckoutInput, type CreateCustomerInput, type CreatePortalInput, DeepAgentIntegration, DockerIntegration, EmailIntegration, IntegrationConfig, type IntegrationConstructor, IntegrationErrorCode, IntegrationLogger, IntegrationResult, LLMIntegration, OAuthIntegration, OtelIntegration, QueueIntegration, RedisIntegration, type RetryConfig, StorageIntegration, StripeIntegration, type StripePriceMap, TwilioIntegration, type UpdateSubscriptionInput, type VerifyAndParseInput, YouTubeIntegration, 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, BaseIntegration, CLIIntegration, type CancelSubscriptionInput, ConsoleLogger, type CreateCheckoutInput, type CreateCustomerInput, type CreatePortalInput, DeepAgentIntegration, DockerIntegration, EmailIntegration, IntegrationConfig, type IntegrationConstructor, IntegrationErrorCode, IntegrationLogger, IntegrationResult, LLMIntegration, MLIntegration, OAuthIntegration, OtelIntegration, QueueIntegration, RedisIntegration, type RetryConfig, StorageIntegration, StripeIntegration, type StripePriceMap, TwilioIntegration, type UpdateSubscriptionInput, type VerifyAndParseInput, YouTubeIntegration, getIntegration, getRegisteredIntegrations, isKnownIntegration, registerIntegration, verifyAndParseStripeEvent, withRetry };

package/dist/index.js

@@ -1121,6 +1121,179 @@ Return ONLY valid JSON matching the schema.`,
 };
 registerIntegration("llm", LLMIntegration);
 
+// src/types.ts
+var IntegrationError = class extends Error {
+  constructor(message, code = "UNKNOWN_ERROR", details) {
+    super(message);
+    this.name = "IntegrationError";
+    this.code = code;
+    this.details = details;
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      code: this.code,
+      integration: this.integration,
+      action: this.action,
+      details: this.details
+    };
+  }
+};
+
+// src/integrations/ml/index.ts
+var INFERRED_EVENT = "INFERRED";
+var INFER_FAILED_EVENT = "INFER_FAILED";
+var DEFAULT_TIMEOUT_MS = 6e4;
+function isServiceParams(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) && !(value instanceof Date);
+}
+function extractInferResult(response) {
+  const emitted = (response.effectResults ?? []).find(
+    (result) => result.effect === "emit" && result.success && isServiceParams(result.data) && result.data.event === INFERRED_EVENT
+  );
+  if (!emitted || !isServiceParams(emitted.data)) {
+    return null;
+  }
+  const payload = emitted.data.payload;
+  if (!isServiceParams(payload)) {
+    return null;
+  }
+  if (!("output" in payload) || typeof payload.confidence !== "number" || !Array.isArray(payload.violations)) {
+    return null;
+  }
+  return {
+    output: payload.output,
+    confidence: payload.confidence,
+    violations: payload.violations
+  };
+}
+var MLIntegration = class extends BaseIntegration {
+  constructor(config) {
+    super(config);
+    const baseUrl = config.env.MASAR_URL;
+    const traitPrefix = config.env.MASAR_ML_TRAIT;
+    if (!baseUrl || !traitPrefix) {
+      throw new Error(
+        "ML integration requires MASAR_URL (serving orbital host) and MASAR_ML_TRAIT (kebab-case trait name of its /events route) to be configured"
+      );
+    }
+    this.eventsUrl = `${baseUrl.replace(/\/+$/, "")}/api/${traitPrefix}/events`;
+    this.timeoutMs = config.env.MASAR_ML_TIMEOUT_MS ? Number(config.env.MASAR_ML_TIMEOUT_MS) : DEFAULT_TIMEOUT_MS;
+    this.logger.info("ML integration initialized", { eventsUrl: this.eventsUrl });
+  }
+  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();
+    try {
+      let data;
+      switch (action) {
+        case "infer":
+          data = await this.executeWithRetry(() => this.infer(params));
+          break;
+        default:
+          throw new Error(`Unknown action: ${action}`);
+      }
+      return {
+        success: true,
+        data,
+        metadata: this.createMetadata(action, Date.now() - startTime)
+      };
+    } catch (error) {
+      return this.handleError(action, error);
+    }
+  }
+  async infer(params) {
+    const { model, input } = params;
+    this.logger.debug("Running ML inference", { model });
+    const response = await this.postEvent(model, input);
+    if (!response.success) {
+      throw new IntegrationError(
+        `ML service reported failure: ${response.error ?? "unknown error"}`,
+        "SERVICE_ERROR",
+        { model, response }
+      );
+    }
+    const failed = (response.effectResults ?? []).find(
+      (result) => result.effect === "emit" && isServiceParams(result.data) && result.data.event === INFER_FAILED_EVENT
+    );
+    if (failed) {
+      throw new IntegrationError(
+        `ML service could not infer: ${failed.error ?? "model unavailable"}`,
+        "SERVICE_ERROR",
+        { model, response }
+      );
+    }
+    const inferred = extractInferResult(response);
+    if (!inferred) {
+      throw new IntegrationError(
+        "ML service response did not include a valid inference result",
+        "SERVICE_ERROR",
+        { model, response }
+      );
+    }
+    return inferred;
+  }
+  async postEvent(model, input) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+    let httpResponse;
+    try {
+      httpResponse = await fetch(this.eventsUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ event: "INFER", payload: { model, input } }),
+        signal: controller.signal
+      });
+    } catch (error) {
+      if (error instanceof DOMException && error.name === "AbortError") {
+        throw new IntegrationError(
+          `ML service request timed out after ${this.timeoutMs}ms (model may be cold-starting)`,
+          "TIMEOUT_ERROR",
+          { model, eventsUrl: this.eventsUrl }
+        );
+      }
+      throw new IntegrationError(
+        `ML service request failed: ${error instanceof Error ? error.message : String(error)}`,
+        "NETWORK_ERROR",
+        { model, eventsUrl: this.eventsUrl }
+      );
+    } finally {
+      clearTimeout(timer);
+    }
+    if (!httpResponse.ok) {
+      const body = await httpResponse.text().catch(() => "");
+      throw new IntegrationError(
+        `ML service responded with status ${httpResponse.status}`,
+        "SERVICE_ERROR",
+        { model, status: httpResponse.status, body }
+      );
+    }
+    try {
+      return await httpResponse.json();
+    } catch (error) {
+      throw new IntegrationError(
+        `ML service returned a malformed response body: ${error instanceof Error ? error.message : String(error)}`,
+        "SERVICE_ERROR",
+        { model }
+      );
+    }
+  }
+};
+registerIntegration("ml", MLIntegration);
+
 // src/integrations/deepagent/index.ts
 var DeepAgentIntegration = class extends BaseIntegration {
   constructor(config) {
@@ -1242,28 +1415,6 @@ var DeepAgentIntegration = class extends BaseIntegration {
   }
 };
 registerIntegration("deepagent", DeepAgentIntegration);
-
-// src/types.ts
-var IntegrationError = class extends Error {
-  constructor(message, code = "UNKNOWN_ERROR", details) {
-    super(message);
-    this.name = "IntegrationError";
-    this.code = code;
-    this.details = details;
-  }
-  toJSON() {
-    return {
-      name: this.name,
-      message: this.message,
-      code: this.code,
-      integration: this.integration,
-      action: this.action,
-      details: this.details
-    };
-  }
-};
-
-// src/integrations/github/github-git.ts
 async function execGit(args, cwd, env) {
   return new Promise((resolve, reject) => {
     const proc = spawn("git", args, {
@@ -3021,6 +3172,6 @@ var DockerIntegration = class extends BaseIntegration {
 };
 registerIntegration("docker", DockerIntegration);
 
-export { BaseIntegration, CLIIntegration, ConsoleLogger, DeepAgentIntegration, DockerIntegration, EmailIntegration, GitHubIntegration, IntegrationFactory, LLMIntegration, OAuthIntegration, OtelIntegration, QueueIntegration, RedisIntegration, StorageIntegration, StripeIntegration, TwilioIntegration, YouTubeIntegration, getIntegration, getIntegrationFactory, getRegisteredIntegrations, isKnownIntegration, registerIntegration, resetIntegrationFactory, validateParams, verifyAndParseStripeEvent, withRetry };
+export { BaseIntegration, CLIIntegration, ConsoleLogger, DeepAgentIntegration, DockerIntegration, EmailIntegration, GitHubIntegration, IntegrationFactory, LLMIntegration, MLIntegration, OAuthIntegration, OtelIntegration, QueueIntegration, RedisIntegration, StorageIntegration, StripeIntegration, TwilioIntegration, YouTubeIntegration, getIntegration, getIntegrationFactory, getRegisteredIntegrations, isKnownIntegration, registerIntegration, resetIntegrationFactory, validateParams, verifyAndParseStripeEvent, withRetry };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map