saeeol 1.0.9 → 1.1.1

package/npm/bin/saeeol

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+
+// saeeol bin wrapper — delegates to the downloaded platform binary
+const { existsSync, chmodSync } = require("fs")
+const { join, resolve } = require("path")
+const { spawn } = require("child_process")
+
+const binDir = join(__dirname, "..", "download")
+function getBinaryName() {
+  const archMap = { x64: "x64", arm64: "arm64" }
+  const platformMap = { win32: "windows", darwin: "darwin", linux: "linux" }
+  const p = platformMap[process.platform] || process.platform
+  const a = archMap[process.arch] || arch
+  const ext = process.platform === "win32" ? ".exe" : ""
+  return `saeeol-${p}-${a}${ext}`
+}
+
+const binaryName = getBinaryName()
+const binaryPath = join(binDir, binaryName)
+
+if (!existsSync(binaryPath)) {
+  console.error(`saeeol binary not found: ${binaryPath}`)
+  console.error(`Run: npm rebuild saeeol`)
+  console.error(`Or: https://github.com/byfabulist/saeeol/releases`)
+  process.exit(1)
+}
+
+if (process.platform !== "win32") {
+  try { chmodSync(binaryPath, 0o755) } catch {}
+}
+
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+  env: { ...process.env },
+  windowsHide: true,
+})
+
+child.on("exit", (code) => process.exit(code || 0))
+child.on("error", (err) => {
+  console.error(`Failed to start saeeol: ${err.message}`)
+  process.exit(1)
+})

package/npm/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "saeeol",
+  "version": "1.1.0",
+  "description": "AI agent engine for SAEEOL",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/byfabulist/saeeol"
+  },
+  "bin": {
+    "saeeol": "./bin/saeeol"
+  },
+  "files": [
+    "bin/",
+    "postinstall.js"
+  ],
+  "scripts": {
+    "postinstall": "node postinstall.js"
+  },
+  "dependencies": {},
+  "devDependencies": {},
+  "peerDependencies": {},
+  "overrides": {},
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "cli",
+    "coding",
+    "assistant",
+    "saeeol"
+  ]
+}

package/npm/postinstall.js

@@ -0,0 +1,162 @@
+#!/usr/bin/env node
+
+// saeeol postinstall — downloads platform binary from GitHub Releases
+const https = require("https")
+const http = require("http")
+const fs = require("fs")
+const path = require("path")
+const zlib = require("zlib")
+const { execSync } = require("child_process")
+
+const REPO = "byfabulist/saeeol"
+const VERSION = require("./package.json").version
+
+function getPlatformInfo() {
+  const archMap = { x64: "x64", arm64: "arm64" }
+  const platformMap = { win32: "windows", darwin: "darwin", linux: "linux" }
+  const p = platformMap[process.platform] || process.platform
+  const a = archMap[process.arch] || process.arch
+  const ext = process.platform === "win32" ? ".zip" : ".tar.gz"
+  const archiveName = `saeeol-${p}-${a}${ext}`
+  const binaryName = process.platform === "win32" ? "saeeol.exe" : "saeeol"
+  return { archiveName, binaryName, platform: p, arch: a }
+}
+
+function fetch(url, redirects = 5) {
+  return new Promise((resolve, reject) => {
+    const mod = url.startsWith("https") ? https : http
+    mod.get(url, { timeout: 60000 }, (res) => {
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        if (redirects <= 0) return reject(new Error("Too many redirects"))
+        return fetch(res.headers.location, redirects - 1).then(resolve, reject)
+      }
+      if (res.statusCode !== 200) {
+        return reject(new Error(`HTTP ${res.statusCode} for ${url}`))
+      }
+      const chunks = []
+      res.on("data", (chunk) => chunks.push(chunk))
+      res.on("end", () => resolve(Buffer.concat(chunks)))
+      res.on("error", reject)
+    }).on("error", reject)
+  })
+}
+
+async function extractTarGz(buffer, destDir, binaryName) {
+  // Use tar on non-windows, or platform tar on windows (git bash)
+  const tmpFile = path.join(destDir, "download.tar.gz")
+  fs.writeFileSync(tmpFile, buffer)
+  try {
+    if (process.platform === "win32") {
+      // Try PowerShell Expand-Archive for .tar.gz or just use tar if available
+      try {
+        execSync(`tar -xzf "${tmpFile}" -C "${destDir}"`, { stdio: "pipe", windowsHide: true })
+      } catch {
+        // Fallback: use zlib + tar parsing manually not practical, try powershell
+        throw new Error("tar command not available on Windows. Install Git Bash or add tar to PATH.")
+      }
+    } else {
+      execSync(`tar -xzf "${tmpFile}" -C "${destDir}"`, { stdio: "pipe" })
+    }
+  } finally {
+    try { fs.unlinkSync(tmpFile) } catch {}
+  }
+}
+
+async function extractZip(buffer, destDir, binaryName) {
+  if (process.platform === "win32") {
+    const tmpFile = path.join(destDir, "download.zip")
+    fs.writeFileSync(tmpFile, buffer)
+    try {
+      execSync(`powershell -Command "Expand-Archive -Path '${tmpFile}' -DestinationPath '${destDir}' -Force"`, {
+        stdio: "pipe",
+        windowsHide: true,
+      })
+    } finally {
+      try { fs.unlinkSync(tmpFile) } catch {}
+    }
+  } else {
+    // On non-windows, try unzip
+    const tmpFile = path.join(destDir, "download.zip")
+    fs.writeFileSync(tmpFile, buffer)
+    try {
+      execSync(`unzip -o "${tmpFile}" -d "${destDir}"`, { stdio: "pipe" })
+    } finally {
+      try { fs.unlinkSync(tmpFile) } catch {}
+    }
+  }
+}
+
+async function main() {
+  const { archiveName, binaryName, platform: p, arch: a } = getPlatformInfo()
+  const binDir = path.join(__dirname, "download")
+
+  // Check if binary already exists
+  const binaryPath = path.join(binDir, binaryName)
+  if (fs.existsSync(binaryPath)) {
+    console.log(`saeeol binary already exists at ${binaryPath}`)
+    return
+  }
+
+  fs.mkdirSync(binDir, { recursive: true })
+
+  const url = `https://github.com/${REPO}/releases/download/v${VERSION}/${archiveName}`
+  console.log(`Downloading saeeol v${VERSION} for ${p}-${a}...`)
+  console.log(`  ${url}`)
+
+  let buffer
+  try {
+    buffer = await fetch(url)
+  } catch (err) {
+    // Fallback: try without version tag (latest)
+    const fallbackUrl = `https://github.com/${REPO}/releases/latest/download/${archiveName}`
+    console.log(`Version-specific download failed: ${err.message}`)
+    console.log(`Trying latest: ${fallbackUrl}`)
+    try {
+      buffer = await fetch(fallbackUrl)
+    } catch (err2) {
+      console.error(`Failed to download saeeol binary: ${err2.message}`)
+      console.error(`Please download manually from: https://github.com/${REPO}/releases`)
+      process.exit(0) // Don't fail npm install
+    }
+  }
+
+  console.log(`Downloaded ${(buffer.length / 1024 / 1024).toFixed(1)} MB`)
+
+  // Extract
+  if (archiveName.endsWith(".tar.gz")) {
+    await extractTarGz(buffer, binDir, binaryName)
+  } else {
+    await extractZip(buffer, binDir, binaryName)
+  }
+
+  // Verify
+  if (!fs.existsSync(binaryPath)) {
+    // The archive might extract to a subdirectory, search for the binary
+    const files = fs.readdirSync(binDir, { recursive: true })
+    const found = files.find((f) => {
+      const basename = path.basename(f)
+      return basename === "saeeol" || basename === "saeeol.exe"
+    })
+    if (found) {
+      const fullPath = path.join(binDir, found)
+      fs.copyFileSync(fullPath, binaryPath)
+    }
+  }
+
+  if (fs.existsSync(binaryPath)) {
+    if (process.platform !== "win32") {
+      fs.chmodSync(binaryPath, 0o755)
+    }
+    console.log(`saeeol v${VERSION} installed successfully!`)
+    console.log(`  Binary: ${binaryPath}`)
+  } else {
+    console.warn(`Warning: binary not found after extraction at ${binaryPath}`)
+    console.warn(`You may need to install manually from https://github.com/${REPO}/releases`)
+  }
+}
+
+main().catch((err) => {
+  console.error(`saeeol postinstall failed: ${err.message}`)
+  console.error(`Install manually: https://github.com/${REPO}/releases`)
+  process.exit(0) // Don't fail npm install
+})

package/package.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
-  "version": "1.0.9",
+  "version": "1.1.1",
   "name": "saeeol",
   "type": "module",
   "license": "Apache-2.0",
@@ -134,8 +134,8 @@
     "@pierre/diffs": "1.1.0-beta.18",
     "@saeeol/boxes": "workspace:*",
     "@saeeol/core": "workspace:*",
-    "@saeeol/i18n": "workspace:*",
     "@saeeol/gateway": "workspace:*",
+    "@saeeol/i18n": "workspace:*",
     "@saeeol/indexing": "workspace:*",
     "@saeeol/plugin": "workspace:*",
     "@saeeol/script": "workspace:*",

package/src/cli/cmd/mcp-refresh.ts

@@ -0,0 +1,47 @@
+import { cmd } from "./cmd"
+import * as prompts from "@clack/prompts"
+import { UI } from "../ui"
+import { Instance } from "../../project/instance"
+import { configuredServers, listState } from "./mcp-shared"
+import { MCP } from "../../mcp"
+import { AppRuntime } from "../../effect/app-runtime"
+import { Effect } from "effect"
+
+export const McpRefreshCommand = cmd({
+  command: "refresh",
+  aliases: ["rf"],
+  describe: "refresh MCP server list from config",
+  async handler() {
+    await Instance.provide({
+      directory: process.cwd(),
+      async fn() {
+        UI.empty()
+        prompts.intro("Refresh MCP Servers")
+
+        const spinner = prompts.spinner()
+        spinner.start("Reconnecting...")
+
+        const statuses = await AppRuntime.runPromise(
+          Effect.gen(function* () {
+            const mcp = yield* MCP.Service
+            return yield* mcp.refresh()
+          }),
+        )
+
+        spinner.stop("Done")
+
+        const { config } = await listState()
+        const servers = configuredServers(config)
+
+        for (const [name] of servers) {
+          const s = statuses[name]
+          if (!s) continue
+          const icon = s.status === "connected" ? "✓" : s.status === "disabled" ? "○" : "✗"
+          prompts.log.info(`${icon} ${name} ${UI.Style.TEXT_DIM}${s.status}`)
+        }
+
+        prompts.outro(`${servers.length} server(s) refreshed`)
+      },
+    })
+  },
+})

package/src/cli/cmd/mcp.ts

@@ -3,6 +3,7 @@ import { McpListCommand } from "./mcp-list"
 import { McpAuthCommand, McpAuthListCommand } from "./mcp-auth"
 import { McpLogoutCommand } from "./mcp-logout"
 import { McpAddCommand } from "./mcp-add"
+import { McpRefreshCommand } from "./mcp-refresh"
 import { McpDebugCommand } from "./mcp-debug"
 
 export const McpCommand = cmd({
@@ -12,6 +13,7 @@ export const McpCommand = cmd({
     yargs
       .command(McpAddCommand)
       .command(McpListCommand)
+      .command(McpRefreshCommand)
       .command(McpAuthCommand)
       .command(McpLogoutCommand)
       .command(McpDebugCommand)
@@ -19,4 +21,4 @@ export const McpCommand = cmd({
   async handler() {},
 })
 
-export { McpListCommand, McpAuthCommand, McpAuthListCommand, McpLogoutCommand, McpAddCommand, McpDebugCommand }
+export { McpListCommand, McpAuthCommand, McpAuthListCommand, McpLogoutCommand, McpAddCommand, McpRefreshCommand, McpDebugCommand }

package/src/cli/cmd/tui/app-commands-core.tsx

@@ -132,6 +132,17 @@ export function registerCoreCommands(deps: CoreCommandDeps): CommandOption[] {
         dialog.replace(() => <DialogMcp />)
       },
     },
+    {
+      title: "Refresh MCP Servers",
+      value: "mcp.refresh",
+      category: t("cmd.cat.agent"),
+      slash: {
+        name: "mcp-refresh",
+      },
+      onSelect: async () => {
+        await local.mcp.refresh()
+      },
+    },
     {
       title: t("cmd.agent.cycle"),
       value: "agent.cycle",

package/src/cli/cmd/tui/app-commands-system.tsx

@@ -5,6 +5,7 @@ import open from "open"
 import { DialogStatus } from "@tui/component/dialog-status"
 import { DialogThemeList } from "@tui/component/dialog-theme-list"
 import { DialogHelp } from "@tui/ui/dialog-help"
+import * as Log from "@saeeol/core/util/log"
 
 type Dialog = ReturnType<typeof import("@tui/ui/dialog").useDialog>
 type KV = ReturnType<typeof import("@tui/context/kv").useKV>
@@ -111,6 +112,25 @@ export function registerSystemCommands(deps: SystemCommandDeps): CommandOption[]
       },
       category: t("cmd.cat.system"),
     },
+    {
+      title: "Open Log File",
+      value: "app.logs",
+      slash: {
+        name: "logs",
+      },
+      onSelect: () => {
+        const logPath = Log.file()
+        if (logPath) {
+          open(logPath).catch(() => {
+            toast.show({ variant: "error", message: logPath, duration: 10000 })
+          })
+        } else {
+          toast.show({ variant: "error", message: "No log file available", duration: 3000 })
+        }
+        dialog.clear()
+      },
+      category: t("cmd.cat.system"),
+    },
     {
       title: t("cmd.system.docs"),
       value: "docs.open",

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

@@ -5,6 +5,7 @@ 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"
+import * as Log from "@saeeol/core/util/log"
 
 type Event = ReturnType<typeof import("@tui/context/event").useEvent>
 type Command = ReturnType<typeof import("@tui/component/dialog-command").useCommandDialog>
@@ -26,6 +27,18 @@ export type EventDeps = {
   exit: Exit
 }
 
+// Session error auto-recovery state
+const MAX_SESSION_ERRORS = 3
+const ERROR_WINDOW_MS = 60_000 // 1 minute window
+const sessionErrors: { time: number; message: string }[] = []
+
+function trimOldErrors() {
+  const cutoff = Date.now() - ERROR_WINDOW_MS
+  while (sessionErrors.length > 0 && sessionErrors[0].time < cutoff) {
+    sessionErrors.shift()
+  }
+}
+
 export function registerAppEvents(deps: EventDeps) {
   const { event, command, toast, route, kv, dialog, sdk, exit } = deps
   event.on(TuiEvent.CommandExecute.type, (evt) => {
@@ -59,6 +72,36 @@ export function registerAppEvents(deps: EventDeps) {
     if (error && typeof error === "object" && error.name === "MessageAbortedError") return
     if (SaeeolApp.handleSessionError(error, toast)) return
     const message = errorMessage(error)
+
+    // Track error for auto-recovery
+    sessionErrors.push({ time: Date.now(), message })
+    trimOldErrors()
+
+    if (sessionErrors.length >= MAX_SESSION_ERRORS) {
+      // Auto-recovery: too many errors, start fresh session
+      sessionErrors.length = 0
+      const logPath = Log.file()
+      toast.show({
+        variant: "warning",
+        message: `Session unstable (${MAX_SESSION_ERRORS} errors in 1min). Starting new session.`,
+        duration: 5000,
+      })
+      route.navigate({ type: "home" })
+      dialog.clear()
+      // If still failing after auto-recovery, show log path
+      setTimeout(() => {
+        if (logPath) {
+          toast.show({
+            variant: "info",
+            title: "Log File",
+            message: logPath,
+            duration: 10000,
+          })
+        }
+      }, 6000)
+      return
+    }
+
     toast.show({
       variant: "error",
       message,

package/src/cli/cmd/tui/app.tsx

@@ -30,6 +30,7 @@ import { CommandProvider, useCommandDialog } from "@tui/component/dialog-command
 import { KeybindProvider, useKeybind } from "@tui/context/keybind"
 import { ThemeProvider, useTheme } from "@tui/context/theme"
 import { Home } from "@tui/routes/home"
+import { LocalModels } from "@tui/routes/local-models"
 import { Session } from "@tui/routes/session"
 import { PromptHistoryProvider } from "@tui/component/prompt/history"
 import { FrecencyProvider } from "@tui/component/prompt/frecency"
@@ -270,6 +271,9 @@ function App(props: { onSnapshot?: () => Promise<string[]> }) {
           <Match when={route.data.type === "saeeolclaw"}>
             <SaeeolApp.SaeeolClawView />
           </Match>
+          <Match when={route.data.type === "local-models"}>
+            <LocalModels />
+          </Match>
         </Switch>
       </Show>
       {plugin()}

package/src/cli/cmd/tui/component/dialog-model.tsx

@@ -41,7 +41,7 @@ export function DialogModel(props: { providerID?: string }) {
 
   const lookup = (providerID: string, modelID: string) => {
     const provider = sync.data.provider.find((x) => x.id === providerID)
-    const model = provider?.models[modelID]
+    const model = provider?.models?.[modelID]
     if (!provider || !model) return
     return {
       model,
@@ -71,7 +71,7 @@ export function DialogModel(props: { providerID?: string }) {
       return items.flatMap((item) => {
         const provider = sync.data.provider.find((x) => x.id === item.providerID)
         if (!provider) return []
-        const model = provider.models[item.modelID]
+        const model = provider.models?.[item.modelID]
         if (!model) return []
         return [
           {

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

@@ -142,7 +142,7 @@ export function usePromptMemos(deps: MemoDeps): PromptMemos {
     if (!last) return
     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 model = sync.data.provider.find((item) => item.id === last.providerID)?.models?.[last.modelID]
     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)

package/src/cli/cmd/tui/component/use-connected.tsx

@@ -5,7 +5,7 @@ export function useConnected() {
   const sync = useSync()
   return createMemo(() =>
     sync.data.provider.some(
-      (x) => (x.id !== "saeeol" && x.id !== "saeeol") || Object.values(x.models).some((y) => y.cost?.input !== 0),
+      (x) => (x.id !== "saeeol" && x.id !== "saeeol") || Object.values(x.models ?? {}).some((y) => y.cost?.input !== 0),
     ),
   )
 }

package/src/cli/cmd/tui/context/local.tsx

@@ -32,7 +32,7 @@ export const { use: useLocal, provider: LocalProvider } = createSimpleContext({
 
     function isModelValid(model: { providerID: string; modelID: string }) {
       const provider = sync.data.provider.find((x) => x.id === model.providerID)
-      return !!provider?.models[model.modelID]
+      return !!provider?.models?.[model.modelID]
     }
 
     function getFirstValidModel(...modelFns: (() => { providerID: string; modelID: string } | undefined)[]) {
@@ -280,7 +280,7 @@ export const { use: useLocal, provider: LocalProvider } = createSimpleContext({
             }
           }
           const provider = sync.data.provider.find((x) => x.id === value.providerID)
-          const info = provider?.models[value.modelID]
+          const info = provider?.models?.[value.modelID]
           return {
             provider: provider?.name ?? value.providerID,
             model: info?.name ?? value.modelID,
@@ -402,7 +402,7 @@ export const { use: useLocal, provider: LocalProvider } = createSimpleContext({
             const m = currentModel()
             if (!m) return []
             const provider = sync.data.provider.find((x) => x.id === m.providerID)
-            const info = provider?.models[m.modelID]
+            const info = provider?.models?.[m.modelID]
             if (!info?.variants) return []
             return Object.keys(info.variants)
           },
@@ -447,6 +447,13 @@ export const { use: useLocal, provider: LocalProvider } = createSimpleContext({
           await sdk.client.mcp.connect({ name })
         }
       },
+      async refresh() {
+        const workspace = project.workspace.current()
+        await (sdk.client as any).mcp._client.post({
+          url: "/mcp/refresh",
+          ...(workspace ? { workspace } : {}),
+        })
+      },
     }
     createEffect(() => {
       if (!model.ready) return

package/src/cli/cmd/tui/context/route.tsx

@@ -16,13 +16,17 @@ export type SaeeolClawRoute = {
   type: "saeeolclaw"
 }
 
+export type LocalModelsRoute = {
+  type: "local-models"
+}
+
 export type PluginRoute = {
   type: "plugin"
   id: string
   data?: Record<string, unknown>
 }
 
-export type Route = HomeRoute | SessionRoute | PluginRoute | SaeeolClawRoute 
+export type Route = HomeRoute | SessionRoute | PluginRoute | SaeeolClawRoute | LocalModelsRoute 
 
 export const { use: useRoute, provider: RouteProvider } = createSimpleContext({
   name: "Route",

package/src/cli/cmd/tui/feature-plugins/sidebar/context.tsx

@@ -26,7 +26,7 @@ function View(props: { api: TuiPluginApi; session_id: string }) {
 
     const tokens =
       last.tokens.input + last.tokens.output + last.tokens.reasoning + last.tokens.cache.read + last.tokens.cache.write
-    const model = props.api.state.provider.find((item) => item.id === last.providerID)?.models[last.modelID]
+    const model = props.api.state.provider.find((item) => item.id === last.providerID)?.models?.[last.modelID]
     return {
       tokens,
       percent: model?.limit.context ? Math.round((tokens / model.limit.context) * 100) : null,

package/src/cli/cmd/tui/plugin/api.tsx

@@ -96,11 +96,15 @@ function routeCurrent(route: ReturnType<typeof useRoute>): TuiPluginApi["route"]
     }
   }
   if (route.data.type === "saeeolclaw") return { name: "saeeolclaw" }
+  if (route.data.type === "local-models") return { name: "local-models" }
 
-  return {
-    name: route.data.id,
-    params: route.data.data,
+  if (route.data.type === "plugin") {
+    return {
+      name: route.data.id,
+      params: route.data.data,
+    }
   }
+  return { name: "unknown" }
 }
 
 function mapOption<Value>(item: TuiDialogSelectOption<Value>): SelectOption<Value> {