js-agent-core 1.0.1

package/src/interfaces/ITool.ts

@@ -0,0 +1,38 @@
+import { ZodSchema } from 'zod';
+
+export interface ToolResult<T = any> {
+  success: boolean;
+  data?: T;
+  error?: string;
+  metadata?: {
+    mimeType?: string;
+    cost?: number;
+    [key: string]: any;
+  };
+}
+
+export interface ITool<TParams = any, TResult = any> {
+  name: string;
+  description: string;
+  parameters: ZodSchema<TParams>;
+  /** 示例数据，帮助 LLM 更好地理解参数 */
+  examples?: TParams[];
+  /** 是否开启严格模式（针对 OpenAI Structured Outputs） */
+  strict?: boolean;
+  /** 工具分类，方便在 UI 或文档中展示 */
+  category?: 'filesystem' | 'web' | 'logic' | string;
+  /** 是否需要人工审批才能执行（人机协作机制） */
+  requiresApproval?: boolean;
+
+  /**
+   * 执行工具
+   * @param params 工具参数
+   * @param context 执行上下文
+   * @param onProgress 进度反馈回调
+   */
+  execute(
+    params: TParams, 
+    context?: any, 
+    onProgress?: (percent: number, message: string) => void
+  ): Promise<ToolResult<TResult>>;
+}

package/src/interfaces/index.ts

@@ -0,0 +1,10 @@
+export * from './ITool.js';
+export * from './ISkill.js';
+export * from './IAgentEvent.js';
+export * from './ILLMProvider.js';
+export * from './IMemory.js';
+export * from './IPlanner.js';
+export * from './IAgentState.js';
+export * from './ISkillStore.js';
+export * from './ILogger.js';
+