agent-passport-system 2.0.0 → 2.2.0

package/dist/src/v2/cognitive-attestation/disputes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disputes.js","sourceRoot":"","sources":["../../../../src/v2/cognitive-attestation/disputes.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qEAAqE;AACrE,iEAAiE;AACjE,qEAAqE;AACrE,0EAA0E;AAC1E,EAAE;AACF,kEAAkE;AAClE,oEAAoE;AACpE,wEAAwE;AACxE,qEAAqE"}

package/dist/src/v2/cognitive-attestation/envelope.d.ts

@@ -0,0 +1,44 @@
+import type { CognitiveAttestation, BuildAttestationInput, FeatureActivation, SignerRole } from './types.js';
+/**
+ * Sort feature_activations canonically. Per schema: sort by
+ * (feature_id ascending, activation_statistic alphabetically).
+ * Returns a new array; does not mutate input.
+ */
+export declare function sortFeatureActivations(acts: FeatureActivation[]): FeatureActivation[];
+/**
+ * Construct an unsigned cognitive attestation. The returned object has
+ * `signatures: []` and canonically-sorted `feature_activations`. Callers
+ * sign it via `signAttestation`.
+ */
+export declare function buildAttestation(input: BuildAttestationInput): CognitiveAttestation;
+/**
+ * JCS-canonicalize the attestation for signing. Signatures are elided
+ * (`signatures: []`) so all signers over the same payload produce the
+ * same input bytes regardless of signing order.
+ *
+ * Returns UTF-8 bytes. To obtain the canonical string, decode with TextDecoder.
+ */
+export declare function canonicalizeAttestation(att: CognitiveAttestation): Uint8Array;
+/**
+ * Sign an attestation with a 32-byte Ed25519 seed. Appends a new entry to
+ * `signatures`. Returns a new object; never mutates input.
+ *
+ * The signature covers `canonicalizeAttestation(att)`, i.e. the envelope
+ * with `signatures: []`. Additional signers produce byte-identical canonical
+ * input, so the signing order does not affect any individual signature.
+ */
+export declare function signAttestation(att: CognitiveAttestation, privateKey: Uint8Array, signerDid: string, signerRole: SignerRole): CognitiveAttestation;
+/**
+ * Cross-primitive anchor. Returns lowercase hex sha256 of the full signed
+ * envelope (including signatures) under JCS. Use this when an APS action
+ * receipt needs to reference a cognitive attestation by content hash.
+ *
+ * Matches the hashing pattern of other v2 primitives (wallet-binding digest,
+ * attribution-primitive canonical hash).
+ */
+export declare function cognitiveAttestationDigest(att: CognitiveAttestation): string;
+export declare function validateAttestationShape(att: unknown): {
+    ok: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=envelope.d.ts.map

package/dist/src/v2/cognitive-attestation/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../../../src/v2/cognitive-attestation/envelope.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,UAAU,EACX,MAAM,YAAY,CAAA;AAcnB;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAOrF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,oBAAoB,CAuCnF;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,oBAAoB,GAAG,UAAU,CAQ7E;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,oBAAoB,EACzB,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,GACrB,oBAAoB,CAsBtB;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,CAO5E;AAkCD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAsJxF"}

package/dist/src/v2/cognitive-attestation/envelope.js

@@ -0,0 +1,341 @@
+// Copyright 2024-2026 Tymofii Pidlisnyi. Apache-2.0 license. See LICENSE.
+// ══════════════════════════════════════════════════════════════════
+// Cognitive Attestation — envelope construction, JCS, signing, digest
+// ══════════════════════════════════════════════════════════════════
+// Paper: "Cognitive Attestation" — Zenodo DOI 10.5281/zenodo.19646276
+// Normative schema: papers/paper-4/poc/schema/cognitive_attestation.schema.json
+//
+// Wire compatibility with the Python reference impl at
+// papers/paper-4/poc/src/envelope.py is preserved via:
+//   - canonicalizeJCS (RFC 8785, nulls preserved)
+//   - base64 signatures
+//   - feature_activations sorted by (feature_id, activation_statistic)
+// ══════════════════════════════════════════════════════════════════
+import { createHash } from 'node:crypto';
+import { canonicalizeJCS } from '../../core/canonical-jcs.js';
+import { sign as edSignHex } from '../../crypto/keys.js';
+const SPEC_VERSION = '1.0';
+function bytesToHex(bytes) {
+    let out = '';
+    for (let i = 0; i < bytes.length; i++)
+        out += bytes[i].toString(16).padStart(2, '0');
+    return out;
+}
+function hexToBase64(hex) {
+    return Buffer.from(hex, 'hex').toString('base64');
+}
+/**
+ * Sort feature_activations canonically. Per schema: sort by
+ * (feature_id ascending, activation_statistic alphabetically).
+ * Returns a new array; does not mutate input.
+ */
+export function sortFeatureActivations(acts) {
+    return acts.slice().sort((a, b) => {
+        if (a.feature_id !== b.feature_id)
+            return a.feature_id - b.feature_id;
+        if (a.activation_statistic < b.activation_statistic)
+            return -1;
+        if (a.activation_statistic > b.activation_statistic)
+            return 1;
+        return 0;
+    });
+}
+/**
+ * Construct an unsigned cognitive attestation. The returned object has
+ * `signatures: []` and canonically-sorted `feature_activations`. Callers
+ * sign it via `signAttestation`.
+ */
+export function buildAttestation(input) {
+    const timestamp = input.timestamp ?? new Date().toISOString();
+    return {
+        spec_version: SPEC_VERSION,
+        model_ref: {
+            model_id: input.model_id,
+            model_version_hash: input.model_version_hash,
+            tokenizer_version_hash: input.tokenizer_version_hash,
+            inference_provider: input.inference_provider,
+            execution_environment: {
+                hardware_family: input.hardware_family,
+                precision: input.precision,
+                inference_engine: input.inference_engine,
+                deterministic_mode: input.deterministic_mode,
+            },
+        },
+        dictionary_ref: {
+            dictionary_id: input.dictionary_id,
+            dictionary_version_hash: input.dictionary_version_hash,
+            training_corpus_hash: input.training_corpus_hash,
+            layer_index: input.layer_index,
+            attachment_point: input.attachment_point,
+            sae_type: input.sae_type,
+        },
+        token_range: {
+            absolute_sequence_hash: input.absolute_sequence_hash,
+            prior_state_hash: input.prior_state_hash,
+            start_token_index: input.start_token_index,
+            end_token_index: input.end_token_index,
+            token_count: input.token_count,
+        },
+        feature_activations: sortFeatureActivations(input.feature_activations),
+        aggregation_policy: {
+            ...input.aggregation_policy,
+            required_signer_roles: input.aggregation_policy.required_signer_roles.slice(),
+        },
+        signatures: [],
+        attestation_timestamp: timestamp,
+    };
+}
+/**
+ * JCS-canonicalize the attestation for signing. Signatures are elided
+ * (`signatures: []`) so all signers over the same payload produce the
+ * same input bytes regardless of signing order.
+ *
+ * Returns UTF-8 bytes. To obtain the canonical string, decode with TextDecoder.
+ */
+export function canonicalizeAttestation(att) {
+    const view = {
+        ...att,
+        feature_activations: sortFeatureActivations(att.feature_activations),
+        signatures: [],
+    };
+    const s = canonicalizeJCS(view);
+    return new TextEncoder().encode(s);
+}
+/**
+ * Sign an attestation with a 32-byte Ed25519 seed. Appends a new entry to
+ * `signatures`. Returns a new object; never mutates input.
+ *
+ * The signature covers `canonicalizeAttestation(att)`, i.e. the envelope
+ * with `signatures: []`. Additional signers produce byte-identical canonical
+ * input, so the signing order does not affect any individual signature.
+ */
+export function signAttestation(att, privateKey, signerDid, signerRole) {
+    if (!(privateKey instanceof Uint8Array) || privateKey.length !== 32) {
+        throw new Error('signAttestation: privateKey must be a 32-byte Uint8Array (Ed25519 seed)');
+    }
+    if (typeof signerDid !== 'string' || signerDid.length === 0) {
+        throw new Error('signAttestation: signerDid must be a non-empty string');
+    }
+    const canonicalBytes = canonicalizeAttestation(att);
+    const canonicalString = new TextDecoder().decode(canonicalBytes);
+    const privateKeyHex = bytesToHex(privateKey);
+    const sigHex = edSignHex(canonicalString, privateKeyHex);
+    const sigB64 = hexToBase64(sigHex);
+    return {
+        ...att,
+        feature_activations: sortFeatureActivations(att.feature_activations),
+        signatures: [
+            ...att.signatures,
+            { signer_did: signerDid, signer_role: signerRole, signature: sigB64 },
+        ],
+    };
+}
+/**
+ * Cross-primitive anchor. Returns lowercase hex sha256 of the full signed
+ * envelope (including signatures) under JCS. Use this when an APS action
+ * receipt needs to reference a cognitive attestation by content hash.
+ *
+ * Matches the hashing pattern of other v2 primitives (wallet-binding digest,
+ * attribution-primitive canonical hash).
+ */
+export function cognitiveAttestationDigest(att) {
+    const withSortedFeatures = {
+        ...att,
+        feature_activations: sortFeatureActivations(att.feature_activations),
+    };
+    const canonical = canonicalizeJCS(withSortedFeatures);
+    return createHash('sha256').update(canonical, 'utf-8').digest('hex');
+}
+// ──────────────────────────────────────────────────────────────────
+// Shape validation — hand-rolled check of the normative JSON schema.
+// No new runtime deps. The schema file is the source of truth; this
+// function mirrors its required fields, enums, and patterns.
+// ──────────────────────────────────────────────────────────────────
+const HEX64 = /^[0-9a-f]{64}$/;
+const PRECISIONS = new Set(['fp32', 'fp16', 'bf16', 'int8']);
+const ATTACHMENT_POINTS = new Set(['residual_stream', 'attention_output', 'mlp_output']);
+const SAE_TYPES = new Set(['standard', 'topk', 'jumprelu', 'gated', 'batchtopk']);
+const STATS = new Set(['max', 'mean', 'sum', 'integral', 'last']);
+const COMPLETENESS = new Set(['top_k_only', 'all_above_threshold', 'dictionary_exhaustive']);
+const TIEBREAKERS = new Set(['lowest_feature_id', 'highest_feature_id']);
+const ROLES = new Set(['agent', 'operator', 'provider', 'third_party_attester']);
+function isObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+function isInt(v) {
+    return typeof v === 'number' && Number.isInteger(v);
+}
+function checkHex64(errs, path, v) {
+    if (typeof v !== 'string' || !HEX64.test(v))
+        errs.push(`${path}: expected 64-char lowercase hex`);
+}
+function checkHex64Nullable(errs, path, v) {
+    if (v === null)
+        return;
+    checkHex64(errs, path, v);
+}
+export function validateAttestationShape(att) {
+    const errors = [];
+    if (!isObject(att))
+        return { ok: false, errors: ['root: expected object'] };
+    if (att.spec_version !== '1.0')
+        errors.push('spec_version: must be "1.0"');
+    // model_ref
+    const m = att.model_ref;
+    if (!isObject(m)) {
+        errors.push('model_ref: expected object');
+    }
+    else {
+        if (typeof m.model_id !== 'string')
+            errors.push('model_ref.model_id: expected string');
+        checkHex64(errors, 'model_ref.model_version_hash', m.model_version_hash);
+        checkHex64(errors, 'model_ref.tokenizer_version_hash', m.tokenizer_version_hash);
+        if (m.inference_provider !== null && typeof m.inference_provider !== 'string') {
+            errors.push('model_ref.inference_provider: expected string|null');
+        }
+        const ee = m.execution_environment;
+        if (!isObject(ee)) {
+            errors.push('model_ref.execution_environment: expected object');
+        }
+        else {
+            if (typeof ee.hardware_family !== 'string')
+                errors.push('execution_environment.hardware_family: expected string');
+            if (typeof ee.precision !== 'string' || !PRECISIONS.has(ee.precision)) {
+                errors.push('execution_environment.precision: must be fp32|fp16|bf16|int8');
+            }
+            if (typeof ee.inference_engine !== 'string')
+                errors.push('execution_environment.inference_engine: expected string');
+            if (typeof ee.deterministic_mode !== 'boolean')
+                errors.push('execution_environment.deterministic_mode: expected boolean');
+        }
+    }
+    // dictionary_ref
+    const d = att.dictionary_ref;
+    if (!isObject(d)) {
+        errors.push('dictionary_ref: expected object');
+    }
+    else {
+        if (typeof d.dictionary_id !== 'string')
+            errors.push('dictionary_ref.dictionary_id: expected string');
+        checkHex64(errors, 'dictionary_ref.dictionary_version_hash', d.dictionary_version_hash);
+        checkHex64Nullable(errors, 'dictionary_ref.training_corpus_hash', d.training_corpus_hash);
+        if (!isInt(d.layer_index) || d.layer_index < 0) {
+            errors.push('dictionary_ref.layer_index: expected non-negative integer');
+        }
+        if (typeof d.attachment_point !== 'string' || !ATTACHMENT_POINTS.has(d.attachment_point)) {
+            errors.push('dictionary_ref.attachment_point: must be residual_stream|attention_output|mlp_output');
+        }
+        if (typeof d.sae_type !== 'string' || !SAE_TYPES.has(d.sae_type)) {
+            errors.push('dictionary_ref.sae_type: must be standard|topk|jumprelu|gated|batchtopk');
+        }
+    }
+    // token_range
+    const tr = att.token_range;
+    if (!isObject(tr)) {
+        errors.push('token_range: expected object');
+    }
+    else {
+        checkHex64(errors, 'token_range.absolute_sequence_hash', tr.absolute_sequence_hash);
+        checkHex64Nullable(errors, 'token_range.prior_state_hash', tr.prior_state_hash);
+        if (!isInt(tr.start_token_index) || tr.start_token_index < 0) {
+            errors.push('token_range.start_token_index: expected non-negative integer');
+        }
+        if (!isInt(tr.end_token_index) || tr.end_token_index < 0) {
+            errors.push('token_range.end_token_index: expected non-negative integer');
+        }
+        if (!isInt(tr.token_count) || tr.token_count < 1) {
+            errors.push('token_range.token_count: expected integer >= 1');
+        }
+    }
+    // feature_activations
+    if (!Array.isArray(att.feature_activations)) {
+        errors.push('feature_activations: expected array');
+    }
+    else {
+        att.feature_activations.forEach((fa, i) => {
+            if (!isObject(fa)) {
+                errors.push(`feature_activations[${i}]: expected object`);
+                return;
+            }
+            if (!isInt(fa.feature_id) || fa.feature_id < 0) {
+                errors.push(`feature_activations[${i}].feature_id: expected non-negative integer`);
+            }
+            if (fa.feature_label !== null && typeof fa.feature_label !== 'string') {
+                errors.push(`feature_activations[${i}].feature_label: expected string|null`);
+            }
+            if (typeof fa.activation_statistic !== 'string' || !STATS.has(fa.activation_statistic)) {
+                errors.push(`feature_activations[${i}].activation_statistic: must be max|mean|sum|integral|last`);
+            }
+            if (typeof fa.activation_value !== 'number' || fa.activation_value < 0) {
+                errors.push(`feature_activations[${i}].activation_value: expected number >= 0`);
+            }
+            if (!isInt(fa.tokens_active) || fa.tokens_active < 0) {
+                errors.push(`feature_activations[${i}].tokens_active: expected non-negative integer`);
+            }
+        });
+    }
+    // aggregation_policy
+    const ap = att.aggregation_policy;
+    if (!isObject(ap)) {
+        errors.push('aggregation_policy: expected object');
+    }
+    else {
+        if (ap.top_k !== null && (!isInt(ap.top_k) || ap.top_k < 1)) {
+            errors.push('aggregation_policy.top_k: expected integer >= 1 or null');
+        }
+        if (ap.threshold !== null && (typeof ap.threshold !== 'number' || ap.threshold < 0)) {
+            errors.push('aggregation_policy.threshold: expected number >= 0 or null');
+        }
+        if (typeof ap.attestation_epsilon !== 'number' || ap.attestation_epsilon <= 0) {
+            errors.push('aggregation_policy.attestation_epsilon: required, must be number > 0');
+        }
+        checkHex64Nullable(errors, 'aggregation_policy.feature_allowlist_hash', ap.feature_allowlist_hash);
+        if (typeof ap.completeness_claim !== 'string' || !COMPLETENESS.has(ap.completeness_claim)) {
+            errors.push('aggregation_policy.completeness_claim: must be top_k_only|all_above_threshold|dictionary_exhaustive');
+        }
+        if (typeof ap.tiebreaker_rule !== 'string' || !TIEBREAKERS.has(ap.tiebreaker_rule)) {
+            errors.push('aggregation_policy.tiebreaker_rule: must be lowest_feature_id|highest_feature_id');
+        }
+        if (!Array.isArray(ap.required_signer_roles) || ap.required_signer_roles.length === 0) {
+            errors.push('aggregation_policy.required_signer_roles: required, non-empty array');
+        }
+        else {
+            const seen = new Set();
+            ap.required_signer_roles.forEach((r, i) => {
+                if (typeof r !== 'string' || !ROLES.has(r)) {
+                    errors.push(`aggregation_policy.required_signer_roles[${i}]: must be agent|operator|provider|third_party_attester`);
+                }
+                if (seen.has(r))
+                    errors.push(`aggregation_policy.required_signer_roles: duplicate "${r}"`);
+                seen.add(r);
+            });
+        }
+    }
+    // signatures
+    if (!Array.isArray(att.signatures) || att.signatures.length < 1) {
+        errors.push('signatures: expected non-empty array');
+    }
+    else {
+        att.signatures.forEach((s, i) => {
+            if (!isObject(s)) {
+                errors.push(`signatures[${i}]: expected object`);
+                return;
+            }
+            if (typeof s.signer_did !== 'string' || s.signer_did.length === 0) {
+                errors.push(`signatures[${i}].signer_did: expected non-empty string`);
+            }
+            if (typeof s.signer_role !== 'string' || !ROLES.has(s.signer_role)) {
+                errors.push(`signatures[${i}].signer_role: must be agent|operator|provider|third_party_attester`);
+            }
+            if (typeof s.signature !== 'string' || s.signature.length === 0) {
+                errors.push(`signatures[${i}].signature: expected non-empty base64 string`);
+            }
+        });
+    }
+    // attestation_timestamp
+    if (typeof att.attestation_timestamp !== 'string' || Number.isNaN(Date.parse(att.attestation_timestamp))) {
+        errors.push('attestation_timestamp: expected ISO 8601 date-time string');
+    }
+    return { ok: errors.length === 0, errors };
+}
+//# sourceMappingURL=envelope.js.map

package/dist/src/v2/cognitive-attestation/envelope.js.map

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

package/dist/src/v2/cognitive-attestation/index.d.ts

@@ -0,0 +1,6 @@
+export type { CognitiveAttestation, ModelRef, DictionaryRef, TokenRange, FeatureActivation, AggregationPolicy, Signature, SignerRole, ExecutionEnvironment, Precision, AttachmentPoint, SAEType, ActivationStatistic, CompletenessClaim, TiebreakerRule, BuildAttestationInput, } from './types.js';
+export { buildAttestation, canonicalizeAttestation, signAttestation, cognitiveAttestationDigest, sortFeatureActivations, validateAttestationShape, } from './envelope.js';
+export { verifySignature, verifyRequiredSignerRoles, verifyAgainstRegistry, verifyByReplay, } from './verify.js';
+export type { RequiredRoleCoverage, RegistryResolver, RegistryVerificationResult, ReplayBackend, ReplayVerificationResult, } from './verify.js';
+export type { ThresholdDispute, ExclusionDispute, ComputationalDispute, DecompositionAdequacyDispute, FacetedReinterpretationDispute, InterpretiveDispute, Dispute, } from './disputes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/v2/cognitive-attestation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/v2/cognitive-attestation/index.ts"],"names":[],"mappings":"AAqBA,YAAY,EACV,oBAAoB,EACpB,QAAQ,EACR,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,oBAAoB,EACpB,SAAS,EACT,eAAe,EACf,OAAO,EACP,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,GACtB,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,qBAAqB,EACrB,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,0BAA0B,EAC1B,aAAa,EACb,wBAAwB,GACzB,MAAM,aAAa,CAAA;AAGpB,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,EAC5B,8BAA8B,EAC9B,mBAAmB,EACnB,OAAO,GACR,MAAM,eAAe,CAAA"}

package/dist/src/v2/cognitive-attestation/index.js

@@ -0,0 +1,23 @@
+// Copyright 2024-2026 Tymofii Pidlisnyi. Apache-2.0 license. See LICENSE.
+// ══════════════════════════════════════════════════════════════════
+// Cognitive Attestation — public surface
+// ══════════════════════════════════════════════════════════════════
+// Paper: "Cognitive Attestation — signed declarations of feature-level
+//        model computation for accountable AI"
+// Zenodo DOI: 10.5281/zenodo.19646276
+// Normative schema: papers/paper-4/poc/schema/cognitive_attestation.schema.json
+//
+// SDK scope: envelope construction, JCS canonicalization, Ed25519 signing,
+//            Stage 1 (cryptographic) verification, Stage 2 (registry)
+//            interface, Stage 3 (replay) stub, typed dispute primitives.
+//
+// Out of scope for the SDK: dispute resolution, re-verification scheduling,
+//                           cross-tenant correlation, transparency-log
+//                           publishing, bulk compliance reports. All of
+//                           those are product intelligence and live in
+//                           the private `@aeoess/gateway` module.
+// ══════════════════════════════════════════════════════════════════
+export { buildAttestation, canonicalizeAttestation, signAttestation, cognitiveAttestationDigest, sortFeatureActivations, validateAttestationShape, } from './envelope.js';
+// Three-stage verification
+export { verifySignature, verifyRequiredSignerRoles, verifyAgainstRegistry, verifyByReplay, } from './verify.js';
+//# sourceMappingURL=index.js.map

package/dist/src/v2/cognitive-attestation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v2/cognitive-attestation/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qEAAqE;AACrE,yCAAyC;AACzC,qEAAqE;AACrE,uEAAuE;AACvE,+CAA+C;AAC/C,sCAAsC;AACtC,gFAAgF;AAChF,EAAE;AACF,2EAA2E;AAC3E,sEAAsE;AACtE,yEAAyE;AACzE,EAAE;AACF,4EAA4E;AAC5E,uEAAuE;AACvE,wEAAwE;AACxE,uEAAuE;AACvE,kEAAkE;AAClE,qEAAqE;AAsBrE,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,eAAe,CAAA;AAEtB,2BAA2B;AAC3B,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,qBAAqB,EACrB,cAAc,GACf,MAAM,aAAa,CAAA"}

package/dist/src/v2/cognitive-attestation/types.d.ts

@@ -0,0 +1,111 @@
+export type Precision = 'fp32' | 'fp16' | 'bf16' | 'int8';
+export type AttachmentPoint = 'residual_stream' | 'attention_output' | 'mlp_output';
+export type SAEType = 'standard' | 'topk' | 'jumprelu' | 'gated' | 'batchtopk';
+export type ActivationStatistic = 'max' | 'mean' | 'sum' | 'integral' | 'last';
+export type CompletenessClaim = 'top_k_only' | 'all_above_threshold' | 'dictionary_exhaustive';
+export type TiebreakerRule = 'lowest_feature_id' | 'highest_feature_id';
+export type SignerRole = 'agent' | 'operator' | 'provider' | 'third_party_attester';
+export interface ExecutionEnvironment {
+    /** e.g. `nvidia/hopper/h100-sxm5` or `apple-silicon/m-series/m3-max` */
+    hardware_family: string;
+    precision: Precision;
+    /** `library@version` format, e.g. `vllm@0.6.3`. */
+    inference_engine: string;
+    deterministic_mode: boolean;
+}
+export interface ModelRef {
+    model_id: string;
+    /** sha256 hex, 64 lowercase chars. */
+    model_version_hash: string;
+    /** sha256 hex, 64 lowercase chars. */
+    tokenizer_version_hash: string;
+    inference_provider: string | null;
+    execution_environment: ExecutionEnvironment;
+}
+export interface DictionaryRef {
+    dictionary_id: string;
+    /** sha256 hex, 64 lowercase chars. */
+    dictionary_version_hash: string;
+    /** sha256 hex, 64 lowercase chars, or null. */
+    training_corpus_hash: string | null;
+    layer_index: number;
+    attachment_point: AttachmentPoint;
+    sae_type: SAEType;
+}
+export interface TokenRange {
+    /** sha256 of uint32-big-endian token IDs from BOS through end-of-range, no separators. */
+    absolute_sequence_hash: string;
+    /** sha256 of tokens preceding the attested range, or null. NOT a KV-cache hash. */
+    prior_state_hash: string | null;
+    start_token_index: number;
+    end_token_index: number;
+    token_count: number;
+}
+export interface FeatureActivation {
+    feature_id: number;
+    feature_label: string | null;
+    activation_statistic: ActivationStatistic;
+    activation_value: number;
+    tokens_active: number;
+}
+/**
+ * Aggregation policy. Note: `attestation_epsilon` and `required_signer_roles`
+ * are REQUIRED per the normative schema. The Python reference's smoke test
+ * omitted them — this TS type makes that omission a compile error.
+ */
+export interface AggregationPolicy {
+    top_k: number | null;
+    threshold: number | null;
+    /** Governance-relevant "effectively zero" threshold. Must be > 0. */
+    attestation_epsilon: number;
+    /** sha256 hex of the allowlist, or null. */
+    feature_allowlist_hash: string | null;
+    completeness_claim: CompletenessClaim;
+    tiebreaker_rule: TiebreakerRule;
+    /** At least one role. Verifiers MUST confirm every listed role is signed by someone. */
+    required_signer_roles: SignerRole[];
+}
+export interface Signature {
+    signer_did: string;
+    signer_role: SignerRole;
+    /** base64-encoded Ed25519 signature over JCS-canonicalized payload with signatures=[] elided. */
+    signature: string;
+}
+export interface CognitiveAttestation {
+    spec_version: '1.0';
+    model_ref: ModelRef;
+    dictionary_ref: DictionaryRef;
+    token_range: TokenRange;
+    feature_activations: FeatureActivation[];
+    aggregation_policy: AggregationPolicy;
+    signatures: Signature[];
+    /** ISO 8601 UTC timestamp. */
+    attestation_timestamp: string;
+}
+/** Input to `buildAttestation`. Flat shape matches the Python reference. */
+export interface BuildAttestationInput {
+    model_id: string;
+    model_version_hash: string;
+    tokenizer_version_hash: string;
+    inference_provider: string | null;
+    hardware_family: string;
+    precision: Precision;
+    inference_engine: string;
+    deterministic_mode: boolean;
+    dictionary_id: string;
+    dictionary_version_hash: string;
+    training_corpus_hash: string | null;
+    layer_index: number;
+    attachment_point: AttachmentPoint;
+    sae_type: SAEType;
+    absolute_sequence_hash: string;
+    prior_state_hash: string | null;
+    start_token_index: number;
+    end_token_index: number;
+    token_count: number;
+    feature_activations: FeatureActivation[];
+    aggregation_policy: AggregationPolicy;
+    /** Override for deterministic fixtures. Defaults to `new Date().toISOString()`. */
+    timestamp?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/v2/cognitive-attestation/types.d.ts.map

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

package/dist/src/v2/cognitive-attestation/types.js

@@ -0,0 +1,13 @@
+// Copyright 2024-2026 Tymofii Pidlisnyi. Apache-2.0 license. See LICENSE.
+// ══════════════════════════════════════════════════════════════════
+// Cognitive Attestation — TypeScript types mirroring the normative schema
+// ══════════════════════════════════════════════════════════════════
+// Source of truth: papers/paper-4/poc/schema/cognitive_attestation.schema.json
+// Paper: "Cognitive Attestation" — Zenodo DOI 10.5281/zenodo.19646276
+//
+// Every nullable field in the JSON schema is expressed as `T | null` here so
+// that JCS canonicalization preserves null (RFC 8785 requirement, and the
+// cross-language compatibility contract with the Python reference impl).
+// ══════════════════════════════════════════════════════════════════
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/v2/cognitive-attestation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/v2/cognitive-attestation/types.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qEAAqE;AACrE,0EAA0E;AAC1E,qEAAqE;AACrE,+EAA+E;AAC/E,sEAAsE;AACtE,EAAE;AACF,6EAA6E;AAC7E,0EAA0E;AAC1E,yEAAyE;AACzE,qEAAqE"}