mojentic 1.0.0

package/dist/llm/gateways/tokenizerGateway.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenizerGateway = void 0;
+const tiktoken_1 = require("tiktoken");
+/**
+ * Gateway for tokenizing and detokenizing text using tiktoken.
+ *
+ * This gateway provides encoding and decoding functionality for text,
+ * which is useful for:
+ * - Counting tokens to manage context windows
+ * - Understanding token usage for cost estimation
+ * - Debugging token-related issues
+ *
+ * @example
+ * ```typescript
+ * const tokenizer = new TokenizerGateway();
+ * const tokens = tokenizer.encode("Hello, world!");
+ * const text = tokenizer.decode(tokens);
+ * ```
+ */
+class TokenizerGateway {
+    tokenizer;
+    /**
+     * Creates a new TokenizerGateway instance.
+     *
+     * @param model - The encoding model to use. Defaults to "cl100k_base" which is used by GPT-4 and GPT-3.5-turbo.
+     *                Other options include "p50k_base" (GPT-3), "r50k_base" (older models), etc.
+     */
+    constructor(model = 'cl100k_base') {
+        this.tokenizer = (0, tiktoken_1.get_encoding)(model);
+    }
+    /**
+     * Encodes text into tokens.
+     *
+     * @param text - The text to encode
+     * @returns An array of token IDs
+     *
+     * @example
+     * ```typescript
+     * const tokenizer = new TokenizerGateway();
+     * const tokens = tokenizer.encode("Hello, world!");
+     * console.log(`Token count: ${tokens.length}`);
+     * ```
+     */
+    encode(text) {
+        return Array.from(this.tokenizer.encode(text));
+    }
+    /**
+     * Decodes tokens back into text.
+     *
+     * @param tokens - The array of token IDs to decode
+     * @returns The decoded text
+     *
+     * @example
+     * ```typescript
+     * const tokenizer = new TokenizerGateway();
+     * const tokens = [9906, 11, 1917, 0];
+     * const text = tokenizer.decode(tokens);
+     * console.log(text); // "Hello, world!"
+     * ```
+     */
+    decode(tokens) {
+        const decoder = new TextDecoder();
+        return decoder.decode(this.tokenizer.decode(new Uint32Array(tokens)));
+    }
+    /**
+     * Frees the tokenizer resources.
+     * Call this when you're done using the tokenizer to prevent memory leaks.
+     */
+    free() {
+        this.tokenizer.free();
+    }
+}
+exports.TokenizerGateway = TokenizerGateway;
+//# sourceMappingURL=tokenizerGateway.js.map

package/dist/llm/gateways/tokenizerGateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizerGateway.js","sourceRoot":"","sources":["../../../src/llm/gateways/tokenizerGateway.ts"],"names":[],"mappings":";;;AAAA,uCAAkD;AAElD;;;;;;;;;;;;;;;GAeG;AACH,MAAa,gBAAgB;IACnB,SAAS,CAAW;IAE5B;;;;;OAKG;IACH,YAAY,QAAgB,aAAa;QACvC,IAAI,CAAC,SAAS,GAAG,IAAA,uBAAY,EAAC,KAA2D,CAAC,CAAC;IAC7F,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAY;QACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,MAAgB;QACrB,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;CACF;AAxDD,4CAwDC"}

package/dist/llm/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * LLM module exports
+ */
+export * from './models';
+export * from './gateway';
+export * from './broker';
+export * from './chat-session';
+export * from './tools';
+export * from './gateways';
+export * from './agent';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}

package/dist/llm/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * LLM module exports
+ */
+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("./models"), exports);
+__exportStar(require("./gateway"), exports);
+__exportStar(require("./broker"), exports);
+__exportStar(require("./chat-session"), exports);
+__exportStar(require("./tools"), exports);
+__exportStar(require("./gateways"), exports);
+__exportStar(require("./agent"), exports);
+//# sourceMappingURL=index.js.map

package/dist/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,2CAAyB;AACzB,4CAA0B;AAC1B,2CAAyB;AACzB,iDAA+B;AAC/B,0CAAwB;AACxB,6CAA2B;AAC3B,0CAAwB"}

package/dist/llm/models.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Core data models for LLM interactions
+ */
+/**
+ * Role of a message in a conversation
+ */
+export declare enum MessageRole {
+    System = "system",
+    User = "user",
+    Assistant = "assistant",
+    Tool = "tool"
+}
+/**
+ * Content item in a message (text or image)
+ */
+export interface ContentItem {
+    type: 'text' | 'image_url';
+    text?: string;
+    image_url?: {
+        url: string;
+    };
+}
+/**
+ * Tool call request from the LLM
+ */
+export interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/**
+ * Message in a conversation with an LLM
+ */
+export interface LlmMessage {
+    role: MessageRole;
+    content: string | ContentItem[];
+    name?: string;
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
+}
+/**
+ * Helper functions for creating messages
+ */
+export declare class Message {
+    static system(content: string): LlmMessage;
+    static user(content: string): LlmMessage;
+    static assistant(content: string, toolCalls?: ToolCall[]): LlmMessage;
+    static tool(content: string, toolCallId: string, name: string): LlmMessage;
+}
+/**
+ * Configuration for LLM completion requests
+ */
+export interface CompletionConfig {
+    temperature?: number;
+    maxTokens?: number;
+    numPredict?: number;
+    topP?: number;
+    topK?: number;
+    numCtx?: number;
+    frequencyPenalty?: number;
+    presencePenalty?: number;
+    stop?: string[];
+    stream?: boolean;
+    responseFormat?: {
+        type: 'json_object' | 'text';
+        schema?: Record<string, unknown>;
+    };
+}
+/**
+ * Response from an LLM gateway
+ */
+export interface GatewayResponse {
+    content: string;
+    toolCalls?: ToolCall[];
+    finishReason?: 'stop' | 'length' | 'tool_calls' | 'content_filter';
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    model?: string;
+}
+/**
+ * Stream chunk from an LLM gateway
+ */
+export interface StreamChunk {
+    content?: string;
+    toolCalls?: ToolCall[];
+    finishReason?: 'stop' | 'length' | 'tool_calls' | 'content_filter';
+    done: boolean;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/llm/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/llm/models.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE;QACV,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,OAAO;IAClB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;IAO1C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;IAOxC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,GAAG,UAAU;IAQrE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU;CAQ3E;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE;QACf,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,gBAAgB,CAAC;IACnE,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,gBAAgB,CAAC;IACnE,IAAI,EAAE,OAAO,CAAC;CACf"}

package/dist/llm/models.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Core data models for LLM interactions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Message = exports.MessageRole = void 0;
+/**
+ * Role of a message in a conversation
+ */
+var MessageRole;
+(function (MessageRole) {
+    MessageRole["System"] = "system";
+    MessageRole["User"] = "user";
+    MessageRole["Assistant"] = "assistant";
+    MessageRole["Tool"] = "tool";
+})(MessageRole || (exports.MessageRole = MessageRole = {}));
+/**
+ * Helper functions for creating messages
+ */
+class Message {
+    static system(content) {
+        return {
+            role: MessageRole.System,
+            content,
+        };
+    }
+    static user(content) {
+        return {
+            role: MessageRole.User,
+            content,
+        };
+    }
+    static assistant(content, toolCalls) {
+        return {
+            role: MessageRole.Assistant,
+            content,
+            tool_calls: toolCalls,
+        };
+    }
+    static tool(content, toolCallId, name) {
+        return {
+            role: MessageRole.Tool,
+            content,
+            tool_call_id: toolCallId,
+            name,
+        };
+    }
+}
+exports.Message = Message;
+//# sourceMappingURL=models.js.map

package/dist/llm/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/llm/models.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;GAEG;AACH,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,4BAAa,CAAA;IACb,sCAAuB,CAAA;IACvB,4BAAa,CAAA;AACf,CAAC,EALW,WAAW,2BAAX,WAAW,QAKtB;AAoCD;;GAEG;AACH,MAAa,OAAO;IAClB,MAAM,CAAC,MAAM,CAAC,OAAe;QAC3B,OAAO;YACL,IAAI,EAAE,WAAW,CAAC,MAAM;YACxB,OAAO;SACR,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,OAAe;QACzB,OAAO;YACL,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,OAAO;SACR,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,OAAe,EAAE,SAAsB;QACtD,OAAO;YACL,IAAI,EAAE,WAAW,CAAC,SAAS;YAC3B,OAAO;YACP,UAAU,EAAE,SAAS;SACtB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,OAAe,EAAE,UAAkB,EAAE,IAAY;QAC3D,OAAO;YACL,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,OAAO;YACP,YAAY,EAAE,UAAU;YACxB,IAAI;SACL,CAAC;IACJ,CAAC;CACF;AA/BD,0BA+BC"}

package/dist/llm/tools/ask-user.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Ask user tool - prompts user for input when the LLM needs help
+ */
+import { BaseTool, ToolArgs, ToolDescriptor, ToolResult } from './tool';
+import { Result } from '../../error';
+/**
+ * Tool that prompts the user for input when the LLM needs help or information.
+ *
+ * This tool allows the LLM to ask questions or request assistance from the user
+ * during problem-solving. It displays a message and waits for user input via stdin.
+ *
+ * @example
+ * ```typescript
+ * const tool = new AskUserTool();
+ * const result = await tool.run({
+ *   user_request: "What is your preferred programming language?"
+ * });
+ * // Displays:
+ * //
+ * //
+ * //
+ * // I NEED YOUR HELP!
+ * // What is your preferred programming language?
+ * // Your response:
+ * // (waits for user input)
+ * ```
+ */
+export declare class AskUserTool extends BaseTool {
+    run(args: ToolArgs): Promise<Result<ToolResult, Error>>;
+    descriptor(): ToolDescriptor;
+    /**
+     * Prompt the user for input via readline.
+     *
+     * @param prompt - The prompt text to display
+     * @returns Promise resolving to the user's input
+     */
+    private promptUser;
+}
+//# sourceMappingURL=ask-user.d.ts.map

package/dist/llm/tools/ask-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user.d.ts","sourceRoot":"","sources":["../../../src/llm/tools/ask-user.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACxE,OAAO,EAAM,MAAM,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,WAAY,SAAQ,QAAQ;IACjC,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAU7D,UAAU,IAAI,cAAc;IAsB5B;;;;;OAKG;YACW,UAAU;CAazB"}

package/dist/llm/tools/ask-user.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * Ask user tool - prompts user for input when the LLM needs help
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AskUserTool = void 0;
+const tool_1 = require("./tool");
+const error_1 = require("../../error");
+const readline = __importStar(require("readline"));
+/**
+ * Tool that prompts the user for input when the LLM needs help or information.
+ *
+ * This tool allows the LLM to ask questions or request assistance from the user
+ * during problem-solving. It displays a message and waits for user input via stdin.
+ *
+ * @example
+ * ```typescript
+ * const tool = new AskUserTool();
+ * const result = await tool.run({
+ *   user_request: "What is your preferred programming language?"
+ * });
+ * // Displays:
+ * //
+ * //
+ * //
+ * // I NEED YOUR HELP!
+ * // What is your preferred programming language?
+ * // Your response:
+ * // (waits for user input)
+ * ```
+ */
+class AskUserTool extends tool_1.BaseTool {
+    async run(args) {
+        const userRequest = args.user_request || '';
+        console.log(`\n\n\nI NEED YOUR HELP!\n${userRequest}`);
+        const response = await this.promptUser('Your response: ');
+        return (0, error_1.Ok)(response);
+    }
+    descriptor() {
+        return {
+            type: 'function',
+            function: {
+                name: 'ask_user',
+                description: 'If you do not know how to proceed, ask the user a question, or ask them for help or to do something for you.',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        user_request: {
+                            type: 'string',
+                            description: 'The question you need the user to answer, or the task you need the user to do for you.',
+                        },
+                    },
+                    required: ['user_request'],
+                },
+            },
+        };
+    }
+    /**
+     * Prompt the user for input via readline.
+     *
+     * @param prompt - The prompt text to display
+     * @returns Promise resolving to the user's input
+     */
+    async promptUser(prompt) {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        return new Promise((resolve) => {
+            rl.question(prompt, (answer) => {
+                rl.close();
+                resolve(answer);
+            });
+        });
+    }
+}
+exports.AskUserTool = AskUserTool;
+//# sourceMappingURL=ask-user.js.map

package/dist/llm/tools/ask-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user.js","sourceRoot":"","sources":["../../../src/llm/tools/ask-user.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,iCAAwE;AACxE,uCAAyC;AACzC,mDAAqC;AAErC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAa,WAAY,SAAQ,eAAQ;IACvC,KAAK,CAAC,GAAG,CAAC,IAAc;QACtB,MAAM,WAAW,GAAI,IAAI,CAAC,YAAuB,IAAI,EAAE,CAAC;QAExD,OAAO,CAAC,GAAG,CAAC,4BAA4B,WAAW,EAAE,CAAC,CAAC;QAEvD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;QAE1D,OAAO,IAAA,UAAE,EAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IAED,UAAU;QACR,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI,EAAE,UAAU;gBAChB,WAAW,EACT,8GAA8G;gBAChH,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,YAAY,EAAE;4BACZ,IAAI,EAAE,QAAQ;4BACd,WAAW,EACT,wFAAwF;yBAC3F;qBACF;oBACD,QAAQ,EAAE,CAAC,cAAc,CAAC;iBAC3B;aACF;SACF,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,UAAU,CAAC,MAAc;QACrC,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;YAClC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QAEH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;gBAC7B,EAAE,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AApDD,kCAoDC"}

package/dist/llm/tools/current-datetime.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Current datetime tool - returns the current date and time
+ */
+import { BaseTool, ToolArgs, ToolDescriptor, ToolResult } from './tool';
+import { Result } from '../../error';
+/**
+ * Tool that returns the current date and time
+ */
+export declare class CurrentDatetimeTool extends BaseTool {
+    run(args: ToolArgs): Promise<Result<ToolResult, Error>>;
+    descriptor(): ToolDescriptor;
+    /**
+     * Format a date using Python strftime-style format codes
+     */
+    private formatDateTime;
+}
+//# sourceMappingURL=current-datetime.d.ts.map

package/dist/llm/tools/current-datetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-datetime.d.ts","sourceRoot":"","sources":["../../../src/llm/tools/current-datetime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACxE,OAAO,EAAM,MAAM,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;IACzC,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAgB7D,UAAU,IAAI,cAAc;IAsB5B;;OAEG;IACH,OAAO,CAAC,cAAc;CA+BvB"}

package/dist/llm/tools/current-datetime.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * Current datetime tool - returns the current date and time
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CurrentDatetimeTool = void 0;
+const tool_1 = require("./tool");
+const error_1 = require("../../error");
+/**
+ * Tool that returns the current date and time
+ */
+class CurrentDatetimeTool extends tool_1.BaseTool {
+    async run(args) {
+        const formatString = args.format_string || '%Y-%m-%d %H:%M:%S';
+        const now = new Date();
+        // Convert Python strftime format to JavaScript Date format
+        const formattedTime = this.formatDateTime(now, formatString);
+        const timestamp = Math.floor(now.getTime() / 1000);
+        const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+        return (0, error_1.Ok)({
+            current_datetime: formattedTime,
+            timestamp: timestamp,
+            timezone: timezone,
+        });
+    }
+    descriptor() {
+        return {
+            type: 'function',
+            function: {
+                name: 'get_current_datetime',
+                description: 'Get the current date and time. Useful when you need to know the current time or date.',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        format_string: {
+                            type: 'string',
+                            description: "Format string for the datetime (e.g., '%Y-%m-%d %H:%M:%S', '%A, %B %d, %Y'). Default is ISO format.",
+                        },
+                    },
+                    required: [],
+                },
+            },
+        };
+    }
+    /**
+     * Format a date using Python strftime-style format codes
+     */
+    formatDateTime(date, format) {
+        const pad = (n, width = 2) => String(n).padStart(width, '0');
+        const replacements = {
+            '%Y': String(date.getFullYear()),
+            '%y': String(date.getFullYear()).slice(-2),
+            '%m': pad(date.getMonth() + 1),
+            '%d': pad(date.getDate()),
+            '%H': pad(date.getHours()),
+            '%I': pad(date.getHours() % 12 || 12),
+            '%M': pad(date.getMinutes()),
+            '%S': pad(date.getSeconds()),
+            '%p': date.getHours() >= 12 ? 'PM' : 'AM',
+            '%A': date.toLocaleDateString('en-US', { weekday: 'long' }),
+            '%a': date.toLocaleDateString('en-US', { weekday: 'short' }),
+            '%B': date.toLocaleDateString('en-US', { month: 'long' }),
+            '%b': date.toLocaleDateString('en-US', { month: 'short' }),
+            '%w': String(date.getDay()),
+            '%j': String(Math.floor((date.getTime() - new Date(date.getFullYear(), 0, 0).getTime()) / 86400000)),
+        };
+        let result = format;
+        for (const [code, value] of Object.entries(replacements)) {
+            // eslint-disable-next-line security/detect-non-literal-regexp -- Format codes are from controlled set
+            result = result.replace(new RegExp(code, 'g'), value);
+        }
+        return result;
+    }
+}
+exports.CurrentDatetimeTool = CurrentDatetimeTool;
+//# sourceMappingURL=current-datetime.js.map

package/dist/llm/tools/current-datetime.js.map

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

package/dist/llm/tools/date-resolver.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Date resolver tool - resolves relative date references like "next Friday"
+ */
+import { BaseTool, ToolArgs, ToolDescriptor, ToolResult } from './tool';
+import { Result } from '../../error';
+/**
+ * Tool that resolves relative date references
+ */
+export declare class DateResolverTool extends BaseTool {
+    run(args: ToolArgs): Promise<Result<ToolResult, Error>>;
+    descriptor(): ToolDescriptor;
+    private resolveDate;
+    private getWeekdayNumber;
+    private getNextWeekday;
+    private getLastWeekday;
+}
+//# sourceMappingURL=date-resolver.d.ts.map

package/dist/llm/tools/date-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-resolver.d.ts","sourceRoot":"","sources":["../../../src/llm/tools/date-resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACxE,OAAO,EAAM,MAAM,EAAa,MAAM,aAAa,CAAC;AAEpD;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;IACtC,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IA0B7D,UAAU,IAAI,cAAc;IAqB5B,OAAO,CAAC,WAAW;IA+DnB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,cAAc;CAYvB"}