agentic-lang 0.2.0

package/dist/verification/z3-engine.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Z3 SMT Solver Integration for Formal Verification
+ * Verifies contracts (@requires, @ensures) using Z3
+ */
+import * as AST from '../types';
+export interface VerificationResult {
+    verified: boolean;
+    counterexample?: any;
+    properties: Array<{
+        name: string;
+        proven: boolean;
+        time_ms: number;
+    }>;
+}
+export interface Contract {
+    requires?: string[];
+    ensures?: string[];
+    invariants?: string[];
+}
+export declare class Z3VerificationEngine {
+    private z3Context;
+    private initialized;
+    initialize(): Promise<void>;
+    /**
+     * Verify a function's contract using Z3
+     */
+    verifyFunction(func: AST.FunctionDeclaration, contract: Contract): Promise<VerificationResult>;
+    /**
+     * Verify that preconditions imply postconditions
+     * ∀x. precondition(x) → postcondition(x)
+     */
+    private verifyProperty;
+    /**
+     * Parse expression string into Z3 formula
+     * Simple parser for basic arithmetic and boolean expressions
+     */
+    private parseExpression;
+    private parseOperand;
+    /**
+     * Check for common antipatterns
+     */
+    checkAntipatterns(func: AST.FunctionDeclaration): Promise<string[]>;
+}
+/**
+ * Statistical Confidence Validator
+ * Validates confidence claims using Wilson score intervals
+ */
+export declare class ConfidenceValidator {
+    private observations;
+    /**
+     * Record function execution result
+     */
+    observe(functionName: string, success: boolean): void;
+    /**
+     * Calculate confidence interval using Wilson score
+     */
+    calculateConfidenceInterval(functionName: string, confidenceLevel?: number): {
+        lower: number;
+        upper: number;
+        samples: number;
+    } | null;
+    /**
+     * Validate claimed confidence against observed data
+     */
+    validateClaim(functionName: string, claimedConfidence: number): {
+        valid: boolean;
+        actual: {
+            lower: number;
+            upper: number;
+        } | null;
+        recommendation: string;
+    };
+    private getZScore;
+}
+//# sourceMappingURL=z3-engine.d.ts.map

package/dist/verification/z3-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"z3-engine.d.ts","sourceRoot":"","sources":["../../src/verification/z3-engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,WAAW,CAAS;IAEtB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;OAEG;IACG,cAAc,CAClB,IAAI,EAAE,GAAG,CAAC,mBAAmB,EAC7B,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,kBAAkB,CAAC;IAsD9B;;;OAGG;YACW,cAAc;IA4B5B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAiEvB,OAAO,CAAC,YAAY;IAqBpB;;OAEG;IACG,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAe1E;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,YAAY,CAAgC;IAEpD;;OAEG;IACH,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAOrD;;OAEG;IACH,2BAA2B,CACzB,YAAY,EAAE,MAAM,EACpB,eAAe,GAAE,MAAa,GAC7B;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAyB3D;;OAEG;IACH,aAAa,CACX,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,MAAM,GACxB;QACD,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;QAChD,cAAc,EAAE,MAAM,CAAC;KACxB;IAyBD,OAAO,CAAC,SAAS;CAUlB"}

package/dist/verification/z3-engine.js

@@ -0,0 +1,234 @@
+"use strict";
+/**
+ * Z3 SMT Solver Integration for Formal Verification
+ * Verifies contracts (@requires, @ensures) using Z3
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfidenceValidator = exports.Z3VerificationEngine = void 0;
+const z3_solver_1 = require("z3-solver");
+class Z3VerificationEngine {
+    constructor() {
+        this.initialized = false;
+    }
+    async initialize() {
+        if (this.initialized)
+            return;
+        const { Context } = await (0, z3_solver_1.init)();
+        this.z3Context = Context('main');
+        this.initialized = true;
+    }
+    /**
+     * Verify a function's contract using Z3
+     */
+    async verifyFunction(func, contract) {
+        await this.initialize();
+        const solver = new this.z3Context.Solver();
+        const properties = [];
+        // Create Z3 variables from function parameters
+        const vars = {};
+        for (const param of func.params) {
+            const type = param.typeAnnotation?.value;
+            if (type === 'number') {
+                vars[param.name] = this.z3Context.Real.const(param.name);
+            }
+            else if (type === 'boolean') {
+                vars[param.name] = this.z3Context.Bool.const(param.name);
+            }
+            // Add more types as needed
+        }
+        // Verify each postcondition
+        if (contract.ensures) {
+            for (const postcondition of contract.ensures) {
+                const startTime = Date.now();
+                try {
+                    const result = await this.verifyProperty(solver, vars, contract.requires || [], postcondition);
+                    properties.push({
+                        name: postcondition,
+                        proven: result,
+                        time_ms: Date.now() - startTime,
+                    });
+                }
+                catch (error) {
+                    properties.push({
+                        name: postcondition,
+                        proven: false,
+                        time_ms: Date.now() - startTime,
+                    });
+                }
+            }
+        }
+        const allVerified = properties.every(p => p.proven);
+        return {
+            verified: allVerified,
+            properties,
+        };
+    }
+    /**
+     * Verify that preconditions imply postconditions
+     * ∀x. precondition(x) → postcondition(x)
+     */
+    async verifyProperty(solver, vars, preconditions, postcondition) {
+        // Build precondition formula
+        const preFormulas = preconditions.map(pre => this.parseExpression(pre, vars));
+        const preCombined = preFormulas.length > 0
+            ? this.z3Context.And(...preFormulas)
+            : this.z3Context.Bool.val(true);
+        // Build postcondition formula
+        const postFormula = this.parseExpression(postcondition, vars);
+        // Check if ¬(precondition ∧ ¬postcondition) is UNSAT
+        // This proves: precondition → postcondition
+        solver.add(preCombined);
+        solver.add(this.z3Context.Not(postFormula));
+        const result = await solver.check();
+        return result === 'unsat'; // UNSAT means the property is proven
+    }
+    /**
+     * Parse expression string into Z3 formula
+     * Simple parser for basic arithmetic and boolean expressions
+     */
+    parseExpression(expr, vars) {
+        // This is a simplified parser - in production, use a proper expression parser
+        // Handle comparison operators
+        if (expr.includes('>')) {
+            const [left, right] = expr.split('>').map(s => s.trim());
+            return this.z3Context.GT(this.parseOperand(left, vars), this.parseOperand(right, vars));
+        }
+        if (expr.includes('>=')) {
+            const [left, right] = expr.split('>=').map(s => s.trim());
+            return this.z3Context.GE(this.parseOperand(left, vars), this.parseOperand(right, vars));
+        }
+        if (expr.includes('<')) {
+            const [left, right] = expr.split('<').map(s => s.trim());
+            return this.z3Context.LT(this.parseOperand(left, vars), this.parseOperand(right, vars));
+        }
+        if (expr.includes('==')) {
+            const [left, right] = expr.split('==').map(s => s.trim());
+            return this.z3Context.Eq(this.parseOperand(left, vars), this.parseOperand(right, vars));
+        }
+        if (expr.includes('!=')) {
+            const [left, right] = expr.split('!=').map(s => s.trim());
+            return this.z3Context.Not(this.z3Context.Eq(this.parseOperand(left, vars), this.parseOperand(right, vars)));
+        }
+        // Handle boolean operators
+        if (expr.includes('&&')) {
+            const parts = expr.split('&&').map(s => s.trim());
+            return this.z3Context.And(...parts.map(p => this.parseExpression(p, vars)));
+        }
+        if (expr.includes('||')) {
+            const parts = expr.split('||').map(s => s.trim());
+            return this.z3Context.Or(...parts.map(p => this.parseExpression(p, vars)));
+        }
+        // Default: try to parse as variable or constant
+        return this.parseOperand(expr, vars);
+    }
+    parseOperand(operand, vars) {
+        operand = operand.trim();
+        // Check if it's a variable
+        if (vars[operand]) {
+            return vars[operand];
+        }
+        // Check if it's a number
+        const num = parseFloat(operand);
+        if (!isNaN(num)) {
+            return this.z3Context.Real.val(num);
+        }
+        // Check if it's boolean
+        if (operand === 'true')
+            return this.z3Context.Bool.val(true);
+        if (operand === 'false')
+            return this.z3Context.Bool.val(false);
+        throw new Error(`Cannot parse operand: ${operand}`);
+    }
+    /**
+     * Check for common antipatterns
+     */
+    async checkAntipatterns(func) {
+        const issues = [];
+        // Division by zero check
+        if (func.body.toString().includes('/')) {
+            issues.push('Potential division by zero - add precondition for divisor != 0');
+        }
+        // Array access without bounds check
+        if (func.body.toString().match(/\[\d+\]/)) {
+            issues.push('Array access without bounds check - verify index is valid');
+        }
+        return issues;
+    }
+}
+exports.Z3VerificationEngine = Z3VerificationEngine;
+/**
+ * Statistical Confidence Validator
+ * Validates confidence claims using Wilson score intervals
+ */
+class ConfidenceValidator {
+    constructor() {
+        this.observations = new Map();
+    }
+    /**
+     * Record function execution result
+     */
+    observe(functionName, success) {
+        if (!this.observations.has(functionName)) {
+            this.observations.set(functionName, []);
+        }
+        this.observations.get(functionName).push(success);
+    }
+    /**
+     * Calculate confidence interval using Wilson score
+     */
+    calculateConfidenceInterval(functionName, confidenceLevel = 0.95) {
+        const obs = this.observations.get(functionName);
+        if (!obs || obs.length < 10) {
+            return null; // Need at least 10 samples
+        }
+        const n = obs.length;
+        const successes = obs.filter(x => x).length;
+        const p = successes / n;
+        // Z-score for confidence level (1.96 for 95%)
+        const z = this.getZScore(confidenceLevel);
+        // Wilson score interval
+        const center = p + (z * z) / (2 * n);
+        const margin = z * Math.sqrt((p * (1 - p) + (z * z) / (4 * n)) / n);
+        const denominator = 1 + (z * z) / n;
+        return {
+            lower: (center - margin) / denominator,
+            upper: (center + margin) / denominator,
+            samples: n,
+        };
+    }
+    /**
+     * Validate claimed confidence against observed data
+     */
+    validateClaim(functionName, claimedConfidence) {
+        const actual = this.calculateConfidenceInterval(functionName);
+        if (!actual) {
+            return {
+                valid: false,
+                actual: null,
+                recommendation: 'Need at least 10 runtime observations to validate confidence',
+            };
+        }
+        const valid = claimedConfidence >= actual.lower && claimedConfidence <= actual.upper;
+        let recommendation = '';
+        if (!valid) {
+            if (claimedConfidence > actual.upper) {
+                recommendation = `Claimed confidence (${claimedConfidence}) is too high. Based on ${actual.samples} observations, confidence should be ${actual.upper.toFixed(2)} or lower.`;
+            }
+            else {
+                recommendation = `Claimed confidence (${claimedConfidence}) is too low. Based on ${actual.samples} observations, you can increase it to ${actual.lower.toFixed(2)}.`;
+            }
+        }
+        return { valid, actual, recommendation };
+    }
+    getZScore(confidenceLevel) {
+        // Common z-scores
+        const zScores = {
+            0.90: 1.645,
+            0.95: 1.96,
+            0.99: 2.576,
+        };
+        return zScores[confidenceLevel] || 1.96;
+    }
+}
+exports.ConfidenceValidator = ConfidenceValidator;
+//# sourceMappingURL=z3-engine.js.map

package/dist/verification/z3-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"z3-engine.js","sourceRoot":"","sources":["../../src/verification/z3-engine.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,yCAAiC;AAmBjC,MAAa,oBAAoB;IAAjC;QAEU,gBAAW,GAAG,KAAK,CAAC;IAkN9B,CAAC;IAhNC,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAE7B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAA,gBAAI,GAAE,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,IAA6B,EAC7B,QAAkB;QAElB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAExB,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAqC,EAAE,CAAC;QAExD,+CAA+C;QAC/C,MAAM,IAAI,GAAwB,EAAE,CAAC;QACrC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC;YACzC,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3D,CAAC;iBAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC9B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3D,CAAC;YACD,2BAA2B;QAC7B,CAAC;QAED,4BAA4B;QAC5B,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrB,KAAK,MAAM,aAAa,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAE7B,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CACtC,MAAM,EACN,IAAI,EACJ,QAAQ,CAAC,QAAQ,IAAI,EAAE,EACvB,aAAa,CACd,CAAC;oBAEF,UAAU,CAAC,IAAI,CAAC;wBACd,IAAI,EAAE,aAAa;wBACnB,MAAM,EAAE,MAAM;wBACd,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;qBAChC,CAAC,CAAC;gBACL,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,UAAU,CAAC,IAAI,CAAC;wBACd,IAAI,EAAE,aAAa;wBACnB,MAAM,EAAE,KAAK;wBACb,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;qBAChC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAEpD,OAAO;YACL,QAAQ,EAAE,WAAW;YACrB,UAAU;SACX,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,cAAc,CAC1B,MAAW,EACX,IAAyB,EACzB,aAAuB,EACvB,aAAqB;QAErB,6BAA6B;QAC7B,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAC1C,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,CAChC,CAAC;QAEF,MAAM,WAAW,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC;YACxC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;YACpC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAElC,8BAA8B;QAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAE9D,qDAAqD;QACrD,4CAA4C;QAC5C,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACxB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;QAE5C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QAEpC,OAAO,MAAM,KAAK,OAAO,CAAC,CAAC,qCAAqC;IAClE,CAAC;IAED;;;OAGG;IACK,eAAe,CAAC,IAAY,EAAE,IAAyB;QAC7D,8EAA8E;QAE9E,8BAA8B;QAC9B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACzD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CACtB,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,EAC7B,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAC/B,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CACtB,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,EAC7B,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAC/B,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACzD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CACtB,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,EAC7B,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAC/B,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CACtB,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,EAC7B,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAC/B,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CACvB,IAAI,CAAC,SAAS,CAAC,EAAE,CACf,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,EAC7B,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAC/B,CACF,CAAC;QACJ,CAAC;QAED,2BAA2B;QAC3B,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAClD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CACvB,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CACjD,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAClD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CACtB,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CACjD,CAAC;QACJ,CAAC;QAED,gDAAgD;QAChD,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAEO,YAAY,CAAC,OAAe,EAAE,IAAyB;QAC7D,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAEzB,2BAA2B;QAC3B,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QAED,yBAAyB;QACzB,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;QAED,wBAAwB;QACxB,IAAI,OAAO,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,OAAO,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAE/D,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,IAA6B;QACnD,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,yBAAyB;QACzB,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;QAChF,CAAC;QAED,oCAAoC;QACpC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AApND,oDAoNC;AAED;;;GAGG;AACH,MAAa,mBAAmB;IAAhC;QACU,iBAAY,GAAG,IAAI,GAAG,EAAqB,CAAC;IAwFtD,CAAC;IAtFC;;OAEG;IACH,OAAO,CAAC,YAAoB,EAAE,OAAgB;QAC5C,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,2BAA2B,CACzB,YAAoB,EACpB,kBAA0B,IAAI;QAE9B,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAChD,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC,CAAC,2BAA2B;QAC1C,CAAC;QAED,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;QACrB,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC5C,MAAM,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC;QAExB,8CAA8C;QAC9C,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAE1C,wBAAwB;QACxB,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACpE,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAEpC,OAAO;YACL,KAAK,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,WAAW;YACtC,KAAK,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,WAAW;YACtC,OAAO,EAAE,CAAC;SACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,aAAa,CACX,YAAoB,EACpB,iBAAyB;QAMzB,MAAM,MAAM,GAAG,IAAI,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC;QAE9D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,IAAI;gBACZ,cAAc,EAAE,8DAA8D;aAC/E,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,iBAAiB,IAAI,MAAM,CAAC,KAAK,IAAI,iBAAiB,IAAI,MAAM,CAAC,KAAK,CAAC;QAErF,IAAI,cAAc,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,iBAAiB,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;gBACrC,cAAc,GAAG,uBAAuB,iBAAiB,2BAA2B,MAAM,CAAC,OAAO,uCAAuC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC;YAC/K,CAAC;iBAAM,CAAC;gBACN,cAAc,GAAG,uBAAuB,iBAAiB,0BAA0B,MAAM,CAAC,OAAO,yCAAyC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;YACvK,CAAC;QACH,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAC3C,CAAC;IAEO,SAAS,CAAC,eAAuB;QACvC,kBAAkB;QAClB,MAAM,OAAO,GAA2B;YACtC,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,KAAK;SACZ,CAAC;QAEF,OAAO,OAAO,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC;IAC1C,CAAC;CACF;AAzFD,kDAyFC"}

package/examples/advanced-features.agentic

@@ -0,0 +1,98 @@
+// Advanced Agentic Language Features Demo
+// This example showcases all the powerful features of Agentic
+
+// Example 1: Match expressions with Result types
+@confidence(0.95, "Well-tested pattern matching")
+@complete
+funcprocessResult(value: number) -> Result<string, string> {
+  validateInput(value) match {
+    Ok(v) -> return Ok("Success: " + v),
+    Err(e) -> return Err("Failed: " + e)
+  }
+}
+
+// Example 2: Error recovery with context
+@confidence(0.85, "Has fallback mechanism")
+@partial
+funcfetchDataWithRecovery(url: string) -> Result<string, string> {
+  httpGet(url) or error {
+    @context {
+      what_failed: "HTTP GET request",
+      likely_cause: "Network timeout or invalid URL",
+      recovery: "Trying cached data"
+    }
+    return getCachedData(url)
+  }
+}
+
+// Example 3: Stub function (not implemented yet)
+@stub
+@needs(database, auth_token)
+funccreateUserAccount(username: string, email: string) -> Result<User, Error> {
+  // This will throw "not yet implemented" error
+}
+
+// Example 4: Uncertain areas marked
+@confidence(0.70, "Algorithm needs validation")
+@uncertain("edge cases", "performance impact")
+@partial
+funccomplexCalculation(data: number[]) -> Result<number, string> {
+  if data.length == 0 {
+    return Err("Empty data")
+  }
+
+  // Complex logic here...
+  return Ok(42)
+}
+
+// Example 5: Confidence-based fallback chain
+@confidence(0.90, "Multiple fallbacks ensure success")
+@complete
+funcrobustOperation(input: string) -> Result<string, string> {
+  primaryMethod(input) match {
+    Ok(result) -> return Ok(result),
+    Err(e) -> {
+      secondaryMethod(input) match {
+        Ok(result) -> return Ok(result),
+        Err(e2) -> return fallbackMethod(input)
+      }
+    }
+  }
+}
+
+// Example 6: Stage-aware development
+@partial
+@confidence(0.60, "Basic features only")
+funcaiModelInference(prompt: string) -> Result<string, string> {
+  // TODO: Add temperature control
+  // TODO: Add token limits
+  // TODO: Add streaming support
+  return Ok("Basic response")
+}
+
+// Example 7: Context validation
+@needs(api_key, model_name, temperature)
+@confidence(0.95, "Production-ready")
+@complete
+funcconfigureModel(config: Config) -> Result<Model, string> {
+  if !config.api_key {
+    return Err("Missing API key")
+  }
+
+  return Ok(createModel(config))
+}
+
+// Example 8: Nested match expressions
+@confidence(0.88, "Handles most cases")
+@complete
+funcprocessNestedResults(x: Result<number, string>) -> string {
+  x match {
+    Ok(value) -> {
+      doubleValue(value) match {
+        Ok(doubled) -> return "Doubled: " + doubled,
+        Err(e) -> return "Failed to double: " + e
+      }
+    },
+    Err(e) -> return "Initial error: " + e
+  }
+}

package/examples/annotations.agentic

@@ -0,0 +1,37 @@
+// Example: Annotation system demonstration
+// Shows different annotation types and their purposes
+
+@confidence(0.99, "Core functionality")
+@complete
+funcprocessData(data: string) -> Result<string, string> {
+  if !data {
+    return Err("Empty data")
+  }
+  return Ok(data)
+}
+
+@stub
+@needs(database_connection, auth_token)
+funcsaveToDatabase(data: string) -> Result<boolean, string> {
+  // Not yet implemented
+}
+
+@partial
+@confidence(0.60, "Basic features only")
+@uncertain("error handling", "edge cases")
+funcexperimentalFeature(input: number) -> Result<number, string> {
+  // Partially implemented
+  if input < 0 {
+    return Err("Negative input")
+  }
+  return Ok(input * 2)
+}
+
+@complete
+@confidence(0.88, "Production tested")
+funcrobustOperation(value: string) -> Result<string, string> {
+  processData(value) match {
+    Ok(result) -> return Ok(result),
+    Err(e) -> return Err("Failed: " + e)
+  }
+}

package/examples/auth.agentic

@@ -0,0 +1,53 @@
+// Example: Authentication with confidence tracking
+// This demonstrates Agentic language features
+
+@confidence(0.90)
+@needs(database: Database, jwt_secret: string)
+func authenticate(token: string) -> Result<User, AuthError> {
+    // Validate input with high confidence
+    @confident(0.99)
+    if token.isEmpty() {
+        return Err(AuthError.MISSING_TOKEN)
+    }
+
+    // Decode token with uncertainty
+    @uncertain("Edge case: malformed but decodable tokens?")
+    decoded = jwt.decode(token, jwt_secret) match {
+        Ok(payload) -> payload,
+        Err(e) -> {
+            @context {
+                what_failed: "JWT decode",
+                token_preview: token[0..20],
+                error: e.message,
+                suggestions: [
+                    "Check if token is properly base64 encoded",
+                    "Verify JWT_SECRET matches token issuer"
+                ]
+            }
+            return Err(AuthError.INVALID_TOKEN)
+        }
+    }
+
+    // Check expiration
+    @reasoning {
+        "Expired tokens must be rejected even if signature is valid"
+        "This prevents replay attacks"
+    }
+    if decoded.exp < now() {
+        return Err(AuthError.EXPIRED)
+    }
+
+    // Load user
+    user = database.users.find(decoded.user_id) or {
+        @anomaly("Token valid but user doesn't exist - possible account deletion")
+        return Err(AuthError.USER_NOT_FOUND)
+    }
+
+    return Ok(user)
+}
+
+// Property-based tests auto-generated:
+@property("rejects empty tokens")
+@property("rejects expired tokens")
+@property("accepts valid tokens")
+@property("fails gracefully on invalid format")