@peac/capture-core 0.10.7

package/dist/mapper.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * @peac/capture-core - Evidence Mapper
+ *
+ * Transforms SpoolEntry into InteractionEvidenceV01.
+ * This is a pure transformation with no side effects.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toInteractionEvidence = toInteractionEvidence;
+exports.toInteractionEvidenceBatch = toInteractionEvidenceBatch;
+// =============================================================================
+// Pure Transformation Functions
+// =============================================================================
+/**
+ * Build executor from action.
+ */
+function buildExecutor(action) {
+    const executor = {
+        platform: action.platform,
+    };
+    if (action.platform_version) {
+        executor.version = action.platform_version;
+    }
+    if (action.plugin_id) {
+        executor.plugin_id = action.plugin_id;
+    }
+    return executor;
+}
+/**
+ * Build tool target from action (if applicable).
+ */
+function buildToolTarget(action) {
+    if (!action.tool_name) {
+        return undefined;
+    }
+    const tool = {
+        name: action.tool_name,
+    };
+    if (action.tool_provider) {
+        tool.provider = action.tool_provider;
+    }
+    return tool;
+}
+/**
+ * Build resource target from action (if applicable).
+ */
+function buildResourceTarget(action) {
+    if (!action.resource_uri && !action.resource_method) {
+        return undefined;
+    }
+    const resource = {};
+    if (action.resource_uri) {
+        resource.uri = action.resource_uri;
+    }
+    if (action.resource_method) {
+        resource.method = action.resource_method;
+    }
+    return resource;
+}
+/**
+ * Build payload reference from digest.
+ */
+function buildPayloadRef(digest, redaction) {
+    if (!digest) {
+        return undefined;
+    }
+    return {
+        digest,
+        redaction,
+    };
+}
+/**
+ * Build result from action.
+ */
+function buildResult(action) {
+    if (!action.status) {
+        return undefined;
+    }
+    const result = {
+        status: action.status,
+    };
+    if (action.error_code) {
+        result.error_code = action.error_code;
+    }
+    if (action.retryable !== undefined) {
+        result.retryable = action.retryable;
+    }
+    return result;
+}
+/**
+ * Build policy context from action.
+ */
+function buildPolicyContext(action) {
+    if (!action.policy) {
+        return undefined;
+    }
+    const policy = {
+        decision: action.policy.decision,
+    };
+    if (action.policy.sandbox_enabled !== undefined) {
+        policy.sandbox_enabled = action.policy.sandbox_enabled;
+    }
+    if (action.policy.elevated !== undefined) {
+        policy.elevated = action.policy.elevated;
+    }
+    // Note: effective_policy_digest would require converting the string to Digest
+    // This is left for the adapter to handle if needed
+    return policy;
+}
+// =============================================================================
+// Main Mapper
+// =============================================================================
+/**
+ * Convert a SpoolEntry to InteractionEvidenceV01.
+ *
+ * This is a pure, deterministic transformation.
+ * The same SpoolEntry will always produce the same InteractionEvidence.
+ */
+function toInteractionEvidence(entry, options = {}) {
+    const { defaultRedaction = 'hash_only', includeSpoolAnchor = false } = options;
+    const { action } = entry;
+    // Build the evidence object
+    const evidence = {
+        interaction_id: action.id,
+        kind: action.kind,
+        executor: buildExecutor(action),
+        started_at: action.started_at,
+    };
+    // Optional tool target
+    const tool = buildToolTarget(action);
+    if (tool) {
+        evidence.tool = tool;
+    }
+    // Optional resource target
+    const resource = buildResourceTarget(action);
+    if (resource) {
+        evidence.resource = resource;
+    }
+    // Optional input payload reference
+    const input = buildPayloadRef(entry.input_digest, defaultRedaction);
+    if (input) {
+        evidence.input = input;
+    }
+    // Optional output payload reference
+    const output = buildPayloadRef(entry.output_digest, defaultRedaction);
+    if (output) {
+        evidence.output = output;
+    }
+    // Optional completed_at
+    if (action.completed_at) {
+        evidence.completed_at = action.completed_at;
+    }
+    // Optional duration
+    if (action.duration_ms !== undefined) {
+        evidence.duration_ms = action.duration_ms;
+    }
+    // Optional result
+    const result = buildResult(action);
+    if (result) {
+        evidence.result = result;
+    }
+    // Optional policy context
+    const policy = buildPolicyContext(action);
+    if (policy) {
+        evidence.policy = policy;
+    }
+    // Build extensions
+    const extensions = {};
+    // Add platform-specific metadata if present
+    if (action.metadata && Object.keys(action.metadata).length > 0) {
+        // Check if metadata keys are already properly namespaced
+        // Namespaced keys (e.g., org.openclaw/context) go directly into extensions
+        // Non-namespaced keys go under the generic capture-metadata key
+        const EXTENSION_KEY_PATTERN = /^[a-z0-9-]+\.[a-z0-9-]+\//;
+        const genericMetadata = {};
+        for (const [key, value] of Object.entries(action.metadata)) {
+            if (EXTENSION_KEY_PATTERN.test(key)) {
+                // Already namespaced - add directly to extensions
+                extensions[key] = value;
+            }
+            else {
+                // Not namespaced - collect for generic key
+                genericMetadata[key] = value;
+            }
+        }
+        // Add non-namespaced metadata under generic key
+        if (Object.keys(genericMetadata).length > 0) {
+            extensions['org.peacprotocol/capture-metadata@0.1'] = genericMetadata;
+        }
+    }
+    // Add spool anchor if requested
+    if (includeSpoolAnchor) {
+        const anchor = {
+            spool_head_digest: entry.entry_digest,
+            sequence: entry.sequence,
+            anchored_at: entry.captured_at,
+        };
+        extensions['org.peacprotocol/spool-anchor@0.1'] = anchor;
+    }
+    // Only add extensions if non-empty
+    if (Object.keys(extensions).length > 0) {
+        evidence.extensions = extensions;
+    }
+    return evidence;
+}
+/**
+ * Batch convert SpoolEntries to InteractionEvidence array.
+ */
+function toInteractionEvidenceBatch(entries, options = {}) {
+    return entries.map((entry) => toInteractionEvidence(entry, options));
+}
+//# sourceMappingURL=mapper.js.map

package/dist/mapper.js.map

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

package/dist/memory.d.ts

@@ -0,0 +1,110 @@
+/**
+ * @peac/capture-core - In-Memory Implementations
+ *
+ * Reference implementations for testing and development.
+ * NOT for production use - use @peac/capture-node for durable storage.
+ */
+import type { SpoolStore, SpoolEntry, DedupeIndex, DedupeEntry } from './types';
+/**
+ * In-memory spool store for testing.
+ *
+ * Features:
+ * - Entries stored in array (ordered by sequence)
+ * - commit() is a no-op (no durability)
+ * - Useful for unit tests and development
+ */
+export declare class InMemorySpoolStore implements SpoolStore {
+    private entries;
+    private headDigest;
+    private currentSequence;
+    private closed;
+    /**
+     * Append an entry to the spool.
+     */
+    append(entry: SpoolEntry): Promise<number>;
+    /**
+     * Commit is a no-op for in-memory store.
+     */
+    commit(): Promise<void>;
+    /**
+     * Read entries starting from a sequence number.
+     */
+    read(fromSequence: number, limit?: number): Promise<SpoolEntry[]>;
+    /**
+     * Get the current head digest.
+     */
+    getHeadDigest(): Promise<string>;
+    /**
+     * Get the current sequence number.
+     */
+    getSequence(): Promise<number>;
+    /**
+     * Close the store.
+     */
+    close(): Promise<void>;
+    /**
+     * Check if store is closed.
+     */
+    private assertNotClosed;
+    /**
+     * Get all entries (for testing).
+     */
+    getAllEntries(): SpoolEntry[];
+    /**
+     * Clear all entries (for testing).
+     */
+    clear(): void;
+}
+/**
+ * In-memory dedupe index for testing.
+ *
+ * Features:
+ * - Entries stored in Map
+ * - No persistence
+ * - Returns resolved Promises (async interface, sync implementation)
+ * - Useful for unit tests and development
+ */
+export declare class InMemoryDedupeIndex implements DedupeIndex {
+    private entries;
+    /**
+     * Get entry by action ID.
+     */
+    get(actionId: string): Promise<DedupeEntry | undefined>;
+    /**
+     * Set entry for action ID.
+     */
+    set(actionId: string, entry: DedupeEntry): Promise<void>;
+    /**
+     * Check if action ID exists.
+     */
+    has(actionId: string): Promise<boolean>;
+    /**
+     * Mark an entry as emitted.
+     */
+    markEmitted(actionId: string): Promise<boolean>;
+    /**
+     * Delete entry.
+     */
+    delete(actionId: string): Promise<boolean>;
+    /**
+     * Get count of entries.
+     */
+    size(): Promise<number>;
+    /**
+     * Clear all entries.
+     */
+    clear(): Promise<void>;
+    /**
+     * Get all entries as array (for testing).
+     */
+    getAllEntries(): Array<[string, DedupeEntry]>;
+}
+/**
+ * Create an in-memory spool store.
+ */
+export declare function createInMemorySpoolStore(): InMemorySpoolStore;
+/**
+ * Create an in-memory dedupe index.
+ */
+export declare function createInMemoryDedupeIndex(): InMemoryDedupeIndex;
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAOhF;;;;;;;GAOG;AACH,qBAAa,kBAAmB,YAAW,UAAU;IACnD,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,MAAM,CAAkB;IAEhC;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBhD;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B;;OAEG;IACG,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAavE;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAKtC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAKpC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,aAAa,IAAI,UAAU,EAAE;IAI7B;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd;AAMD;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,OAAO,CAAuC;IAEtD;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAI7D;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7C;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASrD;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACH,aAAa,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAG9C;AAMD;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,mBAAmB,CAE/D"}

package/dist/memory.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * @peac/capture-core - In-Memory Implementations
+ *
+ * Reference implementations for testing and development.
+ * NOT for production use - use @peac/capture-node for durable storage.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryDedupeIndex = exports.InMemorySpoolStore = void 0;
+exports.createInMemorySpoolStore = createInMemorySpoolStore;
+exports.createInMemoryDedupeIndex = createInMemoryDedupeIndex;
+const types_1 = require("./types");
+// =============================================================================
+// In-Memory Spool Store
+// =============================================================================
+/**
+ * In-memory spool store for testing.
+ *
+ * Features:
+ * - Entries stored in array (ordered by sequence)
+ * - commit() is a no-op (no durability)
+ * - Useful for unit tests and development
+ */
+class InMemorySpoolStore {
+    entries = [];
+    headDigest = types_1.GENESIS_DIGEST;
+    currentSequence = 0;
+    closed = false;
+    /**
+     * Append an entry to the spool.
+     */
+    async append(entry) {
+        this.assertNotClosed();
+        // Validate sequence
+        if (entry.sequence !== this.currentSequence + 1) {
+            throw new Error(`Invalid sequence: expected ${this.currentSequence + 1}, got ${entry.sequence}`);
+        }
+        // Validate chain
+        if (entry.prev_entry_digest !== this.headDigest) {
+            throw new Error(`Invalid chain: expected prev_entry_digest ${this.headDigest}, got ${entry.prev_entry_digest}`);
+        }
+        this.entries.push(entry);
+        this.headDigest = entry.entry_digest;
+        this.currentSequence = entry.sequence;
+        return entry.sequence;
+    }
+    /**
+     * Commit is a no-op for in-memory store.
+     */
+    async commit() {
+        this.assertNotClosed();
+        // No-op for in-memory
+    }
+    /**
+     * Read entries starting from a sequence number.
+     */
+    async read(fromSequence, limit) {
+        this.assertNotClosed();
+        const startIndex = fromSequence > 0 ? fromSequence - 1 : 0;
+        const entries = this.entries.slice(startIndex);
+        if (limit !== undefined && limit > 0) {
+            return entries.slice(0, limit);
+        }
+        return entries;
+    }
+    /**
+     * Get the current head digest.
+     */
+    async getHeadDigest() {
+        this.assertNotClosed();
+        return this.headDigest;
+    }
+    /**
+     * Get the current sequence number.
+     */
+    async getSequence() {
+        this.assertNotClosed();
+        return this.currentSequence;
+    }
+    /**
+     * Close the store.
+     */
+    async close() {
+        this.closed = true;
+    }
+    /**
+     * Check if store is closed.
+     */
+    assertNotClosed() {
+        if (this.closed) {
+            throw new Error('SpoolStore is closed');
+        }
+    }
+    // Test helpers (not part of interface)
+    /**
+     * Get all entries (for testing).
+     */
+    getAllEntries() {
+        return [...this.entries];
+    }
+    /**
+     * Clear all entries (for testing).
+     */
+    clear() {
+        this.entries = [];
+        this.headDigest = types_1.GENESIS_DIGEST;
+        this.currentSequence = 0;
+    }
+}
+exports.InMemorySpoolStore = InMemorySpoolStore;
+// =============================================================================
+// In-Memory Dedupe Index
+// =============================================================================
+/**
+ * In-memory dedupe index for testing.
+ *
+ * Features:
+ * - Entries stored in Map
+ * - No persistence
+ * - Returns resolved Promises (async interface, sync implementation)
+ * - Useful for unit tests and development
+ */
+class InMemoryDedupeIndex {
+    entries = new Map();
+    /**
+     * Get entry by action ID.
+     */
+    async get(actionId) {
+        return this.entries.get(actionId);
+    }
+    /**
+     * Set entry for action ID.
+     */
+    async set(actionId, entry) {
+        this.entries.set(actionId, entry);
+    }
+    /**
+     * Check if action ID exists.
+     */
+    async has(actionId) {
+        return this.entries.has(actionId);
+    }
+    /**
+     * Mark an entry as emitted.
+     */
+    async markEmitted(actionId) {
+        const entry = this.entries.get(actionId);
+        if (!entry) {
+            return false;
+        }
+        entry.emitted = true;
+        return true;
+    }
+    /**
+     * Delete entry.
+     */
+    async delete(actionId) {
+        return this.entries.delete(actionId);
+    }
+    /**
+     * Get count of entries.
+     */
+    async size() {
+        return this.entries.size;
+    }
+    /**
+     * Clear all entries.
+     */
+    async clear() {
+        this.entries.clear();
+    }
+    // Test helpers (not part of interface)
+    /**
+     * Get all entries as array (for testing).
+     */
+    getAllEntries() {
+        return [...this.entries.entries()];
+    }
+}
+exports.InMemoryDedupeIndex = InMemoryDedupeIndex;
+// =============================================================================
+// Factory Functions
+// =============================================================================
+/**
+ * Create an in-memory spool store.
+ */
+function createInMemorySpoolStore() {
+    return new InMemorySpoolStore();
+}
+/**
+ * Create an in-memory dedupe index.
+ */
+function createInMemoryDedupeIndex() {
+    return new InMemoryDedupeIndex();
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @peac/capture-core - Capture Session
+ *
+ * Stateful capture pipeline that orchestrates hashing, deduplication,
+ * and spool storage.
+ */
+import type { CaptureSession, CaptureSessionConfig, CapturedAction, CaptureResult } from './types';
+/**
+ * Default capture session implementation.
+ *
+ * Orchestrates:
+ * 1. Deduplication check
+ * 2. Payload hashing (input/output)
+ * 3. Entry creation with chain linking
+ * 4. Spool storage
+ * 5. Dedupe index update
+ */
+export declare class DefaultCaptureSession implements CaptureSession {
+    private readonly store;
+    private readonly dedupe;
+    private readonly hasher;
+    private closed;
+    private captureQueue;
+    constructor(config: CaptureSessionConfig);
+    /**
+     * Capture an action.
+     *
+     * Process:
+     * 1. Validate action
+     * 2. Serialize via queue (prevents race conditions)
+     * 3. Check for duplicate (by action.id)
+     * 4. Hash input/output payloads
+     * 5. Create spool entry with chain link
+     * 6. Append to spool
+     * 7. Update dedupe index
+     *
+     * Concurrency: Capture calls are serialized to prevent race conditions
+     * on sequence numbers and chain linkage.
+     *
+     * GUARANTEE: This method NEVER throws. All failures are returned as
+     * CaptureResult with success=false. This ensures the capture queue
+     * remains healthy and subsequent captures can proceed.
+     */
+    capture(action: CapturedAction): Promise<CaptureResult>;
+    /**
+     * Internal capture logic (runs serialized).
+     *
+     * IMPORTANT: This method must NEVER throw - it always returns CaptureResult.
+     * This is critical for queue safety: if this throws, the queue chain would
+     * propagate the rejection to the caller while the queue itself stays healthy.
+     */
+    private captureInternal;
+    /**
+     * Commit pending writes to durable storage.
+     */
+    commit(): Promise<void>;
+    /**
+     * Get the current spool head digest.
+     */
+    getHeadDigest(): Promise<string>;
+    /**
+     * Close the session and release resources.
+     */
+    close(): Promise<void>;
+    /**
+     * Validate action has required fields.
+     */
+    private validateAction;
+    /**
+     * Strip payload bytes from action for storage.
+     */
+    private stripPayloadBytes;
+    /**
+     * Assert session is not closed.
+     */
+    private assertNotClosed;
+}
+/**
+ * Create a capture session.
+ */
+export declare function createCaptureSession(config: CaptureSessionConfig): CaptureSession;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,aAAa,EAKd,MAAM,SAAS,CAAC;AAMjB;;;;;;;;;GASG;AACH,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,MAAM,CAAkB;IAIhC,OAAO,CAAC,YAAY,CAAoC;gBAE5C,MAAM,EAAE,oBAAoB;IAMxC;;;;;;;;;;;;;;;;;;OAkBG;IACG,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAgD7D;;;;;;OAMG;YACW,eAAe;IA6E7B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAKtC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,eAAe;CAKxB;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAEjF"}