Schemas

Project

id

Identifier · required

workspaceId

Identifier · required

name

string · required

status

ProjectStatus · enum · required

Enum values:

active

archived

memberIds

Identifier[] · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

objective

string

description

string

defaultLanguage

string

timezone

string

ProjectMembership

当前登录成员在此项目中的身份；没有记录时项目仍可被发现，但尚未加入。

archivedAt

UpsertProjectMembershipRequest

primaryRole

ProjectRole · enum · required

项目中的工作视角；只决定默认工具和建议，不授予任何权限。

Enum values:

product

design

engineering

operations

project-management

other

secondaryRoles

ProjectRole[]

Enum values:

product

design

engineering

operations

project-management

other

ProjectMembershipResponse

required

ProjectMembershipListResponse

ProjectMembership[] · required

ProjectMemoryKind

string · enum

Enum values:

identity

goal

user

brand

glossary

constraint

decision

architecture

ProjectMemorySource

kind

string · enum · required

Enum values:

project

conversation

integration

user

system

observedAt

ISO8601Timestamp · required

connectionId

string

externalMemorySourceId

sourceId

sessionId

externalObjectType

string

externalObjectId

string

externalURL

string

version

string

ProjectMemoryEntry

id

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

kind

ProjectMemoryKind · enum · required

Enum values:

identity

goal

user

brand

glossary

constraint

decision

architecture

key

string · required

title

string · required

content

string · required

confidence

number · required

status

string · enum · required

Enum values:

active

superseded

ProjectMemorySource · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

ProjectMemoryResponse

projectId

Identifier · required

ProjectMemoryEntry[] · required

lastRefreshedAt

ExternalActionRisk

string · enum

Enum values:

low

medium

high

WorkSetStatus

string · enum

Enum values:

forming

ready

updating

superseded

WorkSet

id

Identifier · required

projectId

Identifier · required

sessionId

Identifier · required

compositionId

Identifier · required

status

WorkSetStatus · enum · required

Enum values:

forming

ready

updating

superseded

blockIds

Identifier[] · required

actionIds

Identifier[] · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

primaryBlockId

preparedAt

AuditEvent

id

Identifier · required

workspaceId

Identifier · required

required

eventType

string · required

targetType

string · required

targetId

Identifier · required

object · required

occurredAt

ISO8601Timestamp · required

projectId

BuiltInAgentRole

string · enum

Enum values:

chief-of-staff

product-manager

project-manager

designer

researcher

engineer

copywriter

decision-analyst

AgentRole

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = string
	type = string

Properties for Variant 1:

BuiltInAgentRole · enum

Enum values:

chief-of-staff

product-manager

project-manager

designer

researcher

engineer

copywriter

decision-analyst

AgentCapabilityPool

string · enum

Enum values:

planning

research-design

build-execution

AgentTask

id

Identifier · required

AgentRole · required

capabilityPool

AgentCapabilityPool · enum · required

Enum values:

planning

research-design

build-execution

title

string · required

objective

string · required

status

string · enum · required

Enum values:

queued

active

blocked

complete

cancelled

revision

number · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

sourceSegmentIds

Identifier[] · required

outputBlockIds

Identifier[] · required

dependsOnTaskIds

note

string

AgentState

AgentRole · required

capabilityPool

AgentCapabilityPool · enum · required

Enum values:

planning

research-design

build-execution

status

string · enum · required

Enum values:

observing

active

complete

reason

string · required

taskIds

Identifier[] · required

activatedAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

SessionOrchestration

revision

number · required

chiefOfStaffRole

string · const · required

Const value: chief-of-staff

AgentState[] · required

AgentTask[] · required

updatedAt

ISO8601Timestamp · required

BlockFamily

string · enum

Enum values:

text

product

reasoning

structure

action

reference

visual

file

InferenceState

string · enum

Enum values:

verified

inferred

placeholder

observed

proposed

BlockSource

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: kind, segmentId
	type = object · requires: kind, url
	type = object · requires: kind, agentRole
	type = object · requires: kind, participantId

Properties for Variant 1:

kind

string · const · required

Const value: transcript

segmentId

Identifier · required

excerpt

string

Block

id

Identifier · required

family

BlockFamily · enum · required

Enum values:

text

product

reasoning

structure

action

reference

visual

file

type

string · required

title

string · required

revision

number · required

state

string · enum · required

Enum values:

proposed

accepted

edited

superseded

inference

InferenceState · enum · required

Enum values:

verified

inferred

placeholder

observed

proposed

BlockSource[] · required

object · required

relationshipIds

Identifier[] · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

object · required

body

string

object

ArtifactKind

string · enum

Enum values:

mind-map

requirement

decision

assumption

open-question

next-step

RelationshipKind

string · enum

Enum values:

supports

contradicts

depends-on

parent-of

relates-to

derived-from

sequence-before

Relationship

id

Identifier · required

fromBlockId

Identifier · required

toBlockId

Identifier · required

kind

RelationshipKind · enum · required

Enum values:

supports

contradicts

depends-on

parent-of

relates-to

derived-from

sequence-before

revision

number · required

label

string

sourceSegmentIds

Placement

id

Identifier · required

blockId

Identifier · required

order

number · required

presentation

string · enum

Enum values:

prose

list-item

map-node

reference

action

visual

column

number

emphasis

string · enum

Enum values:

quiet

normal

primary

CompositionSection

id

Identifier · required

title

string · required

layout

string · enum · required

Enum values:

prose

list

map

board

timeline

actions

reference-strip

Placement[] · required

purpose

string

Composition

id

Identifier · required

title

string · required

kind

string · required

revision

number · required

status

string · enum · required

Enum values:

draft

ready

CompositionSection[] · required

relationshipIds

Identifier[] · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

summary

string

ActionTarget

required

capability

string

destination

string

Suggestion

id

Identifier · required

title

string · required

rationale

string · required

rank

number · required

sourceBlockIds

Identifier[] · required

compositionId

Identifier · required

ActionTarget · required

requiresConfirmation

boolean · required

status

string · enum · required

Enum values:

suggested

accepted

dismissed

complete

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

SessionStatus

string · enum

Enum values:

ready

active

paused

finalizing

complete

deleted

error

CaptureMode

string · enum

Enum values:

microphone

microphone-and-system-audio

EventActor

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: kind, participantId
	type = object · requires: kind, component
	type = object · requires: kind, role

Properties for Variant 1:

kind

string · const · required

Const value: participant

participantId

Identifier · required

ArtifactNode

id

Identifier · required

kind

ArtifactKind · enum · required

Enum values:

mind-map

requirement

decision

assumption

open-question

next-step

title

string · required

body

string

owner

string

due

string

workStatus

string · enum

Enum values:

todo

in-progress

done

blocked

parentId

object

confidence

number

sourceSegmentIds

ArtifactSnapshot

id

Identifier · required

kind

ArtifactKind · enum · required

Enum values:

mind-map

requirement

decision

assumption

open-question

next-step

title

string · required

revision

number · required

ArtifactNode[] · required

updatedAt

ISO8601Timestamp · required

status

string · enum · required

Enum values:

proposed

confirmed

TranscriptSegment

id

Identifier · required

text

string · required

createdAt

ISO8601Timestamp · required

speakerId

startedAt

endedAt

chunkId

EventEnvelope_3c_22session_2estarted_22_3e

CapWorksEventPayloads

object · required

CapWorksEventType

string · enum

Enum values:

session.started

session.paused

session.resumed

session.deleted

participant.joined

transcript.delta

transcript.final

artifact.proposed

CapWorksEvent

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more
	type = object · requires: eventId, sessionId, sequence +5 more

Properties for Variant 1:

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: session.started

object · required

EventEnvelope_3c_22session_2estarted_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: session.started

object · required

EventEnvelope_3c_22session_2epaused_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: session.paused

object · required

EventEnvelope_3c_22session_2eresumed_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: session.resumed

object · required

EventEnvelope_3c_22session_2edeleted_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: session.deleted

object · required

EventEnvelope_3c_22participant_2ejoined_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: participant.joined

object · required

EventEnvelope_3c_22transcript_2edelta_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: transcript.delta

object · required

EventEnvelope_3c_22transcript_2efinal_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: transcript.final

object · required

EventEnvelope_3c_22artifact_2eproposed_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: artifact.proposed

object · required

EventEnvelope_3c_22artifact_2eupdated_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: artifact.updated

object · required

EventEnvelope_3c_22artifact_2econfirmed_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: artifact.confirmed

object · required

EventEnvelope_3c_22artifact_2esuperseded_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: artifact.superseded

object · required

EventEnvelope_3c_22agent_2eactivated_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: agent.activated

object · required

EventEnvelope_3c_22task_2estarted_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: task.started

object · required

EventEnvelope_3c_22task_2eupdated_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: task.updated

object · required

EventEnvelope_3c_22block_2eproposed_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: block.proposed

object · required

EventEnvelope_3c_22block_2eupdated_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: block.updated

object · required

EventEnvelope_3c_22composition_2eupdated_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: composition.updated

object · required

EventEnvelope_3c_22action_2esuggested_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: action.suggested

object · required

EventEnvelope_3c_22execution_2estarted_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: execution.started

object · required

EventEnvelope_3c_22execution_2eupdated_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: execution.updated

object · required

EventEnvelope_3c_22session_2efinalizing_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: session.finalizing

object · required

EventEnvelope_3c_22session_2eready_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: session.ready

object · required

EventEnvelope_3c_22session_2eerror_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: session.error

object · required

EventEnvelope_3c_22speaker_2eidentity_2eupdated_22_3e

eventId

Identifier · required

sessionId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 1

type

string · const · required

Const value: speaker.identity.updated

object · required

SessionSnapshot

sessionId

Identifier · required

workspaceId

Identifier · required

title

string · required

status

SessionStatus · enum · required

Enum values:

ready

active

paused

finalizing

complete

deleted

error

captureMode

CaptureMode · enum · required

Enum values:

microphone

microphone-and-system-audio

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

lastSequence

number · required

snapshotRevision

number · required

object[] · required

TranscriptSegment[] · required

ArtifactSnapshot[] · required

projectId

contentLanguage

string

completedAt

archivedAt

object

当前唯一收音设备。其它端只同步结果，不得再显示成本机「正在听」。

object

User-confirmed names. Workspace member aliases may be inherited across sessions.

SessionOrchestration

Block[]

Relationship[]

Composition

WorkSet

Suggestion[]

AccountBootstrapRequest

inviteToken

string

InvitationLoginIntentRequest

email

string · required

InvitationLoginIntentResponse

workspaceName

string · required

invitedEmail

string · required

contentPermission

WorkspaceContentPermission · enum · required

内容协作权限独立于组织管理角色；view 仍可在场、查看与评论。

Enum values:

edit

view

expiresAt

ISO8601Timestamp · required

projectId

projectName

string

WorkspaceContentPermission

string · enum

Enum values:

edit

view

内容协作权限独立于组织管理角色；view 仍可在场、查看与评论。

VoiceProfileModelManifest

runtime

string · const · required

Const value: sherpa-onnx

runtimeVersion

string · const · required

Const value: 1.13.2

modelVersion

string · const · required

Const value: 3dspeaker-campplus-zh-en-advanced-v1

fileName

string · const · required

Const value: 3dspeaker_speech_campplus_sv_zh_en_16k-common_advanced.onnx

sha256

string · const · required

Const value: aa3cfc16963a10586a9393f5035d6d6b57e98d358b347f80c2a30bf4f00ceba2

sizeBytes

number · const · required

Const value: 28281164

embeddingDimension

number · const · required

Const value: 192

sampleRate

number · const · required

Const value: 16000

downloadPath

string · required

CreateVoiceProfileEnrollmentRequest

consentVersion

string · required

CreateVoiceProfileEnrollmentResponse

object · required

VoiceProfileModelManifest · required

SaveVoiceProfileEnrollmentRequest

modelVersion

string · const · required

Const value: 3dspeaker-campplus-zh-en-advanced-v1

embeddings

array[] · required

expectedRevision

number | null · required

VoiceProfileResponse

required

DeleteVoiceProfileResponse

deleted

boolean · required

WorkspaceVoiceIdentityStatus

string · enum

Enum values:

candidate

active

conflicted

disabled

WorkspaceVoiceIdentity

id

Identifier · required

workspaceId

Identifier · required

status

WorkspaceVoiceIdentityStatus · enum · required

Enum values:

candidate

active

conflicted

disabled

hasPreview

boolean · required

modelVersion

string · const · required

Const value: 3dspeaker-campplus-zh-en-advanced-v1

sampleCount

number · required

confidence

number · required

firstSeenSessionId

Identifier · required

lastSeenAt

ISO8601Timestamp · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

displayName

string

expiresAt

object[]

WorkspaceVoiceIdentityListResponse

WorkspaceVoiceIdentity[] · required

WorkspaceVoiceIdentityUtterance

sessionId

Identifier · required

sessionTitle

string · required

speakerId

Identifier · required

segmentId

Identifier · required

text

string · required

createdAt

ISO8601Timestamp · required

WorkspaceVoiceIdentityDetailResponse

WorkspaceVoiceIdentity · required

WorkspaceVoiceIdentityUtterance[] · required

UpdateWorkspaceVoiceIdentityRequest

displayName

string

status

string · enum

Enum values:

active

conflicted

disabled

MergeWorkspaceVoiceIdentityRequest

targetIdentityId

Identifier · required

SplitWorkspaceVoiceIdentityRequest

sessionId

Identifier · required

speakerId

Identifier · required

DeleteWorkspaceVoiceIdentityResponse

deleted

boolean · required

anonymizedSessions

number · required

OptOutSessionSpeakerResponse

optedOut

boolean · required

deletedIdentity

boolean · required

object · required

CreateProjectRequest

name

string · required

objective

string

description

string

defaultLanguage

string

timezone

string

UpdateProjectRequest

name

string

status

ProjectStatus · enum

Enum values:

active

archived

objective

string

description

string

defaultLanguage

string

timezone

string

CreateProjectResponse

Project · required

ProjectListResponse

Project[] · required

ProjectContextResponse

Project · required

SessionSnapshot[] · required

ProjectReferenceDocument

id

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

fileName

string · required

mimeType

string · required

sizeBytes

number · required

extractedCharacterCount

number · required

status

string · enum · required

Enum values:

active

deleted

createdByUserId

Identifier · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

ProjectReferenceDocumentResponse

ProjectReferenceDocument · required

ProjectReferenceDocumentListResponse

ProjectReferenceDocument[] · required

IntegrationProviderCard

service

string · required

displayName

string · required

object[] · required

scenario

string · required

authTypes

string[] · required

capabilityCount

number · required

object[] · required

locallyExecutable

boolean · required

IntegrationAuthOption[] · required

iconURL

string

homepageURL

string

description

string

IntegrationAuthOption

type

string · enum · required

Enum values:

no_auth

api_key

custom_credential

oauth2

configured

boolean · required

IntegrationCredentialField[] · required

IntegrationCredentialField

key

string · required

label

string · required

inputType

string · enum · required

Enum values:

text

password

textarea

json

required

boolean · required

secret

boolean · required

placeholder

string

description

string

defaultValue

string

IntegrationActionCard

id

string · required

service

string · required

name

string · required

description

string · required

authenticated

boolean · required

IntegrationActionDescriptor

requiredScopes

string[] · required

providerPermissions

string[] · required

object · required

followUpActionIds

string[] · required

executable

boolean · required

catalogOnly

boolean · required

id

string · required

service

string · required

name

string · required

description

string · required

authenticated

boolean · required

IntegrationConnectionCard

id

string · required

service

string · required

alias

string · required

authType

string · required

displayName

string · required

accountLabel

string · required

isDefault

boolean · required

scopes

string[] · required

status

string · enum · required

Enum values:

pending

active

suspended

error

revoked

actionIds

string[] · required

autoReadActionIds

string[] · required

lifecycleVersion

number · required

IntegrationProviderListResponse

IntegrationProviderCard[] · required

IntegrationProviderActionListResponse

IntegrationActionCard[] · required

IntegrationActionSearchResponse

IntegrationActionCard[] · required

IntegrationActionDescriptorResponse

IntegrationActionDescriptor · required

IntegrationActionFieldOption

value

string · required

label

string · required

description

string

ResolveIntegrationActionFieldOptionsRequest

projectId

Identifier · required

connectionId

string · required

actionId

string · required

field

string · required

object · required

query

string

ResolveIntegrationActionFieldOptionsResponse

field

string · required

IntegrationActionFieldOption[] · required

sourceActionId

string

IntegrationConnectionListResponse

IntegrationConnectionCard[] · required

StartIntegrationOAuthRequest

projectId

Identifier · required

service

string · required

actionIds

string[]

StartIntegrationOAuthResponse

authorizationURL

string · required

connectionAlias

string · required

expiresAt

ISO8601Timestamp · required

CreateIntegrationCredentialRequest

projectId

Identifier · required

service

string · required

authType

string · enum · required

Enum values:

api_key

custom_credential

no_auth

object · required

actionIds

string[]

UpdateIntegrationAccessRequest

projectId

Identifier · required

connectionIds

string[]

actionIds

string[]

object[]

QueryExternalContextRequest

connectionId

string · required

actionId

string · required

object · required

ExternalContextItem

id

Identifier · required

title

string · required

text

string · required

externalId

string

externalURL

string

version

string

ExternalContextObservation

id

Identifier · required

projectId

Identifier · required

connectionId

string · required

actionId

string · required

lifecycleVersion

number · required

ExternalContextItem[] · required

expiresAt

ISO8601Timestamp · required

createdAt

ISO8601Timestamp · required

ExternalMemorySource

id

Identifier · required

projectId

Identifier · required

createdByUserId

Identifier · required

connectionId

string · required

actionId

string · required

lifecycleVersion

number · required

title

string · required

contentHash

string · required

status

string · enum · required

Enum values:

active

suspended

purging

chunkCount

number · required

savedAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

externalId

string

externalURL

string

version

string

SaveExternalMemoryRequest

observationId

Identifier · required

itemIds

Identifier[] · required

confirmSourceBound

boolean · const · required

Const value:

ExternalContextObservationResponse

ExternalContextObservation · required

ExternalMemorySourceListResponse

ExternalMemorySource[] · required

SaveExternalMemoryResponse

ExternalMemorySource[] · required

PrepareExternalActionRequest

projectId

Identifier · required

actionId

string · required

connectionId

string · required

object · required

workObjectId

sourceRevisionId

recommendationId

PreparedExternalAction

id

Identifier · required

projectId

Identifier · required

actionId

string · required

service

string · required

connectionId

string · required

connectionAlias

string · required

object · required

inputDigest

string · required

schemaDigest

string · required

status

string · enum · required

Enum values:

prepared

approved

running

complete

failed

unknown

cancelled

requiresApproval

boolean · const · required

Const value:

expiresAt

ISO8601Timestamp · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

workObjectId

sourceRevisionId

recommendationId

PrepareExternalActionResponse

PreparedExternalAction · required

ApproveExternalActionResponse

PreparedExternalAction · required

approvalToken

string · required

ExternalActionReceipt

id

Identifier · required

preparedActionId

Identifier · required

projectId

Identifier · required

actionId

string · required

connectionId

string · required

status

string · enum · required

Enum values:

running

complete

failed

unknown

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

openConnectorRunId

string

auditPersisted

boolean

JSONValue

object

workObjectId

sourceRevisionId

recommendationId

ExecuteExternalActionRequest

approvalToken

string · required

ExecuteExternalActionResponse

PreparedExternalAction · required

ExternalActionReceipt · required

CreateSessionRequest

captureMode

CaptureMode · enum · required

Enum values:

microphone

microphone-and-system-audio

projectId

title

string

language

string

object

当前唯一收音设备。其它端只同步结果，不得再显示成本机「正在听」。

CreateSessionResponse

SessionSnapshot · required

conversationId

Identifier · required

websocketURL

string · required

workWebsocketURL

string · required

reusedExisting

boolean

true when the account already had this open session; no new row was created.

CreateProjectFromSessionRequest

name

string

CreateProjectFromSessionResponse

Project · required

SessionSnapshot · required

created

boolean · required

SessionListResponse

SessionSnapshot[] · required

SessionSearchResponse

query

string · required

SessionSnapshot[] · required

WorkspaceMemoryAnswerSource

id

Identifier · required

kind

string · enum · required

Enum values:

transcript

outcome

memory

title

string · required

excerpt

string · required

occurredAt

ISO8601Timestamp · required

sessionId

projectId

WorkspaceMemoryAnswerRequest

query

string · required

locale

string · enum

Enum values:

zh-Hans

en

WorkspaceMemoryAnswerResponse

query

string · required

status

string · enum · required

Enum values:

answered

no-evidence

answer

string · required

WorkspaceMemoryAnswerSource[] · required

generatedBy

string · enum · required

Enum values:

grounded-ai

extractive

TranscriptSummaryRequest

segmentId

Identifier · required

itemText

string · required

locale

string · enum

Enum values:

zh-Hans

en

TranscriptSummaryResponse

status

string · enum · required

Enum values:

answered

no-evidence

summary

string · required

object · required

generatedBy

string · enum · required

Enum values:

grounded-ai

extractive

AudioChunkResponse

accepted

boolean · const · required

Const value:

chunkId

Identifier · required

duplicate

boolean · required

TranscriptSegment

ShareLinkResponse

shareToken

string · required

shareURL

string · required

permission

string · enum · required

Enum values:

read

comment

expiresAt

SharedSessionResponse

SessionSnapshot · required

required

permission

string · enum · required

Enum values:

read

comment

ShareComment[] · required

expiresAt

ActionRecommendationEligibility

WorkSetDetailResponse

WorkSetV2 · required

WorkObject[] · required

WorkObjectRevision[] · required

ReviewTask[] · required

ActionV2[] · required

ExecutionV2[] · required

ActionRecommendationRun

ExternalActionRecommendation[]

PreparedExternalAction[]

ExternalActionReceipt[]

needsRebuild

boolean

True when historical output was hidden by the current quality gate and should be rebuilt from its preserved transcript before presentation.

TakeoverDigest

最新未 supersede 的会后摘要；无真实行动项时缺省，前端不渲染接管条。

WorkRelation[]

DecisionWorkstream[]

P6: one decision's independently reviewed professional branches.

takeoverState

TakeoverState · enum

会后整理诚实态：失败时 UI 显示重试，不静默。

Enum values:

pending

ready

failed

empty

WorkSetV2

id

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

title

string · required

status

string · enum · required

Enum values:

forming

ready

updating

superseded

revision

number · required

WorkSetPlacement[] · required

reviewTaskIds

Identifier[] · required

actionIds

Identifier[] · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

primaryWorkObjectId

preparedAt

readyAt

WorkSetPlacement

workObjectId

Identifier · required

order

number · required

size

string · enum · required

Enum values:

compact

standard

wide

hero

emphasis

string · enum · required

Enum values:

quiet

normal

primary

group

string

WorkObject

id

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

family

WorkObjectFamily · enum · required

Enum values:

task

issue

decision

requirement

design

research

communication

code

WorkObjectSemanticType · required

title

string · required

ownerRole

WorkspaceRole · enum · required

Enum values:

owner

admin

product-owner

engineering-owner

design-owner

member

progressState

WorkObjectProgressState · enum · required

责任推进状态与内容审阅状态相互独立：负责人可以推进工作，审阅人负责质量闸。

Enum values:

todo

in-progress

blocked

done

reviewState

WorkObjectReviewState · enum · required

Enum values:

draft

ready-for-review

changes-requested

approved

superseded

latestRevisionId

Identifier · required

latestRevisionNumber

number · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

workOrderId

meetingKind

MeetingWorkKind · enum

会议中的统一工作语言。它与更细的 family/semanticType 并存：前者让跨职能团队快速归类，后者继续为执行器和历史客户端提供精确语义。

Enum values:

outcome

decision

action

question

reference

meetingStage

MeetingWorkStage · enum

人工可审计的推进阶段；AI 建议不得直接改变该字段。

Enum values:

captured

structured

executing

ready-for-review

accepted

proposalState

WorkProposalState · enum

AI revision is only a proposal until a member explicitly decides it.

Enum values:

human

ai-pending

ai-accepted

ai-rejected

stageUpdatedAt

独立于内容 revision 的阶段乐观并发水位。

summary

string

ownerUserId

responsibilityUpdatedAt

独立于标题、内容与审阅修改的责任状态乐观并发水位。

dueAt

blockedReason

string

completedAt

WorkObjectFamily

string · enum

Enum values:

task

issue

decision

requirement

design

research

communication

code

WorkObjectSemanticType

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = string
	type = string

Properties for Variant 1:

BuiltInWorkObjectSemanticType · enum

Enum values:

todo-list

bug

investigation-checklist

product-decision

requirement

acceptance-criteria

design-brief

design-direction

BuiltInWorkObjectSemanticType

string · enum

Enum values:

todo-list

bug

investigation-checklist

product-decision

requirement

acceptance-criteria

design-brief

design-direction

MeetingWorkKind

string · enum

Enum values:

outcome

decision

action

question

reference

会议中的统一工作语言。它与更细的 family/semanticType 并存：前者让跨职能团队快速归类，后者继续为执行器和历史客户端提供精确语义。

MeetingWorkStage

string · enum

Enum values:

captured

structured

executing

ready-for-review

accepted

人工可审计的推进阶段；AI 建议不得直接改变该字段。

WorkProposalState

string · enum

Enum values:

human

ai-pending

ai-accepted

ai-rejected

WorkspaceRole

string · enum

Enum values:

owner

admin

product-owner

engineering-owner

design-owner

member

WorkObjectProgressState

string · enum

Enum values:

todo

in-progress

blocked

done

责任推进状态与内容审阅状态相互独立：负责人可以推进工作，审阅人负责质量闸。

WorkObjectReviewState

string · enum

Enum values:

draft

ready-for-review

changes-requested

approved

superseded

WorkObjectRevision

id

Identifier · required

workObjectId

Identifier · required

revision

number · required

revisionHash

string · required

title

string · required

WorkObjectContent · required

confidence

number · required

WorkObjectSource[] · required

required

createdAt

ISO8601Timestamp · required

summary

string

WorkContextRef[]

项目记忆召回来源；用于展示证据并组装确认后的本地或 OpenConnector 任务。

WorkObjectContent

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: kind, items
	type = object · requires: kind, symptom, reproductionSteps +1 more
	type = object · requires: kind, outcome, rationale
	type = object · requires: kind, problem, scope +1 more
	type = object · requires: kind, challenge, principles +2 more
	type = object · requires: kind, thesis, references
	type = object · requires: kind, question, findings +1 more
	type = object · requires: kind, channel, body
	type = object · requires: kind, objective, plan +2 more
	type = object · requires: kind, rootId, nodes
	type = object · requires: kind, assetType, url
	type = object · requires: kind, query, assets
	type = object · requires: kind, actionId, label
	type = object · requires: kind, fields
	type = object · requires: kind, elements

Properties for Variant 1:

kind

string · const · required

Const value: checklist

ChecklistItem[] · required

ChecklistItem

id

Identifier · required

title

string · required

state

string · enum · required

Enum values:

todo

in-progress

done

blocked

detail

string

ownerUserId

ownerLabel

string

dueAt

priority

string · enum

Enum values:

urgent

high

normal

low

sourceSegmentIds

VisualWorkRequestV1

version

number · const · required

Const value: 1

intent

VisualIntent · enum · required

视觉工作请求的版本化语义契约。它描述用户真正想推进的工作，动作标题、关键词和具体模型 prompt 都不能反向充当路由真相源。

Enum values:

reference-search

image-generation

image-edit

asset-retrieval

visual-analysis

none

goal

string · required

sourceSegmentIds

Identifier[] · required

assumptions

string[] · required

missingCriticalFields

string[] · required

confidence

number · required

deliverable

VisualDeliverable · enum

Enum values:

logo

app-icon

illustration

hero

product-mockup

photo

diagram

moodboard

usage

string

audience

string

subject

string

style

string[]

composition

string[]

palette

string[]

literalText

string[]

object

mustInclude

string[]

mustAvoid

string[]

referenceAssetIds

VisualDirectionV1[]

Two or three meaningfully different, reviewable directions.

WorkContextRef[]

VisualIntent

string · enum

Enum values:

reference-search

image-generation

image-edit

asset-retrieval

visual-analysis

none

视觉工作请求的版本化语义契约。它描述用户真正想推进的工作，动作标题、关键词和具体模型 prompt 都不能反向充当路由真相源。

VisualDeliverable

string · enum

Enum values:

logo

app-icon

illustration

hero

product-mockup

photo

diagram

moodboard

VisualDirectionV1

id

Identifier · required

name

string · required

rationale

string · required

VisualRevisionDeltaV1 · required

assumptions

string[] · required

VisualRevisionDeltaV1

version

number · const · required

Const value: 1

changedFields

VisualRevisionField[] · required

Enum values:

goal

deliverable

usage

audience

subject

style

composition

palette

object · required

sourceSegmentIds

Identifier[] · required

mergeMode

string · enum

Direction exploration appends qualities; user corrections replace them.

Enum values:

replace

append

feedback

string

confidence

number

VisualRevisionField

string · enum

Enum values:

goal

deliverable

usage

audience

subject

style

composition

palette

A visual revision is an explicit field mask, not a replacement prompt. This is the shared invariant behind first-round directions and later feedback such as “keep the composition, only change the color”.

WorkContextRef

sourceType

string · required

sourceId

string · required

title

string · required

excerpt

string · required

externalURL

string

VisualBriefV1

VisualWorkRequestV1 的确定性编译结果。请求保存“用户要什么”，简报保存 “系统准备怎样做”；执行器只消费该版本化简报，不直接吞口语或 UI 文案。

version

number · const · required

Const value: 1

requestVersion

number · const · required

Const value: 1

intent

string · enum · required

视觉工作请求的版本化语义契约。它描述用户真正想推进的工作，动作标题、关键词和具体模型 prompt 都不能反向充当路由真相源。

Enum values:

reference-search

image-generation

image-edit

asset-retrieval

visual-analysis

objective

string · required

object · required

assumptions

string[] · required

missingCriticalFields

string[] · required

readiness

VisualBriefReadiness · enum · required

Enum values:

ready

needs-input

review

executionTarget

string · enum · required

Enum values:

reference-search

image-generation

asset-retrieval

none

executionInstruction

string · required

sourceSegmentIds

Identifier[] · required

deliverable

VisualDeliverable · enum

Enum values:

logo

app-icon

illustration

hero

product-mockup

photo

diagram

moodboard

usage

string

audience

string

subject

string

object

WorkContextRef[]

VisualBriefReadiness

string · enum

Enum values:

ready

needs-input

review

DesignArtifactV1

CapWorks 内部可编辑的结构化设计稿，不等于生成位图或外部系统写入。

version

number · const · required

Const value: 1

id

Identifier · required

sourceRevisionId

Identifier · required

marker

string · required

name

string · required

object · required

DesignArtifactNodeV1

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: id, type, name +2 more
	type = object · requires: id, type, name +4 more
	type = object · requires: id, type, name +3 more
	type = object · requires: id, type, name +1 more

Properties for Variant 1:

id

Identifier · required

type

string · const · required

Const value: frame

name

string · required

layout

string · enum · required

Enum values:

none

horizontal

vertical

DesignArtifactNodeV1[] · required

width

number

height

number

gap

number

padding

number

background

string

BlockElement

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: element, id, text
	type = object · requires: element, id, text
	type = object · requires: element, id, text
	type = object · requires: element, id, text
	type = object · requires: element, id, state +1 more
	type = object · requires: element, id, text
	type = object · requires: element, id, text
	type = object · requires: element, id, url
	type = object · requires: element, id, url
	type = object · requires: element, id, rows
	type = object · requires: code, element, id
	type = object · requires: element, id, label +1 more
	type = object · requires: element, id

Properties for Variant 1:

element

string · const · required

Const value: heading

InlineNode[] · required

id

Identifier · required

ElementSourceRef

零件溯源：指回转写段——AI 产出的每一粒零件都有出处可查

RichText

InlineNode[]

行内节点：一段文字 + 可选标记/链接/提及。纯文本即单节点。

InlineNode

text

string · required

marks

InlineMark[]

Enum values:

em

code

href

string

InlineMention

InlineNode

行内节点：一段文字 + 可选标记/链接/提及。纯文本即单节点。

text

string · required

marks

InlineMark[]

Enum values:

em

code

href

string

InlineMention

InlineMark

string · enum

Enum values:

em

code

InlineMention

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: kind, label
	type = object · requires: kind, date

Properties for Variant 1:

kind

string · const · required

Const value: person

label

string · required

participantId

ElementSourceRef

零件溯源：指回转写段——AI 产出的每一粒零件都有出处可查

segmentId

Identifier · required

speakerId

CheckItemState

string · enum

Enum values:

todo

in-progress

done

blocked

WorkPlug

管道插头：块凭零件构成获得的生产动作入口

target

string · enum · required

Enum values:

external-action

local-agent

label

string

WorkObjectSource

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: kind, segmentId
	type = object · requires: kind, claimId
	type = object · requires: kind, sourceId, connectionId
	type = object · requires: kind, workOrderId, role
	type = object · requires: kind, userId
	type = object · requires: kind, sourceType, sourceId +2 more

Properties for Variant 1:

kind

string · const · required

Const value: transcript

segmentId

Identifier · required

excerpt

string

speakerId

ReviewTask

id

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

workSetId

Identifier · required

workObjectId

Identifier · required

revisionId

Identifier · required

assigneeRole

WorkspaceRole · enum · required

Enum values:

owner

admin

product-owner

engineering-owner

design-owner

member

status

ReviewTaskStatus · enum · required

Enum values:

waiting-for-submission

pending

in-review

approved

changes-requested

cancelled

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

assigneeUserId

claimedByUserId

requestedAt

resolvedAt

ReviewTaskStatus

string · enum

Enum values:

waiting-for-submission

pending

in-review

approved

changes-requested

cancelled

ActionV2

id

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

workSetId

Identifier · required

sourceRevisionIds

Identifier[] · required

actionType

string · required

title

string · required

risk

ExternalActionRisk · enum · required

Enum values:

low

medium

high

object · required

status

ActionV2Status · enum · required

Enum values:

prepared

work-approved

awaiting-side-effect-approval

approved

queued

running

complete

failed

requiresWorkApproval

boolean · required

requiresSideEffectApproval

boolean · required

idempotencyKey

string · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

description

string

approvedByUserId

approvedAt

ActionV2Status

string · enum

Enum values:

prepared

work-approved

awaiting-side-effect-approval

approved

queued

running

complete

failed

ExecutionV2

id

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

actionId

Identifier · required

status

string · enum · required

Enum values:

queued

running

complete

failed

cancelled

attempt

number · required

idempotencyKey

string · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

runnerId

externalObjectId

string

externalURL

string

object

startedAt

completedAt

ActionRecommendationEligibility

state

ActionRecommendationEligibilityState · enum · required

Enum values:

no_provider

no_authorized_action

limited

ready

providerCount

number · required

actionCount

number · required

ActionRecommendationEligibilityState

string · enum

Enum values:

no_provider

no_authorized_action

limited

ready

ActionRecommendationRun

state

ActionRecommendationRunState · enum · required

Enum values:

pending

running

ready

empty

failed

stale

basedOnWorkSetRevision

number · required

recommendationCount

number · required

updatedAt

ISO8601Timestamp · required

errorCode

string

ActionRecommendationRunState

string · enum

Enum values:

pending

running

ready

empty

failed

stale

ExternalActionRecommendation

id

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

workObjectId

Identifier · required

sourceRevisionId

Identifier · required

actionId

string · required

actionLabel

string · required

service

string · required

connectionId

string · required

connectionName

string · required

object · required

missingFields

string[] · required

reason

string · required

score

number · required

status

ExternalActionRecommendationStatus · enum · required

Enum values:

active

stale

prepared

dismissed

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

preparedActionId

ExternalActionRecommendationStatus

string · enum

Enum values:

active

stale

prepared

dismissed

TakeoverDigest

会后接管摘要：纯派生，钉在某个 workset revision 上，不改写块。

id

Identifier · required

conversationId

Identifier · required

basedOnWorksetRevision

number · required

TakeoverAlignedItem[] · required

TakeoverNowItem[] · required

TakeoverLaterItem[] · required

ClarifyItem[] · required

generatedAt

ISO8601Timestamp · required

supersededAt

TakeoverAlignedItem

text

string · required

evidenceSegmentIds

Identifier[] · required

TakeoverNowItem

workObjectId

Identifier · required

why

string · required

evidenceSegmentIds

Identifier[] · required

TakeoverLaterItem

why

string · required

workObjectId

text

string

ClarifyItem

id

Identifier · required

workObjectId

Identifier · required

question

string · required

wouldChange

string · required

答案将改变什么；空则不得入库。

status

ClarifyStatus · enum · required

Enum values:

open

confirmed

deferred

dismissed

evidenceSegmentIds

Identifier[] · required

ClarifyStatus

string · enum

Enum values:

open

confirmed

deferred

dismissed

WorkRelation

会后派生关系：有原话证据才入库，类型由 LLM 判断，不写死枚举。

id

Identifier · required

workSetId

Identifier · required

fromWorkObjectId

Identifier · required

toWorkObjectId

Identifier · required

relationType

string · required

reason

string · required

sourceSegmentIds

Identifier[] · required

manualOverride

boolean · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

deletedAt

DecisionWorkstream

Read-only current projection. Membership comes only from shared transcript evidence; it never replaces each profession's independent revision/review.

id

Identifier · required

decisionWorkObjectId

Identifier · required

decisionRevisionId

Identifier · required

sourceSegmentIds

Identifier[] · required

DecisionWorkstreamItem[] · required

DecisionWorkstreamItem

workObjectId

Identifier · required

revisionId

Identifier · required

discipline

DecisionWorkstreamDiscipline · enum · required

Enum values:

product

design

engineering

quality

reviewStatus

ReviewTaskStatus · enum · required

Enum values:

waiting-for-submission

pending

in-review

approved

changes-requested

cancelled

actionIds

Identifier[] · required

reviewTaskId

DecisionWorkstreamDiscipline

string · enum

Enum values:

product

design

engineering

quality

TakeoverState

string · enum

Enum values:

pending

ready

failed

empty

ShareComment

id

Identifier · required

workObjectId

Identifier · required

authorUserId

Identifier · required

authorDisplayName

string · required

body

string · required

status

WorkCommentStatus · enum · required

Enum values:

active

resolved

createdAt

ISO8601Timestamp · required

WorkCommentStatus

string · enum

Enum values:

active

resolved

RealtimeServerMessage

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: kind, snapshot
	type = object · requires: kind, event
	type = object · requires: kind, lastSequence
	type = object · requires: kind, sentAt
	type = object · requires: kind, code, message +1 more

Properties for Variant 1:

kind

string · const · required

Const value: snapshot

SessionSnapshot · required

RealtimePresenceIntent

string · enum

Enum values:

viewing

editing

reviewing

assigning

RealtimePresenceSelection

workObjectId

Identifier · required

fieldId

string

RealtimePresenceViewport

left

number · required

top

number · required

width

number · required

height

number · required

RealtimeDraftRef

A live draft is scoped to one immutable WorkObject revision. It is never the authoritative revision itself; publishing the draft still goes through the normal optimistic-concurrency API.

workObjectId

Identifier · required

baseRevisionId

Identifier · required

RealtimeClientMessage

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: kind, afterSequence
	type = object · requires: kind, sentAt
	type = object · requires: baseRevisionId, clientId, kind +1 more
	type = object · requires: baseRevisionId, clientId, kind +3 more
	type = object · requires: baseRevisionId, checkpointId, clientId +2 more
	type = object · requires: baseRevisionId, clientId, kind +1 more
	type = object · requires: kind, page, sentAt

Properties for Variant 1:

kind

string · const · required

Const value: resume

afterSequence

number · required

ArtifactGenerationResult

object[] · required

WorkRefinementMode

string · enum

Enum values:

live

final

rebuild

WorkRefinementStatus

state

string · enum · required

Enum values:

idle

queued

running

ready

failed

requestedTranscriptCount

number · required

completedTranscriptCount

number · required

mode

WorkRefinementMode · enum · required

Enum values:

live

final

rebuild

failureCount

number · required

updatedAt

ISO8601Timestamp · required

completedMode

WorkRefinementMode · enum

Enum values:

live

final

rebuild

errorCode

string

WorkRefinementResponse

WorkRefinementStatus · required

QueueJob

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: kind, sessionId, transcriptCount +2 more
	type = object · requires: kind, sessionId, requestedAt
	type = object · requires: kind, workspaceId, projectId +2 more
	type = object · requires: kind, sessionId, requestedAt
	type = object · requires: kind, actionId, requestedAt
	type = object · requires: kind, actionId, requestedAt
	type = object · requires: kind, workspaceId, requestedAt
	type = object · requires: kind, conversationId, sessionId +2 more
	type = object · requires: kind, workspaceId, workSetId +2 more
	type = object · requires: kind, workspaceId, projectId +2 more
	type = object · requires: kind, requestedAt

Properties for Variant 1:

kind

string · const · required

Const value: refine-session-work

sessionId

Identifier · required

transcriptCount

number · required

mode

WorkRefinementMode · enum · required

Enum values:

live

final

rebuild

requestedAt

ISO8601Timestamp · required

CurrentUser

id

Identifier · required

workspaceId

Identifier · required

displayName

string · required

roles

WorkspaceRole[] · required

Enum values:

owner

admin

product-owner

engineering-owner

design-owner

member

jobRole

JobRole · enum · required

Enum values:

product

engineering

design

other

locale

string · enum · required

Enum values:

en

zh-Hans

email

string

avatarURL

string

jobRoleConfirmedAt

JobRole

string · enum

Enum values:

product

engineering

design

other

WorkspaceAccessRole

string · enum

Enum values:

owner

admin

member

BillingPlanKey

string · enum

Enum values:

free

pro

business

BillingInterval

string · enum

Enum values:

monthly

annual

BillingSubscriptionStatus

string · enum

Enum values:

free

trialing

active

past_due

canceled

unpaid

incomplete

incomplete_expired

BillingPlanDefinition

key

BillingPlanKey · enum · required

Enum values:

free

pro

business

name

string · required

description

string · required

monthlyPricePerSeat

number · required

annualPricePerSeat

number · required

annualTotalPerSeat

number · required

currency

string · const · required

Const value: usd

object · required

features

string[] · required

BillingSummaryResponse

enabled

boolean · required

BillingPlanDefinition[] · required

object · required

canManageBilling

boolean · required

CreateBillingCheckoutRequest

planKey

string · enum · required

Enum values:

pro

business

interval

BillingInterval · enum · required

Enum values:

monthly

annual

seatQuantity

number · required

BillingRedirectResponse

url

string · required

WorkspaceSummary

id

Identifier · required

name

string · required

accessRole

WorkspaceAccessRole · enum · required

Enum values:

owner

admin

member

contentPermission

WorkspaceContentPermission · enum · required

内容协作权限独立于组织管理角色；view 仍可在场、查看与评论。

Enum values:

edit

view

jobRole

JobRole · enum · required

Enum values:

product

engineering

design

other

CurrentAccountResponse

object · required

WorkspaceSummary[] · required

object · required

object

服务端发布开关；旧服务端缺失时客户端必须按关闭处理。

AccountBootstrapResponse

CurrentAccountResponse · required

isNewAccount

boolean · required

joinedWorkspaceFromInvite

boolean · required

invitedProjectId

WorkspaceMember

userId

Identifier · required

displayName

string · required

accessRole

WorkspaceAccessRole · enum · required

Enum values:

owner

admin

member

contentPermission

WorkspaceContentPermission · enum · required

内容协作权限独立于组织管理角色；view 仍可在场、查看与评论。

Enum values:

edit

view

jobRole

JobRole · enum · required

Enum values:

product

engineering

design

other

joinedAt

ISO8601Timestamp · required

email

string

avatarURL

string

lastSeenAt

最近心跳时间；20 秒租约内视为在线（实时通道断线后的可信兜底）

online

boolean

presencePage

string

当前所在页面或展开块 id（page / object:work_…）

viewingWorkObjectId

string

RealtimePresence

workspaceId

Identifier · required

conversationId

Identifier · required

userId

Identifier · required

page

string · required

lastSeenAt

ISO8601Timestamp · required

clientId

string

surfaceId

string

object

RealtimePresenceViewport

RealtimePresenceSelection

intent

RealtimePresenceIntent · enum

Enum values:

viewing

editing

reviewing

assigning

WorkspaceInvitationStatus

string · enum

Enum values:

pending

accepted

revoked

expired

WorkspaceInvitation

id

Identifier · required

workspaceId

Identifier · required

email

string · required

accessRole

string · enum · required

Enum values:

admin

member

contentPermission

WorkspaceContentPermission · enum · required

内容协作权限独立于组织管理角色；view 仍可在场、查看与评论。

Enum values:

edit

view

jobRole

JobRole · enum · required

Enum values:

product

engineering

design

other

status

WorkspaceInvitationStatus · enum · required

Enum values:

pending

accepted

revoked

expired

invitedByUserId

Identifier · required

expiresAt

ISO8601Timestamp · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

projectId

可选的项目落点；邀请仍授予工作区权限，项目只负责进入后的上下文。

acceptedByUserId

acceptedAt

revokedAt

WorkspaceMembersResponse

WorkspaceMember[] · required

WorkspaceInvitation[] · required

CreateWorkspaceInvitationRequest

email

string · required

accessRole

string · enum · required

Enum values:

admin

member

contentPermission

WorkspaceContentPermission · enum · required

内容协作权限独立于组织管理角色；view 仍可在场、查看与评论。

Enum values:

edit

view

jobRole

JobRole · enum · required

Enum values:

product

engineering

design

other

projectId

CreateWorkspaceInvitationResponse

WorkspaceInvitation · required

inviteURL

string · required

delivery

string · enum · required

Enum values:

email

link

WorkspaceInvitationPreview

workspaceName

string · required

invitedEmail

string · required

contentPermission

WorkspaceContentPermission · enum · required

内容协作权限独立于组织管理角色；view 仍可在场、查看与评论。

Enum values:

edit

view

status

WorkspaceInvitationStatus · enum · required

Enum values:

pending

accepted

revoked

expired

expiresAt

ISO8601Timestamp · required

projectId

projectName

string

WorkspaceSelectionResponse

CurrentAccountResponse · required

invitedProjectId

ConversationStatus

string · enum

Enum values:

ready

listening

paused

ending

ready-for-review

complete

error

deleted

ProjectInference

confidence

number · required

state

string · enum · required

Enum values:

automatic

needs-confirmation

needs-selection

corrected

evidence

string[] · required

inferredAt

ISO8601Timestamp · required

projectId

projectName

string

confirmedByUserId

Conversation

id

Identifier · required

workspaceId

Identifier · required

title

string · required

status

ConversationStatus · enum · required

Enum values:

ready

listening

paused

ending

ready-for-review

complete

error

deleted

captureMode

string · enum · required

Enum values:

microphone

microphone-and-system-audio

participantIds

Identifier[] · required

startedAt

ISO8601Timestamp · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

projectId

contentLanguage

string

ProjectInference

workSetId

endedAt

WorkOrderStatus

string · enum

Enum values:

queued

working

waiting-for-context

complete

cancelled

failed

WorkOrder

id

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

required

objective

string · required

status

WorkOrderStatus · enum · required

Enum values:

queued

working

waiting-for-context

complete

cancelled

failed

priority

number · required

sourceSegmentIds

Identifier[] · required

inputMemoryClaimIds

Identifier[] · required

outputWorkObjectIds

Identifier[] · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

modelRoute

string

startedAt

completedAt

VisualGenerationDirectionV1

id

Identifier · required

name

string · required

rationale

string · required

VisualRevisionDeltaV1 · required

assumptions

string[] · required

VisualBriefV1 · required

VisualWorkRequestV1 的确定性编译结果。请求保存“用户要什么”，简报保存 “系统准备怎样做”；执行器只消费该版本化简报，不直接吞口语或 UI 文案。

VisualGenerationPlanV1

Immutable execution plan compiled from one source request revision.

version

number · const · required

Const value: 1

requestVersion

number · const · required

Const value: 1

VisualBriefV1 · required

VisualWorkRequestV1 的确定性编译结果。请求保存“用户要什么”，简报保存 “系统准备怎样做”；执行器只消费该版本化简报，不直接吞口语或 UI 文案。

VisualGenerationDirectionV1[] · required

VisualImageMimeType

string · enum

Enum values:

image/jpeg

image/png

image/svg+xml

VisualModelCapabilityV1

App-owned allowlist for one image model adapter. This is an execution boundary, not a marketing claim about every feature the provider may offer.

version

number · const · required

Const value: 1

provider

string · const · required

Const value: cloudflare-workers-ai

model

string · required

supportedIntents

string[] · required

supportedDeliverables

VisualDeliverable[] · required

Enum values:

logo

app-icon

illustration

hero

product-mockup

photo

diagram

moodboard

supportedAspectRatios

string[] · required

outputMimeTypes

VisualImageMimeType[] · required

Enum values:

image/jpeg

image/png

image/svg+xml

maxWidth

number · required

maxHeight

number · required

imageEditing

boolean · required

transparentBackground

boolean · required

exactTextFidelity

string · const · required

Const value: review-required

VisualModelReviewRequirement

string · enum

Enum values:

semantic-fidelity

literal-text-fidelity

VisualModelRouteV1

version

number · const · required

Const value: 1

VisualModelCapabilityV1 · required

App-owned allowlist for one image model adapter. This is an execution boundary, not a marketing claim about every feature the provider may offer.

width

number · required

height

number · required

aspectRatio

string · required

steps

number · required

guidance

number · required

reviewRequirements

VisualModelReviewRequirement[] · required

Enum values:

semantic-fidelity

literal-text-fidelity

VisualQualityCheckCode

string · enum

Enum values:

output-bytes

mime-type

dimensions

aspect-ratio

prompt-coverage

semantic-fidelity

literal-text-fidelity

VisualQualityCheckV1

code

VisualQualityCheckCode · enum · required

Enum values:

output-bytes

mime-type

dimensions

aspect-ratio

prompt-coverage

semantic-fidelity

literal-text-fidelity

status

string · enum · required

Enum values:

pass

warn

fail

message

string · required

object

VisualQualityReportV1

Deterministic transport/adapter checks stay separate from aesthetic review. A report may reject malformed output, but cannot claim pixel-level semantic fidelity without a later visual reviewer or a human decision.

version

number · const · required

Const value: 1

verdict

string · enum · required

Enum values:

pass

needs-review

reject

VisualModelRouteV1 · required

object · required

VisualQualityCheckV1[] · required

MeetingWorkNextStep

string · enum

Enum values:

organize

codex

moodboard

visual-proposal

成员在捕获讨论时明确选择的下一条生产分支。它只准备内部工作或待确认动作，不授权任何外部副作用。

CaptureMeetingWorkObjectRequest

kind

MeetingWorkKind · enum · required

会议中的统一工作语言。它与更细的 family/semanticType 并存：前者让跨职能团队快速归类，后者继续为执行器和历史客户端提供精确语义。

Enum values:

outcome

decision

action

question

reference

title

string · required

sourceSegmentIds

Identifier[] · required

summary

string

nextStep

MeetingWorkNextStep · enum

成员在捕获讨论时明确选择的下一条生产分支。它只准备内部工作或待确认动作，不授权任何外部副作用。

Enum values:

organize

codex

moodboard

visual-proposal

targetProjectId

ExternalActionRecommendationListResponse

ExternalActionRecommendation[] · required

ExternalActionRecommendationDraftRequest

actionId

string · required

connectionId

string · required

ExternalActionRecommendationDraftResponse

ExternalActionRecommendation · required

RefreshActionRecommendationsResponse

ActionRecommendationRun · required

PrepareExternalActionRecommendationRequest

object · required

CaptureMeetingWorkObjectResponse

WorkSetV2 · required

WorkObject · required

WorkObjectRevision · required

SuggestMeetingWorkProjectRequest

sourceSegmentIds

Identifier[] · required

MeetingWorkProjectSuggestion

projectId

Identifier · required

projectName

string · required

confidence

number · required

evidenceSegmentIds

Identifier[] · required

SuggestMeetingWorkProjectResponse

MeetingWorkProjectSuggestion[] · required

route

string · enum · required

Enum values:

project

inbox

preselectedProjectId

TransitionMeetingWorkStageRequest

fromStage

MeetingWorkStage · enum · required

人工可审计的推进阶段；AI 建议不得直接改变该字段。

Enum values:

captured

structured

executing

ready-for-review

accepted

toStage

MeetingWorkStage · enum · required

人工可审计的推进阶段；AI 建议不得直接改变该字段。

Enum values:

captured

structured

executing

ready-for-review

accepted

note

string

WorkObjectStageTransition

id

Identifier · required

workObjectId

Identifier · required

actorUserId

Identifier · required

fromStage

MeetingWorkStage · enum · required

人工可审计的推进阶段；AI 建议不得直接改变该字段。

Enum values:

captured

structured

executing

ready-for-review

accepted

toStage

MeetingWorkStage · enum · required

人工可审计的推进阶段；AI 建议不得直接改变该字段。

Enum values:

captured

structured

executing

ready-for-review

accepted

createdAt

ISO8601Timestamp · required

note

string

TransitionMeetingWorkStageResponse

WorkObject · required

WorkObjectStageTransition · required

WorkObjectRevisionHistoryResponse

workObjectId

Identifier · required

WorkObjectRevision[] · required

DecideWorkProposalRequest

decision

string · enum · required

Enum values:

accept

reject

expectedRevisionId

Identifier · required

note

string

WorkProposalDecision

id

Identifier · required

workObjectId

Identifier · required

revisionId

Identifier · required

actorUserId

Identifier · required

decision

string · enum · required

Enum values:

accept

reject

createdAt

ISO8601Timestamp · required

note

string

DecideWorkProposalResponse

WorkObject · required

WorkProposalDecision · required

WorkAssignmentAction

string · enum

Enum values:

claim

assign

release

UpdateWorkAssignmentRequest

action

WorkAssignmentAction · enum · required

Enum values:

claim

assign

release

userId

UpdateWorkResponsibilityRequest

expectedResponsibilityUpdatedAt

ISO8601Timestamp · required

state

WorkObjectProgressState · enum

责任推进状态与内容审阅状态相互独立：负责人可以推进工作，审阅人负责质量闸。

Enum values:

todo

in-progress

blocked

done

blockedReason

string | null

WorkComment

id

Identifier · required

workspaceId

Identifier · required

workObjectId

Identifier · required

authorKind

string · enum · required

Enum values:

member

account

authorUserId

Identifier · required

authorDisplayName

string · required

body

string · required

mentionUserIds

Identifier[] · required

status

WorkCommentStatus · enum · required

Enum values:

active

resolved

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

authorAvatarURL

string

editedAt

resolvedAt

resolvedByUserId

WorkCommentsResponse

WorkComment[] · required

CreateWorkCommentRequest

body

string · required

mentionUserIds

CreateShareCommentRequest

workObjectId

Identifier · required

body

string · required

UpdateWorkCommentRequest

expectedUpdatedAt

ISO8601Timestamp · required

body

string

mentionUserIds

resolved

boolean

CollaborationNotificationKind

string · enum

Enum values:

mention

assignment

CollaborationNotification

个人协作收件箱是评论/负责人的物化送达视图，不是内容真相源。

id

Identifier · required

workspaceId

Identifier · required

kind

CollaborationNotificationKind · enum · required

Enum values:

mention

assignment

sourceKey

string · required

conversationId

Identifier · required

sessionId

Identifier · required

workObjectId

Identifier · required

workObjectTitle

string · required

actorDisplayName

string · required

createdAt

ISO8601Timestamp · required

commentId

commentPreview

string

actorUserId

actorAvatarURL

string

readAt

CollaborationNotificationsResponse

CollaborationNotification[] · required

unreadCount

number · required

MarkCollaborationNotificationsReadRequest

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: all
	type = object · requires: notificationIds

Properties for Variant 1:

all

boolean · const · required

Const value:

MarkCollaborationNotificationsReadResponse

updated

number · required

unreadCount

number · required

RequestReviewRequest

指定审阅人与正式发起审阅是两件事。负责人或管理者只可把当前正式版本提交审阅。

revisionId

Identifier · required

ReviewAssignmentAction

string · enum

Enum values:

claim

assign

release

UpdateReviewAssignmentRequest

action

ReviewAssignmentAction · enum · required

Enum values:

claim

assign

release

userId

ReviewDecisionKind

string · enum

Enum values:

approved

changes-requested

returned

taken-over

reassigned

ReviewDecision

id

Identifier · required

reviewTaskId

Identifier · required

revisionId

Identifier · required

decision

ReviewDecisionKind · enum · required

Enum values:

approved

changes-requested

returned

taken-over

reassigned

actorUserId

Identifier · required

createdAt

ISO8601Timestamp · required

note

string

reassignedToUserId

MemoryAuthority

string · enum

Enum values:

user-confirmed

external-authority

review-approved

ai-inferred

unverified-draft

MemoryEntity

id

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

entityType

string · enum · required

Enum values:

project

product

person

team

brand

repository

design-file

external-object

canonicalName

string · required

aliases

string[] · required

status

string · enum · required

Enum values:

active

merged

archived

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

mergedIntoEntityId

MemorySource

kind

string · enum · required

Enum values:

user

conversation

integration

review

system

codebase

authority

MemoryAuthority · enum · required

Enum values:

user-confirmed

external-authority

review-approved

ai-inferred

unverified-draft

observedAt

ISO8601Timestamp · required

userId

conversationId

reviewDecisionId

connectionId

string

externalMemorySourceId

sourceId

externalObjectType

string

externalObjectId

string

externalURL

string

externalVersion

string

repoPath

string

MemoryClaim

id

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

subjectEntityId

Identifier · required

predicate

string · required

JSONValue · required

authority

MemoryAuthority · enum · required

Enum values:

user-confirmed

external-authority

review-approved

ai-inferred

unverified-draft

confidence

number · required

status

string · enum · required

Enum values:

active

conflicted

superseded

rejected

MemorySource · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

normalizedValue

string

validFrom

validUntil

supersedesClaimId

MemoryRelation

id

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

fromEntityId

Identifier · required

relationType

string · required

toEntityId

Identifier · required

authority

MemoryAuthority · enum · required

Enum values:

user-confirmed

external-authority

review-approved

ai-inferred

unverified-draft

confidence

number · required

status

string · enum · required

Enum values:

active

conflicted

superseded

rejected

MemorySource · required

createdAt

ISO8601Timestamp · required

updatedAt

ISO8601Timestamp · required

MemoryConflict

id

Identifier · required

projectId

Identifier · required

subjectEntityId

Identifier · required

predicate

string · required

claimIds

Identifier[] · required

status

string · enum · required

Enum values:

open

resolved

dismissed

createdAt

ISO8601Timestamp · required

resolvedClaimId

resolvedByUserId

resolvedAt

LocalRunnerKind

string · enum

Enum values:

codex

claude-code

LocalRunnerResultV1

本地代码执行的可审阅结果；远程 PR/合并/部署不属于该结果。

version

number · const · required

Const value: 1

runner

LocalRunnerKind · enum · required

Enum values:

codex

claude-code

exitCode

number · required

baseRevision

string · required

headRevision

string · required

worktreePath

string · required

changedFiles

string[] · required

diffStat

string · required

diffPatch

string · required

object[] · required

riskStatus

string · enum · required

空数组不能被解释为“无风险”；当前 runner 未结构化报告时保持 not-reported。

Enum values:

reported

not-reported

output

string · required

unresolvedRisks

string[]

LocalRunnerRegistration

id

Identifier · required

workspaceId

Identifier · required

userId

Identifier · required

installationId

Identifier · required

displayName

string · required

supportedRunners

LocalRunnerKind[] · required

Enum values:

codex

claude-code

object[] · required

publicSigningKey

string · required

status

string · enum · required

Enum values:

online

offline

revoked

lastSeenAt

ISO8601Timestamp · required

LocalRunnerTask

id

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

actionId

Identifier · required

executionId

Identifier · required

registrationId

Identifier · required

runnerKind

LocalRunnerKind · enum · required

Enum values:

codex

claude-code

repositoryAuthorizationId

Identifier · required

workingDirectory

string · required

prompt

string · required

sandbox

string · enum · required

Enum values:

workspace-write

read-only

signature

string · required

status

string · enum · required

Enum values:

queued

claimed

running

complete

failed

expired

expiresAt

ISO8601Timestamp · required

createdAt

ISO8601Timestamp · required

signedPayload

string

被 Ed25519 签名的确切载荷（JSON 字符串）；Mac 端验签并核对字段一致性

claimedAt

completedAt

EventEnvelopeV2_3c_22project_2einferred_22_3e

RegisterLocalRunnerRequest

installationId

Identifier · required

displayName

string · required

supportedRunners

LocalRunnerKind[] · required

Enum values:

codex

claude-code

object[] · required

publicSigningKey

string · required

CompleteLocalRunnerTaskRequest

signature

string · required

status

string · enum · required

Enum values:

complete

failed

object

ExecuteActionV2Response

ActionV2 · required

ExecutionV2 · required

LocalRunnerTask

CapWorksEventPayloadsV2

object · required

CapWorksEventTypeV2

string · enum

Enum values:

project.inferred

work_order.started

work_order.updated

work_object.proposed

work_object.revised

work_object.assigned

work_object.progress_updated

work_object.stage_updated

CapWorksEventV2

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more
	type = object · requires: eventId, workspaceId, projectId +8 more

Properties for Variant 1:

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: project.inferred

object · required

EventEnvelopeV2_3c_22project_2einferred_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: project.inferred

object · required

EventEnvelopeV2_3c_22work_order_2estarted_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: work_order.started

object · required

EventEnvelopeV2_3c_22work_order_2eupdated_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: work_order.updated

object · required

EventEnvelopeV2_3c_22work_object_2eproposed_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: work_object.proposed

object · required

EventEnvelopeV2_3c_22work_object_2erevised_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: work_object.revised

object · required

EventEnvelopeV2_3c_22work_object_2eassigned_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: work_object.assigned

object · required

EventEnvelopeV2_3c_22work_object_2eprogress_updated_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: work_object.progress_updated

object · required

EventEnvelopeV2_3c_22work_object_2estage_updated_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: work_object.stage_updated

object · required

EventEnvelopeV2_3c_22work_object_2eproposal_decided_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: work_object.proposal_decided

object · required

EventEnvelopeV2_3c_22work_comment_2ecreated_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: work_comment.created

object · required

EventEnvelopeV2_3c_22work_comment_2eupdated_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: work_comment.updated

object · required

EventEnvelopeV2_3c_22workset_2eupdated_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: workset.updated

object · required

EventEnvelopeV2_3c_22workset_2eready_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: workset.ready

object · required

EventEnvelopeV2_3c_22action_recommendations_2eupdated_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: action_recommendations.updated

object · required

EventEnvelopeV2_3c_22review_2eplanned_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: review.planned

object · required

EventEnvelopeV2_3c_22review_2eassigned_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: review.assigned

object · required

EventEnvelopeV2_3c_22review_2erequested_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: review.requested

object · required

EventEnvelopeV2_3c_22review_2eapproved_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: review.approved

object · required

EventEnvelopeV2_3c_22review_2echanges_requested_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: review.changes_requested

object · required

EventEnvelopeV2_3c_22action_2eprepared_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: action.prepared

object · required

EventEnvelopeV2_3c_22action_2eapproved_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: action.approved

object · required

EventEnvelopeV2_3c_22execution_2erunning_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: execution.running

object · required

EventEnvelopeV2_3c_22execution_2ecompleted_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: execution.completed

object · required

EventEnvelopeV2_3c_22execution_2efailed_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: execution.failed

object · required

EventEnvelopeV2_3c_22memory_2ecandidate_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: memory.candidate

object · required

EventEnvelopeV2_3c_22memory_2eaccepted_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: memory.accepted

object · required

EventEnvelopeV2_3c_22memory_2econflicted_22_3e

eventId

Identifier · required

workspaceId

Identifier · required

projectId

Identifier · required

conversationId

Identifier · required

sequence

number · required

occurredAt

ISO8601Timestamp · required

EventActor · required

schemaVersion

number · const · required

Const value: 2

idempotencyKey

string · required

type

string · const · required

Const value: memory.conflicted

object · required

ClarifyResolveRequest

action

string · const · required

Const value: clarify.resolve

clarifyId

Identifier · required

resolution

string · enum · required

Enum values:

confirmed

deferred

dismissed

idempotencyKey

string · required

TakeoverRegenerateRequest

action

string · const · required

Const value: takeover.regenerate

idempotencyKey

string · required

RelationMutateRequest

action

string · enum · required

Enum values:

relation.delete

relation.confirm

relationId

Identifier · required

idempotencyKey

string · required

WorkSetPatchRequest

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: action, clarifyId, resolution +1 more
	type = object · requires: action, idempotencyKey
	type = object · requires: action, relationId, idempotencyKey

Properties for Variant 1:

ClarifyResolveRequest

action

string · const · required

Const value: clarify.resolve

clarifyId

Identifier · required

resolution

string · enum · required

Enum values:

confirmed

deferred

dismissed

idempotencyKey

string · required

ConversationWorkSetListResponse

WorkSetDetailResponse[] · required

WorkSetPatchResponse

TakeoverDigest

会后接管摘要：纯派生，钉在某个 workset revision 上，不改写块。

WorkRelation[]

takeoverState

TakeoverState · enum

Enum values:

pending

ready

failed

empty

object

UpdateWorkObjectRequest

expectedRevisionHash

string · required

WorkObjectContent · required

title

string

summary

string

CreateReviewDecisionRequest

revisionId

Identifier · required

decision

ReviewDecisionKind · enum · required

Enum values:

approved

changes-requested

returned

taken-over

reassigned

note

string

reassignedToUserId

PrepareActionRequest

sourceRevisionIds

Identifier[] · required

actionType

string · required

title

string · required

risk

ExternalActionRisk · enum · required

Enum values:

low

medium

high

object · required

idempotencyKey

string · required

description

string

ActionPreviewResponse

ActionV2 · required

humanReadableTarget

string · required

sideEffects

string[] · required

permissions

string[] · required

ProjectMemoryGraphResponse

projectId

Identifier · required

MemoryEntity[] · required

MemoryClaim[] · required

MemoryRelation[] · required

MemoryConflict[] · required

lastRefreshedAt