@baanish/hydra-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aanish Bhirud
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,122 @@
+# hydra-cli
+
+hydra is a multi-agent research and synthesis cli that breaks a question into specialist workstreams, runs parallel research plus debate rounds, and produces one consolidated synthesis. it is built for long-form, evidence-oriented questions where a single-model answer is too shallow.
+
+## requirements
+
+- node `>=24`
+- npm `>=11`
+
+the `engines` field in `package.json` enforces `"node": ">=24"`. this migration is intentionally node-24-first: the cli now relies on modern node esm behavior, built-in web platform primitives like `fetch`/`Request`/`Response`, and the runtime shape we verified for the node http-to-fetch web adapter. older node versions are not tested in this phase, so treat them as unsupported until compatibility is widened deliberately.
+
+## install and run
+
+### one-off with npx
+
+```bash
+npx @baanish/hydra-cli --help
+npx @baanish/hydra-cli run "market entry strategy for industrial batteries"
+```
+
+### project-local install
+
+```bash
+npm install @baanish/hydra-cli
+npx hydra --help
+npx hydra run "market entry strategy for industrial batteries"
+```
+
+### global install
+
+```bash
+npm install -g @baanish/hydra-cli
+hydra --help
+hydra run "market entry strategy for industrial batteries"
+```
+
+## quick start
+
+```bash
+hydra config set synthetic-api-key <key>
+# optional llm override key:
+# hydra config set api-key <key>
+hydra run "your query"
+```
+
+to quickly see a full real run output (the bundled ai transition 2036 retrospective) without running anything:
+
+```bash
+cat examples/ai-transition-2036.json | jq -r '.brief'
+# no jq:
+node --input-type=module -e "import { readFile } from 'node:fs/promises'; console.log(JSON.parse(await readFile('./examples/ai-transition-2036.json', 'utf8')).brief)"
+```
+
+## storage
+
+hydra keeps the same on-disk locations across install modes:
+
+- config: `~/.config/hydra-cli/config.json`
+- database: `~/.config/hydra-cli/hydra.db`
+- personas: `~/.config/hydra-cli/personas.json`
+
+## key commands
+
+| command | purpose | example |
+| --- | --- | --- |
+| `hydra run <query>` | start a run (also supports `hydra "<query>"`) | `hydra run "market entry strategy"` |
+| `hydra run --custom-personas-only <query>` | use custom personas only and fill any shortfall with ephemeral generated personas | `hydra run --custom-personas-only --agents 5 "supply chain strategy"` |
+| `hydra view <run-id>` | inspect a run summary | `hydra view Rw9k...` |
+| `hydra history` | list recent runs | `hydra history --limit 20` |
+| `hydra config show` | print effective config with masked keys | `hydra config show` |
+| `hydra config set <key> <value>` | update a config value | `hydra config set max-concurrency 5` |
+| `hydra web` | launch the local web ui with an authenticated local api session | `hydra web --port 3737` |
+
+## personas
+
+personas are specialist analytical lenses assigned to agents (for example `skeptic`, `futurist`, `economist`) to bias how perspectives are generated and debated. hydra ships with 20 built-in personas.
+
+| command | purpose | example |
+| --- | --- | --- |
+| `hydra persona list` | list all personas (built-in + custom) | `hydra persona list` |
+| `hydra persona list --json` | output personas as json | `hydra persona list --json` |
+| `hydra persona add` | add a custom persona | `hydra persona add --name "the lawyer" --description "applies legal reasoning and precedent." --methodology "case law analysis"` |
+| `hydra persona remove <id>` | remove a custom persona | `hydra persona remove the-lawyer` |
+
+custom personas are stored in `~/.config/hydra-cli/personas.json`. built-in personas cannot be removed. if `--id` is not provided when adding a persona, it is auto-derived from the name using slugification.
+
+## config options
+
+| key | type | default |
+| --- | --- | --- |
+| `apiKey` | `string \| undefined` | unset |
+| `syntheticApiKey` | `string \| undefined` | unset |
+| `searchProvider` | `"synthetic" \| "exa" \| "brave"` | `synthetic` |
+| `exaApiKey` | `string \| undefined` | unset |
+| `braveApiKey` | `string \| undefined` | unset |
+| `baseUrl` | `string` | `https://api.synthetic.new/openai/v1` |
+| `model` | `string` | `hf:MiniMaxAI/MiniMax-M2.5` |
+| `defaultAgentCount` | `number` | `5` |
+| `maxConcurrency` | `number` | `5` |
+| `debateRounds` | `number` | `2` |
+| `searchEnabled` | `boolean` | `true` |
+| `customPersonasOnly` | `boolean` | `false` |
+
+## development
+
+```bash
+npm install
+npm run lint
+npm run typecheck
+npm test
+npm run build
+```
+
+manual first publish:
+
+```bash
+npm publish --access public
+```
+
+## note on backend
+
+hydra uses synthetic.new as the default openai-compatible llm backend (`baseUrl` + model defaults target synthetic.new). `baseUrl` must use `https://`, or `http://` only for localhost / loopback development endpoints, and embedded url credentials are rejected.

package/dist/config.d.ts

@@ -0,0 +1,29 @@
+import type { HydraConfig, HydraConfigFile } from "./types.js";
+/** default api base url for llm requests. */
+export declare const DEFAULT_BASE_URL = "https://api.synthetic.new/openai/v1";
+/** default llm model identifier used by the project. */
+export declare const DEFAULT_MODEL = "hf:MiniMaxAI/MiniMax-M2.5";
+/** minimum supported debate rounds value. */
+export declare const MIN_DEBATE_ROUNDS = 1;
+/** maximum supported debate rounds value. */
+export declare const MAX_DEBATE_ROUNDS = 8;
+/** config directory under user home. */
+export declare const CONFIG_DIR: string;
+/** default config file path. */
+export declare const CONFIG_FILE: string;
+/** convert raw numeric values into clamped integers with safe fallback. */
+export declare function clampInt(value: unknown, min: number, max: number, fallback: number): number;
+/** return resolved config file path for diagnostics and tests. */
+export declare function getConfigPath(): string;
+/** load config from defaults, env, and overrides and return validated values. */
+export declare function loadConfig(overrides?: HydraConfigFile): HydraConfig;
+/** persist config values and return normalized merged config. */
+export declare function writeConfig(updates: HydraConfigFile): HydraConfig;
+/** mask api-like values for display to avoid accidental leakage in logs. */
+export declare function maskConfigValue(value: string | undefined): string;
+/** sanitize raw config-string input and return typed value or validation error. */
+export declare function sanitizeConfigValueForSet(key: keyof HydraConfig, value: string): {
+    error?: string;
+    value: unknown;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAkB,MAAM,YAAY,CAAC;AAE/E,6CAA6C;AAC7C,eAAO,MAAM,gBAAgB,wCAAwC,CAAC;AACtE,wDAAwD;AACxD,eAAO,MAAM,aAAa,8BAA8B,CAAC;AACzD,6CAA6C;AAC7C,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,6CAA6C;AAC7C,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,wCAAwC;AACxC,eAAO,MAAM,UAAU,QAA6C,CAAC;AACrE,gCAAgC;AAChC,eAAO,MAAM,WAAW,QAAqC,CAAC;AAiB9D,2EAA2E;AAC3E,wBAAgB,QAAQ,CACvB,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACd,MAAM,CAMR;AAoMD,kEAAkE;AAClE,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,SAAS,GAAE,eAAoB,GAAG,WAAW,CAQvE;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,CAgBjE;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAajE;AAED,mFAAmF;AACnF,wBAAgB,yBAAyB,CACxC,GAAG,EAAE,MAAM,WAAW,EACtB,KAAK,EAAE,MAAM,GACX;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAkHpC"}

package/dist/config.js

@@ -0,0 +1,338 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import { validateBaseUrl } from "./security.js";
+/** default api base url for llm requests. */
+export const DEFAULT_BASE_URL = "https://api.synthetic.new/openai/v1";
+/** default llm model identifier used by the project. */
+export const DEFAULT_MODEL = "hf:MiniMaxAI/MiniMax-M2.5";
+/** minimum supported debate rounds value. */
+export const MIN_DEBATE_ROUNDS = 1;
+/** maximum supported debate rounds value. */
+export const MAX_DEBATE_ROUNDS = 8;
+/** config directory under user home. */
+export const CONFIG_DIR = resolve(homedir(), ".config", "hydra-cli");
+/** default config file path. */
+export const CONFIG_FILE = resolve(CONFIG_DIR, "config.json");
+const DEFAULTS = {
+    apiKey: undefined,
+    syntheticApiKey: undefined,
+    searchProvider: "synthetic",
+    exaApiKey: undefined,
+    braveApiKey: undefined,
+    baseUrl: DEFAULT_BASE_URL,
+    model: DEFAULT_MODEL,
+    defaultAgentCount: 5,
+    maxConcurrency: 1,
+    debateRounds: 2,
+    searchEnabled: true,
+    customPersonasOnly: false,
+};
+/** convert raw numeric values into clamped integers with safe fallback. */
+export function clampInt(value, min, max, fallback) {
+    const parsed = Number.parseInt(String(value), 10);
+    if (!Number.isFinite(parsed)) {
+        return fallback;
+    }
+    return Math.min(Math.max(parsed, min), max);
+}
+/** normalize truthy / falsy string values from env and config files. */
+function normalizeBoolean(value) {
+    if (typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "string") {
+        const normalized = value.trim().toLowerCase();
+        if (["1", "true", "yes", "y", "on"].includes(normalized)) {
+            return true;
+        }
+        if (["0", "false", "no", "n", "off"].includes(normalized)) {
+            return false;
+        }
+    }
+    return undefined;
+}
+/** normalize and fallback invalid search provider values. */
+function normalizeSearchProvider(value) {
+    if (typeof value === "string") {
+        const normalized = value.trim().toLowerCase();
+        if (normalized === "synthetic" ||
+            normalized === "exa" ||
+            normalized === "brave") {
+            return normalized;
+        }
+    }
+    return DEFAULTS.searchProvider;
+}
+/** trim optional string values and convert blank values to undefined. */
+function trimOptionalString(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+/** trim optional api key strings and convert blank values to undefined. */
+function trimOptionalApiKey(value) {
+    return trimOptionalString(value);
+}
+/** normalize base-url values and surface invalid explicit settings immediately. */
+function normalizeBaseUrl(value) {
+    if (typeof value !== "string") {
+        return DEFAULTS.baseUrl;
+    }
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return DEFAULTS.baseUrl;
+    }
+    const parsed = validateBaseUrl(trimmed);
+    if (!parsed.value) {
+        throw new Error(`invalid base-url "${trimmed}": ${parsed.error ?? "must be a valid absolute URL"}`);
+    }
+    return parsed.value;
+}
+/** ensure the config directory exists before read/write operations. */
+function ensureConfigDir() {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    }
+}
+/** load raw config from disk and return parsed config json if valid. */
+function readConfigFile() {
+    if (!existsSync(CONFIG_FILE)) {
+        return {};
+    }
+    const raw = readFileSync(CONFIG_FILE, "utf8").trim();
+    if (!raw) {
+        return {};
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+            return {};
+        }
+        return parsed;
+    }
+    catch {
+        return {};
+    }
+}
+/** overlay environment variables on top of persisted config values. */
+function applyEnvironmentOverrides(config) {
+    const merged = { ...config };
+    if (process.env.HYDRA_API_KEY) {
+        merged.apiKey = process.env.HYDRA_API_KEY;
+    }
+    if (process.env.HYDRA_SYNTHETIC_API_KEY) {
+        merged.syntheticApiKey = process.env.HYDRA_SYNTHETIC_API_KEY;
+    }
+    else if (process.env.SYNTHETIC_API_KEY) {
+        merged.syntheticApiKey = process.env.SYNTHETIC_API_KEY;
+    }
+    if (process.env.HYDRA_SEARCH_PROVIDER) {
+        merged.searchProvider = normalizeSearchProvider(process.env.HYDRA_SEARCH_PROVIDER);
+    }
+    if (process.env.HYDRA_EXA_API_KEY) {
+        merged.exaApiKey = process.env.HYDRA_EXA_API_KEY;
+    }
+    else if (process.env.EXA_API_KEY) {
+        merged.exaApiKey = process.env.EXA_API_KEY;
+    }
+    if (process.env.HYDRA_BRAVE_API_KEY) {
+        merged.braveApiKey = process.env.HYDRA_BRAVE_API_KEY;
+    }
+    else if (process.env.BRAVE_API_KEY) {
+        merged.braveApiKey = process.env.BRAVE_API_KEY;
+    }
+    if (process.env.HYDRA_MODEL) {
+        merged.model = process.env.HYDRA_MODEL;
+    }
+    if (process.env.HYDRA_ORCHESTRATOR_MODEL !== undefined) {
+        merged.orchestratorModel = process.env.HYDRA_ORCHESTRATOR_MODEL;
+    }
+    if (process.env.HYDRA_RESEARCH_MODEL !== undefined) {
+        merged.researchModel = process.env.HYDRA_RESEARCH_MODEL;
+    }
+    if (process.env.HYDRA_BASE_URL) {
+        merged.baseUrl = process.env.HYDRA_BASE_URL;
+    }
+    if (process.env.HYDRA_CUSTOM_PERSONAS_ONLY) {
+        const parsed = normalizeBoolean(process.env.HYDRA_CUSTOM_PERSONAS_ONLY);
+        if (parsed !== undefined) {
+            merged.customPersonasOnly = parsed;
+        }
+    }
+    if (process.env.HYDRA_CONCURRENCY) {
+        const parsed = Number.parseInt(process.env.HYDRA_CONCURRENCY, 10);
+        if (Number.isFinite(parsed)) {
+            merged.maxConcurrency = parsed;
+        }
+    }
+    return merged;
+}
+/** normalize config values and apply hard constraints to numeric fields. */
+function normalizeConfig(config) {
+    const syntheticApiKey = trimOptionalApiKey(config.syntheticApiKey);
+    const explicitApiKey = trimOptionalApiKey(config.apiKey);
+    const apiKey = explicitApiKey ?? syntheticApiKey;
+    return {
+        apiKey: apiKey ?? undefined,
+        syntheticApiKey,
+        searchProvider: normalizeSearchProvider(config.searchProvider),
+        exaApiKey: trimOptionalApiKey(config.exaApiKey),
+        braveApiKey: trimOptionalApiKey(config.braveApiKey),
+        baseUrl: normalizeBaseUrl(config.baseUrl),
+        model: config.model || DEFAULTS.model,
+        orchestratorModel: trimOptionalString(config.orchestratorModel),
+        researchModel: trimOptionalString(config.researchModel),
+        defaultAgentCount: clampInt(config.defaultAgentCount, 1, 20, DEFAULTS.defaultAgentCount),
+        maxConcurrency: clampInt(config.maxConcurrency, 1, 1, DEFAULTS.maxConcurrency),
+        debateRounds: clampInt(config.debateRounds, MIN_DEBATE_ROUNDS, MAX_DEBATE_ROUNDS, DEFAULTS.debateRounds),
+        searchEnabled: typeof config.searchEnabled === "boolean"
+            ? config.searchEnabled
+            : DEFAULTS.searchEnabled,
+        customPersonasOnly: typeof config.customPersonasOnly === "boolean"
+            ? config.customPersonasOnly
+            : DEFAULTS.customPersonasOnly,
+    };
+}
+/** return resolved config file path for diagnostics and tests. */
+export function getConfigPath() {
+    return CONFIG_FILE;
+}
+/** load config from defaults, env, and overrides and return validated values. */
+export function loadConfig(overrides = {}) {
+    const merged = {
+        ...DEFAULTS,
+        ...applyEnvironmentOverrides(readConfigFile()),
+        ...overrides,
+    };
+    return normalizeConfig(merged);
+}
+/** persist config values and return normalized merged config. */
+export function writeConfig(updates) {
+    ensureConfigDir();
+    const normalized = normalizeConfig({
+        ...DEFAULTS,
+        ...readConfigFile(),
+        ...updates,
+    });
+    writeFileSync(CONFIG_FILE, JSON.stringify(normalized, null, 2), {
+        encoding: "utf8",
+        mode: 0o600,
+    });
+    // Explicit chmod ensures 0o600 regardless of umask.
+    chmodSync(CONFIG_FILE, 0o600);
+    return normalized;
+}
+/** mask api-like values for display to avoid accidental leakage in logs. */
+export function maskConfigValue(value) {
+    if (!value) {
+        return "not set";
+    }
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return "not set";
+    }
+    if (trimmed.length <= 8) {
+        return "[redacted]";
+    }
+    const suffix = trimmed.slice(-4);
+    return `sk-...${suffix}`;
+}
+/** sanitize raw config-string input and return typed value or validation error. */
+export function sanitizeConfigValueForSet(key, value) {
+    if (key === "defaultAgentCount") {
+        const parsed = Number.parseInt(value, 10);
+        if (!Number.isFinite(parsed)) {
+            return {
+                error: "defaultAgentCount must be an integer",
+                value: undefined,
+            };
+        }
+        return { value: clampInt(parsed, 1, 20, DEFAULTS.defaultAgentCount) };
+    }
+    if (key === "maxConcurrency") {
+        const parsed = Number.parseInt(value, 10);
+        if (!Number.isFinite(parsed)) {
+            return {
+                error: "maxConcurrency must be 1",
+                value: undefined,
+            };
+        }
+        if (parsed !== 1) {
+            return {
+                error: "maxConcurrency must be 1",
+                value: undefined,
+            };
+        }
+        return { value: parsed };
+    }
+    if (key === "debateRounds") {
+        const parsed = Number.parseInt(value, 10);
+        if (!Number.isFinite(parsed)) {
+            return { error: "debateRounds must be an integer", value: undefined };
+        }
+        return {
+            value: clampInt(parsed, MIN_DEBATE_ROUNDS, MAX_DEBATE_ROUNDS, DEFAULTS.debateRounds),
+        };
+    }
+    if (key === "searchEnabled") {
+        const parsed = normalizeBoolean(value);
+        if (parsed === undefined) {
+            return {
+                error: "searchEnabled must be one of: true, false, 1, 0, yes, no",
+                value: undefined,
+            };
+        }
+        return { value: parsed };
+    }
+    if (key === "customPersonasOnly") {
+        const parsed = normalizeBoolean(value);
+        if (parsed === undefined) {
+            return {
+                error: "custom-personas-only must be one of: true, false, 1, 0, yes, no",
+                value: undefined,
+            };
+        }
+        return { value: parsed };
+    }
+    if (key === "baseUrl") {
+        const parsed = validateBaseUrl(value);
+        if (!parsed.value) {
+            return {
+                error: parsed.error ?? "base-url must be a valid absolute URL",
+                value: undefined,
+            };
+        }
+        return { value: parsed.value };
+    }
+    if (key === "model") {
+        return { value: value.trim() };
+    }
+    if (key === "syntheticApiKey" ||
+        key === "orchestratorModel" ||
+        key === "researchModel") {
+        return { value: trimOptionalString(value) };
+    }
+    if (key === "apiKey") {
+        return { value: trimOptionalString(value) };
+    }
+    if (key === "exaApiKey" || key === "braveApiKey") {
+        return { value: trimOptionalString(value) };
+    }
+    if (key === "searchProvider") {
+        const normalized = value.trim().toLowerCase();
+        if (normalized !== "synthetic" &&
+            normalized !== "exa" &&
+            normalized !== "brave") {
+            return {
+                error: "search-provider must be one of: synthetic, exa, brave",
+                value: undefined,
+            };
+        }
+        return { value: normalized };
+    }
+    return { value };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,SAAS,EACT,UAAU,EACV,SAAS,EACT,YAAY,EACZ,aAAa,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,6CAA6C;AAC7C,MAAM,CAAC,MAAM,gBAAgB,GAAG,qCAAqC,CAAC;AACtE,wDAAwD;AACxD,MAAM,CAAC,MAAM,aAAa,GAAG,2BAA2B,CAAC;AACzD,6CAA6C;AAC7C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC,6CAA6C;AAC7C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC,wCAAwC;AACxC,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;AACrE,gCAAgC;AAChC,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAE9D,MAAM,QAAQ,GAAgB;IAC7B,MAAM,EAAE,SAAS;IACjB,eAAe,EAAE,SAAS;IAC1B,cAAc,EAAE,WAAW;IAC3B,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,SAAS;IACtB,OAAO,EAAE,gBAAgB;IACzB,KAAK,EAAE,aAAa;IACpB,iBAAiB,EAAE,CAAC;IACpB,cAAc,EAAE,CAAC;IACjB,YAAY,EAAE,CAAC;IACf,aAAa,EAAE,IAAI;IACnB,kBAAkB,EAAE,KAAK;CACzB,CAAC;AAEF,2EAA2E;AAC3E,MAAM,UAAU,QAAQ,CACvB,KAAc,EACd,GAAW,EACX,GAAW,EACX,QAAgB;IAEhB,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC;IACjB,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,wEAAwE;AACxE,SAAS,gBAAgB,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACd,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1D,OAAO,IAAI,CAAC;QACb,CAAC;QACD,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3D,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,6DAA6D;AAC7D,SAAS,uBAAuB,CAAC,KAAc;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9C,IACC,UAAU,KAAK,WAAW;YAC1B,UAAU,KAAK,KAAK;YACpB,UAAU,KAAK,OAAO,EACrB,CAAC;YACF,OAAO,UAAU,CAAC;QACnB,CAAC;IACF,CAAC;IACD,OAAO,QAAQ,CAAC,cAAc,CAAC;AAChC,CAAC;AAED,yEAAyE;AACzE,SAAS,kBAAkB,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC;AAED,2EAA2E;AAC3E,SAAS,kBAAkB,CAAC,KAAc;IACzC,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,mFAAmF;AACnF,SAAS,gBAAgB,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,QAAQ,CAAC,OAAO,CAAC;IACzB,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,QAAQ,CAAC,OAAO,CAAC;IACzB,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACd,qBAAqB,OAAO,MAAM,MAAM,CAAC,KAAK,IAAI,8BAA8B,EAAE,CAClF,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC;AACrB,CAAC;AAED,uEAAuE;AACvE,SAAS,eAAe;IACvB,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzD,CAAC;AACF,CAAC;AAED,wEAAwE;AACxE,SAAS,cAAc;IACtB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACrD,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;IACX,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAC;QAClD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACpE,OAAO,EAAE,CAAC;QACX,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC;AAED,uEAAuE;AACvE,SAAS,yBAAyB,CAAC,MAAuB;IACzD,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;QAC/B,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC3C,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,CAAC;QACzC,MAAM,CAAC,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IAC9D,CAAC;SAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAC1C,MAAM,CAAC,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACxD,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC;QACvC,MAAM,CAAC,cAAc,GAAG,uBAAuB,CAC9C,OAAO,CAAC,GAAG,CAAC,qBAAqB,CACjC,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;QACnC,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAClD,CAAC;SAAM,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAC5C,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC;QACrC,MAAM,CAAC,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACtD,CAAC;SAAM,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;QACtC,MAAM,CAAC,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAChD,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACxC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,KAAK,SAAS,EAAE,CAAC;QACxD,MAAM,CAAC,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IACjE,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;QACpD,MAAM,CAAC,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IACzD,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAChC,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC7C,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACxE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,CAAC,kBAAkB,GAAG,MAAM,CAAC;QACpC,CAAC;IACF,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;QAClE,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,cAAc,GAAG,MAAM,CAAC;QAChC,CAAC;IACF,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,4EAA4E;AAC5E,SAAS,eAAe,CAAC,MAAmB;IAC3C,MAAM,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACnE,MAAM,cAAc,GAAG,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,cAAc,IAAI,eAAe,CAAC;IAEjD,OAAO;QACN,MAAM,EAAE,MAAM,IAAI,SAAS;QAC3B,eAAe;QACf,cAAc,EAAE,uBAAuB,CAAC,MAAM,CAAC,cAAc,CAAC;QAC9D,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC;QAC/C,WAAW,EAAE,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC;QACnD,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC;QACzC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK;QACrC,iBAAiB,EAAE,kBAAkB,CAAC,MAAM,CAAC,iBAAiB,CAAC;QAC/D,aAAa,EAAE,kBAAkB,CAAC,MAAM,CAAC,aAAa,CAAC;QACvD,iBAAiB,EAAE,QAAQ,CAC1B,MAAM,CAAC,iBAAiB,EACxB,CAAC,EACD,EAAE,EACF,QAAQ,CAAC,iBAAiB,CAC1B;QACD,cAAc,EAAE,QAAQ,CACvB,MAAM,CAAC,cAAc,EACrB,CAAC,EACD,CAAC,EACD,QAAQ,CAAC,cAAc,CACvB;QACD,YAAY,EAAE,QAAQ,CACrB,MAAM,CAAC,YAAY,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,CAAC,YAAY,CACrB;QACD,aAAa,EACZ,OAAO,MAAM,CAAC,aAAa,KAAK,SAAS;YACxC,CAAC,CAAC,MAAM,CAAC,aAAa;YACtB,CAAC,CAAC,QAAQ,CAAC,aAAa;QAC1B,kBAAkB,EACjB,OAAO,MAAM,CAAC,kBAAkB,KAAK,SAAS;YAC7C,CAAC,CAAC,MAAM,CAAC,kBAAkB;YAC3B,CAAC,CAAC,QAAQ,CAAC,kBAAkB;KAC/B,CAAC;AACH,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,aAAa;IAC5B,OAAO,WAAW,CAAC;AACpB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,UAAU,CAAC,YAA6B,EAAE;IACzD,MAAM,MAAM,GAAG;QACd,GAAG,QAAQ;QACX,GAAG,yBAAyB,CAAC,cAAc,EAAE,CAAC;QAC9C,GAAG,SAAS;KACZ,CAAC;IAEF,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,WAAW,CAAC,OAAwB;IACnD,eAAe,EAAE,CAAC;IAClB,MAAM,UAAU,GAAG,eAAe,CAAC;QAClC,GAAG,QAAQ;QACX,GAAG,cAAc,EAAE;QACnB,GAAG,OAAO;KACV,CAAC,CAAC;IAEH,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;QAC/D,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,KAAK;KACX,CAAC,CAAC;IACH,oDAAoD;IACpD,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAE9B,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,eAAe,CAAC,KAAyB;IACxD,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,YAAY,CAAC;IACrB,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,SAAS,MAAM,EAAE,CAAC;AAC1B,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,yBAAyB,CACxC,GAAsB,EACtB,KAAa;IAEb,IAAI,GAAG,KAAK,mBAAmB,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACN,KAAK,EAAE,sCAAsC;gBAC7C,KAAK,EAAE,SAAS;aAChB,CAAC;QACH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;IACvE,CAAC;IAED,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACN,KAAK,EAAE,0BAA0B;gBACjC,KAAK,EAAE,SAAS;aAChB,CAAC;QACH,CAAC;QACD,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YAClB,OAAO;gBACN,KAAK,EAAE,0BAA0B;gBACjC,KAAK,EAAE,SAAS;aAChB,CAAC;QACH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,OAAO,EAAE,KAAK,EAAE,iCAAiC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QACvE,CAAC;QACD,OAAO;YACN,KAAK,EAAE,QAAQ,CACd,MAAM,EACN,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,CAAC,YAAY,CACrB;SACD,CAAC;IACH,CAAC;IAED,IAAI,GAAG,KAAK,eAAe,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO;gBACN,KAAK,EAAE,0DAA0D;gBACjE,KAAK,EAAE,SAAS;aAChB,CAAC;QACH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,GAAG,KAAK,oBAAoB,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO;gBACN,KAAK,EACJ,iEAAiE;gBAClE,KAAK,EAAE,SAAS;aAChB,CAAC;QACH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO;gBACN,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,uCAAuC;gBAC9D,KAAK,EAAE,SAAS;aAChB,CAAC;QACH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;IAED,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACrB,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;IAChC,CAAC;IAED,IACC,GAAG,KAAK,iBAAiB;QACzB,GAAG,KAAK,mBAAmB;QAC3B,GAAG,KAAK,eAAe,EACtB,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7C,CAAC;IAED,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7C,CAAC;IAED,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;QAClD,OAAO,EAAE,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7C,CAAC;IAED,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9C,IACC,UAAU,KAAK,WAAW;YAC1B,UAAU,KAAK,KAAK;YACpB,UAAU,KAAK,OAAO,EACrB,CAAC;YACF,OAAO;gBACN,KAAK,EAAE,uDAAuD;gBAC9D,KAAK,EAAE,SAAS;aAChB,CAAC;QACH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,CAAC;AAClB,CAAC"}

package/dist/db/client.d.ts

@@ -0,0 +1,10 @@
+import Database from "better-sqlite3";
+type SqliteDatabase = InstanceType<typeof Database>;
+/** return fully qualified path to the sqlite database file. */
+export declare function getDatabasePath(): string;
+/** get initialized singleton sqlite connection with required pragmas applied. */
+export declare function getDatabase(): SqliteDatabase;
+/** close singleton database connection and clear in-memory handle. */
+export declare function closeDatabase(): void;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/db/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/db/client.ts"],"names":[],"mappings":"AAEA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAyCtC,KAAK,cAAc,GAAG,YAAY,CAAC,OAAO,QAAQ,CAAC,CAAC;AAqCpD,+DAA+D;AAC/D,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,iFAAiF;AACjF,wBAAgB,WAAW,IAAI,cAAc,CAW5C;AAED,sEAAsE;AACtE,wBAAgB,aAAa,SAK5B"}

package/dist/db/client.js

@@ -0,0 +1,93 @@
+import { chmodSync, existsSync, mkdirSync } from "node:fs";
+import { resolve } from "node:path";
+import Database from "better-sqlite3";
+import { CONFIG_DIR } from "../config.js";
+const DB_DIR = CONFIG_DIR;
+const DB_PATH = resolve(DB_DIR, "hydra.db");
+const SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS runs (
+  id TEXT PRIMARY KEY,
+  query TEXT NOT NULL,
+  agent_count INTEGER NOT NULL,
+  status TEXT NOT NULL DEFAULT 'decomposing',
+  brief TEXT,
+  error TEXT,
+  pipeline_state TEXT,
+  total_prompt_tokens INTEGER DEFAULT 0,
+  total_completion_tokens INTEGER DEFAULT 0,
+  created_at INTEGER NOT NULL,
+  completed_at INTEGER,
+  elapsed_ms INTEGER
+);
+
+CREATE TABLE IF NOT EXISTS agent_runs (
+  id TEXT PRIMARY KEY,
+  run_id TEXT NOT NULL REFERENCES runs(id) ON DELETE CASCADE,
+  phase TEXT NOT NULL,
+  persona TEXT NOT NULL,
+  system_prompt TEXT NOT NULL,
+  messages TEXT,
+  output TEXT DEFAULT '',
+  search_queries TEXT,
+  status TEXT NOT NULL DEFAULT 'running',
+  prompt_tokens INTEGER DEFAULT 0,
+  completion_tokens INTEGER DEFAULT 0,
+  started_at INTEGER NOT NULL,
+  completed_at INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS idx_agent_runs_run_id ON agent_runs(run_id);
+`;
+let db = null;
+function ensureDbDir() {
+    if (!existsSync(DB_DIR)) {
+        mkdirSync(DB_DIR, { recursive: true, mode: 0o700 });
+    }
+}
+function enforceDatabaseFilePermissions() {
+    const filePaths = [DB_PATH, `${DB_PATH}-wal`, `${DB_PATH}-shm`];
+    for (const path of filePaths) {
+        if (!existsSync(path)) {
+            continue;
+        }
+        try {
+            chmodSync(path, 0o600);
+        }
+        catch (error) {
+            if (path === DB_PATH) {
+                const message = error instanceof Error ? error.message : "unknown permission error";
+                console.warn(`[hydra] warning: could not set permissions on ${DB_PATH}: ${message}`);
+            }
+            // Ignore chmod failures for transient sqlite sidecar files.
+        }
+    }
+}
+function initializeSchema(database) {
+    database.exec("PRAGMA foreign_keys = ON;");
+    database.exec("PRAGMA journal_mode = WAL;");
+    database.exec(SCHEMA_SQL);
+}
+/** return fully qualified path to the sqlite database file. */
+export function getDatabasePath() {
+    return DB_PATH;
+}
+/** get initialized singleton sqlite connection with required pragmas applied. */
+export function getDatabase() {
+    if (db) {
+        return db;
+    }
+    ensureDbDir();
+    const database = new Database(DB_PATH);
+    initializeSchema(database);
+    enforceDatabaseFilePermissions();
+    db = database;
+    return db;
+}
+/** close singleton database connection and clear in-memory handle. */
+export function closeDatabase() {
+    if (db) {
+        db.close();
+        db = null;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/db/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/db/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,MAAM,GAAG,UAAU,CAAC;AAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAE5C,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiClB,CAAC;AAIF,IAAI,EAAE,GAA0B,IAAI,CAAC;AAErC,SAAS,WAAW;IACnB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC;AACF,CAAC;AAED,SAAS,8BAA8B;IACtC,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,MAAM,EAAE,GAAG,OAAO,MAAM,CAAC,CAAC;IAChE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,SAAS;QACV,CAAC;QACD,IAAI,CAAC;YACJ,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBACtB,MAAM,OAAO,GACZ,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,CAAC;gBACrE,OAAO,CAAC,IAAI,CACX,iDAAiD,OAAO,KAAK,OAAO,EAAE,CACtE,CAAC;YACH,CAAC;YACD,4DAA4D;QAC7D,CAAC;IACF,CAAC;AACF,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAwB;IACjD,QAAQ,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC3C,QAAQ,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC5C,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAC3B,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,eAAe;IAC9B,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,WAAW;IAC1B,IAAI,EAAE,EAAE,CAAC;QACR,OAAO,EAAE,CAAC;IACX,CAAC;IAED,WAAW,EAAE,CAAC;IACd,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;IACvC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC3B,8BAA8B,EAAE,CAAC;IACjC,EAAE,GAAG,QAAQ,CAAC;IACd,OAAO,EAAE,CAAC;AACX,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,aAAa;IAC5B,IAAI,EAAE,EAAE,CAAC;QACR,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,EAAE,GAAG,IAAI,CAAC;IACX,CAAC;AACF,CAAC"}