@acosmi/sdk-ts 1.4.2 → 1.5.0

package/dist/node/index.d.cts

@@ -1048,6 +1048,314 @@ interface YudaoPageResult<T> {
     total: number;
 }
 
+/** 排序方向。wire 上为小写字符串。 */
+type SortDirection = 'asc' | 'desc';
+/**
+ * 跨域统一分页【请求】参数。
+ *
+ * 既有域（billing / compliance / skills / notifications）各自内联了
+ * `page` / `pageNo` + `pageSize`，互不一致；本类型是为后续新命名空间
+ * （平台控制面 / `compliance.list*`）提供的统一形态。
+ *
+ * 字段全部可选 —— 调用方省略时由服务端取默认页；排序字段白名单由各命名
+ * 空间各自的 API 文档约定，SDK 不在客户端做字段校验。
+ */
+interface PageRequest {
+    /** 1-based 页码。 */
+    pageNo?: number;
+    /** 每页条数。 */
+    pageSize?: number;
+    /** 排序字段名（领域字段，由各命名空间文档约定白名单）。 */
+    sortBy?: string;
+    /** 排序方向；省略时由服务端决定默认值。 */
+    sortDirection?: SortDirection;
+}
+/**
+ * 跨域统一分页【结果】。
+ *
+ * **刻意做成 `YudaoPageResult<T>` 的别名** —— 全 SDK 单一分页结果结构
+ * `{ list, total }`。新命名空间统一用 `PageResult<T>` 这个对外名，
+ * 底层与 tk-dist 代理透传的 yudao 分页结构完全等价、零转换、零双标准。
+ */
+type PageResult<T> = YudaoPageResult<T>;
+
+type ComplianceProviderRequestStatus = 'PENDING' | 'SUCCESS' | 'FAILED' | 'UNKNOWN' | 'RETRYING';
+interface ProviderRequestStatusView {
+    id: number;
+    status: ComplianceProviderRequestStatus | string;
+    /** SUCCESS / FAILED 终态。 */
+    terminal: boolean;
+    /** 当前状态是否允许 SDK 安全重试请求（仅对 RETRYING 为 true）。 */
+    retryable: boolean;
+    businessNo?: string | null;
+    contractNo?: string | null;
+    sealId?: string | null;
+    attemptCount?: number | null;
+    reconciliationStatus?: string | null;
+    nextRetryAt?: string | null;
+    requestedAt?: string | null;
+    respondedAt?: string | null;
+}
+
+/** 统一操作关联键。贯通控制台 / API / MCP / CrabCode / scheduler 各来源。 */
+type OperationId = string;
+/**
+ * 操作来源。开放联合 —— 平台侧 5 种固定值，合规域可追加自定义来源字符串。
+ * `(string & {})` 在保留 IDE 字面量补全的同时不拒绝未知来源（后端保留新增空间）。
+ */
+type OperationSource = 'console' | 'api' | 'scheduler' | 'crabcode' | 'mcp' | (string & NonNullable<unknown>);
+/**
+ * 操作状态机。开放联合，后端保留新增空间。
+ *
+ * 与 `compliance/status.ts` 的 `ComplianceEnvelopeStatus` 等领域状态【正交】：
+ * 领域状态描述某个履约对象的业务态，`OperationStatus` 描述【一次操作】本身
+ * 的执行进度。
+ */
+type OperationStatus = 'pending' | 'running' | 'retrying' | 'awaiting_callback' | 'awaiting_verify' | 'succeeded' | 'failed' | 'canceled' | 'unknown' | (string & NonNullable<unknown>);
+/**
+ * 本地 verify 状态（§6.4）。
+ *
+ * provider success 仅表示 provider request 终态；时间章 / 签署 / 验签 /
+ * 证据包 / 报告发布须经后端本地 verify / evidence chain verify。`VerifyStatus`
+ * 与 provider 状态是【两个独立维度】，operation projection 必须分别展示
+ * （local verify failed → 业务 failed，不 billing settle）。
+ */
+type VerifyStatus = 'pending' | 'verified' | 'failed' | 'skipped' | 'unknown' | (string & NonNullable<unknown>);
+/**
+ * 幂等键。作用域 = tenant + principal/client + action + product；同 key 同
+ * canonical request 返回原结果，同 key 异 request 拒绝（§6.3 / §2 边界 9）。
+ * SDK 写接口经 `IdempotencyKeyHeader` 透传，调用方必须【持久化】key。
+ */
+type IdempotencyKey = string;
+/** 幂等键 HTTP header 名 —— 全 SDK 写接口的单一真相源。 */
+declare const IdempotencyKeyHeader: "Idempotency-Key";
+/**
+ * Provider request 状态。
+ *
+ * 复核约束（§9.4 勘误）：**不另造同名近似类型** —— 直接复用
+ * `compliance/provider/types.ts` 既有 `ComplianceProviderRequestStatus`
+ * （`PENDING` / `SUCCESS` / `FAILED` / `UNKNOWN` / `RETRYING`）。
+ */
+type ProviderRequestStatus = ComplianceProviderRequestStatus;
+
+/**
+ * SDK 内部 symbolic key；用于代码分支判断与文档。**不是 wire contract**。
+ */
+type ComplianceErrorKey = 'COMPLIANCE_UNAUTHORIZED' | 'COMPLIANCE_INSUFFICIENT_SCOPE' | 'COMPLIANCE_STEP_UP_REQUIRED' | 'COMPLIANCE_TOKEN_INVALID' | 'SUBJECT_SNAPSHOT_REQUIRED' | 'SUBJECT_SNAPSHOT_NOT_FOUND' | 'SUBJECT_SNAPSHOT_TENANT_MISMATCH' | 'EVIDENCE_ASSET_NOT_FOUND' | 'EVIDENCE_ASSET_HASH_MISMATCH' | 'EVIDENCE_ASSET_PAYLOAD_REQUIRED' | 'TIMESTAMP_TOKEN_NOT_FOUND' | 'TIMESTAMP_PROVIDER_FAILED' | 'TIMESTAMP_PROVIDER_UNKNOWN' | 'TIMESTAMP_LOCAL_VERIFY_FAILED' | 'TIMESTAMP_PROVIDER_NOT_AVAILABLE' | 'EVIDENCE_PACKAGE_NOT_FOUND' | 'EVIDENCE_PACKAGE_TIMESTAMP_REQUIRED' | 'EVIDENCE_PACKAGE_MANIFEST_HASH_MISMATCH' | 'REPORT_NOT_FOUND' | 'REPORT_ALREADY_PUBLISHED' | 'REPORT_DRAFT_REQUIRED' | 'EVIDENCE_VERIFY_TARGET_REQUIRED' | 'EVIDENCE_VERIFY_TARGET_NOT_FOUND' | 'PROVIDER_REQUEST_UNKNOWN_NO_RETRY' | 'PROVIDER_CALLBACK_SOURCE_INVALID' | 'PROVIDER_NOT_CONFIGURED' | 'PROVIDER_REQUEST_NOT_FOUND' | 'PROVIDER_REQUEST_IDEMPOTENCY_REQUIRED' | 'PROVIDER_REQUEST_STATUS_NOT_TERMINAL' | 'ENVELOPE_NOT_FOUND' | 'ENVELOPE_TENANT_MISMATCH' | 'ENVELOPE_STATE_NOT_ALLOWED' | 'ENVELOPE_GATE_CLOSED' | 'CONTRACT_NOT_FOUND' | 'CONTRACT_HASH_MISMATCH' | 'PROVIDER_AUTHORIZATION_NOT_CONFIRMED' | 'ENVELOPE_EVIDENCE_NOT_READY' | 'SEAL_ASSET_NOT_FOUND' | 'SEAL_APPROVAL_NOT_FOUND' | 'SEAL_APPROVAL_STATE_NOT_APPROVED' | 'SEAL_APPROVAL_EXPIRED' | 'SEAL_APPROVAL_ALREADY_USED' | 'SEAL_APPROVAL_NONCE_USED' | 'SEAL_APPROVAL_SEAL_MISMATCH' | 'SEAL_APPROVAL_LOCATION_MISMATCH' | 'SEAL_APPROVAL_TRANSACTOR_MISMATCH' | 'SEAL_APPROVAL_CONTRACT_HASH_MISMATCH' | 'SEAL_APPROVAL_INVALID_TRANSITION' | 'SEAL_USE_ALREADY_CONSUMED' | 'AUDIT_CHAIN_TAMPER_DETECTED' | 'BILLING_COMMIT_REQUIRES_LOCAL_VERIFY' | 'BILLING_COMMIT_REQUIRES_PROVIDER_SUCCESS' | 'BILLING_CALLBACK_CANNOT_COMMIT' | 'BILLING_PROVIDER_UNKNOWN_NOT_COMMITTABLE' | 'BILLING_S2S_FORBIDDEN' | 'UNKNOWN_COMPLIANCE_ERROR';
+/** 单个错误的 SDK 视图。 */
+interface ComplianceErrorInfo {
+    /** Java numeric error code (wire contract)。 */
+    code: number;
+    /** 服务端原始 message（中文，可变）；仅用于日志/展示。 */
+    message: string;
+    /** SDK 分支判断用 symbolic key。 */
+    key: ComplianceErrorKey;
+    /** 是否安全自动重试 — compliance 写接口几乎全为 false。 */
+    retryable: boolean;
+    /** 是否已经是终态 — 用户必须用新 idempotency-key 重新发起。 */
+    terminal: boolean;
+    /** 高风险动作需要 step-up / introspection。 */
+    stepUpRequired: boolean;
+}
+/**
+ * 把一个 BusinessError 分类为 compliance 视图。
+ * 非 compliance 段位的错误码会回退到 UNKNOWN_COMPLIANCE_ERROR，调用方应该当作业务错误处理。
+ */
+declare function classifyComplianceError(err: BusinessError): ComplianceErrorInfo;
+/**
+ * 判断 BusinessError 是否属于 compliance 段位（1-031-xxx-xxx）。
+ * 不在段位的错误码可能来自其它 yudao 模块，按通用业务错误处理即可。
+ */
+declare function isComplianceBusinessError(err: BusinessError): boolean;
+
+/**
+ * 失败补救原因。开放枚举的【封闭】部分 —— 这 11 个值覆盖 §6.6 要求的全集。
+ *
+ * 其中 `gate_closed` / `step_up_required` / `tenant_mismatch` /
+ * `insufficient_scope` 与既有错误码登记表同名概念一一对应（见下方映射表），
+ * 不是新造的码。
+ */
+type RetryAdviceReason = 'unknown' | 'retrying' | 'failed' | 'gate_closed' | 'step_up_required' | 'tenant_mismatch' | 'insufficient_scope' | 'quota_exceeded' | 'provider_timeout' | 'local_verify_failed' | 'billing_preflight_failed';
+/** `RetryAdviceReason` 全集（11 项）—— 供迭代 / 校验使用。 */
+declare const RETRY_ADVICE_REASONS: readonly RetryAdviceReason[];
+/**
+ * 失败补救建议统一模型（§6.6）。
+ *
+ * 高风险 / 收费动作失败后，后端 operation projection 产出本结构告诉调用方
+ * 「能不能重试、要不要换幂等键、要不要人工介入」。
+ */
+interface RetryAdvice {
+    /** 是否值得【自动】重试。compliance 写接口几乎恒为 false（双扣红线）。 */
+    retryable: boolean;
+    /** 建议的重试等待时长（秒）；与 `HTTPError.retryAfter` 单位一致。 */
+    retryAfter?: number;
+    /**
+     * 重试时是否必须沿用【同一】幂等键。
+     * 同 key 同 canonical request → 服务端返回原结果（对账语义）；
+     * 终态错误须改用【新】幂等键重新发起（§6.3）。
+     */
+    sameIdempotencyKeyRequired: boolean;
+    /** 是否需要人工介入（重新登录 / step-up / 联系支持），不能纯自动恢复。 */
+    manualActionRequired: boolean;
+    /** 归一化失败原因。 */
+    reason: RetryAdviceReason;
+    /** 面向终端用户的提示文案（调用方可用自有 copy 表覆盖）。 */
+    userMessage?: string;
+    /** 面向开发者的诊断信息（如服务端原始 message）。 */
+    developerMessage?: string;
+    /** 支持工单关联码（如 `compliance:1031004004`）。 */
+    supportCode?: string;
+}
+/** SDK compliance 符号 key → `RetryAdviceReason`。未知 key 兜底 `unknown`。 */
+declare function retryReasonForComplianceKey(key: ComplianceErrorKey): RetryAdviceReason;
+/** Go OAuth 标准错误字符串 → `RetryAdviceReason`。未登记的兜底 `unknown`。 */
+declare function retryReasonForOAuthError(oauthError: string): RetryAdviceReason;
+/**
+ * 把 `ComplianceErrorInfo`（compliance/errors.ts `classifyComplianceError` 的产出）
+ * 投影为统一 `RetryAdvice`。
+ *
+ * 语义：
+ *   - `retryable` 直接透传 `info.retryable`（compliance 写接口恒 false）。
+ *   - 终态错误（`info.terminal`）→ 须改用【新】幂等键 →
+ *     `sameIdempotencyKeyRequired=false`、`manualActionRequired=true`。
+ *   - step-up 错误 → 重新做 OAuth introspection 后用【同一】幂等键重试 →
+ *     `sameIdempotencyKeyRequired=true`、`manualActionRequired=true`。
+ *   - 其余（非终态、非 step-up）→ 沿用同一幂等键对账重发。
+ *
+ * 不读、不写 `ComplianceErrorInfo` 以外的状态；入参不被 mutate。
+ */
+declare function complianceErrorToRetryAdvice(info: ComplianceErrorInfo): RetryAdvice;
+
+/**
+ * 租户轻量引用。
+ *
+ * 完整租户详情（状态 / 类型 / 产品开通 / 主体类型 / 地区 / 组织配置）见
+ * 后续 `tenant` 命名空间。
+ */
+interface TenantRef {
+    tenantId: string;
+    /** 展示名；后端可省略。 */
+    name?: string;
+}
+/**
+ * Principal（操作主体）轻量引用。
+ *
+ * 完整 principal 视图（脱敏联系方式 / 角色 / scope / 认证方式 / token jti /
+ * 登录来源）见后续 `iam` 命名空间。前端【不自解 JWT】推断身份（§1.1 复核
+ * 边界）—— 一律由 SDK 暴露稳定 principal。
+ */
+interface PrincipalRef {
+    principalId: string;
+    /** 关联用户 id；与 `principalId` 可能不同（同一用户多 principal）。 */
+    userId?: string;
+    /** 所属租户 id。 */
+    tenantId?: string;
+    /** 展示名；后端可省略。 */
+    displayName?: string;
+}
+/**
+ * API client 轻量引用。
+ *
+ * 完整 API client 治理（CRUD / secret 轮换 / 回调域名 / IP 白名单 / 调用
+ * 日志）见对外鉴权层独立计划范围 —— 本期不实现（用户决策 2026-05-22）。
+ */
+interface ApiClientRef {
+    clientId: string;
+    /** 展示名；后端可省略。 */
+    name?: string;
+}
+
+/**
+ * 高风险 / 收费动作的 gate 状态机（§U-6）。开放联合，后端保留新增空间。
+ *
+ * `gates.ts`（csign workbench）拿不到能力时 fail-closed 返回 `unknown` —
+ * 与本枚举的 `unknown` 一致。
+ */
+type FeatureGateState = 'executable' | 'scope_missing' | 'not_provisioned' | 'quota_exceeded' | 'step_up_required' | 'gate_closed' | 'unknown' | (string & NonNullable<unknown>);
+/** 配额快照。`FeatureGateStatus.quota` 与 `BillingPreflightResult` 复用。 */
+interface GateQuota {
+    /** 配额上限。 */
+    limit?: number;
+    /** 已用量。 */
+    used?: number;
+    /** 剩余量。 */
+    remaining?: number;
+    /** 配额单位（如 `etu` / `count`）；后端可省略。 */
+    unit?: string;
+}
+/**
+ * step-up（高风险动作二次验证）状态（§6.1）。
+ *
+ * 字段形态先行沉淀；step-up 发起 / 校验的【后端运行期能力】随对外鉴权层
+ * 计划本期不实施。
+ */
+interface StepUpStatus {
+    /** 当前动作是否要求 step-up。 */
+    required: boolean;
+    /** 是否已满足（已完成且未过期）。 */
+    satisfied: boolean;
+    /** step-up 方式（如 `webauthn` / `oauth_introspection`）；后端可省略。 */
+    method?: string;
+    /** 满足态过期时间（ISO 8601）；未满足时省略。 */
+    expiresAt?: string;
+    /** 未满足 / 失败原因；满足时省略。 */
+    reason?: string;
+}
+/**
+ * gate / capability 查询结果（§U-6）。
+ *
+ * 高风险动作（signEnvelope / createH5SigningUrl / publishReport /
+ * approveSealApproval / executeSealUse / claimLeadWithConflictOverride）执行前
+ * 查询本结构，区分「可执行 / scope 缺失 / 未开通 / quota 不足 / 需 step-up /
+ * gate closed」。拿不到时必须 fail-closed（`executable=false`，§2 边界 7）。
+ */
+interface FeatureGateStatus {
+    /** 最终是否可执行。fail-closed：拿不到能力时为 false。 */
+    executable: boolean;
+    /** 不可执行的具体状态。 */
+    state: FeatureGateState;
+    /** 缺失 / 所需 OAuth scope。 */
+    requiredScopes?: string[];
+    /** 是否需要 step-up。 */
+    requiredStepUp?: boolean;
+    /** 缺失的 entitlement / feature 标识。 */
+    missingEntitlements?: string[];
+    /** 配额快照。 */
+    quota?: GateQuota;
+    /** 人类可读原因（诊断 / 展示）。 */
+    reason?: string;
+    /** 失败补救建议（叠加层，见 retry-advice.ts）。 */
+    retryAdvice?: RetryAdvice;
+    /** 关联 operation / preflight id。 */
+    operationId?: OperationId;
+}
+/**
+ * 收费 / 高风险动作的 billing preflight 结果（§4.4 / §4.5）。
+ *
+ * 在动作执行【前】返回可执行性、预估扣费、所需 step-up / scopes。金额字段为
+ * `string`（json.Number 端口，避免 JS number 精度损失 —— 金融安全红线）。
+ */
+interface BillingPreflightResult {
+    /** 是否可执行（含 quota / entitlement / gate 综合判定）。 */
+    executable: boolean;
+    /** 预估扣费金额；`string` 表示，避免浮点精度丢失。 */
+    estimatedCharge?: string;
+    /** 计费单位 / 币种（如 `etu` / `CNY`）。 */
+    currency?: string;
+    /** 所需 OAuth scope。 */
+    requiredScopes?: string[];
+    /** 是否需要 step-up。 */
+    requiredStepUp?: boolean;
+    /** 配额快照。 */
+    quota?: GateQuota;
+    /** 失败补救建议。 */
+    retryAdvice?: RetryAdvice;
+    /** preflight 关联 id —— 后续真实扣费动作回填以串联 hold/settle/release。 */
+    preflightId?: string;
+    /** 不可执行原因（诊断 / 展示）。 */
+    reason?: string;
+}
+
 declare const ScopeAI = "ai";
 declare const ScopeSkills = "skills";
 declare const ScopeAccount = "account";
@@ -1782,8 +2090,10 @@ declare const ScopeComplianceSealUseExecute = "compliance:seal_use:execute";
 declare const ScopeComplianceReportsRead = "compliance:reports:read";
 declare const ScopeComplianceReportsWrite = "compliance:reports:write";
 declare const ScopeComplianceReportsPublish = "compliance:reports:publish";
+declare const ScopeComplianceContractTemplateRead = "compliance:contract_template:read";
+declare const ScopeComplianceContractTemplateWrite = "compliance:contract_template:write";
 /** 类型联合：合规域细粒度 scope。Java compliance verifier 只按细粒度匹配, 不做分组展开。 */
-type ComplianceScope = typeof ScopeComplianceEvidenceRead | typeof ScopeComplianceEvidenceWrite | typeof ScopeComplianceTimestampIssue | typeof ScopeComplianceTimestampVerify | typeof ScopeComplianceContractSigningRead | typeof ScopeComplianceContractSigningWrite | typeof ScopeComplianceSealManage | typeof ScopeComplianceSealApprovalRequest | typeof ScopeComplianceSealApprovalApprove | typeof ScopeComplianceSealUseExecute | typeof ScopeComplianceReportsRead | typeof ScopeComplianceReportsWrite | typeof ScopeComplianceReportsPublish;
+type ComplianceScope = typeof ScopeComplianceEvidenceRead | typeof ScopeComplianceEvidenceWrite | typeof ScopeComplianceTimestampIssue | typeof ScopeComplianceTimestampVerify | typeof ScopeComplianceContractSigningRead | typeof ScopeComplianceContractSigningWrite | typeof ScopeComplianceSealManage | typeof ScopeComplianceSealApprovalRequest | typeof ScopeComplianceSealApprovalApprove | typeof ScopeComplianceSealUseExecute | typeof ScopeComplianceReportsRead | typeof ScopeComplianceReportsWrite | typeof ScopeComplianceReportsPublish | typeof ScopeComplianceContractTemplateRead | typeof ScopeComplianceContractTemplateWrite;
 /** 全部合规域 scope。OAuth 申请合规权限时使用; 谨慎一次性申请全部, 推荐按业务最小集合申请。 */
 declare function complianceScopes(): ComplianceScope[];
 
@@ -1928,6 +2238,77 @@ interface EvidencePackage {
     packageHash: string;
     status: string;
 }
+/**
+ * 证据资产分页【列表项】视图。对应后端 G1 `EvidenceAssetPageItem`。
+ *
+ * 与 {@link EvidenceAsset} 一致的 SDK-safe 子集 + `createTime`；时间字段为
+ * ISO-8601 字符串。
+ */
+interface EvidenceAssetPageItem {
+    id: number;
+    evidenceNo: string;
+    publicVerifyCode?: string | null;
+    assetType: ComplianceAssetType | string;
+    name: string;
+    mimeType?: string | null;
+    size?: number | null;
+    hashAlgorithm: ComplianceHashAlgorithm | string;
+    contentHash: string;
+    canonicalizationProfile?: string | null;
+    digestSource: ComplianceDigestSource | string;
+    privacyLevel: CompliancePrivacyLevel | string;
+    status: string;
+    /** 创建时间 ISO-8601。 */
+    createTime: string;
+}
+/**
+ * `listEvidenceAssets` 请求参数。
+ *
+ * 继承 {@link PageRequest} 的 `pageNo` / `pageSize` / `sortBy` / `sortDirection`，
+ * 全部可选；省略时由服务端取默认页。
+ *
+ * `createTimeStart` / `createTimeEnd` 为调用方提供的【原样字符串】，后端按
+ * `yyyy-MM-dd HH:mm:ss` 解析（例如 `'2026-05-01 00:00:00'`）；SDK 不做格式校验、
+ * 不做时区转换，原样透传查询参数。
+ */
+interface ListEvidenceAssetsRequest extends PageRequest {
+    /** 资产类型过滤（`AssetTypeEnum.name()`）。 */
+    assetType?: ComplianceAssetType | string;
+    /** 资产状态过滤。 */
+    status?: string;
+    /** 创建时间下界，`yyyy-MM-dd HH:mm:ss`。 */
+    createTimeStart?: string;
+    /** 创建时间上界，`yyyy-MM-dd HH:mm:ss`。 */
+    createTimeEnd?: string;
+}
+/**
+ * 证据包分页【列表项】视图。对应后端 G1 `EvidencePackagePageItem`。
+ */
+interface EvidencePackagePageItem {
+    id: number;
+    assetId: number;
+    timestampTokenId?: number | null;
+    chainId: string;
+    packageVersion: string;
+    hashAlgorithm: string;
+    manifestHash: string;
+    packageHash: string;
+    status: string;
+    /** 创建时间 ISO-8601。 */
+    createTime: string;
+}
+/**
+ * `listEvidencePackages` 请求参数。`createTimeStart` / `createTimeEnd` 语义见
+ * {@link ListEvidenceAssetsRequest}。
+ */
+interface ListEvidencePackagesRequest extends PageRequest {
+    /** 证据包状态过滤。 */
+    status?: string;
+    /** 创建时间下界，`yyyy-MM-dd HH:mm:ss`。 */
+    createTimeStart?: string;
+    /** 创建时间上界，`yyyy-MM-dd HH:mm:ss`。 */
+    createTimeEnd?: string;
+}
 
 type ComplianceTimestampVerificationStatus = 'PENDING' | 'VERIFIED' | 'FAILED' | 'LOCAL_VERIFY_FAILED' | 'UNKNOWN' | 'RETRYING';
 /** 时间章 token 对外视图（不含 provider/object/tsa 内部字段）。 */
@@ -1960,6 +2341,70 @@ interface TimestampVerifyResult {
     passed: boolean;
     reason: string;
 }
+/**
+ * 时间章分页【列表项】视图。对应后端 G1 `TimestampPageItem`。
+ *
+ * 与 {@link TimestampToken} 一致的 SDK-safe 子集 + `createTime`；时间字段为
+ * ISO-8601 字符串。
+ */
+interface TimestampPageItem {
+    id: number;
+    assetId: number;
+    policyOid?: string | null;
+    serialNumber?: string | null;
+    genTime?: string | null;
+    accuracy?: string | null;
+    verificationStatus: ComplianceTimestampVerificationStatus | string;
+    verifiedAt?: string | null;
+    verificationError?: string | null;
+    /** 创建时间 ISO-8601。 */
+    createTime: string;
+}
+/**
+ * `listTimestamps` 请求参数。
+ *
+ * 继承 {@link PageRequest} 分页 / 排序字段；全部可选。`createTimeStart` /
+ * `createTimeEnd` 为调用方提供的【原样字符串】，后端按 `yyyy-MM-dd HH:mm:ss`
+ * 解析；SDK 不做格式校验或时区转换。
+ */
+interface ListTimestampsRequest extends PageRequest {
+    /** 时间章 provider 过滤（`TsaProviderEnum.name()` 之类）。 */
+    provider?: string;
+    /** 校验状态过滤。 */
+    verificationStatus?: ComplianceTimestampVerificationStatus | string;
+    /** 创建时间下界，`yyyy-MM-dd HH:mm:ss`。 */
+    createTimeStart?: string;
+    /** 创建时间上界，`yyyy-MM-dd HH:mm:ss`。 */
+    createTimeEnd?: string;
+}
+/**
+ * 时间章授权机构（TSA）provider 视图。对应后端 G3 `TsaProviderVO`。
+ *
+ * 描述某个 TSA provider 的对外可见状态——名称、所处环境、当前是否可用。
+ * 只读视图：不含 provider 端点、凭证、证书或其它内部接入材料。
+ */
+interface TsaProvider {
+    /** provider 名称（如 `TsaProviderEnum.name()`）。 */
+    name: string;
+    /** provider 所处环境（如 `production` / `sandbox`）。 */
+    environment: string;
+    /** 该 provider 当前是否可用。 */
+    available: boolean;
+}
+/**
+ * 时间章统计视图。对应后端 G3 `TsaStatsVO`。
+ *
+ * 只读聚合：时间章总数 + 按校验状态分桶的计数。
+ */
+interface TsaStats {
+    /** 时间章总数。 */
+    total: number;
+    /**
+     * 按校验状态分桶的计数。键为校验状态枚举名（如 `VERIFIED` / `PENDING` /
+     * `FAILED`），值为该状态下的时间章数量。
+     */
+    byVerificationStatus: Record<string, number>;
+}
 
 interface ComplianceReport {
     id: number;
@@ -1994,6 +2439,40 @@ interface ReportDownload {
     timestampGenTime?: string | null;
     timestampVerificationStatus?: string | null;
 }
+/**
+ * 证据报告分页【列表项】视图。对应后端 G1 `ReportPageItem`。
+ *
+ * 与 {@link ComplianceReport} 一致的 SDK-safe 子集 + `createTime`；时间字段为
+ * ISO-8601 字符串。
+ */
+interface ReportPageItem {
+    id: number;
+    reportNo: string;
+    reportType: string;
+    status: string;
+    assetId?: number | null;
+    packageId?: number | null;
+    publicUrlToken?: string | null;
+    publishedAt?: string | null;
+    bodyHash?: string | null;
+    /** 创建时间 ISO-8601。 */
+    createTime: string;
+}
+/**
+ * `listReports` 请求参数。
+ *
+ * 继承 {@link PageRequest} 分页 / 排序字段；全部可选。`createTimeStart` /
+ * `createTimeEnd` 为调用方提供的【原样字符串】，后端按 `yyyy-MM-dd HH:mm:ss`
+ * 解析；SDK 不做格式校验或时区转换。
+ */
+interface ListReportsRequest extends PageRequest {
+    /** 报告状态过滤。 */
+    status?: string;
+    /** 创建时间下界，`yyyy-MM-dd HH:mm:ss`。 */
+    createTimeStart?: string;
+    /** 创建时间上界，`yyyy-MM-dd HH:mm:ss`。 */
+    createTimeEnd?: string;
+}
 
 interface SigningEnvelope {
     id: number;
@@ -2035,6 +2514,83 @@ interface SignEnvelopeRequest {
 /** H5 短链请求。 */
 interface CreateH5SigningUrlRequest extends SignEnvelopeRequest {
 }
+/**
+ * 签署 envelope 分页【列表项】视图。对应后端 G1 `SigningEnvelopePageItem`。
+ *
+ * 与 {@link SigningEnvelope} 一致的 SDK-safe 子集 + `createTime`；时间字段为
+ * ISO-8601 字符串。
+ */
+interface SigningEnvelopePageItem {
+    id: number;
+    envelopeNo: string;
+    applicantUserId?: string | null;
+    status: string;
+    primaryContractId?: number | null;
+    contractHash?: string | null;
+    hashAlgorithm?: string | null;
+    billingGroupId?: string | null;
+    chainId?: string | null;
+    requestId?: string | null;
+    pendingReason?: string | null;
+    signedAt?: string | null;
+    evidenceReadyAt?: string | null;
+    committedAt?: string | null;
+    /** 创建时间 ISO-8601。 */
+    createTime: string;
+}
+/**
+ * `listSigningEnvelopes` 请求参数。
+ *
+ * 继承 {@link PageRequest} 分页 / 排序字段；全部可选。`createTimeStart` /
+ * `createTimeEnd` 为调用方提供的【原样字符串】，后端按 `yyyy-MM-dd HH:mm:ss`
+ * 解析；SDK 不做格式校验或时区转换。
+ */
+interface ListSigningEnvelopesRequest extends PageRequest {
+    /** envelope 状态过滤。 */
+    status?: string;
+    /** 创建时间下界，`yyyy-MM-dd HH:mm:ss`。 */
+    createTimeStart?: string;
+    /** 创建时间上界，`yyyy-MM-dd HH:mm:ss`。 */
+    createTimeEnd?: string;
+}
+/**
+ * 签署 envelope 下挂的合同【列表项】视图。对应后端 G4 `EnvelopeContractItem`。
+ *
+ * 一个 envelope 可挂多份合同；本视图描述合同的元数据与哈希指纹，便于离线复核。
+ * SDK-safe 子集——不含合同原文 / storage key / provider raw payload。时间字段
+ * 为 ISO-8601 字符串。
+ */
+interface EnvelopeContractItem {
+    /** 合同行 id（数值主键）。 */
+    id: number;
+    /** 所属 envelope id。 */
+    envelopeId: number;
+    /** 合同编号。 */
+    contractNo: string;
+    /** 合同标题。 */
+    title: string;
+    /** 合同文件 MIME 类型。 */
+    mimeType: string;
+    /** 合同文件字节数。 */
+    size: number;
+    /** 哈希算法（如 `sha256`）。 */
+    hashAlgorithm: string;
+    /** 合同原文内容哈希。 */
+    contentHash: string;
+    /** 签署后内容哈希（未签署时缺省）。 */
+    signedContentHash?: string;
+    /** 合同状态。 */
+    status: string;
+    /** 创建时间 ISO-8601。 */
+    createTime: string;
+}
+/**
+ * `voidEnvelope` 请求体。作废一个签署 envelope，`reason` 为必填的作废原因。
+ */
+interface VoidEnvelopeRequest {
+    /** 作废原因（必填，随 JSON body 提交）。 */
+    reason: string;
+}
 
 interface SealApproval {
     id: number;
@@ -2078,54 +2634,344 @@ interface RejectSealApprovalQuery {
 interface CancelSealApprovalQuery {
     reason?: string;
 }
+/**
+ * 用印审批分页【列表项】视图。对应后端 G1 `SealApprovalPageItem`。
+ *
+ * 与 {@link SealApproval} 一致的 SDK-safe 子集 + `createTime`；时间字段为
+ * ISO-8601 字符串。
+ */
+interface SealApprovalPageItem {
+    id: number;
+    envelopeId?: number | null;
+    contractId?: number | null;
+    contractHash?: string | null;
+    hashAlgorithm?: string | null;
+    sealId?: number | null;
+    applicantUserId?: string | null;
+    approverUserId?: string | null;
+    transactorId?: number | null;
+    signLocationType?: string | null;
+    signLocationPayload?: string | null;
+    reason?: string | null;
+    expiresAt?: string | null;
+    status: string;
+    approvedAt?: string | null;
+    rejectedAt?: string | null;
+    canceledAt?: string | null;
+    /** 创建时间 ISO-8601。 */
+    createTime: string;
+}
+/**
+ * `listSealApprovals` 请求参数。
+ *
+ * 继承 {@link PageRequest} 分页 / 排序字段；全部可选。`createTimeStart` /
+ * `createTimeEnd` 为调用方提供的【原样字符串】，后端按 `yyyy-MM-dd HH:mm:ss`
+ * 解析；SDK 不做格式校验或时区转换。
+ */
+interface ListSealApprovalsRequest extends PageRequest {
+    /** 审批状态过滤。 */
+    status?: string;
+    /** 创建时间下界，`yyyy-MM-dd HH:mm:ss`。 */
+    createTimeStart?: string;
+    /** 创建时间上界，`yyyy-MM-dd HH:mm:ss`。 */
+    createTimeEnd?: string;
+}
+/**
+ * 用印执行记录分页【列表项】视图。对应后端 G6 `SealUsePageItem`。
+ *
+ * 一次用印执行（seal use）描述【该次盖章动作本身】的执行进度——envelope /
+ * contract / seal / 审批联动后真正调用 provider 落章的那一笔记录，与
+ * envelope 领域状态正交。SDK-safe 视图——不含 provider raw payload / 证书 /
+ * storage key。时间字段为 ISO-8601 字符串。
+ */
+interface SealUsePageItem {
+    id: number;
+    envelopeId: number;
+    contractId: number;
+    sealId: number;
+    /** 用印执行状态。 */
+    usageStatus: string;
+    /** 签署位置类型（坐标 / 关键字 / 域字段等）。 */
+    signLocationType?: string | null;
+    /** 调起时间 ISO-8601。 */
+    invokedAt?: string | null;
+    /** 成功落章时间 ISO-8601。 */
+    consumedAt?: string | null;
+    /** 失败时的错误原因（如有）。 */
+    failureReason?: string | null;
+    /** 创建时间 ISO-8601。 */
+    createTime: string;
+}
+/**
+ * `listSealUses` 请求参数。
+ *
+ * 继承 {@link PageRequest} 分页 / 排序字段；全部可选。`createTimeStart` /
+ * `createTimeEnd` 为调用方提供的【原样字符串】，后端按 `yyyy-MM-dd HH:mm:ss`
+ * 解析；SDK 不做格式校验或时区转换。
+ */
+interface ListSealUsesRequest extends PageRequest {
+    /** 印章 id 过滤。 */
+    sealId?: number;
+    /** 签署 envelope id 过滤。 */
+    envelopeId?: number;
+    /** 用印执行状态过滤。 */
+    usageStatus?: string;
+    /** 创建时间下界，`yyyy-MM-dd HH:mm:ss`。 */
+    createTimeStart?: string;
+    /** 创建时间上界，`yyyy-MM-dd HH:mm:ss`。 */
+    createTimeEnd?: string;
+}
 
-type ComplianceProviderRequestStatus = 'PENDING' | 'SUCCESS' | 'FAILED' | 'UNKNOWN' | 'RETRYING';
-interface ProviderRequestStatusView {
+/**
+ * 单个 compliance 高风险 / 收费动作的能力闸门视图。对应后端 G2 `CapabilityVO`。
+ *
+ * 后端为每个动作返回一条：`signEnvelope` / `createH5SigningUrl` /
+ * `publishReport` / `approveSealApproval` / `executeSealUse` / `createSeal`。
+ *
+ * 拿不到能力时调用方必须 fail-closed（视为 `executable=false`）。`state` 复用
+ * 跨域 {@link FeatureGateState} 开放联合——后端保留新增空间。
+ */
+interface ComplianceCapability {
+    /** 动作标识（如 `signEnvelope` / `publishReport`）。 */
+    action: string;
+    /** 该动作当前是否可执行。fail-closed：拿不到能力时按 false 处理。 */
+    executable: boolean;
+    /**
+     * 不可执行的具体状态。后端取值：`executable` / `scope_missing` /
+     * `not_provisioned` / `step_up_required` / `gate_closed` / `unknown`。
+     */
+    state: FeatureGateState;
+    /** 该动作所需的 OAuth scope。 */
+    requiredScopes: string[];
+    /** 该动作是否需要 step-up（高风险动作二次验证）。 */
+    requiredStepUp: boolean;
+    /** 人类可读原因（诊断 / 展示）。 */
+    reason: string;
+}
+/**
+ * compliance 操作投影【列表项】视图。对应后端 G2 `OperationPageItem`。
+ *
+ * 与领域对象状态【正交】：描述【一次操作】本身的执行进度，而非某个履约对象的
+ * 业务态。时间字段为 ISO-8601 字符串。
+ */
+interface OperationPageItem {
+    /** 行 id（数值主键）。 */
     id: number;
-    status: ComplianceProviderRequestStatus | string;
-    /** SUCCESS / FAILED 终态。 */
+    /** 操作幂等键（跨来源统一关联键）。 */
+    operationId: string;
+    /** 操作状态。 */
+    status: string;
+    /** 是否终态。 */
     terminal: boolean;
-    /** 当前状态是否允许 SDK 安全重试请求（仅对 RETRYING 为 true）。 */
+    /** 当前状态是否允许 SDK 安全重试。 */
     retryable: boolean;
+    /** 已尝试次数。 */
+    attemptCount: number;
+    /** 关联业务编号。 */
     businessNo?: string | null;
+    /** 关联合同编号。 */
     contractNo?: string | null;
-    sealId?: string | null;
-    attemptCount?: number | null;
+    /** 关联印章 id。 */
+    sealId?: number | null;
+    /** 对账状态。 */
     reconciliationStatus?: string | null;
+    /** 下次重试时间 ISO-8601。 */
     nextRetryAt?: string | null;
+    /** 请求发起时间 ISO-8601。 */
     requestedAt?: string | null;
+    /** provider 响应时间 ISO-8601。 */
     respondedAt?: string | null;
+    /** 创建时间 ISO-8601。 */
+    createTime: string;
 }
-
 /**
- * SDK 内部 symbolic key；用于代码分支判断与文档。**不是 wire contract**。
+ * compliance 操作投影【详情】视图。对应后端 G2 `OperationDetail`。
+ *
+ * 当前与 {@link OperationPageItem} 字段一致——单独成类型以便后端在详情视图
+ * 追加字段时不破坏列表项契约。
  */
-type ComplianceErrorKey = 'COMPLIANCE_UNAUTHORIZED' | 'COMPLIANCE_INSUFFICIENT_SCOPE' | 'COMPLIANCE_STEP_UP_REQUIRED' | 'COMPLIANCE_TOKEN_INVALID' | 'SUBJECT_SNAPSHOT_REQUIRED' | 'SUBJECT_SNAPSHOT_NOT_FOUND' | 'SUBJECT_SNAPSHOT_TENANT_MISMATCH' | 'EVIDENCE_ASSET_NOT_FOUND' | 'EVIDENCE_ASSET_HASH_MISMATCH' | 'EVIDENCE_ASSET_PAYLOAD_REQUIRED' | 'TIMESTAMP_TOKEN_NOT_FOUND' | 'TIMESTAMP_PROVIDER_FAILED' | 'TIMESTAMP_PROVIDER_UNKNOWN' | 'TIMESTAMP_LOCAL_VERIFY_FAILED' | 'TIMESTAMP_PROVIDER_NOT_AVAILABLE' | 'EVIDENCE_PACKAGE_NOT_FOUND' | 'EVIDENCE_PACKAGE_TIMESTAMP_REQUIRED' | 'EVIDENCE_PACKAGE_MANIFEST_HASH_MISMATCH' | 'REPORT_NOT_FOUND' | 'REPORT_ALREADY_PUBLISHED' | 'REPORT_DRAFT_REQUIRED' | 'EVIDENCE_VERIFY_TARGET_REQUIRED' | 'EVIDENCE_VERIFY_TARGET_NOT_FOUND' | 'PROVIDER_REQUEST_UNKNOWN_NO_RETRY' | 'PROVIDER_CALLBACK_SOURCE_INVALID' | 'PROVIDER_NOT_CONFIGURED' | 'PROVIDER_REQUEST_NOT_FOUND' | 'PROVIDER_REQUEST_IDEMPOTENCY_REQUIRED' | 'PROVIDER_REQUEST_STATUS_NOT_TERMINAL' | 'ENVELOPE_NOT_FOUND' | 'ENVELOPE_TENANT_MISMATCH' | 'ENVELOPE_STATE_NOT_ALLOWED' | 'ENVELOPE_GATE_CLOSED' | 'CONTRACT_NOT_FOUND' | 'CONTRACT_HASH_MISMATCH' | 'PROVIDER_AUTHORIZATION_NOT_CONFIRMED' | 'ENVELOPE_EVIDENCE_NOT_READY' | 'SEAL_ASSET_NOT_FOUND' | 'SEAL_APPROVAL_NOT_FOUND' | 'SEAL_APPROVAL_STATE_NOT_APPROVED' | 'SEAL_APPROVAL_EXPIRED' | 'SEAL_APPROVAL_ALREADY_USED' | 'SEAL_APPROVAL_NONCE_USED' | 'SEAL_APPROVAL_SEAL_MISMATCH' | 'SEAL_APPROVAL_LOCATION_MISMATCH' | 'SEAL_APPROVAL_TRANSACTOR_MISMATCH' | 'SEAL_APPROVAL_CONTRACT_HASH_MISMATCH' | 'SEAL_APPROVAL_INVALID_TRANSITION' | 'SEAL_USE_ALREADY_CONSUMED' | 'AUDIT_CHAIN_TAMPER_DETECTED' | 'BILLING_COMMIT_REQUIRES_LOCAL_VERIFY' | 'BILLING_COMMIT_REQUIRES_PROVIDER_SUCCESS' | 'BILLING_CALLBACK_CANNOT_COMMIT' | 'BILLING_PROVIDER_UNKNOWN_NOT_COMMITTABLE' | 'BILLING_S2S_FORBIDDEN' | 'UNKNOWN_COMPLIANCE_ERROR';
-/** 单个错误的 SDK 视图。 */
-interface ComplianceErrorInfo {
-    /** Java numeric error code (wire contract)。 */
-    code: number;
-    /** 服务端原始 message（中文，可变）；仅用于日志/展示。 */
-    message: string;
-    /** SDK 分支判断用 symbolic key。 */
-    key: ComplianceErrorKey;
-    /** 是否安全自动重试 — compliance 写接口几乎全为 false。 */
-    retryable: boolean;
-    /** 是否已经是终态 — 用户必须用新 idempotency-key 重新发起。 */
+interface OperationDetail {
+    /** 行 id（数值主键）。 */
+    id: number;
+    /** 操作幂等键（跨来源统一关联键）。 */
+    operationId: string;
+    /** 操作状态。 */
+    status: string;
+    /** 是否终态。 */
     terminal: boolean;
-    /** 高风险动作需要 step-up / introspection。 */
-    stepUpRequired: boolean;
+    /** 当前状态是否允许 SDK 安全重试。 */
+    retryable: boolean;
+    /** 已尝试次数。 */
+    attemptCount: number;
+    /** 关联业务编号。 */
+    businessNo?: string | null;
+    /** 关联合同编号。 */
+    contractNo?: string | null;
+    /** 关联印章 id。 */
+    sealId?: number | null;
+    /** 对账状态。 */
+    reconciliationStatus?: string | null;
+    /** 下次重试时间 ISO-8601。 */
+    nextRetryAt?: string | null;
+    /** 请求发起时间 ISO-8601。 */
+    requestedAt?: string | null;
+    /** provider 响应时间 ISO-8601。 */
+    respondedAt?: string | null;
+    /** 创建时间 ISO-8601。 */
+    createTime: string;
 }
 /**
- * 把一个 BusinessError 分类为 compliance 视图。
- * 非 compliance 段位的错误码会回退到 UNKNOWN_COMPLIANCE_ERROR，调用方应该当作业务错误处理。
+ * `listOperations` 请求参数。
+ *
+ * 继承 {@link PageRequest} 分页 / 排序字段；全部可选。`createTimeStart` /
+ * `createTimeEnd` 为调用方提供的【原样字符串】，后端按 `yyyy-MM-dd HH:mm:ss`
+ * 解析；SDK 不做格式校验或时区转换。
  */
-declare function classifyComplianceError(err: BusinessError): ComplianceErrorInfo;
+interface ListOperationsRequest extends PageRequest {
+    /** 操作状态过滤。 */
+    status?: string;
+    /** 创建时间下界，`yyyy-MM-dd HH:mm:ss`。 */
+    createTimeStart?: string;
+    /** 创建时间上界，`yyyy-MM-dd HH:mm:ss`。 */
+    createTimeEnd?: string;
+}
+
+/** 模板上的可填充字段类型：签名 / 印章 / 文本 / 日期 / 勾选。 */
+type ContractTemplateFieldType = 'signature' | 'seal' | 'text' | 'date' | 'check';
 /**
- * 判断 BusinessError 是否属于 compliance 段位（1-031-xxx-xxx）。
- * 不在段位的错误码可能来自其它 yudao 模块，按通用业务错误处理即可。
+ * 模板字段叠加项。一个模板包含一组字段——签名 / 印章 / 文本 / 日期 / 勾选——
+ * 字段在 PDF 上的位置以 `page`（页码）+ `x`/`y`/`width`/`height`（坐标 / 尺寸）
+ * 描述。SDK 不在客户端做几何 / 坐标系校验，原样透传给后端。
  */
-declare function isComplianceBusinessError(err: BusinessError): boolean;
+interface ContractTemplateField {
+    /** 字段稳定 key，调用方业务侧自定。 */
+    key: string;
+    /** 字段类型。 */
+    type: ContractTemplateFieldType;
+    /** 字段在 UI 上展示的标签。 */
+    label: string;
+    /** PDF 页码（1-based 或调用方约定，SDK 原样透传）。 */
+    page: number;
+    /** PDF 坐标系横坐标。 */
+    x: number;
+    /** PDF 坐标系纵坐标。 */
+    y: number;
+    /** 字段宽度。 */
+    width: number;
+    /** 字段高度。 */
+    height: number;
+    /** 字段绑定的角色（签署人角色 key，可选）。 */
+    assignedRole?: string;
+    /** 字段在模板内的排序键。 */
+    order: number;
+    /** 是否为必填字段。 */
+    required: boolean;
+}
+/** 模板状态。DRAFT 可编辑 / 删除 / 上传 PDF / publish；PUBLISHED / ARCHIVED 只读。 */
+type ContractTemplateStatus = 'DRAFT' | 'PUBLISHED' | 'ARCHIVED';
+/**
+ * 合同模板详情。对应后端 G5 `ContractTemplateResp`。
+ *
+ * - `pdfHash` / `pdfPageCount` 在【上传 PDF】之后才有值。
+ * - `currentVersion` 记录【已发布】版本号；DRAFT 阶段为 0。
+ * - `fields` 是【当前编辑中】的字段叠加快照——publish 时会同步固化进版本表。
+ * - 时间字段 `createTime` 为 ISO-8601 字符串。
+ */
+interface ContractTemplateResp {
+    id: number;
+    /** 模板编号（业务编号，区别于数值主键 `id`）。 */
+    templateNo: string;
+    name: string;
+    description?: string | null;
+    status: ContractTemplateStatus;
+    /** 已上传 PDF 的哈希；未上传时缺省。 */
+    pdfHash?: string | null;
+    /** 已上传 PDF 的页数；未上传时缺省。 */
+    pdfPageCount?: number | null;
+    fields: ContractTemplateField[];
+    /** 已发布版本号；DRAFT 阶段为 0。 */
+    currentVersion: number;
+    /** 创建时间 ISO-8601。 */
+    createTime: string;
+}
+/**
+ * 合同模板分页【列表项】视图。对应后端 G5 `ContractTemplatePageItem`。
+ *
+ * 与 {@link ContractTemplateResp} 一致的 SDK-safe 子集，**不含 `fields`**——
+ * 字段叠加只在详情 / 版本快照里返回，分页列表不下发，避免大对象 N+1。
+ */
+interface ContractTemplatePageItem {
+    id: number;
+    templateNo: string;
+    name: string;
+    description?: string | null;
+    status: ContractTemplateStatus;
+    pdfHash?: string | null;
+    pdfPageCount?: number | null;
+    currentVersion: number;
+    /** 创建时间 ISO-8601。 */
+    createTime: string;
+}
+/**
+ * 合同模板版本快照。对应后端 G5 `ContractTemplateVersion`。
+ *
+ * 每次 publish 会落一个版本快照，记录当时的 `name` / `pdfHash` / `fields` /
+ * `statusAtSnapshot`（publish 时模板的状态字面量）。版本是【不可变】的离线复核
+ * 依据。
+ */
+interface ContractTemplateVersion {
+    id: number;
+    templateId: number;
+    version: number;
+    name: string;
+    pdfHash?: string | null;
+    fields: ContractTemplateField[];
+    /** publish 时模板状态的字面量快照。 */
+    statusAtSnapshot: string;
+    /** 创建时间 ISO-8601。 */
+    createTime: string;
+}
+/**
+ * 创建合同模板请求。`fields` 可选——通常先在 DRAFT 状态创建模板、再上传 PDF、
+ * 然后再单独 `updateContractTemplate` 设置 / 调整字段叠加。
+ */
+interface CreateContractTemplateRequest {
+    name: string;
+    description?: string;
+    fields?: ContractTemplateField[];
+}
+/**
+ * 更新合同模板请求。仅 DRAFT 状态下允许调用——服务端在 PUBLISHED / ARCHIVED
+ * 状态下会拒绝更新。所有字段可选，缺省的字段视为【不修改】。
+ */
+interface UpdateContractTemplateRequest {
+    name?: string;
+    description?: string;
+    fields?: ContractTemplateField[];
+}
+/**
+ * 上传模板 PDF 请求。`pdfBase64` 为 base64 编码的 PDF 原文；SDK 不在客户端做
+ * PDF 解析 / 几何校验。
+ */
+interface UploadContractTemplatePdfRequest {
+    /** base64 编码的 PDF 原文。 */
+    pdfBase64: string;
+}
+/**
+ * `listContractTemplates` 请求参数。
+ *
+ * 继承 {@link PageRequest} 分页 / 排序字段；全部可选。`createTimeStart` /
+ * `createTimeEnd` 为调用方提供的【原样字符串】，后端按 `yyyy-MM-dd HH:mm:ss`
+ * 解析；SDK 不做格式校验或时区转换。
+ */
+interface ListContractTemplatesRequest extends PageRequest {
+    /** 模板状态过滤。 */
+    status?: ContractTemplateStatus | string;
+    /** 创建时间下界，`yyyy-MM-dd HH:mm:ss`。 */
+    createTimeStart?: string;
+    /** 创建时间上界，`yyyy-MM-dd HH:mm:ss`。 */
+    createTimeEnd?: string;
+}
 
 declare module '@acosmi/sdk-ts' {
     interface Client {
@@ -2151,6 +2997,14 @@ declare class ComplianceClient {
     createEvidenceAsset(req: CreateEvidenceAssetRequest, opts?: ComplianceWriteOptions): Promise<EvidenceAsset>;
     /** 读 — 证据资产详情。 */
     getEvidenceAsset(id: number, signal?: AbortSignal): Promise<EvidenceAsset>;
+    /**
+     * 读 — 证据资产分页列表（compliance gateway S1）。
+     *
+     * 走 GET 读路径（允许 401 单次刷新重放）。返回 yudao `PageResult<T>`
+     * （`{ total, list }`）。所有过滤项可选；`createTimeStart` / `createTimeEnd`
+     * 由调用方按 `yyyy-MM-dd HH:mm:ss` 提供，SDK 原样透传。
+     */
+    listEvidenceAssets(req?: ListEvidenceAssetsRequest, signal?: AbortSignal): Promise<PageResult<EvidenceAssetPageItem>>;
     /**
      * 公开 verify。隐私边界：返回字段不含 PII / 合同原文 / storage / provider raw。
      *
@@ -2169,6 +3023,13 @@ declare class ComplianceClient {
     issueTimestampForAsset(assetId: number, opts?: ComplianceWriteOptions): Promise<TimestampToken>;
     /** 读 — 时间章 token 详情。 */
     getTimestamp(id: number, signal?: AbortSignal): Promise<TimestampToken>;
+    /**
+     * 读 — 时间章分页列表（compliance gateway S1）。
+     *
+     * 走 GET 读路径。返回 yudao `PageResult<T>`。所有过滤项可选；`createTimeStart` /
+     * `createTimeEnd` 由调用方按 `yyyy-MM-dd HH:mm:ss` 提供，SDK 原样透传。
+     */
+    listTimestamps(req?: ListTimestampsRequest, signal?: AbortSignal): Promise<PageResult<TimestampPageItem>>;
     /** verify — 本地离线校验已申请的时间章。 */
     verifyTimestamp(req: VerifyTimestampRequest, opts?: ComplianceWriteOptions): Promise<TimestampVerifyResult>;
     /**
@@ -2179,12 +3040,41 @@ declare class ComplianceClient {
      * - timeout → 抛 {@link CompliancePollError} kind='timeout'。
      */
     waitForTimestampVerified(id: number, opts?: CompliancePollOptions): Promise<TimestampToken>;
+    /**
+     * 读 — 时间章授权机构（TSA）provider 列表（compliance gateway S3）。
+     *
+     * 走 GET 读路径（允许 401 单次刷新重放）。后端 G3 为每个 TSA provider 返回
+     * 一条 {@link TsaProvider}：名称、所处环境、当前是否可用。只读视图，不含
+     * provider 端点 / 凭证 / 证书等内部接入材料。
+     */
+    listTsaProviders(signal?: AbortSignal): Promise<TsaProvider[]>;
+    /**
+     * 读 — 时间章统计视图（compliance gateway S3）。
+     *
+     * 走 GET 读路径（允许 401 单次刷新重放）。返回 {@link TsaStats}：时间章总数
+     * + 按校验状态分桶的计数。只读聚合视图。
+     */
+    getTsaStats(signal?: AbortSignal): Promise<TsaStats>;
     /** 构建证据包（写）。 */
     buildEvidencePackage(assetId: number, timestampTokenId?: number, opts?: ComplianceWriteOptions): Promise<EvidencePackage>;
+    /**
+     * 读 — 证据包分页列表（compliance gateway S1）。
+     *
+     * 走 GET 读路径。返回 yudao `PageResult<T>`。所有过滤项可选；`createTimeStart` /
+     * `createTimeEnd` 由调用方按 `yyyy-MM-dd HH:mm:ss` 提供，SDK 原样透传。
+     */
+    listEvidencePackages(req?: ListEvidencePackagesRequest, signal?: AbortSignal): Promise<PageResult<EvidencePackagePageItem>>;
     /** 创建证据报告（写）。 */
     createReport(req: CreateReportRequest, opts?: ComplianceWriteOptions): Promise<ComplianceReport>;
     /** 读 — 报告详情。 */
     getReport(id: number, signal?: AbortSignal): Promise<ComplianceReport>;
+    /**
+     * 读 — 证据报告分页列表（compliance gateway S1）。
+     *
+     * 走 GET 读路径。返回 yudao `PageResult<T>`。所有过滤项可选；`createTimeStart` /
+     * `createTimeEnd` 由调用方按 `yyyy-MM-dd HH:mm:ss` 提供，SDK 原样透传。
+     */
+    listReports(req?: ListReportsRequest, signal?: AbortSignal): Promise<PageResult<ReportPageItem>>;
     /**
      * 发布报告（写，step-up 必须）。
      *
@@ -2204,6 +3094,13 @@ declare class ComplianceClient {
     createSigningEnvelope(req: CreateSigningEnvelopeRequest, opts?: ComplianceWriteOptions): Promise<number>;
     /** 读 — envelope 详情。租户由服务端从 compliance token principal 推导。 */
     getSigningEnvelope(envelopeId: number, signal?: AbortSignal): Promise<SigningEnvelope>;
+    /**
+     * 读 — 签署 envelope 分页列表（compliance gateway S1）。
+     *
+     * 走 GET 读路径。返回 yudao `PageResult<T>`。所有过滤项可选；`createTimeStart` /
+     * `createTimeEnd` 由调用方按 `yyyy-MM-dd HH:mm:ss` 提供，SDK 原样透传。
+     */
+    listSigningEnvelopes(req?: ListSigningEnvelopesRequest, signal?: AbortSignal): Promise<PageResult<SigningEnvelopePageItem>>;
     /**
      * 正式签署（写，step-up 必须）。
      *
@@ -2219,6 +3116,31 @@ declare class ComplianceClient {
     createH5SigningUrl(envelopeId: number, req: CreateH5SigningUrlRequest, opts?: ComplianceWriteOptions): Promise<string>;
     /** 同步 provider 状态（写但只读对账，不创建新 provider 请求）。 */
     syncSigningEnvelopeStatus(envelopeId: number, opts?: ComplianceWriteOptions): Promise<void>;
+    /**
+     * 读 — envelope 下挂的合同列表（compliance gateway S4）。
+     *
+     * 走 GET 读路径（允许 401 单次刷新重放）。后端 G4 为每份挂在该 envelope 上的
+     * 合同返回一条 {@link EnvelopeContractItem}：编号 / 标题 / MIME / 大小 / 哈希
+     * 指纹 / 状态。返回普通数组（非 `PageResult`）。SDK-safe 视图——不含合同原文 /
+     * storage key / provider raw payload。
+     */
+    listEnvelopeContracts(envelopeId: number, signal?: AbortSignal): Promise<EnvelopeContractItem[]>;
+    /**
+     * 读 — envelope 关联的 provider 请求列表（compliance gateway S4）。
+     *
+     * 走 GET 读路径（允许 401 单次刷新重放）。后端 G4 复用操作投影
+     * {@link OperationPageItem}：描述每次 provider 请求本身的执行进度，与 envelope
+     * 领域状态正交。返回普通数组（非 `PageResult`）。
+     */
+    listEnvelopeProviderRequests(envelopeId: number, signal?: AbortSignal): Promise<OperationPageItem[]>;
+    /**
+     * 作废 envelope（写，compliance gateway S4）。
+     *
+     * 走 compliance 写路径——发送前 `ensureToken` 一次、不自动重试、`401` 不刷新
+     * 重放；支持 `Idempotency-Key` header（强烈建议调用方持久化幂等键，重试 / 恢复
+     * 时复用，避免重复作废）。`req.reason` 为必填的作废原因，随 JSON body 提交。
+     */
+    voidEnvelope(envelopeId: number, req: VoidEnvelopeRequest, opts?: ComplianceWriteOptions): Promise<boolean>;
     /**
      * 提交用印审批申请（写）。
      *
@@ -2238,6 +3160,28 @@ declare class ComplianceClient {
     cancelSealApproval(id: number, query: CancelSealApprovalQuery, opts?: ComplianceWriteOptions): Promise<void>;
     listPendingSealApprovals(signal?: AbortSignal): Promise<SealApproval[]>;
     getSealApproval(id: number, signal?: AbortSignal): Promise<SealApproval>;
+    /**
+     * 读 — 用印审批分页列表（compliance gateway S1）。
+     *
+     * 与 {@link listPendingSealApprovals}（仅 pending、不分页）不同，本方法支持分页与
+     * 状态 / 时间过滤。走 GET 读路径。返回 yudao `PageResult<T>`。所有过滤项可选；
+     * `createTimeStart` / `createTimeEnd` 由调用方按 `yyyy-MM-dd HH:mm:ss` 提供，
+     * SDK 原样透传。
+     */
+    listSealApprovals(req?: ListSealApprovalsRequest, signal?: AbortSignal): Promise<PageResult<SealApprovalPageItem>>;
+    /**
+     * 读 — 用印执行记录分页列表（compliance gateway S6）。
+     *
+     * 走 GET 读路径（允许 401 单次刷新重放）。返回 yudao `PageResult<T>`
+     * （`{ total, list }`）。一次用印执行（seal use）描述 envelope / contract /
+     * seal / 审批联动后【真正调用 provider 落章】的那一笔记录，与 envelope
+     * 领域状态正交。所有过滤项可选；`createTimeStart` / `createTimeEnd` 由调用方
+     * 按 `yyyy-MM-dd HH:mm:ss` 提供，SDK 原样透传。
+     *
+     * 与后端复用同一只读 scope `CONTRACT_SIGNING_READ`
+     *（{@link ScopeComplianceContractSigningRead}）——不引入新 scope。
+     */
+    listSealUses(req?: ListSealUsesRequest, signal?: AbortSignal): Promise<PageResult<SealUsePageItem>>;
     getProviderRequest(id: number, signal?: AbortSignal): Promise<ProviderRequestStatusView>;
     /**
      * 轮询 provider request 到 SUCCESS / FAILED 终态。
@@ -2248,6 +3192,110 @@ declare class ComplianceClient {
      * SUCCESS 不代表 billing 已 commit；调用方仍需通过业务侧 envelope / asset 终态判断。
      */
     waitForProviderRequestTerminal(id: number, opts?: CompliancePollOptions): Promise<ProviderRequestStatusView>;
+    /**
+     * 读 — compliance 能力闸门列表（compliance gateway S2）。
+     *
+     * 走 GET 读路径（允许 401 单次刷新重放）。后端 G2 为每个高风险 / 收费动作
+     * （`signEnvelope` / `createH5SigningUrl` / `publishReport` /
+     * `approveSealApproval` / `executeSealUse` / `createSeal`）返回一条
+     * {@link ComplianceCapability}：是否可执行、所处状态、所需 scope / step-up。
+     *
+     * 调用方在高风险动作执行【前】查询本结果做门控；拿不到能力时必须 fail-closed
+     *（按 `executable=false` 处理）。
+     */
+    getCapabilities(signal?: AbortSignal): Promise<ComplianceCapability[]>;
+    /**
+     * 读 — 单个动作的能力闸门视图（便捷方法）。
+     *
+     * 拉取完整 {@link getCapabilities} 列表并返回 `action` 匹配的那一条，无匹配时
+     * 返回 `undefined`。**每次调用产生一次网络请求**——需要门控多个动作时应改用
+     * {@link getCapabilities} 一次性取回再本地查表，避免重复请求。
+     *
+     * 与 {@link getCapabilities} 一致走 GET 读路径（允许 401 单次刷新重放）。
+     */
+    getFeatureGate(action: string, signal?: AbortSignal): Promise<ComplianceCapability | undefined>;
+    /**
+     * 读 — compliance 操作投影分页列表（compliance gateway S2）。
+     *
+     * 走 GET 读路径。返回 yudao `PageResult<T>`（`{ total, list }`）。所有过滤项
+     * 可选；`createTimeStart` / `createTimeEnd` 由调用方按 `yyyy-MM-dd HH:mm:ss`
+     * 提供，SDK 原样透传，不做格式校验或时区转换。
+     *
+     * 操作投影描述【一次操作】本身的执行进度，与履约对象的领域状态正交。
+     */
+    listOperations(req?: ListOperationsRequest, signal?: AbortSignal): Promise<PageResult<OperationPageItem>>;
+    /**
+     * 读 — compliance 操作投影详情（compliance gateway S2）。
+     *
+     * `id` 为数值行主键（非 `operationId` 幂等键）。走 GET 读路径（允许 401 单次
+     * 刷新重放）。
+     */
+    getOperation(id: number, signal?: AbortSignal): Promise<OperationDetail>;
+    /**
+     * 创建合同模板（写）。
+     *
+     * 走 compliance 写路径——发送前 `ensureToken` 一次、不自动重试、`401` 不刷新
+     * 重放；支持 `Idempotency-Key` header（强烈建议调用方持久化幂等键，重试 / 恢复
+     * 时复用，避免重复创建模板）。模板创建后初始状态为 `DRAFT`。
+     */
+    createContractTemplate(req: CreateContractTemplateRequest, opts?: ComplianceWriteOptions): Promise<ContractTemplateResp>;
+    /**
+     * 更新合同模板（写，仅 DRAFT 状态）。
+     *
+     * 走 compliance 写路径——`Idempotency-Key`、不重试、`401` 不刷新重放。所有字段
+     * 可选，缺省字段视为不修改。服务端在 PUBLISHED / ARCHIVED 状态下会拒绝更新。
+     */
+    updateContractTemplate(id: number, req: UpdateContractTemplateRequest, opts?: ComplianceWriteOptions): Promise<ContractTemplateResp>;
+    /**
+     * 删除合同模板（写，仅 DRAFT 状态）。
+     *
+     * 走 compliance 写路径——`Idempotency-Key`、不重试、`401` 不刷新重放。服务端
+     * 在 PUBLISHED / ARCHIVED 状态下会拒绝删除——已发布的模板应改走 `archive`。
+     */
+    deleteContractTemplate(id: number, opts?: ComplianceWriteOptions): Promise<void>;
+    /** 读 — 合同模板详情。 */
+    getContractTemplate(id: number, signal?: AbortSignal): Promise<ContractTemplateResp>;
+    /**
+     * 读 — 合同模板分页列表（compliance gateway S5）。
+     *
+     * 走 GET 读路径（允许 401 单次刷新重放）。返回 yudao `PageResult<T>`
+     * （`{ total, list }`）。所有过滤项可选；`createTimeStart` / `createTimeEnd`
+     * 由调用方按 `yyyy-MM-dd HH:mm:ss` 提供，SDK 原样透传。列表项视图
+     * {@link ContractTemplatePageItem} 不含 `fields`——字段叠加只在详情 / 版本
+     * 快照里返回。
+     */
+    listContractTemplates(req?: ListContractTemplatesRequest, signal?: AbortSignal): Promise<PageResult<ContractTemplatePageItem>>;
+    /**
+     * 上传合同模板 PDF（写）。
+     *
+     * 走 compliance 写路径——`Idempotency-Key`、不重试、`401` 不刷新重放。请求体
+     * 为 `{ pdfBase64 }`；SDK 不在客户端做 PDF 解析 / 几何校验，原样透传给后端。
+     * 返回上传后的最新模板视图（含 `pdfHash` / `pdfPageCount`）。
+     */
+    uploadContractTemplatePdf(id: number, req: UploadContractTemplatePdfRequest, opts?: ComplianceWriteOptions): Promise<ContractTemplateResp>;
+    /**
+     * 发布合同模板（写）。DRAFT → PUBLISHED，落版本快照。
+     *
+     * 走 compliance 写路径——`Idempotency-Key`、不重试、`401` 不刷新重放。
+     * publish 后 `currentVersion` 递增，`fields` 与 `pdfHash` 同步固化进版本表。
+     */
+    publishContractTemplate(id: number, opts?: ComplianceWriteOptions): Promise<ContractTemplateResp>;
+    /**
+     * 归档合同模板（写）。PUBLISHED → ARCHIVED。
+     *
+     * 走 compliance 写路径——`Idempotency-Key`、不重试、`401` 不刷新重放。
+     * 已归档模板只读，不再允许 publish / 编辑 / 删除。
+     */
+    archiveContractTemplate(id: number, opts?: ComplianceWriteOptions): Promise<ContractTemplateResp>;
+    /**
+     * 读 — 合同模板版本快照列表。
+     *
+     * 走 GET 读路径（允许 401 单次刷新重放）。返回 {@link ContractTemplateVersion}
+     * 普通数组（非 `PageResult`）——每次 publish 落一个不可变快照，记录当时的
+     * `name` / `pdfHash` / `fields` / `statusAtSnapshot`，是离线复核 / 版本对账
+     * 的依据。
+     */
+    listContractTemplateVersions(id: number, signal?: AbortSignal): Promise<ContractTemplateVersion[]>;
     classifyError(err: unknown): ComplianceErrorInfo | null;
     /**
      * 读路径：GET / 公开 verify。允许 401 单次刷新后重放（GET 幂等安全）。
@@ -2336,4 +3384,4 @@ declare module '@acosmi/sdk-ts' {
     }
 }
 
-export { type APIResponse, type AgentRun, type AgentRunArtifact, type AgentRunArtifactList, type AgentRunArtifactPolicy, type AgentRunCreateRequest, type AgentRunCreateResponse, type AgentRunDownload, type AgentRunErrorPayload, type AgentRunLocalContextPolicy, type AgentRunLocalToolHandler, type AgentRunLocalToolHandlerContext, type AgentRunLocalToolResult, type AgentRunRunOptions, type AgentRunSettlement, type AgentRunStatus, AgentRunStreamError, type AgentRunStreamEvent, type AgentRunStreamOptions, type AgentRunUsage, type AgentRunWithLocalToolsOptions, AgentRunsClient, AnthropicResponse, type ApproveSealApprovalQuery, type AuthorizeResult, type BalanceDetail, type BlockMeta, type BrowserRefreshMode, type BugReportResult, type BugView, BusinessError, type CancelSealApprovalQuery, type CertificationStatus, ChatRequest, ChatResponse, Client, type ClientRegistration, type ComplianceAssetType, type ComplianceBillingDisplayStatus, ComplianceClient, type ComplianceClientErrorCode, type ComplianceDigestSource, type ComplianceEnvelopeStatus, type ComplianceErrorInfo, type ComplianceErrorKey, type ComplianceHashAlgorithm, CompliancePollError, type CompliancePollOptions, type CompliancePrivacyLevel, type ComplianceProviderRequestStatus, type ComplianceProviderStatus, type ComplianceReport, type ComplianceScope, type ComplianceSealApprovalStatus, type ComplianceTimestampVerificationStatus, type ComplianceWriteOptions, type Config, type ConsumeRecord, type ConsumeRecordPage, type CreateEvidenceAssetRequest, type CreateH5SigningUrlRequest, type CreateReportRequest, type CreateSigningEnvelopeRequest, type CreateWebAuthorizationRequestOptions, DefaultRetryPolicy, type DeviceRegistration, type EntitlementBalance, type EntitlementItem, ErrAuthDenied, ErrBillingCallbackCannotCommit, ErrBillingCommitRequiresLocalVerify, ErrBillingS2sForbidden, ErrBrowserOpen, ErrComplianceStepUpRequired, ErrDiscovery, ErrEnvelopeGateClosed, ErrOAuthCORSBlocked, ErrProviderNotConfigured, ErrProviderUnknownNoRetry, ErrRefreshProxyFailed, ErrRegistration, ErrSSLProxy, ErrSealApprovalContractHashMismatch, ErrSealApprovalExpired, ErrSealApprovalLocationMismatch, ErrSealApprovalNonceUsed, ErrSealApprovalNotApproved, ErrSealApprovalSealMismatch, ErrSealApprovalTransactorMismatch, ErrSealUseAlreadyConsumed, ErrStateMismatch, ErrTimeout, ErrTokenExchange, ErrTokenExpired, EventAuthURL, EventComplete, EventError, type EvidenceAsset, type EvidencePackage, FileTokenStore, type FilterStatus, FilterStatusAdminBypass, FilterStatusDisabledByFlag, FilterStatusFallbackMissingUser, FilterStatusFallbackNoBuckets, FilterStatusFallbackTkdistError, FilterStatusFallbackTkdistSkew, FilterStatusInternalBypass, FilterStatusOK, FilterStatusUnknown, type GenerateSkillRequest, type GenerateSkillResult, HTTPError, InMemoryTokenStore, InputModality, type IssueTimestampRequest, LocalStorageTokenStore, type LoginErrCode, type LoginEvent, type LoginEventType, type LoginOptions, ManagedModel, type ModelBucket, type ModelByQuotaResponse, ModelCapabilities, type ModelCoefficient, ModelNotFoundError, NetworkError, type Notification, type NotificationList, type NotificationPreference, type NotificationUnreadCount, type OAuthMetadataProfile, type OpenAIChatChoice, type OpenAIChatMessage, type OpenAIChatResponse, type OpenAIFunctionCall, type OpenAIStreamChoice, type OpenAIStreamChunk, type OpenAIStreamDelta, type OpenAIStreamToolCall, type OpenAIToolCall, type OpenAIUsage, type OptimizeSkillRequest, type OptimizeSkillResult, type Order, type OrderStatus, OrderTerminalError, type PayPayload, ProviderAdapter, type ProviderRequestStatusView, type PublicEvidenceVerifyResult, QuotaSummary, RateLimitError, type RegisterWebOAuthClientOptions, type RejectSealApprovalQuery, type ReportDownload, type RetryPolicy, type RetryRequestInfo, ScopeAI, ScopeAccount, ScopeComplianceContractSigningRead, ScopeComplianceContractSigningWrite, ScopeComplianceEvidenceRead, ScopeComplianceEvidenceWrite, ScopeComplianceReportsPublish, ScopeComplianceReportsRead, ScopeComplianceReportsWrite, ScopeComplianceSealApprovalApprove, ScopeComplianceSealApprovalRequest, ScopeComplianceSealManage, ScopeComplianceSealUseExecute, ScopeComplianceTimestampIssue, ScopeComplianceTimestampVerify, ScopeEntitlements, ScopeModels, ScopeModelsChat, ScopeProfile, ScopeSkillStore, ScopeSkills, ScopeTokenPackages, ScopeTools, ScopeToolsExecute, ScopeWallet, ScopeWalletReadonly, type SealApproval, type ServerMetadata, type SignEnvelopeRequest, type SigningEnvelope, type SkillBrowseListResponse, type SkillBrowseResponse, type SkillStoreItem, type SkillStoreListItem, type SkillStoreQuery, type SkillSummary, SourcesEvent, StreamError, StreamEvent, StreamSettlement, type SubmitSealApprovalRequest, type TimestampToken, type TimestampVerifyResult, type TokenPackage, type TokenResponse, type TokenSet, type TokenStore, type ToolListResponse, type ToolProvider, type ToolView, type Transaction, type VerifyTimestampRequest, type WSConfig, type WSEvent, type WalletStats, type WebAuthorizationCallbackParams, type WebAuthorizationPending, type WebAuthorizationRequest, type YudaoPageResult, allScopes, apiResponseBusinessError, apiResponseGetMessage, authorize, buildBetas, classifyComplianceError, commerceScopes, completeWebAuthorizationRequest, complianceScopes, computeBackoff, createWebAuthorizationRequest, defaultRetryable, defaultSafeToRetry, discover, discoverWebOAuthMetadata, discoverWithProfile, effectivePolicy, exchangeCode, extractAnthropicBlockMeta, fileLockDefaults, findDesktopVisualUnderstandingModel, findFirstModelByInputModality, generateState, isBillingConfirmable, isComplianceBusinessError, isComplianceTerminalError, isSSLError, modelScopes, modelSupportsImageInput, modelSupportsInputModality, newFileTokenStore, newTokenSet, parseNotificationEvent, refreshToken, register, registerWebOAuthClient, revokeToken, skillScopes, tokenSetIsExpired, uniqueMerge };
+export { type APIResponse, type AgentRun, type AgentRunArtifact, type AgentRunArtifactList, type AgentRunArtifactPolicy, type AgentRunCreateRequest, type AgentRunCreateResponse, type AgentRunDownload, type AgentRunErrorPayload, type AgentRunLocalContextPolicy, type AgentRunLocalToolHandler, type AgentRunLocalToolHandlerContext, type AgentRunLocalToolResult, type AgentRunRunOptions, type AgentRunSettlement, type AgentRunStatus, AgentRunStreamError, type AgentRunStreamEvent, type AgentRunStreamOptions, type AgentRunUsage, type AgentRunWithLocalToolsOptions, AgentRunsClient, AnthropicResponse, type ApiClientRef, type ApproveSealApprovalQuery, type AuthorizeResult, type BalanceDetail, type BillingPreflightResult, type BlockMeta, type BrowserRefreshMode, type BugReportResult, type BugView, BusinessError, type CancelSealApprovalQuery, type CertificationStatus, ChatRequest, ChatResponse, Client, type ClientRegistration, type ComplianceAssetType, type ComplianceBillingDisplayStatus, type ComplianceCapability, ComplianceClient, type ComplianceClientErrorCode, type ComplianceDigestSource, type ComplianceEnvelopeStatus, type ComplianceErrorInfo, type ComplianceErrorKey, type ComplianceHashAlgorithm, CompliancePollError, type CompliancePollOptions, type CompliancePrivacyLevel, type ComplianceProviderRequestStatus, type ComplianceProviderStatus, type ComplianceReport, type ComplianceScope, type ComplianceSealApprovalStatus, type ComplianceTimestampVerificationStatus, type ComplianceWriteOptions, type Config, type ConsumeRecord, type ConsumeRecordPage, type ContractTemplateField, type ContractTemplateFieldType, type ContractTemplatePageItem, type ContractTemplateResp, type ContractTemplateStatus, type ContractTemplateVersion, type CreateContractTemplateRequest, type CreateEvidenceAssetRequest, type CreateH5SigningUrlRequest, type CreateReportRequest, type CreateSigningEnvelopeRequest, type CreateWebAuthorizationRequestOptions, DefaultRetryPolicy, type DeviceRegistration, type EntitlementBalance, type EntitlementItem, type EnvelopeContractItem, ErrAuthDenied, ErrBillingCallbackCannotCommit, ErrBillingCommitRequiresLocalVerify, ErrBillingS2sForbidden, ErrBrowserOpen, ErrComplianceStepUpRequired, ErrDiscovery, ErrEnvelopeGateClosed, ErrOAuthCORSBlocked, ErrProviderNotConfigured, ErrProviderUnknownNoRetry, ErrRefreshProxyFailed, ErrRegistration, ErrSSLProxy, ErrSealApprovalContractHashMismatch, ErrSealApprovalExpired, ErrSealApprovalLocationMismatch, ErrSealApprovalNonceUsed, ErrSealApprovalNotApproved, ErrSealApprovalSealMismatch, ErrSealApprovalTransactorMismatch, ErrSealUseAlreadyConsumed, ErrStateMismatch, ErrTimeout, ErrTokenExchange, ErrTokenExpired, EventAuthURL, EventComplete, EventError, type EvidenceAsset, type EvidenceAssetPageItem, type EvidencePackage, type EvidencePackagePageItem, type FeatureGateState, type FeatureGateStatus, FileTokenStore, type FilterStatus, FilterStatusAdminBypass, FilterStatusDisabledByFlag, FilterStatusFallbackMissingUser, FilterStatusFallbackNoBuckets, FilterStatusFallbackTkdistError, FilterStatusFallbackTkdistSkew, FilterStatusInternalBypass, FilterStatusOK, FilterStatusUnknown, type GateQuota, type GenerateSkillRequest, type GenerateSkillResult, HTTPError, type IdempotencyKey, IdempotencyKeyHeader, InMemoryTokenStore, InputModality, type IssueTimestampRequest, type ListContractTemplatesRequest, type ListEvidenceAssetsRequest, type ListEvidencePackagesRequest, type ListOperationsRequest, type ListReportsRequest, type ListSealApprovalsRequest, type ListSealUsesRequest, type ListSigningEnvelopesRequest, type ListTimestampsRequest, LocalStorageTokenStore, type LoginErrCode, type LoginEvent, type LoginEventType, type LoginOptions, ManagedModel, type ModelBucket, type ModelByQuotaResponse, ModelCapabilities, type ModelCoefficient, ModelNotFoundError, NetworkError, type Notification, type NotificationList, type NotificationPreference, type NotificationUnreadCount, type OAuthMetadataProfile, type OpenAIChatChoice, type OpenAIChatMessage, type OpenAIChatResponse, type OpenAIFunctionCall, type OpenAIStreamChoice, type OpenAIStreamChunk, type OpenAIStreamDelta, type OpenAIStreamToolCall, type OpenAIToolCall, type OpenAIUsage, type OperationDetail, type OperationId, type OperationPageItem, type OperationSource, type OperationStatus, type OptimizeSkillRequest, type OptimizeSkillResult, type Order, type OrderStatus, OrderTerminalError, type PageRequest, type PageResult, type PayPayload, type PrincipalRef, ProviderAdapter, type ProviderRequestStatus, type ProviderRequestStatusView, type PublicEvidenceVerifyResult, QuotaSummary, RETRY_ADVICE_REASONS, RateLimitError, type RegisterWebOAuthClientOptions, type RejectSealApprovalQuery, type ReportDownload, type ReportPageItem, type RetryAdvice, type RetryAdviceReason, type RetryPolicy, type RetryRequestInfo, ScopeAI, ScopeAccount, ScopeComplianceContractSigningRead, ScopeComplianceContractSigningWrite, ScopeComplianceContractTemplateRead, ScopeComplianceContractTemplateWrite, ScopeComplianceEvidenceRead, ScopeComplianceEvidenceWrite, ScopeComplianceReportsPublish, ScopeComplianceReportsRead, ScopeComplianceReportsWrite, ScopeComplianceSealApprovalApprove, ScopeComplianceSealApprovalRequest, ScopeComplianceSealManage, ScopeComplianceSealUseExecute, ScopeComplianceTimestampIssue, ScopeComplianceTimestampVerify, ScopeEntitlements, ScopeModels, ScopeModelsChat, ScopeProfile, ScopeSkillStore, ScopeSkills, ScopeTokenPackages, ScopeTools, ScopeToolsExecute, ScopeWallet, ScopeWalletReadonly, type SealApproval, type SealApprovalPageItem, type SealUsePageItem, type ServerMetadata, type SignEnvelopeRequest, type SigningEnvelope, type SigningEnvelopePageItem, type SkillBrowseListResponse, type SkillBrowseResponse, type SkillStoreItem, type SkillStoreListItem, type SkillStoreQuery, type SkillSummary, type SortDirection, SourcesEvent, type StepUpStatus, StreamError, StreamEvent, StreamSettlement, type SubmitSealApprovalRequest, type TenantRef, type TimestampPageItem, type TimestampToken, type TimestampVerifyResult, type TokenPackage, type TokenResponse, type TokenSet, type TokenStore, type ToolListResponse, type ToolProvider, type ToolView, type Transaction, type TsaProvider, type TsaStats, type UpdateContractTemplateRequest, type UploadContractTemplatePdfRequest, type VerifyStatus, type VerifyTimestampRequest, type VoidEnvelopeRequest, type WSConfig, type WSEvent, type WalletStats, type WebAuthorizationCallbackParams, type WebAuthorizationPending, type WebAuthorizationRequest, type YudaoPageResult, allScopes, apiResponseBusinessError, apiResponseGetMessage, authorize, buildBetas, classifyComplianceError, commerceScopes, completeWebAuthorizationRequest, complianceErrorToRetryAdvice, complianceScopes, computeBackoff, createWebAuthorizationRequest, defaultRetryable, defaultSafeToRetry, discover, discoverWebOAuthMetadata, discoverWithProfile, effectivePolicy, exchangeCode, extractAnthropicBlockMeta, fileLockDefaults, findDesktopVisualUnderstandingModel, findFirstModelByInputModality, generateState, isBillingConfirmable, isComplianceBusinessError, isComplianceTerminalError, isSSLError, modelScopes, modelSupportsImageInput, modelSupportsInputModality, newFileTokenStore, newTokenSet, parseNotificationEvent, refreshToken, register, registerWebOAuthClient, retryReasonForComplianceKey, retryReasonForOAuthError, revokeToken, skillScopes, tokenSetIsExpired, uniqueMerge };