feat(kiro): add Kiro ACP provider with agent picker, /agent command, and Opus 4.7

Adds Kiro as a first-class ACP provider layered on top of upstream's shared ACP
infrastructure (PR pingdotgg#1355). Kiro is an Amazon CLI (`kiro-cli acp`) speaking the
Agent Communication Protocol over stdio; authentication is OIDC via
`kiro-cli login` (out-of-band).

Highlights:

- Full ACP lifecycle: initialize → session/new → session/prompt/cancel, with
  streaming `session/update` notifications and `{stopReason: "end_turn"}` turn
  end via RPC response.
- Agent discovery via `kiro-cli agent list`, cached at `~/.t3/caches/kiro.json`
  and surfaced through `ModelCapabilities.agentOptions`. Agents are a spawn-time
  CLI flag (`--agent <name>`) so `sendTurn` respawns the child process when the
  selected agent changes mid-session.
- `/agent` slash command opens the TraitsPicker, mirroring `/model`. Gated on
  whether the current model exposes `agentOptions`.
- TraitsPicker now closes on agent selection (`closeOnClick` MenuRadioItem).
- `normalizeProviderModelOptionsWithCapabilities` gains a `case "kiro"` —
  previously the kiro dispatch path dropped `{ agent }` silently because the
  switch fell through to `undefined`, so the server never received the agent
  selection even though the composer store held it.
- `_kiro.dev/commands/available` notifications runtime-patch slash commands;
  `_kiro.dev/metadata` surfaces context window usage.
- Built-in Kiro models include Opus 4.7 (aliased as `opus`), Sonnet 4.6, Haiku
  4.5, Deepseek 3.2.

Hidden traps documented in PATCH.md:

- Three hardcoded ProviderKind arrays in `composerDraftStore.ts` all need
  `"kiro"` or model selection silently reverts to previous provider.
- `normalizeProviderModelOptionsWithCapabilities` switch needs an explicit
  `case "kiro"` or agent selection never reaches the server.
- ACP `authMethodId` is made optional: Kiro returns empty `authMethods` and per
  spec the client must skip `authenticate`.
- `_kiro.dev/*` ext requests the adapter doesn't handle must return JSON-RPC
  error `-32601` (not empty-object success).
- `mcpServers: []` is required in `session/new`; omission exits kiro-cli
  silently.

Test coverage:

- `KiroAdapter.integration.test.ts` — 8 tests covering start/stop/listSessions,
  streaming, runtime events, agent flag propagation, respawn on agent change.
- `KiroAdapter.parsing.test.ts` — ACP message parsing.
- `packages/shared/src/model.test.ts` — 4 new tests for `normalizeKiro*` and
  provider-switch wiring.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: hrishi mane

.npmrc

@@ -0,0 +1 @@
+registry=https://registry.npmjs.org/

AGENTS.md

@@ -51,3 +51,11 @@ Docs:
 - Codex-Monitor (Tauri, feature-complete, strong reference implementation): https://github.com/Dimillian/CodexMonitor
 
 Use these as implementation references when designing protocol handling, UX flows, and operational safeguards.
+
+## Fork-specific: Kiro Provider
+
+This repo (`t3code-kiro`) is a fork of `pingdotgg/t3code` that patches a Kiro ACP provider on top of upstream. Before making changes that touch providers, the composer, or ACP:
+
+- Read `PATCH.md` for the maintenance guide (sync workflow, conflict zones, verification checklist).
+- Read `docs/KIRO.md` for Kiro ACP protocol notes (OIDC auth, `_kiro.dev/*` ext methods, agent discovery).
+- Adding a new provider requires updating **three** hardcoded `ProviderKind` arrays in `apps/web/src/composerDraftStore.ts` — see "Hidden Traps" in `PATCH.md`. Missing one produces a silent no-op (model selection reverts in UI with no error).

PATCH.md

@@ -0,0 +1,74 @@
+#!/usr/bin/env bun
+/**
+ * Mock ACP agent that imitates kiro-cli ACP protocol for integration tests.
+ *
+ * Responds to: initialize, session/new, session/prompt, session/cancel.
+ * Emits: session/update (agent_message_chunk), _kiro.dev/metadata extension.
+ */
+import * as Effect from "effect/Effect";
+
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import * as NodeRuntime from "@effect/platform-node/NodeRuntime";
+
+import * as EffectAcpAgent from "effect-acp/agent";
+
+const sessionId = "kiro-mock-session-1";
+
+const program = Effect.gen(function* () {
+  const agent = yield* EffectAcpAgent.AcpAgent;
+
+  yield* agent.handleInitialize(() =>
+    Effect.succeed({
+      protocolVersion: 1,
+      agentCapabilities: {},
+      agentInfo: {
+        name: "kiro-mock-agent",
+        version: "0.0.0",
+      },
+    }),
+  );
+
+  yield* agent.handleAuthenticate(() => Effect.succeed({}));
+
+  yield* agent.handleCreateSession(() =>
+    Effect.succeed({
+      sessionId,
+    }),
+  );
+
+  yield* agent.handleLoadSession(() => Effect.succeed({}));
+
+  yield* agent.handleCancel(() => Effect.void);
+
+  yield* agent.handlePrompt((request) =>
+    Effect.gen(function* () {
+      const requestedSessionId = String(request.sessionId ?? sessionId);
+
+      // Emit a content delta
+      yield* agent.client.sessionUpdate({
+        sessionId: requestedSessionId,
+        update: {
+          sessionUpdate: "agent_message_chunk",
+          content: { type: "text", text: "hello from kiro mock" },
+        },
+      });
+
+      // Emit kiro metadata extension notification
+      yield* agent.client.extNotification("_kiro.dev/metadata", {
+        contextUsagePercentage: 10,
+      });
+
+      return { stopReason: "end_turn" };
+    }),
+  );
+
+  yield* agent.handleUnknownExtRequest((_method, _params) => Effect.succeed({}));
+
+  return yield* Effect.never;
+}).pipe(
+  Effect.provide(EffectAcpAgent.layerStdio()),
+  Effect.scoped,
+  Effect.provide(NodeServices.layer),
+);
+
+NodeRuntime.runMain(program);

apps/server/scripts/kiro-mock-agent.ts

@@ -37,6 +37,10 @@ class OpenCodeTextGen extends Context.Service<OpenCodeTextGen, TextGenerationSha
   "t3/git/Layers/RoutingTextGeneration/OpenCodeTextGen",
 ) {}
 
+class KiroTextGen extends Context.Service<KiroTextGen, TextGenerationShape>()(
+  "t3/git/Layers/RoutingTextGeneration/KiroTextGen",
+) {}
+
 // ---------------------------------------------------------------------------
 // Routing implementation
 // ---------------------------------------------------------------------------
@@ -47,6 +51,7 @@ const makeRoutingTextGeneration = Effect.gen(function* () {
     claudeAgent: yield* ClaudeTextGen,
     cursor: yield* CursorTextGen,
     opencode: yield* OpenCodeTextGen,
+    kiro: yield* KiroTextGen,
   };
 
   return {
@@ -93,6 +98,14 @@ const InternalOpenCodeLayer = Layer.effect(
   }),
 ).pipe(Layer.provide(OpenCodeTextGenerationLive));
 
+const InternalKiroLayer = Layer.effect(
+  KiroTextGen,
+  Effect.gen(function* () {
+    const svc = yield* TextGeneration;
+    return svc;
+  }),
+).pipe(Layer.provide(OpenCodeTextGenerationLive));
+
 export const RoutingTextGenerationLive = Layer.effect(
   TextGeneration,
   makeRoutingTextGeneration,
@@ -101,4 +114,5 @@ export const RoutingTextGenerationLive = Layer.effect(
   Layer.provide(InternalClaudeLayer),
   Layer.provide(InternalCursorLayer),
   Layer.provide(InternalOpenCodeLayer),
+  Layer.provide(InternalKiroLayer),
 );

apps/server/src/git/Layers/RoutingTextGeneration.ts

@@ -13,7 +13,7 @@ import type { ChatAttachment, ModelSelection } from "@t3tools/contracts";
 import type { TextGenerationError } from "@t3tools/contracts";
 
 /** Providers that support git text generation (commit messages, PR content, branch names). */
-export type TextGenerationProvider = "codex" | "claudeAgent" | "cursor" | "opencode";
+export type TextGenerationProvider = "codex" | "claudeAgent" | "cursor" | "opencode" | "kiro";
 
 export interface CommitMessageGenerationInput {
   cwd: string;