@vantio/agent-sdk
Advanced tools
+11
-15
| { | ||
| "name": "@vantio/agent-sdk", | ||
| "version": "0.2.3", | ||
| "version": "0.2.4", | ||
| "description": "Vantio Optics Node SDK — shield() for Sight Loop observe. Metadata only; no prompts. Upgrade path to Gate and Phantom Engine.", | ||
@@ -13,5 +13,3 @@ "license": "MIT", | ||
| }, | ||
| "bugs": { | ||
| "url": "https://github.com/vantioai/vantio-open-core/issues" | ||
| }, | ||
| "bugs": { "url": "https://github.com/vantioai/vantio-open-core/issues" }, | ||
| "keywords": [ | ||
@@ -47,5 +45,10 @@ "vantio", | ||
| }, | ||
| "files": [ | ||
| "dist" | ||
| ], | ||
| "files": ["dist"], | ||
| "scripts": { | ||
| "build": "tsc -p tsconfig.esm.json && tsc -p tsconfig.cjs.json && tsc -p tsconfig.types.json && node scripts/postbuild.mjs", | ||
| "typecheck": "tsc -p tsconfig.json --noEmit", | ||
| "typecheck:test": "tsc -p tsconfig.test.json", | ||
| "dev": "tsc -p tsconfig.esm.json --watch", | ||
| "test": "node --experimental-strip-types --test test/*.test.ts" | ||
| }, | ||
| "devDependencies": { | ||
@@ -57,10 +60,3 @@ "@types/node": "^20.0.0", | ||
| "node": ">=18.0.0" | ||
| }, | ||
| "scripts": { | ||
| "build": "tsc -p tsconfig.esm.json && tsc -p tsconfig.cjs.json && tsc -p tsconfig.types.json && node scripts/postbuild.mjs", | ||
| "typecheck": "tsc -p tsconfig.json --noEmit", | ||
| "typecheck:test": "tsc -p tsconfig.test.json", | ||
| "dev": "tsc -p tsconfig.esm.json --watch", | ||
| "test": "node --experimental-strip-types --test test/*.test.ts" | ||
| } | ||
| } | ||
| } |
+12
-12
| # @vantio/agent-sdk | ||
| > Host-level security and governance for autonomous AI agents. | ||
| **Vantio** is the infrastructure control layer for autonomous AI. This package is **Vantio Optics** Observe for Node: a trace ID around your agent. It does not wrap `fetch` by itself — Node wrap lives in [`@vantio/cli`](https://www.npmjs.com/package/@vantio/cli) (`vantio run`). | ||
| Optics does not block on its own. [Gate](https://github.com/vantioai/vantio-pro) enforces rules on the wrapped path. [Phantom Engine](https://github.com/vantioai/vantio-phantom-engine) is runtime protection on enrolled Linux. | ||
| ```bash | ||
@@ -9,6 +11,2 @@ npm install @vantio/agent-sdk | ||
| Standard prompt wrappers and gateways fail when agents run direct terminal commands or raw sockets. To safely deploy autonomous agents, security must run locally at the host level. Vantio moves security from fragile prompt engineering directly into the host operating system, removing the burden of defensive prompt engineering and physically blocking unauthorized actions. | ||
| --- | ||
| ## Quick start | ||
@@ -24,3 +22,3 @@ | ||
| Wrap your agent in `shield()`. Vantio generates a trace ID, propagates it through every async hop in your agent's call tree, and streams metadata to your dashboard — without ever reading your prompts. | ||
| Wrap your agent in `shield()`. Vantio generates a trace ID and propagates it through async hops — without reading your prompts. Node LLM wrap (fetch, undici, http/https, …) is `vantio run` from `@vantio/cli`, not this package. | ||
@@ -31,3 +29,3 @@ --- | ||
| ### `shield(callback, options?)` — canonical interceptor | ||
| ### `shield(callback, options?)` — trace context | ||
@@ -51,3 +49,3 @@ ```ts | ||
| ### `reportAnomaly(event, opts?)` — send metadata to your dashboard | ||
| ### `reportAnomaly(event, opts?)` — send metadata to Gate ingest | ||
@@ -74,3 +72,3 @@ ```ts | ||
| ## Policy & redaction (Vantio Pro) | ||
| ## Policy & redaction (Vantio Gate) | ||
@@ -126,3 +124,3 @@ Enforcement policy is served by the [Vantio Pro](https://github.com/vantioai/vantio-pro) control plane; the SDK applies it **locally** — Vantio is not a network proxy. The SDK ships two building blocks so you can fetch and enforce that policy yourself. | ||
| |---|---| | ||
| | `VANTIO_API_KEY` | Your API key from [vantio.ai/dashboard](https://vantio.ai/dashboard) | | ||
| | `VANTIO_API_KEY` | Gate API key from a trial (`hello@vantio.ai`) or Stripe once live — `/dashboard` redirects to docs | | ||
| | `VANTIO_INGEST_URL` | Ingest endpoint (default: `https://vantio.ai`) | | ||
@@ -134,5 +132,5 @@ | `VANTIO_CLOUD_INGEST` | Set to `true` to enable cloud routing | | ||
| ## Zero-line alternative | ||
| ## Zero-line Node wrap | ||
| No code changes at all — use the CLI: | ||
| No code changes for Node — use the CLI: | ||
@@ -143,2 +141,4 @@ ```bash | ||
| Python needs [`vantio-agent-sdk`](https://pypi.org/project/vantio-agent-sdk) on that interpreter. Prefixing `vantio run python` does not intercept by itself. | ||
| --- | ||
@@ -145,0 +145,0 @@ |
AI-detected potential code anomaly
Supply chain riskAI has identified unusual behaviors that may pose a security risk.
AI-detected potential code anomaly
Supply chain riskAI has identified unusual behaviors that may pose a security risk.
63723
0.41%