opencode/packages/cli/src/mini/mini.ts

import { NodeFileSystem } from "@effect/platform-node"
import { OpenCode, type OpenCodeClient } from "@opencode-ai/client/promise"
import { Global } from "@opencode-ai/core/global"
import { Effect } from "effect"
import path from "node:path"
import { Daemon } from "../daemon"
import { waitForCatalogReady } from "./catalog.shared"
import { INTERACTIVE_INPUT_ERROR, resolveInteractiveStdin } from "./runtime.stdin"
import type { RunInput, RunTuiConfig } from "./types"

export type MiniCommandInput = {
  directory?: string
  attach?: string
  password?: string
  username?: string
  continue?: boolean
  session?: string
  fork?: boolean
  model?: string
  agent?: string
  prompt?: string
  replay?: boolean
  replayLimit?: number
  demo?: boolean
  serverCommand?: ReadonlyArray<string>
  tuiConfig?: RunTuiConfig | Promise<RunTuiConfig>
}

type Session = Awaited<ReturnType<OpenCodeClient["session"]["get"]>>
type Transport = { readonly url: string; readonly headers?: HeadersInit }

export async function runMini(input: MiniCommandInput) {
  validate(input)
  const initialInput = mergeInput(process.stdin.isTTY ? undefined : await Bun.stdin.text(), input.prompt)
  const runtimeTask = import("./runtime")
  const directory = input.attach ? input.directory : localDirectory(input.directory)
  const transportTask = startTransport(input)
  void transportTask.catch(() => {})

  try {
    if (input.attach) await transportTask
    const sdk = OpenCode.make({
      baseUrl: "http://opencode.pending",
      fetch: deferredFetch(transportTask),
    })
    const attachedSession =
      input.attach && input.session && !input.directory
        ? await sdk.session.get({ sessionID: input.session }).catch(() => fail("Session not found"))
        : undefined
    const resolvedDirectory =
      directory ?? attachedSession?.location.directory ?? (await remoteDirectory(await transportTask, sdk))
    const model = parseModel(input.model)
    let agentTask: Promise<string | undefined> | undefined
    const resolveAgent = () => {
      agentTask ??= validateAgent(sdk, resolvedDirectory, input.agent, input.attach)
      return agentTask
    }
    const resolveSession = async () => {
      const [agent, selected] = await Promise.all([
        resolveAgent(),
        selectSession(sdk, resolvedDirectory, input, attachedSession),
      ])
      const readyModel =
        model ?? (selected?.model ? { providerID: selected.model.providerID, modelID: selected.model.id } : undefined)
      if (readyModel) await waitForCatalogReady({ sdk, directory: resolvedDirectory, model: readyModel })
      const session = selected ?? (await createSession(sdk, resolvedDirectory, agent, model))
      return { id: session.id, title: session.title, resume: selected !== undefined }
    }
    const create = (
      _sdk: OpenCodeClient,
      next: { agent: string | undefined; model: RunInput["model"]; variant: string | undefined },
    ) => createSession(sdk, resolvedDirectory, next.agent, next.model, next.variant)
    const runtime = await runtimeTask
    await runtime.runInteractiveDeferredMode({
      sdk,
      directory: resolvedDirectory,
      resolveAgent,
      session: resolveSession,
      createSession: create,
      agent: input.agent,
      model,
      variant: undefined,
      files: [],
      initialInput,
      thinking: true,
      replay: input.replay ?? true,
      replayLimit: input.replayLimit,
      demo: input.demo,
      tuiConfig: input.tuiConfig,
    })
  } catch (error) {
    if (error instanceof Error && error.message === INTERACTIVE_INPUT_ERROR) fail(error.message)
    throw error
  }
}

/** @internal Exported for testing. */
export function mergeInput(piped: string | undefined, prompt: string | undefined) {
  if (!prompt) return piped || undefined
  if (!piped) return prompt
  return piped + "\n" + prompt
}

function validate(input: MiniCommandInput) {
  if (!process.stdout.isTTY) fail("opencode mini requires a TTY stdout")
  if (input.replayLimit !== undefined && (!Number.isInteger(input.replayLimit) || input.replayLimit <= 0)) {
    fail("--replay-limit must be a positive integer")
  }
  if (input.fork && !input.continue && !input.session) fail("--fork requires --continue or --session")
  resolveInteractiveStdin().cleanup?.()
}

function localDirectory(directory?: string): string {
  const root = process.env.PWD ?? process.cwd()
  try {
    process.chdir(directory ? (path.isAbsolute(directory) ? directory : path.join(root, directory)) : root)
    return process.cwd()
  } catch {
    fail(`Failed to change directory to ${directory}`)
  }
}

function startTransport(input: MiniCommandInput): Promise<Transport> {
  if (input.attach) {
    return Effect.runPromise(
      Daemon.transport({
        mode: "attach",
        url: input.attach,
        password: input.password ?? process.env.OPENCODE_SERVER_PASSWORD,
        username: input.username ?? process.env.OPENCODE_SERVER_USERNAME,
      }),
    )
  }
  return Effect.runPromise(
    Daemon.transport({ mode: "shared", command: input.serverCommand }).pipe(
      Effect.provide(NodeFileSystem.layer),
      Effect.provide(Global.layerWith({})),
    ),
  )
}

function deferredFetch(transportTask: Promise<{ url: string; headers?: HeadersInit }>): typeof globalThis.fetch {
  const fetch = async (input: RequestInfo | URL, init?: RequestInit) => {
    const transport = await transportTask
    const request = new Request(input, init)
    const source = new URL(request.url)
    const headers = new Headers(request.headers)
    for (const [key, value] of new Headers(transport.headers)) headers.set(key, value)
    return globalThis.fetch(new Request(new URL(source.pathname + source.search, transport.url), request), { headers })
  }
  return fetch as typeof globalThis.fetch
}

async function remoteDirectory(
  transport: { url: string; headers?: HeadersInit },
  sdk: OpenCodeClient,
): Promise<string> {
  const location = await sdk.location.get()
  if (!location.directory) throw new Error(`Failed to resolve remote directory from ${transport.url}`)
  return location.directory
}

function parseModel(value?: string): RunInput["model"] {
  if (!value) return
  const [providerID, ...rest] = value.split("/")
  const modelID = rest.join("/")
  if (!providerID || !modelID) fail("--model must use the format provider/model")
  return { providerID, modelID }
}

async function validateAgent(sdk: OpenCodeClient, directory: string, name?: string, attach?: string) {
  if (!name) return
  const deadline = Date.now() + 5_000
  let agents: Awaited<ReturnType<OpenCodeClient["agent"]["list"]>> | undefined
  while (Date.now() < deadline) {
    agents = await sdk.agent.list({ location: { directory } }).catch(() => undefined)
    const agent = agents?.data.find((item) => item.id === name)
    if (agent?.mode === "subagent") {
      warning(`agent "${name}" is a subagent, not a primary agent. Falling back to default agent`)
      return
    }
    if (agent) return name
    await Bun.sleep(25)
  }
  if (!agents) {
    warning(`failed to list agents${attach ? ` from ${attach}` : ""}. Falling back to default agent`)
    return
  }
  warning(`agent "${name}" not found. Falling back to default agent`)
}

async function selectSession(sdk: OpenCodeClient, directory: string, input: MiniCommandInput, preselected?: Session) {
  const selected =
    preselected ??
    (input.session
      ? await sdk.session.get({ sessionID: input.session }).catch(() => undefined)
      : input.continue
        ? await sdk.session
            .list({ directory, parentID: null, limit: 1, order: "desc" })
            .then((result) => result.data[0])
        : undefined)
  if (input.session && !selected) fail("Session not found")
  if (!selected) return
  if (!input.fork) return selected
  return sdk.session.fork({ sessionID: selected.id })
}

async function createSession(
  sdk: OpenCodeClient,
  directory: string,
  agent: string | undefined,
  model: RunInput["model"],
  variant?: string,
): Promise<Session> {
  if (model) await waitForCatalogReady({ sdk, directory, model })
  return sdk.session.create({
    agent,
    model: model ? { providerID: model.providerID, id: model.modelID, variant } : undefined,
    location: { directory },
  })
}

function warning(message: string) {
  process.stderr.write(`\x1b[93m\x1b[1m!\x1b[0m ${message}\n`)
}

function fail(message: string): never {
  process.stderr.write(`\x1b[91m\x1b[1mError: \x1b[0m${message}\n`)
  process.exit(1)
}