@vorionsys/sdk 0.1.0

package/dist/__tests__/sdk.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Vorion SDK Tests
+ */
+export {};
+//# sourceMappingURL=sdk.test.d.ts.map

package/dist/__tests__/sdk.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sdk.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/__tests__/sdk.test.js

@@ -0,0 +1,164 @@
+/**
+ * Vorion SDK Tests
+ */
+import { describe, it, expect, beforeEach } from 'vitest';
+import { Vorion, createVorion, Agent } from '../index.js';
+describe('Vorion SDK', () => {
+    let 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;
+        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');
+        });
+    });
+});
+//# sourceMappingURL=sdk.test.js.map

package/dist/__tests__/sdk.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,282 @@
+/**
+ * @vorionsys/sdk - Vorion SDK
+ *
+ * Simple, developer-friendly interface for AI agent governance.
+ * Supports both local mode (in-memory) and remote mode (cognigate-api).
+ *
+ * @packageDocumentation
+ */
+export type { TrustTier, DecisionTier, AgentCredentials, Action, TrustSignal, } from '@vorionsys/runtime';
+/**
+ * SDK Configuration
+ */
+export interface VorionConfig {
+    /** API endpoint for hosted Cognigate */
+    apiEndpoint?: string;
+    /** API key for authentication */
+    apiKey?: string;
+    /** Default observation tier for agents */
+    defaultObservationTier?: 'BLACK_BOX' | 'GRAY_BOX' | 'WHITE_BOX';
+    /** Enable local mode (no API calls). If false and apiEndpoint is provided, uses remote mode. */
+    localMode?: boolean;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+}
+/**
+ * Agent registration options
+ */
+export interface AgentOptions {
+    /** Unique agent identifier */
+    agentId: string;
+    /** Human-readable name */
+    name: string;
+    /** Agent capabilities/permissions */
+    capabilities?: string[];
+    /** Observation tier */
+    observationTier?: 'BLACK_BOX' | 'GRAY_BOX' | 'WHITE_BOX';
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result of an action request
+ */
+export interface ActionResult {
+    /** Whether the action was allowed */
+    allowed: boolean;
+    /** Decision tier (GREEN/YELLOW/RED) */
+    tier: 'GREEN' | 'YELLOW' | 'RED';
+    /** Human-readable reason */
+    reason: string;
+    /** Proof commitment ID for audit */
+    proofId: string;
+    /** Any constraints applied */
+    constraints?: string[];
+    /** Processing time in ms (remote mode only) */
+    processingTimeMs?: number;
+}
+/**
+ * Trust score information
+ */
+export interface TrustInfo {
+    /** Current trust score (0-1000) */
+    score: number;
+    /** Trust tier name */
+    tierName: string;
+    /** Trust tier number (0-7) */
+    tierNumber: number;
+    /** Observation tier */
+    observationTier: string;
+}
+/**
+ * API Client for cognigate-api
+ */
+declare class ApiClient {
+    private baseUrl;
+    private apiKey;
+    private timeout;
+    constructor(baseUrl: string, apiKey: string, timeout?: number);
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+    submitIntent(payload: {
+        agentId: string;
+        agentName?: string;
+        capabilities?: string[];
+        observationTier?: string;
+        action: {
+            type: string;
+            resource: string;
+            parameters?: Record<string, unknown>;
+        };
+    }): Promise<{
+        intentId: string;
+        allowed: boolean;
+        tier: string;
+        reason: string;
+        proofId: string;
+        constraints?: string[] | undefined;
+        processingTimeMs: number;
+    }>;
+    checkIntent(payload: {
+        agentId: string;
+        agentName?: string;
+        capabilities?: string[];
+        observationTier?: string;
+        action: {
+            type: string;
+            resource: string;
+        };
+    }): Promise<{
+        wouldAllow: boolean;
+        tier: string;
+        reason: string;
+    }>;
+    admitAgent(payload: {
+        agentId: string;
+        name: string;
+        capabilities: string[];
+        observationTier: string;
+    }): Promise<{
+        admitted: boolean;
+        initialTier: number;
+        initialScore: number;
+        observationCeiling: number;
+        capabilities: string[];
+        expiresAt: string;
+        reason?: string | undefined;
+    }>;
+    getTrustInfo(agentId: string): Promise<{
+        agentId: string;
+        score: number | null;
+        tier: number | null;
+        tierName: string | null;
+        observationCeiling?: number | undefined;
+        message?: string | undefined;
+    }>;
+    recordSignal(agentId: string, payload: {
+        type: 'success' | 'failure' | 'violation' | 'neutral';
+        source: string;
+        weight?: number;
+        context?: Record<string, unknown>;
+    }): Promise<{
+        accepted: boolean;
+        scoreBefore: number;
+        scoreAfter: number;
+        change: number;
+        newTier: number | null;
+        newTierName: string | null;
+    }>;
+    health(): Promise<{
+        status: string;
+        version: string;
+    }>;
+}
+/**
+ * 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 declare class Vorion {
+    private config;
+    private agents;
+    private apiClient;
+    constructor(config?: VorionConfig);
+    /**
+     * Register an agent with the governance system
+     */
+    registerAgent(options: AgentOptions): Promise<Agent>;
+    /**
+     * Get a registered agent by ID
+     */
+    getAgent(agentId: string): Agent | undefined;
+    /**
+     * Get all registered agents
+     */
+    getAllAgents(): Agent[];
+    /**
+     * Get SDK configuration
+     */
+    getConfig(): VorionConfig;
+    /**
+     * Get the API client (for advanced use)
+     */
+    getApiClient(): ApiClient | null;
+    /**
+     * Check if running in local mode
+     */
+    isLocalMode(): boolean;
+    /**
+     * Health check (remote mode only)
+     */
+    healthCheck(): Promise<{
+        status: string;
+        version: string;
+    }>;
+}
+/**
+ * Agent wrapper for simplified governance interactions
+ */
+export declare class Agent {
+    private sdk;
+    private options;
+    private localTrustScore;
+    private actionHistory;
+    constructor(sdk: Vorion, options: AgentOptions);
+    /**
+     * Request permission to perform an action
+     */
+    requestAction(action: {
+        type: string;
+        resource: string;
+        parameters?: Record<string, unknown>;
+    }): Promise<ActionResult>;
+    /**
+     * Report action completion (positive signal)
+     */
+    reportSuccess(actionType: string): Promise<void>;
+    /**
+     * Report action failure (negative signal)
+     */
+    reportFailure(actionType: string, reason?: string): Promise<void>;
+    /**
+     * Get current trust information
+     */
+    getTrustInfo(): Promise<TrustInfo>;
+    /**
+     * Get agent ID
+     */
+    getId(): string;
+    /**
+     * Get agent name
+     */
+    getName(): string;
+    /**
+     * Get agent capabilities
+     */
+    getCapabilities(): string[];
+    /**
+     * Get action history
+     */
+    getActionHistory(): Array<{
+        action: string;
+        allowed: boolean;
+        timestamp: number;
+    }>;
+    private getTierNumber;
+    private getTierName;
+    private getConstraintsForTier;
+}
+/**
+ * Create a new Vorion SDK instance
+ */
+export declare function createVorion(config?: VorionConfig): Vorion;
+export default Vorion;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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