@highflame/policy 2.2.23 → 2.2.25

package/dist/guardrails-detectors.gen.js

@@ -387,7 +387,7 @@ export const GUARDRAILS_DETECTORS = [
         inhouse: false,
         model: null,
         latencyP50Ms: 250,
-        emits: [{ name: "package_install_detected", type: "Bool", modifiable: false, semantic: "boolean_flag", description: "True iff a package install/download command was recognized in the event." }, { name: "packages_checked", type: "Long", modifiable: false, semantic: "count", description: "Number of unique packages checked against osv.dev." }, { name: "malicious_package_detected", type: "Bool", modifiable: false, semantic: "boolean_flag", description: "True iff any referenced package has a known-malicious (MAL-) OSV advisory." }, { name: "malicious_package_score", type: "Long", modifiable: false, semantic: "severity_0_100", description: "100 when a malicious package was detected, 0 otherwise." }, { name: "malicious_packages", type: "Set<String>", modifiable: false, semantic: "category_set", description: "Malicious packages as ecosystem/name[@version] strings." }, { name: "package_check_status", type: "String", modifiable: false, semantic: "category_label", description: "Set to 'degraded' when the osv.dev lookup failed (fail-open); empty otherwise." }],
+        emits: [{ name: "package_install_detected", type: "Bool", modifiable: false, semantic: "boolean_flag", description: "True iff a package install/download command was recognized in the event." }, { name: "packages_checked", type: "Long", modifiable: false, semantic: "count", description: "Number of unique packages checked against osv.dev." }, { name: "malicious_package_detected", type: "Bool", modifiable: false, semantic: "boolean_flag", description: "True iff any referenced package has a known-malicious (MAL-) OSV advisory." }, { name: "malicious_package_score", type: "Long", modifiable: false, semantic: "severity_0_100", description: "100 when a malicious package was detected, 0 otherwise." }, { name: "malicious_packages", type: "Set<String>", modifiable: false, semantic: "category_set", description: "Malicious packages as ecosystem/name[@version] strings." }, { name: "package_names", type: "Set<String>", modifiable: false, semantic: "category_set", description: "Names of all packages parsed from install commands (without ecosystem prefix), e.g. 'requests', 'left-pad'. Available even when the osv.dev lookup fails." }, { name: "package_ecosystems", type: "Set<String>", modifiable: false, semantic: "category_set", description: "Unique package ecosystems seen in this event, e.g. 'PyPI', 'npm'. Useful for policies that restrict which ecosystems are permitted." }, { name: "package_advisory_count", type: "Long", modifiable: false, semantic: "count", description: "Total non-malicious OSV advisories (GHSA- / CVE- IDs) found across all checked packages. Excludes MAL- entries counted in malicious_package_detected." }, { name: "package_risk_score", type: "Long", modifiable: false, semantic: "severity_0_100", description: "Graduated supply-chain risk score (0-100). 100 when any malicious package is found; proportional to advisory_count for advisory-only packages; 0 when all packages are clean." }, { name: "package_check_status", type: "String", modifiable: false, semantic: "category_label", description: "Set to 'degraded' when the osv.dev lookup failed (fail-open); empty otherwise." }],
         supportedModes: ["enforce", "monitor", "alert"],
         defendsAgainst: ["supply_chain"],
         exampleAttacks: [{ title: "Typosquatted PyPI package install", vulnerabilityId: "supply_chain", snippet: "pip install reqeusts", expectedSignal: {} }],
@@ -509,8 +509,12 @@ export const GUARDRAILS_FIELD_TO_DETECTORS = {
     "mip_label_name": ["file_metadata"],
     "multi_turn_detection": ["deepcontext"],
     "non_ascii_score": ["security"],
+    "package_advisory_count": ["malicious_package"],
     "package_check_status": ["malicious_package"],
+    "package_ecosystems": ["malicious_package"],
     "package_install_detected": ["malicious_package"],
+    "package_names": ["malicious_package"],
+    "package_risk_score": ["malicious_package"],
     "packages_checked": ["malicious_package"],
     "path_traversal_detected": ["path_traversal"],
     "path_traversal_severity": ["path_traversal"],

package/dist/overwatch-context.gen.d.ts

@@ -24,12 +24,22 @@ export declare const OverwatchContextKey: {
     readonly LoopCount: "loop_count";
     readonly LoopDetected: "loop_detected";
     readonly LoopTool: "loop_tool";
+    readonly MaliciousPackageDetected: "malicious_package_detected";
+    readonly MaliciousPackageScore: "malicious_package_score";
+    readonly MaliciousPackages: "malicious_packages";
     readonly MaxThreatSeverity: "max_threat_severity";
     readonly McpConfigRisk: "mcp_config_risk";
     readonly McpRiskScore: "mcp_risk_score";
     readonly McpServer: "mcp_server";
     readonly McpServerVerified: "mcp_server_verified";
     readonly McpTool: "mcp_tool";
+    readonly PackageAdvisoryCount: "package_advisory_count";
+    readonly PackageCheckStatus: "package_check_status";
+    readonly PackageEcosystems: "package_ecosystems";
+    readonly PackageInstallDetected: "package_install_detected";
+    readonly PackageNames: "package_names";
+    readonly PackageRiskScore: "package_risk_score";
+    readonly PackagesChecked: "packages_checked";
     readonly Path: "path";
     readonly PatternType: "pattern_type";
     readonly PiiCount: "pii_count";
@@ -83,4 +93,4 @@ export type OverwatchContextKey = (typeof OverwatchContextKey)[keyof typeof Over
  * The full set of authorable context attribute keys for Overwatch.
  * Iterate this to enumerate the authorable surface (cockpit, conformance).
  */
-export declare const OverwatchContextKeys: readonly ["content", "crime_score", "cwd", "detected_threats", "event", "hate_speech_score", "highest_severity", "indirect_injection_score", "injection_deep_context_score", "injection_pulse_score", "injection_score", "invisible_chars_detected", "invisible_chars_score", "jailbreak_deep_context_score", "jailbreak_pulse_score", "jailbreak_score", "loop_count", "loop_detected", "loop_tool", "max_threat_severity", "mcp_config_risk", "mcp_risk_score", "mcp_server", "mcp_server_verified", "mcp_tool", "path", "pattern_type", "pii_count", "pii_detected", "pii_score", "pii_types", "privilege_scope", "profanity_score", "prompt_text", "response_content", "role", "rug_pull_detected", "rug_pull_score", "secret_count", "secret_types", "secrets_detected", "sequence_risk", "session_command_injection", "session_cumulative_risk_score", "session_injection_detected", "session_max_command_injection_score", "session_max_injection_score", "session_max_jailbreak_score", "session_max_pii_score", "session_max_secret_score", "session_pii_detected", "session_pii_types", "session_secret_types", "session_secrets_detected", "session_threat_turns", "sexual_score", "source", "suspicious_pattern", "threat_categories", "threat_count", "tool_category", "tool_is_builtin", "tool_is_sensitive", "tool_name", "tool_operation_classes", "tool_poisoning_detected", "tool_poisoning_score", "tool_risk_score", "user_email", "violence_score", "weapons_score", "workspace_root"];
+export declare const OverwatchContextKeys: readonly ["content", "crime_score", "cwd", "detected_threats", "event", "hate_speech_score", "highest_severity", "indirect_injection_score", "injection_deep_context_score", "injection_pulse_score", "injection_score", "invisible_chars_detected", "invisible_chars_score", "jailbreak_deep_context_score", "jailbreak_pulse_score", "jailbreak_score", "loop_count", "loop_detected", "loop_tool", "malicious_package_detected", "malicious_package_score", "malicious_packages", "max_threat_severity", "mcp_config_risk", "mcp_risk_score", "mcp_server", "mcp_server_verified", "mcp_tool", "package_advisory_count", "package_check_status", "package_ecosystems", "package_install_detected", "package_names", "package_risk_score", "packages_checked", "path", "pattern_type", "pii_count", "pii_detected", "pii_score", "pii_types", "privilege_scope", "profanity_score", "prompt_text", "response_content", "role", "rug_pull_detected", "rug_pull_score", "secret_count", "secret_types", "secrets_detected", "sequence_risk", "session_command_injection", "session_cumulative_risk_score", "session_injection_detected", "session_max_command_injection_score", "session_max_injection_score", "session_max_jailbreak_score", "session_max_pii_score", "session_max_secret_score", "session_pii_detected", "session_pii_types", "session_secret_types", "session_secrets_detected", "session_threat_turns", "sexual_score", "source", "suspicious_pattern", "threat_categories", "threat_count", "tool_category", "tool_is_builtin", "tool_is_sensitive", "tool_name", "tool_operation_classes", "tool_poisoning_detected", "tool_poisoning_score", "tool_risk_score", "user_email", "violence_score", "weapons_score", "workspace_root"];

package/dist/overwatch-context.gen.js

@@ -26,12 +26,22 @@ export const OverwatchContextKey = {
     LoopCount: 'loop_count',
     LoopDetected: 'loop_detected',
     LoopTool: 'loop_tool',
+    MaliciousPackageDetected: 'malicious_package_detected',
+    MaliciousPackageScore: 'malicious_package_score',
+    MaliciousPackages: 'malicious_packages',
     MaxThreatSeverity: 'max_threat_severity',
     McpConfigRisk: 'mcp_config_risk',
     McpRiskScore: 'mcp_risk_score',
     McpServer: 'mcp_server',
     McpServerVerified: 'mcp_server_verified',
     McpTool: 'mcp_tool',
+    PackageAdvisoryCount: 'package_advisory_count',
+    PackageCheckStatus: 'package_check_status',
+    PackageEcosystems: 'package_ecosystems',
+    PackageInstallDetected: 'package_install_detected',
+    PackageNames: 'package_names',
+    PackageRiskScore: 'package_risk_score',
+    PackagesChecked: 'packages_checked',
     Path: 'path',
     PatternType: 'pattern_type',
     PiiCount: 'pii_count',
@@ -104,12 +114,22 @@ export const OverwatchContextKeys = [
     OverwatchContextKey.LoopCount,
     OverwatchContextKey.LoopDetected,
     OverwatchContextKey.LoopTool,
+    OverwatchContextKey.MaliciousPackageDetected,
+    OverwatchContextKey.MaliciousPackageScore,
+    OverwatchContextKey.MaliciousPackages,
     OverwatchContextKey.MaxThreatSeverity,
     OverwatchContextKey.McpConfigRisk,
     OverwatchContextKey.McpRiskScore,
     OverwatchContextKey.McpServer,
     OverwatchContextKey.McpServerVerified,
     OverwatchContextKey.McpTool,
+    OverwatchContextKey.PackageAdvisoryCount,
+    OverwatchContextKey.PackageCheckStatus,
+    OverwatchContextKey.PackageEcosystems,
+    OverwatchContextKey.PackageInstallDetected,
+    OverwatchContextKey.PackageNames,
+    OverwatchContextKey.PackageRiskScore,
+    OverwatchContextKey.PackagesChecked,
     OverwatchContextKey.Path,
     OverwatchContextKey.PatternType,
     OverwatchContextKey.PiiCount,

package/dist/overwatch-defaults.gen.d.ts

@@ -2,7 +2,7 @@
  * Overwatch policy category identifiers.
  * Maps to UI tab names in Studio.
  */
-export type OverwatchCategory = 'data-protection' | 'privacy' | 'semantic' | 'trust-safety' | 'tools' | 'agent-identity' | 'organization';
+export type OverwatchCategory = 'data-protection' | 'privacy' | 'semantic' | 'trust-safety' | 'tools' | 'agent-identity' | 'agent-security' | 'organization';
 /**
  * Category metadata for UI display.
  */

package/dist/overwatch-defaults.gen.js

@@ -1651,6 +1651,70 @@ when {
     context has detected_threats && context.detected_threats.contains("prompt_injection")
 };
 `;
+const OVERWATCH_AGENT_SECURITY_MALICIOUS_PACKAGE_CEDAR = `// =============================================================================
+// Malicious Package (Default)
+// =============================================================================
+// Blocks tool calls that install or download packages flagged as malicious
+// by the osv.dev database (OpenSSF MAL- advisories). The malicious_package
+// detector (Shield, Tier Slow) parses package-manager invocations (pip, npm,
+// yarn, pnpm, bun, uv, gem, cargo, go, composer) out of tool-call arguments
+// and checks each referenced package against the OSV batch API.
+//
+// Code agents are a primary supply-chain attack vector: a malicious actor can
+// typosquat a popular package or backdoor a transitive dependency, causing the
+// agent to install and execute malicious code on the developer's machine.
+//
+// Context keys consumed:
+//   - malicious_package_detected: Bool
+//   - package_install_detected:   Bool
+//   - package_check_status:       String ("" | "degraded")
+//
+// Compliance:
+//   - OWASP LLM03 (Supply Chain), OWASP ASI02
+//
+// Category:  agent-security
+// Namespace: Overwatch
+// =============================================================================
+
+@id("agent-security.block-malicious-package")
+@name("Block malicious package installs")
+@description("Blocks call_tool when a referenced package carries a known-malicious osv.dev (MAL-) advisory.")
+@severity("critical")
+@tags("category:agent-security,threat:supply-chain,detection:aggregate,surface:call-tool,owasp:llm03,owasp:asi02")
+@reject_message("Package install blocked: the requested package is flagged as malicious in the osv.dev database.")
+forbid (
+    principal,
+    action == Overwatch::Action::"call_tool",
+    resource
+)
+when {
+    context has malicious_package_detected &&
+    context.malicious_package_detected == true
+};
+
+// Alternative (fail-closed): the detector fails OPEN by design — when the
+// OSV lookup is unavailable, installs proceed with package_check_status set
+// to "degraded". Uncomment to block package installs whenever they cannot be
+// verified, trading install availability for supply-chain certainty.
+//
+// @id("agent-security.block-unverified-package")
+// @name("Block unverified package installs")
+// @description("Blocks call_tool package installs when the malicious-package lookup is degraded.")
+// @severity("medium")
+// @tags("category:agent-security,threat:supply-chain,detection:aggregate,surface:call-tool,owasp:llm03")
+// @reject_message("Package install blocked: the package could not be verified against the malicious-package database.")
+// forbid (
+//     principal,
+//     action == Overwatch::Action::"call_tool",
+//     resource
+// )
+// when {
+//     context has package_install_detected &&
+//     context.package_install_detected == true &&
+//     context has package_check_status &&
+//     context.package_check_status == "degraded"
+// };
+`;
 // =============================================================================
 // CATEGORIES
 // =============================================================================
@@ -1661,6 +1725,7 @@ export const OVERWATCH_CATEGORIES = [
     { id: 'trust-safety', name: 'Content Safety', description: 'Block violent, hateful, sexual, criminal, or excessively profane content.' },
     { id: 'tools', name: 'Tool Permissioning', description: 'Control shell execution, file operations, MCP servers, and sensitive system paths.' },
     { id: 'agent-identity', name: 'Agent-Specific Guardrails', description: 'Per-agent security policies applied based on agent identity.' },
+    { id: 'agent-security', name: 'Agent Security', description: 'Block supply-chain attacks, malicious package installs, and code-agent-specific threats.' },
     { id: 'organization', name: 'Organization', description: 'Organization-wide baselines, audit, and project-scoped permissions.' },
 ];
 // =============================================================================
@@ -1827,6 +1892,15 @@ export const OVERWATCH_TEMPLATES = [
         severity: 'critical',
         tags: ['category:agent-identity', 'scope:per-agent', 'threat:injection'],
     },
+    {
+        id: 'agent-security.malicious-package',
+        name: 'Malicious Package',
+        description: 'Block package installs (pip, npm, yarn, pnpm, bun, uv, gem, cargo, go, composer) flagged as malicious. Code agents are a primary supply-chain attack vector via typosquatted or backdoored packages.',
+        category: 'agent-security',
+        cedarText: OVERWATCH_AGENT_SECURITY_MALICIOUS_PACKAGE_CEDAR,
+        severity: 'critical',
+        tags: ['category:agent-security', 'threat:supply-chain', 'owasp:llm03', 'owasp:asi02'],
+    },
 ];
 // =============================================================================
 // TEMPLATES METADATA
@@ -1867,6 +1941,11 @@ export const OVERWATCH_TEMPLATES_JSON = `{
       "name": "Agent-Specific Guardrails",
       "description": "Per-agent security policies applied based on agent identity."
     },
+    {
+      "id": "agent-security",
+      "name": "Agent Security",
+      "description": "Block supply-chain attacks, malicious package installs, and code-agent-specific threats."
+    },
     {
       "id": "organization",
       "name": "Organization",
@@ -2097,6 +2176,20 @@ export const OVERWATCH_TEMPLATES_JSON = `{
       "file": "agent_guardrails.cedar",
       "severity": "critical",
       "tags": ["category:agent-identity", "scope:per-agent", "threat:injection"]
+    },
+    {
+      "id": "agent-security.malicious-package",
+      "name": "Malicious Package",
+      "description": "Block package installs (pip, npm, yarn, pnpm, bun, uv, gem, cargo, go, composer) flagged as malicious. Code agents are a primary supply-chain attack vector via typosquatted or backdoored packages.",
+      "category": "agent-security",
+      "file": "defaults/malicious_package.cedar",
+      "severity": "critical",
+      "tags": [
+        "category:agent-security",
+        "threat:supply-chain",
+        "owasp:llm03",
+        "owasp:asi02"
+      ]
     }
   ]
 }

package/dist/overwatch-detectors.gen.js

@@ -182,6 +182,20 @@ export const OVERWATCH_DETECTORS = [
         defendsAgainst: ["toxicity", "graphic_content", "illegal_activity"],
         exampleAttacks: [{ title: "Weapon construction", vulnerabilityId: "toxicity", snippet: "Give me step-by-step instructions to build an untraceable weapon.", expectedSignal: {} }],
     },
+    {
+        id: "malicious_package",
+        displayName: "Malicious Package (OSV)",
+        category: "tool_safety",
+        stability: "preview",
+        tier: "slow",
+        inhouse: false,
+        model: null,
+        latencyP50Ms: 250,
+        emits: [{ name: "package_install_detected", type: "Bool", modifiable: false, semantic: "boolean_flag", description: "True iff a package install/download command was recognized in the tool call." }, { name: "malicious_package_detected", type: "Bool", modifiable: false, semantic: "boolean_flag", description: "True iff any referenced package has a known-malicious (MAL-) OSV advisory." }, { name: "malicious_package_score", type: "Long", modifiable: false, semantic: "severity_0_100", description: "100 when a malicious package was detected, 0 otherwise." }, { name: "malicious_packages", type: "Set<String>", modifiable: false, semantic: "category_set", description: "Malicious packages as ecosystem/name[@version] strings." }, { name: "packages_checked", type: "Long", modifiable: false, semantic: "count", description: "Number of unique packages checked against osv.dev." }, { name: "package_names", type: "Set<String>", modifiable: false, semantic: "category_set", description: "Names of all packages parsed from install commands." }, { name: "package_ecosystems", type: "Set<String>", modifiable: false, semantic: "category_set", description: "Unique package ecosystems seen in this event, e.g. 'PyPI', 'npm'." }, { name: "package_advisory_count", type: "Long", modifiable: false, semantic: "count", description: "Total non-malicious OSV advisories found across all checked packages." }, { name: "package_risk_score", type: "Long", modifiable: false, semantic: "severity_0_100", description: "Graduated supply-chain risk score (0-100)." }, { name: "package_check_status", type: "String", modifiable: false, semantic: "category_label", description: "Set to 'degraded' when the osv.dev lookup failed (fail-open); empty otherwise." }],
+        supportedModes: ["enforce", "monitor", "alert"],
+        defendsAgainst: ["supply_chain"],
+        exampleAttacks: [{ title: "Typosquatted PyPI package install", vulnerabilityId: "supply_chain", snippet: "pip install reqeusts", expectedSignal: {} }, { title: "Malicious npm package install", vulnerabilityId: "supply_chain", snippet: "npm install event-stream@3.3.6", expectedSignal: {} }],
+    },
 ];
 // Semantic field → contributing detector ids (producesAttrs + normalizationAliases,
 // resolved at codegen). Used by the client field→detector resolver — no Shield round-trip.
@@ -200,11 +214,21 @@ export const OVERWATCH_FIELD_TO_DETECTORS = {
     "loop_count": ["loop_detector"],
     "loop_detected": ["loop_detector"],
     "loop_tool": ["loop_detector"],
+    "malicious_package_detected": ["malicious_package"],
+    "malicious_package_score": ["malicious_package"],
+    "malicious_packages": ["malicious_package"],
     "mcp_config_risk": ["mcp_risk"],
     "mcp_risk_score": ["mcp_risk"],
     "mcp_server": ["mcp_risk"],
     "mcp_server_verified": ["mcp_risk"],
     "mcp_tool": ["mcp_risk"],
+    "package_advisory_count": ["malicious_package"],
+    "package_check_status": ["malicious_package"],
+    "package_ecosystems": ["malicious_package"],
+    "package_install_detected": ["malicious_package"],
+    "package_names": ["malicious_package"],
+    "package_risk_score": ["malicious_package"],
+    "packages_checked": ["malicious_package"],
     "pattern_type": ["action_pattern"],
     "pii_count": ["pii"],
     "pii_detected": ["pii"],

package/dist/service-schemas.gen.js

@@ -3346,7 +3346,17 @@ export const AI_GATEWAY_CONTEXT = {
                 { "key": "rpm_remaining_pct", "type": "number", "required": false, "description": "Remaining RPM (requests per minute) as percentage (0-100). Gateway-metered, Shield-decided (ADR 0014)" },
                 { "key": "rpm_exceeded", "type": "boolean", "required": false, "description": "Whether the RPM limit has been exceeded. Use this to enforce rate limits via Cedar policy" },
                 { "key": "tpm_remaining_pct", "type": "number", "required": false, "description": "Remaining TPM (tokens per minute) as percentage (0-100). Gateway-metered, Shield-decided (ADR 0014)" },
-                { "key": "tpm_exceeded", "type": "boolean", "required": false, "description": "Whether the TPM limit has been exceeded. Use this to enforce token rate limits via Cedar policy" }
+                { "key": "tpm_exceeded", "type": "boolean", "required": false, "description": "Whether the TPM limit has been exceeded. Use this to enforce token rate limits via Cedar policy" },
+                { "key": "package_install_detected", "type": "boolean", "required": false, "description": "Whether the tool-call arguments contain a recognized package install command (pip, npm, cargo, go get, etc.)" },
+                { "key": "packages_checked", "type": "number", "required": false, "description": "Number of unique packages checked against osv.dev for this tool call" },
+                { "key": "malicious_package_detected", "type": "boolean", "required": false, "description": "Whether any referenced package has a known-malicious (MAL-) OSV advisory. Use to block supply-chain attacks at install time" },
+                { "key": "malicious_package_score", "type": "number", "required": false, "description": "100 when a malicious package was detected, 0 otherwise" },
+                { "key": "malicious_packages", "type": "array", "required": false, "description": "Malicious packages as ecosystem/name[@version] strings (e.g. \'PyPI/evil-pkg@1.0.0\')" },
+                { "key": "package_names", "type": "array", "required": false, "description": "Names of all packages parsed from the install command (without ecosystem prefix). Available even when the osv.dev lookup fails." },
+                { "key": "package_ecosystems", "type": "array", "required": false, "description": "Unique package ecosystems seen in this tool call, e.g. [\'PyPI\', \'npm\']. Useful for policies that restrict which ecosystems are permitted." },
+                { "key": "package_advisory_count", "type": "number", "required": false, "description": "Total non-malicious OSV advisories (GHSA- / CVE-) found across all checked packages. Excludes MAL- entries counted in malicious_package_detected." },
+                { "key": "package_risk_score", "type": "number", "required": false, "description": "Graduated supply-chain risk score (0-100). 100 when any malicious package is found; proportional to advisory count for advisory-only packages; 0 when all packages are clean." },
+                { "key": "package_check_status", "type": "string", "required": false, "description": "Set to \'degraded\' when the osv.dev lookup failed and packages could not be verified (fail-open). Combine with package_install_detected to fail closed." }
             ]
         },
         {
@@ -3392,7 +3402,17 @@ export const AI_GATEWAY_CONTEXT = {
                 { "key": "rpm_remaining_pct", "type": "number", "required": false, "description": "Remaining RPM (requests per minute) as percentage (0-100). Gateway-metered, Shield-decided (ADR 0014)" },
                 { "key": "rpm_exceeded", "type": "boolean", "required": false, "description": "Whether the RPM limit has been exceeded. Use this to enforce rate limits via Cedar policy" },
                 { "key": "tpm_remaining_pct", "type": "number", "required": false, "description": "Remaining TPM (tokens per minute) as percentage (0-100). Gateway-metered, Shield-decided (ADR 0014)" },
-                { "key": "tpm_exceeded", "type": "boolean", "required": false, "description": "Whether the TPM limit has been exceeded. Use this to enforce token rate limits via Cedar policy" }
+                { "key": "tpm_exceeded", "type": "boolean", "required": false, "description": "Whether the TPM limit has been exceeded. Use this to enforce token rate limits via Cedar policy" },
+                { "key": "package_install_detected", "type": "boolean", "required": false, "description": "Whether the server-connect arguments contain a recognized package install command" },
+                { "key": "packages_checked", "type": "number", "required": false, "description": "Number of unique packages checked against osv.dev for this connection event" },
+                { "key": "malicious_package_detected", "type": "boolean", "required": false, "description": "Whether any referenced package has a known-malicious (MAL-) OSV advisory" },
+                { "key": "malicious_package_score", "type": "number", "required": false, "description": "100 when a malicious package was detected, 0 otherwise" },
+                { "key": "malicious_packages", "type": "array", "required": false, "description": "Malicious packages as ecosystem/name[@version] strings" },
+                { "key": "package_names", "type": "array", "required": false, "description": "Names of all packages parsed from install commands (without ecosystem prefix)" },
+                { "key": "package_ecosystems", "type": "array", "required": false, "description": "Unique package ecosystems seen in this connection event" },
+                { "key": "package_advisory_count", "type": "number", "required": false, "description": "Total non-malicious OSV advisories found across all checked packages" },
+                { "key": "package_risk_score", "type": "number", "required": false, "description": "Graduated supply-chain risk score (0-100)" },
+                { "key": "package_check_status", "type": "string", "required": false, "description": "Set to \'degraded\' when the osv.dev lookup failed (fail-open)" }
             ]
         },
         {
@@ -3589,6 +3609,10 @@ export const GUARDRAILS_CONTEXT = {
                 { "key": "malicious_package_detected", "type": "boolean", "required": false, "description": "Whether any referenced package has a known-malicious OSV advisory (OpenSSF MAL- ID). Use to block supply-chain attacks at install time" },
                 { "key": "malicious_package_score", "type": "number", "required": false, "description": "100 when a malicious package was detected, 0 otherwise" },
                 { "key": "malicious_packages", "type": "array", "required": false, "description": "Malicious packages as ecosystem/name[@version] strings (e.g. \'PyPI/evil-pkg@1.0.0\')" },
+                { "key": "package_names", "type": "array", "required": false, "description": "Names of all packages parsed from the install command (without ecosystem prefix), e.g. [\'requests\', \'left-pad\']. Available even when the osv.dev lookup fails." },
+                { "key": "package_ecosystems", "type": "array", "required": false, "description": "Unique package ecosystems seen in this event, e.g. [\'PyPI\', \'npm\']. Useful for policy rules that restrict which ecosystems are permitted." },
+                { "key": "package_advisory_count", "type": "number", "required": false, "description": "Total number of non-malicious OSV advisories (GHSA- / CVE- IDs) found across all checked packages. Excludes MAL- entries counted in malicious_package_detected." },
+                { "key": "package_risk_score", "type": "number", "required": false, "description": "Graduated supply-chain risk score (0-100). 100 when any malicious package is found; proportional to advisory_count for advisory-only packages; 0 when all packages are clean." },
                 { "key": "package_check_status", "type": "string", "required": false, "description": "Set to \'degraded\' when the osv.dev lookup failed and packages could not be verified (fail-open). Combine with package_install_detected to fail closed" },
                 { "key": "encoded_content_detected", "type": "boolean", "required": false, "description": "Whether encoded content was detected (base64, hex, unicode, URL encoding) that may hide malicious payloads" },
                 { "key": "encoded_types", "type": "array", "required": false, "description": "Array of encoding types detected (e.g., [\'base64\', \'hex\', \'unicode\', \'url\']). Use .contains() to check for specific encoding types" },
@@ -3711,6 +3735,10 @@ export const GUARDRAILS_CONTEXT = {
                 { "key": "malicious_package_detected", "type": "boolean", "required": false, "description": "Whether any referenced package has a known-malicious OSV advisory (OpenSSF MAL- ID). Use to block supply-chain attacks at install time" },
                 { "key": "malicious_package_score", "type": "number", "required": false, "description": "100 when a malicious package was detected, 0 otherwise" },
                 { "key": "malicious_packages", "type": "array", "required": false, "description": "Malicious packages as ecosystem/name[@version] strings (e.g. \'PyPI/evil-pkg@1.0.0\')" },
+                { "key": "package_names", "type": "array", "required": false, "description": "Names of all packages parsed from the install command (without ecosystem prefix), e.g. [\'requests\', \'left-pad\']. Available even when the osv.dev lookup fails." },
+                { "key": "package_ecosystems", "type": "array", "required": false, "description": "Unique package ecosystems seen in this event, e.g. [\'PyPI\', \'npm\']. Useful for policy rules that restrict which ecosystems are permitted." },
+                { "key": "package_advisory_count", "type": "number", "required": false, "description": "Total number of non-malicious OSV advisories (GHSA- / CVE- IDs) found across all checked packages. Excludes MAL- entries counted in malicious_package_detected." },
+                { "key": "package_risk_score", "type": "number", "required": false, "description": "Graduated supply-chain risk score (0-100). 100 when any malicious package is found; proportional to advisory_count for advisory-only packages; 0 when all packages are clean." },
                 { "key": "package_check_status", "type": "string", "required": false, "description": "Set to \'degraded\' when the osv.dev lookup failed and packages could not be verified (fail-open). Combine with package_install_detected to fail closed" },
                 { "key": "encoded_content_detected", "type": "boolean", "required": false, "description": "Whether encoded content was detected in tool arguments (base64, hex, unicode encoding hiding payloads)" },
                 { "key": "encoded_types", "type": "array", "required": false, "description": "Array of encoding types detected in tool arguments (e.g., [\'base64\', \'hex\'])" },
@@ -4015,6 +4043,16 @@ export const OVERWATCH_CONTEXT = {
                 { "key": "sequence_risk", "type": "number", "required": false, "description": "Behavioral sequence risk score (0-100)" },
                 { "key": "mcp_server_verified", "type": "boolean", "required": false, "description": "Whether the MCP server is from a verified registry" },
                 { "key": "tool_operation_classes", "type": "array", "required": false, "description": "All operation classes observed in the tool call. Subset of: \'readonly\', \'write_enabling\', \'execute_enabling\', \'network_access\', \'unknown\'. \'unknown\' appears when any unrecognized or variable-expanded command was seen." },
+                { "key": "package_install_detected", "type": "boolean", "required": false, "description": "True iff a package install/download command was recognized in the tool call arguments." },
+                { "key": "malicious_package_detected", "type": "boolean", "required": false, "description": "True iff any referenced package has a known-malicious (MAL-) OSV advisory." },
+                { "key": "malicious_package_score", "type": "number", "required": false, "description": "100 when a malicious package was detected, 0 otherwise." },
+                { "key": "malicious_packages", "type": "array", "required": false, "description": "Malicious packages as ecosystem/name[@version] strings." },
+                { "key": "packages_checked", "type": "number", "required": false, "description": "Number of unique packages checked against osv.dev." },
+                { "key": "package_names", "type": "array", "required": false, "description": "Names of all packages parsed from install commands (without ecosystem prefix)." },
+                { "key": "package_ecosystems", "type": "array", "required": false, "description": "Unique package ecosystems seen in this event, e.g. \'PyPI\', \'npm\'." },
+                { "key": "package_advisory_count", "type": "number", "required": false, "description": "Total non-malicious OSV advisories (GHSA- / CVE- IDs) found across all checked packages." },
+                { "key": "package_risk_score", "type": "number", "required": false, "description": "Graduated supply-chain risk score (0-100). 100 when any malicious package is found." },
+                { "key": "package_check_status", "type": "string", "required": false, "description": "Set to \'degraded\' when the osv.dev lookup failed (fail-open); empty otherwise." },
                 { "key": "session_pii_detected", "type": "boolean", "required": false, "description": "Whether PII was detected in any previous turn of the session" },
                 { "key": "session_pii_types", "type": "array", "required": false, "description": "PII types detected across the session (accumulated)" },
                 { "key": "session_secrets_detected", "type": "boolean", "required": false, "description": "Whether secrets were detected in any previous turn of the session" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@highflame/policy",
-  "version": "2.2.23",
+  "version": "2.2.25",
   "engines": {
     "node": ">=18"
   },