CommandCodeAI / CommandCodeAI/command-code

feat: Allow mods to spawn and await background agents / background work

Đang mở
#691 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Ngôn ngữ chính
Không có dữ liệu ngôn ngữ
Star
4k
Fork
350
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

Mô tả

Feature Description

Summary

Mods currently have no way to run work in the background. The agent tool (with run_in_background: true), background agents (background: true), and background shell tasks are all seams the main agent drives — none are reachable from a mod. Mods only have cmd.exec (foreground shell) and the synchronous onStop + prepareNextTurn force-continue seam for post-run model turns.

Motivation

Post-run maintenance work — summarization, extraction, knowledge discovery, compaction — is exactly the kind of task that should run detached from the main loop, on a cheap model, without blocking or polluting the session. Today a mod that wants a model to do post-run work must inject a continuation turn (onStop with {continue: true}) that runs in-line: it occupies the same run, renders in the feed, and competes with sibling mods over the single continuation slot (harness short-circuits "any mod returning continue wins").

Alternatives considered
  • Keep the onStop continuation seam and just make the injected turn quieter. Doesn't solve the collision problem (one continuation slot shared by all
    mods) or the "detached from the run" goal.
  • Background shell + cmd.events polling. Mods could shell out to cmd -p via a background process, but there's no background cmd.exec, and reacting to
    completion would require polling from a hook — no clean completion signal.

Acceptance criteria

  • A mod can launch a background agent and continue the session without blocking.
  • The spawning mod is notified (hook or event) when the agent completes, with the agent's final result.
  • The behavior is observable in the TUI Background panel (Ctrl+B) like other background work.
  • Works headless (-p), degrading deterministically.
Use Case
Mods am building or trying out that could use background running
  • Memory/journal mods that extract compressed episodes or discover durable facts from a finished run (e.g. the project-brain / task-journal pattern).

  • Any mod wanting to fan out parallel investigation or run a long background process and react when it completes.
    Current gap

  • No cmd.agent(...) / cmd.spawnAgent(...) equivalent on ModApi — a mod cannot launch the built-in agent tool or a custom agent.

  • No background variant of cmd.exec (no way to get a task id + log + wake-up like shell_command run_in_background / monitor_command).

  • No hook or event a mod can register to be notified when a background agent it spawned finishes (the result of agent_output never reaches a mod).

Proposed API (suggestion — open to design)

Something like:

  • cmd.agent({prompt, agent?, model?, runInBackground: true}) → Promise<{agentId}> — spawn a background agent from a mod.
  • A completion hook or event, e.g. cmd.hooks({onAgentResult}) or cmd.events.on('agent_completed', ...), delivering the agent's final result to the
    spawning mod.
  • Optionally: a background cmd.exec variant returning a task id + on-disk log, mirroring shell_command run_in_background.
Additional Context
  • Sort of how taste learning works to be honest
How important is this to you?

Medium. Nice mod improvements for UX, but right now these are experiments and sync running is ok.

Hướng dẫn đóng góp

Chưa lập chỉ mục được hướng dẫn đóng góp cho kho mã nguồn này

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Hướng nghiên cứu

Bắt đầu bằng cách lần theo bề mặt ModApi cmd.exec hiện có và các điểm giao giữa agent, background-agent và background-shell được mô tả trong issue. So sánh hành vi của chúng với TUI Background panel (Ctrl+B) và chế độ headless (-p). Được xem là hoàn tất khi một mod có thể khởi chạy công việc mà không bị chặn, nhận kết quả cuối cùng khi hoàn tất, hiển thị kết quả đó trong background panel và suy giảm một cách tất định trong chế độ headless.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Lĩnh vực
api, backend, cli
Loại issue
Tính năng
Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức độ hoạt động
Ít trao đổi
Độ rõ ràng
Khá rõ ràng
Mức phù hợp với người mới
35/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.