@nobulex/kova 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stele Labs, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,46 @@
+# Kova
+
+**The trust layer for the agent economy.**
+
+Kova is an open cryptographic protocol (MIT license) that enables AI agents to declare behavioral commitments, prove compliance, and build verifiable reputation across platforms. Single package, one import, 30-minute integration.
+
+## Install
+
+```bash
+npm install kova
+```
+
+## Quick Start
+
+```typescript
+import { withKova } from 'kova';
+
+const server = await withKova(yourMCPServer, 'data-isolation');
+```
+
+Three lines of code. Your MCP server is now wrapped with covenant enforcement.
+
+## Presets
+
+| Preset | Description |
+|--------|-------------|
+| `data-isolation` | Read-only data access, no writes, no network |
+| `read-write` | Read/write to data and output, no network |
+| `network` | Full network access with PII protection |
+| `minimal` | Deny all; audit only |
+
+## Advanced: 3 Primitives
+
+For custom integrations, Kova re-exports the protocol primitives:
+
+- **Identity Binding**: `createIdentity`, `evolveIdentity`
+- **Covenant Declaration**: `buildCovenant`, `verifyCovenant`
+- **Compliance Proof**: `generateComplianceProof`, `Monitor`
+
+```typescript
+import { createIdentity, buildCovenant, generateComplianceProof } from 'kova';
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Kova — The trust layer for the agent economy.
+ */
+
+import type { MCPServer, SteleGuardOptions, WrappedMCPServer } from '@nobulex/mcp';
+
+export type KovaPreset = 'data-isolation' | 'read-write' | 'network' | 'minimal';
+
+export function getPresetConstraints(preset: KovaPreset): string;
+
+export function withKova(
+  server: MCPServer,
+  preset: KovaPreset | string,
+  options?: Partial<SteleGuardOptions>,
+): Promise<WrappedMCPServer>;
+
+export { createIdentity, evolveIdentity } from '@nobulex/identity';
+export { buildCovenant, verifyCovenant } from '@nobulex/core';
+export { generateComplianceProof } from '@nobulex/proof';
+export { Monitor } from '@nobulex/enforcement';
+
+export type { MCPServer, WrappedMCPServer, SteleGuardOptions } from '@nobulex/mcp';

package/dist/index.js

@@ -0,0 +1,84 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Monitor: () => import_enforcement.Monitor,
+  buildCovenant: () => import_core.buildCovenant,
+  createIdentity: () => import_identity.createIdentity,
+  evolveIdentity: () => import_identity.evolveIdentity,
+  generateComplianceProof: () => import_proof.generateComplianceProof,
+  getPresetConstraints: () => getPresetConstraints,
+  verifyCovenant: () => import_core.verifyCovenant,
+  withKova: () => withKova
+});
+module.exports = __toCommonJS(index_exports);
+var import_mcp = require("@nobulex/mcp");
+var import_identity = require("@nobulex/identity");
+var import_core = require("@nobulex/core");
+var import_proof = require("@nobulex/proof");
+var import_enforcement = require("@nobulex/enforcement");
+function getPresetConstraints(preset) {
+  const key = `standard:${preset}`;
+  const ccl = import_mcp.PRESETS[key];
+  if (!ccl) {
+    throw new Error(`Unknown preset: ${preset}. Use 'data-isolation', 'read-write', 'network', or 'minimal'.`);
+  }
+  return ccl;
+}
+async function withKova(server, preset, options) {
+  if (server == null) {
+    throw new Error("withKova: server is required");
+  }
+  if (typeof server !== "object") {
+    throw new Error("withKova: server must be an object with tools and handleToolCall");
+  }
+  if (typeof server.handleToolCall !== "function") {
+    throw new Error(
+      "withKova: server.handleToolCall is required. The MCP server must implement handleToolCall(name, args) => Promise<unknown>"
+    );
+  }
+  if (typeof preset !== "string" || preset.trim() === "") {
+    throw new Error("withKova: preset must be a non-empty string");
+  }
+  const trimmed = preset.trim();
+  const isPreset = ["data-isolation", "read-write", "network", "minimal"].includes(trimmed) || trimmed.startsWith("standard:");
+  const constraints = isPreset ? trimmed.startsWith("standard:") ? trimmed : `standard:${trimmed}` : trimmed;
+  try {
+    return await import_mcp.SteleGuard.wrap(server, { constraints, ...options });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes("CCL") || msg.includes("parse")) {
+      throw new Error(`withKova: invalid CCL constraints. Use a preset ('data-isolation', 'read-write', 'network', 'minimal') or valid CCL. ${msg}`);
+    }
+    throw err;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Monitor,
+  buildCovenant,
+  createIdentity,
+  evolveIdentity,
+  generateComplianceProof,
+  getPresetConstraints,
+  verifyCovenant,
+  withKova
+});

package/dist/index.mjs

@@ -0,0 +1,52 @@
+// src/index.ts
+import { SteleGuard, PRESETS } from "@nobulex/mcp";
+import { createIdentity, evolveIdentity } from "@nobulex/identity";
+import { buildCovenant, verifyCovenant } from "@nobulex/core";
+import { generateComplianceProof } from "@nobulex/proof";
+import { Monitor } from "@nobulex/enforcement";
+function getPresetConstraints(preset) {
+  const key = `standard:${preset}`;
+  const ccl = PRESETS[key];
+  if (!ccl) {
+    throw new Error(`Unknown preset: ${preset}. Use 'data-isolation', 'read-write', 'network', or 'minimal'.`);
+  }
+  return ccl;
+}
+async function withKova(server, preset, options) {
+  if (server == null) {
+    throw new Error("withKova: server is required");
+  }
+  if (typeof server !== "object") {
+    throw new Error("withKova: server must be an object with tools and handleToolCall");
+  }
+  if (typeof server.handleToolCall !== "function") {
+    throw new Error(
+      "withKova: server.handleToolCall is required. The MCP server must implement handleToolCall(name, args) => Promise<unknown>"
+    );
+  }
+  if (typeof preset !== "string" || preset.trim() === "") {
+    throw new Error("withKova: preset must be a non-empty string");
+  }
+  const trimmed = preset.trim();
+  const isPreset = ["data-isolation", "read-write", "network", "minimal"].includes(trimmed) || trimmed.startsWith("standard:");
+  const constraints = isPreset ? trimmed.startsWith("standard:") ? trimmed : `standard:${trimmed}` : trimmed;
+  try {
+    return await SteleGuard.wrap(server, { constraints, ...options });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes("CCL") || msg.includes("parse")) {
+      throw new Error(`withKova: invalid CCL constraints. Use a preset ('data-isolation', 'read-write', 'network', 'minimal') or valid CCL. ${msg}`);
+    }
+    throw err;
+  }
+}
+export {
+  Monitor,
+  buildCovenant,
+  createIdentity,
+  evolveIdentity,
+  generateComplianceProof,
+  getPresetConstraints,
+  verifyCovenant,
+  withKova
+};

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@nobulex/kova",
+  "version": "0.2.1",
+  "description": "Open cryptographic protocol (MIT) \u2014 the trust layer for the agent economy. AI agents declare behavioral commitments, prove compliance, build verifiable reputation.",
+  "sideEffects": false,
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "module": "dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm && node -e \"require('fs').copyFileSync('src/index.d.ts','dist/index.d.ts')\"",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@nobulex/cli": "0.2.0",
+    "@nobulex/sdk": "0.2.0",
+    "@nobulex/mcp": "0.2.0",
+    "@nobulex/enforcement": "0.2.0",
+    "@nobulex/core": "0.2.0",
+    "@nobulex/ccl": "0.2.0",
+    "@nobulex/crypto": "0.2.0",
+    "@nobulex/identity": "0.2.0",
+    "@nobulex/proof": "0.2.0",
+    "@nobulex/store": "0.2.0",
+    "@nobulex/verifier": "0.2.0"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nobulexdev/nobulex.git",
+    "directory": "packages/kova"
+  },
+  "homepage": "https://nobulex.com",
+  "bugs": {
+    "url": "https://github.com/nobulexdev/nobulex/issues"
+  },
+  "author": "Nobulex Labs, Inc.",
+  "keywords": [
+    "kova",
+    "trust",
+    "agent",
+    "accountability",
+    "mcp",
+    "covenant"
+  ],
+  "bin": {
+    "kova": "./scripts/kova.js"
+  }
+}

package/scripts/kova.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Kova CLI launcher — runs the Stele CLI (stele audit, stele init, etc.)
+ * so users can run `kova audit` instead of `stele audit`.
+ */
+require('@nobulex/cli');