@yagr/agent 0.2.5 → 0.2.7

package/dist/config/n8n-config-service.js

@@ -1,9 +1,29 @@
 import Conf from 'conf';
 import fs from 'node:fs';
-import { createFallbackInstanceIdentifier, resolveInstanceIdentifier } from 'n8nac';
-import { ensureYagrHomeDir, getYagrPaths } from './yagr-home.js';
+import path from 'node:path';
+import { createFallbackInstanceIdentifier, createProjectSlug, resolveInstanceIdentifier } from 'n8nac';
+import { ensureYagrHomeDir, getYagrN8nWorkspaceDir, getYagrPaths } from './yagr-home.js';
+/**
+ * Computes the fully-qualified workflow directory for the current config:
+ *   <syncFolder>/<instanceIdentifier>/<projectSlug>
+ *
+ * Returns undefined when any required field is missing (e.g. during bootstrap).
+ * This is the single source of truth for this path calculation.
+ */
+export function resolveWorkflowDir(config) {
+    const { syncFolder, instanceIdentifier, projectName } = config;
+    if (!syncFolder || !instanceIdentifier || !projectName) {
+        return undefined;
+    }
+    const workspaceDir = getYagrN8nWorkspaceDir();
+    const resolvedSyncFolder = path.isAbsolute(syncFolder)
+        ? syncFolder
+        : path.join(workspaceDir, syncFolder);
+    return path.join(resolvedSyncFolder, instanceIdentifier, createProjectSlug(projectName));
+}
 export class YagrN8nConfigService {
     globalStore;
+    compatibilityStore;
     localConfigPath;
     legacyCredentialsPath;
     constructor() {
@@ -13,9 +33,14 @@ export class YagrN8nConfigService {
             cwd: paths.homeDir,
             configName: 'n8n-credentials',
         });
+        this.compatibilityStore = new Conf({
+            projectName: 'n8nac',
+            configName: 'credentials',
+        });
         this.localConfigPath = paths.n8nConfigPath;
         this.legacyCredentialsPath = paths.legacyN8nCredentialsPath;
         this.migrateLegacyCredentials();
+        this.syncCompatibilityCredentials();
     }
     getLocalConfig() {
         if (!fs.existsSync(this.localConfigPath)) {
@@ -45,12 +70,21 @@ export class YagrN8nConfigService {
     }
     getApiKey(host) {
         const credentials = this.globalStore.get('hosts') ?? {};
-        return credentials[this.normalizeHost(host)];
+        const normalizedHost = this.normalizeHost(host);
+        if (credentials[normalizedHost]) {
+            return credentials[normalizedHost];
+        }
+        const compatibilityCredentials = this.compatibilityStore.get('hosts') ?? {};
+        return compatibilityCredentials[normalizedHost];
     }
     saveApiKey(host, apiKey) {
         const credentials = this.globalStore.get('hosts') ?? {};
-        credentials[this.normalizeHost(host)] = apiKey;
+        const compatibilityCredentials = this.compatibilityStore.get('hosts') ?? {};
+        const normalizedHost = this.normalizeHost(host);
+        credentials[normalizedHost] = apiKey;
+        compatibilityCredentials[normalizedHost] = apiKey;
         this.globalStore.set('hosts', credentials);
+        this.compatibilityStore.set('hosts', compatibilityCredentials);
     }
     clearLocalConfig() {
         if (fs.existsSync(this.localConfigPath)) {
@@ -59,6 +93,7 @@ export class YagrN8nConfigService {
     }
     clearAllApiKeys() {
         this.globalStore.set('hosts', {});
+        this.compatibilityStore.set('hosts', {});
     }
     async getOrCreateInstanceIdentifier(host) {
         const local = this.getLocalConfig();
@@ -113,5 +148,18 @@ export class YagrN8nConfigService {
             // Ignore malformed legacy files and start fresh in the Yagr home.
         }
     }
+    syncCompatibilityCredentials() {
+        const homeHosts = this.globalStore.get('hosts') ?? {};
+        const compatibilityHosts = this.compatibilityStore.get('hosts') ?? {};
+        const mergedHosts = {
+            ...compatibilityHosts,
+            ...homeHosts,
+        };
+        if (Object.keys(mergedHosts).length === 0) {
+            return;
+        }
+        this.globalStore.set('hosts', mergedHosts);
+        this.compatibilityStore.set('hosts', mergedHosts);
+    }
 }
 //# sourceMappingURL=n8n-config-service.js.map

package/dist/config/n8n-config-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"n8n-config-service.js","sourceRoot":"","sources":["../../src/config/n8n-config-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"n8n-config-service.js","sourceRoot":"","sources":["../../src/config/n8n-config-service.ts"],"names":[],"mappings":"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"}

package/dist/config/yagr-home.d.ts

@@ -1,6 +1,9 @@
 export interface YagrPaths {
     launchDir: string;
     homeDir: string;
+    n8nWorkspaceDir: string;
+    homeInstructionsPath: string;
+    workspaceInstructionsPath: string;
     yagrConfigPath: string;
     yagrCredentialsPath: string;
     n8nConfigPath: string;
@@ -13,6 +16,7 @@ export interface YagrPaths {
 export declare function getYagrLaunchDir(): string;
 export declare function resolveYagrHomeDir(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform, homedir?: string, launchDir?: string): string;
 export declare function getYagrHomeDir(): string;
+export declare function getYagrN8nWorkspaceDir(): string;
 export declare function resolveLegacyConfStorePath(projectName: string, configName: string, env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform, homedir?: string): string;
 export declare function getYagrPaths(): YagrPaths;
 export declare function ensureYagrHomeDir(): string;

package/dist/config/yagr-home.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"yagr-home.d.ts","sourceRoot":"","sources":["../../src/config/yagr-home.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wBAAwB,EAAE,MAAM,CAAC;IACjC,yBAAyB,EAAE,MAAM,CAAC;IAClC,uBAAuB,EAAE,MAAM,CAAC;IAChC,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAMD,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,kBAAkB,CAChC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,OAAO,GAAE,MAAqB,EAC9B,SAAS,GAAE,MAA2B,GACrC,MAAM,CAkBR;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,OAAO,GAAE,MAAqB,GAC7B,MAAM,CAaR;AAED,wBAAgB,YAAY,IAAI,SAAS,CAkBxC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAI1C"}
+{"version":3,"file":"yagr-home.d.ts","sourceRoot":"","sources":["../../src/config/yagr-home.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,yBAAyB,EAAE,MAAM,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wBAAwB,EAAE,MAAM,CAAC;IACjC,yBAAyB,EAAE,MAAM,CAAC;IAClC,uBAAuB,EAAE,MAAM,CAAC;IAChC,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAMD,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,kBAAkB,CAChC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,OAAO,GAAE,MAAqB,EAC9B,SAAS,GAAE,MAA2B,GACrC,MAAM,CAkBR;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,OAAO,GAAE,MAAqB,GAC7B,MAAM,CAaR;AAED,wBAAgB,YAAY,IAAI,SAAS,CAsBxC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C"}

package/dist/config/yagr-home.js

@@ -27,6 +27,9 @@ export function resolveYagrHomeDir(env = process.env, platform = process.platfor
 export function getYagrHomeDir() {
     return resolveYagrHomeDir(process.env, process.platform, os.homedir(), getYagrLaunchDir());
 }
+export function getYagrN8nWorkspaceDir() {
+    return path.join(getYagrHomeDir(), 'n8n-workspace');
+}
 export function resolveLegacyConfStorePath(projectName, configName, env = process.env, platform = process.platform, homedir = os.homedir()) {
     const suffix = `${projectName}-nodejs`;
     if (platform === 'win32') {
@@ -42,14 +45,18 @@ export function resolveLegacyConfStorePath(projectName, configName, env = proces
 export function getYagrPaths() {
     const launchDir = getYagrLaunchDir();
     const homeDir = getYagrHomeDir();
+    const n8nWorkspaceDir = getYagrN8nWorkspaceDir();
     const legacyYagrCredentialsPath = resolveLegacyConfStorePath('yagr', 'credentials');
     const legacyN8nCredentialsPath = resolveLegacyConfStorePath('n8nac', 'credentials');
     return {
         launchDir,
         homeDir,
+        n8nWorkspaceDir,
+        homeInstructionsPath: path.join(homeDir, 'AGENTS.md'),
+        workspaceInstructionsPath: path.join(n8nWorkspaceDir, 'AGENTS.md'),
         yagrConfigPath: path.join(homeDir, 'yagr-config.json'),
         yagrCredentialsPath: path.join(homeDir, 'credentials.json'),
-        n8nConfigPath: path.join(homeDir, 'n8nac-config.json'),
+        n8nConfigPath: path.join(n8nWorkspaceDir, 'n8nac-config.json'),
         n8nCredentialsPath: path.join(homeDir, 'n8n-credentials.json'),
         legacyYagrCredentialsDir: path.dirname(legacyYagrCredentialsPath),
         legacyYagrCredentialsPath,
@@ -58,8 +65,9 @@ export function getYagrPaths() {
     };
 }
 export function ensureYagrHomeDir() {
-    const homeDir = getYagrHomeDir();
-    fs.mkdirSync(homeDir, { recursive: true });
-    return homeDir;
+    const paths = getYagrPaths();
+    fs.mkdirSync(paths.homeDir, { recursive: true });
+    fs.mkdirSync(paths.n8nWorkspaceDir, { recursive: true });
+    return paths.homeDir;
 }
 //# sourceMappingURL=yagr-home.js.map

package/dist/config/yagr-home.js.map

@@ -1 +1 @@
-{"version":3,"file":"yagr-home.js","sourceRoot":"","sources":["../../src/config/yagr-home.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"yagr-home.js","sourceRoot":"","sources":["../../src/config/yagr-home.ts"],"names":[],"mappings":"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"}

package/dist/gateway/format-message.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared message formatting utilities for TUI and Telegram gateways.
+ * Single source of truth for workflow-link rendering and markdown-to-surface conversion.
+ */
+import type { YagrToolEvent } from '../types.js';
+export interface WorkflowEmbed {
+    workflowId: string;
+    url: string;
+    title?: string;
+}
+export declare function extractWorkflowEmbed(event: YagrToolEvent): WorkflowEmbed | undefined;
+export declare function formatWorkflowLinkPlain(embed: WorkflowEmbed): string;
+export declare function formatWorkflowLinkHtml(embed: WorkflowEmbed): string;
+export declare function formatWorkflowLinkTerminal(embed: WorkflowEmbed): string;
+export declare function buildWorkflowFooterPlain(embeds: WorkflowEmbed[]): string;
+export declare function buildWorkflowFooterHtml(embeds: WorkflowEmbed[]): string;
+export declare function buildWorkflowFooterTerminal(embeds: WorkflowEmbed[]): string;
+export declare function escapeHtml(text: string): string;
+/**
+ * Convert LLM-produced markdown to Telegram-compatible HTML.
+ * Handles: fenced code blocks, inline code, bold, italic, links, headers, lists.
+ * Falls back to HTML-escaped plain text on any error.
+ */
+export declare function markdownToTelegramHtml(markdown: string): string;
+//# sourceMappingURL=format-message.d.ts.map

package/dist/gateway/format-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-message.d.ts","sourceRoot":"","sources":["../../src/gateway/format-message.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,GAAG,SAAS,CAKpF;AAMD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAGpE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAGnE;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAGvE;AAMD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAGxE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAGvE;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAG3E;AAMD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAMD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM/D"}

package/dist/gateway/format-message.js

@@ -0,0 +1,166 @@
+/**
+ * Shared message formatting utilities for TUI and Telegram gateways.
+ * Single source of truth for workflow-link rendering and markdown-to-surface conversion.
+ */
+export function extractWorkflowEmbed(event) {
+    if (event.type === 'embed' && event.kind === 'workflow') {
+        return { workflowId: event.workflowId, url: event.url, title: event.title };
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Workflow link formatting — one per surface
+// ---------------------------------------------------------------------------
+export function formatWorkflowLinkPlain(embed) {
+    const label = embed.title ?? `Workflow ${embed.workflowId}`;
+    return `🔗 ${label}\n   ${embed.url}`;
+}
+export function formatWorkflowLinkHtml(embed) {
+    const label = escapeHtml(embed.title ?? `Workflow ${embed.workflowId}`);
+    return `🔗 <b>${label}</b>\n${embed.url}`;
+}
+export function formatWorkflowLinkTerminal(embed) {
+    const label = embed.title ?? `Workflow ${embed.workflowId}`;
+    return `🔗 \x1b]8;;${embed.url}\x07${label}\x1b]8;;\x07`;
+}
+// ---------------------------------------------------------------------------
+// Workflow footer builder (appended to response messages)
+// ---------------------------------------------------------------------------
+export function buildWorkflowFooterPlain(embeds) {
+    if (embeds.length === 0)
+        return '';
+    return embeds.map(formatWorkflowLinkPlain).join('\n');
+}
+export function buildWorkflowFooterHtml(embeds) {
+    if (embeds.length === 0)
+        return '';
+    return embeds.map(formatWorkflowLinkHtml).join('\n');
+}
+export function buildWorkflowFooterTerminal(embeds) {
+    if (embeds.length === 0)
+        return '';
+    return embeds.map(formatWorkflowLinkTerminal).join('\n');
+}
+// ---------------------------------------------------------------------------
+// HTML escaping
+// ---------------------------------------------------------------------------
+export function escapeHtml(text) {
+    return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+// ---------------------------------------------------------------------------
+// Markdown → Telegram HTML conversion
+// ---------------------------------------------------------------------------
+/**
+ * Convert LLM-produced markdown to Telegram-compatible HTML.
+ * Handles: fenced code blocks, inline code, bold, italic, links, headers, lists.
+ * Falls back to HTML-escaped plain text on any error.
+ */
+export function markdownToTelegramHtml(markdown) {
+    try {
+        return convertMarkdownToHtml(markdown);
+    }
+    catch {
+        return escapeHtml(markdown);
+    }
+}
+function convertMarkdownToHtml(md) {
+    const lines = md.split('\n');
+    const output = [];
+    let inCode = false;
+    const codeBuf = [];
+    for (const line of lines) {
+        if (line.trimStart().startsWith('```')) {
+            if (inCode) {
+                output.push(`<pre>${escapeHtml(codeBuf.join('\n'))}</pre>`);
+                codeBuf.length = 0;
+            }
+            inCode = !inCode;
+            continue;
+        }
+        if (inCode) {
+            codeBuf.push(line);
+            continue;
+        }
+        output.push(convertMarkdownLine(line));
+    }
+    if (codeBuf.length > 0) {
+        output.push(`<pre>${escapeHtml(codeBuf.join('\n'))}</pre>`);
+    }
+    return output.join('\n');
+}
+function convertMarkdownLine(line) {
+    const trimmed = line.trimStart();
+    const headerMatch = trimmed.match(/^#{1,6}\s+(.+)$/);
+    if (headerMatch) {
+        return `\n<b>${convertInline(headerMatch[1])}</b>`;
+    }
+    if (/^[-*]\s/.test(trimmed)) {
+        return `• ${convertInline(trimmed.replace(/^[-*]\s+/, ''))}`;
+    }
+    return convertInline(line);
+}
+/**
+ * Character-level inline conversion.
+ * Extracts code spans, links, bold, italic one token at a time so that
+ * HTML entities inside code / URLs are never double-escaped.
+ */
+function convertInline(text) {
+    let result = '';
+    let i = 0;
+    while (i < text.length) {
+        // Inline code
+        if (text[i] === '`') {
+            const end = text.indexOf('`', i + 1);
+            if (end !== -1) {
+                result += `<code>${escapeHtml(text.slice(i + 1, end))}</code>`;
+                i = end + 1;
+                continue;
+            }
+        }
+        // Link: [text](url)
+        if (text[i] === '[') {
+            const closeBracket = text.indexOf(']', i + 1);
+            if (closeBracket !== -1 && text[closeBracket + 1] === '(') {
+                const closeParen = text.indexOf(')', closeBracket + 2);
+                if (closeParen !== -1) {
+                    const linkText = text.slice(i + 1, closeBracket);
+                    const url = text.slice(closeBracket + 2, closeParen);
+                    result += `<a href="${escapeHtml(url)}">${escapeHtml(linkText)}</a>`;
+                    i = closeParen + 1;
+                    continue;
+                }
+            }
+        }
+        // Bold: **text**
+        if (text[i] === '*' && text[i + 1] === '*') {
+            const end = text.indexOf('**', i + 2);
+            if (end !== -1) {
+                result += `<b>${escapeHtml(text.slice(i + 2, end))}</b>`;
+                i = end + 2;
+                continue;
+            }
+        }
+        // Italic: *text* (single asterisk, not followed by another)
+        if (text[i] === '*' && text[i + 1] !== '*') {
+            const end = text.indexOf('*', i + 1);
+            if (end !== -1 && text[end + 1] !== '*') {
+                result += `<i>${escapeHtml(text.slice(i + 1, end))}</i>`;
+                i = end + 1;
+                continue;
+            }
+        }
+        // Regular character — escape HTML
+        const ch = text[i];
+        if (ch === '&')
+            result += '&amp;';
+        else if (ch === '<')
+            result += '&lt;';
+        else if (ch === '>')
+            result += '&gt;';
+        else
+            result += ch;
+        i++;
+    }
+    return result;
+}
+//# sourceMappingURL=format-message.js.map

package/dist/gateway/format-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-message.js","sourceRoot":"","sources":["../../src/gateway/format-message.ts"],"names":[],"mappings":"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"}

package/dist/gateway/interactive-ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactive-ui.d.ts","sourceRoot":"","sources":["../../src/gateway/interactive-ui.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAMV,cAAc,EAGf,MAAM,aAAa,CAAC;AAkmBrB,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpG"}
+{"version":3,"file":"interactive-ui.d.ts","sourceRoot":"","sources":["../../src/gateway/interactive-ui.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAO7C,OAAO,KAAK,EAMV,cAAc,EAGf,MAAM,aAAa,CAAC;AAqwBrB,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpG"}