tuplet 2.7.0

package/dist/shell/commands/tail.js

@@ -0,0 +1,68 @@
+/**
+ * tail - Output the last part of files
+ */
+import { MAX_LINE_LENGTH } from '../limits.js';
+export const tailCommand = {
+    name: 'tail',
+    help: {
+        usage: 'tail [OPTIONS] [FILE...]',
+        description: 'Output the last part of files',
+        flags: [
+            { flag: '-n NUM', description: 'Output last NUM lines (default: 10)' }
+        ],
+        examples: [
+            { command: 'tail log.txt', description: 'Show last 10 lines' },
+            { command: 'tail -n 3 history.json', description: 'Show last 3 lines' },
+            { command: 'cat data | tail -n 5', description: 'Last 5 lines of piped input' }
+        ],
+        notes: [
+            'Also accepts -NUM shorthand (e.g. tail -5 file)',
+            'Reads from stdin when no file given and input is piped',
+            `Lines are truncated to ${MAX_LINE_LENGTH} characters`
+        ]
+    },
+    async execute(args, ctx) {
+        let lines = 10;
+        const paths = [];
+        for (let i = 0; i < args.length; i++) {
+            const arg = args[i];
+            if (arg === '-n') {
+                lines = parseInt(args[++i], 10);
+            }
+            else if (arg.startsWith('-') && !isNaN(parseInt(arg.slice(1), 10))) {
+                lines = parseInt(arg.slice(1), 10);
+            }
+            else if (!arg.startsWith('-')) {
+                paths.push(arg);
+            }
+        }
+        // Handle stdin
+        if (paths.length === 0 && ctx.stdin !== undefined) {
+            const inputLines = ctx.stdin.split('\n');
+            const output = inputLines.slice(-lines)
+                .map(line => line.length > MAX_LINE_LENGTH ? line.slice(0, MAX_LINE_LENGTH) + '...' : line)
+                .join('\n');
+            return { exitCode: 0, stdout: output + '\n', stderr: '' };
+        }
+        if (paths.length === 0) {
+            return { exitCode: 1, stdout: '', stderr: 'tail: missing file operand' };
+        }
+        const outputs = [];
+        for (const path of paths) {
+            const content = await ctx.fs.read(path);
+            if (content === null) {
+                return { exitCode: 1, stdout: '', stderr: `tail: ${path}: No such file` };
+            }
+            const fileLines = content.split('\n');
+            const output = fileLines.slice(-lines)
+                .map(line => line.length > MAX_LINE_LENGTH ? line.slice(0, MAX_LINE_LENGTH) + '...' : line)
+                .join('\n');
+            if (paths.length > 1) {
+                outputs.push(`==> ${path} <==`);
+            }
+            outputs.push(output);
+        }
+        return { exitCode: 0, stdout: outputs.join('\n') + '\n', stderr: '' };
+    }
+};
+//# sourceMappingURL=tail.js.map

package/dist/shell/commands/tail.js.map

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

package/dist/shell/commands/wc.d.ts

@@ -0,0 +1,6 @@
+/**
+ * wc - Word, line, and byte count
+ */
+import type { CommandHandler } from '../types.js';
+export declare const wcCommand: CommandHandler;
+//# sourceMappingURL=wc.d.ts.map

package/dist/shell/commands/wc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wc.d.ts","sourceRoot":"","sources":["../../../src/shell/commands/wc.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAA+B,MAAM,aAAa,CAAA;AAE9E,eAAO,MAAM,SAAS,EAAE,cAkFvB,CAAA"}

package/dist/shell/commands/wc.js

@@ -0,0 +1,86 @@
+/**
+ * wc - Word, line, and byte count
+ */
+export const wcCommand = {
+    name: 'wc',
+    help: {
+        usage: 'wc [OPTIONS] [FILE...]',
+        description: 'Print newline, word, and byte counts',
+        flags: [
+            { flag: '-l', description: 'Print line count only' },
+            { flag: '-w', description: 'Print word count only' },
+            { flag: '-c', description: 'Print character/byte count only' }
+        ],
+        examples: [
+            { command: 'wc file.txt', description: 'Show all counts for file' },
+            { command: 'wc -l file.txt', description: 'Count lines only' },
+            { command: 'cat file.txt | wc -l', description: 'Count lines from stdin' }
+        ]
+    },
+    async execute(args, ctx) {
+        let countLines = false;
+        let countWords = false;
+        let countChars = false;
+        const paths = [];
+        for (const arg of args) {
+            if (arg === '-l') {
+                countLines = true;
+            }
+            else if (arg === '-w') {
+                countWords = true;
+            }
+            else if (arg === '-c' || arg === '-m') {
+                countChars = true;
+            }
+            else if (arg.startsWith('-') && /^-[lwcm]+$/.test(arg)) {
+                for (const ch of arg.slice(1)) {
+                    if (ch === 'l')
+                        countLines = true;
+                    else if (ch === 'w')
+                        countWords = true;
+                    else if (ch === 'c' || ch === 'm')
+                        countChars = true;
+                }
+            }
+            else if (!arg.startsWith('-')) {
+                paths.push(arg);
+            }
+        }
+        // Default: show all counts
+        const showAll = !countLines && !countWords && !countChars;
+        function formatCounts(content, label) {
+            const lines = content.split('\n');
+            // Line count: number of newlines (trailing newline = +1 line)
+            const lineCount = content.endsWith('\n') ? lines.length - 1 : lines.length;
+            const wordCount = content.split(/\s+/).filter(w => w.length > 0).length;
+            const charCount = content.length;
+            const parts = [];
+            if (showAll || countLines)
+                parts.push(String(lineCount).padStart(8));
+            if (showAll || countWords)
+                parts.push(String(wordCount).padStart(8));
+            if (showAll || countChars)
+                parts.push(String(charCount).padStart(8));
+            if (label)
+                parts.push(` ${label}`);
+            return parts.join('');
+        }
+        // Handle stdin
+        if (paths.length === 0 && ctx.stdin !== undefined) {
+            return { exitCode: 0, stdout: formatCounts(ctx.stdin) + '\n', stderr: '' };
+        }
+        if (paths.length === 0) {
+            return { exitCode: 1, stdout: '', stderr: 'wc: missing file operand' };
+        }
+        const outputs = [];
+        for (const path of paths) {
+            const content = await ctx.fs.read(path);
+            if (content === null) {
+                return { exitCode: 1, stdout: '', stderr: `wc: ${path}: No such file` };
+            }
+            outputs.push(formatCounts(content, path));
+        }
+        return { exitCode: 0, stdout: outputs.join('\n') + '\n', stderr: '' };
+    }
+};
+//# sourceMappingURL=wc.js.map

package/dist/shell/commands/wc.js.map

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

package/dist/shell/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shell Emulator
+ *
+ * Bash-like interface for context management and HTTP requests.
+ * AI tool acts as a proxy to this emulator.
+ */
+export { Shell } from './shell.js';
+export type { ShellConfig, ShellResult, CommandHandler, CommandHelp, CommandFlag, CommandExample } from './types.js';
+export * from './commands/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shell/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shell/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAGpH,cAAc,qBAAqB,CAAA"}

package/dist/shell/index.js

@@ -0,0 +1,10 @@
+/**
+ * Shell Emulator
+ *
+ * Bash-like interface for context management and HTTP requests.
+ * AI tool acts as a proxy to this emulator.
+ */
+export { Shell } from './shell.js';
+// Command handlers
+export * from './commands/index.js';
+//# sourceMappingURL=index.js.map

package/dist/shell/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shell/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAGlC,mBAAmB;AACnB,cAAc,qBAAqB,CAAA"}

package/dist/shell/limits.d.ts

@@ -0,0 +1,5 @@
+export declare const MAX_FILE_SIZE = 262144;
+export declare const DEFAULT_LINE_LIMIT = 2000;
+export declare const MAX_LINE_LENGTH = 2000;
+export declare const MAX_OUTPUT_CHARS = 30000;
+//# sourceMappingURL=limits.d.ts.map

package/dist/shell/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../src/shell/limits.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,SAAU,CAAA;AACpC,eAAO,MAAM,kBAAkB,OAAQ,CAAA;AACvC,eAAO,MAAM,eAAe,OAAQ,CAAA;AACpC,eAAO,MAAM,gBAAgB,QAAS,CAAA"}

package/dist/shell/limits.js

@@ -0,0 +1,5 @@
+export const MAX_FILE_SIZE = 262_144; // 256 KB
+export const DEFAULT_LINE_LIMIT = 2_000; // lines per read
+export const MAX_LINE_LENGTH = 2_000; // chars per line
+export const MAX_OUTPUT_CHARS = 30_000; // shell tool output cap
+//# sourceMappingURL=limits.js.map

package/dist/shell/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../src/shell/limits.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAA,CAAO,SAAS;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAA,CAAI,iBAAiB;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAA,CAAO,iBAAiB;AAC5D,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAA,CAAK,wBAAwB"}

package/dist/shell/parser.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shell Command Parser
+ *
+ * Parses bash-like command strings into structured commands.
+ */
+import type { ParsedCommand } from './types.js';
+export declare function parseCommand(input: string): ParsedCommand[];
+//# sourceMappingURL=parser.d.ts.map

package/dist/shell/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/shell/parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAQ/C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,CA4D3D"}

package/dist/shell/parser.js

@@ -0,0 +1,307 @@
+/**
+ * Shell Command Parser
+ *
+ * Parses bash-like command strings into structured commands.
+ */
+/**
+ * Heredoc regex: matches << WORD, <<-WORD, << 'WORD', << "WORD"
+ * Group 1: optional leading quote, Group 2: delimiter word
+ */
+const HEREDOC_RE = /<<-?\s*(['"]?)(\w+)\1/;
+export function parseCommand(input) {
+    const commands = [];
+    // Join lines that are inside open quotes before splitting into commands
+    const logicalLines = joinQuotedLines(input.split('\n'));
+    let i = 0;
+    while (i < logicalLines.length) {
+        const line = logicalLines[i].trim();
+        // Skip empty lines and comment lines
+        if (line === '' || line.startsWith('#')) {
+            i++;
+            continue;
+        }
+        // Check for heredoc (e.g. cat << EOF > /file.json)
+        const heredocMatch = line.match(HEREDOC_RE);
+        if (heredocMatch) {
+            const quoteChar = heredocMatch[1]; // '' if unquoted, "'" or '"' if quoted
+            const delimiter = heredocMatch[2];
+            // Remove the << DELIMITER portion, keep the rest (command + redirections)
+            const cleanedLine = line.replace(HEREDOC_RE, '').trim();
+            // Collect heredoc body until matching delimiter
+            const heredocLines = [];
+            i++;
+            while (i < logicalLines.length && logicalLines[i].trim() !== delimiter) {
+                heredocLines.push(logicalLines[i]);
+                i++;
+            }
+            i++; // skip the delimiter line
+            if (cleanedLine) {
+                const parsed = parsePipeline(cleanedLine);
+                if (parsed) {
+                    parsed.stdinContent = heredocLines.join('\n');
+                    // Quoted delimiter (e.g. << 'EOF') suppresses variable expansion
+                    if (quoteChar) {
+                        parsed.heredocQuoted = true;
+                    }
+                    commands.push(parsed);
+                }
+            }
+            continue;
+        }
+        // Split by && (respecting quotes) before pipe parsing
+        const andParts = splitByAnd(line);
+        for (const part of andParts) {
+            const trimmedPart = part.trim();
+            if (!trimmedPart)
+                continue;
+            const parsed = parsePipeline(trimmedPart);
+            if (parsed) {
+                commands.push(parsed);
+            }
+        }
+        i++;
+    }
+    return commands;
+}
+/**
+ * Join lines that are continuations of an unclosed quote from a previous line.
+ * e.g. echo 'hello\nworld' sent as two lines gets joined back into one.
+ */
+function joinQuotedLines(lines) {
+    const result = [];
+    let pending = '';
+    let inSingleQuote = false;
+    let inDoubleQuote = false;
+    for (const line of lines) {
+        if (inSingleQuote || inDoubleQuote) {
+            // We're continuing a quoted string from a previous line
+            pending += '\n' + line;
+        }
+        else {
+            // Start a new logical line
+            if (pending)
+                result.push(pending);
+            pending = line;
+        }
+        // Scan this line to update quote state
+        let escape = false;
+        for (const ch of line) {
+            if (escape) {
+                escape = false;
+                continue;
+            }
+            if (ch === '\\' && !inSingleQuote) {
+                escape = true;
+                continue;
+            }
+            if (ch === "'" && !inDoubleQuote) {
+                inSingleQuote = !inSingleQuote;
+            }
+            else if (ch === '"' && !inSingleQuote) {
+                inDoubleQuote = !inDoubleQuote;
+            }
+        }
+    }
+    if (pending)
+        result.push(pending);
+    return result;
+}
+/**
+ * Split a line by && (AND operator), respecting quotes.
+ */
+function splitByAnd(input) {
+    const parts = [];
+    let current = '';
+    let inSingleQuote = false;
+    let inDoubleQuote = false;
+    let escape = false;
+    for (let i = 0; i < input.length; i++) {
+        const char = input[i];
+        if (escape) {
+            current += char;
+            escape = false;
+            continue;
+        }
+        if (char === '\\') {
+            escape = true;
+            current += char;
+            continue;
+        }
+        if (char === "'" && !inDoubleQuote) {
+            inSingleQuote = !inSingleQuote;
+            current += char;
+            continue;
+        }
+        if (char === '"' && !inSingleQuote) {
+            inDoubleQuote = !inDoubleQuote;
+            current += char;
+            continue;
+        }
+        if (char === '&' && input[i + 1] === '&' && !inSingleQuote && !inDoubleQuote) {
+            parts.push(current);
+            current = '';
+            i++; // skip second &
+            continue;
+        }
+        current += char;
+    }
+    if (current) {
+        parts.push(current);
+    }
+    return parts;
+}
+/**
+ * Parse a single line that may contain pipes into a linked ParsedCommand chain.
+ */
+function parsePipeline(line) {
+    const segments = splitByPipe(line);
+    let first = null;
+    let prev = null;
+    for (const segment of segments) {
+        const trimmed = segment.trim();
+        if (!trimmed)
+            continue;
+        const parsed = parseSegment(trimmed);
+        if (!first) {
+            first = parsed;
+        }
+        if (prev) {
+            prev.pipe = parsed;
+        }
+        prev = parsed;
+    }
+    return first;
+}
+function parseSegment(segment) {
+    // Strip stderr redirections (2>/dev/null, 2>&1, etc.) — no stderr in virtual shell
+    const cleaned = segment.replace(/\s*2>\s*(?:\/dev\/null|&1)\s*/g, ' ');
+    const tokens = tokenize(cleaned);
+    const result = {
+        command: '',
+        args: []
+    };
+    let i = 0;
+    // First token is the command
+    if (tokens.length > 0) {
+        result.command = tokens[i++];
+    }
+    // Parse remaining tokens
+    while (i < tokens.length) {
+        const token = tokens[i];
+        if (token === '>') {
+            // Output redirection
+            result.outputFile = tokens[++i];
+        }
+        else if (token === '>>') {
+            // Append redirection
+            result.appendFile = tokens[++i];
+        }
+        else if (token === '<') {
+            // Input redirection
+            result.inputFile = tokens[++i];
+        }
+        else {
+            result.args.push(token);
+        }
+        i++;
+    }
+    return result;
+}
+function splitByPipe(input) {
+    const segments = [];
+    let current = '';
+    let inSingleQuote = false;
+    let inDoubleQuote = false;
+    let escape = false;
+    for (const char of input) {
+        if (escape) {
+            current += char;
+            escape = false;
+            continue;
+        }
+        if (char === '\\') {
+            escape = true;
+            current += char;
+            continue;
+        }
+        if (char === "'" && !inDoubleQuote) {
+            inSingleQuote = !inSingleQuote;
+            current += char;
+            continue;
+        }
+        if (char === '"' && !inSingleQuote) {
+            inDoubleQuote = !inDoubleQuote;
+            current += char;
+            continue;
+        }
+        if (char === '|' && !inSingleQuote && !inDoubleQuote) {
+            segments.push(current);
+            current = '';
+            continue;
+        }
+        current += char;
+    }
+    if (current) {
+        segments.push(current);
+    }
+    return segments;
+}
+function tokenize(input) {
+    const tokens = [];
+    let current = '';
+    let inSingleQuote = false;
+    let inDoubleQuote = false;
+    let escape = false;
+    for (const char of input) {
+        if (escape) {
+            current += char;
+            escape = false;
+            continue;
+        }
+        if (char === '\\' && !inSingleQuote) {
+            escape = true;
+            continue;
+        }
+        if (char === "'" && !inDoubleQuote) {
+            inSingleQuote = !inSingleQuote;
+            continue;
+        }
+        if (char === '"' && !inSingleQuote) {
+            inDoubleQuote = !inDoubleQuote;
+            continue;
+        }
+        if ((char === ' ' || char === '\t') && !inSingleQuote && !inDoubleQuote) {
+            if (current) {
+                tokens.push(current);
+                current = '';
+            }
+            continue;
+        }
+        // Handle >> as single token
+        if (char === '>' && current === '>') {
+            current = '>>';
+            tokens.push(current);
+            current = '';
+            continue;
+        }
+        // Handle > and < as separate tokens
+        if ((char === '>' || char === '<') && !inSingleQuote && !inDoubleQuote) {
+            if (current) {
+                tokens.push(current);
+                current = '';
+            }
+            current = char;
+            continue;
+        }
+        if ((current === '>' || current === '<') && !inSingleQuote && !inDoubleQuote) {
+            tokens.push(current);
+            current = '';
+        }
+        current += char;
+    }
+    if (current) {
+        tokens.push(current);
+    }
+    return tokens;
+}
+//# sourceMappingURL=parser.js.map

package/dist/shell/parser.js.map

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

package/dist/shell/path-validation.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Path Validation
+ *
+ * Validates and normalizes workspace paths.
+ * All workspace paths must be relative — absolute paths and '..' traversal are forbidden.
+ */
+import type { WorkspaceProvider } from '../providers/workspace/types.js';
+export interface PathValidationResult {
+    /** Error message if path is invalid */
+    error?: string;
+    /** Normalized internal path (with '/' prefix for provider) */
+    fsPath: string;
+}
+/**
+ * Validate and normalize a workspace path.
+ *
+ * Rules:
+ * - '.' and '' map to root ('/')
+ * - Paths starting with './' have the prefix stripped
+ * - Absolute paths (starting with '/') are rejected
+ * - Path traversal ('..') is rejected
+ * - Valid relative paths get '/' prepended for internal provider use
+ */
+export declare function validatePath(path: string): PathValidationResult;
+/**
+ * Create a validated filesystem wrapper.
+ *
+ * Wraps a WorkspaceProvider so that all path arguments are validated
+ * (must be relative, no '..') and converted to internal format (prepended with '/').
+ * Results from glob() have the leading '/' stripped to return relative paths.
+ *
+ * Throws on invalid paths — the shell's top-level catch converts these to stderr.
+ */
+export declare function createValidatedFS(inner: WorkspaceProvider): WorkspaceProvider;
+//# sourceMappingURL=path-validation.d.ts.map

package/dist/shell/path-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-validation.d.ts","sourceRoot":"","sources":["../../src/shell/path-validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAExE,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CA8B/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,iBAAiB,CAqC7E"}