saeeol 1.0.7 → 1.0.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "name": "saeeol",
   "type": "module",
   "license": "Apache-2.0",
@@ -61,21 +61,21 @@
     "@parcel/watcher-win32-arm64": "2.5.1",
     "@parcel/watcher-win32-x64": "2.5.1",
     "@standard-schema/spec": "1.0.0",
-    "@tsconfig/bun": "catalog:",
+    "@tsconfig/bun": "1.0.9",
     "@types/babel__core": "7.20.5",
-    "@types/bun": "catalog:",
-    "@types/cross-spawn": "catalog:",
+    "@types/bun": "1.3.12",
+    "@types/cross-spawn": "6.0.6",
     "@types/mime-types": "3.0.1",
     "@types/npm-package-arg": "6.1.4",
     "@types/semver": "^7.5.8",
     "@types/turndown": "5.0.5",
     "@types/which": "3.0.4",
     "@types/yargs": "17.0.33",
-    "@typescript/native-preview": "catalog:",
-    "drizzle-kit": "catalog:",
-    "drizzle-orm": "catalog:",
+    "@typescript/native-preview": "7.0.0-dev.20260316.1",
+    "drizzle-kit": "1.0.0-beta.19-d95b7a4",
+    "drizzle-orm": "1.0.0-beta.19-d95b7a4",
     "prettier": "3.6.2",
-    "typescript": "catalog:",
+    "typescript": "5.8.2",
     "vscode-languageserver-types": "3.17.5",
     "why-is-node-running": "3.2.2",
     "zod-to-json-schema": "3.24.5",
@@ -107,31 +107,31 @@
     "@ai-sdk/xai": "3.0.82",
     "@aws-sdk/credential-providers": "3.1025.0",
     "@clack/prompts": "1.0.0-alpha.1",
-    "@effect/opentelemetry": "catalog:",
-    "@effect/platform-node": "catalog:",
+    "@effect/opentelemetry": "4.0.0-beta.57",
+    "@effect/platform-node": "4.0.0-beta.57",
     "@gitlab/gitlab-ai-provider": "3.6.0",
     "@hono/node-server": "1.19.13",
     "@hono/node-ws": "1.3.0",
     "@hono/standard-validator": "0.1.5",
-    "@hono/zod-validator": "catalog:",
-    "@lydell/node-pty": "catalog:",
+    "@hono/zod-validator": "0.4.2",
+    "@lydell/node-pty": "1.2.0-beta.10",
     "@modelcontextprotocol/sdk": "1.29.0",
     "@morphllm/morphsdk": "0.2.166",
     "@npmcli/arborist": "9.4.0",
     "@npmcli/config": "10.8.1",
     "@octokit/graphql": "9.0.2",
-    "@octokit/rest": "catalog:",
-    "@openauthjs/openauth": "catalog:",
+    "@octokit/rest": "22.0.0",
+    "@openauthjs/openauth": "0.0.0-20250322224806",
     "@openrouter/ai-sdk-provider": "2.8.1",
     "@opentelemetry/api": "1.9.0",
     "@opentelemetry/context-async-hooks": "2.6.1",
     "@opentelemetry/exporter-trace-otlp-http": "0.214.0",
     "@opentelemetry/sdk-trace-base": "2.6.1",
     "@opentelemetry/sdk-trace-node": "2.6.1",
-    "@opentui/core": "catalog:",
-    "@opentui/solid": "catalog:",
+    "@opentui/core": "0.2.2",
+    "@opentui/solid": "0.2.2",
     "@parcel/watcher": "2.5.1",
-    "@pierre/diffs": "catalog:",
+    "@pierre/diffs": "1.1.0-beta.18",
     "@saeeol/boxes": "workspace:*",
     "@saeeol/core": "workspace:*",
     "@saeeol/i18n": "workspace:*",
@@ -145,7 +145,7 @@
     "@solid-primitives/scheduled": "1.5.2",
     "@standard-schema/spec": "1.0.0",
     "@zip.js/zip.js": "2.7.62",
-    "ai": "catalog:",
+    "ai": "6.0.168",
     "ai-gateway-provider": "3.1.2",
     "bonjour-service": "1.3.0",
     "bun-pty": "0.4.8",
@@ -153,19 +153,19 @@
     "chokidar": "4.0.3",
     "cli-sound": "1.1.3",
     "clipboardy": "4.0.0",
-    "cross-spawn": "catalog:",
+    "cross-spawn": "7.0.6",
     "decimal.js": "10.5.0",
-    "diff": "catalog:",
-    "drizzle-orm": "catalog:",
-    "effect": "catalog:",
+    "diff": "8.0.4",
+    "drizzle-orm": "1.0.0-beta.19-d95b7a4",
+    "effect": "4.0.0-beta.57",
     "fuzzysort": "3.1.0",
     "gensync": "1.0.0-beta.2",
     "gitlab-ai-provider": "6.6.0",
     "glob": "13.0.5",
     "google-auth-library": "10.5.0",
     "gray-matter": "4.0.3",
-    "hono": "catalog:",
-    "hono-openapi": "catalog:",
+    "hono": "4.12.12",
+    "hono-openapi": "1.1.2",
     "iconv-lite": "0.7.2",
     "ignore": "7.0.5",
     "immer": "11.1.4",
@@ -174,33 +174,33 @@
     "minimatch": "10.2.5",
     "npm-package-arg": "13.0.2",
     "open": "10.1.2",
-    "opentui-spinner": "catalog:",
+    "opentui-spinner": "0.0.6",
     "partial-json": "0.1.7",
-    "remeda": "catalog:",
+    "remeda": "2.26.0",
     "ripgrep": "0.3.1",
     "rotating-file-stream": "3.2.9",
     "saeeol-gitlab-auth": "workspace:*",
     "saeeol-poe-auth": "workspace:*",
     "semver": "^7.6.3",
     "simple-git": "3.36.0",
-    "solid-js": "catalog:",
+    "solid-js": "1.9.12",
     "strip-ansi": "7.1.2",
     "tree-sitter-bash": "0.25.0",
     "tree-sitter-powershell": "0.25.10",
     "tree-sitter-wasms": "^0.1.12",
     "turndown": "7.2.0",
-    "ulid": "catalog:",
+    "ulid": "3.0.1",
     "venice-ai-sdk-provider": "2.0.1",
     "vscode-jsonrpc": "8.2.1",
     "web-tree-sitter": "0.25.10",
     "which": "6.0.1",
     "xdg-basedir": "5.1.0",
     "yargs": "18.0.0",
-    "zod": "catalog:",
+    "zod": "4.1.8",
     "zod-to-json-schema": "3.24.5"
   },
   "overrides": {
-    "drizzle-orm": "catalog:"
+    "drizzle-orm": "1.0.0-beta.19-d95b7a4"
   },
   "peerDependencies": {}
 }

package/specs/effect/http-api.md

@@ -189,23 +189,23 @@ Use raw Effect HTTP routes where `HttpApi` does not fit. The goal is deleting Ho
 
 ## Current Route Status
 
-| Area                      | Status            | Notes                                                                      |
-| ------------------------- | ----------------- | -------------------------------------------------------------------------- |
-| `question`                | `bridged`         | `GET /question`, reply, reject                                             |
-| `permission`              | `bridged`         | list and reply                                                             |
-| `provider`                | `bridged`         | list, auth, OAuth authorize/callback                                       |
-| `config`                  | `bridged`         | read, providers, update                                                    |
-| `project`                 | `bridged`         | list, current, git init, update                                            |
-| `file`                    | `bridged` partial | find text/file/symbol, list/content/status                                 |
-| `mcp`                     | `bridged`         | status, add, OAuth, connect/disconnect                                     |
-| `workspace`               | `bridged`         | adapter/list/status/create/remove/session-restore                          |
-| top-level instance routes | `bridged`         | path, vcs, command, agent, skill, lsp, formatter, dispose                  |
-| experimental JSON routes  | `bridged`         | console, tool, worktree list/mutations, global session list, resource list |
-| `session`                 | `bridged`         | read, lifecycle, prompt, message/part mutations, revert, permission reply  |
-| `sync`                    | `bridged`         | start/replay/history                                                       |
-| `event`                   | `bridged`         | SSE via raw Effect HTTP                                                    |
-| `pty`                     | `special`         | websocket                                                                  |
-| `tui`                     | `special`         | UI bridge                                                                  |
+| Area | Status | Notes |
+|---|---|---|
+| `question` | `bridged` | `GET /question`, reply, reject |
+| `permission` | `bridged` | list and reply |
+| `provider` | `bridged` | list, auth, OAuth authorize/callback |
+| `config` | `bridged` | read, providers, update |
+| `project` | `bridged` | list, current, git init, update |
+| `file` | `bridged` partial | find text/file/symbol, list/content/status |
+| `mcp` | `bridged` | status, add, OAuth, connect/disconnect |
+| `workspace` | `bridged` | adapter/list/status/create/remove/session-restore |
+| top-level instance routes | `bridged` | path, vcs, command, agent, skill, lsp, formatter, dispose |
+| experimental JSON routes | `bridged` | console, tool, worktree list/mutations, global session list, resource list |
+| `session` | `bridged` | read, lifecycle, prompt, message/part mutations, revert, permission reply |
+| `sync` | `bridged` | start/replay/history |
+| `event` | `bridged` | SSE via raw Effect HTTP |
+| `pty` | `special` | websocket |
+| `tui` | `special` | UI bridge |
 
 ## Full Route Checklist
 

package/src/cli/cmd/providers.ts

@@ -14,6 +14,7 @@ import { Instance } from "../../project/instance"
 import { Process } from "@/util/process"
 import { text } from "node:stream/consumers"
 import { Effect } from "effect"
+import { Npm } from "@saeeol/core/npm"
 import { put, handlePluginAuth, resolvePluginProviders } from "./providers-auth"
 
 const getModels = () => AppRuntime.runPromise(ModelsDev.Service.use((s) => s.get()))
@@ -24,7 +25,12 @@ export const ProvidersCommand = cmd({
   aliases: ["providers"],
   describe: "manage AI providers and credentials",
   builder: (yargs) =>
-    yargs.command(ProvidersListCommand).command(ProvidersLoginCommand).command(ProvidersLogoutCommand).demandCommand(),
+    yargs
+      .command(ProvidersListCommand)
+      .command(ProvidersLoginCommand)
+      .command(ProvidersLogoutCommand)
+      .command(ProvidersInstallCommand)
+      .demandCommand(),
   async handler() {},
 })
 
@@ -226,3 +232,71 @@ export const ProvidersLogoutCommand = cmd({
     })
   },
 })
+
+export const ProvidersInstallCommand = cmd({
+  command: "install [providers..]",
+  describe: "pre-install provider SDK packages (skip runtime download delay)",
+  builder: (yargs) =>
+    yargs.positional("providers", {
+      describe: "provider id(s) to install (e.g. anthropic openai google)",
+      type: "string",
+      array: true,
+    }),
+  async handler(args) {
+    await Instance.provide({
+      directory: process.cwd(),
+      async fn() {
+        UI.empty()
+        prompts.intro("Install provider SDKs")
+
+        await refreshModels().catch(() => {})
+        const database = await getModels()
+
+        // Build npm package → provider names mapping from models.dev data
+        const npmToNames: Record<string, Set<string>> = {}
+        for (const [id, info] of Object.entries(database)) {
+          const pkg = info.npm
+          if (!pkg) continue
+          if (!npmToNames[pkg]) npmToNames[pkg] = new Set()
+          npmToNames[pkg].add(info.name || id)
+        }
+
+        // Resolve target packages
+        const targets = args.providers?.length
+          ? args.providers
+          : await (async () => {
+              const options = Object.entries(npmToNames).map(([pkg, names]) => ({
+                label: [...names].join(", "),
+                value: pkg,
+                hint: pkg,
+              }))
+              const selected = await prompts.multiselect({
+                message: "Select providers to install",
+                options,
+                required: true,
+              })
+              if (prompts.isCancel(selected)) throw new UI.CancelledError()
+              return selected as string[]
+            })()
+
+        for (const target of targets) {
+          // If user typed a provider id (like "anthropic"), resolve to npm package
+          const pkg = npmToNames[target] ? target
+            : Object.entries(database).find(([id]) => id === target)?.[1]?.npm
+            ?? target
+
+          const spinner = prompts.spinner()
+          spinner.start(`Installing ${pkg}`)
+          try {
+            await Npm.add(pkg)
+            spinner.stop(`${pkg} installed`)
+          } catch (err) {
+            spinner.stop(`${pkg} failed: ${err instanceof Error ? err.message : String(err)}`)
+          }
+        }
+
+        prompts.outro("Done")
+      },
+    })
+  },
+})

package/src/cli/cmd/tui/app-events.ts

@@ -4,6 +4,7 @@ import { DialogConfirm } from "@tui/ui/dialog-confirm"
 import { DialogAlert } from "@tui/ui/dialog-alert"
 import { errorMessage } from "@tui/app-config"
 import * as SaeeolApp from "@/saeeol/cli/cmd/tui/app"
+import { ProviderInstallEvent } from "@/provider/provider-events"
 
 type Event = ReturnType<typeof import("@tui/context/event").useEvent>
 type Command = ReturnType<typeof import("@tui/component/dialog-command").useCommandDialog>
@@ -101,4 +102,35 @@ export function registerAppEvents(deps: EventDeps) {
     )
     void exit()
   })
+
+  // Provider SDK 동적 설치 진행 상태 표시
+  // subscribe() 사용 + 타입 단언 — SDK Event 유니온에 아직 타입이 없음
+  // SDK 재생성(provider-events 레지스트리 포함) 후 타입 안전하게 전환 가능
+  event.subscribe((raw: any) => {
+    const evt = raw as { type: string; properties: { providerID: string; pkg: string; error?: string } }
+    if (evt.type === ProviderInstallEvent.Started.type) {
+      toast.show({
+        title: "Installing Provider",
+        message: `Downloading ${evt.properties.pkg} for ${evt.properties.providerID}...`,
+        variant: "info",
+        duration: 60000,
+      })
+    }
+    if (evt.type === ProviderInstallEvent.Completed.type) {
+      toast.show({
+        title: "Provider Ready",
+        message: `${evt.properties.providerID} installed successfully`,
+        variant: "success",
+        duration: 3000,
+      })
+    }
+    if (evt.type === ProviderInstallEvent.Failed.type) {
+      toast.show({
+        title: "Installation Failed",
+        message: `Failed to install ${evt.properties.pkg}: ${evt.properties.error}`,
+        variant: "error",
+        duration: 10000,
+      })
+    }
+  })
 }

package/src/cli/cmd/tui/component/prompt/PromptStatusBar.tsx

@@ -21,7 +21,7 @@ export type PromptStatusBarProps = {
     exitPress: number
   }
   hint: any
-  usage: () => { context: string; cost?: string } | undefined
+  usage: () => { context: string; cost?: string; health: string; remaining?: number; pct: number } | undefined
   borderHighlight: () => any
   spinnerDef: () => { frames: any; color: any }
   editorFileLabelDisplay: () => string | undefined
@@ -128,11 +128,20 @@ export function PromptStatusBar(props: PromptStatusBarProps) {
               <Match when={props.store.mode === "normal"}>
                 <Switch>
                   <Match when={props.usage()}>
-                    {(item) => (
-                      <text fg={theme.textMuted} wrapMode="none">
-                        {[item().context, item().cost].filter(Boolean).join(" · ")}
-                      </text>
-                    )}
+                    {(item) => {
+                      const u = item()
+                      const color = u.health === "critical"
+                        ? theme.error
+                        : u.health === "warning"
+                          ? theme.warning
+                          : theme.textMuted
+                      const parts = [u.context, u.cost].filter(Boolean)
+                      return (
+                        <text fg={color} wrapMode="none">
+                          {parts.join(" · ")}
+                        </text>
+                      )
+                    }}
                   </Match>
                   <Match when={true}>
                     <text fg={theme.text}>

package/src/cli/cmd/tui/component/prompt/use-prompt-memos.ts

@@ -47,7 +47,7 @@ export function formatEditorContext(selection: EditorSelection) {
 
 export type PromptMemos = {
   status: () => { type: string }
-  usage: () => { context: string; cost?: string } | undefined
+  usage: () => { context: string; cost?: string; health: string; remaining?: number; pct: number } | undefined
   currentProviderLabel: () => string
   hasRightContent: () => boolean
   editorContext: () => EditorSelection | undefined
@@ -143,11 +143,17 @@ export function usePromptMemos(deps: MemoDeps): PromptMemos {
     const tokens = last.tokens.input + last.tokens.output + last.tokens.reasoning + last.tokens.cache.read + last.tokens.cache.write
     if (tokens <= 0) return
     const model = sync.data.provider.find((item) => item.id === last.providerID)?.models[last.modelID]
-    const pct = model?.limit.context ? `${Math.round((tokens / model.limit.context) * 100)}%` : undefined
+    const contextLimit = model?.limit.context ?? 0
+    const pct = contextLimit ? Math.round((tokens / contextLimit) * 100) : 0
     const cost = msg.reduce((sum, item) => sum + (item.role === "assistant" ? item.cost : 0), 0)
+    const health = !contextLimit ? "ok" : pct >= 90 ? "critical" : pct >= 75 ? "warning" : "ok"
+    const remaining = contextLimit ? Math.max(0, contextLimit - tokens) : undefined
     return {
-      context: pct ? `${Locale.number(tokens)} (${pct})` : Locale.number(tokens),
+      context: contextLimit ? `${Locale.number(tokens)} (${pct}%)` : Locale.number(tokens),
       cost: cost > 0 ? money.format(cost) : undefined,
+      health,
+      remaining,
+      pct,
     }
   })
 

package/src/index.ts

@@ -11,52 +11,10 @@ import { hideBin } from "yargs/helpers"
 // ║  MASTER = CODE + web + remote + analytics                         ║
 // ╚══════════════════════════════════════════════════════════════════╝
 
-// ── LIGHT: core ────────────────────────────────────────────────────
-import { TuiThreadCommand } from "./cli/cmd/tui/thread"
-import { RunCommand } from "./cli/cmd/run"
-import { GenerateCommand } from "./cli/cmd/generate"
-import { SessionCommand } from "./cli/cmd/session"
-
-// ── LIGHT: llm ─────────────────────────────────────────────────────
-import { InitCommand } from "./cli/cmd/init"
-import { ProvidersCommand } from "./cli/cmd/providers"
-import { ModelsCommand } from "./cli/cmd/models"
-import { ConfigCommand as ConfigCLICommand } from "./cli/cmd/config"
-
-// ── LIGHT: lifecycle ───────────────────────────────────────────────
-import { UpgradeCommand } from "./cli/cmd/upgrade"
-import { UninstallCommand } from "./cli/cmd/uninstall"
-
-// ── CODE: server ───────────────────────────────────────────────────
-import { ServeCommand } from "./cli/cmd/serve"
-import { AttachCommand } from "./cli/cmd/tui/attach"
-import { AcpCommand } from "./cli/cmd/acp"
-
-// ── CODE: tools ────────────────────────────────────────────────────
-import { McpCommand } from "./cli/cmd/mcp"
-import { PluginCommand } from "./cli/cmd/plug"
-
-// ── CODE: data ─────────────────────────────────────────────────────
-import { ExportCommand } from "./cli/cmd/export"
-import { ImportCommand } from "./cli/cmd/import"
-import { DbCommand } from "./cli/cmd/db"
-
-// ── CODE: dev (선택) ───────────────────────────────────────────────
-import { AgentCommand } from "./cli/cmd/agent"
-import { DebugCommand } from "./cli/cmd/debug"
-
-// ── MASTER: web ────────────────────────────────────────────────────
-import { WebCommand } from "./cli/cmd/web"
-
-// ── MASTER: remote (선택) ──────────────────────────────────────────
-import { RemoteCommand } from "./cli/cmd/remote"
-
-// ── MASTER: analytics (선택) ───────────────────────────────────────
-import { StatsCommand } from "./cli/cmd/stats"
-import { PrCommand } from "./cli/cmd/pr"
-import { RollCallCommand } from "./saeeol/cli/cmd/roll-call"
+import type { Tier } from "./addons/types"
+import { commandsForTier, manifest } from "./addons/registry"
 
-// ── DEV 전용 ───────────────────────────────────────────────────────
+// ── DEV 전용 (항상 포함) ────────────────────────────────────────────
 import { DevSetupCommand, DevAliasCommand } from "./saeeol/cli/dev-setup"
 
 // ── 공통 ────────────────────────────────────────────────────────────
@@ -82,8 +40,7 @@ import { errorMessage } from "./util/error"
 import { Heap } from "./cli/heap"
 import { drizzle } from "drizzle-orm/bun-sqlite"
 import { ensureProcessMetadata } from "@saeeol/core/util/saeeol-process"
-import type { Tier } from "./addons/types"
-import { addonsForTier, manifest } from "./addons/registry"
+
 
 if (!process.env[ENV_FEATURE]) {
   const isServe = process.argv.includes("serve")
@@ -235,70 +192,18 @@ let cli = yargs(args)
   .usage("")
   .completion("completion", "generate shell completion script")
 
-  // ════════════════════════════════════════════════════════════════
-  //   LIGHT: core (TUI 채팅 + 프롬프트 + 세션)
-  // ════════════════════════════════════════════════════════════════
-  .command(TuiThreadCommand)      // [default]   TUI 채팅
-  .command(RunCommand)            // run         프롬프트 실행
-  .command(GenerateCommand)       // generate    코드 생성
-  .command(SessionCommand)        // session     세션 관리
-
-  // ════════════════════════════════════════════════════════════════
-  //   LIGHT: llm (provider + 모델 + 설정)
-  // ════════════════════════════════════════════════════════════════
-  .command(InitCommand)           // init        최초 설정
-  .command(ProvidersCommand)      // auth        provider 인증
-  .command(ModelsCommand)         // models      모델 목록
-  .command(ConfigCLICommand)      // config      설정 관리
-
-  // ════════════════════════════════════════════════════════════════
-  //   LIGHT: lifecycle (설치/업그레이드/제거)
-  // ════════════════════════════════════════════════════════════════
-  .command(UpgradeCommand)        // upgrade     버전 업그레이드
-  .command(UninstallCommand)      // uninstall   제거
-
-  // ════════════════════════════════════════════════════════════════
-  //   CODE: server (headless + 원격 + ACP)
-  // ════════════════════════════════════════════════════════════════
-  .command(ServeCommand)          // serve       headless 서버
-  .command(AttachCommand)         // attach      원격 연결
-  .command(AcpCommand)            // acp         ACP 서버
+// ════════════════════════════════════════════════════════════════
+//   애드온 기반 명령어 등록
+//   SAEEOL_TIER define에 따라 활성 애드온이 결정됨
+// ════════════════════════════════════════════════════════════════
 
-  // ════════════════════════════════════════════════════════════════
-  //   CODE: tools (MCP + 플러그인)
-  // ════════════════════════════════════════════════════════════════
-  .command(McpCommand)            // mcp         MCP 서버 관리
-  .command(PluginCommand)         // plugin      플러그인
-
-  // ════════════════════════════════════════════════════════════════
-  //   CODE: data (export + import + db)
-  // ════════════════════════════════════════════════════════════════
-  .command(ExportCommand)         // export      세션 내보내기
-  .command(ImportCommand)         // import      세션 가져오기
-  .command(DbCommand)             // db          데이터베이스
-
-  // ════════════════════════════════════════════════════════════════
-  //   CODE: dev (선택)
-  // ════════════════════════════════════════════════════════════════
-  .command(AgentCommand)          // agent       에이전트 관리
-  .command(DebugCommand)          // debug       디버깅
-
-  // ════════════════════════════════════════════════════════════════
-  //   MASTER: web (브라우저 채팅 UI)
-  // ════════════════════════════════════════════════════════════════
-  .command(WebCommand)            // web         웹 UI + 브라우저
-
-  // ════════════════════════════════════════════════════════════════
-  //   MASTER: remote (선택)
-  // ════════════════════════════════════════════════════════════════
-  .command(RemoteCommand)         // remote      실시간 릴레이
+declare const SAEEOL_TIER: string
+const tier = (typeof SAEEOL_TIER === "string" ? SAEEOL_TIER : "master") as Tier
+const addonCommands = await commandsForTier(tier)
+for (const cmd of addonCommands) {
+  cli = cli.command(cmd)
+}
 
-  // ════════════════════════════════════════════════════════════════
-  //   MASTER: analytics (선택)
-  // ════════════════════════════════════════════════════════════════
-  .command(StatsCommand)          // stats       사용량 통계
-  .command(PrCommand)             // pr          GitHub PR
-  .command(RollCallCommand)       // roll-call   모델 연결 테스트
 if (InstallationBuildKind !== "release") {
   cli = cli.command(DevSetupCommand).command(DevAliasCommand)
 }

package/src/provider/bundled-providers.ts

@@ -25,12 +25,12 @@ type ProviderLoader = () => Promise<(opts: any) => BundledSDK>
 // Bun은 조건에 맞지 않는 branch의 import()를 dead code로 처리
 
 function getProviders(): Record<string, ProviderLoader> {
-  if (SAEEOL_TIER === "light") {
-    // Bun replaces SAEEOL_TIER with literal, dead-eliminates else branches
+  const tier = typeof SAEEOL_TIER === "string" ? SAEEOL_TIER : "master"
+  if (tier === "light") {
     const m = require("./tiers/light") as typeof import("./tiers/light")
     return m.lightProviders
   }
-  if (SAEEOL_TIER === "code") {
+  if (tier === "code") {
     const m = require("./tiers/code") as typeof import("./tiers/code")
     return m.codeProviders
   }

package/src/provider/provider-events.ts

@@ -0,0 +1,29 @@
+import { BusEvent } from "@/bus/bus-event"
+import { Schema } from "effect"
+
+// Provider SDK 동적 설치 이벤트 — TUI/웹뷰에서 구독하여 설치 진행 상태 표시
+// BusEvent.define 호출로 전역 레지스트리에 자동 등록됨
+export const ProviderInstallEvent = {
+  Started: BusEvent.define(
+    "provider.install.started",
+    Schema.Struct({
+      providerID: Schema.String,
+      pkg: Schema.String,
+    }),
+  ),
+  Completed: BusEvent.define(
+    "provider.install.completed",
+    Schema.Struct({
+      providerID: Schema.String,
+      pkg: Schema.String,
+    }),
+  ),
+  Failed: BusEvent.define(
+    "provider.install.failed",
+    Schema.Struct({
+      providerID: Schema.String,
+      pkg: Schema.String,
+      error: Schema.String,
+    }),
+  ),
+}

package/src/provider/provider-resolve.ts

@@ -5,7 +5,9 @@ import { NoSuchModelError, type Provider as SDK } from "ai"
 import * as Log from "@saeeol/core/util/log"
 import { Npm } from "@saeeol/core/npm"
 import { Hash } from "@saeeol/core/util/hash"
+import * as Bus from "@/bus"
 import { BUNDLED_PROVIDERS } from "./bundled-providers"
+import { ProviderInstallEvent } from "./provider-events"
 import { buildTimeoutSignal } from "@/saeeol/provider/provider"
 import { InitError } from "./provider-types"
 import type { State, BundledSDK } from "./provider-types"
@@ -182,9 +184,27 @@ export async function resolveSDK(model: Model, s: State, envs: Record<string, st
 
     let installedPath: string
     if (!model.api.npm.startsWith("file://")) {
-      const item = await Npm.add(model.api.npm)
-      if (!item.entrypoint) throw new Error(`Package ${model.api.npm} has no import entrypoint`)
-      installedPath = item.entrypoint
+      log.info("installing provider package", { providerID: model.providerID, pkg: model.api.npm })
+      void Bus.publish(ProviderInstallEvent.Started, {
+        providerID: model.providerID,
+        pkg: model.api.npm,
+      })
+      try {
+        const item = await Npm.add(model.api.npm)
+        if (!item.entrypoint) throw new Error(`Package ${model.api.npm} has no import entrypoint`)
+        installedPath = item.entrypoint
+        void Bus.publish(ProviderInstallEvent.Completed, {
+          providerID: model.providerID,
+          pkg: model.api.npm,
+        })
+      } catch (installErr) {
+        void Bus.publish(ProviderInstallEvent.Failed, {
+          providerID: model.providerID,
+          pkg: model.api.npm,
+          error: installErr instanceof Error ? installErr.message : String(installErr),
+        })
+        throw installErr
+      }
     } else {
       log.info("loading local provider", { pkg: model.api.npm })
       installedPath = model.api.npm

package/src/provider/tiers/code.ts

@@ -1,6 +1,5 @@
 // CODE 티어 provider 맵 — LIGHT + 개발용 provider
 import type { BundledSDK } from "../../provider/provider-types"
-import { createSaeeol } from "@saeeol/gateway"
 import { lightProviders } from "./light"
 
 type L = () => Promise<(opts: any) => BundledSDK>