saeeol 1.4.1 → 1.4.3

package/src/cli/cmd/web.ts

@@ -1,92 +0,0 @@
-import { Server } from "../../server/server"
-import { UI } from "../ui"
-import { cmd } from "./cmd"
-import { withNetworkOptions, resolveNetworkOptions } from "../network"
-import { Flag } from "@saeeol/core/flag/flag"
-import { InstanceStore } from "../../project/instance-store" 
-import open from "open"
-import { networkInterfaces } from "os"
-
-function getNetworkIPs() {
-  const nets = networkInterfaces()
-  const results: string[] = []
-
-  for (const name of Object.keys(nets)) {
-    const net = nets[name]
-    if (!net) continue
-
-    for (const netInfo of net) {
-      // Skip internal and non-IPv4 addresses
-      if (netInfo.internal || netInfo.family !== "IPv4") continue
-
-      // Skip Docker bridge networks (typically 172.x.x.x)
-      if (netInfo.address.startsWith("172.")) continue
-
-      results.push(netInfo.address)
-    }
-  }
-
-  return results
-}
-
-export const WebCommand = cmd({
-  command: "web",
-  builder: (yargs) => withNetworkOptions(yargs),
-  describe: "start saeeol server and open web interface", 
-  handler: async (args) => {
-    if (!Flag.SAEEOL_SERVER_PASSWORD) {
-      UI.println(UI.Style.TEXT_WARNING_BOLD + "!  SAEEOL_SERVER_PASSWORD is not set; server is unsecured.")
-    }
-    const opts = await resolveNetworkOptions(args)
-    const server = await Server.listen(opts)
-    UI.empty()
-    UI.println(UI.logo("  "))
-    UI.empty()
-
-    if (opts.hostname === "0.0.0.0") {
-      // Show localhost for local access
-      const localhostUrl = `http://localhost:${server.port}`
-      UI.println(UI.Style.TEXT_INFO_BOLD + "  Local access:      ", UI.Style.TEXT_NORMAL, localhostUrl)
-
-      // Show network IPs for remote access
-      const networkIPs = getNetworkIPs()
-      if (networkIPs.length > 0) {
-        for (const ip of networkIPs) {
-          UI.println(
-            UI.Style.TEXT_INFO_BOLD + "  Network access:    ",
-            UI.Style.TEXT_NORMAL,
-            `http://${ip}:${server.port}`,
-          )
-        }
-      }
-
-      if (opts.mdns) {
-        UI.println(
-          UI.Style.TEXT_INFO_BOLD + "  mDNS:              ",
-          UI.Style.TEXT_NORMAL,
-          `${opts.mdnsDomain}:${server.port}`,
-        )
-      }
-
-      // Open localhost in browser
-      open(localhostUrl.toString()).catch(() => {})
-    } else {
-      const displayUrl = server.url.toString()
-      UI.println(UI.Style.TEXT_INFO_BOLD + "  Web interface:    ", UI.Style.TEXT_NORMAL, displayUrl)
-      open(displayUrl).catch(() => {})
-    }
-    const abort = new AbortController()
-    const shutdown = async () => {
-      try {
-        await InstanceStore.disposeAllInstances()
-        await server.stop(true)
-      } finally {
-        abort.abort()
-      }
-    }
-    process.on("SIGTERM", shutdown)
-    process.on("SIGINT", shutdown)
-    process.on("SIGHUP", shutdown)
-    await new Promise((resolve) => abort.signal.addEventListener("abort", resolve))
-  },
-})

package/src/cli/effect/prompt.ts

@@ -1,25 +0,0 @@
-import * as prompts from "@clack/prompts"
-import { Effect, Option } from "effect"
-
-export const intro = (msg: string) => Effect.sync(() => prompts.intro(msg))
-export const outro = (msg: string) => Effect.sync(() => prompts.outro(msg))
-
-export const log = {
-  info: (msg: string) => Effect.sync(() => prompts.log.info(msg)),
-}
-
-export const select = <Value>(opts: Parameters<typeof prompts.select<Value>>[0]) =>
-  Effect.tryPromise(() => prompts.select(opts)).pipe(
-    Effect.map((result) => {
-      if (prompts.isCancel(result)) return Option.none<Value>()
-      return Option.some(result)
-    }),
-  )
-
-export const spinner = () => {
-  const s = prompts.spinner()
-  return {
-    start: (msg: string) => Effect.sync(() => s.start(msg)),
-    stop: (msg: string, code?: number) => Effect.sync(() => s.stop(msg, code)),
-  }
-}

package/src/cli/effect-cmd.ts

@@ -1,50 +0,0 @@
-import type { Argv } from "yargs"
-import { Effect, Schema } from "effect"
-import { AppRuntime, type AppServices } from "@/effect/app-runtime"
-import { InstanceStore } from "@/project/instance-store"
-import { cmd } from "./cmd/cmd"
-
-/**
- * User-visible command failure. Throw via `fail("...")` from an effectCmd handler
- * to surface a printed message + non-zero exit. Recognised by the global error
- * formatter in `src/cli/error.ts` (FormatError), so the existing top-level
- * catch + cleanup in `src/index.ts` runs normally.
- */
-export class CliError extends Schema.TaggedErrorClass<CliError>()("CliError", {
-  message: Schema.String,
-  exitCode: Schema.optional(Schema.Number),
-}) {}
-
-export const fail = (message: string, exitCode = 1) => Effect.fail(new CliError({ message, exitCode }))
-
-/**
- * Effect-native CLI command builder. Wraps yargs `cmd()` so the handler body is
- * an `Effect` with `InstanceRef` provided and any `AppServices` yieldable.
- *
- * Errors propagate to the existing top-level handler in `src/index.ts`; use
- * `fail("...")` for user-visible domain failures (clean exit, formatted message).
- *
- * Handlers are typically `Effect.fn("Cli.<name>")(function*(args) { ... })`,
- * which adds a named tracing span per CLI invocation. Once all commands use
- * `effectCmd`, swapping the underlying `cmd()` factory for effect/cli's
- * `Command.make(...)` won't touch any handler bodies.
- */
-export const effectCmd = <Args, A>(opts: {
-  command: string | readonly string[]
-  describe: string | false
-  builder?: (yargs: Argv) => Argv<Args>
-  /** Defaults to process.cwd(). Override for commands that take a directory positional. */
-  directory?: (args: Args) => string
-  handler: (args: Args) => Effect.Effect<A, CliError, AppServices | InstanceStore.Service>
-}) =>
-  cmd<{}, Args>({
-    command: opts.command,
-    describe: opts.describe,
-    builder: opts.builder as never,
-    async handler(rawArgs) {
-      // yargs typing wraps Args in ArgumentsCamelCase<WithDoubleDash<...>>; cast at the boundary.
-      const args = rawArgs as unknown as Args
-      const directory = opts.directory?.(args) ?? process.cwd()
-      await AppRuntime.runPromise(InstanceStore.Service.use((s) => s.provide({ directory }, opts.handler(args))))
-    },
-  })

package/src/cli/error.ts

@@ -1,89 +0,0 @@
-import { NamedError } from "@saeeol/core/util/error"
-import { errorFormat } from "@/util/error"
-
-interface ErrorLike {
-  name?: string
-  _tag?: string
-  message?: string
-  data?: Record<string, any>
-}
-
-function isTaggedError(error: unknown, tag: string): boolean {
-  return (
-    typeof error === "object" && error !== null && "_tag" in error && (error as Record<string, unknown>)._tag === tag
-  )
-}
-
-export function FormatError(input: unknown) {
-  // CliError: domain failure surfaced from an effectCmd handler via fail("...")
-  if (isTaggedError(input, "CliError")) {
-    const data = input as ErrorLike & { exitCode?: number }
-    if (data.exitCode != null) process.exitCode = data.exitCode
-    return data.message ?? ""
-  }
-
-  // MCPFailed: { name: string }
-  if (NamedError.hasName(input, "MCPFailed")) {
-    return `MCP server "${(input as ErrorLike).data?.name}" failed. Note, saeeol does not support MCP authentication yet.`
-  }
-
-  // AccountServiceError, AccountTransportError: TaggedErrorClass
-  if (isTaggedError(input, "AccountServiceError") || isTaggedError(input, "AccountTransportError")) {
-    return (input as ErrorLike).message ?? ""
-  }
-
-  // ProviderModelNotFoundError: { providerID: string, modelID: string, suggestions?: string[] }
-  if (NamedError.hasName(input, "ProviderModelNotFoundError")) {
-    const data = (input as ErrorLike).data
-    const suggestions: string[] = Array.isArray(data?.suggestions) ? data.suggestions : []
-    return [
-      `Model not found: ${data?.providerID}/${data?.modelID}`,
-      ...(suggestions.length ? ["Did you mean: " + suggestions.join(", ")] : []),
-      `Try: \`saeeol models\` to list available models`, 
-      `Or check your config (saeeol.json) provider/model names`,
-    ].join("\n")
-  }
-
-  // ProviderInitError: { providerID: string }
-  if (NamedError.hasName(input, "ProviderInitError")) {
-    return `Failed to initialize provider "${(input as ErrorLike).data?.providerID}". Check credentials and configuration.`
-  }
-
-  // ConfigJsonError: { path: string, message?: string }
-  if (NamedError.hasName(input, "ConfigJsonError")) {
-    const data = (input as ErrorLike).data
-    return `Config file at ${data?.path} is not valid JSON(C)` + (data?.message ? `: ${data.message}` : "")
-  }
-
-  // ConfigDirectoryTypoError: { dir: string, path: string, suggestion: string }
-  if (NamedError.hasName(input, "ConfigDirectoryTypoError")) {
-    const data = (input as ErrorLike).data
-    return `Directory "${data?.dir}" in ${data?.path} is not valid. Rename the directory to "${data?.suggestion}" or remove it. This is a common typo.`
-  }
-
-  // ConfigFrontmatterError: { message: string }
-  if (NamedError.hasName(input, "ConfigFrontmatterError")) {
-    return (input as ErrorLike).data?.message ?? ""
-  }
-
-  // ConfigInvalidError: { path?: string, message?: string, issues?: Array<{ message: string, path: string[] }> }
-  if (NamedError.hasName(input, "ConfigInvalidError")) {
-    const data = (input as ErrorLike).data
-    const path = data?.path
-    const message = data?.message
-    const issues: Array<{ message: string; path: string[] }> = Array.isArray(data?.issues) ? data.issues : []
-    return [
-      `Configuration is invalid${path && path !== "config" ? ` at ${path}` : ""}` + (message ? `: ${message}` : ""),
-      ...issues.map((issue) => "↳ " + issue.message + " " + issue.path.join(".")),
-    ].join("\n")
-  }
-
-  // UICancelledError: void (no data)
-  if (NamedError.hasName(input, "UICancelledError")) {
-    return ""
-  }
-}
-
-export function FormatUnknownError(input: unknown): string {
-  return errorFormat(input)
-}

package/src/cli/heap.ts

@@ -1,59 +0,0 @@
-import path from "path"
-import { writeHeapSnapshot } from "node:v8"
-import { Flag } from "@saeeol/core/flag/flag"
-import { Global } from "@saeeol/core/global"
-import * as Log from "@saeeol/core/util/log"
-
-const log = Log.create({ service: "heap" })
-const MINUTE = 60_000
-const LIMIT = 2 * 1024 * 1024 * 1024
-
-let timer: Timer | undefined
-let lock = false
-let armed = true
-
-export function start() {
-  if (!Flag.SAEEOL_AUTO_HEAP_SNAPSHOT) return
-  if (timer) return
-
-  const run = async () => {
-    if (lock) return
-
-    const stat = process.memoryUsage()
-    if (stat.rss <= LIMIT) {
-      armed = true
-      return
-    }
-    if (!armed) return
-
-    lock = true
-    armed = false
-    const file = path.join(
-      Global.Path.log,
-      `heap-${process.pid}-${new Date().toISOString().replace(/[:.]/g, "")}.heapsnapshot`,
-    )
-    log.warn("heap usage exceeded limit", {
-      rss: stat.rss,
-      heap: stat.heapUsed,
-      file,
-    })
-
-    await Promise.resolve()
-      .then(() => writeHeapSnapshot(file))
-      .catch((err) => {
-        log.error("failed to write heap snapshot", {
-          error: err instanceof Error ? err.message : String(err),
-          file,
-        })
-      })
-
-    lock = false
-  }
-
-  timer = setInterval(() => {
-    void run()
-  }, MINUTE)
-  timer.unref?.()
-}
-
-export * as Heap from "./heap"

package/src/cli/logo.ts

@@ -1,13 +0,0 @@
-import { art } from "../overlay/cli/saeeol-logo"
-
-export const logo = {
-  left: ["", "", "", "", "", "", ""],
-  right: art(),
-}
-
-export const go = {
-  left: ["", "", "", "", "", "", ""],
-  right: ["", "", "", "", "", "", ""],
-}
-
-export const marks = "_^~,"

package/src/cli/network.ts

@@ -1,62 +0,0 @@
-import type { Argv, InferredOptionTypes } from "yargs"
-import { Config } from "@/config/config"
-import { AppRuntime } from "@/effect/app-runtime"
-
-const options = {
-  port: {
-    type: "number" as const,
-    describe: "port to listen on",
-    default: 0,
-  },
-  hostname: {
-    type: "string" as const,
-    describe: "hostname to listen on",
-    default: "127.0.0.1",
-  },
-  mdns: {
-    type: "boolean" as const,
-    describe: "enable mDNS service discovery (defaults hostname to 0.0.0.0)",
-    default: false,
-  },
-  "mdns-domain": {
-    type: "string" as const,
-    describe: "custom domain name for mDNS service (default: saeeol.local)",
-    default: "saeeol.local", 
-  },
-  cors: {
-    type: "string" as const,
-    array: true,
-    describe: "additional domains to allow for CORS",
-    default: [] as string[],
-  },
-}
-
-export type NetworkOptions = InferredOptionTypes<typeof options>
-
-export function withNetworkOptions<T>(yargs: Argv<T>) {
-  return yargs.options(options)
-}
-export async function resolveNetworkOptions(args: NetworkOptions) {
-  const config = await AppRuntime.runPromise(Config.Service.use((cfg) => cfg.getGlobal()))
-  return resolveNetworkOptionsNoConfig(args, config)
-}
-
-export function resolveNetworkOptionsNoConfig(args: NetworkOptions, config?: Config.Info) {
-  const portExplicitlySet = process.argv.includes("--port")
-  const hostnameExplicitlySet = process.argv.includes("--hostname")
-  const mdnsExplicitlySet = process.argv.includes("--mdns")
-  const mdnsDomainExplicitlySet = process.argv.includes("--mdns-domain")
-  const mdns = mdnsExplicitlySet ? args.mdns : (config?.server?.mdns ?? args.mdns)
-  const mdnsDomain = mdnsDomainExplicitlySet ? args["mdns-domain"] : (config?.server?.mdnsDomain ?? args["mdns-domain"])
-  const port = portExplicitlySet ? args.port : (config?.server?.port ?? args.port)
-  const hostname = hostnameExplicitlySet
-    ? args.hostname
-    : mdns && !config?.server?.hostname
-      ? "0.0.0.0"
-      : (config?.server?.hostname ?? args.hostname)
-  const configCors = config?.server?.cors ?? []
-  const argsCors = Array.isArray(args.cors) ? args.cors : args.cors ? [args.cors] : []
-  const cors = [...configCors, ...argsCors]
-
-  return { hostname, port, mdns, mdnsDomain, cors }
-}

package/src/cli/ui.ts

@@ -1,91 +0,0 @@
-import z from "zod"
-import { EOL } from "os"
-import { NamedError } from "@saeeol/core/util/error"
-import { art, loadCustomArt } from "../overlay/cli/saeeol-logo"
-
-export const CancelledError = NamedError.create("UICancelledError", z.void())
-
-export const Style = {
-  TEXT_HIGHLIGHT: "\x1b[96m",
-  TEXT_HIGHLIGHT_BOLD: "\x1b[96m\x1b[1m",
-  TEXT_DIM: "\x1b[90m",
-  TEXT_DIM_BOLD: "\x1b[90m\x1b[1m",
-  TEXT_NORMAL: "\x1b[0m",
-  TEXT_NORMAL_BOLD: "\x1b[1m",
-  TEXT_WARNING: "\x1b[93m",
-  TEXT_WARNING_BOLD: "\x1b[93m\x1b[1m",
-  TEXT_DANGER: "\x1b[91m",
-  TEXT_DANGER_BOLD: "\x1b[91m\x1b[1m",
-  TEXT_SUCCESS: "\x1b[92m",
-  TEXT_SUCCESS_BOLD: "\x1b[92m\x1b[1m",
-  TEXT_INFO: "\x1b[94m",
-  TEXT_INFO_BOLD: "\x1b[94m\x1b[1m",
-}
-
-export function println(...message: string[]) {
-  print(...message)
-  process.stderr.write(EOL)
-}
-
-export function print(...message: string[]) {
-  blank = false
-  process.stderr.write(message.join(" "))
-}
-
-let blank = false
-export function empty() {
-  if (blank) return
-  println("" + Style.TEXT_NORMAL)
-  blank = true
-}
-
-export function logo(pad?: string) {
-  const lines = art()
-  const isCustom = loadCustomArt() !== null
-  const result: string[] = []
-  const reset = "\x1b[0m"
-  const cyan = "\x1b[96m"
-  const dim = "\x1b[90m"
-
-  for (const line of lines) {
-    if (pad) result.push(pad)
-    if (isCustom) {
-      result.push(line)
-    } else {
-      const colored = line
-        .replace(/#/g, `${cyan}█${reset}`)
-        .replace(/\./g, " ")
-      result.push(colored)
-    }
-    result.push(EOL)
-  }
-  return result.join("").trimEnd()
-}
-
-export async function input(prompt: string): Promise<string> {
-  const readline = require("readline")
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  })
-
-  return new Promise((resolve) => {
-    rl.question(prompt, (answer: string) => {
-      rl.close()
-      resolve(answer.trim())
-    })
-  })
-}
-
-export function error(message: string) {
-  if (message.startsWith("Error: ")) {
-    message = message.slice("Error: ".length)
-  }
-  println(Style.TEXT_DANGER_BOLD + "Error: " + Style.TEXT_NORMAL + message)
-}
-
-export function markdown(text: string): string {
-  return text
-}
-
-export * as UI from "./ui"

package/src/cli/upgrade.ts

@@ -1,33 +0,0 @@
-import { Bus } from "@/bus"
-import { Config } from "@/config/config"
-import { AppRuntime } from "@/effect/app-runtime"
-import { Flag } from "@saeeol/core/flag/flag"
-import { Installation } from "@/installation"
-import { InstallationVersion } from "@saeeol/core/installation/version"
-
-export async function upgrade() {
-  const config = await AppRuntime.runPromise(Config.Service.use((cfg) => cfg.getGlobal()))
-  if (config.autoupdate === false || Flag.SAEEOL_DISABLE_AUTOUPDATE) return
-  const method = await Installation.method()
-  if (method !== "npm" && method !== "pnpm" && method !== "bun") return
-  const latest = await Installation.latest(method).catch(() => {})
-  if (!latest) return
-
-  if (Flag.SAEEOL_ALWAYS_NOTIFY_UPDATE) {
-    await Bus.publish(Installation.Event.UpdateAvailable, { version: latest })
-    return
-  }
-
-  if (InstallationVersion === latest) return
-
-  const kind = Installation.getReleaseType(InstallationVersion, latest)
-
-  if (config.autoupdate === "notify" || kind !== "patch") {
-    await Bus.publish(Installation.Event.UpdateAvailable, { version: latest })
-    return
-  }
-
-  await Installation.upgrade(method, latest)
-    .then(() => Bus.publish(Installation.Event.Updated, { version: latest }))
-    .catch(() => {})
-}