@amical/aiagent-sdk 0.1.0 → 0.1.2

package/src/shared/tools.ts

@@ -1,270 +0,0 @@
-export enum AgentDefaultTool {
-  ASK = "agent_ask_followup_question",
-  ATTEMPT = "agent_attempt_completion",
-  BASH = "agent_execute_command",
-  FILE_EDIT = "agent_replace_in_file",
-  FILE_READ = "agent_read_file",
-  FILE_NEW = "agent_write_to_file",
-  FILE_DELETE = "agent_delete_file",
-  DIR_DELETE = "agent_delete_directory",
-  SEARCH = "agent_search_files",
-  LIST_FILES = "agent_list_files",
-  LIST_CODE_DEF = "agent_list_code_definition_names",
-  BROWSER = "agent_browser_action",
-  MCP_USE = "agent_use_mcp_tool",
-  MCP_ACCESS = "agent_access_mcp_resource",
-  MCP_DOCS = "agent_load_mcp_documentation",
-  NEW_TASK = "agent_new_task",
-  PLAN_MODE = "agent_plan_mode_respond",
-  ACT_MODE = "agent_act_mode_respond",
-  TODO = "agent_focus_chain",
-  WEB_FETCH = "agent_web_fetch",
-  WEB_SEARCH = "agent_web_search",
-  CONDENSE = "agent_condense",
-  SUMMARIZE_TASK = "agent_summarize_task",
-  REPORT_BUG = "agent_report_bug",
-  NEW_RULE = "agent_new_rule",
-  APPLY_PATCH = "agent_apply_patch",
-  GENERATE_EXPLANATION = "agent_generate_explanation",
-  LOAD_SKILL = "agent_load_skill",
-  USE_SUBAGENTS = "agent_use_subagents",
-}
-
-export const TOOL_RESULT_BLOCK = 'tool_call_result';
-
-export const defaultTools = [
-  {
-    name: AgentDefaultTool.ASK,
-    description: "Ask the user a clarifying question if more information is needed.",
-    params: {
-      question: "The question to ask the user.",
-    },
-  },
-  {
-    name: AgentDefaultTool.ATTEMPT,
-    description: "After each tool use, the user will respond with the result of that tool use, i.e. if it succeeded or failed, along with any reasons for failure. Once you've received the results of tool uses and can confirm that the task is complete, use this tool to present the result of your work to the user. Optionally you may provide a CLI command to showcase the result of your work. The user may respond with feedback if they are not satisfied with the result, which you can use to make improvements and try again. IMPORTANT NOTE: This tool CANNOT be used until you've confirmed from the user that any previous tool uses were successful. Failure to do so will result in code corruption and system failure. Before using this tool, you must ask yourself in tags if you've confirmed from the user that any previous tool uses were successful. If not, then DO NOT use this tool. If you were using task_progress to update the task progress, you must include the completed list in the result as well.",
-    params: {
-      result: "(required) The result of the tool use. This should be a clear, specific description of the result.",
-    },
-    example: `## Example: ${AgentDefaultTool.ATTEMPT}
-<${AgentDefaultTool.ATTEMPT}>
-<result>final result or message</result>
-<task_progress>
-- [x] Set up project structure
-- [x] Install dependencies
-- [x] Run command to start server
-- [x] Test application
-</task_progress>
-</${AgentDefaultTool.ATTEMPT}>`,
-  },
-  {
-    name: AgentDefaultTool.BASH,
-    description: "Request to execute a CLI command on the system. Use this when you need to perform system operations or run specific commands to accomplish any step in the user's task. You must tailor your command to the user's system and provide a clear explanation of what the command does. For command chaining, use the appropriate chaining syntax for the user's shell. Prefer to execute complex CLI commands over creating executable scripts, as they are more flexible and easier to run. Commands will be executed in the current working directory: ${context.cwd} Use @workspace:path syntax (e.g., @frontend:src/index.ts) to specify a workspace.",
-    params: {
-      command: "(required) The CLI command to execute. This should be valid for the current operating system. Ensure the command is properly formatted and does not contain any harmful instructions.",
-    },
-    example: `## Example: Requesting to execute a command
-
-<${AgentDefaultTool.BASH}>
-<command>npm run dev</command>
-<requires_approval>false</requires_approval>
-<task_progress>
-- [x] Set up project structure
-- [x] Install dependencies
-- [ ] Run command to start server
-- [ ] Test application
-</task_progress>
-</${AgentDefaultTool.BASH}>`,
-  },
-  {
-    name: AgentDefaultTool.FILE_EDIT,
-    description: "Replace specific content in a file using a search/replace diff block.",
-    params: {
-      path: "(required) The absolute or relative file path to modify.",
-      diff: "(required) The diff content to apply.",
-    },
-    example: `## Example: Requesting to make targeted edits to a file
-
-<${AgentDefaultTool.FILE_EDIT}>
-<path>src/components/App.tsx</path>
-<diff>
-------- SEARCH
-import React from 'react';
-=======
-import React, { useState } from 'react';
-+++++++ REPLACE
-
-------- SEARCH
-function handleSubmit() {
-  saveData();
-  setLoading(false);
-}
-
-=======
-+++++++ REPLACE
-
-------- SEARCH
-return (
-  <div>
-=======
-function handleSubmit() {
-  saveData();
-  setLoading(false);
-}
-
-return (
-  <div>
-+++++++ REPLACE
-</diff>
-<task_progress>
-- [x] Set up project structure
-- [x] Install dependencies
-- [ ] Create components
-- [ ] Test application
-</task_progress>
-</${AgentDefaultTool.FILE_EDIT}>`,
-  },
-  {
-    name: AgentDefaultTool.FILE_READ,
-    description: "Read the contents of a specific file.",
-    params: {
-      path: "(required) The absolute or relative file path to read.",
-    },
-  },
-  {
-    name: AgentDefaultTool.FILE_NEW,
-    description: "Create or overwrite a file with new content.",
-    params: {
-      path: "(required) The path of the file to write to (relative to the current working directory ${context.cwd}) Use @workspace:path syntax (e.g., @frontend:src/index.ts) to specify a workspace.",
-      content: "(required) The content to write to the file.",
-    },
-    example: `## Example: Requesting to create a new file
-
-<${AgentDefaultTool.FILE_NEW}>
-<path>src/frontend-config.json</path>
-<content>
-{
-  "apiEndpoint": "https://api.example.com",
-  "theme": {
-    "primaryColor": "#007bff",
-    "secondaryColor": "#6c757d",
-    "fontFamily": "Arial, sans-serif"
-  },
-  "features": {
-    "darkMode": true,
-    "notifications": true,
-    "analytics": false
-  },
-  "version": "1.0.0"
-}
-</content>
-<task_progress>
-- [x] Set up project structure
-- [x] Install dependencies
-- [x] Create components
-- [ ] Test application
-</task_progress>
-</${AgentDefaultTool.FILE_NEW}>`
-  },
-  {
-    name: AgentDefaultTool.FILE_DELETE,
-    description: "Delete a file.",
-    params: {
-      path: "(required) The path of the file to delete to (relative to the current working directory ${context.cwd}) Use @workspace:path syntax (e.g., @frontend:src/index.ts) to specify a workspace.",
-    },
-  },
-  {
-    name: AgentDefaultTool.DIR_DELETE,
-    description: "Delete a directory.",
-    params: {
-      path: "(required) The path of the directory to delete to (relative to the current working directory ${context.cwd}) Use @workspace:path syntax (e.g., @frontend:src/index.ts) to specify a workspace.",
-    },
-  },
-  {
-    name: AgentDefaultTool.SEARCH,
-    description: "Search for files in a directory that match a regex pattern or glob pattern.",
-    params: {
-      path: "(required) The absolute or relative directory path to search.",
-      regex: "(required) The regex pattern to match files against.",
-      file_pattern: "(optional) glob pattern like *.ts.",
-    },
-  },
-  {
-    name: AgentDefaultTool.LIST_FILES,
-    description: "List all files in a directory.",
-    params: {
-      path: "(required) The absolute or relative directory path to list.",
-    },
-  },
-  //================
-  {
-    name: AgentDefaultTool.NEW_TASK,
-    description: "Create a new task with a given context.",
-    params: {
-      context: "(required) The context of the new task.",
-    },
-    example: `## Example: Creating a new task
-<${AgentDefaultTool.NEW_TASK}>
-<context>
-1. Current Work:
-   [Detailed description]
-
-2. Key Technical Concepts:
-   - [Concept 1]
-   - [Concept 2]
-   - [...]
-
-3. Relevant Files and Code:
-   - [File Name 1]
-      - [Summary of why this file is important]
-      - [Summary of the changes made to this file, if any]
-      - [Important Code Snippet]
-   - [File Name 2]
-      - [Important Code Snippet]
-   - [...]
-
-4. Problem Solving:
-   [Detailed description]
-
-5. Pending Tasks and Next Steps:
-   - [Task 1 details & next steps]
-   - [Task 2 details & next steps]
-   - [...]
-</context>
-</${AgentDefaultTool.NEW_TASK}>`,
-  },
-  {
-    name: AgentDefaultTool.LOAD_SKILL,
-    description: "Load a skill to perform a task. important: skill_name is required. must use this tool to load the skill; do not use any other method to read it.",
-    params: {
-      skill_name: "(required) The name of the skill to load.",
-    },
-  },
-] as const; 
-
-export const toolUseNames = Object.values(AgentDefaultTool) as AgentDefaultTool[];
-
-const dynamicToolUseNamesByNamespace = new Map<string, Set<string>>();
-
-export function setDynamicToolUseNames(namespace: string, names: string[]): void {
-  dynamicToolUseNamesByNamespace.set(namespace, new Set(names.map((name) => name.trim()).filter(Boolean)));
-}
-
-export function getToolUseNames(): string[] {
-  const defaults = [...toolUseNames];
-  const dynamic = Array.from(dynamicToolUseNamesByNamespace.values()).flatMap((set) => Array.from(set));
-  return Array.from(new Set([...defaults, ...dynamic]));
-}
-
-export const READ_ONLY_TOOLS = [
-  AgentDefaultTool.LIST_FILES,
-  AgentDefaultTool.FILE_READ,
-  AgentDefaultTool.SEARCH,
-  AgentDefaultTool.LIST_CODE_DEF,
-  AgentDefaultTool.BROWSER,
-  AgentDefaultTool.ASK,
-  AgentDefaultTool.WEB_SEARCH,
-  AgentDefaultTool.WEB_FETCH,
-  AgentDefaultTool.LOAD_SKILL,
-  AgentDefaultTool.USE_SUBAGENTS,
-] as const;

package/test-node-agent.ts

@@ -1,113 +0,0 @@
-import { createNodeAgent, AgentDefaultTool } from "./src/runtime/nodeRuntime";
-import {webSearch} from './webSearch';
-import {webFetch} from './webFetch';
-
-async function main() {
-  console.log("Initializing Node Agent...");
-
-  // 请注意：在实际运行中，需要将 apiKey 替换为真实可用的密钥，
-  // 或在运行命令时通过环境变量传入，例如: OPENAI_API_KEY="sk-xxx" tsx test-node-agent.ts
-  // const apiKey = process.env.OPENAI_API_KEY || "YOUR_API_KEY_HERE";
-  
-  // 初始化 Agent
-  const agent = createNodeAgent({
-    apiConfig: {
-      providerId: "dify",
-      modelId: "115a5bb0-4a9c-409e-8652-26898ee00aa0", // 这里替换为你实际使用的模型
-      apiKey: 'app-oPDCCXHA2lxKZOqn38WlqjOp',
-      baseURL: 'http://api.aiagentv1.mama.cn/v1', // 如果有代理地址可以在此设置
-      headers: {
-        ['user-id']: 'agent-user'
-      }
-    },
-    allowDefaultTools: [
-      AgentDefaultTool.ATTEMPT,
-      AgentDefaultTool.BASH,
-      AgentDefaultTool.FILE_EDIT, 
-      AgentDefaultTool.FILE_READ,
-      AgentDefaultTool.FILE_NEW, 
-      AgentDefaultTool.SEARCH,
-      AgentDefaultTool.LIST_FILES,
-      AgentDefaultTool.NEW_TASK,
-      AgentDefaultTool.LOAD_SKILL, 
-    ],
-    customInstructions: "你是一个专业的内容策划与创作引擎，服务于自媒体从业者。你的目标是帮助用户将一个主题或素材转化为适配特定平台、能够打动读者的完整内容。",
-    customTools: [
-      {
-        name: 'web_search',
-        description: 'useful when you want to search the web',
-        params: {
-          // 搜索查询，查询关键词，小于 15 个字符
-          query: '(required) search query to use web search tool, less than 15 characters',
-        },
-        onCall: async (params: any) => {
-          try {
-            const res = await webSearch(params.query);
-            return JSON.stringify(res);
-          } catch (error: any) {
-            return `Error searching the web: ${error.message}`;
-          }
-        },
-      },
-      {
-        name: 'web_fetch',
-        // 从指定 URL 获取网页内容
-        description: 'useful when you want to fetch the content of a web page',
-        params: {
-          url: '(required) url to fetch the content of',
-        },
-        onCall: async (params: any) => {
-          try {
-            const res = await webFetch(params.url);
-            return JSON.stringify(res);
-          } catch (error: any) {
-            return `Error fetching the web page: ${error.message}`;
-          }
-        },
-      },
-      {
-        name: "article_write",
-        description: "Write an article based on the given content.",
-        params: {
-          content: '(required) string, the article content to write.',
-        },
-        onCall: (params: any) => {
-          console.log(`Custom tool "article_write" called with params: ${JSON.stringify(params)}`);
-          return `Success!`;
-        }
-      },
-    ]
-  });
-
-  // 监听状态变化
-  agent.onStateChange = (state) => {
-    console.log(`\n[Agent State]: ${state}`);
-  };
-
-  // 监听流式输出
-  process.stdout.write("[Agent]: ");
-  agent.onStreamChunk = (chunk) => {
-    if (chunk.type === "text" && chunk.text) {
-      process.stdout.write(chunk.text);
-    } else if (chunk.type === "usage") {
-      console.log(`\n[Usage]: Input: ${chunk.usage?.inputTokens}, Output: ${chunk.usage?.outputTokens}`);
-    } else if (chunk.type === "error") {
-      console.error(`\n[Error]: ${chunk.error?.message}`);
-    }
-  };
-
-  // 定义一个简单的测试任务
-  const task = "web_search 搜索分析后，web_fetch 获取到详细内容后，写一篇腾讯2026中报的主要内容，1000字左右的文章，写到 test.md 文件中";
-  
-  console.log(`\n[Task]: ${task}\n`);
-  
-  try {
-    // 启动任务
-    await agent.startTask(task);
-    console.log("\nTask completed successfully!");
-  } catch (error) {
-    console.error("\nTask failed with error:", error);
-  }
-}
-
-main().catch(console.error);

package/test-runtime.mjs

@@ -1,36 +0,0 @@
-import { NodeRuntime } from './dist/runtime/node.mjs';
-import { WebRuntime } from './dist/runtime/web.mjs';
-import { NodePromptManager, WebPromptManager } from './dist/index.mjs';
-
-async function run() {
-  console.log("=== Testing NodeRuntime & Prompt ===");
-  const nodeRuntime = new NodeRuntime();
-  const nodeCwd = nodeRuntime.env.cwd();
-  console.log("Node CWD:", nodeCwd);
-  const result = await nodeRuntime.terminal.execCommand("echo hello node");
-  console.log("Node Exec:", result.stdout.trim());
-
-  const nodePrompt = new NodePromptManager("Always output JSON.");
-  const nodeSystemPrompt = await nodePrompt.getSystemPrompt({ cwd: nodeCwd, os: nodeRuntime.env.osInfo() });
-  console.log("Node Prompt:\n", nodeSystemPrompt.substring(0, 150) + "...\n");
-
-  console.log("\n=== Testing WebRuntime & Prompt ===");
-  const webRuntime = new WebRuntime();
-  const webCwd = webRuntime.env.cwd();
-  console.log("Web CWD:", webCwd);
-  
-  await webRuntime.fs.writeFile("/workspace/test.txt", "hello web");
-  const exists = await webRuntime.fs.fileExists("/workspace/test.txt");
-  console.log("Web File Exists:", exists);
-  const content = await webRuntime.fs.readFile("/workspace/test.txt");
-  console.log("Web File Content:", content);
-  
-  const webExec = await webRuntime.terminal.execCommand("echo hello");
-  console.log("Web Exec:", webExec.stdout.trim());
-
-  const webPrompt = new WebPromptManager();
-  const webSystemPrompt = await webPrompt.getSystemPrompt({ cwd: webCwd, os: webRuntime.env.osInfo() });
-  console.log("Web Prompt:\n", webSystemPrompt.substring(0, 150) + "...\n");
-}
-
-run().catch(console.error);

package/test.md

@@ -1,33 +0,0 @@
-# 腾讯2026中报解读：营收净利双增10%，自由现金流为何罕见转负？
-
-8月12日，腾讯控股发布了2026年半年度业绩报告。这份中报既延续了稳健增长的底色，也透露出一个强烈的信号——腾讯正在经历一场由AI驱动的战略重构。
-
-## 一、基本面：稳步增长的"基本盘"
-
-先看核心财务数据。2026年上半年，腾讯实现营收4012.43亿元，同比增长10%；净利润1141.15亿元，同样增长10%。分季度看，第二季度营收2048亿元，同比增长11%；Non-IFRS经营盈利756亿元，同比增长9%；Non-IFRS归母净利润684亿元，同比增长9%。
-
-盈利能力持续改善。二季度毛利同比增长13%至1184亿元，毛利率由去年同期的57%提升至58%。增值服务、营销服务、金融科技及企业服务三大板块毛利率全线站稳高位，分别达64%、57%和52%。
-
-## 二、业务板块：游戏与广告双引擎发力
-
-游戏业务表现尤为亮眼。二季度本土市场游戏收入473亿元，同比增长17%，《三角洲行动》《无畏契约》《洛克王国：世界》等多款产品贡献显著。国际市场游戏收入186亿元，按固定汇率计算同比增长4%。增值服务整体收入984亿元，同比增长8%。
-
-营销服务是本季度最大亮点，收入同比增长22%至436亿元。这得益于AI驱动的广告推荐模型持续优化，以及微信生态闭环营销能力的整合。金融科技及企业服务收入603亿元，同比增长9%，其中云服务受AI相关需求上升和国际市场拓展推动，增长势头良好。
-
-## 三、AI战略：马化腾的"三个层面"
-
-马化腾在业绩报告中罕见地用较长篇幅阐述了AI战略：**"我们正在智能、应用与基础设施三个层面，构建一个全新的、AI赋能的腾讯。"**
-
-智能层面，混元Hy3正式版发布，在智能体、代码、复杂推理等能力上大幅提升，token消耗量稳居全球前三。应用层面，AI办公助手WorkBuddy PC端6月访问量突破2000万，位居国内同类产品第一；AI编程工具CodeBuddy同样实现突破性增长。基础设施层面，腾讯大幅增加算力采购，为AI商业化铺设硬件底座。
-
-## 四、争议焦点：自由现金流为何-138亿？
-
-这份财报最受市场关注的一个数字，是**二季度自由现金流为-138亿元**。这是腾讯上市22年来首次出现单季自由现金流转负，对一家以"现金流充沛、高额回购分红"著称的巨头而言，冲击不小。
-
-原因清晰：二季度资本开支高达528亿元，同比增长176%，主要用于AI算力基础设施采购；同时叠加2025年度股息支付416亿元。不过，若剔除算力采购预付等一次性因素，自由现金流实际为正的376亿元。研发投入同比增长35%至273亿元，也印证了腾讯"重投入、慢回报"的AI转型决心。
-
-## 五、结语：从"连接一切"到"智能驱动一切"
-
-腾讯2026年中报传递出的信号很明确：短期利润增长放缓（二季度归母净利仅增0.7%），是主动为AI战略让路的结果。当WorkBuddy已在50多个行业落地、Hy3调用量跻身全球前三、资本开支同比近乎翻两倍时，腾讯正从一家互联网平台公司，加速进化为AI基础设施与智能应用生态的核心玩家。这份中报，或许正是腾讯"AI再造"的起点。
-
-*（数据来源：腾讯控股2026年半年度业绩公告及相关新闻稿件）*

package/tsconfig.json

@@ -1,28 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
-    "strict": true,
-    "skipLibCheck": true,
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true,
-    "forceConsistentCasingInFileNames": true,
-    "isolatedModules": true,
-    "declaration": true,
-    "declarationMap": true,
-    "outDir": "dist",
-    "resolveJsonModule": true,
-    "baseUrl": ".",
-    "paths": {
-      "@/*": ["src/*"],
-      "@utils/*": ["src/utils/*"],
-      "@shared/*": ["src/shared/*"],
-      "@core/*": ["src/core/*"],
-      "@services/*": ["src/services/*"]
-    }
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}

package/tsup.config.ts

@@ -1,21 +0,0 @@
-import { defineConfig } from 'tsup';
-
-export default defineConfig({
-  entry: [
-    'src/index.ts',
-    'src/runtime/node.ts',
-    'src/runtime/web.ts'
-  ],
-  format: ['cjs', 'esm'],
-  dts: true,
-  splitting: false,
-  sourcemap: true,
-  clean: true,
-  treeshake: true,
-  minify: false,
-  outExtension({ format }) {
-    return {
-      js: format === 'cjs' ? '.js' : '.mjs',
-    };
-  },
-});

package/uapi.ts

@@ -1,3 +0,0 @@
-import { UapiClient } from 'uapi-sdk-typescript'
-
-export const uapiClient = new UapiClient('https://uapis.cn', process.env.UAPI_KEY)

package/webFetch.ts

@@ -1,49 +0,0 @@
-import { uapiClient } from './uapi';
-
-// export async function webFetch(url: string) {
-//   return fetch('https://cloud-iqs.aliyuncs.com/readpage/basic', {
-//     method: 'POST',
-//     headers: {
-//       'Content-Type': 'application/json',
-//       'Authorization': 'Bearer ' + process.env.IQS_SEARCH_KEY,
-//     },
-//     body: JSON.stringify({
-//       url,
-//       "maxAge":0,"formats":["html","markdown","text"]
-//     }),
-//   })
-// }
-
-export async function webFetch(url: string) {
-  let resolve: any, reject: any;
-  const promise = new Promise((resol, reje) => {
-    resolve = resol
-    reject = reje
-  });
-  try {
-    const res = await uapiClient.webparse.postWebTomarkdownAsync({url});
-    let setTimeoutTimer: any;
-    const checkStatus = async (taskId: string) => {
-      const checkRes = await uapiClient.webparse.getWebTomarkdownAsyncStatus({taskId: res.task_id!, task_id: res.task_id!});
-      if (checkRes.status === 'pending' || checkRes.status === 'queued' || checkRes.status === 'running') {
-        setTimeoutTimer = setTimeout(() => {
-          checkStatus(taskId);
-        }, 1000);
-      } else if (checkRes.status === 'completed' && checkRes.result) {
-        resolve(checkRes.result);
-      } else {
-        reject(new Error('fetch Error'));
-      }
-    }
-
-    if (res.task_id) {
-      await checkStatus(res.task_id);
-    } else {
-      reject(new Error('fetch Error'));
-    }
-  } catch (error) {
-    reject(error);
-  }
-
-  return promise;
-}

package/webSearch.ts

@@ -1,19 +0,0 @@
-import { uapiClient } from './uapi';
-
-// export async function webSearch(query: string) {
-//   return fetch('https://cloud-iqs.aliyuncs.com/search/unified', {
-//     method: 'POST',
-//     headers: {
-//       'Content-Type': 'application/json',
-//       'Authorization': 'Bearer ' + process.env.IQS_SEARCH_KEY,
-//     },
-//     body: JSON.stringify({
-//       query,
-//       "engineType": "Generic", "numResults": 20, "contents": { "mainText": false, "markdownText": false, "richMainBody": false, "summary": true, "rerankScore": true }
-//     }),
-//   })
-// }
-
-export async function webSearch(query: string, site?: string, sort?: string) {
-  return uapiClient.zhiNengSouSuo.postSearchAggregate({query, site, sort});
-}