Reference · generated
Every operation kovee answers, and every CLI verb it ships.
The registry below is the authority on what exists: 96
operations over 100
(operation, surface) entries in
4 bundles, at registry revision
k2-4.
If an operation is not on this page, kovee does not have it.
docs-tools/gen_reference.py from
spec/registry.json, spec/schemas/,
crates/kovee-cli/src/main.rs and
crates/koveed/src/handlers.rs. Editing it by hand is pointless —
docs-tools/check_docs.py regenerates it and fails on any difference.
How to read this
An entry is one (operation, surface) pair. A few operations are
reachable from two surfaces with different authority, so there are more entries
than operations. Each card carries the registry's own fields:
| Field | What it means |
|---|---|
Surface | Which socket and channel may carry it: external_client, worker, or operator. |
Actor | The actor kinds the registry admits for that surface. |
Kind | Mutation or query. A mutation requires meta (request_id and idempotency_key); a query does not. |
Args | Argument names taken from the operation's request schema. A trailing ? marks an optional one. |
Dependencies | The AuthorizationDependencySet categories re-read at authorization time; a change to any of them invalidates the decision. |
Fence | The compare-and-swap or epoch the operation is bound to, where it has one. |
Offline | no, queueable, or cached_draft_only. |
CLI
The shipped kovee binary has
6 verbs. This is its own
USAGE string, read out of
crates/kovee-cli/src/main.rs:
kovee hello
kovee init
kovee space create --project <id> --title <t> [--visibility project|restricted]
kovee space show --project <id> <space_id>
kovee space contribute --project <id> --space <id> --text <t> [--kind <kind>]
kovee events --project <id> [--after <cursor>] [--limit <n>]
There is no --help flag: any unrecognised verb prints this block on
stderr and exits 2. Each verb is a thin client — it writes one JSON
command line to the daemon socket and prints the result (or the
problem) it reads back. These are the wire operations each verb
actually sends, in order:
| Verb | Operations sent |
|---|---|
kovee hello | hello |
kovee init | hello, realm_show, project_create |
kovee space create --project <id> --title <t> [--visibility project|restricted] | space_create |
kovee space show --project <id> <space_id> | space_show |
kovee space contribute --project <id> --space <id> --text <t> [--kind <kind>] | space_show, events_read, contribution_append |
kovee events --project <id> [--after <cursor>] [--limit <n>] | events_read |
Defaults, taken from the same source:
--visibilitydefaults toproject.--kinddefaults toutterance.--limitdefaults to100.
Two flags are accepted but not advertised in the usage block:
space create and space contribute both take
--idempotency-key <key>, which replaces the random key the CLI
would otherwise mint — replay the same key and you get the stored result back
rather than a second record.
Envelope schemas
Five schemas describe the envelope every operation shares — the command, its
result, an event, a problem, and the hello exchange. The
per-operation schemas linked from each card below describe only the
args and result payloads inside them.
| Schema | |
|---|---|
kcp-command-result.schema.json | source |
kcp-command.schema.json | source |
kcp-event.schema.json | source |
kcp-hello.schema.json | source |
kcp-problem.schema.json | source |
Problems
A refused command comes back as
{"outcome":"problem","problem":{…}} with a typed
type, a title, and usually a detail line naming the rule that was
broken. The kinds are closed — there are
21 of them, each with
a pinned status:
| Type | Status |
|---|---|
urn:kovee:error:invalid | 422 |
urn:kovee:error:unauthenticated | 401 |
urn:kovee:error:forbidden | 403 |
urn:kovee:error:not-found | 404 |
urn:kovee:error:unsupported-version | 400 |
urn:kovee:error:unknown-op | 400 |
urn:kovee:error:forbidden-surface | 403 |
urn:kovee:error:stale-revision | 409 |
urn:kovee:error:stale-lease | 409 |
urn:kovee:error:idempotency-mismatch | 409 |
urn:kovee:error:idempotency-result-expired | 410 |
urn:kovee:error:authorization-stale | 409 |
urn:kovee:error:budget-exceeded | 409 |
urn:kovee:error:deadline-exceeded | 409 |
urn:kovee:error:cycle | 409 |
urn:kovee:error:cursor-expired | 410 |
urn:kovee:error:snapshot-expired | 410 |
urn:kovee:error:rate-limited | 429 |
urn:kovee:error:ambiguous | 409 |
urn:kovee:error:unavailable | 503 |
urn:kovee:error:internal | 500 |
MCP tools
kovee-mcp binds 14
operations as MCP tools, all on the participant profile — no worker- or
operator-surface operation is ever bound. Each tool's input schema is derived
from the operation's request schema minus the fields the channel already fixes.
Mutations are gated for your harness to prompt on; reads are marked safe to
allow, with one exception whose result carries a live storage credential.
| Tool | Operation | Access |
|---|---|---|
kovee_contribution_append | contribution_append | gated |
kovee_contribution_show | contribution_show | safe to allow |
kovee_contribution_list | contribution_list | safe to allow |
kovee_relation_assert | relation_assert | gated |
kovee_space_show | space_show | safe to allow |
kovee_context_assembly_show | context_assembly_show | safe to allow |
kovee_artifact_upload_begin | artifact_upload_begin | gated |
kovee_artifact_upload_show | artifact_upload_show | safe to allow |
kovee_artifact_upload_credential | artifact_upload_credential | gated |
kovee_artifact_upload_finalize | artifact_upload_finalize | gated |
kovee_artifact_upload_abort | artifact_upload_abort | gated |
kovee_artifact_show | artifact_show | safe to allow |
kovee_events_read | events_read | safe to allow |
kovee_events_wait | events_wait | safe to allow |
Bundles
A bundle is atomic: a client may assume every operation in it, or none. That is
why an incomplete bundle is not advertised even when its operations dispatch —
hello and protocol_info report exactly the bundles
named K1_FEATURE_BUNDLES in
crates/koveed/src/handlers.rs.
| Bundle | Operations | Entries | In hello |
|---|---|---|---|
core_v1 | 3 | 3 | advertised |
shared_space_v1 | 62 | 65 | advertised |
developer_assistant_v1 | 22 | 23 | advertised |
governed_work_binding_v1 | 9 | 9 | not advertised |
governed_work_binding_v1 is the incomplete one. Its operations
dispatch over the socket, but a client that discovers capabilities the
supported way — by reading hello — will not see it, and should
not depend on it.
Operations
core_v1 — 3 operations
KCP diagnose result (derived — gap note KG3)
- Surface
operator- Actor
- principal
- Kind
- query
- Args
checks?- Scope
- installation diagnostics/audit action
- Assurance
- current login
- Dependencies
current_authentication_observation,installation_recovery_epoch,membership,principal_status,realm_status_kill_epoch- Constraints
- realm and role dependencies bind only where the diagnostic is realm-scoped
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (core_v1 row) + §11.6.1 (family: diagnose, audit_export)
KCP hello result (DESIGN.md §11.1)
- Surface
external_client- Actor
- pre-auth channel
- Kind
- query
- Args
supported_versionsimplementationimplementation_versionrequested_features- Scope
- bounded public installation metadata; protocol negotiation only
- Assurance
- none
- Dependencies
- none
- Constraints
- none
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (core_v1 row) + §11.6.1 (family: hello, public protocol_info)
KCP protocol_info result (DESIGN.md §11.1, §11.6.1; derived — gap note KG2)
- Surface
external_client- Actor
- pre-auth channel
- Kind
- query
- Args
- none
- Scope
- bounded public installation metadata; protocol negotiation only
- Assurance
- none
- Dependencies
- none
- Constraints
- none
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (core_v1 row) + §11.6.1 (family: hello, public protocol_info)
shared_space_v1 — 62 operations
KCP artifact_show result (DESIGN.md §10.10, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
artifact_id- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP artifact_upload_abort result (DESIGN.md §10.10, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- mapped connector (only for contribution/reaction/upload operations granted to it), principal
- Kind
- mutation —
metarequired - Args
upload_idreason?- Scope
- exact action and space scope
- Assurance
- current login (principal); workload identity (mapped connector)
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP artifact_upload_begin result (DESIGN.md §10.10, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- mapped connector (only for contribution/reaction/upload operations granted to it), principal
- Kind
- mutation —
metarequired - Args
declared_raw_sha256declared_sizedeclared_media_typeclassification_ref?- Scope
- exact action and space scope
- Assurance
- current login (principal); workload identity (mapped connector)
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP artifact_upload_credential result (DESIGN.md §10.10, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
upload_id- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP artifact_upload_finalize result (DESIGN.md §10.10, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- mapped connector (only for contribution/reaction/upload operations granted to it), principal
- Kind
- mutation —
metarequired - Args
upload_id- Scope
- exact action and space scope
- Assurance
- current login (principal); workload identity (mapped connector)
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP artifact_upload_show result (DESIGN.md §10.10, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
upload_id- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP context_assembly_create result (DESIGN.md §10.8, §14.1, §11.6.1 prepare/propose + worker families)
- Surface
external_client,worker- Actor
- fenced worker (exact listed proposal operation in its capability), principal
- Kind
- mutation —
metarequired - Args
space_idbranch_idaudience_refpurposeselection_policy_refrequired_refs?trigger_refs?recipe_ref?recipe_revision?attempt_id?fence_epoch?- Scope
- assembly; ceilings; current invocation; exact prepare/propose action; fence; output scope; subject digest
- Assurance
- current login; worker capability
- Dependencies
branch_status_frontier,commitment_terms_acceptance,context_item_visibility,service_identity_capability,target_resource_revision- Constraints
- none
- Fence
- current attempt fence; none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: branch fork/freeze/reopen/archive; merge prepare/reject/withdraw; context assembly request; context-recipe mutation; Need/Offer/Formation/amendment/attention preparation and proposal)
KCP context_assembly_show result (DESIGN.md §10.8, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
assembly_id- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP contribution_append result (DESIGN.md §10.2, §10.3, §11.2, §11.6.1 space/content mutation + worker families)
- Surface
external_client,worker- Actor
- invocation attempt only, mapped connector (only for contribution/reaction/upload operations granted to it), principal
- Kind
- mutation —
metarequired - Args
space_idbranch_idexpected_head_digestkindbody_partsschema_ref?subject_refs?source_refs?epistemic_posture?classification_ref?retention_policy_ref?attempt_id?fence_epoch?- Scope
- attempt; budget; exact action and space scope; exact operation and space/object scope listed in the invocation capability; invocation manifest
- Assurance
- current login (principal); workload identity (mapped connector); workload identity plus invocation capability
- Dependencies
branch_status_frontier,classification_retention_policy,context_item_visibility,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- the complete current authorization dependency set is required; this family excludes project status and every prepared access-widening operation
- Fence
- current Kovee fence and byom fence when bound; none
- Offline
no,queueable- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP contribution_list result (DESIGN.md §10.2, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
space_idbranch_id?kind?after?limitsnapshot?- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP contribution_redact result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- principal
- Kind
- mutation —
metarequired - Args
contribution_refreason_class- Scope
- exact action and space scope
- Assurance
- current login; policy may require step-up
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,space_access_participant_binding,target_resource_revision- Constraints
- connector redaction disallowed pending a design amendment (R0 KREG-02 decision); this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP contribution_show result (DESIGN.md §10.2, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
contribution_id- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP contribution_supersede result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- mapped connector (only for contribution/reaction/upload operations granted to it), principal
- Kind
- mutation —
metarequired - Args
contribution_refreplacement_refreason_class- Scope
- exact action and space scope
- Assurance
- current login (principal); workload identity (mapped connector)
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP contribution_withdraw result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- mapped connector (only for contribution/reaction/upload operations granted to it), principal
- Kind
- mutation —
metarequired - Args
contribution_refreason_class- Scope
- exact action and space scope
- Assurance
- current login (principal); workload identity (mapped connector)
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP disclosure_manifest_show result (DESIGN.md §16.2, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
disclosure_id- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP event_payload result (DESIGN.md §11.3, §11.4, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
event_id- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP events_read result (DESIGN.md §11.3, §11.4, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
sourceafter_cursor?project_id?type_prefixes?limit- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP events_wait result (DESIGN.md §11.3, §11.4, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
sourceafter_cursorfilters?timeout_ms- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP frontier_pin result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- principal
- Kind
- mutation —
metarequired - Args
space_idbranch_id- Scope
- exact action and space scope
- Assurance
- current login
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP frontier_show result (DESIGN.md §10.2, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
frontier_id- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP lens_create result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- principal
- Kind
- mutation —
metarequired - Args
space_idkindquery_astsort_specpresentation_optionsvisibility- Scope
- exact action and space scope
- Assurance
- current login
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP lens_list result (DESIGN.md §10.2, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
space_idafter?limitsnapshot?- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP lens_read result (DESIGN.md §10.2, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
lens_idafter?limitsnapshot?- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP lens_revoke result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- principal
- Kind
- mutation —
metarequired - Args
lens_id- Scope
- exact action and space scope
- Assurance
- current login
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP lens_show result (DESIGN.md §10.2, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
lens_id- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP lens_update result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- principal
- Kind
- mutation —
metarequired - Args
lens_idquery_ast?sort_spec?presentation_options?visibility?- Scope
- exact action and space scope
- Assurance
- current login
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
project_access_policy_change_cancel
KCP project_access_policy_change_cancel result (DESIGN.md §10.1, §11.6.1 project access-policy change family)
- Surface
external_client- Actor
- authenticated project owner principal only
- Kind
- mutation —
metarequired - Args
change_id- Scope
- affected Space frontier/item/audience digests; effective-change class; prior/proposed policy/default classification
- Assurance
- current login
- Dependencies
classification_retention_policy,kovee_policy_set,project_status_revision- Constraints
- none
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project_access_policy_change_prepare, project_access_policy_change_cancel, project_access_policy_change_confirm)
project_access_policy_change_confirm
KCP project_access_policy_change_confirm result (DESIGN.md §10.1, §11.6.1 project access-policy change family)
- Surface
external_client- Actor
- authenticated project owner principal only
- Kind
- mutation —
metarequired - Args
change_iddecision_receipt_ref- Scope
- affected Space frontier/item/audience digests; authorization decision receipt; effective-change class; prior/proposed policy/default classification
- Assurance
- risk-required step-up
- Dependencies
classification_retention_policy,kovee_policy_set,project_status_revision- Constraints
- none
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project_access_policy_change_prepare, project_access_policy_change_cancel, project_access_policy_change_confirm)
project_access_policy_change_list
KCP project_access_policy_change_list result (DESIGN.md §10.1, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
after?limitsnapshot?- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
project_access_policy_change_prepare
KCP project_access_policy_change_prepare result (DESIGN.md §10.1, §11.6.1 project access-policy change family)
- Surface
external_client- Actor
- authenticated project owner principal only
- Kind
- mutation —
metarequired - Args
proposed_policy_set_ref?proposed_default_classification_ref?- Scope
- affected Space frontier/item/audience digests; effective-change class; prior/proposed policy/default classification
- Assurance
- current login
- Dependencies
classification_retention_policy,kovee_policy_set,project_status_revision- Constraints
- none
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project_access_policy_change_prepare, project_access_policy_change_cancel, project_access_policy_change_confirm)
project_access_policy_change_show
KCP project_access_policy_change_show result (DESIGN.md §10.1, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
change_id- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP project_create result (DESIGN.md §10.1, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- principal
- Kind
- mutation —
metarequired - Args
namedefault_classification_ref?policy_set_ref?- Scope
- exact action and space scope
- Assurance
- current login
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP project_list result (DESIGN.md §10.1, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
after?limitsnapshot?- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP project_show result (DESIGN.md §10.1, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
- none
- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP project_update_metadata result (DESIGN.md §10.1, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- principal
- Kind
- mutation —
metarequired - Args
name- Scope
- exact action and space scope
- Assurance
- current login
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP reaction_set result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- mapped connector (only for contribution/reaction/upload operations granted to it), principal
- Kind
- mutation —
metarequired - Args
space_idtarget_reftarget_revisiontarget_digestkeystate- Scope
- exact action and space scope
- Assurance
- current login (principal); workload identity (mapped connector)
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
queueable- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP realm_show result (DESIGN.md §10.1, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
- none
- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP relation_assert result (DESIGN.md §10.2, §10.3, §11.6.1 space/content mutation + worker families)
- Surface
external_client,worker- Actor
- invocation attempt only, principal
- Kind
- mutation —
metarequired - Args
space_idbranch_idexpected_head_digestkindfrom_refto_refrationale_ref?schema_ref?attempt_id?fence_epoch?- Scope
- attempt; budget; exact action and space scope; exact operation and space/object scope listed in the invocation capability; invocation manifest
- Assurance
- current login; workload identity plus invocation capability
- Dependencies
branch_status_frontier,classification_retention_policy,context_item_visibility,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- the complete current authorization dependency set is required; this family excludes project status and every prepared access-widening operation
- Fence
- current Kovee fence and byom fence when bound; none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP relation_retract result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- principal
- Kind
- mutation —
metarequired - Args
relation_refreason_class- Scope
- exact action and space scope
- Assurance
- current login
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP snapshot_read result (DESIGN.md §11.5, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
sourceafter?limitsnapshot?- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP space_access_grant_create result (DESIGN.md §10.2, §11.6.1 operator administration family)
- Surface
operator- Actor
- principal only
- Kind
- mutation —
metarequired - Args
space_idsubject_refallowed_actionsclassification_ceiling_ref?expires_at?- Scope
- exact administrative/governance action; prepared subject digest
- Assurance
- current step-up observation at risk-required level
- Dependencies
classification_retention_policy,current_authentication_observation,kovee_policy_set,membership,principal_status,project_status_revision,realm_authority_binding,realm_status_kill_epoch,remaining_use_grant,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes access-widening confirms and handoff-transfer reconciliation
- Fence
- none; cannot impersonate a worker
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: force-cancel, realm/binding, project-status, identity/membership, invitation/join, space-access-grant administration, classification mapping, artifact grant, handoff offer/admission decisions, effect authorization/reconciliation)
KCP space_access_grant_list result (DESIGN.md §10.2, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
space_idafter?limitsnapshot?- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP space_access_grant_revoke result (DESIGN.md §10.2, §11.6.1 operator administration family)
- Surface
operator- Actor
- principal only
- Kind
- mutation —
metarequired - Args
space_access_id- Scope
- exact administrative/governance action; prepared subject digest
- Assurance
- current step-up observation at risk-required level
- Dependencies
classification_retention_policy,current_authentication_observation,kovee_policy_set,membership,principal_status,project_status_revision,realm_authority_binding,realm_status_kill_epoch,remaining_use_grant,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes access-widening confirms and handoff-transfer reconciliation
- Fence
- none; cannot impersonate a worker
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: force-cancel, realm/binding, project-status, identity/membership, invitation/join, space-access-grant administration, classification mapping, artifact grant, handoff offer/admission decisions, effect authorization/reconciliation)
KCP space_access_widen_cancel result (DESIGN.md §10.2, §11.6.1 access-widening prepare family)
- Surface
external_client- Actor
- authenticated steward/owner principal
- Kind
- mutation —
metarequired - Args
widening_id- Scope
- affected frontier/item/audience digests; prior/proposed visibility/policy/classification
- Assurance
- current login
- Dependencies
classification_retention_policy,context_item_visibility,contribution_relation_endpoint_visibility,kovee_policy_set,membership,space_access_participant_binding,target_resource_revision- Constraints
- none
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: space_access_widen_prepare, space_access_widen_cancel)
KCP space_access_widen_confirm result (DESIGN.md §10.2, §11.6.1 access-widening confirm family)
- Surface
external_client- Actor
- authenticated steward/owner principal only
- Kind
- mutation —
metarequired - Args
widening_iddecision_receipt_ref- Scope
- authorization decision receipt; exact prepared widening subject
- Assurance
- risk-required current step-up
- Dependencies
target_resource_revision- Constraints
- item-level policies remain intersected
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: space_access_widen_confirm)
KCP space_access_widen_list result (DESIGN.md §10.2, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
space_id?after?limitsnapshot?- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP space_access_widen_prepare result (DESIGN.md §10.2, §11.6.1 access-widening prepare family)
- Surface
external_client- Actor
- authenticated steward/owner principal
- Kind
- mutation —
metarequired - Args
space_idproposed_visibility?proposed_policy_set_ref?proposed_default_classification_ref?- Scope
- affected frontier/item/audience digests; prior/proposed visibility/policy/classification
- Assurance
- current login; policy may require step-up
- Dependencies
classification_retention_policy,context_item_visibility,contribution_relation_endpoint_visibility,kovee_policy_set,membership,space_access_participant_binding,target_resource_revision- Constraints
- none
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: space_access_widen_prepare, space_access_widen_cancel)
KCP space_access_widen_show result (DESIGN.md §10.2, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
widening_id- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP space_archive result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- principal
- Kind
- mutation —
metarequired - Args
space_id- Scope
- exact action and space scope
- Assurance
- current login
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP space_create result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- principal
- Kind
- mutation —
metarequired - Args
titlevisibilitypurpose_contribution_ref?default_classification_ref?policy_set_ref?- Scope
- exact action and space scope
- Assurance
- current login
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP space_freeze result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- principal
- Kind
- mutation —
metarequired - Args
space_id- Scope
- exact action and space scope
- Assurance
- current login
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP space_list result (DESIGN.md §10.2, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
after?limitsnapshot?- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP space_participant_activate result (DESIGN.md §10.2, §11.6.1 activation family)
- Surface
operator- Actor
- authenticated principal, narrow policy service consuming an exact active standing-policy/contract receipt
- Kind
- mutation —
metarequired - Args
participant_idsubject_digest- Scope
- budget/disclosure union; exact prepared subject digest
- Assurance
- current assurance required by policy
- Dependencies
attention_revision_acceptance,branch_status_frontier,commitment_terms_acceptance,remaining_use_grant,target_resource_revision- Constraints
- the complete current dependency set is required
- Fence
- none; never model prose or a worker self-decision
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: attention accept/decline/resume/widen/candidate-activate/replay-start; merge acceptance; Commitment/Need review; participant activation)
KCP space_participant_add result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- principal
- Kind
- mutation —
metarequired - Args
space_idsubject_refkindrolesubject_revision?- Scope
- exact action and space scope
- Assurance
- current login
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP space_participant_list result (DESIGN.md §10.2, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
space_idafter?limitsnapshot?- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP space_participant_remove result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- principal
- Kind
- mutation —
metarequired - Args
participant_id- Scope
- exact action and space scope
- Assurance
- current login
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP space_participant_update result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- principal
- Kind
- mutation —
metarequired - Args
participant_idrole?status?- Scope
- exact action and space scope
- Assurance
- current login
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP space_policy_narrow result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- principal
- Kind
- mutation —
metarequired - Args
space_idpolicy_set_ref?default_classification_ref?- Scope
- exact action and space scope
- Assurance
- current login
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP space_reopen result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- principal
- Kind
- mutation —
metarequired - Args
space_id- Scope
- exact action and space scope
- Assurance
- current login
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP space_restrict result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- principal
- Kind
- mutation —
metarequired - Args
space_id- Scope
- exact action and space scope
- Assurance
- current login
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
KCP space_show result (DESIGN.md §10.2, §11.6.1 read family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
space_id- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP space_update_metadata result (DESIGN.md §10.2, §11.6.1 space/content mutation family)
- Surface
external_client- Actor
- principal
- Kind
- mutation —
metarequired - Args
space_idtitle?purpose_contribution_ref?- Scope
- exact action and space scope
- Assurance
- current login
- Dependencies
branch_status_frontier,classification_retention_policy,contribution_relation_endpoint_visibility,kovee_policy_set,membership,principal_status,space_access_participant_binding,target_resource_revision- Constraints
- this family excludes project status and every prepared access-widening operation
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (shared_space_v1 row) + §11.6.1 (family: project/Space creation and metadata; Space lifecycle/restrict/policy-narrow; participant proposal/update/removal; contribution/disposition; semantic-relation/disposition; lens, reaction, frontier, and artifact-upload mutations)
developer_assistant_v1 — 22 operations
KCP application_event_emit result (DESIGN.md §11.3; derived — gap note KG15)
- Surface
worker- Actor
- invocation attempt only
- Kind
- mutation —
metarequired - Args
attempt_idfence_epochtypepayload- Scope
- attempt; budget; exact operation and space/object scope listed in the invocation capability; invocation manifest
- Assurance
- workload identity plus invocation capability
- Dependencies
branch_status_frontier,context_item_visibility,kovee_policy_set,service_identity_capability,target_resource_revision- Constraints
- the complete current authorization dependency set is required
- Fence
- current Kovee fence and byom fence when bound
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: checkpoint/contribution/semantic-relation/model/tool/application_event_emit worker operations)
KCP assistant_alias_bind result (DESIGN.md §10.5, §11.6.1 assistant author/deploy family)
- Surface
operator- Actor
- principal
- Kind
- mutation —
metarequired - Args
display_aliasassistant_deployment_iddeployment_revision- Scope
- exact author/deploy action
- Assurance
- current login
- Dependencies
kovee_policy_set,membership,principal_status,project_status_revision,realm_status_kill_epoch,target_resource_revision- Constraints
- none
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: assistant definition/revision/deployment/alias mutations)
KCP assistant_alias_list result (DESIGN.md §10.5, §11.6.1 assistant author/deploy family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
after?limitsnapshot?assistant_deployment_id?- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP assistant_alias_revoke result (DESIGN.md §10.5, §11.6.1 assistant author/deploy family)
- Surface
operator- Actor
- principal
- Kind
- mutation —
metarequired - Args
alias_binding_id- Scope
- exact author/deploy action
- Assurance
- current login
- Dependencies
kovee_policy_set,membership,principal_status,project_status_revision,realm_status_kill_epoch,target_resource_revision- Constraints
- none
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: assistant definition/revision/deployment/alias mutations)
KCP assistant_alias_show result (DESIGN.md §10.5, §11.6.1 assistant author/deploy family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
alias_binding_id- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP assistant_alias_update result (DESIGN.md §10.5, §11.6.1 assistant author/deploy family)
- Surface
operator- Actor
- principal
- Kind
- mutation —
metarequired - Args
alias_binding_idassistant_deployment_iddeployment_revision- Scope
- exact author/deploy action
- Assurance
- current login
- Dependencies
kovee_policy_set,membership,principal_status,project_status_revision,realm_status_kill_epoch,target_resource_revision- Constraints
- none
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: assistant definition/revision/deployment/alias mutations)
KCP assistant_create result (DESIGN.md §10.5, §11.6.1 assistant author/deploy family)
- Surface
operator- Actor
- principal
- Kind
- mutation —
metarequired - Args
namedescription- Scope
- exact author/deploy action
- Assurance
- current login
- Dependencies
kovee_policy_set,membership,principal_status,project_status_revision,realm_status_kill_epoch,target_resource_revision- Constraints
- none
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: assistant definition/revision/deployment/alias mutations)
KCP assistant_list result (DESIGN.md §10.5, §11.6.1 assistant author/deploy family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
after?limitsnapshot?- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP assistant_revision_list result (DESIGN.md §10.5, §11.6.1 assistant author/deploy family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
after?limitsnapshot?definition_id?- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP assistant_revision_register result (DESIGN.md §10.5, §11.6.1 assistant author/deploy family)
- Surface
operator- Actor
- principal
- Kind
- mutation —
metarequired - Args
definition_idversionmanifestpackage_artifact_refpackage_digestconfig_schema_digestsdk_protocol_rangesignature_refs?- Scope
- exact author/deploy action
- Assurance
- current login
- Dependencies
kovee_policy_set,membership,principal_status,project_status_revision,realm_status_kill_epoch,target_resource_revision- Constraints
- none
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: assistant definition/revision/deployment/alias mutations)
KCP assistant_revision_show result (DESIGN.md §10.5, §11.6.1 assistant author/deploy family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
assistant_revision_id- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP assistant_show result (DESIGN.md §10.5, §11.6.1 assistant author/deploy family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
definition_id- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP deployment_activate result (DESIGN.md §10.5, §11.6.1 assistant author/deploy family)
- Surface
operator- Actor
- principal
- Kind
- mutation —
metarequired - Args
assistant_deployment_id- Scope
- exact author/deploy action
- Assurance
- current login; step-up for production activation
- Dependencies
kovee_policy_set,membership,principal_status,project_status_revision,realm_status_kill_epoch,target_resource_revision- Constraints
- none
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: assistant definition/revision/deployment/alias mutations)
KCP deployment_create result (DESIGN.md §10.5, §11.6.1 assistant author/deploy family)
- Surface
operator- Actor
- principal
- Kind
- mutation —
metarequired - Args
assistant_revision_idconfig_refconfig_digestsecret_binding_set_refsecret_binding_set_digestpolicy_refpool_refsecurity_profileconcurrency_policyrollout_policy- Scope
- exact author/deploy action
- Assurance
- current login
- Dependencies
kovee_policy_set,membership,principal_status,project_status_revision,realm_status_kill_epoch,target_resource_revision- Constraints
- none
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: assistant definition/revision/deployment/alias mutations)
KCP deployment_drain result (DESIGN.md §10.5, §11.6.1 assistant author/deploy family)
- Surface
operator- Actor
- principal
- Kind
- mutation —
metarequired - Args
assistant_deployment_id- Scope
- exact author/deploy action
- Assurance
- current login
- Dependencies
kovee_policy_set,membership,principal_status,project_status_revision,realm_status_kill_epoch,target_resource_revision- Constraints
- none
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: assistant definition/revision/deployment/alias mutations)
KCP deployment_list result (DESIGN.md §10.5, §11.6.1 assistant author/deploy family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
after?limitsnapshot?assistant_revision_id?- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP deployment_show result (DESIGN.md §10.5, §11.6.1 assistant author/deploy family)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
assistant_deployment_id- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP invocation_cancel result (DESIGN.md §10.6)
- Surface
external_client,worker- Actor
- authenticated creator or authorized principal, current attempt (own exact child invocation under an explicit parent capability)
- Kind
- mutation —
metarequired - Args
invocation_idcancellation_scope?reason?attempt_id?fence_epoch?- Scope
- ancestry; cancellation scope; inherited ceilings; parent attempt binding
- Assurance
- current login; worker capability
- Dependencies
commitment_terms_acceptance,service_identity_capability,target_resource_revision- Constraints
- none
- Fence
- current attempt fence, plus byom fence when bound; none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: Invocation, Commitment, and WorkRealization cancel)
KCP invocation_create result (DESIGN.md §10.6)
- Surface
external_client- Actor
- authenticated operator, authenticated principal
- Kind
- mutation —
metarequired - Args
assistant_deployment_idassistant_deployment_revisionspace_id?branch_id?context_assembly_ref?context_assembly_digest?budget_reservation_set_ref?disclosure_rules_digest?priority?not_before?max_attempts?deadline- Scope
- ContextAssembly/input manifest; budget; disclosure; exact manual/deployment-test create action
- Assurance
- current login; production test may require step-up
- Dependencies
context_item_visibility,kovee_policy_set,target_resource_revision- Constraints
- cannot name a worker as requester or create a Commitment; the complete current authorization dependency set is required
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: direct invocation)
KCP invocation_list result (DESIGN.md §10.6)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
after?limitsnapshot?assistant_deployment_id?space_id?state?- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP invocation_show result (DESIGN.md §10.6)
- Surface
external_client- Actor
- connector service (only for its mapped resources), principal
- Kind
- query
- Args
invocation_id- Scope
- exact resource read/resume action; resume cursor where applicable
- Assurance
- current login or workload identity
- Dependencies
classification_retention_policy,contribution_relation_endpoint_visibility,external_visibility_proof,membership,principal_status,project_status_revision,realm_status_kill_epoch,service_identity_capability,space_access_participant_binding,target_resource_revision- Constraints
- external visibility proof required only where the target carries external-sourced material
- Fence
- none
- Offline
cached_draft_only- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: *_show, *_list, lens_read, events_read, events_wait, event_payload, snapshot_read, presence_list, realtime_resume, artifact_upload_credential)
KCP model_complete result (DESIGN.md §16.1-§16.3; derived)
- Surface
worker- Actor
- invocation attempt only
- Kind
- mutation —
metarequired - Args
attempt_idfence_epochmodel_profile_refpurpose_refclassification_refpromptsystem?max_output_tokensstable_binding_key?act_intent_refact_intent_digestact_revisionsubject_digestcontext_manifest_refcontext_manifest_digeststable_execution_keybudget_reservation_set_ref- Scope
- budget; exact model call through ONE logical ModelProfile named by the invocation capability; invocation manifest, attempt, and the exact DisclosureManifest the ProviderContextManifest chain seals; the byom model_egress ActIntent whose one-shot ExecutionConsumptionReceipt the broker must hold before egress; the destination is that profile's ModelProviderBinding endpoint; a worker cannot name a provider, host, URL, header, or credential
- Assurance
- workload identity plus invocation capability
- Dependencies
classification_retention_policy,context_item_visibility,kovee_policy_set,realm_authority_binding,remaining_use_grant,service_identity_capability,target_resource_revision- Constraints
- credentials never enter workers, events, or portable manifests: credential_secret_ref lives only on the ModelProviderBinding and resolves inside the broker; no egress without a valid byom ExecutionConsumptionReceipt (max_uses 1) for this effect's exact stable_execution_key: the act chain is byom's and Kovee only consumes the permit; the act refs a worker presents are CLAIMS, never authority: byomd re-derives intent/subject/disclosure digests, both fences, and the driver audience inside execution_permit_consume, and the permit-channel token is byomd's own file keyed to that act; the complete current authorization dependency set is required; the prepared Effect and the dispatching EffectAttempt are each committed before the next step; an attempt left dispatching resolves to ambiguous and is never auto-retried
- Fence
- current Kovee invocation fence and the byom Episode fence when bound; both are re-presented to byomd (family contract L21)
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (developer_assistant_v1 row) + §11.6.1 (family: checkpoint/contribution/semantic-relation/model/tool/application_event_emit worker operations) + §16.1-§16.3 (effect lifecycle, disclosure manifest, model broker) + byom/DESIGN.md §13.1-§13.3 (the model-egress act chain and execution_permit_consume) + byom/spec/governed-work/provider-context-manifest-byom-fields.schema.json
governed_work_binding_v1 — 9 operations
KCP byom_episode_binding_show result
- Surface
operator- Actor
- human realm-owner principal only
- Kind
- query
- Args
stable_binding_key?episode_ref?- Scope
- both fence epochs (byom_fence_epoch and kovee_invocation_fence) per row; exact hosted-Episode binding read over the realm's ByomEpisodeBinding rows; retained fenced rows for audit and orphan-result diagnostics
- Assurance
- current login
- Dependencies
current_authentication_observation,external_visibility_proof,principal_status,realm_authority_binding,realm_status_kill_epoch,target_resource_revision- Constraints
- a human realm-owner principal only — never a service identity, session, assistant, or connector; personal-mode bootstrap is owner-only over the UID-checked local socket; a read: it never binds, fences, releases, or advances an Episode; the Episode/EpisodeLease lifecycle is byom-owned and referenced, never re-owned; recovery-only service authority: a service may query saga state (external_command_result_query pattern), never submit, terminalize, modify, or impersonate the original human (R42)
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (governed_work_binding_v1 row) + design/2026-07-25-amendment-governance-owner.md §A5 (wire-name resolution) + byom/DESIGN.md §16.6 item 3 + byom/spec/descriptors/byom-episode-binding.json
KCP endeavor_promotion_cancel result (the released pair)
- Surface
operator- Actor
- human realm-owner principal only
- Kind
- mutation —
metarequired - Args
formation_idreason- Scope
- exact pre-send cancel over one prepared intent with a still-held slot; the recorded cancel reason
- Assurance
- explicit confirmation in personal mode; fresh step-up/challenge in team mode
- Dependencies
authentication_binding_security_epoch,current_authentication_observation,external_visibility_proof,installation_recovery_epoch,principal_status,realm_authority_binding,realm_status_kill_epoch,target_resource_revision- Constraints
- a human realm-owner principal only — never a service identity, session, assistant, or connector; personal-mode bootstrap is owner-only over the UID-checked local socket; after bytes may have left Kovee, cancel is not a row of this machine and the slot has no timeout-based release; recovery-only service authority: a service may query saga state (external_command_result_query pattern), never submit, terminalize, modify, or impersonate the original human (R42); the ONE pre-send release: the local cancel must durably precede the first send (byom §16.3 table row 1)
- Fence
- paired intent/slot CAS under the slot generation; slot released with released_at set
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (governed_work_binding_v1 row) + design/2026-07-25-amendment-governance-owner.md §A5 (wire-name resolution) + byom/DESIGN.md §16.3 (the frozen EndeavorFormationIntent/Slot/Attempt machine and the five-fact ExternalCommandResultQuery union) + byom/spec/descriptors/endeavor-formation.json
KCP endeavor_promotion_prepare result (the durable intent/slot pair)
- Surface
operator- Actor
- human realm-owner principal only
- Kind
- mutation —
metarequired - Args
byom_endpoint_refsociety_reffrontier_refcollaboration_context_bundle_refbound_participant_refparticipant_binding_epochclient_formation_keyendeavor_proposal_refendeavor_proposalsource_principal_position- Scope
- byomd endpoint identity and incarnation, read from the active binding; exact formation-preparation action over one client_formation_key; target society_ref and Society recovery epoch, read from the active mapping; the exact IdempotencyDomain digest and byom command idempotency key; the pinned SpaceFrontier and the ContextAssembly taken at it; the stable KoveeEndeavorFormCommand bytes and their canonical command digest
- Assurance
- explicit confirmation in personal mode; fresh step-up/challenge in team mode
- Dependencies
authentication_binding_security_epoch,branch_status_frontier,context_item_visibility,current_authentication_observation,external_visibility_proof,installation_recovery_epoch,principal_status,realm_authority_binding,realm_status_kill_epoch,target_resource_revision- Constraints
- UNIQUE(realm_id, requested_by_principal, client_formation_key) deduplicates one explicit human formation command; it does not imply one Endeavor per Branch, frontier, purpose, or Society (byom §16.3); a human realm-owner principal only — never a service identity, session, assistant, or connector; personal-mode bootstrap is owner-only over the UID-checked local socket; no external contact at all: every byom fact the intent pins is read from the ACTIVE KoveeRealmByomBinding/KoveeSocietyMapping, never asserted by the caller; recovery-only service authority: a service may query saga state (external_command_result_query pattern), never submit, terminalize, modify, or impersonate the original human (R42); the context bundle must be assembled AT the pinned frontier
- Fence
- paired intent/slot create under slot generation 1; an exact retry of the same client_formation_key returns the identical pair
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (governed_work_binding_v1 row) + design/2026-07-25-amendment-governance-owner.md §A5 (wire-name resolution) + byom/DESIGN.md §16.3 (the frozen EndeavorFormationIntent/Slot/Attempt machine and the five-fact ExternalCommandResultQuery union) + byom/spec/descriptors/endeavor-formation.json
KCP endeavor_promotion_reconcile result (the promotion after the verified fact)
- Surface
operator- Actor
- human realm-owner principal only
- Kind
- mutation —
metarequired - Args
formation_idterminalize?authentication_observation_ref?reason?- Scope
- exact recovery action over one non-terminal intent; optionally external_command_terminalize over the exact original domain and command bytes, same source human, freshly authenticated through the current recovery binding (R40); the read-only external_command_result_query against the exact IdempotencyDomain and canonical command digest (R42)
- Assurance
- always step-up
- Dependencies
authentication_binding_security_epoch,current_authentication_observation,external_visibility_proof,installation_recovery_epoch,principal_status,realm_authority_binding,realm_status_kill_epoch,target_resource_revision- Constraints
- a human realm-owner principal only — never a service identity, session, assistant, or connector; personal-mode bootstrap is owner-only over the UID-checked local socket; exactly one of five facts drives exactly one row; a verified live `absent` never releases the slot and `unknown` is a conservative hold, never a guess; missing or incomplete RestoreLineage is unknown, never live absent; recovery-only service authority: a service may query saga state (external_command_result_query pattern), never submit, terminalize, modify, or impersonate the original human (R42); terminalization exists exactly where the descriptor's tombstone_verified row does — any state whose outcome is still ambiguous, never one with a verified committed result — and only for the same source human freshly authenticated through the current recovery binding; another principal, service, controller, or successor Participant cannot terminalize; the query is read-only: it cannot submit, terminalize, modify, or impersonate the original human (R42), and it rides the narrow byomd recovery workload, never the delegated-principal credential
- Fence
- paired intent/slot CAS under the slot generation per verified fact; the slot is released only by a verified non-reexecuting tombstone, a verified historically_fenced_absent, or the committed ExternalLink
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (governed_work_binding_v1 row) + design/2026-07-25-amendment-governance-owner.md §A5 (wire-name resolution) + byom/DESIGN.md §16.3 (the frozen EndeavorFormationIntent/Slot/Attempt machine and the five-fact ExternalCommandResultQuery union) + byom/spec/descriptors/endeavor-formation.json
KCP endeavor_promotion_show result
- Surface
operator- Actor
- human realm-owner principal only
- Kind
- query
- Args
formation_id?- Scope
- exact formation-state read over the realm's intents, slots, attempts, and external links; recorded saga state and slot generation (query-first restore resolution)
- Assurance
- current login
- Dependencies
current_authentication_observation,external_visibility_proof,principal_status,realm_authority_binding,realm_status_kill_epoch,target_resource_revision- Constraints
- a human realm-owner principal only — never a service identity, session, assistant, or connector; personal-mode bootstrap is owner-only over the UID-checked local socket; a read: it never prepares, submits, cancels, reconciles, or terminalizes, and makes no byom call at all; recovery-only service authority: a service may query saga state (external_command_result_query pattern), never submit, terminalize, modify, or impersonate the original human (R42)
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (governed_work_binding_v1 row) + design/2026-07-25-amendment-governance-owner.md §A5 (wire-name resolution) + byom/DESIGN.md §16.3 (the frozen EndeavorFormationIntent/Slot/Attempt machine and the five-fact ExternalCommandResultQuery union) + byom/spec/descriptors/endeavor-formation.json
KCP endeavor_promotion_start result (the promotion after the send)
- Surface
operator- Actor
- human realm-owner principal only
- Kind
- mutation —
metarequired - Args
formation_idauthentication_observation_ref- Scope
- exact formation-submission action over one prepared or awaiting_principal intent; one fresh EndeavorFormationAttempt: nonce, recovery-binding quadruple, authentication observation, and attempt proof; the minted DelegatedPrincipalCredential's (issuer_ref, nonce) consume pair; the unchanged stable command bytes and their canonical command digest
- Assurance
- always step-up
- Dependencies
authentication_binding_security_epoch,current_authentication_observation,external_visibility_proof,installation_recovery_epoch,principal_status,realm_authority_binding,realm_status_kill_epoch,target_resource_revision- Constraints
- a fresh human authentication attempt per send: reusing the previous attempt's observation is refused (byom §16.3 table row 2); a human realm-owner principal only — never a service identity, session, assistant, or connector; personal-mode bootstrap is owner-only over the UID-checked local socket; recovery-only service authority: a service may query saga state (external_command_result_query pattern), never submit, terminalize, modify, or impersonate the original human (R42); source-qualified human via the exact Kovee delegated-principal channel, personally filling the sole computed formation seat (R39); it never bootstraps a Society and never manufactures membership; the command endpoint incarnation and Society recovery epoch must still be active; binding rotation fences the send and never releases the slot; the pair moves to submitting and COMMITS before any byte leaves Kovee
- Fence
- paired intent/slot CAS under the slot generation at the read revision; one immutable attempt per send, UNIQUE(formation_id, attempt_ordinal) and UNIQUE(attempt_nonce); a lost reply becomes remote_unknown and never releases the slot
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (governed_work_binding_v1 row) + design/2026-07-25-amendment-governance-owner.md §A5 (wire-name resolution) + byom/DESIGN.md §16.3 (the frozen EndeavorFormationIntent/Slot/Attempt machine and the five-fact ExternalCommandResultQuery union) + byom/spec/descriptors/endeavor-formation.json
KCP governance_disable result (greenfield-saga §4)
- Surface
operator- Actor
- human realm-owner principal only
- Kind
- mutation —
metarequired - Args
binding_refexpected_owner_revisionconfirmed_subject_digest- Scope
- canonical subject digest the confirming human sees; exact governance-disable action over one active owner binding; exact scope selector and digest, binding epoch, and expected owner-binding revision
- Assurance
- always step-up
- Dependencies
current_authentication_observation,external_visibility_proof,principal_status,realm_authority_binding,realm_status_kill_epoch,target_resource_revision- Constraints
- a human realm-owner principal only — never a service identity, session, assistant, or connector; personal-mode bootstrap is owner-only over the UID-checked local socket and cannot bind an arbitrary endpoint or map another principal; freezes the owner row (status active→frozen) with the owner arm retained for audit and invalidates derived channels and permits; re-enablement is a fresh saga row under a new binding epoch, not a transition of this machine; recovery-only service authority: a service may query saga state (external_command_result_query pattern), never create or activate a binding
- Fence
- owner-binding CAS at the expected revision under the active binding epoch
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (governed_work_binding_v1 row) + design/2026-07-25-amendment-governance-owner.md §A5 (wire-name resolution) + byom/design/2026-07-25-family-contract.md §2.A (the frozen governance_enable authority row, field-complete) + byom/spec/governed-work/greenfield-saga.md (D10)
KCP governance_enable result (D10 greenfield enablement saga)
- Surface
operator- Actor
- human realm-owner principal only
- Kind
- mutation —
metarequired - Args
byom_endpoint_refsociety_refexact_scope_selectorallowed_project_and_space_selectorsclassification_binding_refexpected_owner_revisionexpected_binding_ref?confirmed_subject_digest?- Scope
- KoveeSocietyMapping revision; byomd endpoint identity and incarnation; canonical subject digest over the (realm, society_ref, recovery epoch, byom endpoint, mapping revision, owner-binding transition none→byom) tuple — the exact digest the confirming human sees; exact greenfield-enablement action over one exact governed scope; expected absent-or-identical KoveeRealmByomBinding; target society_ref and Society recovery epoch
- Assurance
- explicit confirmation in personal mode; fresh step-up/challenge in team mode
- Dependencies
current_authentication_observation,external_visibility_proof,principal_status,realm_authority_binding,realm_status_kill_epoch,target_resource_revision- Constraints
- Kovee is never the genesis governance actor: an already-active Society established by native society_prepare/society_bootstrap is required and is verified by a byomd projection read; Kovee may start/configure/bind byomd and supply inert context only (amendment A2); a human realm-owner principal only — never a service identity, session, assistant, or connector; personal-mode bootstrap is owner-only over the UID-checked local socket and cannot bind an arbitrary endpoint or map another principal; no overlapping scope selector may hold an active owner binding or a pending enablement past step 1 (byom §16.6 item 1); rejection precedes creating anything; recovery-only service authority: a service may query saga state (external_command_result_query pattern), never create or activate a binding
- Fence
- binding epoch CAS at the expected KoveeGovernanceOwnerBinding revision; overlap rejected; retry returns the identical binding; rollback-before-activation spends the epoch; restore behavior per the D10 saga
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (governed_work_binding_v1 row) + design/2026-07-25-amendment-governance-owner.md §A5 (wire-name resolution) + byom/design/2026-07-25-family-contract.md §2.A (the frozen governance_enable authority row, field-complete) + byom/spec/governed-work/greenfield-saga.md (D10)
KCP governance_show result (D10 greenfield enablement saga state)
- Surface
operator- Actor
- human realm-owner principal only
- Kind
- query
- Args
binding_ref?- Scope
- exact governance-state read over the realm's bindings, mappings, owner rows, and enablement saga slots; recorded saga state and binding epoch (query-first restore resolution)
- Assurance
- current login
- Dependencies
current_authentication_observation,external_visibility_proof,principal_status,realm_authority_binding,realm_status_kill_epoch,target_resource_revision- Constraints
- a human realm-owner principal only — never a service identity, session, assistant, or connector; personal-mode bootstrap is owner-only over the UID-checked local socket and cannot bind an arbitrary endpoint or map another principal; a read: it never creates, activates, rolls back, or freezes a binding; recovery-only service authority: a service may query saga state (external_command_result_query pattern), never create or activate a binding
- Fence
- none
- Offline
no- Schemas
- request · result
- Source
- DESIGN.md §11.6 (governed_work_binding_v1 row) + design/2026-07-25-amendment-governance-owner.md §A5 (wire-name resolution) + byom/design/2026-07-25-family-contract.md §2.A (the frozen governance_enable authority row, field-complete) + byom/spec/governed-work/greenfield-saga.md (D10)