| Session | 会话工作上下文 | A durable work-context identity linking pinned configuration, workspace, conversation, and cloud resources. Not a particular machine; recovery can change the resource. |
| Run | 一次任务执行 | The durable execution record of one submission. A Session allows one active Run; authorization/approval waits remain active. |
| Agent template | Agent 模板 | Optional reusable configuration with immutable revisions. Direct Session creation requires no template. |
| Control plane | 控制平面 | The service owning Sessions/Runs, tenant checks, credentials, durable events, and cloud-resource operations. |
| Sandbox | 云执行环境 | A remote isolated environment for task code, supplied by a provider and lifecycle-managed by the platform. Not a Console page. |
| Sandbox Runtime | Sandbox 内运行服务 | The in-Sandbox supervisor for Harness processes, Tool mailboxes, and execution communication. It does not own cloud-account operations. |
| Harness | Agent 执行引擎 | An engine running the model-driven loop, such as Pi/OpenCode; chosen separately from provider and model protocol. |
| Provider | 服务提供方 | An adapter target for a connection kind. Fly Sprites and Fly Machines are distinct; vendor identity does not imply uniform capabilities. |
| Connection | 连接 | Tenant-owned account configuration, endpoint, and access policy with validation, enablement, and version state. Not a single socket. |
| Binding | 绑定 | A named Session association, such as an alias-to-connection ID mapping in tools or connections. It does not expand permissions. |
| ToolBroker | 工具调用管理服务 | The control-plane component managing Tool authorization, approval, dispatch, durable calls, and unknown outcomes. |
| Agent Tool | Agent 可调用工具 | A named capability discoverable and callable by a Harness through the platform, supplied by HTTP Tools, applications, or Remote MCP. |
| Protected HTTP connection | 受保护 HTTP 连接 | Direct guest API access through a delegated URL with method/path restrictions; no automatic ToolBroker approval. |
| Authorization | 授权 | Establishing and maintaining authority to access an account/Tool. A credential does not prove access to every resource. |
| Approval | 调用审批 | A decision on executing a specific operation and arguments; not account login or a substitute for upstream permissions. |
| Secret | 受管理密钥 | An encrypted credential resource whose value is not echoed. Rotation/disable and reference-aware deletion apply. |
| Variable | 变量 | Ordinary guest-readable configuration, not a Secret. Putting a key here does not protect it. |
| Delegated grant | 委托访问授权 | Scoped, lifecycle-bound, revocable access. Its token still requires secrecy; it is not the original upstream account key. |
| Preflight | 预检 | Checks configuration, references, capabilities, and credential ingress before allocation; not proof of live connectivity, quota, or task success. |
| Validation | 连接验证 | Adapter-specific verification, sometimes only structural/list checks. Inspect its actual scope. |
| Pinned configuration | 固定配置 | Configuration versions and policy retained by a Session, not silently rewritten by later connection/template edits. |
| Idempotency key | 幂等键 | Identifies one logical submission. Preserve key/input after lost responses; use a new key for a new turn. |
| Durable event | 持久事件 | A state/activity record persisted before streaming. Disconnect does not cancel execution; cursors resume observation. |
| Artifact | 产物 | An exported downloadable deliverable that may survive close. Arbitrary workspace files are not automatically artifacts. |
| Private preview | 私有预览 | Authorized, expiry-bound access to a running service; not public deployment or a permanent URL. |
| Pause / suspend | 暂停 | An idle state retaining recovery context, not deletion. Memory/filesystem preservation depends on provider strategy. |
| Provider-managed standby | 供应商自动待机 | Provider-controlled standby whose compute/billing state may not be directly observable. |
| Resume / wake | 恢复 / 唤醒 | Continuing the same Session, possibly by resuming a VM or recreating from filesystem snapshot. |
| Close | 关闭 Session | Terminates the Session and coordinates cloud cleanup. Accepted close does not by itself confirm remote deletion. |
| Cancellation | 取消 Run | Stops further execution of that Run; cannot undo external writes and is not automatically Session close. |
| Unknown outcome | 结果未知 | A remote operation may have happened without a definitive receipt. Not failed and not permission to retry blindly. |
| Reconciliation | 对账 | Checking original operations/resources/external records and recording conclusions, not rerunning an action to guess its outcome. |
| OCI digest | OCI 内容摘要 | An immutable image-content identity, unlike a mutable tag; preparation can still modify the execution filesystem. |
| Native session ID | Harness 原生会话标识 | Harness-owned history identity, distinct from Hexagon Session ID and cloud resource ID. |
| Local / hosted | 本地 / 托管控制平面 | Describes control-plane deployment, not local task execution on the user computer; real tasks use cloud Sandboxes. |
| Verified combination | 已验证组合 | Evidence scoped to exact versions, protocols, SDKs, scenarios, and date; not certification of every catalog capability. |
| Agent revision | Agent 修订版本 | An immutable version of one Agent template definition, selected when creating a Session. It is not a Harness software version, and revising it does not migrate existing Sessions. |
| Workspace | 工作区 | Files available to task execution inside the Sandbox. It is not the durable artifact store, and retention depends on the lifecycle strategy. |
| Model protocol | 模型协议 | The request/response wire contract, such as Messages, Chat Completions or Responses. A model/vendor name does not establish protocol compatibility or imply conversion. |
| Event cursor | 事件游标 | A position for reading durable Run events, represented as a numeric string. It is neither an event count nor the internal Runtime cursor; gaps are valid. |
| Runtime invocation | Runtime 调用 | The persisted instruction for a Harness process execution managed by Runtime. Reconnecting to an existing invocation is not submitting a new Run. |
| Resource operation | 资源操作 | A durable record of a cloud lifecycle operation such as create or delete. Its completion concerns that operation, not the Run result or account-wide cleanup. |
| Lease / generation | 租约/代次 | Time-bounded worker ownership plus a fencing generation used to reject stale control-plane writes. It cannot roll back an upstream side effect. |
| Tenant | 租户 | The ownership boundary used by control-plane resource lookups and bindings. It does not automatically separate every end user in an application sharing one tenant. |