@mate-academy/llm-gateway 8.8.2 → 8.8.4

package/dist/services/agentRounds/agentRounds.typedefs.d.ts

@@ -0,0 +1,48 @@
+import { type LLMModelUsage } from '../../LLMService.typedefs';
+/**
+ * One model round of an agent tool loop, as its provider observed it.
+ *
+ * `input` is the provider-native message array the round was sent with. Each
+ * provider keeps its own representation, so a round carries whatever that
+ * provider actually assembled — system instructions included — rather than a
+ * shared message shape none of them speaks.
+ */
+interface LLMAgentRoundBase {
+    input: unknown;
+    /**
+     * The round's own token usage. Providers that report usage per call fill it
+     * on every round; one that only totals a run leaves it unset until the last
+     * round, which then carries the run total.
+     */
+    usage?: LLMModelUsage;
+    /** Epoch milliseconds stamped immediately before the provider call. */
+    startedAt: number;
+}
+interface LLMSuccessfulAgentRound extends LLMAgentRoundBase {
+    output: unknown;
+    error?: never;
+    isError?: false;
+}
+interface LLMFailedAgentRound extends LLMAgentRoundBase {
+    output?: never;
+    error: unknown;
+    isError: true;
+}
+export type LLMAgentRound = LLMSuccessfulAgentRound | LLMFailedAgentRound;
+/**
+ * What one round's response contributes to its generation. Produced by the
+ * provider because only the provider knows which part of its response is the
+ * assistant output and where that response reports its usage.
+ */
+export interface LLMAgentRoundOutcome {
+    output: unknown;
+    usage?: LLMModelUsage;
+}
+export interface LLMAgentRoundSpec<ProviderResponse> {
+    input: unknown;
+    call: () => Promise<ProviderResponse>;
+    describeOutcome: (response: ProviderResponse) => LLMAgentRoundOutcome;
+}
+/** Emits the generation observation of a single agent round. */
+export type LLMAgentRoundWriter = (round: LLMAgentRound) => void;
+export {};

package/dist/services/agentRounds/agentRounds.typedefs.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=agentRounds.typedefs.js.map

package/dist/services/agentRounds/agentRounds.typedefs.js.map

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

package/dist/services/agentRounds/index.d.ts

@@ -0,0 +1,2 @@
+export * from './agentRounds.typedefs';
+export * from './LLMAgentRounds';

package/dist/services/agentRounds/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./agentRounds.typedefs"), exports);
+__exportStar(require("./LLMAgentRounds"), exports);
+//# sourceMappingURL=index.js.map

package/dist/services/agentRounds/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/agentRounds/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,mDAAiC"}

package/dist/services/chatState/CompletionsChatState.d.ts

@@ -0,0 +1,35 @@
+import type { ChatCompletionMessageParam, ChatCompletionMessageFunctionToolCall } from 'openai/resources/chat';
+import type { ChatCompletionContentPart } from 'openai/resources/chat';
+export type ChatCompletionToolCallExtraContent = {
+    google?: {
+        thought_signature?: string;
+    };
+} & Record<string, unknown>;
+export type ChatCompletionToolCallWithExtraContent = ChatCompletionMessageFunctionToolCall & {
+    extra_content?: ChatCompletionToolCallExtraContent;
+};
+interface ChatStateEntry {
+    instructions: string | undefined;
+    storageId: string | undefined;
+    messages: ChatCompletionMessageParam[];
+}
+export declare class CompletionsChatState {
+    private chats;
+    createChat(chatId: string, instructions?: string, storageId?: string, history?: ChatCompletionMessageParam[]): void;
+    getChat(chatId: string): ChatStateEntry | null;
+    appendUserMessage(chatId: string, content: ChatCompletionContentPart[]): void;
+    appendAssistantMessage(chatId: string, content: string): void;
+    appendToolCallMessages(chatId: string, toolCalls: ChatCompletionToolCallWithExtraContent[], reasoningContent?: string, content?: string): void;
+    appendToolResult(chatId: string, toolCallId: string, content: string): void;
+    getMessages(chatId: string): ChatCompletionMessageParam[];
+    /**
+     * Replaces every recorded thought_signature in the chat's assistant
+     * tool-call turns with the given marker. Recovery path for providers that
+     * reject a previously-issued signature on replay ("Corrupted thought
+     * signature"): downgrading to the documented validator-bypass marker lets
+     * the conversation continue without the rejected signatures.
+     */
+    replaceThoughtSignatures(chatId: string, marker: string): void;
+    deleteChat(chatId: string): void;
+}
+export {};

package/dist/services/chatState/CompletionsChatState.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompletionsChatState = void 0;
+class CompletionsChatState {
+    chats = new Map();
+    createChat(chatId, instructions, storageId, history) {
+        const messages = [];
+        if (instructions) {
+            messages.push({
+                role: 'system',
+                content: instructions,
+            });
+        }
+        if (history) {
+            messages.push(...history);
+        }
+        this.chats.set(chatId, {
+            instructions,
+            storageId,
+            messages,
+        });
+    }
+    getChat(chatId) {
+        return this.chats.get(chatId) ?? null;
+    }
+    appendUserMessage(chatId, content) {
+        const chat = this.chats.get(chatId);
+        if (!chat) {
+            return;
+        }
+        chat.messages.push({
+            role: 'user',
+            content,
+        });
+    }
+    appendAssistantMessage(chatId, content) {
+        const chat = this.chats.get(chatId);
+        if (!chat) {
+            return;
+        }
+        chat.messages.push({
+            role: 'assistant',
+            content,
+        });
+    }
+    appendToolCallMessages(chatId, toolCalls, reasoningContent, content = '') {
+        const chat = this.chats.get(chatId);
+        if (!chat) {
+            return;
+        }
+        const message = {
+            role: 'assistant',
+            content,
+            tool_calls: toolCalls,
+            ...(reasoningContent !== undefined && {
+                reasoning_content: reasoningContent,
+            }),
+        };
+        chat.messages.push(message);
+    }
+    appendToolResult(chatId, toolCallId, content) {
+        const chat = this.chats.get(chatId);
+        if (!chat) {
+            return;
+        }
+        chat.messages.push({
+            role: 'tool',
+            tool_call_id: toolCallId,
+            content: content || 'No output.',
+        });
+    }
+    getMessages(chatId) {
+        const chat = this.chats.get(chatId);
+        if (!chat) {
+            return [];
+        }
+        return chat.messages;
+    }
+    /**
+     * Replaces every recorded thought_signature in the chat's assistant
+     * tool-call turns with the given marker. Recovery path for providers that
+     * reject a previously-issued signature on replay ("Corrupted thought
+     * signature"): downgrading to the documented validator-bypass marker lets
+     * the conversation continue without the rejected signatures.
+     */
+    replaceThoughtSignatures(chatId, marker) {
+        const chat = this.chats.get(chatId);
+        if (!chat) {
+            return;
+        }
+        chat.messages = chat.messages.map((message) => {
+            if (message.role !== 'assistant' || !Array.isArray(message.tool_calls)) {
+                return message;
+            }
+            const toolCalls = message.tool_calls;
+            return {
+                ...message,
+                tool_calls: toolCalls.map((toolCall) => (toolCall.extra_content?.google?.thought_signature
+                    ? {
+                        ...toolCall,
+                        extra_content: {
+                            ...toolCall.extra_content,
+                            google: {
+                                ...toolCall.extra_content.google,
+                                thought_signature: marker,
+                            },
+                        },
+                    }
+                    : toolCall)),
+            };
+        });
+    }
+    deleteChat(chatId) {
+        this.chats.delete(chatId);
+    }
+}
+exports.CompletionsChatState = CompletionsChatState;
+//# sourceMappingURL=CompletionsChatState.js.map

package/dist/services/chatState/CompletionsChatState.js.map

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

package/dist/services/chatState/index.d.ts

@@ -0,0 +1 @@
+export { CompletionsChatState, type ChatCompletionToolCallExtraContent, type ChatCompletionToolCallWithExtraContent, } from './CompletionsChatState';

package/dist/services/chatState/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompletionsChatState = void 0;
+var CompletionsChatState_1 = require("./CompletionsChatState");
+Object.defineProperty(exports, "CompletionsChatState", { enumerable: true, get: function () { return CompletionsChatState_1.CompletionsChatState; } });
+//# sourceMappingURL=index.js.map

package/dist/services/chatState/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/chatState/index.ts"],"names":[],"mappings":";;;AAAA,+DAIgC;AAH9B,4HAAA,oBAAoB,OAAA"}

package/dist/services/fileStorage/FileStorageToolExecutor.d.ts

@@ -0,0 +1,15 @@
+import { type InMemoryFileStorage } from './InMemoryFileStorage';
+export declare class FileStorageToolExecutor {
+    private storage;
+    constructor(storage: InMemoryFileStorage);
+    execute(storageId: string, toolName: string, rawArguments: string): string;
+    private listFiles;
+    private searchFiles;
+    private mergeContextRanges;
+    private readFile;
+    private readFileLines;
+    private resolveLineRange;
+    private findFileByPath;
+    private fileNotFoundMessage;
+    private formatLinesWithNumbers;
+}

package/dist/services/fileStorage/FileStorageToolExecutor.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileStorageToolExecutor = void 0;
+const fileStorageTools_1 = require("./fileStorageTools");
+const MAX_OUTPUT_LENGTH = 50_000;
+class FileStorageToolExecutor {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    execute(storageId, toolName, rawArguments) {
+        switch (toolName) {
+            case fileStorageTools_1.FileStorageToolName.ListFiles:
+                return this.listFiles(storageId);
+            case fileStorageTools_1.FileStorageToolName.SearchFiles:
+                return this.searchFiles(storageId, JSON.parse(rawArguments));
+            case fileStorageTools_1.FileStorageToolName.ReadFile:
+                return this.readFile(storageId, JSON.parse(rawArguments));
+            case fileStorageTools_1.FileStorageToolName.ReadFileLines:
+                return this.readFileLines(storageId, JSON.parse(rawArguments));
+            default:
+                return `Unknown tool: '${toolName}'`;
+        }
+    }
+    listFiles(storageId) {
+        const files = this.storage.getStorageFiles(storageId);
+        if (files.length === 0) {
+            return 'No files in storage.';
+        }
+        return files
+            .map((file) => {
+            const lineCount = file.content.split('\n').length;
+            return `${file.name} (${file.path}) - ${lineCount} lines`;
+        })
+            .join('\n');
+    }
+    searchFiles(storageId, arguments_) {
+        const files = this.storage.getStorageFiles(storageId);
+        const contextLines = arguments_.context_lines ?? 3;
+        const lowerQuery = arguments_.query.toLowerCase();
+        const filteredFiles = arguments_.path
+            ? files.filter((file) => file.path.includes(arguments_.path))
+            : files;
+        const results = [];
+        for (const file of filteredFiles) {
+            if (!file.content.toLowerCase().includes(lowerQuery)) {
+                continue;
+            }
+            const lines = file.content.split('\n');
+            const matchingLineIndices = [];
+            for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+                if (lines[lineIndex].toLowerCase().includes(lowerQuery)) {
+                    matchingLineIndices.push(lineIndex);
+                }
+            }
+            if (matchingLineIndices.length === 0) {
+                continue;
+            }
+            const ranges = this.mergeContextRanges(matchingLineIndices, contextLines, lines.length);
+            for (const range of ranges) {
+                for (let lineIndex = range.start; lineIndex <= range.end; lineIndex++) {
+                    results.push(`${file.path}:${lineIndex + 1}: ${lines[lineIndex]}`);
+                }
+            }
+        }
+        if (results.length === 0) {
+            return `No matches found for '${arguments_.query}'`;
+        }
+        const output = results.join('\n');
+        if (output.length > MAX_OUTPUT_LENGTH) {
+            return output.slice(0, MAX_OUTPUT_LENGTH)
+                + '\n... (output truncated)';
+        }
+        return output;
+    }
+    mergeContextRanges(matchingIndices, contextLines, totalLines) {
+        const ranges = [];
+        for (const matchIndex of matchingIndices) {
+            const start = Math.max(0, matchIndex - contextLines);
+            const end = Math.min(totalLines - 1, matchIndex + contextLines);
+            const lastRange = ranges[ranges.length - 1];
+            if (lastRange && start <= lastRange.end + 1) {
+                lastRange.end = end;
+            }
+            else {
+                ranges.push({ start, end });
+            }
+        }
+        return ranges;
+    }
+    readFile(storageId, arguments_) {
+        const file = this.findFileByPath(storageId, arguments_.path);
+        if (!file) {
+            return this.fileNotFoundMessage(storageId, arguments_.path);
+        }
+        const lines = file.content.split('\n');
+        return this.formatLinesWithNumbers(lines, 1);
+    }
+    readFileLines(storageId, arguments_) {
+        const file = this.findFileByPath(storageId, arguments_.path);
+        if (!file) {
+            return this.fileNotFoundMessage(storageId, arguments_.path);
+        }
+        const lines = file.content.split('\n');
+        const { startIndex, endIndex } = this.resolveLineRange(lines.length, arguments_.start_line, arguments_.end_line);
+        const selectedLines = lines.slice(startIndex, endIndex);
+        return this.formatLinesWithNumbers(selectedLines, startIndex + 1);
+    }
+    resolveLineRange(totalLines, startLine, endLine) {
+        if (startLine !== undefined && endLine !== undefined) {
+            return {
+                startIndex: Math.max(0, startLine - 1),
+                endIndex: Math.min(totalLines, endLine),
+            };
+        }
+        if (startLine !== undefined) {
+            return {
+                startIndex: Math.max(0, startLine - 1),
+                endIndex: totalLines,
+            };
+        }
+        if (endLine !== undefined && endLine < 0) {
+            return {
+                startIndex: Math.max(0, totalLines + endLine),
+                endIndex: totalLines,
+            };
+        }
+        if (endLine !== undefined) {
+            return {
+                startIndex: 0,
+                endIndex: Math.min(totalLines, endLine),
+            };
+        }
+        return {
+            startIndex: 0,
+            endIndex: totalLines,
+        };
+    }
+    findFileByPath(storageId, path) {
+        const files = this.storage.getStorageFiles(storageId);
+        const exactMatch = files.find((file) => file.path === path);
+        if (exactMatch) {
+            return exactMatch;
+        }
+        const endsWithMatch = files.find((file) => file.path.endsWith(path));
+        if (endsWithMatch) {
+            return endsWithMatch;
+        }
+        const includesMatch = files.find((file) => file.path.includes(path));
+        return includesMatch ?? null;
+    }
+    fileNotFoundMessage(storageId, path) {
+        const files = this.storage.getStorageFiles(storageId);
+        const availablePaths = files
+            .map((file) => file.path)
+            .join(', ');
+        return `File not found: '${path}'. Available files: ${availablePaths}`;
+    }
+    formatLinesWithNumbers(lines, startLineNumber) {
+        const lastLineNumber = startLineNumber + lines.length - 1;
+        const maxWidth = String(lastLineNumber).length;
+        return lines
+            .map((line, index) => {
+            const lineNumber = String(startLineNumber + index)
+                .padStart(maxWidth, ' ');
+            return `${lineNumber}: ${line}`;
+        })
+            .join('\n');
+    }
+}
+exports.FileStorageToolExecutor = FileStorageToolExecutor;
+//# sourceMappingURL=FileStorageToolExecutor.js.map

package/dist/services/fileStorage/FileStorageToolExecutor.js.map

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

package/dist/services/fileStorage/InMemoryFileStorage.d.ts

@@ -0,0 +1,20 @@
+import { type LLMUploadFileMimeTypes } from '../../LLMService.typedefs';
+interface StoredFile {
+    fileId: string;
+    name: string;
+    path: string;
+    mimeType: LLMUploadFileMimeTypes;
+    content: string;
+}
+export declare class InMemoryFileStorage {
+    private files;
+    private filesByPath;
+    private storages;
+    addFile(path: string, name: string, mimeType: LLMUploadFileMimeTypes): StoredFile;
+    getFileByPath(path: string): StoredFile | null;
+    removeFile(fileId: string): void;
+    createStorage(fileIds: string[]): string;
+    removeStorage(storageId: string): void;
+    getStorageFiles(storageId: string): StoredFile[];
+}
+export {};

package/dist/services/fileStorage/InMemoryFileStorage.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryFileStorage = void 0;
+const fs_1 = require("fs");
+const uuid_1 = require("uuid");
+class InMemoryFileStorage {
+    files = new Map();
+    filesByPath = new Map();
+    storages = new Map();
+    addFile(path, name, mimeType) {
+        const existing = this.filesByPath.get(path);
+        if (existing) {
+            return existing;
+        }
+        const content = (0, fs_1.readFileSync)(path, 'utf-8');
+        const fileId = (0, uuid_1.v4)();
+        const storedFile = {
+            fileId,
+            name,
+            path,
+            mimeType,
+            content,
+        };
+        this.files.set(fileId, storedFile);
+        this.filesByPath.set(path, storedFile);
+        return storedFile;
+    }
+    getFileByPath(path) {
+        return this.filesByPath.get(path) ?? null;
+    }
+    removeFile(fileId) {
+        const file = this.files.get(fileId);
+        if (!file) {
+            return;
+        }
+        this.filesByPath.delete(file.path);
+        this.files.delete(fileId);
+    }
+    createStorage(fileIds) {
+        const storageId = (0, uuid_1.v4)();
+        this.storages.set(storageId, {
+            storageId,
+            fileIds,
+        });
+        return storageId;
+    }
+    removeStorage(storageId) {
+        const group = this.storages.get(storageId);
+        if (group) {
+            for (const fileId of group.fileIds) {
+                this.removeFile(fileId);
+            }
+        }
+        this.storages.delete(storageId);
+    }
+    getStorageFiles(storageId) {
+        const group = this.storages.get(storageId);
+        if (!group) {
+            return [];
+        }
+        return group.fileIds
+            .map((fileId) => this.files.get(fileId))
+            .filter((file) => file !== undefined);
+    }
+}
+exports.InMemoryFileStorage = InMemoryFileStorage;
+//# sourceMappingURL=InMemoryFileStorage.js.map

package/dist/services/fileStorage/InMemoryFileStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryFileStorage.js","sourceRoot":"","sources":["../../../src/services/fileStorage/InMemoryFileStorage.ts"],"names":[],"mappings":";;;AAAA,2BAAkC;AAClC,+BAAoC;AAgBpC,MAAa,mBAAmB;IACtB,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IACtC,WAAW,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC5C,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEvD,OAAO,CACL,IAAY,EACZ,IAAY,EACZ,QAAgC;QAEhC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAE5C,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAA,SAAM,GAAE,CAAC;QAExB,MAAM,UAAU,GAAe;YAC7B,MAAM;YACN,IAAI;YACJ,IAAI;YACJ,QAAQ;YACR,OAAO;SACR,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACnC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAEvC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,aAAa,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IAC5C,CAAC;IAED,UAAU,CAAC,MAAc;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEpC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,aAAa,CAAC,OAAiB;QAC7B,MAAM,SAAS,GAAG,IAAA,SAAM,GAAE,CAAC;QAE3B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE;YAC3B,SAAS;YACT,OAAO;SACR,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,aAAa,CAAC,SAAiB;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE3C,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBACnC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,eAAe,CAAC,SAAiB;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE3C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,KAAK,CAAC,OAAO;aACjB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;aACvC,MAAM,CAAC,CAAC,IAAI,EAAsB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAC9D,CAAC;CACF;AAlFD,kDAkFC"}

package/dist/services/fileStorage/fileStorageTools.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import type { ChatCompletionTool } from 'openai/resources/chat';
+export declare enum FileStorageToolName {
+    ListFiles = "list_files",
+    SearchFiles = "search_files",
+    ReadFile = "read_file",
+    ReadFileLines = "read_file_lines"
+}
+declare const searchFilesParameters: z.ZodObject<{
+    query: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    context_lines: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const readFileParameters: z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strip>;
+declare const readFileLinesParameters: z.ZodObject<{
+    path: z.ZodString;
+    start_line: z.ZodOptional<z.ZodNumber>;
+    end_line: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type SearchFilesArgs = z.infer<typeof searchFilesParameters>;
+export type ReadFileArgs = z.infer<typeof readFileParameters>;
+export type ReadFileLinesArgs = z.infer<typeof readFileLinesParameters>;
+export declare function getFileStorageToolsForChatCompletions(): ChatCompletionTool[];
+export {};

package/dist/services/fileStorage/fileStorageTools.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileStorageToolName = void 0;
+exports.getFileStorageToolsForChatCompletions = getFileStorageToolsForChatCompletions;
+const zod_1 = require("zod");
+var FileStorageToolName;
+(function (FileStorageToolName) {
+    FileStorageToolName["ListFiles"] = "list_files";
+    FileStorageToolName["SearchFiles"] = "search_files";
+    FileStorageToolName["ReadFile"] = "read_file";
+    FileStorageToolName["ReadFileLines"] = "read_file_lines";
+})(FileStorageToolName || (exports.FileStorageToolName = FileStorageToolName = {}));
+const listFilesParameters = zod_1.z.object({});
+const searchFilesParameters = zod_1.z.object({
+    query: zod_1.z.string().describe('The search query string to find in file contents'),
+    path: zod_1.z.string().optional().describe('Optional file path filter to narrow the search scope'),
+    context_lines: zod_1.z.number().optional().describe('Number of context lines to show around each match (default: 3)'),
+});
+const readFileParameters = zod_1.z.object({
+    path: zod_1.z.string().describe('The path of the file to read'),
+});
+const readFileLinesParameters = zod_1.z.object({
+    path: zod_1.z.string().describe('The path of the file to read'),
+    start_line: zod_1.z.number().optional().describe('The 1-based starting line number to read from'),
+    end_line: zod_1.z.number().optional().describe('The 1-based ending line number to read to (inclusive). '
+        + 'Negative values read from end of file.'),
+});
+const FILE_STORAGE_TOOLS = [
+    {
+        name: FileStorageToolName.ListFiles,
+        description: 'List all files available in the file storage with their '
+            + 'names, paths, and line counts.',
+        parametersSchema: listFilesParameters,
+    },
+    {
+        name: FileStorageToolName.SearchFiles,
+        description: 'Search for a query string across all files in the storage. '
+            + 'Returns matching lines with surrounding context.',
+        parametersSchema: searchFilesParameters,
+    },
+    {
+        name: FileStorageToolName.ReadFile,
+        description: 'Read the entire contents of a file from the storage.',
+        parametersSchema: readFileParameters,
+    },
+    {
+        name: FileStorageToolName.ReadFileLines,
+        description: 'Read specific lines from a file in the storage. '
+            + 'Supports line ranges and reading from end of file.',
+        parametersSchema: readFileLinesParameters,
+    },
+];
+const FILE_STORAGE_CHAT_COMPLETION_TOOLS = FILE_STORAGE_TOOLS
+    .map((tool) => ({
+    type: 'function',
+    function: {
+        name: tool.name,
+        description: tool.description,
+        parameters: zod_1.z.toJSONSchema(tool.parametersSchema, {
+            target: 'draft-7',
+            reused: 'inline',
+        }),
+    },
+}));
+function getFileStorageToolsForChatCompletions() {
+    return FILE_STORAGE_CHAT_COMPLETION_TOOLS;
+}
+//# sourceMappingURL=fileStorageTools.js.map

package/dist/services/fileStorage/fileStorageTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileStorageTools.js","sourceRoot":"","sources":["../../../src/services/fileStorage/fileStorageTools.ts"],"names":[],"mappings":";;;AA0FA,sFAGC;AA7FD,6BAAwB;AAGxB,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC7B,+CAAwB,CAAA;IACxB,mDAA4B,CAAA;IAC5B,6CAAsB,CAAA;IACtB,wDAAiC,CAAA;AACnC,CAAC,EALW,mBAAmB,mCAAnB,mBAAmB,QAK9B;AAED,MAAM,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEzC,MAAM,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACxB,kDAAkD,CACnD;IACD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAClC,sDAAsD,CACvD;IACD,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC3C,gEAAgE,CACjE;CACF,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACvB,8BAA8B,CAC/B;CACF,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACvB,8BAA8B,CAC/B;IACD,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACxC,+CAA+C,CAChD;IACD,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACtC,yDAAyD;UACvD,wCAAwC,CAC3C;CACF,CAAC,CAAC;AAMH,MAAM,kBAAkB,GAAG;IACzB;QACE,IAAI,EAAE,mBAAmB,CAAC,SAAS;QACnC,WAAW,EAAE,0DAA0D;cACnE,gCAAgC;QACpC,gBAAgB,EAAE,mBAAmB;KACtC;IACD;QACE,IAAI,EAAE,mBAAmB,CAAC,WAAW;QACrC,WAAW,EAAE,6DAA6D;cACtE,kDAAkD;QACtD,gBAAgB,EAAE,qBAAqB;KACxC;IACD;QACE,IAAI,EAAE,mBAAmB,CAAC,QAAQ;QAClC,WAAW,EAAE,sDAAsD;QACnE,gBAAgB,EAAE,kBAAkB;KACrC;IACD;QACE,IAAI,EAAE,mBAAmB,CAAC,aAAa;QACvC,WAAW,EAAE,kDAAkD;cAC3D,oDAAoD;QACxD,gBAAgB,EAAE,uBAAuB;KAC1C;CAKA,CAAC;AAEJ,MAAM,kCAAkC,GAAyB,kBAAkB;KAChF,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACd,IAAI,EAAE,UAAmB;IACzB,QAAQ,EAAE;QACR,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,OAAC,CAAC,YAAY,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAChD,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,QAAQ;SACjB,CAAC;KACH;CACF,CAAC,CAAC,CAAC;AAEN,SAAgB,qCAAqC;IAEnD,OAAO,kCAAkC,CAAC;AAC5C,CAAC"}