@amaranthic/hernex 0.0.0-stage → 0.2.0
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.
- package/LICENSE +21 -0
- package/README.md +66 -2
- package/dist/ai.d.ts +11 -0
- package/dist/ai.d.ts.map +1 -0
- package/dist/ai.js +11 -0
- package/dist/ai.js.map +1 -0
- package/dist/checkpoints/FileCheckpointStore.d.ts +95 -0
- package/dist/checkpoints/FileCheckpointStore.d.ts.map +1 -0
- package/dist/checkpoints/FileCheckpointStore.js +412 -0
- package/dist/checkpoints/FileCheckpointStore.js.map +1 -0
- package/dist/checkpoints/index.d.ts +7 -0
- package/dist/checkpoints/index.d.ts.map +1 -0
- package/dist/checkpoints/index.js +7 -0
- package/dist/checkpoints/index.js.map +1 -0
- package/dist/checkpoints/types.d.ts +157 -0
- package/dist/checkpoints/types.d.ts.map +1 -0
- package/dist/checkpoints/types.js +6 -0
- package/dist/checkpoints/types.js.map +1 -0
- package/dist/engine/AgentEngine.d.ts +156 -0
- package/dist/engine/AgentEngine.d.ts.map +1 -0
- package/dist/engine/AgentEngine.js +288 -0
- package/dist/engine/AgentEngine.js.map +1 -0
- package/dist/engine/engineConfig.d.ts +138 -0
- package/dist/engine/engineConfig.d.ts.map +1 -0
- package/dist/engine/engineConfig.js +6 -0
- package/dist/engine/engineConfig.js.map +1 -0
- package/dist/engine/eventQueue.d.ts +42 -0
- package/dist/engine/eventQueue.d.ts.map +1 -0
- package/dist/engine/eventQueue.js +93 -0
- package/dist/engine/eventQueue.js.map +1 -0
- package/dist/engine/index.d.ts +7 -0
- package/dist/engine/index.d.ts.map +1 -0
- package/dist/engine/index.js +6 -0
- package/dist/engine/index.js.map +1 -0
- package/dist/engine/runTurn.d.ts +17 -0
- package/dist/engine/runTurn.d.ts.map +1 -0
- package/dist/engine/runTurn.js +684 -0
- package/dist/engine/runTurn.js.map +1 -0
- package/dist/errors.d.ts +142 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +174 -0
- package/dist/errors.js.map +1 -0
- package/dist/events/checkpointEvents.d.ts +20 -0
- package/dist/events/checkpointEvents.d.ts.map +1 -0
- package/dist/events/checkpointEvents.js +6 -0
- package/dist/events/checkpointEvents.js.map +1 -0
- package/dist/events/errorEvents.d.ts +23 -0
- package/dist/events/errorEvents.d.ts.map +1 -0
- package/dist/events/errorEvents.js +6 -0
- package/dist/events/errorEvents.js.map +1 -0
- package/dist/events/index.d.ts +11 -0
- package/dist/events/index.d.ts.map +1 -0
- package/dist/events/index.js +6 -0
- package/dist/events/index.js.map +1 -0
- package/dist/events/stepEvents.d.ts +68 -0
- package/dist/events/stepEvents.d.ts.map +1 -0
- package/dist/events/stepEvents.js +6 -0
- package/dist/events/stepEvents.js.map +1 -0
- package/dist/events/streamEvents.d.ts +41 -0
- package/dist/events/streamEvents.d.ts.map +1 -0
- package/dist/events/streamEvents.js +6 -0
- package/dist/events/streamEvents.js.map +1 -0
- package/dist/events/toolEvents.d.ts +62 -0
- package/dist/events/toolEvents.d.ts.map +1 -0
- package/dist/events/toolEvents.js +6 -0
- package/dist/events/toolEvents.js.map +1 -0
- package/dist/events/types.d.ts +37 -0
- package/dist/events/types.d.ts.map +1 -0
- package/dist/events/types.js +6 -0
- package/dist/events/types.js.map +1 -0
- package/dist/hooks/composeAgentHooks.d.ts +14 -0
- package/dist/hooks/composeAgentHooks.d.ts.map +1 -0
- package/dist/hooks/composeAgentHooks.js +142 -0
- package/dist/hooks/composeAgentHooks.js.map +1 -0
- package/dist/hooks/index.d.ts +7 -0
- package/dist/hooks/index.d.ts.map +1 -0
- package/dist/hooks/index.js +6 -0
- package/dist/hooks/index.js.map +1 -0
- package/dist/hooks/types.d.ts +133 -0
- package/dist/hooks/types.d.ts.map +1 -0
- package/dist/hooks/types.js +6 -0
- package/dist/hooks/types.js.map +1 -0
- package/dist/index.d.ts +26 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +25 -0
- package/dist/index.js.map +1 -0
- package/dist/model/ProviderRegistry.d.ts +62 -0
- package/dist/model/ProviderRegistry.d.ts.map +1 -0
- package/dist/model/ProviderRegistry.js +114 -0
- package/dist/model/ProviderRegistry.js.map +1 -0
- package/dist/model/providers/alibaba.d.ts +11 -0
- package/dist/model/providers/alibaba.d.ts.map +1 -0
- package/dist/model/providers/alibaba.js +16 -0
- package/dist/model/providers/alibaba.js.map +1 -0
- package/dist/model/providers/anthropic.d.ts +11 -0
- package/dist/model/providers/anthropic.d.ts.map +1 -0
- package/dist/model/providers/anthropic.js +16 -0
- package/dist/model/providers/anthropic.js.map +1 -0
- package/dist/model/providers/cohere.d.ts +11 -0
- package/dist/model/providers/cohere.d.ts.map +1 -0
- package/dist/model/providers/cohere.js +16 -0
- package/dist/model/providers/cohere.js.map +1 -0
- package/dist/model/providers/compatible.d.ts +11 -0
- package/dist/model/providers/compatible.d.ts.map +1 -0
- package/dist/model/providers/compatible.js +17 -0
- package/dist/model/providers/compatible.js.map +1 -0
- package/dist/model/providers/deepseek.d.ts +11 -0
- package/dist/model/providers/deepseek.d.ts.map +1 -0
- package/dist/model/providers/deepseek.js +16 -0
- package/dist/model/providers/deepseek.js.map +1 -0
- package/dist/model/providers/google.d.ts +11 -0
- package/dist/model/providers/google.d.ts.map +1 -0
- package/dist/model/providers/google.js +16 -0
- package/dist/model/providers/google.js.map +1 -0
- package/dist/model/providers/groq.d.ts +11 -0
- package/dist/model/providers/groq.d.ts.map +1 -0
- package/dist/model/providers/groq.js +16 -0
- package/dist/model/providers/groq.js.map +1 -0
- package/dist/model/providers/mistral.d.ts +11 -0
- package/dist/model/providers/mistral.d.ts.map +1 -0
- package/dist/model/providers/mistral.js +16 -0
- package/dist/model/providers/mistral.js.map +1 -0
- package/dist/model/providers/openai.d.ts +11 -0
- package/dist/model/providers/openai.d.ts.map +1 -0
- package/dist/model/providers/openai.js +16 -0
- package/dist/model/providers/openai.js.map +1 -0
- package/dist/model/providers/openrouter.d.ts +14 -0
- package/dist/model/providers/openrouter.d.ts.map +1 -0
- package/dist/model/providers/openrouter.js +20 -0
- package/dist/model/providers/openrouter.js.map +1 -0
- package/dist/model/providers/togetherai.d.ts +11 -0
- package/dist/model/providers/togetherai.d.ts.map +1 -0
- package/dist/model/providers/togetherai.js +16 -0
- package/dist/model/providers/togetherai.js.map +1 -0
- package/dist/model/providers/vercelGateway.d.ts +14 -0
- package/dist/model/providers/vercelGateway.d.ts.map +1 -0
- package/dist/model/providers/vercelGateway.js +19 -0
- package/dist/model/providers/vercelGateway.js.map +1 -0
- package/dist/model/providers/xai.d.ts +11 -0
- package/dist/model/providers/xai.d.ts.map +1 -0
- package/dist/model/providers/xai.js +16 -0
- package/dist/model/providers/xai.js.map +1 -0
- package/dist/model/resolveModel.d.ts +45 -0
- package/dist/model/resolveModel.d.ts.map +1 -0
- package/dist/model/resolveModel.js +109 -0
- package/dist/model/resolveModel.js.map +1 -0
- package/dist/model/types.d.ts +98 -0
- package/dist/model/types.d.ts.map +1 -0
- package/dist/model/types.js +6 -0
- package/dist/model/types.js.map +1 -0
- package/dist/runtime.d.ts +74 -0
- package/dist/runtime.d.ts.map +1 -0
- package/dist/runtime.js +41 -0
- package/dist/runtime.js.map +1 -0
- package/dist/storage/atomicFile.d.ts +28 -0
- package/dist/storage/atomicFile.d.ts.map +1 -0
- package/dist/storage/atomicFile.js +56 -0
- package/dist/storage/atomicFile.js.map +1 -0
- package/dist/storage/homeDirectory.d.ts +21 -0
- package/dist/storage/homeDirectory.d.ts.map +1 -0
- package/dist/storage/homeDirectory.js +36 -0
- package/dist/storage/homeDirectory.js.map +1 -0
- package/dist/storage/index.d.ts +10 -0
- package/dist/storage/index.d.ts.map +1 -0
- package/dist/storage/index.js +10 -0
- package/dist/storage/index.js.map +1 -0
- package/dist/storage/jsonl.d.ts +46 -0
- package/dist/storage/jsonl.d.ts.map +1 -0
- package/dist/storage/jsonl.js +121 -0
- package/dist/storage/jsonl.js.map +1 -0
- package/dist/storage/lock.d.ts +47 -0
- package/dist/storage/lock.d.ts.map +1 -0
- package/dist/storage/lock.js +126 -0
- package/dist/storage/lock.js.map +1 -0
- package/dist/storage/valueCodec.d.ts +68 -0
- package/dist/storage/valueCodec.d.ts.map +1 -0
- package/dist/storage/valueCodec.js +140 -0
- package/dist/storage/valueCodec.js.map +1 -0
- package/dist/tasks/TaskManager.d.ts +155 -0
- package/dist/tasks/TaskManager.d.ts.map +1 -0
- package/dist/tasks/TaskManager.js +774 -0
- package/dist/tasks/TaskManager.js.map +1 -0
- package/dist/tasks/index.d.ts +7 -0
- package/dist/tasks/index.d.ts.map +1 -0
- package/dist/tasks/index.js +6 -0
- package/dist/tasks/index.js.map +1 -0
- package/dist/tasks/types.d.ts +160 -0
- package/dist/tasks/types.d.ts.map +1 -0
- package/dist/tasks/types.js +8 -0
- package/dist/tasks/types.js.map +1 -0
- package/dist/threads/FileThreadStore.d.ts +118 -0
- package/dist/threads/FileThreadStore.d.ts.map +1 -0
- package/dist/threads/FileThreadStore.js +320 -0
- package/dist/threads/FileThreadStore.js.map +1 -0
- package/dist/threads/index.d.ts +7 -0
- package/dist/threads/index.d.ts.map +1 -0
- package/dist/threads/index.js +7 -0
- package/dist/threads/index.js.map +1 -0
- package/dist/threads/types.d.ts +230 -0
- package/dist/threads/types.d.ts.map +1 -0
- package/dist/threads/types.js +6 -0
- package/dist/threads/types.js.map +1 -0
- package/dist/tools/AgentTool.d.ts +38 -0
- package/dist/tools/AgentTool.d.ts.map +1 -0
- package/dist/tools/AgentTool.js +6 -0
- package/dist/tools/AgentTool.js.map +1 -0
- package/dist/tools/BashTool.d.ts +61 -0
- package/dist/tools/BashTool.d.ts.map +1 -0
- package/dist/tools/BashTool.js +142 -0
- package/dist/tools/BashTool.js.map +1 -0
- package/dist/tools/EditFileTool.d.ts +49 -0
- package/dist/tools/EditFileTool.d.ts.map +1 -0
- package/dist/tools/EditFileTool.js +114 -0
- package/dist/tools/EditFileTool.js.map +1 -0
- package/dist/tools/GlobTool.d.ts +48 -0
- package/dist/tools/GlobTool.d.ts.map +1 -0
- package/dist/tools/GlobTool.js +117 -0
- package/dist/tools/GlobTool.js.map +1 -0
- package/dist/tools/GrepTool.d.ts +73 -0
- package/dist/tools/GrepTool.d.ts.map +1 -0
- package/dist/tools/GrepTool.js +250 -0
- package/dist/tools/GrepTool.js.map +1 -0
- package/dist/tools/ReadFileTool.d.ts +51 -0
- package/dist/tools/ReadFileTool.d.ts.map +1 -0
- package/dist/tools/ReadFileTool.js +153 -0
- package/dist/tools/ReadFileTool.js.map +1 -0
- package/dist/tools/TaskManagerTool.d.ts +102 -0
- package/dist/tools/TaskManagerTool.d.ts.map +1 -0
- package/dist/tools/TaskManagerTool.js +130 -0
- package/dist/tools/TaskManagerTool.js.map +1 -0
- package/dist/tools/ToolExecutionContext.d.ts +61 -0
- package/dist/tools/ToolExecutionContext.d.ts.map +1 -0
- package/dist/tools/ToolExecutionContext.js +8 -0
- package/dist/tools/ToolExecutionContext.js.map +1 -0
- package/dist/tools/ToolRegistry.d.ts +82 -0
- package/dist/tools/ToolRegistry.d.ts.map +1 -0
- package/dist/tools/ToolRegistry.js +116 -0
- package/dist/tools/ToolRegistry.js.map +1 -0
- package/dist/tools/WriteFileTool.d.ts +46 -0
- package/dist/tools/WriteFileTool.d.ts.map +1 -0
- package/dist/tools/WriteFileTool.js +87 -0
- package/dist/tools/WriteFileTool.js.map +1 -0
- package/dist/tools/index.d.ts +17 -0
- package/dist/tools/index.d.ts.map +1 -0
- package/dist/tools/index.js +17 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/tools/internal/bashEnvironment.d.ts +20 -0
- package/dist/tools/internal/bashEnvironment.d.ts.map +1 -0
- package/dist/tools/internal/bashEnvironment.js +65 -0
- package/dist/tools/internal/bashEnvironment.js.map +1 -0
- package/dist/tools/internal/pathGuard.d.ts +27 -0
- package/dist/tools/internal/pathGuard.d.ts.map +1 -0
- package/dist/tools/internal/pathGuard.js +99 -0
- package/dist/tools/internal/pathGuard.js.map +1 -0
- package/dist/tools/prompts.d.ts +33 -0
- package/dist/tools/prompts.d.ts.map +1 -0
- package/dist/tools/prompts.js +48 -0
- package/dist/tools/prompts.js.map +1 -0
- package/package.json +64 -4
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Shell process environment sanitization and filtering.
|
|
3
|
+
* @packageDocumentation
|
|
4
|
+
*/
|
|
5
|
+
/**
|
|
6
|
+
* Sensitive environment variable name patterns that must never leak into shell executions.
|
|
7
|
+
*/
|
|
8
|
+
const SENSITIVE_ENV_PATTERN = /(API_KEY|TOKEN|SECRET|PASSWORD|CREDENTIAL|AUTH|HERNEX_HOME|GREG_)/i;
|
|
9
|
+
/**
|
|
10
|
+
* Standard host environment variables safe to forward to child shell processes.
|
|
11
|
+
*/
|
|
12
|
+
const SAFE_ENV_VARS = new Set([
|
|
13
|
+
"PATH",
|
|
14
|
+
"HOME",
|
|
15
|
+
"USER",
|
|
16
|
+
"LOGNAME",
|
|
17
|
+
"SHELL",
|
|
18
|
+
"LANG",
|
|
19
|
+
"LC_ALL",
|
|
20
|
+
"LC_CTYPE",
|
|
21
|
+
"LC_MESSAGES",
|
|
22
|
+
"TMPDIR",
|
|
23
|
+
"TMP",
|
|
24
|
+
"TEMP",
|
|
25
|
+
"PWD",
|
|
26
|
+
"EDITOR",
|
|
27
|
+
"VISUAL",
|
|
28
|
+
"PAGER",
|
|
29
|
+
"NODE_PATH",
|
|
30
|
+
"NODE_ENV",
|
|
31
|
+
]);
|
|
32
|
+
/**
|
|
33
|
+
* Constructs a sanitized environment dictionary for shell command execution.
|
|
34
|
+
*
|
|
35
|
+
* Filters out all host API keys, authentication tokens, and secrets by default,
|
|
36
|
+
* while forwarding standard execution variables (PATH, HOME, USER, etc.).
|
|
37
|
+
*
|
|
38
|
+
* @param extraAllowlist - Optional list of additional environment variable names to forward.
|
|
39
|
+
* @returns Clean environment record safe for subprocess execution.
|
|
40
|
+
*
|
|
41
|
+
* @example
|
|
42
|
+
* ```typescript
|
|
43
|
+
* const env = getSafeBashEnvironment(["CUSTOM_VAR"]);
|
|
44
|
+
* ```
|
|
45
|
+
*/
|
|
46
|
+
export function getSafeBashEnvironment(extraAllowlist) {
|
|
47
|
+
const safeEnv = {
|
|
48
|
+
TERM: "dumb",
|
|
49
|
+
};
|
|
50
|
+
const allowedSet = new Set(extraAllowlist ?? []);
|
|
51
|
+
for (const [key, value] of Object.entries(process.env)) {
|
|
52
|
+
if (value === undefined) {
|
|
53
|
+
continue;
|
|
54
|
+
}
|
|
55
|
+
if (allowedSet.has(key)) {
|
|
56
|
+
safeEnv[key] = value;
|
|
57
|
+
continue;
|
|
58
|
+
}
|
|
59
|
+
if (SAFE_ENV_VARS.has(key) && !SENSITIVE_ENV_PATTERN.test(key)) {
|
|
60
|
+
safeEnv[key] = value;
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
return safeEnv;
|
|
64
|
+
}
|
|
65
|
+
//# sourceMappingURL=bashEnvironment.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bashEnvironment.js","sources":["../../../src/tools/internal/bashEnvironment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,qBAAqB,GACzB,oEAAoE,CAAC;AAEvE;;GAEG;AACH,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,MAAM;IACN,MAAM;IACN,MAAM;IACN,SAAS;IACT,OAAO;IACP,MAAM;IACN,QAAQ;IACR,UAAU;IACV,aAAa;IACb,QAAQ;IACR,KAAK;IACL,MAAM;IACN,KAAK;IACL,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,WAAW;IACX,UAAU;CACX,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB,CACpC,cAAkC;IAElC,MAAM,OAAO,GAA2B;QACtC,IAAI,EAAE,MAAM;KACb,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS,cAAc,IAAI,EAAE,CAAC,CAAC;IAEzD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QAED,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACrB,SAAS;QACX,CAAC;QAED,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Path containment and filesystem security guards for agent tools.
|
|
3
|
+
* @packageDocumentation
|
|
4
|
+
*/
|
|
5
|
+
/**
|
|
6
|
+
* Validates and resolves a target path, ensuring it stays strictly within the workspace root
|
|
7
|
+
* and does not traverse through or terminate at any symbolic links.
|
|
8
|
+
*
|
|
9
|
+
* Enforces strict filesystem containment:
|
|
10
|
+
* - Canonicalizes the workspace root directory.
|
|
11
|
+
* - Rejects directory traversals (`..`) and outside absolute paths using strict relative boundary checks.
|
|
12
|
+
* - Inspects every existing path segment with `lstatSync` to reject all symbolic links (both intermediate directories and target files).
|
|
13
|
+
* - Stops at the first `ENOENT` so writes to not-yet-created files remain possible.
|
|
14
|
+
* - Propagates permission and I/O failures without swallowing.
|
|
15
|
+
*
|
|
16
|
+
* @param targetPath - Path requested by tool arguments.
|
|
17
|
+
* @param rootDir - Workspace root directory.
|
|
18
|
+
* @returns Fully resolved absolute path within the workspace root.
|
|
19
|
+
* @throws Error if the path escapes the workspace root or encounters a symbolic link.
|
|
20
|
+
*
|
|
21
|
+
* @example
|
|
22
|
+
* ```typescript
|
|
23
|
+
* const safePath = resolvePathWithinWorkspace("src/index.ts", "/path/to/workspace");
|
|
24
|
+
* ```
|
|
25
|
+
*/
|
|
26
|
+
export declare function resolvePathWithinWorkspace(targetPath: string, rootDir: string): string;
|
|
27
|
+
//# sourceMappingURL=pathGuard.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pathGuard.d.ts","sources":["../../../src/tools/internal/pathGuard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,MAAM,CAsFR"}
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Path containment and filesystem security guards for agent tools.
|
|
3
|
+
* @packageDocumentation
|
|
4
|
+
*/
|
|
5
|
+
import { lstatSync, realpathSync } from "node:fs";
|
|
6
|
+
import { isAbsolute, relative, resolve, sep } from "node:path";
|
|
7
|
+
/**
|
|
8
|
+
* Validates and resolves a target path, ensuring it stays strictly within the workspace root
|
|
9
|
+
* and does not traverse through or terminate at any symbolic links.
|
|
10
|
+
*
|
|
11
|
+
* Enforces strict filesystem containment:
|
|
12
|
+
* - Canonicalizes the workspace root directory.
|
|
13
|
+
* - Rejects directory traversals (`..`) and outside absolute paths using strict relative boundary checks.
|
|
14
|
+
* - Inspects every existing path segment with `lstatSync` to reject all symbolic links (both intermediate directories and target files).
|
|
15
|
+
* - Stops at the first `ENOENT` so writes to not-yet-created files remain possible.
|
|
16
|
+
* - Propagates permission and I/O failures without swallowing.
|
|
17
|
+
*
|
|
18
|
+
* @param targetPath - Path requested by tool arguments.
|
|
19
|
+
* @param rootDir - Workspace root directory.
|
|
20
|
+
* @returns Fully resolved absolute path within the workspace root.
|
|
21
|
+
* @throws Error if the path escapes the workspace root or encounters a symbolic link.
|
|
22
|
+
*
|
|
23
|
+
* @example
|
|
24
|
+
* ```typescript
|
|
25
|
+
* const safePath = resolvePathWithinWorkspace("src/index.ts", "/path/to/workspace");
|
|
26
|
+
* ```
|
|
27
|
+
*/
|
|
28
|
+
export function resolvePathWithinWorkspace(targetPath, rootDir) {
|
|
29
|
+
const normalizedRoot = resolve(rootDir);
|
|
30
|
+
let canonicalRoot;
|
|
31
|
+
try {
|
|
32
|
+
canonicalRoot = realpathSync(normalizedRoot);
|
|
33
|
+
}
|
|
34
|
+
catch (error) {
|
|
35
|
+
if (typeof error === "object" &&
|
|
36
|
+
error !== null &&
|
|
37
|
+
"code" in error &&
|
|
38
|
+
error.code === "ENOENT") {
|
|
39
|
+
canonicalRoot = normalizedRoot;
|
|
40
|
+
}
|
|
41
|
+
else {
|
|
42
|
+
throw error;
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
let resolvedTarget;
|
|
46
|
+
if (isAbsolute(targetPath)) {
|
|
47
|
+
const relFromNormalized = relative(normalizedRoot, resolve(targetPath));
|
|
48
|
+
const isInsideNormalized = relFromNormalized === "" ||
|
|
49
|
+
(!isAbsolute(relFromNormalized) &&
|
|
50
|
+
relFromNormalized !== ".." &&
|
|
51
|
+
!relFromNormalized.startsWith(".." + sep));
|
|
52
|
+
if (isInsideNormalized) {
|
|
53
|
+
resolvedTarget = resolve(canonicalRoot, relFromNormalized);
|
|
54
|
+
}
|
|
55
|
+
else {
|
|
56
|
+
resolvedTarget = resolve(targetPath);
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
else {
|
|
60
|
+
resolvedTarget = resolve(canonicalRoot, targetPath);
|
|
61
|
+
}
|
|
62
|
+
const rel = relative(canonicalRoot, resolvedTarget);
|
|
63
|
+
const isWithin = rel === "" ||
|
|
64
|
+
(!isAbsolute(rel) && rel !== ".." && !rel.startsWith(".." + sep));
|
|
65
|
+
if (!isWithin) {
|
|
66
|
+
throw new Error(`Access denied: path "${targetPath}" resolves outside the allowed workspace directory.`);
|
|
67
|
+
}
|
|
68
|
+
if (rel !== "") {
|
|
69
|
+
const segments = rel.split(sep).filter(Boolean);
|
|
70
|
+
let currentPath = canonicalRoot;
|
|
71
|
+
for (const segment of segments) {
|
|
72
|
+
currentPath = resolve(currentPath, segment);
|
|
73
|
+
try {
|
|
74
|
+
const stats = lstatSync(currentPath);
|
|
75
|
+
if (stats.isSymbolicLink()) {
|
|
76
|
+
throw new Error(`Access denied: path "${targetPath}" contains symbolic link "${segment}".`);
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
catch (error) {
|
|
80
|
+
if (error instanceof Error &&
|
|
81
|
+
error.message.startsWith("Access denied:")) {
|
|
82
|
+
throw error;
|
|
83
|
+
}
|
|
84
|
+
if (typeof error === "object" &&
|
|
85
|
+
error !== null &&
|
|
86
|
+
"code" in error &&
|
|
87
|
+
error.code === "ENOENT") {
|
|
88
|
+
// Missing component encountered: stop inspecting further components
|
|
89
|
+
// so writes to not-yet-created files remain possible.
|
|
90
|
+
break;
|
|
91
|
+
}
|
|
92
|
+
// Propagate all other permission/IO errors
|
|
93
|
+
throw error;
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
return resolvedTarget;
|
|
98
|
+
}
|
|
99
|
+
//# sourceMappingURL=pathGuard.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pathGuard.js","sources":["../../../src/tools/internal/pathGuard.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview System instruction descriptions for standard agent tools.
|
|
3
|
+
* @packageDocumentation
|
|
4
|
+
*/
|
|
5
|
+
/**
|
|
6
|
+
* System prompt description for ReadFileTool.
|
|
7
|
+
*/
|
|
8
|
+
export declare const readFileDescription: string;
|
|
9
|
+
/**
|
|
10
|
+
* System prompt description for WriteFileTool.
|
|
11
|
+
*/
|
|
12
|
+
export declare const writeFileDescription: string;
|
|
13
|
+
/**
|
|
14
|
+
* System prompt description for EditFileTool.
|
|
15
|
+
*/
|
|
16
|
+
export declare const editFileDescription: string;
|
|
17
|
+
/**
|
|
18
|
+
* System prompt description for BashTool.
|
|
19
|
+
*/
|
|
20
|
+
export declare const bashDescription: string;
|
|
21
|
+
/**
|
|
22
|
+
* System prompt description for TaskManagerTool.
|
|
23
|
+
*/
|
|
24
|
+
export declare const taskManagerDescription: string;
|
|
25
|
+
/**
|
|
26
|
+
* System prompt description for GlobTool.
|
|
27
|
+
*/
|
|
28
|
+
export declare const globDescription: string;
|
|
29
|
+
/**
|
|
30
|
+
* System prompt description for GrepTool.
|
|
31
|
+
*/
|
|
32
|
+
export declare const grepDescription: string;
|
|
33
|
+
//# sourceMappingURL=prompts.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"prompts.d.ts","sources":["../../src/tools/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAGsC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAG4B,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAG4E,CAAC;AAE7G;;GAEG;AACH,eAAO,MAAM,eAAe,QAIyB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,sBAAsB,QAGyD,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,eAAe,QAGuC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,eAAe,QAGgD,CAAC"}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview System instruction descriptions for standard agent tools.
|
|
3
|
+
* @packageDocumentation
|
|
4
|
+
*/
|
|
5
|
+
/**
|
|
6
|
+
* System prompt description for ReadFileTool.
|
|
7
|
+
*/
|
|
8
|
+
export const readFileDescription = "Reads content from a file in the workspace with 1-based line numbering. " +
|
|
9
|
+
"Supports start line offset and line limit parameters for efficiently inspecting large files. " +
|
|
10
|
+
"Binary files and blocking device files are automatically rejected.";
|
|
11
|
+
/**
|
|
12
|
+
* System prompt description for WriteFileTool.
|
|
13
|
+
*/
|
|
14
|
+
export const writeFileDescription = "Writes the complete content to a file in the workspace. " +
|
|
15
|
+
"If the file does not exist, it is created along with any necessary parent directories. " +
|
|
16
|
+
"If the file already exists, it is completely overwritten.";
|
|
17
|
+
/**
|
|
18
|
+
* System prompt description for EditFileTool.
|
|
19
|
+
*/
|
|
20
|
+
export const editFileDescription = "Performs surgical string replacement in a workspace file. " +
|
|
21
|
+
"Requires exact matching of 'oldString' with existing file content, including indentation. " +
|
|
22
|
+
"If 'oldString' appears multiple times, specify 'replaceAll: true' or provide unique surrounding context.";
|
|
23
|
+
/**
|
|
24
|
+
* System prompt description for BashTool.
|
|
25
|
+
*/
|
|
26
|
+
export const bashDescription = "Executes a shell command in the workspace directory with the host permissions of the current process user. " +
|
|
27
|
+
"Environment variables are sanitized, but the shell is not an isolated sandbox. " +
|
|
28
|
+
"Captures combined output and exit codes. Supports waitMsBeforeAsync to wait in foreground before detaching as a background task, " +
|
|
29
|
+
"and optional timeoutMs for hard process lifetime.";
|
|
30
|
+
/**
|
|
31
|
+
* System prompt description for TaskManagerTool.
|
|
32
|
+
*/
|
|
33
|
+
export const taskManagerDescription = "Manages background shell tasks. " +
|
|
34
|
+
"Supports spawning new commands, listing active and recent tasks, line-paged log inspection with offset and limit, " +
|
|
35
|
+
"delivering interactive stdin input, terminating processes, and deleting completed tasks.";
|
|
36
|
+
/**
|
|
37
|
+
* System prompt description for GlobTool.
|
|
38
|
+
*/
|
|
39
|
+
export const globDescription = "Searches for files across the workspace matching a glob pattern (e.g. '**/*.ts', 'src/**/*.json'). " +
|
|
40
|
+
"Automatically ignores version control and dependency directories like .git and node_modules. " +
|
|
41
|
+
"Returns matching relative file paths with a cap of 250 results.";
|
|
42
|
+
/**
|
|
43
|
+
* System prompt description for GrepTool.
|
|
44
|
+
*/
|
|
45
|
+
export const grepDescription = "Searches file contents across the workspace matching a regular expression or plain text pattern. " +
|
|
46
|
+
"Supports path scoping, file glob filtering, and case-insensitive matching. " +
|
|
47
|
+
"Returns matching relative file paths with line numbers and line content.";
|
|
48
|
+
//# sourceMappingURL=prompts.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"prompts.js","sources":["../../src/tools/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,0EAA0E;IAC1E,+FAA+F;IAC/F,oEAAoE,CAAC;AAEvE;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAC/B,0DAA0D;IAC1D,yFAAyF;IACzF,2DAA2D,CAAC;AAE9D;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,4DAA4D;IAC5D,4FAA4F;IAC5F,0GAA0G,CAAC;AAE7G;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAC1B,6GAA6G;IAC7G,iFAAiF;IACjF,mIAAmI;IACnI,mDAAmD,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GACjC,kCAAkC;IAClC,oHAAoH;IACpH,0FAA0F,CAAC;AAE7F;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAC1B,qGAAqG;IACrG,+FAA+F;IAC/F,iEAAiE,CAAC;AAEpE;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAC1B,mGAAmG;IACnG,6EAA6E;IAC7E,0EAA0E,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,66 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@amaranthic/hernex",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.2.0",
|
|
4
|
+
"description": "Unified AI agent runtime, microkernel engine, and tool harnesses built on Vercel AI SDK",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "./dist/index.js",
|
|
7
|
+
"types": "./dist/index.d.ts",
|
|
8
|
+
"exports": {
|
|
9
|
+
".": {
|
|
10
|
+
"types": "./dist/index.d.ts",
|
|
11
|
+
"import": "./dist/index.js",
|
|
12
|
+
"default": "./dist/index.js"
|
|
13
|
+
},
|
|
14
|
+
"./ai": {
|
|
15
|
+
"types": "./dist/ai.d.ts",
|
|
16
|
+
"import": "./dist/ai.js",
|
|
17
|
+
"default": "./dist/ai.js"
|
|
18
|
+
}
|
|
19
|
+
},
|
|
20
|
+
"files": [
|
|
21
|
+
"dist"
|
|
22
|
+
],
|
|
23
|
+
"publishConfig": {
|
|
24
|
+
"access": "public"
|
|
25
|
+
},
|
|
26
|
+
"scripts": {
|
|
27
|
+
"build": "tsc",
|
|
28
|
+
"typecheck": "tsc --project tsconfig.test.json",
|
|
29
|
+
"test": "bun test",
|
|
30
|
+
"clean": "rm -rf dist"
|
|
31
|
+
},
|
|
32
|
+
"engines": {
|
|
33
|
+
"node": ">=22.0.0"
|
|
34
|
+
},
|
|
35
|
+
"repository": {
|
|
36
|
+
"type": "git",
|
|
37
|
+
"url": "git+https://github.com/amaranthic/harnex.git"
|
|
38
|
+
},
|
|
39
|
+
"homepage": "https://github.com/amaranthic/harnex#readme",
|
|
40
|
+
"bugs": {
|
|
41
|
+
"url": "https://github.com/amaranthic/harnex/issues"
|
|
42
|
+
},
|
|
43
|
+
"author": "Amaranthic",
|
|
44
|
+
"license": "MIT",
|
|
45
|
+
"dependencies": {
|
|
46
|
+
"@ai-sdk/alibaba": "2.0.73",
|
|
47
|
+
"@ai-sdk/anthropic": "4.0.85",
|
|
48
|
+
"@ai-sdk/cohere": "4.0.66",
|
|
49
|
+
"@ai-sdk/deepseek": "3.0.70",
|
|
50
|
+
"@ai-sdk/gateway": "4.0.121",
|
|
51
|
+
"@ai-sdk/google": "4.0.102",
|
|
52
|
+
"@ai-sdk/groq": "4.0.67",
|
|
53
|
+
"@ai-sdk/mistral": "4.0.69",
|
|
54
|
+
"@ai-sdk/openai": "4.0.99",
|
|
55
|
+
"@ai-sdk/openai-compatible": "3.0.75",
|
|
56
|
+
"@ai-sdk/togetherai": "3.0.76",
|
|
57
|
+
"@ai-sdk/xai": "5.0.27",
|
|
58
|
+
"ai": "7.0.148",
|
|
59
|
+
"zod": "4.6.7"
|
|
60
|
+
},
|
|
61
|
+
"devDependencies": {
|
|
62
|
+
"@types/bun": "^1.4.3",
|
|
63
|
+
"@types/node": "26.6.5",
|
|
64
|
+
"typescript": "7.0.2"
|
|
65
|
+
}
|
|
66
|
+
}
|