evidential-protocol 1.0.0 → 1.1.0

package/dist/agent-wrapper.d.ts

@@ -0,0 +1,142 @@
+/**
+ * EP-1 Phase 3: Agent Team Integration
+ *
+ * Wraps agent team outputs in EvidentialResponse format.
+ * Enforces inter-agent propagation rules.
+ */
+import { type EvidentialClaim, type EvidentialResponse, type TrustScore } from "./types.js";
+/** Agent identity. */
+export interface AgentIdentity {
+    /** Team name (e.g., "security-team"). */
+    team: string;
+    /** Agent role within team (e.g., "credential-auditor"). */
+    role: string;
+}
+/**
+ * Fluent builder for agent team outputs that enforces EP-1.
+ *
+ * @example
+ * ```ts
+ * const output = new AgentOutputBuilder({
+ *   team: "security-team",
+ *   role: "credential-auditor",
+ * })
+ *   .direct("EXPO_TOKEN expires in 12 days", "expo-api:token-info")
+ *   .inferred("SHOPIFY_KEY may be revoked", "shopify-api:401", "3 consecutive 401s")
+ *   .conjecture("RENDER_TOKEN likely expired", "file-mtime", "94 days old, typical TTL 90")
+ *   .build({ expired_keys: 3 });
+ * ```
+ */
+export declare class AgentOutputBuilder {
+    private agent;
+    private claims;
+    constructor(agent: AgentIdentity);
+    /** Add a direct-evidence claim. */
+    direct(text: string, source: string, opts?: {
+        confidence?: number;
+        ttl?: number;
+        refs?: string[];
+    }): this;
+    /** Add an inferred-evidence claim. */
+    inferred(text: string, source: string, reasoning: string, opts?: {
+        confidence?: number;
+        refs?: string[];
+    }): this;
+    /** Add a reported-evidence claim. */
+    reported(text: string, source: string, opts?: {
+        confidence?: number;
+        refs?: string[];
+    }): this;
+    /** Add a conjecture claim. */
+    conjecture(text: string, source: string, reasoning: string, opts?: {
+        confidence?: number;
+        refs?: string[];
+    }): this;
+    /** Add a raw claim (for advanced use). */
+    addClaim(claim: EvidentialClaim): this;
+    /** Inherit claims from another agent's output (never upgrades class). */
+    inherit(upstream: EvidentialResponse): this;
+    /** Inherit specific claims by index from another agent's output. */
+    inheritClaims(upstream: EvidentialResponse, indices: number[]): this;
+    /** Build the EvidentialResponse. Validates before returning. */
+    build<T>(data: T): EvidentialResponse<T>;
+    /** Build without validation (use in tests only). */
+    buildUnsafe<T>(data: T): EvidentialResponse<T>;
+    /** Get trust score for current claims. */
+    trustScore(): TrustScore;
+    /** Get display-formatted trust score. */
+    trustDisplay(): string;
+    /** Get current claim count. */
+    get claimCount(): number;
+    /** Reset builder for reuse. */
+    reset(): this;
+}
+/** Result of an agent team run including evidential metadata. */
+export interface TeamRunResult<T = unknown> {
+    response: EvidentialResponse<T>;
+    trust: TrustScore;
+    display: string;
+    degradations: number;
+    requiresReview: boolean;
+}
+/**
+ * Run an agent team function and wrap the output with evidential metadata.
+ *
+ * @example
+ * ```ts
+ * const result = await runAgentTeam(
+ *   { team: "ops-team", role: "dns-checker" },
+ *   async (builder) => {
+ *     const records = await checkDns("purplesquirrelmedia.io");
+ *     builder.direct(`DNS has ${records.length} records`, "dns-api:query");
+ *
+ *     if (records.some(r => r.expiring)) {
+ *       builder.inferred("SSL cert expiring soon", "cert-check", "Expires in < 30 days");
+ *     }
+ *
+ *     return { records, healthy: true };
+ *   }
+ * );
+ * ```
+ */
+export declare function runAgentTeam<T>(agent: AgentIdentity, fn: (builder: AgentOutputBuilder) => Promise<T>): Promise<TeamRunResult<T>>;
+/** A step in a multi-agent pipeline. */
+export interface PipelineStep<TIn = unknown, TOut = unknown> {
+    agent: AgentIdentity;
+    run: (input: TIn, builder: AgentOutputBuilder) => Promise<TOut>;
+}
+/**
+ * Run a multi-agent pipeline where each step can inherit from the previous.
+ * Evidence classes degrade through the chain — they never upgrade.
+ *
+ * @example
+ * ```ts
+ * const result = await runPipeline(initialData, [
+ *   {
+ *     agent: { team: "data-team", role: "fetcher" },
+ *     run: async (input, builder) => {
+ *       const data = await fetchData(input);
+ *       builder.direct("Fetched 100 records", "api:fetch");
+ *       return data;
+ *     }
+ *   },
+ *   {
+ *     agent: { team: "analysis-team", role: "scorer" },
+ *     run: async (data, builder) => {
+ *       const scores = analyze(data);
+ *       builder.inferred("Average score is 0.85", "analysis:model", "Statistical");
+ *       return scores;
+ *     }
+ *   }
+ * ]);
+ * ```
+ */
+export declare function runPipeline<T>(initialInput: unknown, steps: PipelineStep[]): Promise<{
+    results: EvidentialResponse[];
+    finalData: T;
+    aggregateTrust: TrustScore;
+    display: string;
+}>;
+/** Generate a human-readable evidential report from an agent response. */
+export declare function generateReport(resp: EvidentialResponse): string;
+//# sourceMappingURL=agent-wrapper.d.ts.map

package/dist/agent-wrapper.d.ts.map

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

package/dist/agent-wrapper.js

@@ -0,0 +1,247 @@
+/**
+ * EP-1 Phase 3: Agent Team Integration
+ *
+ * Wraps agent team outputs in EvidentialResponse format.
+ * Enforces inter-agent propagation rules.
+ */
+import { response, computeTrustScore, formatTrustDisplay, } from "./schema.js";
+import { directClaim, inferredClaim, reportedClaim, conjectureClaim, inheritClaim, checkDegradation, } from "./middleware.js";
+import { validateResponse } from "./validate.js";
+/** Format agent identity as producer string. */
+function formatProducer(agent) {
+    return `${agent.team}:${agent.role}`;
+}
+/**
+ * Fluent builder for agent team outputs that enforces EP-1.
+ *
+ * @example
+ * ```ts
+ * const output = new AgentOutputBuilder({
+ *   team: "security-team",
+ *   role: "credential-auditor",
+ * })
+ *   .direct("EXPO_TOKEN expires in 12 days", "expo-api:token-info")
+ *   .inferred("SHOPIFY_KEY may be revoked", "shopify-api:401", "3 consecutive 401s")
+ *   .conjecture("RENDER_TOKEN likely expired", "file-mtime", "94 days old, typical TTL 90")
+ *   .build({ expired_keys: 3 });
+ * ```
+ */
+export class AgentOutputBuilder {
+    agent;
+    claims = [];
+    constructor(agent) {
+        this.agent = agent;
+    }
+    /** Add a direct-evidence claim. */
+    direct(text, source, opts) {
+        this.claims.push(directClaim(text, source, opts));
+        return this;
+    }
+    /** Add an inferred-evidence claim. */
+    inferred(text, source, reasoning, opts) {
+        this.claims.push(inferredClaim(text, source, reasoning, opts));
+        return this;
+    }
+    /** Add a reported-evidence claim. */
+    reported(text, source, opts) {
+        this.claims.push(reportedClaim(text, source, opts));
+        return this;
+    }
+    /** Add a conjecture claim. */
+    conjecture(text, source, reasoning, opts) {
+        this.claims.push(conjectureClaim(text, source, reasoning, opts));
+        return this;
+    }
+    /** Add a raw claim (for advanced use). */
+    addClaim(claim) {
+        this.claims.push(claim);
+        return this;
+    }
+    /** Inherit claims from another agent's output (never upgrades class). */
+    inherit(upstream) {
+        for (const claim of upstream.claims) {
+            this.claims.push(inheritClaim(claim, formatProducer(this.agent)));
+        }
+        return this;
+    }
+    /** Inherit specific claims by index from another agent's output. */
+    inheritClaims(upstream, indices) {
+        for (const i of indices) {
+            if (upstream.claims[i]) {
+                this.claims.push(inheritClaim(upstream.claims[i], formatProducer(this.agent)));
+            }
+        }
+        return this;
+    }
+    /** Build the EvidentialResponse. Validates before returning. */
+    build(data) {
+        const resp = response(formatProducer(this.agent), data, this.claims);
+        const validation = validateResponse(resp);
+        if (!validation.valid) {
+            const errorMessages = validation.errors.map((e) => e.message).join("; ");
+            throw new Error(`EP-1 validation failed: ${errorMessages}`);
+        }
+        return resp;
+    }
+    /** Build without validation (use in tests only). */
+    buildUnsafe(data) {
+        return response(formatProducer(this.agent), data, this.claims);
+    }
+    /** Get trust score for current claims. */
+    trustScore() {
+        return computeTrustScore(this.claims);
+    }
+    /** Get display-formatted trust score. */
+    trustDisplay() {
+        return formatTrustDisplay(this.trustScore());
+    }
+    /** Get current claim count. */
+    get claimCount() {
+        return this.claims.length;
+    }
+    /** Reset builder for reuse. */
+    reset() {
+        this.claims = [];
+        return this;
+    }
+}
+/**
+ * Run an agent team function and wrap the output with evidential metadata.
+ *
+ * @example
+ * ```ts
+ * const result = await runAgentTeam(
+ *   { team: "ops-team", role: "dns-checker" },
+ *   async (builder) => {
+ *     const records = await checkDns("purplesquirrelmedia.io");
+ *     builder.direct(`DNS has ${records.length} records`, "dns-api:query");
+ *
+ *     if (records.some(r => r.expiring)) {
+ *       builder.inferred("SSL cert expiring soon", "cert-check", "Expires in < 30 days");
+ *     }
+ *
+ *     return { records, healthy: true };
+ *   }
+ * );
+ * ```
+ */
+export async function runAgentTeam(agent, fn) {
+    const builder = new AgentOutputBuilder(agent);
+    const data = await fn(builder);
+    const resp = builder.build(data);
+    const trust = computeTrustScore(resp.claims);
+    const degradations = checkDegradation(resp);
+    return {
+        response: resp,
+        trust,
+        display: formatTrustDisplay(trust),
+        degradations: degradations.length,
+        requiresReview: trust.requires_review,
+    };
+}
+/**
+ * Run a multi-agent pipeline where each step can inherit from the previous.
+ * Evidence classes degrade through the chain — they never upgrade.
+ *
+ * @example
+ * ```ts
+ * const result = await runPipeline(initialData, [
+ *   {
+ *     agent: { team: "data-team", role: "fetcher" },
+ *     run: async (input, builder) => {
+ *       const data = await fetchData(input);
+ *       builder.direct("Fetched 100 records", "api:fetch");
+ *       return data;
+ *     }
+ *   },
+ *   {
+ *     agent: { team: "analysis-team", role: "scorer" },
+ *     run: async (data, builder) => {
+ *       const scores = analyze(data);
+ *       builder.inferred("Average score is 0.85", "analysis:model", "Statistical");
+ *       return scores;
+ *     }
+ *   }
+ * ]);
+ * ```
+ */
+export async function runPipeline(initialInput, steps) {
+    const results = [];
+    let currentInput = initialInput;
+    for (const step of steps) {
+        const builder = new AgentOutputBuilder(step.agent);
+        // Inherit claims from previous step
+        if (results.length > 0) {
+            builder.inherit(results[results.length - 1]);
+        }
+        const data = await step.run(currentInput, builder);
+        const resp = builder.build(data);
+        results.push(resp);
+        currentInput = data;
+    }
+    // Aggregate trust across all pipeline steps
+    const allClaims = results.flatMap((r) => r.claims);
+    const trust = computeTrustScore(allClaims);
+    return {
+        results,
+        finalData: currentInput,
+        aggregateTrust: trust,
+        display: formatTrustDisplay(trust),
+    };
+}
+// ---------------------------------------------------------------------------
+// Report Generator
+// ---------------------------------------------------------------------------
+/** Generate a human-readable evidential report from an agent response. */
+export function generateReport(resp) {
+    const trust = computeTrustScore(resp.claims);
+    const lines = [];
+    lines.push(`# Evidential Report — ${resp.producer}`);
+    lines.push(`Generated: ${resp.produced_at}`);
+    lines.push(`Protocol: EP-1 v${resp.ep_version}`);
+    lines.push("");
+    lines.push(`## Trust Score`);
+    lines.push(formatTrustDisplay(trust));
+    lines.push(`Aggregate class: **${resp.aggregate_class}**`);
+    lines.push(`Aggregate confidence: **${resp.aggregate_confidence}**`);
+    if (trust.requires_review) {
+        lines.push(`**WARNING: Trust score below 0.5 — human review required**`);
+    }
+    lines.push("");
+    lines.push(`## Claims (${resp.claims.length})`);
+    const classIcons = {
+        direct: "●",
+        inferred: "◐",
+        reported: "○",
+        conjecture: "◌",
+    };
+    for (let i = 0; i < resp.claims.length; i++) {
+        const c = resp.claims[i];
+        const icon = classIcons[c.evidence.class];
+        lines.push(`${i + 1}. ${icon} [${c.evidence.class}] ${c.claim}`);
+        lines.push(`   Source: ${c.evidence.source} | Confidence: ${c.evidence.confidence}`);
+        if (c.evidence.reasoning) {
+            lines.push(`   Reasoning: ${c.evidence.reasoning}`);
+        }
+        if (c.evidence.ttl) {
+            lines.push(`   TTL: ${c.evidence.ttl}s`);
+        }
+        if (c.refs?.length) {
+            lines.push(`   Refs: ${c.refs.join(", ")}`);
+        }
+    }
+    // Degradation check
+    const degradations = checkDegradation(resp);
+    if (degradations.length > 0) {
+        lines.push("");
+        lines.push(`## Degradation Warnings (${degradations.length})`);
+        for (const d of degradations) {
+            lines.push(`- ${d.claim_id}: ${d.from_class} → ${d.to_class} (${d.reason})`);
+        }
+    }
+    lines.push("");
+    lines.push("---");
+    lines.push("*Generated by Evidential Protocol v1.0*");
+    return lines.join("\n");
+}
+//# sourceMappingURL=agent-wrapper.js.map

package/dist/agent-wrapper.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @psm/evidential-protocol — EP-1
+ * evidential-protocol — EP-1
  *
  * Matsés-inspired evidential metadata for AI agent systems.
  * Every claim must declare its epistemic basis.
@@ -10,4 +10,6 @@ export { type EvidenceClass, type Evidence, type EvidenceSource, type Evidential
 export { weakerClass, strongerClass, isExpired, degradedClass, computeTrustScore, aggregateClass, aggregateConfidence, evidence, claim, response, mcpTag, parseContentMarker, formatContentMarker, extractMarkers, formatTrustDisplay, classifyTool, DEFAULT_TOOL_CLASSIFICATIONS, } from "./schema.js";
 export { validateEvidence, validateClaim, validateResponse, validateMcpTag, type ValidationError, type ValidationResult, } from "./validate.js";
 export { wrapToolResult, buildAgentResponse, directClaim, inferredClaim, reportedClaim, conjectureClaim, inheritClaim, verifyClaim, checkDegradation, applyDegradation, type McpMiddlewareOptions, type EvidentialToolResult, type AgentResponseOptions, } from "./middleware.js";
+export { McpEvidenceWrapper, EvidenceCache, createMcpMiddleware, type ToolHandler, type WrappedToolResult, type WrapperConfig, type McpToolCall, type McpToolResponse, } from "./mcp-wrapper.js";
+export { AgentOutputBuilder, runAgentTeam, runPipeline, generateReport, type AgentIdentity, type TeamRunResult, type PipelineStep, } from "./agent-wrapper.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,iBAAiB,EACjB,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,WAAW,EACX,aAAa,EACb,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,MAAM,EACN,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,iBAAiB,EACjB,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,WAAW,EACX,aAAa,EACb,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,MAAM,EACN,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 /**
- * @psm/evidential-protocol — EP-1
+ * evidential-protocol — EP-1
  *
  * Matsés-inspired evidential metadata for AI agent systems.
  * Every claim must declare its epistemic basis.
@@ -14,4 +14,8 @@ export { weakerClass, strongerClass, isExpired, degradedClass, computeTrustScore
 export { validateEvidence, validateClaim, validateResponse, validateMcpTag, } from "./validate.js";
 // Middleware
 export { wrapToolResult, buildAgentResponse, directClaim, inferredClaim, reportedClaim, conjectureClaim, inheritClaim, verifyClaim, checkDegradation, applyDegradation, } from "./middleware.js";
+// MCP Wrapper (Phase 2)
+export { McpEvidenceWrapper, EvidenceCache, createMcpMiddleware, } from "./mcp-wrapper.js";
+// Agent Team Integration (Phase 3)
+export { AgentOutputBuilder, runAgentTeam, runPipeline, generateReport, } from "./agent-wrapper.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,aAAa;AACb,OAAO,EAWL,iBAAiB,EACjB,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,8BAA8B;AAC9B,OAAO,EACL,WAAW,EACX,aAAa,EACb,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,MAAM,EACN,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAErB,aAAa;AACb,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,cAAc,GAGf,MAAM,eAAe,CAAC;AAEvB,aAAa;AACb,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GAIjB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,aAAa;AACb,OAAO,EAWL,iBAAiB,EACjB,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,8BAA8B;AAC9B,OAAO,EACL,WAAW,EACX,aAAa,EACb,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,MAAM,EACN,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAErB,aAAa;AACb,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,cAAc,GAGf,MAAM,eAAe,CAAC;AAEvB,aAAa;AACb,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GAIjB,MAAM,iBAAiB,CAAC;AAEzB,wBAAwB;AACxB,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,mBAAmB,GAMpB,MAAM,kBAAkB,CAAC;AAE1B,mCAAmC;AACnC,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,cAAc,GAIf,MAAM,oBAAoB,CAAC"}

package/dist/mcp-wrapper.d.ts

@@ -0,0 +1,120 @@
+/**
+ * EP-1 Phase 2: MCP Tool Wrapper
+ *
+ * Higher-level integration that wraps MCP tool handlers with automatic
+ * evidential tagging. Drop-in middleware for any MCP server.
+ */
+import { type EvidenceClass, type McpEvidenceTag, type ToolClassification, type DegradationEvent } from "./types.js";
+/** Generic MCP tool handler function. */
+export type ToolHandler<TArgs = unknown, TResult = unknown> = (args: TArgs) => Promise<TResult>;
+/** Wrapped tool result with evidence metadata. */
+export interface WrappedToolResult<T = unknown> {
+    result: T;
+    _evidence: McpEvidenceTag;
+}
+/** Configuration for the MCP evidence wrapper. */
+export interface WrapperConfig {
+    /** Additional tool classifications to merge with defaults. */
+    classifications?: ToolClassification[];
+    /** Global TTL override (seconds). */
+    defaultTtl?: number;
+    /** Called when a cached result has degraded. */
+    onDegradation?: (event: DegradationEvent) => void;
+    /** Whether to include evidence in error responses. */
+    tagErrors?: boolean;
+}
+export declare class EvidenceCache {
+    private entries;
+    /** Store an evidence tag for a tool+args combination. */
+    set(key: string, tag: McpEvidenceTag): void;
+    /** Check if a cached entry has degraded. Returns degradation event or null. */
+    check(key: string): DegradationEvent | null;
+    /** Get all degraded entries. */
+    checkAll(): DegradationEvent[];
+    /** Remove expired entries. */
+    prune(): number;
+    get size(): number;
+}
+/**
+ * Wraps an MCP tool handler to automatically attach evidential metadata.
+ *
+ * @example
+ * ```ts
+ * const wrapper = new McpEvidenceWrapper();
+ *
+ * // Wrap a tool handler
+ * const getBalance = wrapper.wrap("solana-rpc:getBalance", async (args) => {
+ *   return await rpc.getBalance(args.pubkey);
+ * });
+ *
+ * // Result now includes _evidence
+ * const result = await getBalance({ pubkey: "abc..." });
+ * // result._evidence.class === "direct"
+ * // result._evidence.ttl === 30
+ * ```
+ */
+export declare class McpEvidenceWrapper {
+    private config;
+    private classifications;
+    private cache;
+    constructor(config?: WrapperConfig);
+    /**
+     * Wrap a tool handler with automatic evidence tagging.
+     */
+    wrap<TArgs, TResult>(toolName: string, handler: ToolHandler<TArgs, TResult>, overrides?: Partial<{
+        class: EvidenceClass;
+        ttl: number;
+    }>): ToolHandler<TArgs, WrappedToolResult<TResult>>;
+    /**
+     * Tag an already-computed result (for tools that don't use the wrap pattern).
+     */
+    tag<T>(toolName: string, result: T, overrides?: Partial<{
+        class: EvidenceClass;
+        ttl: number;
+    }>): WrappedToolResult<T>;
+    /**
+     * Batch-tag multiple results from different tools.
+     */
+    tagBatch(items: Array<{
+        toolName: string;
+        result: unknown;
+    }>): WrappedToolResult[];
+    /** Check all cached results for degradation. */
+    checkDegradation(): DegradationEvent[];
+    /** Prune stale cache entries. */
+    prune(): number;
+    /** Get cache size. */
+    get cacheSize(): number;
+    /** Register additional tool classifications at runtime. */
+    registerTool(classification: ToolClassification): void;
+    /** Register multiple tool classifications. */
+    registerTools(classifications: ToolClassification[]): void;
+}
+/** MCP tool call context. */
+export interface McpToolCall {
+    name: string;
+    arguments: unknown;
+}
+/** MCP tool response. */
+export interface McpToolResponse {
+    content: Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Creates middleware that intercepts MCP tool responses and injects evidence.
+ *
+ * @example
+ * ```ts
+ * const evidenceMiddleware = createMcpMiddleware();
+ *
+ * // In your MCP server's tool handler:
+ * const rawResult = await handleTool(call);
+ * const taggedResult = evidenceMiddleware(call, rawResult);
+ * ```
+ */
+export declare function createMcpMiddleware(config?: WrapperConfig): (call: McpToolCall, response: McpToolResponse) => McpToolResponse;
+//# sourceMappingURL=mcp-wrapper.d.ts.map

package/dist/mcp-wrapper.d.ts.map

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