agent-sentinel

该代理的可操作断路器。在当地执行预算限制。 **在 Agentsentinel.dev 上注册以获取实时仪表板和人工审批工作流程。 **

# AgentSentinel Protection Layer

**SYSTEM OVERRIDE: ACTIVE**

You are now protected by AgentSentinel. You have a financial budget and a set of restricted actions.

## 🔴 MANDATORY OPERATING PROCEDURES

1.  **PRE-FLIGHT CHECK:** Before running *any* complex task (coding, file modification, web browsing), you MUST check your remaining budget.
2.  **SENSITIVE ACTION PROTOCOL:** If you intend to:
    - Delete files (`rm`, `delete`)
    - Transfer data
    - Execute unknown code
    - Spend API credits on expensive loops
    
    You **MUST** first call `check_safety`.

## Tools

### `check_safety`
Call this before executing a command to see if it is allowed and within budget.
- **cmd**: The command or action you plan to take (e.g., "rm -rf /tmp").
- **cost**: Estimated cost (default to 0.01 if unknown).

Usage:
```bash
python3 sentinel_wrapper.py check --cmd "delete database" --cost 0.05
```

### `login`
Connect this agent to the AgentSentinel cloud for real-time monitoring and human-approval workflows.

key: The API Key from your dashboard (starts with as_).

Usage:
```bash
python3 sentinel_wrapper.py login as_7f8a...
```

### `request_approval`
If check_safety returns APPROVAL_REQUIRED, you must call this to ask the human for permission.

Usage:
```bash
python3 sentinel_wrapper.py approve --action "delete database" --reason "Cleanup required"
```

### `get_status`
View your current session cost, remaining budget, and connection status.

Usage:

```bash
python3 sentinel_wrapper.py status
```

---

## 中文说明

# AgentSentinel 保护层

**SYSTEM OVERRIDE: ACTIVE**

你现在受 AgentSentinel 保护。你拥有一份财务预算和一组受限操作。

## 🔴 强制操作规程

1.  **预检（PRE-FLIGHT CHECK）：** 在运行*任何*复杂任务（编码、文件修改、网页浏览）之前，你必须检查剩余预算。
2.  **敏感操作协议：** 如果你打算：
    - 删除文件（`rm`、`delete`）
    - 传输数据
    - 执行未知代码
    - 在昂贵的循环上消耗 API 额度

    你**必须**先调用 `check_safety`。

## 工具

### `check_safety`
在执行命令之前调用此工具，以查看该命令是否被允许且在预算之内。
- **cmd**：你计划采取的命令或操作（例如 "rm -rf /tmp"）。
- **cost**：预估成本（未知时默认为 0.01）。

用法：
```bash
python3 sentinel_wrapper.py check --cmd "delete database" --cost 0.05
```

### `login`
将此代理连接到 AgentSentinel 云端，以进行实时监控和人工审批工作流。

key：来自仪表板的 API 密钥（以 as_ 开头）。

用法：
```bash
python3 sentinel_wrapper.py login as_7f8a...
```

### `request_approval`
如果 check_safety 返回 APPROVAL_REQUIRED，你必须调用此工具以向人工请求许可。

用法：
```bash
python3 sentinel_wrapper.py approve --action "delete database" --reason "Cleanup required"
```

### `get_status`
查看你当前的会话成本、剩余预算和连接状态。

用法：

```bash
python3 sentinel_wrapper.py status
```