open-multi-agent-kit 0.80.0 → 0.80.3

package/dist/util/reasoning-nlp.js

@@ -1,325 +0,0 @@
-/**
- * Reasoning NLP — Types, normalizer, accumulator, and JSONL writer for reasoning/thinking frames.
- *
- * Pipeline: provider output → ReasoningAccumulator.feed() → ReasoningFrame[] → reasoning.jsonl
- *
- * Visibility modes:
- *   off     — hidden (production default)
- *   summary — summarized reasoning exposed in chat (recommended)
- *   debug   — raw provider think/trace/status in dev logs only
- */
-import { appendFile, mkdir } from "fs/promises";
-import { dirname, join } from "path";
-import { style } from "./theme.js";
-// ── Secret redaction ──
-const SECRET_PATTERNS = [
-    /(?:api[_-]?key|token|secret|password|credential|authorization)\s*[:=]\s*["']?([^\s"']{8,})/gi,
-    /(?:sk|pk|rk)[-_][A-Za-z0-9]{20,}/g,
-    /(?:ghp|gho|ghu|ghs|ghr)_[A-Za-z0-9]{36,}/g,
-    /(?:xoxb|xoxp|xoxa|xoxr)-[A-Za-z0-9-]+/g,
-    /Bearer\s+[A-Za-z0-9._-]{20,}/gi,
-    /eyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}/g, // JWT
-    /(?:-----BEGIN\s+(?:RSA\s+)?PRIVATE\s+KEY-----)/g,
-];
-function redactSecrets(text) {
-    let result = text;
-    for (const pattern of SECRET_PATTERNS) {
-        result = result.replace(pattern, "[REDACTED]");
-    }
-    return result;
-}
-// ── Pattern matching ──
-const THINK_OPEN_RE = /^<think(?:ing)?>[\s:]*/i;
-const THINK_CLOSE_RE = /<\/think(?:ing)?>\s*$/i;
-const THINK_SINGLE_RE = /^<think(?:ing)?>[\s:]*(.+?)(?:<\/think(?:ing)?>)?$/is;
-const TOOL_ACTIVITY_RE = /read_file|write_file|edit_file|search_files|glob|grep|ctx_read|bash|webfetch/i;
-const TOOL_PATH_RE = /["']([^"']{1,120})["']/;
-const PLAN_RE = /^(?:step|plan|phase|first|next|then|finally|now)[\s:]/i;
-const STATUS_RE = /^(?:running|processing|thinking|analyzing|searching|generating|loading|saving)/i;
-function classifyLine(line) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.length < 3)
-        return null;
-    // Single-line think tags
-    const thinkMatch = trimmed.match(THINK_SINGLE_RE);
-    if (thinkMatch) {
-        return { kind: "thinking", text: thinkMatch[1].trim() };
-    }
-    // Tool activity
-    if (TOOL_ACTIVITY_RE.test(trimmed)) {
-        const pathMatch = trimmed.match(TOOL_PATH_RE);
-        const text = pathMatch
-            ? `📄 ${pathMatch[1].split("/").pop() ?? pathMatch[1]}`
-            : `🔧 ${trimmed.slice(0, 80)}`;
-        return { kind: "tool-activity", text };
-    }
-    // Plan lines
-    if (PLAN_RE.test(trimmed) && trimmed.length > 10) {
-        return { kind: "plan", text: trimmed.slice(0, 200) };
-    }
-    // Status lines
-    if (STATUS_RE.test(trimmed) && trimmed.length < 100) {
-        return { kind: "status", text: trimmed };
-    }
-    return null;
-}
-// ── ReasoningAccumulator (streaming multi-line think tag support) ──
-export class ReasoningAccumulator {
-    provider;
-    buffer = "";
-    inThinkBlock = false;
-    lastFrameTime = Date.now();
-    frames = [];
-    constructor(provider) {
-        this.provider = provider;
-    }
-    /**
-     * Feed a streaming chunk. Returns any completed frames.
-     * Handles multi-line <think>...</think> and <thinking>...</thinking> blocks.
-     */
-    feed(chunk, visibility) {
-        if (visibility === "off")
-            return [];
-        const now = Date.now();
-        const elapsed = now - this.lastFrameTime;
-        const lines = chunk.split("\n");
-        const result = [];
-        for (const rawLine of lines) {
-            const trimmed = rawLine.trim();
-            if (this.inThinkBlock) {
-                // Check for closing tag
-                if (THINK_CLOSE_RE.test(trimmed)) {
-                    const text = this.buffer.trim();
-                    if (text) {
-                        const frame = this.makeFrame("thinking", text, elapsed);
-                        result.push(frame);
-                        this.frames.push(frame);
-                    }
-                    this.buffer = "";
-                    this.inThinkBlock = false;
-                    this.lastFrameTime = now;
-                    continue;
-                }
-                // Accumulate inside think block
-                this.buffer += (this.buffer ? "\n" : "") + rawLine;
-                continue;
-            }
-            // Check for opening think tag
-            if (THINK_OPEN_RE.test(trimmed)) {
-                // Check if it's a single-line tag (has close on same line)
-                if (THINK_CLOSE_RE.test(trimmed)) {
-                    const text = trimmed.replace(THINK_OPEN_RE, "").replace(THINK_CLOSE_RE, "").trim();
-                    if (text) {
-                        const frame = this.makeFrame("thinking", text, elapsed);
-                        result.push(frame);
-                        this.frames.push(frame);
-                    }
-                    this.lastFrameTime = now;
-                    continue;
-                }
-                // Multi-line: start accumulating
-                const afterOpen = trimmed.replace(THINK_OPEN_RE, "").trim();
-                this.buffer = afterOpen;
-                this.inThinkBlock = true;
-                this.lastFrameTime = now;
-                continue;
-            }
-            // Non-think lines: classify normally
-            const classified = classifyLine(rawLine);
-            if (classified) {
-                const frame = this.makeFrame(classified.kind, classified.text, elapsed);
-                if (visibility === "debug" || classified.kind === "thinking" || classified.kind === "plan") {
-                    result.push(frame);
-                }
-                this.frames.push(frame);
-                this.lastFrameTime = now;
-            }
-        }
-        return result;
-    }
-    /** Flush any pending think block content (e.g. on turn:end). */
-    flush() {
-        if (!this.inThinkBlock || !this.buffer.trim())
-            return [];
-        const now = Date.now();
-        const elapsed = now - this.lastFrameTime;
-        const frame = this.makeFrame("thinking", this.buffer.trim(), elapsed);
-        this.frames.push(frame);
-        this.buffer = "";
-        this.inThinkBlock = false;
-        this.lastFrameTime = now;
-        return [frame];
-    }
-    /** Get all accumulated frames. */
-    allFrames() {
-        return this.frames;
-    }
-    /** Get the latest thinking summary. */
-    summary() {
-        for (let i = this.frames.length - 1; i >= 0; i--) {
-            if (this.frames[i].kind === "thinking" || this.frames[i].kind === "plan") {
-                const text = this.frames[i].text;
-                return text.length > 120 ? text.slice(0, 117) + "..." : text;
-            }
-        }
-        return undefined;
-    }
-    makeFrame(kind, text, elapsedMs) {
-        return {
-            kind,
-            text: redactSecrets(text),
-            timestamp: new Date().toISOString(),
-            provider: this.provider,
-            elapsedMs,
-        };
-    }
-}
-/**
- * Process a chunk of provider output and extract reasoning frames.
- * For streaming use, prefer ReasoningAccumulator instead.
- */
-export function normalizeReasoningChunk(data, options) {
-    if (options.visibility === "off")
-        return [];
-    const acc = new ReasoningAccumulator(options.provider);
-    return acc.feed(data, options.visibility);
-}
-/**
- * Extract a single-line thinking summary from the most recent thinking frame.
- */
-export function extractThinkingSummary(frames) {
-    for (let i = frames.length - 1; i >= 0; i--) {
-        const frame = frames[i];
-        if (frame.kind === "thinking" || frame.kind === "plan") {
-            const text = frame.text;
-            return text.length > 120 ? text.slice(0, 117) + "..." : text;
-        }
-    }
-    return undefined;
-}
-export function createReasoningJsonlWriter(runPath) {
-    const filePath = `${runPath}/reasoning.jsonl`;
-    let buffer = [];
-    let writePromise = Promise.resolve();
-    let enospcHit = false;
-    return {
-        async append(frames) {
-            if (frames.length === 0 || enospcHit)
-                return;
-            buffer.push(...frames);
-            if (buffer.length >= 10) {
-                await this.flush();
-            }
-        },
-        async flush() {
-            if (buffer.length === 0 || enospcHit)
-                return;
-            const toWrite = buffer;
-            buffer = [];
-            writePromise = writePromise.then(async () => {
-                try {
-                    await mkdir(dirname(filePath), { recursive: true });
-                    const lines = toWrite.map((f) => JSON.stringify(f)).join("\n") + "\n";
-                    await appendFile(filePath, lines, "utf-8");
-                }
-                catch (err) {
-                    if (err && typeof err === "object" && "code" in err && err.code === "ENOSPC") {
-                        enospcHit = true;
-                        buffer = []; // Drop remaining frames
-                    }
-                    // Other errors silently ignored — reasoning is non-critical
-                }
-            });
-            await writePromise;
-        },
-    };
-}
-/**
- * Append reasoning frames to `.omk/runs/<runId>/reasoning.jsonl`.
- */
-export async function appendReasoningFrames(runDir, frames) {
-    if (frames.length === 0)
-        return;
-    const filePath = join(runDir, "reasoning.jsonl");
-    try {
-        await mkdir(dirname(filePath), { recursive: true });
-        const lines = frames.map((f) => JSON.stringify(f)).join("\n") + "\n";
-        await appendFile(filePath, lines, "utf-8");
-    }
-    catch (err) {
-        if (err && typeof err === "object" && "code" in err && err.code === "ENOSPC") {
-            return; // Stop trying on disk full
-        }
-    }
-}
-// ── CLI Display Helpers ──
-const KIND_ICONS = {
-    "thinking": "🧠",
-    "tool-activity": "📄",
-    "status": "⚡",
-    "plan": "📋",
-    "unknown": "💭",
-};
-/**
- * Format a reasoning frame for terminal display.
- */
-export function formatReasoningFrame(frame) {
-    const icon = KIND_ICONS[frame.kind] ?? "💭";
-    const maxLen = frame.kind === "thinking" ? 120 : 80;
-    const text = frame.text.length > maxLen ? frame.text.slice(0, maxLen - 3) + "..." : frame.text;
-    return style.gray(`  ${icon} ${text}`);
-}
-/**
- * Format a compact thinking summary for HUD/status display.
- */
-export function formatThinkingStatusLine(summary) {
-    if (!summary)
-        return undefined;
-    const truncated = summary.length > 100 ? summary.slice(0, 97) + "..." : summary;
-    return style.gray(`  🧠 ${truncated}`);
-}
-/**
- * Read reasoning.jsonl and return parsed frames.
- */
-export async function readReasoningFrames(runDir) {
-    const filePath = join(runDir, "reasoning.jsonl");
-    try {
-        const { readFile } = await import("fs/promises");
-        const content = await readFile(filePath, "utf-8");
-        const frames = [];
-        for (const line of content.split("\n")) {
-            if (!line.trim())
-                continue;
-            try {
-                frames.push(JSON.parse(line));
-            }
-            catch { /* skip malformed lines */ }
-        }
-        return frames;
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Resolve reasoning visibility from env/flags.
- */
-export function resolveReasoningVisibility(flag, envOverride) {
-    const raw = flag ?? envOverride ?? "off";
-    const normalized = raw.trim().toLowerCase();
-    if (normalized === "summary" || normalized === "debug" || normalized === "off") {
-        return normalized;
-    }
-    return "off";
-}
-/**
- * Resolve reasoning summary mode from env/flags.
- */
-export function resolveReasoningSummaryMode(flag, envOverride) {
-    const raw = flag ?? envOverride ?? "auto";
-    const normalized = raw.trim().toLowerCase();
-    if (normalized === "concise" || normalized === "detailed" || normalized === "auto") {
-        return normalized;
-    }
-    return "auto";
-}

package/dist/util/resource-profile.d.ts

@@ -1,32 +0,0 @@
-import { getProjectRoot, getProjectRootAsync, getProjectRootDiagnostics, resolveProjectRoot, resolveProjectRootAsync, displayProjectRootPath, type ProjectRootResolution, type ProjectRootSource } from "./project-root.js";
-import type { ExecutionPromptPolicy } from "../contracts/orchestration.js";
-export { getProjectRoot, getProjectRootAsync, getProjectRootDiagnostics, resolveProjectRoot, resolveProjectRootAsync, displayProjectRootPath, type ProjectRootResolution, type ProjectRootSource, };
-export type OmkResourceProfile = "lite" | "standard" | "super";
-export type OmkResourceProfileRequest = OmkResourceProfile | "auto";
-export type OmkRuntimeScope = "all" | "project" | "none";
-export interface OmkResourceSettings {
-    requestedProfile: OmkResourceProfileRequest;
-    profile: OmkResourceProfile;
-    reason: string;
-    totalMemoryGb: number;
-    maxWorkers: number;
-    shellMaxBufferBytes: number;
-    wireOutputBytes: number;
-    renderLogo: boolean;
-    mcpScope: OmkRuntimeScope;
-    skillsScope: OmkRuntimeScope;
-    hooksScope: OmkRuntimeScope;
-    executionPrompt: ExecutionPromptPolicy;
-    ensembleDefaultEnabled: boolean;
-    localeLanguage: string;
-}
-type FlatToml = Record<string, string>;
-export declare function resetOmkResourceSettingsCache(): void;
-export interface OmkActivePreset {
-    skills: string[];
-    hooks: string[];
-    mcpServers: string[];
-}
-export declare function getActiveRuntimePreset(): Promise<OmkActivePreset | undefined>;
-export declare function getOmkResourceSettings(): Promise<OmkResourceSettings>;
-export declare function readSimpleToml(path: string): Promise<FlatToml>;

package/dist/util/resource-profile.js

@@ -1,219 +0,0 @@
-import { readFile } from "fs/promises";
-import { totalmem } from "os";
-import { join } from "path";
-import { getProjectRoot, getProjectRootAsync, getProjectRootDiagnostics, resolveProjectRoot, resolveProjectRootAsync, displayProjectRootPath, } from "./project-root.js";
-import { parseExecutionPromptPolicy } from "./execution-selection.js";
-export { getProjectRoot, getProjectRootAsync, getProjectRootDiagnostics, resolveProjectRoot, resolveProjectRootAsync, displayProjectRootPath, };
-const LITE_MEMORY_THRESHOLD_GB = 18;
-const MIB = 1024 * 1024;
-let settingsCache;
-export function resetOmkResourceSettingsCache() {
-    settingsCache = undefined;
-}
-export async function getActiveRuntimePreset() {
-    try {
-        const content = await readFile(join(await getProjectRootAsync(), ".omk", "runtime-preset.json"), "utf-8");
-        const parsed = JSON.parse(content);
-        if (parsed && typeof parsed === "object") {
-            const record = parsed;
-            return {
-                skills: Array.isArray(record.skills) ? record.skills : [],
-                hooks: Array.isArray(record.hooks) ? record.hooks : [],
-                mcpServers: Array.isArray(record.mcpServers) ? record.mcpServers : [],
-            };
-        }
-    }
-    catch {
-        // ignore missing or invalid preset file
-    }
-    return undefined;
-}
-export async function getOmkResourceSettings() {
-    settingsCache ??= loadOmkResourceSettings();
-    return settingsCache;
-}
-async function loadOmkResourceSettings() {
-    const env = process.env;
-    const projectRoot = await getProjectRootAsync();
-    const config = await readSimpleToml(join(projectRoot, ".omk", "config.toml"));
-    const totalMemoryGb = Number((totalmem() / 1024 / 1024 / 1024).toFixed(1));
-    const requestedProfile = normalizeProfileRequest(env.OMK_RESOURCE_PROFILE
-        ?? env.OMK_RUNTIME_PROFILE
-        ?? optimizeEnvToProfile(env.OMK_OPTIMIZE)
-        ?? config["runtime.resource_profile"]
-        ?? "auto");
-    const autoLite = totalMemoryGb > 0 && totalMemoryGb <= LITE_MEMORY_THRESHOLD_GB;
-    const profile = requestedProfile === "auto"
-        ? autoLite ? "lite" : "standard"
-        : requestedProfile;
-    const reason = requestedProfile === "auto"
-        ? autoLite
-            ? `auto-detected <=${LITE_MEMORY_THRESHOLD_GB}GB RAM host`
-            : `auto-detected >${LITE_MEMORY_THRESHOLD_GB}GB RAM host`
-        : `requested by ${profileSource(env, config)}`;
-    const maxWorkers = parsePositiveInt(env.OMK_MAX_WORKERS ?? config["runtime.max_workers"])
-        ?? (profile === "lite" ? 1 : profile === "super" ? 4 : 2);
-    const shellMaxBufferBytes = parseMib(env.OMK_MAX_OUTPUT_MB)
-        ?? parseBytes(env.OMK_MAX_OUTPUT_BYTES)
-        ?? parseMib(config["runtime.max_output_mb"])
-        ?? (profile === "lite" ? 4 * MIB : 20 * MIB);
-    const wireOutputBytes = parseMib(env.OMK_WIRE_OUTPUT_MB)
-        ?? parseBytes(env.OMK_WIRE_MAX_OUTPUT_BYTES)
-        ?? parseMib(config["runtime.wire_output_mb"])
-        ?? (profile === "lite" ? 1 * MIB : 8 * MIB);
-    const renderLogo = parseOptionalBoolean(env.OMK_RENDER_LOGO ?? config["theme.render_logo"])
-        ?? profile !== "lite";
-    const mcpScope = normalizeScope(env.OMK_MCP_SCOPE ?? config["runtime.mcp_scope"], "project");
-    const skillsScope = normalizeScope(env.OMK_SKILLS_SCOPE ?? config["runtime.skills_scope"], "project");
-    const hooksScope = normalizeScope(env.OMK_HOOKS_SCOPE ?? config["runtime.hooks_scope"], "project");
-    const rawExecutionPrompt = env.OMK_EXECUTION_PROMPT ?? config["orchestration.execution_prompt"];
-    const executionPromptSource = env.OMK_EXECUTION_PROMPT !== undefined
-        ? "OMK_EXECUTION_PROMPT"
-        : config["orchestration.execution_prompt"] !== undefined
-            ? ".omk/config.toml orchestration.execution_prompt"
-            : "orchestration.execution_prompt";
-    const executionPrompt = parseExecutionPromptPolicy(rawExecutionPrompt, executionPromptSource) ?? "ask";
-    const localeLanguage = normalizeLocaleLanguage(env.OMK_LANGUAGE ?? config["locale.language"]) ?? "en";
-    return {
-        requestedProfile,
-        profile,
-        reason,
-        totalMemoryGb,
-        maxWorkers,
-        shellMaxBufferBytes,
-        wireOutputBytes,
-        renderLogo,
-        mcpScope,
-        skillsScope,
-        hooksScope,
-        executionPrompt,
-        ensembleDefaultEnabled: profile !== "lite",
-        localeLanguage,
-    };
-}
-export async function readSimpleToml(path) {
-    try {
-        const content = await readFile(path, "utf-8");
-        return parseSimpleToml(content);
-    }
-    catch {
-        return {};
-    }
-}
-function parseSimpleToml(content) {
-    const result = {};
-    let section = "";
-    for (const rawLine of content.split(/\r?\n/)) {
-        const line = stripComment(rawLine).trim();
-        if (!line)
-            continue;
-        const sectionMatch = line.match(/^\[([^\]]+)]$/);
-        if (sectionMatch) {
-            section = sectionMatch[1].trim();
-            continue;
-        }
-        const kv = line.match(/^([A-Za-z0-9_.-]+)\s*=\s*(.+)$/);
-        if (!kv)
-            continue;
-        const key = section ? `${section}.${kv[1].trim()}` : kv[1].trim();
-        result[key] = normalizeTomlValue(kv[2].trim());
-    }
-    return result;
-}
-function stripComment(line) {
-    let inString = false;
-    let quote = "";
-    for (let i = 0; i < line.length; i += 1) {
-        const char = line[i];
-        if ((char === "\"" || char === "'") && line[i - 1] !== "\\") {
-            if (!inString) {
-                inString = true;
-                quote = char;
-            }
-            else if (quote === char) {
-                inString = false;
-            }
-        }
-        if (char === "#" && !inString)
-            return line.slice(0, i);
-    }
-    return line;
-}
-function normalizeTomlValue(value) {
-    const trimmed = value.trim();
-    if ((trimmed.startsWith("\"") && trimmed.endsWith("\"")) || (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
-        return trimmed.slice(1, -1);
-    }
-    return trimmed;
-}
-function normalizeProfileRequest(value) {
-    const normalized = value?.trim().toLowerCase();
-    if (normalized === "lite" || normalized === "low-memory" || normalized === "low_memory" || normalized === "16gb")
-        return "lite";
-    if (normalized === "standard" || normalized === "normal" || normalized === "full")
-        return "standard";
-    if (normalized === "super")
-        return "super";
-    return "auto";
-}
-function optimizeEnvToProfile(value) {
-    const parsed = parseOptionalBoolean(value);
-    if (parsed === undefined)
-        return undefined;
-    return parsed ? "lite" : "standard";
-}
-function profileSource(env, config) {
-    if (env.OMK_RESOURCE_PROFILE !== undefined)
-        return "OMK_RESOURCE_PROFILE";
-    if (env.OMK_RUNTIME_PROFILE !== undefined)
-        return "OMK_RUNTIME_PROFILE";
-    if (env.OMK_OPTIMIZE !== undefined)
-        return "OMK_OPTIMIZE";
-    if (config["runtime.resource_profile"] !== undefined)
-        return ".omk/config.toml";
-    return "default";
-}
-function normalizeScope(value, fallback) {
-    const normalized = value?.trim().toLowerCase();
-    if (normalized === "none" || normalized === "off" || normalized === "disabled")
-        return "none";
-    if (normalized === "project" || normalized === "local")
-        return "project";
-    if (normalized === "all" || normalized === "global" || normalized === "local-user" || normalized === "local_user" || normalized === "personal" || normalized === "user")
-        return "all";
-    return fallback;
-}
-function normalizeLocaleLanguage(value) {
-    const normalized = value?.trim().toLowerCase();
-    if (normalized === "ko" || normalized === "kr" || normalized === "korean")
-        return "ko";
-    if (normalized === "en" || normalized === "eng" || normalized === "english")
-        return "en";
-    if (normalized === "ja" || normalized === "jp" || normalized === "japanese")
-        return "ja";
-    return undefined;
-}
-function parsePositiveInt(value) {
-    if (value === undefined || value.trim() === "")
-        return undefined;
-    const parsed = Number.parseInt(value, 10);
-    return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
-}
-function parseMib(value) {
-    const parsed = parsePositiveInt(value);
-    return parsed === undefined ? undefined : parsed * MIB;
-}
-function parseBytes(value) {
-    const parsed = parsePositiveInt(value);
-    return parsed === undefined ? undefined : parsed;
-}
-function parseOptionalBoolean(value) {
-    if (value === undefined)
-        return undefined;
-    const normalized = value.trim().toLowerCase();
-    if (["1", "true", "yes", "on"].includes(normalized))
-        return true;
-    if (["0", "false", "no", "off"].includes(normalized))
-        return false;
-    return undefined;
-}

package/dist/util/run-store.d.ts

@@ -1,38 +0,0 @@
-export declare const RUN_ID_MAX_LENGTH = 128;
-export declare const RUN_ARTIFACT_PATH_MAX_LENGTH = 256;
-export declare const RESERVED_RUN_IDS: Set<string>;
-/**
- * Validates a runId and returns the canonical form.
- * Rejects traversal, separators, drive syntax, UNC paths, and reserved names.
- */
-export declare function validateRunId(raw: string): string;
-/**
- * Sanitizes generated run IDs before they touch `.omk/runs`.
- * User-supplied invalid IDs still fail validation at the store boundary.
- */
-export declare function sanitizeRunId(raw: string, fallbackPrefix?: string): string;
-/**
- * Validates a relative artifact path below a run directory.
- * Accepts nested POSIX-style segments, rejects traversal, absolute paths,
- * drive paths, UNC paths, empty segments, and special characters.
- */
-export declare function validateRunArtifactPath(raw: string): string;
-/**
- * Returns the `.omk/runs` directory path.
- */
-export declare function getRunsDir(root?: string): string;
-/**
- * Returns the full path to a run directory or an artifact inside it.
- * Validates the runId before constructing the path.
- */
-export declare function getRunPath(runId: string, artifact?: string, root?: string): string;
-/**
- * Returns the path to a run artifact.
- * Validates both runId and artifact path before constructing the path.
- */
-export declare function getRunArtifactPath(runId: string, artifact: string, root?: string): string;
-/**
- * Lists valid runIds from the runs directory.
- * Skips directories with invalid names (e.g., "latest", ".", "..").
- */
-export declare function listValidRunIds(root?: string): Promise<string[]>;