discord-agent-bridge 0.1.0

package/dist/discord/directoryBrowser.test.js

@@ -0,0 +1,163 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { DirectoryBrowser } from './directoryBrowser.js';
+let root;
+beforeEach(() => {
+    // root/
+    //   sub/
+    //     nested/
+    //   file.txt
+    root = fs.mkdtempSync(path.join(os.tmpdir(), 'dab-dir-'));
+    fs.mkdirSync(path.join(root, 'sub', 'nested'), { recursive: true });
+    fs.writeFileSync(path.join(root, 'file.txt'), 'x');
+});
+afterEach(() => {
+    fs.rmSync(root, { recursive: true, force: true });
+});
+describe('DirectoryBrowser', () => {
+    it('lists only subdirectories, sorted, hiding files and dotfiles', () => {
+        fs.mkdirSync(path.join(root, '.hidden'));
+        fs.mkdirSync(path.join(root, 'aaa'));
+        const b = new DirectoryBrowser({ allowedRoots: [root], startPath: root });
+        expect(b.listChildren()).toEqual(['aaa', 'sub']);
+    });
+    it('descends into a child and back up', () => {
+        const b = new DirectoryBrowser({ allowedRoots: [root], startPath: root });
+        expect(b.into('sub')).toBe(true);
+        expect(b.cwd()).toBe(path.join(root, 'sub'));
+        expect(b.into('nested')).toBe(true);
+        expect(b.cwd()).toBe(path.join(root, 'sub', 'nested'));
+        expect(b.up()).toBe(true);
+        expect(b.cwd()).toBe(path.join(root, 'sub'));
+    });
+    it('select() returns the current absolute path', () => {
+        const b = new DirectoryBrowser({ allowedRoots: [root], startPath: root });
+        b.into('sub');
+        expect(b.select()).toBe(path.join(root, 'sub'));
+    });
+    it('cannot ascend above an allowed root', () => {
+        const b = new DirectoryBrowser({ allowedRoots: [root], startPath: root });
+        expect(b.up()).toBe(false); // already at the root boundary
+        expect(b.cwd()).toBe(root);
+    });
+    it('cannot descend outside an allowed root via traversal', () => {
+        const b = new DirectoryBrowser({ allowedRoots: [path.join(root, 'sub')], startPath: path.join(root, 'sub') });
+        // Attempt to escape up-and-out with a relative component.
+        expect(b.into('..')).toBe(false);
+        expect(b.cwd()).toBe(path.join(root, 'sub'));
+    });
+    it('into a nonexistent or non-directory target is a no-op', () => {
+        const b = new DirectoryBrowser({ allowedRoots: [root], startPath: root });
+        expect(b.into('does-not-exist')).toBe(false);
+        expect(b.into('file.txt')).toBe(false);
+        expect(b.cwd()).toBe(root);
+    });
+    it('clamps a start path outside the roots back to the first root', () => {
+        const b = new DirectoryBrowser({ allowedRoots: [path.join(root, 'sub')], startPath: os.tmpdir() });
+        expect(b.cwd()).toBe(path.join(root, 'sub'));
+    });
+});
+describe('DirectoryBrowser unbounded (Fix 1: reach the filesystem root and other volumes)', () => {
+    it('with NO allowedRoots, can navigate all the way UP to the filesystem root "/"', () => {
+        const b = new DirectoryBrowser({ startPath: root });
+        // Walk up repeatedly; each up() succeeds until we hit '/'.
+        let guard = 0;
+        while (b.up() && guard < 100)
+            guard++;
+        expect(b.cwd()).toBe(path.parse(root).root); // '/' on POSIX
+        // At the filesystem root, up() is a no-op (dirname('/') === '/').
+        expect(b.up()).toBe(false);
+    });
+    it('⬆ up is ENABLED at every path except "/" in the render', () => {
+        // Deep-ish start: up is enabled here.
+        const deep = new DirectoryBrowser({ startPath: path.join(root, 'sub', 'nested') });
+        const upBtn = (rows) => rows.flatMap((r) => r.components).find((c) => c.type === 'button' && c.customId === 'dir:up');
+        expect(upBtn(deep.render().rows)?.disabled).toBe(false);
+        // At the filesystem root, up is disabled.
+        const atRoot = new DirectoryBrowser({ startPath: path.parse(root).root });
+        expect(upBtn(atRoot.render().rows)?.disabled).toBe(true);
+    });
+    it('from "/" can enter a top-level directory (the path to other volumes, e.g. /Volumes)', () => {
+        const fsRoot = path.parse(root).root; // '/'
+        const b = new DirectoryBrowser({ startPath: fsRoot });
+        expect(b.cwd()).toBe(fsRoot);
+        // "/" lists its top-level entries (on macOS this includes 'Volumes', the mount root
+        // for other drives). Entering any of them descends off the root — the exact behavior
+        // the user needs to reach a project on another volume.
+        const children = b.listChildren();
+        expect(children.length).toBeGreaterThan(0);
+        const first = children[0];
+        expect(b.into(first)).toBe(true);
+        expect(b.cwd()).toBe(path.join(fsRoot, first));
+    });
+    it('bounded mode still cannot ascend past an allowed root (confinement unchanged)', () => {
+        const b = new DirectoryBrowser({ allowedRoots: [root], startPath: root });
+        expect(b.up()).toBe(false);
+        expect(b.cwd()).toBe(root);
+    });
+});
+describe('DirectoryBrowser render (A4D-style folder picker)', () => {
+    function selectOf(rows) {
+        return rows.flatMap((r) => r.components).find((c) => c.type === 'select' && c.customId === 'dir:into');
+    }
+    function buttonOf(rows, id) {
+        return rows.flatMap((r) => r.components).find((c) => c.type === 'button' && c.customId === id);
+    }
+    it('shows the CURRENT path + guidance, a subfolder select, and ⬆ up / ✅ start buttons', () => {
+        const b = new DirectoryBrowser({ allowedRoots: [root], startPath: root });
+        const { embed, rows } = b.render();
+        // The embed carries the how-to guidance and the current absolute path.
+        expect(embed.description).toContain('프로젝트 폴더');
+        expect(embed.description).toContain(root);
+        // Subfolder select lists the child directory as a navigation option.
+        const select = selectOf(rows);
+        expect(select?.customId).toBe('dir:into');
+        expect(select?.options?.map((o) => o.value)).toContain('sub');
+        // Up button is DISABLED at a root boundary; the start button is present.
+        expect(buttonOf(rows, 'dir:up')?.disabled).toBe(true);
+        const start = buttonOf(rows, 'dir:here');
+        expect(start).toBeDefined();
+        if (start && 'label' in start)
+            expect(start.label).toContain('시작');
+    });
+    it('after navigating INTO a subfolder, the render reflects the new path and enables ⬆ up', () => {
+        const b = new DirectoryBrowser({ allowedRoots: [root], startPath: root });
+        expect(b.into('sub')).toBe(true);
+        const { embed, rows } = b.render();
+        expect(embed.description).toContain(path.join(root, 'sub'));
+        // Now inside a subfolder, going up is allowed.
+        expect(buttonOf(rows, 'dir:up')?.disabled).toBe(false);
+        // 'nested' is offered as the next descent.
+        expect(selectOf(rows)?.options?.map((o) => o.value)).toContain('nested');
+    });
+    it('navigating UP returns to the parent path in the render', () => {
+        const b = new DirectoryBrowser({ allowedRoots: [root], startPath: root });
+        b.into('sub');
+        expect(b.up()).toBe(true);
+        expect(b.render().embed.description).toContain(root);
+    });
+    it('an empty folder renders a disabled-style placeholder option, not a crash', () => {
+        const empty = path.join(root, 'sub', 'nested');
+        const b = new DirectoryBrowser({ allowedRoots: [root], startPath: empty });
+        const select = selectOf(b.render().rows);
+        // The single sentinel option (never a real folder) keeps the select non-empty.
+        expect(select?.options).toHaveLength(1);
+        expect(select?.options?.[0].value).toBe('__none__');
+    });
+    it('mirrors A4D folder-step buttons: Parent · Start · Resume · 📁 Create · Cancel in ONE row (≤5 rows)', () => {
+        const b = new DirectoryBrowser({ allowedRoots: [root], startPath: root });
+        const { rows } = b.render();
+        // Two rows total (subfolder select + the five-button row) — well under Discord's 5.
+        expect(rows.length).toBeLessThanOrEqual(5);
+        expect(rows).toHaveLength(2);
+        // The subfolder select stays in its own row.
+        expect(rows[0].components.every((c) => c.type === 'select')).toBe(true);
+        // The button row carries exactly the five A4D-style buttons, in order.
+        const buttonRow = rows[1].components;
+        expect(buttonRow.every((c) => c.type === 'button')).toBe(true);
+        expect(buttonRow.map((c) => c.customId)).toEqual(['dir:up', 'dir:here', 'dir:resume', 'dir:create', 'cancel']);
+    });
+});
+//# sourceMappingURL=directoryBrowser.test.js.map

package/dist/discord/directoryBrowser.test.js.map

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

package/dist/discord/favorites.js

@@ -0,0 +1,10 @@
+// TODO(Phase 1): project favorites/bookmarks (saved cwd paths) (§4, §8).
+export class Favorites {
+    list(_guildId) {
+        throw new Error('not implemented');
+    }
+    add(_guildId, _path) {
+        throw new Error('not implemented');
+    }
+}
+//# sourceMappingURL=favorites.js.map

package/dist/discord/favorites.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"favorites.js","sourceRoot":"","sources":["../../src/discord/favorites.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,OAAO,SAAS;IACpB,IAAI,CAAC,QAAgB;QACnB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,QAAgB,EAAE,KAAa;QACjC,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/discord/fileDownload.js

@@ -0,0 +1,94 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// Read-only file browse/download, realpath-confined to the session workspace
+// (§4, §7.5, fixes A5). Every browsed/downloaded path is realpath-resolved and
+// must stay inside the workspace root — a symlink pointing outside the root is
+// caught, not just a literal `..`. Reuses the confinement approach from
+// mcpFileTool/sessionOrchestrator (realpath the deepest existing ancestor).
+//
+// This is a "read" component: it lists entries and resolves a download path, but
+// never mutates the filesystem. The actual Discord attachment is built by 7b from
+// the OutgoingFile this returns. Pure FS logic — unit-testable with temp dirs.
+export class WorkspaceEscapeError extends Error {
+    requestedPath;
+    constructor(requestedPath) {
+        super(`Path escapes the workspace: ${requestedPath}`);
+        this.requestedPath = requestedPath;
+        this.name = 'WorkspaceEscapeError';
+    }
+}
+export class FileDownload {
+    root;
+    constructor(workspaceRoot) {
+        this.root = realpathOrResolve(workspaceRoot);
+    }
+    // List the entries of a directory inside the workspace. `relativeDir` is resolved
+    // against the workspace root; anything escaping the root throws WorkspaceEscapeError.
+    browse(relativeDir = '.') {
+        const target = this.resolveConfined(relativeDir);
+        const entries = fs.readdirSync(target, { withFileTypes: true });
+        return entries
+            .filter((e) => !e.name.startsWith('.'))
+            .map((e) => ({ name: e.name, isDirectory: e.isDirectory() }))
+            .sort((a, b) => {
+            if (a.isDirectory !== b.isDirectory)
+                return a.isDirectory ? -1 : 1;
+            return a.name.localeCompare(b.name);
+        });
+    }
+    // Resolve a download target inside the workspace, returning an OutgoingFile that
+    // 7b turns into a discord.js attachment. Throws WorkspaceEscapeError when the path
+    // escapes the workspace, or a plain Error when the target is missing / not a file.
+    download(relativePath) {
+        const target = this.resolveConfined(relativePath);
+        let stat;
+        try {
+            stat = fs.statSync(target);
+        }
+        catch {
+            throw new Error(`File not found: ${relativePath}`);
+        }
+        if (!stat.isFile()) {
+            throw new Error(`Not a file: ${relativePath}`);
+        }
+        return { path: target, name: path.basename(target) };
+    }
+    // Resolve `requested` against the workspace root, realpath-confining it. Throws
+    // WorkspaceEscapeError if the resolved path is outside the root.
+    resolveConfined(requested) {
+        const resolved = realpathOrResolve(path.resolve(this.root, requested));
+        if (!isWithin(this.root, resolved)) {
+            throw new WorkspaceEscapeError(requested);
+        }
+        return resolved;
+    }
+}
+// Realpath a path, falling back to the realpath of its deepest existing ancestor
+// joined with the non-existent tail — so confinement holds for paths that do not
+// exist yet while still resolving symlinks in the part that does. (Same approach as
+// core/sessionOrchestrator realpathOrResolve; duplicated locally to keep the
+// discord layer free of a core import for a tiny helper.)
+function realpathOrResolve(target) {
+    const abs = path.resolve(target);
+    let existing = abs;
+    const tail = [];
+    while (!fs.existsSync(existing)) {
+        const parent = path.dirname(existing);
+        if (parent === existing)
+            break;
+        tail.unshift(path.basename(existing));
+        existing = parent;
+    }
+    try {
+        const realExisting = fs.realpathSync(existing);
+        return tail.length > 0 ? path.join(realExisting, ...tail) : realExisting;
+    }
+    catch {
+        return abs;
+    }
+}
+function isWithin(root, child) {
+    const rel = path.relative(root, child);
+    return rel === '' || (!rel.startsWith('..') && !path.isAbsolute(rel));
+}
+//# sourceMappingURL=fileDownload.js.map

package/dist/discord/fileDownload.js.map

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

package/dist/discord/fileDownload.test.js

@@ -0,0 +1,59 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { FileDownload, WorkspaceEscapeError } from './fileDownload.js';
+let root;
+let outside;
+beforeEach(() => {
+    root = fs.mkdtempSync(path.join(os.tmpdir(), 'dab-ws-'));
+    outside = fs.mkdtempSync(path.join(os.tmpdir(), 'dab-out-'));
+    fs.mkdirSync(path.join(root, 'src'));
+    fs.writeFileSync(path.join(root, 'src', 'a.ts'), 'export const a = 1;');
+    fs.writeFileSync(path.join(outside, 'secret.txt'), 'nope');
+});
+afterEach(() => {
+    fs.rmSync(root, { recursive: true, force: true });
+    fs.rmSync(outside, { recursive: true, force: true });
+});
+describe('FileDownload', () => {
+    it('downloads an in-workspace file', () => {
+        const dl = new FileDownload(root);
+        const file = dl.download('src/a.ts');
+        expect(file.path).toBe(fs.realpathSync(path.join(root, 'src', 'a.ts')));
+        expect(file.name).toBe('a.ts');
+    });
+    it('browses an in-workspace directory (dirs first, dotfiles hidden)', () => {
+        fs.mkdirSync(path.join(root, '.git'));
+        const dl = new FileDownload(root);
+        const entries = dl.browse('.');
+        expect(entries.map((e) => e.name)).toEqual(['src']);
+        expect(entries[0].isDirectory).toBe(true);
+    });
+    it('rejects a path escaping the workspace via ..', () => {
+        const dl = new FileDownload(root);
+        const rel = path.join('..', path.basename(outside), 'secret.txt');
+        expect(() => dl.download(rel)).toThrow(WorkspaceEscapeError);
+    });
+    it('rejects an absolute path outside the workspace', () => {
+        const dl = new FileDownload(root);
+        expect(() => dl.download(path.join(outside, 'secret.txt'))).toThrow(WorkspaceEscapeError);
+    });
+    it('rejects a symlink that points outside the workspace', () => {
+        const link = path.join(root, 'escape');
+        try {
+            fs.symlinkSync(outside, link);
+        }
+        catch {
+            return; // symlinks unsupported on this platform — skip
+        }
+        const dl = new FileDownload(root);
+        expect(() => dl.download(path.join('escape', 'secret.txt'))).toThrow(WorkspaceEscapeError);
+    });
+    it('throws a plain error for a missing file or a directory target', () => {
+        const dl = new FileDownload(root);
+        expect(() => dl.download('src/missing.ts')).toThrow(/not found/i);
+        expect(() => dl.download('src')).toThrow(/not a file/i);
+    });
+});
+//# sourceMappingURL=fileDownload.test.js.map

package/dist/discord/fileDownload.test.js.map

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

package/dist/discord/format.js

@@ -0,0 +1,104 @@
+// Small formatting helpers shared by the renderers. Pure functions — no discord.js,
+// no I/O — so they are trivially unit-testable. Discord's hard limits (2000 chars
+// per message, 4096 per embed description) are respected here in one place.
+// Discord hard limits.
+export const MSG_LIMIT = 2000; // plain message content
+export const EMBED_DESC_LIMIT = 4096; // embed description
+export const THREAD_NAME_LIMIT = 100; // thread name
+// Embed colors (ported from A4D COLORS; adapted names).
+export const COLORS = {
+    streaming: 0xfee75c, // yellow
+    thinking: 0x9b59b6, // purple
+    permission: 0xe67e22, // orange
+    idle: 0x57f287, // green
+    error: 0xed4245, // red
+    stopped: 0xed4245, // red
+};
+// Split text into Discord-message-sized chunks, preferring to break on newlines so
+// code fences and paragraphs are not cut mid-line where avoidable. Never returns an
+// empty array for a non-empty input; an empty input yields [].
+export function chunkMessage(text, limit = MSG_LIMIT) {
+    if (text.length === 0)
+        return [];
+    if (text.length <= limit)
+        return [text];
+    const chunks = [];
+    let rest = text;
+    while (rest.length > limit) {
+        // Prefer the last newline within the limit; fall back to a hard cut.
+        const window = rest.slice(0, limit);
+        const nl = window.lastIndexOf('\n');
+        const cut = nl > 0 ? nl : limit;
+        chunks.push(rest.slice(0, cut));
+        rest = rest.slice(cut).replace(/^\n/, '');
+    }
+    if (rest.length > 0)
+        chunks.push(rest);
+    return chunks;
+}
+// Truncate a string to `max`, appending an ellipsis when it was cut. Used for embed
+// descriptions (live stream preview) and thread names.
+export function truncate(text, max) {
+    if (text.length <= max)
+        return text;
+    if (max <= 1)
+        return text.slice(0, max);
+    return text.slice(0, max - 1) + '…';
+}
+// A tool-call thread name from the tool + its input (§6). Ports A4D's per-tool
+// summary heuristics; capped to Discord's 100-char thread-name limit.
+export function toolThreadName(toolName, input) {
+    const summary = toolSummary(toolName, input);
+    const name = summary ? `${toolName}: ${summary}` : toolName;
+    return truncate(name, THREAD_NAME_LIMIT);
+}
+// A short, human summary of a tool's input for the thread name. Falls back to a
+// clipped JSON stringify for unknown tools. Never throws on odd input.
+export function toolSummary(toolName, input) {
+    const obj = isRecord(input) ? input : {};
+    const str = (v) => (typeof v === 'string' ? v : undefined);
+    switch (toolName) {
+        case 'Edit':
+        case 'Write':
+        case 'Read':
+        case 'NotebookEdit':
+            return str(obj.file_path) ?? str(obj.path) ?? '';
+        case 'Bash':
+            return (str(obj.command) ?? '').slice(0, 60);
+        case 'Glob':
+        case 'Grep':
+            return str(obj.pattern) ?? '';
+        case 'Agent':
+        case 'Task':
+            return str(obj.description) ?? (str(obj.prompt) ?? '').slice(0, 40);
+        case 'WebSearch':
+        case 'WebFetch':
+            return str(obj.query) ?? str(obj.url) ?? '';
+        default: {
+            try {
+                return JSON.stringify(input).slice(0, 60);
+            }
+            catch {
+                return '';
+            }
+        }
+    }
+}
+// Compact token count (1234 → "1.2K", 2_000_000 → "2.0M").
+export function formatTokens(count) {
+    if (count >= 1_000_000)
+        return `${(count / 1_000_000).toFixed(1)}M`;
+    if (count >= 1_000)
+        return `${(count / 1_000).toFixed(1)}K`;
+    return String(count);
+}
+// Human duration: >=60s → "1.5m", else "12.3s".
+export function formatDuration(ms) {
+    if (ms >= 60_000)
+        return `${(ms / 60_000).toFixed(1)}m`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+function isRecord(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+//# sourceMappingURL=format.js.map

package/dist/discord/format.js.map

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

package/dist/discord/format.test.js

@@ -0,0 +1,40 @@
+import { describe, it, expect } from 'vitest';
+import { chunkMessage, truncate, toolThreadName, formatTokens, formatDuration, MSG_LIMIT, THREAD_NAME_LIMIT, } from './format.js';
+describe('format helpers', () => {
+    it('chunkMessage keeps short text whole and splits long text under the limit', () => {
+        expect(chunkMessage('short')).toEqual(['short']);
+        expect(chunkMessage('')).toEqual([]);
+        const long = 'a'.repeat(MSG_LIMIT * 2 + 10);
+        const chunks = chunkMessage(long);
+        expect(chunks.length).toBeGreaterThan(1);
+        expect(chunks.every((c) => c.length <= MSG_LIMIT)).toBe(true);
+        expect(chunks.join('')).toBe(long);
+    });
+    it('chunkMessage prefers to break on a newline', () => {
+        // First line fills nearly the whole limit; total exceeds it so a split is forced,
+        // and the break lands on the newline (not mid-line).
+        const line = 'x'.repeat(MSG_LIMIT - 5);
+        const text = `${line}\n${'y'.repeat(50)}`;
+        const chunks = chunkMessage(text);
+        expect(chunks[0]).toBe(line);
+        expect(chunks[1]).toBe('y'.repeat(50));
+    });
+    it('truncate appends an ellipsis only when cut', () => {
+        expect(truncate('abc', 5)).toBe('abc');
+        expect(truncate('abcdef', 4)).toBe('abc…');
+    });
+    it('toolThreadName summarizes per-tool input and caps to the thread-name limit', () => {
+        expect(toolThreadName('Edit', { file_path: '/ws/a.ts' })).toBe('Edit: /ws/a.ts');
+        expect(toolThreadName('Bash', { command: 'ls -la' })).toBe('Bash: ls -la');
+        const longPath = '/' + 'p'.repeat(200);
+        expect(toolThreadName('Read', { file_path: longPath }).length).toBeLessThanOrEqual(THREAD_NAME_LIMIT);
+    });
+    it('formatTokens / formatDuration are compact', () => {
+        expect(formatTokens(512)).toBe('512');
+        expect(formatTokens(1500)).toBe('1.5K');
+        expect(formatTokens(2_000_000)).toBe('2.0M');
+        expect(formatDuration(3000)).toBe('3.0s');
+        expect(formatDuration(90_000)).toBe('1.5m');
+    });
+});
+//# sourceMappingURL=format.test.js.map

package/dist/discord/format.test.js.map

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

package/dist/discord/guildChannels.js

@@ -0,0 +1,97 @@
+// Names for the created structure. Kept here (not in i18n) since they are Discord
+// channel/category names, not localized bot messages — Discord lowercases/sanitizes
+// text channel names itself, but we pass already-clean values.
+const CONTROL_CATEGORY_NAME = '🤖 Agent';
+const CONTROL_CHANNEL_NAME = 'agent-start';
+const SESSIONS_CATEGORY_NAME = 'Agent - Sessions';
+// Idempotently create (or reuse) the guild's channel structure and persist the ids
+// into servers/<guildId>.json. Re-running with an existing, still-valid structure
+// reuses every channel (matched by stored id) instead of duplicating — the ids only
+// change when a channel was deleted out from under us. Returns the resolved structure
+// so the caller can post a summary / link the control channel.
+export async function ensureGuildChannels(provisioner, configStore) {
+    const guildId = provisioner.guildId;
+    const server = configStore.loadServerConfig(guildId);
+    const existing = server?.channels;
+    // Reuse each stored id ONLY when the channel still exists; otherwise re-create it.
+    const controlCategory = await provisioner.ensureCategory(CONTROL_CATEGORY_NAME, existing && provisioner.channelExists(existing.categoryId) ? existing.categoryId : undefined);
+    const controlChannel = await provisioner.ensureTextChannel(CONTROL_CHANNEL_NAME, controlCategory.id, existing && provisioner.channelExists(existing.controlChannelId) ? existing.controlChannelId : undefined);
+    const sessionsCategory = await provisioner.ensureCategory(SESSIONS_CATEGORY_NAME, existing && provisioner.channelExists(existing.sessionsCategoryId) ? existing.sessionsCategoryId : undefined);
+    const channels = {
+        categoryId: controlCategory.id,
+        controlChannelId: controlChannel.id,
+        sessionsCategoryId: sessionsCategory.id,
+        statusChannelId: existing?.statusChannelId ?? null,
+    };
+    persistChannels(configStore, guildId, server, channels);
+    return channels;
+}
+// Auto-provision a guild's channel structure without a manual /init. Called on
+// ClientReady (for every existing guild) and on GuildCreate (a fresh invite), so the
+// 🤖 Agent category + #agent-start control channel + Agent - Sessions category appear
+// automatically. GUARDED and NON-THROWING by design: skips with a clear warning when
+// the bot lacks Manage Channels, and swallows any create failure (a missing permission
+// surfaces as a create error on some paths) so one bad guild never crashes the ready
+// handler. Idempotent — reuses existing channels by stored id via ensureGuildChannels.
+// Returns the resolved structure, or null when it could not provision.
+export async function autoProvisionGuild(provisioner, configStore, logger) {
+    if (!provisioner.canManageChannels()) {
+        logger.warn('auto-provision skipped: missing Manage Channels permission', {
+            guildId: provisioner.guildId,
+        });
+        return null;
+    }
+    try {
+        const channels = await ensureGuildChannels(provisioner, configStore);
+        logger.info('auto-provisioned guild channels', {
+            guildId: provisioner.guildId,
+            controlChannelId: channels.controlChannelId,
+        });
+        return channels;
+    }
+    catch (err) {
+        logger.warn('auto-provision failed', {
+            guildId: provisioner.guildId,
+            err: err instanceof Error ? err.message : String(err),
+        });
+        return null;
+    }
+}
+// Create a dedicated session channel for a picked project folder, under the guild's
+// sessions category (from /init) when available. The name is derived from the folder
+// basename, sanitized to Discord's channel-name rules and prefixed `proj-`. Returns
+// the new channel; the caller binds the session to its id.
+export async function createSessionChannel(provisioner, folderPath, sessionsCategoryId) {
+    const name = sessionChannelName(folderPath);
+    return provisioner.createTextChannel(name, sessionsCategoryId);
+}
+// Derive a Discord-safe session channel name from a folder path: `proj-<basename>`,
+// lowercased, non-alphanumerics collapsed to '-', trimmed, and capped at Discord's
+// 100-char channel-name limit. An empty/blank basename falls back to `proj-session`.
+export function sessionChannelName(folderPath) {
+    const base = folderPath.replace(/[/\\]+$/, '').split(/[/\\]/).pop() ?? '';
+    const slug = base
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    const name = slug.length > 0 ? `proj-${slug}` : 'proj-session';
+    return name.slice(0, 100);
+}
+// Merge the resolved channel ids into servers/<guildId>.json without disturbing the
+// server's other fields (auth / defaults / locale). A server file may not exist yet
+// (first /init before any /config); create a minimal one carrying just the channels.
+function persistChannels(configStore, guildId, existing, channels) {
+    const next = {
+        version: existing?.version ?? 1,
+        guildId,
+        ...(existing?.auth ? { auth: existing.auth } : {}),
+        ...(existing?.defaults ? { defaults: existing.defaults } : {}),
+        ...(existing?.limits ? { limits: existing.limits } : {}),
+        ...(existing?.locale ? { locale: existing.locale } : {}),
+        ...(existing?.auditChannelId !== undefined ? { auditChannelId: existing.auditChannelId } : {}),
+        ...(existing?.favorites ? { favorites: existing.favorites } : {}),
+        channels,
+    };
+    configStore.saveServerConfig(next);
+}
+//# sourceMappingURL=guildChannels.js.map

package/dist/discord/guildChannels.js.map

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