Merge remote-tracking branch 'origin/main' into work778

Author: ysyneu

.claude/skills/translate-zh-to-en/glossary.md

@@ -174,7 +174,7 @@ string to preserve verbatim when generating Chinese translations.
 Style rule: when a DNT term appears mid-sentence in Chinese, surround it with
 a single half-width space on either side (e.g., `管理你的 Routines`, not
 `管理你的Routines`). For multi-word terms, keep them together verbatim
-(e.g., `创建 Knowledge Pack`).
+(e.g., `创建 A2A Agent`).
 
 | Term | Notes |
 |------|-------|
@@ -186,12 +186,10 @@ a single half-width space on either side (e.g., `管理你的 Routines`, not
 | Automation | User-defined automation trigger + action |
 | Runner | Agent execution backend (e.g., `flashduty-runner`) |
 | A2A | Agent-to-Agent protocol |
-| Knowledge Pack | A curated knowledge bundle attached to an Agent |
 | Tool call | A single tool invocation inside an Agent turn |
 | Slash command | UI slash-prefixed command (e.g., `/help`) |
 | Reasoning | The reasoning / chain-of-thought block of a model response |
 | Connector | Integration with an external system (Slack, GitHub, etc.) |
-| Environment | Execution environment for runners (env vars, credentials) |
 | Todo | The Todo list shown in agent UI |
 | Mermaid | Mermaid diagram syntax |
 | Prompt | System or user prompt sent to a model |
@@ -201,6 +199,14 @@ Translatable companions (do NOT belong in DNT — translate to Chinese):
 | English | Chinese |
 |---------|---------|
 | Artifact / Artifacts | 产物 |
+| Knowledge | 知识 — the DUTY.md-rooted file tree an account or team maintains for AI SRE. Formerly "Knowledge Pack"; do not use that name in copy. Running text uses lowercase "knowledge" (e.g., "team knowledge"); API identifiers such as `pack_id` and `knowledge-pack-*` CLI commands stay unchanged |
+| Memory | 记忆 |
+| Context | 上下文 — the Customize group holding Knowledge and Memory |
+| Customize | 自定义 — the AI SRE sidebar entry that opens Context, Plugins, and Environments |
+| Plugins | 插件 |
+| Environment / Environments | 环境 |
+| Self-hosted | 自托管 |
+| Cloud | 云端 |
 
 ## Intentional Variants (per-context wording)
 
@@ -217,7 +223,6 @@ Translators: pick the variant whose context matches.
 | 成功 | Succeeded (run-status filter) / OK (compact badge) |
 | 对话 | Chat (singular) / Chats (section header, plural) |
 | 环境 | Environment (field label) / Environments (nav or page title, plural) |
-| 知识库 | Knowledge Pack (singular) / Knowledge Packs (page title, plural) |
 | 产物 | Artifact (singular) / Artifacts (plural) |
 | 文档 | Document (artifact kind) / Documentation (docs link) |
 | 邮件 | Email (channel label, pairs with "SMS") / Email us (CTA, pairs with "Call us") |

.github/workflows/integration-docs-upload.yml

@@ -24,6 +24,12 @@ on:
           - development
           - production
 
+# Runs for one branch upload the same zh.js/en.js objects. Run them one at a time so an
+# older run that finishes late cannot overwrite the files of a newer one.
+concurrency:
+  group: integration-docs-upload-${{ github.ref }}
+  cancel-in-progress: false
+
 jobs:
   build-check:
     runs-on: ubuntu-latest

.github/workflows/openapi-lint.yml

@@ -10,12 +10,16 @@ on:
     paths:
       - 'api-reference/*.json'
       - 'scripts/lint_openapi.py'
+      - 'scripts/api_path_redirects.py'
+      - 'docs.json'
       - '.github/workflows/openapi-lint.yml'
   push:
     branches: [main]
     paths:
       - 'api-reference/*.json'
       - 'scripts/lint_openapi.py'
+      - 'scripts/api_path_redirects.py'
+      - 'docs.json'
       - '.github/workflows/openapi-lint.yml'
 
 jobs:
@@ -26,3 +30,5 @@ jobs:
       - uses: actions/setup-python@v5
       - name: Lint specs
         run: python3 scripts/lint_openapi.py
+      - name: Check API path redirects in docs.json
+        run: python3 scripts/api_path_redirects.py --check

api-reference/on-call.openapi.en.json

@@ -32600,7 +32600,26 @@
               "type": "integer",
               "format": "int64"
             },
-            "description": "Member IDs of the current assignees. Never null; an empty array means unassigned."
+            "description": "Member IDs of the current person assignees. AI SRE is not included. Never null; an empty array means no person assignee."
+          },
+          "assignees": {
+            "description": "Current assignees. Each entry is `{type, id?}`. `type` is `person` or `ai_sre`; an `ai_sre` entry omits `id`. Never null; an empty array means unassigned. `assignee_ids` is the person-only subset of this list.",
+            "items": {
+              "$ref": "#/components/schemas/WorkItemAssignee"
+            },
+            "type": "array"
+          },
+          "agent_session_id": {
+            "description": "ID of the AI SRE session executing this item. Omitted when no session is recorded.",
+            "type": "string"
+          },
+          "agent_session_venue": {
+            "description": "Where that AI SRE session runs: `web` or `im`. Omitted when no session is recorded.",
+            "enum": [
+              "web",
+              "im"
+            ],
+            "type": "string"
           },
           "created_by": {
             "type": "integer",
@@ -32740,7 +32759,15 @@
           "assignee_id": {
             "type": "integer",
             "format": "int64",
-            "description": "Restrict results to items assigned to this member ID. Listing by assignee alone requires being that assignee or an account admin."
+            "description": "Restrict results to items assigned to this member ID. Listing by assignee alone requires being that assignee or an account admin. Ignored when `assignee_type` is `ai_sre`."
+          },
+          "assignee_type": {
+            "description": "Filter by assignee type: `person` or `ai_sre`. `ai_sre` returns items assigned to AI SRE (an AI caller uses this to list its own tasks) and does not require `assignee_id`. `person` together with `assignee_id` restricts results to that member. Omitted with a positive `assignee_id` means `person`.",
+            "enum": [
+              "person",
+              "ai_sre"
+            ],
+            "type": "string"
           },
           "cursor": {
             "type": "string",
@@ -32809,7 +32836,15 @@
               "type": "integer",
               "format": "int64"
             },
-            "description": "Initial assignee member IDs. Assignees must be active members who can already read the anchor; assignment never grants access."
+            "description": "Legacy alias for the initial assignees. Equivalent to `assignees` with every entry `type` `person`. Mutually exclusive with `assignees`: sending both returns an error. Assignees must be active members who can already read the anchor; assignment never grants access."
+          },
+          "assignees": {
+            "description": "Initial assignees. Each entry is `{type, id?}`. `type` is `person` or `ai_sre`; an `ai_sre` entry omits `id`. Mutually exclusive with `assignee_ids`: sending both returns an error. `assignee_ids` is the legacy alias and is equivalent to an all-`person` list. At most 20 entries. Person assignees must be active members who can already read the anchor; assignment never grants access.",
+            "items": {
+              "$ref": "#/components/schemas/WorkItemAssignee"
+            },
+            "maxItems": 20,
+            "type": "array"
           },
           "idempotency_key": {
             "type": "string",
@@ -32983,7 +33018,15 @@
               "type": "integer",
               "format": "int64"
             },
-            "description": "New assignee member IDs, replacing the current set. An empty array clears all assignees."
+            "description": "Legacy alias for the replacement assignee set. Equivalent to `assignees` with every entry `type` `person`. Mutually exclusive with `assignees`: sending both returns an error. An empty array clears all assignees."
+          },
+          "assignees": {
+            "description": "Replacement assignee set. Each entry is `{type, id?}`. `type` is `person` or `ai_sre`; an `ai_sre` entry omits `id`. Mutually exclusive with `assignee_ids`: sending both returns an error. `assignee_ids` is the legacy alias and is equivalent to an all-`person` list. At most 20 entries. An empty array clears all assignees.",
+            "items": {
+              "$ref": "#/components/schemas/WorkItemAssignee"
+            },
+            "maxItems": 20,
+            "type": "array"
           }
         }
       },
@@ -33637,6 +33680,28 @@
             "format": "int64"
           }
         }
+      },
+      "WorkItemAssignee": {
+        "description": "One assignee on a work item.",
+        "properties": {
+          "id": {
+            "description": "Member ID. Required when `type` is `person`. Omitted when `type` is `ai_sre`.",
+            "format": "int64",
+            "type": "integer"
+          },
+          "type": {
+            "description": "Assignee kind: `person` (a member) or `ai_sre` (the account AI SRE).",
+            "enum": [
+              "person",
+              "ai_sre"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "type"
+        ],
+        "type": "object"
       }
     }
   }

api-reference/on-call.openapi.zh.json

@@ -32600,7 +32600,26 @@
               "type": "integer",
               "format": "int64"
             },
-            "description": "当前负责人的成员 ID 列表。不会为 null；空数组表示未指派。"
+            "description": "当前人员负责人的成员 ID。不含 AI SRE。不会为 null；空数组表示没有人员负责人。"
+          },
+          "assignees": {
+            "description": "当前负责人。每项为 `{type, id?}`。`type` 取 `person` 或 `ai_sre`；`ai_sre` 不带 `id`。不会为 null；空数组表示未指派。`assignee_ids` 是其中仅含 `person` 的子集。",
+            "items": {
+              "$ref": "#/components/schemas/WorkItemAssignee"
+            },
+            "type": "array"
+          },
+          "agent_session_id": {
+            "description": "执行该事项的 AI SRE 会话 ID。没有会话时省略。",
+            "type": "string"
+          },
+          "agent_session_venue": {
+            "description": "该 AI SRE 会话所在位置：`web` 或 `im`。没有会话时省略。",
+            "enum": [
+              "web",
+              "im"
+            ],
+            "type": "string"
           },
           "created_by": {
             "type": "integer",
@@ -32740,7 +32759,15 @@
           "assignee_id": {
             "type": "integer",
             "format": "int64",
-            "description": "按负责人成员 ID 过滤结果。仅按负责人查询时，须为本人或账户管理员。"
+            "description": "按负责人成员 ID 过滤结果。仅按负责人查询时，须为本人或账户管理员。`assignee_type` 为 `ai_sre` 时忽略本字段。"
+          },
+          "assignee_type": {
+            "description": "按负责人类型过滤：`person` 或 `ai_sre`。`ai_sre` 返回指派给 AI SRE 的事项（AI 用它查询自己的任务），不需要 `assignee_id`。`person` 与 `assignee_id` 一起使用时，只返回该成员负责的事项。省略本字段且 `assignee_id` 为正数时，按 `person` 过滤。",
+            "enum": [
+              "person",
+              "ai_sre"
+            ],
+            "type": "string"
           },
           "cursor": {
             "type": "string",
@@ -32809,7 +32836,15 @@
               "type": "integer",
               "format": "int64"
             },
-            "description": "初始负责人成员 ID 列表。负责人须为已能查看锚定对象的活跃成员；指派不会授予访问权限。"
+            "description": "初始负责人的旧版别名，等价于全部为 `person` 的 `assignees`。与 `assignees` 互斥，同时出现会报错。负责人须为已能查看锚定对象的活跃成员；指派不会授予访问权限。"
+          },
+          "assignees": {
+            "description": "初始负责人列表。每项为 `{type, id?}`。`type` 取 `person` 或 `ai_sre`；`ai_sre` 不带 `id`。与 `assignee_ids` 互斥，同时出现会报错。`assignee_ids` 是旧版别名，等价于全部为 `person`。最多 20 项。`person` 须为已能查看锚定对象的活跃成员；指派不会授予访问权限。",
+            "items": {
+              "$ref": "#/components/schemas/WorkItemAssignee"
+            },
+            "maxItems": 20,
+            "type": "array"
           },
           "idempotency_key": {
             "type": "string",
@@ -32983,7 +33018,15 @@
               "type": "integer",
               "format": "int64"
             },
-            "description": "新的负责人成员 ID 列表，整体替换当前集合。空数组表示清空所有负责人。"
+            "description": "替换后负责人集合的旧版别名，等价于全部为 `person` 的 `assignees`。与 `assignees` 互斥，同时出现会报错。空数组表示清空所有负责人。"
+          },
+          "assignees": {
+            "description": "替换后的负责人集合。每项为 `{type, id?}`。`type` 取 `person` 或 `ai_sre`；`ai_sre` 不带 `id`。与 `assignee_ids` 互斥，同时出现会报错。`assignee_ids` 是旧版别名，等价于全部为 `person`。最多 20 项。空数组表示清空所有负责人。",
+            "items": {
+              "$ref": "#/components/schemas/WorkItemAssignee"
+            },
+            "maxItems": 20,
+            "type": "array"
           }
         }
       },
@@ -33637,6 +33680,28 @@
             "format": "int64"
           }
         }
+      },
+      "WorkItemAssignee": {
+        "description": "跟进事项的一名负责人。",
+        "properties": {
+          "id": {
+            "description": "成员 ID。`type` 为 `person` 时必填；`type` 为 `ai_sre` 时省略。",
+            "format": "int64",
+            "type": "integer"
+          },
+          "type": {
+            "description": "负责人类型：`person` 为成员，`ai_sre` 为账户的 AI SRE。",
+            "enum": [
+              "person",
+              "ai_sre"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "type"
+        ],
+        "type": "object"
       }
     }
   }