dot-studio 0.0.1 → 0.0.2

package/dist/server/routes/opencode.js

@@ -1,421 +1,11 @@
-// OpenCode SDK Proxy Routes
-// Models, Agents, Tools, Config, Provider Auth, File, Find, VCS, LSP, MCP
 import { Hono } from 'hono';
-import { getOpencode } from '../lib/opencode.js';
-import { cached, invalidate, TTL } from '../lib/cache.js';
-import { resolveRuntimeTools } from '../lib/runtime-tools.js';
-import { requestDirectoryQuery, resolveRequestWorkingDir } from '../lib/request-context.js';
-import { canRestartOpencodeSidecar, isManagedOpencode, restartOpencodeSidecar } from '../lib/opencode-sidecar.js';
-import { OPENCODE_URL } from '../lib/config.js';
-import { clearStoredProviderAuth } from '../lib/opencode-auth.js';
-import { jsonOpencodeError, unwrapOpencodeResult } from '../lib/opencode-errors.js';
-import { listRuntimeModels } from '../lib/model-catalog.js';
-import { readProjectMcpCatalog, summarizeProjectMcpCatalog } from '../lib/project-config.js';
+import opencodeCore from './opencode-core.js';
+import opencodeProvider from './opencode-provider.js';
+import opencodeMcp from './opencode-mcp.js';
+import opencodeFile from './opencode-file.js';
 const opencode = new Hono();
-// ── OpenCode Health ─────────────────────────────────────
-opencode.get('/api/opencode/health', async (c) => {
-    try {
-        const oc = await getOpencode();
-        const res = await oc.project.current(requestDirectoryQuery(c));
-        const data = res.data;
-        return c.json({
-            connected: true,
-            url: OPENCODE_URL,
-            project: data,
-            managed: isManagedOpencode(),
-            mode: isManagedOpencode() ? 'managed' : 'external',
-            restartAvailable: canRestartOpencodeSidecar(),
-        });
-    }
-    catch (err) {
-        return c.json({
-            connected: false,
-            error: err.message,
-            url: OPENCODE_URL,
-            managed: isManagedOpencode(),
-            mode: isManagedOpencode() ? 'managed' : 'external',
-            restartAvailable: canRestartOpencodeSidecar(),
-        }, 503);
-    }
-});
-opencode.post('/api/opencode/restart', async (c) => {
-    try {
-        await restartOpencodeSidecar();
-        return c.json({
-            ok: true,
-            managed: isManagedOpencode(),
-            mode: isManagedOpencode() ? 'managed' : 'external',
-        });
-    }
-    catch (err) {
-        return c.json({ error: err.message }, 400);
-    }
-});
-// ── Models ──────────────────────────────────────────────
-opencode.get('/api/models', async (c) => {
-    try {
-        const cwd = resolveRequestWorkingDir(c);
-        return c.json(await listRuntimeModels(cwd));
-    }
-    catch {
-        return c.json([]);
-    }
-});
-opencode.get('/api/providers', async (c) => {
-    try {
-        const cwd = resolveRequestWorkingDir(c);
-        const oc = await getOpencode();
-        const data = unwrapOpencodeResult(await oc.provider.list({ directory: cwd }));
-        const connected = new Set((data?.connected || []));
-        const providers = (data?.all || []).map((provider) => ({
-            id: provider.id,
-            name: provider.name || provider.id,
-            source: provider.source || 'builtin',
-            env: Array.isArray(provider.env) ? provider.env : [],
-            connected: connected.has(provider.id),
-            modelCount: provider.models ? Object.keys(provider.models).length : 0,
-            defaultModel: data?.default?.[provider.id] || null,
-        }));
-        return c.json(providers);
-    }
-    catch (err) {
-        return jsonOpencodeError(c, err, { defaultStatus: 503 });
-    }
-});
-// ── Agents ──────────────────────────────────────────────
-opencode.get('/api/agents', async (c) => {
-    try {
-        const oc = await getOpencode();
-        const res = await oc.app.agents(requestDirectoryQuery(c));
-        const data = res.data;
-        return c.json(data || []);
-    }
-    catch {
-        return c.json([]);
-    }
-});
-// ── Tools ───────────────────────────────────────────────
-opencode.get('/api/tools', async (c) => {
-    try {
-        const oc = await getOpencode();
-        const res = await oc.tool.ids(requestDirectoryQuery(c));
-        const data = res.data;
-        return c.json(data || []);
-    }
-    catch {
-        return c.json([]);
-    }
-});
-opencode.get('/api/tools/:provider/:model', async (c) => {
-    try {
-        const oc = await getOpencode();
-        const res = await oc.tool.list({
-            ...requestDirectoryQuery(c),
-            provider: c.req.param('provider'),
-            model: c.req.param('model'),
-        });
-        const data = res.data;
-        return c.json(data || []);
-    }
-    catch (err) {
-        return c.json({ error: err.message }, 500);
-    }
-});
-opencode.post('/api/runtime/tools', async (c) => {
-    const { model = null, mcpServerNames = [] } = await c.req.json();
-    try {
-        const resolution = await resolveRuntimeTools(resolveRequestWorkingDir(c), model, mcpServerNames);
-        return c.json(resolution);
-    }
-    catch (err) {
-        return c.json({ error: err.message }, 500);
-    }
-});
-// ── Config ──────────────────────────────────────────────
-opencode.get('/api/config', async (c) => {
-    try {
-        const oc = await getOpencode();
-        const res = await oc.config.get(requestDirectoryQuery(c));
-        const data = res.data;
-        return c.json(data || {});
-    }
-    catch (err) {
-        return c.json({ error: err.message }, 500);
-    }
-});
-opencode.get('/api/config/project', async (c) => {
-    const cwd = resolveRequestWorkingDir(c);
-    try {
-        const oc = await getOpencode();
-        const res = await oc.file.read({
-            directory: cwd,
-            path: 'config.json',
-        });
-        const data = res.data;
-        const raw = typeof data?.content === 'string' ? data.content : '{}';
-        const config = JSON.parse(raw);
-        return c.json({
-            exists: true,
-            path: `${cwd}/config.json`,
-            config,
-        });
-    }
-    catch {
-        return c.json({
-            exists: false,
-            path: `${cwd}/config.json`,
-            config: {},
-        });
-    }
-});
-opencode.put('/api/config', async (c) => {
-    const body = await c.req.json();
-    try {
-        const oc = await getOpencode();
-        const res = await oc.config.update({ ...requestDirectoryQuery(c), config: body });
-        const data = res.data;
-        invalidate('mcp-servers');
-        return c.json(data);
-    }
-    catch (err) {
-        return c.json({ error: err.message }, 500);
-    }
-});
-// ── Provider Auth ───────────────────────────────────────
-opencode.get('/api/provider/auth', async (c) => {
-    try {
-        const oc = await getOpencode();
-        const data = unwrapOpencodeResult(await oc.provider.auth(requestDirectoryQuery(c)));
-        return c.json(data || {});
-    }
-    catch (err) {
-        return jsonOpencodeError(c, err, { defaultStatus: 503 });
-    }
-});
-opencode.post('/api/provider/:id/oauth/authorize', async (c) => {
-    const { method } = await c.req.json();
-    try {
-        const oc = await getOpencode();
-        const data = unwrapOpencodeResult(await oc.provider.oauth.authorize({
-            providerID: c.req.param('id'),
-            ...requestDirectoryQuery(c),
-            method,
-        }));
-        return c.json(data);
-    }
-    catch (err) {
-        return jsonOpencodeError(c, err, { providerId: c.req.param('id'), defaultStatus: 500 });
-    }
-});
-opencode.post('/api/provider/:id/oauth/callback', async (c) => {
-    const { method, code } = await c.req.json();
-    try {
-        const oc = await getOpencode();
-        const data = unwrapOpencodeResult(await oc.provider.oauth.callback({
-            providerID: c.req.param('id'),
-            ...requestDirectoryQuery(c),
-            method,
-            ...(code ? { code } : {}),
-        }));
-        unwrapOpencodeResult(await oc.instance.dispose(requestDirectoryQuery(c)));
-        return c.json(data);
-    }
-    catch (err) {
-        return jsonOpencodeError(c, err, { providerId: c.req.param('id'), defaultStatus: 500 });
-    }
-});
-opencode.put('/api/provider/:id/auth', async (c) => {
-    const auth = await c.req.json();
-    try {
-        const oc = await getOpencode();
-        const data = unwrapOpencodeResult(await oc.auth.set({
-            providerID: c.req.param('id'),
-            auth,
-        }));
-        unwrapOpencodeResult(await oc.instance.dispose(requestDirectoryQuery(c)));
-        return c.json(data);
-    }
-    catch (err) {
-        return jsonOpencodeError(c, err, { providerId: c.req.param('id'), defaultStatus: 500 });
-    }
-});
-opencode.delete('/api/provider/:id/auth', async (c) => {
-    try {
-        const oc = await getOpencode();
-        await clearStoredProviderAuth(c.req.param('id'));
-        unwrapOpencodeResult(await oc.instance.dispose(requestDirectoryQuery(c)));
-        return c.json({ ok: true });
-    }
-    catch (err) {
-        return jsonOpencodeError(c, err, { providerId: c.req.param('id'), defaultStatus: 500 });
-    }
-});
-// ── LSP ─────────────────────────────────────────────────
-opencode.get('/api/lsp/status', async (c) => {
-    try {
-        const oc = await getOpencode();
-        const res = await oc.lsp.status(requestDirectoryQuery(c));
-        const data = res.data;
-        return c.json(data || []);
-    }
-    catch (err) {
-        return c.json({ error: err.message }, 500);
-    }
-});
-// ── MCP Servers ─────────────────────────────────────────
-opencode.get('/api/mcp/servers', async (c) => {
-    try {
-        const cwd = resolveRequestWorkingDir(c);
-        return c.json(await cached(`mcp-servers-${cwd}`, TTL.MCP_SERVERS, async () => {
-            const oc = await getOpencode();
-            const res = await oc.mcp.status({ directory: cwd });
-            const data = (res.data || {});
-            const catalog = await readProjectMcpCatalog(cwd);
-            return summarizeProjectMcpCatalog(catalog, data);
-        }));
-    }
-    catch {
-        return c.json([]);
-    }
-});
-opencode.post('/api/mcp/add', async (c) => {
-    const { name, config } = await c.req.json();
-    try {
-        const oc = await getOpencode();
-        const res = await oc.mcp.add({
-            ...requestDirectoryQuery(c),
-            name,
-            config: config,
-        });
-        const data = res.data;
-        invalidate('mcp-servers');
-        return c.json(data);
-    }
-    catch (err) {
-        return c.json({ error: err.message }, 500);
-    }
-});
-opencode.post('/api/mcp/:name/connect', async (c) => {
-    try {
-        const oc = await getOpencode();
-        const res = await oc.mcp.connect({
-            name: c.req.param('name'),
-            ...requestDirectoryQuery(c),
-        });
-        const data = res.data;
-        invalidate('mcp-servers');
-        return c.json(data);
-    }
-    catch (err) {
-        return c.json({ error: err.message }, 500);
-    }
-});
-opencode.post('/api/mcp/:name/disconnect', async (c) => {
-    try {
-        const oc = await getOpencode();
-        const res = await oc.mcp.disconnect({
-            name: c.req.param('name'),
-            ...requestDirectoryQuery(c),
-        });
-        const data = res.data;
-        invalidate('mcp-servers');
-        return c.json(data);
-    }
-    catch (err) {
-        return c.json({ error: err.message }, 500);
-    }
-});
-// ── File ────────────────────────────────────────────────
-opencode.get('/api/file/list', async (c) => {
-    const dirPath = c.req.query('path') || '.';
-    try {
-        const oc = await getOpencode();
-        const res = await oc.file.list({ ...requestDirectoryQuery(c), path: dirPath });
-        const data = res.data;
-        return c.json(data || []);
-    }
-    catch {
-        return c.json([]);
-    }
-});
-opencode.get('/api/file/read', async (c) => {
-    const filePath = c.req.query('path');
-    if (!filePath)
-        return c.json({ error: 'path required' }, 400);
-    try {
-        const oc = await getOpencode();
-        const res = await oc.file.read({ ...requestDirectoryQuery(c), path: filePath });
-        const data = res.data;
-        return c.json(data);
-    }
-    catch (err) {
-        return c.json({ error: err.message }, 500);
-    }
-});
-opencode.get('/api/file/status', async (c) => {
-    try {
-        const oc = await getOpencode();
-        const res = await oc.file.status(requestDirectoryQuery(c));
-        const data = res.data;
-        return c.json(data || []);
-    }
-    catch {
-        return c.json([]);
-    }
-});
-// ── Find ────────────────────────────────────────────────
-opencode.get('/api/find/text', async (c) => {
-    const pattern = c.req.query('pattern');
-    if (!pattern)
-        return c.json({ error: 'pattern required' }, 400);
-    try {
-        const oc = await getOpencode();
-        const res = await oc.find.text({ ...requestDirectoryQuery(c), pattern });
-        const data = res.data;
-        return c.json(data || []);
-    }
-    catch (err) {
-        return c.json({ error: err.message }, 500);
-    }
-});
-opencode.get('/api/find/files', async (c) => {
-    const pattern = c.req.query('pattern');
-    if (!pattern)
-        return c.json({ error: 'pattern required' }, 400);
-    try {
-        const oc = await getOpencode();
-        const res = await oc.find.files({ ...requestDirectoryQuery(c), query: pattern });
-        const data = res.data;
-        return c.json(data || []);
-    }
-    catch (err) {
-        return c.json({ error: err.message }, 500);
-    }
-});
-opencode.get('/api/find/symbols', async (c) => {
-    const pattern = c.req.query('pattern');
-    if (!pattern)
-        return c.json({ error: 'pattern required' }, 400);
-    try {
-        const oc = await getOpencode();
-        const res = await oc.find.symbols({ ...requestDirectoryQuery(c), query: pattern });
-        const data = res.data;
-        return c.json(data || []);
-    }
-    catch (err) {
-        return c.json({ error: err.message }, 500);
-    }
-});
-// ── VCS / Git ───────────────────────────────────────────
-opencode.get('/api/vcs', async (c) => {
-    try {
-        const oc = await getOpencode();
-        const res = await oc.vcs.get(requestDirectoryQuery(c));
-        const data = res.data;
-        return c.json(data || {});
-    }
-    catch (err) {
-        return c.json({ error: err.message }, 500);
-    }
-});
+opencode.route('/', opencodeCore);
+opencode.route('/', opencodeProvider);
+opencode.route('/', opencodeMcp);
+opencode.route('/', opencodeFile);
 export default opencode;

package/dist/server/routes/route-errors.js

@@ -0,0 +1,10 @@
+import { resolveRequestWorkingDir } from '../lib/request-context.js';
+export function jsonError(c, message, status = 400) {
+    return c.json({ error: message }, { status });
+}
+export function requestWorkingDir(c) {
+    return resolveRequestWorkingDir(c);
+}
+export function jsonServiceFailure(c, result) {
+    return c.json({ error: result.error }, { status: result.status });
+}

package/dist/server/routes/safe-actions.js

@@ -0,0 +1,60 @@
+import { Hono } from 'hono';
+import { applySafeOwnerSummary, discardAllSafeOwnerSummaryChanges, discardSafeOwnerSummaryFile, parseSafeOwnerKind, undoLastSafeOwnerSummaryApply, } from '../services/safe-service.js';
+import { jsonError, requestWorkingDir } from './route-errors.js';
+const safeActions = new Hono();
+function errorMessage(error, fallback) {
+    return error instanceof Error && error.message ? error.message : fallback;
+}
+safeActions.post('/api/safe/:ownerKind/:ownerId/apply', async (c) => {
+    const ownerKind = parseSafeOwnerKind(c.req.param('ownerKind'));
+    if (!ownerKind) {
+        return jsonError(c, 'Invalid owner kind.');
+    }
+    try {
+        return c.json(await applySafeOwnerSummary(requestWorkingDir(c), ownerKind, c.req.param('ownerId')));
+    }
+    catch (error) {
+        return jsonError(c, errorMessage(error, 'Failed to apply safe mode changes.'), 500);
+    }
+});
+safeActions.post('/api/safe/:ownerKind/:ownerId/discard', async (c) => {
+    const ownerKind = parseSafeOwnerKind(c.req.param('ownerKind'));
+    if (!ownerKind) {
+        return jsonError(c, 'Invalid owner kind.');
+    }
+    const body = await c.req.json().catch(() => ({}));
+    if (!body.filePath || !body.filePath.trim()) {
+        return jsonError(c, 'filePath is required.');
+    }
+    try {
+        return c.json(await discardSafeOwnerSummaryFile(requestWorkingDir(c), ownerKind, c.req.param('ownerId'), body.filePath.trim()));
+    }
+    catch (error) {
+        return jsonError(c, errorMessage(error, 'Failed to discard the file.'), 500);
+    }
+});
+safeActions.post('/api/safe/:ownerKind/:ownerId/discard-all', async (c) => {
+    const ownerKind = parseSafeOwnerKind(c.req.param('ownerKind'));
+    if (!ownerKind) {
+        return jsonError(c, 'Invalid owner kind.');
+    }
+    try {
+        return c.json(await discardAllSafeOwnerSummaryChanges(requestWorkingDir(c), ownerKind, c.req.param('ownerId')));
+    }
+    catch (error) {
+        return jsonError(c, errorMessage(error, 'Failed to discard pending changes.'), 500);
+    }
+});
+safeActions.post('/api/safe/:ownerKind/:ownerId/undo-last-apply', async (c) => {
+    const ownerKind = parseSafeOwnerKind(c.req.param('ownerKind'));
+    if (!ownerKind) {
+        return jsonError(c, 'Invalid owner kind.');
+    }
+    try {
+        return c.json(await undoLastSafeOwnerSummaryApply(requestWorkingDir(c), ownerKind, c.req.param('ownerId')));
+    }
+    catch (error) {
+        return jsonError(c, errorMessage(error, 'Failed to undo the last apply.'), 500);
+    }
+});
+export default safeActions;

package/dist/server/routes/safe-summary.js

@@ -0,0 +1,20 @@
+import { Hono } from 'hono';
+import { parseSafeOwnerKind, readSafeOwnerSummary, } from '../services/safe-service.js';
+import { jsonError, requestWorkingDir } from './route-errors.js';
+const safeSummary = new Hono();
+function errorMessage(error) {
+    return error instanceof Error && error.message ? error.message : 'Failed to load safe mode summary.';
+}
+safeSummary.get('/api/safe/:ownerKind/:ownerId', async (c) => {
+    const ownerKind = parseSafeOwnerKind(c.req.param('ownerKind'));
+    if (!ownerKind) {
+        return jsonError(c, 'Invalid owner kind.');
+    }
+    try {
+        return c.json(await readSafeOwnerSummary(requestWorkingDir(c), ownerKind, c.req.param('ownerId')));
+    }
+    catch (error) {
+        return jsonError(c, errorMessage(error), 500);
+    }
+});
+export default safeSummary;

package/dist/server/routes/safe.js

@@ -0,0 +1,7 @@
+import { Hono } from 'hono';
+import safeSummary from './safe-summary.js';
+import safeActions from './safe-actions.js';
+const safe = new Hono();
+safe.route('/', safeSummary);
+safe.route('/', safeActions);
+export default safe;

package/dist/server/routes/workspaces.js

@@ -0,0 +1,47 @@
+// Workspace CRUD Routes — with path validation
+import { Hono } from 'hono';
+import { deleteSavedWorkspace, getSavedWorkspace, listSavedWorkspaces, saveWorkspaceSnapshot, setSavedWorkspaceHidden, } from '../services/workspace-service.js';
+import { jsonServiceFailure } from './route-errors.js';
+const workspaces = new Hono();
+function registerWorkspaceRoutes(basePath) {
+    workspaces.get(basePath, async (c) => {
+        try {
+            return c.json(await listSavedWorkspaces(c.req.query('includeHidden') === '1'));
+        }
+        catch {
+            return c.json([]);
+        }
+    });
+    workspaces.get(`${basePath}/:id`, async (c) => {
+        const result = await getSavedWorkspace(c.req.param('id'));
+        if (!result.ok) {
+            return jsonServiceFailure(c, result);
+        }
+        return c.json(result.workspace);
+    });
+    workspaces.put(basePath, async (c) => {
+        const body = await c.req.json();
+        const result = await saveWorkspaceSnapshot(body);
+        if (!result.ok) {
+            return jsonServiceFailure(c, result);
+        }
+        return c.json(result);
+    });
+    workspaces.patch(`${basePath}/:id`, async (c) => {
+        const body = await c.req.json().catch(() => ({}));
+        const result = await setSavedWorkspaceHidden(c.req.param('id'), body.hiddenFromList === true);
+        if (!result.ok) {
+            return jsonServiceFailure(c, result);
+        }
+        return c.json(result);
+    });
+    workspaces.delete(`${basePath}/:id`, async (c) => {
+        const result = await deleteSavedWorkspace(c.req.param('id'));
+        if (!result.ok) {
+            return jsonServiceFailure(c, result);
+        }
+        return c.json(result);
+    });
+}
+registerWorkspaceRoutes('/api/workspaces');
+export default workspaces;

package/dist/server/services/act-runtime/act-context-builder.js

@@ -0,0 +1,81 @@
+/**
+ * act-context-builder.ts — Collaboration context injection
+ *
+ * PRD §9: Stable collaboration context is injected at the agent/system level.
+ * Includes: goal, participants, collaboration tools, relations, subscriptions, and rules.
+ */
+function participantDisplayName(actDefinition, participantKey) {
+    return actDefinition.participants[participantKey]?.displayName || participantKey;
+}
+/**
+ * Build markdown Act context for a participant's agent prompt.
+ */
+export function buildActContext(actDefinition, participantKey) {
+    const lines = [];
+    const selfName = participantDisplayName(actDefinition, participantKey);
+    // ── Header ──────────────────────────────────────
+    lines.push('# Collaboration Context');
+    if (actDefinition.description) {
+        lines.push(`- Goal: ${actDefinition.description}`);
+    }
+    lines.push(`- Team: ${actDefinition.name}`);
+    lines.push(`- Your role: ${selfName}`);
+    // ── Participants ─────────────────────────────────
+    lines.push('- Team members:');
+    for (const key of Object.keys(actDefinition.participants)) {
+        const isSelf = key === participantKey;
+        lines.push(`  - ${participantDisplayName(actDefinition, key)}${isSelf ? ' (you)' : ''}`);
+    }
+    lines.push('');
+    // ── Collaboration Runtime ────────────────────────
+    lines.push('# Coordination Tools');
+    lines.push('- Use `message_teammate` for direct coordination with one teammate.');
+    lines.push('- Use `update_shared_board` to publish durable notes, findings, tasks, and handoffs for the whole team.');
+    lines.push('- Use `read_shared_board` to review current shared context before acting.');
+    lines.push('- Use `wait_until` when you need to pause until future messages or shared updates arrive.');
+    lines.push('');
+    // ── Available Relations ─────────────────────────
+    const myRelations = actDefinition.relations.filter((rel) => rel.between.includes(participantKey));
+    if (myRelations.length > 0) {
+        lines.push('# Team Connections');
+        for (const rel of myRelations) {
+            const partner = rel.between[0] === participantKey ? rel.between[1] : rel.between[0];
+            const partnerName = participantDisplayName(actDefinition, partner);
+            const dirLabel = rel.direction === 'one-way'
+                ? (rel.between[0] === participantKey ? '→' : '←')
+                : '↔';
+            lines.push(`- ${selfName} ${dirLabel} ${partnerName}: ${rel.name}${rel.description ? ` — ${rel.description}` : ''}`);
+        }
+        lines.push('');
+    }
+    // ── Subscriptions ───────────────────────────────
+    const binding = actDefinition.participants[participantKey];
+    if (binding?.subscriptions) {
+        const subs = binding.subscriptions;
+        lines.push('# Notifications You Receive');
+        if (subs.messagesFrom?.length) {
+            lines.push(`- Direct messages from: ${subs.messagesFrom.map((key) => participantDisplayName(actDefinition, key)).join(', ')}`);
+        }
+        if (subs.messageTags?.length) {
+            lines.push(`- Message labels: ${subs.messageTags.join(', ')}`);
+        }
+        if (subs.callboardKeys?.length) {
+            lines.push(`- Shared note keys: ${subs.callboardKeys.join(', ')}`);
+        }
+        if (subs.eventTypes?.length) {
+            lines.push(`- System updates: ${subs.eventTypes.join(', ')}`);
+        }
+        lines.push('');
+    }
+    // activeDances section removed per PRD-005
+    // Performer uses all its dances by default
+    // ── Act Rules ───────────────────────────────────
+    if (actDefinition.actRules && actDefinition.actRules.length > 0) {
+        lines.push('# Working Rules');
+        for (const rule of actDefinition.actRules) {
+            lines.push(`- ${rule}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}