@aitne/daemon 0.1.0

package/dist/core/backends/install-methods.js

@@ -0,0 +1,267 @@
+import { findExecutable } from "./cli-utils.js";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { accessSync, constants as fsConstants } from "node:fs";
+const CLI_COMMANDS = {
+    claude: "claude",
+    codex: "codex",
+    gemini: "gemini",
+};
+const DOCS_URLS = {
+    claude: "https://docs.anthropic.com/en/docs/claude-code/setup",
+    codex: "https://github.com/openai/codex",
+    gemini: "https://github.com/google-gemini/gemini-cli",
+};
+/**
+ * Install methods are ordered by recommendation priority — the first
+ * available method is auto-selected in the dashboard UI.
+ *
+ * Design principles:
+ * - Only include methods that can run non-interactively from a daemon
+ *   (no sudo, no UAC, no interactive prompts).
+ * - Methods requiring elevation are marked `manualOnly: true` and
+ *   displayed as copyable commands rather than auto-run buttons.
+ * - `brew install --cask` is macOS-only (Linuxbrew doesn't support cask).
+ * - `brew install <formula>` works on both macOS and Linux.
+ */
+const METHOD_DEFS = {
+    claude: [
+        // Native installer — officially recommended on macOS/Linux.
+        {
+            id: "native",
+            label: "Native installer (recommended)",
+            command: "curl -fsSL https://claude.ai/install.sh | bash",
+            executable: "curl",
+            platforms: ["darwin", "linux"],
+            recommended: true,
+            manualOnly: false,
+        },
+        // Homebrew cask — macOS only (cask is not supported on Linux).
+        {
+            id: "brew",
+            label: "Homebrew",
+            command: "brew install --cask claude-code",
+            executable: "brew",
+            platforms: ["darwin"],
+            recommended: false,
+            manualOnly: false,
+        },
+        // npm — cross-platform fallback. Officially deprecated for Claude
+        // but still functional.
+        {
+            id: "npm",
+            label: "npm (global)",
+            command: "npm install -g @anthropic-ai/claude-code",
+            executable: "npm",
+            platforms: [],
+            recommended: false,
+            manualOnly: false,
+        },
+        // Windows — PowerShell native installer. Requires user to run in
+        // their own terminal (irm | iex needs an interactive PS session).
+        {
+            id: "winget",
+            label: "WinGet (run in terminal)",
+            command: "winget install Anthropic.ClaudeCode",
+            executable: "winget",
+            platforms: ["win32"],
+            recommended: true,
+            manualOnly: true,
+        },
+    ],
+    codex: [
+        // Homebrew cask — macOS only.
+        {
+            id: "brew",
+            label: "Homebrew (recommended)",
+            command: "brew install --cask codex",
+            executable: "brew",
+            platforms: ["darwin"],
+            recommended: true,
+            manualOnly: false,
+        },
+        // npm — cross-platform.
+        {
+            id: "npm",
+            label: "npm (global)",
+            command: "npm install -g @openai/codex",
+            executable: "npm",
+            platforms: [],
+            recommended: false,
+            manualOnly: false,
+        },
+    ],
+    gemini: [
+        // npm — cross-platform, officially recommended.
+        {
+            id: "npm",
+            label: "npm (global, recommended)",
+            command: "npm install -g @google/gemini-cli",
+            executable: "npm",
+            platforms: [],
+            recommended: true,
+            manualOnly: false,
+        },
+        // Homebrew formula (NOT cask) — works on both macOS and Linux.
+        {
+            id: "brew",
+            label: "Homebrew",
+            command: "brew install gemini-cli",
+            executable: "brew",
+            platforms: ["darwin", "linux"],
+            recommended: false,
+            manualOnly: false,
+        },
+    ],
+};
+/**
+ * Additional directories to scan when looking for CLI binaries that
+ * may not be on the daemon's PATH (e.g. installed while daemon runs).
+ *
+ * The daemon inherits PATH from its parent process at startup. CLIs
+ * installed after the daemon starts may land in directories that
+ * weren't on PATH at boot. These common install locations are checked
+ * as a supplement.
+ */
+function getSupplementalPaths() {
+    const home = homedir();
+    const paths = [];
+    if (process.platform === "win32") {
+        // npm global bin on Windows
+        const appData = process.env.APPDATA;
+        if (appData)
+            paths.push(join(appData, "npm"));
+        // Scoop
+        paths.push(join(home, "scoop", "shims"));
+    }
+    else {
+        // Common Unix install locations
+        paths.push(join(home, ".local", "bin")); // Claude native installer
+        paths.push("/usr/local/bin");
+        paths.push("/opt/homebrew/bin"); // Apple Silicon Homebrew
+        paths.push(join(home, ".npm-global", "bin")); // Custom npm prefix
+    }
+    return paths;
+}
+// ── Public API ─────────────────────────────────────────────────
+/**
+ * Check if a specific CLI binary is on PATH (one-shot, no cache).
+ *
+ * Extends the standard PATH with common install locations so we
+ * can detect CLIs installed while the daemon was already running.
+ */
+export function isCliInstalled(backendId) {
+    const command = CLI_COMMANDS[backendId];
+    // First try standard PATH
+    if (findExecutable(command) !== null)
+        return true;
+    // Then try supplemental paths
+    return findExecutableInDirs(command, getSupplementalPaths());
+}
+/** Get the CLI command name for a backend. */
+export function getCliCommand(backendId) {
+    return CLI_COMMANDS[backendId];
+}
+/**
+ * Check if a command exists in a set of specific directories,
+ * bypassing the standard PATH lookup.
+ */
+function findExecutableInDirs(command, dirs) {
+    const constants = fsConstants;
+    const extensions = process.platform === "win32" && !/\.[A-Za-z0-9]+$/.test(command)
+        ? (process.env.PATHEXT?.split(";").filter(Boolean) ?? [".exe", ".cmd", ".bat"])
+        : [""];
+    for (const dir of dirs) {
+        for (const ext of extensions) {
+            try {
+                accessSync(join(dir, `${command}${ext}`), constants.X_OK);
+                return true;
+            }
+            catch {
+                // not found here, continue
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Build the full install-methods response for the current host.
+ *
+ * Filters methods by platform and probes each package manager
+ * executable for availability.
+ */
+export function getInstallMethods() {
+    const platform = process.platform;
+    // Cache executable availability within a single call to avoid
+    // redundant PATH scans for the same executable (e.g. "npm").
+    const execCache = new Map();
+    function isAvailable(executable) {
+        if (execCache.has(executable))
+            return execCache.get(executable);
+        const available = findExecutable(executable) !== null;
+        execCache.set(executable, available);
+        return available;
+    }
+    const backends = {};
+    for (const backendId of Object.keys(CLI_COMMANDS)) {
+        const cliCommand = CLI_COMMANDS[backendId];
+        const installed = isCliInstalled(backendId);
+        const defs = METHOD_DEFS[backendId];
+        const docsUrl = DOCS_URLS[backendId];
+        const methods = defs
+            .filter((d) => d.platforms.length === 0 || d.platforms.includes(platform))
+            .map((d) => ({
+            id: d.id,
+            label: d.label,
+            command: d.command,
+            executable: d.executable,
+            available: d.manualOnly || isAvailable(d.executable),
+            recommended: d.recommended,
+            docsUrl,
+            manualOnly: d.manualOnly,
+        }));
+        backends[backendId] = { cliCommand, installed, methods, docsUrl };
+    }
+    return { platform, backends };
+}
+/**
+ * Resolve the install command for a given backend + method id.
+ * Returns null if the method is not found, not applicable to
+ * the current platform, or is manual-only.
+ */
+export function resolveInstallCommand(backendId, methodId) {
+    const defs = METHOD_DEFS[backendId];
+    const def = defs.find((d) => d.id === methodId &&
+        (d.platforms.length === 0 || d.platforms.includes(process.platform)));
+    if (!def)
+        return null;
+    // Manual-only methods cannot be run by the daemon
+    if (def.manualOnly)
+        return null;
+    // For piped commands like "curl ... | bash", use shell execution.
+    // POSIX-only: Windows native shells (cmd.exe / PowerShell) don't accept
+    // `sh -c`-style invocation, and the only piped recipe today (Anthropic's
+    // installer) is platform-restricted to darwin/linux. Defensively bail
+    // here too so a future METHOD_DEF added without a `platforms` filter
+    // can't silently drop us into cmd.exe.
+    if (def.command.includes("|")) {
+        if (process.platform === "win32")
+            return null;
+        return {
+            command: def.command,
+            // `sh` (PATH lookup) is more portable than hardcoding `bash` for the
+            // outer shell. The pipe target inside the command string still
+            // requires whichever interpreter the recipe asks for (e.g. Anthropic's
+            // installer ends with `| bash`), but that's the recipe's contract.
+            executable: "sh",
+            args: ["-c", def.command],
+        };
+    }
+    const parts = def.command.split(" ");
+    return {
+        command: def.command,
+        executable: parts[0],
+        args: parts.slice(1),
+    };
+}
+//# sourceMappingURL=install-methods.js.map

package/dist/core/backends/install-methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-methods.js","sourceRoot":"","sources":["../../../src/core/backends/install-methods.ts"],"names":[],"mappings":"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"}

package/dist/core/backends/model-registry.d.ts

@@ -0,0 +1,58 @@
+import type { BackendId, BackendModel, BackendModelTier, BackendUsage } from "@aitne/shared";
+/**
+ * Canonical per-backend default model IDs. Import these instead of
+ * hardcoding the literal strings in fallbacks / aliases / legacy env parses
+ * so a version bump is a one-line edit here.
+ *
+ * Tier semantics (see `BackendModelTier` in shared/backend.ts):
+ *   - `LITE`   — delegated proxy + observer-fired short-shape tasks.
+ *   - `MEDIUM` — main agent surfaces (DM, routines, hourly check, reviews).
+ *   - `HIGH`   — heavy reasoning (advisor, knowledge import, generative one-shots).
+ *
+ * Sources of truth for the alias → API ID mapping:
+ *   - Claude:  https://platform.claude.com/docs/en/about-claude/models/overview
+ *   - Codex:   https://platform.openai.com/docs/models
+ *   - Gemini:  https://ai.google.dev/gemini-api/docs/models
+ */
+export declare const DEFAULT_CLAUDE_LITE_MODEL = "claude-haiku-4-5-20251001";
+export declare const DEFAULT_CLAUDE_MEDIUM_MODEL = "claude-sonnet-4-6";
+export declare const DEFAULT_CLAUDE_HIGH_MODEL = "claude-opus-4-7";
+export declare const DEFAULT_CODEX_LITE_MODEL = "gpt-5.4-mini";
+export declare const DEFAULT_CODEX_MEDIUM_MODEL = "gpt-5.4-mini";
+export declare const DEFAULT_CODEX_HIGH_MODEL = "gpt-5.5";
+export declare const DEFAULT_GEMINI_LITE_MODEL = "gemini-3.1-flash-lite-preview";
+export declare const DEFAULT_GEMINI_MEDIUM_MODEL = "gemini-3.1-flash-lite-preview";
+export declare const DEFAULT_GEMINI_HIGH_MODEL = "gemini-3.1-pro-preview";
+export declare function getModelsForBackend(backendId: BackendId): ReadonlyArray<BackendModel>;
+export declare function findRegisteredModel(backendId: BackendId, modelId: string): BackendModel | undefined;
+/**
+ * Return the first available high-tier model for `backendId`, or `null` if
+ * the backend has no high-tier models registered. Preset builders use this
+ * so a model/pricing change is a one-line edit inside this registry instead
+ * of a cascade through every preset + test. See `plan-presets.ts` and
+ * `docs/design/09-safety-cost.md` §9.4.6.
+ */
+export declare function latestHighFor(backendId: BackendId): string | null;
+/** Mirror of `latestHighFor` for the medium tier (main agent surfaces). */
+export declare function latestMediumFor(backendId: BackendId): string | null;
+/** Mirror of `latestHighFor` for the lite tier (delegated / observer-fired). */
+export declare function latestLiteFor(backendId: BackendId): string | null;
+/**
+ * Cheapest available lite-tier model for `backendId` by `usdPer1kIn`.
+ * Used by surfaces that want "the budget pick" rather than the canonical
+ * latest lite model — e.g. the docs Q&A picker. Falls back to
+ * `latestLiteFor` when no lite model has pricing data.
+ */
+export declare function cheapestLiteFor(backendId: BackendId): string | null;
+/**
+ * Resolve the canonical default model id for a `(backendId, tier)` pair.
+ * Falls back across tiers if the registry has no match (e.g. Codex has no
+ * distinct medium model — `latestMediumFor("codex")` returns null and we
+ * fall through to lite).
+ */
+export declare function defaultModelForTier(backendId: BackendId, tier: BackendModelTier): string;
+export declare function estimateCostForUsage(model: BackendModel | undefined, usage: BackendUsage): number;
+export declare function estimateTextInputTokens(text: string): number;
+/** Get the human-readable label for a model, falling back to the raw modelId. */
+export declare function getModelLabel(backendId: BackendId, modelId: string): string;
+//# sourceMappingURL=model-registry.d.ts.map

package/dist/core/backends/model-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-registry.d.ts","sourceRoot":"","sources":["../../../src/core/backends/model-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACb,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;;;GAcG;AAGH,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AACrE,eAAO,MAAM,2BAA2B,sBAAsB,CAAC;AAC/D,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAQ3D,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AACvD,eAAO,MAAM,0BAA0B,iBAAiB,CAAC;AACzD,eAAO,MAAM,wBAAwB,YAAY,CAAC;AAKlD,eAAO,MAAM,yBAAyB,kCAAkC,CAAC;AACzE,eAAO,MAAM,2BAA2B,kCAAkC,CAAC;AAC3E,eAAO,MAAM,yBAAyB,2BAA2B,CAAC;AAiVlE,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,CAAC,YAAY,CAAC,CAErF;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,MAAM,GACd,YAAY,GAAG,SAAS,CAI1B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAWjE;AAKD,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CASnE;AAMD,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CASjE;AAGD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAuBnE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,gBAAgB,GACrB,MAAM,CA4BR;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,YAAY,GAAG,SAAS,EAC/B,KAAK,EAAE,YAAY,GAClB,MAAM,CAiER;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3E"}