@ouro.bot/cli 0.1.0-alpha.44 → 0.1.0-alpha.441

package/dist/heart/daemon/hooks/bundle-meta.js

@@ -37,6 +37,115 @@ exports.bundleMetaHook = bundleMetaHook;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const runtime_1 = require("../../../nerves/runtime");
+/**
+ * Migrate bundle from schema 1 to schema 2:
+ * - Move state/{episodes,obligations,cares,intentions}/* to arc/{name}/*
+ * - Move the old psyche note store to diary/
+ * Idempotent: skips missing sources; on collision, newer mtime wins.
+ */
+function migrateToSchema2(agentRoot) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.bundle_migration_start",
+        message: "migrating bundle to schema 2",
+        meta: { agentRoot },
+    });
+    // Migrate arc entities
+    for (const name of ["episodes", "obligations", "cares", "intentions"]) {
+        const src = path.join(agentRoot, "state", name);
+        const dest = path.join(agentRoot, "arc", name);
+        migrateDirectory(src, dest);
+    }
+    // Migrate diary from the old pre-diary bundle layout.
+    const legacyDiarySrc = path.join(agentRoot, "psyche", "mem" + "ory");
+    const diaryDest = path.join(agentRoot, "diary");
+    migrateDirectory(legacyDiarySrc, diaryDest);
+    // Update bundle .gitignore
+    updateBundleGitignore(agentRoot);
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.bundle_migration_end",
+        message: "bundle migration to schema 2 complete",
+        meta: { agentRoot },
+    });
+}
+/**
+ * Ensure bundle .gitignore has state/ ignored and does NOT ignore arc/, diary/, journal/.
+ */
+function updateBundleGitignore(agentRoot) {
+    const gitignorePath = path.join(agentRoot, ".gitignore");
+    let lines = [];
+    try {
+        if (fs.existsSync(gitignorePath)) {
+            lines = fs.readFileSync(gitignorePath, "utf-8").split("\n");
+        }
+    }
+    catch {
+        // If we can't read, start fresh
+    }
+    // Remove arc/, diary/, journal/ from ignore (they should be tracked)
+    const toRemove = new Set(["arc/", "diary/", "journal/"]);
+    lines = lines.filter((line) => !toRemove.has(line.trim()));
+    // Ensure state/ is in the ignore list
+    const hasState = lines.some((line) => line.trim() === "state/");
+    if (!hasState) {
+        lines.push("state/");
+    }
+    // Write back, trimming trailing empty lines and ensuring trailing newline
+    const content = lines.join("\n").replace(/\n+$/, "") + "\n";
+    try {
+        fs.writeFileSync(gitignorePath, content, "utf-8");
+    }
+    catch {
+        // Non-blocking: if we can't write .gitignore, migration still succeeds
+    }
+}
+/**
+ * Recursively copy files from src to dest.
+ * Creates destination directories as needed. Skips if source doesn't exist.
+ * When both source and destination exist, compares mtimes: newer file wins.
+ * Logs a warning either way when a collision is detected.
+ */
+function migrateDirectory(src, dest) {
+    if (!fs.existsSync(src))
+        return;
+    fs.mkdirSync(dest, { recursive: true });
+    const entries = fs.readdirSync(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            migrateDirectory(srcPath, destPath);
+        }
+        else if (!fs.existsSync(destPath)) {
+            fs.copyFileSync(srcPath, destPath);
+        }
+        else {
+            // Collision: both source and destination exist — compare mtimes
+            const srcMtime = fs.statSync(srcPath).mtimeMs;
+            const destMtime = fs.statSync(destPath).mtimeMs;
+            if (srcMtime > destMtime) {
+                fs.copyFileSync(srcPath, destPath);
+                (0, runtime_1.emitNervesEvent)({
+                    level: "warn",
+                    component: "daemon",
+                    event: "daemon.bundle_migration_collision",
+                    message: `migration collision: source newer, overwriting destination`,
+                    meta: { srcPath, destPath, srcMtime, destMtime },
+                });
+            }
+            else {
+                (0, runtime_1.emitNervesEvent)({
+                    level: "warn",
+                    component: "daemon",
+                    event: "daemon.bundle_migration_collision",
+                    message: `migration collision: destination newer or equal, keeping destination`,
+                    meta: { srcPath, destPath, srcMtime, destMtime },
+                });
+            }
+        }
+    }
+}
 async function bundleMetaHook(ctx) {
     (0, runtime_1.emitNervesEvent)({
         component: "daemon",
@@ -56,9 +165,14 @@ async function bundleMetaHook(ctx) {
         // Malformed JSON -- treat as missing, will overwrite with fresh
         existing = undefined;
     }
+    // Run schema-2 migration if needed
+    const currentSchema = existing?.bundleSchemaVersion ?? 1;
+    if (currentSchema < 2) {
+        migrateToSchema2(ctx.agentRoot);
+    }
     const updated = {
         runtimeVersion: ctx.currentVersion,
-        bundleSchemaVersion: existing?.bundleSchemaVersion ?? 1,
+        bundleSchemaVersion: currentSchema < 2 ? 2 : currentSchema,
         lastUpdated: new Date().toISOString(),
     };
     // Save old runtimeVersion as previousRuntimeVersion (if there was one)

package/dist/heart/daemon/http-health-probe.js

@@ -0,0 +1,80 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHttpHealthProbe = createHttpHealthProbe;
+const http = __importStar(require("node:http"));
+function createHttpHealthProbe(name, port, timeoutMs = 5000) {
+    return {
+        name,
+        check: () => new Promise((resolve) => {
+            const req = http.get({
+                hostname: "127.0.0.1",
+                port,
+                path: "/health",
+                timeout: timeoutMs,
+            }, (res) => {
+                let body = "";
+                res.on("data", (chunk) => {
+                    body += chunk.toString();
+                });
+                res.on("end", () => {
+                    if (res.statusCode !== 200) {
+                        resolve({ ok: false, detail: `HTTP ${res.statusCode}` });
+                        return;
+                    }
+                    try {
+                        const parsed = JSON.parse(body);
+                        if (parsed.status === "ok") {
+                            resolve({ ok: true });
+                        }
+                        else {
+                            resolve({ ok: false, detail: `unexpected status: ${String(parsed.status)}` });
+                        }
+                    }
+                    catch {
+                        resolve({ ok: false, detail: "invalid JSON response" });
+                    }
+                });
+            });
+            req.on("timeout", () => {
+                req.destroy();
+                resolve({ ok: false, detail: "timeout" });
+            });
+            req.on("error", (err) => {
+                resolve({ ok: false, detail: err.message });
+            });
+        }),
+    };
+}

package/dist/heart/daemon/human-command-screens.js

@@ -0,0 +1,236 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildOuroHomeActions = buildOuroHomeActions;
+exports.resolveOuroHomeAction = resolveOuroHomeAction;
+exports.renderOuroHomeScreen = renderOuroHomeScreen;
+exports.renderAgentPickerScreen = renderAgentPickerScreen;
+exports.resolveNamedAgentSelection = resolveNamedAgentSelection;
+exports.renderHumanReadinessBoard = renderHumanReadinessBoard;
+exports.renderHumanCommandBoard = renderHumanCommandBoard;
+exports.renderHouseStatusScreen = renderHouseStatusScreen;
+const runtime_1 = require("../../nerves/runtime");
+const terminal_ui_1 = require("./terminal-ui");
+function renderScreenEvent(screen) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.human_screen_rendered",
+        message: "rendered human command screen",
+        meta: { screen },
+    });
+}
+function buildOuroHomeActions(agents) {
+    if (agents.length === 0) {
+        return [
+            { key: "1", label: "Hatch a new agent", kind: "hatch", command: "ouro hatch" },
+            { key: "2", label: "Clone an existing bundle", kind: "clone", command: "ouro clone <remote>" },
+            { key: "3", label: "Show help", kind: "help", command: "ouro --help" },
+            { key: "4", label: "Exit", kind: "exit", command: "exit" },
+        ];
+    }
+    const actions = agents.map((agent, index) => ({
+        key: String(index + 1),
+        label: `Talk to ${agent}`,
+        kind: "chat",
+        command: `ouro chat ${agent}`,
+        agent,
+    }));
+    return [
+        ...actions,
+        { key: String(actions.length + 1), label: "Prepare the house", kind: "up", command: "ouro up" },
+        { key: String(actions.length + 2), label: "Connect an agent", kind: "connect", command: "ouro connect --agent <agent>" },
+        { key: String(actions.length + 3), label: "Repair an agent", kind: "repair", command: "ouro repair --agent <agent>" },
+        { key: String(actions.length + 4), label: "Show help", kind: "help", command: "ouro --help" },
+        { key: String(actions.length + 5), label: "Exit", kind: "exit", command: "exit" },
+    ];
+}
+function resolveOuroHomeAction(answer, actions) {
+    const normalized = answer.trim().toLowerCase();
+    if (!normalized)
+        return undefined;
+    const byKey = actions.find((action) => action.key === normalized);
+    if (byKey)
+        return byKey;
+    const byAgent = actions.find((action) => action.agent?.toLowerCase() === normalized);
+    if (byAgent)
+        return byAgent;
+    return actions.find((action) => action.kind === normalized || action.label.toLowerCase() === normalized);
+}
+function renderOuroHomeScreen(options) {
+    renderScreenEvent("home");
+    const actions = buildOuroHomeActions(options.agents);
+    const sections = [
+        {
+            title: options.agents.length === 0 ? "Start here" : "Around the house",
+            lines: options.agents.length === 0
+                ? ["No agents are home yet. Hatch someone new or bring an existing bundle aboard."]
+                : options.agents.map((agent) => `${agent} is home and ready when called.`),
+        },
+    ];
+    const actionRows = actions.map((action, index) => ({
+        label: action.label,
+        actor: "agent-runnable",
+        command: action.command,
+        ...(index === 0 ? { recommended: true } : {}),
+    }));
+    return (0, terminal_ui_1.renderTerminalBoard)({
+        isTTY: options.isTTY,
+        columns: options.columns,
+        masthead: {
+            subtitle: options.agents.length === 0
+                ? "No agents are home yet."
+                : "Welcome home.",
+        },
+        title: "Ouro home",
+        summary: options.agents.length === 0
+            ? "Hatch someone new or bring an existing bundle aboard."
+            : "Choose who to wake or what to prepare without memorizing commands.",
+        sections,
+        actions: actionRows,
+        prompt: `Choose [1-${actions.length}] or type a name: `,
+    });
+}
+function renderAgentPickerScreen(options) {
+    renderScreenEvent("agent-picker");
+    return (0, terminal_ui_1.renderTerminalBoard)({
+        isTTY: options.isTTY,
+        columns: options.columns,
+        masthead: {
+            subtitle: options.subtitle,
+        },
+        title: options.title,
+        summary: "Type the number or name that matches the agent you want.",
+        sections: [
+            {
+                title: "Agents",
+                lines: options.agents.map((agent, index) => `${index + 1}. ${agent}`),
+            },
+        ],
+        prompt: `Choose [1-${options.agents.length}] or type a name: `,
+    });
+}
+function resolveNamedAgentSelection(answer, agents) {
+    const normalized = answer.trim().toLowerCase();
+    if (!normalized)
+        return undefined;
+    const numbered = Number.parseInt(normalized, 10);
+    if (Number.isFinite(numbered))
+        return agents[numbered - 1];
+    return agents.find((agent) => agent.toLowerCase() === normalized);
+}
+function statusLabel(status) {
+    return status.replace(/-/g, " ");
+}
+function renderHumanReadinessBoard(options) {
+    renderScreenEvent("readiness");
+    const sections = options.snapshot.items.map((item) => ({
+        title: item.title,
+        lines: [
+            `${statusLabel(item.status)} — ${item.summary}`,
+            ...item.detailLines,
+        ],
+    }));
+    return renderHumanCommandBoard({
+        title: options.title,
+        subtitle: options.subtitle,
+        summary: options.snapshot.summary,
+        isTTY: options.isTTY,
+        columns: options.columns,
+        sections,
+        actions: options.snapshot.nextActions,
+        prompt: options.prompt,
+    });
+}
+function renderHumanCommandBoard(options) {
+    renderScreenEvent("command-board");
+    return (0, terminal_ui_1.renderTerminalBoard)({
+        isTTY: options.isTTY,
+        columns: options.columns,
+        masthead: {
+            subtitle: options.subtitle,
+        },
+        title: options.title,
+        summary: options.summary,
+        sections: options.sections,
+        actions: options.actions,
+        prompt: options.prompt,
+    });
+}
+function renderHouseStatusScreen(options) {
+    renderScreenEvent("house-status");
+    const sections = [
+        {
+            title: "House pulse",
+            lines: [
+                `Daemon: ${options.payload.overview.daemon}`,
+                `Health: ${options.payload.overview.health}`,
+                `Outlook: ${options.payload.overview.outlookUrl}`,
+                `Updated: ${options.payload.overview.lastUpdated}`,
+            ],
+        },
+    ];
+    if (options.payload.agents.length > 0) {
+        sections.push({
+            title: "Agents",
+            lines: options.payload.agents.map((agent) => `${agent.name} — ${agent.enabled ? "enabled" : "disabled"}`),
+        });
+    }
+    if (options.payload.providers.length > 0) {
+        sections.push({
+            title: "Providers",
+            lines: options.payload.providers.map((provider) => {
+                const detail = [provider.readiness, provider.detail, provider.source, provider.credential].filter(Boolean).join("; ");
+                return `${provider.agent} ${provider.lane} — ${provider.provider} / ${provider.model}${detail ? ` — ${detail}` : ""}`;
+            }),
+        });
+    }
+    if (options.payload.senses.length > 0) {
+        sections.push({
+            title: "Senses",
+            lines: options.payload.senses.map((sense) => {
+                const status = sense.enabled ? sense.status : "disabled";
+                return `${sense.agent} — ${sense.label ?? sense.sense} — ${status}${sense.detail ? ` — ${sense.detail}` : ""}`;
+            }),
+        });
+    }
+    if (options.payload.workers.length > 0) {
+        sections.push({
+            title: "Workers",
+            lines: options.payload.workers.map((worker) => {
+                const details = [`restarts: ${worker.restartCount}`];
+                if (worker.pid !== null)
+                    details.unshift(`pid ${worker.pid}`);
+                if (worker.lastExitCode !== null)
+                    details.push(`exit=${worker.lastExitCode}`);
+                if (worker.lastSignal !== null)
+                    details.push(`signal=${worker.lastSignal}`);
+                if (worker.errorReason)
+                    details.push(`error: ${worker.errorReason}`);
+                if (worker.fixHint)
+                    details.push(`fix: ${worker.fixHint}`);
+                return `${worker.agent} — ${worker.worker} — ${worker.status} — ${details.join("; ")}`;
+            }),
+        });
+    }
+    if (options.payload.sync.length > 0) {
+        sections.push({
+            title: "Git sync",
+            lines: options.payload.sync.map((row) => {
+                if (!row.enabled)
+                    return `${row.agent} — disabled`;
+                if (row.gitInitialized === false)
+                    return `${row.agent} — needs git init`;
+                if (row.remoteUrl)
+                    return `${row.agent} — ${row.remote} -> ${row.remoteUrl}`;
+                return `${row.agent} — local only`;
+            }),
+        });
+    }
+    return renderHumanCommandBoard({
+        title: "House status",
+        subtitle: "The house is awake enough to answer clearly.",
+        summary: "What is awake, resting, or asking for care.",
+        isTTY: options.isTTY,
+        columns: options.columns,
+        sections,
+    });
+}

package/dist/heart/daemon/human-readiness.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readinessItemFromIssue = readinessItemFromIssue;
+exports.buildHumanReadinessSnapshot = buildHumanReadinessSnapshot;
+const runtime_1 = require("../../nerves/runtime");
+const STATUS_PRIORITY = {
+    locked: 0,
+    "needs credentials": 1,
+    "needs attention": 2,
+    "needs setup": 3,
+    missing: 4,
+    "not attached": 5,
+    ready: 6,
+    attached: 6,
+};
+function statusFromIssue(issue) {
+    switch (issue.kind) {
+        case "vault-locked":
+            return "locked";
+        case "vault-unconfigured":
+            return "needs setup";
+        case "provider-credentials-missing":
+            return "needs credentials";
+        case "provider-live-check-failed":
+            return issue.actions[0]?.kind === "provider-auth" ? "needs credentials" : "needs attention";
+        case "generic":
+            return "needs attention";
+    }
+}
+function copyActions(actions) {
+    return actions.map((action) => ({
+        label: action.label,
+        command: action.command,
+        actor: action.actor,
+        ...(action.executable === undefined ? {} : { executable: action.executable }),
+    }));
+}
+function readinessItemFromIssue(issue, options) {
+    return {
+        key: options.key,
+        title: options.title,
+        status: statusFromIssue(issue),
+        summary: issue.summary,
+        detailLines: issue.detail ? [issue.detail] : [],
+        actions: copyActions(issue.actions),
+    };
+}
+function compareStatus(a, b) {
+    return STATUS_PRIORITY[a.status] - STATUS_PRIORITY[b.status];
+}
+function uniqueActions(items) {
+    const seen = new Set();
+    const actions = [];
+    for (const item of [...items].sort(compareStatus)) {
+        for (const [index, action] of item.actions.entries()) {
+            if (seen.has(action.command))
+                continue;
+            seen.add(action.command);
+            actions.push({
+                ...action,
+                ...(actions.length === 0 && index === 0 ? { recommended: true } : {}),
+            });
+        }
+    }
+    return actions;
+}
+function overallStatus(items) {
+    if (items.length === 0)
+        return "ready";
+    return [...items].sort(compareStatus)[0].status;
+}
+function summaryFor(status) {
+    if (status === "ready" || status === "attached") {
+        return "Everything needed here is ready.";
+    }
+    if (status === "locked") {
+        return "Start by unlocking the vault on this machine, then continue through the remaining steps.";
+    }
+    if (status === "needs credentials") {
+        return "At least one credential is missing, so the next move is to authenticate it.";
+    }
+    if (status === "needs attention") {
+        return "Something is configured but not healthy yet, so verify or refresh it before moving on.";
+    }
+    if (status === "needs setup") {
+        return "This capability needs setup before it can be used.";
+    }
+    return "This area still needs a little attention.";
+}
+function buildHumanReadinessSnapshot(options) {
+    const status = overallStatus(options.items);
+    const nextActions = uniqueActions(options.items);
+    const primaryAction = nextActions[0];
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.human_readiness_snapshot",
+        message: "built human readiness snapshot",
+        meta: {
+            agent: options.agent,
+            title: options.title,
+            items: options.items.length,
+            status,
+        },
+    });
+    return {
+        agent: options.agent,
+        title: options.title,
+        status,
+        summary: summaryFor(status),
+        items: [...options.items].sort(compareStatus),
+        ...(primaryAction ? { primaryAction } : {}),
+        nextActions,
+    };
+}

package/dist/heart/daemon/inner-status.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildInnerStatusOutput = buildInnerStatusOutput;
+const runtime_1 = require("../../nerves/runtime");
+function formatRelativeTime(elapsedMs) {
+    const minutes = Math.floor(elapsedMs / (60 * 1000));
+    if (minutes < 1)
+        return "just now";
+    if (minutes === 1)
+        return "1 minute ago";
+    if (minutes < 60)
+        return `${minutes} minutes ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours === 1)
+        return "1 hour ago";
+    return `${hours} hours ago`;
+}
+function formatCadence(cadenceMs) {
+    const minutes = Math.round(cadenceMs / (60 * 1000));
+    if (minutes >= 60) {
+        const hours = Math.round(minutes / 60);
+        return `${hours}h`;
+    }
+    return `${minutes}m`;
+}
+function buildInnerStatusOutput(input) {
+    const { agentName, runtimeState, journalFiles, heartbeat, attentionCount, now } = input;
+    const lines = [];
+    lines.push(`inner dialog status: ${agentName}`);
+    // Last turn
+    if (runtimeState?.lastCompletedAt) {
+        const lastMs = new Date(runtimeState.lastCompletedAt).getTime();
+        const elapsed = now - lastMs;
+        const relativeTime = formatRelativeTime(elapsed);
+        const reasonSuffix = runtimeState.reason ? ` (${runtimeState.reason})` : "";
+        lines.push(`  last turn: ${relativeTime}${reasonSuffix}`);
+    }
+    else {
+        lines.push("  last turn: unknown");
+    }
+    // Status
+    if (runtimeState) {
+        const reasonSuffix = runtimeState.status === "running" && runtimeState.reason ? ` (${runtimeState.reason})` : "";
+        lines.push(`  status: ${runtimeState.status}${reasonSuffix}`);
+    }
+    else {
+        lines.push("  status: unknown");
+    }
+    // Heartbeat health
+    if (heartbeat && heartbeat.lastCompletedAt !== null) {
+        const elapsed = now - heartbeat.lastCompletedAt;
+        const threshold = heartbeat.cadenceMs * 1.5;
+        const health = elapsed < threshold ? "healthy" : "overdue";
+        const cadenceStr = formatCadence(heartbeat.cadenceMs);
+        const sinceStr = formatRelativeTime(elapsed);
+        lines.push(`  heartbeat: ${health} (cadence ${cadenceStr}, ${sinceStr})`);
+    }
+    else {
+        lines.push("  heartbeat: unknown");
+    }
+    // Journal
+    if (journalFiles.length === 0) {
+        lines.push("  journal: (empty)");
+    }
+    else {
+        lines.push("  journal:");
+        const sorted = [...journalFiles].sort((a, b) => b.mtimeMs - a.mtimeMs);
+        for (const file of sorted) {
+            const elapsed = now - file.mtimeMs;
+            const relativeTime = formatRelativeTime(elapsed);
+            lines.push(`    - ${file.name} (${relativeTime})`);
+        }
+    }
+    // Attention
+    const thoughtWord = attentionCount === 1 ? "thought" : "thoughts";
+    lines.push(`  attention: ${attentionCount} held ${thoughtWord}`);
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.inner_status_read",
+        message: "inner dialog status read",
+        meta: {
+            agentName,
+            status: runtimeState?.status ?? "unknown",
+            journalCount: journalFiles.length,
+            attentionCount,
+        },
+    });
+    return lines.join("\n");
+}