@sema-agent/sdk 8.7.0 → 9.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +111 -3
- package/dist/errors.d.ts +34 -4
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +52 -13
- package/dist/errors.js.map +1 -1
- package/dist/events.d.ts +18 -0
- package/dist/events.d.ts.map +1 -1
- package/dist/events.js.map +1 -1
- package/dist/health.d.ts +17 -0
- package/dist/health.d.ts.map +1 -1
- package/dist/health.js.map +1 -1
- package/dist/index.d.ts +6 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/resources/approvals.d.ts +24 -1
- package/dist/resources/approvals.d.ts.map +1 -1
- package/dist/resources/approvals.js +24 -1
- package/dist/resources/approvals.js.map +1 -1
- package/dist/resources/rules.d.ts +85 -8
- package/dist/resources/rules.d.ts.map +1 -1
- package/dist/resources/rules.js +9 -1
- package/dist/resources/rules.js.map +1 -1
- package/dist/resources/tool-approvals.d.ts +31 -5
- package/dist/resources/tool-approvals.d.ts.map +1 -1
- package/dist/resources/tool-approvals.js +4 -0
- package/dist/resources/tool-approvals.js.map +1 -1
- package/dist/resources/workflows.d.ts +10 -0
- package/dist/resources/workflows.d.ts.map +1 -1
- package/dist/resources/workflows.js.map +1 -1
- package/dist/types.d.ts +236 -26
- package/dist/types.d.ts.map +1 -1
- package/openapi.yaml +605 -68
- package/package.json +1 -1
package/dist/health.d.ts
CHANGED
|
@@ -48,6 +48,23 @@ export interface EngineHealth {
|
|
|
48
48
|
configHash?: string;
|
|
49
49
|
/** 🔴 公开承诺字段 — see {@link dataRoot}. Emitted UNCONDITIONALLY (`:753`). */
|
|
50
50
|
pid?: number;
|
|
51
|
+
/**
|
|
52
|
+
* **This process's start instant, epoch ms** — server >= 7.67.0 (S-179), emitted UNCONDITIONALLY beside
|
|
53
|
+
* {@link pid} (`src/http/server.ts`, `PROCESS_STARTED_AT_MS = Date.now() - round(process.uptime()*1000)`).
|
|
54
|
+
* Minted ONCE at module load from the PROCESS's own uptime, so it does not drift with lazy-load ordering.
|
|
55
|
+
*
|
|
56
|
+
* 🔴 WHAT IT IS FOR — a GENERATION anchor on the ONE unauthenticated door. `/health` needs no credentials
|
|
57
|
+
* (the heartbeat is always green), so "another host restarted the shared engine" was previously only
|
|
58
|
+
* discoverable by having some AUTHENTICATED request hit a 401 first — a path that misreads a restart as a
|
|
59
|
+
* network fault. A CHANGED `startedAt` means the port is now serving a DIFFERENT life; treat engine
|
|
60
|
+
* regeneration as a first-class fact instead of waiting for a failure.
|
|
61
|
+
* `instanceId` is the other anchor and the two are deliberately NOT folded: `instanceId` answers "is this
|
|
62
|
+
* the same life", `startedAt` also answers "since when".
|
|
63
|
+
* ⚠️ ONLY this number rides here — the service token itself and any generation COUNTER stay off the
|
|
64
|
+
* unauthenticated face.
|
|
65
|
+
* ⚠️ ABSENT on a worker < 7.67.0. Absence is "this worker cannot say", NEVER "it never restarted".
|
|
66
|
+
*/
|
|
67
|
+
startedAt?: number;
|
|
51
68
|
/** Emitted UNCONDITIONALLY (`:754`). */
|
|
52
69
|
port?: number;
|
|
53
70
|
draining?: boolean;
|
package/dist/health.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"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"}
|
package/dist/health.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"health.js","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;
|
|
1
|
+
{"version":3,"file":"health.js","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -3,7 +3,7 @@ export { AgentClient, type AgentClientConfig, type AgentAuthToken } from "./clie
|
|
|
3
3
|
/** Control plane (TOB): sema-registry / config-center `/api/config/*`. A peer client (different backend +
|
|
4
4
|
* secret) for managing the fleet config — see control-client.ts. */
|
|
5
5
|
export { ControlClient, type ControlClientConfig } from "./control-client.js";
|
|
6
|
-
export type { Principal, Scenario, RunStatus, TaskStats, TaskRequest, TaskAgentDefinition, TaskResult, ActiveRunConflictDoneResult, PendingGateMaterial, ApprovalStaleCurrentPending, TerminalCause, PausedCause, GateOutcome, GateDisposition, Settlement, DeniedBy, McpDelivered, McpFailureKind, LegacyPlaneTaskResult, WriteProtectionCapability, WriteProtectionPosture, WriteProtectedRow, ReadFacePosture, McpToolFace, ToolRoster, ToolRosterEntry, ApprovalDecisionResult, RunReceipt, RunRecord, CancelAck, Artifact, LeaderReceipt, LeaderRecord, SupervisorCostBreakdown, Capabilities, ScenarioDetail, PendingCheckpoint, SessionRecord, SkillSpec, TaskSummary, CheckpointGate, TraceTurn, TraceBlock, PromptManifest, PromptEpoch, SessionSummary, SessionListPage, SessionPermissionRules, StoredSessionRules, McpServerStatus, McpStatusPanel, SessionMemoryStatus, SessionMemoryStatusResponse, SessionWindow, SessionMessageEnvelope, SyncEntry, SyncSnapshot, SyncAnchor, SessionRulesRecord, SessionManifest, SessionBundle, SyncRelation, SyncConflictRelation, ImportStaged, ImportCommitted, TraceStreamEvent, WorkflowStreamEvent, ToolResultSlice, CheckpointSummary, InboxRow, AssistantGate, AssistantTask, PlanReviewRequest, AssistantTaskStatus, ImageIndexEntry, ImageSelectResult, ImageCapabilities, ImagePodContract, ModelInfo, ImageRegisterRequest, BakeCreateRequest, BakeRecordView, BakeIngestLine, BakeSubmitAck, UsageInfo, PolicyInfo, ModelUsageDelta, WorkflowRunStatus, WorkflowRunSummary, WorkflowRun, WorkflowAgentRow, WorkflowActivityBeat, WorkflowGroupNode, WiringManifest, ServerWiringGates, WiringDiagnostics, } from "./types.js";
|
|
6
|
+
export type { Principal, Scenario, RunStatus, TaskStats, TaskRequest, TaskAgentDefinition, TaskResult, ActiveRunConflictDoneResult, PendingGateMaterial, ApprovalStaleCurrentPending, TerminalCause, PausedCause, GateOutcome, GateDisposition, Settlement, DeniedBy, McpDelivered, McpFailureKind, LegacyPlaneTaskResult, WriteProtectionCapability, WriteProtectionPosture, WriteProtectedRow, ReadFacePosture, McpToolFace, ToolRoster, ToolRosterEntry, ApprovalDecisionResult, RunReceipt, RunRecord, CancelAck, Artifact, LeaderReceipt, LeaderRecord, SupervisorCostBreakdown, Capabilities, ScenarioDetail, PendingCheckpoint, SessionRecord, SkillSpec, TaskSummary, CheckpointGate, TraceTurn, TraceBlock, PromptManifest, PromptEpoch, SessionSummary, SessionListPage, SessionPermissionRules, StoredSessionRules, McpServerStatus, McpStatusPanel, SessionMemoryStatus, SessionMemoryStatusResponse, SessionWindow, SessionMessageEnvelope, SyncEntry, SyncSnapshot, SyncAnchor, SessionRulesRecord, SessionManifest, SessionBundle, SyncRelation, SyncConflictRelation, ImportStaged, ImportCommitted, TraceStreamEvent, WorkflowStreamEvent, ToolResultSlice, CheckpointSummary, InboxRow, AssistantGate, AssistantTask, PlanReviewRequest, AssistantTaskStatus, ImageIndexEntry, ImageSelectResult, ImageCapabilities, ImagePodContract, ModelInfo, ModelCompat, ModelThinkingFormat, ModelThinkingLevel, RoutePairingStatus, ImageRegisterRequest, BakeCreateRequest, BakeRecordView, BakeIngestLine, BakeSubmitAck, UsageInfo, PolicyInfo, ModelUsageDelta, WorkflowRunStatus, WorkflowItemStatus, WorkflowRunSummary, WorkflowRun, WorkflowAgentRow, WorkflowActivityBeat, WorkflowGroupNode, WiringManifest, ServerWiringGates, WiringDiagnostics, PostureSource, PostureKnobReading, } from "./types.js";
|
|
7
7
|
/** TOC `settings.json` — the SHARED environment-customization contract (CC-parity v1: permissions/hooks/env/model/
|
|
8
8
|
* outputStyle). ONE schema, two wirings: TOC-local (shell adapter → local Runner) + TOB-fleet (carried to service via
|
|
9
9
|
* {@link TaskRequest.settings}). SDK owns the CONTRACT only — no interpreter, no shell-hook runner. core/search AI
|
|
@@ -17,7 +17,7 @@ export { assertNever } from "./events.js";
|
|
|
17
17
|
export { MetricsResource, OutcomesResource, SendfileLinksResource, WiringDiagnosticsResource, type OutcomeRow, type SendfileLinkRow } from "./resources/ops.js";
|
|
18
18
|
export { BakesResource, type BakeClaim } from "./resources/images.js";
|
|
19
19
|
export { type UsageAnalyticsParams, type UsageMetric, type UsageGranularity, type UsageTotals, type UsageSummary, type UsageSeries, type UsageBreakdown, type UsageDimension } from "./resources/usage.js";
|
|
20
|
-
export { APIError, AuthError, RateLimitedError, QuotaExhaustedError, UsageWindowExhaustedError, MemoryAdmissionError, ScenarioNotAllowedError, BudgetExceededError, ConflictError, SyncConflictError, ApprovalStaleError, ApprovalBindingMismatchError, ApprovalConcurrentlyReopenedError, SteeringNotRunningError, SteeringInvalidContentError, PayloadTooLargeError, TaskStopConflictError, InterruptConflictError, PrincipalUnverifiedError, PrincipalUnboundError, ApprovalMacRequiredError, ApprovalMacInvalidError, GateNotResumableError, GateNotPlanReviewError, WorkspaceFileTooLargeError, SubagentResumeConflictError, ResumeRetryLaterError, WakeGatePendingError, RunNotLiveError, DrainingError, ResumeOutcomeInvalidError, ResumeBlockedByPolicyError, DecideError, DecideParkMovedError, DecideUnsupportedError, DecideStoreUnreachableError, ParkedResumeStartupError, BadRequestError, AttachmentRejectedError, NotFoundError, LimitExceededError, CapabilityUnavailableError, FeatureDisabledError, InternalServerError, ServiceStateError, SteeringError, SteeringAmbiguousTargetError, SteeringStillRunningError, SteeringQueueFullError, SteeringDuplicateInputIdError, GateNotToolApprovalError, AskDecidedError, AskIdempotencyConflictError, AskGoneError, AskParkingError,
|
|
20
|
+
export { APIError, AuthError, RateLimitedError, QuotaExhaustedError, UsageWindowExhaustedError, MemoryAdmissionError, ScenarioNotAllowedError, BudgetExceededError, ConflictError, SyncConflictError, ApprovalStaleError, ApprovalBindingMismatchError, ApprovalConcurrentlyReopenedError, SteeringNotRunningError, SteeringInvalidContentError, PayloadTooLargeError, TaskStopConflictError, InterruptConflictError, PrincipalUnverifiedError, PrincipalUnboundError, ApprovalMacRequiredError, ApprovalMacInvalidError, GateNotResumableError, GateNotPlanReviewError, WorkspaceFileTooLargeError, SubagentResumeConflictError, ResumeRetryLaterError, WakeGatePendingError, RunNotLiveError, DrainingError, ResumeOutcomeInvalidError, ResumeBlockedByPolicyError, DecideError, DecideParkMovedError, DecideUnsupportedError, DecideStoreUnreachableError, DecideWorkflowHostError, ParkedResumeStartupError, BadRequestError, AttachmentRejectedError, NotFoundError, LimitExceededError, CapabilityUnavailableError, FeatureDisabledError, InternalServerError, ServiceStateError, SteeringError, SteeringAmbiguousTargetError, SteeringStillRunningError, SteeringQueueFullError, SteeringDuplicateInputIdError, GateNotToolApprovalError, AskDecidedError, AskIdempotencyConflictError, AskGoneError, AskParkingError,
|
|
21
21
|
/** `DENIED` 态的唯一合法归因值(消费端做「路由失败 vs 人拒」判别用,别手抄字符串)。 */
|
|
22
22
|
DENY_REASON_ROUTING_FAILURE } from "./errors.js";
|
|
23
23
|
/** E4 quota deny (pinned wire shape) — structured detail on the 429 `quota_exhausted` typed error. */
|
|
@@ -98,7 +98,7 @@ export { RULE_OFFER_MATCHES, RULE_OFFER_BATCH_MEMBER_KINDS, RULE_OFFER_UNCOVERED
|
|
|
98
98
|
* · {@link DenialLimitFallback} / {@link DenialLimitKind} —— auto 分类器的**限额回落卡**
|
|
99
99
|
* (四成员全必填;`autoDenyAfterMs` 只渲倒计时,**禁**据它自铸第二只定时器)。
|
|
100
100
|
*/
|
|
101
|
-
export type { AskOrigin, RuleOffersAbsence, DenialLimitKind, DenialLimitFallback } from "./resources/tool-approvals.js";
|
|
101
|
+
export type { AskOrigin, ClassifierUnavailable, RuleOffersAbsence, DenialLimitKind, DenialLimitFallback } from "./resources/tool-approvals.js";
|
|
102
102
|
/** 上面两张闭词表的**单一真源**(`as const`;词类型由它们派生,运行期校验器读同一数组)。 */
|
|
103
103
|
export { RULE_OFFERS_ABSENCE_REASONS, DENIAL_LIMIT_KINDS } from "./resources/tool-approvals.js";
|
|
104
104
|
/** #154 车二 —— CC settings 导入两口(`client.rules`)的类型面。两步同意协议:prepare 出预览+票(**零规则
|
|
@@ -107,12 +107,12 @@ export { RULE_OFFERS_ABSENCE_REASONS, DENIAL_LIMIT_KINDS } from "./resources/too
|
|
|
107
107
|
export { RulesResource } from "./resources/rules.js";
|
|
108
108
|
export type { CcImportSettingsLayer, CcImportLayer, CcImportLayerReport, CcImportSkippedRule, CcImportPreview, CcImportPrepareResult, CcImportResult, CcImportRedeemedMember, CcImportRedeemResult, RuleScope, RuleCandidate, } from "./resources/rules.js";
|
|
109
109
|
/** design/203 §2(server 7.12.0)—— 规则**撤销面**两口的类型面(`client.rules.list` / `.revoke`)。
|
|
110
|
-
* 🔴 `DELETE /v1/rules` **路径上没有 `:id` 段**:规则按 `(rule, scope)` **内容**寻址,回传字节要逐字
|
|
111
|
-
* 照 {@link PersistedRule}
|
|
110
|
+
* 🔴 `DELETE /v1/rules` **路径上没有 `:id` 段**:规则按 `(behavior, rule, scope)` **内容**寻址,回传字节要逐字
|
|
111
|
+
* 照 {@link PersistedRule} 给的那三串(server ≥7.67.0 起身份含 `behavior`)。列举是 keyset 分页且**游标绑 `(rev, principal, scope)`**——对不上
|
|
112
112
|
* 当场 400,丢掉游标从头列(静默重置会铸出一份既漏行又重行的治理清单)。撤销**幂等**:重复删 / 本来
|
|
113
113
|
* 没有一律 200 `no-op`(**不是 404** —— 那会是一台存在性 oracle),而**两支 200 都带 `stillLive`**:
|
|
114
114
|
* 它为真意味着墓碑落了但 add-wins 让规则仍然活着,没读它之前别对人说「规则已经没了」。 */
|
|
115
|
-
export type { RuleDot, RuleAdd, RuleAddOrigin, PersistedRule, RuleListParams, RuleListResult, RuleRevokeRequest, RuleRevokeResult, } from "./resources/rules.js";
|
|
115
|
+
export type { RuleDot, RuleAdd, RuleAddOrigin, RuleBehavior, PersistedRule, RuleListParams, RuleListResult, RuleRevokeRequest, RuleRevokeResult, } from "./resources/rules.js";
|
|
116
116
|
/** design/183 —— 身份收编面(`client.adoption`)的类型面。回执只有一种包络(首次与幂等重跑同形);
|
|
117
117
|
* `status` 闭集不含 `rejected`(拒一律 typed 409);史实 `immutableReport` 与现势 `current` 各住各的字段。 */
|
|
118
118
|
export { AdoptionResource } from "./resources/adoption.js";
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACvF;qEACqE;AACrE,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EACV,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,mBAAmB,EAAE,UAAU,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,2BAA2B,EAQtK,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAI5G,qBAAqB,EAErB,yBAAyB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,sBAAsB,EACvJ,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,uBAAuB,EAChG,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAC1J,cAAc,EAAE,eAAe,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAC5G,mBAAmB,EAAE,2BAA2B,EAChD,aAAa,EAAE,sBAAsB,EACrC,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,eAAe,EAAE,aAAa,EACvF,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,eAAe,EACjE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EACtD,iBAAiB,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,mBAAmB,EACjG,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,SAAS,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACvF;qEACqE;AACrE,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EACV,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,mBAAmB,EAAE,UAAU,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,2BAA2B,EAQtK,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAI5G,qBAAqB,EAErB,yBAAyB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,sBAAsB,EACvJ,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,uBAAuB,EAChG,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAC1J,cAAc,EAAE,eAAe,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAC5G,mBAAmB,EAAE,2BAA2B,EAChD,aAAa,EAAE,sBAAsB,EACrC,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,eAAe,EAAE,aAAa,EACvF,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,eAAe,EACjE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EACtD,iBAAiB,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,mBAAmB,EACjG,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,SAAS,EAAE,WAAW,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAG5J,oBAAoB,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EACtF,SAAS,EAAE,UAAU,EAAE,eAAe,EACtC,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,iBAAiB,EACjI,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAEpD,aAAa,EAAE,kBAAkB,GAClC,MAAM,YAAY,CAAC;AACpB;;;mEAGmE;AACnE,YAAY,EACV,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,WAAW,EAGvG,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/E,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,kGAAkG;AAClG,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,KAAK,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAChK,OAAO,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3M,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,iCAAiC,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,eAAe,EAI5pB,aAAa,EAEb,yBAAyB,EAAE,0BAA0B,EACrD,WAAW,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,wBAAwB,EAGzI,eAAe,EACf,uBAAuB,EAAE,aAAa,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,oBAAoB,EAC5G,mBAAmB,EAAE,iBAAiB,EAEtC,aAAa,EAAE,4BAA4B,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,6BAA6B,EAE7H,wBAAwB,EAGxB,eAAe,EAAE,2BAA2B,EAAE,YAAY,EAAE,eAAe;AAC3E,sDAAsD;AACtD,2BAA2B,EAAE,MAAM,aAAa,CAAC;AACnD,sGAAsG;AACtG,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD;yDACyD;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C;6GAC6G;AAC7G,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC;;sGAEsG;AACtG,OAAO,EAAE,+BAA+B,EAAE,MAAM,UAAU,CAAC;AAC3D;6GAC6G;AAC7G,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,6BAA6B,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrH,8GAA8G;AAC9G,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC3H,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC3G,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC7G,0FAA0F;AAC1F,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACvE;wCACwC;AACxC,OAAO,EAAE,0BAA0B,EAAE,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,YAAY,EACV,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,EACrD,uBAAuB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,sBAAsB,EACjG,iBAAiB,EAAE,mBAAmB;AACtC,iGAAiG;AACjG,mBAAmB,EAAE,iBAAiB,GACvC,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,yBAAyB,EAAE,mBAAmB,EAAE,kBAAkB,EAClE,oBAAoB,EAAE,6BAA6B,GACpD,MAAM,0BAA0B,CAAC;AAClC,qGAAqG;AACrG,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACxK,8DAA8D;AAC9D,YAAY,EACV,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EACxF,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAC5E,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,mBAAmB,EACrG,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAC9D,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EACzE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,qBAAqB,EAC5F,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,EAC5F,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,wBAAwB,EACrF,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,qBAAqB,GACvF,MAAM,oBAAoB,CAAC;AAC5B;oDACoD;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD;6FAC6F;AAC7F,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC/H,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACtG,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACtJ,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACrH;;2DAE2D;AAC3D,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvF;;;;;;;;;;;GAWG;AACH,YAAY,EACV,SAAS,EAAE,cAAc,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,wBAAwB,EACnG,oBAAoB,EAAE,mBAAmB,GAC1C,MAAM,+BAA+B,CAAC;AACvC,wEAAwE;AACxE,OAAO,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAChI;;;;;;;;;;;GAWG;AACH,YAAY,EAAE,SAAS,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAC/I,yDAAyD;AACzD,OAAO,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAChG;;gFAEgF;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EACV,qBAAqB,EAAE,aAAa,EAAE,mBAAmB,EAAE,mBAAmB,EAC9E,eAAe,EAAE,qBAAqB,EAAE,cAAc,EAAE,sBAAsB,EAAE,oBAAoB,EACpG,SAAS,EAAE,aAAa,GACzB,MAAM,sBAAsB,CAAC;AAC9B;;;;;sDAKsD;AACtD,YAAY,EACV,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAC5D,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,GACpE,MAAM,sBAAsB,CAAC;AAC9B;yFACyF;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EACV,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EACjF,WAAW,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,uBAAuB,GAClG,MAAM,yBAAyB,CAAC;AACjC;;;;;;uEAMuE;AACvE,YAAY,EACV,oBAAoB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,YAAY,EAAE,sBAAsB,EACtG,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,GACvF,MAAM,+BAA+B,CAAC;AACvC;2DAC2D;AAC3D,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAIlG;iHACiH;AACjH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,mBAAmB,EAAE,eAAe,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAGpN,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEvJ,OAAO,EACL,iBAAiB,EACjB,KAAK,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,KAAK,aAAa;AACtE;0DAC0D;AAC1D,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,GACnD,MAAM,0BAA0B,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -13,7 +13,7 @@ export { APIError, AuthError, RateLimitedError, QuotaExhaustedError, UsageWindow
|
|
|
13
13
|
// errors.test.ts 的导出面门现在机器看住整族)。
|
|
14
14
|
DrainingError,
|
|
15
15
|
// resume/decide 面(2026-07-25):见 errors.ts 各类注释。`DecideError` 是家族基类 —— 一把 catch 住 decide 门。
|
|
16
|
-
ResumeOutcomeInvalidError, ResumeBlockedByPolicyError, DecideError, DecideParkMovedError, DecideUnsupportedError, DecideStoreUnreachableError, ParkedResumeStartupError,
|
|
16
|
+
ResumeOutcomeInvalidError, ResumeBlockedByPolicyError, DecideError, DecideParkMovedError, DecideUnsupportedError, DecideStoreUnreachableError, DecideWorkflowHostError, ParkedResumeStartupError,
|
|
17
17
|
// 附录 A 判据三的 11 个稳定前缀族兜底(SDK 1.1.0 × server 3.x;`gone.` / `parking.` 两族随 server 7.3.0
|
|
18
18
|
// 上 wire,见 errors.ts 顶注):`auth.` / `conflict.` 复用上面的 AuthError / ConflictError,其余各一个类。整族一把 catch,未知新码有信息地降级(见 errors.ts 顶注)。
|
|
19
19
|
BadRequestError, AttachmentRejectedError, NotFoundError, LimitExceededError, CapabilityUnavailableError, FeatureDisabledError, InternalServerError, ServiceStateError,
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,OAAO,EAAE,WAAW,EAA+C,MAAM,aAAa,CAAC;AACvF;qEACqE;AACrE,OAAO,EAAE,aAAa,EAA4B,MAAM,qBAAqB,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -136,7 +136,30 @@ export declare class ApprovalsResource {
|
|
|
136
136
|
* (server 1.268):豁免落该子代的 **root/host 会话**(「本会话」= 宿主会话树全域,子代同享),复活后
|
|
137
137
|
* 同工具的下一问被短路;`decide.parked_remember_unsupported`(400)仅剩无会话锚的受损行防御臂。
|
|
138
138
|
* 任务级 suspend 的 decide **错误面**(4xx/5xx)与 parked 腿各归各不变;其 200 形自 server 7.37 起
|
|
139
|
-
* 见顶部 #316 段(受理回执),pre-7.37 仍是终局形。
|
|
139
|
+
* 见顶部 #316 段(受理回执),pre-7.37 仍是终局形。
|
|
140
|
+
*
|
|
141
|
+
* **Parked WORKFLOW-agent variant**(server ≥7.69.0,S-185 / core 7.10.0 #642 —— **第三条车道**):
|
|
142
|
+
* 一个 **workflow 子代**也会停在审批门上(那条 `wa*` 行记 `status:"parked"`,整条 workflow run 挂起)。
|
|
143
|
+
* /decide 现在认得这个出身;7.69.0 以前这种 checkpoint 会掉进任务级腿吃一个响亮但**错因**的
|
|
144
|
+
* `409 conflict.resume_context_unavailable`(workflow 子代的会话没有 resume 上下文),于是人的批准无处可去。
|
|
145
|
+
*
|
|
146
|
+
* 🔴 **决定的走法与 bg 车道刻意不同,消费端必须分开读**:引擎面向部署的唯一通道是「resume **宿主会话**、
|
|
147
|
+
* 带上这条决定,宿主再调一次 `Workflow({resumeFromRunId})`,引擎据此把 park 住的子代推下去」。所以
|
|
148
|
+
* 成功形是**宿主会话的 wake 受理形** `{taskId: <宿主新铸 run id>, sessionId, status:"resuming",
|
|
149
|
+
* bindingEnforced:true}` —— **不是** `a*` 句柄。三条后果:
|
|
150
|
+
* · **200 = 投递受理,不是门已解决**:子代的 checkpoint 要等 workflow 引擎自己去 resolve,所以 200 之后
|
|
151
|
+
* 那张卡**可能仍在** `list()` 上 ⇒ **禁**据 200 把卡从 UI 抹掉;看进度 poll `GET /v1/runs/{taskId}`(宿主的 run),
|
|
152
|
+
* 不要盯那张卡;
|
|
153
|
+
* · **投递可能丢**:宿主那一跑若在重新调用 `Workflow` 之前被打断(崩溃 / 资源限额挂起),决定随那次调用
|
|
154
|
+
* 消失(它不持久化在任何地方),重发得到 409 `decide.workflow_host_not_parked`。卡全程 pending ⇒ 什么都
|
|
155
|
+
* 没有被伪造,宿主再 park 之后可以重决,或据 `runId` 自行 resume 那条 run;
|
|
156
|
+
* · 三个专有码({@link import("../errors.js").DecideWorkflowHostError} / `DecideUnsupportedError`,体带
|
|
157
|
+
* **`runId`** 而**不带** `taskId`):`decide.workflow_host_unknown`(409,run 上没有发起会话锚 —— 直起的
|
|
158
|
+
* `runWorkflow`,无处投递,没有重试价值)、`decide.workflow_host_not_parked`(409,宿主此刻没停在可唤醒的
|
|
159
|
+
* park 上 —— 等它再 park 后重发)、`decide.workflow_remember_unsupported`(400,本车道 fail-closed 拒
|
|
160
|
+
* `remember:"session"`:这条腿的 200 证不出引擎已提交,据它落免询问豁免会让豁免活过一个后来被引擎拒掉
|
|
161
|
+
* 的决定 —— 去掉 `remember` 重发即可,零副作用)。
|
|
162
|
+
* **读面一个字未动**:`/v1/approvals`、`/v1/approvals/stream`、inbox 的键集不变,**不加**任何 workflow 出身标。 */
|
|
140
163
|
decide(sessionId: string, decision: ApprovalDecision, opts?: {
|
|
141
164
|
signal?: AbortSignal;
|
|
142
165
|
}): Promise<ApprovalDecisionResult>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../../src/resources/approvals.ts"],"names":[],"mappings":"AAAA;;mFAEmF;AACnF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIrD;;4DAE4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;kDAakD;AAClD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACzF;;;;2FAIuF;IACvF,eAAe,CAAC,EAAE,IAAI,CAAC;IACvB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC;IAC7B;;;;;;;;yFAQqF;IACrF,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAKhB;;;uEAGmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6GAA6G;IAC7G,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;4GACwG;IACxG,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;wFAKoF;IACpF,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;+EAK+E;AAC/E,MAAM,WAAW,oBAAoB;IACnC,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC;CAC9B;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAEzC;;;;;;;;;;;;oCAYgC;IAC1B,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAOxF;;;;;;8DAM0D;IACpD,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC;IAWtI
|
|
1
|
+
{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../../src/resources/approvals.ts"],"names":[],"mappings":"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"}
|
|
@@ -64,7 +64,30 @@ export class ApprovalsResource {
|
|
|
64
64
|
* (server 1.268):豁免落该子代的 **root/host 会话**(「本会话」= 宿主会话树全域,子代同享),复活后
|
|
65
65
|
* 同工具的下一问被短路;`decide.parked_remember_unsupported`(400)仅剩无会话锚的受损行防御臂。
|
|
66
66
|
* 任务级 suspend 的 decide **错误面**(4xx/5xx)与 parked 腿各归各不变;其 200 形自 server 7.37 起
|
|
67
|
-
* 见顶部 #316 段(受理回执),pre-7.37 仍是终局形。
|
|
67
|
+
* 见顶部 #316 段(受理回执),pre-7.37 仍是终局形。
|
|
68
|
+
*
|
|
69
|
+
* **Parked WORKFLOW-agent variant**(server ≥7.69.0,S-185 / core 7.10.0 #642 —— **第三条车道**):
|
|
70
|
+
* 一个 **workflow 子代**也会停在审批门上(那条 `wa*` 行记 `status:"parked"`,整条 workflow run 挂起)。
|
|
71
|
+
* /decide 现在认得这个出身;7.69.0 以前这种 checkpoint 会掉进任务级腿吃一个响亮但**错因**的
|
|
72
|
+
* `409 conflict.resume_context_unavailable`(workflow 子代的会话没有 resume 上下文),于是人的批准无处可去。
|
|
73
|
+
*
|
|
74
|
+
* 🔴 **决定的走法与 bg 车道刻意不同,消费端必须分开读**:引擎面向部署的唯一通道是「resume **宿主会话**、
|
|
75
|
+
* 带上这条决定,宿主再调一次 `Workflow({resumeFromRunId})`,引擎据此把 park 住的子代推下去」。所以
|
|
76
|
+
* 成功形是**宿主会话的 wake 受理形** `{taskId: <宿主新铸 run id>, sessionId, status:"resuming",
|
|
77
|
+
* bindingEnforced:true}` —— **不是** `a*` 句柄。三条后果:
|
|
78
|
+
* · **200 = 投递受理,不是门已解决**:子代的 checkpoint 要等 workflow 引擎自己去 resolve,所以 200 之后
|
|
79
|
+
* 那张卡**可能仍在** `list()` 上 ⇒ **禁**据 200 把卡从 UI 抹掉;看进度 poll `GET /v1/runs/{taskId}`(宿主的 run),
|
|
80
|
+
* 不要盯那张卡;
|
|
81
|
+
* · **投递可能丢**:宿主那一跑若在重新调用 `Workflow` 之前被打断(崩溃 / 资源限额挂起),决定随那次调用
|
|
82
|
+
* 消失(它不持久化在任何地方),重发得到 409 `decide.workflow_host_not_parked`。卡全程 pending ⇒ 什么都
|
|
83
|
+
* 没有被伪造,宿主再 park 之后可以重决,或据 `runId` 自行 resume 那条 run;
|
|
84
|
+
* · 三个专有码({@link import("../errors.js").DecideWorkflowHostError} / `DecideUnsupportedError`,体带
|
|
85
|
+
* **`runId`** 而**不带** `taskId`):`decide.workflow_host_unknown`(409,run 上没有发起会话锚 —— 直起的
|
|
86
|
+
* `runWorkflow`,无处投递,没有重试价值)、`decide.workflow_host_not_parked`(409,宿主此刻没停在可唤醒的
|
|
87
|
+
* park 上 —— 等它再 park 后重发)、`decide.workflow_remember_unsupported`(400,本车道 fail-closed 拒
|
|
88
|
+
* `remember:"session"`:这条腿的 200 证不出引擎已提交,据它落免询问豁免会让豁免活过一个后来被引擎拒掉
|
|
89
|
+
* 的决定 —— 去掉 `remember` 重发即可,零副作用)。
|
|
90
|
+
* **读面一个字未动**:`/v1/approvals`、`/v1/approvals/stream`、inbox 的键集不变,**不加**任何 workflow 出身标。 */
|
|
68
91
|
async decide(sessionId, decision, opts) {
|
|
69
92
|
return this.t.request({
|
|
70
93
|
method: "POST",
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"approvals.js","sourceRoot":"","sources":["../../src/resources/approvals.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAuFxC,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAE7C;;;;;;;;;;;;oCAYgC;IAChC,KAAK,CAAC,GAAG,CAAC,EAAU,EAAE,IAA+B;QACnD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;QACpD,IAAI,GAAG;YAAE,OAAO,GAAyC,CAAC;QAC1D,MAAM,IAAI,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,mCAAmC,EAAE,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;8DAM0D;IAC1D,KAAK,CAAC,IAAI,CAAC,IAA+C;QACxD,2EAA2E;QAC3E,0EAA0E;QAC1E,sFAAsF;QACtF,6EAA6E;QAC7E,sEAAsE;QACtE,sFAAsF;QACtF,MAAM,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,UAAU,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,8BAA8B;QACvG,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAmE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9J,CAAC;IAED
|
|
1
|
+
{"version":3,"file":"approvals.js","sourceRoot":"","sources":["../../src/resources/approvals.ts"],"names":[],"mappings":"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"}
|
|
@@ -63,8 +63,22 @@ export type RuleScope = {
|
|
|
63
63
|
kind: "project";
|
|
64
64
|
root: string;
|
|
65
65
|
};
|
|
66
|
-
/**
|
|
66
|
+
/**
|
|
67
|
+
* 一条持久规则的**态**(core `RULE_BEHAVIORS`,闭三词,**优先序**即此序:deny > ask > allow)。
|
|
68
|
+
*
|
|
69
|
+
* 🔴 **规则的身份是 (behavior, 文本, 作用域) 三元组**(core `sameRuleIdentity`;server ≥7.67.0 / core 7.9.0
|
|
70
|
+
* #625):同一段文本的 `deny` 与 `allow` 是**两条不同的行**。一个忘了这一格的比较,会让一次瞄准 `allow` 的
|
|
71
|
+
* 撤销删掉同文本的 `deny` —— 所以撤销体上这一格**必填且不给默认**。
|
|
72
|
+
* `allow` = 一次人工批准的常驻形(卡上点的「不再询问」);`deny` / `ask` = 「永不运行」与「每次都问我」的
|
|
73
|
+
* 常驻形(引擎从 settings 的 deny/ask 表读的同一种内容形规则)。**一套文法、一种规范拼法、一族匹配器**服务
|
|
74
|
+
* 三态,态是**文本旁边的一格**,永远不是文本的一部分。
|
|
75
|
+
*/
|
|
76
|
+
export type RuleBehavior = "deny" | "ask" | "allow";
|
|
77
|
+
/** 一条候选规则:**态** + 规范文本 + 它会落在哪个作用域(core `RuleCandidate`)。 */
|
|
67
78
|
export interface RuleCandidate {
|
|
79
|
+
/** 🔴 server ≥7.67.0 / core 7.9.0 #625 —— 这条候选是哪一态。卡道只铸 `allow`(一张卡 = 一个人的一次 yes);
|
|
80
|
+
* settings 导入道自本版起**三个表都读**(此前只收 allow 桶),所以这条面上三词都可能到达。 */
|
|
81
|
+
behavior: RuleBehavior;
|
|
68
82
|
rule: string;
|
|
69
83
|
scope: RuleScope;
|
|
70
84
|
}
|
|
@@ -119,12 +133,30 @@ export interface CcImportLayer {
|
|
|
119
133
|
*
|
|
120
134
|
* `uncovered` 是**两键记录而不是列表**(core 原形):本版不读的两层写在 TYPE 里,于是「空列表 / 少一员 /
|
|
121
135
|
* 重复一员」都不可拼写。
|
|
136
|
+
*
|
|
137
|
+
* 🔴 **server ≥7.67.0 / core 7.9.0 #625:deny/ask 桶现在也导入**。此前只收 allow 桶,deny/ask 条目会被报进
|
|
138
|
+
* `uncovered.denyAskBuckets` 那一格说「未覆盖」;自本版起每条候选自带 {@link RuleCandidate.behavior},
|
|
139
|
+
* `uncovered` 旁边**不再有**那个「留在原地」的计数 —— 没成为候选的条目一律在 `skipped` 里带着它的理由。
|
|
140
|
+
* 按 `uncovered.denyAskBuckets` 渲染的消费端要改读 `candidates[].behavior`。
|
|
122
141
|
*/
|
|
123
142
|
export interface CcImportPreview {
|
|
124
143
|
/** 会被持久化的候选(顺序即兑付顺序)。 */
|
|
125
144
|
candidates: RuleCandidate[];
|
|
126
145
|
/** 没进候选的条目(`reason` 是散文,不是码 —— 见 {@link CcImportSkippedRule})。 */
|
|
127
146
|
skipped: CcImportSkippedRule[];
|
|
147
|
+
/**
|
|
148
|
+
* **本版恒为空数组**的兼容座(core `ImportPreview.translated` 顶注逐字:"ALWAYS EMPTY in this version —
|
|
149
|
+
* a compatibility seat")。它曾经装「进来的路上匹配形被改写过」的条目(另一产品的 space-star 建议形翻成
|
|
150
|
+
* 本车道的 colon-star);那次翻译已退役 —— space-star 自己成了本车道文法的一等匹配形,于是条目的匹配形
|
|
151
|
+
* **按文件里写的样子**落地。按这一格渲染「改写过的拼法」列 = 渲染一个空列,正确。
|
|
152
|
+
* ⚠️ 8.7.0 及以前**型面与 spec 都漏了这一格**,而 core 每次都发它 ⇒ 严格消费端会把真实的 200 体判违约;
|
|
153
|
+
* 本版补齐(如实登记,不是行为变更)。
|
|
154
|
+
*/
|
|
155
|
+
translated: Array<{
|
|
156
|
+
from: string;
|
|
157
|
+
to: string;
|
|
158
|
+
scope: RuleScope;
|
|
159
|
+
}>;
|
|
128
160
|
/** 逐层读取报告。 */
|
|
129
161
|
layers: CcImportLayerReport[];
|
|
130
162
|
/** 本版**不读**的两层,写死在类型里(不是运行期列表)。 */
|
|
@@ -154,6 +186,9 @@ export interface CcImportPrepareResult {
|
|
|
154
186
|
export interface CcImportRedeemedMember {
|
|
155
187
|
/** 这条成员在 prepare 候选集里的下标(candidate 空间;与 preview 的 `candidates` 对位)。 */
|
|
156
188
|
candidateIndex: number;
|
|
189
|
+
/** server ≥7.67.0 / core 7.9.0 #625 —— 落库的那条行是哪一态(与 preview 里同下标候选的
|
|
190
|
+
* {@link RuleCandidate.behavior} 同值;身份三元组的一格)。 */
|
|
191
|
+
behavior: RuleBehavior;
|
|
157
192
|
/** 规范规则文本。 */
|
|
158
193
|
rule: string;
|
|
159
194
|
/** 落库作用域(与 {@link RuleCandidate.scope} 同形)。 */
|
|
@@ -222,29 +257,58 @@ export interface RuleAdd {
|
|
|
222
257
|
createdAt: string;
|
|
223
258
|
}
|
|
224
259
|
/**
|
|
225
|
-
* `GET /v1/rules`
|
|
260
|
+
* `GET /v1/rules` 列出来的一条**活着**的持久规则(server `PersistedRuleWireRow`)。墓碑已折算 ——
|
|
226
261
|
* 这里的每一行在 {@link RuleListResult.rev} 那一刻都是活的。
|
|
227
262
|
*
|
|
228
263
|
* 🔴 `scope` 是**判别式串**(`global` / `project:<root>`),**不是**导入道说的 {@link RuleScope} 对象:
|
|
229
264
|
* 它就是撤销体想要回去的那串字节,所以**原样回传**,别拿解析后的形重新序列化(拼法等价但不逐字相同的
|
|
230
265
|
* root 什么都匹配不上,而且会得到一个笑呵呵的 `no-op`)。
|
|
231
266
|
*
|
|
232
|
-
* 🔴
|
|
267
|
+
* 🔴 **三态,不再只有 allow**(server ≥7.67.0 / core 7.9.0 #625):见 {@link behavior}。8.7.0 及以前这里写着
|
|
268
|
+
* 「规则车道只有 allow,deny/ask 永远不会出现在这里」—— 那句话自 server 7.67.0 起是假的。
|
|
233
269
|
*/
|
|
234
270
|
export interface PersistedRule {
|
|
271
|
+
/** 🔴 server ≥7.67.0 —— 这一行是哪一态(见 {@link RuleBehavior})。**身份的一格**:同文本不同态是两条
|
|
272
|
+
* 不同的行,撤销时必须**原样**回传这一格,否则会瞄准另一态。 */
|
|
273
|
+
behavior: RuleBehavior;
|
|
235
274
|
/** 规范规则文本 —— `Bash(git status)`(exact)或 `Bash(git status:*)`(prefix)。撤销时**原样**回传。 */
|
|
236
275
|
rule: string;
|
|
237
276
|
/** 作用域判别式串:`global`,或 `project:<root>`(root **非空**)。撤销时**原样**回传。 */
|
|
238
277
|
scope: string;
|
|
239
|
-
/**
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
278
|
+
/**
|
|
279
|
+
* 这条行说的是哪只工具。🔴 **不是闭集**(server ≥7.67.0 / core 7.9.0 #625,型自 `"Bash"` 放宽成 `string`):
|
|
280
|
+
* 工具集自引擎**目录**的路径目标声明派生 —— `Bash` = 命令文法,声明了 `pathTarget` 的工具(`Read` /
|
|
281
|
+
* `Write` / `Edit` / `Glob` / `Grep` / `NotebookEdit` …)= 路径文法。判据是「引擎的规则文法认不认得这个
|
|
282
|
+
* 名字」,而那份名单在引擎的目录里、不在这条 wire 上。**读它,别按闭集写 switch**;server 对认不得的名字
|
|
283
|
+
* 仍是 400。
|
|
284
|
+
*/
|
|
285
|
+
tool: string;
|
|
286
|
+
/**
|
|
287
|
+
* 匹配形(core `PersistedRuleMatch`,五员):`exact` = 只这一条命令 · `prefix` = 词边界前缀(历史
|
|
288
|
+
* colon-star 拼法,复合前缀形的唯一拼法)· `wildcard` = space-star,单命令体上与 `prefix` **同一谓词** ·
|
|
289
|
+
* `subpath` = 目录形(只读容纳,永不容纳任何命令)· `path` = **server ≥7.67.0 新增**,路径族 deny/ask/allow
|
|
290
|
+
* 的模式文法(`//abs`、`~/`、根相对、cwd 相对;段内 `*`、跨段 `**`)。
|
|
291
|
+
* ⚠️ 8.7.0 的型面只写了前两员 —— 按闭集渲染这一格的消费端要补后三员。留 `(string & {})` 逃生口是因为
|
|
292
|
+
* 词表属主是引擎;**spec 侧是闭 enum**。
|
|
293
|
+
*/
|
|
294
|
+
match: "exact" | "prefix" | "wildcard" | "subpath" | "path" | (string & {});
|
|
243
295
|
/** 匹配器**真正**拿去比的东西:铸规则时从 `rule` 里解出来存下的,省得每个消费端各自重解一遍。
|
|
244
296
|
* 信它 + `match`,别信你自己对 `rule` 的解析。 */
|
|
245
297
|
command: string;
|
|
246
298
|
/** 这条规则**全部活着的** add(见 {@link RuleAdd} —— 真集合,刻意不折叠)。 */
|
|
247
299
|
adds: RuleAdd[];
|
|
300
|
+
/**
|
|
301
|
+
* 这一行来自哪个源(server ≥7.57.0 / core 7.5.0 design/389)。**由 `scope` 派生**(`global`⟺`user`、
|
|
302
|
+
* `project`⟺`project`、`session`⟺`session`)—— 行上没有第二个会跟 `scope` 漂的字节。今天本部署只接
|
|
303
|
+
* durable 一格分区 ⇒ 实际值域是 `user | project`。
|
|
304
|
+
* ⚠️ **导入面不收这一格**:把列举行原样 POST 回 local-import 会 400(它与 {@link status} 都是派生键)。
|
|
305
|
+
*/
|
|
306
|
+
source: "user" | "project" | "session" | (string & {});
|
|
307
|
+
/**
|
|
308
|
+
* 这一行的**站位**(server ≥7.57.0 / design/389):`live`,或 `shadowed-by-org`(org deny 盖到了它的命令
|
|
309
|
+
* 模式上)。今天无 org 分区 ⇒ 恒 `live` —— **现在就按两值写分支**,别按恒真优化掉。
|
|
310
|
+
*/
|
|
311
|
+
status: "live" | "shadowed-by-org" | (string & {});
|
|
248
312
|
}
|
|
249
313
|
/**
|
|
250
314
|
* `rules.list()` 的 200 体。
|
|
@@ -284,6 +348,13 @@ export interface RuleListParams {
|
|
|
284
348
|
}
|
|
285
349
|
/** `rules.revoke()` 的请求体。规则**按内容**寻址 —— 这条面上下没有任何 id。 */
|
|
286
350
|
export interface RuleRevokeRequest {
|
|
351
|
+
/**
|
|
352
|
+
* 🔴 **必填,server ≥7.67.0**(少了它 400 `request.body_shape`)—— 要撤的是**哪一态**的那条行,
|
|
353
|
+
* **逐字**照 {@link PersistedRule.behavior}。
|
|
354
|
+
* 🔴 **这一格刻意不给默认**:一次瞄准 `allow` 的撤销若被默认成同文本的 `deny`(或反过来),删掉的是一条
|
|
355
|
+
* 本该留着的**拒绝**规则,而调用方收到的是一个 200。core 的 `sameRuleIdentity` 顶注逐字写着这一形。
|
|
356
|
+
*/
|
|
357
|
+
behavior: RuleBehavior;
|
|
287
358
|
/** 规范规则文本,**逐字**照 {@link PersistedRule.rule}。 */
|
|
288
359
|
rule: string;
|
|
289
360
|
/** 作用域判别式串,**逐字**照 {@link PersistedRule.scope}(`global` / `project:<非空 root>`)。 */
|
|
@@ -357,6 +428,11 @@ export declare class RulesResource {
|
|
|
357
428
|
* 游标来翻页 ⇒ 400 `request.query_invalid`(体里带当前 `rev`),**丢掉游标从头列**即可。静默重置的代价
|
|
358
429
|
* 是客户端把第二页当成「接着上一页」,治理面上于是出现一份既漏行又重行的清单,而没有任何人知道。
|
|
359
430
|
*
|
|
431
|
+
* 🔴 **游标带格式代,server ≥7.67.0 抬到 v2 —— 型不变,老游标一律 400 重列**(排序键随规则身份从
|
|
432
|
+
* `(scope, rule)` 二元组变成 `(scope, rule, behavior)` 三元组而换形)。滚动升级/回退期间两代副本互接
|
|
433
|
+
* 对方的游标是**响亮拒**,不是各按各的键形静默跳行:一份治理清单在全 200 之下失真,比一次重列贵得多。
|
|
434
|
+
* 处置不变 —— 游标恒当**不透明串**原样回传,拿到 400 就丢掉重列。
|
|
435
|
+
*
|
|
360
436
|
* 🔴 **翻页要翻完**:`nextCursor` 缺席才是终点。半途停下拿到的是**一份不全的清单**,而这条面的消费者
|
|
361
437
|
* (治理视图)恰恰最不能拿不全的清单当全量。
|
|
362
438
|
*
|
|
@@ -378,7 +454,8 @@ export declare class RulesResource {
|
|
|
378
454
|
signal?: AbortSignal;
|
|
379
455
|
}): Promise<RuleListResult>;
|
|
380
456
|
/**
|
|
381
|
-
* `DELETE /v1/rules` —— 按**内容** `(rule, scope)`
|
|
457
|
+
* `DELETE /v1/rules` —— 按**内容** `(behavior, rule, scope)` 撤销一条持久规则(server ≥7.67.0 起是三元组;
|
|
458
|
+
* `behavior` 必填、无默认,见 {@link RuleRevokeRequest.behavior})。**路径上没有 `:id` 段**:一条规则
|
|
382
459
|
* 的身份就是那个内容对,server 不铸行 id,引擎的 `removePersistedRule` 原语按 observed-remove 形在 add
|
|
383
460
|
* 的 dot 上工作。
|
|
384
461
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/resources/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,4DAA4D;AAC5D,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAEzF,6EAA6E;AAC7E,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,
|
|
1
|
+
{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/resources/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,4DAA4D;AAC5D,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAEzF,6EAA6E;AAC7E,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;AAEpD,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC5B;iEAC6D;IAC7D,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,qBAAqB,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,qBAAqB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,kEAAkE;IAClE,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B;;;;;;;OAOG;IACH,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAClE,cAAc;IACd,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,mCAAmC;IACnC,SAAS,EAAE;QAAE,YAAY,EAAE,iBAAiB,CAAC;QAAC,cAAc,EAAE,iBAAiB,CAAA;KAAE,CAAC;CACnF;AAED;oCACoC;AACpC,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,eAAe,CAAC;IACzB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB;IACrC,uEAAuE;IACvE,cAAc,EAAE,MAAM,CAAC;IACvB;uDACmD;IACnD,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,KAAK,EAAE,SAAS,CAAC;IACjB,2DAA2D;IAC3D,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,qDAAqD;IACrD,eAAe,EAAE,OAAO,CAAC;IACzB,iEAAiE;IACjE,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc;IAC7B,sFAAsF;IACtF,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAwB;AACxB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,cAAc,CAAC;CACxB;AAID;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B;0CACsC;IACtC,QAAQ,EAAE,YAAY,CAAC;IACvB,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC5E;0CACsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB;;;;;OAKG;IACH,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACvD;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;CACpD;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB;qCACiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;0CAEsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;iBACa;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,QAAQ,EAAE,YAAY,CAAC;IACvB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;;;;;;;;OAcG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAEzC;;;;;;;;yDAQqD;IAC/C,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAS/G;;;;;;;yDAOqD;IAC/C,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IASpG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAc7F;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAcnG"}
|
package/dist/resources/rules.js
CHANGED
|
@@ -48,6 +48,11 @@ export class RulesResource {
|
|
|
48
48
|
* 游标来翻页 ⇒ 400 `request.query_invalid`(体里带当前 `rev`),**丢掉游标从头列**即可。静默重置的代价
|
|
49
49
|
* 是客户端把第二页当成「接着上一页」,治理面上于是出现一份既漏行又重行的清单,而没有任何人知道。
|
|
50
50
|
*
|
|
51
|
+
* 🔴 **游标带格式代,server ≥7.67.0 抬到 v2 —— 型不变,老游标一律 400 重列**(排序键随规则身份从
|
|
52
|
+
* `(scope, rule)` 二元组变成 `(scope, rule, behavior)` 三元组而换形)。滚动升级/回退期间两代副本互接
|
|
53
|
+
* 对方的游标是**响亮拒**,不是各按各的键形静默跳行:一份治理清单在全 200 之下失真,比一次重列贵得多。
|
|
54
|
+
* 处置不变 —— 游标恒当**不透明串**原样回传,拿到 400 就丢掉重列。
|
|
55
|
+
*
|
|
51
56
|
* 🔴 **翻页要翻完**:`nextCursor` 缺席才是终点。半途停下拿到的是**一份不全的清单**,而这条面的消费者
|
|
52
57
|
* (治理视图)恰恰最不能拿不全的清单当全量。
|
|
53
58
|
*
|
|
@@ -83,7 +88,8 @@ export class RulesResource {
|
|
|
83
88
|
});
|
|
84
89
|
}
|
|
85
90
|
/**
|
|
86
|
-
* `DELETE /v1/rules` —— 按**内容** `(rule, scope)`
|
|
91
|
+
* `DELETE /v1/rules` —— 按**内容** `(behavior, rule, scope)` 撤销一条持久规则(server ≥7.67.0 起是三元组;
|
|
92
|
+
* `behavior` 必填、无默认,见 {@link RuleRevokeRequest.behavior})。**路径上没有 `:id` 段**:一条规则
|
|
87
93
|
* 的身份就是那个内容对,server 不铸行 id,引擎的 `removePersistedRule` 原语按 observed-remove 形在 add
|
|
88
94
|
* 的 dot 上工作。
|
|
89
95
|
*
|
|
@@ -109,6 +115,8 @@ export class RulesResource {
|
|
|
109
115
|
method: "DELETE",
|
|
110
116
|
path: "/v1/rules",
|
|
111
117
|
body: {
|
|
118
|
+
// 🔴 `behavior` 恒发(server ≥7.67.0 必填,且刻意不给默认——见 RuleRevokeRequest.behavior)。
|
|
119
|
+
behavior: input.behavior,
|
|
112
120
|
rule: input.rule,
|
|
113
121
|
scope: input.scope,
|
|
114
122
|
...(input.principal !== undefined ? { principal: input.principal } : {}),
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../src/resources/rules.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../src/resources/rules.ts"],"names":[],"mappings":"AAmZA,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAE7C;;;;;;;;yDAQqD;IACrD,KAAK,CAAC,eAAe,CAAC,MAAuB,EAAE,IAA+B;QAC5E,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAwB;YAC3C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,6BAA6B;YACnC,IAAI,EAAE,EAAE,MAAM,EAAE;YAChB,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;yDAOqD;IACrD,KAAK,CAAC,cAAc,CAAC,MAAc,EAAE,IAA+B;QAClE,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAuB;YAC1C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,4BAA4B;YAClC,IAAI,EAAE,EAAE,MAAM,EAAE;YAChB,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,KAAK,CAAC,IAAI,CAAC,MAAuB,EAAE,IAA+B;QACjE,MAAM,CAAC,GAAG,IAAI,eAAe,EAAE,CAAC;QAChC,IAAI,MAAM,EAAE,SAAS,KAAK,SAAS;YAAE,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAC1E,IAAI,MAAM,EAAE,KAAK,KAAK,SAAS;YAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9D,IAAI,MAAM,EAAE,KAAK,KAAK,SAAS;YAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,IAAI,MAAM,EAAE,MAAM,KAAK,SAAS;YAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACjE,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAiB;YACpC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,EAAE,EAAE;YACjD,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,MAAM,CAAC,KAAwB,EAAE,IAA+B;QACpE,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAmB;YACtC,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE;gBACJ,6EAA6E;gBAC7E,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACzE;YACD,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;CACF"}
|
|
@@ -70,7 +70,7 @@ export type ToolApprovalDecision = "allow" | "allow_session" | "deny";
|
|
|
70
70
|
* (client-core 自持同名闭集 copy)做机器对账用——照 registry-core 值拷贝+同源锚先例。下游测试断言
|
|
71
71
|
* 自己的 copy 键集 ⊇/== 本清单,SDK 每次 additive 增键(如 1.307 的 `toolCallId`)对方当天红,
|
|
72
72
|
* 不再靠人肉追平。**新增帧字段必须同步进本清单**(有测试钉)。 */
|
|
73
|
-
export declare const TOOL_APPROVAL_FRAME_KEYS: readonly ["type", "approvalId", "toolCallId", "toolName", "sourceTaskId", "fromSubagent", "sourceAgentName", "message", "args", "argsOmitted", "governanceForced", "requiresRealApproval", "origin", "inputHasBidi", "expiresAtMs", "expiresInMs", "serverNowMs", "ruleSuggestions", "ruleOffers", "ruleOffersAbsence", "denialLimitFallback", "persistedRuleShadowed", "probeCause", "ruleEvidence", "delegation", "parked", "outcome"];
|
|
73
|
+
export declare const TOOL_APPROVAL_FRAME_KEYS: readonly ["type", "approvalId", "toolCallId", "toolName", "sourceTaskId", "fromSubagent", "sourceAgentName", "message", "args", "argsOmitted", "governanceForced", "requiresRealApproval", "origin", "inputHasBidi", "expiresAtMs", "expiresInMs", "serverNowMs", "ruleSuggestions", "ruleOffers", "ruleOffersAbsence", "denialLimitFallback", "persistedRuleShadowed", "probeCause", "ruleEvidence", "delegation", "parked", "outcome", "classifierUnavailable"];
|
|
74
74
|
/** #154 车二(core 5.18.0 design/179):**引擎铸的**一条规则候选 —— 一格「不再询问」按下去会持久化的东西。
|
|
75
75
|
*
|
|
76
76
|
* 🔴 文本由 ENGINE 铸,不由壳拼:`rule` 是 server 从被裁决命令的原字节交给引擎算出来的规范文本,回决时
|
|
@@ -184,12 +184,32 @@ export interface DenialLimitFallback {
|
|
|
184
184
|
/** 这张卡自己的自动拒窗(ms,`0` = 不武装)。渲倒计时用,**不得**据它自铸定时器。 */
|
|
185
185
|
autoDenyAfterMs: number;
|
|
186
186
|
}
|
|
187
|
+
/**
|
|
188
|
+
* 一只 ask 上的「**分类器答不了**」标注(server ≥7.69.0;core 7.10.0 #616)—— 答的是审批人最想知道的
|
|
189
|
+
* 那句话:**为什么这一问会到我手上**。三面同形同值:live `tool_approval` 帧 / {@link ApprovalCard}
|
|
190
|
+
* (`card_json` / `approval_request`)/ `GET /v1/assistant/inbox` 行。
|
|
191
|
+
*
|
|
192
|
+
* 🔴 **`cause` 在 wire 上是开集 `string`,本 SDK 刻意不枚举**:词表的单一属主在引擎(今天三词
|
|
193
|
+
* `error`(网关坏了)/ `timeout`(太慢了)/ `breaker_open`(熔断已开 ⇒ 后面每一问都会来)),抄一份
|
|
194
|
+
* 会把引擎加的新词吞成缺席 —— 与 {@link AskOrigin} / mcp `errorCode` 同规。**switch 必须带 default 臂**。
|
|
195
|
+
* 🔴 **缺席不是断言**:它同时覆盖三形 —— ①分类器**答上了**(这一问正是它判出来要问人的)②这只 ask
|
|
196
|
+
* **没资格**走分类器 ③本部署**没接**分类器。禁读成对分类器健康的任何断言,也禁读成「分类器是好的」。
|
|
197
|
+
* `parse_error` 按引擎契约**不盖**这一位。
|
|
198
|
+
*/
|
|
199
|
+
export interface ClassifierUnavailable {
|
|
200
|
+
/** 引擎给的因由词。**开集** —— 认已知词,其余走 default 臂当「分类器不可用,因由未知」。 */
|
|
201
|
+
cause: string;
|
|
202
|
+
}
|
|
187
203
|
/**
|
|
188
204
|
* 一只 ask 的**出身**(core `ASK_ORIGINS`,亲读 `@sema-agent/core` 的 `dist/core/ask-origin.d.ts` 逐字):
|
|
189
|
-
* `content_question` / `unresolvable` / `org_unavailable` / `org_rule` / `
|
|
190
|
-
* `denial_limit_fallback` / `shell_gate_tighten` / `safety_tighten` / `policy`。**引擎在门上盖章**
|
|
205
|
+
* `content_question` / `unresolvable` / `org_unavailable` / `org_rule` / `rule_store_unavailable` / `hook` /
|
|
206
|
+
* `ask_rule` / `denial_limit_fallback` / `shell_gate_tighten` / `safety_tighten` / `policy`。**引擎在门上盖章**
|
|
191
207
|
* (core 原话:engine-stamped at the gate, never a policy's claim)。
|
|
192
208
|
*
|
|
209
|
+
* 🔴 **core 7.9.0 再加一个词**(共十一词):`rule_store_unavailable` = 门自己那条**持久规则车道的读**这次
|
|
210
|
+
* 读不出来(接了的规则店读失败 ⇒ 这条腿的 deny/ask 行**执行不了**),于是按 fail-closed 转人问。它与
|
|
211
|
+
* `org_unavailable` 是同一形的个人店同胞(治理源读不到 ⇒ 问人,不是静默放行)。
|
|
212
|
+
*
|
|
193
213
|
* 🔴 **core 7.6.0 加了两个词**(core 7.5.x 及以前是八词):`shell_gate_tighten` = 门自己的不可逆 tighten 在
|
|
194
214
|
* **粗粒度** `shellGate` 教条装的那一层上提的问(`shellGate: "classify"` / `"always"` 下的 shell 命令),
|
|
195
215
|
* `safety_tighten` = 门自己在**调用的显式事实**上做的 post-fold tighten(工具的 egress 标 / 不可逆标 /
|
|
@@ -210,7 +230,7 @@ export interface DenialLimitFallback {
|
|
|
210
230
|
* 「**本部署运维治理层**是不是这只 ask 的门」;`origin: "policy"` 覆盖任何部署 ToolPolicy 的 ask,
|
|
211
231
|
* 治理策略产的与普通策略产的在这一个词上同形 ⇒ 顶替不了。
|
|
212
232
|
*/
|
|
213
|
-
export type AskOrigin = "content_question" | "unresolvable" | "org_unavailable" | "org_rule" | "hook" | "ask_rule" | "denial_limit_fallback" | "shell_gate_tighten" | "safety_tighten" | "policy" | (string & {});
|
|
233
|
+
export type AskOrigin = "content_question" | "unresolvable" | "org_unavailable" | "org_rule" | "rule_store_unavailable" | "hook" | "ask_rule" | "denial_limit_fallback" | "shell_gate_tighten" | "safety_tighten" | "policy" | (string & {});
|
|
214
234
|
/**
|
|
215
235
|
* 一张审批卡上的**一个**「不再询问」选项(core design/375 §3.1 的判别联合;server ≥7.46.0 在
|
|
216
236
|
* `tool_approval` 帧 / `card_json` / durable park 行**三腿同形**发出,**BREAKING 换键**,前名
|
|
@@ -662,6 +682,9 @@ export interface ToolApprovalFrame {
|
|
|
662
682
|
* `settle(false,"expired")` fail-closed DENY stands. The frame itself is cosmetic either way — never derive
|
|
663
683
|
* the run's fate from it; read the run row / checkpoint face. */
|
|
664
684
|
outcome?: "allowed" | "denied" | "expired";
|
|
685
|
+
/** ADDITIVE(server ≥7.69.0;core 7.10.0 #616)—— **为什么这一问会到我手上**:分类器被咨询过但答不了。
|
|
686
|
+
* 形与三条硬读法(开集 `cause` / 缺席不是断言 / switch 带 default)逐字见 {@link ClassifierUnavailable}。 */
|
|
687
|
+
classifierUnavailable?: ClassifierUnavailable;
|
|
665
688
|
[k: string]: unknown;
|
|
666
689
|
}
|
|
667
690
|
/** 回决二值(design/172 §3.2 / 车4 §3)。⚠️ **不是** {@link ToolApprovalDecision} 的三值集:
|
|
@@ -772,13 +795,16 @@ export interface ApprovalCard {
|
|
|
772
795
|
/** ADDITIVE(server ≥7.57.0;S-139 补公示,帧卡同窄读函数同值):auto 分类器的**限额回落卡**标记。
|
|
773
796
|
* 形与硬条款逐字见 {@link DenialLimitFallback} / {@link ToolApprovalFrame.denialLimitFallback}。 */
|
|
774
797
|
denialLimitFallback?: DenialLimitFallback;
|
|
798
|
+
/** ADDITIVE(server ≥7.69.0;core 7.10.0 #616 —— 帧与卡走**同一只窄读函数**同值):分类器答不了的因由。
|
|
799
|
+
* 形与硬读法逐字见 {@link ClassifierUnavailable} / {@link ToolApprovalFrame.classifierUnavailable}。 */
|
|
800
|
+
classifierUnavailable?: ClassifierUnavailable;
|
|
775
801
|
}
|
|
776
802
|
/** 同源锚对账面(照 {@link TOOL_APPROVAL_FRAME_KEYS} 先例):`ApprovalRequestFrame` 的**字段名清单**,
|
|
777
803
|
* 给下游值拷贝(client-core / web 各自持同名闭集 copy)做机器对账用。
|
|
778
804
|
* **新增帧字段必须同步进本清单**(有测试钉)。 */
|
|
779
805
|
export declare const APPROVAL_REQUEST_FRAME_KEYS: readonly ["type", "schemaVersion", "askId", "taskId", "kind", "card", "expiresInMs", "expiresAtMs", "serverNowMs", "approvalId"];
|
|
780
806
|
/** {@link ApprovalCard} 的字段名清单(同上,卡是嵌套结构,单独一份)。 */
|
|
781
|
-
export declare const APPROVAL_CARD_KEYS: readonly ["toolName", "message", "args", "argsOmitted", "toolCallId", "risk", "governanceForced", "ruleSuggestions", "ruleOffers", "persistedRuleShadowed", "fromSubagent", "sourceTaskId", "sourceAgentName", "delegation", "inputHasBidi", "probeCause", "ruleEvidence", "ruleOffersAbsence", "denialLimitFallback"];
|
|
807
|
+
export declare const APPROVAL_CARD_KEYS: readonly ["toolName", "message", "args", "argsOmitted", "toolCallId", "risk", "governanceForced", "ruleSuggestions", "ruleOffers", "persistedRuleShadowed", "fromSubagent", "sourceTaskId", "sourceAgentName", "delegation", "inputHasBidi", "probeCause", "ruleEvidence", "ruleOffersAbsence", "denialLimitFallback", "classifierUnavailable"];
|
|
782
808
|
/** 流内审批呈卡帧(SSE,`type` 即事件名;design/172 §3.1 + 车3 §4.1)。**两腿两形**:live 腿上它与
|
|
783
809
|
* `tool_approval`/`question`/`elicitation` 同一条 out-of-band 通道、在 token 流上交织,**不是**
|
|
784
810
|
* `AgentEvent` 臂(按 SSE `event:` 名分派);durable 腿上 server 会 append 它,于是同一帧在
|