Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
  •  
  •  
  •  
22 changes: 11 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,7 @@ In an agent-native system, failure does not come from model quality alone. It co

Axon solves this by making execution contract-first:

- Addressability: every network object has a canonical URI.
- Addressability: every network object has a canonical URA.
- Decidability: every operation ends in a known state.
- Explainability: every routing and scheduling decision can be justified.
- Auditability: every state transition leaves a durable trace.
Expand All @@ -112,7 +112,7 @@ A central design choice in Axon is separating **Skill** from **Ability**.
In Axon terms:

- A **Skill** is developer logic.
- An **Ability** is that logic elevated into a governed protocol object (`axon://capabilities/<capability_id>`) with explicit schema, trust posture, execution mode, observability, and policy surface.
- An **Ability** is that logic elevated into a governed protocol object (`easynet:///r/<realm>/ability/<ability-id>`) with explicit schema, trust posture, execution mode, observability, and policy surface.

This is the key move from demos to durable AI products: users buy reliable abilities, not private skill implementations.

Expand All @@ -134,7 +134,7 @@ Axon defines the full contract for resource naming, invocation semantics, conten

| Guarantee | Meaning |
| --------------- | ------------------------------------------------------------------------- |
| **Addressable** | Every resource has a canonical URI: `axon://<type>/<id>` |
| **Addressable** | Every resource has a canonical URA: `axon://<type>/<id>` |
| **Decidable** | Every operation terminates in a known state |
| **Explainable** | Scheduler decisions include explicit reasons |
| **Auditable** | Every change emits an `AuditEntry` |
Expand All @@ -143,16 +143,16 @@ Axon defines the full contract for resource naming, invocation semantics, conten

### Resource Namespace (`axon://`)

| URI | Resource | Managed by |
| URA | Resource | Managed by |
| ------------------------------------- | ---------------------- | ------------------- |
| `axon://nodes/<node_id>` | Node | ControlPlane |
| `axon://capabilities/<capability_id>` | Ability | CapabilityLifecycle |
| `axon://invocations/<invocation_id>` | Invocation | Invocation |
| `easynet:///r/<realm>/device/<device-id>` | Node | ControlPlane |
| `easynet:///r/<realm>/ability/<ability-id>` | Ability | CapabilityLifecycle |
| `easynet:///r/<realm>/resource/invocation/<invocation-id>` | Invocation | Invocation |
| `axon://missions/<mission_id>` | Mission | MissionControl |
| `axon://streams/<session_id>` | Stream session | Stream |
| `axon://payloads/<payload_id>` | Large payload | PayloadTransfer |
| `easynet:///r/<realm>/resource/<owner-id>/payload/<payload-id>` | Large payload | PayloadTransfer |
| `axon://policies/<policy_id>` | Policy | Policy |
| `axon://keys/<key_hash>` | Key material reference | Identity |
| `easynet:///r/<realm>/resource/session-key/<key-hash>` | Key material reference | Identity |

### Execution Modes

Expand Down Expand Up @@ -180,7 +180,7 @@ Axon defines the full contract for resource naming, invocation semantics, conten

Every protocol-crossing payload (input, output, stream chunk) uses `ContentEnvelope` with explicit MIME type, encoding, and optional schema.

Large payloads are referenced by `PayloadRef` (`axon://payloads/<id>`) and carry full content metadata plus integrity digest.
Large payloads are referenced by `PayloadRef` (`easynet:///r/<realm>/resource/<owner-id>/payload/<payload-id>`) and carry full content metadata plus integrity digest.

## Security Contract

Expand Down Expand Up @@ -234,7 +234,7 @@ See `document/plans/ecosystem/10-capability-control-plane-evidence-and-paper-pla
## Engineering Principles

1. Close AgentNet first, then expand into EasyNet.
2. Reserve extension hooks early (schema fields, state-machine hooks, URI namespaces).
2. Reserve extension hooks early (schema fields, state-machine hooks, URA namespaces).
3. Keep future EasyNet features out of P0 execution-critical paths until activation.

## Repository Structure
Expand Down
6 changes: 3 additions & 3 deletions core/proto/axon/v1/capability.proto
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ service CapabilityLifecycle {
// This proof is generated from protocol-level payload transfer metadata
// plus package signature fingerprinting and is re-validated at install time.
message CapabilityPackageProof {
string payload_uri = 1; // must be axon://payloads/<payload_id>
string payload_ura = 1; // must be EasyNet URA /r/<realm>/resource/<owner>/payloads/<payload_id>
string payload_digest = 2; // sha256:<hex>
int64 payload_size_bytes = 3; // immutable payload size
string signature_fingerprint = 4; // sha256 of signature bytes
Expand All @@ -71,7 +71,7 @@ message PublishPackageRequest {
map<string, string> requirements = 8; // "gpu": "optional", "python": ">=3.10"
map<string, string> metadata = 9;
// Payload is uploaded separately via object store; this is metadata only.
string payload_uri = 10; // reference to payload in object store
string payload_ura = 10; // reference to payload in object store
uint32 publisher_key_version = 11; // key version used to produce the signature
CapabilityPackageProof proof = 12; // integrity + security proof (required in vNext)
}
Expand All @@ -93,7 +93,7 @@ message GetPackageRequest {
message GetPackageResponse {
ResponseHeader header = 1;
CapabilityDescriptor descriptor = 2;
string payload_uri = 3;
string payload_ura = 3;
CapabilityPackageProof proof = 4;
Error error = 100;
}
Expand Down
2 changes: 1 addition & 1 deletion core/proto/axon/v1/control.proto
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ message RegisterNodeRequest {
string owner_id = 11; // principal_id of the owning user
string device_group = 12; // "home" | "office" | "lab" | custom
DeviceMeta device = 13; // device hardware/OS metadata
// Structured runtime role. UNSPECIFIED defaults to FULL. Legacy callers may
// Structured runtime role. UNSPECIFIED defaults to FULL. Existing callers may
// instead set `labels["axon.role"]`; that fallback is honored only when this
// field is UNSPECIFIED.
NodeRole role = 14;
Expand Down
2 changes: 1 addition & 1 deletion core/proto/axon/v1/federation.proto
Original file line number Diff line number Diff line change
Expand Up @@ -123,7 +123,7 @@ message FederationHeartbeatResponse {
// `false` value means "no action required" and a `true` value means
// "refresh your join token out-of-band, then re-join".
bool token_refresh_hint = 4;
// Legacy scalar mirror for older clients.
// Scalar mirror for clients that do not read structured membership URA fields.
// Semantics: the Hub returns the caller member's own spec version here,
// not a federation-global counter. This avoids waking unrelated peers when
// some other member changes its ability set.
Expand Down
20 changes: 13 additions & 7 deletions core/proto/axon/v1/invoke.proto
Original file line number Diff line number Diff line change
Expand Up @@ -94,8 +94,8 @@ service Invocation {

// Bidirectional invocation (P5-rewrite-15) — realtime multimodal
// sessions. PTY uses the session-as-subject pattern: unary
// `fleet.session_create` mints the session URA, then a single
// InvokeBidi against `fleet.session_attach` carries the
// `device.terminal.create` mints the session URA, then a single
// InvokeBidi against `device.terminal.attach` carries the
// bidirectional binary stream until close.
rpc InvokeBidi(stream InvokeBidiUp) returns (stream InvokeBidiDown);
}
Expand Down Expand Up @@ -139,9 +139,9 @@ message InvokeResponse {
// callee's public key (no runtime contact) can re-compute the
// canonical bytes and check the signature independently.
//
// Absent for legacy unsigned invocations (no admission ⇒ no signed
// receipt). Absent on admission-reject paths (the Error message
// itself is the wire-visible outcome).
// Absent when no signed admission receipt exists. Absent on
// admission-reject paths (the Error message itself is the
// wire-visible outcome).
InvocationReceipt admission_receipt = 14;
Error error = 100;
}
Expand Down Expand Up @@ -482,6 +482,12 @@ message EnvelopeOpen {
// four AXIOM gates as the other two RPCs (signature_policy →
// admission → membership → delegation).
map<string, string> metadata = 6;

// Full content contract for `initial_args`. Unary and server-stream
// requests already carry this field; bidi frame-0 needs the same
// contract so encrypted or schema-bound session opens do not degrade
// into opaque bytes when routed through InvokeBidi / invoke_remote.
ContentEnvelope content_envelope = 7;
}

message StreamDescriptor {
Expand Down Expand Up @@ -704,8 +710,8 @@ message InvocationReceipt {
// - signer_binding present + DIFFERENT from callee_binding ⇒
// hosted (Model B). callee_signature MUST verify under
// signer_binding's pubkey, AND host_attestation MUST be a
// signature over canonical_host_attestation_bytes(callee_uri,
// signer_uri) by the same signer_binding pubkey.
// signature over canonical_host_attestation_bytes(callee_ura,
// signer_ura) by the same signer_binding pubkey.
//
// - signer_binding absent OR equal to callee_binding ⇒
// self-signed (Model A). callee_signature verifies under
Expand Down
6 changes: 3 additions & 3 deletions core/proto/axon/v1/observe.proto
Original file line number Diff line number Diff line change
Expand Up @@ -135,13 +135,13 @@ message GetSLOStatusRequest {
enum SLOIndicatorKind {
SLO_INDICATOR_KIND_UNSPECIFIED = 0;
SLO_INDICATOR_KIND_THRESHOLD = 1; // compared against threshold_target
SLO_INDICATOR_KIND_COUNTER = 2; // monotonic/process counter; target is legacy mirror
SLO_INDICATOR_KIND_GAUGE = 3; // point-in-time value; target is legacy mirror
SLO_INDICATOR_KIND_COUNTER = 2; // monotonic/process counter; target is a scalar mirror
SLO_INDICATOR_KIND_GAUGE = 3; // point-in-time value; target is a scalar mirror
}

message SLOIndicator {
string name = 1; // "invoke_success_rate" | "p99_latency_ms" | "stream_cancel_latency_ms"
double target = 2; // legacy target mirror for compatibility with existing clients
double target = 2; // scalar target mirror for existing clients
double current = 3; // actual measured value
bool in_compliance = 4;
string window = 5; // "1h" | "24h" | "7d"
Expand Down
10 changes: 5 additions & 5 deletions core/proto/axon/v1/transfer.proto
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ import "axon/v1/types.proto";
//
// Part of the Axon content contract: every payload that
// exceeds inline gRPC limits is stored as a protocol-level
// resource addressed via axon://payloads/<payload_id>.
// resource addressed via EasyNet URA /r/<realm>/resource/<owner>/payloads/<payload_id>.
//
// Any Axon subsystem (invocation, mission, capability, stream)
// can reference PayloadRef objects managed by this service.
Expand Down Expand Up @@ -68,15 +68,15 @@ message UploadFinalBody {

message UploadPayloadResponse {
ResponseHeader header = 1;
PayloadRef ref = 2; // complete PayloadRef with axon://payloads/<id> URI
PayloadRef ref = 2; // complete PayloadRef with EasyNet URA /r/<realm>/resource/<owner>/payloads/<id> URA
Error error = 100;
}

// ─── Download ─────────────────────────────────────────

message DownloadPayloadRequest {
Envelope envelope = 1;
string uri = 2; // axon://payloads/<payload_id>
string ura = 2; // EasyNet URA /r/<realm>/resource/<owner>/payloads/<payload_id>
int64 offset = 3; // byte offset for resume (protocol resumability); 0 = start
int64 limit = 4; // max bytes to return; 0 = all remaining
}
Expand All @@ -94,7 +94,7 @@ message DownloadPayloadResponse {

message GetPayloadMetaRequest {
Envelope envelope = 1;
string uri = 2; // axon://payloads/<payload_id>
string ura = 2; // EasyNet URA /r/<realm>/resource/<owner>/payloads/<payload_id>
}

message GetPayloadMetaResponse {
Expand All @@ -107,7 +107,7 @@ message GetPayloadMetaResponse {

message DeletePayloadRequest {
Envelope envelope = 1;
string uri = 2; // axon://payloads/<payload_id>
string ura = 2; // EasyNet URA /r/<realm>/resource/<owner>/payloads/<payload_id>
}

message DeletePayloadResponse {
Expand Down
Loading
Loading