@vorionsys/atsf-core 0.1.0

package/README.md

@@ -0,0 +1,308 @@
+# @vorion/atsf-core
+
+Agentic Trust Scoring Framework - Core runtime for AI agent governance, trust scoring, and policy enforcement.
+
+## Installation
+
+```bash
+npm install @vorion/atsf-core
+```
+
+## Quick Start
+
+```typescript
+import {
+  TrustEngine,
+  createTrustEngine,
+  IntentService,
+  createIntentService,
+  EnforcementService,
+  createEnforcementService,
+} from '@vorion/atsf-core';
+
+// Create a trust engine
+const trustEngine = createTrustEngine();
+
+// Initialize an agent with trust
+const agent = await trustEngine.initializeEntity('agent-001', 1);
+console.log(agent.score); // 200 (L1 minimum)
+
+// Record behavioral signals
+await trustEngine.recordSignal({
+  id: crypto.randomUUID(),
+  entityId: 'agent-001',
+  type: 'behavioral.task_completed',
+  value: 0.9,
+  source: 'system',
+  timestamp: new Date().toISOString(),
+  metadata: {},
+});
+
+// Get updated score
+const record = await trustEngine.getScore('agent-001');
+console.log(record?.score, record?.level);
+```
+
+## Modules
+
+### Trust Engine
+
+0-1000 trust scoring with 6 tiers, time-based decay, and accelerated decay on failure.
+
+```typescript
+import { TrustEngine, createTrustEngine } from '@vorion/atsf-core';
+
+// Basic usage
+const engine = createTrustEngine();
+
+// With full configuration
+const configuredEngine = createTrustEngine({
+  decayRate: 0.01,              // 1% decay per interval
+  decayIntervalMs: 60000,       // 1 minute intervals
+  failureThreshold: 0.3,        // Signals below 0.3 = failure
+  acceleratedDecayMultiplier: 3.0, // 3x decay on failure
+  failureWindowMs: 3600000,     // 1 hour failure window
+  minFailuresForAcceleration: 2,// 2+ failures = accelerated
+});
+```
+
+### BASIS Rule Engine
+
+Constraint evaluation for governance policies.
+
+```typescript
+import { createEvaluator, parseNamespace } from '@vorion/atsf-core';
+
+const evaluator = createEvaluator();
+evaluator.registerNamespace(parseNamespace(ruleDefinition));
+const result = await evaluator.evaluate(context);
+```
+
+### Intent Service
+
+Submit and track agent intents through the governance pipeline.
+
+```typescript
+import { createIntentService } from '@vorion/atsf-core';
+
+const intentService = createIntentService();
+const intent = await intentService.submit({
+  entityId: 'agent-001',
+  goal: 'Send email to user',
+  context: { recipient: 'user@example.com' },
+});
+```
+
+### Enforcement Service
+
+Policy decision point for allow/deny/escalate decisions.
+
+```typescript
+import { createEnforcementService } from '@vorion/atsf-core';
+
+const enforcer = createEnforcementService({
+  defaultAction: 'deny',
+  requireMinTrustLevel: 2,
+});
+const decision = await enforcer.decide(context);
+```
+
+### Proof Service
+
+Immutable audit chain with SHA-256 hashing.
+
+```typescript
+import { createProofService } from '@vorion/atsf-core';
+
+const proofService = createProofService();
+const proof = await proofService.create({ intent, decision, inputs, outputs });
+const verification = await proofService.verify(proof.id);
+```
+
+### Cognigate Runtime
+
+Constrained execution with resource limits.
+
+```typescript
+import { createGateway } from '@vorion/atsf-core';
+
+const gateway = createGateway({
+  maxMemoryMb: 256,
+  timeoutMs: 30000,
+});
+gateway.registerHandler('email', emailHandler);
+const result = await gateway.execute(context);
+```
+
+## Trust Levels (6 Tiers)
+
+| Level | Name | Score Range |
+|-------|------|-------------|
+| 0 | Untrusted | 0-166 |
+| 1 | Observed | 167-332 |
+| 2 | Limited | 333-499 |
+| 3 | Standard | 500-665 |
+| 4 | Trusted | 666-832 |
+| 5 | Certified | 833-1000 |
+
+## Events
+
+The Trust Engine extends `EventEmitter` and emits the following events:
+
+```typescript
+import { TrustEngine } from '@vorion/atsf-core';
+
+const engine = new TrustEngine();
+
+// Listen for all trust events
+engine.on('trust:*', (event) => {
+  console.log('Trust event:', event);
+});
+
+// Listen for specific events
+engine.on('trust:initialized', (event) => {
+  console.log(`Entity ${event.entityId} initialized at L${event.initialLevel}`);
+});
+
+engine.on('trust:tier_changed', (event) => {
+  console.log(`${event.entityId} ${event.direction}: ${event.previousLevelName} → ${event.newLevelName}`);
+});
+
+engine.on('trust:decay_applied', (event) => {
+  console.log(`Decay: ${event.entityId} lost ${event.decayAmount} points`);
+});
+
+engine.on('trust:score_changed', (event) => {
+  console.log(`Score: ${event.entityId} changed by ${event.delta}`);
+});
+
+engine.on('trust:signal_recorded', (event) => {
+  console.log(`Signal: ${event.signal.type} for ${event.entityId}`);
+});
+```
+
+### Event Types
+
+| Event | Description |
+|-------|-------------|
+| `trust:initialized` | New entity registered |
+| `trust:signal_recorded` | Behavioral signal recorded |
+| `trust:score_changed` | Score changed by ≥5 points |
+| `trust:tier_changed` | Entity promoted or demoted |
+| `trust:decay_applied` | Trust decayed due to staleness (includes `accelerated` flag) |
+| `trust:failure_detected` | Low-value signal detected as failure |
+| `trust:*` | Wildcard - all events |
+
+### Accelerated Decay
+
+When an entity accumulates failures (signals with value < 0.3), the decay rate increases:
+
+```typescript
+engine.on('trust:failure_detected', (event) => {
+  console.log(`Failure #${event.failureCount} for ${event.entityId}`);
+  if (event.acceleratedDecayActive) {
+    console.log('Accelerated decay is now active (3x normal rate)');
+  }
+});
+
+engine.on('trust:decay_applied', (event) => {
+  if (event.accelerated) {
+    console.log(`Accelerated decay: -${event.decayAmount} points`);
+  }
+});
+
+// Check status
+const isAccelerated = engine.isAcceleratedDecayActive('agent-001');
+const failureCount = engine.getFailureCount('agent-001');
+```
+
+## Persistence
+
+Trust records can be persisted using pluggable storage backends:
+
+```typescript
+import {
+  createTrustEngine,
+  createFileProvider,
+  createMemoryProvider,
+} from '@vorion/atsf-core';
+
+// File-based persistence
+const fileProvider = createFileProvider({
+  path: './trust-records.json',
+  autoSaveIntervalMs: 5000, // Auto-save every 5 seconds
+});
+await fileProvider.initialize();
+
+const engine = createTrustEngine({
+  persistence: fileProvider,
+  autoPersist: true, // Auto-save on changes
+});
+
+// Load existing records
+await engine.loadFromPersistence();
+
+// Records are automatically saved on changes
+await engine.initializeEntity('agent-001', 2);
+
+// Manual save/close
+await engine.saveToPersistence();
+await engine.close();
+```
+
+Available providers:
+- `MemoryPersistenceProvider` - Fast, non-persistent (default)
+- `FilePersistenceProvider` - JSON file storage
+
+## LangChain Integration
+
+Integrate trust scoring with LangChain agents:
+
+```typescript
+import {
+  createTrustEngine,
+  createTrustAwareExecutor,
+  createTrustTools,
+} from '@vorion/atsf-core';
+
+// Create trust-aware executor
+const engine = createTrustEngine();
+const executor = createTrustAwareExecutor(engine, {
+  agentId: 'my-agent',
+  initialTrustLevel: 2,
+  minTrustLevel: 2,
+  recordToolUsage: true,
+  recordLlmCalls: true,
+  recordErrors: true,
+});
+await executor.initialize();
+
+// Use callback handler with LangChain
+const callbacks = [executor.callbackHandler];
+
+// Execute with trust gating
+const result = await executor.execute(async () => {
+  // Your agent execution here
+  return await agent.invoke({ input: 'Hello' }, { callbacks });
+});
+
+console.log(result.trustCheck.allowed);
+console.log(result.finalScore);
+
+// Add trust tools to your agent
+const trustTools = createTrustTools(engine, 'my-agent');
+// Tools: check_my_trust, check_trust_requirements, get_trust_levels,
+//        report_task_success, report_task_failure
+```
+
+### Trust-Aware Execution Flow
+
+1. **Check Trust** - Verify agent has sufficient trust level
+2. **Execute** - Run the agent with callback tracking
+3. **Record Signals** - Tool/LLM success/failure recorded automatically
+4. **Update Score** - Trust score updates based on behavior
+5. **Return Context** - Execution result includes trust state
+
+## License
+
+MIT

package/dist/api/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * API module exports
+ */
+export * from './server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,5 @@
+/**
+ * API module exports
+ */
+export * from './server.js';
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC"}

package/dist/api/server.d.ts

@@ -0,0 +1,17 @@
+/**
+ * API Server
+ *
+ * Fastify server providing REST API for Vorion platform.
+ *
+ * @packageDocumentation
+ */
+import { FastifyInstance } from 'fastify';
+/**
+ * Create and configure the API server
+ */
+export declare function createServer(): Promise<FastifyInstance>;
+/**
+ * Start the API server
+ */
+export declare function startServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/api/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/api/server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AASnD;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC,CAyG7D;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAsBjD"}

package/dist/api/server.js

@@ -0,0 +1,124 @@
+/**
+ * API Server
+ *
+ * Fastify server providing REST API for Vorion platform.
+ *
+ * @packageDocumentation
+ */
+import Fastify from 'fastify';
+import cors from '@fastify/cors';
+import helmet from '@fastify/helmet';
+import rateLimit from '@fastify/rate-limit';
+import { createLogger, logger } from '../common/logger.js';
+import { getConfig } from '../common/config.js';
+const apiLogger = createLogger({ component: 'api' });
+/**
+ * Create and configure the API server
+ */
+export async function createServer() {
+    const config = getConfig();
+    const server = Fastify({
+        logger: logger,
+        requestIdHeader: 'x-request-id',
+        requestIdLogLabel: 'requestId',
+    });
+    // Register plugins
+    await server.register(cors, {
+        origin: config.env === 'production' ? false : true,
+        credentials: true,
+    });
+    await server.register(helmet, {
+        contentSecurityPolicy: config.env === 'production',
+    });
+    await server.register(rateLimit, {
+        max: config.api.rateLimit,
+        timeWindow: '1 minute',
+    });
+    // Health check endpoint
+    server.get('/health', async () => ({
+        status: 'healthy',
+        version: process.env['npm_package_version'],
+        environment: config.env,
+        timestamp: new Date().toISOString(),
+    }));
+    // Ready check endpoint
+    server.get('/ready', async () => ({
+        status: 'ready',
+        checks: {
+            database: 'ok', // TODO: Implement actual checks
+            redis: 'ok',
+            proof: 'ok',
+        },
+    }));
+    // API routes
+    server.register(async (api) => {
+        // Intent routes
+        api.post('/intents', async (_request, _reply) => {
+            // TODO: Implement intent submission
+            return { message: 'Intent submission - not implemented' };
+        });
+        api.get('/intents/:id', async (_request, _reply) => {
+            // TODO: Implement intent retrieval
+            return { message: 'Intent retrieval - not implemented' };
+        });
+        // Proof routes
+        api.get('/proofs/:id', async (_request, _reply) => {
+            // TODO: Implement proof retrieval
+            return { message: 'Proof retrieval - not implemented' };
+        });
+        api.post('/proofs/:id/verify', async (_request, _reply) => {
+            // TODO: Implement proof verification
+            return { message: 'Proof verification - not implemented' };
+        });
+        // Trust routes
+        api.get('/trust/:entityId', async (_request, _reply) => {
+            // TODO: Implement trust retrieval
+            return { message: 'Trust retrieval - not implemented' };
+        });
+        // Constraint routes
+        api.post('/constraints/validate', async (_request, _reply) => {
+            // TODO: Implement constraint validation
+            return { message: 'Constraint validation - not implemented' };
+        });
+    }, { prefix: config.api.basePath });
+    // Error handler
+    server.setErrorHandler((error, request, reply) => {
+        apiLogger.error({
+            error: error.message,
+            stack: error.stack,
+            requestId: request.id,
+        }, 'Request error');
+        reply.status(error.statusCode ?? 500).send({
+            error: {
+                code: error.code ?? 'INTERNAL_ERROR',
+                message: config.env === 'production'
+                    ? 'An error occurred'
+                    : error.message,
+            },
+        });
+    });
+    return server;
+}
+/**
+ * Start the API server
+ */
+export async function startServer() {
+    const config = getConfig();
+    const server = await createServer();
+    try {
+        await server.listen({
+            port: config.api.port,
+            host: config.api.host,
+        });
+        apiLogger.info({
+            port: config.api.port,
+            host: config.api.host,
+            environment: config.env,
+        }, 'Server started');
+    }
+    catch (error) {
+        apiLogger.error({ error }, 'Failed to start server');
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/api/server.js.map

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

package/dist/arbitration/index.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Multi-Agent Trust Arbitration Engine
+ *
+ * Resolves trust conflicts between agents using weighted voting,
+ * consensus building, and cross-agent confidence decay.
+ *
+ * @packageDocumentation
+ */
+import type { ID, TrustLevel } from '../common/types.js';
+import type { ArbitrationAgent, ArbitrationVote, TrustConflict, ArbitrationResult, ArbitrationMethod, ArbitrationConfig, ArbitrationRequest, ArbitrationQuery, AgentRole } from './types.js';
+export * from './types.js';
+/**
+ * Trust Arbitration Engine
+ */
+export declare class TrustArbitrationEngine {
+    private config;
+    private history;
+    private agents;
+    constructor(config?: Partial<ArbitrationConfig>);
+    /**
+     * Register an agent for arbitration
+     */
+    registerAgent(agent: ArbitrationAgent): void;
+    /**
+     * Unregister an agent
+     */
+    unregisterAgent(agentId: ID): void;
+    /**
+     * Get a registered agent
+     */
+    getAgent(agentId: ID): ArbitrationAgent | undefined;
+    /**
+     * Arbitrate a trust conflict
+     */
+    arbitrate(request: ArbitrationRequest): Promise<ArbitrationResult>;
+    /**
+     * Weighted majority voting
+     */
+    private arbitrateWeightedMajority;
+    /**
+     * Unanimous voting (all must agree)
+     */
+    private arbitrateUnanimous;
+    /**
+     * Supervisor override - supervisor agent makes final call
+     */
+    private arbitrateSupervisorOverride;
+    /**
+     * Consensus building - iterative discussion
+     */
+    private arbitrateConsensusBuilding;
+    /**
+     * Escalate to human decision-maker
+     */
+    private arbitrateEscalateHuman;
+    /**
+     * Default to deny (most restrictive)
+     */
+    private arbitrateDefaultDeny;
+    /**
+     * Collect votes from initial positions
+     */
+    private collectVotes;
+    /**
+     * Apply confidence decay based on disagreement
+     */
+    private applyConfidenceDecay;
+    /**
+     * Create the final decision
+     */
+    private createDecision;
+    /**
+     * Generate explanation for decision
+     */
+    private generateExplanation;
+    /**
+     * Generate conditions that would invalidate the decision
+     */
+    private generateInvalidityConditions;
+    /**
+     * Calculate consensus metrics
+     */
+    private calculateConsensusMetrics;
+    /**
+     * Simulate vote adjustment in consensus building
+     */
+    private simulateVoteAdjustment;
+    /**
+     * Update agent accuracy based on arbitration result
+     */
+    private updateAgentAccuracy;
+    /**
+     * Query arbitration history
+     */
+    query(query: ArbitrationQuery): Promise<ArbitrationResult[]>;
+    /**
+     * Get arbitration statistics
+     */
+    getStats(): {
+        totalArbitrations: number;
+        byMethod: Record<ArbitrationMethod, number>;
+        consensusRate: number;
+        averageDurationMs: number;
+        agentCount: number;
+    };
+}
+/**
+ * Create a new trust arbitration engine
+ */
+export declare function createTrustArbitrationEngine(config?: Partial<ArbitrationConfig>): TrustArbitrationEngine;
+/**
+ * Helper to create an arbitration agent
+ */
+export declare function createArbitrationAgent(agentId: ID, name: string, options: {
+    trustScore: number;
+    trustLevel: TrustLevel;
+    role: AgentRole;
+    historicalAccuracy?: number;
+}): ArbitrationAgent;
+/**
+ * Helper to create a trust conflict
+ */
+export declare function createTrustConflict(conflictType: TrustConflict['conflictType'], subject: TrustConflict['subject'], agents: ArbitrationAgent[], initialPositions: ArbitrationVote[]): TrustConflict;
+//# sourceMappingURL=index.d.ts.map

package/dist/arbitration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/arbitration/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,EAAE,EAAE,UAAU,EAAiB,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,iBAAiB,EAGjB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAIhB,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,cAAc,YAAY,CAAC;AAiC3B;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,MAAM,CAAwC;gBAE1C,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM;IAInD;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAY5C;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI;IAIlC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,EAAE,GAAG,gBAAgB,GAAG,SAAS;IAInD;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgExE;;OAEG;YACW,yBAAyB;IAoEvC;;OAEG;YACW,kBAAkB;IAiDhC;;OAEG;YACW,2BAA2B;IAgDzC;;OAEG;YACW,0BAA0B;IAoExC;;OAEG;YACW,sBAAsB;IAgCpC;;OAEG;YACW,oBAAoB;IAgClC;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAsF5B;;OAEG;IACH,OAAO,CAAC,cAAc;IA8BtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAmBpC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA2CjC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAkB9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAsClE;;OAEG;IACH,QAAQ,IAAI;QACV,iBAAiB,EAAE,MAAM,CAAC;QAC1B,QAAQ,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;QAC5C,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;KACpB;CA6BF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,sBAAsB,CAExB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,EAAE,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,GACA,gBAAgB,CAWlB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,aAAa,CAAC,cAAc,CAAC,EAC3C,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,EACjC,MAAM,EAAE,gBAAgB,EAAE,EAC1B,gBAAgB,EAAE,eAAe,EAAE,GAClC,aAAa,CAef"}