agent-exec：为AI代理工作流设计的结构化任务运行器

agent-exec是一个用Rust编写的非交互式任务运行器，专为AI代理工作流设计。它将命令作为后台作业运行，并以结构化JSON格式返回结果，解决了AI代理执行外部命令时面临的输出解析、超时控制、错误处理等常见难题。核心特性包括默认10秒超时机制、stdout/stderr分离、持久化日志存储、完整的命令生命周期管理（即时/延迟执行、状态查询、终止控制）等，秉持代理优先的设计理念。

AI代理执行外部命令时，传统方式存在诸多问题：shell输出格式不统一需复杂解析、长任务阻塞会话、错误信息混杂在stderr、超时与信号处理需手动实现。这些问题消耗大量上下文窗口资源，影响代理核心逻辑运行，agent-exec正是为解决这些痛点而生。

agent-exec的核心设计围绕合理默认设置：默认10秒超时（避免会话劫持、快速暴露启动失败）、stdout仅输出结构化JSON（stderr用于诊断日志）、持久化日志到文件（响应含路径和摘要）。命令生命周期支持两种模式：1. 即时执行（run）：一步到位，返回含job_id、状态、输出范围的JSON；2. 延迟执行（create+start）：先定义任务再启动，适用于批量场景。此外提供status（查询状态）、tail（流式输出）、wait（阻塞等待）、kill（终止任务）等功能。

agent-exec提供精细超时与信号处理：支持分级终止（如--timeout 5发送SIGTERM，--kill-after 2发送SIGKILL）。环境管理兼顾安全：--env设置变量、--env-file从文件读取（避免敏感信息入版本控制）、--mask隐藏敏感参数。与shell协作时，简单命令直接执行，需shell特性（管道/重定向）时显式用shell包装（如sh -lc ...），避免注入风险。

agent-exec适用于自动化工作流（CI/CD、定时任务）、AI代理集成（工具调用、代码运行）、长时间任务（模型训练、数据迁移）、多步骤编排（部署流程、测试矩阵）。技术上，Rust实现保证内存与并发安全，Result模式处理错误，schema_version设计确保向前兼容性。

与传统工具相比，agent-exec轻量且专注单次任务执行（区别于systemd/supervisord的长期服务管理），提供完整生命周期管理与结构化输出（优于timeout/nohup）。它填补了AI代理生态中可靠任务执行层的空白，是AI代理开发者的实用组件——Rust保证性能与可靠性，简洁JSON接口降低集成复杂度，代理优先设计确保实用性。