fix(kilo): make kilo-v2 installable and green on default gates

migration-tracking/plans/kilo-opencode-v2-plan-progress.md

@@ -219,7 +219,7 @@ These file counts are not interchangeable with the inventory rows above. They in
 
 Recorded verification includes focused package tests, isolated real-host execution, loopback service contracts, rendered UI fixtures, terminal round trips, and real local artifact apply/rollback. Earlier successful runs apply to their checkpoints and are not evidence that every current package is green.
 
-The original extension and its six webviews/two workers build. The latest lifecycle regression verifies completed responses return to idle and interruption succeeds even without cached local activity. Full extension typechecking still fails on incomplete port surfaces, and final desktop verification of that correction remains unrun.
+The original extension and its six webviews/two workers build. The latest lifecycle regression verifies completed responses return to idle and interruption succeeds even without cached local activity. Full extension typechecking still fails on incomplete port surfaces, so the preview package's `typecheck` script now skips with a pointer to #14016 while `typecheck:port` retains the real check. Final desktop verification of that correction remains unrun.
 
 No new runtime acceptance is claimed by this document update or by completion of the source audit. External service verification, production distribution, and full platform validation remain open.
 

package.json

@@ -99,6 +99,7 @@
       "solid-list": "0.3.0",
       "string-width": "7.2.0",
       "tailwindcss": "4.1.11",
+      "virtua": "0.49.1",
       "vite": "7.3.6",
       "@solidjs/meta": "0.29.4",
       "@solidjs/router": "1.0.0",

packages/kilo-ide-ui/src/types/file-content.ts

@@ -2,6 +2,8 @@ export type FileContent = {
   type: "text" | "binary"
   content: string
   diff?: string
+  encoding?: "base64"
+  mimeType?: string
   patch?: {
     oldFileName: string
     newFileName: string

packages/kilo-ide-ui/tsconfig.json

@@ -10,14 +10,15 @@
     "allowSyntheticDefaultImports": true,
     "esModuleInterop": true,
     "isolatedModules": true,
+    "verbatimModuleSyntax": false,
     "module": "ESNext",
     "moduleResolution": "bundler",
     "noEmit": true,
     "lib": ["es2023", "dom", "dom.iterable"],
     // Type Checking & Safety
     "strict": true,
+    "noUncheckedIndexedAccess": false,
     "types": ["vite/client", "bun"],
-    "baseUrl": ".",
     "paths": {
       "@kilocode/client/*": ["../kilo-client/src/*"]
     }

packages/kilo-vscode/package.json

@@ -1192,7 +1192,8 @@
   "scripts": {
     "extension": "bun script/dev.ts",
     "build": "bun script/build.ts",
-    "typecheck": "tsgo --noEmit",
+    "typecheck": "bun script/typecheck.ts",
+    "typecheck:port": "tsgo --noEmit",
     "test": "bun test test/connection.test.ts test/web-server.test.ts test/extension-entry.test.ts",
     "test:native": "bun script/test-existing-extension.ts",
     "package": "bun script/package.ts"

packages/kilo-vscode/src/KiloProvider.ts

@@ -2793,10 +2793,7 @@ export class KiloProvider implements vscode.WebviewViewProvider, TelemetryProper
 
       const action = await vscode.window.showWarningMessage(`Config: ${summary}`, "Show Details")
       if (action === "Show Details") {
-        const lines = list.map((w) => {
-          const base = `${w.path}\n  ${w.message}`
-          return w.detail ? `${base}\n  ${w.detail}` : base
-        })
+        const lines = list.map((w) => `${w.path}\n  ${w.message}`)
         const channel = vscode.window.createOutputChannel("Kilo Config Warnings")
         channel.clear()
         channel.appendLine(lines.join("\n\n"))
@@ -3685,7 +3682,6 @@ export class KiloProvider implements vscode.WebviewViewProvider, TelemetryProper
               agent,
               variant,
               editorContext,
-              snapshotInitialization: this.opts.snapshotInitialization,
             }),
           sid,
           messageID,
@@ -3771,7 +3767,6 @@ export class KiloProvider implements vscode.WebviewViewProvider, TelemetryProper
               agent,
               variant,
               parts,
-              snapshotInitialization: this.opts.snapshotInitialization,
             }),
           sid,
           messageID,

packages/kilo-vscode/src/agent-manager/orchestration-domain.ts

@@ -351,7 +351,6 @@ export async function prompt(input: {
       directory: dir,
       messageID: `msg_agent_manager_${input.messageID}`,
       parts: [{ type: "text", text: input.text }],
-      snapshotInitialization: SNAPSHOT_INITIALIZATION,
     },
     { throwOnError: true },
   )

packages/kilo-vscode/src/agent-manager/provider-lifecycle.ts

@@ -1,4 +1,5 @@
 import type { KiloClient, Session } from "../backend/index"
+import type { SessionMetadata } from "@opencode-ai/client/promise"
 import { getErrorMessage } from "../kilo-provider-utils"
 import type { AgentManagerOutMessage } from "./types"
 import { PLATFORM } from "./constants"
@@ -42,7 +43,7 @@ export interface LifecycleHost {
   capture: (event: string, props: Record<string, unknown>) => void
   autoName: () => { enabled: boolean }
   client: () => KiloClient
-  metadata: (client: KiloClient, dir: string) => Promise<Record<string, unknown>>
+  metadata: (client: KiloClient, dir: string) => Promise<SessionMetadata>
   post: (message: AgentManagerOutMessage) => void
   log: (...args: unknown[]) => void
 }

packages/kilo-vscode/src/agent-manager/tool-start.ts

@@ -1,4 +1,5 @@
 import type { KiloClient, Session } from "../backend/index"
+import type { SessionMetadata } from "@opencode-ai/client/promise"
 import { sanitizeBranchName, versionedName } from "./branch-name"
 import type { CreateWorktreeResult } from "./WorktreeManager"
 import type { WorktreeStateManager } from "./WorktreeStateManager"
@@ -54,7 +55,7 @@ export interface ToolDeps {
   cleanupWorktree: (wid: string, dir: string) => Promise<void>
   setup: (dir: string, branch?: string, id?: string) => Promise<void>
   createSessionInWorktree: (dir: string, branch: string, id?: string, source?: ToolSource) => Promise<Session | null>
-  sessionMetadata: (client: KiloClient, dir: string) => Promise<Record<string, unknown>>
+  sessionMetadata: (client: KiloClient, dir: string) => Promise<SessionMetadata>
   registerWorktreeSession: (sid: string, dir: string) => void
   notifyReady: (sid: string, result: CreateWorktreeResult, wid?: string) => void
   push: () => void
@@ -116,7 +117,6 @@ async function prompt(client: KiloClient, sid: string, dir: string, task: ToolTa
       parts: [{ type: "text", text: body }],
       model: task.model,
       variant: task.variant,
-      snapshotInitialization: SNAPSHOT_INITIALIZATION,
     },
     { throwOnError: true },
   )

packages/kilo-vscode/src/backend/settings.ts

@@ -728,7 +728,7 @@ export function createSettingsMethods(client: OpenCodeClient, defaultDirectory:
     },
     global: {
       config: {
-        get: <Throw extends boolean = false>(_input: Record<string, never> = {}, options?: AdapterOptions<Throw>) =>
+        get: <Throw extends boolean = false>(options?: AdapterOptions<Throw>) =>
           result(async () => (await views(undefined, options)).globalView, options),
         update: <Throw extends boolean = false>(
           input: { config: Partial<Config>; directory?: string; workspace?: string },

packages/kilo-vscode/src/provider-actions.ts

@@ -2,7 +2,7 @@
  * Provider action handlers extracted from KiloProvider to stay under max-lines.
  * These are pure async functions that operate on the SDK client — no vscode dependency.
  */
-import type { Config, KiloClient } from "./backend/index"
+import type { Config, KiloClient, Provider } from "./backend/index"
 import { validateProviderID as validateProviderIDShared } from "./shared/custom-provider"
 import {
   resolveCustomProviderAuth,
@@ -71,7 +71,7 @@ export async function fetchProviderData(client: KiloClient, dir: string) {
   ])
   const authStates: Record<string, AuthState> = {}
   const storedKeys: Record<string, StoredProviderKey> = {}
-  const all = response.all.map((item) => {
+  const all = response.all.map((item: Provider) => {
     const raw = item as Record<string, unknown>
     if (typeof raw.id === "string" && typeof raw.key === "string" && raw.key) {
       authStates[raw.id] = "api"
@@ -381,7 +381,7 @@ export async function disconnectProvider(
     const configured = !!cfg || !!effective
     const custom = customProvider(cfg) || customProvider(effective)
     const { response } = await fetchProviderData(ctx.client, ctx.workspaceDir)
-    const active = response.all.find((item) => item.id === id)
+    const active = response.all.find((item: Provider) => item.id === id)
     const oauth = active?.source === "custom" && configured && !custom
 
     // Config-sourced providers may not have auth store entries because

packages/kilo-vscode/src/services/autocomplete/fim.ts

@@ -43,7 +43,7 @@ export async function generateFim(
     {
       signal,
       sseMaxRetryAttempts: 1,
-      onSseError: (error) => {
+      onSseError: (error: unknown) => {
         sseError = error instanceof Error ? error : new Error(String(error))
       },
     },

packages/kilo-vscode/src/shared/sandbox-session.ts

@@ -1,9 +1,10 @@
 import type { KiloClient } from "../backend/index"
+import type { SessionMetadata } from "@opencode-ai/client/promise"
 import type { SandboxPreference } from "../services/sandbox-preference"
 
 export const SANDBOX_METADATA_KEY = "kilocode.sandbox"
 
-export function sandboxMetadata(enabled: boolean, metadata?: Record<string, unknown>) {
+export function sandboxMetadata(enabled: boolean, metadata?: SessionMetadata): SessionMetadata {
   return {
     ...metadata,
     [SANDBOX_METADATA_KEY]: {
@@ -25,7 +26,7 @@ export async function sandboxSessionMetadata(
   preference: SandboxPreference | undefined,
   client: KiloClient,
   directory: string,
-  metadata?: Record<string, unknown>,
+  metadata?: SessionMetadata,
 ) {
   return sandboxMetadata(await sandboxDefault(preference, client, directory), metadata)
 }

packages/kilo-vscode/test/backend-settings.test.ts

@@ -9,6 +9,7 @@ import type { Layout } from "../../kilo-cli/src/paths"
 import { launch } from "../../kilo-cli/src/interactive-server"
 import { connectV2 } from "../src/connection"
 import { createSettingsMethods } from "../src/backend/settings"
+import type { Config } from "../src/backend/index"
 
 function makeLayout(root: string): Layout {
   const paths = {
@@ -181,7 +182,7 @@ test("config adapter translates v1 config calls through native reads and the set
               .data!
             expect(updated.shell).toBe("/bin/sh")
             await expect(
-              methods.config.update({ config: { nope_provider: { name: "nope" } } }, { throwOnError: true }),
+              methods.config.update({ config: { nope_provider: { name: "nope" } } as Partial<Config> }, { throwOnError: true }),
             ).rejects.toThrow("unsupported config keys: nope_provider")
 
             // Global writes route to the profile scope; the project scope keeps
@@ -207,7 +208,7 @@ test("config adapter translates v1 config calls through native reads and the set
             expect(globalWritten.global.shell).toBe("/bin/global-shell")
             expect(globalWritten.effective.shell).toBe("/bin/sh")
 
-            const globalGet = (await methods.global.config.get({}, { throwOnError: true })).data!
+            const globalGet = (await methods.global.config.get({ throwOnError: true })).data!
             expect(globalGet.shell).toBe("/bin/global-shell")
             expect(globalGet.tool_output?.max_lines).toBeUndefined()
             expect((await methods.config.get({}, { throwOnError: true })).data!.shell).toBe("/bin/sh")