@godman-protocols/soul 0.2.0 → 0.3.0

package/dist/engine.d.ts

@@ -1,46 +1,124 @@
 /**
- * SOUL — Constitutional Constraints and Safety
- * Core engine: constitution creation, evaluation, kill switches, audit
- * @version 0.2.0
+ * SOUL — Sovereign Open Universal Layer
+ * "One layer. Every chain. Every model. SOUL."
  *
- * SOUL is the lowest protocol layer. No other protocol overrides it.
- * Kill switches are non-negotiable and cannot be delegated away.
+ * Core engine: SoulValidator, SoulPublisher, SoulVerifier,
+ * parseSoulMd(), generateSoulMd().
+ *
+ * @version 0.3.0
  */
-import type { AgentId, AuditEntry, Constraint, Constitution, EvaluationResult, KillSwitch, Timestamp } from './types.js';
+import type { ERC8004Anchor, SHA256Hash, SoulDocument, SoulPublisherConfig, SoulValidationResult, SoulVerificationResult } from './types.js';
 /**
- * Create a Constitution document.
- * Must be signed by the operator before use.
+ * Compute SHA-256 hex digest of a string.
  */
-export declare function createConstitution(operatorId: string, constraints: Omit<Constraint, 'id'>[], killSwitches: Omit<KillSwitch, 'id' | 'nonNegotiable'>[], options?: {
-    issuedAt?: Timestamp;
-}): Omit<Constitution, 'signature'> & {
-    signature: '';
-};
+export declare function sha256(content: string): SHA256Hash;
 /**
- * Sign a constitution with the operator's secret.
+ * Parse a SOUL.md markdown string into a SoulDocument.
+ *
+ * Expected format:
+ * ```
+ * # SOUL — <agent_name>
+ *
+ * ## Who We Are
+ * <content>
+ *
+ * ## Why We Exist
+ * <content>
+ * ...
+ * ```
+ *
+ * Metadata (agent_did, created_at, etc.) can be provided via `defaults`
+ * since they are not typically present in the markdown itself.
  */
-export declare function signConstitution(constitution: Constitution, operatorSecret: string): Constitution;
+export declare function parseSoulMd(markdown: string, defaults?: {
+    agent_did?: string;
+    created_at?: string;
+    updated_at?: string;
+    erc8004_anchor?: ERC8004Anchor;
+}): SoulDocument;
 /**
- * Evaluate an action against the constitution.
+ * Generate a SOUL.md markdown string from a SoulDocument.
  *
- * Matching order:
- * 1. Check 'deny' constraints first (deny wins over allow)
- * 2. Check 'require' constraints (must have a matching allow)
- * 3. Check 'allow' constraints
- * 4. Default: deny (constitutional principle — deny by default)
+ * Output format:
+ * ```
+ * # SOUL — <agent_name>
+ *
+ * ## Who We Are
+ * <content>
+ * ...
+ * ```
+ */
+export declare function generateSoulMd(doc: SoulDocument): string;
+/**
+ * Validates SoulDocument instances against the SOUL format specification.
  */
-export declare function evaluateAction(constitution: Constitution, agentId: AgentId, action: string): EvaluationResult;
+export declare class SoulValidator {
+    /**
+     * Validate a SoulDocument for completeness and format compliance.
+     */
+    validate(doc: SoulDocument): SoulValidationResult;
+    /**
+     * Validate a SOUL.md markdown string by parsing it first.
+     */
+    validateMarkdown(markdown: string): SoulValidationResult;
+}
 /**
- * Check kill switch conditions against context.
- * Context is a key-value map of runtime metrics.
+ * Publishes a SoulDocument as a SOUL.md endpoint.
  *
- * Trigger condition format: "key operator value"
- * Supported operators: >, <, >=, <=, ==, !=
- * Example: "views_per_30_posts < 500", "memory_gb > 22"
+ * In v0.3.0 this is a lightweight utility that generates the markdown
+ * and computes the hash. Full HTTP server implementation is deferred
+ * to v0.4.0 (requires server/client packages).
  */
-export declare function checkKillSwitches(constitution: Constitution, context: Record<string, number | string | boolean>): KillSwitch | null;
+export declare class SoulPublisher {
+    private document;
+    private config;
+    constructor(doc: SoulDocument, config?: SoulPublisherConfig);
+    /**
+     * Generate the SOUL.md markdown content for publishing.
+     */
+    getMarkdown(): string;
+    /**
+     * Compute the SHA-256 hash of the generated SOUL.md content.
+     * This is the value that should be anchored on-chain via ERC-8004.
+     */
+    getHash(): SHA256Hash;
+    /**
+     * Get the full endpoint path where SOUL.md would be served.
+     */
+    getEndpoint(): string;
+    /**
+     * Get the publisher configuration.
+     */
+    getConfig(): Required<SoulPublisherConfig>;
+    /**
+     * Build the ERC-8004 anchor metadata for this published SOUL.md.
+     */
+    buildAnchor(params: {
+        token_id: string;
+        chain_id: number;
+        contract_address: string;
+    }): ERC8004Anchor;
+}
 /**
- * Create an audit entry from an evaluation result.
+ * Verifies that a SOUL.md content matches its on-chain ERC-8004 anchor.
+ *
+ * In v0.3.0 this provides local hash verification. On-chain fetch
+ * (via ethers/viem) is deferred to v0.4.0 server package.
  */
-export declare function createAudit(agentId: AgentId, action: string, evaluation: EvaluationResult): AuditEntry;
+export declare class SoulVerifier {
+    /**
+     * Verify a SOUL.md markdown string against an expected SHA-256 hash.
+     */
+    verify(markdown: string, expectedHash: SHA256Hash): SoulVerificationResult;
+    /**
+     * Verify a SoulDocument against its own ERC-8004 anchor.
+     * Returns unverified if no anchor is present.
+     */
+    verifyDocument(doc: SoulDocument): SoulVerificationResult;
+    /**
+     * Compute the SHA-256 hash of a SOUL.md markdown string.
+     * Utility method for pre-anchoring verification.
+     */
+    computeHash(markdown: string): SHA256Hash;
+}
 //# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,UAAU,EAEV,YAAY,EAEZ,gBAAgB,EAChB,UAAU,EACV,SAAS,EACV,MAAM,YAAY,CAAC;AAMpB;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,EACrC,YAAY,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,eAAe,CAAC,EAAE,EACxD,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAO,GACrC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,GAAG;IAAE,SAAS,EAAE,EAAE,CAAA;CAAE,CAarD;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,MAAM,GACrB,YAAY,CAYd;AA2BD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GACb,gBAAgB,CAqClB;AAMD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACjD,UAAU,GAAG,IAAI,CAsBnB;AAMD;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,gBAAgB,GAC3B,UAAU,CAQZ"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,YAAY,EACZ,mBAAmB,EAGnB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAWpB;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAElD;AAyBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE;IACT,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,aAAa,CAAC;CAChC,GACA,YAAY,CAgFd;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAmBxD;AAMD;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,oBAAoB;IA4EjD;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB;CAIzD;AAMD;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,MAAM,CAAgC;gBAElC,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,mBAAmB;IAS3D;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;;OAGG;IACH,OAAO,IAAI,UAAU;IAIrB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,mBAAmB,CAAC;IAI1C;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,GAAG,aAAa;CAQlB;AAMD;;;;;GAKG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,GAAG,sBAAsB;IAc1E;;;OAGG;IACH,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,sBAAsB;IAgBzD;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU;CAG1C"}

package/dist/engine.js

@@ -1,182 +1,351 @@
 /**
- * SOUL — Constitutional Constraints and Safety
- * Core engine: constitution creation, evaluation, kill switches, audit
- * @version 0.2.0
+ * SOUL — Sovereign Open Universal Layer
+ * "One layer. Every chain. Every model. SOUL."
  *
- * SOUL is the lowest protocol layer. No other protocol overrides it.
- * Kill switches are non-negotiable and cannot be delegated away.
+ * Core engine: SoulValidator, SoulPublisher, SoulVerifier,
+ * parseSoulMd(), generateSoulMd().
+ *
+ * @version 0.3.0
  */
-import { createHmac, randomUUID } from 'node:crypto';
+import { createHash } from 'node:crypto';
+import { REQUIRED_SECTION_KEYS, SOUL_SECTION_TITLES, } from './types.js';
 // ---------------------------------------------------------------------------
-// Constitution creation
+// SHA-256 utility
 // ---------------------------------------------------------------------------
 /**
- * Create a Constitution document.
- * Must be signed by the operator before use.
+ * Compute SHA-256 hex digest of a string.
  */
-export function createConstitution(operatorId, constraints, killSwitches, options = {}) {
-    return {
-        version: '0.1',
-        operatorId,
-        issuedAt: options.issuedAt ?? new Date().toISOString(),
-        constraints: constraints.map((c) => ({ ...c, id: randomUUID() })),
-        killSwitches: killSwitches.map((k) => ({
-            ...k,
-            id: randomUUID(),
-            nonNegotiable: true,
-        })),
-        signature: '',
-    };
+export function sha256(content) {
+    return createHash('sha256').update(content, 'utf8').digest('hex');
 }
 // ---------------------------------------------------------------------------
-// Signing
+// Section key <-> title mapping
 // ---------------------------------------------------------------------------
+/** Map from human-readable title to section key */
+const TITLE_TO_KEY = new Map(Object.entries(SOUL_SECTION_TITLES).map(([key, title]) => [title, key]));
 /**
- * Sign a constitution with the operator's secret.
+ * Normalise a heading string to match against known section titles.
+ * Strips leading '#' characters, trims whitespace.
  */
-export function signConstitution(constitution, operatorSecret) {
-    const payload = JSON.stringify({
-        version: constitution.version,
-        operatorId: constitution.operatorId,
-        issuedAt: constitution.issuedAt,
-        constraintCount: constitution.constraints.length,
-        killSwitchCount: constitution.killSwitches.length,
-    });
-    const signature = createHmac('sha256', operatorSecret)
-        .update(payload, 'utf8')
-        .digest('hex');
-    return { ...constitution, signature };
+function normaliseHeading(raw) {
+    return raw.replace(/^#+\s*/, '').trim();
 }
 // ---------------------------------------------------------------------------
-// Scope matching
+// parseSoulMd — parse SOUL.md markdown into SoulDocument
 // ---------------------------------------------------------------------------
 /**
- * Match an action string against a scope pattern.
- * Supports:
- * - Exact match: 'read:workspace/scs001'
- * - Wildcard: 'read:*', '*:workspace/*', '*'
- * - Prefix: 'read:workspace/*' matches 'read:workspace/scs001/file.ts'
+ * Parse a SOUL.md markdown string into a SoulDocument.
+ *
+ * Expected format:
+ * ```
+ * # SOUL — <agent_name>
+ *
+ * ## Who We Are
+ * <content>
+ *
+ * ## Why We Exist
+ * <content>
+ * ...
+ * ```
+ *
+ * Metadata (agent_did, created_at, etc.) can be provided via `defaults`
+ * since they are not typically present in the markdown itself.
  */
-function scopeMatches(pattern, action) {
-    if (pattern === '*')
-        return true;
-    if (pattern === action)
-        return true;
-    if (pattern.endsWith('*')) {
-        const prefix = pattern.slice(0, -1);
-        return action.startsWith(prefix);
-    }
-    return false;
+export function parseSoulMd(markdown, defaults) {
+    const lines = markdown.split('\n');
+    // Extract agent name from first H1 heading
+    let agentName = 'Unknown Agent';
+    const h1Match = lines.find((l) => /^#\s+/.test(l) && !/^##/.test(l));
+    if (h1Match) {
+        const cleaned = normaliseHeading(h1Match);
+        // Strip "SOUL — " or "SOUL - " prefix if present
+        agentName = cleaned.replace(/^SOUL\s*[—\-]\s*/, '').trim() || agentName;
+    }
+    // Split into sections by ## headings
+    const sections = [];
+    let currentTitle = null;
+    let currentLines = [];
+    for (const line of lines) {
+        if (/^##\s+/.test(line)) {
+            // Save previous section
+            if (currentTitle !== null) {
+                sections.push({
+                    title: currentTitle,
+                    content: currentLines.join('\n').trim(),
+                });
+            }
+            currentTitle = normaliseHeading(line);
+            currentLines = [];
+        }
+        else if (currentTitle !== null) {
+            currentLines.push(line);
+        }
+    }
+    // Save last section
+    if (currentTitle !== null) {
+        sections.push({
+            title: currentTitle,
+            content: currentLines.join('\n').trim(),
+        });
+    }
+    // Build section map
+    const sectionMap = new Map();
+    for (const section of sections) {
+        const key = TITLE_TO_KEY.get(section.title);
+        if (key) {
+            sectionMap.set(key, {
+                title: section.title,
+                content: section.content,
+                immutable: key === 'what_we_will_never_do' || key === 'constitutional_foundation',
+            });
+        }
+    }
+    // Fill missing sections with empty placeholders
+    const now = new Date().toISOString();
+    const buildSection = (key) => {
+        return sectionMap.get(key) ?? {
+            title: SOUL_SECTION_TITLES[key],
+            content: '',
+            immutable: key === 'what_we_will_never_do' || key === 'constitutional_foundation',
+        };
+    };
+    return {
+        soul_version: '1.0',
+        agent_name: agentName,
+        agent_did: defaults?.agent_did ?? '',
+        created_at: defaults?.created_at ?? now,
+        updated_at: defaults?.updated_at ?? now,
+        who_we_are: buildSection('who_we_are'),
+        why_we_exist: buildSection('why_we_exist'),
+        what_we_believe: buildSection('what_we_believe'),
+        what_we_will_never_do: buildSection('what_we_will_never_do'),
+        what_we_owe_the_world: buildSection('what_we_owe_the_world'),
+        what_we_owe_each_other: buildSection('what_we_owe_each_other'),
+        founding_intention: buildSection('founding_intention'),
+        self_committed_swarms: buildSection('self_committed_swarms'),
+        constitutional_foundation: buildSection('constitutional_foundation'),
+        erc8004_anchor: defaults?.erc8004_anchor,
+    };
 }
 // ---------------------------------------------------------------------------
-// Evaluation
+// generateSoulMd — generate SOUL.md markdown from SoulDocument
 // ---------------------------------------------------------------------------
 /**
- * Evaluate an action against the constitution.
+ * Generate a SOUL.md markdown string from a SoulDocument.
  *
- * Matching order:
- * 1. Check 'deny' constraints first (deny wins over allow)
- * 2. Check 'require' constraints (must have a matching allow)
- * 3. Check 'allow' constraints
- * 4. Default: deny (constitutional principle — deny by default)
+ * Output format:
+ * ```
+ * # SOUL — <agent_name>
+ *
+ * ## Who We Are
+ * <content>
+ * ...
+ * ```
  */
-export function evaluateAction(constitution, agentId, action) {
-    const now = new Date().toISOString();
-    // Check deny constraints first
-    for (const c of constitution.constraints) {
-        if (c.action === 'deny' && scopeMatches(c.scope, action)) {
-            return {
-                allowed: false,
-                constraintId: c.id,
-                enforcementLevel: c.enforcementLevel,
-                reason: `Denied by constraint '${c.name}': ${c.description}`,
-                evaluatedAt: now,
-            };
+export function generateSoulMd(doc) {
+    const parts = [];
+    // Title
+    parts.push(`# SOUL — ${doc.agent_name}`);
+    parts.push('');
+    // Each section in canonical order
+    for (const key of REQUIRED_SECTION_KEYS) {
+        const section = doc[key];
+        parts.push(`## ${section.title}`);
+        parts.push('');
+        if (section.content) {
+            parts.push(section.content);
+            parts.push('');
         }
     }
-    // Check allow constraints
-    for (const c of constitution.constraints) {
-        if (c.action === 'allow' && scopeMatches(c.scope, action)) {
-            return {
-                allowed: true,
-                constraintId: c.id,
-                enforcementLevel: c.enforcementLevel,
-                reason: `Allowed by constraint '${c.name}'`,
-                evaluatedAt: now,
-            };
+    return parts.join('\n').trimEnd() + '\n';
+}
+// ---------------------------------------------------------------------------
+// SoulValidator — validates required sections and format compliance
+// ---------------------------------------------------------------------------
+/**
+ * Validates SoulDocument instances against the SOUL format specification.
+ */
+export class SoulValidator {
+    /**
+     * Validate a SoulDocument for completeness and format compliance.
+     */
+    validate(doc) {
+        const errors = [];
+        const warnings = [];
+        // Check version
+        if (doc.soul_version !== '1.0') {
+            errors.push(`Invalid soul_version: expected "1.0", got "${doc.soul_version}"`);
+        }
+        // Check agent metadata
+        if (!doc.agent_name || doc.agent_name.trim().length === 0) {
+            errors.push('agent_name is required and must not be empty');
+        }
+        if (!doc.agent_did || doc.agent_did.trim().length === 0) {
+            warnings.push('agent_did is empty — on-chain anchoring requires a DID');
+        }
+        if (!doc.created_at) {
+            errors.push('created_at timestamp is required');
+        }
+        if (!doc.updated_at) {
+            errors.push('updated_at timestamp is required');
+        }
+        // Check all 9 required sections exist and have content
+        for (const key of REQUIRED_SECTION_KEYS) {
+            const section = doc[key];
+            if (!section) {
+                errors.push(`Missing required section: ${SOUL_SECTION_TITLES[key]} (${key})`);
+                continue;
+            }
+            if (!section.title || section.title.trim().length === 0) {
+                errors.push(`Section "${key}" has empty title`);
+            }
+            if (!section.content || section.content.trim().length === 0) {
+                warnings.push(`Section "${key}" (${section.title}) has no content`);
+            }
+        }
+        // Validate immutability flags on key sections
+        if (doc.what_we_will_never_do && !doc.what_we_will_never_do.immutable) {
+            warnings.push('"What We Will Never Do" section should be marked immutable');
         }
+        if (doc.constitutional_foundation && !doc.constitutional_foundation.immutable) {
+            warnings.push('"Constitutional Foundation" section should be marked immutable');
+        }
+        // Validate ERC-8004 anchor if present
+        if (doc.erc8004_anchor) {
+            const anchor = doc.erc8004_anchor;
+            if (!anchor.token_id) {
+                errors.push('ERC-8004 anchor: token_id is required');
+            }
+            if (!anchor.soul_hash) {
+                errors.push('ERC-8004 anchor: soul_hash is required');
+            }
+            if (!anchor.chain_id) {
+                errors.push('ERC-8004 anchor: chain_id is required');
+            }
+            if (!anchor.contract_address) {
+                errors.push('ERC-8004 anchor: contract_address is required');
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Validate a SOUL.md markdown string by parsing it first.
+     */
+    validateMarkdown(markdown) {
+        const doc = parseSoulMd(markdown);
+        return this.validate(doc);
     }
-    // Default deny
-    return {
-        allowed: false,
-        constraintId: null,
-        enforcementLevel: 'hard',
-        reason: 'No matching allow constraint — denied by default (constitutional principle)',
-        evaluatedAt: now,
-    };
 }
 // ---------------------------------------------------------------------------
-// Kill switches
+// SoulPublisher — hosts SOUL.md at /.well-known/soul.md
 // ---------------------------------------------------------------------------
 /**
- * Check kill switch conditions against context.
- * Context is a key-value map of runtime metrics.
+ * Publishes a SoulDocument as a SOUL.md endpoint.
  *
- * Trigger condition format: "key operator value"
- * Supported operators: >, <, >=, <=, ==, !=
- * Example: "views_per_30_posts < 500", "memory_gb > 22"
+ * In v0.3.0 this is a lightweight utility that generates the markdown
+ * and computes the hash. Full HTTP server implementation is deferred
+ * to v0.4.0 (requires server/client packages).
  */
-export function checkKillSwitches(constitution, context) {
-    for (const ks of constitution.killSwitches) {
-        const parts = ks.triggerCondition.split(/\s+/);
-        if (parts.length !== 3)
-            continue;
-        const [key, op, rawVal] = parts;
-        if (!(key in context))
-            continue;
-        const actual = Number(context[key]);
-        const threshold = Number(rawVal);
-        if (isNaN(actual) || isNaN(threshold))
-            continue;
-        let triggered = false;
-        switch (op) {
-            case '>':
-                triggered = actual > threshold;
-                break;
-            case '<':
-                triggered = actual < threshold;
-                break;
-            case '>=':
-                triggered = actual >= threshold;
-                break;
-            case '<=':
-                triggered = actual <= threshold;
-                break;
-            case '==':
-                triggered = actual === threshold;
-                break;
-            case '!=':
-                triggered = actual !== threshold;
-                break;
-        }
-        if (triggered)
-            return ks;
+export class SoulPublisher {
+    document;
+    config;
+    constructor(doc, config) {
+        this.document = doc;
+        this.config = {
+            port: config?.port ?? 3000,
+            hostname: config?.hostname ?? '0.0.0.0',
+            path: config?.path ?? '/.well-known/soul.md',
+        };
+    }
+    /**
+     * Generate the SOUL.md markdown content for publishing.
+     */
+    getMarkdown() {
+        return generateSoulMd(this.document);
+    }
+    /**
+     * Compute the SHA-256 hash of the generated SOUL.md content.
+     * This is the value that should be anchored on-chain via ERC-8004.
+     */
+    getHash() {
+        return sha256(this.getMarkdown());
+    }
+    /**
+     * Get the full endpoint path where SOUL.md would be served.
+     */
+    getEndpoint() {
+        return this.config.path;
+    }
+    /**
+     * Get the publisher configuration.
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Build the ERC-8004 anchor metadata for this published SOUL.md.
+     */
+    buildAnchor(params) {
+        return {
+            token_id: params.token_id,
+            soul_hash: this.getHash(),
+            chain_id: params.chain_id,
+            contract_address: params.contract_address,
+        };
     }
-    return null;
 }
 // ---------------------------------------------------------------------------
-// Audit
+// SoulVerifier — fetch SOUL.md + verify SHA-256 hash matches on-chain
 // ---------------------------------------------------------------------------
 /**
- * Create an audit entry from an evaluation result.
+ * Verifies that a SOUL.md content matches its on-chain ERC-8004 anchor.
+ *
+ * In v0.3.0 this provides local hash verification. On-chain fetch
+ * (via ethers/viem) is deferred to v0.4.0 server package.
  */
-export function createAudit(agentId, action, evaluation) {
-    return {
-        id: randomUUID(),
-        agentId,
-        action,
-        evaluation,
-        timestamp: evaluation.evaluatedAt,
-    };
+export class SoulVerifier {
+    /**
+     * Verify a SOUL.md markdown string against an expected SHA-256 hash.
+     */
+    verify(markdown, expectedHash) {
+        const computedHash = sha256(markdown);
+        const matches = computedHash === expectedHash;
+        return {
+            verified: matches,
+            computed_hash: computedHash,
+            on_chain_hash: expectedHash,
+            reason: matches
+                ? 'SOUL.md hash matches on-chain ERC-8004 anchor'
+                : `Hash mismatch: computed ${computedHash} !== on-chain ${expectedHash}`,
+        };
+    }
+    /**
+     * Verify a SoulDocument against its own ERC-8004 anchor.
+     * Returns unverified if no anchor is present.
+     */
+    verifyDocument(doc) {
+        const markdown = generateSoulMd(doc);
+        const computedHash = sha256(markdown);
+        if (!doc.erc8004_anchor) {
+            return {
+                verified: false,
+                computed_hash: computedHash,
+                on_chain_hash: null,
+                reason: 'No ERC-8004 anchor present — cannot verify on-chain',
+            };
+        }
+        return this.verify(markdown, doc.erc8004_anchor.soul_hash);
+    }
+    /**
+     * Compute the SHA-256 hash of a SOUL.md markdown string.
+     * Utility method for pre-anchoring verification.
+     */
+    computeHash(markdown) {
+        return sha256(markdown);
+    }
 }
 //# sourceMappingURL=engine.js.map