@baanish/hydra-cli 0.1.0

package/dist/db/queries.d.ts

@@ -0,0 +1,67 @@
+import type { AgentPhase, AgentRunRecord, AgentRunStatus, RunRecord, RunStatus } from "../types.js";
+type RunStatusPatch = Partial<Pick<RunRecord, "query" | "status" | "brief" | "error" | "pipelineState" | "totalPromptTokens" | "totalCompletionTokens" | "completedAt" | "elapsedMs">>;
+type AgentRunStatusPatch = Partial<Omit<Pick<AgentRunRecord, "messages" | "output" | "status" | "promptTokens" | "completionTokens" | "completedAt">, "searchQueries"> & {
+    searchQueries?: string[];
+    startedAt?: number;
+}>;
+/** create a new top-level run row and return the persisted record. */
+export declare function createRun(input: {
+    query: string;
+    agentCount: number;
+    status?: RunStatus;
+    pipelineState?: string | null;
+}): RunRecord;
+/** update a run record and return the fresh persisted record. */
+export declare function updateRunStatus(runId: string, patch: RunStatusPatch): RunRecord;
+/** fetch a single run by id or return null. */
+export declare function getRun(runId: string): RunRecord | null;
+/** list recent runs in descending creation order, clamped to a safe page size. */
+export declare function listRuns(limit?: number): RunRecord[];
+/** delete a run and its dependent agent rows. */
+export declare function deleteRun(runId: string): boolean;
+/** create a new agent run row in the database. */
+export declare function createAgentRun(input: {
+    runId: string;
+    phase: AgentPhase;
+    persona: string;
+    systemPrompt: string;
+    messages?: string;
+    output?: string;
+    searchQueries?: string[];
+    status?: AgentRunStatus;
+    promptTokens?: number;
+    completionTokens?: number;
+    startedAt?: number;
+    completedAt?: number | null;
+}): AgentRunRecord;
+/** apply status/output changes to an agent run and return updated state. */
+export declare function updateAgentRun(agentRunId: string, patch: AgentRunStatusPatch): AgentRunRecord;
+/** mark an agent run complete and persist usage and status metadata. */
+export declare function completeAgentRun(agentRunId: string, output: string, options?: {
+    status?: AgentRunStatus;
+    searchQueries?: string[];
+    promptTokens?: number;
+    completionTokens?: number;
+}): AgentRunRecord;
+/** fetch a single agent run or return null. */
+export declare function getAgentRun(agentRunId: string): AgentRunRecord | null;
+/** fetch all agent runs for a run ordered by start time. */
+export declare function getAgentRunsForRun(runId: string): AgentRunRecord[];
+/** alias for `getAgentRunsForRun` retained for compatibility. */
+export declare function getRunAgentRuns(runId: string): AgentRunRecord[];
+/** delete all agent runs tied to a run id. */
+export declare function deleteAgentRunsForRun(runId: string): void;
+/** legacy alias for `deleteRun` kept for compatibility. */
+export declare const deleteRunRecords: typeof deleteRun;
+/** mark a run complete with final brief and compute elapsed wall time. */
+export declare function markRunComplete(runId: string, brief: string): RunRecord;
+/** mark a run as failed and store the error message. */
+export declare function markRunFailed(runId: string, error: string): RunRecord;
+/** increment token usage counters on a run. */
+export declare function addTokenUsage(runId: string, promptTokens: number, completionTokens: number): void;
+/** backwards-compatible alias for `updateRunStatus`. */
+export declare const updateRun: typeof updateRunStatus;
+/** backwards-compatible alias for `deleteRun`. */
+export declare const removeRun: typeof deleteRun;
+export {};
+//# sourceMappingURL=queries.d.ts.map

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

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

package/dist/db/queries.js

@@ -0,0 +1,336 @@
+import { nanoid } from "nanoid";
+import { getDatabase } from "./client.js";
+function toRunRecord(row) {
+    return {
+        id: row.id,
+        query: row.query,
+        agentCount: row.agent_count,
+        status: row.status,
+        brief: row.brief,
+        error: row.error,
+        pipelineState: row.pipeline_state,
+        totalPromptTokens: row.total_prompt_tokens,
+        totalCompletionTokens: row.total_completion_tokens,
+        createdAt: row.created_at,
+        completedAt: row.completed_at,
+        elapsedMs: row.elapsed_ms,
+    };
+}
+function toAgentRunRecord(row) {
+    return {
+        id: row.id,
+        runId: row.run_id,
+        phase: row.phase,
+        persona: row.persona,
+        systemPrompt: row.system_prompt,
+        messages: row.messages ?? "[]",
+        output: row.output,
+        searchQueries: row.search_queries ?? "[]",
+        status: row.status,
+        promptTokens: row.prompt_tokens,
+        completionTokens: row.completion_tokens,
+        startedAt: row.started_at,
+        completedAt: row.completed_at,
+    };
+}
+function normalizeTokenValue(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+function toDbRunValues(input) {
+    const now = Date.now();
+    return {
+        id: nanoid(),
+        query: input.query,
+        agent_count: input.agentCount,
+        status: input.status ?? "decomposing",
+        pipeline_state: input.pipelineState ?? null,
+        created_at: now,
+    };
+}
+function toDbAgentRunValues(input) {
+    return {
+        id: nanoid(),
+        run_id: input.runId,
+        phase: input.phase,
+        persona: input.persona,
+        system_prompt: input.systemPrompt,
+        messages: input.messages ?? "[]",
+        output: input.output ?? "",
+        search_queries: JSON.stringify(input.searchQueries ?? []),
+        status: input.status ?? "running",
+        prompt_tokens: input.promptTokens ?? 0,
+        completion_tokens: input.completionTokens ?? 0,
+        started_at: input.startedAt ?? Date.now(),
+        completed_at: input.completedAt ?? null,
+    };
+}
+const RUNS_SELECT = `
+  SELECT
+    id, query, agent_count, status, brief, error, pipeline_state,
+    total_prompt_tokens, total_completion_tokens, created_at, completed_at, elapsed_ms
+  FROM runs
+`;
+const AGENT_RUNS_SELECT = `
+  SELECT
+    id, run_id, phase, persona, system_prompt, messages, output, search_queries,
+    status, prompt_tokens, completion_tokens, started_at, completed_at
+  FROM agent_runs
+`;
+/** create a new top-level run row and return the persisted record. */
+export function createRun(input) {
+    const db = getDatabase();
+    const row = toDbRunValues(input);
+    db.prepare(`
+    INSERT INTO runs (
+      id, query, agent_count, status, brief, error, pipeline_state,
+      total_prompt_tokens, total_completion_tokens, created_at, completed_at, elapsed_ms
+    )
+    VALUES (
+      ?, ?, ?, ?, NULL, NULL, ?, 0, 0, ?, NULL, NULL
+    )
+    `).run(row.id, row.query, row.agent_count, row.status, row.pipeline_state, row.created_at);
+    const created = getRun(row.id);
+    if (!created) {
+        throw new Error(`Run ${row.id} not found`);
+    }
+    return created;
+}
+/** build a patch for updating top-level run columns while enforcing defaults. */
+function buildRunPatch(patch) {
+    const fields = [];
+    const values = [];
+    if (patch.query !== undefined) {
+        fields.push("query = ?");
+        values.push(patch.query);
+    }
+    if (patch.status !== undefined) {
+        fields.push("status = ?");
+        values.push(patch.status);
+    }
+    if (patch.brief !== undefined) {
+        fields.push("brief = ?");
+        values.push(patch.brief);
+    }
+    if (patch.error !== undefined) {
+        fields.push("error = ?");
+        values.push(patch.error);
+    }
+    if (patch.pipelineState !== undefined) {
+        fields.push("pipeline_state = ?");
+        values.push(patch.pipelineState);
+    }
+    if (patch.totalPromptTokens !== undefined) {
+        fields.push("total_prompt_tokens = ?");
+        values.push(patch.totalPromptTokens);
+    }
+    if (patch.totalCompletionTokens !== undefined) {
+        fields.push("total_completion_tokens = ?");
+        values.push(patch.totalCompletionTokens);
+    }
+    if (patch.completedAt !== undefined) {
+        fields.push("completed_at = ?");
+        values.push(patch.completedAt);
+    }
+    if (patch.elapsedMs !== undefined) {
+        fields.push("elapsed_ms = ?");
+        values.push(patch.elapsedMs);
+    }
+    return { fields, values };
+}
+/** update a run record and return the fresh persisted record. */
+export function updateRunStatus(runId, patch) {
+    const db = getDatabase();
+    const { fields, values } = buildRunPatch(patch);
+    if (fields.length === 0) {
+        const run = getRun(runId);
+        if (!run) {
+            throw new Error(`Run ${runId} not found`);
+        }
+        return run;
+    }
+    db.prepare(`UPDATE runs SET ${fields.join(", ")} WHERE id = ?`).run(...values, runId);
+    const updated = getRun(runId);
+    if (!updated) {
+        throw new Error(`Run ${runId} not found`);
+    }
+    return updated;
+}
+/** fetch a single run by id or return null. */
+export function getRun(runId) {
+    const db = getDatabase();
+    const row = db
+        .prepare(`${RUNS_SELECT} WHERE id = ?`)
+        .get(runId);
+    return row ? toRunRecord(row) : null;
+}
+/** list recent runs in descending creation order, clamped to a safe page size. */
+export function listRuns(limit = 50) {
+    const db = getDatabase();
+    const rows = db
+        .prepare(`${RUNS_SELECT} ORDER BY created_at DESC LIMIT ?`)
+        .all(Math.max(1, Math.min(limit, 500)));
+    return rows.map(toRunRecord);
+}
+/** delete a run and its dependent agent rows. */
+export function deleteRun(runId) {
+    const db = getDatabase();
+    deleteAgentRunsForRun(runId);
+    const result = db.prepare("DELETE FROM runs WHERE id = ?").run(runId);
+    return result.changes > 0;
+}
+/** create a new agent run row in the database. */
+export function createAgentRun(input) {
+    const db = getDatabase();
+    const row = toDbAgentRunValues(input);
+    db.prepare(`
+    INSERT INTO agent_runs (
+      id, run_id, phase, persona, system_prompt, messages, output, search_queries,
+      status, prompt_tokens, completion_tokens, started_at, completed_at
+    )
+    VALUES (
+      ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?
+    )
+    `).run(row.id, row.run_id, row.phase, row.persona, row.system_prompt, row.messages, row.output, row.search_queries, row.status, row.prompt_tokens, row.completion_tokens, row.started_at, row.completed_at);
+    const agentRun = getAgentRun(row.id);
+    if (!agentRun) {
+        throw new Error(`Failed to create agent run ${row.id}`);
+    }
+    return agentRun;
+}
+/** build a patch for updating agent run columns. */
+function buildAgentRunPatch(patch) {
+    const fields = [];
+    const values = [];
+    if (patch.messages !== undefined) {
+        fields.push("messages = ?");
+        values.push(patch.messages);
+    }
+    if (patch.output !== undefined) {
+        fields.push("output = ?");
+        values.push(patch.output);
+    }
+    if (patch.searchQueries !== undefined) {
+        fields.push("search_queries = ?");
+        values.push(JSON.stringify(patch.searchQueries));
+    }
+    if (patch.status !== undefined) {
+        fields.push("status = ?");
+        values.push(patch.status);
+    }
+    if (patch.promptTokens !== undefined) {
+        fields.push("prompt_tokens = ?");
+        values.push(normalizeTokenValue(patch.promptTokens));
+    }
+    if (patch.completionTokens !== undefined) {
+        fields.push("completion_tokens = ?");
+        values.push(normalizeTokenValue(patch.completionTokens));
+    }
+    if (patch.completedAt !== undefined) {
+        fields.push("completed_at = ?");
+        values.push(patch.completedAt);
+    }
+    if (patch.startedAt !== undefined) {
+        fields.push("started_at = ?");
+        values.push(patch.startedAt);
+    }
+    return { fields, values };
+}
+/** apply status/output changes to an agent run and return updated state. */
+export function updateAgentRun(agentRunId, patch) {
+    const db = getDatabase();
+    const { fields, values } = buildAgentRunPatch(patch);
+    if (fields.length === 0) {
+        const existing = getAgentRun(agentRunId);
+        if (!existing) {
+            throw new Error(`Agent run ${agentRunId} not found`);
+        }
+        return existing;
+    }
+    db.prepare(`UPDATE agent_runs SET ${fields.join(", ")} WHERE id = ?`).run(...values, agentRunId);
+    const run = getAgentRun(agentRunId);
+    if (!run) {
+        throw new Error(`Agent run ${agentRunId} not found`);
+    }
+    return run;
+}
+/** mark an agent run complete and persist usage and status metadata. */
+export function completeAgentRun(agentRunId, output, options) {
+    return updateAgentRun(agentRunId, {
+        output,
+        status: options?.status ?? "complete",
+        searchQueries: options?.searchQueries,
+        promptTokens: options?.promptTokens,
+        completionTokens: options?.completionTokens,
+        completedAt: Date.now(),
+    });
+}
+/** fetch a single agent run or return null. */
+export function getAgentRun(agentRunId) {
+    const db = getDatabase();
+    const row = db
+        .prepare(`${AGENT_RUNS_SELECT} WHERE id = ?`)
+        .get(agentRunId);
+    return row ? toAgentRunRecord(row) : null;
+}
+/** fetch all agent runs for a run ordered by start time. */
+export function getAgentRunsForRun(runId) {
+    const db = getDatabase();
+    const rows = db
+        .prepare(`${AGENT_RUNS_SELECT} WHERE run_id = ? ORDER BY rowid`)
+        .all(runId);
+    return rows.map(toAgentRunRecord);
+}
+/** alias for `getAgentRunsForRun` retained for compatibility. */
+export function getRunAgentRuns(runId) {
+    return getAgentRunsForRun(runId);
+}
+/** delete all agent runs tied to a run id. */
+export function deleteAgentRunsForRun(runId) {
+    const db = getDatabase();
+    db.prepare("DELETE FROM agent_runs WHERE run_id = ?").run(runId);
+}
+/** legacy alias for `deleteRun` kept for compatibility. */
+export const deleteRunRecords = deleteRun;
+/** mark a run complete with final brief and compute elapsed wall time. */
+export function markRunComplete(runId, brief) {
+    const run = getRun(runId);
+    if (!run) {
+        throw new Error(`Run ${runId} not found`);
+    }
+    const completedAt = Date.now();
+    return updateRunStatus(runId, {
+        status: "complete",
+        brief,
+        completedAt,
+        elapsedMs: completedAt - run.createdAt,
+        error: null,
+    });
+}
+/** mark a run as failed and store the error message. */
+export function markRunFailed(runId, error) {
+    const run = getRun(runId);
+    if (!run) {
+        throw new Error(`Run ${runId} not found`);
+    }
+    return updateRunStatus(runId, {
+        status: "error",
+        error,
+        completedAt: Date.now(),
+        elapsedMs: Date.now() - run.createdAt,
+    });
+}
+/** increment token usage counters on a run. */
+export function addTokenUsage(runId, promptTokens, completionTokens) {
+    const db = getDatabase();
+    db.prepare(`
+    UPDATE runs
+    SET total_prompt_tokens = total_prompt_tokens + ?, total_completion_tokens = total_completion_tokens + ?
+    WHERE id = ?
+  `).run(promptTokens, completionTokens, runId);
+}
+// Backward-compatible aliases for older callers.
+/** backwards-compatible alias for `updateRunStatus`. */
+export const updateRun = updateRunStatus;
+/** backwards-compatible alias for `deleteRun`. */
+export const removeRun = deleteRun;
+//# sourceMappingURL=queries.js.map

package/dist/db/queries.js.map

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

package/dist/engine/concurrency.d.ts

@@ -0,0 +1,3 @@
+/** run asynchronous work with bounded concurrency and optional progress callback. */
+export declare function runWithConcurrency<T, R>(items: T[], concurrency: number, fn: (item: T, index: number) => Promise<R>, onProgress?: (completed: number, total: number) => void): Promise<R[]>;
+//# sourceMappingURL=concurrency.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/engine/concurrency.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAC5C,KAAK,EAAE,CAAC,EAAE,EACV,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GACrD,OAAO,CAAC,CAAC,EAAE,CAAC,CA2Cd"}

package/dist/engine/concurrency.js

@@ -0,0 +1,42 @@
+/** run asynchronous work with bounded concurrency and optional progress callback. */
+export async function runWithConcurrency(items, concurrency, fn, onProgress) {
+    const total = items.length;
+    if (total === 0) {
+        return [];
+    }
+    const safeConcurrency = Math.max(1, Math.floor(concurrency));
+    const results = new Array(total);
+    let nextIndex = 0;
+    let completed = 0;
+    let hasFirstError = false;
+    let firstError;
+    const worker = async () => {
+        while (true) {
+            const currentIndex = nextIndex++;
+            if (currentIndex >= total) {
+                return;
+            }
+            try {
+                const item = items[currentIndex];
+                results[currentIndex] = await fn(item, currentIndex);
+            }
+            catch (error) {
+                if (!hasFirstError) {
+                    hasFirstError = true;
+                    firstError = error;
+                }
+            }
+            finally {
+                completed += 1;
+                onProgress?.(completed, total);
+            }
+        }
+    };
+    const workers = Array.from({ length: Math.min(total, safeConcurrency) }, () => worker());
+    await Promise.all(workers);
+    if (hasFirstError) {
+        throw firstError;
+    }
+    return results;
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/engine/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/engine/concurrency.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,KAAU,EACV,WAAmB,EACnB,EAA0C,EAC1C,UAAuD;IAEvD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3B,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,UAAmB,CAAC;IAExB,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;QACzB,OAAO,IAAI,EAAE,CAAC;YACb,MAAM,YAAY,GAAG,SAAS,EAAE,CAAC;YACjC,IAAI,YAAY,IAAI,KAAK,EAAE,CAAC;gBAC3B,OAAO;YACR,CAAC;YAED,IAAI,CAAC;gBACJ,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;gBACjC,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YACtD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,IAAI,CAAC,aAAa,EAAE,CAAC;oBACpB,aAAa,GAAG,IAAI,CAAC;oBACrB,UAAU,GAAG,KAAK,CAAC;gBACpB,CAAC;YACF,CAAC;oBAAS,CAAC;gBACV,SAAS,IAAI,CAAC,CAAC;gBACf,UAAU,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAChC,CAAC;QACF,CAAC;IACF,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,EAAE,GAAG,EAAE,CAC7E,MAAM,EAAE,CACR,CAAC;IACF,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,aAAa,EAAE,CAAC;QACnB,MAAM,UAAU,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC"}

package/dist/engine/eta.d.ts

@@ -0,0 +1,16 @@
+/** estimate remaining wall clock with recent completion samples and concurrency. */
+export declare class ETAEstimator {
+    private completionTimesMs;
+    private readonly maxSamples;
+    /** initialize the estimator with optional max sample size for smoothing. */
+    constructor(maxSamples?: number);
+    /** record a completed item duration in milliseconds for future estimates. */
+    recordCompletion(durationMs: number): void;
+    /** estimate remaining time from current samples and configured concurrency. */
+    estimate(remainingItems: number, currentConcurrency: number): string;
+    /** clear any stored completion samples. */
+    reset(): void;
+}
+/** format milliseconds into a human friendly `Xm Ss` or `Ns` string. */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=eta.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eta.d.ts","sourceRoot":"","sources":["../../src/engine/eta.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,qBAAa,YAAY;IACxB,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,4EAA4E;gBAChE,UAAU,SAAK;IAI3B,6EAA6E;IAC7E,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAW1C,+EAA+E;IAC/E,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM;IAoBpE,2CAA2C;IAC3C,KAAK,IAAI,IAAI;CAGb;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAajD"}

package/dist/engine/eta.js

@@ -0,0 +1,54 @@
+/** estimate remaining wall clock with recent completion samples and concurrency. */
+export class ETAEstimator {
+    completionTimesMs = [];
+    maxSamples;
+    /** initialize the estimator with optional max sample size for smoothing. */
+    constructor(maxSamples = 20) {
+        this.maxSamples = Math.max(1, maxSamples);
+    }
+    /** record a completed item duration in milliseconds for future estimates. */
+    recordCompletion(durationMs) {
+        if (!Number.isFinite(durationMs) || durationMs <= 0) {
+            return;
+        }
+        this.completionTimesMs.push(durationMs);
+        if (this.completionTimesMs.length > this.maxSamples) {
+            this.completionTimesMs.shift();
+        }
+    }
+    /** estimate remaining time from current samples and configured concurrency. */
+    estimate(remainingItems, currentConcurrency) {
+        if (!Number.isFinite(remainingItems) || remainingItems <= 0) {
+            return "0s";
+        }
+        if (this.completionTimesMs.length === 0) {
+            return "--";
+        }
+        const safeConcurrency = Number.isFinite(currentConcurrency) && currentConcurrency > 0
+            ? Math.floor(currentConcurrency)
+            : 1;
+        const average = this.completionTimesMs.reduce((sum, value) => sum + value, 0) /
+            this.completionTimesMs.length;
+        const batches = Math.ceil(remainingItems / safeConcurrency);
+        const estimateMs = Math.max(0, Math.round(average * batches));
+        return formatDuration(estimateMs);
+    }
+    /** clear any stored completion samples. */
+    reset() {
+        this.completionTimesMs = [];
+    }
+}
+/** format milliseconds into a human friendly `Xm Ss` or `Ns` string. */
+export function formatDuration(ms) {
+    if (!Number.isFinite(ms) || ms <= 0) {
+        return "0s";
+    }
+    const totalSeconds = Math.max(1, Math.round(ms / 1000));
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    if (minutes > 0) {
+        return `${minutes}m ${String(seconds).padStart(2, "0")}s`;
+    }
+    return `${seconds}s`;
+}
+//# sourceMappingURL=eta.js.map

package/dist/engine/eta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eta.js","sourceRoot":"","sources":["../../src/engine/eta.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,OAAO,YAAY;IAChB,iBAAiB,GAAa,EAAE,CAAC;IACxB,UAAU,CAAS;IAEpC,4EAA4E;IAC5E,YAAY,UAAU,GAAG,EAAE;QAC1B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED,6EAA6E;IAC7E,gBAAgB,CAAC,UAAkB;QAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;YACrD,OAAO;QACR,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,iBAAiB,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YACrD,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAChC,CAAC;IACF,CAAC;IAED,+EAA+E;IAC/E,QAAQ,CAAC,cAAsB,EAAE,kBAA0B;QAC1D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC;QACb,CAAC;QACD,IAAI,IAAI,CAAC,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC;QACb,CAAC;QAED,MAAM,eAAe,GACpB,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,kBAAkB,GAAG,CAAC;YAC5D,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC;YAChC,CAAC,CAAC,CAAC,CAAC;QACN,MAAM,OAAO,GACZ,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC;YAC7D,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,eAAe,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;QAC9D,OAAO,cAAc,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;IAED,2CAA2C;IAC3C,KAAK;QACJ,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC;IAC7B,CAAC;CACD;AAED,wEAAwE;AACxE,MAAM,UAAU,cAAc,CAAC,EAAU;IACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,YAAY,GAAG,EAAE,CAAC;IAElC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QACjB,OAAO,GAAG,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;IAC3D,CAAC;IACD,OAAO,GAAG,OAAO,GAAG,CAAC;AACtB,CAAC"}

package/dist/engine/model.d.ts

@@ -0,0 +1,57 @@
+import type { SearchConfig } from "../types.js";
+type NormalizedToolCall = {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+};
+type NormalizedMessage = {
+    role: "system";
+    content: string;
+} | {
+    role: "user";
+    content: string;
+} | {
+    role: "assistant";
+    content: string;
+    tool_calls?: NormalizedToolCall[];
+} | {
+    role: "tool";
+    content: string;
+    tool_call_id: string;
+};
+/** normalized result from a model invocation including usage and trace. */
+export interface ModelRunResult {
+    /** normalized output text after model cleanup. */
+    output: string;
+    messages: NormalizedMessage[];
+    searchQueries: string[];
+    promptTokens: number;
+    completionTokens: number;
+    executionStartedAt: number;
+}
+/** options required to execute a model invocation in the pipeline. */
+export interface ModelRunInput {
+    apiKey: string;
+    baseUrl: string;
+    model: string;
+    searchConfig: SearchConfig;
+    systemPrompt: string;
+    userPrompt: string;
+    maxToolCalls?: number;
+    allowTools?: boolean;
+    temperature?: number;
+    onExecutionStart?: (timestamp: number) => void;
+}
+/** strip tool-call wrapper tags from model output before presentation. */
+export declare function cleanModelOutput(text: string): string;
+/** run a model turn with optional search/tool calling and return normalized artifacts. */
+export declare function runModelWithOptionalTools(input: ModelRunInput): Promise<ModelRunResult>;
+/** run a model turn with tool support explicitly enabled. */
+export declare function runModelWithTools(input: ModelRunInput): Promise<ModelRunResult>;
+/** clip tool-call result text to avoid runaway token usage in context. */
+export declare function cleanSearchResultOutput(resultText: string, maxChars?: number): string;
+export {};
+//# sourceMappingURL=model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/engine/model.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,KAAK,kBAAkB,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KAClB,CAAC;CACF,CAAC;AACF,KAAK,iBAAiB,GACnB;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACf,GACD;IACA,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACf,GACD;IACA,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACjC,GACD;IACA,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACpB,CAAC;AAEL,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC9B,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC3B;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C;AA2bD,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASrD;AAED,0FAA0F;AAC1F,wBAAsB,yBAAyB,CAC9C,KAAK,EAAE,aAAa,GAClB,OAAO,CAAC,cAAc,CAAC,CAwLzB;AAED,6DAA6D;AAC7D,wBAAsB,iBAAiB,CACtC,KAAK,EAAE,aAAa,GAClB,OAAO,CAAC,cAAc,CAAC,CAEzB;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CACtC,UAAU,EAAE,MAAM,EAClB,QAAQ,SAAwB,GAC9B,MAAM,CAIR"}