npm - @yagr/agent - Versions diffs - 0.1.0 - Mend

@yagr/agent 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (215) hide show

package/LICENSE +201 -0
package/README.md +257 -0
package/dist/agent.d.ts +21 -0
package/dist/agent.d.ts.map +1 -0
package/dist/agent.js +47 -0
package/dist/agent.js.map +1 -0
package/dist/cli.d.ts +3 -0
package/dist/cli.d.ts.map +1 -0
package/dist/cli.js +293 -0
package/dist/cli.js.map +1 -0
package/dist/config/init-yagr-home.d.ts +2 -0
package/dist/config/init-yagr-home.d.ts.map +1 -0
package/dist/config/init-yagr-home.js +6 -0
package/dist/config/init-yagr-home.js.map +1 -0
package/dist/config/load-env.d.ts +2 -0
package/dist/config/load-env.d.ts.map +1 -0
package/dist/config/load-env.js +20 -0
package/dist/config/load-env.js.map +1 -0
package/dist/config/load-n8n-engine-config.d.ts +6 -0
package/dist/config/load-n8n-engine-config.d.ts.map +1 -0
package/dist/config/load-n8n-engine-config.js +39 -0
package/dist/config/load-n8n-engine-config.js.map +1 -0
package/dist/config/yagr-config-service.d.ts +51 -0
package/dist/config/yagr-config-service.d.ts.map +1 -0
package/dist/config/yagr-config-service.js +103 -0
package/dist/config/yagr-config-service.js.map +1 -0
package/dist/config/yagr-home.d.ts +4 -0
package/dist/config/yagr-home.d.ts.map +1 -0
package/dist/config/yagr-home.js +25 -0
package/dist/config/yagr-home.js.map +1 -0
package/dist/engine/engine.d.ts +15 -0
package/dist/engine/engine.d.ts.map +1 -0
package/dist/engine/engine.js +2 -0
package/dist/engine/engine.js.map +1 -0
package/dist/engine/n8n-engine.d.ts +26 -0
package/dist/engine/n8n-engine.d.ts.map +1 -0
package/dist/engine/n8n-engine.js +200 -0
package/dist/engine/n8n-engine.js.map +1 -0
package/dist/engine/yagr-engine.d.ts +17 -0
package/dist/engine/yagr-engine.d.ts.map +1 -0
package/dist/engine/yagr-engine.js +37 -0
package/dist/engine/yagr-engine.js.map +1 -0
package/dist/gateway/cli.d.ts +8 -0
package/dist/gateway/cli.d.ts.map +1 -0
package/dist/gateway/cli.js +50 -0
package/dist/gateway/cli.js.map +1 -0
package/dist/gateway/history-viewport.d.ts +14 -0
package/dist/gateway/history-viewport.d.ts.map +1 -0
package/dist/gateway/history-viewport.js +51 -0
package/dist/gateway/history-viewport.js.map +1 -0
package/dist/gateway/interactive-ui.d.ts +4 -0
package/dist/gateway/interactive-ui.d.ts.map +1 -0
package/dist/gateway/interactive-ui.js +430 -0
package/dist/gateway/interactive-ui.js.map +1 -0
package/dist/gateway/manager.d.ts +25 -0
package/dist/gateway/manager.d.ts.map +1 -0
package/dist/gateway/manager.js +204 -0
package/dist/gateway/manager.js.map +1 -0
package/dist/gateway/telegram.d.ts +30 -0
package/dist/gateway/telegram.d.ts.map +1 -0
package/dist/gateway/telegram.js +406 -0
package/dist/gateway/telegram.js.map +1 -0
package/dist/gateway/types.d.ts +19 -0
package/dist/gateway/types.d.ts.map +1 -0
package/dist/gateway/types.js +2 -0
package/dist/gateway/types.js.map +1 -0
package/dist/gateway/webui.d.ts +13 -0
package/dist/gateway/webui.d.ts.map +1 -0
package/dist/gateway/webui.js +663 -0
package/dist/gateway/webui.js.map +1 -0
package/dist/index.d.ts +23 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +15 -0
package/dist/index.js.map +1 -0
package/dist/llm/create-language-model.d.ts +31 -0
package/dist/llm/create-language-model.d.ts.map +1 -0
package/dist/llm/create-language-model.js +129 -0
package/dist/llm/create-language-model.js.map +1 -0
package/dist/prompt/build-system-prompt.d.ts +3 -0
package/dist/prompt/build-system-prompt.d.ts.map +1 -0
package/dist/prompt/build-system-prompt.js +64 -0
package/dist/prompt/build-system-prompt.js.map +1 -0
package/dist/runtime/completion-gate.d.ts +21 -0
package/dist/runtime/completion-gate.d.ts.map +1 -0
package/dist/runtime/completion-gate.js +59 -0
package/dist/runtime/completion-gate.js.map +1 -0
package/dist/runtime/context-compaction.d.ts +25 -0
package/dist/runtime/context-compaction.d.ts.map +1 -0
package/dist/runtime/context-compaction.js +197 -0
package/dist/runtime/context-compaction.js.map +1 -0
package/dist/runtime/outcome.d.ts +23 -0
package/dist/runtime/outcome.d.ts.map +1 -0
package/dist/runtime/outcome.js +89 -0
package/dist/runtime/outcome.js.map +1 -0
package/dist/runtime/policy-hooks.d.ts +15 -0
package/dist/runtime/policy-hooks.d.ts.map +1 -0
package/dist/runtime/policy-hooks.js +54 -0
package/dist/runtime/policy-hooks.js.map +1 -0
package/dist/runtime/required-actions.d.ts +5 -0
package/dist/runtime/required-actions.d.ts.map +1 -0
package/dist/runtime/required-actions.js +77 -0
package/dist/runtime/required-actions.js.map +1 -0
package/dist/runtime/run-engine.d.ts +15 -0
package/dist/runtime/run-engine.d.ts.map +1 -0
package/dist/runtime/run-engine.js +624 -0
package/dist/runtime/run-engine.js.map +1 -0
package/dist/setup/setup-wizard.d.ts +52 -0
package/dist/setup/setup-wizard.d.ts.map +1 -0
package/dist/setup/setup-wizard.js +613 -0
package/dist/setup/setup-wizard.js.map +1 -0
package/dist/setup/start-launcher.d.ts +22 -0
package/dist/setup/start-launcher.d.ts.map +1 -0
package/dist/setup/start-launcher.js +76 -0
package/dist/setup/start-launcher.js.map +1 -0
package/dist/setup.d.ts +20 -0
package/dist/setup.d.ts.map +1 -0
package/dist/setup.js +247 -0
package/dist/setup.js.map +1 -0
package/dist/tools/build-tools.d.ts +608 -0
package/dist/tools/build-tools.d.ts.map +1 -0
package/dist/tools/build-tools.js +35 -0
package/dist/tools/build-tools.js.map +1 -0
package/dist/tools/delete-workspace-file.d.ts +38 -0
package/dist/tools/delete-workspace-file.d.ts.map +1 -0
package/dist/tools/delete-workspace-file.js +31 -0
package/dist/tools/delete-workspace-file.js.map +1 -0
package/dist/tools/deploy.d.ts +110 -0
package/dist/tools/deploy.d.ts.map +1 -0
package/dist/tools/deploy.js +28 -0
package/dist/tools/deploy.js.map +1 -0
package/dist/tools/generate-workflow.d.ts +180 -0
package/dist/tools/generate-workflow.d.ts.map +1 -0
package/dist/tools/generate-workflow.js +46 -0
package/dist/tools/generate-workflow.js.map +1 -0
package/dist/tools/index.d.ts +20 -0
package/dist/tools/index.d.ts.map +1 -0
package/dist/tools/index.js +20 -0
package/dist/tools/index.js.map +1 -0
package/dist/tools/list-directory.d.ts +48 -0
package/dist/tools/list-directory.d.ts.map +1 -0
package/dist/tools/list-directory.js +61 -0
package/dist/tools/list-directory.js.map +1 -0
package/dist/tools/list-workflows.d.ts +18 -0
package/dist/tools/list-workflows.d.ts.map +1 -0
package/dist/tools/list-workflows.js +17 -0
package/dist/tools/list-workflows.js.map +1 -0
package/dist/tools/manage-workflow.d.ts +42 -0
package/dist/tools/manage-workflow.d.ts.map +1 -0
package/dist/tools/manage-workflow.js +26 -0
package/dist/tools/manage-workflow.js.map +1 -0
package/dist/tools/move-workspace-file.d.ts +42 -0
package/dist/tools/move-workspace-file.d.ts.map +1 -0
package/dist/tools/move-workspace-file.js +45 -0
package/dist/tools/move-workspace-file.js.map +1 -0
package/dist/tools/n8nac.d.ts +144 -0
package/dist/tools/n8nac.d.ts.map +1 -0
package/dist/tools/n8nac.js +349 -0
package/dist/tools/n8nac.js.map +1 -0
package/dist/tools/node-info.d.ts +18 -0
package/dist/tools/node-info.d.ts.map +1 -0
package/dist/tools/node-info.js +15 -0
package/dist/tools/node-info.js.map +1 -0
package/dist/tools/observer.d.ts +32 -0
package/dist/tools/observer.d.ts.map +1 -0
package/dist/tools/observer.js +10 -0
package/dist/tools/observer.js.map +1 -0
package/dist/tools/read-workspace-file.d.ts +54 -0
package/dist/tools/read-workspace-file.d.ts.map +1 -0
package/dist/tools/read-workspace-file.js +49 -0
package/dist/tools/read-workspace-file.js.map +1 -0
package/dist/tools/replace-in-workspace-file.d.ts +62 -0
package/dist/tools/replace-in-workspace-file.d.ts.map +1 -0
package/dist/tools/replace-in-workspace-file.js +46 -0
package/dist/tools/replace-in-workspace-file.js.map +1 -0
package/dist/tools/report-progress.d.ts +20 -0
package/dist/tools/report-progress.d.ts.map +1 -0
package/dist/tools/report-progress.js +20 -0
package/dist/tools/report-progress.js.map +1 -0
package/dist/tools/request-required-action.d.ts +31 -0
package/dist/tools/request-required-action.d.ts.map +1 -0
package/dist/tools/request-required-action.js +33 -0
package/dist/tools/request-required-action.js.map +1 -0
package/dist/tools/search-nodes.d.ts +18 -0
package/dist/tools/search-nodes.d.ts.map +1 -0
package/dist/tools/search-nodes.js +15 -0
package/dist/tools/search-nodes.js.map +1 -0
package/dist/tools/search-templates.d.ts +18 -0
package/dist/tools/search-templates.d.ts.map +1 -0
package/dist/tools/search-templates.js +15 -0
package/dist/tools/search-templates.js.map +1 -0
package/dist/tools/search-workspace.d.ts +55 -0
package/dist/tools/search-workspace.d.ts.map +1 -0
package/dist/tools/search-workspace.js +86 -0
package/dist/tools/search-workspace.js.map +1 -0
package/dist/tools/validate.d.ts +110 -0
package/dist/tools/validate.d.ts.map +1 -0
package/dist/tools/validate.js +28 -0
package/dist/tools/validate.js.map +1 -0
package/dist/tools/workspace-utils.d.ts +10 -0
package/dist/tools/workspace-utils.d.ts.map +1 -0
package/dist/tools/workspace-utils.js +63 -0
package/dist/tools/workspace-utils.js.map +1 -0
package/dist/tools/write-workspace-file.d.ts +46 -0
package/dist/tools/write-workspace-file.d.ts.map +1 -0
package/dist/tools/write-workspace-file.js +39 -0
package/dist/tools/write-workspace-file.js.map +1 -0
package/dist/types.d.ts +243 -0
package/dist/types.d.ts.map +1 -0
package/dist/types.js +2 -0
package/dist/types.js.map +1 -0
package/dist/webui/app.js +26759 -0
package/dist/webui/app.js.map +7 -0
package/dist/webui/styles.css +740 -0
package/dist/webui/styles.css.map +7 -0
package/package.json +72 -0

package/dist/gateway/webui.js ADDED Viewed

@@ -0,0 +1,663 @@
+import { randomUUID } from 'node:crypto';
+import { createServer } from 'node:http';
+import { execFile } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { promisify } from 'node:util';
+import { ConfigService as N8nConfigService, N8nApiClient, WorkspaceSetupService, getDisplayProjectName, } from 'n8nac';
+import { YagrAgent } from '../agent.js';
+import { YagrConfigService } from '../config/yagr-config-service.js';
+import { getYagrHomeDir } from '../config/yagr-home.js';
+import { createOnboardingToken, getTelegramGatewayStatus, resetTelegramGateway, } from './telegram.js';
+import { getYagrSetupStatus } from '../setup.js';
+import { resolveLanguageModelConfig } from '../llm/create-language-model.js';
+const execFileAsync = promisify(execFile);
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const DEFAULT_HOST = '127.0.0.1';
+const DEFAULT_PORT = 3789;
+const VALID_PROVIDERS = [
+    'anthropic',
+    'openai',
+    'google',
+    'groq',
+    'mistral',
+    'openrouter',
+];
+const WEB_UI_HTML = `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Yagr Web UI</title>
+    <link rel="stylesheet" href="/styles.css" />
+    <script defer src="/app.js"></script>
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+  </html>`;
+function isAbortError(error) {
+    return error instanceof Error && error.name === 'AbortError';
+}
+function sanitizeHost(value) {
+    const trimmed = value?.trim();
+    return trimmed || DEFAULT_HOST;
+}
+function sanitizePort(value) {
+    if (!Number.isInteger(value) || Number(value) <= 0 || Number(value) > 65535) {
+        return DEFAULT_PORT;
+    }
+    return Number(value);
+}
+function getWebUiConfig(configService = new YagrConfigService()) {
+    const config = configService.getLocalConfig();
+    return {
+        host: sanitizeHost(config.gateway?.webui?.host),
+        port: sanitizePort(config.gateway?.webui?.port),
+    };
+}
+function persistWebUiConfig(configService = new YagrConfigService(), nextConfig) {
+    const normalized = {
+        host: sanitizeHost(nextConfig.host),
+        port: sanitizePort(nextConfig.port),
+    };
+    configService.updateLocalConfig((localConfig) => ({
+        ...localConfig,
+        gateway: {
+            ...localConfig.gateway,
+            webui: normalized,
+        },
+    }));
+    return normalized;
+}
+export function getWebUiGatewayStatus(configService = new YagrConfigService()) {
+    const config = persistWebUiConfig(configService, getWebUiConfig(configService));
+    return {
+        configured: true,
+        host: config.host,
+        port: config.port,
+        url: `http://${config.host}:${config.port}`,
+    };
+}
+export function createWebUiGatewayRuntime(engineResolver, options = {}, configService = new YagrConfigService()) {
+    const status = getWebUiGatewayStatus(configService);
+    return {
+        gateway: new WebUiGateway(engineResolver, options, configService, status),
+        startupMessages: [
+            `Yagr Web UI listening at ${status.url}.`,
+            'Open the local UI to configure the runtime, link Telegram, and chat with Yagr.',
+        ],
+        onboardingLink: status.url,
+    };
+}
+class WebUiGateway {
+    engineResolver;
+    options;
+    configService;
+    status;
+    server;
+    enginePromise;
+    agents = new Map();
+    constructor(engineResolver, options, configService, status) {
+        this.engineResolver = engineResolver;
+        this.options = options;
+        this.configService = configService;
+        this.status = status;
+    }
+    async start() {
+        if (this.server) {
+            return;
+        }
+        this.server = createServer(async (request, response) => {
+            try {
+                await this.handleRequest(request, response);
+            }
+            catch (error) {
+                this.sendJson(response, 500, {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        });
+        await new Promise((resolve, reject) => {
+            this.server?.once('error', reject);
+            this.server?.listen(this.status.port, this.status.host, () => resolve());
+        });
+    }
+    async stop() {
+        if (!this.server) {
+            return;
+        }
+        const server = this.server;
+        this.server = undefined;
+        await new Promise((resolve, reject) => {
+            server.close((error) => {
+                if (error) {
+                    reject(error);
+                    return;
+                }
+                resolve();
+            });
+        });
+    }
+    async reply() { }
+    async handleRequest(request, response) {
+        const method = request.method ?? 'GET';
+        const url = new URL(request.url ?? '/', this.status.url);
+        if (method === 'GET' && url.pathname === '/') {
+            this.sendText(response, 200, WEB_UI_HTML, 'text/html; charset=utf-8');
+            return;
+        }
+        if (method === 'GET' && (url.pathname === '/styles.css' || url.pathname === '/app.css')) {
+            await this.sendStaticAsset(response, 'styles.css', 'text/css; charset=utf-8');
+            return;
+        }
+        if (method === 'GET' && url.pathname === '/app.js') {
+            await this.sendStaticAsset(response, 'app.js', 'application/javascript; charset=utf-8');
+            return;
+        }
+        if (method === 'GET' && url.pathname === '/api/config') {
+            this.sendJson(response, 200, await this.buildSnapshot());
+            return;
+        }
+        if (method === 'POST' && url.pathname === '/api/n8n/projects') {
+            const body = await this.readJson(request);
+            const projects = await this.fetchN8nProjects(String(body.host ?? ''), body.apiKey ? String(body.apiKey) : undefined);
+            const current = new N8nConfigService().getLocalConfig();
+            this.sendJson(response, 200, {
+                projects: projects.map((project) => ({ id: project.id, name: getDisplayProjectName(project) })),
+                selectedProjectId: current.projectId,
+            });
+            return;
+        }
+        if (method === 'POST' && url.pathname === '/api/config/n8n') {
+            const body = await this.readJson(request);
+            const warning = await this.saveN8nConfig({
+                host: String(body.host ?? ''),
+                apiKey: body.apiKey ? String(body.apiKey) : undefined,
+                projectId: String(body.projectId ?? ''),
+                syncFolder: String(body.syncFolder ?? 'workflows'),
+            });
+            this.sendJson(response, 200, {
+                warning,
+                snapshot: await this.buildSnapshot(),
+            });
+            return;
+        }
+        if (method === 'POST' && url.pathname === '/api/llm/models') {
+            const body = await this.readJson(request);
+            const provider = this.assertProvider(String(body.provider ?? ''));
+            const apiKey = body.apiKey ? String(body.apiKey) : this.configService.getApiKey(provider);
+            if (!apiKey) {
+                throw new Error(`No API key available for ${provider}. Save one first.`);
+            }
+            this.sendJson(response, 200, {
+                models: await fetchAvailableModels(provider, apiKey),
+            });
+            return;
+        }
+        if (method === 'POST' && url.pathname === '/api/config/llm') {
+            const body = await this.readJson(request);
+            const provider = this.assertProvider(String(body.provider ?? ''));
+            const apiKey = body.apiKey ? String(body.apiKey) : undefined;
+            const model = String(body.model ?? '').trim();
+            if (!model) {
+                throw new Error('Model is required.');
+            }
+            if (apiKey) {
+                this.configService.saveApiKey(provider, apiKey);
+            }
+            this.configService.updateLocalConfig((localConfig) => ({
+                ...localConfig,
+                provider,
+                model,
+                baseUrl: body.baseUrl ? String(body.baseUrl) : undefined,
+            }));
+            this.sendJson(response, 200, { snapshot: await this.buildSnapshot() });
+            return;
+        }
+        if (method === 'POST' && url.pathname === '/api/config/surfaces') {
+            const body = await this.readJson(request);
+            const enabledSurfaces = Array.isArray(body.enabledSurfaces)
+                ? body.enabledSurfaces.filter((surface) => surface === 'telegram' || surface === 'whatsapp')
+                : [];
+            this.configService.setEnabledGatewaySurfaces(enabledSurfaces);
+            this.sendJson(response, 200, { snapshot: await this.buildSnapshot() });
+            return;
+        }
+        if (method === 'POST' && url.pathname === '/api/telegram/configure') {
+            const body = await this.readJson(request);
+            const botToken = String(body.botToken ?? '').trim();
+            if (!botToken || !botToken.includes(':')) {
+                throw new Error('Enter a valid Telegram BotFather token.');
+            }
+            const identity = await resolveTelegramBotIdentity(botToken);
+            this.configService.saveTelegramBotToken(botToken);
+            this.configService.enableGatewaySurface('telegram');
+            this.configService.updateLocalConfig((localConfig) => ({
+                ...localConfig,
+                telegram: {
+                    ...localConfig.telegram,
+                    botUsername: identity.username,
+                    onboardingToken: localConfig.telegram?.onboardingToken ?? createOnboardingToken(),
+                    linkedChats: localConfig.telegram?.linkedChats ?? [],
+                },
+            }));
+            this.sendJson(response, 200, { snapshot: await this.buildSnapshot() });
+            return;
+        }
+        if (method === 'POST' && url.pathname === '/api/telegram/reset') {
+            resetTelegramGateway(this.configService);
+            this.sendJson(response, 200, { snapshot: await this.buildSnapshot() });
+            return;
+        }
+        if (method === 'POST' && url.pathname === '/api/chat') {
+            const body = await this.readJson(request);
+            const message = String(body.message ?? '').trim();
+            const sessionId = String(body.sessionId ?? randomUUID());
+            if (!message) {
+                throw new Error('Message is required.');
+            }
+            const setupStatus = getYagrSetupStatus(this.configService, new N8nConfigService());
+            if (!setupStatus.ready) {
+                throw new Error(`Yagr is not ready yet. Missing: ${setupStatus.missingSteps.join(', ')}.`);
+            }
+            const agent = await this.resolveAgent(sessionId);
+            const resolvedConfig = resolveLanguageModelConfig({}, this.configService);
+            const result = await agent.run(message, {
+                ...this.options,
+                provider: resolvedConfig.provider,
+                model: resolvedConfig.model,
+                apiKey: resolvedConfig.apiKey,
+                baseUrl: resolvedConfig.baseUrl,
+            });
+            this.sendJson(response, 200, {
+                sessionId,
+                response: result.text,
+                requiredActions: result.requiredActions,
+                finalState: result.finalState,
+            });
+            return;
+        }
+        if (method === 'POST' && url.pathname === '/api/chat/stream') {
+            const body = await this.readJson(request);
+            const message = String(body.message ?? '').trim();
+            const sessionId = String(body.sessionId ?? randomUUID());
+            if (!message) {
+                throw new Error('Message is required.');
+            }
+            await this.handleStreamingChat(response, sessionId, message);
+            return;
+        }
+        if (method === 'POST' && url.pathname === '/api/chat/reset') {
+            const body = await this.readJson(request);
+            const sessionId = String(body.sessionId ?? '');
+            if (sessionId) {
+                this.agents.delete(sessionId);
+            }
+            this.sendJson(response, 200, { ok: true });
+            return;
+        }
+        this.sendJson(response, 404, { error: 'Not found' });
+    }
+    async buildSnapshot() {
+        const n8nService = new N8nConfigService();
+        const n8nConfig = n8nService.getLocalConfig();
+        const setupStatus = getYagrSetupStatus(this.configService, n8nService);
+        const telegramStatus = getTelegramGatewayStatus(this.configService);
+        const webUiStatus = getWebUiGatewayStatus(this.configService);
+        const yagrConfig = this.configService.getLocalConfig();
+        const enabledSurfaces = this.configService.getEnabledGatewaySurfaces();
+        const startableSurfaces = enabledSurfaces.filter((surface) => surface === 'telegram' && telegramStatus.configured);
+        let availableModels = [];
+        if (yagrConfig.provider) {
+            const apiKey = this.configService.getApiKey(yagrConfig.provider);
+            if (apiKey) {
+                try {
+                    availableModels = await fetchAvailableModels(yagrConfig.provider, apiKey);
+                }
+                catch {
+                    availableModels = [];
+                }
+            }
+        }
+        return {
+            setupStatus,
+            gatewayStatus: {
+                enabledSurfaces,
+                startableSurfaces,
+            },
+            telegram: telegramStatus,
+            webui: webUiStatus,
+            yagr: {
+                provider: yagrConfig.provider,
+                model: yagrConfig.model,
+                baseUrl: yagrConfig.baseUrl,
+                providers: VALID_PROVIDERS.map((provider) => ({
+                    provider,
+                    apiKeyStored: this.configService.hasApiKey(provider),
+                })),
+            },
+            n8n: {
+                host: n8nConfig.host,
+                syncFolder: n8nConfig.syncFolder,
+                projectId: n8nConfig.projectId,
+                projectName: n8nConfig.projectName,
+                apiKeyStored: Boolean(n8nConfig.host && n8nService.getApiKey(n8nConfig.host)),
+                projects: n8nConfig.projectId && n8nConfig.projectName ? [{ id: n8nConfig.projectId, name: n8nConfig.projectName }] : [],
+            },
+            availableModels,
+        };
+    }
+    async fetchN8nProjects(host, apiKeyOverride) {
+        const normalizedHost = host.trim();
+        if (!normalizedHost) {
+            throw new Error('n8n host is required.');
+        }
+        const configService = new N8nConfigService();
+        const apiKey = apiKeyOverride ?? configService.getApiKey(normalizedHost);
+        if (!apiKey) {
+            throw new Error('No n8n API key available for that host.');
+        }
+        const client = new N8nApiClient({ host: normalizedHost, apiKey });
+        const connected = await client.testConnection();
+        if (!connected) {
+            throw new Error('Unable to connect to n8n with the provided URL and API key.');
+        }
+        return client.getProjects();
+    }
+    async saveN8nConfig(input) {
+        const host = input.host.trim();
+        const projectId = input.projectId.trim();
+        const syncFolder = input.syncFolder.trim() || 'workflows';
+        if (!host) {
+            throw new Error('n8n host is required.');
+        }
+        if (!projectId) {
+            throw new Error('Select an n8n project first.');
+        }
+        const configService = new N8nConfigService();
+        const apiKey = input.apiKey?.trim() || configService.getApiKey(host);
+        if (!apiKey) {
+            throw new Error('An n8n API key is required.');
+        }
+        const projects = await this.fetchN8nProjects(host, apiKey);
+        const selectedProject = projects.find((project) => project.id === projectId);
+        if (!selectedProject) {
+            throw new Error('The selected n8n project could not be found. Reload projects and try again.');
+        }
+        configService.saveApiKey(host, apiKey);
+        configService.saveBootstrapState(host, syncFolder);
+        const instanceIdentifier = await configService.getOrCreateInstanceIdentifier(host);
+        configService.saveLocalConfig({
+            host,
+            syncFolder,
+            projectId: selectedProject.id,
+            projectName: getDisplayProjectName(selectedProject),
+            instanceIdentifier,
+        });
+        WorkspaceSetupService.ensureWorkspaceFiles(syncFolder);
+        try {
+            await runN8nacCommand(['update-ai']);
+            return undefined;
+        }
+        catch (error) {
+            return `Workspace saved, but AGENTS.md refresh failed: ${error instanceof Error ? error.message : String(error)}`;
+        }
+    }
+    assertProvider(value) {
+        if (!VALID_PROVIDERS.includes(value)) {
+            throw new Error(`Unknown provider: ${value}`);
+        }
+        return value;
+    }
+    async resolveAgent(sessionId) {
+        const existing = this.agents.get(sessionId);
+        if (existing) {
+            return existing;
+        }
+        if (!this.enginePromise) {
+            this.enginePromise = this.engineResolver();
+        }
+        const engine = await this.enginePromise;
+        const agent = new YagrAgent(engine);
+        this.agents.set(sessionId, agent);
+        return agent;
+    }
+    async readJson(request) {
+        const chunks = [];
+        for await (const chunk of request) {
+            chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        }
+        if (chunks.length === 0) {
+            return {};
+        }
+        return JSON.parse(Buffer.concat(chunks).toString('utf-8'));
+    }
+    sendJson(response, statusCode, payload) {
+        response.writeHead(statusCode, {
+            'Content-Type': 'application/json; charset=utf-8',
+            'Cache-Control': 'no-store',
+        });
+        response.end(JSON.stringify(payload));
+    }
+    sendText(response, statusCode, text, contentType) {
+        response.writeHead(statusCode, {
+            'Content-Type': contentType,
+            'Cache-Control': 'no-store',
+        });
+        response.end(text);
+    }
+    async sendStaticAsset(response, fileName, contentType) {
+        const assetPath = path.resolve(__dirname, '..', 'webui', fileName);
+        const content = await readFile(assetPath, 'utf-8');
+        this.sendText(response, 200, content, contentType);
+    }
+    async handleStreamingChat(response, sessionId, message) {
+        const setupStatus = getYagrSetupStatus(this.configService, new N8nConfigService());
+        if (!setupStatus.ready) {
+            this.sendJson(response, 400, { error: `Yagr is not ready yet. Missing: ${setupStatus.missingSteps.join(', ')}.` });
+            return;
+        }
+        response.writeHead(200, {
+            'Content-Type': 'application/x-ndjson; charset=utf-8',
+            'Cache-Control': 'no-store',
+            Connection: 'keep-alive',
+            'X-Accel-Buffering': 'no',
+        });
+        const abortController = new AbortController();
+        let runFinished = false;
+        let streamedText = '';
+        const handleConnectionClose = () => {
+            if (!runFinished && !abortController.signal.aborted) {
+                abortController.abort();
+            }
+        };
+        response.on('close', handleConnectionClose);
+        const writeEvent = (event) => {
+            if (response.writableEnded || response.destroyed) {
+                return;
+            }
+            response.write(`${JSON.stringify(event)}\n`);
+        };
+        const pushPhaseEvent = (event) => {
+            if (event.status !== 'started') {
+                return;
+            }
+            writeEvent({
+                type: 'phase',
+                phase: event.phase,
+                status: event.status,
+                message: event.message,
+            });
+        };
+        const pushStateEvent = (event) => {
+            if (event.state === 'running' || event.state === 'streaming' || event.state === 'completed') {
+                return;
+            }
+            writeEvent({
+                type: 'state',
+                state: event.state,
+                message: event.message,
+            });
+        };
+        const pushToolEvent = (event) => {
+            if (event.type === 'status') {
+                writeEvent({
+                    type: 'progress',
+                    tone: 'info',
+                    title: event.toolName === 'reportProgress' ? 'Progress' : `Tool ${event.toolName}`,
+                    detail: event.message,
+                });
+                return;
+            }
+            if (event.type === 'command-end') {
+                if (event.exitCode === 0) {
+                    return;
+                }
+                writeEvent({
+                    type: 'progress',
+                    tone: 'error',
+                    title: `${event.toolName} failed`,
+                    detail: event.message,
+                });
+                return;
+            }
+        };
+        const pushCompactionEvent = (event) => {
+            writeEvent({
+                type: 'progress',
+                tone: 'info',
+                title: 'Context compacted',
+                detail: `${event.messagesCompacted} messages folded to keep the run responsive.`,
+            });
+        };
+        try {
+            writeEvent({
+                type: 'start',
+                sessionId,
+                message: 'Run started. Inspecting workspace and request.',
+            });
+            const agent = await this.resolveAgent(sessionId);
+            const resolvedConfig = resolveLanguageModelConfig({}, this.configService);
+            const result = await agent.run(message, {
+                ...this.options,
+                provider: resolvedConfig.provider,
+                model: resolvedConfig.model,
+                apiKey: resolvedConfig.apiKey,
+                baseUrl: resolvedConfig.baseUrl,
+                onPhaseChange: async (event) => {
+                    pushPhaseEvent(event);
+                    await this.options.onPhaseChange?.(event);
+                },
+                onStateChange: async (event) => {
+                    pushStateEvent(event);
+                    await this.options.onStateChange?.(event);
+                },
+                onToolEvent: async (event) => {
+                    pushToolEvent(event);
+                    await this.options.onToolEvent?.(event);
+                },
+                onCompaction: async (event) => {
+                    pushCompactionEvent(event);
+                    await this.options.onCompaction?.(event);
+                },
+                onTextDelta: async (delta) => {
+                    streamedText += delta;
+                    writeEvent({ type: 'text-delta', delta });
+                    await this.options.onTextDelta?.(delta);
+                },
+                abortSignal: abortController.signal,
+            });
+            runFinished = true;
+            writeEvent({
+                type: 'final',
+                sessionId,
+                response: result.text,
+                finalState: result.finalState,
+                requiredActions: result.requiredActions.map((action) => ({
+                    title: action.title,
+                    message: action.message,
+                })),
+            });
+        }
+        catch (error) {
+            if (isAbortError(error)) {
+                runFinished = true;
+                writeEvent({
+                    type: 'final',
+                    sessionId,
+                    response: streamedText,
+                    finalState: 'stopped',
+                    requiredActions: [],
+                });
+            }
+            else {
+                writeEvent({
+                    type: 'error',
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        finally {
+            response.off('close', handleConnectionClose);
+            response.end();
+        }
+    }
+}
+async function fetchAvailableModels(provider, apiKey) {
+    const endpoints = {
+        openrouter: {
+            url: 'https://openrouter.ai/api/v1/models',
+            map: (data) => data.data?.map((model) => model.id) ?? [],
+        },
+        openai: {
+            url: 'https://api.openai.com/v1/models',
+            map: (data) => data.data?.map((model) => model.id) ?? [],
+        },
+        groq: {
+            url: 'https://api.groq.com/openai/v1/models',
+            map: (data) => data.data?.map((model) => model.id) ?? [],
+        },
+        mistral: {
+            url: 'https://api.mistral.ai/v1/models',
+            map: (data) => data.data?.map((model) => model.id) ?? [],
+        },
+    };
+    const endpoint = endpoints[provider];
+    if (!endpoint) {
+        return [];
+    }
+    const response = await fetch(endpoint.url, {
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`${response.status} ${response.statusText}`);
+    }
+    const payload = await response.json();
+    return endpoint.map(payload).sort((left, right) => left.localeCompare(right));
+}
+async function resolveTelegramBotIdentity(botToken) {
+    const { Telegraf } = await import('telegraf');
+    const bot = new Telegraf(botToken);
+    const me = await bot.telegram.getMe();
+    if (!me.username) {
+        throw new Error('Telegram bot username is missing. Configure the bot with BotFather first.');
+    }
+    return {
+        username: me.username,
+        firstName: me.first_name,
+    };
+}
+async function runN8nacCommand(args) {
+    const command = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+    await execFileAsync(command, ['--yes', 'n8nac', ...args], {
+        cwd: getYagrHomeDir(),
+        env: process.env,
+    });
+}
+//# sourceMappingURL=webui.js.map