@vorionsys/sdk 0.1.0

package/dist/index.js

@@ -0,0 +1,380 @@
+/**
+ * @vorionsys/sdk - Vorion SDK
+ *
+ * Simple, developer-friendly interface for AI agent governance.
+ * Supports both local mode (in-memory) and remote mode (cognigate-api).
+ *
+ * @packageDocumentation
+ */
+import * as crypto from 'node:crypto';
+/**
+ * API Client for cognigate-api
+ */
+class ApiClient {
+    baseUrl;
+    apiKey;
+    timeout;
+    constructor(baseUrl, apiKey, timeout = 30000) {
+        this.baseUrl = baseUrl.replace(/\/$/, ''); // Remove trailing slash
+        this.apiKey = apiKey;
+        this.timeout = timeout;
+    }
+    async request(method, path, body) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(`${this.baseUrl}${path}`, {
+                method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.apiKey}`,
+                },
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const errorData = await response.json().catch(() => ({ error: 'Unknown error' }));
+                throw new Error(`API error ${response.status}: ${errorData.error || errorData.message || 'Unknown'}`);
+            }
+            return await response.json();
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    // Intent endpoints
+    async submitIntent(payload) {
+        return this.request('POST', '/api/v1/intents', payload);
+    }
+    async checkIntent(payload) {
+        return this.request('POST', '/api/v1/intents/check', payload);
+    }
+    // Trust endpoints
+    async admitAgent(payload) {
+        return this.request('POST', '/api/v1/trust/admit', payload);
+    }
+    async getTrustInfo(agentId) {
+        return this.request('GET', `/api/v1/trust/${agentId}`);
+    }
+    async recordSignal(agentId, payload) {
+        return this.request('POST', `/api/v1/trust/${agentId}/signal`, payload);
+    }
+    // Health check
+    async health() {
+        return this.request('GET', '/api/v1/health');
+    }
+}
+/**
+ * Vorion SDK Client
+ *
+ * Simple interface for agent governance.
+ *
+ * @example
+ * ```typescript
+ * // Local mode (in-memory, for testing)
+ * const vorion = new Vorion({ localMode: true });
+ *
+ * // Remote mode (cognigate-api)
+ * const vorion = new Vorion({
+ *   apiEndpoint: 'http://localhost:3000',
+ *   apiKey: 'vorion-dev-key-12345',
+ * });
+ *
+ * const agent = vorion.registerAgent({
+ *   agentId: 'my-agent',
+ *   name: 'My AI Agent',
+ *   capabilities: ['read:*', 'write:*'],
+ * });
+ *
+ * const result = await agent.requestAction({
+ *   type: 'read',
+ *   resource: 'documents/report.pdf',
+ * });
+ *
+ * if (result.allowed) {
+ *   // Perform the action
+ *   await agent.reportSuccess('read');
+ * } else {
+ *   console.log('Denied:', result.reason);
+ * }
+ * ```
+ */
+export class Vorion {
+    config;
+    agents = new Map();
+    apiClient = null;
+    constructor(config = {}) {
+        this.config = {
+            localMode: !config.apiEndpoint,
+            defaultObservationTier: 'GRAY_BOX',
+            timeout: 30000,
+            ...config,
+        };
+        // Initialize API client for remote mode
+        if (!this.config.localMode && this.config.apiEndpoint) {
+            if (!this.config.apiKey) {
+                throw new Error('apiKey is required for remote mode');
+            }
+            this.apiClient = new ApiClient(this.config.apiEndpoint, this.config.apiKey, this.config.timeout);
+        }
+    }
+    /**
+     * Register an agent with the governance system
+     */
+    async registerAgent(options) {
+        const agent = new Agent(this, options);
+        // In remote mode, admit the agent via API
+        if (this.apiClient) {
+            await this.apiClient.admitAgent({
+                agentId: options.agentId,
+                name: options.name,
+                capabilities: options.capabilities ?? [],
+                observationTier: options.observationTier ?? this.config.defaultObservationTier ?? 'GRAY_BOX',
+            });
+        }
+        this.agents.set(options.agentId, agent);
+        return agent;
+    }
+    /**
+     * Get a registered agent by ID
+     */
+    getAgent(agentId) {
+        return this.agents.get(agentId);
+    }
+    /**
+     * Get all registered agents
+     */
+    getAllAgents() {
+        return Array.from(this.agents.values());
+    }
+    /**
+     * Get SDK configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Get the API client (for advanced use)
+     */
+    getApiClient() {
+        return this.apiClient;
+    }
+    /**
+     * Check if running in local mode
+     */
+    isLocalMode() {
+        return this.config.localMode ?? true;
+    }
+    /**
+     * Health check (remote mode only)
+     */
+    async healthCheck() {
+        if (!this.apiClient) {
+            return { status: 'healthy', version: 'local' };
+        }
+        return this.apiClient.health();
+    }
+}
+/**
+ * Agent wrapper for simplified governance interactions
+ */
+export class Agent {
+    sdk;
+    options;
+    localTrustScore = 500; // Start at T3 (Monitored) for local mode
+    actionHistory = [];
+    constructor(sdk, options) {
+        this.sdk = sdk;
+        this.options = {
+            observationTier: sdk.getConfig().defaultObservationTier,
+            capabilities: [],
+            ...options,
+        };
+    }
+    /**
+     * Request permission to perform an action
+     */
+    async requestAction(action) {
+        const apiClient = this.sdk.getApiClient();
+        // Remote mode: call cognigate-api
+        if (apiClient) {
+            const result = await apiClient.submitIntent({
+                agentId: this.options.agentId,
+                agentName: this.options.name,
+                capabilities: this.options.capabilities,
+                observationTier: this.options.observationTier,
+                action,
+            });
+            this.actionHistory.push({
+                action: action.type,
+                allowed: result.allowed,
+                timestamp: Date.now(),
+            });
+            return {
+                allowed: result.allowed,
+                tier: result.tier,
+                reason: result.reason,
+                proofId: result.proofId,
+                constraints: result.constraints,
+                processingTimeMs: result.processingTimeMs,
+            };
+        }
+        // Local mode: simple capability check
+        const proofId = crypto.randomUUID();
+        const hasCapability = this.options.capabilities?.some(cap => cap === '*' ||
+            cap === action.type || // Simple capability (e.g., 'read')
+            cap === `${action.type}:*` ||
+            cap === `${action.type}:${action.resource.split('/')[0]}`) ?? false;
+        const allowed = hasCapability && this.localTrustScore >= 200;
+        if (allowed) {
+            this.localTrustScore = Math.min(1000, this.localTrustScore + 1);
+        }
+        this.actionHistory.push({
+            action: action.type,
+            allowed,
+            timestamp: Date.now(),
+        });
+        return {
+            allowed,
+            tier: allowed ? 'GREEN' : 'RED',
+            reason: allowed
+                ? 'Action permitted'
+                : hasCapability
+                    ? 'Trust score too low'
+                    : `Missing capability: ${action.type}:${action.resource.split('/')[0]}`,
+            proofId,
+            constraints: allowed ? this.getConstraintsForTier() : undefined,
+        };
+    }
+    /**
+     * Report action completion (positive signal)
+     */
+    async reportSuccess(actionType) {
+        const apiClient = this.sdk.getApiClient();
+        if (apiClient) {
+            await apiClient.recordSignal(this.options.agentId, {
+                type: 'success',
+                source: 'sdk',
+                weight: 0.1,
+                context: { actionType },
+            });
+        }
+        else {
+            this.localTrustScore = Math.min(1000, this.localTrustScore + 2);
+        }
+    }
+    /**
+     * Report action failure (negative signal)
+     */
+    async reportFailure(actionType, reason) {
+        const apiClient = this.sdk.getApiClient();
+        if (apiClient) {
+            await apiClient.recordSignal(this.options.agentId, {
+                type: 'failure',
+                source: 'sdk',
+                weight: 0.5,
+                context: { actionType, reason },
+            });
+        }
+        else {
+            this.localTrustScore = Math.max(0, this.localTrustScore - 20);
+        }
+    }
+    /**
+     * Get current trust information
+     */
+    async getTrustInfo() {
+        const apiClient = this.sdk.getApiClient();
+        if (apiClient) {
+            const info = await apiClient.getTrustInfo(this.options.agentId);
+            return {
+                score: info.score ?? 0,
+                tierName: info.tierName ?? 'Unknown',
+                tierNumber: info.tier ?? 0,
+                observationTier: this.options.observationTier ?? 'GRAY_BOX',
+            };
+        }
+        return {
+            score: this.localTrustScore,
+            tierName: this.getTierName(),
+            tierNumber: this.getTierNumber(),
+            observationTier: this.options.observationTier ?? 'GRAY_BOX',
+        };
+    }
+    /**
+     * Get agent ID
+     */
+    getId() {
+        return this.options.agentId;
+    }
+    /**
+     * Get agent name
+     */
+    getName() {
+        return this.options.name;
+    }
+    /**
+     * Get agent capabilities
+     */
+    getCapabilities() {
+        return [...(this.options.capabilities ?? [])];
+    }
+    /**
+     * Get action history
+     */
+    getActionHistory() {
+        return [...this.actionHistory];
+    }
+    getTierNumber() {
+        if (this.localTrustScore < 200)
+            return 0;
+        if (this.localTrustScore < 350)
+            return 1;
+        if (this.localTrustScore < 500)
+            return 2;
+        if (this.localTrustScore < 650)
+            return 3;
+        if (this.localTrustScore < 800)
+            return 4;
+        if (this.localTrustScore < 876)
+            return 5;
+        if (this.localTrustScore < 951)
+            return 6;
+        return 7;
+    }
+    getTierName() {
+        const names = [
+            'Sandbox', // T0
+            'Observed', // T1
+            'Provisional', // T2
+            'Monitored', // T3
+            'Standard', // T4
+            'Trusted', // T5
+            'Certified', // T6
+            'Autonomous', // T7
+        ];
+        return names[this.getTierNumber()] ?? 'Unknown';
+    }
+    getConstraintsForTier() {
+        const tier = this.getTierNumber();
+        if (tier <= 1) {
+            return ['rate_limit:10/min', 'audit:full', 'sandbox:true'];
+        }
+        if (tier <= 3) {
+            return ['rate_limit:100/min', 'audit:standard'];
+        }
+        if (tier <= 5) {
+            return ['rate_limit:1000/min', 'audit:light'];
+        }
+        return []; // T6-T7: minimal constraints
+    }
+}
+/**
+ * Create a new Vorion SDK instance
+ */
+export function createVorion(config) {
+    return new Vorion(config);
+}
+// Default export
+export default Vorion;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@vorionsys/sdk",
+  "version": "0.1.0",
+  "description": "Vorion SDK - Simple interface for AI agent governance",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "pino": "^9.0.0"
+  },
+  "peerDependencies": {
+    "@vorionsys/runtime": ">=0.1.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@vorionsys/runtime": {
+      "optional": false
+    },
+    "typescript": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "vitest": "^2.0.0"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vorionsys/vorion.git",
+    "directory": "packages/sdk"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "governance",
+    "trust",
+    "sdk"
+  ]
+}

package/src/__tests__/sdk.test.ts

@@ -0,0 +1,201 @@
+/**
+ * Vorion SDK Tests
+ */
+
+import { describe, it, expect, beforeEach } from 'vitest';
+import { Vorion, createVorion, Agent } from '../index.js';
+
+describe('Vorion SDK', () => {
+  let vorion: Vorion;
+
+  beforeEach(() => {
+    vorion = createVorion({ localMode: true });
+  });
+
+  describe('Vorion', () => {
+    it('should create SDK instance', () => {
+      expect(vorion).toBeInstanceOf(Vorion);
+    });
+
+    it('should register agents', async () => {
+      const agent = await vorion.registerAgent({
+        agentId: 'test-agent',
+        name: 'Test Agent',
+        capabilities: ['read', 'write'],
+      });
+
+      expect(agent).toBeInstanceOf(Agent);
+      expect(agent.getId()).toBe('test-agent');
+      expect(agent.getName()).toBe('Test Agent');
+    });
+
+    it('should retrieve registered agents', async () => {
+      await vorion.registerAgent({
+        agentId: 'agent-1',
+        name: 'Agent 1',
+      });
+
+      const retrieved = vorion.getAgent('agent-1');
+      expect(retrieved).toBeDefined();
+      expect(retrieved?.getId()).toBe('agent-1');
+    });
+
+    it('should list all agents', async () => {
+      await vorion.registerAgent({ agentId: 'agent-1', name: 'Agent 1' });
+      await vorion.registerAgent({ agentId: 'agent-2', name: 'Agent 2' });
+
+      const agents = vorion.getAllAgents();
+      expect(agents.length).toBe(2);
+    });
+
+    it('should return config', () => {
+      const config = vorion.getConfig();
+      expect(config.localMode).toBe(true);
+      expect(config.defaultObservationTier).toBe('GRAY_BOX');
+    });
+  });
+
+  describe('Agent', () => {
+    let agent: Agent;
+
+    beforeEach(async () => {
+      agent = await vorion.registerAgent({
+        agentId: 'test-agent',
+        name: 'Test Agent',
+        capabilities: ['read', 'write'],
+        observationTier: 'GRAY_BOX',
+      });
+    });
+
+    it('should request actions with capability', async () => {
+      const result = await agent.requestAction({
+        type: 'read',
+        resource: 'documents/test.pdf',
+      });
+
+      expect(result.allowed).toBe(true);
+      expect(result.tier).toBe('GREEN');
+      expect(result.proofId).toBeDefined();
+    });
+
+    it('should deny actions without capability', async () => {
+      const result = await agent.requestAction({
+        type: 'delete', // Not in capabilities
+        resource: 'documents/test.pdf',
+      });
+
+      expect(result.allowed).toBe(false);
+      expect(result.reason).toContain('Missing capability');
+    });
+
+    it('should track action history', async () => {
+      await agent.requestAction({ type: 'read', resource: 'file1.txt' });
+      await agent.requestAction({ type: 'write', resource: 'file2.txt' });
+
+      const history = agent.getActionHistory();
+      expect(history.length).toBe(2);
+      expect(history[0].action).toBe('read');
+      expect(history[1].action).toBe('write');
+    });
+
+    it('should provide trust info', async () => {
+      const trustInfo = await agent.getTrustInfo();
+
+      expect(trustInfo.score).toBe(500); // Default start
+      expect(trustInfo.tierName).toBe('Monitored'); // T3
+      expect(trustInfo.tierNumber).toBe(3);
+      expect(trustInfo.observationTier).toBe('GRAY_BOX');
+    });
+
+    it('should increase trust on success', async () => {
+      const initialTrustInfo = await agent.getTrustInfo();
+      const initialScore = initialTrustInfo.score;
+
+      await agent.reportSuccess('read');
+
+      const newTrustInfo = await agent.getTrustInfo();
+      expect(newTrustInfo.score).toBeGreaterThan(initialScore);
+    });
+
+    it('should decrease trust on failure (asymmetric)', async () => {
+      const initialTrustInfo = await agent.getTrustInfo();
+      const initialScore = initialTrustInfo.score;
+
+      await agent.reportFailure('write', 'Permission denied');
+
+      const newTrustInfo = await agent.getTrustInfo();
+      expect(newTrustInfo.score).toBeLessThan(initialScore);
+      // Asymmetric: failure should decrease more than success increases
+      expect(initialScore - newTrustInfo.score).toBeGreaterThan(10);
+    });
+
+    it('should apply constraints based on tier', async () => {
+      const result = await agent.requestAction({
+        type: 'read',
+        resource: 'documents/test.pdf',
+      });
+
+      expect(result.constraints).toBeDefined();
+      expect(result.constraints?.some((c) => c.includes('rate_limit'))).toBe(true);
+    });
+
+    it('should return capabilities', () => {
+      const caps = agent.getCapabilities();
+      expect(caps).toContain('read');
+      expect(caps).toContain('write');
+    });
+  });
+
+  describe('Trust Tiers', () => {
+    it('should correctly identify tier from score', async () => {
+      const agent = await vorion.registerAgent({
+        agentId: 'tier-test',
+        name: 'Tier Test',
+        capabilities: ['read'],
+      });
+
+      // Default is 500 = T3 Monitored
+      const initialTrustInfo = await agent.getTrustInfo();
+      expect(initialTrustInfo.tierName).toBe('Monitored');
+
+      // Decrease trust significantly
+      for (let i = 0; i < 20; i++) {
+        await agent.reportFailure('read');
+      }
+
+      // Should be at lower tier now
+      const newTrustInfo = await agent.getTrustInfo();
+      expect(newTrustInfo.tierNumber).toBeLessThan(3);
+    });
+  });
+
+  describe('Remote mode configuration', () => {
+    it('should require apiKey for remote mode', () => {
+      expect(() => {
+        new Vorion({
+          apiEndpoint: 'http://localhost:3000',
+          // No apiKey provided
+        });
+      }).toThrow('apiKey is required for remote mode');
+    });
+
+    it('should default to local mode without apiEndpoint', () => {
+      const v = new Vorion({});
+      expect(v.isLocalMode()).toBe(true);
+    });
+
+    it('should enable remote mode with apiEndpoint and apiKey', () => {
+      const v = new Vorion({
+        apiEndpoint: 'http://localhost:3000',
+        apiKey: 'test-key',
+      });
+      expect(v.isLocalMode()).toBe(false);
+    });
+
+    it('should return local health check in local mode', async () => {
+      const health = await vorion.healthCheck();
+      expect(health.status).toBe('healthy');
+      expect(health.version).toBe('local');
+    });
+  });
+});