pty-auto 0.3.6

package/dist/src/plugin/pty/tools/kill.js

@@ -0,0 +1,37 @@
+import { tool } from '@opencode-ai/plugin';
+import { manager } from "../manager.js";
+import { buildSessionNotFoundError } from "../utils.js";
+import DESCRIPTION from './kill.txt';
+export const ptyKill = tool({
+    description: DESCRIPTION,
+    args: {
+        id: tool.schema.string().describe('The PTY session ID (e.g., pty_a1b2c3d4)'),
+        cleanup: tool.schema
+            .boolean()
+            .optional()
+            .describe('If true, removes the session and frees the buffer (default: false)'),
+    },
+    async execute(args) {
+        const session = manager.get(args.id);
+        if (!session) {
+            throw buildSessionNotFoundError(args.id);
+        }
+        const wasRunning = session.status === 'running';
+        const cleanup = args.cleanup ?? false;
+        const success = manager.kill(args.id, cleanup);
+        if (!success) {
+            throw new Error(`Failed to kill PTY session '${args.id}'.`);
+        }
+        const action = wasRunning ? 'Killed' : 'Cleaned up';
+        const cleanupNote = cleanup ? ' (session removed)' : ' (session retained for log access)';
+        return [
+            `<pty_killed>`,
+            `${action}: ${args.id}${cleanupNote}`,
+            `Title: ${session.title}`,
+            `Command: ${session.command} ${session.args.join(' ')}`,
+            `Final line count: ${session.lineCount}`,
+            `</pty_killed>`,
+        ].join('\n');
+    },
+});
+//# sourceMappingURL=kill.js.map

package/dist/src/plugin/pty/tools/kill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kill.js","sourceRoot":"","sources":["../../../../../src/plugin/pty/tools/kill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,WAAW,MAAM,YAAY,CAAA;AAEpC,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,WAAW;IACxB,IAAI,EAAE;QACJ,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QAC5E,OAAO,EAAE,IAAI,CAAC,MAAM;aACjB,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,oEAAoE,CAAC;KAClF;IACD,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACpC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC1C,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,CAAA;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,CAAA;QACrC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAE9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,CAAC,EAAE,IAAI,CAAC,CAAA;QAC7D,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAA;QACnD,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,oCAAoC,CAAA;QAEzF,OAAO;YACL,cAAc;YACd,GAAG,MAAM,KAAK,IAAI,CAAC,EAAE,GAAG,WAAW,EAAE;YACrC,UAAU,OAAO,CAAC,KAAK,EAAE;YACzB,YAAY,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YACvD,qBAAqB,OAAO,CAAC,SAAS,EAAE;YACxC,eAAe;SAChB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACd,CAAC;CACF,CAAC,CAAA"}

package/dist/src/plugin/pty/tools/kill.txt

@@ -0,0 +1,25 @@
+Terminates a PTY session and optionally cleans up its buffer.
+
+Use this tool to:
+- Stop a running process (sends SIGTERM)
+- Clean up an exited session to free memory
+- Remove a session from the list
+
+Usage:
+- `id`: The PTY session ID (from pty_spawn or pty_list)
+- `cleanup`: If true, removes the session and frees the buffer (default: false)
+
+Behavior:
+- If the session is running, it will be killed (status becomes "killed")
+- If cleanup=false (default), the session remains in the list with its output buffer intact
+- If cleanup=true, the session is removed entirely and the buffer is freed
+- Keeping sessions without cleanup allows you to compare logs between runs
+
+Tips:
+- Use cleanup=false if you might want to read the output later
+- Use cleanup=true when you're done with the session entirely
+- To send Ctrl+C instead of killing, use pty_write with data="\x03"
+
+Examples:
+- Kill but keep logs: cleanup=false (or omit)
+- Kill and remove: cleanup=true

package/dist/src/plugin/pty/tools/list.d.ts

@@ -0,0 +1,6 @@
+export declare const ptyList: {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+//# sourceMappingURL=list.d.ts.map

package/dist/src/plugin/pty/tools/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/pty/tools/list.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,OAAO;;;;CAmBlB,CAAA"}

package/dist/src/plugin/pty/tools/list.js

@@ -0,0 +1,22 @@
+import { tool } from '@opencode-ai/plugin';
+import { manager } from "../manager.js";
+import { formatSessionInfo } from "../formatters.js";
+import DESCRIPTION from './list.txt';
+export const ptyList = tool({
+    description: DESCRIPTION,
+    args: {},
+    async execute() {
+        const sessions = manager.list();
+        if (sessions.length === 0) {
+            return '<pty_list>\nNo active PTY sessions.\n</pty_list>';
+        }
+        const lines = ['<pty_list>'];
+        for (const session of sessions) {
+            lines.push(...formatSessionInfo(session));
+        }
+        lines.push(`Total: ${sessions.length} session(s)`);
+        lines.push('</pty_list>');
+        return lines.join('\n');
+    },
+});
+//# sourceMappingURL=list.js.map

package/dist/src/plugin/pty/tools/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../../src/plugin/pty/tools/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,WAAW,MAAM,YAAY,CAAA;AAEpC,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,WAAW;IACxB,IAAI,EAAE,EAAE;IACR,KAAK,CAAC,OAAO;QACX,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;QAE/B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,kDAAkD,CAAA;QAC3D,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,YAAY,CAAC,CAAA;QAC5B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAA;QAC3C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,UAAU,QAAQ,CAAC,MAAM,aAAa,CAAC,CAAA;QAClD,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;QAEzB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;CACF,CAAC,CAAA"}

package/dist/src/plugin/pty/tools/list.txt

@@ -0,0 +1,22 @@
+Lists all PTY sessions (active and exited).
+
+Use this tool to:
+- See all running and exited PTY sessions
+- Get session IDs for use with other pty_* tools
+- Check the status and output line count of each session
+- Monitor which processes are still running
+
+Returns for each session:
+- `id`: Unique identifier for use with other tools
+- `title`: Human-readable name
+- `command`: The command that was executed
+- `status`: Current status (running, exited, killed)
+- `exitCode`: Exit code (if exited/killed)
+- `pid`: Process ID
+- `lineCount`: Number of lines in the output buffer
+- `createdAt`: When the session was created
+
+Tips:
+- Use the session ID with pty_read, pty_write, or pty_kill
+- Sessions remain in the list after exit until explicitly cleaned up with pty_kill
+- This allows you to compare output from multiple sessions

package/dist/src/plugin/pty/tools/read.d.ts

@@ -0,0 +1,18 @@
+export declare const ptyRead: {
+    description: string;
+    args: {
+        id: import("zod").ZodString;
+        offset: import("zod").ZodOptional<import("zod").ZodNumber>;
+        limit: import("zod").ZodOptional<import("zod").ZodNumber>;
+        pattern: import("zod").ZodOptional<import("zod").ZodString>;
+        ignoreCase: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    };
+    execute(args: {
+        id: string;
+        offset?: number | undefined;
+        limit?: number | undefined;
+        pattern?: string | undefined;
+        ignoreCase?: boolean | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+//# sourceMappingURL=read.d.ts.map

package/dist/src/plugin/pty/tools/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/pty/tools/read.ts"],"names":[],"mappings":"AAoNA,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;CA0ClB,CAAA"}

package/dist/src/plugin/pty/tools/read.js

@@ -0,0 +1,165 @@
+import { tool } from '@opencode-ai/plugin';
+import { manager } from "../manager.js";
+import { DEFAULT_READ_LIMIT, MAX_LINE_LENGTH } from "../../../shared/constants.js";
+import { buildSessionNotFoundError } from "../utils.js";
+import { formatLine } from "../formatters.js";
+import DESCRIPTION from './read.txt';
+const NOTIFY_ON_EXIT_REMINDER = [
+    `<system_reminder>`,
+    `This session was started with \`notifyOnExit=true\`.`,
+    `Completion signal is the future \`<pty_exited>\` message, not repeated \`pty_read\` calls.`,
+    `If you only need to know whether the command finished, stop polling and wait for \`<pty_exited>\`.`,
+    `Do not use sleep plus \`pty_read\` loops to check completion.`,
+    `Use \`pty_read\` only when you need live output now, the user explicitly asks for logs, or the exit notification reports a non-zero status and you need to investigate.`,
+    `</system_reminder>`,
+].join('\n');
+function buildTimeoutReminder(session) {
+    return [
+        `<system_reminder>`,
+        `This session was auto-killed after reaching \`timeoutSeconds=${session.timeoutSeconds ?? 'unknown'}\`.`,
+        `Use \`pty_read\` to inspect the final output or \`pty_list\` to review other sessions.`,
+        `</system_reminder>`,
+    ].join('\n');
+}
+/**
+ * Formats PTY output with XML tags and pagination
+ */
+function formatPtyOutput(id, status, pattern, formattedLines, hasMore, paginationMessage, endMessage) {
+    const output = [
+        `<pty_output id="${id}" status="${status}"${pattern ? ` pattern="${pattern}"` : ''}>`,
+        ...formattedLines,
+        '',
+        hasMore ? paginationMessage : endMessage,
+        `</pty_output>`,
+    ];
+    return output.join('\n');
+}
+function appendNotifyOnExitReminder(output, session) {
+    if (!session.notifyOnExit || session.status !== 'running') {
+        return output;
+    }
+    return `${output}\n\n${NOTIFY_ON_EXIT_REMINDER}`;
+}
+function appendTimeoutReminder(output, session) {
+    if (!session.timedOut) {
+        return output;
+    }
+    return `${output}\n\n${buildTimeoutReminder(session)}`;
+}
+function appendSessionReminders(output, session) {
+    return appendTimeoutReminder(appendNotifyOnExitReminder(output, session), session);
+}
+/**
+ * Validates and creates a RegExp from pattern string
+ */
+function validateAndCreateRegex(pattern, ignoreCase) {
+    if (!validateRegex(pattern)) {
+        throw new Error(`Potentially dangerous regex pattern rejected: '${pattern}'. Please use a safer pattern.`);
+    }
+    try {
+        return new RegExp(pattern, ignoreCase ? 'i' : '');
+    }
+    catch (e) {
+        const error = e instanceof Error ? e.message : String(e);
+        throw new Error(`Invalid regex pattern '${pattern}': ${error}`);
+    }
+}
+/**
+ * Handles pattern-based reading and formatting
+ */
+function handlePatternRead(id, pattern, ignoreCase, session, offset, limit) {
+    const regex = validateAndCreateRegex(pattern, ignoreCase);
+    const result = manager.search(id, regex, offset, limit);
+    if (!result) {
+        throw buildSessionNotFoundError(id);
+    }
+    if (result.matches.length === 0) {
+        return appendSessionReminders([
+            `<pty_output id="${id}" status="${session.status}" pattern="${pattern}">`,
+            `No lines matched the pattern '${pattern}'.`,
+            `Total lines in buffer: ${result.totalLines}`,
+            `</pty_output>`,
+        ].join('\n'), session);
+    }
+    const formattedLines = result.matches.map((match) => formatLine(match.text, match.lineNumber, MAX_LINE_LENGTH));
+    const paginationMessage = `(${result.matches.length} of ${result.totalMatches} matches shown. Use offset=${offset + result.matches.length} to see more.)`;
+    const endMessage = `(${result.totalMatches} match${result.totalMatches === 1 ? '' : 'es'} from ${result.totalLines} total lines)`;
+    return appendSessionReminders(formatPtyOutput(id, session.status, pattern, formattedLines, result.hasMore, paginationMessage, endMessage), session);
+}
+/**
+ * Handles plain reading and formatting
+ */
+function handlePlainRead(args, session, offset, limit) {
+    const result = manager.read(args.id, offset, limit);
+    if (!result) {
+        throw buildSessionNotFoundError(args.id);
+    }
+    if (result.lines.length === 0) {
+        return appendSessionReminders([
+            `<pty_output id="${args.id}" status="${session.status}">`,
+            `(No output available - buffer is empty)`,
+            `Total lines: ${result.totalLines}`,
+            `</pty_output>`,
+        ].join('\n'), session);
+    }
+    const formattedLines = result.lines.map((line, index) => formatLine(line, result.offset + index + 1, MAX_LINE_LENGTH));
+    const paginationMessage = `(Buffer has more lines. Use offset=${result.offset + result.lines.length} to read beyond line ${result.offset + result.lines.length})`;
+    const endMessage = `(End of buffer - total ${result.totalLines} lines)`;
+    return appendSessionReminders(formatPtyOutput(args.id, session.status, undefined, formattedLines, result.hasMore, paginationMessage, endMessage), session);
+}
+/**
+ * Formats a single line with line number and truncation
+ */
+function validateRegex(pattern) {
+    try {
+        new RegExp(pattern);
+        // Check for potentially dangerous patterns that can cause exponential backtracking
+        // This is a basic check - more sophisticated validation could be added
+        const dangerousPatterns = [
+            /\(\?:.*\)\*.*\(\?:.*\)\*/, // nested optional groups with repetition
+            /.*\(\.\*\?\)\{2,\}.*/, // overlapping non-greedy quantifiers
+            /.*\(.*\|.*\)\{3,\}.*/, // complex alternation with repetition
+        ];
+        return !dangerousPatterns.some((dangerous) => dangerous.test(pattern));
+    }
+    catch {
+        return false;
+    }
+}
+export const ptyRead = tool({
+    description: DESCRIPTION,
+    args: {
+        id: tool.schema.string().describe('The PTY session ID (e.g., pty_a1b2c3d4)'),
+        offset: tool.schema
+            .number()
+            .optional()
+            .describe('Line number to start reading from (0-based, defaults to 0). When using pattern, this applies to filtered matches.'),
+        limit: tool.schema
+            .number()
+            .optional()
+            .describe('Number of lines to read (defaults to 500). When using pattern, this applies to filtered matches.'),
+        pattern: tool.schema
+            .string()
+            .optional()
+            .describe('Regex pattern to filter lines. When set, only matching lines are returned, then offset/limit apply to the matches.'),
+        ignoreCase: tool.schema
+            .boolean()
+            .optional()
+            .describe('Case-insensitive pattern matching (default: false)'),
+    },
+    async execute(args) {
+        const session = manager.get(args.id);
+        if (!session) {
+            throw buildSessionNotFoundError(args.id);
+        }
+        const offset = args.offset ?? 0;
+        const limit = args.limit ?? DEFAULT_READ_LIMIT;
+        if (args.pattern) {
+            return handlePatternRead(args.id, args.pattern, args.ignoreCase, session, offset, limit);
+        }
+        else {
+            return handlePlainRead(args, session, offset, limit);
+        }
+    },
+});
+//# sourceMappingURL=read.js.map

package/dist/src/plugin/pty/tools/read.js.map

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

package/dist/src/plugin/pty/tools/read.txt

@@ -0,0 +1,39 @@
+Reads output from a PTY session's buffer.
+
+The PTY maintains a rolling buffer of output lines. Use offset and limit to paginate through the output, similar to reading a file.
+
+Usage:
+- `id`: The PTY session ID (from pty_spawn or pty_list)
+- `offset`: Line number to start reading from (0-based, defaults to 0)
+- `limit`: Number of lines to read (defaults to 500)
+- `pattern`: Regex pattern to filter lines (optional)
+- `ignoreCase`: Case-insensitive pattern matching (default: false)
+
+Returns:
+- Numbered lines of output (similar to cat -n format)
+- Total line count in the buffer
+- Indicator if more lines are available
+
+The buffer stores up to PTY_MAX_BUFFER_LINES (default: 50000) lines. Older lines are discarded when the limit is reached.
+
+Pattern Filtering:
+- When `pattern` is set, lines are FILTERED FIRST using the regex, then offset/limit apply to the MATCHES
+- Original line numbers are preserved so you can see where matches occurred in the buffer
+- Supports full regex syntax (e.g., "error", "ERROR|WARN", "failed.*connection", etc.)
+- If the pattern is invalid, an error message is returned explaining the issue
+- If no lines match the pattern, a clear message indicates zero matches
+
+Tips:
+- To see the latest output, use a high offset or omit offset to read from the start
+- To tail recent output, calculate offset as (totalLines - N) where N is how many recent lines you want
+- Lines longer than 2000 characters are truncated
+- Empty output may mean the process hasn't produced output yet
+- If the session was started with `notifyOnExit=true`, do not use repeated `pty_read` calls only to detect completion; wait for the future `<pty_exited>` message instead
+
+Examples:
+- Read first 100 lines: offset=0, limit=100
+- Read lines 500-600: offset=500, limit=100
+- Read all available: omit both parameters
+- Find errors: pattern="error", ignoreCase=true
+- Find specific log levels: pattern="ERROR|WARN|FATAL"
+- First 10 matches only: pattern="error", limit=10

package/dist/src/plugin/pty/tools/spawn.d.ts

@@ -0,0 +1,24 @@
+export declare const ptySpawn: {
+    description: string;
+    args: {
+        command: import("zod").ZodString;
+        args: import("zod").ZodArray<import("zod").ZodString>;
+        workdir: import("zod").ZodOptional<import("zod").ZodString>;
+        env: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        title: import("zod").ZodOptional<import("zod").ZodString>;
+        description: import("zod").ZodString;
+        notifyOnExit: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        timeoutSeconds: import("zod").ZodNumber;
+    };
+    execute(args: {
+        command: string;
+        args: string[];
+        description: string;
+        timeoutSeconds: number;
+        workdir?: string | undefined;
+        env?: Record<string, string> | undefined;
+        title?: string | undefined;
+        notifyOnExit?: boolean | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+//# sourceMappingURL=spawn.d.ts.map

package/dist/src/plugin/pty/tools/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/pty/tools/spawn.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;CA+DnB,CAAA"}

package/dist/src/plugin/pty/tools/spawn.js

@@ -0,0 +1,75 @@
+import { tool } from '@opencode-ai/plugin';
+import { manager } from "../manager.js";
+import { checkWorkdirPermission } from "../permissions.js";
+import DESCRIPTION from './spawn.txt';
+const NOTIFY_ON_EXIT_INSTRUCTIONS = [
+    `<system_reminder>`,
+    `Completion signal for this session is the future \`<pty_exited>\` message.`,
+    `If you only need to know whether the command finished, do not call \`pty_read\`; wait for \`<pty_exited>\`.`,
+    `Never use sleep plus \`pty_read\` loops to check completion for this session.`,
+    `Call \`pty_read\` before exit only if you need live output now, the user explicitly asks for logs, or the exit notification reports a non-zero status and you need to investigate.`,
+    `</system_reminder>`,
+].join('\n');
+function requireTimeoutSeconds(timeoutSeconds) {
+    if (!Number.isInteger(timeoutSeconds) || timeoutSeconds <= 0) {
+        throw new Error('timeoutSeconds must be a positive integer in seconds');
+    }
+    return timeoutSeconds;
+}
+export const ptySpawn = tool({
+    description: DESCRIPTION,
+    args: {
+        command: tool.schema.string().describe('The command/executable to run'),
+        args: tool.schema.array(tool.schema.string()).describe('Arguments to pass to the command'),
+        workdir: tool.schema.string().optional().describe('Working directory for the PTY session'),
+        env: tool.schema
+            .record(tool.schema.string(), tool.schema.string())
+            .optional()
+            .describe('Additional environment variables'),
+        title: tool.schema.string().optional().describe('Human-readable title for the session'),
+        description: tool.schema
+            .string()
+            .describe('Clear, concise description of what this PTY session is for in 5-10 words'),
+        notifyOnExit: tool.schema
+            .boolean()
+            .optional()
+            .describe('If true, sends a notification to the session when the process exits (default: false)'),
+        timeoutSeconds: tool.schema
+            .number()
+            .describe('Required positive integer timeout in seconds. The PTY is killed automatically when this duration elapses.'),
+    },
+    async execute(args, ctx) {
+        const timeoutSeconds = requireTimeoutSeconds(args.timeoutSeconds);
+        if (args.workdir) {
+            await checkWorkdirPermission(args.workdir);
+        }
+        const sessionId = ctx.sessionID;
+        const info = manager.spawn({
+            command: args.command,
+            args: args.args,
+            workdir: args.workdir,
+            env: args.env,
+            title: args.title,
+            description: args.description,
+            parentSessionId: sessionId,
+            parentAgent: ctx.agent,
+            notifyOnExit: args.notifyOnExit,
+            timeoutSeconds,
+        });
+        const output = [
+            `<pty_spawned>`,
+            `ID: ${info.id}`,
+            `Title: ${info.title}`,
+            `Command: ${info.command} ${info.args.join(' ')}`,
+            `Workdir: ${info.workdir}`,
+            `PID: ${info.pid}`,
+            `Status: ${info.status}`,
+            `NotifyOnExit: ${info.notifyOnExit}`,
+            `TimeoutSeconds: ${info.timeoutSeconds}`,
+            `</pty_spawned>`,
+            ...(info.notifyOnExit ? ['', NOTIFY_ON_EXIT_INSTRUCTIONS] : []),
+        ].join('\n');
+        return output;
+    },
+});
+//# sourceMappingURL=spawn.js.map

package/dist/src/plugin/pty/tools/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../../../../src/plugin/pty/tools/spawn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,WAAW,MAAM,aAAa,CAAA;AAErC,MAAM,2BAA2B,GAAG;IAClC,mBAAmB;IACnB,4EAA4E;IAC5E,6GAA6G;IAC7G,+EAA+E;IAC/E,oLAAoL;IACpL,oBAAoB;CACrB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAEZ,SAAS,qBAAqB,CAAC,cAAsB;IACnD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;IACzE,CAAC;IAED,OAAO,cAAc,CAAA;AACvB,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,WAAW;IACxB,IAAI,EAAE;QACJ,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QACvE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QAC1F,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QAC1F,GAAG,EAAE,IAAI,CAAC,MAAM;aACb,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;aAClD,QAAQ,EAAE;aACV,QAAQ,CAAC,kCAAkC,CAAC;QAC/C,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QACvF,WAAW,EAAE,IAAI,CAAC,MAAM;aACrB,MAAM,EAAE;aACR,QAAQ,CAAC,0EAA0E,CAAC;QACvF,YAAY,EAAE,IAAI,CAAC,MAAM;aACtB,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CACP,sFAAsF,CACvF;QACH,cAAc,EAAE,IAAI,CAAC,MAAM;aACxB,MAAM,EAAE;aACR,QAAQ,CACP,2GAA2G,CAC5G;KACJ;IACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;QACrB,MAAM,cAAc,GAAG,qBAAqB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QAEjE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC5C,CAAC;QAED,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAA;QAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,eAAe,EAAE,SAAS;YAC1B,WAAW,EAAE,GAAG,CAAC,KAAK;YACtB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,cAAc;SACf,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG;YACb,eAAe;YACf,OAAO,IAAI,CAAC,EAAE,EAAE;YAChB,UAAU,IAAI,CAAC,KAAK,EAAE;YACtB,YAAY,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YACjD,YAAY,IAAI,CAAC,OAAO,EAAE;YAC1B,QAAQ,IAAI,CAAC,GAAG,EAAE;YAClB,WAAW,IAAI,CAAC,MAAM,EAAE;YACxB,iBAAiB,IAAI,CAAC,YAAY,EAAE;YACpC,mBAAmB,IAAI,CAAC,cAAc,EAAE;YACxC,gBAAgB;YAChB,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,2BAA2B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAChE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEZ,OAAO,MAAM,CAAA;IACf,CAAC;CACF,CAAC,CAAA"}

package/dist/src/plugin/pty/tools/spawn.txt

@@ -0,0 +1,52 @@
+Spawns a new interactive PTY (pseudo-terminal) session that runs in the background.
+
+Unlike the built-in bash tool which runs commands synchronously and waits for completion, PTY sessions persist and allow you to:
+- Run long-running processes (dev servers, watch modes, etc.)
+- Send interactive input (including Ctrl+C, arrow keys, etc.)
+- Read output at any time
+- Manage multiple concurrent terminal sessions
+
+Usage:
+- The `command` parameter is required (e.g., "npm", "python", "bash")
+- Use `args` to pass arguments to the command (e.g., ["run", "dev"])
+- Use `workdir` to set the working directory (defaults to project root)
+- Use `env` to set additional environment variables
+- Use `title` to give the session a human-readable name
+- The `description` parameter is required: a clear, concise 5-10 word description
+- Use `notifyOnExit` to receive a notification when the process exits (default: false)
+- Set `timeoutSeconds` on every spawn. It is required and must be a positive integer.
+- Use a long but finite timeout for sessions that are meant to keep running, such as dev servers, watch modes, local APIs, or REPLs.
+- Prefer a timeout that matches the expected wall-clock budget for builds, unit test suites, end-to-end tests, migrations, or other commands where you are waiting for a result.
+
+Returns the session info including:
+- `id`: Unique identifier (pty_XXXXXXXX) for use with other pty_* tools
+- `pid`: Process ID
+- `status`: Current status ("running")
+
+After spawning, use:
+- `pty_write` to send input to the PTY
+- `pty_read` to read output from the PTY
+- `pty_list` to see all active PTY sessions
+- `pty_kill` to terminate the PTY
+
+Exit Notifications:
+When `notifyOnExit` is true, you will receive a message when the process exits containing:
+- Session ID and title
+- Exit code
+- Total output lines
+- Last line of output (truncated to 250 chars)
+
+This is useful for long-running processes where you want to be notified when they complete
+instead of polling with `pty_read`.
+- Completion signal is the future `<pty_exited>` message
+- If you only need to know whether the command finished, do not call `pty_read`; wait for `<pty_exited>`
+- Never use sleep plus `pty_read` loops to check completion
+- Use `pty_read` before exit only if you need live output now, the user explicitly asks for logs, or the exit notification reports a non-zero status and you need to investigate
+
+Examples:
+- Start a dev server: command="npm", args=["run", "dev"], title="Dev Server"
+- Start a timed dev server when explicitly requested: command="npm", args=["run", "dev"], title="Dev Server", timeoutSeconds=600
+- Start a Python REPL: command="python3", title="Python REPL"
+- Run tests in watch mode: command="npm", args=["test", "--", "--watch"]
+- Run build with notification and timeout: command="npm", args=["run", "build"], title="Build", notifyOnExit=true, timeoutSeconds=900
+- Run end-to-end tests with timeout: command="npm", args=["run", "test:e2e"], title="E2E Tests", notifyOnExit=true, timeoutSeconds=1800

package/dist/src/plugin/pty/tools/write.d.ts

@@ -0,0 +1,12 @@
+export declare const ptyWrite: {
+    description: string;
+    args: {
+        id: import("zod").ZodString;
+        data: import("zod").ZodString;
+    };
+    execute(args: {
+        id: string;
+        data: string;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+//# sourceMappingURL=write.d.ts.map

package/dist/src/plugin/pty/tools/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/pty/tools/write.ts"],"names":[],"mappings":"AAmCA,eAAO,MAAM,QAAQ;;;;;;;;;;CAgCnB,CAAA"}

package/dist/src/plugin/pty/tools/write.js

@@ -0,0 +1,62 @@
+import { tool } from '@opencode-ai/plugin';
+import { manager } from "../manager.js";
+import { buildSessionNotFoundError } from "../utils.js";
+import DESCRIPTION from './write.txt';
+const ETX = String.fromCharCode(3);
+const EOT = String.fromCharCode(4);
+/**
+ * Parse escape sequences in a string to their actual byte values.
+ * Handles: \n, \r, \t, \xNN (hex), \uNNNN (unicode), \\
+ */
+function parseEscapeSequences(input) {
+    return input.replace(/\\(x[0-9A-Fa-f]{2}|u[0-9A-Fa-f]{4}|[nrt\\])/g, (match, seq) => {
+        if (seq.startsWith('x')) {
+            return String.fromCharCode(parseInt(seq.slice(1), 16));
+        }
+        if (seq.startsWith('u')) {
+            return String.fromCharCode(parseInt(seq.slice(1), 16));
+        }
+        switch (seq) {
+            case 'n':
+                return '\n';
+            case 'r':
+                return '\r';
+            case 't':
+                return '\t';
+            case '\\':
+                return '\\';
+            default:
+                return match;
+        }
+    });
+}
+export const ptyWrite = tool({
+    description: DESCRIPTION,
+    args: {
+        id: tool.schema.string().describe('The PTY session ID (e.g., pty_a1b2c3d4)'),
+        data: tool.schema.string().describe('The input data to send to the PTY'),
+    },
+    async execute(args) {
+        const session = manager.get(args.id);
+        if (!session) {
+            throw buildSessionNotFoundError(args.id);
+        }
+        if (session.status !== 'running') {
+            throw new Error(`Cannot write to PTY '${args.id}' - session status is '${session.status}'.`);
+        }
+        // Parse escape sequences to actual bytes
+        const parsedData = parseEscapeSequences(args.data);
+        const success = manager.write(args.id, parsedData);
+        if (!success) {
+            throw new Error(`Failed to write to PTY '${args.id}'.`);
+        }
+        const preview = args.data.length > 50 ? `${args.data.slice(0, 50)}...` : args.data;
+        const displayPreview = preview
+            .replace(new RegExp(ETX, 'g'), '^C')
+            .replace(new RegExp(EOT, 'g'), '^D')
+            .replace(/\n/g, '\\n')
+            .replace(/\r/g, '\\r');
+        return `Sent ${args.data.length} bytes to ${args.id}: "${displayPreview}"`;
+    },
+});
+//# sourceMappingURL=write.js.map

package/dist/src/plugin/pty/tools/write.js.map

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