@qduc/term2 0.7.0 → 0.7.1

package/dist/utils/clipboard.js

@@ -1,4 +1,6 @@
 import { spawn } from 'child_process';
+import fs from 'fs';
+const OSC52_MAX_BYTES = 70 * 1024;
 export function getClipboardCommandCandidates(platform, env) {
     if (platform === 'darwin') {
         return [{ command: 'pbcopy', args: [] }];
@@ -71,10 +73,60 @@ function defaultRunClipboardCommand(command, args, input) {
         });
     });
 }
-export async function copyToClipboard(text, options = {}) {
-    const platform = options.platform ?? process.platform;
+function defaultGetTtyWriter() {
+    if (process.stdout.isTTY) {
+        return (data) => void process.stdout.write(data);
+    }
+    try {
+        const fd = fs.openSync('/dev/tty', 'w');
+        return (data) => {
+            try {
+                fs.writeSync(fd, data);
+            }
+            finally {
+                fs.closeSync(fd);
+            }
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function buildOsc52Sequence(text, env) {
+    const encoded = Buffer.from(text, 'utf8').toString('base64');
+    const inner = `\x1b]52;c;${encoded}\x07`;
+    if (env.TMUX) {
+        // tmux DCS passthrough: double each ESC in the inner sequence
+        const escaped = inner.replace(/\x1b/g, '\x1b\x1b');
+        return `\x1bPtmux;\x1b${escaped}\x1b\\`;
+    }
+    if (env.TERM?.startsWith('screen')) {
+        // screen DCS passthrough: chunk at 768 chars to stay within screen's buffer limit
+        const CHUNK_SIZE = 768;
+        let result = '';
+        for (let i = 0; i < inner.length; i += CHUNK_SIZE) {
+            result += `\x1bP${inner.slice(i, i + CHUNK_SIZE)}\x1b\\`;
+        }
+        return result;
+    }
+    return inner;
+}
+export async function copyViaOsc52(text, options = {}) {
     const env = options.env ?? process.env;
-    const runCommand = options.runCommand ?? defaultRunClipboardCommand;
+    const getTtyWriter = options.getTtyWriter ?? defaultGetTtyWriter;
+    if (Buffer.byteLength(text, 'utf8') > OSC52_MAX_BYTES) {
+        throw new Error(`Response too large to copy over SSH (${Buffer.byteLength(text, 'utf8')} bytes; limit is ${OSC52_MAX_BYTES} bytes)`);
+    }
+    const writer = getTtyWriter();
+    if (!writer) {
+        throw new Error('No TTY available for OSC 52 clipboard write');
+    }
+    writer(buildOsc52Sequence(text, env));
+}
+function isSSHSession(env) {
+    return !!(env.SSH_CONNECTION || env.SSH_TTY || env.SSH_CLIENT);
+}
+async function runNativeCopy(text, platform, env, runCommand) {
     const candidates = getClipboardCommandCandidates(platform, env);
     let lastError = '';
     for (const candidate of candidates) {
@@ -84,8 +136,35 @@ export async function copyToClipboard(text, options = {}) {
         }
         lastError = result.errorMessage ?? '';
     }
-    const supportedCommands = candidates.map((candidate) => candidate.command).join(', ');
+    const supportedCommands = candidates.map((c) => c.command).join(', ');
     const detail = lastError ? ` Last error: ${lastError}` : '';
     throw new Error(`Clipboard is unavailable on this system. Tried: ${supportedCommands}.${detail}`);
 }
+export async function copyToClipboard(text, options = {}) {
+    const platform = options.platform ?? process.platform;
+    const env = options.env ?? process.env;
+    const runCommand = options.runCommand ?? defaultRunClipboardCommand;
+    const getTtyWriter = options.getTtyWriter ?? defaultGetTtyWriter;
+    if (isSSHSession(env)) {
+        // Native clipboard on the remote host would be the wrong machine's clipboard.
+        await copyViaOsc52(text, { env, getTtyWriter });
+        return;
+    }
+    // Local: try native first.
+    try {
+        await runNativeCopy(text, platform, env, runCommand);
+        return;
+    }
+    catch (nativeErr) {
+        // Native failed — try OSC 52 if the content fits and a TTY is available.
+        if (Buffer.byteLength(text, 'utf8') > OSC52_MAX_BYTES) {
+            throw nativeErr;
+        }
+        const ttyWriter = getTtyWriter();
+        if (!ttyWriter) {
+            throw nativeErr;
+        }
+        ttyWriter(buildOsc52Sequence(text, env));
+    }
+}
 //# sourceMappingURL=clipboard.js.map

package/dist/utils/clipboard.js.map

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

package/dist/utils/clipboard.test.js

@@ -1,5 +1,6 @@
 import test from 'ava';
-import { copyToClipboard, getClipboardCommandCandidates } from './clipboard.js';
+import { copyToClipboard, copyViaOsc52, getClipboardCommandCandidates } from './clipboard.js';
+// ── getClipboardCommandCandidates ───────────────────────────────────────────
 test('getClipboardCommandCandidates returns macOS command', (t) => {
     t.deepEqual(getClipboardCommandCandidates('darwin', {}), [{ command: 'pbcopy', args: [] }]);
 });
@@ -20,6 +21,73 @@ test('getClipboardCommandCandidates prefers X11 tools when Wayland is not presen
         { command: 'wl-copy', args: [] },
     ]);
 });
+// ── copyViaOsc52 ────────────────────────────────────────────────────────────
+test('copyViaOsc52 writes bare OSC 52 sequence with base64-encoded text', async (t) => {
+    let written = '';
+    await copyViaOsc52('Hello', {
+        env: {},
+        getTtyWriter: () => (data) => {
+            written = data;
+        },
+    });
+    const expected = `\x1b]52;c;${Buffer.from('Hello').toString('base64')}\x07`;
+    t.is(written, expected);
+});
+test('copyViaOsc52 wraps in tmux DCS passthrough when TMUX is set', async (t) => {
+    let written = '';
+    await copyViaOsc52('Hi', {
+        env: { TMUX: '/tmp/tmux-1000/default,12345,0' },
+        getTtyWriter: () => (data) => {
+            written = data;
+        },
+    });
+    const inner = `\x1b]52;c;${Buffer.from('Hi').toString('base64')}\x07`;
+    const escaped = inner.replace(/\x1b/g, '\x1b\x1b');
+    t.is(written, `\x1bPtmux;\x1b${escaped}\x1b\\`);
+});
+test('copyViaOsc52 wraps in screen DCS passthrough when TERM starts with screen', async (t) => {
+    let written = '';
+    await copyViaOsc52('Hi', {
+        env: { TERM: 'screen-256color' },
+        getTtyWriter: () => (data) => {
+            written = data;
+        },
+    });
+    const inner = `\x1b]52;c;${Buffer.from('Hi').toString('base64')}\x07`;
+    t.is(written, `\x1bP${inner}\x1b\\`);
+});
+test('copyViaOsc52 chunks screen DCS passthrough at 768 characters', async (t) => {
+    // 600 raw bytes → ~800 base64 chars → inner length > 768
+    const longText = 'x'.repeat(600);
+    let written = '';
+    await copyViaOsc52(longText, {
+        env: { TERM: 'screen' },
+        getTtyWriter: () => (data) => {
+            written = data;
+        },
+    });
+    const inner = `\x1b]52;c;${Buffer.from(longText).toString('base64')}\x07`;
+    t.true(inner.length > 768, 'precondition: inner sequence must exceed 768 chars');
+    const chunk1 = inner.slice(0, 768);
+    const chunk2 = inner.slice(768);
+    t.is(written, `\x1bP${chunk1}\x1b\\` + `\x1bP${chunk2}\x1b\\`);
+});
+test('copyViaOsc52 throws when no TTY is available', async (t) => {
+    const error = await t.throwsAsync(copyViaOsc52('hello', {
+        env: {},
+        getTtyWriter: () => null,
+    }));
+    t.regex(error.message, /No TTY available/i);
+});
+test('copyViaOsc52 throws when text exceeds the size limit', async (t) => {
+    const largeText = 'x'.repeat(71 * 1024);
+    const error = await t.throwsAsync(copyViaOsc52(largeText, {
+        env: {},
+        getTtyWriter: () => (_data) => { },
+    }));
+    t.regex(error.message, /too large/i);
+});
+// ── copyToClipboard ─────────────────────────────────────────────────────────
 test('copyToClipboard uses the first successful command', async (t) => {
     const calls = [];
     await copyToClipboard('hello', {
@@ -29,6 +97,7 @@ test('copyToClipboard uses the first successful command', async (t) => {
             calls.push({ command, args, input });
             return { success: true };
         },
+        getTtyWriter: () => null,
     });
     t.deepEqual(calls, [{ command: 'pbcopy', args: [], input: 'hello' }]);
 });
@@ -44,14 +113,16 @@ test('copyToClipboard falls back when a command is unavailable', async (t) => {
             }
             return { success: true };
         },
+        getTtyWriter: () => null,
     });
     t.deepEqual(calls, ['wl-copy', 'xclip']);
 });
-test('copyToClipboard throws when no clipboard command succeeds', async (t) => {
+test('copyToClipboard throws when no clipboard command succeeds and no TTY is available', async (t) => {
     const error = await t.throwsAsync(copyToClipboard('hello', {
         platform: 'linux',
         env: {},
         runCommand: () => ({ success: false, errorMessage: 'not found' }),
+        getTtyWriter: () => null,
     }));
     t.regex(error.message, /Clipboard is unavailable/i);
     t.regex(error.message, /xclip, xsel, wl-copy/i);
@@ -72,7 +143,86 @@ test('copyToClipboard awaits asynchronous command results', async (t) => {
                 }, 10);
             });
         },
+        getTtyWriter: () => null,
     });
     t.deepEqual(calls, ['xclip', 'xsel']);
 });
+test('copyToClipboard uses OSC 52 when SSH_CONNECTION is set, not native', async (t) => {
+    let written = '';
+    await copyToClipboard('hello', {
+        platform: 'linux',
+        env: { SSH_CONNECTION: '10.0.0.1 12345 10.0.0.2 22' },
+        runCommand: () => {
+            t.fail('native command should not be invoked in SSH session');
+            return { success: false };
+        },
+        getTtyWriter: () => (data) => {
+            written = data;
+        },
+    });
+    t.regex(written, /^\x1b\]52;c;/);
+});
+test('copyToClipboard uses OSC 52 when SSH_TTY is set', async (t) => {
+    let written = '';
+    await copyToClipboard('hello', {
+        platform: 'linux',
+        env: { SSH_TTY: '/dev/pts/0' },
+        runCommand: () => {
+            t.fail('should not call native');
+            return { success: false };
+        },
+        getTtyWriter: () => (data) => {
+            written = data;
+        },
+    });
+    t.truthy(written);
+});
+test('copyToClipboard uses OSC 52 when SSH_CLIENT is set', async (t) => {
+    let written = '';
+    await copyToClipboard('hello', {
+        platform: 'linux',
+        env: { SSH_CLIENT: '10.0.0.1 12345 22' },
+        runCommand: () => {
+            t.fail('should not call native');
+            return { success: false };
+        },
+        getTtyWriter: () => (data) => {
+            written = data;
+        },
+    });
+    t.truthy(written);
+});
+test('copyToClipboard falls back to OSC 52 when all native commands fail locally', async (t) => {
+    let written = '';
+    await copyToClipboard('hello', {
+        platform: 'linux',
+        env: {},
+        runCommand: () => ({ success: false, errorMessage: 'not found' }),
+        getTtyWriter: () => (data) => {
+            written = data;
+        },
+    });
+    t.regex(written, /^\x1b\]52;c;/);
+});
+test('copyToClipboard rethrows native error when native fails and no TTY is available locally', async (t) => {
+    const error = await t.throwsAsync(copyToClipboard('hello', {
+        platform: 'linux',
+        env: {},
+        runCommand: () => ({ success: false, errorMessage: 'not found' }),
+        getTtyWriter: () => null,
+    }));
+    t.regex(error.message, /Clipboard is unavailable/i);
+});
+test('copyToClipboard throws no-TTY error when in SSH session and no TTY is available', async (t) => {
+    const error = await t.throwsAsync(copyToClipboard('hello', {
+        platform: 'linux',
+        env: { SSH_CONNECTION: '10.0.0.1 12345 10.0.0.2 22' },
+        runCommand: () => {
+            t.fail('should not call native');
+            return { success: false };
+        },
+        getTtyWriter: () => null,
+    }));
+    t.regex(error.message, /No TTY available/i);
+});
 //# sourceMappingURL=clipboard.test.js.map

package/dist/utils/clipboard.test.js.map

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

package/dist/utils/command-safety.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Validate command safety using an AST parser.
+ * Returns true when a command requires user approval.
+ * Throws for invalid/empty inputs.
+ */
+export declare enum SafetyStatus {
+    GREEN = "GREEN",
+    YELLOW = "YELLOW",
+    RED = "RED"
+}
+/**
+ * Classify command into a SafetyStatus (GREEN/YELLOW/RED)
+ */
+export declare function classifyCommand(commandString: string): SafetyStatus;
+/**
+ * Validate command safety using an AST parser.
+ * Returns true when a command requires user approval.
+ * Throws for invalid/empty inputs OR hard-blocked RED classifications.
+ */
+export declare function validateCommandSafety(command: string): boolean;
+//# sourceMappingURL=command-safety.d.ts.map

package/dist/utils/command-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-safety.d.ts","sourceRoot":"","sources":["../../source/utils/command-safety.ts"],"names":[],"mappings":"AAuDA;;;;GAIG;AACH,oBAAY,YAAY;IACpB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,GAAG,QAAQ;CACd;AAyGD;;GAEG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,YAAY,CAyMnE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAyB9D"}

package/dist/utils/command-safety.devnull.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command-safety.devnull.test.d.ts.map

package/dist/utils/command-safety.devnull.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-safety.devnull.test.d.ts","sourceRoot":"","sources":["../../source/utils/command-safety.devnull.test.ts"],"names":[],"mappings":""}

package/dist/utils/command-safety.devnull.test.js

@@ -0,0 +1,13 @@
+import test from 'ava';
+import { analyzePathRisk } from './command-safety/path-analysis.js';
+import { SafetyStatus, classifyCommand } from './command-safety/index.js';
+test('analyzePathRisk - /dev/null should be GREEN', t => {
+    const result = analyzePathRisk('/dev/null');
+    t.is(result, SafetyStatus.GREEN, '/dev/null should be considered safe');
+});
+test('classifyCommand - cat prod.sh 2>/dev/null | head -200 should be GREEN', t => {
+    const command = 'cat prod.sh 2>/dev/null | head -200';
+    const status = classifyCommand(command);
+    t.is(status, SafetyStatus.GREEN, 'command with /dev/null redirection should be GREEN');
+});
+//# sourceMappingURL=command-safety.devnull.test.js.map

package/dist/utils/command-safety.devnull.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-safety.devnull.test.js","sourceRoot":"","sources":["../../source/utils/command-safety.devnull.test.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,KAAK,CAAC;AACvB,OAAO,EAAC,eAAe,EAAC,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAC,YAAY,EAAE,eAAe,EAAC,MAAM,2BAA2B,CAAC;AAExE,IAAI,CAAC,6CAA6C,EAAE,CAAC,CAAC,EAAE;IACpD,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,EAAE,qCAAqC,CAAC,CAAC;AAC5E,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,uEAAuE,EAAE,CAAC,CAAC,EAAE;IAC9E,MAAM,OAAO,GAAG,qCAAqC,CAAC;IACtD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,EAAE,oDAAoD,CAAC,CAAC;AAC3F,CAAC,CAAC,CAAC"}