@nickyzj2023/ai 1.0.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 nickyzj2023
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# ai
+
+男生自用MyPi Coding Agent，0外部依赖
+
+## 安装
+
+```bash
+# npm
+npm install @nickyzj2023/ai
+
+# yarn
+yarn add @nickyzj2023/ai
+
+# pnpm
+pnpm add @nickyzj2023/ai
+```
+
+## 使用方式
+
+### 在项目里使用
+
+```typescript
+import { defineModel, runAgent, getWeather } from "@nickyzj2023/ai";
+
+const model = defineModel({
+  baseUrl: "https://api.deepseek.com/v1",
+  apiKey: process.env.APIKEY,
+  model: "deepseek-v4-flash",
+});
+
+const tools = [
+  // 内置工具
+  getWeather,
+  getTime,
+  // 自定义工具
+  defineTool("getRandomNumber", "生成随机数字", {min: {type: "number", description: "最小区间"}, max: {type:"number", description:"最大区间"}}, () => 33550336),
+];
+
+const messages = [{ role: "user", content: "随机一个负无穷到正无穷的整数" }];
+
+for await (const e of runAgent(model, messages, tools)) {
+  console.log(e);
+}
+```
+
+### 在终端里使用
+
+```bash
+# 配置deepseek环境变量、启动对话
+SET APIKEY=sk-xxx && ai
+```
+
+## License
+
+ISC

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/cli.mjs

@@ -0,0 +1,67 @@
+import { a as runAgent, i as defineTool, n as get_weather_default, r as defineModel, t as TUI } from "./tui-Dz0id9sE.mjs";
+import { fetcher } from "@nickyzj2023/utils";
+import { existsSync } from "node:fs";
+import { loadEnvFile } from "node:process";
+//#region src/tools/get-time.ts
+const weekdayNames = {
+	Sunday: "星期日",
+	Monday: "星期一",
+	Tuesday: "星期二",
+	Wednesday: "星期三",
+	Thursday: "星期四",
+	Friday: "星期五",
+	Saturday: "星期六"
+};
+var get_time_default = defineTool("get_time", "查询指定时区的当前时间", { timezone: {
+	type: "string",
+	description: "完整的IANA时区名称，如Europe/Amsterdam。用户未明确提及时，传入对方语言对应的时区，例如对方使用中文时可传入Asia/Shanghai。",
+	required: true
+} }, async ({ timezone }) => {
+	const data = await fetcher("https://timeapi.io/api", { params: { timezone } }).get("/time/current/zone");
+	const pad = (n) => String(n).padStart(2, "0");
+	return [
+		`时区：${data.timeZone}${data.dstActive ? "（夏令时已生效）" : ""}`,
+		`日期：${data.year}-${pad(data.month)}-${pad(data.day)}（${weekdayNames[data.dayOfWeek] ?? data.dayOfWeek}）`,
+		`时间：${pad(data.hour)}:${pad(data.minute)}:${pad(data.seconds)}`
+	].join("\n");
+});
+//#endregion
+//#region src/cli.ts
+if (existsSync(".env")) loadEnvFile(".env");
+const model = defineModel({
+	baseUrl: process.env.BASE_URL ?? "https://api.deepseek.com/v1",
+	apiKey: process.env.APIKEY,
+	model: process.env.MODEL ?? "deepseek-v4-flash"
+});
+if (!model.apiKey) {
+	console.error("请先在环境变量或.env文件中填入APIKEY（目前仅支持DeepSeek）");
+	process.exit(1);
+}
+const messages = [];
+const tools = [get_weather_default, get_time_default];
+const tui = new TUI(async (input) => {
+	messages.push({
+		role: "user",
+		content: input
+	});
+	for await (const e of runAgent(model, messages, tools)) switch (e.type) {
+		case "reasoning_delta":
+			tui.printReasoning(e.delta);
+			break;
+		case "content_delta":
+			tui.printContent(e.delta);
+			break;
+		case "tool_call":
+			tui.printToolCall(e.name, e.args);
+			break;
+		case "tool_result":
+			tui.printToolResult(e.name, e.result);
+			break;
+		case "done": tui.printFinish(e.finishReason, e.usage);
+	}
+});
+tui.start();
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":["getWeather","getTime"],"sources":["../src/tools/get-time.ts","../src/cli.ts"],"sourcesContent":["import { fetcher } from \"@nickyzj2023/utils\";\nimport { defineTool } from \"../helper.js\";\n\n// 英文星期名映射为中文，让输出直接可读；未知值时回退到原始英文\nconst weekdayNames: Record<string, string> = {\n\tSunday: \"星期日\",\n\tMonday: \"星期一\",\n\tTuesday: \"星期二\",\n\tWednesday: \"星期三\",\n\tThursday: \"星期四\",\n\tFriday: \"星期五\",\n\tSaturday: \"星期六\",\n};\n\nexport default defineTool(\n\t\"get_time\",\n\t\"查询指定时区的当前时间\",\n\t{\n\t\ttimezone: {\n\t\t\ttype: \"string\",\n\t\t\tdescription:\n\t\t\t\t\"完整的IANA时区名称，如Europe/Amsterdam。用户未明确提及时，传入对方语言对应的时区，例如对方使用中文时可传入Asia/Shanghai。\",\n\t\t\trequired: true,\n\t\t},\n\t},\n\tasync ({ timezone }) => {\n\t\tconst api = fetcher(\"https://timeapi.io/api\", {\n\t\t\tparams: {\n\t\t\t\ttimezone,\n\t\t\t},\n\t\t});\n\t\tconst data = await api.get<any>(\"/time/current/zone\");\n\t\t// 时/分/秒统一补零成两位，保证输出时间文本格式一致\n\t\tconst pad = (n: number) => String(n).padStart(2, \"0\");\n\t\treturn [\n\t\t\t`时区：${data.timeZone}${data.dstActive ? \"（夏令时已生效）\" : \"\"}`,\n\t\t\t`日期：${data.year}-${pad(data.month)}-${pad(data.day)}（${weekdayNames[data.dayOfWeek] ?? data.dayOfWeek}）`,\n\t\t\t`时间：${pad(data.hour)}:${pad(data.minute)}:${pad(data.seconds)}`,\n\t\t].join(\"\\n\");\n\t},\n);\n","import { existsSync } from \"node:fs\";\nimport { loadEnvFile } from \"node:process\";\nimport { runAgent } from \"./agent.js\";\nimport { defineModel } from \"./helper.js\";\nimport getTime from \"./tools/get-time.js\";\nimport getWeather from \"./tools/get-weather.js\";\nimport { TUI } from \"./tui.js\";\nimport type { Message } from \"./types.js\";\n\n// 仅在存在.env时加载：发布后用户可能没有该文件，直接调用会抛错\nif (existsSync(\".env\")) {\n\tloadEnvFile(\".env\");\n}\n\n// 1. 读取配置（环境变量可覆盖默认的DeepSeek地址与模型）\nconst model = defineModel({\n\tbaseUrl: process.env.BASE_URL ?? \"https://api.deepseek.com/v1\",\n\tapiKey: process.env.APIKEY,\n\tmodel: process.env.MODEL ?? \"deepseek-v4-flash\",\n});\n\nif (!model.apiKey) {\n\tconsole.error(\"请先在环境变量或.env文件中填入APIKEY（目前仅支持DeepSeek）\");\n\tprocess.exit(1);\n}\n\n// 2. 读取上下文\nconst messages: Message[] = [];\n\n// 3. 读取工具\nconst tools = [getWeather, getTime];\n\n// 4. 启动TUI，监听用户输入，按下回车后调用Agent\nconst tui = new TUI(async (input) => {\n\tmessages.push({ role: \"user\", content: input });\n\n\tfor await (const e of runAgent(model, messages, tools)) {\n\t\tswitch (e.type) {\n\t\t\tcase \"reasoning_delta\": {\n\t\t\t\ttui.printReasoning(e.delta);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"content_delta\": {\n\t\t\t\ttui.printContent(e.delta);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"tool_call\": {\n\t\t\t\ttui.printToolCall(e.name, e.args);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"tool_result\": {\n\t\t\t\ttui.printToolResult(e.name, e.result);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"done\": {\n\t\t\t\ttui.printFinish(e.finishReason, e.usage);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t}\n});\ntui.start();\n"],"mappings":";;;;;AAIA,MAAM,eAAuC;CAC5C,QAAQ;CACR,QAAQ;CACR,SAAS;CACT,WAAW;CACX,UAAU;CACV,QAAQ;CACR,UAAU;AACX;AAEA,IAAA,mBAAe,WACd,YACA,eACA,EACC,UAAU;CACT,MAAM;CACN,aACC;CACD,UAAU;AACX,EACD,GACA,OAAO,EAAE,eAAe;CAMvB,MAAM,OAAO,MALD,QAAQ,0BAA0B,EAC7C,QAAQ,EACP,SACD,EACD,CACqB,CAAC,CAAC,IAAS,oBAAoB;CAEpD,MAAM,OAAO,MAAc,OAAO,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG;CACpD,OAAO;EACN,MAAM,KAAK,WAAW,KAAK,YAAY,aAAa;EACpD,MAAM,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,EAAE,GAAG,IAAI,KAAK,GAAG,EAAE,GAAG,aAAa,KAAK,cAAc,KAAK,UAAU;EACtG,MAAM,IAAI,KAAK,IAAI,EAAE,GAAG,IAAI,KAAK,MAAM,EAAE,GAAG,IAAI,KAAK,OAAO;CAC7D,CAAC,CAAC,KAAK,IAAI;AACZ,CACD;;;AC9BA,IAAI,WAAW,MAAM,GACpB,YAAY,MAAM;AAInB,MAAM,QAAQ,YAAY;CACzB,SAAS,QAAQ,IAAI,YAAY;CACjC,QAAQ,QAAQ,IAAI;CACpB,OAAO,QAAQ,IAAI,SAAS;AAC7B,CAAC;AAED,IAAI,CAAC,MAAM,QAAQ;CAClB,QAAQ,MAAM,wCAAwC;CACtD,QAAQ,KAAK,CAAC;AACf;AAGA,MAAM,WAAsB,CAAC;AAG7B,MAAM,QAAQ,CAACA,qBAAYC,gBAAO;AAGlC,MAAM,MAAM,IAAI,IAAI,OAAO,UAAU;CACpC,SAAS,KAAK;EAAE,MAAM;EAAQ,SAAS;CAAM,CAAC;CAE9C,WAAW,MAAM,KAAK,SAAS,OAAO,UAAU,KAAK,GACpD,QAAQ,EAAE,MAAV;EACC,KAAK;GACJ,IAAI,eAAe,EAAE,KAAK;GAC1B;EAED,KAAK;GACJ,IAAI,aAAa,EAAE,KAAK;GACxB;EAED,KAAK;GACJ,IAAI,cAAc,EAAE,MAAM,EAAE,IAAI;GAChC;EAED,KAAK;GACJ,IAAI,gBAAgB,EAAE,MAAM,EAAE,MAAM;GACpC;EAED,KAAK,QACJ,IAAI,YAAY,EAAE,cAAc,EAAE,KAAK;CAGzC;AAEF,CAAC;AACD,IAAI,MAAM"}

package/dist/index.d.mts

@@ -0,0 +1,210 @@
+//#region src/types.d.ts
+type Model = {
+  baseUrl: string;
+  /** 如果不传，会尝试使用GET {baseUrl}/models获取到的第一个模型 */
+  model?: string;
+  /** 使用本地llama.cpp等服务时可以不填 */
+  apiKey?: string;
+  /**
+   * 模型支持的消息输入类型
+   * @default ["text"]
+   * @remarks 会在每轮对话前校验消息类型，存在不支持的输入时报错
+   */
+  modalities?: Modality[];
+  /**
+   * 模型的最大上下文
+   * @default 131072
+   * @remarks 会在每轮对话结束后检查上下文阈值，自动压缩消息
+   */
+  context?: number;
+  /**
+   * 自定义请求体，会在每轮请求时带上
+   * @example chat_template_kwargs: { enable_thinking: false }
+   */
+  [key: string]: unknown;
+};
+/** 文/图/音/视频，暂未实现文件输入 */
+type Modality = "text" | "image" | "audio" | "video";
+type Message = {
+  role: "system" | "user" | "assistant" | "tool";
+  reasoning?: string | null;
+  content: string | ContentPart[];
+  tool_calls?: ToolCall[];
+  tool_call_id?: string;
+  [key: string]: unknown;
+};
+type ContentPart = TextContent | ImageContent | AudioContent | VideoContent;
+type TextContent = {
+  type: "text";
+  text: string;
+};
+type ImageContent = {
+  type: "image_url";
+  image_url: {
+    url: string;
+  };
+};
+type AudioContent = {
+  type: "input_audio";
+  input_audio: {
+    /** 使用公网可访问的音频链接 */
+    url?: string;
+    /** 使用base64 */
+    data?: string;
+    format: string;
+  };
+};
+type VideoContent = {
+  type: "video_url";
+  video_url: {
+    url: string;
+  };
+};
+type ToolDefinition = {
+  type: "function";
+  function: {
+    name: string;
+    description: string;
+    parameters: {
+      type: "object";
+      properties: Record<string, {
+        type: string;
+        description?: string;
+        /** defineTool()提供的语法糖，等价于在parameters.required.push(当前property key) */
+        required?: boolean;
+      }>;
+      required?: string[];
+    };
+  };
+  /** 工具的实际执行函数 */
+  execute: (...args: any) => any;
+};
+type ToolCall = {
+  id: string;
+  type: "function";
+  function: {
+    name: string;
+    arguments: string;
+  };
+};
+/** stream()对外输出的事件 */
+type LLMEvent = {
+  type: "reasoning_delta";
+  delta: string;
+} | {
+  type: "content_delta";
+  delta: string;
+} | {
+  type: "tool_call";
+  id: string;
+  name: string;
+  args: any;
+} | {
+  type: "done";
+  finishReason: FinishReason;
+  usage?: Usage;
+} | {
+  type: "error";
+  message: string;
+};
+/** stream()内部要处理的事件流 */
+type ChatCompletionsChunk = {
+  id: string;
+  object: "chat.completion.chunk";
+  created: number;
+  model: string;
+  choices: {
+    index: number;
+    delta: Pick<Message, "reasoning" | "content"> & {
+      tool_calls?: ({
+        index: number;
+      } & Partial<ToolCall>)[];
+    };
+    finish_reason: FinishReason;
+  }[];
+  usage?: Usage;
+} | "[DONE]";
+/** 模型可能返回的finish_reason值：停止/工具调用/上下文超限 */
+type FinishReason = "stop" | "tool_calls" | "length" | null;
+type Usage = {
+  prompt_tokens: number;
+  completion_tokens: number;
+  total_tokens: number;
+  [key: string]: any;
+};
+type AgentEvent = LLMEvent | {
+  type: "tool_result";
+  id: string;
+  name: string;
+  result: string;
+};
+//#endregion
+//#region src/agent.d.ts
+declare function runAgent(model: Model, messages: Message[], tools: ToolDefinition[]): AsyncGenerator<AgentEvent>;
+//#endregion
+//#region src/helper.d.ts
+/**
+ * 辅助定义一个POST /chat/completions支持的model参数
+ * @remarks 只有baseUrl字段是必须的
+ */
+declare const defineModel: (config: Model) => Model;
+/**
+ * 辅助定义一个POST /chat/completions支持的tool对象
+ * @param execute 实际执行工具的函数
+ */
+declare const defineTool: (name: ToolDefinition["function"]["name"], description: ToolDefinition["function"]["description"], properties: ToolDefinition["function"]["parameters"]["properties"], execute: ToolDefinition["execute"]) => ToolDefinition;
+//#endregion
+//#region src/llm.d.ts
+/**
+ * 流式请求模型，转发
+ */
+declare function stream(model: Model, messages: Message[], tools?: ToolDefinition[]): AsyncGenerator<LLMEvent>;
+//#endregion
+//#region src/tools/get-weather.d.ts
+declare const _default: ToolDefinition;
+//#endregion
+//#region src/tui.d.ts
+declare class TUI {
+  private rl;
+  private onPrompt;
+  /** 是否允许输入 */
+  private isBusy;
+  /** 上次打印内容所属的状态（reasoning/content/tool）
+   * 用于在新的状态开始时改变样式、打印前缀
+   */
+  private prevPrintType;
+  /**
+   * 实例化TUI时，接收一个“发出用户提示词”的回调函数
+   * UI只做UI的事，提示词发给谁让调用方决定
+   */
+  constructor(onPrompt: (prompt: string) => void | Promise<void>);
+  /** 启动TUI */
+  start(): void;
+  /** 监听用户输入 */
+  private prompting;
+  /**
+   * 所有print方法调用前的统一入口（相当于“父类逻辑”）：
+   * 状态切换时打印换行，并记录当前状态。
+   * @returns 是否发生了状态切换
+   */
+  private preparePrint;
+  /**
+   * 为文本添加ANSI颜色；非TTY输出（重定向/管道）时返回原文本，避免日志出现转义码。
+   * @param text 原始文本
+   * @param ansiCode ANSI颜色代码，如 "90"（亮黑，大多数终端显示为灰色）
+   */
+  private colorize;
+  /** 流式打印AI思考内容（灰色） */
+  printReasoning(delta: string): void;
+  /** 流式打印AI回复内容 */
+  printContent(delta: string): void;
+  /** 打印工具调用 */
+  printToolCall(name: string, args: any): void;
+  /** 打印工具结果 */
+  printToolResult(name: string, result: string): void;
+  /** 打印轮次结束原因、token消耗 */
+  printFinish(finishReason: FinishReason, usage?: Usage): void;
+}
+//#endregion
+export { type AgentEvent, type AudioContent, type ChatCompletionsChunk, type ContentPart, type FinishReason, type ImageContent, type LLMEvent, type Message, type Modality, type Model, TUI, type TextContent, type ToolCall, type ToolDefinition, type Usage, type VideoContent, defineModel, defineTool, _default as getWeather, runAgent, stream };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { a as runAgent, i as defineTool, n as get_weather_default, o as stream, r as defineModel, t as TUI } from "./tui-Dz0id9sE.mjs";
+export { TUI, defineModel, defineTool, get_weather_default as getWeather, runAgent, stream };

package/dist/tui-Dz0id9sE.mjs

@@ -0,0 +1,300 @@
+import { fetcher, parseSSE, pick, to } from "@nickyzj2023/utils";
+import readline from "node:readline";
+//#region src/llm.ts
+/**
+* 分离ToolDefinition中的valid/invalid字段，前者可以传给模型，后者用于本地运算
+* @returns [validObj, invalidObj]
+*/
+const detachToolArguments = (toolDefinition) => {
+	return [pick(toolDefinition, ["type", "function"]), pick(toolDefinition, ["execute"])];
+};
+/**
+* 从消息中提取模型的思考内容。
+* 不同供应商，即使都用OpenAI API Compatible接口，输出的思考内容字段也可能不同，例如：
+* - OpenRouter里的思考字段为reasoning
+* - 火山引擎的叫reasoning_content
+* @returns 统一返回reasoning作为思考内容字段
+*/
+const extractReasoning = (msgLike) => {
+	return msgLike.reasoning || msgLike.reasoning_content;
+};
+/**
+* 流式请求模型，转发
+*/
+async function* stream(model, messages, tools = []) {
+	const validTools = tools.map((tool) => detachToolArguments(tool)[0]);
+	const api = fetcher(model.baseUrl, {
+		headers: { Authorization: `Bearer ${model.apiKey}` },
+		parser: async (res) => res
+	});
+	const [error, response] = await to(api.post("/chat/completions", {
+		stream: true,
+		model: model.model,
+		messages,
+		tools: validTools
+	}));
+	if (error) {
+		yield {
+			type: "error",
+			message: error.message
+		};
+		return;
+	}
+	const toolCallBuffers = /* @__PURE__ */ new Map();
+	let usage;
+	let finishReason = null;
+	for await (const chunk of parseSSE(response)) {
+		if (typeof chunk === "string") continue;
+		if (chunk.usage) usage = chunk.usage;
+		const choice = chunk.choices?.[0];
+		if (!choice) continue;
+		const { delta } = choice;
+		const { content: contentDelta, tool_calls: toolCalls } = delta;
+		const reasoning = extractReasoning(delta);
+		if (reasoning) yield {
+			type: "reasoning_delta",
+			delta: reasoning
+		};
+		if (contentDelta) yield {
+			type: "content_delta",
+			delta: contentDelta.toString()
+		};
+		if (toolCalls) for (const call of toolCalls) {
+			const { index = 0, type = "function", id, function: fn, ...extra } = call;
+			const existing = toolCallBuffers.getOrInsert(index, {
+				id: "",
+				type,
+				function: {
+					name: "",
+					arguments: ""
+				}
+			});
+			if (id) existing.id = id;
+			if (fn?.name) existing.function.name += fn.name;
+			if (fn?.arguments) existing.function.arguments += fn.arguments;
+			if (extra) Object.assign(existing, extra);
+			toolCallBuffers.set(index, existing);
+		}
+		if (choice.finish_reason) finishReason = choice.finish_reason;
+	}
+	for (const [, call] of toolCallBuffers) yield {
+		type: "tool_call",
+		id: call.id,
+		name: call.function.name,
+		args: call.function.arguments
+	};
+	yield {
+		type: "done",
+		finishReason,
+		usage
+	};
+}
+//#endregion
+//#region src/agent.ts
+async function* runAgent(model, messages, tools) {
+	const toolMap = new Map(tools.map((tool) => [tool.function.name, tool]));
+	while (true) {
+		let content = "";
+		const toolCalls = [];
+		for await (const e of stream(model, messages, tools)) switch (e.type) {
+			case "reasoning_delta":
+				yield e;
+				break;
+			case "content_delta":
+				content += e.delta;
+				yield e;
+				break;
+			case "tool_call":
+				toolCalls.push({
+					id: e.id,
+					type: "function",
+					function: {
+						name: e.name,
+						arguments: e.args
+					}
+				});
+				yield e;
+				break;
+			case "done": yield e;
+		}
+		const message = {
+			role: "assistant",
+			content
+		};
+		if (toolCalls.length > 0) message.tool_calls = toolCalls;
+		messages.push(message);
+		if (toolCalls.length === 0) return;
+		for (const call of toolCalls) {
+			const { name, arguments: args } = call.function;
+			const tool = toolMap.get(name);
+			let result = "";
+			if (!tool) result = `不存在工具“${name}”`;
+			else {
+				const [error, response] = await to(tool.execute(JSON.parse(args)));
+				result = error ? `工具“${name}”执行出错：${error.message}` : String(response);
+			}
+			messages.push({
+				role: "tool",
+				tool_call_id: call.id,
+				content: result
+			});
+			yield {
+				type: "tool_result",
+				id: call.id,
+				name,
+				result
+			};
+		}
+	}
+}
+//#endregion
+//#region src/helper.ts
+/**
+* 辅助定义一个POST /chat/completions支持的model参数
+* @remarks 只有baseUrl字段是必须的
+*/
+const defineModel = (config) => ({
+	modalities: ["text"],
+	context: 131072,
+	...config
+});
+/**
+* 辅助定义一个POST /chat/completions支持的tool对象
+* @param execute 实际执行工具的函数
+*/
+const defineTool = (name, description, properties, execute) => {
+	const _required = [];
+	return {
+		type: "function",
+		function: {
+			name,
+			description,
+			parameters: {
+				type: "object",
+				properties: Object.entries(properties).reduce((result, [key, property]) => {
+					if ("required" in property) {
+						_required.push(key);
+						delete property.required;
+					}
+					result[key] = property;
+					return result;
+				}, {}),
+				required: _required
+			}
+		},
+		execute
+	};
+};
+//#endregion
+//#region src/tools/get-weather.ts
+var get_weather_default = defineTool("get_weather", "查询指定城市的天气情况", { city: {
+	type: "string",
+	description: "城市名，如shanghai、tokyo",
+	required: true
+} }, async ({ city }) => {
+	const data = await fetcher("https://wttr.in", { params: { format: "j1" } }).get(`/${city}`);
+	const nearestArea = data.nearest_area[0];
+	const currentCondition = data.current_condition[0];
+	return [
+		`位置：${nearestArea.country[0].value}-${nearestArea.region[0].value}-${nearestArea.areaName[0].value}`,
+		`当前温度: ${currentCondition.temp_C}°C`,
+		`体感温度: ${currentCondition.FeelsLikeC}°C`,
+		`天气状况: ${currentCondition.weatherDesc[0].value}`,
+		`湿度: ${currentCondition.humidity}%`
+	].join("\n");
+});
+//#endregion
+//#region src/tui.ts
+var TUI = class {
+	rl = null;
+	onPrompt = null;
+	/** 是否允许输入 */
+	isBusy = false;
+	/** 上次打印内容所属的状态（reasoning/content/tool）
+	* 用于在新的状态开始时改变样式、打印前缀
+	*/
+	prevPrintType = void 0;
+	/**
+	* 实例化TUI时，接收一个“发出用户提示词”的回调函数
+	* UI只做UI的事，提示词发给谁让调用方决定
+	*/
+	constructor(onPrompt) {
+		this.onPrompt = onPrompt;
+	}
+	/** 启动TUI */
+	start() {
+		this.rl = readline.createInterface({
+			input: process.stdin,
+			output: process.stdout
+		});
+		this.prompting();
+		this.rl.on("close", () => {
+			this.rl?.close();
+			this.rl = null;
+		});
+	}
+	/** 监听用户输入 */
+	prompting() {
+		if (this.isBusy) return;
+		this.rl?.question("> ", async (answer) => {
+			const input = answer.trim();
+			if (!input) {
+				this.prompting();
+				return;
+			}
+			this.isBusy = true;
+			await this.onPrompt?.(input);
+			this.isBusy = false;
+			this.prompting();
+		});
+	}
+	/**
+	* 所有print方法调用前的统一入口（相当于“父类逻辑”）：
+	* 状态切换时打印换行，并记录当前状态。
+	* @returns 是否发生了状态切换
+	*/
+	preparePrint(type) {
+		if (this.prevPrintType === type) return false;
+		process.stdout.write("\n");
+		this.prevPrintType = type;
+		return true;
+	}
+	/**
+	* 为文本添加ANSI颜色；非TTY输出（重定向/管道）时返回原文本，避免日志出现转义码。
+	* @param text 原始文本
+	* @param ansiCode ANSI颜色代码，如 "90"（亮黑，大多数终端显示为灰色）
+	*/
+	colorize(text, ansiCode) {
+		if (!process.stdout.isTTY) return text;
+		return `\x1b[${ansiCode}m${text}\x1b[0m`;
+	}
+	/** 流式打印AI思考内容（灰色） */
+	printReasoning(delta) {
+		if (this.preparePrint("reasoning_delta")) delta = `[思考内容] ${delta.replaceAll("\n", "")}`;
+		process.stdout.write(this.colorize(delta, "90"));
+	}
+	/** 流式打印AI回复内容 */
+	printContent(delta) {
+		this.preparePrint("content_delta");
+		process.stdout.write(delta);
+	}
+	/** 打印工具调用 */
+	printToolCall(name, args) {
+		this.preparePrint("tool_call");
+		process.stdout.write(`[工具调用：${name}] ${args}`);
+	}
+	/** 打印工具结果 */
+	printToolResult(name, result) {
+		this.preparePrint("tool_result");
+		process.stdout.write(this.colorize(`[工具结果：${name}] ${result}`, "90"));
+	}
+	/** 打印轮次结束原因、token消耗 */
+	printFinish(finishReason, usage) {
+		this.preparePrint("done");
+		process.stdout.write(this.colorize(`[本轮结束：${finishReason}] ${usage ? `输入${usage.prompt_tokens}tok，输出${usage.completion_tokens}tok，总共${usage.total_tokens}tok` : ""}${finishReason === "stop" ? "\n\n" : "\n"}`, "90"));
+	}
+};
+//#endregion
+export { runAgent as a, defineTool as i, get_weather_default as n, stream as o, defineModel as r, TUI as t };
+
+//# sourceMappingURL=tui-Dz0id9sE.mjs.map

package/dist/tui-Dz0id9sE.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-Dz0id9sE.mjs","names":[],"sources":["../src/llm.ts","../src/agent.ts","../src/helper.ts","../src/tools/get-weather.ts","../src/tui.ts"],"sourcesContent":["// ================================\n// 解析OpenAI API Compatible的SSE事件流\n// ================================\n\nimport { fetcher, parseSSE, pick, to } from \"@nickyzj2023/utils\";\nimport type {\n\tChatCompletionsChunk,\n\tFinishReason,\n\tLLMEvent,\n\tMessage,\n\tModel,\n\tToolCall,\n\tToolDefinition,\n\tUsage,\n} from \"./types.js\";\n\n/**\n * 分离ToolDefinition中的valid/invalid字段，前者可以传给模型，后者用于本地运算\n * @returns [validObj, invalidObj]\n */\nconst detachToolArguments = (toolDefinition: ToolDefinition) => {\n\treturn [\n\t\tpick(toolDefinition, [\"type\", \"function\"]),\n\t\tpick(toolDefinition, [\"execute\"]),\n\t] as const;\n};\n\n/**\n * 从消息中提取模型的思考内容。\n * 不同供应商，即使都用OpenAI API Compatible接口，输出的思考内容字段也可能不同，例如：\n * - OpenRouter里的思考字段为reasoning\n * - 火山引擎的叫reasoning_content\n * @returns 统一返回reasoning作为思考内容字段\n */\nconst extractReasoning = (msgLike: Record<string, any>): string | undefined => {\n\treturn msgLike.reasoning || msgLike.reasoning_content;\n};\n\n/**\n * 流式请求模型，转发\n */\nexport async function* stream(\n\tmodel: Model,\n\tmessages: Message[],\n\ttools: ToolDefinition[] = [],\n): AsyncGenerator<LLMEvent> {\n\t// 剥离ToolDefinition里的私有字段/语法糖\n\tconst validTools = tools.map((tool) => detachToolArguments(tool)[0]);\n\n\tconst api = fetcher(model.baseUrl, {\n\t\theaders: {\n\t\t\tAuthorization: `Bearer ${model.apiKey}`,\n\t\t},\n\t\t// 覆盖默认返回的res.json()，改用野生Response\n\t\tparser: async (res) => res,\n\t});\n\n\t// 发出请求\n\tconst [error, response] = await to(\n\t\tapi.post<Response>(\"/chat/completions\", {\n\t\t\tstream: true,\n\t\t\tmodel: model.model,\n\t\t\tmessages,\n\t\t\ttools: validTools,\n\t\t}),\n\t);\n\tif (error) {\n\t\tyield { type: \"error\", message: error.message };\n\t\treturn;\n\t}\n\n\t// 逐行解析SSE事件\n\tconst toolCallBuffers = new Map<number, ToolCall>();\n\tlet usage: Usage | undefined;\n\tlet finishReason: FinishReason = null;\n\tfor await (const chunk of parseSSE<ChatCompletionsChunk>(response)) {\n\t\t// 字符串（通常是\"[DONE]\"），无需处理\n\t\tif (typeof chunk === \"string\") {\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (chunk.usage) {\n\t\t\tusage = chunk.usage;\n\t\t}\n\n\t\t// 模型无回复，暂不处理\n\t\tconst choice = chunk.choices?.[0];\n\t\tif (!choice) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst { delta } = choice;\n\t\tconst { content: contentDelta, tool_calls: toolCalls } = delta;\n\n\t\t// 模型祈祷中...\n\t\tconst reasoning = extractReasoning(delta);\n\t\tif (reasoning) {\n\t\t\tyield { type: \"reasoning_delta\", delta: reasoning };\n\t\t}\n\n\t\t// 模型确定回复\n\t\tif (contentDelta) {\n\t\t\tyield { type: \"content_delta\", delta: contentDelta.toString() };\n\t\t}\n\n\t\t// 拼接工具调用请求\n\t\tif (toolCalls) {\n\t\t\tfor (const call of toolCalls) {\n\t\t\t\tconst {\n\t\t\t\t\tindex = 0,\n\t\t\t\t\ttype = \"function\",\n\t\t\t\t\tid,\n\t\t\t\t\tfunction: fn,\n\t\t\t\t\t...extra\n\t\t\t\t} = call;\n\n\t\t\t\tconst existing = toolCallBuffers.getOrInsert(index, {\n\t\t\t\t\tid: \"\",\n\t\t\t\t\ttype,\n\t\t\t\t\tfunction: { name: \"\", arguments: \"\" },\n\t\t\t\t});\n\n\t\t\t\tif (id) {\n\t\t\t\t\texisting.id = id;\n\t\t\t\t}\n\t\t\t\tif (fn?.name) {\n\t\t\t\t\texisting.function.name += fn.name;\n\t\t\t\t}\n\t\t\t\tif (fn?.arguments) {\n\t\t\t\t\texisting.function.arguments += fn.arguments;\n\t\t\t\t}\n\t\t\t\t// 一些厂商（Gemini）会在工具调用时要求保留CoT等额外信息\n\t\t\t\tif (extra) {\n\t\t\t\t\tObject.assign(existing, extra);\n\t\t\t\t}\n\n\t\t\t\ttoolCallBuffers.set(index, existing);\n\t\t\t}\n\t\t}\n\n\t\tif (choice.finish_reason) {\n\t\t\tfinishReason = choice.finish_reason;\n\t\t}\n\t}\n\n\t// 流式传输结束：\n\t// 1. 依次发起工具调用\n\tfor (const [, call] of toolCallBuffers) {\n\t\tyield {\n\t\t\ttype: \"tool_call\",\n\t\t\tid: call.id,\n\t\t\tname: call.function.name,\n\t\t\targs: call.function.arguments,\n\t\t};\n\t}\n\t// 2. 发出done事件\n\tyield { type: \"done\", finishReason, usage };\n}\n","// ================================\n// Agent Loop，即Re-Act：用户输入 -> while(模型思考 <-> Agent帮模型调用外部工具) -> 模型输出\n// ================================\n\nimport { to } from \"@nickyzj2023/utils\";\nimport { stream } from \"./llm.js\";\nimport type {\n\tAgentEvent,\n\tMessage,\n\tModel,\n\tToolCall,\n\tToolDefinition,\n} from \"./types.js\";\n\nexport async function* runAgent(\n\tmodel: Model,\n\tmessages: Message[],\n\ttools: ToolDefinition[],\n): AsyncGenerator<AgentEvent> {\n\tconst toolMap = new Map(tools.map((tool) => [tool.function.name, tool]));\n\n\twhile (true) {\n\t\t// 1. 流式调用大模型，收集回复内容\n\t\tlet content = \"\";\n\t\tconst toolCalls: ToolCall[] = [];\n\n\t\tfor await (const e of stream(model, messages, tools)) {\n\t\t\tswitch (e.type) {\n\t\t\t\tcase \"reasoning_delta\": {\n\t\t\t\t\tyield e;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tcase \"content_delta\": {\n\t\t\t\t\tcontent += e.delta;\n\t\t\t\t\tyield e;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tcase \"tool_call\": {\n\t\t\t\t\ttoolCalls.push({\n\t\t\t\t\t\tid: e.id,\n\t\t\t\t\t\ttype: \"function\",\n\t\t\t\t\t\tfunction: {\n\t\t\t\t\t\t\tname: e.name,\n\t\t\t\t\t\t\targuments: e.args,\n\t\t\t\t\t\t},\n\t\t\t\t\t});\n\t\t\t\t\tyield e;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tcase \"done\": {\n\t\t\t\t\tyield e;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// 2. 把模型的回复推入上下文\n\t\tconst message: Message = {\n\t\t\trole: \"assistant\",\n\t\t\tcontent,\n\t\t};\n\t\tif (toolCalls.length > 0) {\n\t\t\tmessage.tool_calls = toolCalls;\n\t\t}\n\t\tmessages.push(message);\n\n\t\t// 3. 如果没有工具调用，则结束循环\n\t\tif (toolCalls.length === 0) {\n\t\t\treturn;\n\t\t}\n\n\t\t// 4. 调用工具\n\t\tfor (const call of toolCalls) {\n\t\t\tconst { name, arguments: args } = call.function;\n\t\t\tconst tool = toolMap.get(name);\n\n\t\t\tlet result = \"\";\n\t\t\tif (!tool) {\n\t\t\t\tresult = `不存在工具“${name}”`;\n\t\t\t} else {\n\t\t\t\tconst [error, response] = await to(tool.execute(JSON.parse(args)));\n\t\t\t\tresult = error\n\t\t\t\t\t? `工具“${name}”执行出错：${error.message}`\n\t\t\t\t\t: String(response);\n\t\t\t}\n\n\t\t\tmessages.push({\n\t\t\t\trole: \"tool\",\n\t\t\t\ttool_call_id: call.id,\n\t\t\t\tcontent: result,\n\t\t\t});\n\t\t\tyield { type: \"tool_result\", id: call.id, name: name, result };\n\t\t}\n\t}\n}\n","// ================================\n// 外部项目使用本npm包时的便捷方法\n// ================================\n\nimport type { Model, ToolDefinition } from \"./types.js\";\n\n/**\n * 辅助定义一个POST /chat/completions支持的model参数\n * @remarks 只有baseUrl字段是必须的\n */\nexport const defineModel = (config: Model): Model => ({\n\tmodalities: [\"text\"],\n\tcontext: 131072,\n\t...config,\n});\n\n/**\n * 辅助定义一个POST /chat/completions支持的tool对象\n * @param execute 实际执行工具的函数\n */\nexport const defineTool = (\n\tname: ToolDefinition[\"function\"][\"name\"],\n\tdescription: ToolDefinition[\"function\"][\"description\"],\n\tproperties: ToolDefinition[\"function\"][\"parameters\"][\"properties\"],\n\texecute: ToolDefinition[\"execute\"],\n): ToolDefinition => {\n\t// 收集property内部填写的required: true语法糖，推到外面的required数组\n\tconst _required: string[] = [];\n\tconst _properties = Object.entries(properties).reduce(\n\t\t(result, [key, property]) => {\n\t\t\tif (\"required\" in property) {\n\t\t\t\t_required.push(key);\n\t\t\t\tdelete property.required;\n\t\t\t}\n\t\t\tresult[key] = property;\n\t\t\treturn result;\n\t\t},\n\t\t{} as Omit<\n\t\t\tToolDefinition[\"function\"][\"parameters\"][\"properties\"],\n\t\t\t\"required\"\n\t\t>,\n\t);\n\n\treturn {\n\t\ttype: \"function\",\n\t\tfunction: {\n\t\t\tname,\n\t\t\tdescription,\n\t\t\tparameters: {\n\t\t\t\ttype: \"object\",\n\t\t\t\tproperties: _properties,\n\t\t\t\trequired: _required,\n\t\t\t},\n\t\t},\n\t\texecute,\n\t};\n};\n","import { fetcher } from \"@nickyzj2023/utils\";\nimport { defineTool } from \"../helper.js\";\n\nexport default defineTool(\n\t\"get_weather\",\n\t\"查询指定城市的天气情况\",\n\t{\n\t\tcity: {\n\t\t\ttype: \"string\",\n\t\t\tdescription: \"城市名，如shanghai、tokyo\",\n\t\t\trequired: true,\n\t\t},\n\t},\n\tasync ({ city }) => {\n\t\tconst api = fetcher(\"https://wttr.in\", {\n\t\t\tparams: {\n\t\t\t\tformat: \"j1\", // 返回JSON格式\n\t\t\t},\n\t\t});\n\t\tconst data = await api.get<any>(`/${city}`);\n\t\tconst nearestArea = data.nearest_area[0];\n\t\tconst currentCondition = data.current_condition[0];\n\t\treturn [\n\t\t\t`位置：${nearestArea.country[0].value}-${nearestArea.region[0].value}-${nearestArea.areaName[0].value}`,\n\t\t\t`当前温度: ${currentCondition.temp_C}°C`,\n\t\t\t`体感温度: ${currentCondition.FeelsLikeC}°C`,\n\t\t\t`天气状况: ${currentCondition.weatherDesc[0].value}`,\n\t\t\t`湿度: ${currentCondition.humidity}%`,\n\t\t].join(\"\\n\");\n\t},\n);\n","// ================================\n// 终端UI\n// ================================\n\nimport readline from \"node:readline\";\nimport type { AgentEvent, FinishReason, Usage } from \"./types.js\";\n\nexport class TUI {\n\tprivate rl: readline.Interface | null = null;\n\tprivate onPrompt: ((prompt: string) => void | Promise<void>) | null = null;\n\n\t/** 是否允许输入 */\n\tprivate isBusy = false;\n\n\t/** 上次打印内容所属的状态（reasoning/content/tool）\n\t * 用于在新的状态开始时改变样式、打印前缀\n\t */\n\tprivate prevPrintType: AgentEvent[\"type\"] | undefined = undefined;\n\n\t/**\n\t * 实例化TUI时，接收一个“发出用户提示词”的回调函数\n\t * UI只做UI的事，提示词发给谁让调用方决定\n\t */\n\tconstructor(onPrompt: (prompt: string) => void | Promise<void>) {\n\t\tthis.onPrompt = onPrompt;\n\t}\n\n\t/** 启动TUI */\n\tstart() {\n\t\tthis.rl = readline.createInterface({\n\t\t\tinput: process.stdin,\n\t\t\toutput: process.stdout,\n\t\t});\n\t\tthis.prompting();\n\n\t\t// 停止TUI后，清理残留的监听事件\n\t\tthis.rl.on(\"close\", () => {\n\t\t\tthis.rl?.close();\n\t\t\tthis.rl = null;\n\t\t});\n\t}\n\n\t/** 监听用户输入 */\n\tprivate prompting() {\n\t\tif (this.isBusy) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.rl?.question(\"> \", async (answer) => {\n\t\t\tconst input = answer.trim();\n\t\t\t// 如果输入为空，则重新question\n\t\t\tif (!input) {\n\t\t\t\tthis.prompting();\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthis.isBusy = true;\n\t\t\tawait this.onPrompt?.(input);\n\t\t\tthis.isBusy = false;\n\n\t\t\tthis.prompting();\n\t\t});\n\t}\n\n\t/**\n\t * 所有print方法调用前的统一入口（相当于“父类逻辑”）：\n\t * 状态切换时打印换行，并记录当前状态。\n\t * @returns 是否发生了状态切换\n\t */\n\tprivate preparePrint(type: AgentEvent[\"type\"]): boolean {\n\t\tif (this.prevPrintType === type) {\n\t\t\treturn false;\n\t\t}\n\t\tprocess.stdout.write(\"\\n\");\n\t\tthis.prevPrintType = type;\n\t\treturn true;\n\t}\n\n\t/**\n\t * 为文本添加ANSI颜色；非TTY输出（重定向/管道）时返回原文本，避免日志出现转义码。\n\t * @param text 原始文本\n\t * @param ansiCode ANSI颜色代码，如 \"90\"（亮黑，大多数终端显示为灰色）\n\t */\n\tprivate colorize(text: string, ansiCode: string): string {\n\t\tif (!process.stdout.isTTY) {\n\t\t\treturn text;\n\t\t}\n\t\treturn `\\x1b[${ansiCode}m${text}\\x1b[0m`;\n\t}\n\n\t/** 流式打印AI思考内容（灰色） */\n\tprintReasoning(delta: string) {\n\t\tif (this.preparePrint(\"reasoning_delta\")) {\n\t\t\tdelta = `[思考内容] ${delta.replaceAll(\"\\n\", \"\")}`;\n\t\t}\n\t\tprocess.stdout.write(this.colorize(delta, \"90\"));\n\t}\n\n\t/** 流式打印AI回复内容 */\n\tprintContent(delta: string) {\n\t\tthis.preparePrint(\"content_delta\");\n\t\tprocess.stdout.write(delta);\n\t}\n\n\t/** 打印工具调用 */\n\tprintToolCall(name: string, args: any) {\n\t\tthis.preparePrint(\"tool_call\");\n\t\tprocess.stdout.write(`[工具调用：${name}] ${args}`);\n\t}\n\n\t/** 打印工具结果 */\n\tprintToolResult(name: string, result: string) {\n\t\tthis.preparePrint(\"tool_result\");\n\t\tprocess.stdout.write(this.colorize(`[工具结果：${name}] ${result}`, \"90\"));\n\t}\n\n\t/** 打印轮次结束原因、token消耗 */\n\tprintFinish(finishReason: FinishReason, usage?: Usage) {\n\t\tthis.preparePrint(\"done\");\n\t\tprocess.stdout.write(\n\t\t\tthis.colorize(\n\t\t\t\t`[本轮结束：${finishReason}] ${usage ? `输入${usage.prompt_tokens}tok，输出${usage.completion_tokens}tok，总共${usage.total_tokens}tok` : \"\"}${finishReason === \"stop\" ? \"\\n\\n\" : \"\\n\"}`,\n\t\t\t\t\"90\",\n\t\t\t),\n\t\t);\n\t}\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@nickyzj2023/ai",
+  "version": "1.0.0",
+  "description": "我的“pi”，参考了pi-from-scratch",
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "ai": "./dist/cli.mjs"
+  },
+  "keywords": [
+    "agent",
+    "llm",
+    "openai",
+    "react",
+    "tool-calling",
+    "streaming",
+    "cli",
+    "tui"
+  ],
+  "author": "nickyzj2023",
+  "license": "ISC",
+  "engines": {
+    "node": ">=26.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@nickyzj2023/utils": "^1.0.92"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.11",
+    "@types/node": "^26.4.0",
+    "tsdown": "^0.22.14",
+    "typescript": "^7.0.2"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "check": "biome check --diagnostic-level=error --write src/",
+    "typecheck": "tsc --noEmit"
+  }
+}