actionwall 0.1.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/CHANGELOG.md +16 -0
- package/LICENSE +21 -0
- package/README.md +204 -0
- package/dist/cli/format.d.ts +26 -0
- package/dist/cli/format.js +74 -0
- package/dist/cli/format.js.map +1 -0
- package/dist/cli/index.d.ts +12 -0
- package/dist/cli/index.js +156 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/core/audit.d.ts +61 -0
- package/dist/core/audit.js +126 -0
- package/dist/core/audit.js.map +1 -0
- package/dist/core/engine.d.ts +48 -0
- package/dist/core/engine.js +140 -0
- package/dist/core/engine.js.map +1 -0
- package/dist/core/policy.d.ts +307 -0
- package/dist/core/policy.js +138 -0
- package/dist/core/policy.js.map +1 -0
- package/dist/core/types.d.ts +147 -0
- package/dist/core/types.js +24 -0
- package/dist/core/types.js.map +1 -0
- package/dist/demo/mockAgent.d.ts +33 -0
- package/dist/demo/mockAgent.js +130 -0
- package/dist/demo/mockAgent.js.map +1 -0
- package/dist/index.d.ts +27 -0
- package/dist/index.js +26 -0
- package/dist/index.js.map +1 -0
- package/dist/scanners/commandRisk.d.ts +20 -0
- package/dist/scanners/commandRisk.js +335 -0
- package/dist/scanners/commandRisk.js.map +1 -0
- package/dist/scanners/filePolicy.d.ts +15 -0
- package/dist/scanners/filePolicy.js +165 -0
- package/dist/scanners/filePolicy.js.map +1 -0
- package/dist/scanners/injection.d.ts +15 -0
- package/dist/scanners/injection.js +111 -0
- package/dist/scanners/injection.js.map +1 -0
- package/dist/scanners/secrets.d.ts +12 -0
- package/dist/scanners/secrets.js +102 -0
- package/dist/scanners/secrets.js.map +1 -0
- package/dist/scanners/toolPermissions.d.ts +7 -0
- package/dist/scanners/toolPermissions.js +60 -0
- package/dist/scanners/toolPermissions.js.map +1 -0
- package/dist/scanners/urlPolicy.d.ts +16 -0
- package/dist/scanners/urlPolicy.js +176 -0
- package/dist/scanners/urlPolicy.js.map +1 -0
- package/dist/util/ansi.d.ts +13 -0
- package/dist/util/ansi.js +20 -0
- package/dist/util/ansi.js.map +1 -0
- package/dist/util/entropy.d.ts +6 -0
- package/dist/util/entropy.js +20 -0
- package/dist/util/entropy.js.map +1 -0
- package/dist/util/paths.d.ts +43 -0
- package/dist/util/paths.js +192 -0
- package/dist/util/paths.js.map +1 -0
- package/dist/util/secretPatterns.d.ts +19 -0
- package/dist/util/secretPatterns.js +93 -0
- package/dist/util/secretPatterns.js.map +1 -0
- package/dist/util/shell.d.ts +31 -0
- package/dist/util/shell.js +154 -0
- package/dist/util/shell.js.map +1 -0
- package/docs/ARCHITECTURE.md +115 -0
- package/docs/COMPARISON.md +99 -0
- package/docs/POLICY_REFERENCE.md +126 -0
- package/docs/REQUIREMENTS.md +87 -0
- package/docs/ROADMAP.md +36 -0
- package/docs/THREAT_MODEL.md +88 -0
- package/package.json +67 -0
- package/policies/default.yaml +70 -0
- package/policies/readonly.yaml +58 -0
- package/policies/strict.yaml +75 -0
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Append-only JSONL audit log with a SHA-256 hash chain.
|
|
3
|
+
*
|
|
4
|
+
* Every record embeds the hash of the previous record, so deleting or editing
|
|
5
|
+
* an entry after the fact breaks the chain and is caught by `verify()`.
|
|
6
|
+
* This gives agents (and their humans) a tamper-evident record of everything
|
|
7
|
+
* the firewall allowed or blocked.
|
|
8
|
+
*
|
|
9
|
+
* Records are written synchronously with appendFileSync. At firewall
|
|
10
|
+
* latencies (<50ms per decision) the syscall cost is acceptable and durability
|
|
11
|
+
* is worth more than throughput; batching is a listed roadmap item.
|
|
12
|
+
*/
|
|
13
|
+
import { createHash } from "node:crypto";
|
|
14
|
+
import { existsSync, mkdirSync, readFileSync, appendFileSync, readdirSync } from "node:fs";
|
|
15
|
+
import * as path from "node:path";
|
|
16
|
+
import { redactText } from "../util/secretPatterns.js";
|
|
17
|
+
export const GENESIS_HASH = "0".repeat(64);
|
|
18
|
+
function sha256(input) {
|
|
19
|
+
return createHash("sha256").update(input).digest("hex");
|
|
20
|
+
}
|
|
21
|
+
export class AuditLogger {
|
|
22
|
+
logDir;
|
|
23
|
+
redactSecrets;
|
|
24
|
+
/** Cache of {file → {prevHash, seq}} so appends don't re-read the file. */
|
|
25
|
+
tips = new Map();
|
|
26
|
+
constructor(opts) {
|
|
27
|
+
this.logDir = opts.logDir;
|
|
28
|
+
this.redactSecrets = opts.redactSecrets;
|
|
29
|
+
}
|
|
30
|
+
/** Today's log file: audit-YYYY-MM-DD.jsonl */
|
|
31
|
+
fileFor(date = new Date()) {
|
|
32
|
+
const day = date.toISOString().slice(0, 10);
|
|
33
|
+
return path.join(this.logDir, `audit-${day}.jsonl`);
|
|
34
|
+
}
|
|
35
|
+
listFiles() {
|
|
36
|
+
if (!existsSync(this.logDir))
|
|
37
|
+
return [];
|
|
38
|
+
return readdirSync(this.logDir)
|
|
39
|
+
.filter((f) => f.endsWith(".jsonl"))
|
|
40
|
+
.sort()
|
|
41
|
+
.map((f) => path.join(this.logDir, f));
|
|
42
|
+
}
|
|
43
|
+
/** Append a decision (with its action) to today's log. Returns the entry written. */
|
|
44
|
+
append(decision, action) {
|
|
45
|
+
const file = this.fileFor(new Date(decision.timestamp));
|
|
46
|
+
mkdirSync(path.dirname(file), { recursive: true });
|
|
47
|
+
const tip = this.tipFor(file);
|
|
48
|
+
const seq = tip.seq + 1;
|
|
49
|
+
const paramsJson = JSON.stringify(action.params, null, 0);
|
|
50
|
+
const entry = {
|
|
51
|
+
seq,
|
|
52
|
+
timestamp: decision.timestamp,
|
|
53
|
+
prevHash: tip.prevHash,
|
|
54
|
+
hash: "", // filled below; the chain covers the record body without `hash`
|
|
55
|
+
decision: {
|
|
56
|
+
verdict: decision.verdict,
|
|
57
|
+
risk: decision.risk,
|
|
58
|
+
summary: decision.summary,
|
|
59
|
+
findings: decision.findings,
|
|
60
|
+
latencyMs: decision.latencyMs,
|
|
61
|
+
},
|
|
62
|
+
action: {
|
|
63
|
+
id: action.id,
|
|
64
|
+
agentId: action.agentId,
|
|
65
|
+
tool: action.tool,
|
|
66
|
+
params: this.redactSecrets ? redactText(paramsJson) : paramsJson,
|
|
67
|
+
},
|
|
68
|
+
};
|
|
69
|
+
entry.hash = sha256(entry.prevHash + JSON.stringify({ ...entry, hash: "" }));
|
|
70
|
+
appendFileSync(file, JSON.stringify(entry) + "\n", "utf8");
|
|
71
|
+
this.tips.set(file, { prevHash: entry.hash, seq });
|
|
72
|
+
return entry;
|
|
73
|
+
}
|
|
74
|
+
/** Re-walk the whole chain of a log file and confirm every link. */
|
|
75
|
+
verify(file = this.fileFor()) {
|
|
76
|
+
if (!existsSync(file)) {
|
|
77
|
+
return { file, entries: 0, ok: true, reason: "no log file yet" };
|
|
78
|
+
}
|
|
79
|
+
const lines = readFileSync(file, "utf8").split("\n").filter((l) => l.trim().length > 0);
|
|
80
|
+
let prevHash = GENESIS_HASH;
|
|
81
|
+
for (let i = 0; i < lines.length; i++) {
|
|
82
|
+
let entry;
|
|
83
|
+
try {
|
|
84
|
+
entry = JSON.parse(lines[i]);
|
|
85
|
+
}
|
|
86
|
+
catch (err) {
|
|
87
|
+
return { file, entries: i, ok: false, brokenAt: i + 1, reason: `unparseable line ${(i + 1)}: ${err.message}` };
|
|
88
|
+
}
|
|
89
|
+
if (entry.prevHash !== prevHash) {
|
|
90
|
+
return { file, entries: i, ok: false, brokenAt: entry.seq, reason: "prevHash does not match previous record" };
|
|
91
|
+
}
|
|
92
|
+
const expected = sha256(entry.prevHash + JSON.stringify({ ...entry, hash: "" }));
|
|
93
|
+
if (entry.hash !== expected) {
|
|
94
|
+
return { file, entries: i, ok: false, brokenAt: entry.seq, reason: "record hash mismatch — record was modified" };
|
|
95
|
+
}
|
|
96
|
+
prevHash = entry.hash;
|
|
97
|
+
}
|
|
98
|
+
return { file, entries: lines.length, ok: true };
|
|
99
|
+
}
|
|
100
|
+
/** Last `n` entries of a log file (default today's), oldest last. */
|
|
101
|
+
tail(n, file = this.fileFor()) {
|
|
102
|
+
if (!existsSync(file))
|
|
103
|
+
return [];
|
|
104
|
+
const lines = readFileSync(file, "utf8").split("\n").filter((l) => l.trim().length > 0);
|
|
105
|
+
return lines.slice(-n).map((l) => JSON.parse(l));
|
|
106
|
+
}
|
|
107
|
+
tipFor(file) {
|
|
108
|
+
const cached = this.tips.get(file);
|
|
109
|
+
if (cached)
|
|
110
|
+
return cached;
|
|
111
|
+
let prevHash = GENESIS_HASH;
|
|
112
|
+
let seq = 0;
|
|
113
|
+
if (existsSync(file)) {
|
|
114
|
+
const lines = readFileSync(file, "utf8").split("\n").filter((l) => l.trim().length > 0);
|
|
115
|
+
if (lines.length > 0) {
|
|
116
|
+
const last = JSON.parse(lines[lines.length - 1]);
|
|
117
|
+
prevHash = last.hash;
|
|
118
|
+
seq = last.seq;
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
const tip = { prevHash, seq };
|
|
122
|
+
this.tips.set(file, tip);
|
|
123
|
+
return tip;
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
//# sourceMappingURL=audit.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/core/audit.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ShieldEngine — the firewall itself.
|
|
3
|
+
*
|
|
4
|
+
* Pipeline for one action:
|
|
5
|
+
* 1. run every scanner (order: tool permissions → command risk → file
|
|
6
|
+
* policy → secrets → URL policy → injection) and collect findings
|
|
7
|
+
* 2. aggregate severity (worst finding wins)
|
|
8
|
+
* 3. map severity → verdict via the policy's risk_thresholds
|
|
9
|
+
* 4. write the decision to the tamper-evident audit log
|
|
10
|
+
*
|
|
11
|
+
* Failure semantics: a scanner that throws produces a synthetic finding.
|
|
12
|
+
* With fail_closed (default) that finding is CRITICAL — a broken firewall
|
|
13
|
+
* blocks instead of waving everything through.
|
|
14
|
+
*/
|
|
15
|
+
import type { Action, Decision, Scanner } from "./types.js";
|
|
16
|
+
import type { PolicyDoc } from "./types.js";
|
|
17
|
+
import { AuditLogger } from "./audit.js";
|
|
18
|
+
export declare const DEFAULT_SCANNERS: Scanner[];
|
|
19
|
+
export declare class ActionBlockedError extends Error {
|
|
20
|
+
readonly decision: Decision;
|
|
21
|
+
constructor(decision: Decision);
|
|
22
|
+
}
|
|
23
|
+
export interface ShieldEngineOptions {
|
|
24
|
+
/** Pass `false` to disable audit logging entirely. */
|
|
25
|
+
audit?: AuditLogger | false;
|
|
26
|
+
/** Replace or extend the scanner set. */
|
|
27
|
+
scanners?: Scanner[];
|
|
28
|
+
}
|
|
29
|
+
export declare class ShieldEngine {
|
|
30
|
+
readonly policy: PolicyDoc;
|
|
31
|
+
readonly audit?: AuditLogger;
|
|
32
|
+
private readonly scanners;
|
|
33
|
+
constructor(policy: PolicyDoc, options?: ShieldEngineOptions);
|
|
34
|
+
/** Inspect an action and return the decision. Never throws for policy reasons. */
|
|
35
|
+
check(action: Action): Decision;
|
|
36
|
+
/** `check` + throw ActionBlockedError on BLOCK — the integration shape for agents. */
|
|
37
|
+
guard(action: Action): Decision;
|
|
38
|
+
private verdictFor;
|
|
39
|
+
}
|
|
40
|
+
/** Convenience: build an Action with sane defaults (used by CLI and demos). */
|
|
41
|
+
export declare function makeAction(input: {
|
|
42
|
+
tool: string;
|
|
43
|
+
params: Record<string, unknown>;
|
|
44
|
+
agentId?: string;
|
|
45
|
+
sessionId?: string;
|
|
46
|
+
context?: Action["context"];
|
|
47
|
+
id?: string;
|
|
48
|
+
}): Action;
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ShieldEngine — the firewall itself.
|
|
3
|
+
*
|
|
4
|
+
* Pipeline for one action:
|
|
5
|
+
* 1. run every scanner (order: tool permissions → command risk → file
|
|
6
|
+
* policy → secrets → URL policy → injection) and collect findings
|
|
7
|
+
* 2. aggregate severity (worst finding wins)
|
|
8
|
+
* 3. map severity → verdict via the policy's risk_thresholds
|
|
9
|
+
* 4. write the decision to the tamper-evident audit log
|
|
10
|
+
*
|
|
11
|
+
* Failure semantics: a scanner that throws produces a synthetic finding.
|
|
12
|
+
* With fail_closed (default) that finding is CRITICAL — a broken firewall
|
|
13
|
+
* blocks instead of waving everything through.
|
|
14
|
+
*/
|
|
15
|
+
import { randomUUID } from "node:crypto";
|
|
16
|
+
import { AuditLogger } from "./audit.js";
|
|
17
|
+
import { toolPermissionsScanner } from "../scanners/toolPermissions.js";
|
|
18
|
+
import { commandRiskScanner } from "../scanners/commandRisk.js";
|
|
19
|
+
import { filePolicyScanner } from "../scanners/filePolicy.js";
|
|
20
|
+
import { secretsScanner } from "../scanners/secrets.js";
|
|
21
|
+
import { urlPolicyScanner } from "../scanners/urlPolicy.js";
|
|
22
|
+
import { injectionScanner } from "../scanners/injection.js";
|
|
23
|
+
import { maxSeverity } from "./types.js";
|
|
24
|
+
export const DEFAULT_SCANNERS = [
|
|
25
|
+
toolPermissionsScanner,
|
|
26
|
+
commandRiskScanner,
|
|
27
|
+
filePolicyScanner,
|
|
28
|
+
secretsScanner,
|
|
29
|
+
urlPolicyScanner,
|
|
30
|
+
injectionScanner,
|
|
31
|
+
];
|
|
32
|
+
export class ActionBlockedError extends Error {
|
|
33
|
+
decision;
|
|
34
|
+
constructor(decision) {
|
|
35
|
+
super(`ActionWall ${decision.verdict}: ${decision.summary}`);
|
|
36
|
+
this.decision = decision;
|
|
37
|
+
this.name = "ActionBlockedError";
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
export class ShieldEngine {
|
|
41
|
+
policy;
|
|
42
|
+
audit;
|
|
43
|
+
scanners;
|
|
44
|
+
constructor(policy, options = {}) {
|
|
45
|
+
this.policy = policy;
|
|
46
|
+
this.scanners = options.scanners ?? DEFAULT_SCANNERS;
|
|
47
|
+
if (policy.audit.enabled && options.audit !== false) {
|
|
48
|
+
this.audit =
|
|
49
|
+
options.audit ??
|
|
50
|
+
new AuditLogger({ logDir: policy.audit.log_dir, redactSecrets: policy.audit.redact_secrets });
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
/** Inspect an action and return the decision. Never throws for policy reasons. */
|
|
54
|
+
check(action) {
|
|
55
|
+
const started = performance.now();
|
|
56
|
+
const timestamp = new Date().toISOString();
|
|
57
|
+
const findings = [];
|
|
58
|
+
for (const scanner of this.scanners) {
|
|
59
|
+
try {
|
|
60
|
+
findings.push(...scanner.scan(action, this.policy));
|
|
61
|
+
}
|
|
62
|
+
catch (err) {
|
|
63
|
+
findings.push({
|
|
64
|
+
scanner: scanner.name,
|
|
65
|
+
ruleId: "SCANNER-FAILURE",
|
|
66
|
+
severity: this.policy.fail_closed ? "CRITICAL" : "LOW",
|
|
67
|
+
title: this.policy.fail_closed ? "Scanner failure (fail-closed)" : "Scanner failure (fail-open)",
|
|
68
|
+
reason: `Scanner "${scanner.name}" threw an error and the policy is fail_${this.policy.fail_closed ? "closed" : "open"}: ${err.message}`,
|
|
69
|
+
});
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
const risk = maxSeverity(findings);
|
|
73
|
+
const verdict = this.verdictFor(risk);
|
|
74
|
+
const decision = {
|
|
75
|
+
actionId: action.id,
|
|
76
|
+
agentId: action.agentId,
|
|
77
|
+
tool: action.tool,
|
|
78
|
+
verdict,
|
|
79
|
+
risk,
|
|
80
|
+
findings,
|
|
81
|
+
summary: headline(findings, verdict),
|
|
82
|
+
latencyMs: Math.round((performance.now() - started) * 100) / 100,
|
|
83
|
+
timestamp,
|
|
84
|
+
};
|
|
85
|
+
if (this.audit && (verdict !== "ALLOW" || this.policy.audit.log_allowed)) {
|
|
86
|
+
try {
|
|
87
|
+
this.audit.append(decision, action);
|
|
88
|
+
}
|
|
89
|
+
catch (err) {
|
|
90
|
+
// Audit failures must not lose the decision itself.
|
|
91
|
+
decision.findings.push({
|
|
92
|
+
scanner: "audit",
|
|
93
|
+
ruleId: "AUDIT-WRITE-FAILURE",
|
|
94
|
+
severity: this.policy.fail_closed ? "CRITICAL" : "LOW",
|
|
95
|
+
title: "Audit log write failed",
|
|
96
|
+
reason: `Failed to append to the audit log: ${err.message}`,
|
|
97
|
+
});
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
return decision;
|
|
101
|
+
}
|
|
102
|
+
/** `check` + throw ActionBlockedError on BLOCK — the integration shape for agents. */
|
|
103
|
+
guard(action) {
|
|
104
|
+
const decision = this.check(action);
|
|
105
|
+
if (decision.verdict === "BLOCK")
|
|
106
|
+
throw new ActionBlockedError(decision);
|
|
107
|
+
return decision;
|
|
108
|
+
}
|
|
109
|
+
verdictFor(risk) {
|
|
110
|
+
if (this.policy.risk_thresholds.block.includes(risk))
|
|
111
|
+
return "BLOCK";
|
|
112
|
+
if (this.policy.risk_thresholds.ask.includes(risk))
|
|
113
|
+
return "ASK_HUMAN";
|
|
114
|
+
return "ALLOW";
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
function headline(findings, verdict) {
|
|
118
|
+
if (findings.length === 0)
|
|
119
|
+
return "No policy violations detected";
|
|
120
|
+
const order = ["CRITICAL", "HIGH", "MEDIUM", "LOW"];
|
|
121
|
+
for (const level of order) {
|
|
122
|
+
const worst = findings.find((f) => f.severity === level);
|
|
123
|
+
if (worst)
|
|
124
|
+
return worst.title;
|
|
125
|
+
}
|
|
126
|
+
return verdict === "ALLOW" ? "Allowed with warnings" : "Policy violation";
|
|
127
|
+
}
|
|
128
|
+
/** Convenience: build an Action with sane defaults (used by CLI and demos). */
|
|
129
|
+
export function makeAction(input) {
|
|
130
|
+
return {
|
|
131
|
+
id: input.id ?? randomUUID(),
|
|
132
|
+
timestamp: new Date().toISOString(),
|
|
133
|
+
agentId: input.agentId ?? "default-agent",
|
|
134
|
+
sessionId: input.sessionId,
|
|
135
|
+
tool: input.tool,
|
|
136
|
+
params: input.params,
|
|
137
|
+
context: input.context,
|
|
138
|
+
};
|
|
139
|
+
}
|
|
140
|
+
//# sourceMappingURL=engine.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/core/engine.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,307 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Policy loading + validation.
|
|
3
|
+
*
|
|
4
|
+
* A policy is a YAML (or JSON) document validated with zod. Every section has
|
|
5
|
+
* safe defaults, so `loadPolicy()` with no path yields the built-in baseline
|
|
6
|
+
* (the same defaults shipped in policies/default.yaml).
|
|
7
|
+
*/
|
|
8
|
+
import { z } from "zod";
|
|
9
|
+
import type { PolicyDoc, RiskLevel } from "./types.js";
|
|
10
|
+
export declare const riskLevelSchema: z.ZodEnum<["LOW", "MEDIUM", "HIGH", "CRITICAL"]>;
|
|
11
|
+
export declare const policySchema: z.ZodObject<{
|
|
12
|
+
version: z.ZodDefault<z.ZodLiteral<1>>;
|
|
13
|
+
name: z.ZodDefault<z.ZodString>;
|
|
14
|
+
description: z.ZodOptional<z.ZodString>;
|
|
15
|
+
fail_closed: z.ZodDefault<z.ZodBoolean>;
|
|
16
|
+
risk_thresholds: z.ZodEffects<z.ZodObject<{
|
|
17
|
+
block: z.ZodDefault<z.ZodArray<z.ZodEnum<["LOW", "MEDIUM", "HIGH", "CRITICAL"]>, "many">>;
|
|
18
|
+
ask: z.ZodDefault<z.ZodArray<z.ZodEnum<["LOW", "MEDIUM", "HIGH", "CRITICAL"]>, "many">>;
|
|
19
|
+
}, "strip", z.ZodTypeAny, {
|
|
20
|
+
block: ("LOW" | "MEDIUM" | "HIGH" | "CRITICAL")[];
|
|
21
|
+
ask: ("LOW" | "MEDIUM" | "HIGH" | "CRITICAL")[];
|
|
22
|
+
}, {
|
|
23
|
+
block?: ("LOW" | "MEDIUM" | "HIGH" | "CRITICAL")[] | undefined;
|
|
24
|
+
ask?: ("LOW" | "MEDIUM" | "HIGH" | "CRITICAL")[] | undefined;
|
|
25
|
+
}>, {
|
|
26
|
+
block: ("LOW" | "MEDIUM" | "HIGH" | "CRITICAL")[];
|
|
27
|
+
ask: ("LOW" | "MEDIUM" | "HIGH" | "CRITICAL")[];
|
|
28
|
+
}, unknown>;
|
|
29
|
+
tools: z.ZodEffects<z.ZodObject<{
|
|
30
|
+
default: z.ZodDefault<z.ZodEnum<["allow", "deny"]>>;
|
|
31
|
+
allow: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
|
|
32
|
+
deny: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
|
|
33
|
+
agents: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
|
|
34
|
+
default: z.ZodOptional<z.ZodEnum<["allow", "deny"]>>;
|
|
35
|
+
allow: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
|
|
36
|
+
deny: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
|
|
37
|
+
}, "strip", z.ZodTypeAny, {
|
|
38
|
+
deny: string[];
|
|
39
|
+
allow: string[];
|
|
40
|
+
default?: "deny" | "allow" | undefined;
|
|
41
|
+
}, {
|
|
42
|
+
deny?: string[] | undefined;
|
|
43
|
+
allow?: string[] | undefined;
|
|
44
|
+
default?: "deny" | "allow" | undefined;
|
|
45
|
+
}>>>;
|
|
46
|
+
}, "strip", z.ZodTypeAny, {
|
|
47
|
+
deny: string[];
|
|
48
|
+
allow: string[];
|
|
49
|
+
default: "deny" | "allow";
|
|
50
|
+
agents: Record<string, {
|
|
51
|
+
deny: string[];
|
|
52
|
+
allow: string[];
|
|
53
|
+
default?: "deny" | "allow" | undefined;
|
|
54
|
+
}>;
|
|
55
|
+
}, {
|
|
56
|
+
deny?: string[] | undefined;
|
|
57
|
+
allow?: string[] | undefined;
|
|
58
|
+
default?: "deny" | "allow" | undefined;
|
|
59
|
+
agents?: Record<string, {
|
|
60
|
+
deny?: string[] | undefined;
|
|
61
|
+
allow?: string[] | undefined;
|
|
62
|
+
default?: "deny" | "allow" | undefined;
|
|
63
|
+
}> | undefined;
|
|
64
|
+
}>, {
|
|
65
|
+
deny: string[];
|
|
66
|
+
allow: string[];
|
|
67
|
+
default: "deny" | "allow";
|
|
68
|
+
agents: Record<string, {
|
|
69
|
+
deny: string[];
|
|
70
|
+
allow: string[];
|
|
71
|
+
default?: "deny" | "allow" | undefined;
|
|
72
|
+
}>;
|
|
73
|
+
}, unknown>;
|
|
74
|
+
command_risk: z.ZodEffects<z.ZodObject<{
|
|
75
|
+
blocked_patterns: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
|
|
76
|
+
}, "strip", z.ZodTypeAny, {
|
|
77
|
+
blocked_patterns: string[];
|
|
78
|
+
}, {
|
|
79
|
+
blocked_patterns?: string[] | undefined;
|
|
80
|
+
}>, {
|
|
81
|
+
blocked_patterns: string[];
|
|
82
|
+
}, unknown>;
|
|
83
|
+
file_policy: z.ZodEffects<z.ZodObject<{
|
|
84
|
+
protected_paths: z.ZodDefault<z.ZodArray<z.ZodObject<{
|
|
85
|
+
path: z.ZodString;
|
|
86
|
+
permissions: z.ZodDefault<z.ZodArray<z.ZodEnum<["deny", "readonly", "allow"]>, "many">>;
|
|
87
|
+
description: z.ZodOptional<z.ZodString>;
|
|
88
|
+
}, "strip", z.ZodTypeAny, {
|
|
89
|
+
path: string;
|
|
90
|
+
permissions: ("deny" | "readonly" | "allow")[];
|
|
91
|
+
description?: string | undefined;
|
|
92
|
+
}, {
|
|
93
|
+
path: string;
|
|
94
|
+
permissions?: ("deny" | "readonly" | "allow")[] | undefined;
|
|
95
|
+
description?: string | undefined;
|
|
96
|
+
}>, "many">>;
|
|
97
|
+
max_bulk_delete: z.ZodDefault<z.ZodNumber>;
|
|
98
|
+
workspace_root: z.ZodOptional<z.ZodString>;
|
|
99
|
+
allow_outside_workspace: z.ZodDefault<z.ZodBoolean>;
|
|
100
|
+
}, "strip", z.ZodTypeAny, {
|
|
101
|
+
protected_paths: {
|
|
102
|
+
path: string;
|
|
103
|
+
permissions: ("deny" | "readonly" | "allow")[];
|
|
104
|
+
description?: string | undefined;
|
|
105
|
+
}[];
|
|
106
|
+
max_bulk_delete: number;
|
|
107
|
+
allow_outside_workspace: boolean;
|
|
108
|
+
workspace_root?: string | undefined;
|
|
109
|
+
}, {
|
|
110
|
+
protected_paths?: {
|
|
111
|
+
path: string;
|
|
112
|
+
permissions?: ("deny" | "readonly" | "allow")[] | undefined;
|
|
113
|
+
description?: string | undefined;
|
|
114
|
+
}[] | undefined;
|
|
115
|
+
max_bulk_delete?: number | undefined;
|
|
116
|
+
workspace_root?: string | undefined;
|
|
117
|
+
allow_outside_workspace?: boolean | undefined;
|
|
118
|
+
}>, {
|
|
119
|
+
protected_paths: {
|
|
120
|
+
path: string;
|
|
121
|
+
permissions: ("deny" | "readonly" | "allow")[];
|
|
122
|
+
description?: string | undefined;
|
|
123
|
+
}[];
|
|
124
|
+
max_bulk_delete: number;
|
|
125
|
+
allow_outside_workspace: boolean;
|
|
126
|
+
workspace_root?: string | undefined;
|
|
127
|
+
}, unknown>;
|
|
128
|
+
url_policy: z.ZodEffects<z.ZodObject<{
|
|
129
|
+
allowed_schemes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
|
|
130
|
+
allowed_domains: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
|
|
131
|
+
denied_domains: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
|
|
132
|
+
block_private_networks: z.ZodDefault<z.ZodBoolean>;
|
|
133
|
+
}, "strip", z.ZodTypeAny, {
|
|
134
|
+
allowed_schemes: string[];
|
|
135
|
+
allowed_domains: string[];
|
|
136
|
+
denied_domains: string[];
|
|
137
|
+
block_private_networks: boolean;
|
|
138
|
+
}, {
|
|
139
|
+
allowed_schemes?: string[] | undefined;
|
|
140
|
+
allowed_domains?: string[] | undefined;
|
|
141
|
+
denied_domains?: string[] | undefined;
|
|
142
|
+
block_private_networks?: boolean | undefined;
|
|
143
|
+
}>, {
|
|
144
|
+
allowed_schemes: string[];
|
|
145
|
+
allowed_domains: string[];
|
|
146
|
+
denied_domains: string[];
|
|
147
|
+
block_private_networks: boolean;
|
|
148
|
+
}, unknown>;
|
|
149
|
+
secrets: z.ZodEffects<z.ZodObject<{
|
|
150
|
+
enabled: z.ZodDefault<z.ZodBoolean>;
|
|
151
|
+
scan_entropy: z.ZodDefault<z.ZodBoolean>;
|
|
152
|
+
custom_patterns: z.ZodDefault<z.ZodArray<z.ZodObject<{
|
|
153
|
+
name: z.ZodString;
|
|
154
|
+
regex: z.ZodString;
|
|
155
|
+
severity: z.ZodDefault<z.ZodEnum<["LOW", "MEDIUM", "HIGH", "CRITICAL"]>>;
|
|
156
|
+
}, "strip", z.ZodTypeAny, {
|
|
157
|
+
regex: string;
|
|
158
|
+
name: string;
|
|
159
|
+
severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
|
|
160
|
+
}, {
|
|
161
|
+
regex: string;
|
|
162
|
+
name: string;
|
|
163
|
+
severity?: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL" | undefined;
|
|
164
|
+
}>, "many">>;
|
|
165
|
+
}, "strip", z.ZodTypeAny, {
|
|
166
|
+
enabled: boolean;
|
|
167
|
+
scan_entropy: boolean;
|
|
168
|
+
custom_patterns: {
|
|
169
|
+
regex: string;
|
|
170
|
+
name: string;
|
|
171
|
+
severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
|
|
172
|
+
}[];
|
|
173
|
+
}, {
|
|
174
|
+
enabled?: boolean | undefined;
|
|
175
|
+
scan_entropy?: boolean | undefined;
|
|
176
|
+
custom_patterns?: {
|
|
177
|
+
regex: string;
|
|
178
|
+
name: string;
|
|
179
|
+
severity?: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL" | undefined;
|
|
180
|
+
}[] | undefined;
|
|
181
|
+
}>, {
|
|
182
|
+
enabled: boolean;
|
|
183
|
+
scan_entropy: boolean;
|
|
184
|
+
custom_patterns: {
|
|
185
|
+
regex: string;
|
|
186
|
+
name: string;
|
|
187
|
+
severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
|
|
188
|
+
}[];
|
|
189
|
+
}, unknown>;
|
|
190
|
+
injection: z.ZodEffects<z.ZodObject<{
|
|
191
|
+
enabled: z.ZodDefault<z.ZodBoolean>;
|
|
192
|
+
hits_for_high: z.ZodDefault<z.ZodNumber>;
|
|
193
|
+
}, "strip", z.ZodTypeAny, {
|
|
194
|
+
enabled: boolean;
|
|
195
|
+
hits_for_high: number;
|
|
196
|
+
}, {
|
|
197
|
+
enabled?: boolean | undefined;
|
|
198
|
+
hits_for_high?: number | undefined;
|
|
199
|
+
}>, {
|
|
200
|
+
enabled: boolean;
|
|
201
|
+
hits_for_high: number;
|
|
202
|
+
}, unknown>;
|
|
203
|
+
audit: z.ZodEffects<z.ZodObject<{
|
|
204
|
+
enabled: z.ZodDefault<z.ZodBoolean>;
|
|
205
|
+
log_dir: z.ZodDefault<z.ZodString>;
|
|
206
|
+
redact_secrets: z.ZodDefault<z.ZodBoolean>;
|
|
207
|
+
log_allowed: z.ZodDefault<z.ZodBoolean>;
|
|
208
|
+
}, "strip", z.ZodTypeAny, {
|
|
209
|
+
enabled: boolean;
|
|
210
|
+
log_dir: string;
|
|
211
|
+
redact_secrets: boolean;
|
|
212
|
+
log_allowed: boolean;
|
|
213
|
+
}, {
|
|
214
|
+
enabled?: boolean | undefined;
|
|
215
|
+
log_dir?: string | undefined;
|
|
216
|
+
redact_secrets?: boolean | undefined;
|
|
217
|
+
log_allowed?: boolean | undefined;
|
|
218
|
+
}>, {
|
|
219
|
+
enabled: boolean;
|
|
220
|
+
log_dir: string;
|
|
221
|
+
redact_secrets: boolean;
|
|
222
|
+
log_allowed: boolean;
|
|
223
|
+
}, unknown>;
|
|
224
|
+
}, "strip", z.ZodTypeAny, {
|
|
225
|
+
name: string;
|
|
226
|
+
secrets: {
|
|
227
|
+
enabled: boolean;
|
|
228
|
+
scan_entropy: boolean;
|
|
229
|
+
custom_patterns: {
|
|
230
|
+
regex: string;
|
|
231
|
+
name: string;
|
|
232
|
+
severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
|
|
233
|
+
}[];
|
|
234
|
+
};
|
|
235
|
+
injection: {
|
|
236
|
+
enabled: boolean;
|
|
237
|
+
hits_for_high: number;
|
|
238
|
+
};
|
|
239
|
+
audit: {
|
|
240
|
+
enabled: boolean;
|
|
241
|
+
log_dir: string;
|
|
242
|
+
redact_secrets: boolean;
|
|
243
|
+
log_allowed: boolean;
|
|
244
|
+
};
|
|
245
|
+
version: 1;
|
|
246
|
+
fail_closed: boolean;
|
|
247
|
+
risk_thresholds: {
|
|
248
|
+
block: ("LOW" | "MEDIUM" | "HIGH" | "CRITICAL")[];
|
|
249
|
+
ask: ("LOW" | "MEDIUM" | "HIGH" | "CRITICAL")[];
|
|
250
|
+
};
|
|
251
|
+
tools: {
|
|
252
|
+
deny: string[];
|
|
253
|
+
allow: string[];
|
|
254
|
+
default: "deny" | "allow";
|
|
255
|
+
agents: Record<string, {
|
|
256
|
+
deny: string[];
|
|
257
|
+
allow: string[];
|
|
258
|
+
default?: "deny" | "allow" | undefined;
|
|
259
|
+
}>;
|
|
260
|
+
};
|
|
261
|
+
command_risk: {
|
|
262
|
+
blocked_patterns: string[];
|
|
263
|
+
};
|
|
264
|
+
file_policy: {
|
|
265
|
+
protected_paths: {
|
|
266
|
+
path: string;
|
|
267
|
+
permissions: ("deny" | "readonly" | "allow")[];
|
|
268
|
+
description?: string | undefined;
|
|
269
|
+
}[];
|
|
270
|
+
max_bulk_delete: number;
|
|
271
|
+
allow_outside_workspace: boolean;
|
|
272
|
+
workspace_root?: string | undefined;
|
|
273
|
+
};
|
|
274
|
+
url_policy: {
|
|
275
|
+
allowed_schemes: string[];
|
|
276
|
+
allowed_domains: string[];
|
|
277
|
+
denied_domains: string[];
|
|
278
|
+
block_private_networks: boolean;
|
|
279
|
+
};
|
|
280
|
+
description?: string | undefined;
|
|
281
|
+
}, {
|
|
282
|
+
name?: string | undefined;
|
|
283
|
+
secrets?: unknown;
|
|
284
|
+
injection?: unknown;
|
|
285
|
+
audit?: unknown;
|
|
286
|
+
description?: string | undefined;
|
|
287
|
+
version?: 1 | undefined;
|
|
288
|
+
fail_closed?: boolean | undefined;
|
|
289
|
+
risk_thresholds?: unknown;
|
|
290
|
+
tools?: unknown;
|
|
291
|
+
command_risk?: unknown;
|
|
292
|
+
file_policy?: unknown;
|
|
293
|
+
url_policy?: unknown;
|
|
294
|
+
}>;
|
|
295
|
+
export declare class PolicyValidationError extends Error {
|
|
296
|
+
readonly source: string;
|
|
297
|
+
constructor(source: string, issues: z.ZodIssue[]);
|
|
298
|
+
}
|
|
299
|
+
/**
|
|
300
|
+
* Load and validate a policy file (YAML or JSON). With no argument, returns
|
|
301
|
+
* the built-in default policy.
|
|
302
|
+
*/
|
|
303
|
+
export declare function loadPolicy(path?: string): PolicyDoc;
|
|
304
|
+
/** The built-in default policy (identical to policies/default.yaml). */
|
|
305
|
+
export declare function defaultPolicy(): PolicyDoc;
|
|
306
|
+
/** Helper for threshold checks in tests/tools. */
|
|
307
|
+
export declare function severityIn(list: RiskLevel[], level: RiskLevel): boolean;
|