loopengine 0.1.94 → 0.1.97

package/dist/web/global-config.d.ts

@@ -1,6 +1,6 @@
 import type { AgentConfig } from '../core/agent-config.js';
 export interface ModelProviderInfo {
-    provider: 'anthropic' | 'openai' | 'deepseek' | 'kimi' | 'glm' | 'gemini';
+    provider: 'anthropic' | 'openai' | 'deepseek' | 'kimi' | 'glm' | 'gemini' | 'xai' | 'meta';
     envVar: string;
     configured: boolean;
 }
@@ -69,6 +69,49 @@ export declare function modelKeyEnvVar(provider: string): string | undefined;
  */
 export declare function setModelProviderKey(provider: string, key: unknown): Promise<void>;
 export declare function clearModelProviderKey(provider: string): Promise<void>;
+export interface ProviderModelsView {
+    provider: string;
+    /** Model ids to offer, newest first where the provider says when each
+     * was released. Empty when they couldn't be listed (see `error`). */
+    models: string[];
+    /** Why the list is short or empty: no key saved (only common models,
+     * if any, are listed), or the provider refused or timed out. Shown
+     * under the dropdown. */
+    error?: string;
+}
+export declare const MODELS_FILE_ENV = "LOOPENGINE_MODELS_FILE";
+/** models.yaml in the project root (where .env is), or the file
+ * LOOPENGINE_MODELS_FILE names (absolute, or relative to the root). */
+export declare function modelsFilePath(): string;
+/**
+ * The hand-edited model lists in models.yaml: provider name to the models
+ * its dropdown offers, in order.
+ *
+ *   anthropic:
+ *     - claude-opus-5-5
+ *     - claude-sonnet-5-5
+ *
+ * Read fresh on every call (it's a few lines), so an edit shows the next
+ * time a dropdown loads. A missing file is no lists; a malformed one is
+ * reported in `error` and ignored as a whole, so a typo can't hide one
+ * provider's models while the rest still load.
+ */
+export declare function readModelsFile(): {
+    models: Partial<Record<ModelProviderInfo['provider'], string[]>>;
+    error?: string;
+};
+/**
+ * The models a provider offers, for the model dropdown in the New agent
+ * and Model forms. A provider listed in models.yaml (readModelsFile)
+ * offers exactly that list, with no key needed. Otherwise this asks the
+ * provider itself with the saved key (cached for ten minutes per key),
+ * so new models show up without a release. Never throws for a provider
+ * problem: the view carries an `error` instead, and the form lets the
+ * model name be typed. Throws ModelKeyError for an unknown provider.
+ */
+export declare function listProviderModels(provider: string, options?: {
+    fetch?: typeof fetch;
+}): Promise<ProviderModelsView>;
 export declare class TimeZoneError extends Error {
 }
 export interface TimeZoneView {

package/dist/web/global-config.js

@@ -1,3 +1,17 @@
+// Backs the global /config page's Models and Gateways sections (see
+// web/agents-config-page.ts's left sidebar) — the account-wide,
+// not-scoped-to-one-agent counterpart to that page's existing per-agent
+// Overview/Skills/Tools/ActAuth tabs. "Global" here means: which model
+// providers this deployment can actually call (an API-key-in-env-vars
+// question, same everywhere regardless of which agent is running) and
+// which gateway providers (Composio today) this machine's CLI session
+// is authenticated against — neither is a property of any one
+// AgentConfig.
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import Anthropic from '@anthropic-ai/sdk';
+import OpenAI from 'openai';
+import { parse as parseYaml } from 'yaml';
 import { getComposioAuthStatus } from '../core/gateway-tools.js';
 import { moveScheduledTasksToTimeZone } from '../core/scheduler.js';
 import { TIME_ZONE_ENV, isValidTimeZone, listTimeZones, serverTimeZone, workspaceTimeZone } from '../core/time-zone.js';
@@ -10,14 +24,17 @@ export class ModelKeyError extends Error {
 // union from; adding a fourth provider means one more line here and one
 // more arm in that union, not a rewrite.
 const KNOWN_PROVIDERS = [
-    { provider: 'anthropic', envVar: 'ANTHROPIC_API_KEY' },
     { provider: 'openai', envVar: 'OPENAI_API_KEY' },
+    { provider: 'anthropic', envVar: 'ANTHROPIC_API_KEY' },
+    { provider: 'gemini', envVar: 'GEMINI_API_KEY' },
+    // LiteLLM's name; see core/model-calls/meta-model-call.ts.
+    { provider: 'meta', envVar: 'META_API_KEY' },
+    { provider: 'xai', envVar: 'XAI_API_KEY' },
     { provider: 'deepseek', envVar: 'DEEPSEEK_API_KEY' },
     // Moonshot AI's own env var name, not KIMI_API_KEY — see
     // core/model-calls/kimi-model-call.ts's own header comment for why.
     { provider: 'kimi', envVar: 'MOONSHOT_API_KEY' },
     { provider: 'glm', envVar: 'GLM_API_KEY' },
-    { provider: 'gemini', envVar: 'GEMINI_API_KEY' },
 ];
 /** Every registered agent's resolved model, alongside whether each
  * supported provider actually has credentials available in this
@@ -104,6 +121,149 @@ export async function clearModelProviderKey(provider) {
         throw new ModelKeyError(`unknown provider '${provider}'`);
     await unsetEnvVar(envVar);
 }
+// The OpenAI-compatible providers' base URLs, the same ones their
+// model-calls/*.ts use (OpenAI's own comes from the SDK, so
+// OPENAI_BASE_URL applies to both). Anthropic has its own models API.
+const OPENAI_COMPATIBLE_BASE_URLS = {
+    deepseek: 'https://api.deepseek.com',
+    kimi: 'https://api.moonshot.ai/v1',
+    glm: 'https://open.bigmodel.cn/api/paas/v4/',
+    gemini: 'https://generativelanguage.googleapis.com/v1beta/openai/',
+    xai: 'https://api.x.ai/v1',
+    meta: 'https://api.meta.ai/v1',
+};
+// OpenAI and Gemini also list models a chat agent can't use.
+const NON_CHAT_MODEL = /embed|tts|whisper|dall-e|davinci|babbage|moderation|transcribe|image|audio|realtime|search|aqa|imagen|veo|sora/i;
+// Offered when the provider's own list isn't available (no key saved
+// yet, or the provider refused) and models.yaml doesn't list it. Only
+// names checked against the provider's docs (2026-10-31); other
+// providers need a key to list theirs. Meta's "-contributor" variants are
+// left out, since choosing one lets Meta train on the requests; type one
+// under "Other" to use it.
+const KNOWN_MODELS = {
+    anthropic: ['claude-fable-5-1', 'claude-opus-5-5', 'claude-sonnet-5-5', 'claude-haiku-5-5', 'claude-sonnet-5'],
+    deepseek: ['deepseek-v4-pro', 'deepseek-flash'],
+    meta: ['muse-spark-1.3', 'muse-wonder-1.0', 'muse-spark-1.2', 'muse-spark-1.1'],
+};
+const MODEL_LIST_TTL_MS = 10 * 60 * 1000;
+const modelListCache = new Map();
+export const MODELS_FILE_ENV = 'LOOPENGINE_MODELS_FILE';
+/** models.yaml in the project root (where .env is), or the file
+ * LOOPENGINE_MODELS_FILE names (absolute, or relative to the root). */
+export function modelsFilePath() {
+    return resolve(process.cwd(), process.env[MODELS_FILE_ENV]?.trim() || 'models.yaml');
+}
+/**
+ * The hand-edited model lists in models.yaml: provider name to the models
+ * its dropdown offers, in order.
+ *
+ *   anthropic:
+ *     - claude-opus-5-5
+ *     - claude-sonnet-5-5
+ *
+ * Read fresh on every call (it's a few lines), so an edit shows the next
+ * time a dropdown loads. A missing file is no lists; a malformed one is
+ * reported in `error` and ignored as a whole, so a typo can't hide one
+ * provider's models while the rest still load.
+ */
+export function readModelsFile() {
+    const path = modelsFilePath();
+    if (!existsSync(path))
+        return { models: {} };
+    const name = process.env[MODELS_FILE_ENV]?.trim() || 'models.yaml';
+    let data;
+    try {
+        data = parseYaml(readFileSync(path, 'utf8'));
+    }
+    catch (err) {
+        return { models: {}, error: `${name} isn't valid YAML: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    if (data == null)
+        return { models: {} };
+    if (typeof data !== 'object' || Array.isArray(data))
+        return { models: {}, error: `${name} should map each provider to a list of models.` };
+    const models = {};
+    for (const [provider, list] of Object.entries(data)) {
+        if (!modelKeyEnvVar(provider)) {
+            return { models: {}, error: `${name}: unknown provider '${provider}'. Use one of ${KNOWN_PROVIDERS.map((p) => p.provider).join(', ')}.` };
+        }
+        // An empty key ("openai:") means no list, same as leaving it out.
+        if (list == null)
+            continue;
+        if (!Array.isArray(list) || list.some((m) => typeof m !== 'string' || !m.trim())) {
+            return { models: {}, error: `${name}: '${provider}' should be a list of model names.` };
+        }
+        models[provider] = [...new Set(list.map((m) => m.trim()))];
+    }
+    return { models };
+}
+/**
+ * The models a provider offers, for the model dropdown in the New agent
+ * and Model forms. A provider listed in models.yaml (readModelsFile)
+ * offers exactly that list, with no key needed. Otherwise this asks the
+ * provider itself with the saved key (cached for ten minutes per key),
+ * so new models show up without a release. Never throws for a provider
+ * problem: the view carries an `error` instead, and the form lets the
+ * model name be typed. Throws ModelKeyError for an unknown provider.
+ */
+export async function listProviderModels(provider, options = {}) {
+    const envVar = modelKeyEnvVar(provider);
+    if (!envVar)
+        throw new ModelKeyError(`unknown provider '${provider}'`);
+    const file = readModelsFile();
+    const fromFile = file.models[provider];
+    if (fromFile)
+        return { provider, models: fromFile };
+    const view = await listProviderModelsLive(provider, envVar, options);
+    return file.error ? { ...view, error: view.error ? `${file.error} ${view.error}` : file.error } : view;
+}
+async function listProviderModelsLive(provider, envVar, options) {
+    const key = process.env[envVar];
+    if (!key) {
+        const known = KNOWN_MODELS[provider] ?? [];
+        return {
+            provider,
+            models: known,
+            error: known.length
+                ? `Showing common ${provider} models. Save ${envVar} on the Models page to list all of them.`
+                : `No ${envVar} saved. Save it on the Models page to list ${provider}'s models, or choose Other.`,
+        };
+    }
+    const cached = modelListCache.get(provider);
+    if (cached && cached.key === key && Date.now() - cached.at < MODEL_LIST_TTL_MS)
+        return { provider, models: cached.models };
+    const clientOptions = { apiKey: key, timeout: 10_000, maxRetries: 0, ...(options.fetch ? { fetch: options.fetch } : {}) };
+    try {
+        const listed = [];
+        if (provider === 'anthropic') {
+            // Already newest first.
+            for await (const model of new Anthropic(clientOptions).models.list({ limit: 1000 })) {
+                listed.push({ id: model.id, created: 0 });
+            }
+        }
+        else {
+            const client = new OpenAI({ ...clientOptions, baseURL: OPENAI_COMPATIBLE_BASE_URLS[provider] });
+            for await (const model of client.models.list()) {
+                // Gemini's ids come back as "models/gemini-...", but its chat
+                // endpoint takes the bare name.
+                listed.push({ id: model.id.replace(/^models\//, ''), created: model.created ?? 0 });
+            }
+        }
+        const models = listed
+            .filter((model) => (provider === 'openai' || provider === 'gemini' ? !NON_CHAT_MODEL.test(model.id) : true))
+            .sort((a, b) => b.created - a.created)
+            .map((model) => model.id)
+            .filter((id, index, ids) => ids.indexOf(id) === index);
+        modelListCache.set(provider, { key, at: Date.now(), models });
+        return { provider, models };
+    }
+    catch (err) {
+        const known = KNOWN_MODELS[provider];
+        if (known)
+            return { provider, models: known };
+        return { provider, models: [], error: `Couldn't list ${provider}'s models: ${err instanceof Error ? err.message : String(err)}` };
+    }
+}
 export class TimeZoneError extends Error {
 }
 export function describeTimeZone() {

package/dist/web/interview-admin.js

@@ -126,7 +126,7 @@ export function setupChecklist(candidate, agentName) {
             case 'ability':
                 return { label: `Install the ${need.name ?? need.description} ability`, href: tab('abilities') };
             case 'api':
-                return { label: `Connect ${need.description} (an HTTP tool, or an MCP server)`, href: tab('tools') };
+                return { label: `Connect ${need.description} (an HTTP tool, or an MCP server)`, href: tab('advanced') };
             case 'key':
                 return { label: `Add ${need.description}`, href: tab('env') };
             case 'messaging':
@@ -239,7 +239,7 @@ export function interviewTools(agents) {
             return results.slice(0, 10).map((r) => ({ name: r.name, ...(r.description ? { description: r.description } : {}) }));
         },
         async listConnections() {
-            const providers = ['anthropic', 'openai', 'deepseek', 'kimi', 'glm', 'gemini'].filter((p) => {
+            const providers = ['openai', 'anthropic', 'gemini', 'meta', 'xai', 'deepseek', 'kimi', 'glm'].filter((p) => {
                 const envVar = modelKeyEnvVar(p);
                 return envVar ? Boolean(process.env[envVar]) : false;
             });

package/dist/web/messaging-icons.d.ts

@@ -0,0 +1,2 @@
+import type { NotifierFileChannel } from '../core/notifier-file.js';
+export declare const MESSAGING_ICONS: Record<NotifierFileChannel, string>;

package/dist/web/messaging-icons.js

@@ -0,0 +1,7 @@
+export const MESSAGING_ICONS = {
+    webhook: '<svg class="le-channel-icon" aria-hidden="true" focusable="false" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" > <path d="M18 16.98h-5.99c-1.1 0-1.95.94-2.48 1.9A4 4 0 0 1 2 17c.01-.7.2-1.4.57-2" /> <path d="m6 17 3.13-5.78c.53-.97.1-2.18-.5-3.1a4 4 0 1 1 6.89-4.06" /> <path d="m12 6 3.13 5.73C15.66 12.7 16.9 13 18 13a4 4 0 0 1 0 8" /> </svg>',
+    telegram: '<svg class="le-channel-icon" aria-hidden="true" focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg" fill="#26A5E4"><path d="M11.944 0A12 12 0 0 0 0 12a12 12 0 0 0 12 12 12 12 0 0 0 12-12A12 12 0 0 0 12 0a12 12 0 0 0-.056 0zm4.962 7.224c.1-.002.321.023.465.14a.506.506 0 0 1 .171.325c.016.093.036.306.02.472-.18 1.898-.962 6.502-1.36 8.627-.168.9-.499 1.201-.82 1.23-.696.065-1.225-.46-1.9-.902-1.056-.693-1.653-1.124-2.678-1.8-1.185-.78-.417-1.21.258-1.91.177-.184 3.247-2.977 3.307-3.23.007-.032.014-.15-.056-.212s-.174-.041-.249-.024c-.106.024-1.793 1.14-5.061 3.345-.48.33-.913.49-1.302.48-.428-.008-1.252-.241-1.865-.44-.752-.245-1.349-.374-1.297-.789.027-.216.325-.437.893-.663 3.498-1.524 5.83-2.529 6.998-3.014 3.332-1.386 4.025-1.627 4.476-1.635z"/></svg>',
+    slack: '<svg class="le-channel-icon" aria-hidden="true" focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg" fill="currentColor"><path d="M5.042 15.165a2.528 2.528 0 0 1-2.52 2.523A2.528 2.528 0 0 1 0 15.165a2.527 2.527 0 0 1 2.522-2.52h2.52v2.52zM6.313 15.165a2.527 2.527 0 0 1 2.521-2.52 2.527 2.527 0 0 1 2.521 2.52v6.313A2.528 2.528 0 0 1 8.834 24a2.528 2.528 0 0 1-2.521-2.522v-6.313zM8.834 5.042a2.528 2.528 0 0 1-2.521-2.52A2.528 2.528 0 0 1 8.834 0a2.528 2.528 0 0 1 2.521 2.522v2.52H8.834zM8.834 6.313a2.528 2.528 0 0 1 2.521 2.521 2.528 2.528 0 0 1-2.521 2.521H2.522A2.528 2.528 0 0 1 0 8.834a2.528 2.528 0 0 1 2.522-2.521h6.312zM18.956 8.834a2.528 2.528 0 0 1 2.522-2.521A2.528 2.528 0 0 1 24 8.834a2.528 2.528 0 0 1-2.522 2.521h-2.522V8.834zM17.688 8.834a2.528 2.528 0 0 1-2.523 2.521 2.527 2.527 0 0 1-2.52-2.521V2.522A2.527 2.527 0 0 1 15.165 0a2.528 2.528 0 0 1 2.523 2.522v6.312zM15.165 18.956a2.528 2.528 0 0 1 2.523 2.522A2.528 2.528 0 0 1 15.165 24a2.527 2.527 0 0 1-2.52-2.522v-2.522h2.52zM15.165 17.688a2.527 2.527 0 0 1-2.52-2.523 2.526 2.526 0 0 1 2.52-2.52h6.313A2.527 2.527 0 0 1 24 15.165a2.528 2.528 0 0 1-2.522 2.523h-6.313z"/></svg>',
+    lark: '<svg class="le-channel-icon" aria-hidden="true" focusable="false" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M12.9238 12.8029C12.9427 12.784 12.9616 12.7682 12.9806 12.7493C13.0184 12.7146 13.0563 12.6767 13.091 12.6389L13.1667 12.5631L13.397 12.336L14.7315 11.0173L15.0659 10.686C15.129 10.6229 15.1952 10.563 15.2615 10.5031C15.3845 10.3926 15.5076 10.2854 15.6369 10.1813C15.7536 10.0866 15.8767 9.99514 15.9997 9.9068C16.1732 9.78376 16.3499 9.67019 16.5329 9.55977C16.7127 9.45251 16.8957 9.35471 17.085 9.26322C17.2616 9.17804 17.4415 9.09917 17.6276 9.02661C17.7317 8.9856 17.8326 8.94774 17.9399 8.91304C17.9935 8.89411 18.044 8.87834 18.0977 8.86256C17.6276 7.00439 16.7632 5.3008 15.5991 3.84959C15.3719 3.56566 15.0249 3.40161 14.6589 3.40161H5.0084C4.83489 3.40161 4.76233 3.6256 4.90114 3.72656C8.18528 6.13997 10.9236 9.24114 12.9017 12.825C12.908 12.8187 12.9175 12.8124 12.9238 12.8029Z" fill="#00D6B9" /><path d="M9.09696 21.2986C14.0815 21.2986 18.4225 18.5476 20.6877 14.4843C20.7666 14.3423 20.8454 14.1972 20.918 14.052C20.8044 14.2729 20.6751 14.4811 20.5394 14.6767C20.4889 14.7461 20.4385 14.8155 20.388 14.8818C20.3217 14.9669 20.2555 15.049 20.1861 15.1278C20.1324 15.1909 20.0757 15.2509 20.0189 15.3108C19.9021 15.4307 19.7823 15.5474 19.6561 15.6547C19.5867 15.7146 19.5141 15.7714 19.4415 15.8282C19.3564 15.8944 19.268 15.9575 19.1797 16.0143C19.1229 16.0522 19.0661 16.09 19.0093 16.1247C18.9494 16.1626 18.8895 16.1973 18.8264 16.232C18.7002 16.3014 18.574 16.3645 18.4446 16.4245C18.3311 16.4749 18.2175 16.5223 18.1008 16.5633C17.9746 16.6106 17.8452 16.6516 17.7159 16.6863C17.5234 16.7399 17.3247 16.7809 17.1259 16.8125C16.9808 16.8346 16.8357 16.8504 16.6874 16.863C16.5328 16.8724 16.3751 16.8787 16.2173 16.8756C16.0438 16.8724 15.8703 16.863 15.6936 16.844C15.5643 16.8314 15.435 16.8125 15.3056 16.7873C15.192 16.7683 15.0785 16.7431 14.9649 16.7178C14.9049 16.7021 14.845 16.6895 14.7851 16.6737C14.6179 16.6295 14.4538 16.5822 14.2898 16.5349C14.2077 16.5096 14.1257 16.4875 14.0437 16.4623C13.9206 16.4245 13.7976 16.3897 13.6777 16.3519C13.5768 16.3203 13.479 16.2888 13.378 16.2572C13.2834 16.2257 13.1887 16.1942 13.0941 16.1626C13.031 16.1405 12.9647 16.1184 12.9016 16.0964C12.8228 16.0711 12.7471 16.0427 12.6682 16.0143C12.6114 15.9954 12.5578 15.9765 12.501 15.9544C12.3906 15.9134 12.2802 15.8755 12.1729 15.8345C12.1098 15.8093 12.0467 15.7872 11.9836 15.7619C11.8984 15.7304 11.8132 15.6957 11.7312 15.6641C11.6429 15.6294 11.5514 15.5947 11.4631 15.5569C11.4063 15.5348 11.3463 15.5096 11.2895 15.4875C11.217 15.4591 11.1476 15.4275 11.075 15.3991C11.0214 15.3771 10.9646 15.3518 10.911 15.3297C10.8542 15.3045 10.7974 15.2793 10.7406 15.254C10.6901 15.2319 10.6428 15.2099 10.5923 15.1878C10.5482 15.1688 10.5008 15.1468 10.4567 15.1278C10.4094 15.1057 10.3652 15.0868 10.3179 15.0647C10.2705 15.0427 10.2232 15.0206 10.1759 14.9985C10.116 14.9701 10.056 14.9417 9.99608 14.9165C9.93299 14.8881 9.87304 14.8565 9.80995 14.8281C9.7437 14.7966 9.67745 14.765 9.6112 14.7303C9.55441 14.7019 9.49762 14.6735 9.44084 14.6483C6.45324 13.1592 3.80321 11.1717 1.54438 8.76145C1.43081 8.64157 1.23206 8.72044 1.23206 8.88449L1.23836 18.0933C1.23836 18.494 1.43712 18.8726 1.77153 19.0934C3.86631 20.4878 6.38699 21.2986 9.09696 21.2986Z" fill="#3370FF" /><path d="M23.7322 9.29488C22.7226 8.79642 21.5838 8.5188 20.3818 8.5188C19.6688 8.5188 18.9747 8.6166 18.3217 8.80273C18.246 8.82481 18.1703 8.8469 18.0977 8.86898C18.0441 8.88476 17.9905 8.90368 17.94 8.91946C17.8359 8.95416 17.7318 8.99202 17.6276 9.03303C17.4447 9.10559 17.2617 9.18446 17.085 9.26964C16.8957 9.36113 16.7128 9.45893 16.5329 9.56619C16.35 9.67345 16.1701 9.79018 15.9998 9.91322C15.8767 10.0016 15.7569 10.093 15.637 10.1877C15.5076 10.2918 15.3846 10.3991 15.2616 10.5095C15.1953 10.5694 15.1322 10.6325 15.066 10.6925L14.7315 11.0206L13.3939 12.3424L13.1636 12.5696L13.0879 12.6453C13.05 12.6831 13.0122 12.7178 12.9775 12.7557C12.9586 12.7746 12.9396 12.7904 12.9207 12.8093C12.8923 12.8377 12.8639 12.863 12.8355 12.8882C12.804 12.9166 12.7724 12.9481 12.7409 12.9765C11.9143 13.7368 10.9931 14.3899 9.99304 14.923C10.053 14.9514 10.1129 14.9798 10.1729 15.0051C10.2202 15.0271 10.2675 15.0492 10.3148 15.0713C10.359 15.0934 10.4063 15.1123 10.4536 15.1344C10.4978 15.1533 10.5451 15.1754 10.5893 15.1943C10.6398 15.2164 10.6871 15.2385 10.7376 15.2606C10.7944 15.2858 10.8511 15.3111 10.9079 15.3363C10.9616 15.3584 11.0184 15.3836 11.072 15.4057C11.1445 15.4373 11.2139 15.4657 11.2865 15.4941C11.3433 15.5193 11.4032 15.5414 11.46 15.5635C11.5484 15.5982 11.6367 15.636 11.7282 15.6707C11.8134 15.7023 11.8954 15.737 11.9806 15.7685C12.0437 15.7938 12.1068 15.8158 12.1699 15.8411C12.2803 15.8821 12.3875 15.9231 12.498 15.961C12.5547 15.9799 12.6084 16.002 12.6652 16.0209C12.744 16.0493 12.8197 16.0745 12.8986 16.1029C12.9617 16.125 13.028 16.1471 13.0911 16.1692C13.1857 16.2007 13.2803 16.2323 13.375 16.2638C13.4728 16.2954 13.5737 16.3269 13.6747 16.3585C13.7977 16.3963 13.9176 16.4342 14.0406 16.4689C14.1227 16.4941 14.2047 16.5162 14.2867 16.5414C14.4508 16.5888 14.618 16.6361 14.782 16.6803C14.842 16.696 14.9019 16.7118 14.9618 16.7244C15.0754 16.7528 15.189 16.7749 15.3026 16.7938C15.4319 16.8159 15.5613 16.8348 15.6906 16.8506C15.8673 16.8695 16.0408 16.8822 16.2143 16.8822C16.372 16.8853 16.5298 16.879 16.6844 16.8695C16.8326 16.8601 16.9778 16.8412 17.1229 16.8191C17.3248 16.7875 17.5204 16.7465 17.7128 16.6929C17.8422 16.6582 17.9715 16.6172 18.0977 16.5698C18.2144 16.5257 18.328 16.4815 18.4416 16.4279C18.5709 16.3679 18.7003 16.3048 18.8233 16.2354C18.8833 16.2007 18.9464 16.166 19.0063 16.1282C19.0631 16.0935 19.1199 16.0556 19.1767 16.0178C19.265 15.9578 19.3533 15.8947 19.4385 15.8316C19.5111 15.7748 19.5836 15.718 19.653 15.6581C19.7792 15.5508 19.8991 15.4341 20.0158 15.3142C20.0726 15.2543 20.1294 15.1943 20.183 15.1313C20.2524 15.0524 20.3187 14.9704 20.3849 14.8852C20.4354 14.8189 20.4859 14.7495 20.5364 14.6801C20.672 14.4845 20.7982 14.2763 20.9118 14.0586L21.0411 13.7999L22.2084 11.4748L22.2053 11.4812C22.5807 10.6578 23.1012 9.91953 23.7322 9.29488Z" fill="#133C9A" /></svg>',
+    email: '<svg class="le-channel-icon" aria-hidden="true" focusable="false" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" > <rect width="20" height="16" x="2" y="4" rx="2" /> <path d="m22 7-8.97 5.7a1.94 1.94 0 0 1-2.06 0L2 7" /> </svg>',
+};

package/dist/web/notifier-admin.d.ts

@@ -13,6 +13,10 @@ export interface DefaultWebhook {
 }
 export declare function describeAgentNotifier(config: AgentConfig, defaultWebhook?: DefaultWebhook): {
     source: string;
+    channels: NotifierFileChannel[];
+    primaryChannels: NotifierFileChannel[];
+    connections: NotifierFile[];
+    primary: NotifierFileChannel | null;
     defaultWebhookUrl: string | null;
     publicUrl: string | null;
     plan: string | null;
@@ -33,10 +37,16 @@ export declare function describeAgentNotifier(config: AgentConfig, defaultWebhoo
     file?: NotifierFile;
     missingSecret?: string;
     error?: string;
+    active?: Array<{
+        channel: NotifierFileChannel;
+        missingSecret?: string;
+    }>;
 };
-/** Writes agents/<name>/messaging.yml from the console form and, when the
- * form includes one, the channel's secret into the agent's own env.
- * Throws NotifierFileError for an invalid form. */
+/** Saves one app's connection in agents/<name>/messaging.yml from its
+ * section of the Messaging tab (the first one saved becomes primary;
+ * `primary: true` in the body makes this one primary) and, when the form
+ * includes one, its secret into the agent's own env. Throws
+ * NotifierFileError for an invalid form. */
 export declare function saveAgentNotifier(config: AgentConfig, body: Record<string, unknown>): Promise<void>;
 /** The bot token and signing secret behind an agent's Slack notifier —
  * from AgentConfig.httpNotifier when it's Slack, else from the agent's
@@ -60,25 +70,33 @@ export declare function slackClickAllowed(config: AgentConfig, user: string | un
     allowed: boolean;
     message?: string;
 };
-/** Replaces the approver list on the agent's saved Slack connection.
- * Throws NotifierFileError when there's no Slack connection to add them to. */
+/** Replaces the approver list on the agent's saved Slack connection,
+ * primary or not. Throws NotifierFileError when there's no Slack
+ * connection to add them to. */
 export declare function setAgentApprovers(config: AgentConfig, approvers: unknown): MessagingApprover[];
 /** The people in the agent's Slack channel, for picking approvers. */
 export declare function listAgentSlackMembers(config: AgentConfig): Promise<SlackMember[]>;
 /** Channels for the console's picker, with the token being typed in or,
  * when none is given, the one already saved. */
 export declare function listAgentSlackChannels(config: AgentConfig, botToken?: string): Promise<SlackChannel[]>;
-/** Removes the messaging settings; the stored secret is left alone, so turning the
- * notifier back on doesn't need it re-entered. */
-export declare function removeAgentNotifier(config: AgentConfig): void;
-/** Posts a plain announcement through the agent's notifier — a scheduled
- * task's result, for one — regardless of which events it subscribed to.
- * A webhook gets a signed `run_finish` payload with `data` merged in;
- * Slack and Lark get `text`. Does nothing when no notifier applies. */
+/** Removes one app's connection, or every connection when no app is
+ * named. Removing the primary leaves none primary. Stored secrets are
+ * left alone, so setting an app up again doesn't need them re-entered. */
+export declare function removeAgentNotifier(config: AgentConfig, channel?: string): void;
+/** Makes one saved connection the one in use. Throws NotifierFileError
+ * when that app isn't set up. */
+export declare function setAgentPrimaryNotifier(config: AgentConfig, channel: unknown): void;
+/** Posts a plain announcement through the agent's notifiers (the webhook
+ * and the primary messaging app) — a scheduled task's result, for one —
+ * regardless of which events they subscribed to. A webhook gets a signed
+ * `run_finish` payload with `data` merged in; the apps get `text`.
+ * Returns whether any notifier took it. */
 export declare function announceToNotifier(config: AgentConfig, text: string, data: Record<string, unknown>, defaultWebhook?: DefaultWebhook): boolean;
-/** Sends a test through whichever notifier applies to this agent —
- * webhook or Slack; reports what the receiver answered. */
-export declare function testAgentNotifier(config: AgentConfig, defaultWebhook?: DefaultWebhook): Promise<DeliveryResult & {
+/** Sends a test through one app's saved connection when `channel` is
+ * given (primary or not, so it can be tried before it's made primary),
+ * else through whichever notifier applies to this agent; reports what
+ * the receiver answered. */
+export declare function testAgentNotifier(config: AgentConfig, defaultWebhook?: DefaultWebhook, channel?: string): Promise<DeliveryResult & {
     channel?: string;
 }>;
 /** Every decision still waiting for this agent, oldest first, each with

package/dist/web/notifier-admin.js

@@ -5,8 +5,9 @@ import { sendTestSlackMessage } from '../core/http-notify-triggers/slack.js';
 import { postLifecycleWebhook, sendTestWebhook } from '../core/http-notify-triggers/webhook.js';
 import { SlackNotifier } from '../core/http-notify-triggers/slack.js';
 import { LarkNotifier } from '../core/http-notify-triggers/lark.js';
+import { TelegramNotifier, sendTestTelegramMessage } from '../core/http-notify-triggers/telegram.js';
 import { listDeliveries } from '../core/notifier-deliveries.js';
-import { NOTIFIER_SECRET_VARS, NOTIFIER_SLACK_SIGNING_SECRET_VAR, NotifierFileError, notifierConfigFromFile, readNotifierFile, removeNotifierFile, writeNotifierFile } from '../core/notifier-file.js';
+import { NOTIFIER_CHANNELS, NOTIFIER_SECRET_VARS, PRIMARY_CHANNELS, NOTIFIER_SLACK_SIGNING_SECRET_VAR, NotifierFileError, notifierConfigFromFile, readActiveConnections, readMessagingConnections, readNotifierFile, removeMessagingConnection, removeNotifierFile, setPrimaryConnection, writeNotifierFile } from '../core/notifier-file.js';
 import { listSlackChannelMembers, listSlackChannels, slackAppManifest } from '../core/messaging/connectors/slack/index.js';
 import { setAgentEnvVar } from './env-admin.js';
 export function describeAgentNotifier(config, defaultWebhook) {
@@ -14,9 +15,22 @@ export function describeAgentNotifier(config, defaultWebhook) {
     const env = createAgentEnv(config.name, agentDirFor(config));
     const secretsSet = Object.fromEntries(Object.keys(NOTIFIER_SECRET_VARS).map((channel) => [channel, env.get(NOTIFIER_SECRET_VARS[channel]) !== undefined]));
     const source = described.source === 'none' && defaultWebhook ? 'default' : described.source;
+    // Every saved connection, one per app, for the tab's section for each;
+    // only `primary` is used. An unreadable file shows as none here (the
+    // error itself comes through `described`).
+    let saved = { connections: [] };
+    try {
+        saved = readMessagingConnections(agentDirFor(config));
+    }
+    catch { }
     return {
         ...described,
         source,
+        channels: NOTIFIER_CHANNELS,
+        // Only these take turns as primary; a webhook always sends.
+        primaryChannels: PRIMARY_CHANNELS,
+        connections: saved.connections,
+        primary: saved.primary ?? null,
         defaultWebhookUrl: defaultWebhook?.webhookUrl ?? null,
         publicUrl: process.env.LOOPENGINE_PUBLIC_URL ?? null,
         // LOOPENGINE_PLAN ('free' on LoopEngine Cloud's free plan): the
@@ -38,22 +52,27 @@ export function describeAgentNotifier(config, defaultWebhook) {
         deliveries: listDeliveries(config.name),
     };
 }
-/** Writes agents/<name>/messaging.yml from the console form and, when the
- * form includes one, the channel's secret into the agent's own env.
- * Throws NotifierFileError for an invalid form. */
-export async function saveAgentNotifier(config, body) {
-    // The form doesn't carry the approvers (they have their own section),
-    // so saving it keeps them.
-    let existing;
+/** The agent's saved connection for one app, primary or not. */
+function savedConnection(config, channel) {
     try {
-        existing = readNotifierFile(agentDirFor(config));
+        return readMessagingConnections(agentDirFor(config)).connections.find((c) => c.channel === channel);
     }
-    catch { }
-    if (existing && body.channel === existing.channel) {
-        if (body.approvers === undefined && existing.approvers)
-            body = { ...body, approvers: existing.approvers };
+    catch {
+        return undefined;
     }
-    const file = writeNotifierFile(agentDirFor(config), body);
+}
+/** Saves one app's connection in agents/<name>/messaging.yml from its
+ * section of the Messaging tab (the first one saved becomes primary;
+ * `primary: true` in the body makes this one primary) and, when the form
+ * includes one, its secret into the agent's own env. Throws
+ * NotifierFileError for an invalid form. */
+export async function saveAgentNotifier(config, body) {
+    // The form doesn't carry the approvers (they have their own section),
+    // so saving it keeps them.
+    const existing = typeof body.channel === 'string' ? savedConnection(config, body.channel) : undefined;
+    if (existing?.approvers && body.approvers === undefined)
+        body = { ...body, approvers: existing.approvers };
+    const file = writeNotifierFile(agentDirFor(config), body, { makePrimary: body.primary === true });
     if (typeof body.secret === 'string' && body.secret.trim()) {
         await setAgentEnvVar(config.name, NOTIFIER_SECRET_VARS[file.channel], body.secret.trim());
     }
@@ -104,19 +123,19 @@ export function slackClickAllowed(config, user) {
         return { allowed: true };
     return { allowed: false, message: `Only approvers can decide this: ${approvers.map((a) => `<@${a.user}>`).join(', ')}.` };
 }
-/** Replaces the approver list on the agent's saved Slack connection.
- * Throws NotifierFileError when there's no Slack connection to add them to. */
+/** Replaces the approver list on the agent's saved Slack connection,
+ * primary or not. Throws NotifierFileError when there's no Slack
+ * connection to add them to. */
 export function setAgentApprovers(config, approvers) {
-    const dir = agentDirFor(config);
-    const file = readNotifierFile(dir);
-    if (!file || file.channel !== 'slack')
+    const file = savedConnection(config, 'slack');
+    if (!file)
         throw new NotifierFileError('Save a Slack connection first');
-    return writeNotifierFile(dir, { ...file, approvers: Array.isArray(approvers) ? approvers : [] }).approvers ?? [];
+    return writeNotifierFile(agentDirFor(config), { ...file, approvers: Array.isArray(approvers) ? approvers : [] }).approvers ?? [];
 }
 /** The people in the agent's Slack channel, for picking approvers. */
 export async function listAgentSlackMembers(config) {
     const { botToken } = slackCredentialsFor(config);
-    const channelId = config.httpNotifier?.channel === 'slack' ? config.httpNotifier.config.channelId : readNotifierFile(agentDirFor(config))?.channelId;
+    const channelId = config.httpNotifier?.channel === 'slack' ? config.httpNotifier.config.channelId : savedConnection(config, 'slack')?.channelId;
     if (!botToken || !channelId)
         throw new Error('Save the Slack bot token and channel first');
     return listSlackChannelMembers(botToken, channelId);
@@ -129,61 +148,83 @@ export async function listAgentSlackChannels(config, botToken) {
         throw new Error('Enter the bot token first');
     return listSlackChannels(token);
 }
-/** Removes the messaging settings; the stored secret is left alone, so turning the
- * notifier back on doesn't need it re-entered. */
-export function removeAgentNotifier(config) {
-    removeNotifierFile(agentDirFor(config));
+/** Removes one app's connection, or every connection when no app is
+ * named. Removing the primary leaves none primary. Stored secrets are
+ * left alone, so setting an app up again doesn't need them re-entered. */
+export function removeAgentNotifier(config, channel) {
+    if (channel)
+        removeMessagingConnection(agentDirFor(config), channel);
+    else
+        removeNotifierFile(agentDirFor(config));
+}
+/** Makes one saved connection the one in use. Throws NotifierFileError
+ * when that app isn't set up. */
+export function setAgentPrimaryNotifier(config, channel) {
+    if (typeof channel !== 'string' || !NOTIFIER_CHANNELS.includes(channel)) {
+        throw new NotifierFileError(`channel must be one of: ${NOTIFIER_CHANNELS.join(', ')}`);
+    }
+    setPrimaryConnection(agentDirFor(config), channel);
 }
-/** The notifier settings that apply to an agent: its code httpNotifier,
- * else its messaging.yml (once its secret is set), else the
- * deployment-wide default webhook. */
-function activeNotifierTarget(config, defaultWebhook) {
+/** The notifiers that apply to an agent: its code httpNotifier; else its
+ * messaging.yml's webhook and primary messaging app (each once its
+ * secret is set); else the deployment-wide default webhook. */
+function activeNotifierTargets(config, defaultWebhook) {
     if (config.httpNotifier)
-        return config.httpNotifier;
+        return [config.httpNotifier];
     const dir = agentDirFor(config);
-    const file = readNotifierFile(dir);
-    if (file) {
-        const { config: fromFile } = notifierConfigFromFile(file, createAgentEnv(config.name, dir), config.name);
-        if (fromFile)
-            return fromFile;
-    }
-    return defaultWebhook ? { channel: 'webhook', config: { webhookUrl: defaultWebhook.webhookUrl, webhookSecret: defaultWebhook.webhookSecret }, events: ['run_finish'] } : undefined;
-}
-/** Posts a plain announcement through the agent's notifier — a scheduled
- * task's result, for one — regardless of which events it subscribed to.
- * A webhook gets a signed `run_finish` payload with `data` merged in;
- * Slack and Lark get `text`. Does nothing when no notifier applies. */
+    const env = createAgentEnv(config.name, dir);
+    const fromFile = readActiveConnections(dir).flatMap((file) => notifierConfigFromFile(file, env, config.name).config ?? []);
+    if (fromFile.length)
+        return fromFile;
+    return defaultWebhook ? [{ channel: 'webhook', config: { webhookUrl: defaultWebhook.webhookUrl, webhookSecret: defaultWebhook.webhookSecret }, events: ['run_finish'] }] : [];
+}
+/** Posts a plain announcement through the agent's notifiers (the webhook
+ * and the primary messaging app) — a scheduled task's result, for one —
+ * regardless of which events they subscribed to. A webhook gets a signed
+ * `run_finish` payload with `data` merged in; the apps get `text`.
+ * Returns whether any notifier took it. */
 export function announceToNotifier(config, text, data, defaultWebhook) {
-    let target;
+    let targets;
     try {
-        target = activeNotifierTarget(config, defaultWebhook);
+        targets = activeNotifierTargets(config, defaultWebhook);
     }
     catch {
         return false;
     }
-    if (!target)
-        return false;
-    switch (target.channel) {
-        case 'webhook':
-            postLifecycleWebhook(target.config.webhookUrl, target.config.webhookSecret, 'run_finish', { agent: config.name, text, ...data });
-            return true;
-        case 'slack':
-            new SlackNotifier({ botToken: target.config.botToken, channelId: target.config.channelId }).postMessage(text);
-            return true;
-        case 'lark':
-            new LarkNotifier({ appId: target.config.appId, appSecret: target.config.appSecret, chatId: target.config.chatId }).postMessage(text);
-            return true;
-        default:
-            return false;
-    }
-}
-/** Sends a test through whichever notifier applies to this agent —
- * webhook or Slack; reports what the receiver answered. */
-export async function testAgentNotifier(config, defaultWebhook) {
-    let target = config.httpNotifier;
+    let sent = false;
+    for (const target of targets) {
+        switch (target.channel) {
+            case 'webhook':
+                postLifecycleWebhook(target.config.webhookUrl, target.config.webhookSecret, 'run_finish', { agent: config.name, text, ...data });
+                sent = true;
+                break;
+            case 'slack':
+                new SlackNotifier({ botToken: target.config.botToken, channelId: target.config.channelId }).postMessage(text);
+                sent = true;
+                break;
+            case 'lark':
+                new LarkNotifier({ appId: target.config.appId, appSecret: target.config.appSecret, chatId: target.config.chatId }).postMessage(text);
+                sent = true;
+                break;
+            case 'telegram':
+                new TelegramNotifier({ botToken: target.config.botToken, chatId: target.config.chatId }).postMessage(text);
+                sent = true;
+                break;
+        }
+    }
+    return sent;
+}
+/** Sends a test through one app's saved connection when `channel` is
+ * given (primary or not, so it can be tried before it's made primary),
+ * else through whichever notifier applies to this agent; reports what
+ * the receiver answered. */
+export async function testAgentNotifier(config, defaultWebhook, channel) {
+    let target = channel ? undefined : config.httpNotifier;
+    if (channel && !savedConnection(config, channel))
+        return { ok: false, channel, error: `Save the ${channel} connection first` };
     if (!target) {
         const dir = agentDirFor(config);
-        const file = readNotifierFile(dir);
+        const file = channel ? savedConnection(config, channel) : readNotifierFile(dir);
         if (file) {
             const { config: fromFile, missingSecret } = notifierConfigFromFile(file, createAgentEnv(config.name, dir), config.name);
             if (!fromFile)
@@ -202,6 +243,9 @@ export async function testAgentNotifier(config, defaultWebhook) {
     if (target.channel === 'slack') {
         return { channel: 'slack', ...(await sendTestSlackMessage(target.config.botToken, target.config.channelId, `Test from LoopEngine: approvals for ${config.name} will be posted here.`)) };
     }
+    if (target.channel === 'telegram') {
+        return { channel: 'telegram', ...(await sendTestTelegramMessage(target.config.botToken, target.config.chatId, `Test from LoopEngine: approvals for ${config.name} will be posted here.`)) };
+    }
     if (target.channel === 'email') {
         try {
             await target.config.sendEmail(target.config.to, `Test from LoopEngine: ${config.name}`, `<p>This is a test. Approval requests and questions from <b>${config.name}</b> will be emailed here, each with a link to approve, deny or answer.</p>`, { kind: 'test' });

package/dist/web/provider-icons.d.ts

@@ -0,0 +1,2 @@
+import type { ModelProviderInfo } from './global-config.js';
+export declare const PROVIDER_ICONS: Record<ModelProviderInfo['provider'], string>;