deepseek-coder-cli 1.0.0

package/dist/capabilities/webCapability.js

@@ -0,0 +1,33 @@
+/**
+ * Web Capability Module
+ *
+ * Provides web search and content extraction tools using:
+ * - Tavily (recommended): Search + Extract APIs
+ * - Brave Search: Web search fallback
+ * - SerpAPI: Google search fallback
+ */
+import { createWebTools } from '../tools/webTools.js';
+/**
+ * Web Capability Module
+ *
+ * Provides WebSearch and WebExtract tools for accessing web content.
+ */
+export class WebCapabilityModule {
+    id = 'capability.web';
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async create(_context) {
+        return {
+            id: 'web.tools',
+            description: 'Web search and content extraction',
+            toolSuite: {
+                id: 'web',
+                tools: createWebTools(),
+            },
+            metadata: {},
+        };
+    }
+}
+//# sourceMappingURL=webCapability.js.map

package/dist/capabilities/webCapability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webCapability.js","sourceRoot":"","sources":["../../src/capabilities/webCapability.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAMtD;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IACrB,EAAE,GAAG,gBAAgB,CAAC;IACd,OAAO,CAAuB;IAE/C,YAAY,UAAgC,EAAE;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAA2B;QACtC,OAAO;YACL,EAAE,EAAE,WAAW;YACf,WAAW,EAAE,mCAAmC;YAChD,SAAS,EAAE;gBACT,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,cAAc,EAAE;aACxB;YACD,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;CACF"}

package/dist/capabilities/zeroDayDiscoveryCapability.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Zero-Day Discovery Capability Module
+ *
+ * MAXIMUM CAPABILITIES FOR DISCOVERING ZERO-DAYS IN ANY POSSIBLE WAY
+ *
+ * Integrates zero-day discovery engine into AGI Core as a first-class capability.
+ * Provides tools for comprehensive vulnerability discovery across all attack surfaces.
+ */
+import type { CapabilityContribution, CapabilityContext, CapabilityModule } from '../runtime/agentHost.js';
+export interface ZeroDayDiscoveryCapabilityOptions {
+    /** Default aggressiveness level 0-1 */
+    defaultAggressiveness?: number;
+    /** Enable live verification by default */
+    defaultLiveVerification?: boolean;
+    /** Enable tournament RL by default */
+    defaultEnableTournament?: boolean;
+    /** Default heuristics to apply */
+    defaultHeuristics?: string[];
+    /** Default output directory */
+    outputDir?: string;
+    /** Working directory for discovery */
+    workingDir?: string;
+}
+export declare class ZeroDayDiscoveryCapabilityModule implements CapabilityModule {
+    readonly id = "capability.zero-day-discovery";
+    private readonly options;
+    constructor(options?: ZeroDayDiscoveryCapabilityOptions);
+    create(context: CapabilityContext): Promise<CapabilityContribution>;
+    private createDiscoveryTools;
+}
+//# sourceMappingURL=zeroDayDiscoveryCapability.d.ts.map

package/dist/capabilities/zeroDayDiscoveryCapability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zeroDayDiscoveryCapability.d.ts","sourceRoot":"","sources":["../../src/capabilities/zeroDayDiscoveryCapability.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3G,MAAM,WAAW,iCAAiC;IAChD,uCAAuC;IACvC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,0CAA0C;IAC1C,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,sCAAsC;IACtC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,gCAAiC,YAAW,gBAAgB;IACvE,QAAQ,CAAC,EAAE,mCAAmC;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;gBAEhD,OAAO,GAAE,iCAAsC;IA0BrD,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAmBzE,OAAO,CAAC,oBAAoB;CAkI7B"}

package/dist/capabilities/zeroDayDiscoveryCapability.js

@@ -0,0 +1,183 @@
+/**
+ * Zero-Day Discovery Capability Module
+ *
+ * MAXIMUM CAPABILITIES FOR DISCOVERING ZERO-DAYS IN ANY POSSIBLE WAY
+ *
+ * Integrates zero-day discovery engine into AGI Core as a first-class capability.
+ * Provides tools for comprehensive vulnerability discovery across all attack surfaces.
+ */
+import { ZeroDayDiscovery } from '../core/zeroDayDiscovery.js';
+export class ZeroDayDiscoveryCapabilityModule {
+    id = 'capability.zero-day-discovery';
+    options;
+    constructor(options = {}) {
+        this.options = {
+            defaultAggressiveness: 0.9,
+            defaultLiveVerification: true,
+            defaultEnableTournament: true,
+            defaultHeuristics: [
+                'complexityCorrelation',
+                'trustBoundaryAnalysis',
+                'temporalCoupling',
+                'serializationBoundaries',
+                'emergentBehaviors',
+                'errorHandlingAsymmetry',
+                'implicitStateDependencies',
+                'resourceExhaustion',
+                'supplyChainAnalysis',
+                'cryptographicWeakness',
+                'raceConditions',
+                'memoryCorruption',
+                'logicBugs',
+                'configurationDrift'
+            ],
+            outputDir: process.cwd(),
+            ...options
+        };
+    }
+    async create(context) {
+        const workingDir = this.options.workingDir ?? context.workingDir;
+        return {
+            id: 'zero-day-discovery.maximum-capability',
+            description: 'MAXIMUM CAPABILITIES FOR DISCOVERING ZERO-DAYS IN ANY POSSIBLE WAY - Integrated security audit, tournament RL, and multi-vector discovery',
+            toolSuite: {
+                id: 'zero-day-discovery',
+                description: 'Zero-day vulnerability discovery across all attack surfaces',
+                tools: this.createDiscoveryTools(workingDir),
+            },
+            metadata: {
+                workingDir,
+                outputDir: this.options.outputDir,
+                defaultAggressiveness: this.options.defaultAggressiveness,
+            },
+        };
+    }
+    createDiscoveryTools(workingDir) {
+        return [
+            {
+                name: 'discover_zero_days',
+                description: `MAXIMUM CAPABILITY ZERO-DAY DISCOVERY
+
+Execute comprehensive zero-day discovery across all available pathways:
+1. Heuristic-based vulnerability prediction
+2. Universal security audit integration  
+3. Tournament RL optimization
+4. Live verification and exploitation
+5. Multi-vector attack surface exploration
+
+Parameters:
+- target: Primary target (domain, IP, cloud project, etc.)
+- targetType: Type of target (web, cloud, mobile, api, infrastructure, iot, network, binary, source)
+- attackSurface: Specific attack surfaces to target (optional)
+- aggressiveness: Discovery aggressiveness 0-1 (default: 0.9)
+- liveVerification: Enable live exploitation verification (default: true)
+- enableTournament: Enable tournament RL optimization (default: true)
+- heuristics: Zero-day heuristic categories to apply (optional)
+- outputDir: Output directory for findings (default: current directory)
+
+Returns comprehensive discovery results with findings, metrics, and recommendations.`,
+                handler: async (args) => {
+                    try {
+                        const config = {
+                            target: args.target || 'localhost',
+                            targetType: args.targetType || 'web',
+                            attackSurface: args.attackSurface || [],
+                            aggressiveness: args.aggressiveness ?? this.options.defaultAggressiveness,
+                            liveVerification: args.liveVerification ?? this.options.defaultLiveVerification,
+                            enableTournament: args.enableTournament ?? this.options.defaultEnableTournament,
+                            heuristics: args.heuristics || this.options.defaultHeuristics,
+                            outputDir: args.outputDir || this.options.outputDir,
+                        };
+                        const discovery = new ZeroDayDiscovery(config);
+                        const result = await discovery.discover();
+                        return JSON.stringify({
+                            status: 'success',
+                            result,
+                            summary: {
+                                target: result.target,
+                                findings: result.findings.length,
+                                zeroDays: result.findings.filter(f => f.zeroDayConfidence > 0.8).length,
+                                critical: result.findings.filter(f => f.severity === 'critical').length,
+                                high: result.findings.filter(f => f.severity === 'high').length,
+                                duration: result.duration,
+                            },
+                        }, null, 2);
+                    }
+                    catch (error) {
+                        return JSON.stringify({
+                            status: 'error',
+                            error: error.message,
+                            stack: error.stack,
+                        }, null, 2);
+                    }
+                },
+            },
+            {
+                name: 'zero_day_health_check',
+                description: 'Check zero-day discovery capability health and readiness',
+                handler: async () => {
+                    try {
+                        // Quick test of zero-day discovery engine
+                        const testDiscovery = new ZeroDayDiscovery({
+                            target: 'test.local',
+                            targetType: 'web',
+                            attackSurface: ['web'],
+                            aggressiveness: 0.1,
+                            liveVerification: false,
+                            enableTournament: false,
+                            heuristics: ['trustBoundaryAnalysis'],
+                            outputDir: workingDir,
+                        });
+                        const health = {
+                            engine: 'operational',
+                            heuristics: this.options.defaultHeuristics?.length || 0,
+                            workingDir,
+                            outputDir: this.options.outputDir,
+                            timestamp: new Date().toISOString(),
+                        };
+                        return JSON.stringify({
+                            status: 'healthy',
+                            health,
+                            message: 'Zero-day discovery capability is operational',
+                        }, null, 2);
+                    }
+                    catch (error) {
+                        return JSON.stringify({
+                            status: 'unhealthy',
+                            error: error.message,
+                            message: 'Zero-day discovery capability failed health check',
+                        }, null, 2);
+                    }
+                },
+            },
+            {
+                name: 'list_zero_day_heuristics',
+                description: 'List all available zero-day discovery heuristics with descriptions',
+                handler: async () => {
+                    const heuristics = [
+                        { id: 'complexityCorrelation', principle: 'Vulnerabilities cluster where code complexity exceeds cognitive limits', weight: 0.85 },
+                        { id: 'trustBoundaryAnalysis', principle: 'Every trust boundary crossing is a potential attack surface', weight: 0.90 },
+                        { id: 'temporalCoupling', principle: 'Time-based operations create race condition opportunities', weight: 0.80 },
+                        { id: 'serializationBoundaries', principle: 'Data format transitions are high-risk transformation points', weight: 0.88 },
+                        { id: 'emergentBehaviors', principle: 'Complex systems exhibit behaviors not present in components', weight: 0.75 },
+                        { id: 'errorHandlingAsymmetry', principle: 'Error paths receive less testing than happy paths', weight: 0.82 },
+                        { id: 'implicitStateDependencies', principle: 'Hidden state coupling creates unexpected interactions', weight: 0.78 },
+                        { id: 'resourceExhaustion', principle: 'Resource limits are often enforced inconsistently', weight: 0.70 },
+                        { id: 'supplyChainAnalysis', principle: 'Third-party dependencies introduce unknown vulnerabilities', weight: 0.88 },
+                        { id: 'cryptographicWeakness', principle: 'Cryptographic implementations often contain subtle flaws', weight: 0.92 },
+                        { id: 'raceConditions', principle: 'Concurrent access to shared resources creates timing windows', weight: 0.83 },
+                        { id: 'memoryCorruption', principle: 'Memory management errors enable arbitrary code execution', weight: 0.95 },
+                        { id: 'logicBugs', principle: 'Business logic errors create security bypass opportunities', weight: 0.79 },
+                        { id: 'configurationDrift', principle: 'Configuration changes over time introduce security gaps', weight: 0.72 },
+                    ];
+                    return JSON.stringify({
+                        heuristics,
+                        count: heuristics.length,
+                        recommended: this.options.defaultHeuristics,
+                    }, null, 2);
+                },
+            },
+        ];
+    }
+}
+//# sourceMappingURL=zeroDayDiscoveryCapability.js.map

package/dist/capabilities/zeroDayDiscoveryCapability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zeroDayDiscoveryCapability.js","sourceRoot":"","sources":["../../src/capabilities/zeroDayDiscoveryCapability.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,gBAAgB,EAA4D,MAAM,6BAA6B,CAAC;AAiBzH,MAAM,OAAO,gCAAgC;IAClC,EAAE,GAAG,+BAA+B,CAAC;IAC7B,OAAO,CAAoC;IAE5D,YAAY,UAA6C,EAAE;QACzD,IAAI,CAAC,OAAO,GAAG;YACb,qBAAqB,EAAE,GAAG;YAC1B,uBAAuB,EAAE,IAAI;YAC7B,uBAAuB,EAAE,IAAI;YAC7B,iBAAiB,EAAE;gBACjB,uBAAuB;gBACvB,uBAAuB;gBACvB,kBAAkB;gBAClB,yBAAyB;gBACzB,mBAAmB;gBACnB,wBAAwB;gBACxB,2BAA2B;gBAC3B,oBAAoB;gBACpB,qBAAqB;gBACrB,uBAAuB;gBACvB,gBAAgB;gBAChB,kBAAkB;gBAClB,WAAW;gBACX,oBAAoB;aACrB;YACD,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE;YACxB,GAAG,OAAO;SACX,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAA0B;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;QAEjE,OAAO;YACL,EAAE,EAAE,uCAAuC;YAC3C,WAAW,EAAE,2IAA2I;YACxJ,SAAS,EAAE;gBACT,EAAE,EAAE,oBAAoB;gBACxB,WAAW,EAAE,6DAA6D;gBAC1E,KAAK,EAAE,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC;aAC7C;YACD,QAAQ,EAAE;gBACR,UAAU;gBACV,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;gBACjC,qBAAqB,EAAE,IAAI,CAAC,OAAO,CAAC,qBAAqB;aAC1D;SACF,CAAC;IACJ,CAAC;IAEO,oBAAoB,CAAC,UAAkB;QAC7C,OAAO;YACL;gBACE,IAAI,EAAE,oBAAoB;gBAC1B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;qFAmBgE;gBAC7E,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,EAAE;oBAC3B,IAAI,CAAC;wBACH,MAAM,MAAM,GAA2B;4BACrC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,WAAW;4BAClC,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,KAAK;4BACpC,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE;4BACvC,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,OAAO,CAAC,qBAAqB;4BACzE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,OAAO,CAAC,uBAAuB;4BAC/E,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,OAAO,CAAC,uBAAuB;4BAC/E,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,iBAAiB;4BAC7D,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS;yBACpD,CAAC;wBAEF,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;wBAC/C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE,CAAC;wBAE1C,OAAO,IAAI,CAAC,SAAS,CAAC;4BACpB,MAAM,EAAE,SAAS;4BACjB,MAAM;4BACN,OAAO,EAAE;gCACP,MAAM,EAAE,MAAM,CAAC,MAAM;gCACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;gCAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,GAAG,GAAG,CAAC,CAAC,MAAM;gCACvE,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,MAAM;gCACvE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM;gCAC/D,QAAQ,EAAE,MAAM,CAAC,QAAQ;6BAC1B;yBACF,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;oBACd,CAAC;oBAAC,OAAO,KAAU,EAAE,CAAC;wBACpB,OAAO,IAAI,CAAC,SAAS,CAAC;4BACpB,MAAM,EAAE,OAAO;4BACf,KAAK,EAAE,KAAK,CAAC,OAAO;4BACpB,KAAK,EAAE,KAAK,CAAC,KAAK;yBACnB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;oBACd,CAAC;gBACH,CAAC;aACF;YACD;gBACE,IAAI,EAAE,uBAAuB;gBAC7B,WAAW,EAAE,0DAA0D;gBACvE,OAAO,EAAE,KAAK,IAAI,EAAE;oBAClB,IAAI,CAAC;wBACH,0CAA0C;wBAC1C,MAAM,aAAa,GAAG,IAAI,gBAAgB,CAAC;4BACzC,MAAM,EAAE,YAAY;4BACpB,UAAU,EAAE,KAAK;4BACjB,aAAa,EAAE,CAAC,KAAK,CAAC;4BACtB,cAAc,EAAE,GAAG;4BACnB,gBAAgB,EAAE,KAAK;4BACvB,gBAAgB,EAAE,KAAK;4BACvB,UAAU,EAAE,CAAC,uBAAuB,CAAC;4BACrC,SAAS,EAAE,UAAU;yBACtB,CAAC,CAAC;wBAEH,MAAM,MAAM,GAAG;4BACb,MAAM,EAAE,aAAa;4BACrB,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,MAAM,IAAI,CAAC;4BACvD,UAAU;4BACV,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;4BACjC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;yBACpC,CAAC;wBAEF,OAAO,IAAI,CAAC,SAAS,CAAC;4BACpB,MAAM,EAAE,SAAS;4BACjB,MAAM;4BACN,OAAO,EAAE,8CAA8C;yBACxD,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;oBACd,CAAC;oBAAC,OAAO,KAAU,EAAE,CAAC;wBACpB,OAAO,IAAI,CAAC,SAAS,CAAC;4BACpB,MAAM,EAAE,WAAW;4BACnB,KAAK,EAAE,KAAK,CAAC,OAAO;4BACpB,OAAO,EAAE,mDAAmD;yBAC7D,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;oBACd,CAAC;gBACH,CAAC;aACF;YACD;gBACE,IAAI,EAAE,0BAA0B;gBAChC,WAAW,EAAE,oEAAoE;gBACjF,OAAO,EAAE,KAAK,IAAI,EAAE;oBAClB,MAAM,UAAU,GAAG;wBACjB,EAAE,EAAE,EAAE,uBAAuB,EAAE,SAAS,EAAE,wEAAwE,EAAE,MAAM,EAAE,IAAI,EAAE;wBAClI,EAAE,EAAE,EAAE,uBAAuB,EAAE,SAAS,EAAE,6DAA6D,EAAE,MAAM,EAAE,IAAI,EAAE;wBACvH,EAAE,EAAE,EAAE,kBAAkB,EAAE,SAAS,EAAE,2DAA2D,EAAE,MAAM,EAAE,IAAI,EAAE;wBAChH,EAAE,EAAE,EAAE,yBAAyB,EAAE,SAAS,EAAE,6DAA6D,EAAE,MAAM,EAAE,IAAI,EAAE;wBACzH,EAAE,EAAE,EAAE,mBAAmB,EAAE,SAAS,EAAE,6DAA6D,EAAE,MAAM,EAAE,IAAI,EAAE;wBACnH,EAAE,EAAE,EAAE,wBAAwB,EAAE,SAAS,EAAE,mDAAmD,EAAE,MAAM,EAAE,IAAI,EAAE;wBAC9G,EAAE,EAAE,EAAE,2BAA2B,EAAE,SAAS,EAAE,uDAAuD,EAAE,MAAM,EAAE,IAAI,EAAE;wBACrH,EAAE,EAAE,EAAE,oBAAoB,EAAE,SAAS,EAAE,mDAAmD,EAAE,MAAM,EAAE,IAAI,EAAE;wBAC1G,EAAE,EAAE,EAAE,qBAAqB,EAAE,SAAS,EAAE,4DAA4D,EAAE,MAAM,EAAE,IAAI,EAAE;wBACpH,EAAE,EAAE,EAAE,uBAAuB,EAAE,SAAS,EAAE,0DAA0D,EAAE,MAAM,EAAE,IAAI,EAAE;wBACpH,EAAE,EAAE,EAAE,gBAAgB,EAAE,SAAS,EAAE,8DAA8D,EAAE,MAAM,EAAE,IAAI,EAAE;wBACjH,EAAE,EAAE,EAAE,kBAAkB,EAAE,SAAS,EAAE,0DAA0D,EAAE,MAAM,EAAE,IAAI,EAAE;wBAC/G,EAAE,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,4DAA4D,EAAE,MAAM,EAAE,IAAI,EAAE;wBAC1G,EAAE,EAAE,EAAE,oBAAoB,EAAE,SAAS,EAAE,yDAAyD,EAAE,MAAM,EAAE,IAAI,EAAE;qBACjH,CAAC;oBAEF,OAAO,IAAI,CAAC,SAAS,CAAC;wBACpB,UAAU;wBACV,KAAK,EAAE,UAAU,CAAC,MAAM;wBACxB,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB;qBAC5C,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBACd,CAAC;aACF;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/config.d.ts

@@ -0,0 +1,25 @@
+import type { ProviderId } from './core/types.js';
+import { type ProfileName } from './core/agentProfiles.js';
+export type { ProfileName } from './core/agentProfiles.js';
+export interface ResolvedProfileConfig {
+    profile: ProfileName;
+    label: string;
+    provider: ProviderId;
+    model: string;
+    systemPrompt: string;
+    temperature?: number;
+    maxTokens?: number;
+    modelLocked: boolean;
+    providerLocked: boolean;
+    rulebook: ProfileRulebookMetadata | null;
+}
+export interface ProfileRulebookMetadata {
+    profile: ProfileName;
+    label: string;
+    version: string;
+    contractVersion: string;
+    description?: string;
+    file: string;
+}
+export declare function resolveProfileConfig(profile: ProfileName, workspaceContext: string | null): ResolvedProfileConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAKjC,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,UAAU,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAgBD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,qBAAqB,CAqDjH"}

package/dist/config.js

@@ -0,0 +1,155 @@
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { registerAgentProfile, hasAgentProfile, getAgentProfile, } from './core/agentProfiles.js';
+import { buildAgentRulebookPrompt, loadAgentRulebook } from './core/agentRulebook.js';
+import { getAgentProfileManifest } from './core/agentProfileManifest.js';
+import { inferProviderFromModelId } from './core/modelDiscovery.js';
+const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const PROFILE_MANIFEST = getAgentProfileManifest();
+const DEFAULT_PROFILES = PROFILE_MANIFEST.profiles.map((entry) => normalizeProfileFromManifest(entry, PROFILE_MANIFEST, PACKAGE_ROOT));
+for (const profile of DEFAULT_PROFILES) {
+    if (!hasAgentProfile(profile.name)) {
+        registerAgentProfile(profile);
+    }
+}
+export function resolveProfileConfig(profile, workspaceContext) {
+    const blueprint = getAgentProfile(profile);
+    const envPrefix = toEnvPrefix(blueprint.name);
+    const modelEnv = process.env[`${envPrefix}_MODEL`];
+    const modelLocked = typeof modelEnv === 'string' && modelEnv.trim().length > 0;
+    const model = modelLocked ? modelEnv.trim() : blueprint.defaultModel;
+    const inferredProvider = inferProviderFromModelId(model);
+    const systemPrompt = process.env[`${envPrefix}_SYSTEM_PROMPT`] ?? blueprint.defaultSystemPrompt;
+    const providerEnv = process.env[`${envPrefix}_PROVIDER`];
+    const providerCandidate = isProviderValue(providerEnv) ? providerEnv.trim() : null;
+    const providerLocked = Boolean(providerCandidate) && (!inferredProvider || providerCandidate === inferredProvider);
+    const provider = (() => {
+        if (providerCandidate && inferredProvider && providerCandidate !== inferredProvider) {
+            // Prefer the model-aligned provider over a mismatched env override
+            return inferredProvider;
+        }
+        if (providerCandidate) {
+            return providerCandidate;
+        }
+        if (inferredProvider) {
+            return inferredProvider;
+        }
+        return blueprint.defaultProvider;
+    })();
+    const rulebook = loadRulebookMetadata(blueprint);
+    const contextBlock = workspaceContext?.trim()
+        ? `\n\nWorkspace context (auto-detected):\n${workspaceContext.trim()}`
+        : '';
+    const resolved = {
+        profile,
+        label: blueprint.label,
+        provider,
+        model,
+        systemPrompt: `${systemPrompt.trim()}${contextBlock}`,
+        modelLocked,
+        providerLocked,
+        rulebook,
+    };
+    if (typeof blueprint.temperature === 'number') {
+        resolved.temperature = blueprint.temperature;
+    }
+    if (typeof blueprint.maxTokens === 'number') {
+        resolved.maxTokens = blueprint.maxTokens;
+    }
+    return resolved;
+}
+function toEnvPrefix(profile) {
+    return profile
+        .trim()
+        .toUpperCase()
+        .replace(/[^A-Z0-9]/g, '_');
+}
+function isProviderValue(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function loadRulebookMetadata(profile) {
+    try {
+        // Check if rulebook is inline
+        const rulebookRef = profile.rulebook; // eslint-disable-line @typescript-eslint/no-explicit-any
+        const manifest = rulebookRef.inline
+            ? loadAgentRulebook(profile.name, { inline: rulebookRef.inline })
+            : loadAgentRulebook(profile.name, {
+                root: PACKAGE_ROOT,
+                file: rulebookRef.file,
+            });
+        return {
+            profile: manifest.profile,
+            label: manifest.label ?? manifest.profile,
+            version: manifest.version,
+            contractVersion: manifest.contractVersion,
+            description: manifest.description ?? profile.rulebook.description,
+            file: rulebookRef.file ?? '[inline]',
+        };
+    }
+    catch {
+        if (!profile.rulebook) {
+            return null;
+        }
+        const rulebookRef = profile.rulebook; // eslint-disable-line @typescript-eslint/no-explicit-any
+        const fallback = {
+            profile: profile.name,
+            label: profile.label,
+            version: rulebookRef.version ?? 'unknown',
+            contractVersion: rulebookRef.contractVersion ?? 'unknown',
+            description: rulebookRef.description,
+            file: rulebookRef.file ?? '[inline]',
+        };
+        return fallback;
+    }
+}
+function normalizeProfileFromManifest(entry, manifest, root) {
+    const defaultSystemPrompt = buildDefaultSystemPrompt(entry, root);
+    return {
+        name: entry.name,
+        label: entry.label,
+        description: entry.description,
+        defaultProvider: entry.defaultProvider,
+        defaultModel: entry.defaultModel,
+        systemPromptConfig: entry.systemPrompt,
+        defaultSystemPrompt,
+        temperature: entry.temperature,
+        maxTokens: entry.maxTokens,
+        rulebook: entry.rulebook,
+        manifestVersion: manifest.version,
+        manifestContractVersion: manifest.contractVersion,
+    };
+}
+function buildDefaultSystemPrompt(entry, root) {
+    try {
+        const promptConfig = entry.systemPrompt;
+        if (promptConfig.type === 'literal') {
+            return promptConfig.content.trim();
+        }
+        const template = promptConfig.template?.trim() || '{{rulebook}}';
+        // Check if rulebook is inline
+        const rulebookRef = entry.rulebook; // eslint-disable-line @typescript-eslint/no-explicit-any
+        const rulebookPrompt = rulebookRef.inline
+            ? buildAgentRulebookPrompt(entry.name, { inline: rulebookRef.inline }).trim()
+            : buildAgentRulebookPrompt(entry.name, { root, file: rulebookRef.file }).trim();
+        const replacements = {
+            rulebook: rulebookPrompt,
+            profile: entry.label || entry.name,
+            profile_name: entry.name,
+        };
+        const rendered = template.replace(/\{\{\s*(rulebook|profile|profile_name)\s*\}\}/gi, (_match, token) => {
+            const key = token.toLowerCase();
+            return replacements[key] ?? '';
+        });
+        if (/\{\{\s*rulebook\s*\}\}/i.test(template)) {
+            return rendered.trim();
+        }
+        const merged = rendered.trim();
+        const suffix = merged ? `\n\n${rulebookPrompt}` : rulebookPrompt;
+        return `${merged}${suffix}`.trim();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to build system prompt for profile "${entry.name}": ${message}`);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/contracts/agent-profiles.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "./schemas/agent-profile.schema.json",
+  "contractVersion": "1.0.0",
+  "version": "2024-11-24",
+  "label": "AGI CLI profile manifest",
+  "description": "Default profile definitions shipped with the CLI, including provider defaults and rulebook bindings.",
+  "profiles": [
+    {
+      "name": "general",
+      "label": "AGI",
+      "description": "General-purpose operator with advanced reasoning across research, planning, writing, and coding tasks.",
+      "defaultProvider": "anthropic",
+      "defaultModel": "claude-sonnet-4-20250514",
+      "temperature": 0.2,
+      "systemPrompt": {
+        "type": "rulebook",
+        "template": "{{rulebook}}"
+      },
+      "rulebook": {
+        "file": "agents/general.rules.json",
+        "version": "2024-11-24",
+        "contractVersion": "1.0.0",
+        "description": "Structured rules governing the balanced AGI profile."
+      }
+    },
+    {
+      "name": "agi-code",
+      "label": "AGI Code",
+      "description": "Coding specialist with advanced reasoning capabilities.",
+      "defaultProvider": "anthropic",
+      "defaultModel": "claude-sonnet-4-20250514",
+      "systemPrompt": {
+        "type": "rulebook"
+      },
+      "rulebook": {
+        "file": "agents/agi-code.rules.json",
+        "version": "2024-11-24",
+        "contractVersion": "1.0.0",
+        "description": "Deterministic coding workflow guardrails."
+      }
+    }
+  ]
+}