@justin06lee/yagami 0.4.1

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { spawn, spawnSync } from \"node:child_process\";\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { Command } from \"commander\";\nimport { YagamiEngine } from \"./core/engine.js\";\nimport { ClaudeProvider } from \"./core/providers/claude.js\";\nimport { createProvider, detectProviders } from \"./core/providers/registry.js\";\nimport { startYagami } from \"./server.js\";\nimport {\n  clearServerState,\n  configFilePath,\n  generateApiKey,\n  isProcessAlive,\n  loadConfig,\n  loadFileConfig,\n  logFilePath,\n  maskKey,\n  readServerState,\n  saveConfig,\n  sessionCachePath,\n  writeServerState,\n} from \"./server/config.js\";\nimport { VERSION } from \"./version.js\";\n\nconst sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));\n\nconst program = new Command();\n\nprogram\n  .name(\"yagami\")\n  .description(\"Anthropic-compatible API served by your signed-in Claude Code CLI\")\n  .version(VERSION);\n\ninterface StartFlags {\n  port?: string;\n  host?: string;\n  claude?: string;\n  provider?: string;\n  cors?: boolean;\n  daemon?: boolean;\n  log?: string;\n}\n\nprogram\n  .command(\"start\", { isDefault: true })\n  .description(\"start the yagami server\")\n  .option(\"-p, --port <port>\", \"port to listen on\")\n  .option(\"-H, --host <host>\", \"host to bind (default 127.0.0.1)\")\n  .option(\"--claude <path>\", \"path to the claude executable\")\n  .option(\"--provider <id>\", \"default provider for bare model ids (claude, codex, opencode, gemini, …)\")\n  .option(\"--cors\", \"enable permissive CORS (for browser clients)\")\n  .option(\"--daemon\", \"run in the background (managed with `yagami stop`/`yagami status`)\")\n  .option(\"--log <file>\", \"log file for --daemon mode (default ~/.config/yagami/yagami.log)\")\n  .action(async (opts: StartFlags) => {\n    // First run: generate a key automatically so the endpoint is never open.\n    const fileConfig = loadFileConfig();\n    let freshKey: string | undefined;\n    if (fileConfig.apiKeys.length === 0 && !process.env[\"YAGAMI_API_KEY\"]) {\n      freshKey = generateApiKey();\n      fileConfig.apiKeys.push(freshKey);\n      saveConfig(fileConfig);\n    }\n\n    if (opts.daemon) {\n      await startDaemon(opts, freshKey);\n      return;\n    }\n\n    try {\n      const running = await startYagami({\n        port: opts.port !== undefined ? Number(opts.port) : undefined,\n        host: opts.host,\n        claudePath: opts.claude,\n        defaultProvider: opts.provider,\n        cors: opts.cors,\n      });\n\n      writeServerState({\n        pid: process.pid,\n        host: running.config.host,\n        port: running.config.port,\n        url: running.url,\n        startedAt: new Date().toISOString(),\n        version: VERSION,\n        ...(process.env[\"YAGAMI_LOG_FILE\"] ? { log: process.env[\"YAGAMI_LOG_FILE\"] } : {}),\n      });\n      const shutdown = () => {\n        running.sessionCache.persistNow();\n        clearServerState(process.pid);\n        void running.close().finally(() => process.exit(0));\n        // Don't hang on a stuck in-flight response.\n        setTimeout(() => process.exit(0), 3000).unref?.();\n      };\n      process.on(\"SIGINT\", shutdown);\n      process.on(\"SIGTERM\", shutdown);\n\n      const engine = running.engine;\n      const version = await engine.defaultProvider.version();\n      const others = engine.providerIds.filter((id) => id !== engine.defaultProviderId);\n      console.log(`yagami v${VERSION}`);\n      console.log(`  listening   ${running.url}`);\n      console.log(`  provider    ${engine.defaultProviderId} — ${engine.executable}${version ? ` (${version})` : \"\"}`);\n      console.log(\n        `  also        ${others.length > 0 ? `${others.join(\", \")} (use model \"<provider>:<model>\")` : \"no other harness CLIs found — see `yagami doctor`\"}`,\n      );\n      console.log(`  config      ${configFilePath()}`);\n      if (freshKey) {\n        console.log(`  api key     ${freshKey}`);\n        console.log(\"              (newly generated and saved — copy it now, it is shown in full only once)\");\n      } else {\n        console.log(`  api keys    ${running.config.apiKeys.map(maskKey).join(\", \")}`);\n      }\n      if (![\"127.0.0.1\", \"localhost\", \"::1\"].includes(running.config.host)) {\n        console.log(\n          `  ⚠ bound to ${running.config.host} — reachable beyond this machine. Only do this on a network you trust.`,\n        );\n      }\n      console.log(\"\\nPoint any Anthropic SDK at it:\");\n      console.log(`  baseURL: \"${running.url}\"   apiKey: <your yagami key>`);\n    } catch (err) {\n      console.error(`yagami: ${err instanceof Error ? err.message : String(err)}`);\n      process.exitCode = 1;\n    }\n  });\n\nasync function startDaemon(opts: StartFlags, freshKey: string | undefined): Promise<void> {\n  const existing = readServerState();\n  if (existing && isProcessAlive(existing.pid)) {\n    console.error(`yagami is already running (pid ${existing.pid}, ${existing.url}) — \\`yagami stop\\` first`);\n    process.exitCode = 1;\n    return;\n  }\n  clearServerState();\n\n  const logPath = opts.log ? path.resolve(opts.log) : logFilePath();\n  fs.mkdirSync(path.dirname(logPath), { recursive: true });\n  const fd = fs.openSync(logPath, \"a\");\n  const args = [process.argv[1]!, \"start\"];\n  if (opts.port !== undefined) args.push(\"-p\", opts.port);\n  if (opts.host !== undefined) args.push(\"-H\", opts.host);\n  if (opts.claude !== undefined) args.push(\"--claude\", opts.claude);\n  if (opts.provider !== undefined) args.push(\"--provider\", opts.provider);\n  if (opts.cors) args.push(\"--cors\");\n\n  const child = spawn(process.execPath, args, {\n    detached: true,\n    stdio: [\"ignore\", fd, fd],\n    env: { ...process.env, YAGAMI_LOG_FILE: logPath },\n  });\n  fs.closeSync(fd);\n  let exitCode: number | null | undefined;\n  child.on(\"exit\", (code) => {\n    exitCode = code;\n  });\n  child.unref();\n\n  const deadline = Date.now() + 15_000;\n  while (Date.now() < deadline && exitCode === undefined) {\n    const state = readServerState();\n    if (state && state.pid === child.pid) {\n      console.log(`yagami v${VERSION} running in the background`);\n      console.log(`  pid   ${child.pid}`);\n      console.log(`  url   ${state.url}`);\n      console.log(`  log   ${logPath}`);\n      if (freshKey) {\n        console.log(`  key   ${freshKey}`);\n        console.log(\"        (newly generated and saved — copy it now, it is shown in full only once)\");\n      }\n      return;\n    }\n    await sleep(200);\n  }\n  console.error(\n    exitCode !== undefined\n      ? `yagami exited immediately (code ${exitCode}) — see ${logPath}`\n      : `yagami did not report ready within 15s — see ${logPath}`,\n  );\n  process.exitCode = 1;\n}\n\nprogram\n  .command(\"stop\")\n  .description(\"stop a running yagami server\")\n  .action(async () => {\n    const state = readServerState();\n    if (!state || !isProcessAlive(state.pid)) {\n      if (state) clearServerState();\n      console.log(\"yagami is not running\");\n      return;\n    }\n    process.kill(state.pid, \"SIGTERM\");\n    const deadline = Date.now() + 5_000;\n    while (Date.now() < deadline) {\n      if (!isProcessAlive(state.pid)) {\n        clearServerState();\n        console.log(`stopped yagami (pid ${state.pid})`);\n        return;\n      }\n      await sleep(100);\n    }\n    console.error(`yagami (pid ${state.pid}) did not exit within 5s`);\n    process.exitCode = 1;\n  });\n\nprogram\n  .command(\"status\")\n  .description(\"show whether yagami is running, plus request/cost totals\")\n  .action(async () => {\n    const state = readServerState();\n    if (!state || !isProcessAlive(state.pid)) {\n      if (state) clearServerState();\n      console.log(\"yagami is not running\");\n      process.exitCode = 1;\n      return;\n    }\n    console.log(`yagami running (pid ${state.pid})`);\n    console.log(`  url       ${state.url}`);\n    console.log(`  since     ${state.startedAt}`);\n    if (state.log) console.log(`  log       ${state.log}`);\n    try {\n      const res = await fetch(`${state.url}/healthz`, { signal: AbortSignal.timeout(3000) });\n      const body = (await res.json()) as {\n        version?: string;\n        claude?: string;\n        requests?: number;\n        total_cost_usd?: number;\n      };\n      console.log(`  version   ${body.version ?? \"?\"}`);\n      console.log(`  claude    ${body.claude ?? \"?\"}`);\n      console.log(`  requests  ${body.requests ?? 0}`);\n      console.log(`  cost      $${(body.total_cost_usd ?? 0).toFixed(4)} (would-be API cost since start)`);\n    } catch {\n      console.log(`  healthz   unreachable — process is alive but ${state.url} is not answering`);\n    }\n  });\n\nprogram\n  .command(\"keygen\")\n  .description(\"generate an API key and add it to the config\")\n  .action(() => {\n    const cfg = loadFileConfig();\n    const key = generateApiKey();\n    cfg.apiKeys.push(key);\n    const file = saveConfig(cfg);\n    console.log(key);\n    console.error(`saved to ${file} (${cfg.apiKeys.length} key${cfg.apiKeys.length === 1 ? \"\" : \"s\"} total)`);\n  });\n\nprogram\n  .command(\"doctor\")\n  .description(\"check which coding-agent CLIs yagami can drive and whether they work\")\n  .option(\"--live\", \"send one real (tiny) completion through the default provider\")\n  .option(\"--provider <id>\", \"provider to use for --live (default: config/claude)\")\n  .action(async (opts: { live?: boolean; provider?: string }) => {\n    let failed = false;\n    const cfg = loadConfig();\n    const providerConfig = { ...cfg.providers };\n    if (cfg.claudePath || cfg.claudeConfigDir) {\n      providerConfig[\"claude\"] = {\n        ...providerConfig[\"claude\"],\n        ...(cfg.claudePath ? { path: cfg.claudePath } : {}),\n        ...(cfg.claudeConfigDir ? { configDir: cfg.claudeConfigDir } : {}),\n      };\n    }\n    const defaultProvider = opts.provider ?? cfg.defaultProvider ?? \"claude\";\n\n    console.log(`node        ${process.version}`);\n    console.log(`config      ${configFilePath()}${fs.existsSync(configFilePath()) ? \"\" : \" (not created yet)\"}`);\n    console.log(`api keys    ${cfg.apiKeys.length === 0 ? \"none — run `yagami keygen`\" : cfg.apiKeys.map(maskKey).join(\", \")}`);\n    console.log(`bind        ${cfg.host}:${cfg.port}`);\n    console.log(`sessions    ${sessionCachePath()}${fs.existsSync(sessionCachePath()) ? \"\" : \" (empty)\"}`);\n    const state = readServerState();\n    console.log(\n      `server      ${state && isProcessAlive(state.pid) ? `running (pid ${state.pid}, ${state.url})` : \"not running\"}`,\n    );\n\n    console.log(\"\\nproviders   (model ids route as \\\"<provider>:<model>\\\"; bare ids go to the default)\");\n    const detected = detectProviders(providerConfig);\n    const installed = detected.filter((d) => d.installed);\n    for (const d of detected) {\n      const marker = d.id === defaultProvider ? \"*\" : \" \";\n      if (!d.installed) {\n        if (presetIsNiche(d.id)) continue; // keep the list readable\n        console.log(`  ${marker} ${d.id.padEnd(11)} not installed — ${d.installHint}`);\n        continue;\n      }\n      let version: string | undefined;\n      try {\n        version = await createProvider(d.id, providerConfig[d.id] ?? {}, {}).version();\n      } catch (err) {\n        version = `✗ ${err instanceof Error ? err.message : String(err)}`;\n      }\n      console.log(`  ${marker} ${d.id.padEnd(11)} ${d.path}${version ? ` (${version})` : \"\"}`);\n    }\n    const hidden = detected.filter((d) => !d.installed && presetIsNiche(d.id)).length;\n    if (hidden > 0) console.log(`    … ${hidden} more ACP presets not installed (see README for the full list)`);\n    if (!installed.some((d) => d.id === defaultProvider)) {\n      failed = true;\n      console.log(`  ✗ default provider \"${defaultProvider}\" is not installed`);\n    }\n\n    if (installed.some((d) => d.id === \"claude\")) {\n      try {\n        const claude = createProvider(\"claude\", providerConfig[\"claude\"] ?? {}, {}) as ClaudeProvider;\n        const skew = await claude.versionSkew();\n        if (skew) {\n          console.log(`\\nagent sdk   ${skew.sdkVersion} ↔ claude ${skew.binaryVersion} — ${skew.inSync ? \"in sync\" : `⚠ ${skew.note}`}`);\n        }\n      } catch {\n        // skew check is advisory\n      }\n    }\n\n    if (opts.live && !failed) {\n      console.log(`\\nlive check: sending one tiny completion through ${defaultProvider}…`);\n      try {\n        const engine = new YagamiEngine({ providerConfig, defaultProvider, ...(cfg.defaultModel ? { defaultModel: cfg.defaultModel } : {}) });\n        const started = Date.now();\n        const result = await engine.complete({\n          messages: [{ role: \"user\", content: \"Reply with exactly: pong\" }],\n          max_tokens: 32,\n        });\n        const text = result.response.content\n          .filter((b) => b.type === \"text\")\n          .map((b) => b[\"text\"])\n          .join(\"\");\n        console.log(`  reply     ${JSON.stringify(text)}`);\n        console.log(`  model     ${result.response.model}`);\n        console.log(`  latency   ${((Date.now() - started) / 1000).toFixed(1)}s`);\n        if (result.costUsd !== undefined) console.log(`  cost      $${result.costUsd.toFixed(6)}`);\n      } catch (err) {\n        failed = true;\n        console.log(`  ✗ ${err instanceof Error ? err.message : String(err)}`);\n      }\n    }\n\n    if (failed) process.exitCode = 1;\n  });\n\n/** Presets most people won't have; hidden from doctor unless installed. */\nfunction presetIsNiche(id: string): boolean {\n  return ![\"claude\", \"codex\", \"opencode\", \"gemini\", \"copilot\", \"cursor\", \"qwen\", \"goose\", \"kimi\"].includes(id);\n}\n\nprogram\n  .command(\"models\")\n  .description(\"list models across every installed provider (ids are ready to paste into requests)\")\n  .option(\"--provider <id>\", \"only this provider\")\n  .action(async (opts: { provider?: string }) => {\n    const cfg = loadConfig();\n    try {\n      const engine = new YagamiEngine({\n        ...(cfg.providers ? { providerConfig: cfg.providers } : {}),\n        ...(cfg.defaultProvider ? { defaultProvider: cfg.defaultProvider } : {}),\n      });\n      const models = await engine.listModels();\n      const byProvider = new Map<string, typeof models>();\n      for (const m of models) {\n        if (opts.provider && m.provider !== opts.provider) continue;\n        if (!m.id.includes(\":\")) continue; // print the qualified form once\n        const list = byProvider.get(m.provider ?? \"?\") ?? [];\n        list.push(m);\n        byProvider.set(m.provider ?? \"?\", list);\n      }\n      for (const [provider, list] of byProvider) {\n        console.log(`${provider}${provider === engine.defaultProviderId ? \" (default — bare ids work too)\" : \"\"}`);\n        for (const m of list) {\n          console.log(`  ${m.id.padEnd(40)} ${m.display_name}${m.resolved_model ? ` → ${m.resolved_model}` : \"\"}`);\n        }\n      }\n      if (byProvider.size === 0) console.log(\"no models reported — run `yagami doctor`\");\n    } catch (err) {\n      console.error(`yagami: ${err instanceof Error ? err.message : String(err)}`);\n      process.exitCode = 1;\n    }\n  });\n\nawait program.parseAsync(process.argv);\n"],"mappings":"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","names":["resolve"]}

package/dist/engine-pmCK3S7z.d.ts

@@ -0,0 +1,381 @@
+/** A model a provider reports as available. */
+interface EngineModel {
+    id: string;
+    display_name: string;
+    description?: string;
+    /** Canonical wire id an alias resolves to (e.g. "sonnet" → "claude-sonnet-5"). */
+    resolved_model?: string;
+    /** Provider that serves this model (set by the engine when aggregating). */
+    provider?: string;
+}
+
+/**
+ * Anthropic Messages API shapes (the subset yagami implements) and the error
+ * type shared across the engine and the HTTP layer.
+ */
+type ApiErrorType = "invalid_request_error" | "authentication_error" | "permission_error" | "not_found_error" | "rate_limit_error" | "api_error" | "overloaded_error";
+declare class ApiError extends Error {
+    readonly status: number;
+    readonly type: ApiErrorType;
+    constructor(status: number, type: ApiErrorType, message: string);
+    toBody(): {
+        type: "error";
+        error: {
+            type: ApiErrorType;
+            message: string;
+        };
+    };
+}
+interface ContentBlockParam {
+    type: string;
+    [key: string]: unknown;
+}
+interface TextBlockParam extends ContentBlockParam {
+    type: "text";
+    text: string;
+}
+type SystemParam = string | TextBlockParam[];
+interface MessageParam {
+    role: "user" | "assistant";
+    content: string | ContentBlockParam[];
+}
+interface ThinkingParam {
+    type: "enabled" | "disabled" | "adaptive" | string;
+    budget_tokens?: number;
+}
+interface MessagesRequest {
+    model?: string;
+    messages: MessageParam[];
+    system?: SystemParam;
+    max_tokens?: number;
+    stream?: boolean;
+    temperature?: number;
+    top_p?: number;
+    top_k?: number;
+    stop_sequences?: string[];
+    metadata?: Record<string, unknown>;
+    service_tier?: string;
+    thinking?: ThinkingParam;
+    tools?: unknown;
+    tool_choice?: unknown;
+    /** yagami extension: Claude Code reasoning effort for this request. */
+    effort?: string;
+    [key: string]: unknown;
+}
+interface Usage {
+    input_tokens: number;
+    output_tokens: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+}
+interface ContentBlock {
+    type: string;
+    [key: string]: unknown;
+}
+interface MessagesResponse {
+    id: string;
+    type: "message";
+    role: "assistant";
+    model: string;
+    content: ContentBlock[];
+    stop_reason: string | null;
+    stop_sequence: string | null;
+    usage: Usage;
+}
+/** One server-sent event, pre-serialization. */
+interface SseEvent {
+    event: string;
+    data: unknown;
+}
+
+/** What a provider can natively honor; the engine emulates or rejects the rest. */
+interface ProviderCapabilities {
+    /** Can continue a previous session by id (otherwise history is replayed as text). */
+    resume: boolean;
+    /** Resuming leaves the original session intact (branches are safe). */
+    fork: boolean;
+    images: boolean;
+    documents: boolean;
+    systemPrompt: boolean;
+    thinking: boolean;
+    effort: boolean;
+    /** Token-level deltas or whole chunks per message part. */
+    streaming: "tokens" | "chunks";
+}
+/** One completion turn, already normalized by the engine. */
+interface TurnRequest {
+    /** Full prompt text (history already flattened, prefill directive appended). */
+    prompt: string;
+    /** Image/document blocks (Anthropic shape) attached to the prompt. */
+    media?: ContentBlockParam[];
+    system?: string;
+    /** Provider-native model id; undefined means the provider's own default. */
+    model?: string;
+    /** Provider session id to continue. */
+    resume?: string;
+    thinking?: ThinkingParam;
+    effort?: string;
+    signal?: AbortSignal;
+}
+type TurnEvent = {
+    type: "session";
+    sessionId: string;
+} | {
+    type: "text";
+    text: string;
+} | {
+    type: "thinking";
+    text: string;
+} | {
+    type: "done";
+    usage: Usage;
+    costUsd?: number;
+    model?: string;
+    stopReason?: string;
+};
+/**
+ * A coding-agent harness yagami can drive: a signed-in CLI on this machine,
+ * wrapped so the engine can run sandboxed completion turns through it.
+ */
+interface Provider {
+    readonly id: string;
+    readonly label: string;
+    /** Resolved path of the CLI binary (for diagnostics). */
+    readonly executable: string;
+    readonly capabilities: ProviderCapabilities;
+    /** Shell command that signs the CLI in, for error messages. */
+    readonly loginCommand: string;
+    /** Run one sandboxed completion turn. Throws typed errors on failure. */
+    run(req: TurnRequest): AsyncGenerator<TurnEvent, void, undefined>;
+    /** Models the CLI reports as available (may spawn a short-lived process). */
+    listModels(): Promise<EngineModel[]>;
+    /** CLI version string, if it can be determined. */
+    version(): Promise<string | undefined>;
+}
+interface ModelRef {
+    providerId?: string;
+    model?: string;
+}
+/**
+ * Split a request's `model` into provider + native model. `"codex:gpt-5"`
+ * routes to codex; a bare provider id (`"codex"`) means that provider's
+ * default model; anything else is a model for the default provider. The
+ * split happens only at the first colon and only when the prefix names a
+ * known provider, so ids like `"ollama/llama3:8b"` stay intact.
+ */
+declare function parseModelRef(model: string | undefined, providerIds: Iterable<string>): ModelRef;
+declare function qualifiedModel(providerId: string, model: string): string;
+
+type CodexSandboxMode = "read-only" | "workspace-write" | "danger-full-access";
+interface CodexProviderOptions {
+    /** Path to the `codex` binary. Auto-resolved when omitted. */
+    path?: string;
+    /** Working directory for completion turns. */
+    workDir?: string;
+    /** Sandbox for completion turns (default read-only). */
+    sandbox?: CodexSandboxMode;
+    env?: Record<string, string>;
+}
+/** OpenAI Codex CLI via `codex exec --json`, signed in with the user's ChatGPT account. */
+declare class CodexProvider implements Provider {
+    readonly id = "codex";
+    readonly label = "Codex CLI";
+    readonly executable: string;
+    readonly loginCommand = "codex login";
+    readonly capabilities: ProviderCapabilities;
+    private readonly workDir;
+    private readonly sandbox;
+    private readonly env;
+    constructor(options?: CodexProviderOptions);
+    /** Build the `codex exec` argument list for a turn (exported for tests). */
+    buildArgs(req: TurnRequest, imagePaths: string[]): string[];
+    run(req: TurnRequest): AsyncGenerator<TurnEvent, void, undefined>;
+    /** Ask the app-server protocol for the model catalog (no tokens spent). */
+    listModels(): Promise<EngineModel[]>;
+    version(): Promise<string | undefined>;
+}
+
+type ProviderKind = "claude" | "codex" | "acp";
+/** A harness yagami knows how to launch out of the box. */
+interface ProviderPreset {
+    id: string;
+    label: string;
+    kind: ProviderKind;
+    command: string;
+    args: string[];
+    loginCommand: string;
+    installHint: string;
+}
+/**
+ * Built-in catalog. Native drivers for Claude Code and Codex; everything
+ * else speaks the Agent Client Protocol, with launch commands taken from
+ * the ACP registry (cdn.agentclientprotocol.com/registry). Login commands
+ * are best-effort hints.
+ */
+declare const PROVIDER_PRESETS: readonly ProviderPreset[];
+/** Per-provider settings from config.json (`providers.<id>`). */
+interface ProviderConfigEntry {
+    /** Explicit executable path. */
+    path?: string;
+    /** Launch command for custom ACP agents (and overrides for presets). */
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    label?: string;
+    /** Claude only: CLAUDE_CONFIG_DIR isolation. */
+    configDir?: string;
+    /** Codex only: sandbox for completion turns. */
+    sandbox?: CodexSandboxMode;
+    /** ACP only: id of the model config option (default "model"). */
+    modelConfigId?: string;
+    loginCommand?: string;
+    /** Set false to skip this preset even if installed. */
+    enabled?: boolean;
+}
+interface ProviderCommonOptions {
+    workDir?: string;
+    appName?: string;
+}
+declare function presetFor(id: string): ProviderPreset | undefined;
+/** Instantiate one provider by id from a preset and/or config entry. */
+declare function createProvider(id: string, entry?: ProviderConfigEntry, common?: ProviderCommonOptions): Provider;
+interface LoadedProviders {
+    providers: Map<string, Provider>;
+    /** Providers that couldn't be constructed, with the reason (usually not installed). */
+    unavailable: Map<string, string>;
+}
+/**
+ * Build every provider that is installed on this machine: all presets plus
+ * any custom entries in config. Missing CLIs are recorded, not fatal.
+ */
+declare function loadProviders(config?: Record<string, ProviderConfigEntry>, common?: ProviderCommonOptions): LoadedProviders;
+interface DetectedProvider {
+    id: string;
+    label: string;
+    kind: ProviderKind;
+    installed: boolean;
+    path?: string;
+    loginCommand: string;
+    installHint: string;
+}
+/** Which known harnesses exist on this machine (cheap: no processes spawned). */
+declare function detectProviders(config?: Record<string, ProviderConfigEntry>): DetectedProvider[];
+
+interface SessionCacheOptions {
+    maxEntries?: number;
+    /** JSON file to persist the cache across restarts (best-effort). */
+    persistPath?: string;
+}
+/**
+ * LRU map from conversation-prefix hash to Claude Code session id.
+ * Session transcripts themselves live in ~/.claude; this only remembers
+ * which session corresponds to which conversation prefix.
+ */
+declare class SessionCache {
+    private readonly map;
+    private readonly maxEntries;
+    private readonly persistPath;
+    private persistTimer;
+    constructor(options?: SessionCacheOptions);
+    get size(): number;
+    get(key: string): string | undefined;
+    /** Drop a mapping, e.g. when its session turns out to be gone. */
+    delete(key: string): void;
+    set(key: string, sessionId: string): void;
+    private load;
+    private schedulePersist;
+    persistNow(): void;
+}
+
+interface EngineOptions {
+    /** Explicit provider instances (library mode). Overrides config-driven loading. */
+    providers?: Provider[];
+    /** Per-provider settings (`providers.<id>` in config.json). */
+    providerConfig?: Record<string, ProviderConfigEntry>;
+    /** Provider used for bare model ids (default: claude if installed, else the first available). */
+    defaultProvider?: string;
+    /** @deprecated Use providerConfig.claude.path. */
+    claudePath?: string;
+    /** @deprecated Use providerConfig.claude.configDir. */
+    claudeConfigDir?: string;
+    /** Working directory for completion turns (inert — tools are disabled/sandboxed). */
+    workDir?: string;
+    /** Model used when a request omits `model` (may be `provider:model`). */
+    defaultModel?: string;
+    sessionCache?: SessionCache;
+    /** Reported to the CLIs as the client application name. */
+    appName?: string;
+}
+interface CompleteResult {
+    response: MessagesResponse;
+    costUsd?: number;
+    sessionId?: string;
+    provider: string;
+    ignored: string[];
+}
+interface StreamStart {
+    ignored: string[];
+    provider: string;
+    events: AsyncGenerator<SseEvent, void, undefined>;
+}
+/** Metadata about a finished streaming turn, reported via `onResult`. */
+interface StreamResultInfo {
+    costUsd?: number;
+    sessionId?: string;
+}
+interface StreamOptions {
+    signal?: AbortSignal;
+    /** Called once when a streamed turn completes successfully. */
+    onResult?: (info: StreamResultInfo) => void;
+}
+/**
+ * Translates Anthropic Messages API requests into turns on whichever
+ * signed-in coding harness the model id names — Claude Code by default,
+ * `codex:…`, `opencode:…`, `gemini:…` and friends on request.
+ */
+declare class YagamiEngine {
+    readonly providers: Map<string, Provider>;
+    readonly unavailable: Map<string, string>;
+    readonly defaultProviderId: string;
+    private readonly defaultModel;
+    private readonly cache;
+    private readonly modelsPromises;
+    constructor(options?: EngineOptions);
+    get defaultProvider(): Provider;
+    /** Executable of the default provider. */
+    get executable(): string;
+    /** @deprecated Use `executable`. */
+    get claudePath(): string;
+    get providerIds(): string[];
+    /** Route a request's model id to a provider and its native model. */
+    resolve(model: string | undefined): {
+        provider: Provider;
+        model?: string;
+    };
+    /**
+     * Models across every available provider. The default provider's ids are
+     * listed bare as well as qualified; others only as `provider:model`.
+     * Providers whose probe fails are skipped (their error is not cached).
+     */
+    listModels(): Promise<EngineModel[]>;
+    private providerModels;
+    private prepare;
+    /**
+     * A failed resumed attempt usually means the cached session no longer
+     * exists. Drop the stale mapping and re-prepare from scratch — the
+     * transcript-replay path. Undefined when falling back is impossible.
+     */
+    private prepareResumeFallback;
+    private storeSession;
+    complete(req: MessagesRequest): Promise<CompleteResult>;
+    private attemptComplete;
+    /**
+     * Validates synchronously (throws ApiError), then returns a lazy generator
+     * of Anthropic-style SSE events.
+     */
+    stream(req: MessagesRequest, streamOptions?: StreamOptions): StreamStart;
+    private runStream;
+    private attemptStream;
+}
+
+export { ApiError as A, presetFor as B, CodexProvider as C, type DetectedProvider as D, type EngineModel as E, qualifiedModel as F, type LoadedProviders as L, type MessageParam as M, type Provider as P, SessionCache as S, type TurnRequest as T, type Usage as U, YagamiEngine as Y, type ProviderCapabilities as a, type TurnEvent as b, type ApiErrorType as c, type CodexProviderOptions as d, type CodexSandboxMode as e, type CompleteResult as f, type ContentBlock as g, type ContentBlockParam as h, type EngineOptions as i, type MessagesRequest as j, type MessagesResponse as k, type ModelRef as l, PROVIDER_PRESETS as m, type ProviderConfigEntry as n, type ProviderKind as o, type ProviderPreset as p, type SessionCacheOptions as q, type SseEvent as r, type StreamOptions as s, type StreamResultInfo as t, type StreamStart as u, type SystemParam as v, createProvider as w, detectProviders as x, loadProviders as y, parseModelRef as z };