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

package/dist/env/workflow/tools/index.d.ts

@@ -1,416 +0,0 @@
-import { z as z5 } from "zod";
-import { z as z4 } from "zod";
-import { z as z2, 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 ToolResult2 {
-	/** 是否成功 */
-	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: z2.infer<Parameters>, ctx: ToolContext) => Promise<ToolResult2>;
-	/** 参数验证错误格式化（可选） */
-	formatValidationError?: (error: ZodError) => string;
-	/** 沙箱配置 */
-	sandbox?: ToolSandboxConfig;
-	/** 权限配置 */
-	permission?: ToolPermissionConfig;
-	/** 工具元数据 */
-	metadata?: ToolMetadata;
-}
-/**
-* 工具类型别名
-*/
-type Tool = ToolInfo;
-declare const RunStatusSchema: unknown;
-type RunStatus = z4.infer<typeof RunStatusSchema>;
-interface RunOptions {
-	input?: Record<string, any>;
-	debug?: boolean;
-	parallelLimit?: number | null;
-	timeout?: number | null;
-	/** @deprecated No-op: workflow always waits for completion */
-	sync?: boolean;
-}
-interface RunResult {
-	runId: string;
-	/** Session ID (workflow_{runId} format) - useful for CLI resume */
-	sessionId?: string;
-	status: RunStatus;
-	output?: Record<string, any>;
-	error?: string;
-	durationMs?: number;
-	/** Pending node ID (when status is 'paused') */
-	pendingNodeId?: string;
-	/** Query from ask_user (when status is 'paused') */
-	query?: string;
-	/** Agent sub-session ID (for resuming agent nodes) */
-	agentSessionId?: string;
-}
-declare const NodeDefinitionSchema: unknown;
-type NodeDefinition = z5.infer<typeof NodeDefinitionSchema>;
-declare const WorkflowConfigSchema: unknown;
-type WorkflowConfig = z5.infer<typeof WorkflowConfigSchema>;
-declare const WorkflowMetadataSchema: unknown;
-type WorkflowMetadata = z5.infer<typeof WorkflowMetadataSchema>;
-declare const WorkflowDefinitionSchema: unknown;
-type WorkflowDefinition = z5.infer<typeof WorkflowDefinitionSchema>;
-interface Workflow {
-	id: string;
-	name: string;
-	version: string;
-	description?: string;
-	definition: WorkflowDefinition;
-	config: WorkflowConfig;
-	metadata: WorkflowMetadata;
-	tags: string[];
-	createdAt: Date;
-	updatedAt: Date;
-}
-import { z as z7 } from "zod";
-interface WorkflowRepository {
-	create(workflow: Omit<Workflow, "id" | "createdAt" | "updatedAt">): Workflow;
-	getById(id: string): Workflow | null;
-	getByName(name: string): Workflow | null;
-	list(options?: ListOptions): Workflow[];
-	update(id: string, updates: Partial<Workflow>): Workflow | null;
-	delete(id: string): boolean;
-}
-interface CreateOptions {
-	tags?: string[];
-	metadata?: WorkflowMetadata;
-	taskId?: number;
-	force?: boolean;
-}
-interface ListOptions {
-	tag?: string;
-	taskId?: number;
-	search?: string;
-	limit?: number;
-	offset?: number;
-}
-interface WorkflowUpdates {
-	definition?: WorkflowDefinition;
-	config?: WorkflowConfig;
-	tags?: string[];
-	metadata?: WorkflowMetadata;
-}
-interface WorkflowEngine {
-	createSession(workflowId: string, options?: {
-		input?: Record<string, any>;
-		workflowName?: string;
-		workflowVersion?: string;
-	}): Promise<string>;
-	run(sessionId: string, options?: RunOptions): Promise<RunResult>;
-	runWorkflow(workflow: Workflow | WorkflowDefinition, options?: RunOptions): Promise<RunResult>;
-	stop(sessionId: string, reason?: string): Promise<void>;
-	addNode(sessionId: string, nodeDefinition: NodeDefinition): Promise<void>;
-	removeNode(sessionId: string, nodeId: string): Promise<void>;
-}
-type WorkflowEngineFactory = (workflow: Workflow, options?: RunOptions) => Pick<WorkflowEngine, "run" | "stop" | "runWorkflow">;
-interface SessionInfo {
-	id: string;
-	title: string;
-	metadata: WorkflowSessionMetadata3;
-	createdAt: Date;
-	updatedAt: Date;
-}
-interface WorkflowSessionMetadata3 {
-	type: "workflow";
-	runId?: string;
-	workflowId?: string;
-	workflowName: string;
-	workflowVersion?: string;
-	status: "running" | "paused" | "completed" | "failed";
-	input?: any;
-	rootNodeId?: string;
-	agentSessions?: AgentSessionRef3[];
-}
-interface AgentSessionRef3 {
-	nodeId: string;
-	sessionId: string;
-	status: "active" | "paused" | "completed";
-}
-declare class WorkflowService {
-	private workflowRepository;
-	private engineFactory;
-	private sessionComponent?;
-	constructor(workflowRepository: WorkflowRepository, engineFactory: WorkflowEngineFactory, sessionComponent?: {
-		create(options: {
-			id?: string;
-			title: string;
-			metadata: any;
-		}): Promise<{
-			id: string;
-		}>;
-		get(id: string): Promise<SessionInfo | null | undefined>;
-		list?(options?: {
-			limit?: number;
-			offset?: number;
-		}): Promise<SessionInfo[]>;
-		update(id: string, updates: {
-			metadata?: any;
-		}): Promise<boolean>;
-		addMessage(sessionId: string, message: any): Promise<string>;
-		getMessages(sessionId: string): Promise<any[]>;
-	} | undefined);
-	/**
-	* Create a new workflow from definition
-	*/
-	createWorkflow(definition: WorkflowDefinition, options?: CreateOptions): Promise<Workflow>;
-	/**
-	* Get workflow by id or name
-	*/
-	getWorkflow(idOrName: string): Workflow | null;
-	/**
-	* Get workflow by id
-	*/
-	getWorkflowById(id: string): Workflow | null;
-	/**
-	* Get workflow by name
-	*/
-	getWorkflowByName(name: string): Workflow | null;
-	/**
-	* List workflows with optional filters
-	*/
-	listWorkflows(options?: ListOptions): Workflow[];
-	/**
-	* Update an existing workflow
-	*/
-	updateWorkflow(idOrName: string, updates: WorkflowUpdates, options?: {
-		tags?: string[];
-	}): Promise<Workflow>;
-	/**
-	* Delete a workflow by name or id
-	*/
-	deleteWorkflow(idOrName: string): Promise<boolean>;
-	/**
-	* Run a workflow by definition or name
-	* 
-	* This creates a Session that represents the workflow run.
-	* The Session ID is used as the run identifier for pause/resume.
-	*/
-	runWorkflow(idOrNameOrDefinition: string | WorkflowDefinition, input?: Record<string, any>, options?: RunOptions): Promise<RunResult>;
-	/**
-	* Run workflow by name (convenience method)
-	*/
-	runWorkflowByName(name: string, input?: Record<string, any>, options?: RunOptions): Promise<RunResult>;
-	/**
-	* Stop a running workflow session
-	*/
-	stopRun(sessionId: string, reason?: string): Promise<void>;
-	/**
-	* Get workflow session by ID
-	*/
-	getSession(sessionId: string): Promise<SessionInfo | null>;
-	/**
-	* List workflow sessions
-	*/
-	listSessions(options?: {
-		limit?: number;
-		offset?: number;
-	}): Promise<SessionInfo[]>;
-	/**
-	* Get messages from a workflow session
-	*/
-	getSessionMessages(sessionId: string): Promise<any[]>;
-}
-/**
-* Input schema for run-workflow tool
-*/
-declare const RunWorkflowInputSchema: unknown;
-type RunWorkflowInput = z7.infer<typeof RunWorkflowInputSchema>;
-/**
-* Run Workflow Tool interface for type-safe access
-*/
-interface RunWorkflowToolInterface {
-	name: "run-workflow";
-	description: string;
-	inputSchema: typeof RunWorkflowInputSchema;
-}
-/**
-* Create a run-workflow tool with the given WorkflowService
-* 
-* @param workflowService - The WorkflowService instance for executing workflows
-* @returns A Tool instance for running workflows
-*/
-declare function createRunWorkflowTool(workflowService: WorkflowService): Tool;
-/**
-* Initialize the run-workflow tool with a WorkflowService
-* 
-* @param workflowService - The WorkflowService instance
-*/
-declare function initRunWorkflowTool(workflowService: WorkflowService): void;
-/**
-* Get the run-workflow tool instance
-* 
-* @throws Error if the tool has not been initialized
-*/
-declare function getRunWorkflowTool(): Tool;
-/**
-* Reset the run-workflow tool (for testing)
-*/
-declare function resetRunWorkflowTool(): void;
-type RunWorkflowTool = ReturnType<typeof createRunWorkflowTool>;
-import { z as z8 } from "zod";
-/**
-* AskUserTool input schema
-*/
-declare const AskUserInputSchema: unknown;
-type AskUserInput = z8.infer<typeof AskUserInputSchema>;
-/**
-* AskUserTool
-* 
-* A special tool that can be called by Agent to request user input.
-* Calling this tool will throw AskUserError, which the Executor will
-* catch and convert to a workflow pause event.
-*/
-type AskUserTool = ToolInfo<typeof AskUserInputSchema>;
-declare const askUserTool: AskUserTool;
-declare const askUserToolInstance: unknown;
-export { resetRunWorkflowTool, initRunWorkflowTool, getRunWorkflowTool, createRunWorkflowTool, askUserToolInstance, askUserTool, RunWorkflowToolInterface, RunWorkflowTool, RunWorkflowInputSchema, RunWorkflowInput, AskUserTool, AskUserInputSchema, AskUserInput };