MindOS API 接口 reserve
这页先把高管雷达、隐蔽测评、L2/L3、WebSocket 和错误码收成统一接口层,后面 week5 / week6 对着联调。
当前这份 API 文档最关键的几件事是: 标记幂等性、一次性隐蔽测评链接、实时推送和错误码边界 已经说得比我们现有 reserve 更细了,适合直接当 week5 / week6 的接口收口输入。
回文档包总览回 Prompt / API 预览再看组件规范 reserve看 oneTimeLink 运行时骨架看 suggestions 运行时骨架看实时事件运行时骨架看碎碎念主链运行时看实时鉴权骨架看 token / 恢复骨架看失败退避骨架看签名 / 过期骨架看 durable cursor 骨架看客户端恢复骨架看 refresh token 骨架看 token governance 骨架看 durable token store 骨架看 TTL cleanup 骨架看 cleanup scheduler 骨架看 retry / dead-letter 骨架看 alert / replay 骨架看 audit / confirm 骨架看 audit export 骨架看 export jobs 骨架看 export tickets 骨架看 export receipts 骨架看 export archives 骨架看 export retrievals 骨架看 restore handoff 骨架看 restore closeout 骨架看任务链运行时骨架看 L2 / L3 运行时骨架看主线聚合看板看话术运行时骨架看内参运行时骨架看关键节点 / 置信度运行时骨架看关键节点配置骨架看置信度日志骨架
碎碎念主链
这条链现在已经不只是产品预览,也已经有了统一总览页、运行时页和最小共享摘要层,适合从文档入口直接跳转。
碎碎念 reserve 总览
这张总览先把 Whisper、反馈闭环、ServiceAnchor 和隐私红线对 API / runtime / frontstage 的入口关系一次收清。
Whisper / DailyReflect reserve
候选前置先冻结 60 秒录入、静音截断和候选标签,不提前做完整语音产品。
60 秒限制静音截断自动标签source 口径
反馈闭环 reserve
合同优先先把 feedback_score、was_useful 和 masking 口径对齐,不提前做大报表。
feedback_scorewas_usefulJSON 输出data_masking_rules
ServiceAnchor reserve
服务承接先把 ServiceAnchorCard、生成中状态和 Intervention Routing 讲清,再接真实服务链。
ServiceAnchorCard生成中状态Intervention Routing组织雷达
隐私红线 reserve
红线优先先固定 data_masking_rules 和前台显示边界,后面再扩更细权限中心。
data_masking_rules脱敏示例前台显示边界反馈闭环红线
8 个模块
先按模块核接口边界,不把所有 API 混成一团。
认证与授权
高管雷达模块
隐蔽测评模块
商业内参模块
L2 / L3 诊断引擎
话术生成模块
WebSocket 实时推送
错误码定义
当前 P0 必收字段
这一层更适合直接挂到 week5。
高管标记 API `idempotencyKey`
`source` 区分 `manual / auto_system`
隐蔽测评 `oneTimeLink`
标记历史返回 `source`
WebSocket 推送基础框架
当前已补最小运行时骨架:`POST /api/coach/stealth-links`、`GET /api/coach/stealth-links/[token]`、`POST /api/coach/stealth-links/[token]`
当前已补最小主动建议运行时:`GET /api/coach/suggestions` 默认返回 `minimal runtime`,需要旧预览时显式带 `mode=reserve`
当前已补最小实时事件骨架:`GET /api/coach/events` 返回 stream 订阅,`POST /api/coach/events` 可补一条新事件
当前已补最小实时 viewer_role 边界:`GET /api/coach/events` 已开始支持 `viewer_role`,Founder / HR / Demo 会按最小 channel 边界过滤或返回 `403`
当前已补最小 token / 恢复骨架:`GET /api/coach/events` 已开始支持 `viewer_token`,无效 token 返回 `401`,带 `cursor` 时按 `cursor-replay` 语义恢复
当前已补最小失败退避骨架:`GET /api/coach/events` 已开始支持 `retry_attempt`,`snapshot / heartbeat` 会返回 `retryPlan / reconnectAfterMs`
当前已补最小签名 / 过期骨架:`GET /api/coach/events` 已开始返回 `signatureMode / tokenIssuedAt / tokenExpiresAt`,过期 token 当前返回 `401 + AUTH_002`
当前已补最小 durable cursor 骨架:`GET /api/coach/event-cursors` 查看最小游标记录,`POST /api/coach/event-cursors` 补 `last_cursor / last_event_id / last_event_at`,`GET /api/coach/events` 在未带 `cursor` 时可开始回读 `runtime-store`
当前已补最小客户端恢复骨架:`GET /api/coach/event-recovery` 已开始返回 `phase / nextAction / fallbackAction / clientHints`,把 `token / cursor / retry_attempt` 串成最小恢复动作建议
当前已补最小 refresh token 骨架:`GET /api/coach/token-refresh` 查看 `viewer_token / refresh_token` 状态,`POST /api/coach/token-refresh` 已开始返回轮转后的新 token 对
当前已补最小 token governance 骨架:`GET /api/coach/token-governance` 查看 `session family / revoked token`,`POST /api/coach/token-governance` 已可做最小 `manual revoke`
当前已补最小 durable token store 骨架:`GET /api/coach/token-store` 已开始返回 `storeRuntime / revocationTtlHours / expires_at`
当前已补最小 TTL cleanup 骨架:`GET /api/coach/token-cleanup` 查看 `revokedTokens / storeRuntime`,`POST /api/coach/token-cleanup` 已开始执行最小过期回收
当前已补最小 cleanup scheduler 骨架:`GET /api/coach/token-cleanup-schedule` 查看 `cadence / next_run_at / cleanup_scope`,`POST /api/coach/token-cleanup-schedule` 已开始更新最小 cleanup cadence
当前已补最小 cleanup retry / dead-letter 骨架:`GET /api/coach/token-cleanup-retry` 查看 `pendingRetries / deadLetters`,`POST /api/coach/token-cleanup-retry` 已支持 `simulate-failure / retry`
当前已补最小 cleanup alert / replay 骨架:`GET /api/coach/token-cleanup-alerts` 查看 `alerts / deadLetters`,`POST /api/coach/token-cleanup-alerts` 已支持 `send-alert / manual-replay`
当前已补最小 cleanup audit / confirm 骨架:`GET /api/coach/token-cleanup-audit` 查看 `audits / alerts / deadLetters`,`POST /api/coach/token-cleanup-audit` 已支持 `confirm-alert`,并可带 `operator_label / confirm_reason / confirm_result`
当前已补最小 cleanup audit export 骨架:`GET /api/coach/token-cleanup-audit-export` 已开始返回 `headers / rows / previewCsvLines / outcomeSummary / exportBatchId / schemaVersion / fileNameHint / mimeType / contentDisposition / deliveryMode / previewByteSize / previewChecksum / retentionDays / previewExpiresAt / asyncJobHint`,并开始支持 `outcome / operator_role / confirm_result / page / page_size / columns / sort_by / sort_order / format`
当前已补最小 cleanup export jobs 骨架:`POST /api/coach/token-cleanup-audit-export-jobs` 已开始创建最小 async export job,`GET /api/coach/token-cleanup-audit-export-jobs` 已开始查看 `queued / running / ready / expired`,并可做最小 `mark-running / mark-ready / expire`
当前已补最小 cleanup export tickets 骨架:`POST /api/coach/token-cleanup-audit-export-tickets` 已开始对 `ready` job 签发最小 download ticket,`GET /api/coach/token-cleanup-audit-export-tickets` 已开始查看 `active / used / expired`
当前已补最小 cleanup export receipts 骨架:`POST /api/coach/token-cleanup-audit-export-receipts` 已开始对 `used` ticket 补最小 delivery receipt,`GET /api/coach/token-cleanup-audit-export-receipts` 已开始查看 `delivered / acknowledged`
当前已补最小 cleanup export archives 骨架:`POST /api/coach/token-cleanup-audit-export-archives` 已开始对 `acknowledged` receipt 补最小 archive record,`GET /api/coach/token-cleanup-audit-export-archives` 已开始查看 `archived / released`
当前已补最小 cleanup export retrievals 骨架:`POST /api/coach/token-cleanup-audit-export-retrievals` 已开始对 `released` archive 补最小 retrieval request,`GET /api/coach/token-cleanup-audit-export-retrievals` 已开始查看 `requested / restored`
当前已补最小 cleanup export restore handoffs 骨架:`POST /api/coach/token-cleanup-audit-export-restore-handoffs` 已开始对 `restored` retrieval 补最小 handoff,`GET /api/coach/token-cleanup-audit-export-restore-handoffs` 已开始查看 `handed-off / accepted`
当前已补最小 cleanup export closeouts 骨架:`POST /api/coach/token-cleanup-audit-export-closeouts` 已开始对 `accepted` handoff 补最小 closeout,`GET /api/coach/token-cleanup-audit-export-closeouts` 已开始查看 `closed / verified`
当前已补最小 cleanup export signoffs 骨架:`POST /api/coach/token-cleanup-audit-export-signoffs` 已开始对 `reported` review 补最小 signoff,`GET /api/coach/token-cleanup-audit-export-signoffs` 已开始查看 `signed-off / published`
当前已补最小 cleanup export notices 骨架:`POST /api/coach/token-cleanup-audit-export-notices` 已开始对 `published` signoff 补最小 notice,`GET /api/coach/token-cleanup-audit-export-notices` 已开始查看 `notified / seen`
当前已补最小 cleanup export followups 骨架:`POST /api/coach/token-cleanup-audit-export-followups` 已开始对 `seen` notice 补最小 follow-up,`GET /api/coach/token-cleanup-audit-export-followups` 已开始查看 `follow-up / resolved`
当前已补最小 cleanup export outcomes 骨架:`POST /api/coach/token-cleanup-audit-export-outcomes` 已开始对 `resolved` follow-up 补最小 outcome,`GET /api/coach/token-cleanup-audit-export-outcomes` 已开始查看 `outcome-logged / accepted`
当前已补最小 cleanup export closures 骨架:`POST /api/coach/token-cleanup-audit-export-closures` 已开始对 `accepted` outcome 补最小 closure,`GET /api/coach/token-cleanup-audit-export-closures` 已开始查看 `closure-opened / closed`
当前已补最小 cleanup export closure receipts 骨架:`POST /api/coach/token-cleanup-audit-export-closure-receipts` 已开始对 `closed` closure 补最小 receipt,`GET /api/coach/token-cleanup-audit-export-closure-receipts` 已开始查看 `receipt-issued / receipt-confirmed`
当前已补最小 cleanup export reconciliations 骨架:`POST /api/coach/token-cleanup-audit-export-reconciliations` 已开始对 `receipt-confirmed` receipt 补最小 reconciliation,`GET /api/coach/token-cleanup-audit-export-reconciliations` 已开始查看 `reconciliation-opened / reconciled`
当前已补最小 cleanup export settlements 骨架:`POST /api/coach/token-cleanup-audit-export-settlements` 已开始对 `reconciled` reconciliation 补最小 settlement,`GET /api/coach/token-cleanup-audit-export-settlements` 已开始查看 `settlement-opened / settled`
当前已补最小 cleanup export ledgers 骨架:`POST /api/coach/token-cleanup-audit-export-ledgers` 已开始对 `settled` settlement 补最小 ledger,`GET /api/coach/token-cleanup-audit-export-ledgers` 已开始查看 `ledger-opened / posted`
当前已补最小 cleanup export journals 骨架:`POST /api/coach/token-cleanup-audit-export-journals` 已开始对 `posted` ledger 补最小 journal,`GET /api/coach/token-cleanup-audit-export-journals` 已开始查看 `journal-opened / journaled`
当前已补最小 cleanup export entries 骨架:`POST /api/coach/token-cleanup-audit-export-entries` 已开始对 `journaled` journal 补最小 entry,`GET /api/coach/token-cleanup-audit-export-entries` 已开始查看 `entry-opened / entered`
当前已补最小 cleanup export bookings 骨架:`POST /api/coach/token-cleanup-audit-export-bookings` 已开始对 `entered` entry 补最小 booking,`GET /api/coach/token-cleanup-audit-export-bookings` 已开始查看 `booking-opened / booked`
当前已补最小 cleanup export registers 骨架:`POST /api/coach/token-cleanup-audit-export-registers` 已开始对 `booked` booking 补最小 register,`GET /api/coach/token-cleanup-audit-export-registers` 已开始查看 `register-opened / registered`
当前已补最小 cleanup export filings 骨架:`POST /api/coach/token-cleanup-audit-export-filings` 已开始对 `registered` register 补最小 filing,`GET /api/coach/token-cleanup-audit-export-filings` 已开始查看 `filing-opened / filed`
当前已补最小 cleanup export retentions 骨架:`POST /api/coach/token-cleanup-audit-export-retentions` 已开始对 `filed` filing 补最小 retention,`GET /api/coach/token-cleanup-audit-export-retentions` 已开始查看 `retention-opened / retained`
当前已补最小 cleanup export disposals 骨架:`POST /api/coach/token-cleanup-audit-export-disposals` 已开始对 `retained` retention 补最小 disposal,`GET /api/coach/token-cleanup-audit-export-disposals` 已开始查看 `disposal-opened / disposed`
当前已补最小 cleanup export purges 骨架:`POST /api/coach/token-cleanup-audit-export-purges` 已开始对 `disposed` disposal 补最小 purge,`GET /api/coach/token-cleanup-audit-export-purges` 已开始查看 `purge-opened / purged`
当前已补最小 cleanup export erasures 骨架:`POST /api/coach/token-cleanup-audit-export-erasures` 已开始对 `purged` purge 补最小 erasure,`GET /api/coach/token-cleanup-audit-export-erasures` 已开始查看 `erasure-opened / erased`
当前已补最小 cleanup export certificates 骨架:`POST /api/coach/token-cleanup-audit-export-certificates` 已开始对 `erased` erasure 补最小 certificate,`GET /api/coach/token-cleanup-audit-export-certificates` 已开始查看 `certificate-opened / certified`
当前已补最小 cleanup export attestations 骨架:`POST /api/coach/token-cleanup-audit-export-attestations` 已开始对 `certified` certificate 补最小 attestation,`GET /api/coach/token-cleanup-audit-export-attestations` 已开始查看 `attestation-opened / attested`
当前已补最小 cleanup export witnesses 骨架:`POST /api/coach/token-cleanup-audit-export-witnesses` 已开始对 `attested` attestation 补最小 witness,`GET /api/coach/token-cleanup-audit-export-witnesses` 已开始查看 `witness-opened / witnessed`
当前已补最小 cleanup export notarizations 骨架:`POST /api/coach/token-cleanup-audit-export-notarizations` 已开始对 `witnessed` witness 补最小 notarization,`GET /api/coach/token-cleanup-audit-export-notarizations` 已开始查看 `notarization-opened / notarized`
当前已补最小 cleanup export registrations 骨架:`POST /api/coach/token-cleanup-audit-export-registrations` 已开始对 `notarized` notarization 补最小 registration,`GET /api/coach/token-cleanup-audit-export-registrations` 已开始查看 `registration-opened / registered`
当前已补最小 cleanup export acknowledgements 骨架:`POST /api/coach/token-cleanup-audit-export-acknowledgements` 已开始对 `registered` registration 补最小 acknowledgement,`GET /api/coach/token-cleanup-audit-export-acknowledgements` 已开始查看 `acknowledgement-opened / acknowledged`
当前已补最小 cleanup export confirmations 骨架:`POST /api/coach/token-cleanup-audit-export-confirmations` 已开始对 `acknowledged` acknowledgement 补最小 confirmation,`GET /api/coach/token-cleanup-audit-export-confirmations` 已开始查看 `confirmation-opened / confirmed`
当前已补最小 cleanup export finalizations 骨架:`POST /api/coach/token-cleanup-audit-export-finalizations` 已开始对 `confirmed` confirmation 补最小 finalization,`GET /api/coach/token-cleanup-audit-export-finalizations` 已开始查看 `finalization-opened / finalized`
当前已补最小 cleanup export sealings 骨架:`POST /api/coach/token-cleanup-audit-export-sealings` 已开始对 `finalized` finalization 补最小 sealing,`GET /api/coach/token-cleanup-audit-export-sealings` 已开始查看 `sealing-opened / sealed`
当前已补最小 cleanup export lockings 骨架:`POST /api/coach/token-cleanup-audit-export-lockings` 已开始对 `sealed` sealing 补最小 locking,`GET /api/coach/token-cleanup-audit-export-lockings` 已开始查看 `locking-opened / locked`
当前已补最小 cleanup export freezings 骨架:`POST /api/coach/token-cleanup-audit-export-freezings` 已开始对 `locked` locking 补最小 freezing,`GET /api/coach/token-cleanup-audit-export-freezings` 已开始查看 `freezing-opened / frozen`
当前已补最小 cleanup export holdings 骨架:`POST /api/coach/token-cleanup-audit-export-holdings` 已开始对 `frozen` freezing 补最小 holding,`GET /api/coach/token-cleanup-audit-export-holdings` 已开始查看 `holding-opened / held`
当前已补最小 cleanup export escrows 骨架:`POST /api/coach/token-cleanup-audit-export-escrows` 已开始对 `held` holding 补最小 escrow,`GET /api/coach/token-cleanup-audit-export-escrows` 已开始查看 `escrow-opened / escrowed`
当前已补最小 cleanup export custodies 骨架:`POST /api/coach/token-cleanup-audit-export-custodies` 已开始对 `escrowed` escrow 补最小 custody,`GET /api/coach/token-cleanup-audit-export-custodies` 已开始查看 `custody-opened / custodied`
当前已补最小 cleanup export vaultings 骨架:`POST /api/coach/token-cleanup-audit-export-vaultings` 已开始对 `custodied` custody 补最小 vaulting,`GET /api/coach/token-cleanup-audit-export-vaultings` 已开始查看 `vaulting-opened / vaulted`
当前已补最小 cleanup export shelvings 骨架:`POST /api/coach/token-cleanup-audit-export-shelvings` 已开始对 `vaulted` vaulting 补最小 shelving,`GET /api/coach/token-cleanup-audit-export-shelvings` 已开始查看 `shelving-opened / shelved`
当前已补最小 cleanup export indexings 骨架:`POST /api/coach/token-cleanup-audit-export-indexings` 已开始对 `shelved` shelving 补最小 indexing,`GET /api/coach/token-cleanup-audit-export-indexings` 已开始查看 `indexing-opened / indexed`
当前已补最小 cleanup export catalogings 骨架:`POST /api/coach/token-cleanup-audit-export-catalogings` 已开始对 `indexed` indexing 补最小 cataloging,`GET /api/coach/token-cleanup-audit-export-catalogings` 已开始查看 `cataloging-opened / cataloged`
当前已补最小 cleanup export listings 骨架:`POST /api/coach/token-cleanup-audit-export-listings` 已开始对 `cataloged` cataloging 补最小 listing,`GET /api/coach/token-cleanup-audit-export-listings` 已开始查看 `listing-opened / listed`
当前已补最小 cleanup export publishings 骨架:`POST /api/coach/token-cleanup-audit-export-publishings` 已开始对 `listed` listing 补最小 publishing,`GET /api/coach/token-cleanup-audit-export-publishings` 已开始查看 `publishing-opened / published`
当前已补最小 cleanup export distributions 骨架:`POST /api/coach/token-cleanup-audit-export-distributions` 已开始对 `published` publishing 补最小 distribution,`GET /api/coach/token-cleanup-audit-export-distributions` 已开始查看 `distribution-opened / distributed`
当前已补最小 cleanup export syndications 骨架:`POST /api/coach/token-cleanup-audit-export-syndications` 已开始对 `distributed` distribution 补最小 syndication,`GET /api/coach/token-cleanup-audit-export-syndications` 已开始查看 `syndication-opened / syndicated`
当前已补最小 cleanup export propagations 骨架:`POST /api/coach/token-cleanup-audit-export-propagations` 已开始对 `syndicated` syndication 补最小 propagation,`GET /api/coach/token-cleanup-audit-export-propagations` 已开始查看 `propagation-opened / propagated`
当前已补最小 cleanup export broadcasts 骨架:`POST /api/coach/token-cleanup-audit-export-broadcasts` 已开始对 `propagated` propagation 补最小 broadcast,`GET /api/coach/token-cleanup-audit-export-broadcasts` 已开始查看 `broadcast-opened / broadcast`
当前已补最小任务链编排骨架:`GET /api/coach/orchestration` 查看记录,`POST /api/coach/orchestration` 补 `scenario / parent_task_id / target_ids[] / privacy_redline`
当前已补最小诊断引擎骨架:`GET /api/coach/diagnosis` 查看记录,`POST /api/coach/diagnosis` 补 `input_signal / l2_friction / l3_explanation / recommended_action`
当前已补最小话术输出骨架:`POST /api/script-suggestions` 默认返回 CEO 语境的 minimal runtime,显式传 `mode=reserve` 时再回旧示例结构
当前已补最小商业内参骨架:`GET /api/coach/intelligence` 查看记录,`POST /api/coach/intelligence` 补 `source / title / highlight / action`
当前已补最小关键节点 / 置信度骨架:`GET /api/coach/confidence-center` 查看 `viewer_role / node_type / confidence_score / visible_fields`,`POST /api/coach/confidence-center` 补最小中心记录
当前已补最小置信度日志骨架:`GET /api/coach/confidence-logs` 查看 `source / delta / reason`,`POST /api/coach/confidence-logs` 补最小日志记录
当前已补最小关键节点配置骨架:`GET /api/coach/critical-nodes` 查看 `priority / owner_view / required_signals`,`POST /api/coach/critical-nodes` 补最小配置记录