Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
94 commits
Select commit Hold shift + click to select a range
bf82ee4
P0 RFC-001: conformance lock + plan v4.1.1 + baseline counts
Qingbolan Apr 26, 2026
f986c61
P0 RFC-001: conformance test infrastructure
Qingbolan Apr 26, 2026
f35ab1d
P1.1 RFC-001: Full RPC Restatement Mapping (all 150 RPCs)
Qingbolan Apr 26, 2026
f1c25d9
P1.2.a RFC-001: delete interop.proto entirely; stub MCP/A2A call sites
Qingbolan Apr 26, 2026
9ffd775
P1.2.b RFC-001: delete RegisterNode + Heartbeat from control.proto
Qingbolan Apr 26, 2026
8f161fd
P1.2.c RFC-001: collapse remaining 12 control.proto RPCs
Qingbolan Apr 26, 2026
c6df9e0
P1.2.d RFC-001: collapse identity / policy / admin / observe protos (…
Qingbolan Apr 26, 2026
d921273
P1.2.e RFC-001: collapse federation/capability/mission/state_sync (45…
Qingbolan Apr 26, 2026
4c41557
P1.2.f RFC-001: collapse stream + voice protos (23 RPCs)
Qingbolan Apr 26, 2026
24bbaf0
P1.2.g RFC-001: collapse invoke.proto to Invoke + InvokeStream only
Qingbolan Apr 26, 2026
52ef851
P1.2.h RFC-001: clean up tests for removed RPCs
Qingbolan Apr 26, 2026
48f986c
P1.2.i RFC-001: P1.2 final — baseline updated, conformance verified
Qingbolan Apr 26, 2026
4a6a1a9
P1.5 RFC-001: collapse sdk/rust to Invoke + InvokeStream + Close
Qingbolan Apr 26, 2026
72b15f5
P3.1: wire §A6 Membership layer into Invoke admission gate
Qingbolan Apr 26, 2026
cd50b86
P3.2: agents catalog (RealmDirectory) backs membership lookup
Qingbolan Apr 26, 2026
fd0c8fa
P3.3: hub-profile in-process Agent (federation.* abilities)
Qingbolan Apr 26, 2026
e231903
P3.4 (axon): membership + hub-profile run unconditionally; e2e tests
Qingbolan Apr 26, 2026
5927568
P5.0: federation.advertise_abilities + descriptor storage in hub-profile
Qingbolan Apr 26, 2026
834732f
P5.6.a: federation.revoke handler in hub-profile
Qingbolan Apr 26, 2026
d3376ec
P5-fix-1: axon admission verifies DelegationProof (closes §A14 loop)
Qingbolan Apr 26, 2026
10a4cc0
P5-rewrite-1: Go SDK exposes axon_dendrite_invoke_ability_signed_json
Qingbolan Apr 27, 2026
31e0c9f
P5-rewrite-2: kernel signature-policy gate (RequireSigned by default)
Qingbolan Apr 27, 2026
40b44fc
P5-rewrite-4 (axon): per-form receipt canonical-bytes anchors
Qingbolan Apr 27, 2026
c2018d6
P5-rewrite-5 (axon): self-review cleanup — boot log, lying comments, …
Qingbolan Apr 27, 2026
b174901
P5-rewrite-8 (axon): cross-language envelope interop fixture (Rust ↔ Go)
Qingbolan Apr 27, 2026
29ad715
P5-rewrite-10 (axon): receiver-side AXIOM gates on invoke_stream
Qingbolan Apr 27, 2026
89eb233
P5-rewrite-11 (axon): hosted-Agent receipt fields (§A12 closure)
Qingbolan Apr 27, 2026
b100231
P5-rewrite-12 (axon): chain-walking verifier (offline file-bundle mode)
Qingbolan Apr 27, 2026
46f948b
P5-rewrite-13: un-break dendrite-bridge — remove P1-orphan code
Qingbolan Apr 27, 2026
24ddbc5
C-M1a (axon): server-stream signed FFI verb (P5-rewrite-14)
Qingbolan Apr 27, 2026
bca743f
P5-rewrite-15a (axon): InvokeBidi server handler + shared frame-chain…
Qingbolan Apr 27, 2026
0cc03f1
P5-rewrite-15a-cleanup: industrial-grade self-review pass on bidi han…
Qingbolan Apr 27, 2026
db367b3
P5-rewrite-15b (axon): caller-side InvokeBidi FFI verbs
Qingbolan Apr 27, 2026
d8ef353
P5-rewrite-15b-cleanup: industrial-grade self-review on bidi FFI bridge
Qingbolan Apr 27, 2026
cc6528c
P5-rewrite-15c (sdk-go): InvokeBidi helper validation fix + 3 rejecti…
Qingbolan Apr 27, 2026
e2a3f63
P5-rewrite-15d (doc): AXIOM §A16 — bidirectional realtime invocation …
Qingbolan Apr 27, 2026
5cc67b3
P5-rewrite-15d: industrial-grade test expansion (Go SDK) + §A16 RFC +…
Qingbolan Apr 27, 2026
470ac35
P5-rewrite-15e: second-pass self-review on Go BidiStream
Qingbolan Apr 27, 2026
19c53e8
P5-rewrite-15f: C-route audit closure — F1 (gates) + F2 (conformance)…
Qingbolan Apr 27, 2026
79dbaae
P5-rewrite-15g (axon): close the v1 echo gap — fleet.session_attach d…
Qingbolan Apr 27, 2026
cbdc58a
P6-baseline-0 (doc): AXIOM §"Tier 2.5 — Baseline Locomotion Profile" …
Qingbolan Apr 27, 2026
74db5fa
P6-baseline-2-spec (doc): AXIOM Tier 2.5 — shell.run + 8-stage pipeline
Qingbolan Apr 27, 2026
54687b8
RFC-002 Stage 1.1: SessionProvider trait + types
Qingbolan Apr 27, 2026
a5f1a03
RFC-002 Stage 1.1 polish: real BidiStreamHandle + ownership contract …
Qingbolan Apr 27, 2026
44915c2
RFC-002 Stage 1.2: SessionRegistry + SessionRecord + SessionStatus + …
Qingbolan Apr 27, 2026
73ea770
RFC-002 Stage 1.3.1: AxonState wires SessionRegistry field
Qingbolan Apr 27, 2026
a84160d
RFC-002 Stage 1.1 polish-2: channel-close terminal + mark_failed slot
Qingbolan Apr 27, 2026
d94434e
RFC-002 Stage 1.2 polish: registry-canonical session store + synthesi…
Qingbolan Apr 27, 2026
6e10984
RFC-002 Stage 1.2 polish-2: first-class SessionSource on SessionRecord
Qingbolan Apr 27, 2026
bdfdb8d
RFC-002 Stage 1.3 Step 2-5: bidi_handler refactor + BuiltinPtySession…
Qingbolan Apr 27, 2026
ab8a4e6
RFC-002 Stage 1 self-review: clean up audit defects
Qingbolan Apr 27, 2026
7d1bda6
RFC-002 Stage 1 self-review pass 2: doc accuracy + style consistency
Qingbolan Apr 27, 2026
dac69db
RFC-002 Stage 1 self-review pass 3: trim historical comments
Qingbolan Apr 27, 2026
f06e40e
RFC-002 Stage 1 self-review pass 4: trim more historical preambles
Qingbolan Apr 27, 2026
babbfca
RFC-002 Stage 1 self-review pass 5: trim stage labels + clarify the P…
Qingbolan Apr 27, 2026
476d9e1
RFC-002 Stage 1 self-review pass 6: fix the PTY auto-register conflict
Qingbolan Apr 27, 2026
50576c9
RFC-002 Stage 1 self-review pass 7: align attach_session_with_synthes…
Qingbolan Apr 27, 2026
2359296
RFC-002 Stage 1 self-review pass 8: drop remaining stage labels
Qingbolan Apr 27, 2026
c8130e7
RFC-002 Stage 1 self-review pass 9: zero out remaining Stage labels
Qingbolan Apr 27, 2026
fe4295b
C-M11: federation.subscribe_directory — server-stream ability
Qingbolan Apr 27, 2026
dff7294
G-bundle: fix BIDI_CHAIN_STATES leak (P0-A) + stale anchor (P1-4)
Qingbolan Apr 27, 2026
aa932ba
X-batch1: P1-2 failure_reason cap + P1-1 explicit replay tests
Qingbolan Apr 27, 2026
d938b04
X-batch1 self-review (session_provider only): visibility + clutter
Qingbolan Apr 27, 2026
4a3fc9f
X-batch2: P1-3 slow-receiver stall detection
Qingbolan Apr 27, 2026
1bd6bd0
X-batch3: minimal RFC-003 v1 conformance suite (21 tests)
Qingbolan Apr 27, 2026
df1b8b9
runtime: implement runtime.* admin namespace + Step 3 dispatch hook
Qingbolan Apr 27, 2026
7ecd51e
runtime: exempt runtime.* from signature-policy gate
Qingbolan Apr 28, 2026
276e5e0
sdk(dendrite-bridge): make list_mcp_tools/call_mcp_tool symbols optional
Qingbolan Apr 28, 2026
1caa3b2
runtime(invoke): exempt runtime.* from easynet-metadata signature ver…
Qingbolan Apr 28, 2026
66d36ae
runtime: add runtime.bootstrap_self_identity admin RPC for trusted-ke…
Qingbolan Apr 28, 2026
3678a10
runtime: stream-mode fallback through runtime_local_tools UDS
Qingbolan Apr 28, 2026
366d291
runtime: unblock the federation deadlock that disabled every signed I…
Qingbolan Apr 28, 2026
4fb7991
RFC-002: federation.forward_invoke + resolve_key + keyring routing
Qingbolan Apr 28, 2026
743242d
RFC-002 §5 update: tenant-scope federation.resolve
Qingbolan Apr 29, 2026
ffa190c
hub: secondary tenant + host_node indexes; distributed-routing RFC sk…
Qingbolan Apr 29, 2026
2d34564
RFC-002.2: distributed shard routing implementation
Qingbolan Apr 29, 2026
efe8cdd
single-tenant cross-shard chat e2e: prove args+result actually flow
Qingbolan Apr 29, 2026
34a7f4d
RFC-002.2 production gRPC dispatcher: real cross-shard forwarding
Qingbolan Apr 29, 2026
3261835
runtime: prune dead bidi diagnostics and unused target_node_id field
Qingbolan Apr 29, 2026
4a1e10c
sdk: collapse legacy direct-RPCs into federation.* across all 6 SDKs
Qingbolan Apr 29, 2026
3655e9c
sdk(rust): clear pre-existing clippy + doctest warnings
Qingbolan Apr 29, 2026
a53ea5c
ci: drop spec-parity check and Node kit tests for removed remote_cont…
Qingbolan Apr 29, 2026
2cc784e
sdk(rust): finish §A1 by deleting the dead remote_control MCP surface
Qingbolan Apr 29, 2026
6231e76
rust: clear runtime-rs lint backlog so `cargo fmt --check` and clippy…
Qingbolan Apr 29, 2026
5353e85
rust: fix five clippy lints introduced by clippy 1.95
Qingbolan Apr 29, 2026
c8f4006
sdk(java): close the spawn/posixPgid race that flakes the cancel-grac…
Qingbolan Apr 29, 2026
7aa20c3
sdk(java): signal both process group and direct PID in cancel flow
Qingbolan Apr 29, 2026
fa6fd3f
sdk(python): declare cryptography runtime dep and pytest dev extra
Qingbolan Apr 29, 2026
f187de5
fix(runtime): URI v4.1.4 — federation_client uses /hub and /device/ s…
Qingbolan May 2, 2026
c379ae0
Demote stale agent heartbeats; bootstrap fixes
Qingbolan May 3, 2026
b6904ae
docs(ontology): widen Ability ownership to {user, agent, hub, resource}
Qingbolan May 3, 2026
d925d21
feat(hub): hub-broadcast contract — published abilities + heartbeat diff
Qingbolan May 5, 2026
fbe30e9
uri: retire legacy hub ability URA
Qingbolan May 7, 2026
576e25e
chore(fmt): apply rustfmt to runtime-rs (no behaviour change)
Qingbolan May 9, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
14 changes: 5 additions & 9 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -56,9 +56,6 @@ jobs:
- name: Project Structure Contract Check
run: bash packaging/release/check_project_structure.sh

- name: Remote Control Spec Parity Check
run: python3 scripts/check_remote_control_spec_parity.py

- name: Node SDK Generated Artifact Contract Check
run: |
cd sdk/node
Expand Down Expand Up @@ -239,8 +236,11 @@ jobs:
working-directory: sdk/python
shell: bash
run: |
pip install -e ".[dev]" 2>/dev/null || pip install -e .
pip install pytest
# `[dev]` pulls in pytest; the runtime `cryptography` dep is
# in the base deps list. Don't swallow failures — a missing
# dependency must surface as an install error rather than as
# a confusing test failure later.
pip install -e ".[dev]"

- name: Python SDK Tests
working-directory: sdk/python
Expand Down Expand Up @@ -273,10 +273,6 @@ jobs:
working-directory: sdk/node
run: npm run types

- name: Node SDK Tests
working-directory: sdk/node
run: node --test src/presets/remote_control/kit.test.js

sdk-react-test:
runs-on: ubuntu-latest
timeout-minutes: 30
Expand Down
47 changes: 47 additions & 0 deletions .github/workflows/rfc-001-conformance.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
name: RFC-001 Conformance

# Enforces AXON-RFC-001 architectural invariants on every PR + push
# to main. Three checks run in series:
# 1. self-test — verifies the conformance script itself works
# (positive + negative cases against fixtures)
# 2. baseline — runs the conformance script in baseline mode and
# confirms its output is parseable
# 3. lock — compares current violation total to recorded
# baseline; fails on regression
#
# These checks do NOT (yet) fail on absolute violation count > 0 —
# the codebase has 327 known baseline violations that subsequent
# RFC-001 implementation phases will drive to zero. The lock check
# only fails on REGRESSION (new violations introduced after baseline).

on:
pull_request:
branches: [main]
push:
branches: [main, "rfc-001-impl"]

jobs:
conformance:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4

- name: Install ripgrep
run: |
if ! command -v rg >/dev/null 2>&1; then
sudo apt-get update -qq
sudo apt-get install -y ripgrep
fi
rg --version

- name: Self-test (verifies the conformance script catches violations)
run: |
./core/runtime-rs/scripts/check-rfc-001-conformance-self-test.sh

- name: Baseline scan (informational; never fails CI)
run: |
./core/runtime-rs/scripts/check-rfc-001-conformance.sh

- name: Baseline regression lock (fails if violations increased)
run: |
./core/runtime-rs/scripts/check-rfc-001-baseline-lock.sh
22 changes: 4 additions & 18 deletions core/proto/axon/v1/admin.proto
Original file line number Diff line number Diff line change
Expand Up @@ -40,25 +40,11 @@ import "axon/v1/types.proto";
// and adds GetComponentStatus + ReloadLimits for production ops.
// ─────────────────────────────────────────────────────────

// RFC-001 P1.2.d: Admin service collapsed.
// All RPCs restated as Agent abilities. See
// docs/rfc/AXON-RFC-001-restatement-mapping.md §2 admin.proto.
service Admin {
// Trigger control-plane leader failover / traffic switch.
rpc Failover(FailoverRequest) returns (FailoverResponse);

// Trigger WAL + state snapshot for crash recovery.
rpc Snapshot(SnapshotRequest) returns (SnapshotResponse);

// Restore from a previous snapshot.
rpc Recover(RecoverRequest) returns (RecoverResponse);

// Per-component health status (scheduler, WAL, registry, etc.).
rpc GetComponentStatus(GetComponentStatusRequest) returns (GetComponentStatusResponse);

// Hot-reload rate limits / quotas without restart.
rpc ReloadLimits(ReloadLimitsRequest) returns (ReloadLimitsResponse);

// Hot-reload bootstrap configuration (node discovery seeds,
// default policies, initial trust anchors) without restart.
rpc ReloadBootstrapConfig(ReloadBootstrapConfigRequest) returns (ReloadBootstrapConfigResponse);
// intentionally empty
}

// ─── Enums ──────────────────────────────────────────────
Expand Down
40 changes: 4 additions & 36 deletions core/proto/axon/v1/capability.proto
Original file line number Diff line number Diff line change
Expand Up @@ -40,43 +40,11 @@ import "axon/v1/types.proto";
// Every payload requires signature verification.
// ─────────────────────────────────────────────────────────

// RFC-001 P1.2.e: CapabilityLifecycle service collapsed.
// All RPCs restated as Agent abilities. See
// docs/rfc/AXON-RFC-001-restatement-mapping.md §2 capability.proto.
service CapabilityLifecycle {
// Package management (server-side registry)
rpc PublishPackage(PublishPackageRequest) returns (PublishPackageResponse);
rpc GetPackage(GetPackageRequest) returns (GetPackageResponse);
rpc DeprecatePackage(DeprecatePackageRequest) returns (DeprecatePackageResponse);

// Signing & promotion pipeline
rpc SignPackage(SignPackageRequest) returns (SignPackageResponse);
rpc PromotePackage(PromotePackageRequest) returns (PromotePackageResponse);

// Rollout management (canary → progressive → full)
rpc CreateRollout(CreateRolloutRequest) returns (CreateRolloutResponse);
rpc GetRollout(GetRolloutRequest) returns (GetRolloutResponse);
rpc PauseRollout(PauseRolloutRequest) returns (PauseRolloutResponse);
rpc ResumeRollout(ResumeRolloutRequest) returns (ResumeRolloutResponse);
rpc AbortRollout(AbortRolloutRequest) returns (AbortRolloutResponse);

// Device-side ability operations
rpc InstallCapability(InstallCapabilityRequest) returns (InstallCapabilityResponse);
rpc ActivateCapability(ActivateCapabilityRequest) returns (ActivateCapabilityResponse);
rpc DeactivateCapability(DeactivateCapabilityRequest) returns (DeactivateCapabilityResponse);
rpc RollbackCapability(RollbackCapabilityRequest) returns (RollbackCapabilityResponse);
rpc RevokeCapability(RevokeCapabilityRequest) returns (RevokeCapabilityResponse);
rpc UninstallCapability(UninstallCapabilityRequest) returns (UninstallCapabilityResponse);

// Query
rpc ListNodeCapabilities(ListNodeCapabilitiesRequest) returns (ListNodeCapabilitiesResponse);
rpc QueryCapabilities(QueryCapabilitiesRequest) returns (QueryCapabilitiesResponse);
rpc ResolveCapability(ResolveCapabilityRequest) returns (ResolveCapabilityResponse);

// Consent (user-side approval for sensitive abilities)
rpc GrantConsent(GrantConsentRequest) returns (GrantConsentResponse);
rpc RevokeConsent(RevokeConsentRequest) returns (RevokeConsentResponse);
rpc ListConsents(ListConsentsRequest) returns (ListConsentsResponse);

// Watch installation events
rpc WatchCapabilityEvents(WatchCapabilityEventsRequest) returns (stream CapabilityEvent);
// intentionally empty
}

// Integrity + provenance proof for a transferred ability package.
Expand Down
42 changes: 19 additions & 23 deletions core/proto/axon/v1/control.proto
Original file line number Diff line number Diff line change
Expand Up @@ -36,30 +36,26 @@ import "axon/v1/types.proto";
// sustained healthy heartbeats, not through configuration.
// ─────────────────────────────────────────────────────────

// RFC-001 P1.2.c: ControlPlane service collapsed.
// All 14 RPCs (RegisterNode, Heartbeat, DrainNode, UndrainNode,
// QuarantineNode, DeregisterNode, GetNodeTrust, SetNodeTrust,
// ListNodes, GetNode, ResolveNode, GetDeviceOverview,
// ListDeviceOverviews, WatchMembership) are restated as abilities:
//
// federation.join, federation.heartbeat, federation.leave,
// federation.revoke, federation.resolve, federation.watch_membership,
// admin.{drain_node, undrain_node, quarantine_node},
// identity.{get_trust, set_trust},
// meta.describe (per device-agent for GetDeviceOverview),
// aggregate.list_device_overviews (backend-profile)
//
// See docs/rfc/AXON-RFC-001-restatement-mapping.md §2 control.proto.
//
// Message types remain (kept by other paths) until they are no longer
// referenced; the empty ControlPlane service stays only to preserve
// the file layout while in transition.
service ControlPlane {
// Node lifecycle
rpc RegisterNode(RegisterNodeRequest) returns (RegisterNodeResponse);
rpc Heartbeat(HeartbeatRequest) returns (HeartbeatResponse);
rpc DrainNode(DrainNodeRequest) returns (DrainNodeResponse);
rpc UndrainNode(UndrainNodeRequest) returns (UndrainNodeResponse);
rpc QuarantineNode(QuarantineNodeRequest) returns (QuarantineNodeResponse);
rpc DeregisterNode(DeregisterNodeRequest) returns (DeregisterNodeResponse);

// Trust management (progressive trust)
rpc GetNodeTrust(GetNodeTrustRequest) returns (GetNodeTrustResponse);
rpc SetNodeTrust(SetNodeTrustRequest) returns (SetNodeTrustResponse);

// Discovery
rpc ListNodes(ListNodesRequest) returns (ListNodesResponse);
rpc GetNode(GetNodeRequest) returns (GetNodeResponse);
rpc ResolveNode(ResolveNodeRequest) returns (ResolveNodeResponse);

// Device overview: aggregated view of a device + all its abilities
rpc GetDeviceOverview(GetDeviceOverviewRequest) returns (GetDeviceOverviewResponse);
rpc ListDeviceOverviews(ListDeviceOverviewsRequest) returns (ListDeviceOverviewsResponse);

// Streaming membership events (for AliveAgent state writeback)
rpc WatchMembership(WatchMembershipRequest) returns (stream MembershipEvent);
// intentionally empty
}

// ─── Registration ───────────────────────────────────────
Expand Down
33 changes: 4 additions & 29 deletions core/proto/axon/v1/federation.proto
Original file line number Diff line number Diff line change
Expand Up @@ -48,36 +48,11 @@ import "axon/v1/types.proto";
// Only the Hub Runtime needs to be publicly reachable.
// ─────────────────────────────────────────────────────────

// RFC-001 P1.2.e: Federation service collapsed.
// All RPCs restated as Agent abilities. See
// docs/rfc/AXON-RFC-001-restatement-mapping.md §2 federation.proto.
service Federation {
// Local Runtime registers itself with the Hub.
rpc JoinFederation(JoinFederationRequest) returns (JoinFederationResponse);

// Local Runtime deregisters from the Hub.
rpc LeaveFederation(LeaveFederationRequest) returns (LeaveFederationResponse);

// Periodic heartbeat: local runtime syncs its node list to Hub,
// Hub returns aggregated view of all federated nodes.
rpc FederationHeartbeat(FederationHeartbeatRequest) returns (FederationHeartbeatResponse);

// Source runtime submits a cross-network invocation to the Hub and waits
// for terminal completion reported by the target runtime.
rpc DispatchFederatedInvocation(DispatchFederatedInvocationRequest)
returns (DispatchFederatedInvocationResponse);

// Long-lived stream: Hub pushes cross-network invocations to local runtime.
// Local runtime executes locally and reports results via ReportInvocationResult.
// Delivery guarantee: at-least-once, ordered per federated_invocation_id.
// Clients must use idempotency_key for deduplication.
// Messages with terminal = true signal end-of-stream for a given invocation.
rpc WatchFederatedInvocations(WatchFederatedInvocationsRequest)
returns (stream FederatedInvocation);

// Local Runtime reports the result of a federated invocation back to the Hub.
rpc ReportInvocationResult(FederatedInvocationResultRequest)
returns (FederatedInvocationResultResponse);

// Query all nodes visible across the federation.
rpc ListFederatedNodes(ListFederatedNodesRequest) returns (ListFederatedNodesResponse);
// intentionally empty
}

// ─── Join / Leave ────────────────────────────────────────
Expand Down
58 changes: 4 additions & 54 deletions core/proto/axon/v1/identity.proto
Original file line number Diff line number Diff line change
Expand Up @@ -17,61 +17,11 @@ import "axon/v1/types.proto";
// requires quorum approval in production.
// ─────────────────────────────────────────────────────────

// RFC-001 P1.2.d: Identity service collapsed.
// All RPCs restated as Agent abilities. See
// docs/rfc/AXON-RFC-001-restatement-mapping.md §2 identity.proto.
service Identity {
// Node key rotation: old key signs the rotation request,
// new public key is submitted and verified.
rpc RotateNodeKey(RotateNodeKeyRequest) returns (RotateNodeKeyResponse);

// Revoke a compromised or decommissioned node key.
rpc RevokeNodeKey(RevokeNodeKeyRequest) returns (RevokeNodeKeyResponse);

// Retrieve the current system trust root public key.
rpc GetTrustRoot(GetTrustRootRequest) returns (GetTrustRootResponse);

// Rotate the system trust root (high-privilege ops operation).
rpc RotateTrustRoot(RotateTrustRootRequest) returns (RotateTrustRootResponse);

// Verify a payload signature (used by capability install pipeline).
rpc VerifySignature(VerifySignatureRequest) returns (VerifySignatureResponse);

// Query node key history (active + rotated + revoked).
rpc ListNodeKeys(ListNodeKeysRequest) returns (ListNodeKeysResponse);

// ─── Token Management ──────────────────────────────────

// Issue a bearer token for any authenticated principal
// (node via mTLS, user/service via secret).
rpc IssueToken(IssueTokenRequest) returns (IssueTokenResponse);

// Rotate a bearer token before expiry.
rpc RotateToken(RotateTokenRequest) returns (RotateTokenResponse);

// Revoke a bearer token (immediate invalidation).
rpc RevokeToken(RevokeTokenRequest) returns (RevokeTokenResponse);

// Identify the caller from their bearer token.
rpc WhoAmI(WhoAmIRequest) returns (WhoAmIResponse);

// ─── Tenant Management (L0) ─────────────────────────────

// Create a new tenant namespace.
rpc CreateTenant(CreateTenantRequest) returns (CreateTenantResponse);

// Retrieve tenant configuration and quota.
rpc GetTenant(GetTenantRequest) returns (GetTenantResponse);

// Update tenant quota or policy settings.
rpc UpdateTenant(UpdateTenantRequest) returns (UpdateTenantResponse);

// ─── E2E Encryption: Session Key Exchange ─────────────

// Establish ephemeral session key between two nodes via ECDH.
// The resulting session key enables E2E encrypted payloads
// that intermediaries (scheduler, gateway) cannot decrypt.
rpc NegotiateSessionKey(NegotiateSessionKeyRequest) returns (NegotiateSessionKeyResponse);

// Retrieve a session key for decryption (only the authorized peer can call).
rpc GetSessionKey(GetSessionKeyRequest) returns (GetSessionKeyResponse);
// intentionally empty
}

// ─── Node Key Rotation ──────────────────────────────────
Expand Down
Loading
Loading