plugins/_code_execution/AGENTS.md

Code Execution Plugin DOX

Purpose

• Own terminal, Python, and Node.js code execution through persistent local or SSH-backed sessions.

Ownership

• tools/ owns the code execution and input tools.
• helpers/ owns local shell, SSH shell, and TTY session management.
• prompts/ owns execution prompt and runtime response fragments.
• default_config.yaml, plugin.yaml, extensions/, and webui/ own settings, metadata, hooks, and UI config.

Local Contracts

• Keep session concurrency, timeout, streaming, and reset behavior predictable.
• Execute multi-line terminal input as one current-shell compound so intermediate prompts cannot mark queued work complete; preserve cd, exports, and other shell state.
• Treat local process exit and SSH channel termination as definitive command completion even when no final prompt is emitted; recreate terminated sessions before their next command.
• Terminal reset/close must not hang on foreground commands or shells that ignore SIGTERM.
• Local and SSH session wrappers must synchronously release their owned process or connection resources when discarded.
• Explicitly target local versus SSH execution runtimes.
• Do not hardcode secrets, SSH credentials, or local user paths.

Work Guidance

• Preserve long-running command output retrieval and busy-session guards when changing execution flow.

Verification

• Smoke-test terminal, Python, Node.js, output polling, and reset paths after tool changes.

Child DOX Index

No child DOX files.