feat(agents): add kilocode adapter

[yyovil]

Adds the kilocode harness, stacked on #119 (agent platform). Adapter package + Constructors() registration + resolver test. Includes its own activity deriver.

🤖 Generated with Claude Code

Stack

1. feat(agents): agent platform — registry, activity hooks, harness allowlist #119
2. feat(agents): add grok adapter #120
3. feat(agents): add droid adapter #121
4. feat(agents): add amp adapter #122
5. feat(agents): add agy adapter #123
6. feat(agents): add crush adapter #124
7. feat(agents): add aider adapter #125
8. feat(agents): add cursor adapter #126
9. feat(agents): add qwen adapter #127
10. feat(agents): add copilot adapter #128
11. feat(agents): add goose adapter #129
12. feat(agents): add auggie adapter #130
13. feat(agents): add continue adapter #131
14. feat(agents): add devin adapter #132
15. feat(agents): add cline adapter #133
16. feat(agents): add kimi adapter #134
17. feat(agents): add kiro adapter #135
18. feat(agents): add kilocode adapter #136 👈 current
19. feat(agents): add vibe adapter #137
20. feat(agents): add pi adapter #138
21. feat(agents): add autohand adapter #139

[greptile-apps]

Greptile Summary

Adds the kilocode agent adapter — a fork of sst/opencode — following the same two-layer bridge pattern used by the opencode adapter: an embedded TypeScript plugin installs into .kilocode/plugins/ to forward lifecycle events, and a Go adapter registers the deriver and builds launch/restore argv.

• Go adapter (kilocode.go, hooks.go, activity.go): Implements the full ports.Agent interface — binary resolution with cache, permission mode delivery via KILO_CONFIG_CONTENT env (the TUI has no --auto flag), atomic sentinel-guarded plugin install/uninstall, and a four-event activity deriver (session-start, user-prompt-submit, permission-request, stop).
• TypeScript plugin (ao-activity.ts): Bridges Kilo's native events (session.created, message.updated, message.part.updated, session.status, permission.ask) to AO hook calls via Bun.spawnSync with a 30 s timeout; includes a MESSAGE_STORE_MAX = 256 guard on messageStore.
• Registration: registry.Constructors(), dispatch.Derivers, and the wiring integration test are all updated; test coverage includes every permission mode, hook lifecycle, foreign-file protection, and context cancellation.

Confidence Score: 5/5

Safe to merge; the adapter is self-contained, follows the established opencode/codex pattern, and is well-tested.

The adapter is a clean, well-tested addition of a new agent harness. All hooks are sentinel-guarded, writes are atomic, and the activity dispatch and registry wiring are correct. The only finding is a minor bounded-growth omission in the TypeScript plugin's promptReports map — symmetric with the messageStore cap already added in this PR — which has no correctness impact on normal-path behavior.

No files require special attention.

Important Files Changed

Filename	Overview
backend/internal/adapters/agent/kilocode/assets/ao-activity.ts	TypeScript plugin bridging Kilo lifecycle events to AO hooks; messageStore is now bounded (MESSAGE_STORE_MAX=256) but promptReports has no equivalent cap and grows linearly with user messages in a long session.
backend/internal/adapters/agent/kilocode/hooks.go	Installs/uninstalls AO's plugin file using sentinel-guarded atomic writes; foreign-file protection and idempotency are well-handled.
backend/internal/adapters/agent/kilocode/kilocode.go	Main adapter: binary resolution with cache, permission env prefix rendering, launch/restore/session-info commands — clean and mirrors the opencode/codex pattern throughout.
backend/internal/adapters/agent/kilocode/kilocode_test.go	Comprehensive tests: all permission modes, hook install/uninstall/foreign-file guards, restore command, session info, activity deriver, and context cancellation.
backend/internal/adapters/agent/kilocode/activity.go	Simple DeriveActivityState switch mapping the four managed events to AO domain states; correct and minimal.
backend/internal/adapters/agent/activitydispatch/dispatch.go	Registers kilocode deriver in the Derivers map alongside the other adapters; no logic change.
backend/internal/adapters/agent/registry/registry.go	Adds kilocode.New() to Constructors(); one-line registration following the existing pattern.
backend/internal/daemon/wiring_test.go	Adds domain.HarnessKilocode to the resolver integration test; straightforward extension of existing test table.

Sequence Diagram

sequenceDiagram
    participant K as Kilo Code CLI
    participant P as ao-activity.ts plugin
    participant AO as ao hooks kilocode

    K->>P: "session.created { id }"
    P->>AO: "session-start { session_id }"
    Note over AO: DeriveActivityState → ActivityActive

    K->>P: "message.updated { role:user, id, sessionID }"
    P->>P: rememberMessage(id, msg)
    P->>AO: "user-prompt-submit { session_id, prompt:"" }"
    Note over AO: DeriveActivityState → ActivityActive

    K->>P: "message.part.updated { messageID, type:text, text }"
    P->>P: lookup msg in messageStore
    P->>AO: "user-prompt-submit { session_id, prompt:text }"
    P->>P: messageStore.delete(messageID)

    K->>P: "permission.ask { sessionID }"
    P->>AO: "permission-request { session_id }"
    Note over AO: DeriveActivityState → ActivityWaitingInput

    K->>P: "session.status { status.type:"idle", sessionID }"
    P->>AO: "stop { session_id }"
    Note over AO: DeriveActivityState → ActivityIdle

Loading

_{Reviews (2): Last reviewed commit: "feat(agents): add kilocode adapter" | Re-trigger Greptile}