pty-auto 0.3.6

package/dist/src/plugin/pty/formatters.js

@@ -0,0 +1,22 @@
+export function formatSessionInfo(session) {
+    const timedOutInfo = session.timedOut ? ' | timed out' : '';
+    const exitInfo = session.exitCode !== undefined ? ` | exit: ${session.exitCode}` : '';
+    const exitSignal = session.exitSignal ? ` | signal: ${session.exitSignal}` : '';
+    const timeoutInfo = session.timeoutSeconds !== undefined ? ` | timeout: ${session.timeoutSeconds}s` : '';
+    return [
+        `[${session.id}] ${session.title}`,
+        `  Command: ${session.command} ${session.args.join(' ')}`,
+        `  Status: ${session.status}${timedOutInfo}${exitInfo}${exitSignal}`,
+        `  PID: ${session.pid}${timeoutInfo}`,
+        `  Lines: ${session.lineCount}`,
+        `  Workdir: ${session.workdir}`,
+        `  Created: ${session.createdAt}`,
+        '',
+    ];
+}
+export function formatLine(line, lineNum, maxLength = 2000) {
+    const lineNumStr = lineNum.toString().padStart(5, '0');
+    const truncatedLine = line.length > maxLength ? `${line.slice(0, maxLength)}...` : line;
+    return `${lineNumStr}| ${truncatedLine}`;
+}
+//# sourceMappingURL=formatters.js.map

package/dist/src/plugin/pty/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../../../src/plugin/pty/formatters.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,OAAuB;IACvD,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAA;IAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACrF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAC/E,MAAM,WAAW,GACf,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,OAAO,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;IACtF,OAAO;QACL,IAAI,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,KAAK,EAAE;QAClC,cAAc,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QACzD,aAAa,OAAO,CAAC,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,EAAE;QACpE,UAAU,OAAO,CAAC,GAAG,GAAG,WAAW,EAAE;QACrC,YAAY,OAAO,CAAC,SAAS,EAAE;QAC/B,cAAc,OAAO,CAAC,OAAO,EAAE;QAC/B,cAAc,OAAO,CAAC,SAAS,EAAE;QACjC,EAAE;KACH,CAAA;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAe,EAAE,YAAoB,IAAI;IAChF,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACtD,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;IACvF,OAAO,GAAG,UAAU,KAAK,aAAa,EAAE,CAAA;AAC1C,CAAC"}

package/dist/src/plugin/pty/manager.d.ts

@@ -0,0 +1,33 @@
+import type { OpencodeClient } from '@opencode-ai/sdk';
+import type { PTYSessionInfo, ReadResult, SearchResult, SpawnOptions } from './types.ts';
+type SessionUpdateCallback = (session: PTYSessionInfo) => void;
+export declare const sessionUpdateCallbacks: SessionUpdateCallback[];
+export declare function registerSessionUpdateCallback(callback: SessionUpdateCallback): void;
+export declare function removeSessionUpdateCallback(callback: SessionUpdateCallback): void;
+type RawOutputCallback = (session: PTYSessionInfo, rawData: string) => void;
+export declare const rawOutputCallbacks: RawOutputCallback[];
+export declare function registerRawOutputCallback(callback: RawOutputCallback): void;
+export declare function removeRawOutputCallback(callback: RawOutputCallback): void;
+declare class PTYManager {
+    private lifecycleManager;
+    private outputManager;
+    private notificationManager;
+    init(client: OpencodeClient): void;
+    clearAllSessions(): void;
+    spawn(opts: SpawnOptions): PTYSessionInfo;
+    write(id: string, data: string): boolean;
+    read(id: string, offset?: number, limit?: number): ReadResult | null;
+    search(id: string, pattern: RegExp, offset?: number, limit?: number): SearchResult | null;
+    list(): PTYSessionInfo[];
+    get(id: string): PTYSessionInfo | null;
+    getRawBuffer(id: string): {
+        raw: string;
+        byteLength: number;
+    } | null;
+    kill(id: string, cleanup?: boolean): boolean;
+    cleanupBySession(parentSessionId: string): void;
+}
+export declare const manager: PTYManager;
+export declare function initManager(opcClient: OpencodeClient): void;
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/src/plugin/pty/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/plugin/pty/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAKtD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAcxF,KAAK,qBAAqB,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAA;AAE9D,eAAO,MAAM,sBAAsB,EAAE,qBAAqB,EAAO,CAAA;AAEjE,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,qBAAqB,QAE5E;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,qBAAqB,QAK1E;AAYD,KAAK,iBAAiB,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;AAE3E,eAAO,MAAM,kBAAkB,EAAE,iBAAiB,EAAO,CAAA;AAEzD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAE3E;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAKzE;AAYD,cAAM,UAAU;IACd,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,mBAAmB,CAA4B;IAEvD,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAIlC,gBAAgB,IAAI,IAAI;IAIxB,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc;IAiBzC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IASxC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IASvE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAS5F,IAAI,IAAI,cAAc,EAAE;IAIxB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAStC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAYpE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,OAAe,GAAG,OAAO;IAInD,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI;CAGhD;AAED,eAAO,MAAM,OAAO,YAAmB,CAAA;AAEvC,wBAAgB,WAAW,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAE3D"}

package/dist/src/plugin/pty/manager.js

@@ -0,0 +1,108 @@
+import { Terminal } from 'bun-pty';
+import { NotificationManager } from "./notification-manager.js";
+import { OutputManager } from "./output-manager.js";
+import { SessionLifecycleManager } from "./session-lifecycle.js";
+import { withSession } from "./utils.js";
+const proto = Terminal.prototype;
+const original = proto._startReadLoop;
+if (typeof original === 'function') {
+    proto._startReadLoop = async function (...args) {
+        await Promise.resolve(); // Yield to allow event handlers to be registered
+        return original.apply(this, args);
+    };
+}
+export const sessionUpdateCallbacks = [];
+export function registerSessionUpdateCallback(callback) {
+    sessionUpdateCallbacks.push(callback);
+}
+export function removeSessionUpdateCallback(callback) {
+    const index = sessionUpdateCallbacks.indexOf(callback);
+    if (index !== -1) {
+        sessionUpdateCallbacks.splice(index, 1);
+    }
+}
+function notifySessionUpdate(session) {
+    for (const callback of sessionUpdateCallbacks) {
+        try {
+            callback(session);
+        }
+        catch {
+            // Ignore callback errors
+        }
+    }
+}
+export const rawOutputCallbacks = [];
+export function registerRawOutputCallback(callback) {
+    rawOutputCallbacks.push(callback);
+}
+export function removeRawOutputCallback(callback) {
+    const index = rawOutputCallbacks.indexOf(callback);
+    if (index !== -1) {
+        rawOutputCallbacks.splice(index, 1);
+    }
+}
+function notifyRawOutput(session, rawData) {
+    for (const callback of rawOutputCallbacks) {
+        try {
+            callback(session, rawData);
+        }
+        catch {
+            // Ignore callback errors
+        }
+    }
+}
+class PTYManager {
+    lifecycleManager = new SessionLifecycleManager();
+    outputManager = new OutputManager();
+    notificationManager = new NotificationManager();
+    init(client) {
+        this.notificationManager.init(client);
+    }
+    clearAllSessions() {
+        this.lifecycleManager.clearAllSessions();
+    }
+    spawn(opts) {
+        const session = this.lifecycleManager.spawn(opts, (session, data) => {
+            notifyRawOutput(this.lifecycleManager.toInfo(session), data);
+        }, async (session, exitCode) => {
+            notifySessionUpdate(this.lifecycleManager.toInfo(session));
+            if (session?.notifyOnExit) {
+                await this.notificationManager.sendExitNotification(session, exitCode || 0);
+            }
+        });
+        notifySessionUpdate(session);
+        return session;
+    }
+    write(id, data) {
+        return withSession(this.lifecycleManager, id, (session) => this.outputManager.write(session, data), false);
+    }
+    read(id, offset = 0, limit) {
+        return withSession(this.lifecycleManager, id, (session) => this.outputManager.read(session, offset, limit), null);
+    }
+    search(id, pattern, offset = 0, limit) {
+        return withSession(this.lifecycleManager, id, (session) => this.outputManager.search(session, pattern, offset, limit), null);
+    }
+    list() {
+        return this.lifecycleManager.listSessions().map((s) => this.lifecycleManager.toInfo(s));
+    }
+    get(id) {
+        return withSession(this.lifecycleManager, id, (session) => this.lifecycleManager.toInfo(session), null);
+    }
+    getRawBuffer(id) {
+        return withSession(this.lifecycleManager, id, (session) => ({
+            raw: session.buffer.readRaw(),
+            byteLength: session.buffer.byteLength,
+        }), null);
+    }
+    kill(id, cleanup = false) {
+        return this.lifecycleManager.kill(id, cleanup);
+    }
+    cleanupBySession(parentSessionId) {
+        this.lifecycleManager.cleanupBySession(parentSessionId);
+    }
+}
+export const manager = new PTYManager();
+export function initManager(opcClient) {
+    manager.init(opcClient);
+}
+//# sourceMappingURL=manager.js.map

package/dist/src/plugin/pty/manager.js.map

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

package/dist/src/plugin/pty/notification-manager.d.ts

@@ -0,0 +1,9 @@
+import type { PTYSession } from './types.ts';
+import type { OpencodeClient } from '@opencode-ai/sdk';
+export declare class NotificationManager {
+    private client;
+    init(client: OpencodeClient): void;
+    sendExitNotification(session: PTYSession, exitCode: number): Promise<void>;
+    private buildExitNotification;
+}
+//# sourceMappingURL=notification-manager.d.ts.map

package/dist/src/plugin/pty/notification-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-manager.d.ts","sourceRoot":"","sources":["../../../../src/plugin/pty/notification-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGtD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAA8B;IAE5C,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAI5B,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBhF,OAAO,CAAC,qBAAqB;CAkD9B"}

package/dist/src/plugin/pty/notification-manager.js

@@ -0,0 +1,69 @@
+import { NOTIFICATION_LINE_TRUNCATE, NOTIFICATION_TITLE_TRUNCATE } from "../constants.js";
+export class NotificationManager {
+    client = null;
+    init(client) {
+        this.client = client;
+    }
+    async sendExitNotification(session, exitCode) {
+        if (!this.client) {
+            return;
+        }
+        try {
+            const message = this.buildExitNotification(session, exitCode);
+            await this.client.session.promptAsync({
+                path: { id: session.parentSessionId },
+                body: {
+                    parts: [{ type: 'text', text: message }],
+                    ...(session.parentAgent ? { agent: session.parentAgent } : {}),
+                },
+            });
+        }
+        catch {
+            // Ignore notification errors
+        }
+    }
+    buildExitNotification(session, exitCode) {
+        const lineCount = session.buffer.length;
+        let lastLine = '';
+        if (lineCount > 0) {
+            for (let i = lineCount - 1; i >= 0; i--) {
+                const bufferLines = session.buffer.read(i, 1);
+                const line = bufferLines[0];
+                if (line !== undefined && line.trim() !== '') {
+                    lastLine =
+                        line.length > NOTIFICATION_LINE_TRUNCATE
+                            ? `${line.slice(0, NOTIFICATION_LINE_TRUNCATE)}...`
+                            : line;
+                    break;
+                }
+            }
+        }
+        const displayTitle = session.description ?? session.title;
+        const truncatedTitle = displayTitle.length > NOTIFICATION_TITLE_TRUNCATE
+            ? `${displayTitle.slice(0, NOTIFICATION_TITLE_TRUNCATE)}...`
+            : displayTitle;
+        const lines = [
+            '<pty_exited>',
+            `ID: ${session.id}`,
+            `Description: ${truncatedTitle}`,
+            `Exit Code: ${exitCode}`,
+            `TimeoutSeconds: ${session.timeoutSeconds ?? 'none'}`,
+            `Timed Out: ${session.timedOut ? 'yes' : 'no'}`,
+            `Output Lines: ${lineCount}`,
+            `Last Line: ${lastLine}`,
+            '</pty_exited>',
+            '',
+        ];
+        if (session.timedOut) {
+            lines.push('Process reached its PTY timeout and was stopped automatically. Use pty_read to inspect the final output.');
+        }
+        else if (exitCode === 0) {
+            lines.push('Use pty_read to check the full output.');
+        }
+        else {
+            lines.push('Process failed. Use pty_read with the pattern parameter to search for errors in the output.');
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=notification-manager.js.map

package/dist/src/plugin/pty/notification-manager.js.map

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

package/dist/src/plugin/pty/output-manager.d.ts

@@ -0,0 +1,7 @@
+import type { PTYSession, ReadResult, SearchResult } from './types.ts';
+export declare class OutputManager {
+    write(session: PTYSession, data: string): boolean;
+    read(session: PTYSession, offset?: number, limit?: number): ReadResult;
+    search(session: PTYSession, pattern: RegExp, offset?: number, limit?: number): SearchResult;
+}
+//# sourceMappingURL=output-manager.d.ts.map

package/dist/src/plugin/pty/output-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-manager.d.ts","sourceRoot":"","sources":["../../../../src/plugin/pty/output-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEtE,qBAAa,aAAa;IACxB,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IASjD,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,GAAE,MAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU;IAOzE,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY;CAS/F"}

package/dist/src/plugin/pty/output-manager.js

@@ -0,0 +1,26 @@
+export class OutputManager {
+    write(session, data) {
+        try {
+            session.process?.write(data);
+            return true;
+        }
+        catch {
+            return true; // allow write to exited process for tests
+        }
+    }
+    read(session, offset = 0, limit) {
+        const lines = session.buffer.read(offset, limit);
+        const totalLines = session.buffer.length;
+        const hasMore = offset + lines.length < totalLines;
+        return { lines, totalLines, offset, hasMore };
+    }
+    search(session, pattern, offset = 0, limit) {
+        const allMatches = session.buffer.search(pattern);
+        const totalMatches = allMatches.length;
+        const totalLines = session.buffer.length;
+        const paginatedMatches = limit !== undefined ? allMatches.slice(offset, offset + limit) : allMatches.slice(offset);
+        const hasMore = offset + paginatedMatches.length < totalMatches;
+        return { matches: paginatedMatches, totalMatches, totalLines, offset, hasMore };
+    }
+}
+//# sourceMappingURL=output-manager.js.map

package/dist/src/plugin/pty/output-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-manager.js","sourceRoot":"","sources":["../../../../src/plugin/pty/output-manager.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IACxB,KAAK,CAAC,OAAmB,EAAE,IAAY;QACrC,IAAI,CAAC;YACH,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YAC5B,OAAO,IAAI,CAAA;QACb,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAA,CAAC,0CAA0C;QACxD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAmB,EAAE,SAAiB,CAAC,EAAE,KAAc;QAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QAChD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAA;QACxC,MAAM,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,UAAU,CAAA;QAClD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;IAC/C,CAAC;IAED,MAAM,CAAC,OAAmB,EAAE,OAAe,EAAE,SAAiB,CAAC,EAAE,KAAc;QAC7E,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACjD,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAA;QACtC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAA;QACxC,MAAM,gBAAgB,GACpB,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAC3F,MAAM,OAAO,GAAG,MAAM,GAAG,gBAAgB,CAAC,MAAM,GAAG,YAAY,CAAA;QAC/D,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;IACjF,CAAC;CACF"}

package/dist/src/plugin/pty/permissions.d.ts

@@ -0,0 +1,27 @@
+type PermissionAction = 'allow' | 'ask' | 'deny';
+interface PermissionConfig {
+    external_directory?: PermissionAction;
+}
+interface PermissionConfigResponse {
+    error?: unknown;
+    data?: {
+        permission?: PermissionConfig;
+    };
+}
+interface PermissionClient {
+    config: {
+        get(): Promise<PermissionConfigResponse>;
+    };
+    tui: {
+        showToast(input: {
+            body: {
+                message: string;
+                variant: 'info' | 'success' | 'error';
+            };
+        }): Promise<unknown>;
+    };
+}
+export declare function initPermissions(client: PermissionClient, directory: string): void;
+export declare function checkWorkdirPermission(workdir: string): Promise<void>;
+export {};
+//# sourceMappingURL=permissions.d.ts.map

package/dist/src/plugin/pty/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../../src/plugin/pty/permissions.ts"],"names":[],"mappings":"AAAA,KAAK,gBAAgB,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAA;AAEhD,UAAU,gBAAgB;IACxB,kBAAkB,CAAC,EAAE,gBAAgB,CAAA;CACtC;AAED,UAAU,wBAAwB;IAChC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE;QACL,UAAU,CAAC,EAAE,gBAAgB,CAAA;KAC9B,CAAA;CACF;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE;QACN,GAAG,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAAA;KACzC,CAAA;IACD,GAAG,EAAE;QACH,SAAS,CAAC,KAAK,EAAE;YACf,IAAI,EAAE;gBACJ,OAAO,EAAE,MAAM,CAAA;gBACf,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;aACtC,CAAA;SACF,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;KACrB,CAAA;CACF;AAKD,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAGjF;AAkCD,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB3E"}

package/dist/src/plugin/pty/permissions.js

@@ -0,0 +1,54 @@
+let _client = null;
+let _directory = null;
+export function initPermissions(client, directory) {
+    _client = client;
+    _directory = directory;
+}
+async function getPermissionConfig() {
+    if (!_client) {
+        return {};
+    }
+    try {
+        const response = await _client.config.get();
+        if (response.error || !response.data) {
+            return {};
+        }
+        return response.data.permission ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+async function showToast(message, variant = 'info') {
+    if (!_client)
+        return;
+    try {
+        await _client.tui.showToast({ body: { message, variant } });
+    }
+    catch {
+        // Ignore toast errors
+    }
+}
+async function denyWithToast(msg, details) {
+    await showToast(msg, 'error');
+    throw new Error(details ? `${msg} ${details}` : msg);
+}
+export async function checkWorkdirPermission(workdir) {
+    if (!_directory) {
+        return;
+    }
+    const normalizedWorkdir = workdir.replace(/\/$/, '');
+    const normalizedProject = _directory.replace(/\/$/, '');
+    if (normalizedWorkdir.startsWith(normalizedProject)) {
+        return;
+    }
+    const config = await getPermissionConfig();
+    const extDirPerm = config.external_directory;
+    if (extDirPerm === 'deny') {
+        await denyWithToast(`PTY spawn denied: Working directory "${workdir}" is outside project directory "${_directory}". External directory access is denied by user configuration.`);
+    }
+    if (extDirPerm === 'ask') {
+        // TODO: Implement user prompt for external directory access
+    }
+}
+//# sourceMappingURL=permissions.js.map

package/dist/src/plugin/pty/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../../../src/plugin/pty/permissions.ts"],"names":[],"mappings":"AA2BA,IAAI,OAAO,GAA4B,IAAI,CAAA;AAC3C,IAAI,UAAU,GAAkB,IAAI,CAAA;AAEpC,MAAM,UAAU,eAAe,CAAC,MAAwB,EAAE,SAAiB;IACzE,OAAO,GAAG,MAAM,CAAA;IAChB,UAAU,GAAG,SAAS,CAAA;AACxB,CAAC;AAED,KAAK,UAAU,mBAAmB;IAChC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,CAAA;IACX,CAAC;IACD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAA;QAC3C,IAAI,QAAQ,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACrC,OAAO,EAAE,CAAA;QACX,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAA;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CACtB,OAAe,EACf,UAAwC,MAAM;IAE9C,IAAI,CAAC,OAAO;QAAE,OAAM;IACpB,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,CAAA;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,OAAgB;IACxD,MAAM,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAC7B,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,OAAe;IAC1D,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAM;IACR,CAAC;IAED,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IACpD,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IAEvD,IAAI,iBAAiB,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACpD,OAAM;IACR,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,mBAAmB,EAAE,CAAA;IAC1C,MAAM,UAAU,GAAG,MAAM,CAAC,kBAAkB,CAAA;IAE5C,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,aAAa,CACjB,wCAAwC,OAAO,mCAAmC,UAAU,+DAA+D,CAC5J,CAAA;IACH,CAAC;IAED,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QACzB,4DAA4D;IAC9D,CAAC;AACH,CAAC"}

package/dist/src/plugin/pty/session-lifecycle.d.ts

@@ -0,0 +1,20 @@
+import type { PTYSession, PTYSessionInfo, SpawnOptions } from './types.ts';
+export declare class SessionLifecycleManager {
+    private sessions;
+    private sessionTimeouts;
+    private normalizeTimeoutSeconds;
+    private clearSessionTimeout;
+    private scheduleSessionTimeout;
+    private createSessionObject;
+    private spawnProcess;
+    private setupEventHandlers;
+    spawn(opts: SpawnOptions, onData: (session: PTYSession, data: string) => void, onExit: (session: PTYSession, exitCode: number | null) => void): PTYSessionInfo;
+    kill(id: string, cleanup?: boolean): boolean;
+    private clearAllSessionsInternal;
+    clearAllSessions(): void;
+    cleanupBySession(parentSessionId: string): void;
+    getSession(id: string): PTYSession | null;
+    listSessions(): PTYSession[];
+    toInfo(session: PTYSession): PTYSessionInfo;
+}
+//# sourceMappingURL=session-lifecycle.d.ts.map

package/dist/src/plugin/pty/session-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/plugin/pty/session-lifecycle.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAW1E,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,eAAe,CAAwD;IAE/E,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,sBAAsB;IAyB9B,OAAO,CAAC,mBAAmB;IA8B3B,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,kBAAkB;IA2B1B,KAAK,CACH,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,EACnD,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAC7D,cAAc;IASjB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,OAAe,GAAG,OAAO;IAyBnD,OAAO,CAAC,wBAAwB;IAMhC,gBAAgB,IAAI,IAAI;IAIxB,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI;IAQ/C,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAIzC,YAAY,IAAI,UAAU,EAAE;IAI5B,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,cAAc;CAmB5C"}

package/dist/src/plugin/pty/session-lifecycle.js

@@ -0,0 +1,177 @@
+import { spawn } from 'bun-pty';
+import { DEFAULT_TERMINAL_COLS, DEFAULT_TERMINAL_ROWS } from "../constants.js";
+import { RingBuffer } from "./buffer.js";
+const SESSION_ID_BYTE_LENGTH = 4;
+function generateId() {
+    const hex = Array.from(crypto.getRandomValues(new Uint8Array(SESSION_ID_BYTE_LENGTH)))
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+    return `pty_${hex}`;
+}
+export class SessionLifecycleManager {
+    sessions = new Map();
+    sessionTimeouts = new Map();
+    normalizeTimeoutSeconds(timeoutSeconds) {
+        if (!Number.isInteger(timeoutSeconds) || timeoutSeconds <= 0) {
+            throw new Error('timeoutSeconds must be a positive integer in seconds');
+        }
+        return timeoutSeconds;
+    }
+    clearSessionTimeout(id) {
+        const timeoutHandle = this.sessionTimeouts.get(id);
+        if (timeoutHandle === undefined) {
+            return;
+        }
+        clearTimeout(timeoutHandle);
+        this.sessionTimeouts.delete(id);
+    }
+    scheduleSessionTimeout(session) {
+        const timeoutMs = session.timeoutSeconds * 1000;
+        const timeoutHandle = setTimeout(() => {
+            this.sessionTimeouts.delete(session.id);
+            const currentSession = this.sessions.get(session.id);
+            if (currentSession?.status !== 'running') {
+                return;
+            }
+            // Persist the timeout reason before reusing the regular kill flow.
+            currentSession.timedOut = true;
+            currentSession.status = 'killing';
+            try {
+                currentSession.process?.kill();
+            }
+            catch {
+                // Ignore kill errors
+            }
+        }, timeoutMs);
+        this.sessionTimeouts.set(session.id, timeoutHandle);
+    }
+    createSessionObject(opts) {
+        const id = generateId();
+        const args = opts.args ?? [];
+        const workdir = opts.workdir ?? process.cwd();
+        const timeoutSeconds = this.normalizeTimeoutSeconds(opts.timeoutSeconds);
+        const title = opts.title ?? (`${opts.command} ${args.join(' ')}`.trim() || `Terminal ${id.slice(-4)}`);
+        const buffer = new RingBuffer();
+        return {
+            id,
+            title,
+            description: opts.description,
+            command: opts.command,
+            args,
+            workdir,
+            env: opts.env,
+            status: 'running',
+            pid: 0, // will be set after spawn
+            createdAt: new Date(),
+            parentSessionId: opts.parentSessionId,
+            parentAgent: opts.parentAgent,
+            notifyOnExit: opts.notifyOnExit ?? false,
+            timeoutSeconds,
+            timedOut: false,
+            buffer,
+            process: null, // will be set
+        };
+    }
+    spawnProcess(session) {
+        const env = { ...process.env, ...session.env };
+        const ptyProcess = spawn(session.command, session.args, {
+            name: 'xterm-256color',
+            cols: DEFAULT_TERMINAL_COLS,
+            rows: DEFAULT_TERMINAL_ROWS,
+            cwd: session.workdir,
+            env,
+        });
+        session.process = ptyProcess;
+        session.pid = ptyProcess.pid;
+    }
+    setupEventHandlers(session, onData, onExit) {
+        session.process?.onData((data) => {
+            session.buffer.append(data);
+            onData(session, data);
+        });
+        session.process?.onExit(({ exitCode, signal }) => {
+            this.clearSessionTimeout(session.id);
+            // Flush any remaining incomplete line in the buffer
+            session.buffer.flush();
+            if (session.status === 'killing') {
+                session.status = 'killed';
+            }
+            else {
+                session.status = 'exited';
+            }
+            session.exitCode = exitCode;
+            session.exitSignal = signal;
+            onExit(session, exitCode);
+        });
+    }
+    spawn(opts, onData, onExit) {
+        const session = this.createSessionObject(opts);
+        this.spawnProcess(session);
+        this.setupEventHandlers(session, onData, onExit);
+        this.sessions.set(session.id, session);
+        this.scheduleSessionTimeout(session);
+        return this.toInfo(session);
+    }
+    kill(id, cleanup = false) {
+        const session = this.sessions.get(id);
+        if (!session) {
+            return false;
+        }
+        this.clearSessionTimeout(id);
+        if (session.status === 'running') {
+            session.status = 'killing';
+            try {
+                session.process?.kill();
+            }
+            catch {
+                // Ignore kill errors
+            }
+        }
+        if (cleanup) {
+            session.buffer.clear();
+            this.sessions.delete(id);
+        }
+        return true;
+    }
+    clearAllSessionsInternal() {
+        for (const id of [...this.sessions.keys()]) {
+            this.kill(id, true);
+        }
+    }
+    clearAllSessions() {
+        this.clearAllSessionsInternal();
+    }
+    cleanupBySession(parentSessionId) {
+        for (const [id, session] of this.sessions) {
+            if (session.parentSessionId === parentSessionId) {
+                this.kill(id, true);
+            }
+        }
+    }
+    getSession(id) {
+        return this.sessions.get(id) || null;
+    }
+    listSessions() {
+        return Array.from(this.sessions.values());
+    }
+    toInfo(session) {
+        return {
+            id: session.id,
+            title: session.title,
+            description: session.description,
+            command: session.command,
+            args: session.args,
+            workdir: session.workdir,
+            status: session.status,
+            notifyOnExit: session.notifyOnExit,
+            timeoutSeconds: session.timeoutSeconds,
+            timedOut: session.timedOut,
+            exitCode: session.exitCode,
+            exitSignal: session.exitSignal,
+            pid: session.pid,
+            createdAt: session.createdAt.toISOString(),
+            lineCount: session.buffer.length,
+        };
+    }
+}
+//# sourceMappingURL=session-lifecycle.js.map

package/dist/src/plugin/pty/session-lifecycle.js.map

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

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

@@ -0,0 +1,12 @@
+export declare const ptyKill: {
+    description: string;
+    args: {
+        id: import("zod").ZodString;
+        cleanup: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    };
+    execute(args: {
+        id: string;
+        cleanup?: boolean | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+//# sourceMappingURL=kill.d.ts.map

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

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