Spiking Networks

This reference covers 16 HTTP operations registered by the Akasha daemon. Call these paths on your instance base URL. See authentication, errors, and coverage before integrating.

POST /v1/snn/network/build

Snn build

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped. Handler additionally checks require_scoped( CoreAction::Write, "snn:write", request_authority::MEMORY_SNN, ); require_scoped( CoreAction::Admin, "snn:admin", request_authority::MEMORY_SNN, ); require_matching_db(&scoped_db).

Request

Json — SnnBuildReq

struct SnnBuildReq {
    network_id: Option<String>,
    namespace: Option<String>,
    version: Option<String>,
    spec: Option<serde_json::Value>,
    #[serde(flatten)]
    body_authority: RejectedBodyAuthority,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

response

Errors and validation

Directly referenced error variants: Forbidden, InvalidRequest. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:8975. Registration: akasha-daemon/src/main.rs:4463.

POST /v1/snn/network/compile

Snn compile

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped. Handler additionally checks require_scoped( CoreAction::Write, "snn:write", request_authority::MEMORY_SNN, ); require_scoped( CoreAction::Query, "snn:execute", request_authority::MEMORY_SNN, ); require_matching_db(&scoped_db).

Request

Json — SnnCompileReq

struct SnnCompileReq {
    network_id: String,
    namespace: String,
    version: Option<String>,
    #[serde(flatten)]
    body_authority: RejectedBodyAuthority,
}

JSON field accesses in handler: input, output, spec. Nested lookups are included; this list alone does not establish requiredness.

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

SnnCompileResponse {
        compiled_id: req.network_id.clone(),
        version: version.clone(),
    }

Errors and validation

Directly referenced error variants: Forbidden, Internal, InvalidRequest. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:9050. Registration: akasha-daemon/src/main.rs:4464.

POST /v1/snn/network/step

Snn step

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped. Handler additionally checks require_scoped( CoreAction::Query, "snn:execute", request_authority::MEMORY_SNN, ); require_matching_db(&scoped).

Request

Json — SnnStepReq

struct SnnStepReq {
    network_id: String,
    namespace: String,
    version: Option<String>,
    input: Vec<f32>,
    #[serde(flatten)]
    body_authority: RejectedBodyAuthority,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

SnnStepResponse { output: result_vec }

Errors and validation

Directly referenced error variants: Forbidden, Internal. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:9166. Registration: akasha-daemon/src/main.rs:4465.

POST /v1/snn/train/bptt

Snn train bptt

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped. Handler additionally checks require_scoped( CoreAction::Write, "snn:train", request_authority::MEMORY_SNN, ); require_matching_db(&scoped_db).

Request

Implementation limit: Placeholder training: constructs a trainer but does not run BPTT. Records placeholder completed metrics and saves a versioned spec; do not interpret success as learned weights.

Json — SnnTrainBpttReq

struct SnnTrainBpttReq {
    network_id: String,
    namespace: String,
    version: Option<String>,
    steps: usize,
    #[serde(flatten)]
    body_authority: RejectedBodyAuthority,
}

JSON field accesses in handler: spec. Nested lookups are included; this list alone does not establish requiredness.

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

SnnTrainBpttResponse {
        network_id: req.network_id,
        version,
    }

Errors and validation

Directly referenced error variants: Forbidden, Internal, InvalidRequest. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:9210. Registration: akasha-daemon/src/main.rs:4466.

POST /v1/snn/network/state

Snn state

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped. Handler additionally checks require_scoped(CoreAction::Read, "snn:read", request_authority::MEMORY_SNN); require_matching_db(&scoped_db).

Request

Json — SnnStateReq

struct SnnStateReq {
    namespace: String,
    #[serde(flatten)]
    body_authority: RejectedBodyAuthority,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

SnnStateResponse {
        namespace: req.namespace,
        networks,
    }

Errors and validation

Directly referenced error variants: Forbidden. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:9318. Registration: akasha-daemon/src/main.rs:4467.

POST /v1/snn/federation/register

Snn federation register

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

Json — SnnFederationRegisterReq

struct SnnFederationRegisterReq {
    token: Option<String>,
    agent_id: String,
    host: String,
    capabilities: Vec<String>,
    #[serde(default)]
    ensembles: Vec<EnsembleInfo>,
    visibility: Option<String>,
    #[serde(default)]
    trust_score: Option<f32>,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::json!({"ok": true})

Errors and validation

Directly referenced error variants: from. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:9359. Registration: akasha-daemon/src/main.rs:4468.

POST /v1/snn/federation/contribute

Snn federation contribute

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

Json — SnnFederationContributeReq

struct SnnFederationContributeReq {
    token: Option<String>,
    agent_id: String,
    deltas: WeightDeltas,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::to_value(snapshot).unwrap_or_default()

Errors and validation

Directly referenced error variants: from. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:9380. Registration: akasha-daemon/src/main.rs:4469.

POST /v1/snn/federation/parameters

Snn federation parameters

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

Json — SnnFederationTokenReq

struct SnnFederationTokenReq {
    token: Option<String>,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::to_value(snapshot).unwrap_or_default()

Errors and validation

Directly referenced error variants: from. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:9392. Registration: akasha-daemon/src/main.rs:4473.

POST /v1/snn/federation/spike

Snn federation spike

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

Json — SnnFederationSpikeReq

struct SnnFederationSpikeReq {
    token: Option<String>,
    event: SpikeEventPayload,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::json!({"ok": true})

Errors and validation

Directly referenced error variants: from. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:9404. Registration: akasha-daemon/src/main.rs:4477.

POST /v1/snn/federation/capabilities

Snn federation capabilities

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

Json — SnnFederationCapabilitiesReq

struct SnnFederationCapabilitiesReq {
    token: Option<String>,
    #[serde(default)]
    required: Option<Vec<String>>,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::to_value(list).unwrap_or_default()

Errors and validation

Directly referenced error variants: from. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:9416. Registration: akasha-daemon/src/main.rs:4478.

POST /v1/snn/federation/agent/update

Snn federation agent update

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

Json — SnnFederationAgentUpdateReq

struct SnnFederationAgentUpdateReq {
    token: Option<String>,
    agent_id: String,
    visibility: Option<String>,
    trust_score: Option<f32>,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::to_value(updated).unwrap_or_default()

Errors and validation

Directly referenced error variants: from. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:9429. Registration: akasha-daemon/src/main.rs:4482.

POST /v1/snn/federation/agent/remove

Snn federation agent remove

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

Json — SnnFederationAgentRemoveReq

struct SnnFederationAgentRemoveReq {
    token: Option<String>,
    agent_id: String,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::json!({"ok": true})

Errors and validation

Directly referenced error variants: from. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:9446. Registration: akasha-daemon/src/main.rs:4486.

POST /v1/snn/federation/spikes

Snn federation spikes recent

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

Json — SnnFederationTokenReq

struct SnnFederationTokenReq {
    token: Option<String>,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::to_value(list).unwrap_or_default()

Errors and validation

Directly referenced error variants: from. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:9458. Registration: akasha-daemon/src/main.rs:4490.

GET /v1/snn/health

Snn health

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

No typed JSON, query, or path extractor is declared in the handler signature. Headers or request objects may still be consumed; the signature below is authoritative.

Response

Declared return: Result<impl IntoResponse, DaemonError>

Serialization is delegated or the handler returns a raw response. Consult the exact handler below; the OpenAPI response intentionally remains unconstrained.

Errors and validation

Directly referenced error variants: none in the handler body. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:10301. Registration: akasha-daemon/src/main.rs:4494.

GET /v1/snn/stats

Snn stats

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped. Handler additionally checks require_scoped(CoreAction::Read, "snn:read", request_authority::MEMORY_SNN); require_matching_db(&db).

Request

No typed JSON, query, or path extractor is declared in the handler signature. Headers or request objects may still be consumed; the signature below is authoritative.

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::json!({
        "cacheHits": metrics.cache_hits.get(),
        "cacheMisses": metrics.cache_misses.get(),
        "cacheEvictions": metrics.cache_evictions.get(),
        "loadFailures": metrics.load_failures.get()
    })

Errors and validation

Directly referenced error variants: none in the handler body. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:11151. Registration: akasha-daemon/src/main.rs:4495.

POST /v1/snn/neurons

Snn neurons

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped. Handler additionally checks require_scoped(CoreAction::Read, "snn:read", request_authority::MEMORY_SNN); require_matching_db(&db).

Request

Json — SnnNeuronsReq

struct SnnNeuronsReq {
    network_id: String,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::json!({
        "networkId": req.network_id,
        "neurons": []
    })

Errors and validation

Directly referenced error variants: none in the handler body. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:11173. Registration: akasha-daemon/src/main.rs:4496.