@xrkseek/harness 0.3.11 → 0.4.0-rc.2

package/node_modules/@xrkseek/exec-ssh/dist/fs.js

@@ -0,0 +1,214 @@
+import { posix } from "node:path";
+import { applyLiteralEdit, detectLineEndings, EditAmbiguousError, EditMismatchError, EditWithoutOldError, matchGlob, normalizeLineEndings, DOCUMENT_EXTRACT_MAX_BYTES, isDocumentExtractPath, textFromReadBuffer, restoreLineEndings, } from "@xrkseek/exec-fs";
+import { normalizeRemoteAbs, resolveWithinRemoteRoot } from "./paths.js";
+import { shQuote } from "./quote.js";
+async function requireOk(session, command, label) {
+    const r = await session.exec(command);
+    if (r.exitCode !== 0) {
+        const detail = (r.stderr || r.stdout || `exit ${r.exitCode}`).trim();
+        throw new Error(`ssh ${label}: ${detail}`);
+    }
+    return { stdout: r.stdout, stderr: r.stderr };
+}
+/** Provider — remote POSIX disk bound to workspace root (Hermes shell file ops). */
+export function createFsSshProvider(options) {
+    const session = options.session;
+    const root = normalizeRemoteAbs(options.root ?? session.config.workspace);
+    const defaultMaxBytes = options.defaultMaxBytes ?? 512_000;
+    const intentHandlers = new Set();
+    const emit = (kind, userPath) => {
+        for (const h of intentHandlers)
+            h(kind, userPath);
+    };
+    const readUtf8 = async (userPath, maxBytes = defaultMaxBytes) => {
+        emit("fs/read-intent", userPath);
+        const abs = resolveWithinRemoteRoot(root, userPath);
+        const fetchCap = isDocumentExtractPath(userPath)
+            ? DOCUMENT_EXTRACT_MAX_BYTES
+            : maxBytes;
+        const { stdout } = await requireOk(session, `python3 -c ${shQuote([
+            "import sys,base64",
+            `p=${JSON.stringify(abs)}`,
+            `m=${fetchCap}`,
+            "d=open(p,'rb').read()",
+            "t=len(d)>m",
+            "d=d[:m]",
+            "sys.stdout.write(('1' if t else '0')+base64.b64encode(d).decode())",
+        ].join(";"))}`, "read");
+        const truncated = stdout[0] === "1";
+        const buf = Buffer.from(stdout.slice(1), "base64");
+        if (isDocumentExtractPath(userPath)) {
+            if (truncated) {
+                return {
+                    content: `Document too large to convert (limit is ${DOCUMENT_EXTRACT_MAX_BYTES} bytes)`,
+                    truncated: true,
+                };
+            }
+            return textFromReadBuffer(buf, userPath, maxBytes);
+        }
+        return {
+            content: buf.toString("utf8"),
+            ...(truncated ? { truncated: true } : {}),
+        };
+    };
+    const writeUtf8 = async (userPath, content) => {
+        emit("fs/write-intent", userPath);
+        const abs = resolveWithinRemoteRoot(root, userPath);
+        const b64 = Buffer.from(content, "utf8").toString("base64");
+        await requireOk(session, [
+            `mkdir -p ${shQuote(posix.dirname(abs))}`,
+            `printf '%s' ${shQuote(b64)} | base64 -d > ${shQuote(abs)}`,
+        ].join(" && "), "write");
+    };
+    return {
+        root,
+        resolvePath(userPath) {
+            return resolveWithinRemoteRoot(root, userPath);
+        },
+        read(userPath, maxBytes) {
+            return readUtf8(userPath, maxBytes);
+        },
+        async readBytes(userPath, maxBytes = defaultMaxBytes) {
+            emit("fs/read-intent", userPath);
+            const abs = resolveWithinRemoteRoot(root, userPath);
+            const r = await session.exec(`python3 -c ${shQuote([
+                "import sys,base64",
+                `p=${JSON.stringify(abs)}`,
+                `m=${maxBytes}`,
+                "d=open(p,'rb').read()",
+                "sys.exit(2) if len(d)>m else None",
+                "sys.stdout.buffer.write(base64.b64encode(d))",
+            ].join(";"))}`);
+            if (r.exitCode === 2) {
+                throw new Error(`file exceeds read byte limit`);
+            }
+            if (r.exitCode !== 0) {
+                throw new Error(`ssh readBytes: ${(r.stderr || r.stdout || `exit ${r.exitCode}`).trim()}`);
+            }
+            return new Uint8Array(Buffer.from(r.stdout.trim(), "base64"));
+        },
+        write(userPath, content) {
+            return writeUtf8(userPath, content);
+        },
+        async edit(userPath, oldContent, newContent, editOpts) {
+            if (oldContent === undefined || oldContent === null) {
+                throw new EditWithoutOldError("edit requires oldContent");
+            }
+            // Match local provider: edit emits write-intent only (no read-intent).
+            const abs = resolveWithinRemoteRoot(root, userPath);
+            const { stdout } = await requireOk(session, `python3 -c ${shQuote([
+                "import sys,base64",
+                `p=${JSON.stringify(abs)}`,
+                "sys.stdout.write(base64.b64encode(open(p,'rb').read()).decode())",
+            ].join(";"))}`, "edit-read");
+            const raw = Buffer.from(stdout.trim(), "base64").toString("utf8");
+            const endings = detectLineEndings(raw);
+            const currentLf = normalizeLineEndings(raw);
+            try {
+                const { content } = applyLiteralEdit(currentLf, String(oldContent), String(newContent ?? ""), editOpts?.replaceAll === true, userPath);
+                await writeUtf8(userPath, restoreLineEndings(content, endings));
+            }
+            catch (err) {
+                if (err instanceof EditAmbiguousError)
+                    throw err;
+                const message = err instanceof Error ? err.message : String(err);
+                if (message.includes("edit mismatch") || message.includes("not found")) {
+                    throw new EditMismatchError(message);
+                }
+                throw err;
+            }
+        },
+        async stat(userPath) {
+            const abs = resolveWithinRemoteRoot(root, userPath);
+            const { stdout } = await requireOk(session, `python3 -c ${shQuote([
+                "import os,stat,sys,json",
+                `p=${JSON.stringify(abs)}`,
+                "st=os.stat(p)",
+                "print(json.dumps({'size':st.st_size,'isFile':stat.S_ISREG(st.st_mode),'isDirectory':stat.S_ISDIR(st.st_mode)}))",
+            ].join(";"))}`, "stat");
+            return JSON.parse(stdout.trim());
+        },
+        async mkdir(userPath) {
+            emit("fs/write-intent", userPath);
+            const abs = resolveWithinRemoteRoot(root, userPath);
+            await requireOk(session, `mkdir -p ${shQuote(abs)}`, "mkdir");
+        },
+        async glob(pattern, globOpts) {
+            const maxResults = globOpts?.maxResults ?? 200;
+            const { stdout } = await requireOk(session, `python3 -c ${shQuote([
+                "import os,json",
+                `root=${JSON.stringify(root)}`,
+                "out=[]",
+                "for dp, dns, fns in os.walk(root):",
+                "  dns[:] = [d for d in dns if d not in ('.git','node_modules')]",
+                "  for fn in fns:",
+                "    abs=os.path.join(dp,fn)",
+                "    rel=os.path.relpath(abs, root).replace(os.sep,'/')",
+                "    out.append(rel)",
+                "print(json.dumps(out))",
+            ].join("\n"))}`, "glob");
+            const all = JSON.parse(stdout.trim());
+            const hits = [];
+            for (const rel of all) {
+                if (matchGlob(rel, pattern)) {
+                    hits.push(rel);
+                    if (hits.length >= maxResults)
+                        break;
+                }
+            }
+            return hits;
+        },
+        async grep(pattern, grepOpts) {
+            const maxResults = grepOpts?.maxResults ?? 100;
+            const scope = resolveWithinRemoteRoot(root, grepOpts?.path ?? ".");
+            const flags = grepOpts?.caseInsensitive ? "i" : "";
+            let re;
+            try {
+                re = new RegExp(pattern, flags);
+            }
+            catch {
+                throw new Error(`invalid grep pattern: ${pattern}`);
+            }
+            const { stdout } = await requireOk(session, `python3 -c ${shQuote([
+                "import os,json",
+                `root=${JSON.stringify(root)}`,
+                `scope=${JSON.stringify(scope)}`,
+                "rows=[]",
+                "def walk(base):",
+                "  if os.path.isfile(base):",
+                "    yield base; return",
+                "  for dp, dns, fns in os.walk(base):",
+                "    dns[:] = [d for d in dns if d not in ('.git','node_modules')]",
+                "    for fn in fns: yield os.path.join(dp,fn)",
+                "for abs in walk(scope):",
+                "  try:",
+                "    text=open(abs,'r',encoding='utf-8',errors='replace').read()",
+                "  except Exception: continue",
+                "  rel=os.path.relpath(abs, root).replace(os.sep,'/')",
+                "  for i,line in enumerate(text.splitlines(),1):",
+                "    rows.append({'path':rel,'line':i,'text':line})",
+                "print(json.dumps(rows))",
+            ].join("\n"))}`, "grep");
+            const rows = JSON.parse(stdout.trim());
+            const hits = [];
+            const fileGlob = grepOpts?.glob;
+            for (const row of rows) {
+                if (fileGlob && !matchGlob(row.path, fileGlob))
+                    continue;
+                if (!re.test(row.text))
+                    continue;
+                hits.push(row);
+                if (hits.length >= maxResults)
+                    break;
+            }
+            return hits;
+        },
+        onIntent(handler) {
+            intentHandlers.add(handler);
+            return () => {
+                intentHandlers.delete(handler);
+            };
+        },
+    };
+}
+//# sourceMappingURL=fs.js.map

package/node_modules/@xrkseek/exec-ssh/dist/fs.js.map

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

package/node_modules/@xrkseek/exec-ssh/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { resolveSshConfigFromEnv, type SshEnv, type SshTargetConfig, } from "./config.js";
+export { createSshCodeRuntime, } from "./code.js";
+export { createFsSshProvider, type FsSshOptions, } from "./fs.js";
+export { createSshDirectory, listSshDirectory, type SshDirectoryEntry, type SshDirectoryListing, } from "./directory.js";
+export { isRemotelyInside, normalizeRemoteAbs, resolveWithinRemoteRoot, } from "./paths.js";
+export { createSshExecutionWorld, type CreateSshExecutionWorldOptions, type SshExecutionWorld, } from "./providers.js";
+export { shJoin, shQuote } from "./quote.js";
+export { createSshSession, type CreateSshSessionOptions, type SshExecOptions, type SshSession, } from "./session.js";
+export { createSshSubprocess } from "./subprocess.js";
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@xrkseek/exec-ssh/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,KAAK,MAAM,EACX,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,mBAAmB,EACnB,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,uBAAuB,EACvB,KAAK,8BAA8B,EACnC,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,UAAU,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/node_modules/@xrkseek/exec-ssh/dist/index.js

@@ -0,0 +1,10 @@
+export { resolveSshConfigFromEnv, } from "./config.js";
+export { createSshCodeRuntime, } from "./code.js";
+export { createFsSshProvider, } from "./fs.js";
+export { createSshDirectory, listSshDirectory, } from "./directory.js";
+export { isRemotelyInside, normalizeRemoteAbs, resolveWithinRemoteRoot, } from "./paths.js";
+export { createSshExecutionWorld, } from "./providers.js";
+export { shJoin, shQuote } from "./quote.js";
+export { createSshSession, } from "./session.js";
+export { createSshSubprocess } from "./subprocess.js";
+//# sourceMappingURL=index.js.map

package/node_modules/@xrkseek/exec-ssh/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,GAGxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,mBAAmB,GAEpB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GAGjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,uBAAuB,GAGxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EACL,gBAAgB,GAIjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/node_modules/@xrkseek/exec-ssh/dist/paths.d.ts

@@ -0,0 +1,10 @@
+/** Normalize an absolute POSIX remote path (no host cwd). */
+export declare function normalizeRemoteAbs(abs: string): string;
+/** True when `candidate` is `root` or a descendant (POSIX lexical). */
+export declare function isRemotelyInside(root: string, candidate: string): boolean;
+/**
+ * Resolve a user path under a remote workspace root.
+ * Relative paths join the root; absolute paths must stay inside.
+ */
+export declare function resolveWithinRemoteRoot(root: string, userPath: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/node_modules/@xrkseek/exec-ssh/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAGA,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAQzE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,MAAM,CASR"}

package/node_modules/@xrkseek/exec-ssh/dist/paths.js

@@ -0,0 +1,34 @@
+import { posix } from "node:path";
+import { PathEscapeError } from "@xrkseek/exec-fs";
+/** Normalize an absolute POSIX remote path (no host cwd). */
+export function normalizeRemoteAbs(abs) {
+    const n = posix.normalize(abs);
+    if (!posix.isAbsolute(n)) {
+        throw new PathEscapeError(`remote path must be absolute: ${abs}`);
+    }
+    // Strip trailing slash except root.
+    return n === "/" ? "/" : n.replace(/\/+$/, "");
+}
+/** True when `candidate` is `root` or a descendant (POSIX lexical). */
+export function isRemotelyInside(root, candidate) {
+    const rootAbs = normalizeRemoteAbs(root);
+    const candAbs = normalizeRemoteAbs(candidate);
+    const rel = posix.relative(rootAbs, candAbs);
+    return (rel === "" ||
+        (rel !== ".." && !rel.startsWith("../") && !posix.isAbsolute(rel)));
+}
+/**
+ * Resolve a user path under a remote workspace root.
+ * Relative paths join the root; absolute paths must stay inside.
+ */
+export function resolveWithinRemoteRoot(root, userPath) {
+    const rootAbs = normalizeRemoteAbs(root);
+    const targetAbs = posix.isAbsolute(userPath)
+        ? normalizeRemoteAbs(userPath)
+        : normalizeRemoteAbs(posix.join(rootAbs, userPath));
+    if (!isRemotelyInside(rootAbs, targetAbs)) {
+        throw new PathEscapeError(`path escapes workspace root: ${userPath}`);
+    }
+    return targetAbs;
+}
+//# sourceMappingURL=paths.js.map

package/node_modules/@xrkseek/exec-ssh/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,6DAA6D;AAC7D,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,eAAe,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,oCAAoC;IACpC,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,SAAiB;IAC9D,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,OAAO,CACL,GAAG,KAAK,EAAE;QACV,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CACnE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAY,EACZ,QAAgB;IAEhB,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;QAC1C,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC;QAC9B,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtD,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,eAAe,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/node_modules/@xrkseek/exec-ssh/dist/providers.d.ts

@@ -0,0 +1,19 @@
+import type { CodeRuntime } from "@xrkseek/code-runtime";
+import type { FsService } from "@xrkseek/exec-fs";
+import type { SubprocessService } from "@xrkseek/exec-subprocess";
+import type { SshTargetConfig } from "./config.js";
+import { type CreateSshSessionOptions, type SshSession } from "./session.js";
+export interface SshExecutionWorld {
+    readonly session: SshSession;
+    readonly workspaceRoot: string;
+    readonly fs: FsService;
+    readonly subprocess: SubprocessService;
+    readonly codeRuntime: CodeRuntime;
+    dispose(): void;
+}
+export interface CreateSshExecutionWorldOptions extends Omit<CreateSshSessionOptions, "config"> {
+    readonly config: SshTargetConfig;
+}
+/** Build fs + subprocess + code providers for one SSH target. */
+export declare function createSshExecutionWorld(options: CreateSshExecutionWorldOptions): SshExecutionWorld;
+//# sourceMappingURL=providers.d.ts.map

package/node_modules/@xrkseek/exec-ssh/dist/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,EAAoB,KAAK,uBAAuB,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,8BACf,SAAQ,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CAClC;AAED,iEAAiE;AACjE,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,8BAA8B,GACtC,iBAAiB,CAenB"}

package/node_modules/@xrkseek/exec-ssh/dist/providers.js

@@ -0,0 +1,22 @@
+import { createSshCodeRuntime } from "./code.js";
+import { createFsSshProvider } from "./fs.js";
+import { createSshSession } from "./session.js";
+import { createSshSubprocess } from "./subprocess.js";
+/** Build fs + subprocess + code providers for one SSH target. */
+export function createSshExecutionWorld(options) {
+    const session = createSshSession(options);
+    const fs = createFsSshProvider({ session });
+    const subprocess = createSshSubprocess(session);
+    const codeRuntime = createSshCodeRuntime(session);
+    return {
+        session,
+        workspaceRoot: session.config.workspace,
+        fs,
+        subprocess,
+        codeRuntime,
+        dispose() {
+            session.dispose();
+        },
+    };
+}
+//# sourceMappingURL=providers.js.map

package/node_modules/@xrkseek/exec-ssh/dist/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAiD,MAAM,cAAc,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAgBtD,iEAAiE;AACjE,MAAM,UAAU,uBAAuB,CACrC,OAAuC;IAEvC,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,EAAE,GAAG,mBAAmB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAClD,OAAO;QACL,OAAO;QACP,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;QACvC,EAAE;QACF,UAAU;QACV,WAAW;QACX,OAAO;YACL,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/node_modules/@xrkseek/exec-ssh/dist/quote.d.ts

@@ -0,0 +1,5 @@
+/** Single-quote wrap for remote POSIX shell. */
+export declare function shQuote(value: string): string;
+/** Join argv into a remote shell command string. */
+export declare function shJoin(argv: readonly string[]): string;
+//# sourceMappingURL=quote.d.ts.map

package/node_modules/@xrkseek/exec-ssh/dist/quote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.d.ts","sourceRoot":"","sources":["../src/quote.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,oDAAoD;AACpD,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAGtD"}

package/node_modules/@xrkseek/exec-ssh/dist/quote.js

@@ -0,0 +1,11 @@
+/** Single-quote wrap for remote POSIX shell. */
+export function shQuote(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+/** Join argv into a remote shell command string. */
+export function shJoin(argv) {
+    if (argv.length === 0)
+        throw new Error("ssh remote argv must be non-empty");
+    return argv.map(shQuote).join(" ");
+}
+//# sourceMappingURL=quote.js.map

package/node_modules/@xrkseek/exec-ssh/dist/quote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.js","sourceRoot":"","sources":["../src/quote.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AAC7C,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,MAAM,CAAC,IAAuB;IAC5C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC5E,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC"}

package/node_modules/@xrkseek/exec-ssh/dist/session.d.ts

@@ -0,0 +1,31 @@
+import { type SubprocessHandle, type SubprocessResult, type SubprocessService } from "@xrkseek/exec-subprocess";
+import type { SshTargetConfig } from "./config.js";
+export interface SshExecOptions {
+    readonly cwd?: string;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+}
+export interface SshSession {
+    readonly config: SshTargetConfig;
+    readonly target: string;
+    /** Build `ssh … -- <remoteCommand>` argv (no local cwd). */
+    buildSshArgv(remoteCommand: string): readonly string[];
+    /** Run a remote shell command string (`bash -lc` body). */
+    exec(remoteCommand: string, opts?: SshExecOptions): Promise<SubprocessResult>;
+    /** Start ssh without awaiting (background jobs). */
+    start(remoteCommand: string, opts?: SshExecOptions): SubprocessHandle;
+    dispose(): void;
+}
+export interface CreateSshSessionOptions {
+    readonly config: SshTargetConfig;
+    /** Injectable local OpenSSH client (tests). */
+    readonly local?: SubprocessService;
+    readonly platform?: NodeJS.Platform;
+}
+/**
+ * One OpenSSH client session (Hermes-style ControlMaster on POSIX).
+ * File/process ops ride `ssh … -- bash -lc` — no remote helper install.
+ */
+export declare function createSshSession(options: CreateSshSessionOptions): SshSession;
+//# sourceMappingURL=session.d.ts.map

package/node_modules/@xrkseek/exec-ssh/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAOnD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACvD,2DAA2D;IAC3D,IAAI,CACF,aAAa,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC7B,oDAAoD;IACpD,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,gBAAgB,CAAC;IACtE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CACrC;AAwBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,uBAAuB,GAC/B,UAAU,CA+EZ"}

package/node_modules/@xrkseek/exec-ssh/dist/session.js

@@ -0,0 +1,89 @@
+import { createLocalSubprocess, } from "@xrkseek/exec-subprocess";
+import { shQuote } from "./quote.js";
+import { createHash } from "node:crypto";
+import { mkdirSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+function controlPathFor(target) {
+    const dir = path.join(tmpdir(), "xrk-ssh");
+    mkdirSync(dir, { recursive: true });
+    const id = createHash("sha256").update(target).digest("hex").slice(0, 16);
+    return path.join(dir, `${id}.sock`);
+}
+function resolveTarget(config) {
+    if (config.host.includes("@") || !config.user)
+        return config.host;
+    return `${config.user}@${config.host}`;
+}
+function toSpawnOpts(opts) {
+    return {
+        ...(opts?.signal ? { signal: opts.signal } : {}),
+        ...(opts?.timeoutMs !== undefined ? { timeoutMs: opts.timeoutMs } : {}),
+    };
+}
+/**
+ * One OpenSSH client session (Hermes-style ControlMaster on POSIX).
+ * File/process ops ride `ssh … -- bash -lc` — no remote helper install.
+ */
+export function createSshSession(options) {
+    const config = options.config;
+    const local = options.local ?? createLocalSubprocess();
+    const platform = options.platform ?? process.platform;
+    const target = resolveTarget(config);
+    const connectTimeoutSec = Math.max(1, Math.ceil((config.connectTimeoutMs ?? 15_000) / 1000));
+    const multiplex = platform !== "win32";
+    const controlPath = multiplex ? controlPathFor(target) : undefined;
+    const buildSshArgv = (remoteCommand) => {
+        const argv = ["ssh"];
+        if (multiplex && controlPath) {
+            argv.push("-o", `ControlPath=${controlPath}`, "-o", "ControlMaster=auto", "-o", "ControlPersist=300");
+        }
+        argv.push("-o", "BatchMode=yes", "-o", "StrictHostKeyChecking=accept-new", "-o", `ConnectTimeout=${connectTimeoutSec}`);
+        if (config.port !== undefined) {
+            argv.push("-p", String(config.port));
+        }
+        if (config.keyPath) {
+            argv.push("-i", config.keyPath);
+        }
+        argv.push(target, "--", remoteCommand);
+        return argv;
+    };
+    const wrapRemote = (remoteCommand, opts) => {
+        const cwd = opts?.cwd ?? config.workspace;
+        const envPrefix = opts?.env
+            ? Object.entries(opts.env)
+                .filter(([, v]) => v !== undefined)
+                .map(([k, v]) => `${shQuote(k)}=${shQuote(String(v))}`)
+                .join(" ")
+            : "";
+        return envPrefix
+            ? `cd ${shQuote(cwd)} && env ${envPrefix} bash -lc ${shQuote(remoteCommand)}`
+            : `cd ${shQuote(cwd)} && bash -lc ${shQuote(remoteCommand)}`;
+    };
+    return {
+        config,
+        target,
+        buildSshArgv,
+        exec(remoteCommand, opts) {
+            return local.spawn(buildSshArgv(wrapRemote(remoteCommand, opts)), toSpawnOpts(opts));
+        },
+        start(remoteCommand, opts) {
+            return local.start(buildSshArgv(wrapRemote(remoteCommand, opts)), toSpawnOpts(opts));
+        },
+        dispose() {
+            if (!multiplex || !controlPath)
+                return;
+            void local
+                .spawn([
+                "ssh",
+                "-o",
+                `ControlPath=${controlPath}`,
+                "-O",
+                "exit",
+                target,
+            ])
+                .catch(() => { });
+        },
+    };
+}
+//# sourceMappingURL=session.js.map

package/node_modules/@xrkseek/exec-ssh/dist/session.js.map

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

package/node_modules/@xrkseek/exec-ssh/dist/subprocess.d.ts

@@ -0,0 +1,8 @@
+import type { SubprocessService } from "@xrkseek/exec-subprocess";
+import type { SshSession } from "./session.js";
+/**
+ * SubprocessService whose argv runs on the remote host (Hermes terminal backend).
+ * Paths in argv/cwd are execution-world (remote) coordinates.
+ */
+export declare function createSshSubprocess(session: SshSession): SubprocessService;
+//# sourceMappingURL=subprocess.d.ts.map

package/node_modules/@xrkseek/exec-ssh/dist/subprocess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocess.d.ts","sourceRoot":"","sources":["../src/subprocess.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,UAAU,GAAG,iBAAiB,CAuB1E"}

package/node_modules/@xrkseek/exec-ssh/dist/subprocess.js

@@ -0,0 +1,30 @@
+import { shJoin } from "./quote.js";
+/**
+ * SubprocessService whose argv runs on the remote host (Hermes terminal backend).
+ * Paths in argv/cwd are execution-world (remote) coordinates.
+ */
+export function createSshSubprocess(session) {
+    return {
+        start(argv, opts) {
+            return session.start(shJoin(argv), {
+                cwd: opts?.cwd ?? session.config.workspace,
+                ...(opts?.env ? { env: opts.env } : {}),
+                ...(opts?.signal ? { signal: opts.signal } : {}),
+                ...(opts?.timeoutMs !== undefined
+                    ? { timeoutMs: opts.timeoutMs }
+                    : {}),
+            });
+        },
+        async spawn(argv, opts) {
+            return session.exec(shJoin(argv), {
+                cwd: opts?.cwd ?? session.config.workspace,
+                ...(opts?.env ? { env: opts.env } : {}),
+                ...(opts?.signal ? { signal: opts.signal } : {}),
+                ...(opts?.timeoutMs !== undefined
+                    ? { timeoutMs: opts.timeoutMs }
+                    : {}),
+            });
+        },
+    };
+}
+//# sourceMappingURL=subprocess.js.map

package/node_modules/@xrkseek/exec-ssh/dist/subprocess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocess.js","sourceRoot":"","sources":["../src/subprocess.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGpC;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAmB;IACrD,OAAO;QACL,KAAK,CAAC,IAAI,EAAE,IAAmB;YAC7B,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;gBACjC,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS;gBAC1C,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChD,GAAG,CAAC,IAAI,EAAE,SAAS,KAAK,SAAS;oBAC/B,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE;oBAC/B,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAmB;YACnC,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;gBAChC,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS;gBAC1C,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChD,GAAG,CAAC,IAAI,EAAE,SAAS,KAAK,SAAS;oBAC/B,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE;oBAC/B,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/node_modules/@xrkseek/exec-ssh/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@xrkseek/exec-ssh",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@xrkseek/code-runtime": "workspace:*",
+    "@xrkseek/exec-fs": "workspace:*",
+    "@xrkseek/exec-subprocess": "workspace:*"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xrkseek/XRK-harness.git",
+    "directory": "packages/exec/ssh"
+  },
+  "private": true
+}

package/node_modules/@xrkseek/exec-subprocess/README.md

@@ -4,7 +4,7 @@ Local `SubprocessService`:
 
 - `spawn(argv)` — await exit (stdout/stderr/code; AbortSignal + timeout)  
 - `start(argv)` → `SubprocessHandle` (`kill` · `result()`; **no** `pid`)
-- Windows: non-terminal children use `windowsHide`; stop uses `taskkill /T /F` (hidden helper)
+- Windows: non-terminal children use `windowsHide` (no console flash for bash/code helpers); stop uses `taskkill /T /F` (hidden helper)
 - Terminal processes keep `pid` on `@xrkseek/exec-pty` `SubprocessTerminalHandle`
 
 Consumer: `@xrkseek/exec-shell`. See `docs/seams.md` · `docs/shell-jobs.md`.