@avi770/testteam 2.0.0 → 3.2.0

package/dist/clients/agent-mvp.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Agent-MVP REST API Client
+ *
+ * Wraps Agent-MVP's reputation/coaching API (localhost:3200) for TestTeam.
+ * All methods are graceful -- if Agent-MVP is not running, they return
+ * null/empty without throwing.
+ */
+/** Scoring event submitted to the batch endpoint. */
+export interface AgentScoreEvent {
+    agent_id: string;
+    task_type: string;
+    outcome: 'success' | 'failure';
+    score_delta: number;
+    phase?: string;
+    finding_severity?: string;
+    findings_count?: number;
+    product_id?: string;
+}
+/** Reputation data returned by the Agent-MVP API. */
+export interface AgentReputation {
+    agentId: string;
+    currentScore: number;
+    currentTierId: number;
+    totalTasks: number;
+    successfulTasks: number;
+    failedTasks: number;
+    currentStreak: number;
+    longestStreak: number;
+    [key: string]: unknown;
+}
+/** Coaching flag returned by the Agent-MVP API. */
+export interface CoachingFlag {
+    id: string;
+    agentId: string;
+    flagType: string;
+    severity: string;
+    status: string;
+    message: string;
+    [key: string]: unknown;
+}
+/** Batch scoring response. */
+interface BatchScoringResponse {
+    processed: number;
+    errors: Array<{
+        index: number;
+        error: string;
+    }>;
+}
+export declare class AgentMvpClient {
+    private productId;
+    private readonly baseUrl;
+    constructor(baseUrl?: string, productId?: string);
+    /** Check whether the Agent-MVP API is reachable. */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Submit a batch of scoring events.
+     * Returns the number of successfully processed events.
+     */
+    scoreAgents(events: AgentScoreEvent[]): Promise<BatchScoringResponse>;
+    /** Fetch the reputation record for a single agent by provider ID. */
+    getReputation(agentId: string): Promise<AgentReputation | null>;
+    /** Report a false-positive finding to apply a small score penalty. */
+    reportFalsePositive(agentId: string, findingId: string, reason: string): Promise<void>;
+    /** Fetch coaching flags for an agent. */
+    getCoachingFlags(agentId: string): Promise<CoachingFlag[]>;
+}
+export {};
+//# sourceMappingURL=agent-mvp.d.ts.map

package/dist/clients/agent-mvp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-mvp.d.ts","sourceRoot":"","sources":["../../clients/agent-mvp.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAOD,8BAA8B;AAC9B,UAAU,oBAAoB;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAED,qBAAa,cAAc;IAGsB,OAAO,CAAC,SAAS;IAFhE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,SAA0B,EAAU,SAAS,SAAa;IAI7E,oDAAoD;IAC9C,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC;;;OAGG;IACG,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAoB3E,qEAAqE;IAC/D,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAkBrE,sEAAsE;IAChE,mBAAmB,CACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAmBhB,yCAAyC;IACnC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAiBjE"}

package/dist/clients/agent-mvp.js

@@ -0,0 +1,102 @@
+/**
+ * Agent-MVP REST API Client
+ *
+ * Wraps Agent-MVP's reputation/coaching API (localhost:3200) for TestTeam.
+ * All methods are graceful -- if Agent-MVP is not running, they return
+ * null/empty without throwing.
+ */
+/**
+ * Timeout for data-plane calls (P4-1). `fetch` has no default timeout, so a
+ * hung (not refused) Agent-MVP sidecar would stall the CLI indefinitely. The
+ * health probe uses a tighter 3 s; data-plane reads/writes get a bounded 10 s.
+ */
+const DEFAULT_TIMEOUT_MS = 10_000;
+export class AgentMvpClient {
+    productId;
+    baseUrl;
+    constructor(baseUrl = 'http://localhost:3200', productId = 'testteam') {
+        this.productId = productId;
+        this.baseUrl = baseUrl;
+    }
+    /** Check whether the Agent-MVP API is reachable. */
+    async isAvailable() {
+        try {
+            const response = await fetch(`${this.baseUrl}/api/v1/health`, { signal: AbortSignal.timeout(3000) });
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Submit a batch of scoring events.
+     * Returns the number of successfully processed events.
+     */
+    async scoreAgents(events) {
+        try {
+            const response = await fetch(`${this.baseUrl}/api/v1/reputation/events/batch`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ events: events.map(e => ({ ...e, product_id: this.productId })) }),
+                signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),
+            });
+            if (!response.ok) {
+                return { processed: 0, errors: [{ index: -1, error: `HTTP ${response.status}` }] };
+            }
+            const json = (await response.json());
+            return json.data;
+        }
+        catch {
+            return { processed: 0, errors: [] };
+        }
+    }
+    /** Fetch the reputation record for a single agent by provider ID. */
+    async getReputation(agentId) {
+        try {
+            const response = await fetch(`${this.baseUrl}/api/v1/reputation/${encodeURIComponent(agentId)}?productId=${this.productId}`, { signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS) });
+            if (!response.ok) {
+                return null;
+            }
+            const json = (await response.json());
+            return json.data;
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Report a false-positive finding to apply a small score penalty. */
+    async reportFalsePositive(agentId, findingId, reason) {
+        try {
+            await fetch(`${this.baseUrl}/api/v1/reputation/feedback`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    agent_id: agentId,
+                    finding_id: findingId,
+                    feedback_type: 'false_positive',
+                    reason,
+                    product_id: this.productId,
+                }),
+                signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),
+            });
+        }
+        catch {
+            // Graceful -- no-op if Agent-MVP is down
+        }
+    }
+    /** Fetch coaching flags for an agent. */
+    async getCoachingFlags(agentId) {
+        try {
+            const response = await fetch(`${this.baseUrl}/api/v1/coaching/flags/${encodeURIComponent(agentId)}?productId=${this.productId}`, { signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS) });
+            if (!response.ok) {
+                return [];
+            }
+            const json = (await response.json());
+            return json.data ?? [];
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=agent-mvp.js.map

package/dist/clients/agent-mvp.js.map

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

package/dist/clients/llm-council.d.ts

@@ -0,0 +1,47 @@
+/**
+ * LLM Council REST API Client
+ *
+ * Wraps the LLM Council's consensus API (localhost:8001) for TestTeam.
+ * All methods are graceful -- if the Council is not running, they return
+ * null/false without throwing.
+ */
+export interface CouncilDecision {
+    stage1: Array<{
+        model: string;
+        response: string;
+    }>;
+    stage2: Array<{
+        model: string;
+        ranking: string;
+    }>;
+    stage3: {
+        model: string;
+        response: string;
+    };
+    metadata: {
+        label_to_model: Record<string, string>;
+        aggregate_rankings: Array<{
+            model: string;
+            average_rank: number;
+        }>;
+        models_used: string[];
+        chairman: string;
+    };
+}
+export interface CouncilConfig {
+    council_models: string[];
+    chairman_model: string;
+    version: string;
+    model_count: number;
+}
+export declare class LlmCouncilClient {
+    private baseUrl;
+    constructor(baseUrl?: string);
+    isAvailable(): Promise<boolean>;
+    getConfig(): Promise<CouncilConfig | null>;
+    decide(prompt: string, options?: {
+        models?: string[];
+        chairman?: string;
+    }): Promise<CouncilDecision | null>;
+}
+//# sourceMappingURL=llm-council.d.ts.map

package/dist/clients/llm-council.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-council.d.ts","sourceRoot":"","sources":["../../clients/llm-council.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,QAAQ,EAAE;QACR,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,kBAAkB,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACnE,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,OAAO;gBAAP,OAAO,SAA0B;IAE/C,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAS/B,SAAS,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAY1C,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CAclH"}

package/dist/clients/llm-council.js

@@ -0,0 +1,52 @@
+/**
+ * LLM Council REST API Client
+ *
+ * Wraps the LLM Council's consensus API (localhost:8001) for TestTeam.
+ * All methods are graceful -- if the Council is not running, they return
+ * null/false without throwing.
+ */
+export class LlmCouncilClient {
+    baseUrl;
+    constructor(baseUrl = 'http://localhost:8001') {
+        this.baseUrl = baseUrl;
+    }
+    async isAvailable() {
+        try {
+            const res = await fetch(`${this.baseUrl}/api/config`, { signal: AbortSignal.timeout(3000) });
+            return res.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    async getConfig() {
+        try {
+            // P4-1: bounded timeout — a hung council can't stall the CLI (decide()
+            // already carries a 120 s signal; the health probe uses 3 s).
+            const res = await fetch(`${this.baseUrl}/api/config`, { signal: AbortSignal.timeout(10_000) });
+            if (!res.ok)
+                return null;
+            return await res.json();
+        }
+        catch {
+            return null;
+        }
+    }
+    async decide(prompt, options) {
+        try {
+            const res = await fetch(`${this.baseUrl}/api/council/decide`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ prompt, ...options }),
+                signal: AbortSignal.timeout(120000),
+            });
+            if (!res.ok)
+                return null;
+            return await res.json();
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=llm-council.js.map

package/dist/clients/llm-council.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-council.js","sourceRoot":"","sources":["../../clients/llm-council.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH,MAAM,OAAO,gBAAgB;IACP;IAApB,YAAoB,UAAU,uBAAuB;QAAjC,YAAO,GAAP,OAAO,CAA0B;IAAG,CAAC;IAEzD,KAAK,CAAC,WAAW;QACf,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,aAAa,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7F,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS;QACb,IAAI,CAAC;YACH,uEAAuE;YACvE,8DAA8D;YAC9D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,aAAa,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC/F,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YACzB,OAAO,MAAM,GAAG,CAAC,IAAI,EAAmB,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,OAAkD;QAC7E,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,qBAAqB,EAAE;gBAC5D,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC;gBAC5C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;aACpC,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YACzB,OAAO,MAAM,GAAG,CAAC,IAAI,EAAqB,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/clients/total-recall.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Total Recall REST API Client
+ *
+ * Wraps Total Recall's memory API for the TestTeam agent system.
+ * All methods are graceful — if Total Recall is not running, they return
+ * empty/null without throwing.
+ */
+import type { Finding } from '../core/types.js';
+export declare class TotalRecallClient {
+    private readonly baseUrl;
+    private readonly projectId;
+    private sessionId;
+    constructor(baseUrl?: string, projectId?: string);
+    /** Check whether the Total Recall API is reachable. */
+    isAvailable(): Promise<boolean>;
+    /** Start a new session and store the session_id. Returns the session_id. */
+    startSession(): Promise<string>;
+    /** Close the current session. */
+    endSession(): Promise<void>;
+    /** Store a single finding as a 'fact' in Total Recall. */
+    storeFinding(agentId: number, agentName: string, finding: Finding): Promise<void>;
+    /** Store multiple findings in a single batch request (max 50 per API call). */
+    storeFindings(agentId: number, agentName: string, findings: Finding[]): Promise<void>;
+    /** Store a correction (e.g. a false-positive that was later dismissed). */
+    storeCorrection(agentId: number, originalFinding: string, correction: string): Promise<void>;
+    /** Recall stored findings matching a query. */
+    recallFindings(query: string, limit?: number): Promise<unknown[]>;
+    /** Recall all stored corrections. */
+    recallCorrections(): Promise<unknown[]>;
+    /** Load smart context for a message (combines corrections, rules, keyword matches). */
+    loadContext(message: string): Promise<unknown | null>;
+    /** Semantic search via TF-IDF. */
+    searchSemantic(query: string, limit?: number): Promise<unknown[]>;
+    /** Get the current session ID (if a session has been started). */
+    getSessionId(): string | null;
+}
+//# sourceMappingURL=total-recall.d.ts.map

package/dist/clients/total-recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"total-recall.d.ts","sourceRoot":"","sources":["../../clients/total-recall.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAoC7C,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,SAAS,CAAuB;gBAE5B,OAAO,SAAgE,EAAE,SAAS,SAAa;IAK3G,uDAAuD;IACjD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC,4EAA4E;IACtE,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAgBrC,iCAAiC;IAC3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBjC,0DAA0D;IACpD,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BvF,+EAA+E;IACzE,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC3F,2EAA2E;IACrE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBlG,+CAA+C;IACzC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAmBnE,qCAAqC;IAC/B,iBAAiB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAmB7C,uFAAuF;IACjF,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAmB3D,kCAAkC;IAC5B,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAenE,kEAAkE;IAClE,YAAY,IAAI,MAAM,GAAG,IAAI;CAG9B"}

package/dist/clients/total-recall.js

@@ -0,0 +1,239 @@
+/**
+ * Total Recall REST API Client
+ *
+ * Wraps Total Recall's memory API for the TestTeam agent system.
+ * All methods are graceful — if Total Recall is not running, they return
+ * empty/null without throwing.
+ */
+/**
+ * Timeout for data-plane calls (P4-1). `fetch` has no default timeout, so a
+ * hung (not refused) Total Recall server would stall the CLI indefinitely. The
+ * health probe uses a tighter 3 s; data-plane reads/writes get a bounded 10 s.
+ */
+const DEFAULT_TIMEOUT_MS = 10_000;
+export class TotalRecallClient {
+    baseUrl;
+    projectId;
+    sessionId = null;
+    constructor(baseUrl = process.env.TOTAL_RECALL_URL || 'https://recall.aidev.com.au', projectId = 'testteam') {
+        this.baseUrl = baseUrl;
+        this.projectId = projectId;
+    }
+    /** Check whether the Total Recall API is reachable. */
+    async isAvailable() {
+        try {
+            const res = await fetch(`${this.baseUrl}/health`, { signal: AbortSignal.timeout(3000) });
+            return res.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Start a new session and store the session_id. Returns the session_id. */
+    async startSession() {
+        try {
+            const res = await fetch(`${this.baseUrl}/session/start`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),
+                body: JSON.stringify({ project_id: this.projectId }),
+            });
+            const json = (await res.json());
+            this.sessionId = json.data.session_id;
+            return this.sessionId;
+        }
+        catch {
+            return '';
+        }
+    }
+    /** Close the current session. */
+    async endSession() {
+        if (!this.sessionId)
+            return;
+        try {
+            await fetch(`${this.baseUrl}/session/close`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),
+                body: JSON.stringify({ session_id: this.sessionId }),
+            });
+        }
+        catch {
+            // Swallow — Total Recall may have shut down
+        }
+        finally {
+            this.sessionId = null;
+        }
+    }
+    /** Store a single finding as a 'fact' in Total Recall. */
+    async storeFinding(agentId, agentName, finding) {
+        try {
+            await fetch(`${this.baseUrl}/remember`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),
+                body: JSON.stringify({
+                    category: 'fact',
+                    content: finding.description,
+                    project_id: this.projectId,
+                    source: 'testteam',
+                    tags: [agentName, finding.severity, finding.type],
+                    confidence: finding.severity === 'critical' ? 1.0 : 0.9,
+                    meta: {
+                        agentId,
+                        agentName,
+                        findingId: finding.id,
+                        severity: finding.severity,
+                        module: finding.module,
+                        type: finding.type,
+                        file: finding.file,
+                        line: finding.line,
+                    },
+                }),
+            });
+        }
+        catch {
+            // Graceful — no-op if TR is down
+        }
+    }
+    /** Store multiple findings in a single batch request (max 50 per API call). */
+    async storeFindings(agentId, agentName, findings) {
+        if (findings.length === 0)
+            return;
+        try {
+            const items = findings.slice(0, 50).map((finding) => ({
+                category: 'fact',
+                content: finding.description,
+                project_id: this.projectId,
+                source: 'testteam',
+                tags: [agentName, finding.severity, finding.type],
+                confidence: finding.severity === 'critical' ? 1.0 : 0.9,
+                meta: {
+                    agentId,
+                    agentName,
+                    findingId: finding.id,
+                    severity: finding.severity,
+                    module: finding.module,
+                    type: finding.type,
+                    file: finding.file,
+                    line: finding.line,
+                },
+            }));
+            await fetch(`${this.baseUrl}/batch-remember`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),
+                body: JSON.stringify({ items }),
+            });
+        }
+        catch {
+            // Graceful — no-op if TR is down
+        }
+    }
+    /** Store a correction (e.g. a false-positive that was later dismissed). */
+    async storeCorrection(agentId, originalFinding, correction) {
+        try {
+            await fetch(`${this.baseUrl}/remember`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),
+                body: JSON.stringify({
+                    category: 'correction',
+                    content: correction,
+                    project_id: this.projectId,
+                    source: 'testteam',
+                    tags: ['correction', `agent-${agentId}`],
+                    confidence: 1.0,
+                    meta: {
+                        agentId,
+                        originalFinding,
+                    },
+                }),
+            });
+        }
+        catch {
+            // Graceful
+        }
+    }
+    /** Recall stored findings matching a query. */
+    async recallFindings(query, limit = 20) {
+        try {
+            const res = await fetch(`${this.baseUrl}/recall`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),
+                body: JSON.stringify({
+                    query,
+                    project_id: this.projectId,
+                    limit,
+                }),
+            });
+            const json = (await res.json());
+            return json.data ?? [];
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Recall all stored corrections. */
+    async recallCorrections() {
+        try {
+            const res = await fetch(`${this.baseUrl}/recall`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),
+                body: JSON.stringify({
+                    query: 'correction',
+                    project_id: this.projectId,
+                    limit: 100,
+                }),
+            });
+            const json = (await res.json());
+            return json.data ?? [];
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Load smart context for a message (combines corrections, rules, keyword matches). */
+    async loadContext(message) {
+        try {
+            const res = await fetch(`${this.baseUrl}/context`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),
+                body: JSON.stringify({
+                    message,
+                    project_id: this.projectId,
+                    ...(this.sessionId ? { session_id: this.sessionId } : {}),
+                }),
+            });
+            const json = (await res.json());
+            return json.data ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Semantic search via TF-IDF. */
+    async searchSemantic(query, limit = 20) {
+        try {
+            const res = await fetch(`${this.baseUrl}/search`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),
+                body: JSON.stringify({ query, limit }),
+            });
+            const json = (await res.json());
+            return json.data ?? [];
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Get the current session ID (if a session has been started). */
+    getSessionId() {
+        return this.sessionId;
+    }
+}
+//# sourceMappingURL=total-recall.js.map

package/dist/clients/total-recall.js.map

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

package/dist/core/agent-contract.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The Agent Contract — the governance standard every agent conforms to (Phase 0.3).
+ * Deliberately minimal + ADDITIVE so all 84 existing engine agents conform by default
+ * (default-deny: read-only, no declared capabilities). Subclasses override `contract`.
+ * Spec: blueprint/rules/agent-contract.md.
+ */
+/** Autonomy tiers, ordered least → most privileged. Default is the safest: read-only. */
+export declare const AUTONOMY_TIERS: readonly ["read-only", "recommend", "gated", "autonomous"];
+export type AutonomyTier = (typeof AUTONOMY_TIERS)[number];
+/** A declared capability (free-form for now; tightens to an enum as the suite grows). */
+export type AgentCapability = string;
+/** Every agent exposes this (capabilities + how autonomous it is allowed to be). */
+export interface AgentContract {
+    readonly capabilities: readonly AgentCapability[];
+    readonly autonomyTier: AutonomyTier;
+}
+/** Default-deny posture: no declared capabilities, read-only. */
+export declare const DEFAULT_AGENT_CONTRACT: AgentContract;
+/** Type guard for a valid autonomy tier (used by the conformance test + the Harness). */
+export declare function isAutonomyTier(value: unknown): value is AutonomyTier;
+//# sourceMappingURL=agent-contract.d.ts.map

package/dist/core/agent-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-contract.d.ts","sourceRoot":"","sources":["../../core/agent-contract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yFAAyF;AACzF,eAAO,MAAM,cAAc,4DAA6D,CAAC;AACzF,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,yFAAyF;AACzF,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AAErC,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;CACrC;AAED,iEAAiE;AACjE,eAAO,MAAM,sBAAsB,EAAE,aAGpC,CAAC;AAEF,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE"}

package/dist/core/agent-contract.js

@@ -0,0 +1,18 @@
+/**
+ * The Agent Contract — the governance standard every agent conforms to (Phase 0.3).
+ * Deliberately minimal + ADDITIVE so all 84 existing engine agents conform by default
+ * (default-deny: read-only, no declared capabilities). Subclasses override `contract`.
+ * Spec: blueprint/rules/agent-contract.md.
+ */
+/** Autonomy tiers, ordered least → most privileged. Default is the safest: read-only. */
+export const AUTONOMY_TIERS = ['read-only', 'recommend', 'gated', 'autonomous'];
+/** Default-deny posture: no declared capabilities, read-only. */
+export const DEFAULT_AGENT_CONTRACT = {
+    capabilities: [],
+    autonomyTier: 'read-only',
+};
+/** Type guard for a valid autonomy tier (used by the conformance test + the Harness). */
+export function isAutonomyTier(value) {
+    return typeof value === 'string' && AUTONOMY_TIERS.includes(value);
+}
+//# sourceMappingURL=agent-contract.js.map

package/dist/core/agent-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-contract.js","sourceRoot":"","sources":["../../core/agent-contract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yFAAyF;AACzF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,CAAU,CAAC;AAYzF,iEAAiE;AACjE,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,YAAY,EAAE,EAAE;IAChB,YAAY,EAAE,WAAW;CAC1B,CAAC;AAEF,yFAAyF;AACzF,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,cAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC5F,CAAC"}