@almadar/integrations 2.35.0 → 2.37.0

package/dist/runtime/index.js

@@ -55,8 +55,8 @@ var serviceCredentials = {
     { envVar: "TWILIO_PHONE_NUMBER", required: false, description: "Default sender phone number" }
   ],
   email: [
-    { envVar: "SENDGRID_API_KEY", required: false, description: "SendGrid API key (use this OR RESEND_API_KEY)" },
-    { envVar: "RESEND_API_KEY", required: false, description: "Resend API key (use this OR SENDGRID_API_KEY)" },
+    { envVar: "SENDGRID_API_KEY", required: false, oneOf: "provider", description: "SendGrid API key (use this OR RESEND_API_KEY)" },
+    { envVar: "RESEND_API_KEY", required: false, oneOf: "provider", description: "Resend API key (use this OR SENDGRID_API_KEY)" },
     { envVar: "FROM_EMAIL", required: false, description: "Default sender email address" }
   ],
   webhook: [
@@ -75,9 +75,9 @@ var serviceCredentials = {
     { envVar: "GOOGLE_CALENDAR_CHANNEL_TOKEN", required: false, description: "Watch-channel verification token \u2014 required to receive inbound calendar hooks (two-way sync)" }
   ],
   drive: [
-    { envVar: "GOOGLE_DRIVE_SA_KEY", required: false, description: "Google service-account key JSON (raw or base64) with drive scope \u2014 serves reads; store in Secret Manager, bind as env" },
+    { envVar: "GOOGLE_DRIVE_SA_KEY", required: false, oneOf: "auth", description: "Google service-account key JSON (raw or base64) with drive scope \u2014 serves reads; store in Secret Manager, bind as env" },
     { envVar: "GOOGLE_DRIVE_SUBJECT", required: false, description: "Workspace user to impersonate (domain-wide delegation); empty = act as the service account" },
-    { envVar: "GOOGLE_DRIVE_REFRESH_TOKEN", required: false, description: "User OAuth refresh token (drive-consent.mjs) \u2014 serves writes; SA uploads are impossible on personal accounts (no SA storage quota)" },
+    { envVar: "GOOGLE_DRIVE_REFRESH_TOKEN", required: false, oneOf: "auth", description: "User OAuth refresh token (drive-consent.mjs) \u2014 serves writes; SA uploads are impossible on personal accounts (no SA storage quota)" },
     { envVar: "GOOGLE_DRIVE_FOLDER_ID", required: false, description: "Default parent folder for uploads/new folders when the call names none" }
   ],
   metaAds: [
@@ -94,12 +94,13 @@ var serviceCredentials = {
     { envVar: "DOCUSIGN_ACCESS_TOKEN", required: true, description: "DocuSign OAuth access token (JWT grant rotation is the deployment concern)" }
   ],
   llm: [
-    { envVar: "ANTHROPIC_API_KEY", required: false, description: "Anthropic API key (use this OR OPENAI_API_KEY)" },
-    { envVar: "OPENAI_API_KEY", required: false, description: "OpenAI API key (use this OR ANTHROPIC_API_KEY)" }
+    { envVar: "ANTHROPIC_API_KEY", required: false, oneOf: "provider", description: "Anthropic API key (use this OR OPENAI_API_KEY)" },
+    { envVar: "OPENAI_API_KEY", required: false, oneOf: "provider", description: "OpenAI API key (use this OR ANTHROPIC_API_KEY)" },
+    { envVar: "LLM_PROVIDER", required: false, description: "Chat provider when several keys are set: anthropic | openai | deepseek | kimi | openrouter (default: the first key found)" }
   ],
   "llm-integration": [
-    { envVar: "ANTHROPIC_API_KEY", required: false, description: "Anthropic API key" },
-    { envVar: "OPENAI_API_KEY", required: false, description: "OpenAI API key" }
+    { envVar: "ANTHROPIC_API_KEY", required: false, oneOf: "provider", description: "Anthropic API key" },
+    { envVar: "OPENAI_API_KEY", required: false, oneOf: "provider", description: "OpenAI API key" }
   ],
   ml: [
     { envVar: "MASAR_URL", required: true, description: "Base URL of the deployed model-serving orbital" },
@@ -246,13 +247,14 @@ function validateParams(integration, action, params) {
     }
   }
   for (const paramDef of actionDef.params) {
-    if (paramDef.required && !(paramDef.name in params)) {
+    const provided = params[paramDef.name] !== void 0;
+    if (paramDef.required && !provided) {
       errors.push({
         param: paramDef.name,
         message: `Missing required parameter: ${paramDef.name}`
       });
     }
-    if (paramDef.name in params) {
+    if (provided) {
       const value = params[paramDef.name];
       const expectedType = paramDef.type;
       const actualType = typeof value;
@@ -333,6 +335,14 @@ var BaseIntegration = class {
   validateParams(action, params) {
     return validateParams(this.config.name, action, params);
   }
+  /** A rejected call: a real IntegrationError naming every failing param (kept in `details`). */
+  validationFailure(action, errors) {
+    const reasons = errors.map((e) => `${e.param}: ${e.message}`).join("; ");
+    const error = new IntegrationError(`Validation failed for ${this.config.name}.${action}: ${reasons}`, "VALIDATION_ERROR", errors);
+    error.integration = this.config.name;
+    error.action = action;
+    return { success: false, error, metadata: this.createMetadata(action, 0) };
+  }
   /**
    * Handle errors uniformly
    */
@@ -387,6 +397,9 @@ function registerIntegration(name, constructor) {
 function getIntegration(name) {
   return INTEGRATION_REGISTRY[name];
 }
+function getRegisteredIntegrations() {
+  return Object.keys(INTEGRATION_REGISTRY);
+}
 
 // src/factory.ts
 function instanceKey(name, principal) {
@@ -417,13 +430,13 @@ var IntegrationFactory = class {
     }
     const Constructor = getIntegration(name);
     if (!Constructor) {
-      throw new Error(`Unknown integration: ${name}. Make sure it's imported.`);
+      throw new IntegrationError(`Unknown integration: ${name}. Make sure it's imported.`, "UNKNOWN_INTEGRATION");
     }
     const config = this.configs.get(key) ?? this.configs.get(name);
     if (!config) {
-      throw new Error(
-        `Integration not configured: ${name}. Call configure() first.`
-      );
+      const envVars = (serviceCredentials[name] ?? []).map((c) => c.envVar);
+      const needs = envVars.length > 0 ? ` Set ${envVars.join(" / ")}.` : "";
+      throw new IntegrationError(`Integration not configured: ${name}.${needs}`, "NOT_CONFIGURED");
     }
     const instance = new Constructor(config);
     this.instances.set(key, instance);
@@ -572,18 +585,7 @@ var StripeIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     const retries = 0;
     try {
@@ -801,18 +803,7 @@ var YouTubeIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     let retries = 0;
     try {
@@ -906,18 +897,7 @@ var TwilioIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     let retries = 0;
     try {
@@ -991,18 +971,7 @@ var EmailIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     let retries = 0;
     try {
@@ -1075,8 +1044,11 @@ var EmailIntegration = class extends BaseIntegration {
       ...message.htmlBody ? { text: message.body } : {},
       ...message.replyTo ? { replyTo: message.replyTo } : {}
     });
+    if (response.error || !response.data) {
+      throw new Error(`Resend rejected the email: ${response.error?.message ?? "no message id returned"}`);
+    }
     return {
-      id: response.data?.id,
+      id: response.data.id,
       status: "sent"
     };
   }
@@ -1091,18 +1063,7 @@ var WebhookIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     let retries = 0;
     try {
@@ -1182,18 +1143,7 @@ var PushIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     let retries = 0;
     try {
@@ -1273,18 +1223,7 @@ var CalendarIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     let retries = 0;
     try {
@@ -1525,18 +1464,7 @@ var DriveIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     try {
       let data;
@@ -1672,18 +1600,7 @@ var MetaAdsIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     try {
       let data;
@@ -1771,18 +1688,7 @@ var AccountingIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     try {
       let data;
@@ -1850,18 +1756,7 @@ var BankingIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     try {
       let data;
@@ -1974,18 +1869,7 @@ var EsignIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     try {
       let data;
@@ -2122,18 +2006,7 @@ var LLMIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     try {
       let data;
@@ -2174,16 +2047,14 @@ var LLMIntegration = class extends BaseIntegration {
       maxTokens
     } = params;
     this.logger.debug("Generating content", { model, temperature });
-    const client = model ? new LLMClient({ provider: this.provider, model, temperature: temperature ?? 0.7 }) : this.getClient();
-    const response = await client.callWithMetadata({
+    const client = model !== void 0 || temperature !== void 0 ? new LLMClient({ provider: this.provider, model, temperature: temperature ?? 0.7 }) : this.getClient();
+    const response = await client.callRawWithMetadata({
       systemPrompt: systemPrompt || "You are a helpful assistant.",
       userPrompt,
-      maxTokens: maxTokens ?? 1024,
-      temperature,
-      skipSchemaValidation: true
+      maxTokens: maxTokens ?? 1024
     });
     return {
-      content: response.data,
+      content: response.raw,
       usage: response.usage ? {
         promptTokens: response.usage.promptTokens,
         completionTokens: response.usage.completionTokens,
@@ -2300,18 +2171,7 @@ var MLIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     try {
       let data;
@@ -2420,18 +2280,7 @@ var DeepAgentIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     let retries = 0;
     try {
@@ -2865,18 +2714,7 @@ var GitHubIntegration = class extends BaseIntegration {
    */
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     let retries = 0;
     try {
@@ -3167,18 +3005,7 @@ var RedisIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     try {
       let data;
@@ -3381,18 +3208,7 @@ var QueueIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     try {
       let data;
@@ -3591,18 +3407,7 @@ var OtelIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     try {
       let data;
@@ -3790,18 +3595,7 @@ var OAuthIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     try {
       let data;
@@ -4103,18 +3897,7 @@ var CredentialsIntegration = class extends BaseIntegration {
       }
     }
     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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     try {
       let data;
@@ -4315,18 +4098,7 @@ var StorageIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     try {
       let data;
@@ -4605,18 +4377,7 @@ var DockerIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     try {
       let data;
@@ -5041,18 +4802,7 @@ var DatabaseIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     try {
       let data;
@@ -5120,18 +4870,7 @@ var WikimediaIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     try {
       let data;
@@ -5189,18 +4928,7 @@ var IconifyIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     try {
       let data;
@@ -5299,18 +5027,7 @@ var ArxivIntegration = class extends BaseIntegration {
   }
   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)
-      };
-    }
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
     const startTime = Date.now();
     try {
       let data;
@@ -5349,6 +5066,18 @@ registerIntegration("arxiv", ArxivIntegration);
 var DEFAULT_BASE_URL = "http://127.0.0.1:8181";
 var DEFAULT_TIMEOUT_MS5 = 3e4;
 var DEFAULT_GENERATE_TIMEOUT_MS = 6e5;
+var GENERATE_MODELS = ["z-image-turbo", "kontext"];
+function generateParamErrors(params) {
+  const errors = [];
+  const model = params.model;
+  if (typeof model !== "string" || !GENERATE_MODELS.includes(model)) {
+    errors.push(`model must be one of ${GENERATE_MODELS.join(", ")}`);
+  }
+  if (model === "kontext" && (typeof params.sourcePath !== "string" || params.sourcePath === "")) {
+    errors.push("sourcePath is required when model is kontext");
+  }
+  return errors;
+}
 async function riggerError(path, response) {
   let detail = "";
   try {
@@ -5370,17 +5099,10 @@ var RiggerIntegration = class extends BaseIntegration {
   }
   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)
-      };
+    if (!validation.valid) return this.validationFailure(action, validation.errors);
+    if (action === "generate") {
+      const invalid = generateParamErrors(params);
+      if (invalid.length > 0) return this.validationFailure(action, invalid.map((message) => ({ param: "params", message })));
     }
     const startTime = Date.now();
     try {
@@ -5407,6 +5129,12 @@ var RiggerIntegration = class extends BaseIntegration {
         case "ownership":
           data = await this.executeWithRetry(() => this.ownership(params));
           break;
+        case "buildLayers":
+          data = await this.executeWithRetry(() => this.buildLayers(params));
+          break;
+        case "pose":
+          data = await this.executeWithRetry(() => this.pose(params));
+          break;
         case "generate":
           data = await this.executeWithRetry(() => this.generate(params));
           break;
@@ -5502,6 +5230,32 @@ var RiggerIntegration = class extends BaseIntegration {
     }
     return await response.json();
   }
+  async buildLayers(params) {
+    const { imagePath, rig, outDir } = params;
+    const response = await fetch(`${this.baseUrl}/layers`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ imagePath, rig, outDir }),
+      signal: AbortSignal.timeout(this.timeoutMs)
+    });
+    if (!response.ok) {
+      throw await riggerError("/layers", response);
+    }
+    return await response.json();
+  }
+  async pose(params) {
+    const { imagePath, rig, roles, preset, overrides } = params;
+    const response = await fetch(`${this.baseUrl}/pose`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ imagePath, rig, roles, preset, overrides }),
+      signal: AbortSignal.timeout(this.timeoutMs)
+    });
+    if (!response.ok) {
+      throw await riggerError("/pose", response);
+    }
+    return await response.json();
+  }
   async generate(params) {
     const { model, prompt, seed, size, steps, sourcePath, outDir } = params;
     const response = await fetch(`${this.baseUrl}/generate`, {
@@ -5577,29 +5331,42 @@ function createCallServiceHandler(factory) {
 }
 
 // src/runtime/RuntimeIntegrationManager.ts
-function generateMockFromShape(shape) {
-  const data = {};
-  for (const [key, type] of Object.entries(shape)) {
-    switch (type) {
+function mockValueForDescriptor(key, descriptor) {
+  if (typeof descriptor === "string") {
+    if (descriptor.endsWith("[]")) return [];
+    switch (descriptor) {
       case "string":
-        data[key] = `mock_${key}`;
-        break;
+        return `mock_${key}`;
       case "number":
-        data[key] = 42;
-        break;
+        return 42;
       case "boolean":
-        data[key] = true;
-        break;
+        return true;
       case "object":
-        data[key] = {};
-        break;
-      case "string[]":
-        data[key] = [];
-        break;
+        return {};
       default:
-        data[key] = `mock_${key}`;
+        return `mock_${key}`;
     }
   }
+  if (descriptor.type === "array") {
+    return descriptor.items ? [mockValueForDescriptor(`${key}Item`, descriptor.items)] : [];
+  }
+  if (descriptor.properties) {
+    const obj = {};
+    for (const [propKey, propDescriptor] of Object.entries(descriptor.properties)) {
+      obj[propKey] = mockValueForDescriptor(propKey, propDescriptor);
+    }
+    return obj;
+  }
+  if (descriptor.mapValue) {
+    return { sample: mockValueForDescriptor("sample", descriptor.mapValue) };
+  }
+  return {};
+}
+function generateMockFromShape(shape) {
+  const data = {};
+  for (const [key, descriptor] of Object.entries(shape)) {
+    data[key] = mockValueForDescriptor(key, descriptor);
+  }
   return data;
 }
 var RuntimeIntegrationManager = class {
@@ -5608,7 +5375,6 @@ var RuntimeIntegrationManager = class {
     this.storeEnvBase = null;
     this.storeFirst = false;
     this.factory = new IntegrationFactory();
-    this.installNotConfiguredFallback();
     installActiveFactory(this.factory);
   }
   /**
@@ -5668,37 +5434,6 @@ var RuntimeIntegrationManager = class {
     }
     this.configureFromEnv({ ...base, ...this.credentialStore.snapshotEnv() });
   }
-  /**
-   * Wrap `factory.execute` so an unknown/unconfigured service echoes its
-   * params instead of throwing. This makes the manager safe to install as a
-   * default `callService` handler (e.g. the playground sidecar) without every
-   * service being configured. REAL execution errors (API failures, bad
-   * params, schema violations) still propagate so the circuit's failure
-   * events fire — only the two "not set up" errors (`Unknown integration`,
-   * `Integration not configured`) are caught. Subsumes the broader wrapper
-   * that previously lived inside `configureMockMode`.
-   *
-   * In production the fallback is OFF: a missing key must surface as the
-   * circuit's failure event and a degraded health check, never a fake success.
-   */
-  installNotConfiguredFallback() {
-    const originalExecute = this.factory.execute.bind(this.factory);
-    this.factory.execute = async (integration, action, params, context) => {
-      try {
-        return await originalExecute(integration, action, params, context);
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        if (process.env.NODE_ENV !== "production" && /Unknown integration|not configured/i.test(msg)) {
-          return {
-            success: true,
-            data: { ...params, _mock: true, _service: integration, _action: action },
-            metadata: { integration, action, duration: 0, retries: 0, timestamp: Date.now() }
-          };
-        }
-        throw err;
-      }
-    };
-  }
   /**
    * Configure from environment variables.
    * In mock mode (USE_MOCK_DATA=true), all services return realistic mock data.
@@ -5855,7 +5590,7 @@ var RuntimeIntegrationManager = class {
     for (const k of ["ANTHROPIC_API_KEY", "OPENAI_API_KEY", "DEEPSEEK_API_KEY", "KIMI_API_KEY", "OPEN_ROUTER_API_KEY"]) {
       if (env[k]) llmEnv[k] = env[k];
     }
-    if (env.PROVIDER) llmEnv.PROVIDER = env.PROVIDER;
+    if (env.LLM_PROVIDER) llmEnv.PROVIDER = env.LLM_PROVIDER;
     for (const k of ["EMBEDDING_PROVIDER", "EMBEDDING_MODEL", "EMBEDDING_API_KEY"]) {
       if (env[k]) llmEnv[k] = env[k];
     }
@@ -5889,6 +5624,27 @@ var RuntimeIntegrationManager = class {
         }
       });
     }
+    this.configureFromDeclaredCredentials(env);
+  }
+  /**
+   * Every registered service the blocks above did not configure, configured
+   * from its declared credentials (`serviceCredentials`) once all its required
+   * ones are present: keyless services always, keyed ones only with their keys.
+   */
+  configureFromDeclaredCredentials(env) {
+    for (const name of getRegisteredIntegrations()) {
+      if (this.factory.isConfigured(name)) continue;
+      const declared = serviceCredentials[name] ?? [];
+      if (declared.some((c) => c.required && !env[c.envVar])) continue;
+      const groups = new Set(declared.flatMap((c) => c.oneOf ? [c.oneOf] : []));
+      if ([...groups].some((g) => !declared.some((c) => c.oneOf === g && env[c.envVar]))) continue;
+      const serviceEnv = {};
+      for (const { envVar } of declared) {
+        const value = env[envVar];
+        if (value) serviceEnv[envVar] = value;
+      }
+      this.factory.configure(name, { env: serviceEnv });
+    }
   }
   /**
    * Configure mock mode: register MockIntegration for all known services