crabmate 0.5.0

Rust AI agent: OpenAI-compatible chat/completions, function calling, HTTP serve, ops CLI
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

//! OpenAPI `paths` 中后台工具任务端点片段（`/tools/jobs/*`）。

use serde_json::{Value, json};

pub(super) fn openapi_paths_fragment_tool_jobs() -> Value {
    json!({
        "/tools/jobs/{tool_job_id}": {
            "get": {
                "tags": ["tool_jobs"],
                "summary": "轮询后台工具任务状态与（终态）输出",
                "security": [{ "bearerAuth": [] }, { "apiKeyAuth": [] }],
                "parameters": [
                    {
                        "name": "tool_job_id",
                        "in": "path",
                        "required": true,
                        "schema": { "type": "string" }
                    },
                    {
                        "name": "X-Workspace-Root",
                        "in": "header",
                        "required": false,
                        "description": "可选归属校验：与任务创建时记录的工作区比对，不符 403 JOB_OWNERSHIP_MISMATCH",
                        "schema": { "type": "string" }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "任务状态快照",
                        "content": {
                            "application/json": {
                                "schema": { "$ref": "#/components/schemas/ToolJobStatusResponseBody" }
                            }
                        }
                    },
                    "403": { "description": "X-Workspace-Root 与任务归属不符（JOB_OWNERSHIP_MISMATCH）" },
                    "404": { "description": "不存在 / 从未创建（JOB_NOT_FOUND）" },
                    "410": { "description": "已过 TTL+宽限被清理（JOB_EXPIRED）" }
                }
            }
        },
        "/tools/jobs/{tool_job_id}/cancel": {
            "post": {
                "tags": ["tool_jobs"],
                "summary": "取消后台工具任务（queued 直接转移；running 置取消标记）",
                "security": [{ "bearerAuth": [] }, { "apiKeyAuth": [] }],
                "parameters": [
                    {
                        "name": "tool_job_id",
                        "in": "path",
                        "required": true,
                        "schema": { "type": "string" }
                    },
                    {
                        "name": "X-Workspace-Root",
                        "in": "header",
                        "required": false,
                        "description": "可选归属校验：与任务创建时记录的工作区比对，不符 403 JOB_OWNERSHIP_MISMATCH",
                        "schema": { "type": "string" }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "已取消（幂等；已是 cancelled 亦 200）",
                        "content": {
                            "application/json": {
                                "schema": { "$ref": "#/components/schemas/ToolJobCancelResponseBody" }
                            }
                        }
                    },
                    "403": { "description": "X-Workspace-Root 与任务归属不符（JOB_OWNERSHIP_MISMATCH）" },
                    "404": { "description": "不存在 / 从未创建（JOB_NOT_FOUND）" },
                    "409": { "description": "已是其它终态（不覆盖；body `{ \"status\": <当前状态> }`）" },
                    "410": { "description": "已过 TTL+宽限被清理（JOB_EXPIRED）" }
                }
            }
        }
    })
}