@alextis59/athena 1.0.0

package/dist/agent/types.d.ts

@@ -0,0 +1,84 @@
+import type { Citation, ToolResult } from "../shared/types.js";
+export type ModelRole = "system" | "user" | "assistant" | "tool";
+export interface TextModelMessage {
+    role: "system" | "user";
+    content: string;
+}
+export interface AssistantModelMessage {
+    role: "assistant";
+    content: string;
+    toolCalls?: ModelToolCall[];
+}
+export interface ModelToolResultMessage {
+    role: "tool";
+    toolCallId: string;
+    name: string;
+    content: string;
+}
+export type ModelMessage = TextModelMessage | AssistantModelMessage | ModelToolResultMessage;
+export interface ModelToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface ModelProviderRequest {
+    model: string;
+    messages: ModelMessage[];
+    tools: ModelToolDefinition[];
+    temperature?: number;
+}
+export type ModelFinishReason = "stop" | "length" | "tool_budget";
+export interface ModelToolCall {
+    id: string;
+    name: string;
+    input: unknown;
+}
+export interface ModelToolCallEvent {
+    type: "tool_call";
+    id: string;
+    name: string;
+    input: unknown;
+}
+export type ModelEvent = {
+    type: "message_delta";
+    text: string;
+} | ModelToolCallEvent | {
+    type: "complete";
+    finishReason: ModelFinishReason;
+};
+export interface ModelProvider {
+    streamResponse(input: ModelProviderRequest): AsyncIterable<ModelEvent>;
+}
+export interface CompactConversationTurn {
+    question: string;
+    answerSummary: string;
+    citations?: Citation[];
+}
+export interface AgentTurnInput {
+    root: string;
+    dbPath?: string;
+    question: string;
+    model: string;
+    provider: ModelProvider;
+    maxSteps?: number;
+    previousTurns?: CompactConversationTurn[];
+    pinnedSources?: string[];
+}
+export type AgentEvent = {
+    type: "message_delta";
+    text: string;
+} | ModelToolCallEvent | {
+    type: "tool_result";
+    id: string;
+    name: string;
+    result: ToolResult;
+} | {
+    type: "complete";
+    finishReason: ModelFinishReason;
+    answer: string;
+};
+export interface AgentTurnResult {
+    answer: string;
+    finishReason: ModelFinishReason;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agent/types.d.ts.map

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

package/dist/agent/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":""}

package/dist/cli/help.d.ts

@@ -0,0 +1,2 @@
+export declare function renderHelp(): string;
+//# sourceMappingURL=help.d.ts.map

package/dist/cli/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,IAAI,MAAM,CA0BnC"}

package/dist/cli/help.js

@@ -0,0 +1,28 @@
+export function renderHelp() {
+    return `Athena - local-first documentation RAG
+
+Usage:
+  athena [command] [options]
+  athena ask "How do I configure auth?"
+
+Commands:
+  default   Build or update the index, then start the local UI
+  index     Index documentation into .athena/index.sqlite
+  serve     Start the local Athena HTTP server and chat UI
+  ask       Ask a question from the command line
+  doctor    Check local configuration, storage, parsers, and providers
+  mcp       Start the MCP bridge for external coding agents
+
+Options:
+  --root <path>      Project root to inspect (default: current directory)
+  --config <path>    Explicit Athena config file
+  --db <path>        SQLite index path (default: .athena/index.sqlite)
+  --host <host>      Server bind host (default: 127.0.0.1)
+  --port <port>      Server port (default: 4317)
+  --debug            Enable debug logs
+  --json             Emit machine-readable output where supported
+  --build            Build the index before serving
+  -h, --help         Show help
+`;
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU;IACxB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;CAwBR,CAAC;AACF,CAAC"}

package/dist/cli/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":""}

package/dist/cli/main.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { runCli } from "./run.js";
+const result = await runCli(process.argv.slice(2), { stdin: process.stdin, stdout: process.stdout, stderr: process.stderr }, { cwd: process.cwd() });
+process.exitCode = result.exitCode;
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,MAAM,GAAG,MAAM,MAAM,CACzB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EACrB,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EACxE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CACvB,CAAC;AAEF,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC"}

package/dist/cli/options.d.ts

@@ -0,0 +1,21 @@
+export type CliCommand = "default" | "index" | "serve" | "ask" | "doctor" | "mcp";
+export interface CliOptions {
+    root: string;
+    config?: string;
+    db?: string;
+    host: string;
+    port: number;
+    hostProvided: boolean;
+    portProvided: boolean;
+    debug: boolean;
+    json: boolean;
+    help: boolean;
+    build: boolean;
+}
+export interface ParsedCli {
+    command: CliCommand;
+    options: CliOptions;
+    args: string[];
+}
+export declare function parseCliArgs(argv: string[], cwd: string): ParsedCli;
+//# sourceMappingURL=options.d.ts.map

package/dist/cli/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/cli/options.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GACpB,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,UAAU,CAAC;IACpB,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAWD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAuEnE"}

package/dist/cli/options.js

@@ -0,0 +1,97 @@
+import { UserFacingError } from "../errors.js";
+const commands = new Set([
+    "default",
+    "index",
+    "serve",
+    "ask",
+    "doctor",
+    "mcp"
+]);
+export function parseCliArgs(argv, cwd) {
+    const options = {
+        root: cwd,
+        host: "127.0.0.1",
+        port: 4317,
+        hostProvided: false,
+        portProvided: false,
+        debug: false,
+        json: false,
+        help: false,
+        build: false
+    };
+    const positional = [];
+    for (let index = 0; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (token === undefined) {
+            continue;
+        }
+        if (token === "-h" || token === "--help") {
+            options.help = true;
+            continue;
+        }
+        if (token === "--debug") {
+            options.debug = true;
+            continue;
+        }
+        if (token === "--json") {
+            options.json = true;
+            continue;
+        }
+        if (token === "--build") {
+            options.build = true;
+            continue;
+        }
+        if (token.startsWith("--")) {
+            const equalsIndex = token.indexOf("=");
+            const name = equalsIndex === -1 ? token : token.slice(0, equalsIndex);
+            const inlineValue = equalsIndex === -1 ? undefined : token.slice(equalsIndex + 1);
+            const value = inlineValue ?? argv[index + 1];
+            if (value === undefined || value.startsWith("--")) {
+                throw new UserFacingError(`Missing value for ${name}.`);
+            }
+            if (inlineValue === undefined) {
+                index += 1;
+            }
+            applyOption(options, name, value);
+            continue;
+        }
+        positional.push(token);
+    }
+    const maybeCommand = positional[0];
+    const command = maybeCommand !== undefined && commands.has(maybeCommand)
+        ? maybeCommand
+        : "default";
+    const args = command === "default" ? positional : positional.slice(1);
+    return { command, options, args };
+}
+function applyOption(options, name, value) {
+    switch (name) {
+        case "--root":
+            options.root = value;
+            return;
+        case "--config":
+            options.config = value;
+            return;
+        case "--db":
+            options.db = value;
+            return;
+        case "--host":
+            options.host = value;
+            options.hostProvided = true;
+            return;
+        case "--port":
+            options.port = parsePort(value);
+            options.portProvided = true;
+            return;
+        default:
+            throw new UserFacingError(`Unknown option ${name}.`);
+    }
+}
+function parsePort(value) {
+    const port = Number.parseInt(value, 10);
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+        throw new UserFacingError(`Invalid port: ${value}.`);
+    }
+    return port;
+}
+//# sourceMappingURL=options.js.map

package/dist/cli/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/cli/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAyB/C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAa;IACnC,SAAS;IACT,OAAO;IACP,OAAO;IACP,KAAK;IACL,QAAQ;IACR,KAAK;CACN,CAAC,CAAC;AAEH,MAAM,UAAU,YAAY,CAAC,IAAc,EAAE,GAAW;IACtD,MAAM,OAAO,GAAe;QAC1B,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,IAAI;QACV,YAAY,EAAE,KAAK;QACnB,YAAY,EAAE,KAAK;QACnB,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,KAAK;KACb,CAAC;IACF,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAE1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QAED,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACzC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;YACpB,SAAS;QACX,CAAC;QAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;YACrB,SAAS;QACX,CAAC;QAED,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;YACpB,SAAS;QACX,CAAC;QAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;YACrB,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;YACtE,MAAM,WAAW,GACf,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;YAChE,MAAM,KAAK,GAAG,WAAW,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAE7C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClD,MAAM,IAAI,eAAe,CAAC,qBAAqB,IAAI,GAAG,CAAC,CAAC;YAC1D,CAAC;YAED,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;YAED,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YAClC,SAAS;QACX,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GACX,YAAY,KAAK,SAAS,IAAI,QAAQ,CAAC,GAAG,CAAC,YAA0B,CAAC;QACpE,CAAC,CAAE,YAA2B;QAC9B,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,IAAI,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEtE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,WAAW,CAAC,OAAmB,EAAE,IAAY,EAAE,KAAa;IACnE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC;YACrB,OAAO;QACT,KAAK,UAAU;YACb,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC;YACvB,OAAO;QACT,KAAK,MAAM;YACT,OAAO,CAAC,EAAE,GAAG,KAAK,CAAC;YACnB,OAAO;QACT,KAAK,QAAQ;YACX,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC;YACrB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;YAC5B,OAAO;QACT,KAAK,QAAQ;YACX,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YAChC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;YAC5B,OAAO;QACT;YACE,MAAM,IAAI,eAAe,CAAC,kBAAkB,IAAI,GAAG,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAExC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QACxD,MAAM,IAAI,eAAe,CAAC,iBAAiB,KAAK,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli/run.d.ts

@@ -0,0 +1,21 @@
+import { ExitCode } from "../errors.js";
+import type { ModelProvider } from "../agent/index.js";
+export interface CliStreams {
+    stdin?: AsyncIterable<string | Uint8Array>;
+    stdout: CliWritable;
+    stderr: CliWritable;
+}
+export interface CliWritable {
+    write(chunk: string | Uint8Array): unknown;
+}
+export interface CliEnvironment {
+    cwd: string;
+    modelProvider?: ModelProvider;
+    model?: string;
+    waitForServerShutdown?: boolean;
+}
+export interface CliResult {
+    exitCode: ExitCode;
+}
+export declare function runCli(argv: string[], streams: CliStreams, environment: CliEnvironment): Promise<CliResult>;
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAkC,MAAM,cAAc,CAAC;AAexE,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKvE,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IAC3C,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,UAAU,EACnB,WAAW,EAAE,cAAc,GAC1B,OAAO,CAAC,SAAS,CAAC,CAqBpB"}

package/dist/cli/run.js

@@ -0,0 +1,144 @@
+import { ExitCode, toAthenaError, UserFacingError } from "../errors.js";
+import { askQuestion, renderTerminalCitations } from "../agent/index.js";
+import { loadConfig } from "../config/index.js";
+import { createLogger } from "../logging/logger.js";
+import { runDoctor } from "../doctor/doctor.js";
+import { indexFromCliOptions, renderIndexProgress, renderIndexResult } from "../indexer/index.js";
+import { runMcpServer } from "../mcp/index.js";
+import { createConfiguredModelProvider } from "../agent/index.js";
+import { runServeFromCliOptions } from "../server/index.js";
+import { inspectDatabase } from "../storage/index.js";
+import { renderHelp } from "./help.js";
+import { parseCliArgs } from "./options.js";
+export async function runCli(argv, streams, environment) {
+    try {
+        const parsed = parseCliArgs(argv, environment.cwd);
+        const logger = createLogger(parsed.options.debug ? "debug" : "default", streams.stderr);
+        if (parsed.options.help) {
+            streams.stdout.write(renderHelp());
+            return { exitCode: ExitCode.Success };
+        }
+        logger.debug(`Running athena ${parsed.command}`);
+        await runCommand(parsed, streams, environment, logger);
+        return { exitCode: ExitCode.Success };
+    }
+    catch (error) {
+        const athenaError = toAthenaError(error);
+        streams.stderr.write(`athena: ${athenaError.message}\n`);
+        return { exitCode: athenaError.exitCode };
+    }
+}
+async function runCommand(parsed, streams, environment, logger) {
+    const command = parsed.command;
+    switch (command) {
+        case "index": {
+            await runIndexCommand(parsed, streams, logger);
+            return;
+        }
+        case "doctor":
+            await runDoctor({
+                options: parsed.options,
+                stdout: streams.stdout
+            });
+            return;
+        case "serve":
+            await runServeCommand(parsed, streams, environment, logger);
+            return;
+        case "ask":
+            await runAskCommand(parsed, streams, environment);
+            return;
+        case "mcp":
+            await runMcpCommand(parsed, streams);
+            return;
+        case "default":
+            await runDefaultCommand(parsed, streams, environment, logger);
+            return;
+    }
+}
+async function runDefaultCommand(parsed, streams, environment, logger) {
+    await runIndexCommand(parsed, streams, logger);
+    await runServeFromCliOptions(parsed.options, streams.stdout, {
+        waitForShutdown: environment.waitForServerShutdown ?? true
+    });
+}
+async function runServeCommand(parsed, streams, environment, logger) {
+    if (parsed.options.build) {
+        await runIndexCommand(parsed, streams, logger);
+    }
+    else {
+        assertIndexReady(parsed);
+    }
+    await runServeFromCliOptions(parsed.options, streams.stdout, {
+        waitForShutdown: environment.waitForServerShutdown ?? true
+    });
+}
+async function runIndexCommand(parsed, streams, logger) {
+    const result = await indexFromCliOptions(parsed.options, parsed.options.json
+        ? undefined
+        : (event) => {
+            logger.info(renderIndexProgress(event));
+        });
+    streams.stdout.write(renderIndexResult(result, parsed.options.json));
+}
+function assertIndexReady(parsed) {
+    const database = inspectDatabase(parsed.options.root, parsed.options.db);
+    if (database.status === "ready") {
+        return;
+    }
+    throw new UserFacingError("Athena index is missing. Run 'athena index' first or use 'athena serve --build'.");
+}
+async function runMcpCommand(parsed, streams) {
+    if (streams.stdin === undefined) {
+        throw new UserFacingError("The 'mcp' command requires stdin.");
+    }
+    await runMcpServer({
+        root: parsed.options.root,
+        ...(parsed.options.db === undefined ? {} : { dbPath: parsed.options.db }),
+        input: streams.stdin,
+        output: streams.stdout
+    });
+}
+async function runAskCommand(parsed, streams, environment) {
+    const question = parsed.args.join(" ").trim();
+    if (question === "") {
+        throw new UserFacingError("The 'ask' command requires a question.");
+    }
+    const { provider, model } = await resolveAskProvider(parsed, environment);
+    const input = {
+        root: parsed.options.root,
+        question,
+        model,
+        provider
+    };
+    if (parsed.options.db !== undefined) {
+        input.dbPath = parsed.options.db;
+    }
+    const result = await askQuestion({
+        ...input,
+        onEvent: (event) => {
+            if (event.type === "message_delta") {
+                streams.stdout.write(event.text);
+            }
+        }
+    });
+    streams.stdout.write(renderTerminalCitations(result.answer));
+    if (!result.answer.endsWith("\n")) {
+        streams.stdout.write("\n");
+    }
+}
+async function resolveAskProvider(parsed, environment) {
+    if (environment.modelProvider !== undefined) {
+        return {
+            provider: environment.modelProvider,
+            model: environment.model ?? "fake"
+        };
+    }
+    const loadedConfig = await loadConfig(parsed.options.config === undefined
+        ? { root: parsed.options.root }
+        : { root: parsed.options.root, configPath: parsed.options.config });
+    return {
+        provider: createConfiguredModelProvider(loadedConfig.config.chat),
+        model: loadedConfig.config.chat.model ?? ""
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/run.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,4 @@
+export type { AthenaConfig, AthenaUserConfig, ChatProvider, ChatProviderConfig, ConfigDiagnostic, EmbeddingProvider, EmbeddingProviderConfig, IndexConfig, LoadedConfig, PdfConfig, ServerConfig } from "./types.js";
+export { DEFAULT_CONFIG_FILENAMES, defaultAthenaConfig, defineConfig } from "./schema.js";
+export { ConfigValidationError, discoverConfigFile, loadConfig, resolveConfig } from "./loader.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,YAAY,EACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACd,MAAM,aAAa,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,3 @@
+export { DEFAULT_CONFIG_FILENAMES, defaultAthenaConfig, defineConfig } from "./schema.js";
+export { ConfigValidationError, discoverConfigFile, loadConfig, resolveConfig } from "./loader.js";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACd,MAAM,aAAa,CAAC"}

package/dist/config/loader.d.ts

@@ -0,0 +1,14 @@
+import { UserFacingError } from "../errors.js";
+import type { AthenaConfig, ConfigDiagnostic, LoadedConfig } from "./types.js";
+export declare class ConfigValidationError extends UserFacingError {
+    readonly diagnostics: ConfigDiagnostic[];
+    constructor(diagnostics: ConfigDiagnostic[]);
+}
+export interface LoadConfigOptions {
+    root: string;
+    configPath?: string;
+}
+export declare function loadConfig(options: LoadConfigOptions): Promise<LoadedConfig>;
+export declare function discoverConfigFile(root: string, explicitConfigPath?: string): string | null;
+export declare function resolveConfig(rawConfig: unknown): AthenaConfig;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,KAAK,EACV,YAAY,EAEZ,gBAAgB,EAEhB,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,qBAAa,qBAAsB,SAAQ,eAAe;aACrB,WAAW,EAAE,gBAAgB,EAAE;gBAA/B,WAAW,EAAE,gBAAgB,EAAE;CAUnE;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAeD,wBAAsB,UAAU,CAC9B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,YAAY,CAAC,CASvB;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,kBAAkB,CAAC,EAAE,MAAM,GAC1B,MAAM,GAAG,IAAI,CAwBf;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,OAAO,GAAG,YAAY,CAsB9D"}