# NSP — Nelieo Substrate Protocol

## Docs

- [POST /substrate/v1/action — execute a typed action](https://docs.nelieo.com/api-reference/action.md): Dispatch a typed action on a tracked process via its runtime probe, with optional verification and a before/after field delta in the response.
- [GET /substrate/v1/apps — list all tracked applications](https://docs.nelieo.com/api-reference/apps.md): Retrieve the full list of applications the NSP daemon is tracking, including probe status, runtime type, confidence score, and available action counts.
- [GET /substrate/v1/diff/{pid} — state diff since capture](https://docs.nelieo.com/api-reference/diff.md): Retrieve the exact fields that changed, were added, or were removed between two consecutive state captures for a tracked process, keyed by capture ID.
- [GET /health — daemon liveness, version, and uptime](https://docs.nelieo.com/api-reference/health.md): Check whether the NSP daemon is running, read its version and uptime, and confirm how many processes are currently tracked — no API key required.
- [POST /learn/{pid} — submit semantic label corrections](https://docs.nelieo.com/api-reference/learn.md): Submit semantic label corrections for a tracked application to fix unknown or mislabeled state keys, raising confidence scores on subsequent probe cycles.
- [NSP API Reference — endpoints, auth, and error format](https://docs.nelieo.com/api-reference/overview.md): All NSP REST and WebSocket endpoints in one place: base URL, API key auth, rate limits, HTTP status codes, error envelope format, and request ID tracing.
- [GET /substrate/v1/schema/{pid} — read action schema](https://docs.nelieo.com/api-reference/schema.md): Fetch the ActionSchema map for a process — typed signatures, reversibility class, and parameter lists — without reading the full state objects tree.
- [GET /substrate/v1/state/{pid} — read process state](https://docs.nelieo.com/api-reference/state.md): Fetch the semantic state snapshot for a process — its objects map, action schemas, navigational context, and probe metadata. Cached or fresh on demand.
- [POST /substrate/v1/verify — evaluate a state expression](https://docs.nelieo.com/api-reference/verify.md): Evaluate a JS-style predicate against a tracked process's live state, polling until the condition passes or timeout elapses — no action is dispatched.
- [WS /substrate/v1/watch/{pid} — real-time state stream](https://docs.nelieo.com/api-reference/watch.md): Stream real-time state-change notifications for a tracked process over WebSocket — get changed key lists as they happen, with no REST polling required.
- [Core Concepts: NSP State, Actions, and Runtime Probes](https://docs.nelieo.com/concepts.md): The NSP data model explained: SubstrateState, SSF keys, confidence scores, action schemas, reversibility tiers, runtime probes, and app lifecycle.
- [Authenticating API Requests to the NSP Axon Daemon](https://docs.nelieo.com/daemon/authentication.md): Generate API keys with axon-daemon keygen, pass them via X-Substrate-Key, and configure the keys file and auth settings in axon.toml.
- [NSP Axon Daemon Configuration Reference: axon.toml](https://docs.nelieo.com/daemon/configuration.md): Complete reference for every axon.toml section and AXON_* environment variable, with a full example config and reload instructions.
- [How to Install the NSP Axon Daemon on Windows 10/11](https://docs.nelieo.com/daemon/installation.md): Download and install axon-daemon on Windows using the GUI installer or manually, then verify your setup with the health check endpoint.
- [NSP Axon Daemon: Core Capabilities and Running Modes](https://docs.nelieo.com/daemon/overview.md): Learn what axon-daemon does, how it watches processes, serves the state API on port 7842, streams WebSocket events, and executes actions.
- [Run and Manage the NSP Axon Daemon Windows Service](https://docs.nelieo.com/daemon/windows-service.md): Install, start, stop, and troubleshoot the NSPDaemon Windows Service, including Event Log access and common failure recovery steps.
- [Enable Chrome Remote Debugging for NSP V8 State Probing](https://docs.nelieo.com/guides/chrome-setup.md): Configure Chrome's remote debugging port for NSP V8 state extraction — launch flags, Windows shortcuts, profile isolation, and verification steps.
- [Build a .NET Application Agent Using the CLR Probe](https://docs.nelieo.com/guides/dotnet-agent.md): Build a Python agent for .NET apps with NSP — CLR probe auto-attach, reading WinForms/WPF state, and invoking .NET methods via CLRSessionProxy.
- [Build a Production-Ready Gmail Agent with NSP Python SDK](https://docs.nelieo.com/guides/gmail-agent.md): Build a Gmail agent with NSP: attach to Chrome, read inbox state, send verified replies, archive emails, and stream real-time new-email notifications.
- [Build a Java Application Agent Using the JVM Probe](https://docs.nelieo.com/guides/java-agent.md): Step-by-step guide to building a Python agent for JVM applications — JVMTI auto-attach, reading Java state, and invoking methods using JVMSessionProxy.
- [NSP Production Deployment, Hardening, and Monitoring](https://docs.nelieo.com/guides/production-checklist.md): A step-by-step checklist covering daemon hardening, agent code safety, monitoring, log rotation, key management, and backup for NSP production deployments.
- [React to Live State Changes with WebSocket Streaming](https://docs.nelieo.com/guides/real-time-streaming.md): Use session.watch() to subscribe to NSP state changes, handle StateChangeNotification events, reconnect on drops, and access the raw WebSocket endpoint.
- [NSP: The Live Application Substrate for AI Agent Automation](https://docs.nelieo.com/introduction.md): Learn how NSP attaches to live applications, exposes structured JSON state, and lets AI agents operate software at >99% accuracy without screenshots.
- [ActionRequest: POST /action Request Body Reference](https://docs.nelieo.com/models/action-request.md): Reference for the ActionRequest body sent to POST /action — target process, action name, parameters, and verification fields explained in full.
- [ActionResponse: POST /action Response Body Reference](https://docs.nelieo.com/models/action-response.md): Reference for the ActionResponse object returned by POST /action — success status, return value, execution latency, and optional VerificationResult.
- [ActionSchema: Substrate Action Descriptor Reference](https://docs.nelieo.com/models/action-schema.md): Reference for the ActionSchema object — the typed signature, reversibility tier, parameters, and confidence for a single discoverable substrate action.
- [AppSummary: Tracked Application Status and Metadata](https://docs.nelieo.com/models/app-summary.md): Reference for the AppSummary object returned by GET /apps — probe status, confidence, runtime, and counts for each tracked application.
- [SubstrateState: Application State Snapshot Reference](https://docs.nelieo.com/models/substrate-state.md): Reference for the SubstrateState object — the typed, versioned snapshot of a live application's semantic state returned by GET /state.
- [VerificationResult: Post-Action State Verification Object](https://docs.nelieo.com/models/verification.md): Reference for the VerificationResult object — how NSP evaluates a verify_expression after action dispatch and what the outcome fields mean.
- [CLR / .NET Probe: Managed Heap Walk for .NET Applications](https://docs.nelieo.com/probes/clr.md): How NSP injects a C# bootstrapper via the CLR Hosting API and reads .NET app state over a Memory-Mapped File bridge — no code changes required.
- [JVM / Java Probe: JVMTI State Extraction for Java Apps](https://docs.nelieo.com/probes/jvm.md): How NSP attaches to running Java processes via JVMTI, reads field values and invokes methods using JNI reflection, without an agent JAR or source code.
- [Native / C++ Probe: Memory Reading and Semantic Labeling](https://docs.nelieo.com/probes/native.md): How NSP reads state from native C/C++ apps via ptrace or ReadProcessMemory, then applies Visual-Memory Grounding to assign semantic labels to raw memory.
- [NSP Runtime Probes: How Live State Extraction Works](https://docs.nelieo.com/probes/overview.md): How NSP's four runtime probes attach to live processes, extract semantic state as structured JSON, and transition from cold probe to fast-poll.
- [V8 / JavaScript Probe: Chrome & Electron State Extraction](https://docs.nelieo.com/probes/v8.md): How NSP connects to Chrome and Electron apps via CDP, runs the ASO fast-path extraction, and falls back to a full heap snapshot when needed.
- [Quickstart: Run Your First NSP Agent in Under 5 Minutes](https://docs.nelieo.com/quickstart.md): Install the NSP daemon, connect Chrome's debugging port, read live app state over REST, and execute your first AI agent action with the Python SDK.
- [NSPClient: Connecting to and Controlling the Daemon](https://docs.nelieo.com/sdk/python/client.md): Full reference for NSPClient — constructor parameters, lifecycle management, and every method for listing apps, reading state, and attaching sessions.
- [CLR Session Helpers for .NET Application Automation](https://docs.nelieo.com/sdk/python/clr.md): Use CLRSessionProxy (session.clr) to read .NET fields, invoke managed methods, and walk the CLR heap on any NSPSession attached to a .NET application.
- [Error Handling and the NSP SDK Exception Hierarchy](https://docs.nelieo.com/sdk/python/error-handling.md): Every exception nelieo-nsp raises: when it triggers, which fields it exposes, and recovery patterns including exponential backoff for NSPRateLimitError.
- [Installing the nelieo-nsp Python SDK on Your System](https://docs.nelieo.com/sdk/python/installation.md): Install nelieo-nsp, verify your Python environment, configure API credentials, and confirm the daemon connection with a quick health check.
- [JVM Session Helpers for Java Application Automation](https://docs.nelieo.com/sdk/python/jvm.md): Use JVMSessionProxy (session.jvm) to read Java fields, invoke methods, enumerate loaded classes, and map JVM types to Python for any tracked Java app.
- [nelieo-nsp Python SDK: Package and Symbol Reference](https://docs.nelieo.com/sdk/python/overview.md): Everything exported by nelieo-nsp: NSPClient, NSPSession, CLR/JVM proxies, typed models, enums, streaming, and environment variable configuration.
- [NSPSession: Read Application State and Run Actions](https://docs.nelieo.com/sdk/python/session.md): Full reference for NSPSession — typed state accessors, action execution, cached vs. fresh state, watch streaming, and wait-for condition helpers.
- [Real-Time State Streaming with WebSocket and StateStream](https://docs.nelieo.com/sdk/python/streaming.md): Subscribe to live WebSocket state-change events, filter by changed keys, handle reconnects, and build reactive agents with StateStream and session.watch().
- [NSP Action Safety: Reversibility Tiers and Verification](https://docs.nelieo.com/security/action-safety.md): How NSP's reversibility tiers, confidence gating, verify expressions, and SDK enforcement prevent agents from accidentally executing destructive actions.
- [NSP API Key Management: Generate, Rotate, and Revoke](https://docs.nelieo.com/security/api-keys.md): How to generate NSP API keys with keygen, authenticate every request using the X-Substrate-Key header, configure axon.toml, and safely rotate credentials.
- [NSP Security Model: Auth, Rate Limits, and Action Safety](https://docs.nelieo.com/security/overview.md): A complete guide to NSP's layered security model — localhost binding, API key auth, rate limiting, and action reversibility safety contracts.
- [NSP Rate Limiting: Limits, 429 Handling, and Config](https://docs.nelieo.com/security/rate-limiting.md): Per-endpoint rate limits enforced by NSP, the 429 response format, exponential backoff retry strategy, and axon.toml configuration options.