@dcyfr/ai 1.0.3 → 2.1.0

package/dist/ai/src/types/context-verification.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Context Verification Types for DCYFR AI Framework
+ * TLP:CLEAR
+ *
+ * Types for the Anti-Assumption Protocol — ensures agents verify context
+ * sufficiency before making decisions. Prevents dead-end implementations,
+ * recursive failures, and token waste from assumption-based decision making.
+ *
+ * @module types/context-verification
+ * @version 1.0.0
+ * @date 2026-02-14
+ */
+/**
+ * Classification of information an agent holds about a decision
+ */
+export type InformationClass = 'verified_fact' | 'user_stated' | 'inferred' | 'assumed' | 'unknown';
+/**
+ * Categories of information that commonly require verification
+ */
+export type VerificationCategory = 'file_paths' | 'api_signatures' | 'configurations' | 'dependencies' | 'conventions' | 'user_intent' | 'cross_package_impact' | 'existence' | 'runtime_behavior' | 'infrastructure';
+/**
+ * Individual information item tracked during context verification
+ */
+export interface InformationItem {
+    /** What the agent believes or needs to know */
+    description: string;
+    /** How this information was obtained */
+    classification: InformationClass;
+    /** Category of information for systematic verification */
+    category: VerificationCategory;
+    /** Confidence in the accuracy of this information (0-1) */
+    confidence: number;
+    /** Source of the information (file path, user message, etc.) */
+    source?: string;
+    /** Whether this information has been verified against actual source */
+    verified: boolean;
+    /** Verification method used, if verified */
+    verification_method?: 'source_read' | 'search' | 'user_confirmation' | 'test_execution' | 'type_check';
+}
+/**
+ * An information gap that must be resolved before proceeding
+ */
+export interface InformationGap {
+    /** What information is missing */
+    description: string;
+    /** Category of the missing information */
+    category: VerificationCategory;
+    /** How critical this gap is to the decision */
+    criticality: 'blocking' | 'important' | 'nice_to_have';
+    /** Suggested resolution approach */
+    resolution_strategy: 'read_source' | 'search_codebase' | 'ask_user' | 'run_test' | 'check_types' | 'check_config' | 'defer';
+    /** Whether this gap has been resolved */
+    resolved: boolean;
+    /** Resolution details, if resolved */
+    resolution?: string;
+}
+/**
+ * Complete context sufficiency assessment
+ *
+ * Agents must produce this assessment before taking non-trivial actions.
+ * If overall_confidence < minimum_threshold, the agent should gather
+ * more context or ask for clarification rather than proceeding.
+ */
+export interface ContextSufficiencyAssessment {
+    /** Unique assessment identifier */
+    assessment_id: string;
+    /** Agent performing the assessment */
+    agent_id: string;
+    /** Task or decision being assessed */
+    task_description: string;
+    /** When the assessment was performed */
+    assessed_at: string;
+    /**
+     * Overall confidence in context sufficiency (0-1).
+     * Below 0.7: MUST gather more context or ask for clarification.
+     * 0.7-0.85: SHOULD state uncertainties explicitly before proceeding.
+     * Above 0.85: May proceed with implementation.
+     */
+    overall_confidence: number;
+    /** Facts and inferences the agent is working with */
+    information_items: InformationItem[];
+    /** Identified gaps in knowledge that affect the decision */
+    information_gaps: InformationGap[];
+    /** Assumptions the agent is making (should be minimized) */
+    assumptions: Array<{
+        /** What is being assumed */
+        assumption: string;
+        /** Risk if this assumption is wrong */
+        risk_if_wrong: 'low' | 'medium' | 'high' | 'critical';
+        /** Why verification wasn't possible */
+        reason_unverified: string;
+        /** Fallback plan if assumption proves incorrect */
+        fallback?: string;
+    }>;
+    /**
+     * Decision: can the agent proceed, or must it gather more context?
+     */
+    decision: 'proceed' | 'gather_context' | 'ask_user' | 'escalate';
+    /** Human-readable reasoning for the decision */
+    reasoning: string;
+    /** Specific actions to take if decision is not 'proceed' */
+    next_actions?: Array<{
+        action: string;
+        category: VerificationCategory;
+        priority: number;
+    }>;
+}
+/**
+ * Configuration for context verification behavior
+ */
+export interface ContextVerificationConfig {
+    /**
+     * Minimum confidence threshold to proceed without gathering more context.
+     * Default: 0.7
+     */
+    minimum_confidence_threshold: number;
+    /**
+     * Maximum number of unverified assumptions allowed before blocking.
+     * Default: 2
+     */
+    max_unverified_assumptions: number;
+    /**
+     * Maximum number of search attempts before asking the user.
+     * Default: 2 (the "two-search rule")
+     */
+    max_search_attempts_before_asking: number;
+    /**
+     * Categories that MUST be verified (blocking if unverified).
+     * Default: ['api_signatures', 'file_paths', 'user_intent']
+     */
+    mandatory_verification_categories: VerificationCategory[];
+    /**
+     * Whether to require explicit assumption declaration.
+     * Default: true
+     */
+    require_assumption_declaration: boolean;
+    /**
+     * Whether cross-package impact must be checked for multi-package workspaces.
+     * Default: true
+     */
+    require_cross_package_check: boolean;
+}
+/**
+ * Default context verification configuration
+ */
+export declare const DEFAULT_CONTEXT_VERIFICATION_CONFIG: ContextVerificationConfig;
+/**
+ * Helper to create a minimal context sufficiency assessment
+ */
+export declare function createAssessment(agent_id: string, task_description: string, overrides?: Partial<ContextSufficiencyAssessment>): ContextSufficiencyAssessment;
+/**
+ * Evaluate whether an assessment meets the verification threshold
+ */
+export declare function evaluateAssessment(assessment: ContextSufficiencyAssessment, config?: ContextVerificationConfig): {
+    can_proceed: boolean;
+    blockers: string[];
+};
+//# sourceMappingURL=context-verification.d.ts.map

package/dist/ai/src/types/context-verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-verification.d.ts","sourceRoot":"","sources":["../../../../packages/ai/src/types/context-verification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,aAAa,GACb,UAAU,GACV,SAAS,GACT,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,YAAY,GACZ,gBAAgB,GAChB,gBAAgB,GAChB,cAAc,GACd,aAAa,GACb,aAAa,GACb,sBAAsB,GACtB,WAAW,GACX,kBAAkB,GAClB,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,cAAc,EAAE,gBAAgB,CAAC;IAEjC,0DAA0D;IAC1D,QAAQ,EAAE,oBAAoB,CAAC;IAE/B,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IAEnB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC;IAElB,4CAA4C;IAC5C,mBAAmB,CAAC,EAAE,aAAa,GAAG,QAAQ,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,YAAY,CAAC;CACxG;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IAEpB,0CAA0C;IAC1C,QAAQ,EAAE,oBAAoB,CAAC;IAE/B,+CAA+C;IAC/C,WAAW,EAAE,UAAU,GAAG,WAAW,GAAG,cAAc,CAAC;IAEvD,oCAAoC;IACpC,mBAAmB,EACf,aAAa,GACb,iBAAiB,GACjB,UAAU,GACV,UAAU,GACV,aAAa,GACb,cAAc,GACd,OAAO,CAAC;IAEZ,yCAAyC;IACzC,QAAQ,EAAE,OAAO,CAAC;IAElB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC3C,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IAEtB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IAEjB,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAE3B,qDAAqD;IACrD,iBAAiB,EAAE,eAAe,EAAE,CAAC;IAErC,4DAA4D;IAC5D,gBAAgB,EAAE,cAAc,EAAE,CAAC;IAEnC,4DAA4D;IAC5D,WAAW,EAAE,KAAK,CAAC;QACjB,4BAA4B;QAC5B,UAAU,EAAE,MAAM,CAAC;QAEnB,uCAAuC;QACvC,aAAa,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;QAEtD,uCAAuC;QACvC,iBAAiB,EAAE,MAAM,CAAC;QAE1B,mDAAmD;QACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IAEH;;OAEG;IACH,QAAQ,EAAE,SAAS,GAAG,gBAAgB,GAAG,UAAU,GAAG,UAAU,CAAC;IAEjE,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAElB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,KAAK,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,oBAAoB,CAAC;QAC/B,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,4BAA4B,EAAE,MAAM,CAAC;IAErC;;;OAGG;IACH,0BAA0B,EAAE,MAAM,CAAC;IAEnC;;;OAGG;IACH,iCAAiC,EAAE,MAAM,CAAC;IAE1C;;;OAGG;IACH,iCAAiC,EAAE,oBAAoB,EAAE,CAAC;IAE1D;;;OAGG;IACH,8BAA8B,EAAE,OAAO,CAAC;IAExC;;;OAGG;IACH,2BAA2B,EAAE,OAAO,CAAC;CACtC;AAED;;GAEG;AACH,eAAO,MAAM,mCAAmC,EAAE,yBAOjD,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,EACxB,SAAS,CAAC,EAAE,OAAO,CAAC,4BAA4B,CAAC,GAChD,4BAA4B,CAc9B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,4BAA4B,EACxC,MAAM,GAAE,yBAA+D,GACtE;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAwC9C"}

package/dist/ai/src/types/context-verification.js

@@ -0,0 +1,73 @@
+/**
+ * Context Verification Types for DCYFR AI Framework
+ * TLP:CLEAR
+ *
+ * Types for the Anti-Assumption Protocol — ensures agents verify context
+ * sufficiency before making decisions. Prevents dead-end implementations,
+ * recursive failures, and token waste from assumption-based decision making.
+ *
+ * @module types/context-verification
+ * @version 1.0.0
+ * @date 2026-02-14
+ */
+/**
+ * Default context verification configuration
+ */
+export const DEFAULT_CONTEXT_VERIFICATION_CONFIG = {
+    minimum_confidence_threshold: 0.7,
+    max_unverified_assumptions: 2,
+    max_search_attempts_before_asking: 2,
+    mandatory_verification_categories: ['api_signatures', 'file_paths', 'user_intent'],
+    require_assumption_declaration: true,
+    require_cross_package_check: true,
+};
+/**
+ * Helper to create a minimal context sufficiency assessment
+ */
+export function createAssessment(agent_id, task_description, overrides) {
+    return {
+        assessment_id: `csa_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+        agent_id,
+        task_description,
+        assessed_at: new Date().toISOString(),
+        overall_confidence: 0,
+        information_items: [],
+        information_gaps: [],
+        assumptions: [],
+        decision: 'gather_context',
+        reasoning: 'Initial assessment — context gathering required',
+        ...overrides,
+    };
+}
+/**
+ * Evaluate whether an assessment meets the verification threshold
+ */
+export function evaluateAssessment(assessment, config = DEFAULT_CONTEXT_VERIFICATION_CONFIG) {
+    const blockers = [];
+    // Check overall confidence
+    if (assessment.overall_confidence < config.minimum_confidence_threshold) {
+        blockers.push(`Confidence ${assessment.overall_confidence.toFixed(2)} is below threshold ${config.minimum_confidence_threshold}`);
+    }
+    // Check unverified assumptions
+    const unverifiedCount = assessment.assumptions.length;
+    if (unverifiedCount > config.max_unverified_assumptions) {
+        blockers.push(`${unverifiedCount} unverified assumptions exceed maximum of ${config.max_unverified_assumptions}`);
+    }
+    // Check high-risk assumptions
+    const criticalAssumptions = assessment.assumptions.filter(a => a.risk_if_wrong === 'critical');
+    if (criticalAssumptions.length > 0) {
+        blockers.push(`${criticalAssumptions.length} critical-risk assumption(s) must be verified: ${criticalAssumptions.map(a => a.assumption).join('; ')}`);
+    }
+    // Check mandatory categories
+    for (const category of config.mandatory_verification_categories) {
+        const hasUnresolvedGap = assessment.information_gaps.some(gap => gap.category === category && !gap.resolved && gap.criticality === 'blocking');
+        if (hasUnresolvedGap) {
+            blockers.push(`Mandatory verification category '${category}' has unresolved blocking gaps`);
+        }
+    }
+    return {
+        can_proceed: blockers.length === 0,
+        blockers,
+    };
+}
+//# sourceMappingURL=context-verification.js.map

package/dist/ai/src/types/context-verification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-verification.js","sourceRoot":"","sources":["../../../../packages/ai/src/types/context-verification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA6LH;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAA8B;IAC5E,4BAA4B,EAAE,GAAG;IACjC,0BAA0B,EAAE,CAAC;IAC7B,iCAAiC,EAAE,CAAC;IACpC,iCAAiC,EAAE,CAAC,gBAAgB,EAAE,YAAY,EAAE,aAAa,CAAC;IAClF,8BAA8B,EAAE,IAAI;IACpC,2BAA2B,EAAE,IAAI;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,gBAAwB,EACxB,SAAiD;IAEjD,OAAO;QACL,aAAa,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QAC5E,QAAQ;QACR,gBAAgB;QAChB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,kBAAkB,EAAE,CAAC;QACrB,iBAAiB,EAAE,EAAE;QACrB,gBAAgB,EAAE,EAAE;QACpB,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE,gBAAgB;QAC1B,SAAS,EAAE,iDAAiD;QAC5D,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAwC,EACxC,SAAoC,mCAAmC;IAEvE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,2BAA2B;IAC3B,IAAI,UAAU,CAAC,kBAAkB,GAAG,MAAM,CAAC,4BAA4B,EAAE,CAAC;QACxE,QAAQ,CAAC,IAAI,CACX,cAAc,UAAU,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,MAAM,CAAC,4BAA4B,EAAE,CACnH,CAAC;IACJ,CAAC;IAED,+BAA+B;IAC/B,MAAM,eAAe,GAAG,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC;IACtD,IAAI,eAAe,GAAG,MAAM,CAAC,0BAA0B,EAAE,CAAC;QACxD,QAAQ,CAAC,IAAI,CACX,GAAG,eAAe,6CAA6C,MAAM,CAAC,0BAA0B,EAAE,CACnG,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,MAAM,mBAAmB,GAAG,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,UAAU,CAAC,CAAC;IAC/F,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,QAAQ,CAAC,IAAI,CACX,GAAG,mBAAmB,CAAC,MAAM,kDAAkD,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvI,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,iCAAiC,EAAE,CAAC;QAChE,MAAM,gBAAgB,GAAG,UAAU,CAAC,gBAAgB,CAAC,IAAI,CACvD,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,WAAW,KAAK,UAAU,CACpF,CAAC;QACF,IAAI,gBAAgB,EAAE,CAAC;YACrB,QAAQ,CAAC,IAAI,CAAC,oCAAoC,QAAQ,gCAAgC,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;IAED,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC;QAClC,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/ai/src/types/delegation-contracts.d.ts

@@ -0,0 +1,296 @@
+/**
+ * Delegation Contract Types for DCYFR AI Framework
+ * TLP:CLEAR
+ *
+ * Core types and interfaces for delegation contracts supporting intelligent
+ * task assignment, permission validation, firebreak enforcement, and
+ * verification policies.
+ *
+ * @module types/delegation-contracts
+ * @version 1.0.0
+ * @date 2026-02-13
+ */
+import type { AgentCapability } from './agent-capabilities';
+/**
+ * TLP (Traffic Light Protocol) classification levels
+ */
+export type TLPLevel = 'TLP:RED' | 'TLP:AMBER' | 'TLP:GREEN' | 'TLP:CLEAR';
+/**
+ * Verification policy for task completion validation
+ */
+export type VerificationPolicy = 'none' | 'direct_inspection' | 'third_party_audit' | 'cryptographic_proof' | 'human_required';
+/**
+ * Delegation contract status tracking
+ */
+export type DelegationContractStatus = 'pending' | 'accepted' | 'rejected' | 'active' | 'completed' | 'failed' | 'timeout' | 'cancelled';
+/**
+ * Agent information for delegation tracking
+ */
+export interface DelegationAgent {
+    agent_id: string;
+    agent_name: string;
+    version?: string;
+    reputation_score?: number;
+    current_workload?: number;
+    max_concurrent_tasks?: number;
+    capabilities?: AgentCapability[] | string[];
+    last_active?: string;
+}
+/**
+ * Permission token for resource access control
+ */
+export interface PermissionToken {
+    /** Unique token identifier */
+    token_id: string;
+    /** Permission scopes (e.g., 'read', 'write', 'execute') */
+    scopes: string[];
+    /** Allowed actions (e.g., 'create_file', 'run_command') */
+    actions: string[];
+    /** Resource URIs this token grants access to */
+    resources: string[];
+    /** Token expiration timestamp */
+    expires_at?: string;
+    /** Token issuer information */
+    issued_by?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Firebreak safety mechanism for delegation chains
+ */
+export interface Firebreak {
+    /** Type of firebreak condition */
+    type: 'max_depth' | 'tlp_escalation' | 'human_review' | 'timeout' | 'resource_limit';
+    /** Threshold value for triggering (context-dependent) */
+    threshold?: number;
+    /** Action to take when firebreak triggers */
+    action: 'block' | 'escalate' | 'notify' | 'require_approval' | 'terminate';
+    /** Human-readable reason for this firebreak */
+    reason?: string;
+    /** Metadata for action execution */
+    action_metadata?: Record<string, unknown>;
+}
+/**
+ * Retry policy for failed task execution
+ */
+export interface RetryPolicy {
+    /** Maximum number of retry attempts */
+    max_retries?: number;
+    /** Backoff strategy between retries */
+    backoff_strategy?: 'none' | 'linear' | 'exponential';
+    /** Initial delay before first retry (milliseconds) */
+    initial_delay_ms?: number;
+    /** Maximum delay between retries (milliseconds) */
+    max_delay_ms?: number;
+    /** Conditions that should trigger retries */
+    retry_conditions?: ('timeout' | 'network_error' | 'resource_unavailable')[];
+}
+/**
+ * Reputation requirements for delegation acceptance
+ */
+export interface ReputationRequirements {
+    /** Minimum security/trust score */
+    min_security_score?: number;
+    /** Minimum number of successfully completed tasks */
+    min_tasks_completed?: number;
+    /** Minimum confidence score for relevant capabilities */
+    min_confidence_score?: number;
+    /** Maximum allowed consecutive failures */
+    max_consecutive_failures?: number;
+    /** Required agent specializations */
+    required_specializations?: string[];
+}
+/**
+ * Success criteria for task completion validation
+ */
+export interface SuccessCriteria {
+    /** Required validation checks to pass */
+    required_checks?: string[];
+    /** Expected output schema/structure */
+    output_schema?: Record<string, unknown>;
+    /** Performance requirements (execution time, resource usage) */
+    performance_requirements?: {
+        max_execution_time_ms?: number;
+        max_memory_mb?: number;
+        max_cpu_percent?: number;
+    };
+    /** Minimum quality threshold (0-1) */
+    quality_threshold?: number;
+    /** Required output formats/types */
+    output_formats?: string[];
+    /** Validation functions or criteria */
+    validation_criteria?: string[];
+}
+/**
+ * Verification result for completed tasks
+ */
+export interface VerificationResult {
+    /** Whether verification passed */
+    verified: boolean;
+    /** Verification method used */
+    verification_method: VerificationPolicy;
+    /** Agent/system that performed verification */
+    verified_by: string;
+    /** Verification timestamp */
+    verified_at: string;
+    /** Quality score if applicable (0-1) */
+    quality_score?: number;
+    /** Verification findings and issues */
+    findings?: string[];
+    /** Verification details, errors, or feedback */
+    verification_details?: string;
+    /** Any verification artifacts (logs, signatures, etc.) */
+    artifacts?: Record<string, unknown>;
+}
+/**
+ * Complete delegation contract specification
+ *
+ * Defines the terms, constraints, and requirements for delegating a task
+ * from one agent to another, including security, verification, and
+ * quality requirements.
+ */
+export interface DelegationContract {
+    /** Unique contract identifier */
+    contract_id: string;
+    /** Source task identifier */
+    task_id: string;
+    /** Agent delegating the task */
+    delegator: DelegationAgent;
+    /** Agent receiving the delegation */
+    delegatee: DelegationAgent;
+    /** Delegator agent ID (convenience accessor) */
+    delegator_agent_id: string;
+    /** Delegatee agent ID (convenience accessor) */
+    delegatee_agent_id: string;
+    /** Human-readable task description */
+    task_description?: string;
+    /** Required verification policy for completion */
+    verification_policy: VerificationPolicy;
+    /** Traffic Light Protocol classification */
+    tlp_classification?: TLPLevel;
+    /** Criteria for determining successful completion */
+    success_criteria: SuccessCriteria;
+    /** Maximum time allowed for task completion (milliseconds) */
+    timeout_ms?: number;
+    /** Contract creation timestamp */
+    created_at: string;
+    /** Current contract status */
+    status: DelegationContractStatus;
+    /** Execution mode for this contract (interactive, background, or async) */
+    execution_mode?: string;
+    /** Contract activation timestamp */
+    activated_at?: string;
+    /** Contract completion timestamp */
+    completed_at?: string;
+    /** Permission token for resource access */
+    permission_token?: PermissionToken;
+    /** Safety firebreaks for delegation chain protection */
+    firebreaks?: Firebreak[];
+    /** Retry policy for failed attempts */
+    retry_policy?: RetryPolicy;
+    /** Reputation requirements for delegatee acceptance */
+    reputation_requirements?: ReputationRequirements;
+    /** Parent contract ID (for multi-hop delegation chains) */
+    parent_contract_id?: string;
+    /** Depth in delegation chain (0 = top-level) */
+    delegation_depth?: number;
+    /** Required capabilities for task completion (string[] or object[] format supported) */
+    required_capabilities?: (string | {
+        capability_id: string;
+        min_confidence?: number;
+    })[];
+    /**
+     * Whether the delegatee must verify context sufficiency before acting.
+     * When true, the delegatee agent must perform a ContextSufficiencyAssessment
+     * and achieve minimum_context_confidence before proceeding with implementation.
+     * Prevents assumption-based decision making that leads to dead-end implementations.
+     */
+    context_verification_required?: boolean;
+    /**
+     * Minimum confidence score (0-1) the delegatee must achieve in their
+     * context sufficiency assessment before proceeding. Defaults to 0.7.
+     * Higher values enforce stricter context gathering requirements.
+     */
+    minimum_context_confidence?: number;
+    /** Resource requirements for task execution */
+    resource_requirements?: {
+        memory_mb?: number;
+        cpu_cores?: number;
+        disk_space_mb?: number;
+        network_bandwidth_mbps?: number;
+    };
+    /** Task priority level (1-10, 10 = highest) */
+    priority?: number;
+    /** Additional metadata and context */
+    metadata?: {
+        /** Estimated task complexity (1-10) */
+        estimated_complexity?: number;
+        /** Estimated duration in milliseconds */
+        estimated_duration_ms?: number;
+        /** Whether task requires production system access */
+        requires_production_access?: boolean;
+        /** Delegation chain depth (for firebreak enforcement) */
+        delegation_depth?: number;
+        /** Parent contract ID if this is a sub-delegation */
+        parent_contract_id?: string;
+        /** Task categories/tags for matching */
+        task_categories?: string[];
+        /** Additional context fields */
+        [key: string]: unknown;
+    };
+    /** Contract completion information (when status is completed/failed) */
+    completion?: {
+        /** Completion timestamp */
+        completed_at: string;
+        /** Whether task was successful */
+        success: boolean;
+        /** Task completion result/output */
+        result?: unknown;
+        /** Error information if failed */
+        error?: {
+            error_type: string;
+            error_message: string;
+            error_details?: Record<string, unknown>;
+        };
+        /** Verification result */
+        verification?: VerificationResult;
+        /** Final reputation impact */
+        reputation_delta?: number;
+        /** Execution metrics */
+        metrics?: {
+            execution_time_ms: number;
+            peak_memory_mb: number;
+            cpu_time_ms: number;
+            network_bytes_sent: number;
+            network_bytes_received: number;
+        };
+    };
+    /** Verification result (top-level accessor) */
+    verification_result?: VerificationResult;
+    /** Failure timestamp (when status becomes failed) */
+    failed_at?: string;
+}
+/**
+ * Contract acceptance decision with reasoning
+ */
+export interface ContractAcceptanceDecision {
+    /** Whether the contract can be accepted */
+    can_accept: boolean;
+    /** Human-readable reason for acceptance/rejection */
+    reason?: string;
+    /** Confidence in ability to complete task (0-1) */
+    confidence?: number;
+    /** Estimated completion time in milliseconds */
+    estimated_completion_ms?: number;
+    /** Any modifications proposed to the contract */
+    proposed_modifications?: Partial<DelegationContract>;
+    /** Detailed assessment factors */
+    assessment?: {
+        capability_match: number;
+        resource_availability: number;
+        workload_capacity: number;
+        reputation_compliance: boolean;
+        firebreak_compliance: boolean;
+    };
+}
+//# sourceMappingURL=delegation-contracts.d.ts.map

package/dist/ai/src/types/delegation-contracts.d.ts.map

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

package/dist/ai/src/types/delegation-contracts.js

@@ -0,0 +1,17 @@
+/**
+ * Delegation Contract Types for DCYFR AI Framework
+ * TLP:CLEAR
+ *
+ * Core types and interfaces for delegation contracts supporting intelligent
+ * task assignment, permission validation, firebreak enforcement, and
+ * verification policies.
+ *
+ * @module types/delegation-contracts
+ * @version 1.0.0
+ * @date 2026-02-13
+ */
+export {};
+// All types are already exported individually as named exports above.
+// No default export needed - consumers should use named imports:
+// import type { DelegationContract, SuccessCriteria, ... } from './delegation-contracts.js';
+//# sourceMappingURL=delegation-contracts.js.map

package/dist/ai/src/types/delegation-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-contracts.js","sourceRoot":"","sources":["../../../../packages/ai/src/types/delegation-contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;;AAoYH,sEAAsE;AACtE,iEAAiE;AACjE,6FAA6F"}