deepspider 0.2.11 → 0.3.0

package/src/agent/errors/ErrorClassifier.js

@@ -0,0 +1,43 @@
+/**
+ * DeepSpider - 错误分类器
+ * 判断错误类型，决定重试策略
+ */
+
+/**
+ * 判断是否为工具参数错误（需要 LLM 修正）
+ */
+export function isToolSchemaError(errMsg) {
+  return /did not match expected schema|Invalid input|tool input/i.test(errMsg);
+}
+
+/**
+ * 判断是否为 API 服务错误（可直接重试）
+ */
+export function isApiServiceError(errMsg) {
+  return /503|502|429|rate limit|无可用渠道|timeout|ECONNRESET|ETIMEDOUT/i.test(errMsg);
+}
+
+/**
+ * 判断是否为浏览器错误
+ */
+export function isBrowserError(errMsg) {
+  return /Target closed|page closed|context closed|browser disconnected/i.test(errMsg);
+}
+
+/**
+ * 判断是否为网络错误
+ */
+export function isNetworkError(errMsg) {
+  return /ENOTFOUND|ECONNREFUSED|network|fetch failed/i.test(errMsg);
+}
+
+/**
+ * 获取错误类型
+ */
+export function classifyError(errMsg) {
+  if (isToolSchemaError(errMsg)) return 'tool_schema';
+  if (isApiServiceError(errMsg)) return 'api_service';
+  if (isBrowserError(errMsg)) return 'browser';
+  if (isNetworkError(errMsg)) return 'network';
+  return 'unknown';
+}

package/src/agent/errors/SpiderError.js

@@ -0,0 +1,68 @@
+/**
+ * DeepSpider - 结构化错误类型
+ */
+
+/**
+ * 基础错误类
+ */
+export class SpiderError extends Error {
+  constructor(message, code, details = {}) {
+    super(message);
+    this.name = 'SpiderError';
+    this.code = code;
+    this.details = details;
+  }
+
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      details: this.details,
+    };
+  }
+}
+
+/**
+ * API 服务错误 - 503/502/429 等
+ */
+export class ApiServiceError extends SpiderError {
+  constructor(message, details = {}) {
+    super(message, 'API_SERVICE_ERROR', details);
+    this.name = 'ApiServiceError';
+    this.retryable = true;
+  }
+}
+
+/**
+ * 工具参数错误 - 工具调用参数不匹配
+ */
+export class ToolSchemaError extends SpiderError {
+  constructor(message, details = {}) {
+    super(message, 'TOOL_SCHEMA_ERROR', details);
+    this.name = 'ToolSchemaError';
+    this.retryable = true;
+  }
+}
+
+/**
+ * 浏览器错误 - 页面关闭、上下文丢失等
+ */
+export class BrowserError extends SpiderError {
+  constructor(message, details = {}) {
+    super(message, 'BROWSER_ERROR', details);
+    this.name = 'BrowserError';
+    this.retryable = false;
+  }
+}
+
+/**
+ * 网络错误 - 连接失败、DNS 解析等
+ */
+export class NetworkError extends SpiderError {
+  constructor(message, details = {}) {
+    super(message, 'NETWORK_ERROR', details);
+    this.name = 'NetworkError';
+    this.retryable = true;
+  }
+}

package/src/agent/errors/index.js

@@ -0,0 +1,19 @@
+/**
+ * DeepSpider - Errors 模块索引
+ */
+
+export {
+  isToolSchemaError,
+  isApiServiceError,
+  isBrowserError,
+  isNetworkError,
+  classifyError,
+} from './ErrorClassifier.js';
+
+export {
+  SpiderError,
+  ApiServiceError,
+  ToolSchemaError,
+  BrowserError,
+  NetworkError,
+} from './SpiderError.js';