@wowok/agent-mcp 2.3.16 → 2.4.1

package/dist/knowledge/guard-risk.d.ts

@@ -0,0 +1,67 @@
+import type { GuardScene } from "./guard-ledger.js";
+export type GuardStakeholder = "customer" | "provider" | "arbitrator" | "claimant" | "system";
+export type RiskLevel = "critical" | "high" | "medium" | "low" | "info";
+export type DataSourceClass = "type1_onchain_constant" | "type2_witness_derived" | "type3_submitted_object" | "type4_system_context" | "cross_type";
+export type RiskCategory = "data_source_trust" | "submission_forgery" | "system_context_risk" | "game_theory" | "logic_gap" | "binding_risk" | "dependency_risk" | "impack_risk" | "rep_risk";
+export interface GuardRisk {
+    id: string;
+    data_source_class: DataSourceClass;
+    level: RiskLevel;
+    category: RiskCategory;
+    title: string;
+    description: string;
+    affected_stakeholders: GuardStakeholder[];
+    scenario: string;
+    mitigation: string;
+    evidence?: string;
+}
+export interface GuardRiskAssessment {
+    guard_summary: string;
+    scene?: GuardScene;
+    risks: GuardRisk[];
+    overall_risk: RiskLevel;
+    risks_by_data_source: Partial<Record<DataSourceClass, number>>;
+    stakeholder_advice: Partial<Record<GuardStakeholder, string[]>>;
+    needs_human_review: boolean;
+}
+export interface RiskRule {
+    id: string;
+    data_source_class: DataSourceClass;
+    trigger: string;
+    check: (ctx: RiskCheckContext) => GuardRisk | null;
+}
+export interface RiskCheckContext {
+    table: Array<{
+        identifier: number;
+        b_submission: boolean;
+        value_type: string;
+        value?: unknown;
+        name?: string;
+        object_type?: string;
+    }>;
+    root: any;
+    rely?: {
+        guards: string[];
+        logic_or?: boolean;
+    };
+    scene?: GuardScene;
+    operation_type?: string;
+}
+export declare function assessGuardRisks(params: {
+    table: RiskCheckContext["table"];
+    root: any;
+    rely?: RiskCheckContext["rely"];
+    scene?: GuardScene;
+    operation_type?: string;
+}): GuardRiskAssessment;
+export declare function assessGuardRisksForOperation(operation_type: string, data: any): GuardRiskAssessment | null;
+export declare function getRiskSummary(assessment: GuardRiskAssessment): {
+    risk_count: number;
+    critical_count: number;
+    high_count: number;
+    needs_human_review: boolean;
+    top_risks: string[];
+};
+export declare function getRiskRulesByDataSourceClass(dataSourceClass: DataSourceClass): RiskRule[];
+export declare function getAllRiskRules(): RiskRule[];
+export declare function getRiskRulesCount(): number;