evidential-protocol 1.0.0 → 2.0.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/content.d.ts

@@ -0,0 +1,83 @@
+/**
+ * EP-1 Phase 4: Content Pipeline Integration
+ *
+ * Tags generated content with inline evidence markers,
+ * computes content trust scores, and gates publishing.
+ */
+import { type EvidenceClass, type ContentEvidenceMarker, type TrustScore } from "./types.js";
+/** A tagged sentence within content. */
+export interface TaggedSentence {
+    /** Original sentence text. */
+    text: string;
+    /** Evidence marker if tagged. */
+    marker?: ContentEvidenceMarker;
+    /** Whether this sentence makes a claim that should be tagged. */
+    isClaim: boolean;
+}
+/** Result of content analysis. */
+export interface ContentAnalysis {
+    /** All sentences in the content. */
+    sentences: TaggedSentence[];
+    /** Extracted evidence markers. */
+    markers: ContentEvidenceMarker[];
+    /** Trust score based on markers. */
+    trust: TrustScore;
+    /** Display string. */
+    display: string;
+    /** Sentences that appear to be claims but lack markers. */
+    untagged_claims: string[];
+    /** Content with markers stripped (clean version). */
+    clean_text: string;
+    /** Whether content passes the publish gate. */
+    publishable: boolean;
+}
+/**
+ * Detect if a sentence contains a factual claim that should be evidentially tagged.
+ */
+export declare function isClaim(sentence: string): boolean;
+/**
+ * Strip evidence markers from content, returning clean text.
+ */
+export declare function stripMarkers(content: string): string;
+/**
+ * Analyze content for evidential completeness.
+ */
+export declare function analyzeContent(content: string): ContentAnalysis;
+/**
+ * Tag a sentence with an evidence marker.
+ */
+export declare function tagSentence(sentence: string, cls: EvidenceClass, source: string, confidence?: number): string;
+/**
+ * Auto-tag content by applying evidence markers to detected claims.
+ * Uses a default classification function to guess the evidence class.
+ */
+export declare function autoTag(content: string, classifier: (sentence: string) => ContentEvidenceMarker | null): string;
+/** Publish gate result. */
+export interface PublishGateResult {
+    /** Whether content is approved for publishing. */
+    approved: boolean;
+    /** Reason if blocked. */
+    reason?: string;
+    /** Trust score. */
+    trust: TrustScore;
+    /** Number of untagged claims (claims without evidence). */
+    untagged_claims: number;
+    /** Recommendations for improvement. */
+    recommendations: string[];
+}
+/**
+ * Check if content passes the publish gate.
+ *
+ * Rules:
+ * 1. Trust score must be >= threshold (default 0.5)
+ * 2. No more than max_untagged claims without evidence markers
+ * 3. No conjecture claims without explicit reasoning
+ */
+export declare function publishGate(content: string, opts?: {
+    trust_threshold?: number;
+    max_untagged?: number;
+    require_all_tagged?: boolean;
+}): PublishGateResult;
+/** Render content with visual evidence indicators for human review. */
+export declare function renderForReview(content: string): string;
+//# sourceMappingURL=content.d.ts.map

package/dist/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EAGhB,MAAM,YAAY,CAAC;AAepB,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,kCAAkC;AAClC,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,kCAAkC;IAClC,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,oCAAoC;IACpC,KAAK,EAAE,UAAU,CAAC;IAClB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,WAAW,EAAE,OAAO,CAAC;CACtB;AA4BD;;GAEG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAejD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CA2D/D;AAMD;;GAEG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAGR;AAED;;;GAGG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,qBAAqB,GAAG,IAAI,GAC7D,MAAM,CAkBR;AAMD,2BAA2B;AAC3B,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAC;IAClB,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,KAAK,EAAE,UAAU,CAAC;IAClB,2DAA2D;IAC3D,eAAe,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IACJ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CACzB,GACL,iBAAiB,CAkDnB;AAMD,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA+BvD"}