@avi770/testteam 3.0.0 → 3.2.0

package/dist/clients/agent-mvp.js

@@ -5,15 +5,23 @@
  * 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') {
+    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`);
+            const response = await fetch(`${this.baseUrl}/api/v1/health`, { signal: AbortSignal.timeout(3000) });
             return response.ok;
         }
         catch {
@@ -29,7 +37,8 @@ export class AgentMvpClient {
             const response = await fetch(`${this.baseUrl}/api/v1/reputation/events/batch`, {
                 method: 'POST',
                 headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ events }),
+                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}` }] };
@@ -44,7 +53,7 @@ export class AgentMvpClient {
     /** 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)}`);
+            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;
             }
@@ -66,7 +75,9 @@ export class AgentMvpClient {
                     finding_id: findingId,
                     feedback_type: 'false_positive',
                     reason,
+                    product_id: this.productId,
                 }),
+                signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),
             });
         }
         catch {
@@ -76,7 +87,7 @@ export class AgentMvpClient {
     /** Fetch coaching flags for an agent. */
     async getCoachingFlags(agentId) {
         try {
-            const response = await fetch(`${this.baseUrl}/api/v1/coaching/flags/${encodeURIComponent(agentId)}`);
+            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 [];
             }

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

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

@@ -1,11 +1,11 @@
 /**
  * Total Recall REST API Client
  *
- * Wraps Total Recall's memory API (localhost:3777) for the TestTeam agent system.
+ * 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';
+import type { Finding } from '../core/types.js';
 export declare class TotalRecallClient {
     private readonly baseUrl;
     private readonly projectId;

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

@@ -1 +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;AAoD7C,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,SAAS,CAAuB;gBAE5B,OAAO,SAA0B,EAAE,SAAS,SAAa;IAKrE,uDAAuD;IACjD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC,4EAA4E;IACtE,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAerC,iCAAiC;IAC3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC,0DAA0D;IACpD,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BvF,+EAA+E;IACzE,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC3F,2EAA2E;IACrE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBlG,+CAA+C;IACzC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAkBnE,qCAAqC;IAC/B,iBAAiB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAkB7C,uFAAuF;IACjF,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAkB3D,kCAAkC;IAC5B,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAcnE,kEAAkE;IAClE,YAAY,IAAI,MAAM,GAAG,IAAI;CAG9B"}
+{"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

@@ -1,22 +1,28 @@
 /**
  * Total Recall REST API Client
  *
- * Wraps Total Recall's memory API (localhost:3777) for the TestTeam agent system.
+ * 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 = 'http://localhost:3777', projectId = 'testteam') {
+    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`);
+            const res = await fetch(`${this.baseUrl}/health`, { signal: AbortSignal.timeout(3000) });
             return res.ok;
         }
         catch {
@@ -29,6 +35,7 @@ export class TotalRecallClient {
             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());
@@ -47,6 +54,7 @@ export class TotalRecallClient {
             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 }),
             });
         }
@@ -63,6 +71,7 @@ export class TotalRecallClient {
             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,
@@ -113,6 +122,7 @@ export class TotalRecallClient {
             await fetch(`${this.baseUrl}/batch-remember`, {
                 method: 'POST',
                 headers: { 'Content-Type': 'application/json' },
+                signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),
                 body: JSON.stringify({ items }),
             });
         }
@@ -126,6 +136,7 @@ export class TotalRecallClient {
             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,
@@ -150,6 +161,7 @@ export class TotalRecallClient {
             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,
@@ -169,6 +181,7 @@ export class TotalRecallClient {
             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,
@@ -188,6 +201,7 @@ export class TotalRecallClient {
             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,
@@ -207,6 +221,7 @@ export class TotalRecallClient {
             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());

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

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

package/dist/core/api-contract/api-contract-validator.d.ts

@@ -0,0 +1,178 @@
+/**
+ * API Contract Validator (#11 — "The Border Guard") — implementation.
+ *
+ * This is a COMPOSITE RESULTS-PROCESSOR over the engine "api" squad (#39/#41/#42).
+ * It does NOT re-implement what those engines do at runtime (live HTTP fetch,
+ * pagination edge-case probing, GraphQL depth/introspection). Those remain the
+ * engine agents' jobs; this layer INGESTS their Finding[] output verbatim (see
+ * ValidateApiContractOptions.engineFindings → ApiContractReport.engineFindings) and
+ * adds the static/composite REST-contract capabilities that belong at this tier:
+ *
+ *   - Spec-hash diff gating (skip unchanged endpoints, near-zero steady cost)
+ *   - Breaking-change detection (RECURSIVE spec diff, block/warn classification)
+ *   - Consumer-driven contracts (Pact — structural verification of provider interactions)
+ *   - Runtime contract monitoring (sampled prod traffic schema + latency; unknown endpoints flagged)
+ *   - Error-response contract validation
+ *   - Mock generation from spec (msw handler strings)
+ *   - Migration guide authoring (one entry per breaking change)
+ *
+ * Engine agent roles (NOT re-implemented here — surfaced via engineFindings):
+ *   #39 ApiContractTester   — live HTTP schema conformance
+ *   #41 ApiPaginationTester — pagination edge-case probing
+ *   #42 GraphqlTester       — GraphQL introspection / depth / auth probing
+ *
+ * The composition is real (not just a comment): COMPOSED_ENGINE_AGENTS (./types) is
+ * asserted against the live AGENT_REGISTRY 'api' squad by the integration test, and the
+ * engine Finding[] are ingested into the report.
+ *
+ * Operating rules (spec §"Operating & safety rules"):
+ * - Read-only / non-destructive on the API. Never mutates endpoints.
+ * - Gates rather than fixes.
+ * - Diagnostic-first: distinguish spec bug from impl bug before blocking.
+ * - First-do-no-harm.
+ *
+ * Spec: blueprint/agents/11-api-contract-validator.md.
+ */
+import type { Finding } from '../types.js';
+import type { OpenApiSpec, OpenApiOperation, JsonSchemaObject, EndpointHash, HashRegistry, SchemaValidationResult, BreakingChangeDiff, PactConsumerContract, PactInteraction, ConsumerVerificationResult, BlastRadiusMap, SampledTrafficRecord, RuntimeSampleResult, ErrorContractSpec, ErrorContractValidationResult, GeneratedMockHandler, MigrationGuide, ApiContractReport } from './types.js';
+/**
+ * Compute a deterministic SHA-256 fingerprint of one endpoint's spec fragment.
+ * Only the operation JSON is hashed — stable and independent of spec metadata.
+ * Uses stableStringify to guarantee key-order independence (JSON.stringify key order
+ * is insertion-order in V8, which is not guaranteed canonical across environments).
+ */
+export declare function hashEndpointSpec(path: string, method: string, operation: OpenApiOperation): EndpointHash;
+/**
+ * Given the current spec and a registry of last-validated hashes, return the set of endpoints
+ * that MUST be re-validated (their hash changed or they are new) and the set that can be skipped.
+ * Unchanged endpoints (same spec hash) skip schema re-validation — this gates spec-diff cost,
+ * NOT a proof of implementation conformance (runtime-sample monitoring still applies).
+ */
+export declare function partitionByHash(spec: Readonly<OpenApiSpec>, registry: HashRegistry): {
+    readonly toValidate: readonly EndpointHash[];
+    readonly skipped: readonly string[];
+};
+/**
+ * Validate a response body against a JSON schema fragment (OpenAPI 3 subset).
+ * Pure and deterministic — no I/O. Engine agent #39 validates live HTTP; this layer validates
+ * engine-provided body snapshots and sampled traffic records.
+ *
+ * Never rounds up: every violation is reported individually with field-path precision.
+ */
+export declare function validateResponseSchema(body: unknown, schema: JsonSchemaObject, endpointLabel: string, statusCode: number): SchemaValidationResult;
+/**
+ * Diff two OpenAPI specs and classify each change as breaking or additive.
+ * Breaking changes on stable APIs carry decision === 'block'; unstable/experimental carry 'warn'.
+ *
+ * Show-the-math: every change is individually listed with its kind, path, and decision.
+ * Never gameable: block/warn is derived deterministically from the kind + stability pair.
+ */
+export declare function detectBreakingChanges(previousSpec: Readonly<OpenApiSpec>, currentSpec: Readonly<OpenApiSpec>): BreakingChangeDiff;
+/**
+ * Verify a provider against one consumer Pact contract by checking each interaction against
+ * the fixture responses returned by the provider fixture function.
+ *
+ * `providerFixture` is the adapter that the caller provides — it replays an interaction against
+ * the actual provider (staging) or a recorded fixture. Pure composition: this layer classifies;
+ * the caller owns I/O.
+ */
+export declare function verifyPactContract(contract: Readonly<PactConsumerContract>, providerFixture: (interaction: Readonly<PactInteraction>) => Promise<{
+    readonly statusCode: number;
+    readonly body: unknown;
+}>): Promise<readonly ConsumerVerificationResult[]>;
+/**
+ * Build a blast-radius map: which consumers have failing interactions, and how many total.
+ * Show-the-math: lists every consumer and every failing interaction by name.
+ */
+export declare function buildBlastRadiusMap(verifications: readonly ConsumerVerificationResult[]): BlastRadiusMap;
+/**
+ * Validate a set of sampled production traffic records against the spec.
+ * Frugal by design: callers control the sample size; we only classify what we receive.
+ * Latency / SLA contract: also checks response-time budget per endpoint.
+ */
+export declare function validateRuntimeSample(records: readonly SampledTrafficRecord[], spec: Readonly<OpenApiSpec>): RuntimeSampleResult;
+/**
+ * Validate that an error response body contains all fields declared in the error contract spec.
+ * Error-contract conformance is a first-class contract, not an afterthought.
+ */
+export declare function validateErrorContract(endpoint: string, statusCode: number, responseBody: unknown, errorSpec: Readonly<ErrorContractSpec>): ErrorContractValidationResult;
+/**
+ * Generate msw (Mock Service Worker) handler code from an OpenAPI spec.
+ * The generated handlers are derived from the spec's example / schema defaults so they are
+ * always in sync — "self-healing mocks". Callers write the returned code to their test fixtures.
+ *
+ * Pure and deterministic: same spec → same handler code.
+ */
+export declare function generateMockHandlers(spec: Readonly<OpenApiSpec>): readonly GeneratedMockHandler[];
+/**
+ * Auto-draft a migration guide for every breaking change in a diff.
+ * Handed to Documentation Sync (#10) — this layer author's the draft; humans refine it.
+ * Show-the-math: every change gets its own entry with before/after examples.
+ */
+export declare function draftMigrationGuide(diff: Readonly<BreakingChangeDiff>, options?: {
+    readonly clock?: () => number;
+}): MigrationGuide | null;
+export interface ValidateApiContractOptions {
+    /**
+     * Registry of last-validated spec hashes (spec-hash diff gating, improvement #1).
+     * Pass an empty object `{}` to force validation of every endpoint.
+     */
+    readonly hashRegistry: HashRegistry;
+    /**
+     * Previous spec version for breaking-change detection.
+     * Pass the same object as `currentSpec` to skip diff (no breaking changes possible).
+     */
+    readonly previousSpec: OpenApiSpec;
+    /** The current OpenAPI spec to validate against. */
+    readonly currentSpec: OpenApiSpec;
+    /**
+     * Snapshots of actual endpoint responses keyed by "<METHOD> <path>".
+     * Provided by the caller (adapter over engine agent #39's live fetch, or fixture records).
+     * Only endpoints present in this map are schema-validated.
+     */
+    readonly endpointSnapshots: Readonly<Record<string, {
+        readonly statusCode: number;
+        readonly body: unknown;
+    }>>;
+    /**
+     * Pact consumer contracts to verify.
+     * Caller provides the provider fixture adapter.
+     */
+    readonly pactContracts: readonly PactConsumerContract[];
+    readonly providerFixture: (interaction: Readonly<PactInteraction>) => Promise<{
+        readonly statusCode: number;
+        readonly body: unknown;
+    }>;
+    /**
+     * Sampled production traffic for runtime monitoring.
+     * Empty array = no runtime sample this run.
+     */
+    readonly runtimeSamples: readonly SampledTrafficRecord[];
+    /**
+     * Error-contract specs per status code.
+     * Caller provides observed error responses.
+     */
+    readonly errorContracts: readonly ErrorContractSpec[];
+    readonly errorResponses: Readonly<Record<string, {
+        readonly statusCode: number;
+        readonly body: unknown;
+    }>>;
+    /**
+     * Findings produced by engine agents #39/#41/#42 (live schema conformance, pagination,
+     * GraphQL). Ingested verbatim and surfaced on the report — this is the composition seam.
+     */
+    readonly engineFindings?: readonly Finding[];
+    /** Optional clock for deterministic timestamps in tests. */
+    readonly clock?: () => number;
+}
+/**
+ * Run the full API contract validation pipeline.
+ * Composes: spec-hash gating → schema validation → breaking-change detection →
+ * Pact consumer verification → blast-radius mapping → error contract → runtime sample →
+ * mock generation → migration guide.
+ *
+ * Never mutates the API. Never throws on validation failures — failures are reported as findings
+ * in the returned report. Only infrastructure errors (bad spec JSON, etc.) propagate.
+ */
+export declare function validateApiContract(opts: Readonly<ValidateApiContractOptions>): Promise<ApiContractReport>;
+//# sourceMappingURL=api-contract-validator.d.ts.map

package/dist/core/api-contract/api-contract-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-contract-validator.d.ts","sourceRoot":"","sources":["../../../core/api-contract/api-contract-validator.ts"],"names":[],"mappings":"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"}