@baanish/hydra-cli 0.1.0

package/dist/engine/personas.js

@@ -0,0 +1,336 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { CONFIG_DIR } from "../config.js";
+const PERSONA_ID_PATTERN = /^[a-z0-9-]+$/;
+function trimPersonaValue(value) {
+    return value.trim();
+}
+function normalizePersona(persona) {
+    return {
+        id: trimPersonaValue(persona.id).toLowerCase(),
+        name: trimPersonaValue(persona.name),
+        description: trimPersonaValue(persona.description),
+        methodology: trimPersonaValue(persona.methodology),
+    };
+}
+function isPersonaConfig(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const candidate = value;
+    if (typeof candidate.id !== "string" ||
+        typeof candidate.name !== "string" ||
+        typeof candidate.description !== "string" ||
+        typeof candidate.methodology !== "string") {
+        return false;
+    }
+    const normalized = normalizePersona({
+        id: candidate.id,
+        name: candidate.name,
+        description: candidate.description,
+        methodology: candidate.methodology,
+    });
+    return (normalized.id.length > 0 &&
+        PERSONA_ID_PATTERN.test(normalized.id) &&
+        normalized.name.length > 0 &&
+        normalized.description.length > 0 &&
+        normalized.methodology.length > 0);
+}
+function ensurePersonasDirectoryExists() {
+    const personasDirectory = dirname(PERSONAS_FILE);
+    if (!existsSync(personasDirectory)) {
+        mkdirSync(personasDirectory, { recursive: true, mode: 0o700 });
+    }
+}
+/** location of custom personas persisted on disk. */
+export let PERSONAS_FILE = resolve(CONFIG_DIR, "personas.json");
+/** set custom personas storage path for tests or controlled environments. */
+export function setPersonasFile(path) {
+    PERSONAS_FILE = path;
+}
+/** return current custom personas storage path. */
+export function getPersonasFile() {
+    return PERSONAS_FILE;
+}
+/** complete set of built-in personas used by orchestration phases. */
+export const PERSONAS = [
+    {
+        id: "skeptic",
+        name: "The Skeptic",
+        description: "Questions assumptions, demands evidence, and identifies logical fallacies.",
+        methodology: "first-principles validation",
+    },
+    {
+        id: "optimist",
+        name: "The Optimist",
+        description: "Explores upside scenarios and hidden opportunities.",
+        methodology: "opportunity mapping",
+    },
+    {
+        id: "historian",
+        name: "The Historian",
+        description: "Uses analogies from history and precedent.",
+        methodology: "historical pattern comparison",
+    },
+    {
+        id: "contrarian",
+        name: "The Contrarian",
+        description: "Argues the opposite case to reveal weak assumptions.",
+        methodology: "inverse thesis testing",
+    },
+    {
+        id: "technical-analyst",
+        name: "The Technical Analyst",
+        description: "Data-driven and quantitative.",
+        methodology: "metric-first decomposition",
+    },
+    {
+        id: "risk-assessor",
+        name: "The Risk Assessor",
+        description: "Identifies failure modes and downside scenarios.",
+        methodology: "risk tree analysis",
+    },
+    {
+        id: "futurist",
+        name: "The Futurist",
+        description: "Extrapolates trends and second-order effects.",
+        methodology: "scenario projection",
+    },
+    {
+        id: "devils-advocate",
+        name: "The Devil's Advocate",
+        description: "Stress-tests every conclusion under pressure.",
+        methodology: "adversarial stress testing",
+    },
+    {
+        id: "domain-expert",
+        name: "The Domain Expert",
+        description: "Deep specialist-style contextual analysis.",
+        methodology: "domain-specific synthesis",
+    },
+    {
+        id: "synthesizer",
+        name: "The Synthesizer",
+        description: "Connects disparate findings into cohesive patterns.",
+        methodology: "cross-signal synthesis",
+    },
+    {
+        id: "economist",
+        name: "The Economist",
+        description: "Analyzes cost structures, market dynamics, and economic incentives.",
+        methodology: "economic modeling and incentive analysis",
+    },
+    {
+        id: "pragmatist",
+        name: "The Pragmatist",
+        description: "Focuses on actionable, implementable solutions over theory.",
+        methodology: "feasibility-first evaluation",
+    },
+    {
+        id: "ethicist",
+        name: "The Ethicist",
+        description: "Examines moral implications, fairness, and societal impact.",
+        methodology: "ethical framework analysis",
+    },
+    {
+        id: "systems-thinker",
+        name: "The Systems Thinker",
+        description: "Maps feedback loops, dependencies, and emergent behaviors.",
+        methodology: "systems dynamics modeling",
+    },
+    {
+        id: "consumer-advocate",
+        name: "The Consumer Advocate",
+        description: "Evaluates from the end-user perspective: value, experience, and satisfaction.",
+        methodology: "user-centric value analysis",
+    },
+    {
+        id: "geopolitical-analyst",
+        name: "The Geopolitical Analyst",
+        description: "Considers supply chains, trade policy, and regional dynamics.",
+        methodology: "geopolitical risk mapping",
+    },
+    {
+        id: "data-scientist",
+        name: "The Data Scientist",
+        description: "Seeks statistical evidence, benchmarks, and empirical validation.",
+        methodology: "statistical evidence synthesis",
+    },
+    {
+        id: "venture-strategist",
+        name: "The Venture Strategist",
+        description: "Evaluates through the lens of market timing, moats, and competitive advantage.",
+        methodology: "competitive positioning analysis",
+    },
+    {
+        id: "red-teamer",
+        name: "The Red Teamer",
+        description: "Actively tries to break the consensus and find fatal flaws.",
+        methodology: "adversarial attack surface analysis",
+    },
+    {
+        id: "philosopher",
+        name: "The Philosopher",
+        description: "Questions framing, definitions, and hidden assumptions in the question itself.",
+        methodology: "epistemic deconstruction",
+    },
+];
+const BUILTIN_PERSONA_IDS = new Set(PERSONAS.map((persona) => persona.id));
+/** number of built-in personas. */
+export const BUILTIN_PERSONA_COUNT = PERSONAS.length;
+const EPHEMERAL_PERSONA_PROMPT = "You are a persona designer. Return ONLY a valid JSON array of analyst personas.";
+function parsePersonaCandidates(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        return [];
+    }
+    let candidate = trimmed;
+    const fenced = trimmed.match(/```(?:json)?\s*([\s\S]*?)```/i);
+    if (fenced?.[1]) {
+        candidate = fenced[1].trim();
+    }
+    else {
+        const start = trimmed.indexOf("[");
+        const end = trimmed.lastIndexOf("]");
+        if (start === -1 || end <= start) {
+            return [];
+        }
+        candidate = trimmed.slice(start, end + 1).trim();
+    }
+    try {
+        const parsed = JSON.parse(candidate);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+/** generate additional personas from the model to fill a custom personas shortfall. */
+export async function generateEphemeralPersonas(query, count, runModel) {
+    const targetCount = Math.max(0, count);
+    if (targetCount === 0) {
+        return [];
+    }
+    const personas = [];
+    const usedIds = new Set();
+    const missingPrompt = (remaining) => `Generate ${remaining} distinct analyst personas best suited to research: "${query}". Return a JSON array where each object has: id (lowercase-alphanumeric-hyphens), name, description (one sentence), methodology (short phrase). No markdown, no explanation.`;
+    for (let attempt = 0; attempt < 3 && personas.length < targetCount; attempt += 1) {
+        const remaining = targetCount - personas.length;
+        const userPrompt = missingPrompt(remaining);
+        const raw = await runModel(EPHEMERAL_PERSONA_PROMPT, userPrompt);
+        const candidates = parsePersonaCandidates(raw);
+        for (const candidate of candidates) {
+            if (!isPersonaConfig(candidate)) {
+                continue;
+            }
+            const normalized = normalizePersona(candidate);
+            if (usedIds.has(normalized.id)) {
+                continue;
+            }
+            usedIds.add(normalized.id);
+            personas.push(normalized);
+            if (personas.length >= targetCount) {
+                break;
+            }
+        }
+    }
+    return personas.slice(0, targetCount);
+}
+/** load and normalize all custom personas from config storage. */
+export function loadCustomPersonas() {
+    try {
+        if (!existsSync(PERSONAS_FILE)) {
+            return [];
+        }
+        const raw = readFileSync(PERSONAS_FILE, "utf8").trim();
+        if (!raw) {
+            return [];
+        }
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed) || !parsed.every(isPersonaConfig)) {
+            return [];
+        }
+        return parsed.map((value) => normalizePersona(value));
+    }
+    catch {
+        return [];
+    }
+}
+/** write custom personas list to disk with restricted file permissions. */
+export function saveCustomPersonas(personas) {
+    ensurePersonasDirectoryExists();
+    writeFileSync(PERSONAS_FILE, JSON.stringify(personas, null, 2), {
+        encoding: "utf8",
+        mode: 0o600,
+    });
+    chmodSync(PERSONAS_FILE, 0o600);
+}
+/** append a new custom persona after validation and persist it. */
+export function addCustomPersona(persona) {
+    const candidate = normalizePersona(persona);
+    if (!candidate.id.length) {
+        return { error: "id must be non-empty" };
+    }
+    if (!candidate.name.length) {
+        return { error: "name must be non-empty" };
+    }
+    if (!candidate.description.length) {
+        return { error: "description must be non-empty" };
+    }
+    if (!candidate.methodology.length) {
+        return { error: "methodology must be non-empty" };
+    }
+    if (!PERSONA_ID_PATTERN.test(candidate.id)) {
+        return {
+            error: "id must be lowercase alphanumeric and hyphens only",
+        };
+    }
+    if (BUILTIN_PERSONA_IDS.has(candidate.id)) {
+        return { error: "id already exists" };
+    }
+    const customPersonas = loadCustomPersonas();
+    if (customPersonas.some((existing) => existing.id === candidate.id)) {
+        return { error: "id already exists" };
+    }
+    try {
+        saveCustomPersonas([...customPersonas, candidate]);
+    }
+    catch {
+        return { error: "failed to persist custom personas" };
+    }
+    return {};
+}
+/** remove a custom persona by id from storage. */
+export function removeCustomPersona(id) {
+    const normalizedId = trimPersonaValue(id).toLowerCase();
+    if (!normalizedId.length) {
+        return false;
+    }
+    const customPersonas = loadCustomPersonas();
+    const filteredPersonas = customPersonas.filter((persona) => persona.id !== normalizedId);
+    if (filteredPersonas.length === customPersonas.length) {
+        return false;
+    }
+    try {
+        saveCustomPersonas(filteredPersonas);
+    }
+    catch {
+        return false;
+    }
+    return true;
+}
+/** return built-in and custom personas with built-ins first. */
+export function allPersonas() {
+    return [...PERSONAS, ...loadCustomPersonas()];
+}
+/** find a persona by exact display name from built-ins. */
+export function getPersonaByName(name) {
+    return PERSONAS.find((persona) => persona.name === name);
+}
+/** select a stable prefix of personas up to requested count. */
+export function selectPersonas(count) {
+    const all = allPersonas();
+    const safeCount = Math.max(1, Math.min(all.length, count));
+    return all.slice(0, safeCount);
+}
+//# sourceMappingURL=personas.js.map

package/dist/engine/personas.js.map

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

package/dist/engine/pipeline.d.ts

@@ -0,0 +1,61 @@
+import { EventEmitter } from "node:events";
+import { addTokenUsage, completeAgentRun, createAgentRun, createRun, markRunComplete, markRunFailed, updateAgentRun, updateRunStatus } from "../db/queries.js";
+import type { PersonaConfig, SearchConfig } from "../types.js";
+import { runWithConcurrency } from "./concurrency.js";
+import { runModelWithOptionalTools } from "./model.js";
+/** configuration passed to pipeline creation and used across all phases. */
+export interface PipelineConfig {
+    apiKey: string;
+    baseUrl: string;
+    model: string;
+    orchestratorModel?: string;
+    researchModel?: string;
+    searchConfig: SearchConfig;
+    agentCount: number;
+    maxConcurrency: number;
+    debateRounds: number;
+    searchEnabled: boolean;
+    customPersonasOnly: boolean;
+}
+export type PipelineDependencies = {
+    runModel: typeof runModelWithOptionalTools;
+    runWithConcurrency: typeof runWithConcurrency;
+    personas: PersonaConfig[] | (() => PersonaConfig[]);
+    createRun: typeof createRun;
+    createAgentRun: typeof createAgentRun;
+    completeAgentRun: typeof completeAgentRun;
+    updateAgentRun: typeof updateAgentRun;
+    updateRunStatus: typeof updateRunStatus;
+    markRunComplete: typeof markRunComplete;
+    markRunFailed: typeof markRunFailed;
+    addTokenUsage: typeof addTokenUsage;
+};
+/** orchestrates a full hydra run across decomposition, research, debate, and synthesis. */
+export declare class HydraPipeline extends EventEmitter {
+    #private;
+    /** initialize pipeline with validated runtime configuration. */
+    constructor(config: PipelineConfig, dependencies?: Partial<PipelineDependencies>);
+    /** execute the full pipeline for a user query and return run metadata. */
+    run(query: string): Promise<{
+        runId: string;
+        brief: string;
+    }>;
+    private decompose;
+    private runResearchPhase;
+    private runDebateRounds;
+    private runDebateRound;
+    private synthesize;
+    private runModel;
+    private setStatus;
+    private normalizeAssignments;
+    private parseAssignments;
+    private extractBracketPayload;
+    private resolvePersona;
+    private formatCodeBlock;
+    private buildDebatePrompt;
+    private trimDebateContext;
+    private formatPersonaOutputs;
+    private toAgentState;
+    private resolvePersonas;
+}
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/engine/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/engine/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EACN,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,eAAe,EACf,aAAa,EACb,cAAc,EACd,eAAe,EACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAGX,aAAa,EAGb,YAAY,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAuB,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAa5E,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,kBAAkB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,oBAAoB,GAAG;IAClC,QAAQ,EAAE,OAAO,yBAAyB,CAAC;IAC3C,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,QAAQ,EAAE,aAAa,EAAE,GAAG,CAAC,MAAM,aAAa,EAAE,CAAC,CAAC;IACpD,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,cAAc,EAAE,OAAO,cAAc,CAAC;IACtC,gBAAgB,EAAE,OAAO,gBAAgB,CAAC;IAC1C,cAAc,EAAE,OAAO,cAAc,CAAC;IACtC,eAAe,EAAE,OAAO,eAAe,CAAC;IACxC,eAAe,EAAE,OAAO,eAAe,CAAC;IACxC,aAAa,EAAE,OAAO,aAAa,CAAC;IACpC,aAAa,EAAE,OAAO,aAAa,CAAC;CACpC,CAAC;AA6CF,2FAA2F;AAC3F,qBAAa,aAAc,SAAQ,YAAY;;IAQ9C,gEAAgE;gBAE/D,MAAM,EAAE,cAAc,EACtB,YAAY,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAYjD,0EAA0E;IACpE,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;YAgJrD,SAAS;YAuCT,gBAAgB;YAyJhB,eAAe;YAsBf,cAAc;YAoLd,UAAU;YA+BV,QAAQ;IAiCtB,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,oBAAoB;IA2E5B,OAAO,CAAC,gBAAgB;IAwDxB,OAAO,CAAC,qBAAqB;IAc7B,OAAO,CAAC,cAAc;IA2BtB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,iBAAiB;IA8BzB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,eAAe;CAKvB"}