@vorionsys/atsf-core 0.2.2 → 0.2.4

package/dist/crewai/callback.js

@@ -0,0 +1,271 @@
+/**
+ * CrewAI Trust Callback Handler
+ *
+ * Records crew agent behavior as trust signals during CrewAI execution.
+ *
+ * @packageDocumentation
+ */
+import { createLogger } from '../common/logger.js';
+const logger = createLogger({ component: 'crewai-callback' });
+/**
+ * Default signal weights for crew operations
+ */
+const DEFAULT_WEIGHTS = {
+    taskSuccess: 0.85,
+    taskFailure: 0.1,
+    delegationSuccess: 0.8,
+    delegationFailure: 0.15,
+    crewSuccess: 0.9,
+    crewFailure: 0.1,
+};
+/**
+ * CrewAI callback handler for trust signal recording
+ *
+ * This handler tracks crew agent behavior and records trust signals
+ * for task execution, delegation, and crew-level events.
+ */
+export class CrewTrustCallbackHandler {
+    trustEngine;
+    config;
+    signalCount = 0;
+    startTimes = new Map();
+    constructor(trustEngine, config) {
+        this.trustEngine = trustEngine;
+        this.config = {
+            agentId: config.agentId,
+            role: config.role,
+            goal: config.goal ?? '',
+            initialTrustLevel: config.initialTrustLevel ?? 1,
+            minTrustLevel: config.minTrustLevel ?? 1,
+            allowDelegation: config.allowDelegation ?? true,
+            recordTaskExecution: config.recordTaskExecution ?? true,
+            recordDelegation: config.recordDelegation ?? true,
+            recordErrors: config.recordErrors ?? true,
+            signalWeights: {
+                ...DEFAULT_WEIGHTS,
+                ...config.signalWeights,
+            },
+        };
+    }
+    /**
+     * Get the agent ID
+     */
+    get agentId() {
+        return this.config.agentId;
+    }
+    /**
+     * Get the agent role
+     */
+    get role() {
+        return this.config.role;
+    }
+    /**
+     * Get the number of signals recorded
+     */
+    get signalsRecorded() {
+        return this.signalCount;
+    }
+    /**
+     * Initialize the agent in the trust engine if not exists
+     */
+    async initialize() {
+        const existing = await this.trustEngine.getScore(this.config.agentId);
+        if (!existing) {
+            await this.trustEngine.initializeEntity(this.config.agentId, this.config.initialTrustLevel);
+            logger.info({ agentId: this.config.agentId, role: this.config.role }, 'Initialized trust for crew agent');
+        }
+    }
+    /**
+     * Record a trust signal
+     */
+    async recordSignal(source) {
+        const weights = this.config.signalWeights;
+        let value;
+        let signalType;
+        switch (source.event) {
+            case 'task_end':
+                value = weights.taskSuccess ?? DEFAULT_WEIGHTS.taskSuccess;
+                signalType = `behavioral.task_success.${source.taskId ?? 'unknown'}`;
+                break;
+            case 'task_error':
+                value = weights.taskFailure ?? DEFAULT_WEIGHTS.taskFailure;
+                signalType = `behavioral.task_failure.${source.taskId ?? 'unknown'}`;
+                break;
+            case 'delegation_end':
+                value = weights.delegationSuccess ?? DEFAULT_WEIGHTS.delegationSuccess;
+                signalType = `behavioral.delegation_success.${source.targetAgentId ?? 'unknown'}`;
+                break;
+            case 'delegation_error':
+                value = weights.delegationFailure ?? DEFAULT_WEIGHTS.delegationFailure;
+                signalType = `behavioral.delegation_failure.${source.targetAgentId ?? 'unknown'}`;
+                break;
+            case 'crew_end':
+                value = weights.crewSuccess ?? DEFAULT_WEIGHTS.crewSuccess;
+                signalType = `behavioral.crew_success.${source.crewId ?? 'unknown'}`;
+                break;
+            case 'crew_error':
+                value = weights.crewFailure ?? DEFAULT_WEIGHTS.crewFailure;
+                signalType = `behavioral.crew_failure.${source.crewId ?? 'unknown'}`;
+                break;
+            default:
+                return; // Don't record start events as signals
+        }
+        const signal = {
+            id: crypto.randomUUID(),
+            entityId: source.agentId ?? this.config.agentId,
+            type: signalType,
+            value,
+            source: 'crewai',
+            timestamp: new Date().toISOString(),
+            metadata: {
+                event: source.event,
+                taskId: source.taskId,
+                agentId: source.agentId,
+                targetAgentId: source.targetAgentId,
+                crewId: source.crewId,
+                duration: source.duration,
+                error: source.error?.message,
+                role: this.config.role,
+            },
+        };
+        await this.trustEngine.recordSignal(signal);
+        this.signalCount++;
+        logger.debug({ signal }, 'Recorded trust signal from CrewAI');
+    }
+    /**
+     * Start tracking execution time
+     */
+    startTimer(runId) {
+        this.startTimes.set(runId, Date.now());
+    }
+    /**
+     * Get elapsed time and clear timer
+     */
+    endTimer(runId) {
+        const startTime = this.startTimes.get(runId);
+        this.startTimes.delete(runId);
+        return startTime ? Date.now() - startTime : 0;
+    }
+    // ============================================
+    // Task Lifecycle
+    // ============================================
+    /**
+     * Called when a task starts
+     */
+    async handleTaskStart(taskId, runId) {
+        if (!this.config.recordTaskExecution)
+            return;
+        this.startTimer(runId);
+        logger.debug({ taskId, runId, role: this.config.role }, 'Task started');
+    }
+    /**
+     * Called when a task completes successfully
+     */
+    async handleTaskEnd(taskId, runId) {
+        if (!this.config.recordTaskExecution)
+            return;
+        const duration = this.endTimer(runId);
+        await this.recordSignal({
+            event: 'task_end',
+            taskId,
+            duration,
+        });
+    }
+    /**
+     * Called when a task errors
+     */
+    async handleTaskError(taskId, error, runId) {
+        if (!this.config.recordErrors)
+            return;
+        const duration = this.endTimer(runId);
+        await this.recordSignal({
+            event: 'task_error',
+            taskId,
+            duration,
+            error,
+        });
+    }
+    // ============================================
+    // Delegation Lifecycle
+    // ============================================
+    /**
+     * Called when delegation starts
+     */
+    async handleDelegationStart(targetAgentId, taskId, runId) {
+        if (!this.config.recordDelegation)
+            return;
+        this.startTimer(runId);
+        logger.debug({ targetAgentId, taskId, runId }, 'Delegation started');
+    }
+    /**
+     * Called when delegation completes successfully
+     */
+    async handleDelegationEnd(targetAgentId, taskId, runId) {
+        if (!this.config.recordDelegation)
+            return;
+        const duration = this.endTimer(runId);
+        await this.recordSignal({
+            event: 'delegation_end',
+            targetAgentId,
+            taskId,
+            duration,
+        });
+    }
+    /**
+     * Called when delegation errors
+     */
+    async handleDelegationError(targetAgentId, taskId, error, runId) {
+        if (!this.config.recordErrors)
+            return;
+        const duration = this.endTimer(runId);
+        await this.recordSignal({
+            event: 'delegation_error',
+            targetAgentId,
+            taskId,
+            duration,
+            error,
+        });
+    }
+    // ============================================
+    // Crew Lifecycle
+    // ============================================
+    /**
+     * Called when a crew run starts
+     */
+    async handleCrewStart(crewId, runId) {
+        this.startTimer(runId);
+        logger.debug({ crewId, runId }, 'Crew started');
+    }
+    /**
+     * Called when a crew run completes successfully
+     */
+    async handleCrewEnd(crewId, runId) {
+        const duration = this.endTimer(runId);
+        await this.recordSignal({
+            event: 'crew_end',
+            crewId,
+            duration,
+        });
+    }
+    /**
+     * Called when a crew run errors
+     */
+    async handleCrewError(crewId, error, runId) {
+        if (!this.config.recordErrors)
+            return;
+        const duration = this.endTimer(runId);
+        await this.recordSignal({
+            event: 'crew_error',
+            crewId,
+            duration,
+            error,
+        });
+    }
+}
+/**
+ * Create a crew trust callback handler
+ */
+export function createCrewTrustCallback(trustEngine, config) {
+    return new CrewTrustCallbackHandler(trustEngine, config);
+}
+//# sourceMappingURL=callback.js.map

package/dist/crewai/callback.js.map

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

package/dist/crewai/executor.d.ts

@@ -0,0 +1,226 @@
+/**
+ * Trust-Aware CrewAI Executor
+ *
+ * Wraps CrewAI crews and tasks with trust-based access control.
+ *
+ * @packageDocumentation
+ */
+import type { TrustLevel, TrustScore } from '../common/types.js';
+import type { TrustEngine, TrustRecord } from '../trust-engine/index.js';
+import type { TrustAwareEnforcementService } from '../enforce/trust-aware-enforcement-service.js';
+import type { FluidDecisionResult } from '../enforce/index.js';
+import { CrewTrustCallbackHandler } from './callback.js';
+import type { CrewAgentConfig, CrewConfig, CrewTaskConfig, CrewTrustCheckResult, TrustedTaskResult, TrustedCrewResult, DelegationResult, TrustGatedCrewExecutorConfig, TrustGatedTaskResult, TrustGatedCrewResult } from './types.js';
+/**
+ * Trust-aware executor for a single crew agent
+ *
+ * Provides trust-gated task execution and delegation for CrewAI agents.
+ */
+export declare class CrewAgentExecutor {
+    private trustEngine;
+    private callback;
+    private config;
+    constructor(trustEngine: TrustEngine, config: CrewAgentConfig);
+    /**
+     * Get the callback handler
+     */
+    get callbackHandler(): CrewTrustCallbackHandler;
+    /**
+     * Get the agent ID
+     */
+    get agentId(): string;
+    /**
+     * Get the agent role
+     */
+    get role(): string;
+    /**
+     * Initialize the executor
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if the agent has sufficient trust
+     */
+    checkTrust(requiredLevel?: TrustLevel): Promise<CrewTrustCheckResult>;
+    /**
+     * Execute a task with trust gating
+     *
+     * @param task - Task configuration
+     * @param fn - The function to execute (typically the actual CrewAI task runner)
+     * @throws TrustInsufficientError if trust is too low
+     */
+    executeTask<T>(task: CrewTaskConfig, fn: () => Promise<T>): Promise<TrustedTaskResult<T>>;
+    /**
+     * Delegate a task to another agent with trust gating on both sides
+     *
+     * @param task - Task to delegate
+     * @param targetExecutor - The target agent's executor
+     * @param fn - The function to execute on the target agent
+     * @throws TrustInsufficientError if either agent lacks trust
+     */
+    delegateTask<T>(task: CrewTaskConfig, targetExecutor: CrewAgentExecutor, fn: () => Promise<T>): Promise<DelegationResult<T>>;
+    /**
+     * Get current trust record for the agent
+     */
+    getTrustRecord(): Promise<TrustRecord | undefined>;
+    /**
+     * Manually record a positive signal
+     */
+    recordSuccess(type: string, value?: number): Promise<void>;
+    /**
+     * Manually record a negative signal
+     */
+    recordFailure(type: string, value?: number): Promise<void>;
+}
+/**
+ * Trust-aware crew executor
+ *
+ * Manages a crew of agents with collective trust governance.
+ * Ensures all agents meet minimum trust requirements before crew execution.
+ */
+export declare class CrewExecutor {
+    private trustEngine;
+    private config;
+    private agents;
+    constructor(trustEngine: TrustEngine, config: CrewConfig);
+    /**
+     * Get the crew ID
+     */
+    get crewId(): string;
+    /**
+     * Get the execution process type
+     */
+    get process(): string;
+    /**
+     * Get all agent executors
+     */
+    get agentExecutors(): CrewAgentExecutor[];
+    /**
+     * Add an agent to the crew
+     */
+    addAgent(executor: CrewAgentExecutor): void;
+    /**
+     * Get an agent executor by ID
+     */
+    getAgent(agentId: string): CrewAgentExecutor | undefined;
+    /**
+     * Initialize all agents in the crew
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get the average trust level across all crew members
+     */
+    getCrewTrust(): Promise<{
+        averageScore: number;
+        averageLevel: number;
+        allMeetMinimum: boolean;
+    }>;
+    /**
+     * Execute a set of tasks with the crew
+     *
+     * Tasks are assigned to agents based on the configured process (sequential/hierarchical).
+     * All agents must meet the minimum crew trust requirement.
+     *
+     * @param tasks - Tasks to execute
+     * @param taskRunner - Function that runs a single task given task config and agent executor
+     * @throws TrustInsufficientError if any agent fails trust check
+     */
+    kickoff<T>(tasks: CrewTaskConfig[], taskRunner: (task: CrewTaskConfig, agent: CrewAgentExecutor) => Promise<T>): Promise<TrustedCrewResult<T>>;
+}
+/**
+ * Create a trust-aware crew agent executor
+ */
+export declare function createCrewAgentExecutor(trustEngine: TrustEngine, config: CrewAgentConfig): CrewAgentExecutor;
+/**
+ * Create a trust-aware crew executor
+ */
+export declare function createCrewExecutor(trustEngine: TrustEngine, config: CrewConfig): CrewExecutor;
+/**
+ * Trust-Gated Crew Executor
+ *
+ * High-level wrapper that composes TrustEngine + CrewExecutor + TrustAwareEnforcementService
+ * to provide a full intent -> enforce -> execute pipeline with live trust gating.
+ *
+ * Features:
+ * - Pre-task trust score checks with configurable thresholds
+ * - Optional enforcement service integration (intent -> enforce -> execute)
+ * - Automatic trust decay signals on task failures
+ * - Automatic trust recovery signals on task successes
+ * - Detailed logging of all trust decisions
+ * - Backwards-compatible: enforcement service is optional
+ */
+export declare class TrustGatedCrewExecutor {
+    private trustEngine;
+    private crewExecutor;
+    private enforcementService;
+    private config;
+    constructor(trustEngine: TrustEngine, config: TrustGatedCrewExecutorConfig, enforcementService?: TrustAwareEnforcementService | null);
+    /**
+     * Get the inner CrewExecutor
+     */
+    get executor(): CrewExecutor;
+    /**
+     * Get the TrustEngine instance
+     */
+    get engine(): TrustEngine;
+    /**
+     * Get the crew ID
+     */
+    get crewId(): string;
+    /**
+     * Initialize all agents in the crew
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if an agent passes the trust gate for a task.
+     *
+     * Performs two checks:
+     * 1. Trust score threshold check (score >= configured threshold)
+     * 2. Trust level threshold check (level >= configured threshold)
+     *
+     * If enforcement service is available and enabled, also runs full enforcement.
+     */
+    checkTrustGate(agentId: string, task: CrewTaskConfig): Promise<{
+        allowed: boolean;
+        trustScore: TrustScore;
+        trustLevel: TrustLevel;
+        enforcementResult?: FluidDecisionResult;
+        reason: string;
+    }>;
+    /**
+     * Execute a single task through the trust gate.
+     *
+     * Pipeline: check trust -> (optional) enforce -> execute -> record signals
+     */
+    executeGatedTask<T>(task: CrewTaskConfig, taskRunner: (task: CrewTaskConfig, agent: CrewAgentExecutor) => Promise<T>): Promise<TrustGatedTaskResult<T>>;
+    /**
+     * Execute a full crew kickoff with trust gating on every task.
+     *
+     * Unlike the inner CrewExecutor.kickoff(), this method:
+     * - Checks trust gate before each task individually
+     * - Skips tasks that fail the trust gate (instead of throwing)
+     * - Records trust signals after each success/failure
+     * - Returns a comprehensive result including denied tasks
+     */
+    kickoff<T>(tasks: CrewTaskConfig[], taskRunner: (task: CrewTaskConfig, agent: CrewAgentExecutor) => Promise<T>): Promise<TrustGatedCrewResult<T>>;
+    /**
+     * Resolve the agent executor for a given task
+     */
+    private resolveAgent;
+    /**
+     * Run enforcement pipeline: build intent -> call TrustAwareEnforcementService.decide()
+     */
+    private runEnforcement;
+    /**
+     * Record a trust signal to the engine
+     */
+    private recordTrustSignal;
+}
+/**
+ * Create a TrustGatedCrewExecutor
+ *
+ * @param trustEngine - The TrustEngine instance for score lookups and signal recording
+ * @param config - Configuration for the gated executor
+ * @param enforcementService - Optional TrustAwareEnforcementService for full intent enforcement
+ */
+export declare function createTrustGatedCrewExecutor(trustEngine: TrustEngine, config: TrustGatedCrewExecutorConfig, enforcementService?: TrustAwareEnforcementService | null): TrustGatedCrewExecutor;
+//# sourceMappingURL=executor.d.ts.map

package/dist/crewai/executor.d.ts.map

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