@alextis59/athena 1.0.0

package/dist/agent/loop.js

@@ -0,0 +1,156 @@
+import { randomUUID } from "node:crypto";
+import { UserFacingError } from "../errors.js";
+import { RetrievalToolRuntime } from "../retrieval/index.js";
+import { openDatabase, resolveAthenaPaths } from "../storage/index.js";
+import { validateAnswerCitations } from "./citations.js";
+import { createModelToolDefinitions, executeAgentTool } from "./tools.js";
+export const DEFAULT_MAX_AGENT_STEPS = 6;
+export async function* runAgentTurn(input) {
+    const maxSteps = input.maxSteps ?? DEFAULT_MAX_AGENT_STEPS;
+    if (!Number.isInteger(maxSteps) || maxSteps < 1) {
+        throw new UserFacingError("maxSteps must be a positive integer.");
+    }
+    const runtime = new RetrievalToolRuntime(input.root, input.dbPath);
+    const tools = createModelToolDefinitions();
+    const messages = buildModelMessages(input);
+    let answer = "";
+    try {
+        for (let step = 0; step < maxSteps; step += 1) {
+            const toolCalls = [];
+            let assistantText = "";
+            let finishReason = "stop";
+            for await (const event of input.provider.streamResponse({
+                model: input.model,
+                messages,
+                tools
+            })) {
+                if (event.type === "message_delta") {
+                    answer += event.text;
+                    assistantText += event.text;
+                    yield event;
+                    continue;
+                }
+                if (event.type === "tool_call") {
+                    const toolCall = {
+                        id: event.id,
+                        name: event.name,
+                        input: event.input
+                    };
+                    toolCalls.push(toolCall);
+                    yield event;
+                    continue;
+                }
+                finishReason = event.finishReason;
+            }
+            if (toolCalls.length === 0) {
+                yield* finishTurn(input, runtime, answer, finishReason);
+                return;
+            }
+            const assistantMessage = {
+                role: "assistant",
+                content: assistantText
+            };
+            if (toolCalls.length > 0) {
+                assistantMessage.toolCalls = toolCalls;
+            }
+            messages.push(assistantMessage);
+            for (const toolCall of toolCalls) {
+                const result = await executeAgentTool(runtime, toolCall.name, toolCall.input);
+                messages.push({
+                    role: "tool",
+                    toolCallId: toolCall.id,
+                    name: toolCall.name,
+                    content: JSON.stringify(result.payload)
+                });
+                yield {
+                    type: "tool_result",
+                    id: toolCall.id,
+                    name: toolCall.name,
+                    result
+                };
+            }
+        }
+        const budgetAnswer = "Athena could not complete the answer within the tool budget.";
+        answer =
+            answer.trim() === "" ? budgetAnswer : `${answer}\n\n${budgetAnswer}`;
+        yield* finishTurn(input, runtime, answer, "tool_budget");
+    }
+    finally {
+        runtime.close();
+    }
+}
+export function buildModelMessages(input) {
+    const messages = [
+        {
+            role: "system",
+            content: [
+                "You are Athena, a local-first documentation RAG agent.",
+                "Use only Athena tools for repository facts.",
+                "Cite text sources as [path:start-end] and PDF sources as [path.pdf p.N].",
+                "If evidence is missing, say what could not be verified."
+            ].join(" ")
+        }
+    ];
+    for (const turn of input.previousTurns ?? []) {
+        messages.push({ role: "user", content: turn.question });
+        messages.push({ role: "assistant", content: turn.answerSummary });
+    }
+    const pinnedSources = input.pinnedSources === undefined || input.pinnedSources.length === 0
+        ? ""
+        : `\nPinned sources: ${input.pinnedSources.join(", ")}`;
+    messages.push({
+        role: "user",
+        content: `${input.question}${pinnedSources}`
+    });
+    return messages;
+}
+export { createModelToolDefinitions };
+async function* finishTurn(input, runtime, answer, finishReason) {
+    const citations = await validateAnswerCitations({
+        root: input.root,
+        answer,
+        runtime
+    });
+    persistConversationTurn(input, answer, citations);
+    yield {
+        type: "complete",
+        finishReason,
+        answer
+    };
+}
+function persistConversationTurn(input, answer, citations) {
+    const paths = resolveAthenaPaths(input.root, input.dbPath);
+    const database = openDatabase(paths.databasePath, {
+        fileMustExist: true
+    });
+    const createdAt = new Date().toISOString();
+    try {
+        const turnId = randomUUID();
+        database
+            .prepare([
+            "INSERT INTO conversation_turns",
+            "(id, question, answer_summary, citations_json, pinned_sources_json, created_at)",
+            "VALUES (?, ?, ?, ?, ?, ?)"
+        ].join(" "))
+            .run(turnId, input.question, summarizeAnswer(answer), JSON.stringify(citations), JSON.stringify(input.pinnedSources ?? []), createdAt);
+        const insertCitation = database.prepare([
+            "INSERT INTO answer_citations",
+            "(id, turn_id, chunk_id, source_path, locator_json, label, created_at)",
+            "VALUES (?, ?, ?, ?, ?, ?, ?)"
+        ].join(" "));
+        for (const citation of citations) {
+            insertCitation.run(randomUUID(), turnId, citation.chunkId ?? null, citation.locator.path, JSON.stringify(citation.locator), citation.label, createdAt);
+        }
+    }
+    finally {
+        database.close();
+    }
+}
+function summarizeAnswer(answer) {
+    const normalized = answer.trim().replace(/\s+/gu, " ");
+    if (normalized.length <= 1_000) {
+        return normalized;
+    }
+    return `${normalized.slice(0, 997)}...`;
+}
+//# sourceMappingURL=loop.js.map

package/dist/agent/loop.js.map

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

package/dist/agent/providers.d.ts

@@ -0,0 +1,17 @@
+import type { ChatProviderConfig } from "../config/index.js";
+import type { ModelEvent, ModelProvider, ModelProviderRequest } from "./types.js";
+export type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+export interface CreateModelProviderOptions {
+    env?: NodeJS.ProcessEnv;
+    fetch?: FetchLike;
+    ollamaBaseUrl?: string;
+}
+export declare function createConfiguredModelProvider(config: ChatProviderConfig, options?: CreateModelProviderOptions): ModelProvider;
+export declare function validateModelProviderConfig(config: ChatProviderConfig, env?: NodeJS.ProcessEnv): void;
+export declare class OllamaModelProvider implements ModelProvider {
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    constructor(options?: CreateModelProviderOptions);
+    streamResponse(input: ModelProviderRequest): AsyncIterable<ModelEvent>;
+}
+//# sourceMappingURL=providers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/agent/providers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EACV,UAAU,EAGV,aAAa,EACb,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,MAAM,WAAW,0BAA0B;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAyBD,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,0BAA+B,GACvC,aAAa,CAoBf;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,kBAAkB,EAC1B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,IAAI,CAoBN;AAED,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAEnB,OAAO,GAAE,0BAA+B;IAS7C,cAAc,CAC1B,KAAK,EAAE,oBAAoB,GAC1B,aAAa,CAAC,UAAU,CAAC;CAsD7B"}

package/dist/agent/providers.js

@@ -0,0 +1,171 @@
+import { UserFacingError } from "../errors.js";
+const credentialEnvByProvider = {
+    openai: "OPENAI_API_KEY",
+    anthropic: "ANTHROPIC_API_KEY",
+    gemini: "GEMINI_API_KEY"
+};
+export function createConfiguredModelProvider(config, options = {}) {
+    validateModelProviderConfig(config, options.env);
+    if (config.provider === "ollama") {
+        const providerOptions = {};
+        if (options.ollamaBaseUrl !== undefined) {
+            providerOptions.ollamaBaseUrl = options.ollamaBaseUrl;
+        }
+        if (options.fetch !== undefined) {
+            providerOptions.fetch = options.fetch;
+        }
+        return new OllamaModelProvider(providerOptions);
+    }
+    throw new UserFacingError(`Chat provider '${config.provider}' is validated but no Athena adapter is implemented yet.`);
+}
+export function validateModelProviderConfig(config, env = process.env) {
+    if (config.provider === "none") {
+        throw new UserFacingError("No chat provider configured. Set chat.provider and chat.model before asking questions.");
+    }
+    if (config.model === null || config.model.trim() === "") {
+        throw new UserFacingError(`chat.model is required when chat.provider is '${config.provider}'.`);
+    }
+    const credentialEnv = credentialEnvByProvider[config.provider];
+    if (credentialEnv !== undefined && env[credentialEnv] === undefined) {
+        throw new UserFacingError(`${credentialEnv} is required when chat.provider is '${config.provider}'.`);
+    }
+}
+export class OllamaModelProvider {
+    baseUrl;
+    fetchImpl;
+    constructor(options = {}) {
+        this.baseUrl = normalizeBaseUrl(options.ollamaBaseUrl ??
+            process.env.OLLAMA_HOST ??
+            "http://127.0.0.1:11434");
+        this.fetchImpl = options.fetch ?? fetch;
+    }
+    async *streamResponse(input) {
+        const response = await this.fetchImpl(`${this.baseUrl}/api/chat`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(toOllamaRequest(input))
+        });
+        if (!response.ok) {
+            throw new UserFacingError(`Ollama chat request failed with HTTP ${String(response.status)}.`);
+        }
+        if (response.body === null) {
+            throw new UserFacingError("Ollama chat response did not include a stream.");
+        }
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        try {
+            for (;;) {
+                const chunk = await reader.read();
+                if (chunk.done) {
+                    break;
+                }
+                buffer += decoder.decode(chunk.value, { stream: true });
+                const lines = buffer.split("\n");
+                buffer = lines.pop() ?? "";
+                for (const line of lines) {
+                    for (const event of parseOllamaLine(line)) {
+                        yield event;
+                    }
+                }
+            }
+            buffer += decoder.decode();
+            if (buffer.trim() !== "") {
+                for (const event of parseOllamaLine(buffer)) {
+                    yield event;
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+}
+function toOllamaRequest(input) {
+    const body = {
+        model: input.model,
+        stream: true,
+        messages: input.messages.map(toOllamaMessage)
+    };
+    if (input.tools.length > 0) {
+        body.tools = input.tools.map(toOllamaTool);
+    }
+    if (input.temperature !== undefined) {
+        body.options = { temperature: input.temperature };
+    }
+    return body;
+}
+function toOllamaMessage(message) {
+    if (message.role === "tool") {
+        return {
+            role: "tool",
+            content: message.content,
+            tool_call_id: message.toolCallId,
+            name: message.name
+        };
+    }
+    if (message.role === "assistant" && message.toolCalls !== undefined) {
+        return {
+            role: "assistant",
+            content: message.content,
+            tool_calls: message.toolCalls.map((toolCall) => ({
+                id: toolCall.id,
+                function: {
+                    name: toolCall.name,
+                    arguments: toolCall.input
+                }
+            }))
+        };
+    }
+    return {
+        role: message.role,
+        content: message.content
+    };
+}
+function toOllamaTool(tool) {
+    return {
+        type: "function",
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.inputSchema
+        }
+    };
+}
+function parseOllamaLine(line) {
+    const trimmed = line.trim();
+    if (trimmed === "") {
+        return [];
+    }
+    const chunk = JSON.parse(trimmed);
+    const events = [];
+    if (chunk.message?.content !== undefined && chunk.message.content !== "") {
+        events.push({ type: "message_delta", text: chunk.message.content });
+    }
+    for (const [index, toolCall] of (chunk.message?.tool_calls ?? []).entries()) {
+        const name = toolCall.function?.name;
+        if (name === undefined || name === "") {
+            continue;
+        }
+        events.push({
+            type: "tool_call",
+            id: toolCall.id ?? `ollama-tool-${String(index + 1)}`,
+            name,
+            input: toolCall.function?.arguments ?? {}
+        });
+    }
+    if (chunk.done === true) {
+        events.push({
+            type: "complete",
+            finishReason: toFinishReason(chunk.done_reason)
+        });
+    }
+    return events;
+}
+function toFinishReason(reason) {
+    return reason === "length" ? "length" : "stop";
+}
+function normalizeBaseUrl(baseUrl) {
+    return baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+}
+//# sourceMappingURL=providers.js.map

package/dist/agent/providers.js.map

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

package/dist/agent/tools.d.ts

@@ -0,0 +1,8 @@
+import { toolSchemas } from "../retrieval/index.js";
+import type { RetrievalToolRuntime } from "../retrieval/index.js";
+import type { ToolResult } from "../shared/types.js";
+import type { ModelToolDefinition } from "./types.js";
+export type AgentToolName = keyof typeof toolSchemas;
+export declare function createModelToolDefinitions(): ModelToolDefinition[];
+export declare function executeAgentTool(runtime: RetrievalToolRuntime, name: string, input: unknown): Promise<ToolResult>;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/agent/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAKV,oBAAoB,EAGrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,WAAW,CAAC;AAuBrD,wBAAgB,0BAA0B,IAAI,mBAAmB,EAAE,CAMlE;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,oBAAoB,EAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,UAAU,CAAC,CAarB"}

package/dist/agent/tools.js

@@ -0,0 +1,233 @@
+import { UserFacingError } from "../errors.js";
+import { toolSchemas } from "../retrieval/index.js";
+const toolDescriptions = {
+    searchDocs: "Search indexed documentation chunks.",
+    readSourceRange: "Read exact source lines from an indexed document.",
+    readPdfSource: "Read generated Markdown and source-map metadata for an indexed PDF.",
+    grepDocs: "Search indexed source files for an exact string or regex.",
+    listDocs: "List indexed documentation sources.",
+    relatedChunks: "Fetch neighboring chunks around a retrieved chunk."
+};
+const sourceKinds = new Set([
+    "markdown",
+    "mdx",
+    "text",
+    "rst",
+    "asciidoc",
+    "html",
+    "pdf",
+    "unknown"
+]);
+export function createModelToolDefinitions() {
+    return Object.entries(toolSchemas).map(([name, schema]) => ({
+        name,
+        description: toolDescriptions[name],
+        inputSchema: { ...schema }
+    }));
+}
+export async function executeAgentTool(runtime, name, input) {
+    const beforeSeenChunkIds = new Set(runtime.trace.seenChunkIds);
+    const beforeReadCount = runtime.trace.readLocators.length;
+    const payload = await executeValidatedTool(runtime, name, input);
+    return {
+        toolName: name,
+        payload,
+        retrievedChunkIds: [...runtime.trace.seenChunkIds].filter((chunkId) => !beforeSeenChunkIds.has(chunkId)),
+        readLocators: runtime.trace.readLocators.slice(beforeReadCount)
+    };
+}
+async function executeValidatedTool(runtime, name, input) {
+    switch (name) {
+        case "searchDocs":
+            return runtime.searchDocs(readSearchDocsInput(input));
+        case "readSourceRange":
+            return await runtime.readSourceRange(readSourceRangeInput(input));
+        case "readPdfSource":
+            return runtime.readPdfSource(readPdfSourceInput(input));
+        case "grepDocs":
+            return await runtime.grepDocs(readGrepDocsInput(input));
+        case "listDocs":
+            return runtime.listDocs(readListDocsInput(input));
+        case "relatedChunks":
+            return runtime.relatedChunks(readRelatedChunksInput(input));
+        default:
+            throw new UserFacingError(`Unknown Athena tool: ${name}`);
+    }
+}
+function readSearchDocsInput(input) {
+    const record = readRecord(input, "searchDocs input");
+    assertOnlyKeys(record, ["query", "limit", "pathPrefix", "kind"], "searchDocs");
+    const result = {
+        query: readRequiredString(record, "query")
+    };
+    readOptionalLimit(record, "limit", 1, 50, (limit) => {
+        result.limit = limit;
+    });
+    readOptionalPathPrefix(record, result);
+    readOptionalKind(record, result);
+    return result;
+}
+function readSourceRangeInput(input) {
+    const record = readRecord(input, "readSourceRange input");
+    assertOnlyKeys(record, ["path", "startLine", "endLine"], "readSourceRange");
+    const path = readRequiredPath(record, "path");
+    const startLine = readRequiredInteger(record, "startLine", 1);
+    const endLine = readRequiredInteger(record, "endLine", 1);
+    if (endLine < startLine) {
+        throw new UserFacingError("readSourceRange endLine must be greater than or equal to startLine.");
+    }
+    return {
+        path,
+        startLine,
+        endLine
+    };
+}
+function readPdfSourceInput(input) {
+    const record = readRecord(input, "readPdfSource input");
+    assertOnlyKeys(record, ["path", "page", "regionId"], "readPdfSource");
+    const result = {
+        path: readRequiredPath(record, "path")
+    };
+    if (record.page !== undefined) {
+        result.page = readRequiredInteger(record, "page", 1);
+    }
+    if (record.regionId !== undefined) {
+        result.regionId = readRequiredString(record, "regionId");
+    }
+    return result;
+}
+function readGrepDocsInput(input) {
+    const record = readRecord(input, "grepDocs input");
+    assertOnlyKeys(record, ["pattern", "regex", "limit", "pathPrefix", "kind"], "grepDocs");
+    const result = {
+        pattern: readRequiredString(record, "pattern")
+    };
+    if (result.pattern.length > 128) {
+        throw new UserFacingError("grepDocs pattern must be 128 characters or fewer.");
+    }
+    readOptionalBoolean(record, "regex", (regex) => {
+        result.regex = regex;
+    });
+    readOptionalLimit(record, "limit", 1, 100, (limit) => {
+        result.limit = limit;
+    });
+    readOptionalPathPrefix(record, result);
+    readOptionalKind(record, result);
+    return result;
+}
+function readListDocsInput(input) {
+    const record = readRecord(input, "listDocs input");
+    assertOnlyKeys(record, ["pathPrefix", "kind", "limit"], "listDocs");
+    const result = {};
+    readOptionalLimit(record, "limit", 1, 500, (limit) => {
+        result.limit = limit;
+    });
+    readOptionalPathPrefix(record, result);
+    readOptionalKind(record, result);
+    return result;
+}
+function readRelatedChunksInput(input) {
+    const record = readRecord(input, "relatedChunks input");
+    assertOnlyKeys(record, ["chunkId", "before", "after"], "relatedChunks");
+    const result = {
+        chunkId: readRequiredString(record, "chunkId")
+    };
+    readOptionalLimit(record, "before", 0, 10, (before) => {
+        result.before = before;
+    });
+    readOptionalLimit(record, "after", 0, 10, (after) => {
+        result.after = after;
+    });
+    return result;
+}
+function readRecord(input, label) {
+    if (typeof input !== "object" || input === null || Array.isArray(input)) {
+        throw new UserFacingError(`${label} must be an object.`);
+    }
+    return input;
+}
+function assertOnlyKeys(record, allowedKeys, toolName) {
+    const allowed = new Set(allowedKeys);
+    const unknownKeys = Object.keys(record).filter((key) => !allowed.has(key));
+    if (unknownKeys.length > 0) {
+        throw new UserFacingError(`${toolName} received unsupported fields: ${unknownKeys.join(", ")}.`);
+    }
+}
+function readRequiredString(record, field) {
+    const value = record[field];
+    if (typeof value !== "string" || value.trim() === "") {
+        throw new UserFacingError(`${field} must be a non-empty string.`);
+    }
+    return value;
+}
+function readRequiredPath(record, field) {
+    const value = readRequiredString(record, field);
+    if (value.includes("..") || value.startsWith("/")) {
+        throw new UserFacingError(`${field} must be repository-relative.`);
+    }
+    return value;
+}
+function readRequiredInteger(record, field, min) {
+    const value = record[field];
+    if (typeof value !== "number" || !Number.isInteger(value) || value < min) {
+        throw new UserFacingError(`${field} must be an integer greater than or equal to ${String(min)}.`);
+    }
+    return value;
+}
+function readOptionalLimit(record, field, min, max, setValue) {
+    const value = record[field];
+    if (value === undefined) {
+        return;
+    }
+    if (typeof value !== "number" ||
+        !Number.isInteger(value) ||
+        value < min ||
+        value > max) {
+        throw new UserFacingError(`${field} must be an integer between ${String(min)} and ${String(max)}.`);
+    }
+    setValue(value);
+}
+function readOptionalBoolean(record, field, setValue) {
+    const value = record[field];
+    if (value === undefined) {
+        return;
+    }
+    if (typeof value !== "boolean") {
+        throw new UserFacingError(`${field} must be a boolean.`);
+    }
+    setValue(value);
+}
+function readOptionalPathPrefix(record, result) {
+    const value = record.pathPrefix;
+    if (value === undefined) {
+        return;
+    }
+    if (typeof value !== "string" ||
+        value.includes("..") ||
+        value.startsWith("/")) {
+        throw new UserFacingError("pathPrefix must be repository-relative.");
+    }
+    result.pathPrefix = value;
+}
+function readOptionalKind(record, result) {
+    const value = record.kind;
+    if (value === undefined) {
+        return;
+    }
+    if (typeof value !== "string" || !sourceKinds.has(value)) {
+        throw new UserFacingError(`Unsupported source kind: ${describeValue(value)}.`);
+    }
+    result.kind = value;
+}
+function describeValue(value) {
+    if (typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean") {
+        return String(value);
+    }
+    if (value === null) {
+        return "null";
+    }
+    return typeof value;
+}
+//# sourceMappingURL=tools.js.map

package/dist/agent/tools.js.map

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