@avi770/testteam 2.0.0 → 3.2.0

package/dist/enterprise/sla.js

@@ -0,0 +1,101 @@
+// ── Implementation ──────────────────────────────────────────────────
+/**
+ * Evaluate a completed pipeline run against SLA configuration.
+ * Returns a report indicating whether all SLAs were met and
+ * details on any violations.
+ */
+export function checkSLA(results, slaConfig) {
+    const violations = [];
+    const recommendations = [];
+    // 1. Check total pipeline duration
+    const pipelineDuration = computePipelineDuration(results);
+    if (pipelineDuration > slaConfig.maxPipelineDuration) {
+        violations.push({
+            metric: 'pipeline_duration',
+            threshold: slaConfig.maxPipelineDuration,
+            actual: pipelineDuration,
+            description: `Pipeline took ${pipelineDuration}ms, exceeding the ${slaConfig.maxPipelineDuration}ms limit`,
+        });
+        recommendations.push('Consider parallelising more agents or reducing the scope of slow-running agents.');
+    }
+    // 2. Check individual agent durations
+    for (const [, agentResult] of results.agentResults) {
+        if (agentResult.durationMs > slaConfig.maxAgentDuration) {
+            violations.push({
+                metric: 'agent_duration',
+                threshold: slaConfig.maxAgentDuration,
+                actual: agentResult.durationMs,
+                description: `Agent "${agentResult.agentName}" (ID ${agentResult.agentId}) took ${agentResult.durationMs}ms, exceeding the ${slaConfig.maxAgentDuration}ms per-agent limit`,
+            });
+            recommendations.push(`Optimise agent "${agentResult.agentName}" or split it into smaller focused agents.`);
+        }
+    }
+    // 3. Check failure rate as a proxy for uptime target
+    const { totalAgents, failedAgents } = countAgentOutcomes(results);
+    if (totalAgents > 0) {
+        const successRate = ((totalAgents - failedAgents) / totalAgents) * 100;
+        if (successRate < slaConfig.uptimeTarget) {
+            violations.push({
+                metric: 'uptime_target',
+                threshold: slaConfig.uptimeTarget,
+                actual: successRate,
+                description: `Success rate ${successRate.toFixed(2)}% is below the ${slaConfig.uptimeTarget}% uptime target`,
+            });
+            recommendations.push('Investigate failing agents and improve test stability before next run.');
+        }
+    }
+    // 4. Check average agent response time against responseTimeTarget
+    const avgDuration = computeAverageAgentDuration(results);
+    if (avgDuration > slaConfig.responseTimeTarget) {
+        violations.push({
+            metric: 'response_time',
+            threshold: slaConfig.responseTimeTarget,
+            actual: avgDuration,
+            description: `Average agent duration ${avgDuration.toFixed(0)}ms exceeds the ${slaConfig.responseTimeTarget}ms response time target`,
+        });
+        recommendations.push('Profile slow agents and consider caching or pre-warming strategies.');
+    }
+    return {
+        passed: violations.length === 0,
+        violations,
+        recommendations,
+        checkedAt: Date.now(),
+    };
+}
+// ── Internal helpers ────────────────────────────────────────────────
+function computePipelineDuration(results) {
+    if (results.agentResults.size === 0)
+        return 0;
+    let earliest = Infinity;
+    let latest = -Infinity;
+    for (const [, agent] of results.agentResults) {
+        const start = new Date(agent.startedAt).getTime();
+        const end = new Date(agent.completedAt).getTime();
+        if (start < earliest)
+            earliest = start;
+        if (end > latest)
+            latest = end;
+    }
+    return latest - earliest;
+}
+function countAgentOutcomes(results) {
+    let totalAgents = 0;
+    let failedAgents = 0;
+    for (const [, agent] of results.agentResults) {
+        totalAgents++;
+        if (agent.status === 'failed') {
+            failedAgents++;
+        }
+    }
+    return { totalAgents, failedAgents };
+}
+function computeAverageAgentDuration(results) {
+    if (results.agentResults.size === 0)
+        return 0;
+    let total = 0;
+    for (const [, agent] of results.agentResults) {
+        total += agent.durationMs;
+    }
+    return total / results.agentResults.size;
+}
+//# sourceMappingURL=sla.js.map

package/dist/enterprise/sla.js.map

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

package/dist/helpers/element-discovery.js

@@ -42,7 +42,7 @@ function buildSelector(testId, ariaLabel, tag, text) {
         return `[data-testid="${testId}"]`;
     if (ariaLabel)
         return `[aria-label="${ariaLabel}"]`;
-    const safeSuffix = text.trim().slice(0, 40).replace(/"/g, '\\"');
+    const safeSuffix = text.trim().slice(0, 40).replace(/\\/g, '\\\\').replace(/"/g, '\\"');
     return safeSuffix ? `${tag}:text("${safeSuffix}")` : tag;
 }
 /**

package/dist/helpers/element-discovery.js.map

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

package/dist/helpers/env-resolver.d.ts

@@ -1,5 +1,5 @@
-import type { ValidatedConfig } from '../core/config';
-import type { Phase } from '../core/types';
+import type { ValidatedConfig } from '../core/config.js';
+import type { Phase } from '../core/types.js';
 interface EnvironmentConfig {
     baseUrl: string;
     seed?: boolean;

package/dist/helpers/quality-gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quality-gate.d.ts","sourceRoot":"","sources":["../../helpers/quality-gate.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAiJD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,gBAAgB,EAAE,CAWpB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAGnE"}
+{"version":3,"file":"quality-gate.d.ts","sourceRoot":"","sources":["../../helpers/quality-gate.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAoKD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,gBAAgB,EAAE,CAWpB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAGnE"}

package/dist/helpers/quality-gate.js

@@ -1,8 +1,11 @@
 import { readFileSync } from 'fs';
 // Matches `: any` type annotations
 const ANY_TYPE_PATTERN = /:\s*any\b/;
-// Matches function declarations and arrow functions that open a block body on the same line
-const FUNCTION_START_PATTERN = /(?:function\s+\w+\s*\([^)]*\)\s*\{|(?:\([^)]*\)|\w+)\s*=>\s*\{)/;
+// Matches function declarations and arrow functions that open a block body on the same line.
+// Quantifiers are bounded: an unbounded `\w+` before `=>` (or `[^)]*` param list) lets the
+// engine match a long run and retry at every start position → O(n²) on a long line
+// (CodeQL js/polynomial-redos). Identifiers/param-lists are well within these bounds.
+const FUNCTION_START_PATTERN = /(?:function\s+\w{1,80}\s*\([^)]{0,500}\)\s*\{|(?:\([^)]{0,500}\)|\w{1,80})\s*=>\s*\{)/;
 // Matches hardcoded secret assignments with literal string values
 const HARDCODED_SECRET_PATTERN = /(?:password|secret|apiKey|api_key|token)\s*=\s*['"][^'"]+['"]/i;
 // Matches lines that safely read from process.env
@@ -17,6 +20,21 @@ function isCommentLine(line) {
         trimmed.startsWith('*') ||
         trimmed.startsWith('/*'));
 }
+/**
+ * Replace the CONTENTS of string literals with empty strings so later checks
+ * don't match keywords inside string values.
+ *
+ * One regex per quote type with DISJOINT character classes (`[^'\\]` vs `\\.`,
+ * etc.) and no backreference — this is linear-time. The previous single matcher
+ * `/(['"`])(?:(?!\1)[^\\]|\\.)*\1/g` backtracked polynomially on unterminated
+ * strings under the `/g` flag (CodeQL js/polynomial-redos).
+ */
+function stripStringLiterals(line) {
+    return line
+        .replace(/'(?:[^'\\]|\\.)*'/g, '""')
+        .replace(/"(?:[^"\\]|\\.)*"/g, '""')
+        .replace(/`(?:[^`\\]|\\.)*`/g, '""');
+}
 function checkAnyType(lines) {
     const violations = [];
     for (let i = 0; i < lines.length; i++) {
@@ -24,7 +42,7 @@ function checkAnyType(lines) {
         if (isCommentLine(line))
             continue;
         // Strip string literals to avoid false positives from values containing "any"
-        const stripped = line.replace(/(['"`])(?:(?!\1)[^\\]|\\.)*\1/g, '""');
+        const stripped = stripStringLiterals(line);
         if (ANY_TYPE_PATTERN.test(stripped)) {
             violations.push({
                 rule: 'no-any',

package/dist/helpers/quality-gate.js.map

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

package/dist/helpers/shape-fingerprint.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Structural fingerprint of a JSON value. Used by Agent #88 (writer) and #90
+ * (reader / drift detector) to compare response shapes across runs without
+ * leaking field values into the baseline.
+ *
+ * Rules:
+ *   - primitives  → their type name ("null", "boolean", "number", "string")
+ *   - arrays      → "[<shape-of-first-element>]" or "[]" when empty
+ *   - objects     → "{key1:<shape>,key2:<shape>,...}" with keys sorted
+ *                   alphabetically so the fingerprint is order-independent
+ *
+ * The fingerprint is intentionally structural only. Two responses returning
+ * `{ id: 1, name: "alice" }` and `{ id: 2, name: "bob" }` produce identical
+ * fingerprints; only adding/removing a field or changing a field's type
+ * triggers drift.
+ */
+export declare function inferShape(value: unknown): string;
+//# sourceMappingURL=shape-fingerprint.d.ts.map

package/dist/helpers/shape-fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-fingerprint.d.ts","sourceRoot":"","sources":["../../helpers/shape-fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAkBjD"}

package/dist/helpers/shape-fingerprint.js

@@ -0,0 +1,40 @@
+/**
+ * Structural fingerprint of a JSON value. Used by Agent #88 (writer) and #90
+ * (reader / drift detector) to compare response shapes across runs without
+ * leaking field values into the baseline.
+ *
+ * Rules:
+ *   - primitives  → their type name ("null", "boolean", "number", "string")
+ *   - arrays      → "[<shape-of-first-element>]" or "[]" when empty
+ *   - objects     → "{key1:<shape>,key2:<shape>,...}" with keys sorted
+ *                   alphabetically so the fingerprint is order-independent
+ *
+ * The fingerprint is intentionally structural only. Two responses returning
+ * `{ id: 1, name: "alice" }` and `{ id: 2, name: "bob" }` produce identical
+ * fingerprints; only adding/removing a field or changing a field's type
+ * triggers drift.
+ */
+export function inferShape(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return '[]';
+        return `[${inferShape(value[0])}]`;
+    }
+    const kind = typeof value;
+    if (kind === 'object') {
+        const obj = value;
+        const keys = Object.keys(obj).sort();
+        if (keys.length === 0)
+            return '{}';
+        return `{${keys.map((k) => `${k}:${inferShape(obj[k])}`).join(',')}}`;
+    }
+    // boolean | number | string | bigint | symbol | function | undefined
+    // Stringify undefined explicitly so JSON.parse never produces it but
+    // callers handing in raw values still get a stable token.
+    if (kind === 'undefined')
+        return 'undefined';
+    return kind;
+}
+//# sourceMappingURL=shape-fingerprint.js.map

package/dist/helpers/shape-fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-fingerprint.js","sourceRoot":"","sources":["../../helpers/shape-fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACrC,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC;IAC1B,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACxE,CAAC;IACD,qEAAqE;IACrE,qEAAqE;IACrE,0DAA0D;IAC1D,IAAI,IAAI,KAAK,WAAW;QAAE,OAAO,WAAW,CAAC;IAC7C,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/sdk/custom-agent.d.ts

@@ -0,0 +1,51 @@
+import { BaseAgent } from '../agents/base-agent.js';
+import { type RunMode, type FrameStreamer } from '../core/run-mode/index.js';
+import type { ValidatedConfig } from '../core/config.js';
+import type { TestTeamConfig } from '../core/config.js';
+import type { AgentResult, Phase } from '../core/types.js';
+/**
+ * Abstract base class for custom (user-defined) agents.
+ * Custom agents must use agent numbers >= 1000 to avoid conflicts
+ * with built-in agents (which occupy the reserved 1-999 range).
+ */
+export declare abstract class CustomAgent extends BaseAgent {
+    abstract readonly agentNumber: number;
+    abstract readonly tier: 'pro' | 'enterprise';
+    /** Phases this agent participates in (used by the runner to register it per phase). */
+    abstract readonly phases: Phase[];
+}
+/** Options passed to `defineAgent` to declaratively create a custom agent. */
+export interface DefineAgentOptions {
+    /** Agent number; must be >= 100. */
+    number: number;
+    /** Human-readable agent name. */
+    name: string;
+    /** Phases this agent participates in. */
+    phases: Phase[];
+    /** License tier required. */
+    tier: 'pro' | 'enterprise';
+    /** Whether this agent is blocking (fails the phase gate on failure). */
+    blocking: boolean;
+    /** Pre-flight validation; return false to skip execution. */
+    preFlight: (config: TestTeamConfig) => Promise<boolean>;
+    /** Main execution logic. */
+    execute: (config: TestTeamConfig, phase: Phase) => Promise<AgentResult>;
+}
+/**
+ * Validates that an agent number is in the custom range (>= 100).
+ * Throws if the number conflicts with built-in agents.
+ */
+export declare function validateAgentNumber(agentNumber: number): void;
+/**
+ * Define a custom agent declaratively.
+ *
+ * The returned `CustomAgent` wraps the provided callbacks and can be
+ * registered with the Orchestrator via the agent registry.
+ */
+export declare function defineAgent(options: DefineAgentOptions): CustomAgent;
+/**
+ * Create a new instance of a custom agent with the given config, phase, and run directory.
+ * Used by the loader/orchestrator to instantiate agents with real runtime values.
+ */
+export declare function reinstantiateAgent(agent: CustomAgent, config: ValidatedConfig, phase: Phase, runDir: string, runMode?: RunMode, frames?: FrameStreamer): CustomAgent;
+//# sourceMappingURL=custom-agent.d.ts.map

package/dist/sdk/custom-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-agent.d.ts","sourceRoot":"","sources":["../../sdk/custom-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAoB,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAW,KAAK,EAAE,MAAM,eAAe,CAAC;AAMjE;;;;GAIG;AACH,8BAAsB,WAAY,SAAQ,SAAS;IACjD,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,YAAY,CAAC;IAC7C,uFAAuF;IACvF,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;CACnC;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,6BAA6B;IAC7B,IAAI,EAAE,KAAK,GAAG,YAAY,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAC;IAClB,6DAA6D;IAC7D,SAAS,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,4BAA4B;IAC5B,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CACzE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAM7D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAmDpE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,OAA0B,EACnC,MAAM,CAAC,EAAE,aAAa,GACrB,WAAW,CAuBb"}

package/dist/sdk/custom-agent.js

@@ -0,0 +1,94 @@
+import { BaseAgent } from '../agents/base-agent.js';
+import { DEFAULT_RUN_MODE } from '../core/run-mode/index.js';
+/** Minimum agent number for custom agents. 1-999 is reserved for built-in
+ *  agents (which currently run 1-117, with headroom for growth). */
+const MIN_CUSTOM_AGENT_NUMBER = 1000;
+/**
+ * Abstract base class for custom (user-defined) agents.
+ * Custom agents must use agent numbers >= 1000 to avoid conflicts
+ * with built-in agents (which occupy the reserved 1-999 range).
+ */
+export class CustomAgent extends BaseAgent {
+}
+/**
+ * Validates that an agent number is in the custom range (>= 100).
+ * Throws if the number conflicts with built-in agents.
+ */
+export function validateAgentNumber(agentNumber) {
+    if (!Number.isInteger(agentNumber) || agentNumber < MIN_CUSTOM_AGENT_NUMBER) {
+        throw new Error(`Custom agent number must be an integer >= ${MIN_CUSTOM_AGENT_NUMBER}. Got: ${agentNumber}`);
+    }
+}
+/**
+ * Define a custom agent declaratively.
+ *
+ * The returned `CustomAgent` wraps the provided callbacks and can be
+ * registered with the Orchestrator via the agent registry.
+ */
+export function defineAgent(options) {
+    validateAgentNumber(options.number);
+    if (!options.name || options.name.trim().length === 0) {
+        throw new Error('Custom agent name must be a non-empty string');
+    }
+    if (!options.phases || options.phases.length === 0) {
+        throw new Error('Custom agent must specify at least one phase');
+    }
+    // Create a concrete class that extends CustomAgent
+    const agentOptions = options;
+    class DefinedCustomAgent extends CustomAgent {
+        agentNumber = agentOptions.number;
+        agentId = agentOptions.number;
+        agentName = agentOptions.name;
+        tier = agentOptions.tier;
+        phases = agentOptions.phases;
+        blocking = agentOptions.blocking;
+        async preFlight() {
+            const canProceed = await agentOptions.preFlight(this.config);
+            if (!canProceed) {
+                throw new Error(`Pre-flight check failed for custom agent "${agentOptions.name}"`);
+            }
+        }
+        async execute() {
+            const result = await agentOptions.execute(this.config, this.phase);
+            return result.findings;
+        }
+    }
+    // Instantiate with a minimal validated config placeholder.
+    // The real config/phase/runDir are injected when registered with the orchestrator.
+    // We return the class constructor disguised as an instance for registration.
+    // Actually, BaseAgent requires config/phase/runDir in constructor.
+    // We need to create a factory-like pattern. Let's return a proxy instance
+    // that can be re-instantiated via a factory method.
+    // For the SDK, we return the agent class so the loader can instantiate it.
+    // But the spec says defineAgent returns a CustomAgent instance.
+    // We'll create a lightweight wrapper that stores options and can produce real instances.
+    const placeholderConfig = {};
+    const placeholderPhase = agentOptions.phases[0];
+    const placeholderRunDir = '';
+    return new DefinedCustomAgent(placeholderConfig, placeholderPhase, placeholderRunDir);
+}
+/**
+ * Create a new instance of a custom agent with the given config, phase, and run directory.
+ * Used by the loader/orchestrator to instantiate agents with real runtime values.
+ */
+export function reinstantiateAgent(agent, config, phase, runDir, runMode = DEFAULT_RUN_MODE, frames) {
+    // Re-run defineAgent with the original options is not possible since we don't
+    // store them. Instead, we create a new class that copies the agent's properties.
+    const sourceAgent = agent;
+    class ReinstantiatedAgent extends CustomAgent {
+        agentNumber = sourceAgent.agentNumber;
+        agentId = sourceAgent.agentId;
+        agentName = sourceAgent.agentName;
+        tier = sourceAgent.tier;
+        phases = sourceAgent.phases;
+        async preFlight() {
+            // Delegate to the original agent's preFlight by calling it in context
+            await sourceAgent.preFlight.call(this);
+        }
+        async execute() {
+            return await sourceAgent.execute.call(this);
+        }
+    }
+    return new ReinstantiatedAgent(config, phase, runDir, undefined, runMode, frames);
+}
+//# sourceMappingURL=custom-agent.js.map

package/dist/sdk/custom-agent.js.map

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

package/dist/sdk/index.d.ts

@@ -0,0 +1,5 @@
+export { CustomAgent, defineAgent, validateAgentNumber, reinstantiateAgent, } from './custom-agent.js';
+export type { DefineAgentOptions } from './custom-agent.js';
+export { loadCustomAgents, loadCustomAgentsWithErrors, } from './loader.js';
+export type { LoadResult, LoadError } from './loader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EACL,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,UAAU,CAAC;AAElB,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/sdk/index.js

@@ -0,0 +1,3 @@
+export { CustomAgent, defineAgent, validateAgentNumber, reinstantiateAgent, } from './custom-agent.js';
+export { loadCustomAgents, loadCustomAgentsWithErrors, } from './loader.js';
+//# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EACL,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,UAAU,CAAC"}

package/dist/sdk/loader.d.ts

@@ -0,0 +1,28 @@
+import { CustomAgent } from './custom-agent.js';
+/**
+ * Result of loading custom agents, including any validation errors.
+ */
+export interface LoadResult {
+    agents: CustomAgent[];
+    errors: LoadError[];
+}
+export interface LoadError {
+    file: string;
+    message: string;
+}
+/**
+ * Scan the `testteam-agents/` directory under `configDir` for custom agent
+ * modules. Each module must default-export (or named-export `agent`) a
+ * `CustomAgent` instance with agent number >= 1000.
+ *
+ * @param configDir - Root directory containing the `testteam-agents/` folder.
+ * @returns Array of validated custom agents.
+ * @throws If the agents directory exists but contains invalid agents.
+ */
+export declare function loadCustomAgents(configDir: string): Promise<CustomAgent[]>;
+/**
+ * Load custom agents, returning both valid agents and any errors encountered.
+ * Does not throw; callers can inspect errors individually.
+ */
+export declare function loadCustomAgentsWithErrors(configDir: string): Promise<LoadResult>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/sdk/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../sdk/loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAuB,MAAM,gBAAgB,CAAC;AAWlE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAWhF;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAwCvF"}

package/dist/sdk/loader.js

@@ -0,0 +1,140 @@
+import * as path from 'path';
+import * as fs from 'fs';
+import { pathToFileURL } from 'node:url';
+import { validateAgentNumber } from './custom-agent.js';
+/** Directory name to scan for custom agent definitions. */
+const CUSTOM_AGENTS_DIR = 'testteam-agents';
+/** Supported file extensions for custom agent modules. */
+const SUPPORTED_EXTENSIONS = new Set(['.ts', '.js']);
+/** Built-in agent number range upper bound (exclusive); custom agents start here. */
+const BUILTIN_AGENT_MAX = 1000;
+/**
+ * Scan the `testteam-agents/` directory under `configDir` for custom agent
+ * modules. Each module must default-export (or named-export `agent`) a
+ * `CustomAgent` instance with agent number >= 1000.
+ *
+ * @param configDir - Root directory containing the `testteam-agents/` folder.
+ * @returns Array of validated custom agents.
+ * @throws If the agents directory exists but contains invalid agents.
+ */
+export async function loadCustomAgents(configDir) {
+    const result = await loadCustomAgentsWithErrors(configDir);
+    if (result.errors.length > 0) {
+        const messages = result.errors
+            .map((e) => `  ${e.file}: ${e.message}`)
+            .join('\n');
+        throw new Error(`Failed to load custom agents:\n${messages}`);
+    }
+    return result.agents;
+}
+/**
+ * Load custom agents, returning both valid agents and any errors encountered.
+ * Does not throw; callers can inspect errors individually.
+ */
+export async function loadCustomAgentsWithErrors(configDir) {
+    const agentsDir = path.join(configDir, CUSTOM_AGENTS_DIR);
+    if (!fs.existsSync(agentsDir)) {
+        return { agents: [], errors: [] };
+    }
+    const stat = fs.statSync(agentsDir);
+    if (!stat.isDirectory()) {
+        return {
+            agents: [],
+            errors: [{ file: agentsDir, message: 'Expected a directory, found a file' }],
+        };
+    }
+    const files = fs.readdirSync(agentsDir).filter((file) => {
+        const ext = path.extname(file);
+        return SUPPORTED_EXTENSIONS.has(ext);
+    });
+    const agents = [];
+    const errors = [];
+    const seenNumbers = new Set();
+    for (const file of files) {
+        const filePath = path.join(agentsDir, file);
+        try {
+            const agent = await loadAgentFromFile(filePath);
+            validateAgentInstance(agent, filePath, seenNumbers);
+            seenNumbers.add(agent.agentNumber);
+            agents.push(agent);
+        }
+        catch (err) {
+            errors.push({
+                file: filePath,
+                message: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return { agents, errors };
+}
+/**
+ * Import a single agent file and extract the CustomAgent instance.
+ * Supports default export or named `agent` export.
+ *
+ * Security: `filePath` must resolve to a regular file inside the configured
+ * `testteam-agents/` directory and have a supported extension. This is
+ * checked again here (defence in depth alongside the directory scan) to
+ * stop symlink traversal and stray imports of files outside the agents
+ * sandbox.
+ */
+async function loadAgentFromFile(filePath) {
+    const resolved = path.resolve(filePath);
+    // Reject symlinks and non-regular files before importing
+    let stat;
+    try {
+        stat = fs.lstatSync(resolved);
+    }
+    catch {
+        throw new Error('Custom agent file does not exist');
+    }
+    if (!stat.isFile()) {
+        throw new Error('Custom agent path is not a regular file');
+    }
+    if (!SUPPORTED_EXTENSIONS.has(path.extname(resolved))) {
+        throw new Error(`Unsupported custom agent file extension (allowed: ${[...SUPPORTED_EXTENSIONS].join(', ')})`);
+    }
+    // Dynamic import (not require) so the module shares this loader's ESM graph —
+    // the file's `CustomAgent` is the same class instance, so `instanceof` holds,
+    // and it works under the compiled/published ESM runtime.
+    const mod = (await import(pathToFileURL(resolved).href));
+    const candidate = mod.default ?? mod.agent;
+    if (!candidate) {
+        throw new Error('Module must export a CustomAgent via default export or named "agent" export');
+    }
+    // Structural check rather than `instanceof CustomAgent`: when a user's agent
+    // file is loaded across module realms (tsx dev, compiled node, vitest), the
+    // `CustomAgent` class it extends may be a different instance than this
+    // module's, so `instanceof` is unreliable. Duck-type the shape produced by
+    // `defineAgent()` instead.
+    if (!isCustomAgentLike(candidate)) {
+        throw new Error('Exported value is not a CustomAgent instance. Use defineAgent() to create one.');
+    }
+    return candidate;
+}
+/** True if `x` has the runtime shape of a `defineAgent()` result. */
+function isCustomAgentLike(x) {
+    if (typeof x !== 'object' || x === null)
+        return false;
+    const a = x;
+    return (typeof a.agentNumber === 'number' &&
+        (a.tier === 'pro' || a.tier === 'enterprise') &&
+        typeof a.run === 'function');
+}
+/**
+ * Validate a loaded agent instance:
+ * - Agent number >= 1000 (no conflict with built-ins, which occupy 1-999)
+ * - No duplicate agent numbers
+ */
+function validateAgentInstance(agent, filePath, seenNumbers) {
+    validateAgentNumber(agent.agentNumber);
+    if (agent.agentNumber < BUILTIN_AGENT_MAX) {
+        throw new Error(`Agent number ${agent.agentNumber} conflicts with built-in agents (must be >= ${BUILTIN_AGENT_MAX})`);
+    }
+    if (seenNumbers.has(agent.agentNumber)) {
+        throw new Error(`Duplicate custom agent number ${agent.agentNumber} in ${filePath}`);
+    }
+    if (!agent.agentName || agent.agentName.trim().length === 0) {
+        throw new Error('Custom agent must have a non-empty agentName');
+    }
+}
+//# sourceMappingURL=loader.js.map