@bogyie/opencode-kiro-plugin 0.1.0

package/docs/implementation-strategy.md

@@ -0,0 +1,241 @@
+# Implementation Strategy
+
+## Goal
+
+OpenCode에 Kiro provider를 plugin 형태로 추가합니다. 단, Kiro의 공식 직접 LLM API가 확인되지 않았으므로 초기 목표는 Kiro CLI/ACP를 안정적으로 감싸는 adapter입니다.
+
+## Architecture Options
+
+### Option A: Config-only OpenAI-compatible Provider
+
+조건:
+
+- Kiro가 OpenAI-compatible `/v1/chat/completions` endpoint를 제공해야 합니다.
+
+장점:
+
+- 구현이 가장 작습니다.
+- OpenCode의 기존 provider config만으로 동작합니다.
+- `@ai-sdk/openai-compatible`를 그대로 사용할 수 있습니다.
+
+단점:
+
+- 현재 공식 근거가 없습니다.
+- auth, stream, tool call, usage metadata가 Kiro와 맞지 않을 수 있습니다.
+
+판정: future path로 보관합니다.
+
+### Option B: `kiro-cli chat --no-interactive` Adapter
+
+조건:
+
+- 사용자의 machine에 `kiro-cli`가 설치되어 있어야 합니다.
+- `KIRO_API_KEY` 또는 login session이 있어야 합니다.
+
+장점:
+
+- 공식 CLI 표면을 사용합니다.
+- MVP 구현이 빠릅니다.
+- CI/headless 시나리오와 잘 맞습니다.
+
+단점:
+
+- streaming UX가 제한될 수 있습니다.
+- OpenCode의 LLM tool-call protocol과 1:1 매핑이 어렵습니다.
+- prompt 단위 호출에 가까워 session 재사용이 제한될 수 있습니다.
+
+판정: MVP 후보입니다.
+
+### Option C: `kiro-cli acp` Adapter
+
+조건:
+
+- OpenCode plugin 또는 별도 adapter process가 ACP JSON-RPC를 처리해야 합니다.
+
+장점:
+
+- Kiro가 공식 문서화한 agent integration path입니다.
+- streaming chunk, tool call, session control을 받을 수 있습니다.
+- 장기적으로 provider-like UX에 가장 가깝습니다.
+
+단점:
+
+- ACP event를 OpenCode provider stream으로 변환해야 합니다.
+- OpenCode plugin hook만으로 충분한지 검증이 필요합니다.
+- adapter state/session lifecycle 설계가 필요합니다.
+
+판정: 권장 구현 방향입니다.
+
+### Option D: Unofficial HTTP Adapter
+
+조건:
+
+- Kiro 내부 endpoint, auth, request/response schema를 reverse engineer해야 합니다.
+
+장점:
+
+- 성공하면 가장 provider답게 동작할 수 있습니다.
+
+단점:
+
+- 공식 지원이 없습니다.
+- 약관 및 계정 리스크가 큽니다.
+- Kiro 변경에 쉽게 깨집니다.
+
+판정: 기본 구현에서 제외합니다.
+
+### Option E: OpenCode Plugin with Custom Fetch
+
+조건:
+
+- OpenCode provider는 `@ai-sdk/openai-compatible`로 등록합니다.
+- plugin `auth.loader`가 `baseURL`과 custom `fetch`를 반환합니다.
+- custom `fetch`에서 OpenAI-compatible request를 Kiro/CodeWhisperer request로 변환합니다.
+
+참고 구현:
+
+- `tickernelz/opencode-kiro-auth`
+
+장점:
+
+- 사용자는 OpenCode에서 일반 provider처럼 사용할 수 있습니다.
+- OpenCode의 model selection, variants, auth flow와 잘 맞습니다.
+- 별도 server 없이 plugin 하나로 배포할 수 있습니다.
+
+단점:
+
+- Kiro/CodeWhisperer request 변환을 직접 유지보수해야 합니다.
+- Kiro 내부 API 또는 AWS SDK 동작 변경에 민감합니다.
+- 모델 목록이 정적으로 굳으면 빠르게 깨질 수 있습니다.
+
+판정: OpenCode plugin UX를 목표로 할 때 가장 직접적인 구현 후보입니다.
+
+## Model List Strategy
+
+모델 목록은 Kiro 쪽 변경이 잦을 수 있으므로 하드코딩 whitelist에 의존하지 않습니다.
+
+권장 resolver pipeline:
+
+1. Alias
+   - 사용자가 원하는 별칭을 실제 모델 ID로 매핑합니다.
+   - 예: `kiro-auto` -> `auto`, `sonnet` -> `claude-sonnet-4.6`
+
+2. Normalize
+   - client마다 다른 이름 형식을 Kiro 형식으로 정규화합니다.
+   - 예: `claude-sonnet-4-6` -> `claude-sonnet-4.6`
+   - 예: `claude-sonnet-4-6-20260101` -> `claude-sonnet-4.6`
+   - 예: `claude-4.6-sonnet-high` -> `claude-sonnet-4.6`
+
+3. Dynamic cache
+   - Kiro model list API 또는 CLI discovery 결과를 TTL cache에 저장합니다.
+   - cache가 비어 있거나 stale이면 refresh를 시도합니다.
+   - refresh 실패 시 fallback preset을 사용하되 경고를 남깁니다.
+
+4. Hidden/manual models
+   - 공식 list에는 없지만 동작하는 모델을 user config로 추가할 수 있게 합니다.
+   - display ID와 internal ID를 분리합니다.
+
+5. Optimistic pass-through
+   - cache에 없는 모델도 즉시 거절하지 않습니다.
+   - 정규화한 ID를 Kiro에 보내고 Kiro API/CLI가 최종 판정하게 합니다.
+   - 실패 시 같은 family의 사용 가능한 모델을 suggestion으로 제공합니다.
+
+필수 config knobs:
+
+```json
+{
+  "kiro": {
+    "modelCacheTtlSeconds": 21600,
+    "modelDiscovery": "auto",
+    "modelAliases": {
+      "kiro-auto": "auto"
+    },
+    "hiddenModels": {
+      "claude-3.7-sonnet": "CLAUDE_3_7_SONNET_20250219_V1_0"
+    },
+    "disableModelPassThrough": false
+  }
+}
+```
+
+설계 원칙:
+
+- fallback preset은 마지막 안전망이지 truth source가 아닙니다.
+- `SUPPORTED_MODELS` 같은 상수는 UI 표시와 tests용으로만 사용하고 runtime validation에는 쓰지 않습니다.
+- 새 모델 출시는 config 업데이트 없이 pass-through로 먼저 사용할 수 있어야 합니다.
+- `/models` 또는 OpenCode provider model list는 cache + hidden + alias를 합친 view를 반환합니다.
+
+## Proposed Scaffold
+
+```txt
+src/
+  index.ts          # OpenCode plugin export
+  config.ts         # options, env, validation
+  kiro-cli.ts       # kiro-cli discovery, version, whoami
+  acp-client.ts     # JSON-RPC over stdio client
+  chat-adapter.ts   # no-interactive fallback
+  models.ts         # fallback presets and metadata defaults
+  model-resolver.ts # alias, normalization, dynamic cache, hidden models, pass-through
+  model-cache.ts    # TTL cache and refresh coordination
+  errors.ts         # error normalization
+test/
+  config.test.ts
+  kiro-cli.test.ts
+  acp-client.test.ts
+  chat-adapter.test.ts
+  model-resolver.test.ts
+  model-cache.test.ts
+  fixtures/
+    acp-initialize.json
+    acp-agent-message-chunk.json
+    acp-tool-call.json
+    list-models.json
+```
+
+## MVP Scope
+
+1. Plugin initialization
+   - verify `kiro-cli` exists
+   - expose clear diagnostic errors
+   - do not read Kiro private token files
+
+2. Auth handling
+   - prefer `KIRO_API_KEY`
+   - fallback to `kiro-cli whoami`
+   - show login guidance if missing
+
+3. Kiro call path
+   - implement `chat --no-interactive` adapter first if ACP mapping is too large
+   - record ACP handshake and add ACP adapter behind feature flag
+
+4. OpenCode integration
+   - provide config injection or documented config snippet
+   - add model resolver with fallback presets
+   - expose a custom tool or command for diagnostics
+
+5. Tests
+   - subprocess command construction
+   - env handling
+   - model normalization and pass-through
+   - model cache stale/refresh behavior
+   - ACP JSON-RPC parsing with fixtures
+
+## Open Questions
+
+- Can OpenCode plugin hooks currently replace the actual LLM transport with an ACP-backed adapter without modifying OpenCode core?
+- If not, should this plugin start as a custom tool/command plus config helper, then later move toward provider support?
+- Does current `kiro-cli acp` support non-interactive API key auth reliably under `KIRO_API_KEY`?
+- What is the exact command/flag for listing Kiro models in the installed CLI version?
+- How should OpenCode tool-call requests be represented when Kiro itself wants to use tools?
+
+## Recommended First Milestone
+
+Build a diagnostic-only plugin first:
+
+- `opencode.json` loads `@bogyie/opencode-kiro-plugin`
+- plugin checks `kiro-cli --version`
+- plugin checks auth with `kiro-cli whoami`
+- plugin exposes a `kiro_status` custom tool
+- plugin documents the Kiro model presets and next adapter path
+
+This validates plugin packaging and user environment before committing to the harder ACP/provider transport layer.

package/docs/kiro-integration-notes.md

@@ -0,0 +1,129 @@
+# Kiro Integration Notes
+
+조사일: 2026-07-07
+
+## What Kiro Exposes Publicly
+
+Kiro의 공식 공개 표면은 다음입니다.
+
+- Kiro IDE
+- Kiro CLI
+- Kiro Web
+- Kiro ACP agent mode
+- Kiro headless CLI mode
+
+현재 공식 문서에서 확인되는 직접 호출 방식:
+
+```bash
+kiro-cli
+kiro-cli login
+kiro-cli whoami
+kiro-cli chat --no-interactive "prompt"
+kiro-cli chat --no-interactive --trust-all-tools "prompt"
+kiro-cli acp
+```
+
+Headless mode는 `KIRO_API_KEY` 환경 변수를 사용합니다.
+
+```bash
+export KIRO_API_KEY=ksk_xxxxxxxx
+kiro-cli chat --no-interactive "your prompt here"
+```
+
+## Community API Surface Findings
+
+공식 문서가 직접 LLM API를 설명하지는 않지만, community 구현들은 Kiro/CodeWhisperer 계열 API를 다음 방식으로 사용합니다.
+
+- `opencode-kiro-auth`
+  - AWS `@aws/codewhisperer-streaming-client` 사용
+  - endpoint: `https://q.{region}.amazonaws.com`
+  - operation 성격: `generateAssistantResponse`
+  - Kiro header: `x-amzn-kiro-agent-mode: vibe`
+  - auth refresh endpoints:
+    - `https://prod.{region}.auth.desktop.kiro.dev/refreshToken`
+    - `https://oidc.{region}.amazonaws.com/token`
+이 경로들은 실전 구현으로는 유용하지만, 공식 stable API로 문서화된 것은 아니므로 compatibility risk를 별도로 관리해야 합니다.
+
+## Authentication
+
+공식 문서상 지원 인증:
+
+- GitHub
+- Google
+- AWS Builder ID
+- AWS IAM Identity Center
+- external identity provider
+- API key for headless mode
+
+API key 인증은 Pro, Pro+, Pro Max, Power subscriber 또는 관리자 정책에 따라 사용 가능합니다.
+
+플러그인 구현에서는 Kiro token file을 직접 읽는 방식보다 다음 순서를 권장합니다.
+
+1. `KIRO_API_KEY`가 있으면 headless mode 사용
+2. 없으면 `kiro-cli whoami`로 login 상태 확인
+3. 미로그인 상태면 사용자에게 `kiro-cli login` 안내
+4. 조직/관리자 정책 오류는 그대로 노출
+
+## ACP Mode
+
+Kiro는 `kiro-cli acp`로 ACP-compatible agent process를 실행할 수 있습니다.
+
+특성:
+
+- transport: stdin/stdout
+- protocol: JSON-RPC 2.0
+- session methods: `initialize`, `session/new`, `session/load`, `session/prompt`, `session/cancel`, `session/set_mode`, `session/set_model`
+- update events: `AgentMessageChunk`, `ToolCall`, `ToolCallUpdate`, `TurnEnd`
+
+OpenCode와 연결할 때는 ACP event를 OpenCode model stream 또는 tool event로 변환하는 adapter가 필요합니다.
+
+## Model Notes
+
+Kiro 공식 모델 문서와 community 구현에서 확인된 model 후보:
+
+- `auto`
+- `claude-opus-4.8`
+- `claude-opus-4.7`
+- `claude-opus-4.6`
+- `claude-opus-4.5`
+- `claude-sonnet-5`
+- `claude-sonnet-4.6`
+- `claude-sonnet-4.5`
+- `claude-sonnet-4.0`
+- `claude-haiku-4.5`
+- `deepseek-3.2`
+- `minimax-m2.5`
+- `minimax-m2.1`
+- `glm-5`
+- `qwen3-coder-next`
+- legacy/internal 후보:
+  - `claude-3-7-sonnet`
+  - `nova-swe`
+  - `gpt-oss-120b`
+  - `minimax-m2`
+  - `kimi-k2-thinking`
+
+문서화된 context window는 모델별로 다릅니다. 예를 들어 Kiro docs에는 Claude Opus 4.8/4.7/4.6과 Claude Sonnet 5/4.6가 1M context로 표시되고, Claude Sonnet 4.5/4.0 및 Claude Haiku 4.5는 200K context로 표시됩니다.
+
+## Model Flexibility Requirement
+
+Kiro 모델 목록은 tier, region, release timing에 따라 바뀔 수 있으므로 static list를 runtime truth로 쓰면 안 됩니다.
+
+필수 동작:
+
+- startup 시 model discovery를 시도합니다.
+- discovery 결과는 TTL cache에 저장합니다.
+- cache가 stale이면 background refresh를 시도합니다.
+- refresh 실패 시 fallback preset으로 시작합니다.
+- 사용자가 `hiddenModels`, `modelAliases`, `disabledModels`를 설정할 수 있게 합니다.
+- 알 수 없는 모델은 기본적으로 pass-through합니다.
+- Kiro가 거절한 경우 같은 model family의 후보를 제안합니다.
+
+## Risk Notes
+
+- 공식 OpenAI-compatible endpoint가 확인되지 않았습니다.
+- Kiro CLI는 폐쇄 소스입니다.
+- 비공식 endpoint reverse engineering은 약관, 안정성, 계정 리스크가 큽니다.
+- community 구현은 가능성을 보여주지만 공식 API 안정성을 보장하지 않습니다.
+- Free/individual subscriber의 service improvement 정책과 Enterprise 데이터 처리 정책 차이를 README에 명확히 적어야 합니다.
+- Kiro administrator policy가 model access, MCP, web fetch, API key 사용 가능 여부에 영향을 줄 수 있습니다.

package/docs/opencode-provider-notes.md

@@ -0,0 +1,87 @@
+# OpenCode Provider Notes
+
+조사 기준 upstream: `anomalyco/opencode` commit `9353559088fcb81d02290707e2da2e79d31b9bdc`
+
+## Plugin Loading
+
+OpenCode plugin은 별도 manifest 파일이 필수인 구조가 아니라 JavaScript/TypeScript module export 중심입니다.
+
+로딩 경로:
+
+- project local: `.opencode/plugins/`
+- global local: `~/.config/opencode/plugins/`
+- npm package: `opencode.json`의 `plugin` 배열
+
+공식 문서상 로드 순서:
+
+1. global config
+2. project config
+3. global plugin directory
+4. project plugin directory
+
+npm plugin은 OpenCode 시작 시 Bun으로 설치되고 `~/.cache/opencode/node_modules/`에 cache됩니다.
+
+## Useful Plugin Hooks
+
+`@opencode-ai/plugin`의 주요 hook:
+
+- `config(input)`: OpenCode config를 수정할 수 있습니다. Kiro provider config 자동 주입 후보입니다.
+- `auth`: `/connect` 흐름에 provider credential 입력 또는 OAuth를 붙일 수 있습니다.
+- `provider`: 기존 catalog provider의 model 목록을 조정하는 데 사용할 수 있습니다.
+- `chat.params`: LLM request parameter를 수정합니다.
+- `chat.headers`: LLM request header를 수정합니다.
+- `shell.env`: shell 실행 환경 변수를 추가합니다.
+- `tool`: custom tool을 추가합니다.
+
+중요한 제약:
+
+- source상 `provider` hook은 catalog/database에 이미 존재하는 provider를 대상으로 model 목록을 바꾸는 성격이 강합니다.
+- 완전히 새로운 provider는 `config` hook으로 `provider.kiro`를 추가하거나 사용자가 `opencode.json`에 직접 설정하는 방식이 더 안전합니다.
+
+## Provider Config Shape
+
+legacy/current docs 기준 최소 예시:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@bogyie/opencode-kiro-plugin"],
+  "provider": {
+    "kiro": {
+      "npm": "@ai-sdk/openai-compatible",
+      "name": "Kiro",
+      "options": {
+        "baseURL": "https://example.invalid/v1",
+        "apiKey": "{env:KIRO_API_KEY}"
+      },
+      "models": {
+        "auto": {
+          "name": "Kiro Auto",
+          "limit": {
+            "context": 200000,
+            "output": 32000
+          }
+        }
+      }
+    }
+  },
+  "model": "kiro/auto"
+}
+```
+
+이 config-only 방식은 Kiro가 OpenAI-compatible endpoint를 제공할 때만 유효합니다. 현재 공식 문서상 해당 endpoint가 확인되지 않았으므로 구현 문서에서는 fallback 또는 future path로만 취급합니다.
+
+## Source Pointers
+
+- plugin types: `packages/plugin/src/index.ts`
+- provider config schema: `packages/core/src/v1/config/provider.ts`
+- provider loader: `packages/opencode/src/provider/provider.ts`
+- provider auth: `packages/opencode/src/provider/auth.ts`
+- CLI provider command: `packages/opencode/src/cli/cmd/providers.ts`
+- built-in provider plugins: `packages/core/src/plugin/provider/*`
+- OpenAI-compatible plugin: `packages/core/src/plugin/provider/openai-compatible.ts`
+- session runner model support: `packages/core/src/session/runner/model.ts`
+
+## Version Caveat
+
+OpenCode 문서와 source에는 legacy `provider`/`plugin` config와 v2 `providers`/`plugins` spec가 함께 보입니다. 초기 플러그인은 README에 지원 OpenCode 버전과 config key를 명시해야 합니다.

package/docs/references.md

@@ -0,0 +1,50 @@
+# References
+
+## OpenCode
+
+- OpenCode plugins docs: https://opencode.ai/docs/plugins/
+- OpenCode providers docs: https://opencode.ai/docs/providers/
+- OpenCode ACP docs: https://opencode.ai/docs/acp/
+- OpenCode upstream repo: https://github.com/anomalyco/opencode
+- `@opencode-ai/plugin` types: https://github.com/anomalyco/opencode/blob/9353559088fcb81d02290707e2da2e79d31b9bdc/packages/plugin/src/index.ts
+- provider config schema: https://github.com/anomalyco/opencode/blob/9353559088fcb81d02290707e2da2e79d31b9bdc/packages/core/src/v1/config/provider.ts
+- provider loader: https://github.com/anomalyco/opencode/blob/9353559088fcb81d02290707e2da2e79d31b9bdc/packages/opencode/src/provider/provider.ts
+- built-in provider plugins: https://github.com/anomalyco/opencode/tree/9353559088fcb81d02290707e2da2e79d31b9bdc/packages/core/src/plugin/provider
+- OpenAI-compatible plugin: https://github.com/anomalyco/opencode/blob/9353559088fcb81d02290707e2da2e79d31b9bdc/packages/core/src/plugin/provider/openai-compatible.ts
+- v2 provider/model spec: https://github.com/anomalyco/opencode/blob/9353559088fcb81d02290707e2da2e79d31b9bdc/specs/v2/provider-model.md
+- v2 config spec: https://github.com/anomalyco/opencode/blob/9353559088fcb81d02290707e2da2e79d31b9bdc/specs/v2/config.md
+
+## Kiro
+
+- Kiro homepage: https://kiro.dev/
+- Kiro CLI docs: https://kiro.dev/docs/cli/
+- Kiro CLI quick start: https://kiro.dev/docs/cli/quick-start/
+- Kiro headless mode: https://kiro.dev/docs/cli/headless/
+- Kiro authentication: https://kiro.dev/docs/cli/authentication/
+- Kiro ACP: https://kiro.dev/docs/cli/acp/
+- Kiro models: https://kiro.dev/docs/models/
+- Kiro firewall endpoints: https://kiro.dev/docs/privacy-and-security/firewalls/
+- Kiro data protection: https://kiro.dev/docs/privacy-and-security/data-protection/
+- Kiro license: https://kiro.dev/license/
+- AWS Service Terms: https://aws.amazon.com/service-terms/
+- Amazon Q Developer CLI notice: https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line.html
+- Amazon Q Developer CLI repo: https://github.com/aws/amazon-q-developer-cli
+- Kiro CLI latest manifest: https://prod.download.cli.kiro.dev/stable/latest/manifest.json
+
+## AI SDK
+
+- OpenAI-compatible provider: https://ai-sdk.dev/providers/openai-compatible-providers
+- Anthropic provider: https://ai-sdk.dev/providers/ai-sdk-providers/anthropic
+- Amazon Bedrock provider: https://ai-sdk.dev/providers/ai-sdk-providers/amazon-bedrock
+
+## Community Examples
+
+- OpenCode ecosystem docs: https://opencode.ai/docs/ecosystem/
+- OpenAI Codex auth plugin: https://github.com/numman-ali/opencode-openai-codex-auth
+- Gemini auth plugin: https://github.com/jenslys/opencode-gemini-auth
+- OpenCode plugin template: https://github.com/zenobi-us/opencode-plugin-template
+- OpenCode Kiro auth plugin: https://github.com/tickernelz/opencode-kiro-auth
+
+## License Notes
+
+- `tickernelz/opencode-kiro-auth` is MIT licensed.

package/docs/research-summary.md

@@ -0,0 +1,69 @@
+# Research Summary
+
+조사일: 2026-07-07  
+조사 방식: OpenCode/Kiro 공식 문서 확인, OpenCode upstream source 확인, subagent 병렬 조사 결과 통합
+
+## 결론
+
+OpenCode에 Kiro를 "provider"로 추가하려면 먼저 provider라는 단어를 두 의미로 나눠야 합니다.
+
+1. OpenCode LLM provider: OpenCode의 모델 호출 계층입니다. `@ai-sdk/openai-compatible`, `@ai-sdk/openai`, `@ai-sdk/anthropic` 같은 AI SDK provider와 `provider` config를 통해 동작합니다.
+2. Kiro agent provider: Kiro CLI/ACP agent를 OpenCode에서 호출 가능한 backend처럼 사용하는 방식입니다. Kiro가 공개한 공식 통합 표면은 이쪽에 가깝습니다.
+
+Kiro가 공식적으로 OpenAI-compatible `/v1/chat/completions`, OpenAI Responses API, Anthropic Messages API 같은 직접 LLM endpoint를 공개하지 않았기 때문에, 현재 시점의 안전한 구현 방향은 Kiro CLI/ACP adapter입니다.
+
+## 핵심 발견
+
+OpenCode 쪽:
+
+- plugin은 JavaScript/TypeScript module이며 `@opencode-ai/plugin` 타입을 사용할 수 있습니다.
+- local plugin은 `.opencode/plugins/` 또는 `~/.config/opencode/plugins/`에서 자동 로드됩니다.
+- npm plugin은 `opencode.json`의 `plugin` 배열에 package name을 넣어 설치합니다.
+- custom provider는 `provider.<id>.npm`, `provider.<id>.options.baseURL`, `provider.<id>.models`로 설정합니다.
+- source상 plugin hook에는 `config`, `auth`, `provider`, `chat.params`, `chat.headers`, `shell.env` 등이 있습니다.
+- `provider` hook만으로 완전히 새로운 provider를 만드는 것은 제한적입니다. 새 provider는 config에 등록하는 경로가 더 안정적입니다.
+
+Kiro 쪽:
+
+- Kiro는 AWS가 운영하는 IDE/CLI/Web agentic engineering 제품입니다.
+- 인증은 GitHub, Google, AWS Builder ID, AWS IAM Identity Center, external IdP를 지원합니다.
+- headless/CI는 `KIRO_API_KEY` 환경 변수를 사용하지만 Pro 계열 구독 및 관리자 설정이 필요합니다.
+- 공개 문서에서 직접 LLM API endpoint와 request/response schema는 확인되지 않았습니다.
+- 공식 통합 표면은 `kiro-cli chat`, `kiro-cli chat --no-interactive`, `kiro-cli acp`입니다.
+- ACP 모드는 JSON-RPC 2.0 over stdio로 동작하며 streaming chunk, tool call update, turn end 이벤트를 제공합니다.
+
+Community 구현:
+
+- `tickernelz/opencode-kiro-auth`는 실제 OpenCode server plugin 형태로 Kiro provider를 등록합니다. `config` hook에서 `provider.kiro`에 `@ai-sdk/openai-compatible`와 base URL을 주입하고, `auth.loader`에서 custom `fetch`를 제공해 OpenCode의 OpenAI-compatible 요청을 Kiro/CodeWhisperer request로 변환합니다.
+
+## 구현 가설
+
+현재 가능한 구현 경로는 다섯 가지입니다.
+
+1. Config-only OpenAI-compatible provider
+   - Kiro가 OpenAI-compatible endpoint를 제공한다는 전제가 필요합니다.
+   - 현재 공식 문서상 근거가 부족합니다.
+
+2. `kiro-cli chat --no-interactive` subprocess adapter
+   - 가장 빠른 MVP 후보입니다.
+   - 단점은 OpenCode의 native streaming/tool-call provider와 완전히 같은 UX를 만들기 어렵다는 점입니다.
+
+3. `kiro-cli acp` JSON-RPC adapter
+   - 공식 표면을 쓰면서 streaming과 session control을 받을 수 있습니다.
+   - OpenCode provider interface에 ACP session events를 매핑하는 설계가 필요합니다.
+
+4. 비공식 HTTP adapter
+   - 직접 endpoint를 찾고 request schema를 맞추는 방식입니다.
+   - 약관, 안정성, 계정 리스크가 커서 기본 구현에서 제외해야 합니다.
+
+5. OpenCode plugin + custom fetch adapter
+   - `opencode-kiro-auth`가 이미 검증한 패턴입니다.
+   - OpenCode에는 `@ai-sdk/openai-compatible` provider로 보이게 하고, 실제 fetch에서 Kiro/CodeWhisperer SDK request로 변환합니다.
+   - provider UX는 가장 좋지만 비공식 API 및 request 변환 유지보수 부담이 있습니다.
+
+## 다음 액션
+
+- `kiro-cli acp`의 JSON-RPC initialize/session flow를 실제로 기록합니다.
+- OpenCode plugin으로 custom tool 또는 command를 추가해 Kiro CLI 호출 MVP를 먼저 만듭니다.
+- 그 다음 OpenCode provider 계층에 붙일 수 있는지 검증합니다.
+- Kiro model metadata는 정적 preset을 fallback으로만 두고, 실제 모델 목록은 discovery/cache/resolver로 보정합니다.

package/examples/opencode.jsonc

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    [
+      "@bogyie/opencode-kiro-plugin",
+      {
+        "backend": "auto",
+        "region": "us-east-1",
+        // Optional direct fetch overrides:
+        // "endpoint": "https://q.us-east-1.amazonaws.com",
+        // "profileArn": "arn:aws:q:...",
+        // "userAgent": "KiroIDE",
+        // "agentMode": "vibe",
+        "modelCacheTtlSeconds": 21600,
+        "modelDiscovery": "auto",
+        "modelDiscoveryCommand": [],
+        "maxAttempts": 3,
+        "requestTimeoutMs": 120000,
+        "modelAliases": {
+          "sonnet": "claude-sonnet-4.6",
+          "opus": "claude-opus-4.6"
+        },
+        "extraModels": {
+          "claude-opus-4-9": {
+            "name": "Claude Opus 4.9",
+            "limit": { "context": 1000000, "output": 64000 },
+            "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] },
+            "tool_call": true
+          }
+        },
+        "hiddenModels": {},
+        "disabledModels": [],
+        "disableModelPassThrough": false,
+        "trustAllTools": false
+      }
+    ]
+  ],
+  "provider": {
+    "kiro": {
+      "models": {
+        "sonnet": {
+          "name": "Claude Sonnet via Kiro"
+        }
+      }
+    }
+  }
+}