@kenhkl/agent-moss 0.8.5 → 0.9.0

package/dist/engine/coordinator.d.ts

@@ -0,0 +1,52 @@
+/** Security judgment result from a single analysis layer */
+interface SecurityJudgment {
+    allowed: boolean;
+    reason: string;
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    riskType: string;
+    confidence: number;
+    source: string;
+    violatedLayers: string[];
+    isCredential?: boolean;
+}
+
+interface AnalysisInput {
+    sessionId: string;
+    promptSession: string;
+    actionHistory: {
+        actionType: string;
+        actionDetail: string;
+    }[];
+    aNext: {
+        actionType: string;
+        actionDetail: string;
+    };
+    reason: string;
+    osType: string;
+    cwd: string;
+    /** 调用方 agent 标识（如 'xiaoo' / 'opencode' / 'opendesk'）。空 = 通用模式。 */
+    agentId: string;
+    /** 可选的 per-request LLM 配置覆盖（由 OpenDesk 按当前会话模型传入） */
+    llmConfig?: {
+        baseUrl: string;
+        apiKey: string;
+        model: string;
+        provider?: string;
+    };
+    /** 可选的 per-request LLM prompt 日志路径（来自调用方 env，per-request 注入。
+     * 跟 llmConfig 同理：调用方子进程有 AGENT_MOSS_LOG_PATH env 但服务进程不一定有，
+     * 通过 metadata 注入让服务端写 [LLM_PROMPT] 日志，对齐 py _log_prompt） */
+    llmLogPath?: string;
+}
+/** 内置安全 Skill 白名单（通用 baseline，agent_ext.builtin_safe_skills 会追加）。
+ * 测试可 import 此常量直接断言"无 agentId 时白名单不含某 skill"，避免走 L3
+ * LLM 调用导致测试脆弱（依赖 LLM 401 fail_open 兜底）。 */
+declare const TRUSTED_SKILLS_BASE: Set<string>;
+/**
+ * Three-layer defense coordinator.
+ * Layer 1 → fast-pass check → Layer 2 → Layer 3.
+ * Fast-pass: whitelisted safe tools/commands skip L2+L3 or L3 only.
+ */
+declare function runAnalysis(input: AnalysisInput): Promise<SecurityJudgment>;
+
+export { type AnalysisInput, TRUSTED_SKILLS_BASE, runAnalysis };