@bogyie/opencode-kiro-plugin 0.2.3 → 0.2.5

package/README.md

@@ -39,7 +39,7 @@ The plugin resolves credentials in this order:
 
 Direct fetch mode requires an API key/token usable by the Kiro/CodeWhisperer client. `cli-chat` mode uses the official `kiro-cli chat --no-interactive` surface and depends on the local Kiro CLI login state.
 
-Use the `kiro_status` plugin tool to inspect provider id, backend, region, auth method, and fallback model preset count. Secrets are redacted in diagnostics.
+Use the `kiro_status` plugin tool to inspect provider id, backend, region, auth method, and discovered model count. Secrets are redacted in diagnostics.
 
 ## Backend Modes
 
@@ -74,7 +74,7 @@ Supported values:
 
 ## Model Churn Handling
 
-The resolver intentionally avoids a hard whitelist. By default, the plugin reads the current Kiro CLI model list with `kiro-cli chat --list-models --format json`. Bundled presets are only used as UI metadata and as a fallback when discovery is unavailable.
+The resolver intentionally avoids a hard whitelist. By default, the plugin reads the current Kiro CLI model list with `kiro-cli chat --list-models --format json`. Runtime discovery is the source of truth for the model picker; bundled metadata is not injected as available models by default.
 
 Useful options:
 
@@ -116,11 +116,11 @@ Resolution order:
 2. Name normalization, for example `claude-sonnet-4-6` to `claude-sonnet-4.6`
 3. Disabled model check
 4. Dynamic cache hit
-5. Extra model preset cache hit
+5. Explicit `extraModels` cache hit
 6. Hidden/manual model mapping
 7. Optimistic pass-through unless disabled
 
-This keeps new Kiro model ids visible before the package is updated. Use `extraModels` only when a new model should appear in OpenCode's model picker but is not yet listed by your installed Kiro CLI. Set `disableModelPassThrough: true` only when you need strict model governance.
+This keeps new Kiro model ids usable before the package is updated without advertising unavailable models in OpenCode's picker. Use `extraModels` only when you explicitly want a model to appear even though it is not listed by your installed Kiro CLI. Set `disableModelPassThrough: true` only when you need strict model governance.
 
 The plugin injects `provider.kiro` automatically. You only need to add `provider.kiro.models` yourself when overriding OpenCode model-picker metadata, such as a display name or context limit. Use plugin `modelAliases` for aliases that should resolve one requested model id to another.
 
@@ -150,6 +150,12 @@ npm run typecheck
 npm run build
 ```
 
+For a real Kiro smoke test that uses your local `kiro-cli` login, runs runtime model discovery, verifies the plugin does not advertise models absent from the real CLI list, and checks both non-streaming and streaming assistant responses:
+
+```sh
+npm run smoke:kiro
+```
+
 For real Kiro/OpenCode validation, use [docs/e2e-validation.md](docs/e2e-validation.md).
 
 ## Release

package/dist/local-server.d.ts

@@ -0,0 +1,6 @@
+import type { FetchAdapter } from "./fetch-adapter.js";
+export interface LocalKiroServer {
+    readonly baseURL: string;
+    close(): Promise<void>;
+}
+export declare function startLocalKiroServer(fetchAdapter: FetchAdapter): Promise<LocalKiroServer>;

package/dist/local-server.js

@@ -0,0 +1,78 @@
+import { createServer } from "node:http";
+function requestBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (chunk) => chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)));
+        req.on("end", () => resolve(Buffer.concat(chunks)));
+        req.on("error", reject);
+    });
+}
+async function writeResponse(res, response) {
+    res.statusCode = response.status;
+    response.headers.forEach((value, key) => {
+        res.setHeader(key, value);
+    });
+    if (!response.body) {
+        res.end();
+        return;
+    }
+    const reader = response.body.getReader();
+    try {
+        while (true) {
+            const item = await reader.read();
+            if (item.done)
+                break;
+            res.write(Buffer.from(item.value));
+        }
+        res.end();
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+export async function startLocalKiroServer(fetchAdapter) {
+    const server = createServer(async (req, res) => {
+        try {
+            const body = await requestBody(req);
+            const url = new URL(req.url ?? "/", "http://127.0.0.1");
+            const init = {
+                method: req.method ?? "POST",
+                headers: req.headers,
+            };
+            if (body.length > 0)
+                init.body = new Uint8Array(body);
+            const response = await fetchAdapter(url, init);
+            await writeResponse(res, response);
+        }
+        catch (error) {
+            res.statusCode = 500;
+            res.setHeader("content-type", "application/json");
+            res.end(JSON.stringify({
+                error: {
+                    message: error instanceof Error ? error.message : "Unknown local Kiro server error",
+                    type: "KIRO_LOCAL_SERVER_ERROR",
+                    code: "KIRO_LOCAL_SERVER_ERROR",
+                },
+            }));
+        }
+    });
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(0, "127.0.0.1", () => {
+            server.off("error", reject);
+            resolve();
+        });
+    });
+    const address = server.address();
+    return {
+        baseURL: `http://127.0.0.1:${address.port}/v1`,
+        close: () => new Promise((resolve, reject) => {
+            server.close((error) => {
+                if (error)
+                    reject(error);
+                else
+                    resolve();
+            });
+        }),
+    };
+}

package/dist/models.js

@@ -1,100 +1,2 @@
-const TEXT_IMAGE_PDF = { input: ["text", "image", "pdf"], output: ["text"] };
-const TEXT_ONLY = { input: ["text"], output: ["text"] };
-export const FALLBACK_MODELS = {
-    auto: {
-        name: "Kiro Auto",
-        limit: { context: 200_000, output: 64_000 },
-        modalities: TEXT_IMAGE_PDF,
-        tool_call: true,
-    },
-    "claude-fable-5": {
-        name: "Claude Fable 5",
-        limit: { context: 1_000_000, output: 64_000 },
-        modalities: TEXT_IMAGE_PDF,
-        tool_call: true,
-    },
-    "claude-sonnet-5": {
-        name: "Claude Sonnet 5",
-        limit: { context: 1_000_000, output: 64_000 },
-        modalities: TEXT_IMAGE_PDF,
-        tool_call: true,
-    },
-    "claude-sonnet-4": {
-        name: "Claude Sonnet 4.0",
-        limit: { context: 200_000, output: 64_000 },
-        modalities: TEXT_IMAGE_PDF,
-        tool_call: true,
-    },
-    "claude-sonnet-4.5": {
-        name: "Claude Sonnet 4.5",
-        limit: { context: 200_000, output: 64_000 },
-        modalities: TEXT_IMAGE_PDF,
-        tool_call: true,
-    },
-    "claude-sonnet-4.6": {
-        name: "Claude Sonnet 4.6",
-        limit: { context: 1_000_000, output: 64_000 },
-        modalities: TEXT_IMAGE_PDF,
-        tool_call: true,
-    },
-    "claude-opus-4.8": {
-        name: "Claude Opus 4.8",
-        limit: { context: 1_000_000, output: 128_000 },
-        modalities: TEXT_IMAGE_PDF,
-        tool_call: true,
-    },
-    "claude-opus-4.7": {
-        name: "Claude Opus 4.7",
-        limit: { context: 1_000_000, output: 64_000 },
-        modalities: TEXT_IMAGE_PDF,
-        tool_call: true,
-    },
-    "claude-opus-4.6": {
-        name: "Claude Opus 4.6",
-        limit: { context: 1_000_000, output: 64_000 },
-        modalities: TEXT_IMAGE_PDF,
-        tool_call: true,
-    },
-    "claude-opus-4.5": {
-        name: "Claude Opus 4.5",
-        limit: { context: 200_000, output: 64_000 },
-        modalities: TEXT_IMAGE_PDF,
-        tool_call: true,
-    },
-    "claude-haiku-4.5": {
-        name: "Claude Haiku 4.5",
-        limit: { context: 200_000, output: 64_000 },
-        modalities: { input: ["text", "image"], output: ["text"] },
-        tool_call: true,
-    },
-    "deepseek-3.2": {
-        name: "DeepSeek 3.2",
-        limit: { context: 128_000, output: 64_000 },
-        modalities: TEXT_ONLY,
-        tool_call: true,
-    },
-    "glm-5": {
-        name: "GLM-5",
-        limit: { context: 200_000, output: 64_000 },
-        modalities: TEXT_ONLY,
-        tool_call: true,
-    },
-    "minimax-m2.5": {
-        name: "MiniMax M2.5",
-        limit: { context: 200_000, output: 64_000 },
-        modalities: TEXT_ONLY,
-        tool_call: true,
-    },
-    "minimax-m2.1": {
-        name: "MiniMax M2.1",
-        limit: { context: 200_000, output: 64_000 },
-        modalities: TEXT_ONLY,
-        tool_call: true,
-    },
-    "qwen3-coder-next": {
-        name: "Qwen3 Coder Next",
-        limit: { context: 256_000, output: 64_000 },
-        modalities: TEXT_ONLY,
-        tool_call: true,
-    },
-};
+// Retained as an empty compatibility export. Runtime discovery is the source of truth.
+export const FALLBACK_MODELS = {};

package/dist/plugin.js

@@ -4,18 +4,11 @@ import { detectAuth, resolveApiKey } from "./auth.js";
 import { KiroCliChatTransport } from "./cli-transport.js";
 import { loadOptions } from "./config.js";
 import { createKiroFetch } from "./fetch-adapter.js";
+import { startLocalKiroServer } from "./local-server.js";
 import { ModelCache } from "./model-cache.js";
 import { refreshModelCacheFromCommand } from "./model-discovery.js";
 import { ModelResolver, normalizeModelName } from "./model-resolver.js";
 import { CodeWhispererKiroTransport } from "./kiro-transport.js";
-import { FALLBACK_MODELS } from "./models.js";
-function mergeModels(extraModels, existing) {
-    return {
-        ...FALLBACK_MODELS,
-        ...extraModels,
-        ...(existing ?? {}),
-    };
-}
 function discoveredProviderModels(cache) {
     return Object.fromEntries(cache.all().map((model) => [
         model.id,
@@ -32,6 +25,37 @@ function discoveredProviderModels(cache) {
         },
     ]));
 }
+function modelRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return {};
+    return Object.fromEntries(Object.entries(value).filter((entry) => Boolean(entry[0]) && Boolean(entry[1]) && typeof entry[1] === "object" && !Array.isArray(entry[1])));
+}
+function bearerToken(init) {
+    const header = new Headers(init?.headers).get("authorization");
+    const match = header?.match(/^Bearer\s+(.+)$/i);
+    return match?.[1] || undefined;
+}
+function localTransport(options, accessToken) {
+    if (options.backend === "acp")
+        return new KiroAcpTransport(acpTransportOptions(options));
+    if (options.backend === "cli-chat") {
+        return new KiroCliChatTransport({
+            trustAllTools: options.trustAllTools,
+            ...(options.requestTimeoutMs ? { requestTimeoutMs: options.requestTimeoutMs } : {}),
+        });
+    }
+    const apiKey = accessToken || process.env.KIRO_API_KEY;
+    if (apiKey && apiKey !== "kiro-plugin-local-transport") {
+        return new CodeWhispererKiroTransport(fetchTransportOptions(options, apiKey));
+    }
+    if (options.backend === "auto") {
+        return new KiroCliChatTransport({
+            trustAllTools: options.trustAllTools,
+            ...(options.requestTimeoutMs ? { requestTimeoutMs: options.requestTimeoutMs } : {}),
+        });
+    }
+    return undefined;
+}
 export function acpTransportOptions(options) {
     return {
         trustAllTools: options.trustAllTools,
@@ -53,9 +77,13 @@ export function fetchTransportOptions(options, accessToken) {
 export function createKiroPlugin() {
     return async (_input, rawOptions) => {
         const options = loadOptions(rawOptions);
-        const baseURL = options.endpoint ?? `https://q.${options.region}.amazonaws.com`;
         const modelCache = new ModelCache(options.modelCacheTtlSeconds);
-        modelCache.update([...Object.keys(FALLBACK_MODELS), ...Object.keys(options.extraModels)].map((id) => ({ id: normalizeModelName(id) })));
+        let localServer;
+        let configuredModels = { ...options.extraModels };
+        const disabledModels = new Set(options.disabledModels.map(normalizeModelName));
+        if (Object.keys(options.extraModels).length > 0) {
+            modelCache.update(Object.keys(options.extraModels).map((id) => ({ id: normalizeModelName(id) })));
+        }
         let discovery;
         let discoveryAttempted = false;
         const discoverIfStale = async () => {
@@ -79,16 +107,39 @@ export function createKiroPlugin() {
             disabledModels: options.disabledModels,
             disablePassThrough: options.disableModelPassThrough,
         });
+        const ensureLocalServer = async () => {
+            if (localServer)
+                return localServer;
+            const localFetch = async (input, init) => {
+                const transport = localTransport(options, bearerToken(init));
+                return createKiroFetch({
+                    resolver,
+                    ...(transport ? { transport } : {}),
+                })(input, init);
+            };
+            localServer = await startLocalKiroServer(localFetch);
+            return localServer;
+        };
         return {
+            dispose: async () => {
+                await localServer?.close();
+                localServer = undefined;
+            },
             config: async (config) => {
+                await discoverIfStale();
                 config.provider ??= {};
                 config.provider[options.providerID] ??= {};
                 const provider = config.provider[options.providerID];
+                const server = await ensureLocalServer();
+                configuredModels = {
+                    ...options.extraModels,
+                    ...modelRecord(provider.models),
+                };
                 provider.name ??= "Kiro";
                 provider.npm = "@ai-sdk/openai-compatible";
-                provider.api ??= baseURL;
+                provider.api = server.baseURL;
                 provider.options ??= {};
-                provider.models = mergeModels(options.extraModels, provider.models);
+                provider.models = configuredModels;
             },
             auth: {
                 provider: options.providerID,
@@ -115,36 +166,19 @@ export function createKiroPlugin() {
                 loader: async (auth) => {
                     await discoverIfStale();
                     const apiKey = await resolveApiKey(auth);
-                    const transport = options.backend === "acp"
-                        ? new KiroAcpTransport(acpTransportOptions(options))
-                        : options.backend === "cli-chat"
-                            ? new KiroCliChatTransport({
-                                trustAllTools: options.trustAllTools,
-                                ...(options.requestTimeoutMs ? { requestTimeoutMs: options.requestTimeoutMs } : {}),
-                            })
-                            : apiKey
-                                ? new CodeWhispererKiroTransport(fetchTransportOptions(options, apiKey))
-                                : options.backend === "auto"
-                                    ? new KiroCliChatTransport({
-                                        trustAllTools: options.trustAllTools,
-                                        ...(options.requestTimeoutMs ? { requestTimeoutMs: options.requestTimeoutMs } : {}),
-                                    })
-                                    : undefined;
+                    const server = await ensureLocalServer();
                     return {
-                        apiKey,
-                        baseURL,
-                        fetch: createKiroFetch({
-                            resolver,
-                            ...(transport ? { transport } : {}),
-                        }),
+                        apiKey: apiKey || "kiro-plugin-local-transport",
+                        baseURL: server.baseURL,
                     };
                 },
             },
             tool: {
                 kiro_status: tool({
-                    description: "Show Kiro plugin backend, auth, region, and model fallback status.",
+                    description: "Show Kiro plugin backend, auth, region, and discovered model status.",
                     args: {},
                     execute: async () => {
+                        await discoverIfStale();
                         const auth = await detectAuth();
                         return {
                             title: "Kiro status",
@@ -154,7 +188,7 @@ export function createKiroPlugin() {
                                 `region: ${auth.region}`,
                                 `auth: ${auth.method}`,
                                 `authenticated: ${auth.authenticated ? "yes" : "no"}`,
-                                `models: ${Object.keys(FALLBACK_MODELS).length} fallback presets`,
+                                `models: ${modelCache.ids().length} discovered/cache entries`,
                                 auth.message,
                             ].join("\n"),
                             metadata: {
@@ -172,22 +206,35 @@ export function createKiroPlugin() {
                 id: options.providerID,
                 models: async (provider) => {
                     await discoverIfStale();
-                    const models = {
-                        ...discoveredProviderModels(modelCache),
-                        ...(provider.models ?? {}),
-                    };
-                    return Object.fromEntries(Object.entries(models).map(([id, model]) => [
-                        id,
-                        {
-                            ...model,
-                            api: {
-                                ...(model.api ?? {}),
-                                id,
-                                npm: "@ai-sdk/openai-compatible",
-                                url: baseURL,
+                    const discovered = discoveredProviderModels(modelCache);
+                    const existing = modelRecord(provider.models);
+                    const allowedModelIDs = new Set([
+                        ...Object.keys(discovered),
+                        ...Object.keys(configuredModels),
+                        ...Object.keys(options.hiddenModels),
+                    ]);
+                    const server = await ensureLocalServer();
+                    return Object.fromEntries([...allowedModelIDs]
+                        .filter((id) => !disabledModels.has(normalizeModelName(id)))
+                        .map((id) => {
+                        const model = {
+                            ...(discovered[id] ?? {}),
+                            ...(configuredModels[id] ?? {}),
+                            ...(existing[id] ?? {}),
+                        };
+                        return [
+                            id,
+                            {
+                                ...model,
+                                api: {
+                                    ...(model.api ?? {}),
+                                    id,
+                                    npm: "@ai-sdk/openai-compatible",
+                                    url: server.baseURL,
+                                },
                             },
-                        },
-                    ]));
+                        ];
+                    }));
                 },
             },
         };

package/dist/response-adapter.js

@@ -1,4 +1,4 @@
-import { KiroPluginError } from "./errors.js";
+import { KiroPluginError, normalizeError } from "./errors.js";
 export function toOpenAIChatResponse(response, model) {
     const toolCalls = response.toolCalls ?? [];
     return Response.json({
@@ -40,17 +40,37 @@ export function toOpenAIChatResponse(response, model) {
 function sse(data) {
     return `data: ${JSON.stringify(data)}\n\n`;
 }
+function streamChunk(id, created, model, delta, finishReason) {
+    return {
+        id,
+        object: "chat.completion.chunk",
+        created,
+        model,
+        choices: [
+            {
+                index: 0,
+                delta,
+                finish_reason: finishReason,
+            },
+        ],
+    };
+}
 export function toOpenAIChatStreamResponse(chunks, model) {
     const encoder = new TextEncoder();
     const body = new ReadableStream({
         async start(controller) {
+            const id = `kiro-${crypto.randomUUID()}`;
+            const created = Math.floor(Date.now() / 1000);
+            let responseModel = model;
             try {
                 const toolCallIndexes = new Map();
                 let nextToolCallIndex = 0;
                 let sawToolCall = false;
                 let sawDelta = false;
+                controller.enqueue(encoder.encode(sse(streamChunk(id, created, responseModel, { role: "assistant" }, null))));
                 for await (const chunk of chunks) {
                     let delta;
+                    responseModel = chunk.modelId ?? responseModel;
                     if (chunk.type === "tool_call") {
                         sawToolCall = true;
                         let index = toolCallIndexes.get(chunk.id);
@@ -84,29 +104,26 @@ export function toOpenAIChatStreamResponse(chunks, model) {
                         delta = { content: chunk.text };
                     }
                     sawDelta = true;
-                    controller.enqueue(encoder.encode(sse({
-                        id: `kiro-${crypto.randomUUID()}`,
-                        object: "chat.completion.chunk",
-                        created: Math.floor(Date.now() / 1000),
-                        model: chunk.modelId ?? model,
-                        choices: [
-                            {
-                                index: 0,
-                                delta,
-                                finish_reason: null,
-                            },
-                        ],
-                    })));
+                    controller.enqueue(encoder.encode(sse(streamChunk(id, created, responseModel, delta, null))));
                 }
                 if (!sawDelta) {
                     throw new KiroPluginError("Kiro backend returned an empty response stream.", "KIRO_EMPTY_RESPONSE", 502);
                 }
-                controller.enqueue(encoder.encode(sse({ choices: [{ index: 0, delta: {}, finish_reason: sawToolCall ? "tool_calls" : "stop" }] })));
+                controller.enqueue(encoder.encode(sse(streamChunk(id, created, responseModel, {}, sawToolCall ? "tool_calls" : "stop"))));
                 controller.enqueue(encoder.encode("data: [DONE]\n\n"));
                 controller.close();
             }
             catch (error) {
-                controller.error(error);
+                const known = normalizeError(error);
+                controller.enqueue(encoder.encode(sse({
+                    error: {
+                        message: known.message,
+                        type: known.code,
+                        code: known.code,
+                    },
+                })));
+                controller.enqueue(encoder.encode("data: [DONE]\n\n"));
+                controller.close();
             }
         },
     });

package/docs/e2e-validation.md

@@ -189,7 +189,7 @@ Record any real Kiro/API limitations in `CHANGELOG.md` before publishing.
 - `kiro-cli whoami` succeeded with an IAM Identity Center session; account identifiers were not recorded here.
 - `kiro-cli chat --no-interactive "Say hello in one short sentence."` returned assistant text.
 - Built `KiroCliChatTransport` returned assistant text with `requestTimeoutMs: 30000`.
-- `opencode models kiro` in a temporary project using `file:/Users/boggy/repo/github.com/bogyie/opencode-kiro-plugin` listed `kiro/auto` and fallback models.
+- `opencode models kiro` in a temporary project using `file:/Users/boggy/repo/github.com/bogyie/opencode-kiro-plugin` should list models returned by runtime discovery, not bundled fallback presets.
 - `opencode run -m kiro/auto --format json "Say hello in one short sentence."` returned a text event and `finish_reason: stop` through the local plugin with `backend: "cli-chat"`.
 - `kiro-cli acp --verbose` returned a valid `initialize` JSON-RPC response but also emitted a non-JSON stdout log line; the stdio client now ignores those log lines.
 - Built `KiroAcpTransport` still failed at session creation with `KIRO_ACP_PROCESS_EXITED` because Kiro CLI 2.6.1 exits with code 0 after the current `session/new` request. Full ACP prompt E2E still needs the current Kiro ACP session schema confirmed before release.

package/docs/implementation-plan.md

@@ -46,7 +46,7 @@
 - `config` hook에서 `provider.kiro` 생성
 - `npm: "@ai-sdk/openai-compatible"` 설정
 - provider-level `api` 또는 `options.baseURL` 설정
-- fallback model metadata 주입
+- runtime discovery model metadata 주입
 - 사용자가 이미 정의한 provider/model 설정은 덮어쓰지 않고 merge
 - `enabled_providers`/`disabled_providers`와 충돌하지 않게 처리
 
@@ -54,7 +54,7 @@
 
 - 빈 config에 Kiro provider가 생깁니다.
 - 사용자 override가 유지됩니다.
-- model limit, modality, variant metadata가 기본값으로 들어갑니다.
+- discovery 또는 사용자 override에서 온 model limit, modality, variant metadata가 들어갑니다.
 
 ## Milestone 2: Model Resolver
 
@@ -72,9 +72,9 @@
   - TTL cache
   - stale detection
   - refresh coordination
-  - fallback preset loading
+  - explicit extra model loading
 - `src/models.ts`
-  - fallback preset only
+  - optional metadata helpers only
   - runtime validation에는 사용하지 않음
 - config knobs
   - `modelCacheTtlSeconds`
@@ -274,7 +274,7 @@ test/
 
 - Model churn
   - pass-through를 기본값으로 둡니다.
-  - fallback preset은 cache bootstrap과 UI 표시용으로만 씁니다.
+  - model picker는 runtime discovery 결과를 기준으로 하고, static preset을 사용 가능 모델처럼 표시하지 않습니다.
 
 - Credential safety
   - token 값을 로그에 남기지 않습니다.

package/docs/implementation-strategy.md

@@ -129,7 +129,7 @@ OpenCode에 Kiro provider를 plugin 형태로 추가합니다. 단, Kiro의 공
 3. Dynamic cache
    - Kiro model list API 또는 CLI discovery 결과를 TTL cache에 저장합니다.
    - cache가 비어 있거나 stale이면 refresh를 시도합니다.
-   - refresh 실패 시 fallback preset을 사용하되 경고를 남깁니다.
+   - refresh 실패 시 static preset을 사용 가능 모델처럼 표시하지 않습니다.
 
 4. Hidden/manual models
    - 공식 list에는 없지만 동작하는 모델을 user config로 추가할 수 있게 합니다.
@@ -160,8 +160,8 @@ OpenCode에 Kiro provider를 plugin 형태로 추가합니다. 단, Kiro의 공
 
 설계 원칙:
 
-- fallback preset은 마지막 안전망이지 truth source가 아닙니다.
-- `SUPPORTED_MODELS` 같은 상수는 UI 표시와 tests용으로만 사용하고 runtime validation에는 쓰지 않습니다.
+- static preset은 truth source가 아니며, 기본 model picker에 주입하지 않습니다.
+- `SUPPORTED_MODELS` 같은 상수는 tests나 opt-in metadata용으로만 사용하고 runtime validation에는 쓰지 않습니다.
 - 새 모델 출시는 config 업데이트 없이 pass-through로 먼저 사용할 수 있어야 합니다.
 - `/models` 또는 OpenCode provider model list는 cache + hidden + alias를 합친 view를 반환합니다.
 
@@ -174,7 +174,7 @@ src/
   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
+  models.ts         # optional 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
@@ -210,7 +210,7 @@ test/
 
 4. OpenCode integration
    - provide config injection or documented config snippet
-   - add model resolver with fallback presets
+   - add model resolver with runtime discovery and explicit extra models
    - expose a custom tool or command for diagnostics
 
 5. Tests

package/docs/kiro-integration-notes.md

@@ -114,7 +114,7 @@ Kiro 모델 목록은 tier, region, release timing에 따라 바뀔 수 있으
 - startup 시 model discovery를 시도합니다.
 - discovery 결과는 TTL cache에 저장합니다.
 - cache가 stale이면 background refresh를 시도합니다.
-- refresh 실패 시 fallback preset으로 시작합니다.
+- refresh 실패 시 static preset을 사용 가능 모델처럼 표시하지 않고, 사용자 `extraModels`와 pass-through만 허용합니다.
 - 사용자가 `hiddenModels`, `modelAliases`, `disabledModels`를 설정할 수 있게 합니다.
 - 알 수 없는 모델은 기본적으로 pass-through합니다.
 - Kiro가 거절한 경우 같은 model family의 후보를 제안합니다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bogyie/opencode-kiro-plugin",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "OpenCode plugin for using Kiro as a provider adapter",
   "type": "module",
   "main": "dist/index.js",
@@ -24,6 +24,7 @@
     "build": "npm run clean && tsc -p tsconfig.build.json",
     "prepack": "npm run build",
     "smoke:package": "npm run build && node scripts/smoke-package.mjs",
+    "smoke:kiro": "npm run build && node scripts/real-kiro-smoke.mjs",
     "test": "bun test test/*.test.ts",
     "typecheck": "tsc --noEmit"
   },