@xenosystem/agent-interface-host 0.1.3

package/dist/workspace/fileAssociations.js

@@ -0,0 +1,202 @@
+import { spawn } from 'node:child_process';
+import { existsSync, statSync } from 'node:fs';
+import { extname, join } from 'node:path';
+const DEFAULT_HANDLER_CACHE_TTL_MS = 60_000;
+const DEFAULT_HANDLER_PROBE_TIMEOUT_MS = 2_500;
+const DEFAULT_HANDLER_PROBE_OUTPUT_LIMIT = 16_384;
+const defaultHandlerCache = new Map();
+const WINDOWS_FILE_ASSOCIATION_SCRIPT = String.raw `
+$ErrorActionPreference = 'Stop'
+$Extension = $env:XENO_FILE_ASSOCIATION_EXTENSION
+if ($Extension -notmatch '^\.[a-zA-Z0-9][a-zA-Z0-9+_-]{0,31}$') {
+  throw 'Invalid file extension.'
+}
+$source = @'
+using System;
+using System.Runtime.InteropServices;
+using System.Text;
+
+public static class XenoDefaultFileAssociation {
+  [DllImport("Shlwapi.dll", CharSet = CharSet.Unicode, SetLastError = true)]
+  private static extern uint AssocQueryString(
+    uint flags,
+    uint query,
+    string association,
+    string extra,
+    StringBuilder output,
+    ref uint outputLength
+  );
+
+  public static string Query(string extension, uint query) {
+    uint outputLength = 0;
+    AssocQueryString(0, query, extension, null, null, ref outputLength);
+    if (outputLength == 0) return null;
+
+    var output = new StringBuilder((int)outputLength);
+    uint result = AssocQueryString(0, query, extension, null, output, ref outputLength);
+    return result == 0 ? output.ToString() : null;
+  }
+}
+'@
+
+Add-Type -TypeDefinition $source -ErrorAction Stop
+[pscustomobject]@{
+  name = [XenoDefaultFileAssociation]::Query($Extension, 4)
+  executablePath = [XenoDefaultFileAssociation]::Query($Extension, 2)
+} | ConvertTo-Json -Compress
+`;
+function isExistingFile(candidate) {
+    try {
+        return existsSync(candidate) && statSync(candidate).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function resolveWindowsPowerShell() {
+    const windowsRoot = process.env.SystemRoot || process.env.WINDIR;
+    if (!windowsRoot)
+        return null;
+    const candidate = join(windowsRoot, 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
+    return isExistingFile(candidate) ? candidate : null;
+}
+function normalizeHandlerName(value) {
+    if (typeof value !== 'string')
+        return null;
+    const normalized = value
+        .replace(/[\u0000-\u001f\u007f]/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+    if (!normalized || normalized.startsWith('@{'))
+        return null;
+    return normalized.slice(0, 80);
+}
+function normalizeExecutablePath(value) {
+    if (typeof value !== 'string')
+        return null;
+    const normalized = value
+        .replace(/[\u0000-\u001f\u007f]/g, '')
+        .trim();
+    return normalized ? normalized.slice(0, 2_048) : null;
+}
+function handlerNameFromExecutable(executablePath) {
+    if (!executablePath)
+        return null;
+    // Split on BOTH separators instead of `basename`, which is platform-dependent:
+    // this parses WINDOWS association output, but `path.basename` follows the
+    // HOST. On Linux `\` is a legal filename character, so
+    // basename('C:\\Apps\\Cursor.exe') returns the whole string and the display
+    // name came out as 'C:\Apps\Cursor'. Reading a Windows path is a pure string
+    // operation and must not change meaning with the machine doing the reading.
+    const lastSegment = executablePath.split(/[\\/]/u).pop() ?? executablePath;
+    const executableName = lastSegment.replace(/\.[^.]+$/u, '').trim();
+    if (!executableName)
+        return null;
+    const knownNames = {
+        antigravity: 'Antigravity',
+        code: 'Visual Studio Code',
+        cursor: 'Cursor',
+        explorer: 'File Explorer',
+        notepad: 'Notepad',
+        wordpad: 'WordPad',
+    };
+    return knownNames[executableName.toLowerCase()] || executableName;
+}
+function parseWindowsFileAssociationOutput(output) {
+    const lines = output
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean);
+    for (let index = lines.length - 1; index >= 0; index -= 1) {
+        try {
+            const parsed = JSON.parse(lines[index]);
+            const executablePath = normalizeExecutablePath(parsed.executablePath);
+            const name = normalizeHandlerName(parsed.name) || handlerNameFromExecutable(executablePath);
+            if (name)
+                return { name, executablePath };
+        }
+        catch {
+            // Ignore non-JSON diagnostics and keep looking for the final probe record.
+        }
+    }
+    return null;
+}
+function runWindowsFileAssociationProbe(powershellPath, extension) {
+    return new Promise((complete) => {
+        let settled = false;
+        let stdout = '';
+        let timeout = null;
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timeout)
+                clearTimeout(timeout);
+            complete(value);
+        };
+        let child;
+        try {
+            child = spawn(powershellPath, ['-NoLogo', '-NoProfile', '-NonInteractive', '-Command', WINDOWS_FILE_ASSOCIATION_SCRIPT], {
+                env: {
+                    ...process.env,
+                    XENO_FILE_ASSOCIATION_EXTENSION: extension,
+                },
+                windowsHide: true,
+                shell: false,
+                stdio: ['ignore', 'pipe', 'ignore'],
+            });
+        }
+        catch {
+            finish(null);
+            return;
+        }
+        timeout = setTimeout(() => {
+            child.kill();
+            finish(null);
+        }, DEFAULT_HANDLER_PROBE_TIMEOUT_MS);
+        const stdoutStream = child.stdout;
+        if (!stdoutStream) {
+            child.kill();
+            finish(null);
+            return;
+        }
+        stdoutStream.setEncoding('utf8');
+        stdoutStream.on('data', (chunk) => {
+            stdout += chunk;
+            if (stdout.length > DEFAULT_HANDLER_PROBE_OUTPUT_LIMIT) {
+                child.kill();
+                finish(null);
+            }
+        });
+        child.once('error', () => finish(null));
+        child.once('close', (exitCode) => {
+            finish(exitCode === 0 ? parseWindowsFileAssociationOutput(stdout) : null);
+        });
+    });
+}
+export async function detectDefaultFileHandler(filePath) {
+    const extension = extname(filePath).toLowerCase();
+    if (!/^\.[a-z0-9][a-z0-9+_-]{0,31}$/i.test(extension))
+        return null;
+    const cached = defaultHandlerCache.get(extension);
+    if (cached && cached.expiresAt > Date.now())
+        return cached.value;
+    let value = null;
+    if (process.platform === 'win32') {
+        const powershellPath = resolveWindowsPowerShell();
+        if (powershellPath)
+            value = await runWindowsFileAssociationProbe(powershellPath, extension);
+    }
+    defaultHandlerCache.set(extension, {
+        expiresAt: Date.now() + DEFAULT_HANDLER_CACHE_TTL_MS,
+        value,
+    });
+    return value;
+}
+export const __defaultFileHandlerTest = {
+    clearCache() {
+        defaultHandlerCache.clear();
+    },
+    parseWindowsFileAssociationOutput,
+};
+//# sourceMappingURL=fileAssociations.js.map

package/dist/workspace/fileAssociations.js.map

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

package/dist/workspace/scrollbackBuffer.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Bounded PTY scrollback.
+ *
+ * The original implementation was a one-liner:
+ *
+ *     const combined = `${current}${next}`
+ *     return combined.length > limit ? combined.slice(-limit) : combined
+ *
+ * which is correct and quietly catastrophic. Once a terminal has produced more
+ * than `limit` characters, EVERY subsequent chunk allocates a full-size string
+ * to concatenate and another to slice, then throws both away. A chatty build log
+ * emitting a few thousand chunks a second therefore costs on the order of a
+ * gigabyte a second of copying — per terminal — and the cost is paid on the host
+ * event loop, so it stalls every other run on the box.
+ *
+ * This was found by the §9b load harness on its first execution: two terminals
+ * were enough to wedge the host indefinitely.
+ *
+ * The fix keeps the chunks and trims from the front, so appending is O(chunk)
+ * rather than O(limit). It matters beyond performance: the §9b decision is
+ * whether the host must be rewritten in Rust, and a quadratic memcpy loop would
+ * have made TypeScript look inadequate at a cost that is algorithmic and
+ * present in any language.
+ *
+ * Semantics are deliberately unchanged: retain the last `limit` UTF-16 code
+ * units. (`MAX_PTY_SCROLLBACK_BYTES` is named for bytes but has always been
+ * applied to code units; preserving that is a separate decision from this fix.)
+ */
+export declare class ScrollbackBuffer {
+    private readonly limit;
+    private chunks;
+    private totalLength;
+    /** Cached join; invalidated on append. `null` means "recompute on next read". */
+    private joined;
+    constructor(limit: number);
+    append(chunk: string): void;
+    private trim;
+    /**
+     * The retained scrollback. Rare compared to append (it serves snapshots), so
+     * the join is done here rather than maintained eagerly. The chunk list is NOT
+     * collapsed afterwards — collapsing would recreate one large string for the
+     * next trim to slice, reintroducing the very cost this class removes.
+     */
+    read(): string;
+    clear(): void;
+    get length(): number;
+}
+//# sourceMappingURL=scrollbackBuffer.d.ts.map

package/dist/workspace/scrollbackBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollbackBuffer.d.ts","sourceRoot":"","sources":["../../src/workspace/scrollbackBuffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,gBAAgB;IAMf,OAAO,CAAC,QAAQ,CAAC,KAAK;IALlC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAI;IACvB,iFAAiF;IACjF,OAAO,CAAC,MAAM,CAAoB;gBAEL,KAAK,EAAE,MAAM;IAM1C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ3B,OAAO,CAAC,IAAI;IAyBZ;;;;;OAKG;IACH,IAAI,IAAI,MAAM;IAKd,KAAK,IAAI,IAAI;IAMb,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

package/dist/workspace/scrollbackBuffer.js

@@ -0,0 +1,94 @@
+/**
+ * Bounded PTY scrollback.
+ *
+ * The original implementation was a one-liner:
+ *
+ *     const combined = `${current}${next}`
+ *     return combined.length > limit ? combined.slice(-limit) : combined
+ *
+ * which is correct and quietly catastrophic. Once a terminal has produced more
+ * than `limit` characters, EVERY subsequent chunk allocates a full-size string
+ * to concatenate and another to slice, then throws both away. A chatty build log
+ * emitting a few thousand chunks a second therefore costs on the order of a
+ * gigabyte a second of copying — per terminal — and the cost is paid on the host
+ * event loop, so it stalls every other run on the box.
+ *
+ * This was found by the §9b load harness on its first execution: two terminals
+ * were enough to wedge the host indefinitely.
+ *
+ * The fix keeps the chunks and trims from the front, so appending is O(chunk)
+ * rather than O(limit). It matters beyond performance: the §9b decision is
+ * whether the host must be rewritten in Rust, and a quadratic memcpy loop would
+ * have made TypeScript look inadequate at a cost that is algorithmic and
+ * present in any language.
+ *
+ * Semantics are deliberately unchanged: retain the last `limit` UTF-16 code
+ * units. (`MAX_PTY_SCROLLBACK_BYTES` is named for bytes but has always been
+ * applied to code units; preserving that is a separate decision from this fix.)
+ */
+export class ScrollbackBuffer {
+    limit;
+    chunks = [];
+    totalLength = 0;
+    /** Cached join; invalidated on append. `null` means "recompute on next read". */
+    joined = '';
+    constructor(limit) {
+        this.limit = limit;
+        if (!Number.isInteger(limit) || limit <= 0) {
+            throw new Error('ScrollbackBuffer limit must be a positive integer');
+        }
+    }
+    append(chunk) {
+        if (!chunk)
+            return;
+        this.chunks.push(chunk);
+        this.totalLength += chunk.length;
+        this.joined = null;
+        this.trim();
+    }
+    trim() {
+        while (this.totalLength > this.limit) {
+            const first = this.chunks[0];
+            if (first === undefined) {
+                this.totalLength = 0;
+                return;
+            }
+            const excess = this.totalLength - this.limit;
+            if (first.length <= excess) {
+                this.chunks.shift();
+                this.totalLength -= first.length;
+                continue;
+            }
+            let keepFrom = excess;
+            // Never strand a lone low surrogate at the head of the buffer: the old
+            // `slice(-limit)` could split a surrogate pair and leave an unpaired unit,
+            // which renders as a replacement character in the terminal view.
+            const head = first.charCodeAt(keepFrom);
+            if (head >= 0xdc00 && head <= 0xdfff)
+                keepFrom += 1;
+            const remainder = first.slice(keepFrom);
+            this.totalLength -= first.length - remainder.length;
+            this.chunks[0] = remainder;
+        }
+    }
+    /**
+     * The retained scrollback. Rare compared to append (it serves snapshots), so
+     * the join is done here rather than maintained eagerly. The chunk list is NOT
+     * collapsed afterwards — collapsing would recreate one large string for the
+     * next trim to slice, reintroducing the very cost this class removes.
+     */
+    read() {
+        if (this.joined === null)
+            this.joined = this.chunks.join('');
+        return this.joined;
+    }
+    clear() {
+        this.chunks = [];
+        this.totalLength = 0;
+        this.joined = '';
+    }
+    get length() {
+        return this.totalLength;
+    }
+}
+//# sourceMappingURL=scrollbackBuffer.js.map

package/dist/workspace/scrollbackBuffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollbackBuffer.js","sourceRoot":"","sources":["../../src/workspace/scrollbackBuffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,gBAAgB;IAME;IALrB,MAAM,GAAa,EAAE,CAAA;IACrB,WAAW,GAAG,CAAC,CAAA;IACvB,iFAAiF;IACzE,MAAM,GAAkB,EAAE,CAAA;IAElC,YAA6B,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;QACxC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;QACtE,CAAC;IACH,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,IAAI,CAAC,KAAK;YAAE,OAAM;QAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACvB,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,MAAM,CAAA;QAChC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,CAAC,IAAI,EAAE,CAAA;IACb,CAAC;IAEO,IAAI;QACV,OAAO,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;YAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAA;gBACpB,OAAM;YACR,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAA;YAC5C,IAAI,KAAK,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;gBACnB,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,MAAM,CAAA;gBAChC,SAAQ;YACV,CAAC;YACD,IAAI,QAAQ,GAAG,MAAM,CAAA;YACrB,uEAAuE;YACvE,2EAA2E;YAC3E,iEAAiE;YACjE,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;YACvC,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM;gBAAE,QAAQ,IAAI,CAAC,CAAA;YACnD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YACvC,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAA;YACnD,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;QAC5B,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,IAAI;QACF,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC5D,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;QAChB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAA;QACpB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;IAClB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,WAAW,CAAA;IACzB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@xenosystem/agent-interface-host",
+  "version": "0.1.3",
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/XENO-CORPORATION/xeno-agent-interface.git",
+    "directory": "packages/host"
+  },
+  "dependencies": {
+    "@xenosystem/acp-core": "0.1.1",
+    "@xenosystem/acp-provider-manager": "0.1.1",
+    "@xenosystem/agent-sdk": "^0.9.0",
+    "better-sqlite3": "12.10.0",
+    "extract-zip": "^2.0.1",
+    "node-pty": "^1.1.0",
+    "tar": "^7.5.20",
+    "@xenosystem/agent-interface-client": "0.1.3",
+    "@xenosystem/agent-interface-core": "0.1.3",
+    "@xenosystem/agent-interface-contract": "0.1.3"
+  },
+  "scripts": {}
+}