@ai-setting/roy-agent-core 1.5.15-test → 1.5.16-test

package/dist/env/task/tools/operation/index.js

@@ -0,0 +1,15 @@
+import {
+  createOperationTool,
+  deleteOperationTool,
+  getOperationTool,
+  listOperationsTool,
+  updateOperationTool
+} from "../../../../shared/@ai-setting/roy-agent-core-t94ktchq.js";
+import"../../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
+export {
+  updateOperationTool,
+  listOperationsTool,
+  getOperationTool,
+  deleteOperationTool,
+  createOperationTool
+};

package/dist/env/tool/built-in/index.d.ts

@@ -0,0 +1,218 @@
+import { z, ZodType, ZodError } from "zod";
+/**
+* 沙箱配置
+*/
+interface SandboxConfig {
+	/** 是否启用沙箱 */
+	enabled: boolean;
+	/** 沙箱类型 */
+	type: "native" | "docker";
+	/** 动作过滤 */
+	actionFilter?: {
+		/** 包含的动作 */
+		include?: string[];
+		/** 排除的动作 */
+		exclude?: string[];
+	};
+	/** 文件系统限制 */
+	filesystem?: {
+		/** 允许读取 */
+		allowRead?: string[];
+		/** 禁止读取 */
+		denyRead?: string[];
+		/** 允许写入 */
+		allowWrite?: string[];
+		/** 禁止写入 */
+		denyWrite?: string[];
+	};
+	/** 网络限制 */
+	network?: {
+		/** 允许的域名 */
+		allowedDomains?: string[];
+		/** 禁止的域名 */
+		deniedDomains?: string[];
+	};
+	/** Docker 配置 */
+	docker?: {
+		/** 镜像 */
+		image?: string;
+		/** 网络模式 */
+		networkMode?: "bridge" | "host" | "none";
+		/** 卷挂载 */
+		volumes?: Record<string, string>;
+	};
+}
+/**
+* 工具执行上下文
+*/
+interface ToolContext {
+	/** 工作目录 */
+	workdir?: string;
+	/** 用户 ID */
+	user_id?: string;
+	/** 会话 ID */
+	session_id?: string;
+	/** 消息 ID */
+	message_id?: string;
+	/** 中断信号 */
+	abort?: AbortSignal;
+	/** 额外元数据 */
+	metadata?: Record<string, unknown>;
+	/** 沙箱配置 */
+	sandbox?: SandboxConfig;
+	/** 沙箱 Provider */
+	sandboxProvider?: unknown | null;
+}
+/**
+* 工具结果元数据
+*/
+interface ToolResultMetadata {
+	/** 执行时间（毫秒） */
+	execution_time_ms: number;
+	/** 输出大小（字节） */
+	output_size?: number;
+	/** 标准输出 */
+	stdout?: string;
+	/** 标准错误 */
+	stderr?: string;
+	/** 退出码 */
+	exit_code?: number;
+	/** Token 使用量 */
+	usage?: {
+		inputTokens: number;
+		outputTokens: number;
+		totalTokens?: number;
+	};
+	/** 额外元数据 */
+	[key: string]: unknown;
+}
+/**
+* 工具执行结果
+*/
+interface ToolResult {
+	/** 是否成功 */
+	success: boolean;
+	/** 输出内容 */
+	output: string | Record<string, unknown>;
+	/** 错误信息 */
+	error?: string;
+	/** 结果元数据 */
+	metadata?: ToolResultMetadata;
+}
+/**
+* 工具元数据
+*/
+interface ToolMetadata {
+	/** 分类 */
+	category?: string;
+	/** 标签 */
+	tags?: string[];
+	/** 版本 */
+	version?: string;
+	/** 作者 */
+	author?: string;
+	/** 是否实验性 */
+	experimental?: boolean;
+	/** MCP 工具信息（MCP adapter 使用） */
+	mcpTool?: {
+		originalName: string;
+		originalDescription: string;
+		inputSchema?: unknown;
+	};
+}
+/**
+* 工具沙箱配置
+*/
+interface ToolSandboxConfig {
+	/** 是否启用沙箱 */
+	enabled: boolean;
+	/** 沙箱配置 */
+	config?: Partial<SandboxConfig>;
+}
+/**
+* 工具权限配置
+*/
+interface ToolPermissionConfig {
+	/** 是否需要用户确认 */
+	requireConfirmation?: boolean;
+	/** 权限级别 */
+	level?: "safe" | "dangerous" | "critical";
+}
+/**
+* 工具信息
+*/
+interface ToolInfo<Parameters extends ZodType = ZodType> {
+	/** 工具名称 */
+	name: string;
+	/** 工具描述 */
+	description: string;
+	/** 参数 Schema */
+	parameters: Parameters;
+	/** 初始化函数（可选） */
+	init?: (ctx?: ToolContext) => Promise<void>;
+	/** 执行函数 */
+	execute: (args: z.infer<Parameters>, ctx: ToolContext) => Promise<ToolResult>;
+	/** 参数验证错误格式化（可选） */
+	formatValidationError?: (error: ZodError) => string;
+	/** 沙箱配置 */
+	sandbox?: ToolSandboxConfig;
+	/** 权限配置 */
+	permission?: ToolPermissionConfig;
+	/** 工具元数据 */
+	metadata?: ToolMetadata;
+}
+/**
+* 工具类型别名
+*/
+type Tool = ToolInfo;
+/**
+* Bash 工具
+* 执行 shell 命令
+* 
+* 支持 OpenTelemetry W3C TraceContext 跨进程追踪：
+* - 通过 TRACEPARENT 环境变量传递 traceId 和 parentSpanId
+* - 子进程可以正确关联到父 trace
+*/
+declare const bashTool: Tool;
+/**
+* Echo tool - simple echo command
+* 
+* This is a convenience tool for logging messages in workflows.
+*/
+declare const echoTool: Tool;
+/**
+* Glob 工具
+* 文件模式匹配搜索
+*/
+declare const globTool: Tool;
+/**
+* 读取文件工具
+*/
+declare const readFileTool: Tool;
+/**
+* 写入文件工具
+*/
+declare const writeFileTool: Tool;
+/**
+* 编辑文件工具
+* 通过 oldString/newString 替换来编辑文件
+*/
+declare const editFileTool: Tool;
+/**
+* Grep 工具
+* 在文件中搜索内容
+*/
+declare const grepTool: Tool;
+/**
+* 获取所有内置工具
+* 
+* Note: run-workflow tool is not included here because it requires
+* a WorkflowService instance which needs to be initialized at runtime.
+* Use initRunWorkflowTool(workflowService) to initialize it.
+*/
+declare function getAllBuiltInTools(): Tool[];
+/**
+* 获取指定内置工具
+*/
+declare function getBuiltInTool(name: string): Tool | undefined;
+export { writeFileTool, readFileTool, grepTool, globTool, getBuiltInTool, getAllBuiltInTools, editFileTool, echoTool, bashTool };

package/dist/env/tool/built-in/index.js

@@ -0,0 +1,25 @@
+import {
+  bashTool,
+  echoTool,
+  editFileTool,
+  getAllBuiltInTools,
+  getBuiltInTool,
+  globTool,
+  grepTool,
+  readFileTool,
+  writeFileTool
+} from "../../../shared/@ai-setting/roy-agent-core-satmq6sh.js";
+import"../../../shared/@ai-setting/roy-agent-core-xs5rsgat.js";
+import"../../../shared/@ai-setting/roy-agent-core-psv4v63c.js";
+import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
+export {
+  writeFileTool,
+  readFileTool,
+  grepTool,
+  globTool,
+  getBuiltInTool,
+  getAllBuiltInTools,
+  editFileTool,
+  echoTool,
+  bashTool
+};