@phenixstar/talon 1.0.0

package/dist/cli/setup.js

@@ -0,0 +1,302 @@
+// Copyright (C) 2025 PhenixStar (Alaa Qweider)
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License version 3
+// as published by the Free Software Foundation.
+/**
+ * Talon Interactive Setup Wizard
+ *
+ * Guides users through dependency checking, auth configuration,
+ * and .env generation. Invoked via `./talon setup`.
+ */
+import { select, input, password, confirm, checkbox } from '@inquirer/prompts';
+import chalk from 'chalk';
+import { showBanner, showSummary, showSuccess, showError, showDependencyTable, } from './setup-renderer.js';
+import { readEnvFile, mergeEnv, backupEnvFile, writeEnvFile, validateEnv, } from './env-configurator.js';
+import { checkAllDependencies, detectRunMode, isDockerRunning, checkDiskSpaceGb, } from './dependency-checker.js';
+const ENV_PATH = '.env';
+// === Auth Mode Prompts ===
+async function promptApiKey() {
+    const key = await password({
+        message: 'Anthropic API Key (sk-ant-...):',
+        mask: '*',
+        validate: (v) => {
+            if (!v || v.trim().length === 0)
+                return 'API key is required';
+            return true;
+        },
+    });
+    return [{ key: 'ANTHROPIC_API_KEY', value: key }];
+}
+async function promptOAuth() {
+    const token = await password({
+        message: 'Claude Code OAuth Token (sk-ant-oat01-...):',
+        mask: '*',
+        validate: (v) => {
+            if (!v || v.trim().length === 0)
+                return 'OAuth token is required';
+            return true;
+        },
+    });
+    return [{ key: 'CLAUDE_CODE_OAUTH_TOKEN', value: token }];
+}
+async function promptBedrock() {
+    const region = await input({ message: 'AWS Region (e.g. us-east-1):' });
+    const bearerToken = await password({ message: 'AWS Bearer Token:', mask: '*' });
+    const small = await input({ message: 'Small model ID:', default: 'us.anthropic.claude-haiku-4-5-20251001-v1:0' });
+    const medium = await input({ message: 'Medium model ID:', default: 'us.anthropic.claude-sonnet-4-6-20250514-v1:0' });
+    const large = await input({ message: 'Large model ID:', default: 'us.anthropic.claude-opus-4-6-20250610-v1:0' });
+    return [
+        { key: 'CLAUDE_CODE_USE_BEDROCK', value: '1' },
+        { key: 'AWS_REGION', value: region },
+        { key: 'AWS_BEARER_TOKEN_BEDROCK', value: bearerToken },
+        { key: 'ANTHROPIC_SMALL_MODEL', value: small },
+        { key: 'ANTHROPIC_MEDIUM_MODEL', value: medium },
+        { key: 'ANTHROPIC_LARGE_MODEL', value: large },
+    ];
+}
+async function promptVertex() {
+    const region = await input({ message: 'Cloud ML Region (e.g. us-central1):' });
+    const projectId = await input({ message: 'Vertex Project ID:' });
+    const credPath = await input({
+        message: 'Service account key path (place in ./credentials/):',
+        default: './credentials/gcp-sa-key.json',
+    });
+    const small = await input({ message: 'Small model ID:', default: 'claude-haiku-4-5-20251001' });
+    const medium = await input({ message: 'Medium model ID:', default: 'claude-sonnet-4-6-20250514' });
+    const large = await input({ message: 'Large model ID:', default: 'claude-opus-4-6-20250610' });
+    return [
+        { key: 'CLAUDE_CODE_USE_VERTEX', value: '1' },
+        { key: 'CLOUD_ML_REGION', value: region },
+        { key: 'ANTHROPIC_VERTEX_PROJECT_ID', value: projectId },
+        { key: 'GOOGLE_APPLICATION_CREDENTIALS', value: credPath },
+        { key: 'ANTHROPIC_SMALL_MODEL', value: small },
+        { key: 'ANTHROPIC_MEDIUM_MODEL', value: medium },
+        { key: 'ANTHROPIC_LARGE_MODEL', value: large },
+    ];
+}
+const ROUTER_PROVIDERS = [
+    { name: 'OpenRouter', value: 'OPENROUTER_API_KEY' },
+    { name: 'OpenAI', value: 'OPENAI_API_KEY' },
+    { name: 'Groq', value: 'GROQ_API_KEY' },
+    { name: 'xAI (Grok)', value: 'XAI_API_KEY' },
+    { name: 'Kimi (Moonshot)', value: 'KIMI_API_KEY' },
+    { name: 'MiniMax', value: 'MINIMAX_HIGHSPEED_API_KEY' },
+    { name: 'Z-AI (GLM)', value: 'ZAI_CODING_PLAN_API_KEY' },
+];
+async function promptRouter() {
+    const entries = [{ key: 'ROUTER', value: 'true' }];
+    // Check if user also has an Anthropic key (recommended for best results)
+    const hasAnthropic = await confirm({
+        message: 'Do you also have an Anthropic API key? (recommended for best results)',
+        default: true,
+    });
+    if (hasAnthropic) {
+        const key = await password({ message: 'Anthropic API Key:', mask: '*' });
+        entries.push({ key: 'ANTHROPIC_API_KEY', value: key });
+    }
+    else {
+        entries.push({ key: 'ANTHROPIC_API_KEY', value: 'router-mode' });
+    }
+    // Select which providers to configure
+    const selected = await checkbox({
+        message: 'Select additional LLM providers to configure:',
+        choices: ROUTER_PROVIDERS.map(p => ({ name: p.name, value: p.value })),
+        required: true,
+    });
+    // Capture API key for each selected provider
+    for (const envKey of selected) {
+        const provider = ROUTER_PROVIDERS.find(p => p.value === envKey);
+        const key = await password({
+            message: `${provider?.name ?? envKey} API Key:`,
+            mask: '*',
+        });
+        entries.push({ key: envKey, value: key });
+    }
+    return entries;
+}
+// === Main Wizard ===
+async function main() {
+    showBanner();
+    // 1. Check existing .env
+    const existingEnv = readEnvFile(ENV_PATH);
+    if (existingEnv.size > 0) {
+        const action = await select({
+            message: `Found existing .env with ${existingEnv.size} values. What would you like to do?`,
+            choices: [
+                { name: 'Reconfigure (merge — keeps existing values not overwritten)', value: 'merge' },
+                { name: 'Start fresh (backup existing, create new)', value: 'fresh' },
+                { name: 'Cancel', value: 'cancel' },
+            ],
+        });
+        if (action === 'cancel') {
+            console.log(chalk.dim('  Setup cancelled.\n'));
+            return;
+        }
+        if (action === 'fresh') {
+            existingEnv.clear();
+        }
+    }
+    // 2. Dependency check + run mode
+    const recommended = detectRunMode();
+    const runMode = await select({
+        message: 'How will you run Talon?',
+        choices: [
+            {
+                name: `Docker (recommended${recommended === 'docker' ? ' — Docker detected' : ''})`,
+                value: 'docker',
+            },
+            {
+                name: 'Bare metal (Node.js direct, no Docker)',
+                value: 'bare-metal',
+            },
+        ],
+        default: recommended,
+    });
+    const deps = checkAllDependencies(runMode);
+    showDependencyTable(deps);
+    const missingRequired = deps.filter(d => d.required && (!d.installed || !d.versionOk));
+    if (missingRequired.length > 0) {
+        console.log(chalk.yellow('  Missing required dependencies:\n'));
+        for (const dep of missingRequired) {
+            console.log(chalk.yellow(`    ${dep.name}: ${dep.installHint}`));
+        }
+        console.log();
+        const proceed = await confirm({
+            message: 'Continue setup anyway? (you can install them later)',
+            default: false,
+        });
+        if (!proceed) {
+            showError('Install missing dependencies and run ./talon setup again.');
+            process.exit(1);
+        }
+    }
+    // Docker daemon check
+    if (runMode === 'docker') {
+        const dockerDep = deps.find(d => d.name === 'Docker');
+        if (dockerDep?.installed && !isDockerRunning()) {
+            console.log(chalk.yellow('  ⚠ Docker is installed but the daemon is not running.'));
+            console.log(chalk.dim('    Start it with: sudo systemctl start docker'));
+            console.log();
+        }
+    }
+    // Disk space check
+    const diskGb = checkDiskSpaceGb();
+    if (diskGb !== null && diskGb < 10) {
+        console.log(chalk.yellow(`  ⚠ Low disk space: ${diskGb}GB available (10GB recommended)\n`));
+    }
+    // 3. Auth mode
+    const authMode = await select({
+        message: 'How do you want to authenticate with Claude?',
+        choices: [
+            { name: 'Anthropic API Key (recommended)', value: 'api-key' },
+            { name: 'Claude Code OAuth Token (Max plan)', value: 'oauth' },
+            { name: 'AWS Bedrock', value: 'bedrock' },
+            { name: 'Google Vertex AI', value: 'vertex' },
+            { name: 'Multi-LLM Router (multiple providers)', value: 'router' },
+        ],
+    });
+    // 4. Collect credentials
+    let newEntries;
+    switch (authMode) {
+        case 'api-key':
+            newEntries = await promptApiKey();
+            break;
+        case 'oauth':
+            newEntries = await promptOAuth();
+            break;
+        case 'bedrock':
+            newEntries = await promptBedrock();
+            break;
+        case 'vertex':
+            newEntries = await promptVertex();
+            break;
+        case 'router':
+            newEntries = await promptRouter();
+            break;
+    }
+    // 5. Optional settings
+    const configureOptional = await confirm({
+        message: 'Configure optional settings? (output dir, model routing, testing mode)',
+        default: false,
+    });
+    if (configureOptional) {
+        const pipelineTesting = await confirm({
+            message: 'Enable pipeline testing mode? (minimal prompts, fast retries — for dev/CI)',
+            default: false,
+        });
+        if (pipelineTesting) {
+            newEntries.push({ key: 'PIPELINE_TESTING', value: 'true' });
+        }
+        const customTokens = await confirm({
+            message: 'Set custom max output tokens? (default: 64000)',
+            default: false,
+        });
+        if (customTokens) {
+            const tokens = await input({ message: 'Max output tokens:', default: '64000' });
+            newEntries.push({ key: 'CLAUDE_CODE_MAX_OUTPUT_TOKENS', value: tokens });
+        }
+        const customTurns = await confirm({
+            message: 'Set custom max agent turns? (default: 500)',
+            default: false,
+        });
+        if (customTurns) {
+            const turns = await input({ message: 'Max turns per agent:', default: '500' });
+            newEntries.push({ key: 'TALON_MAX_TURNS', value: turns });
+        }
+    }
+    // 6. Summary
+    const merged = mergeEnv(existingEnv, newEntries);
+    const sensitiveKeys = new Set([
+        'ANTHROPIC_API_KEY', 'CLAUDE_CODE_OAUTH_TOKEN', 'AWS_BEARER_TOKEN_BEDROCK',
+        'OPENAI_API_KEY', 'OPENROUTER_API_KEY', 'GROQ_API_KEY', 'XAI_API_KEY',
+        'KIMI_API_KEY', 'MINIMAX_HIGHSPEED_API_KEY', 'ZAI_CODING_PLAN_API_KEY',
+        'TALON_ROUTER_KEY',
+    ]);
+    const authModeLabels = {
+        'api-key': 'Anthropic API Key',
+        'oauth': 'Claude Code OAuth',
+        'bedrock': 'AWS Bedrock',
+        'vertex': 'Google Vertex AI',
+        'router': 'Multi-LLM Router',
+    };
+    const summaryConfig = {
+        authMode: authModeLabels[authMode],
+        envPath: ENV_PATH,
+        runMode: runMode === 'docker' ? 'Docker' : 'Bare Metal',
+        values: newEntries.map(({ key, value }) => ({
+            key,
+            value,
+            masked: sensitiveKeys.has(key),
+        })),
+    };
+    showSummary(summaryConfig);
+    const proceed = await confirm({ message: 'Save this configuration?', default: true });
+    if (!proceed) {
+        console.log(chalk.dim('  Setup cancelled.\n'));
+        return;
+    }
+    // 7. Validate
+    const missing = validateEnv(merged, authMode);
+    if (missing.length > 0) {
+        showError(`Missing required values: ${missing.join(', ')}`);
+        process.exit(1);
+    }
+    // 8. Write
+    const backupPath = backupEnvFile(ENV_PATH);
+    if (backupPath) {
+        console.log(chalk.dim(`  Backed up existing .env to ${backupPath}`));
+    }
+    writeEnvFile(ENV_PATH, merged);
+    showSuccess(ENV_PATH);
+}
+main().catch((error) => {
+    // Handle Ctrl+C gracefully
+    if (error instanceof Error && error.message.includes('User force closed')) {
+        console.log(chalk.dim('\n  Setup cancelled.\n'));
+        process.exit(0);
+    }
+    showError(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});
+//# sourceMappingURL=setup.js.map

package/dist/cli/setup.js.map

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

package/dist/types/activity-logger.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Logger interface for services called from Temporal activities.
+ * Keeps services Temporal-agnostic while providing structured logging.
+ */
+export interface ActivityLogger {
+    info(message: string, attrs?: Record<string, unknown>): void;
+    warn(message: string, attrs?: Record<string, unknown>): void;
+    error(message: string, attrs?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=activity-logger.d.ts.map

package/dist/types/activity-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-logger.d.ts","sourceRoot":"","sources":["../../src/types/activity-logger.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC/D"}

package/dist/types/activity-logger.js

@@ -0,0 +1,7 @@
+// Copyright (C) 2025 PhenixStar (Alaa Qweider)
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License version 3
+// as published by the Free Software Foundation.
+export {};
+//# sourceMappingURL=activity-logger.js.map

package/dist/types/activity-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-logger.js","sourceRoot":"","sources":["../../src/types/activity-logger.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,uEAAuE;AACvE,wEAAwE;AACxE,gDAAgD"}

package/dist/types/agents.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Agent type definitions
+ */
+/**
+ * List of all agents in execution order.
+ * Used for iteration during resume state checking.
+ */
+export declare const ALL_AGENTS: readonly ["pre-recon", "recon", "injection-vuln", "xss-vuln", "auth-vuln", "ssrf-vuln", "authz-vuln", "injection-exploit", "xss-exploit", "auth-exploit", "ssrf-exploit", "authz-exploit", "report"];
+/**
+ * Agent name type derived from ALL_AGENTS.
+ * This ensures type safety and prevents drift between type and array.
+ */
+export type AgentName = typeof ALL_AGENTS[number];
+export type PlaywrightAgent = 'playwright-agent1' | 'playwright-agent2' | 'playwright-agent3' | 'playwright-agent4' | 'playwright-agent5';
+import type { ActivityLogger } from './activity-logger.js';
+export type AgentValidator = (sourceDir: string, logger: ActivityLogger) => Promise<boolean>;
+export type AgentStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'rolled-back';
+export interface AgentDefinition {
+    name: AgentName;
+    displayName: string;
+    prerequisites: AgentName[];
+    promptTemplate: string;
+    deliverableFilename: string;
+    modelTier?: 'small' | 'medium' | 'large';
+}
+/**
+ * Vulnerability types supported by the pipeline.
+ */
+export type VulnType = 'injection' | 'xss' | 'auth' | 'ssrf' | 'authz';
+/**
+ * Decision returned by queue validation for exploitation phase.
+ */
+export interface ExploitationDecision {
+    shouldExploit: boolean;
+    shouldRetry: boolean;
+    vulnerabilityCount: number;
+    vulnType: VulnType;
+}
+//# sourceMappingURL=agents.d.ts.map

package/dist/types/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/types/agents.ts"],"names":[],"mappings":"AAMA;;GAEG;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU,sMAcb,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAElD,MAAM,MAAM,eAAe,GACvB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE7F,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,aAAa,GACb,WAAW,GACX,QAAQ,GACR,aAAa,CAAC;AAElB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,QAAQ,CAAC;CACpB"}

package/dist/types/agents.js

@@ -0,0 +1,28 @@
+// Copyright (C) 2025 PhenixStar (Alaa Qweider)
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License version 3
+// as published by the Free Software Foundation.
+/**
+ * Agent type definitions
+ */
+/**
+ * List of all agents in execution order.
+ * Used for iteration during resume state checking.
+ */
+export const ALL_AGENTS = [
+    'pre-recon',
+    'recon',
+    'injection-vuln',
+    'xss-vuln',
+    'auth-vuln',
+    'ssrf-vuln',
+    'authz-vuln',
+    'injection-exploit',
+    'xss-exploit',
+    'auth-exploit',
+    'ssrf-exploit',
+    'authz-exploit',
+    'report',
+];
+//# sourceMappingURL=agents.js.map

package/dist/types/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/types/agents.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,uEAAuE;AACvE,wEAAwE;AACxE,gDAAgD;AAEhD;;GAEG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,WAAW;IACX,OAAO;IACP,gBAAgB;IAChB,UAAU;IACV,WAAW;IACX,WAAW;IACX,YAAY;IACZ,mBAAmB;IACnB,aAAa;IACb,cAAc;IACd,cAAc;IACd,eAAe;IACf,QAAQ;CACA,CAAC"}

package/dist/types/audit.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Audit system type definitions
+ */
+/**
+ * Cross-cutting session metadata used by services, temporal, and audit.
+ */
+export interface SessionMetadata {
+    id: string;
+    webUrl: string;
+    repoPath?: string;
+    outputPath?: string;
+    [key: string]: unknown;
+}
+/**
+ * Result data passed to audit system when an agent execution ends.
+ * Used by both AuditSession and MetricsTracker.
+ */
+export interface AgentEndResult {
+    attemptNumber: number;
+    duration_ms: number;
+    cost_usd: number;
+    success: boolean;
+    model?: string | undefined;
+    error?: string | undefined;
+    checkpoint?: string | undefined;
+    isFinalAttempt?: boolean | undefined;
+}
+//# sourceMappingURL=audit.d.ts.map

package/dist/types/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/types/audit.ts"],"names":[],"mappings":"AAMA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC"}

package/dist/types/audit.js

@@ -0,0 +1,7 @@
+// Copyright (C) 2025 PhenixStar (Alaa Qweider)
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License version 3
+// as published by the Free Software Foundation.
+export {};
+//# sourceMappingURL=audit.js.map

package/dist/types/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/types/audit.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,uEAAuE;AACvE,wEAAwE;AACxE,gDAAgD"}

package/dist/types/backtesting.d.ts

@@ -0,0 +1,45 @@
+/** Types for the backtesting subsystem. */
+export interface Finding {
+    id: string;
+    cwe: string;
+    endpoint: string;
+    severity: 'critical' | 'high' | 'medium' | 'low' | 'info';
+    confidence: number;
+    description: string;
+}
+export interface GroundTruth {
+    testCaseId: string;
+    cwe: string;
+    endpoint: string;
+    isVulnerable: boolean;
+}
+export interface MetricsResult {
+    truePositives: number;
+    falsePositives: number;
+    falseNegatives: number;
+    trueNegatives: number;
+    precision: number;
+    recall: number;
+    f1Score: number;
+    specificity: number;
+}
+export interface CategoryMetrics {
+    category: string;
+    metrics: MetricsResult;
+    findings: number;
+}
+export interface BenchmarkRun {
+    runId: string;
+    timestamp: number;
+    target: string;
+    overallMetrics: MetricsResult;
+    categoryBreakdown: CategoryMetrics[];
+    duration_ms: number;
+}
+export interface RegressionAlert {
+    category: string;
+    previousF1: number;
+    currentF1: number;
+    delta: number;
+}
+//# sourceMappingURL=backtesting.d.ts.map

package/dist/types/backtesting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backtesting.d.ts","sourceRoot":"","sources":["../../src/types/backtesting.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,aAAa,CAAC;IAC9B,iBAAiB,EAAE,eAAe,EAAE,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/types/backtesting.js

@@ -0,0 +1,3 @@
+/** Types for the backtesting subsystem. */
+export {};
+//# sourceMappingURL=backtesting.js.map

package/dist/types/backtesting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backtesting.js","sourceRoot":"","sources":["../../src/types/backtesting.ts"],"names":[],"mappings":"AAAA,2CAA2C"}

package/dist/types/config.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Configuration type definitions
+ */
+export type RuleType = 'path' | 'subdomain' | 'domain' | 'method' | 'header' | 'parameter';
+export interface Rule {
+    description: string;
+    type: RuleType;
+    url_path: string;
+}
+export interface Rules {
+    avoid?: Rule[];
+    focus?: Rule[];
+}
+export type LoginType = 'form' | 'sso' | 'api' | 'basic';
+export interface SuccessCondition {
+    type: 'url' | 'cookie' | 'element' | 'redirect';
+    value: string;
+}
+export interface Credentials {
+    username: string;
+    password: string;
+    totp_secret?: string;
+}
+export interface Authentication {
+    login_type: LoginType;
+    login_url: string;
+    credentials: Credentials;
+    login_flow: string[];
+    success_condition: SuccessCondition;
+}
+export interface Config {
+    rules?: Rules;
+    authentication?: Authentication;
+    pipeline?: PipelineConfig;
+}
+export type RetryPreset = 'default' | 'subscription';
+export interface PipelineConfig {
+    retry_preset?: RetryPreset;
+    max_concurrent_pipelines?: number;
+    /** Enable V2 phases (zero-day analysis, evolution cycle). Defaults to true. */
+    v2Features?: boolean;
+}
+export interface DistributedConfig {
+    avoid: Rule[];
+    focus: Rule[];
+    authentication: Authentication | null;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAMA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,WAAW,IAAI;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,KAAK;IACpB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;CAChB;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IAChD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,SAAS,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB,EAAE,gBAAgB,CAAC;CACrC;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,cAAc,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,+EAA+E;IAC/E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;CACvC"}

package/dist/types/config.js

@@ -0,0 +1,7 @@
+// Copyright (C) 2025 PhenixStar (Alaa Qweider)
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License version 3
+// as published by the Free Software Foundation.
+export {};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,uEAAuE;AACvE,wEAAwE;AACxE,gDAAgD"}

package/dist/types/errors.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Error type definitions
+ */
+/**
+ * Specific error codes for reliable classification.
+ *
+ * ErrorCode provides precision within the coarse 8-category PentestErrorType.
+ * Used by classifyErrorForTemporal for code-based classification (preferred)
+ * with string matching as fallback for external errors.
+ */
+export declare enum ErrorCode {
+    CONFIG_NOT_FOUND = "CONFIG_NOT_FOUND",
+    CONFIG_VALIDATION_FAILED = "CONFIG_VALIDATION_FAILED",
+    CONFIG_PARSE_ERROR = "CONFIG_PARSE_ERROR",
+    AGENT_EXECUTION_FAILED = "AGENT_EXECUTION_FAILED",
+    OUTPUT_VALIDATION_FAILED = "OUTPUT_VALIDATION_FAILED",
+    API_RATE_LIMITED = "API_RATE_LIMITED",
+    SPENDING_CAP_REACHED = "SPENDING_CAP_REACHED",
+    INSUFFICIENT_CREDITS = "INSUFFICIENT_CREDITS",
+    GIT_CHECKPOINT_FAILED = "GIT_CHECKPOINT_FAILED",
+    GIT_ROLLBACK_FAILED = "GIT_ROLLBACK_FAILED",
+    PROMPT_LOAD_FAILED = "PROMPT_LOAD_FAILED",
+    DELIVERABLE_NOT_FOUND = "DELIVERABLE_NOT_FOUND",
+    REPO_NOT_FOUND = "REPO_NOT_FOUND",
+    AUTH_FAILED = "AUTH_FAILED",
+    BILLING_ERROR = "BILLING_ERROR"
+}
+export type PentestErrorType = 'config' | 'network' | 'tool' | 'prompt' | 'filesystem' | 'validation' | 'billing' | 'unknown';
+export interface PentestErrorContext {
+    [key: string]: unknown;
+}
+export interface LogEntry {
+    timestamp: string;
+    context: string;
+    error: {
+        name: string;
+        message: string;
+        type: PentestErrorType;
+        retryable: boolean;
+        stack?: string;
+    };
+}
+export interface ToolErrorResult {
+    tool: string;
+    output: string;
+    status: 'error';
+    duration: number;
+    success: false;
+    error: Error;
+}
+export interface PromptErrorResult {
+    success: false;
+    error: Error;
+}
+//# sourceMappingURL=errors.d.ts.map