@aidejs/core 0.1.0-alpha.0

package/CHANGELOG

@@ -0,0 +1,4 @@
+v0.1.0:
+    date:
+    changes:
+      - 初始化版本

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) zxl20070701 走一步，再走一步
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,107 @@
+<img src="./docs/images/logo.png" />
+
+# [Aidejs](https://github.com/NN-Studio/Aidejs)
+一个用于构建人工智能代理的JavaScript框架，它提供了一组工具和库，使创建智能应用程序变得轻松和高效
+
+## 功能列表
+
+通过类似拼积木的方式，你可以轻松地组合各个模块完成个性化的 AI 应用开发。
+
+下面是可用模块：
+
+<p>
+    <a href="https://github.com/NN-Studio/Aidejs/issues">
+        <img src="https://img.shields.io/github/issues/NN-Studio/Aidejs" alt="issue">
+    </a>
+    <a href="https://github.com/NN-Studio/Aidejs" target='_blank'>
+        <img alt="GitHub repo stars" src="https://img.shields.io/github/stars/NN-Studio/Aidejs?style=social">
+    </a>
+    <a href="https://github.com/NN-Studio/Aidejs">
+        <img src="https://img.shields.io/github/forks/NN-Studio/Aidejs" alt="forks">
+    </a>
+</p>
+
+<table>
+    <thead>
+        <tr>
+            <td>名称</td>
+            <td>简介</td>
+            <td>地址</td>
+        </tr>
+    </thead>
+    <tbody>
+        <tr>
+            <td>@aidejs/core</td>
+            <td>必选项，基础库，提供了最核心的LLM交互功能和插件系统</td>
+            <td>
+                <a href="https://www.npmjs.com/package/@aidejs/core" target="_blank">访问</a>
+            </td>
+        </tr>
+        <tr>
+            <td>@aidejs/tools</td>
+            <td>非必选，工具库，提供了各种实用的工具函数</td>
+            <td>
+                <a href="https://www.npmjs.com/package/@aidejs/tools" target="_blank">访问</a>
+            </td>
+        </tr>
+    </tbody>
+</table>
+
+更多模块我们将持续维护，你也可以[ 提issue ](https://github.com/NN-Studio/Aidejs/issues)告诉我们你希望提供或丰富优化的。
+
+## 如何使用？
+
+比如我们希望智能体告诉我们 ./mailmap 文件中的内容，怎么办？
+
+首先，安装必要的依赖：
+
+```bash
+npm i @aidejs/core @aidejs/tools
+```
+
+然后在文件index.js中写入如下代码：
+
+```js
+const Aidejs = require("@aidejs/core");
+const Tools = require("@aidejs/tools");
+
+// 注册插件
+Aidejs.use(Tools);
+
+let agent = new Aidejs({
+    model: "qwen3",
+    url: "http://localhost:11434/v1",
+    apiKey: ""
+});
+
+agent.task("告诉我文件./.mailmap中的内容是什么", function (message) {
+    process.stdout.write(message);
+});
+```
+
+然后直接运行：
+
+```bash
+node ./index.js
+```
+
+运行以后，就可以看见智能体的回答了：
+
+```
+文件 `./.mailmap` 的内容如下：
+
+` ` `
+zxl20070701 <1904314465@qq.com>
+` ` `
+
+这通常是一个邮件映射配置文件，用于将作者名（`zxl20070701`）映射到具体的邮箱地址（`1904314465@qq.com`），
+常见于 Git 等工具的签名配置中。需要我帮你修改或解释吗？
+```
+
+更多细节，你可以访问[ 《Aidejs官方文档》 ](https://NN-Studio.github.io/Aidejs/)进行了解或学习。
+
+## 版权
+
+MIT License
+
+Copyright (c) [zxl20070701](https://zxl20070701.github.io/notebook/home.html) 走一步，再走一步

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@aidejs/core",
+  "version": "0.1.0-alpha.0",
+  "description": "@aidejs/core",
+  "main": "./src/index.js",
+  "typings": "./types/index.d.ts",
+  "sideEffects": false,
+  "scripts": {},
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NN-Studio/Aidejs.git",
+    "directory": "packages/core"
+  },
+  "author": {
+    "name": "zxl20070701",
+    "url": "https://zxl20070701.github.io/notebook/home.html"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/NN-Studio/Aidejs/issues"
+  },
+  "homepage": "https://github.com/NN-Studio/Aidejs",
+  "dependencies": {
+    "oipage": "^2.0.0"
+  }
+}

package/src/Tool.js

@@ -0,0 +1,32 @@
+module.exports = class Tool {
+
+    constructor() {
+        this.tools = {};
+    }
+
+    // 注册
+    register(name, value) {
+        if (this.tools[name]) {
+            console.warn(`工具${name}已存在，将被覆盖`);
+        }
+        this.tools[name] = value;
+    }
+
+    // 工具列表
+    valueOf() {
+        let toolList = [];
+        for (let name in this.tools) {
+            toolList.push(this.tools[name].description);
+        }
+        return toolList;
+    }
+
+    // 工具调用
+    invoke(name, args) {
+        if (!this.tools[name]) {
+            throw new Error(`工具${name}不存在`);
+        }
+        return this.tools[name].valueOf(args);
+    }
+
+};

package/src/index.js

@@ -0,0 +1,123 @@
+const { initOption } = require("oipage/nodejs/option/index");
+const OpenAI = require("./utils/OpenAI");
+const Tool = require("./Tool.js");
+
+module.exports = class Aidejs {
+
+    // 工具管理对象
+    static tool = new Tool();
+
+    constructor(options = {}) {
+        this.options = initOption(options, {
+            model: "",
+            url: "http://localhost:11434/v1",
+            apiKey: ""
+        });
+
+        if (!this.options.model) {
+            throw new Error("model is required");
+        }
+    }
+
+    //  注册工具
+    static registerTool(name, value) {
+        Aidejs.tool.register(name, value);
+    }
+
+    // 安装插件，比如可用工具tool或技能skill等
+    static use(plugin) {
+        plugin.install(Aidejs);
+        return Aidejs;
+    }
+
+    // 执行任务
+    task(message, logback, inputback) {
+        let messages = [], lastIndex = -1, toolCalls = false;
+
+        let resetLastIndex = () => {
+            messages.push({
+                role: "assistant",
+                content: ""
+            });
+            lastIndex = messages.length - 1;
+        };
+
+        let runInputback = () => {
+            if (inputback) {
+                inputback().then(message => {
+                    messages.push({
+                        role: "user",
+                        content: message
+                    });
+                    runChat();
+                }).catch(() => {
+                    console.log("任务完成，未继续输入，已结束。");
+                });
+            } else {
+                console.log("任务完成，未提供输入回调，已结束。");
+            }
+        };
+
+        let runChat = () => {
+            OpenAI(this.options.url + "/chat/completions", {
+                header: {
+                    Authorization: `Bearer ${this.options.apiKey}`
+                },
+                params: {
+                    model: this.options.model,
+                    messages,
+                    tools: Aidejs.tool.valueOf(),
+                    stream: true
+                }
+            }, function (chunk) {
+                try {
+                    for (let choice of chunk.choices) {
+
+                        if (choice.finish_reason) {
+                            if (toolCalls) {
+                                toolCalls = false;
+                                runChat();
+                            } else {
+                                runInputback();
+                            }
+                        } else {
+                            logback(choice.delta.content || "");
+
+                            if (choice.delta.tool_calls) {
+                                for (let tool_call of choice.delta.tool_calls) {
+                                    let result = Aidejs.tool.invoke(tool_call.function.name, JSON.parse(tool_call.function.arguments));
+                                    messages.push({
+                                        role: "tool",
+                                        tool_name: tool_call.function.name,
+                                        content: typeof result === "string" ? result : (JSON.stringify(result) + "")
+                                    });
+                                }
+                                toolCalls = true;
+                            } else {
+                                if (messages[lastIndex].role !== "assistant") resetLastIndex();
+                                messages[lastIndex].content += choice.delta.content || "";
+                            }
+                        }
+                    }
+                } catch (e) {
+                    console.error("处理智能体响应时发生错误：", e);
+                }
+            });
+
+            resetLastIndex();
+        };
+
+        if (message) {
+            messages.push({
+                role: "user",
+                content: message
+            });
+            runChat();
+        } else {
+            runInputback();
+        }
+
+        return this;
+    }
+
+};

package/src/utils/OpenAI.js

@@ -0,0 +1,41 @@
+const https = require('https');
+const http = require('http');
+const toJSON = require("./toJSON");
+
+module.exports = function (url, options = {}, databack, callback, errorback) {
+
+    let handler = /^https/.test(url) ? https : http;
+
+    let execArray = /https*:\/\/([^\/]+)(.+)?/.exec(url);
+    let hostport = execArray[1].split(":");
+
+    const req = handler.request({
+        hostname: hostport[0],
+        port: hostport[1] || 80,
+        path: execArray[2] || "/",
+        method: "POST",
+        headers: options.header || {}
+    }, (res) => {
+
+        let data = "";
+        res.on('data', (chunk) => {
+            chunk = chunk.toString().replace(/^data: /, "");
+
+            // 没有callback的情况下，data不累积，直接把chunk传给databack，适合流式处理
+            // 有callback的情况下，data累积chunk，等end事件触发时一次性调用callback，适合非流式处理
+            if (callback) data += chunk;
+
+            if (databack) databack(toJSON(chunk));
+        });
+        res.on('end', () => {
+            if (callback) callback(toJSON(data));
+        });
+    });
+
+    req.write(JSON.stringify(options.params || {}));
+
+    req.on('error', (e) => {
+        if (errorback) errorback(e);
+    });
+    req.end();
+};

package/src/utils/toJSON.js

@@ -0,0 +1,8 @@
+module.exports = function (value) {
+    try {
+        value = value.trim().replace(/data: \[DONE\]$/, "");
+        return JSON.parse(value);
+    } catch (e) {
+        return value;
+    }
+}

package/types/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @description: Aidejs核心类
+ */
+export default class Aidejs {
+
+    constructor(options: {
+        model: string,
+        url?: string,
+        apiKey?: string
+    })
+
+    /**
+     * 注册工具
+     * @param name 
+     * @param value 
+     */
+    static registerTool(name: string, value: any): void
+
+    /**
+     * 安装插件
+     * @param plugin 
+     */
+    static use(plugin: any): Aidejs
+
+    /**
+     * 执行任务
+     * @param message 
+     */
+    task(message: string, logback: (message: string) => void, inputback: () => Promise<string>): this
+
+}