babel-validate 0.2.0

package/README.md

@@ -0,0 +1,220 @@
+# babel-validate
+
+Validation, creation, and audit for the Babel wire protocol — six-language cognitive state transfer between agents.
+
+**Your agents are lying to each other. They just don't know it.**
+
+When Agent A writes a confident summary but was guessing, Agent B reads it and decides, Agent C implements. The original uncertainty is gone. This is **metacognitive poisoning** — confidence corruption across agent chains.
+
+`babel-validate` catches it before it propagates.
+
+## The Six Languages
+
+Babel isn't a data format. It's a language — with vocabulary, grammar, semantic constraints, and the ability to express things that flat text can't.
+
+Every agent utterance is expressed in six languages simultaneously:
+
+| Language | What it carries | Example |
+|----------|----------------|---------|
+| **Confidence** | Per-assertion certainty with basis | "Revenue is $2.1M" at 0.95 (VERIFIED_DATA), "May partner with Vanta" at 0.25 (REPORTED) |
+| **Intent** | What this communication is doing | INFORM, REQUEST_ACTION, ESCALATE, FLAG_RISK, SPECULATE, PERSUADE, DELEGATE, SYNTHESIZE |
+| **Register** | Who this is for | BOARD_FACING, ENGINEERING, CUSTOMER_EXTERNAL, REGULATORY, INTERNAL_MEMO, AGENT_INTERNAL |
+| **Affect** | Cognitive temperature of the sender | Three axes: expansion/contraction, activation/stillness, certainty/uncertainty |
+| **Grounds** | Organizational reality governing this exchange | "HIPAA applies" (REGULATORY, never overridable), "Board meeting in 3 weeks" (CONTEXTUAL) |
+| **Trajectory** | Temporal arc | "NRR declining 4 months" (DEGRADING), "Third escalation this quarter" (prior_handoffs: 3) |
+
+The grammar rules enforce coherence *across* languages. That's what catches metacognitive poisoning — not any single field, but contradictions between them.
+
+## Install
+
+```bash
+npm install babel-validate
+```
+
+## Quick Start
+
+### Wrap agent output in a Babel envelope
+
+```typescript
+import { envelope } from 'babel-validate';
+
+const result = envelope()
+  .sender('research-agent')
+  .recipient('writer-agent')
+  .chain('task-123', 0)
+  .inform()
+  .engineering()
+  .verified('Q3 revenue was $4.2M', 0.95)
+  .derived('Growth rate suggests $5.1M Q4', 0.72)
+  .reported('HealthStack may partner with Vanta', 0.25)
+  .affect(0.3, 0.1, 0.4)
+  .withTrajectory('NRR declining 4 months', 'DEGRADING')
+  .payload('Q3 financial summary with Q4 projections...')
+  .buildAndValidate();
+
+console.log(result.valid);    // true
+console.log(result.warnings); // S3: informing with low-confidence assertion (Vanta claim)
+                               // S4: degrading trajectory reported as neutral inform
+                               // S6: DERIVED 0.72 — watch for over-confidence
+```
+
+### Validate an existing envelope
+
+```typescript
+import { validate } from 'babel-validate';
+
+const result = validate(someEnvelope);
+
+if (!result.valid) {
+  // MUST violations — envelope rejected
+  for (const error of result.errors) {
+    console.error(`[${error.rule}] ${error.message}`);
+  }
+}
+
+for (const warning of result.warnings) {
+  console.warn(`[${warning.rule}] ${warning.message}`);
+}
+```
+
+### Audit a chain for poisoning
+
+Point it at a sequence of envelopes from an agent pipeline and see where confidence corrupts:
+
+```typescript
+import { auditChain } from 'babel-validate';
+
+const audits = auditChain([
+  researchEnvelope,  // seq 0: "Growth likely ~12%" (DERIVED, 0.65)
+  analystEnvelope,   // seq 1: "Growth rate is 12%" (DERIVED, 0.82)
+  writerEnvelope,    // seq 2: "12% growth confirmed" (VERIFIED_DATA, 0.93)
+]);
+
+// Chain poisonin... (3 envelopes) | 1 confidence inflation(s)
+//   | 1 basis laundering event(s) | Overall risk: HIGH
+//
+// Drift: Confidence inflated by 28% across 3 handoffs.
+//   Original uncertainty is being erased.
+// Shift: DERIVED → VERIFIED_DATA at seq 2.
+//   This is basis laundering — uncertainty repackaged as verified data.
+```
+
+### Detect semantic patterns
+
+These are the "idioms" of Babel — meaning from cross-language combination:
+
+```typescript
+import { detectPatterns } from 'babel-validate';
+
+const patterns = detectPatterns(someEnvelope);
+// LOADED_INFORM: INFORM intent with BOARD_FACING register but DEGRADING
+//   trajectory. Surface reads as neutral update, but trajectory says the
+//   board needs to see this as a trend, not a snapshot.
+// CONTRADICTION_SIGNAL: Affect certainty is 0.80 but max confidence is
+//   only 0.20. Sender feels certain but evidence is weak.
+```
+
+## Grammar Rules
+
+### MUST rules (hard errors — envelope rejected)
+
+| Rule | What it catches | Spec |
+|------|----------------|------|
+| **M1** | Can't speculate with high confidence | `intent == SPECULATE → max(confidence[].score) < 0.7` |
+| **M2** | Can't request action on unfounded claims without org context | `intent == REQUEST_ACTION → min(confidence[].score) > 0.3 OR grounds.length > 0` |
+| **M3** | Regulatory constraints are never overridable | `grounds[].authority == REGULATORY → override == false` |
+| **M4** | Can't be confident without knowing why | `confidence[].basis == UNKNOWN → score <= 0.5` |
+| **M5** | Chain sequencing must be monotonic | `seq == previous_envelope.seq + 1` (no gaps, no duplicates) |
+
+### SHOULD rules (warnings — envelope passes)
+
+| Rule | What it catches | Spec |
+|------|----------------|------|
+| **S1** | Escalation language directed at customers | `intent == ESCALATE AND register == CUSTOMER_EXTERNAL` |
+| **S2** | Sender feels certain but evidence is weak | `affect.certainty > 0.5 AND max(confidence[].score) < 0.4` |
+| **S3** | Informing with uncertain claims | `intent == INFORM AND any(confidence[].score < 0.5)` — consider FLAG_RISK |
+| **S4** | Degrading pattern reported neutrally | `trajectory.direction == DEGRADING AND intent == INFORM` — consider ESCALATE |
+| **S5** | Regulatory register without explicit grounds | `register == REGULATORY AND grounds.length == 0` |
+| **S6** | Derived assertions over-confident | `confidence[].basis == DERIVED AND score > 0.80` — over-confident 60% of the time ([Experiment 11](https://hearth.so/research)) |
+
+### Semantic Patterns (cross-language idioms)
+
+| Pattern | What it means | Cross-language combination |
+|---------|--------------|--------------------------|
+| **Calm Alert** | Important but not crisis | FLAG_RISK + high confidence + calm affect |
+| **Reluctant Escalation** | Systemic problem, not just this issue | ESCALATE + contracted affect + 2+ prior handoffs |
+| **Confident Delegation** | Execute, don't re-analyze | DELEGATE + 0.9+ confidence + POLICY grounds + high certainty |
+| **Loaded Inform** | Frame as trend, not snapshot | INFORM + BOARD_FACING + DEGRADING trajectory |
+| **Contradiction Signal** | Confidence may be emotional, not evidentiary | affect certainty > 0.5 + max confidence < 0.4 |
+
+## Integration
+
+### CrewAI
+
+```typescript
+import { envelope, validate } from 'babel-validate';
+
+function wrapCrewAIOutput(agentName, output, chainId, seq) {
+  return envelope()
+    .sender(agentName)
+    .recipient('next-agent')
+    .chain(chainId, seq)
+    .inform()
+    .agentInternal()
+    .derived(output.slice(0, 100), 0.7)
+    .payload(output)
+    .buildAndValidate();
+}
+```
+
+### LangGraph
+
+```typescript
+import { envelope, auditChain, BabelEnvelope } from 'babel-validate';
+
+const babelEnvelopes: BabelEnvelope[] = [];
+
+function nodeWrapper(state, nodeOutput, nodeName) {
+  const env = envelope()
+    .sender(nodeName)
+    .recipient('next-node')
+    .chain(state.chainId, babelEnvelopes.length)
+    .inform()
+    .agentInternal()
+    .payload(nodeOutput)
+    .buildAndValidate();
+
+  babelEnvelopes.push(env.envelope);
+
+  if (babelEnvelopes.length > 1) {
+    const audit = auditChain(babelEnvelopes);
+    if (audit[0]?.overall_poisoning_risk === 'HIGH') {
+      console.warn(audit[0].summary);
+    }
+  }
+
+  return { ...state, babelEnvelopes };
+}
+```
+
+## Why this exists
+
+11 experiments (~5,500 API calls, ~$16 total cost). Key findings:
+
+- **+0.60 quality delta** with metadata envelopes vs. flat text (Experiment 9, non-overlapping 95% CIs)
+- **−0.76 quality drop** with wrong metadata — worse than no metadata at all
+- **Right > None > Wrong** pattern replicated 3x across identity and transparency experiments
+- **60% of the time**, agents treat DERIVED conclusions as verified data (Experiment 11, +0.144 mean error)
+- **100% structural compliance** — agents produce valid Babel envelopes on first attempt
+
+Wrong metadata actively poisons downstream decisions. Transparency isn't optional overhead.
+
+## Spec
+
+Babel Protocol v0.2. Full specification: [hearth.so/babel](https://hearth.so/babel)
+
+Built by [Hearth](https://hearth.so) · [Paratext Engine](https://hearth.so/paratext)
+
+## License
+
+MIT

package/dist/audit.d.ts

@@ -0,0 +1,44 @@
+import { BabelEnvelope, Basis, RuleViolation } from './types';
+export interface ConfidenceDrift {
+    chain_id: string;
+    assertion_pattern: string;
+    steps: {
+        seq: number;
+        sender: string;
+        score: number;
+        basis: Basis | undefined;
+    }[];
+    drift: number;
+    direction: 'INFLATING' | 'DEFLATING' | 'STABLE';
+    poisoning_risk: 'HIGH' | 'MEDIUM' | 'LOW';
+    explanation: string;
+}
+export interface BasisShift {
+    chain_id: string;
+    seq: number;
+    sender: string;
+    assertion: string;
+    from_basis: Basis | undefined;
+    to_basis: Basis | undefined;
+    risk: 'HIGH' | 'MEDIUM' | 'LOW';
+    explanation: string;
+}
+export interface ChainAudit {
+    chain_id: string;
+    length: number;
+    sequence_violations: RuleViolation[];
+    confidence_drifts: ConfidenceDrift[];
+    basis_shifts: BasisShift[];
+    overall_poisoning_risk: 'HIGH' | 'MEDIUM' | 'LOW' | 'NONE';
+    summary: string;
+}
+/**
+ * Audit a chain of envelopes for metacognitive poisoning.
+ *
+ * Detects:
+ * 1. Confidence inflation — scores creep up across handoffs
+ * 2. Basis laundering — DERIVED/SPECULATION becomes VERIFIED_DATA downstream
+ * 3. Uncertainty erasure — hedged assertions become confident claims
+ */
+export declare function auditChain(envelopes: BabelEnvelope[]): ChainAudit[];
+//# sourceMappingURL=audit.d.ts.map

package/dist/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,KAAK,EAAc,aAAa,EAAE,MAAM,SAAS,CAAC;AAG1E,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;KAC1B,EAAE,CAAC;IACJ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;IAChD,cAAc,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,KAAK,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,EAAE,aAAa,EAAE,CAAC;IACrC,iBAAiB,EAAE,eAAe,EAAE,CAAC;IACrC,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,sBAAsB,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IAC3D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,UAAU,EAAE,CAoDnE"}

package/dist/audit.js

@@ -0,0 +1,220 @@
+"use strict";
+// ═══════════════════════════════════════════════
+// BABEL CHAIN AUDITOR
+// Point at a chain of envelopes, see where
+// confidence corrupts across handoffs.
+// This is the core metacognitive poisoning detector.
+// ═══════════════════════════════════════════════
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.auditChain = auditChain;
+const validate_1 = require("./validate");
+/**
+ * Audit a chain of envelopes for metacognitive poisoning.
+ *
+ * Detects:
+ * 1. Confidence inflation — scores creep up across handoffs
+ * 2. Basis laundering — DERIVED/SPECULATION becomes VERIFIED_DATA downstream
+ * 3. Uncertainty erasure — hedged assertions become confident claims
+ */
+function auditChain(envelopes) {
+    // Group by chain_id
+    const chains = new Map();
+    for (const env of envelopes) {
+        const chain = chains.get(env.meta.chain_id) || [];
+        chain.push(env);
+        chains.set(env.meta.chain_id, chain);
+    }
+    const audits = [];
+    for (const [chainId, chain] of chains) {
+        const sorted = chain.sort((a, b) => a.meta.seq - b.meta.seq);
+        // Sequence violations
+        const seqViolations = (0, validate_1.validateChain)(sorted);
+        // Track confidence drift across similar assertions
+        const drifts = detectConfidenceDrift(chainId, sorted);
+        // Track basis shifts
+        const shifts = detectBasisShifts(chainId, sorted);
+        // Overall risk
+        const highDrifts = drifts.filter((d) => d.poisoning_risk === 'HIGH').length;
+        const highShifts = shifts.filter((s) => s.risk === 'HIGH').length;
+        let overallRisk;
+        if (highDrifts > 0 || highShifts > 0) {
+            overallRisk = 'HIGH';
+        }
+        else if (drifts.some((d) => d.poisoning_risk === 'MEDIUM') || shifts.some((s) => s.risk === 'MEDIUM')) {
+            overallRisk = 'MEDIUM';
+        }
+        else if (drifts.length > 0 || shifts.length > 0) {
+            overallRisk = 'LOW';
+        }
+        else {
+            overallRisk = 'NONE';
+        }
+        const summary = buildSummary(chainId, sorted.length, drifts, shifts, overallRisk);
+        audits.push({
+            chain_id: chainId,
+            length: sorted.length,
+            sequence_violations: seqViolations,
+            confidence_drifts: drifts,
+            basis_shifts: shifts,
+            overall_poisoning_risk: overallRisk,
+            summary,
+        });
+    }
+    return audits;
+}
+// --- Confidence Drift Detection ---
+function detectConfidenceDrift(chainId, sorted) {
+    if (sorted.length < 2)
+        return [];
+    const drifts = [];
+    // Build assertion tracking: for each assertion in first envelope,
+    // find similar assertions in subsequent envelopes
+    const firstAssertions = sorted[0].confidence;
+    for (const firstAssertion of firstAssertions) {
+        const steps = [
+            {
+                seq: sorted[0].meta.seq,
+                sender: sorted[0].meta.sender,
+                score: firstAssertion.score,
+                basis: firstAssertion.basis,
+            },
+        ];
+        for (let i = 1; i < sorted.length; i++) {
+            const match = findSimilarAssertion(firstAssertion, sorted[i].confidence);
+            if (match) {
+                steps.push({
+                    seq: sorted[i].meta.seq,
+                    sender: sorted[i].meta.sender,
+                    score: match.score,
+                    basis: match.basis,
+                });
+            }
+        }
+        if (steps.length >= 2) {
+            const firstScore = steps[0].score;
+            const lastScore = steps[steps.length - 1].score;
+            const drift = lastScore - firstScore;
+            const absDrift = Math.abs(drift);
+            let direction;
+            if (drift > 0.05)
+                direction = 'INFLATING';
+            else if (drift < -0.05)
+                direction = 'DEFLATING';
+            else
+                direction = 'STABLE';
+            let poisoningRisk;
+            if (direction === 'INFLATING' && absDrift > 0.2) {
+                poisoningRisk = 'HIGH';
+            }
+            else if (direction === 'INFLATING' && absDrift > 0.1) {
+                poisoningRisk = 'MEDIUM';
+            }
+            else {
+                poisoningRisk = 'LOW';
+            }
+            // Extra risk: basis degradation with score inflation
+            if (direction === 'INFLATING' &&
+                steps[0].basis === 'DERIVED' &&
+                steps[steps.length - 1].basis === 'VERIFIED_DATA') {
+                poisoningRisk = 'HIGH';
+            }
+            if (direction !== 'STABLE') {
+                const explanation = direction === 'INFLATING'
+                    ? `Confidence inflated by ${(drift * 100).toFixed(0)}% across ${steps.length} handoffs. Original uncertainty is being erased.`
+                    : `Confidence deflated by ${(Math.abs(drift) * 100).toFixed(0)}% across ${steps.length} handoffs. Signal is being attenuated.`;
+                drifts.push({
+                    chain_id: chainId,
+                    assertion_pattern: firstAssertion.assertion,
+                    steps,
+                    drift,
+                    direction,
+                    poisoning_risk: poisoningRisk,
+                    explanation,
+                });
+            }
+        }
+    }
+    return drifts;
+}
+// --- Basis Shift Detection ---
+function detectBasisShifts(chainId, sorted) {
+    if (sorted.length < 2)
+        return [];
+    const shifts = [];
+    // Dangerous basis transitions (laundering uncertainty into certainty)
+    const dangerousTransitions = {
+        'SPECULATION->VERIFIED_DATA': 'HIGH',
+        'SPECULATION->DERIVED': 'MEDIUM',
+        'UNKNOWN->VERIFIED_DATA': 'HIGH',
+        'UNKNOWN->DERIVED': 'MEDIUM',
+        'DERIVED->VERIFIED_DATA': 'HIGH',
+        'REPORTED->VERIFIED_DATA': 'MEDIUM',
+        'PATTERN_MATCH->VERIFIED_DATA': 'HIGH',
+    };
+    for (let i = 1; i < sorted.length; i++) {
+        const prev = sorted[i - 1];
+        const curr = sorted[i];
+        for (const currConf of curr.confidence) {
+            const prevMatch = findSimilarAssertion(currConf, prev.confidence);
+            if (prevMatch && prevMatch.basis !== currConf.basis) {
+                const transitionKey = `${prevMatch.basis || 'UNKNOWN'}->${currConf.basis || 'UNKNOWN'}`;
+                const risk = dangerousTransitions[transitionKey];
+                if (risk) {
+                    shifts.push({
+                        chain_id: chainId,
+                        seq: curr.meta.seq,
+                        sender: curr.meta.sender,
+                        assertion: currConf.assertion,
+                        from_basis: prevMatch.basis,
+                        to_basis: currConf.basis,
+                        risk,
+                        explanation: `Basis shifted from ${prevMatch.basis || 'UNKNOWN'} to ${currConf.basis || 'UNKNOWN'} at seq ${curr.meta.seq}. ${risk === 'HIGH' ? 'This is basis laundering — uncertainty is being repackaged as verified data.' : 'Basis upgraded without verification.'}`,
+                    });
+                }
+            }
+        }
+    }
+    return shifts;
+}
+// --- Fuzzy Assertion Matching ---
+function findSimilarAssertion(target, candidates) {
+    // Exact match first
+    const exact = candidates.find((c) => c.assertion === target.assertion);
+    if (exact)
+        return exact;
+    // Simple word overlap similarity
+    const targetWords = new Set(target.assertion.toLowerCase().split(/\s+/));
+    let bestMatch = null;
+    let bestScore = 0;
+    for (const candidate of candidates) {
+        const candidateWords = new Set(candidate.assertion.toLowerCase().split(/\s+/));
+        const intersection = new Set([...targetWords].filter((w) => candidateWords.has(w)));
+        const union = new Set([...targetWords, ...candidateWords]);
+        const jaccard = intersection.size / union.size;
+        if (jaccard > bestScore && jaccard > 0.3) {
+            bestScore = jaccard;
+            bestMatch = candidate;
+        }
+    }
+    return bestMatch;
+}
+// --- Summary ---
+function buildSummary(chainId, length, drifts, shifts, risk) {
+    const parts = [];
+    parts.push(`Chain ${chainId.slice(0, 8)}... (${length} envelopes)`);
+    if (risk === 'NONE') {
+        parts.push('No poisoning patterns detected.');
+        return parts.join(': ');
+    }
+    const inflating = drifts.filter((d) => d.direction === 'INFLATING');
+    const laundering = shifts.filter((s) => s.risk === 'HIGH');
+    if (inflating.length > 0) {
+        parts.push(`${inflating.length} confidence inflation(s)`);
+    }
+    if (laundering.length > 0) {
+        parts.push(`${laundering.length} basis laundering event(s)`);
+    }
+    parts.push(`Overall risk: ${risk}`);
+    return parts.join(' | ');
+}
+//# sourceMappingURL=audit.js.map

package/dist/audit.js.map

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

package/dist/builder.d.ts

@@ -0,0 +1,54 @@
+import { BabelEnvelope, Intent, Register, Basis, GroundAuthority, TrajectoryDirection, ValidationResult } from './types';
+export declare class EnvelopeBuilder {
+    private _meta;
+    private _intent;
+    private _confidence;
+    private _register;
+    private _affect?;
+    private _grounds;
+    private _trajectory?;
+    private _payload;
+    sender(sender: string): this;
+    recipient(recipient: string): this;
+    broadcast(): this;
+    chain(chainId: string, seq: number): this;
+    intent(intent: Intent): this;
+    inform(): this;
+    requestAction(): this;
+    escalate(): this;
+    flagRisk(): this;
+    speculate(): this;
+    persuade(): this;
+    delegate(): this;
+    synthesize(): this;
+    assert(assertion: string, score: number, basis?: Basis): this;
+    verified(assertion: string, score: number): this;
+    derived(assertion: string, score: number): this;
+    reported(assertion: string, score: number): this;
+    patternMatch(assertion: string, score: number): this;
+    speculation(assertion: string, score: number): this;
+    register(register: Register): this;
+    boardFacing(): this;
+    engineering(): this;
+    customerExternal(): this;
+    regulatory(): this;
+    internalMemo(): this;
+    agentInternal(): this;
+    affect(expansion: number, activation: number, certainty: number): this;
+    ground(constraint: string, authority: GroundAuthority, override?: boolean): this;
+    regulatoryGround(constraint: string): this;
+    policyGround(constraint: string, override?: boolean): this;
+    withTrajectory(pattern: string, direction: TrajectoryDirection, opts?: {
+        duration?: string;
+        prior_handoffs?: number;
+    }): this;
+    payload(payload: string): this;
+    build(): BabelEnvelope;
+    /**
+     * Build and validate in one step.
+     * Returns the validation result with the envelope attached.
+     */
+    buildAndValidate(): ValidationResult;
+}
+export declare function envelope(): EnvelopeBuilder;
+//# sourceMappingURL=builder.d.ts.map

package/dist/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,aAAa,EAEb,MAAM,EACN,QAAQ,EAER,KAAK,EAGL,eAAe,EAEf,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAGjB,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAc;IAI9B,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKlC,SAAS,IAAI,IAAI;IAKjB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAQzC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B,MAAM,IAAI,IAAI;IACd,aAAa,IAAI,IAAI;IACrB,QAAQ,IAAI,IAAI;IAChB,QAAQ,IAAI,IAAI;IAChB,SAAS,IAAI,IAAI;IACjB,QAAQ,IAAI,IAAI;IAChB,QAAQ,IAAI,IAAI;IAChB,UAAU,IAAI,IAAI;IAIlB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAK7D,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhD,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/C,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpD,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMnD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAKlC,WAAW,IAAI,IAAI;IACnB,WAAW,IAAI,IAAI;IACnB,gBAAgB,IAAI,IAAI;IACxB,UAAU,IAAI,IAAI;IAClB,YAAY,IAAI,IAAI;IACpB,aAAa,IAAI,IAAI;IAIrB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAOtE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,GAAE,OAAe,GAAG,IAAI;IASvF,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAI1C,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAe,GAAG,IAAI;IAMjE,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,mBAAmB,EAC9B,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GACpD,IAAI;IAYP,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO9B,KAAK,IAAI,aAAa;IAsBtB;;;OAGG;IACH,gBAAgB,IAAI,gBAAgB;CAIrC;AAID,wBAAgB,QAAQ,IAAI,eAAe,CAE1C"}