wide-cli 0.5.1611261552 → 0.6.191126

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (134) hide show
  1. package/data/osv-bundle.json +1 -0
  2. package/data/rules.json +1 -0
  3. package/dist/agent/index.d.ts +25 -3
  4. package/dist/agent/index.d.ts.map +1 -1
  5. package/dist/agent/index.js +117 -18
  6. package/dist/agent/index.js.map +1 -1
  7. package/dist/completion.js +5 -5
  8. package/dist/completion.js.map +1 -1
  9. package/dist/config/index.d.ts +4 -1
  10. package/dist/config/index.d.ts.map +1 -1
  11. package/dist/config/index.js +9 -2
  12. package/dist/config/index.js.map +1 -1
  13. package/dist/fix.d.ts +25 -0
  14. package/dist/fix.d.ts.map +1 -0
  15. package/dist/fix.js +197 -0
  16. package/dist/fix.js.map +1 -0
  17. package/dist/hook.d.ts +31 -0
  18. package/dist/hook.d.ts.map +1 -0
  19. package/dist/hook.js +152 -0
  20. package/dist/hook.js.map +1 -0
  21. package/dist/index.js +168 -5
  22. package/dist/index.js.map +1 -1
  23. package/dist/providers/antigravity.d.ts +46 -0
  24. package/dist/providers/antigravity.d.ts.map +1 -0
  25. package/dist/providers/antigravity.js +496 -0
  26. package/dist/providers/antigravity.js.map +1 -0
  27. package/dist/providers/claude-code.d.ts +60 -0
  28. package/dist/providers/claude-code.d.ts.map +1 -0
  29. package/dist/providers/claude-code.js +973 -0
  30. package/dist/providers/claude-code.js.map +1 -0
  31. package/dist/providers/codex.d.ts +52 -0
  32. package/dist/providers/codex.d.ts.map +1 -0
  33. package/dist/providers/codex.js +742 -0
  34. package/dist/providers/codex.js.map +1 -0
  35. package/dist/providers/index.d.ts.map +1 -1
  36. package/dist/providers/index.js +33 -1
  37. package/dist/providers/index.js.map +1 -1
  38. package/dist/repl/commands.d.ts.map +1 -1
  39. package/dist/repl/commands.js +53 -3
  40. package/dist/repl/commands.js.map +1 -1
  41. package/dist/repl/index.d.ts +3 -0
  42. package/dist/repl/index.d.ts.map +1 -1
  43. package/dist/repl/index.js +11 -6
  44. package/dist/repl/index.js.map +1 -1
  45. package/dist/repl/setup.d.ts.map +1 -1
  46. package/dist/repl/setup.js +16 -4
  47. package/dist/repl/setup.js.map +1 -1
  48. package/dist/security/crawler.d.ts +90 -0
  49. package/dist/security/crawler.d.ts.map +1 -0
  50. package/dist/security/crawler.js +622 -0
  51. package/dist/security/crawler.js.map +1 -0
  52. package/dist/security/fuzzer.d.ts +1 -0
  53. package/dist/security/fuzzer.d.ts.map +1 -1
  54. package/dist/security/fuzzer.js +25 -1
  55. package/dist/security/fuzzer.js.map +1 -1
  56. package/dist/security/inspect/evasion-decode.d.ts +41 -0
  57. package/dist/security/inspect/evasion-decode.d.ts.map +1 -0
  58. package/dist/security/inspect/evasion-decode.js +316 -0
  59. package/dist/security/inspect/evasion-decode.js.map +1 -0
  60. package/dist/security/inspect/http-conformance.d.ts +51 -0
  61. package/dist/security/inspect/http-conformance.d.ts.map +1 -0
  62. package/dist/security/inspect/http-conformance.js +389 -0
  63. package/dist/security/inspect/http-conformance.js.map +1 -0
  64. package/dist/security/inspect/lexical-sqli.d.ts +7 -0
  65. package/dist/security/inspect/lexical-sqli.d.ts.map +1 -0
  66. package/dist/security/inspect/lexical-sqli.js +986 -0
  67. package/dist/security/inspect/lexical-sqli.js.map +1 -0
  68. package/dist/security/inspect/lexical-xss.d.ts +10 -0
  69. package/dist/security/inspect/lexical-xss.d.ts.map +1 -0
  70. package/dist/security/inspect/lexical-xss.js +654 -0
  71. package/dist/security/inspect/lexical-xss.js.map +1 -0
  72. package/dist/security/inspect/libinjection-tables.d.ts +6 -0
  73. package/dist/security/inspect/libinjection-tables.d.ts.map +1 -0
  74. package/dist/security/inspect/libinjection-tables.js +6 -0
  75. package/dist/security/inspect/libinjection-tables.js.map +1 -0
  76. package/dist/security/inspect/safe-pattern.d.ts +62 -0
  77. package/dist/security/inspect/safe-pattern.d.ts.map +1 -0
  78. package/dist/security/inspect/safe-pattern.js +640 -0
  79. package/dist/security/inspect/safe-pattern.js.map +1 -0
  80. package/dist/security/inspect/score-policy.d.ts +82 -0
  81. package/dist/security/inspect/score-policy.d.ts.map +1 -0
  82. package/dist/security/inspect/score-policy.js +241 -0
  83. package/dist/security/inspect/score-policy.js.map +1 -0
  84. package/dist/security/inspect.d.ts +7 -0
  85. package/dist/security/inspect.d.ts.map +1 -0
  86. package/dist/security/inspect.js +7 -0
  87. package/dist/security/inspect.js.map +1 -0
  88. package/dist/security/loader.d.ts.map +1 -1
  89. package/dist/security/loader.js +30 -3
  90. package/dist/security/loader.js.map +1 -1
  91. package/dist/security/payloads.d.ts.map +1 -1
  92. package/dist/security/payloads.js +19 -0
  93. package/dist/security/payloads.js.map +1 -1
  94. package/dist/security/scanner.d.ts +2 -0
  95. package/dist/security/scanner.d.ts.map +1 -1
  96. package/dist/security/scanner.js +31 -26
  97. package/dist/security/scanner.js.map +1 -1
  98. package/dist/tools/article.d.ts +18 -0
  99. package/dist/tools/article.d.ts.map +1 -0
  100. package/dist/tools/article.js +193 -0
  101. package/dist/tools/article.js.map +1 -0
  102. package/dist/tools/browser.d.ts +8 -2
  103. package/dist/tools/browser.d.ts.map +1 -1
  104. package/dist/tools/browser.js +76 -10
  105. package/dist/tools/browser.js.map +1 -1
  106. package/dist/tools/docx.d.ts +11 -0
  107. package/dist/tools/docx.d.ts.map +1 -0
  108. package/dist/tools/docx.js +149 -0
  109. package/dist/tools/docx.js.map +1 -0
  110. package/dist/tools/fs.d.ts +2 -0
  111. package/dist/tools/fs.d.ts.map +1 -1
  112. package/dist/tools/fs.js +96 -7
  113. package/dist/tools/fs.js.map +1 -1
  114. package/dist/tools/http.d.ts.map +1 -1
  115. package/dist/tools/http.js +125 -48
  116. package/dist/tools/http.js.map +1 -1
  117. package/dist/tools/index.d.ts +21 -2
  118. package/dist/tools/index.d.ts.map +1 -1
  119. package/dist/tools/index.js +137 -14
  120. package/dist/tools/index.js.map +1 -1
  121. package/dist/tools/resilience.d.ts +78 -0
  122. package/dist/tools/resilience.d.ts.map +1 -0
  123. package/dist/tools/resilience.js +211 -0
  124. package/dist/tools/resilience.js.map +1 -0
  125. package/dist/tools/security.d.ts +2 -0
  126. package/dist/tools/security.d.ts.map +1 -1
  127. package/dist/tools/security.js +79 -1
  128. package/dist/tools/security.js.map +1 -1
  129. package/dist/tools/types.d.ts +4 -0
  130. package/dist/tools/types.d.ts.map +1 -1
  131. package/dist/ui/banner.d.ts.map +1 -1
  132. package/dist/ui/banner.js +2 -2
  133. package/dist/ui/banner.js.map +1 -1
  134. package/package.json +3 -1
@@ -1,13 +1,14 @@
1
- import { readFileTool, writeFileTool, editFileTool } from "./fs.js";
1
+ import { readFileTool, readDocumentTool, writeFileTool, editFileTool } from "./fs.js";
2
2
  import { listDirTool, searchFilesTool } from "./search.js";
3
3
  import { runCommandTool } from "./shell.js";
4
- import { securityScanTool, fuzzEndpointTool, generatePayloadsTool } from "./security.js";
4
+ import { securityScanTool, fuzzEndpointTool, generatePayloadsTool, crawlTargetTool, inspectHttpTool } from "./security.js";
5
5
  import { httpRequestTool } from "./http.js";
6
6
  import { gitTool } from "./git.js";
7
7
  import { dbAuditTool, dbExportTool, dbInspectSchemaTool, dbListTool, dbQueryTool } from "./db.js";
8
8
  import { browserOpenTool, browserNavigateTool, browserSnapshotTool, browserClickTool, browserTypeTool, browserPressTool, browserHoverTool, browserSelectTool, browserScrollTool, browserWaitTool, browserExtractTool, browserScreenshotTool, browserConsoleTool, browserCookiesTool, browserEvalTool, browserExportHarTool, browserCloseTool } from "./browser.js";
9
9
  export const ALL_TOOLS = {
10
10
  read_file: readFileTool,
11
+ read_document: readDocumentTool,
11
12
  write_file: writeFileTool,
12
13
  edit_file: editFileTool,
13
14
  list_dir: listDirTool,
@@ -15,6 +16,8 @@ export const ALL_TOOLS = {
15
16
  run_command: runCommandTool,
16
17
  run_security_scan: securityScanTool,
17
18
  fuzz_endpoint: fuzzEndpointTool,
19
+ crawl_target: crawlTargetTool,
20
+ inspect_http_message: inspectHttpTool,
18
21
  generate_payloads: generatePayloadsTool,
19
22
  send_http_request: httpRequestTool,
20
23
  git_inspection: gitTool,
@@ -41,32 +44,152 @@ export const ALL_TOOLS = {
41
44
  browser_export_har: browserExportHarTool,
42
45
  browser_close: browserCloseTool,
43
46
  };
44
- const TOOL_ALIASES = {
45
- browser_fill: "browser_type",
46
- browser_open_url: "browser_open"
47
- };
48
- export async function executeTool(toolName, params, context) {
49
- const canonicalName = TOOL_ALIASES[toolName] || toolName;
50
- const tool = ALL_TOOLS[canonicalName];
47
+ const CLI_SECURITY_TOOLS = new Set([
48
+ "send_http_request",
49
+ "run_security_scan",
50
+ "fuzz_endpoint",
51
+ "crawl_target",
52
+ "inspect_http_message",
53
+ "generate_payloads",
54
+ ]);
55
+ const CLI_CODE_ONLY_TOOLS = new Set([
56
+ "write_file",
57
+ "edit_file",
58
+ "git_inspection",
59
+ ]);
60
+ const CLI_EMPTY_STRING_ALLOWED = new Set(["content", "replacement"]);
61
+ export function normalizeToolMode(mode) {
62
+ const m = String(mode ?? "full").trim().toLowerCase();
63
+ if (m === "code" || m === "security" || m === "full")
64
+ return m;
65
+ return "full";
66
+ }
67
+ export function isToolAllowedInMode(toolName, opts = {}) {
68
+ if (toolName.startsWith("browser_") && opts.allowBrowser === false)
69
+ return false;
70
+ const mode = normalizeToolMode(opts.toolMode);
71
+ if (mode === "code" && CLI_SECURITY_TOOLS.has(toolName))
72
+ return false;
73
+ if (mode === "security" && CLI_CODE_ONLY_TOOLS.has(toolName))
74
+ return false;
75
+ return true;
76
+ }
77
+ export function validateToolCallArgs(rawName, rawParams, opts = {}) {
78
+ const name = String(rawName ?? "").trim();
79
+ const mode = normalizeToolMode(opts.toolMode);
80
+ const allowBrowser = opts.allowBrowser !== false;
81
+ if (!name) {
82
+ return { ok: false, error: "UNKNOWN_TOOL: Empty tool name." };
83
+ }
84
+ const tool = ALL_TOOLS[name];
51
85
  if (!tool) {
86
+ const enabled = getToolDefinitions({ toolMode: mode, allowBrowser }).map((d) => d.name);
87
+ return {
88
+ ok: false,
89
+ error: `UNKNOWN_TOOL: "${name}" does not exist. Enabled tools (${mode}): ${enabled.join(", ")}.`,
90
+ };
91
+ }
92
+ if (!isToolAllowedInMode(name, { toolMode: mode, allowBrowser })) {
93
+ const reason = name.startsWith("browser_") && !allowBrowser
94
+ ? `Tool "${name}" requires Browser mode to be enabled, but --no-browser / browser OFF is active.`
95
+ : `Tool "${name}" is disabled in "${mode}" mode.`;
96
+ return { ok: false, error: `TOOL_DISABLED_IN_MODE: ${reason}` };
97
+ }
98
+ if (rawParams === null || rawParams === undefined || typeof rawParams !== "object" || Array.isArray(rawParams)) {
99
+ return { ok: false, error: `SCHEMA_VALIDATION_ERROR for "${name}": Tool arguments must be a strict JSON object.` };
100
+ }
101
+ const input = rawParams;
102
+ const defProps = tool.definition.parameters.properties ?? {};
103
+ const required = Array.isArray(tool.definition.parameters.required) ? tool.definition.parameters.required : [];
104
+ const issues = [];
105
+ for (const key of Object.keys(input)) {
106
+ if (!(key in defProps)) {
107
+ issues.push(`Unrecognized property "${key}"`);
108
+ }
109
+ }
110
+ for (const reqKey of required) {
111
+ const val = input[reqKey];
112
+ const propType = defProps[reqKey]?.type;
113
+ if (val === undefined || val === null) {
114
+ issues.push(`${reqKey}: required field missing`);
115
+ }
116
+ else if (propType === "string" && (typeof val !== "string" || (val.trim() === "" && !CLI_EMPTY_STRING_ALLOWED.has(reqKey)))) {
117
+ issues.push(`${reqKey}: must be a non-empty string`);
118
+ }
119
+ }
120
+ for (const [key, val] of Object.entries(input)) {
121
+ if (val === undefined)
122
+ continue;
123
+ const spec = defProps[key];
124
+ if (!spec)
125
+ continue;
126
+ if (spec.type === "string") {
127
+ if (typeof val !== "string") {
128
+ issues.push(`${key}: expected string, received ${typeof val}`);
129
+ }
130
+ else if (Array.isArray(spec.enum) && !spec.enum.includes(val)) {
131
+ issues.push(`${key}: expected one of [${spec.enum.join(", ")}]`);
132
+ }
133
+ }
134
+ else if (spec.type === "number" || spec.type === "integer") {
135
+ if (typeof val !== "number" || !Number.isFinite(val)) {
136
+ issues.push(`${key}: expected finite number`);
137
+ }
138
+ }
139
+ else if (spec.type === "boolean") {
140
+ if (typeof val !== "boolean") {
141
+ issues.push(`${key}: expected boolean`);
142
+ }
143
+ }
144
+ else if (spec.type === "array") {
145
+ if (!Array.isArray(val)) {
146
+ issues.push(`${key}: expected array`);
147
+ }
148
+ }
149
+ else if (spec.type === "object") {
150
+ if (val === null || typeof val !== "object" || Array.isArray(val)) {
151
+ issues.push(`${key}: expected object`);
152
+ }
153
+ }
154
+ }
155
+ if (issues.length > 0) {
156
+ const expectedFields = Object.entries(defProps)
157
+ .map(([k, v]) => `${k}${required.includes(k) ? " (required)" : " (optional)"}: ${v?.type || "any"}`)
158
+ .join(", ");
159
+ return {
160
+ ok: false,
161
+ error: `SCHEMA_VALIDATION_ERROR for "${name}": ${issues.join("; ")}. Expected strict object with properties: { ${expectedFields} }. Retry using exact schema property names.`,
162
+ };
163
+ }
164
+ return { ok: true, name, params: input };
165
+ }
166
+ export async function executeTool(toolName, params, context) {
167
+ const check = validateToolCallArgs(toolName, params, {
168
+ toolMode: context.toolMode,
169
+ allowBrowser: context.allowBrowser,
170
+ });
171
+ if (!check.ok) {
52
172
  return {
53
173
  success: false,
54
174
  output: "",
55
- error: `Unknown tool: '${toolName}'. Available tools: ${Object.keys(ALL_TOOLS).join(", ")}`
175
+ error: check.error,
56
176
  };
57
177
  }
178
+ const tool = ALL_TOOLS[check.name];
58
179
  try {
59
- return await tool.execute(params, context);
180
+ return await tool.execute(check.params, context);
60
181
  }
61
182
  catch (err) {
62
183
  return {
63
184
  success: false,
64
185
  output: "",
65
- error: `Error executing ${toolName}: ${err.message}`
186
+ error: `Error executing ${check.name}: ${err.message}`
66
187
  };
67
188
  }
68
189
  }
69
- export function getToolDefinitions() {
70
- return Object.values(ALL_TOOLS).map(t => t.definition);
190
+ export function getToolDefinitions(opts = {}) {
191
+ return Object.values(ALL_TOOLS)
192
+ .filter((t) => isToolAllowedInMode(t.definition.name, opts))
193
+ .map((t) => t.definition);
71
194
  }
72
195
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,78 @@
1
+ import * as http from "node:http";
2
+ import * as https from "node:https";
3
+ export declare function isInternalHost(host: string): boolean;
4
+ export type UrlSecurityCheckResult = {
5
+ allowed: true;
6
+ url: URL;
7
+ } | {
8
+ allowed: false;
9
+ reason: string;
10
+ };
11
+ export interface UrlSecurityOptions {
12
+ allowPrivate?: boolean;
13
+ allowCredentials?: boolean;
14
+ allowNonHttp?: boolean;
15
+ maxRedirects?: number;
16
+ }
17
+ export declare function checkUrlSecurity(rawUrl: string, opts?: UrlSecurityOptions): UrlSecurityCheckResult;
18
+ export declare function validateRedirectChain(urls: readonly string[], opts?: UrlSecurityOptions): {
19
+ allowed: true;
20
+ } | {
21
+ allowed: false;
22
+ reason: string;
23
+ };
24
+ export type CircuitState = "CLOSED" | "OPEN" | "HALF_OPEN";
25
+ export interface CircuitBreakerOptions {
26
+ failureThreshold?: number;
27
+ initialCooldownMs?: number;
28
+ maxCooldownMs?: number;
29
+ multiplier?: number;
30
+ }
31
+ export declare class CircuitBreaker {
32
+ state: CircuitState;
33
+ fails: number;
34
+ openUntil: number;
35
+ cooldownMs: number;
36
+ readonly failureThreshold: number;
37
+ readonly initialCooldownMs: number;
38
+ readonly maxCooldownMs: number;
39
+ readonly multiplier: number;
40
+ constructor(opts?: CircuitBreakerOptions);
41
+ canTry(now?: number): boolean;
42
+ onSuccess(): void;
43
+ onBlocked(now?: number): void;
44
+ snapshot(): {
45
+ state: CircuitState;
46
+ fails: number;
47
+ openUntil: number;
48
+ cooldownMs: number;
49
+ };
50
+ }
51
+ export declare class HostBreakerRegistry {
52
+ private readonly breakers;
53
+ private readonly defaultOpts;
54
+ constructor(opts?: CircuitBreakerOptions);
55
+ private hostOf;
56
+ get(urlOrHost: string): CircuitBreaker;
57
+ canTry(urlOrHost: string, now?: number): boolean;
58
+ recordSuccess(urlOrHost: string): void;
59
+ recordStatus(urlOrHost: string, status: number, now?: number): boolean;
60
+ recordError(urlOrHost: string, now?: number): void;
61
+ getStatus(urlOrHost: string): {
62
+ state: CircuitState;
63
+ fails: number;
64
+ openUntil: number;
65
+ cooldownMs: number;
66
+ };
67
+ reset(urlOrHost?: string): void;
68
+ }
69
+ export declare function computeJitterBackoffMs(attempt: number, baseMs?: number, maxJitterMs?: number, randomFn?: () => number): number;
70
+ export declare class AgentPool {
71
+ private readonly httpKeepAlive;
72
+ private readonly httpsKeepAlive;
73
+ private readonly proxyCache;
74
+ getAgent(protocol: string, insecure?: boolean, proxyKey?: string): http.Agent | https.Agent;
75
+ size(): number;
76
+ closeAll(): void;
77
+ }
78
+ //# sourceMappingURL=resilience.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resilience.d.ts","sourceRoot":"","sources":["../../src/tools/resilience.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,211 @@
1
+ import * as http from "node:http";
2
+ import * as https from "node:https";
3
+ export function isInternalHost(host) {
4
+ const clean = host.trim().toLowerCase().replace(/^\[|\]$/g, "").replace(/\.$/, "");
5
+ if (!clean)
6
+ return false;
7
+ if (clean === "localhost" ||
8
+ clean.endsWith(".localhost") ||
9
+ clean.endsWith(".local") ||
10
+ clean.endsWith(".internal") ||
11
+ clean === "metadata.google.internal") {
12
+ return true;
13
+ }
14
+ const v4 = clean.split(".");
15
+ if (v4.length === 4 && v4.every((p) => /^\d{1,3}$/.test(p) && Number(p) <= 255)) {
16
+ const a = Number(v4[0]);
17
+ const b = Number(v4[1]);
18
+ if (a === 0 || a === 10 || a === 127)
19
+ return true;
20
+ if (a === 100 && b >= 64 && b <= 127)
21
+ return true;
22
+ if (a === 169 && b === 254)
23
+ return true;
24
+ if (a === 172 && b >= 16 && b <= 31)
25
+ return true;
26
+ if (a === 192 && b === 168)
27
+ return true;
28
+ if (a >= 224)
29
+ return true;
30
+ return false;
31
+ }
32
+ if (/^\d+$/.test(clean) && Number(clean) <= 0xffffffff)
33
+ return true;
34
+ if (/^0x[0-9a-f]+$/i.test(clean))
35
+ return true;
36
+ if (clean === "::1" || clean === "::" || clean.startsWith("fc") || clean.startsWith("fd") || clean.startsWith("fe80")) {
37
+ return true;
38
+ }
39
+ if (clean.startsWith("::ffff:")) {
40
+ return isInternalHost(clean.slice(7));
41
+ }
42
+ return false;
43
+ }
44
+ export function checkUrlSecurity(rawUrl, opts = {}) {
45
+ let parsed;
46
+ try {
47
+ parsed = new URL(String(rawUrl || "").trim());
48
+ }
49
+ catch {
50
+ return { allowed: false, reason: `Invalid URL: ${rawUrl}` };
51
+ }
52
+ const scheme = parsed.protocol.toLowerCase();
53
+ if (!opts.allowNonHttp && scheme !== "http:" && scheme !== "https:") {
54
+ return { allowed: false, reason: `Disallowed protocol (${parsed.protocol}): ${parsed.href}` };
55
+ }
56
+ if (opts.allowCredentials !== true && (parsed.username || parsed.password)) {
57
+ return { allowed: false, reason: `Blocked URL containing embedded credentials (user:pass@): ${parsed.origin}` };
58
+ }
59
+ if (opts.allowPrivate === false && isInternalHost(parsed.hostname)) {
60
+ return { allowed: false, reason: `Blocked by SSRF NetworkPolicy (internal/private host): ${parsed.hostname}` };
61
+ }
62
+ return { allowed: true, url: parsed };
63
+ }
64
+ export function validateRedirectChain(urls, opts = {}) {
65
+ const maxHops = Math.max(0, opts.maxRedirects ?? 5);
66
+ if (urls.length > maxHops + 1) {
67
+ return { allowed: false, reason: `Redirect chain too long (>${maxHops} hops)` };
68
+ }
69
+ for (const hopUrl of urls) {
70
+ const check = checkUrlSecurity(hopUrl, opts);
71
+ if (!check.allowed) {
72
+ return { allowed: false, reason: `Redirect target rejected (${hopUrl}): ${check.reason}` };
73
+ }
74
+ }
75
+ return { allowed: true };
76
+ }
77
+ export class CircuitBreaker {
78
+ state = "CLOSED";
79
+ fails = 0;
80
+ openUntil = 0;
81
+ cooldownMs;
82
+ failureThreshold;
83
+ initialCooldownMs;
84
+ maxCooldownMs;
85
+ multiplier;
86
+ constructor(opts = {}) {
87
+ this.failureThreshold = Math.max(1, opts.failureThreshold ?? 3);
88
+ this.initialCooldownMs = Math.max(10, opts.initialCooldownMs ?? 30 * 60_000);
89
+ this.maxCooldownMs = Math.max(this.initialCooldownMs, opts.maxCooldownMs ?? 4 * 3_600_000);
90
+ this.multiplier = Math.max(1, opts.multiplier ?? 2);
91
+ this.cooldownMs = this.initialCooldownMs;
92
+ }
93
+ canTry(now = Date.now()) {
94
+ if (this.state !== "OPEN")
95
+ return true;
96
+ if (now >= this.openUntil) {
97
+ this.state = "HALF_OPEN";
98
+ return true;
99
+ }
100
+ return false;
101
+ }
102
+ onSuccess() {
103
+ this.fails = 0;
104
+ this.cooldownMs = this.initialCooldownMs;
105
+ this.state = "CLOSED";
106
+ this.openUntil = 0;
107
+ }
108
+ onBlocked(now = Date.now()) {
109
+ this.fails += 1;
110
+ if (this.fails >= this.failureThreshold || this.state === "HALF_OPEN") {
111
+ this.state = "OPEN";
112
+ this.openUntil = now + this.cooldownMs;
113
+ this.cooldownMs = Math.min(this.cooldownMs * this.multiplier, this.maxCooldownMs);
114
+ }
115
+ }
116
+ snapshot() {
117
+ return {
118
+ state: this.state,
119
+ fails: this.fails,
120
+ openUntil: this.openUntil,
121
+ cooldownMs: this.cooldownMs,
122
+ };
123
+ }
124
+ }
125
+ export class HostBreakerRegistry {
126
+ breakers = new Map();
127
+ defaultOpts;
128
+ constructor(opts = {}) {
129
+ this.defaultOpts = opts;
130
+ }
131
+ hostOf(urlOrHost) {
132
+ try {
133
+ return new URL(urlOrHost).hostname.toLowerCase();
134
+ }
135
+ catch {
136
+ return String(urlOrHost || "").trim().toLowerCase();
137
+ }
138
+ }
139
+ get(urlOrHost) {
140
+ const key = this.hostOf(urlOrHost) || "default";
141
+ let b = this.breakers.get(key);
142
+ if (!b) {
143
+ b = new CircuitBreaker(this.defaultOpts);
144
+ this.breakers.set(key, b);
145
+ }
146
+ return b;
147
+ }
148
+ canTry(urlOrHost, now = Date.now()) {
149
+ return this.get(urlOrHost).canTry(now);
150
+ }
151
+ recordSuccess(urlOrHost) {
152
+ this.get(urlOrHost).onSuccess();
153
+ }
154
+ recordStatus(urlOrHost, status, now = Date.now()) {
155
+ if (status === 403 || status === 429 || status >= 500) {
156
+ this.get(urlOrHost).onBlocked(now);
157
+ return true;
158
+ }
159
+ this.get(urlOrHost).onSuccess();
160
+ return false;
161
+ }
162
+ recordError(urlOrHost, now = Date.now()) {
163
+ this.get(urlOrHost).onBlocked(now);
164
+ }
165
+ getStatus(urlOrHost) {
166
+ return this.get(urlOrHost).snapshot();
167
+ }
168
+ reset(urlOrHost) {
169
+ if (urlOrHost)
170
+ this.breakers.delete(this.hostOf(urlOrHost));
171
+ else
172
+ this.breakers.clear();
173
+ }
174
+ }
175
+ export function computeJitterBackoffMs(attempt, baseMs = 1000, maxJitterMs = 700, randomFn = Math.random) {
176
+ const safeAttempt = Math.max(0, Math.min(10, Math.floor(attempt)));
177
+ const exp = Math.pow(2, safeAttempt) * Math.max(1, baseMs);
178
+ const jitter = Math.floor(Math.max(0, Math.min(0.999999, randomFn())) * Math.max(0, maxJitterMs));
179
+ return Math.round(exp + jitter);
180
+ }
181
+ export class AgentPool {
182
+ httpKeepAlive = new http.Agent({ keepAlive: true, maxSockets: 64 });
183
+ httpsKeepAlive = new https.Agent({ keepAlive: true, maxSockets: 64 });
184
+ proxyCache = new Map();
185
+ getAgent(protocol, insecure = false, proxyKey) {
186
+ if (proxyKey) {
187
+ const k = `${protocol}:${insecure ? "1" : "0"}:${proxyKey}`;
188
+ let cached = this.proxyCache.get(k);
189
+ if (!cached) {
190
+ cached = protocol === "https:"
191
+ ? new https.Agent({ keepAlive: true, maxSockets: 32, rejectUnauthorized: !insecure })
192
+ : new http.Agent({ keepAlive: true, maxSockets: 32 });
193
+ this.proxyCache.set(k, cached);
194
+ }
195
+ return cached;
196
+ }
197
+ return protocol === "https:" ? this.httpsKeepAlive : this.httpKeepAlive;
198
+ }
199
+ size() {
200
+ return this.proxyCache.size;
201
+ }
202
+ closeAll() {
203
+ this.httpKeepAlive.destroy();
204
+ this.httpsKeepAlive.destroy();
205
+ for (const agent of this.proxyCache.values()) {
206
+ agent.destroy();
207
+ }
208
+ this.proxyCache.clear();
209
+ }
210
+ }
211
+ //# sourceMappingURL=resilience.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resilience.js","sourceRoot":"","sources":["../../src/tools/resilience.ts"],"names":[],"mappings":"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"}
@@ -2,4 +2,6 @@ import type { Tool } from "./types.js";
2
2
  export declare const securityScanTool: Tool;
3
3
  export declare const fuzzEndpointTool: Tool;
4
4
  export declare const generatePayloadsTool: Tool;
5
+ export declare const crawlTargetTool: Tool;
6
+ export declare const inspectHttpTool: Tool;
5
7
  //# sourceMappingURL=security.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/tools/security.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAoC,MAAM,YAAY,CAAC;AAEzE,eAAO,MAAM,gBAAgB,EAAE,IA4C9B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,IA0E9B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,IA+BlC,CAAC"}
1
+ {"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/tools/security.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAoC,MAAM,YAAY,CAAC;AAEzE,eAAO,MAAM,gBAAgB,EAAE,IA4C9B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,IA0E9B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,IA+BlC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,IAuC7B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,IAoC7B,CAAC"}
@@ -1,4 +1,6 @@
1
1
  import { SecurityScanner } from "../security/scanner.js";
2
+ import { WideCrawler } from "../security/crawler.js";
3
+ import { evaluateHttpInspection } from "../security/inspect.js";
2
4
  import { fuzzTargetEndpoint } from "../security/fuzzer.js";
3
5
  import { getPayloadsForType, getAllPayloadTypes } from "../security/payloads.js";
4
6
  export const securityScanTool = {
@@ -58,7 +60,7 @@ export const fuzzEndpointTool = {
58
60
  payloadType: {
59
61
  type: "string",
60
62
  description: "Category of payloads to inject.",
61
- enum: ["sqli", "xss", "ssrf", "traversal", "cmd", "ssti", "idor"]
63
+ enum: ["sqli", "xss", "ssrf", "traversal", "cmd", "ssti", "idor", "evasion", "smuggling"]
62
64
  },
63
65
  method: {
64
66
  type: "string",
@@ -144,4 +146,80 @@ export const generatePayloadsTool = {
144
146
  };
145
147
  }
146
148
  };
149
+ export const crawlTargetTool = {
150
+ definition: {
151
+ name: "crawl_target",
152
+ description: "Crawl a target web application using Wide spider engine (PathTrie, SimHash dedup, JS endpoints, passive headers/secrets/JWT audit).",
153
+ parameters: {
154
+ type: "object",
155
+ properties: {
156
+ url: { type: "string", description: "Seed HTTP or HTTPS URL." },
157
+ maxDepth: { type: "number", description: "Crawl depth limit (default: 3)." },
158
+ maxPages: { type: "number", description: "Maximum pages to crawl (default: 80)." },
159
+ fieldScope: { type: "string", enum: ["rdn", "fqdn", "dn"], description: "Scope matching mode (default: rdn)." },
160
+ allowPrivate: { type: "boolean", description: "Allow private/loopback targets (default: false)." },
161
+ tlsProfile: { type: "string", enum: ["none", "chrome", "firefox", "safari"], description: "Optional TLS impersonation profile." }
162
+ },
163
+ required: ["url"]
164
+ }
165
+ },
166
+ async execute(params) {
167
+ try {
168
+ const crawler = new WideCrawler();
169
+ const result = await crawler.crawl(String(params.url || ""), {
170
+ maxDepth: typeof params.maxDepth === "number" ? params.maxDepth : 3,
171
+ maxPages: typeof params.maxPages === "number" ? params.maxPages : 80,
172
+ fieldScope: params.fieldScope || "rdn",
173
+ allowPrivate: Boolean(params.allowPrivate),
174
+ tlsProfile: params.tlsProfile || "none",
175
+ });
176
+ return {
177
+ success: true,
178
+ output: JSON.stringify(result, null, 2),
179
+ };
180
+ }
181
+ catch (err) {
182
+ return {
183
+ success: false,
184
+ output: "",
185
+ error: `Crawl failed: ${err.message}`,
186
+ };
187
+ }
188
+ }
189
+ };
190
+ export const inspectHttpTool = {
191
+ definition: {
192
+ name: "inspect_http_message",
193
+ description: "Inspect an HTTP request/response using RFC 9112 conformance, evasion decoding, lexical SQLi/XSS tokenizers, ReDoS-safe rules, and learning exception drafts.",
194
+ parameters: {
195
+ type: "object",
196
+ properties: {
197
+ url: { type: "string", description: "Target HTTP URL or path." },
198
+ method: { type: "string", description: "HTTP method (default GET)." },
199
+ headers: { type: "object", description: "Optional HTTP headers map." },
200
+ body: { type: "string", description: "Optional HTTP body." },
201
+ rawRequest: { type: "string", description: "Optional raw HTTP/1.x wire request for RFC 9112 smuggling check." },
202
+ rawResponse: { type: "string", description: "Optional raw HTTP/1.x wire response for poisoning check." },
203
+ learning: { type: "boolean", description: "Generate dated exception drafts for hits." }
204
+ },
205
+ required: ["url"]
206
+ }
207
+ },
208
+ async execute(params) {
209
+ try {
210
+ const report = evaluateHttpInspection({
211
+ url: String(params.url || "/"),
212
+ method: String(params.method || "GET"),
213
+ headers: params.headers || {},
214
+ body: typeof params.body === "string" ? params.body : "",
215
+ rawRequest: typeof params.rawRequest === "string" ? params.rawRequest : undefined,
216
+ rawResponse: typeof params.rawResponse === "string" ? params.rawResponse : undefined,
217
+ }, { learning: Boolean(params.learning) });
218
+ return { success: true, output: JSON.stringify(report, null, 2) };
219
+ }
220
+ catch (err) {
221
+ return { success: false, output: "", error: `HTTP inspection failed: ${err.message}` };
222
+ }
223
+ }
224
+ };
147
225
  //# sourceMappingURL=security.js.map