awb-agent-manager 1.0.0

package/dist/lib/fs-browser.js

@@ -0,0 +1,287 @@
+import { promises as fsp, realpathSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { resolve as pathResolve, sep as PATH_SEP } from 'node:path';
+import { log } from './logging.js';
+const DEFAULT_LIST_LIMIT = 5000;
+const DEFAULT_READ_CAP = 5 * 1024 * 1024;
+const BINARY_SNIFF_BYTES = 512;
+export class FsBrowser {
+    rawRoots;
+    roots = [];
+    hasExplicitRoots;
+    constructor(_config, fsSection) {
+        this.rawRoots = Array.isArray(fsSection?.roots)
+            ? fsSection.roots.filter((r) => typeof r === 'string' && !!r)
+            : [];
+        this.hasExplicitRoots = this.rawRoots.length > 0;
+        this.resolveRootsSync();
+    }
+    resolveRootsSync() {
+        for (const root of this.rawRoots) {
+            try {
+                const abs = pathResolve(root);
+                const real = realpathSync(abs);
+                this.roots.push(real);
+            }
+            catch (err) {
+                log(`[fs-browser] scope root unreachable, dropped: ${root} (${err?.code || err?.message})`);
+            }
+        }
+        if (this.hasExplicitRoots && this.roots.length === 0) {
+            log('[fs-browser] explicit roots configured but none resolved — falling back to unrestricted browsing');
+        }
+        else if (this.roots.length > 0) {
+            log(`[fs-browser] enabled with ${this.roots.length} configured root(s): ${this.roots.join(', ')}`);
+        }
+        else {
+            log('[fs-browser] enabled (unrestricted — no fs_browser.roots configured; UI starts at $HOME)');
+        }
+    }
+    async listDrives() {
+        if (process.platform !== 'win32') {
+            return [{ name: '/', path: '/' }];
+        }
+        const probes = [];
+        for (let code = 65; code <= 90; code++) {
+            const letter = String.fromCharCode(code);
+            const root = `${letter}:\\`;
+            probes.push(fsp.access(root).then(() => ({ name: `${letter}:`, path: root }), () => null));
+        }
+        const results = await Promise.all(probes);
+        return results.filter((r) => r !== null);
+    }
+    defaultStartingPoints() {
+        const out = new Set();
+        try {
+            const home = realpathSync(pathResolve(homedir()));
+            if (home)
+                out.add(home);
+        }
+        catch { }
+        try {
+            const cwd = realpathSync(process.cwd());
+            if (cwd)
+                out.add(cwd);
+        }
+        catch { }
+        return Array.from(out);
+    }
+    async handle(req) {
+        if (!req || typeof req !== 'object') {
+            return { ok: false, error: 'Malformed request', code: 'PATH_INVALID' };
+        }
+        const op = req.op;
+        if (op === 'roots') {
+            const advertisedRoots = this.roots.length > 0 ? this.roots.slice() : this.defaultStartingPoints();
+            return {
+                ok: true,
+                data: {
+                    cwd: process.cwd(),
+                    roots: advertisedRoots,
+                    enabled: true,
+                    platform: process.platform,
+                },
+            };
+        }
+        if (op === 'drives') {
+            return { ok: true, data: { drives: await this.listDrives() } };
+        }
+        const rawPath = req.path;
+        if (typeof rawPath !== 'string' || !rawPath) {
+            return { ok: false, error: 'path is required', code: 'PATH_INVALID' };
+        }
+        if (!rawPath.startsWith(PATH_SEP) && !/^[A-Za-z]:[\\/]/.test(rawPath)) {
+            return { ok: false, error: 'path must be absolute', code: 'PATH_INVALID' };
+        }
+        let realPath;
+        try {
+            realPath = await fsp.realpath(pathResolve(rawPath));
+        }
+        catch (err) {
+            return { ok: false, error: err?.message ?? String(err), code: err?.code || 'ENOENT' };
+        }
+        if (this.roots.length > 0 && !this.inScope(realPath)) {
+            return { ok: false, error: `Path outside configured roots: ${rawPath}`, code: 'SCOPE_DENIED' };
+        }
+        try {
+            switch (op) {
+                case 'list':
+                    return { ok: true, data: await this.list(realPath) };
+                case 'stat':
+                    return { ok: true, data: await this.stat(realPath) };
+                case 'read':
+                    return {
+                        ok: true,
+                        data: await this.read(realPath, req.offset ?? 0, req.limit ?? DEFAULT_READ_CAP),
+                    };
+                case 'mkdir':
+                    return { ok: true, data: await this.mkdir(realPath, req.name) };
+                default:
+                    return { ok: false, error: `Unknown op: ${op}`, code: 'PATH_INVALID' };
+            }
+        }
+        catch (err) {
+            return { ok: false, error: err?.message ?? String(err), code: err?.code || 'FS_ERROR' };
+        }
+    }
+    inScope(realPath) {
+        for (const root of this.roots) {
+            if (realPath === root)
+                return true;
+            if (realPath.startsWith(root + PATH_SEP))
+                return true;
+        }
+        return false;
+    }
+    async list(realPath) {
+        const stat = await fsp.stat(realPath);
+        if (!stat.isDirectory()) {
+            const err = new Error(`Not a directory: ${realPath}`);
+            err.code = 'ENOTDIR';
+            throw err;
+        }
+        const entries = await fsp.readdir(realPath, { withFileTypes: true });
+        const limit = DEFAULT_LIST_LIMIT;
+        const truncated = entries.length > limit;
+        const slice = truncated ? entries.slice(0, limit) : entries;
+        const out = await Promise.all(slice.map(async (dirent) => {
+            const full = `${realPath}${PATH_SEP}${dirent.name}`;
+            let type = 'other';
+            let size = 0;
+            let mtime = '';
+            let mode = 0;
+            let isSymlink = false;
+            try {
+                const lst = await fsp.lstat(full);
+                mode = lst.mode;
+                size = Number(lst.size) || 0;
+                mtime = lst.mtime.toISOString();
+                if (lst.isSymbolicLink()) {
+                    isSymlink = true;
+                    try {
+                        const tgt = await fsp.stat(full);
+                        if (tgt.isDirectory())
+                            type = 'directory';
+                        else if (tgt.isFile())
+                            type = 'file';
+                        else
+                            type = 'symlink';
+                    }
+                    catch {
+                        type = 'symlink';
+                    }
+                }
+                else if (lst.isDirectory())
+                    type = 'directory';
+                else if (lst.isFile())
+                    type = 'file';
+            }
+            catch {
+            }
+            return { name: dirent.name, type, size, mtime, mode, is_symlink: isSymlink };
+        }));
+        return { path: realPath, entries: out, truncated };
+    }
+    async mkdir(parentRealPath, name) {
+        if (typeof name !== 'string') {
+            const err = new Error('name is required');
+            err.code = 'PATH_INVALID';
+            throw err;
+        }
+        const trimmed = name.trim();
+        if (!trimmed || trimmed === '.' || trimmed === '..') {
+            const err = new Error('name must be a non-empty single path segment');
+            err.code = 'PATH_INVALID';
+            throw err;
+        }
+        if (trimmed.includes('/') || trimmed.includes('\\') || trimmed.includes('\0')) {
+            const err = new Error('name must not contain path separators');
+            err.code = 'PATH_INVALID';
+            throw err;
+        }
+        const parentStat = await fsp.stat(parentRealPath);
+        if (!parentStat.isDirectory()) {
+            const err = new Error(`Parent is not a directory: ${parentRealPath}`);
+            err.code = 'ENOTDIR';
+            throw err;
+        }
+        const target = `${parentRealPath}${PATH_SEP}${trimmed}`;
+        await fsp.mkdir(target);
+        const st = await fsp.stat(target);
+        return {
+            path: target,
+            type: 'directory',
+            size: Number(st.size) || 0,
+            mtime: st.mtime.toISOString(),
+            mode: st.mode,
+        };
+    }
+    async stat(realPath) {
+        const st = await fsp.lstat(realPath);
+        let type = 'other';
+        let realTarget;
+        if (st.isSymbolicLink()) {
+            type = 'symlink';
+            try {
+                realTarget = await fsp.realpath(realPath);
+            }
+            catch {
+            }
+        }
+        else if (st.isDirectory())
+            type = 'directory';
+        else if (st.isFile())
+            type = 'file';
+        return {
+            path: realPath,
+            real_path: realTarget,
+            type,
+            size: Number(st.size) || 0,
+            mtime: st.mtime.toISOString(),
+            mode: st.mode,
+        };
+    }
+    async read(realPath, offset, limit) {
+        const st = await fsp.stat(realPath);
+        if (!st.isFile()) {
+            const err = new Error(`Not a file: ${realPath}`);
+            err.code = 'EISDIR';
+            throw err;
+        }
+        const off = Math.max(0, Math.floor(Number(offset) || 0));
+        const cap = Math.min(Math.max(1, Math.floor(Number(limit) || DEFAULT_READ_CAP)), DEFAULT_READ_CAP);
+        const remaining = Math.max(0, Number(st.size) - off);
+        const readBytes = Math.min(remaining, cap);
+        const truncated = readBytes < remaining;
+        const fh = await fsp.open(realPath, 'r');
+        try {
+            const buf = Buffer.alloc(readBytes);
+            if (readBytes > 0) {
+                await fh.read(buf, 0, readBytes, off);
+            }
+            const binary = this.looksBinary(buf);
+            return {
+                path: realPath,
+                content: binary ? buf.toString('base64') : buf.toString('utf8'),
+                encoding: binary ? 'base64' : 'utf8',
+                size: Number(st.size) || 0,
+                read_bytes: readBytes,
+                offset: off,
+                truncated,
+                mtime: st.mtime.toISOString(),
+            };
+        }
+        finally {
+            await fh.close();
+        }
+    }
+    looksBinary(buf) {
+        const scan = Math.min(buf.length, BINARY_SNIFF_BYTES);
+        for (let i = 0; i < scan; i++) {
+            if (buf[i] === 0)
+                return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=fs-browser.js.map

package/dist/lib/fs-browser.js.map

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

package/dist/lib/host-mcp/logs.d.ts

@@ -0,0 +1,19 @@
+export interface FindUnityLogsArgs {
+    project_path?: string;
+}
+export interface UnityLogPaths {
+    ok: true;
+    editor_log: string | null;
+    editor_prev_log: string | null;
+    editor_crash_dir: string | null;
+    player_log: string | null;
+    player_prev_log: string | null;
+    hub_log: string | null;
+    searched: string[];
+    project: {
+        company_name: string | null;
+        product_name: string | null;
+    } | null;
+    platform: string;
+}
+export declare function findUnityLogs(args: FindUnityLogsArgs): Promise<UnityLogPaths>;

package/dist/lib/host-mcp/logs.js

@@ -0,0 +1,102 @@
+import { promises as fsp, existsSync } from 'node:fs';
+import { homedir, platform } from 'node:os';
+import { join, basename } from 'node:path';
+export async function findUnityLogs(args) {
+    const home = homedir();
+    const plat = platform();
+    const searched = [];
+    let editorLog = null;
+    let editorPrev = null;
+    let crashDir = null;
+    let hubLog = null;
+    if (plat === 'win32') {
+        const local = process.env.LOCALAPPDATA || join(home, 'AppData', 'Local');
+        editorLog = pickExisting([join(local, 'Unity', 'Editor', 'Editor.log')], searched);
+        editorPrev = pickExisting([join(local, 'Unity', 'Editor', 'Editor-prev.log')], searched);
+        crashDir = pickExisting([join(local, 'Unity', 'Editor', 'Crashes')], searched);
+        hubLog = pickExisting([join(home, 'AppData', 'Roaming', 'UnityHub', 'logs', 'info-log.json')], searched);
+    }
+    else if (plat === 'darwin') {
+        editorLog = pickExisting([join(home, 'Library', 'Logs', 'Unity', 'Editor.log')], searched);
+        editorPrev = pickExisting([join(home, 'Library', 'Logs', 'Unity', 'Editor-prev.log')], searched);
+        crashDir = pickExisting([
+            join(home, 'Library', 'Logs', 'Unity', 'Editor', 'Crashes'),
+            join(home, 'Library', 'Logs', 'DiagnosticReports'),
+        ], searched);
+        hubLog = pickExisting([join(home, 'Library', 'Application Support', 'UnityHub', 'logs', 'info-log.json')], searched);
+    }
+    else {
+        editorLog = pickExisting([join(home, '.config', 'unity3d', 'Editor.log')], searched);
+        editorPrev = pickExisting([join(home, '.config', 'unity3d', 'Editor-prev.log')], searched);
+        crashDir = pickExisting([join(home, '.config', 'unity3d', 'Editor', 'Crashes')], searched);
+        hubLog = pickExisting([join(home, '.config', 'UnityHub', 'logs', 'info-log.json')], searched);
+    }
+    let projectInfo = null;
+    let playerLog = null;
+    let playerPrev = null;
+    if (args.project_path) {
+        projectInfo = await readProjectIdentifiers(args.project_path);
+        if (projectInfo.company_name && projectInfo.product_name) {
+            const c = projectInfo.company_name;
+            const p = projectInfo.product_name;
+            if (plat === 'win32') {
+                const local = process.env.LOCALAPPDATA || join(home, 'AppData', 'Local');
+                playerLog = pickExisting([
+                    join(local, c, p, 'Player.log'),
+                    join(local, 'Low', c, p, 'Player.log'),
+                ], searched);
+                playerPrev = pickExisting([
+                    join(local, c, p, 'Player-prev.log'),
+                    join(local, 'Low', c, p, 'Player-prev.log'),
+                ], searched);
+            }
+            else if (plat === 'darwin') {
+                playerLog = pickExisting([join(home, 'Library', 'Logs', c, p, 'Player.log')], searched);
+                playerPrev = pickExisting([join(home, 'Library', 'Logs', c, p, 'Player-prev.log')], searched);
+            }
+            else {
+                playerLog = pickExisting([join(home, '.config', 'unity3d', c, p, 'Player.log')], searched);
+                playerPrev = pickExisting([join(home, '.config', 'unity3d', c, p, 'Player-prev.log')], searched);
+            }
+        }
+    }
+    return {
+        ok: true,
+        editor_log: editorLog,
+        editor_prev_log: editorPrev,
+        editor_crash_dir: crashDir,
+        player_log: playerLog,
+        player_prev_log: playerPrev,
+        hub_log: hubLog,
+        searched,
+        project: projectInfo,
+        platform: plat,
+    };
+}
+function pickExisting(candidates, searched) {
+    for (const c of candidates) {
+        searched.push(c);
+        if (existsSync(c))
+            return c;
+    }
+    return null;
+}
+async function readProjectIdentifiers(projectPath) {
+    const file = join(projectPath, 'ProjectSettings', 'ProjectSettings.asset');
+    if (!existsSync(file)) {
+        return { company_name: null, product_name: basename(projectPath) || null };
+    }
+    try {
+        const txt = await fsp.readFile(file, 'utf8');
+        const company = /^\s*companyName:\s*(.+)$/m.exec(txt)?.[1]?.trim() ?? null;
+        const product = /^\s*productName:\s*(.+)$/m.exec(txt)?.[1]?.trim() ?? null;
+        return {
+            company_name: company || null,
+            product_name: product || basename(projectPath) || null,
+        };
+    }
+    catch {
+        return { company_name: null, product_name: basename(projectPath) || null };
+    }
+}
+//# sourceMappingURL=logs.js.map

package/dist/lib/host-mcp/logs.js.map

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

package/dist/lib/host-mcp/platform.d.ts

@@ -0,0 +1,24 @@
+export type HostPlatform = 'win32' | 'darwin' | 'linux';
+export declare function hostPlatform(): HostPlatform;
+export declare function isWayland(): boolean;
+export interface RunResult {
+    code: number;
+    signal: NodeJS.Signals | null;
+    stdout: string;
+    stderr: string;
+    spawnFailed: boolean;
+    spawnError: string;
+}
+export interface RunOptions {
+    stdin?: string | Buffer | null;
+    timeoutMs?: number;
+    cwd?: string;
+    binaryStdout?: boolean;
+    inheritEnv?: boolean;
+    env?: Record<string, string>;
+}
+export declare function runCommand(cmd: string, args: string[], opts?: RunOptions): Promise<RunResult>;
+export declare function runPowerShell(script: string, opts?: RunOptions): Promise<RunResult>;
+export declare function runOsascript(script: string, opts?: RunOptions): Promise<RunResult>;
+export declare function makeTempDir(prefix: string): string;
+export declare function findBinary(candidates: string[]): Promise<string | null>;

package/dist/lib/host-mcp/platform.js

@@ -0,0 +1,133 @@
+import { spawn } from 'node:child_process';
+import { mkdtempSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { platform } from 'node:process';
+export function hostPlatform() {
+    if (platform === 'win32')
+        return 'win32';
+    if (platform === 'darwin')
+        return 'darwin';
+    return 'linux';
+}
+export function isWayland() {
+    if (hostPlatform() !== 'linux')
+        return false;
+    return !!(process.env.WAYLAND_DISPLAY || process.env.XDG_SESSION_TYPE === 'wayland');
+}
+export function runCommand(cmd, args, opts = {}) {
+    return new Promise((resolve) => {
+        const timeoutMs = opts.timeoutMs ?? 15_000;
+        let stdoutChunks = [];
+        let stderrChunks = [];
+        let killTimer = null;
+        let child;
+        try {
+            child = spawn(cmd, args, {
+                cwd: opts.cwd,
+                env: opts.inheritEnv === false ? opts.env : { ...process.env, ...(opts.env || {}) },
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+        }
+        catch (err) {
+            resolve({
+                code: -1,
+                signal: null,
+                stdout: '',
+                stderr: '',
+                spawnFailed: true,
+                spawnError: err?.message || String(err),
+            });
+            return;
+        }
+        child.stdout?.on('data', (chunk) => stdoutChunks.push(chunk));
+        child.stderr?.on('data', (chunk) => stderrChunks.push(chunk));
+        child.on('error', (err) => {
+            if (killTimer)
+                clearTimeout(killTimer);
+            resolve({
+                code: -1,
+                signal: null,
+                stdout: '',
+                stderr: '',
+                spawnFailed: true,
+                spawnError: err?.message || String(err),
+            });
+        });
+        child.on('close', (code, signal) => {
+            if (killTimer)
+                clearTimeout(killTimer);
+            const stdoutBuf = Buffer.concat(stdoutChunks);
+            const stderrBuf = Buffer.concat(stderrChunks);
+            resolve({
+                code: typeof code === 'number' ? code : -1,
+                signal: signal ?? null,
+                stdout: opts.binaryStdout ? stdoutBuf.toString('base64') : stdoutBuf.toString('utf8'),
+                stderr: stderrBuf.toString('utf8'),
+                spawnFailed: false,
+                spawnError: '',
+            });
+        });
+        if (opts.stdin != null) {
+            try {
+                child.stdin?.end(opts.stdin);
+            }
+            catch {
+            }
+        }
+        else {
+            try {
+                child.stdin?.end();
+            }
+            catch { }
+        }
+        if (timeoutMs > 0) {
+            killTimer = setTimeout(() => {
+                try {
+                    child.kill('SIGTERM');
+                }
+                catch { }
+                setTimeout(() => {
+                    try {
+                        child.kill('SIGKILL');
+                    }
+                    catch { }
+                }, 1000).unref();
+            }, timeoutMs);
+            killTimer.unref();
+        }
+    });
+}
+export async function runPowerShell(script, opts = {}) {
+    const candidates = hostPlatform() === 'win32'
+        ? ['pwsh', 'powershell']
+        : ['pwsh'];
+    let last = null;
+    for (const bin of candidates) {
+        const result = await runCommand(bin, ['-NoLogo', '-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-Command', '-'], { ...opts, stdin: script });
+        if (!result.spawnFailed)
+            return result;
+        last = result;
+    }
+    return last ?? {
+        code: -1, signal: null, stdout: '', stderr: '',
+        spawnFailed: true, spawnError: 'no powershell binary found',
+    };
+}
+export async function runOsascript(script, opts = {}) {
+    return runCommand('osascript', ['-e', script], opts);
+}
+export function makeTempDir(prefix) {
+    return mkdtempSync(join(tmpdir(), `awb-host-mcp-${prefix}-`));
+}
+export async function findBinary(candidates) {
+    const probeCmd = hostPlatform() === 'win32' ? 'where' : 'which';
+    for (const bin of candidates) {
+        const result = await runCommand(probeCmd, [bin], { timeoutMs: 3000 });
+        if (!result.spawnFailed && result.code === 0 && result.stdout.trim()) {
+            return bin;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=platform.js.map

package/dist/lib/host-mcp/platform.js.map

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

package/dist/lib/host-mcp/screens.d.ts

@@ -0,0 +1,22 @@
+export interface MonitorInfo {
+    index: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    primary: boolean;
+    scale: number | null;
+    name: string | null;
+}
+export interface ListScreensResult {
+    ok: true;
+    monitors: MonitorInfo[];
+    platform: string;
+    warning?: string;
+}
+export interface ListScreensError {
+    ok: false;
+    error: string;
+    hint?: string;
+}
+export declare function listScreens(): Promise<ListScreensResult | ListScreensError>;