@tracehound/core 1.2.0

package/dist/types/errors.js

@@ -0,0 +1,266 @@
+/**
+ * Tracehound error handling.
+ *
+ * Error codes are organized by domain:
+ * - CONFIG_*     : Configuration validation errors
+ * - SCENT_*      : Scent/payload validation errors
+ * - AGENT_*      : Agent processing errors
+ * - QUARANTINE_* : Quarantine operations
+ * - EVIDENCE_*   : Evidence lifecycle
+ * - CODEC_*      : Encoding/decoding errors
+ * - COLD_*       : Cold storage errors
+ * - PROCESS_*    : Hound process errors
+ * - RATE_*       : Rate limiting
+ * - RUNTIME_*    : Runtime environment
+ */
+/**
+ * Create a TracehoundError.
+ */
+export function createError(state, code, message, options) {
+    return {
+        state,
+        code,
+        message,
+        context: options?.context,
+        recoverable: options?.recoverable ?? true,
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Pre-defined Error Factories
+// ─────────────────────────────────────────────────────────────────────────────
+export const Errors = {
+    // ─────────────────────────────────────────────────────────────────────────
+    // Config Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    invalidConfigQuarantine: (issue) => createError('config', 'CONFIG_QUARANTINE_INVALID', `Invalid quarantine config: ${issue}`, {
+        context: { issue },
+        recoverable: false,
+    }),
+    invalidConfigRateLimit: (issue) => createError('config', 'CONFIG_RATELIMIT_INVALID', `Invalid rate limit config: ${issue}`, {
+        context: { issue },
+        recoverable: false,
+    }),
+    invalidConfigAgent: (issue) => createError('config', 'CONFIG_AGENT_INVALID', `Invalid agent config: ${issue}`, {
+        context: { issue },
+        recoverable: false,
+    }),
+    invalidConfigScheduler: (issue) => createError('config', 'CONFIG_SCHEDULER_INVALID', `Invalid scheduler config: ${issue}`, {
+        context: { issue },
+        recoverable: false,
+    }),
+    // ─────────────────────────────────────────────────────────────────────────
+    // Scent Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    scentPayloadInvalid: (reason) => createError('scent', 'SCENT_PAYLOAD_INVALID', `Invalid scent payload: ${reason}`, {
+        context: { reason },
+        recoverable: false,
+    }),
+    scentSourceMissing: () => createError('scent', 'SCENT_SOURCE_MISSING', 'Scent source is required', {
+        recoverable: false,
+    }),
+    scentIdInvalid: (id) => createError('scent', 'SCENT_ID_INVALID', `Invalid scent ID format: ${id}`, {
+        context: { id },
+        recoverable: false,
+    }),
+    // ─────────────────────────────────────────────────────────────────────────
+    // Agent Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    payloadTooLarge: (size, limit) => createError('agent', 'AGENT_PAYLOAD_TOO_LARGE', `Payload size ${size} exceeds limit ${limit}`, {
+        context: { size, limit },
+        recoverable: false,
+    }),
+    serializationFailed: (reason) => createError('agent', 'AGENT_SERIALIZATION_FAILED', `Failed to serialize: ${reason}`, {
+        context: { reason },
+        recoverable: false,
+    }),
+    interceptFailed: (reason) => createError('agent', 'AGENT_INTERCEPT_FAILED', `Intercept failed: ${reason}`, {
+        context: { reason },
+        recoverable: true,
+    }),
+    // ─────────────────────────────────────────────────────────────────────────
+    // Quarantine Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    quarantineFull: (count, maxCount) => createError('quarantine', 'QUARANTINE_FULL', `Quarantine at capacity: ${count}/${maxCount}`, {
+        context: { count, maxCount },
+        recoverable: false,
+    }),
+    quarantineEvictFailed: (reason) => createError('quarantine', 'QUARANTINE_EVICT_FAILED', `Eviction failed: ${reason}`, {
+        context: { reason },
+        recoverable: false,
+    }),
+    // ─────────────────────────────────────────────────────────────────────────
+    // Evidence Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    evidenceAlreadyDisposed: (signature) => createError('evidence', 'EVIDENCE_DISPOSED', `Evidence ${signature} already disposed`, {
+        context: { signature },
+        recoverable: false,
+    }),
+    evidenceTransferFailed: (signature) => createError('evidence', 'EVIDENCE_TRANSFER_FAILED', `Failed to transfer evidence ${signature}`, {
+        context: { signature },
+        recoverable: false,
+    }),
+    evidenceEmpty: () => createError('evidence', 'EVIDENCE_EMPTY', 'Evidence bytes cannot be empty', {
+        recoverable: false,
+    }),
+    evidenceInvalidBytes: () => createError('evidence', 'EVIDENCE_INVALID_BYTES', 'Evidence bytes must be ArrayBuffer', {
+        recoverable: false,
+    }),
+    evidenceHashMismatch: (expected, actual) => createError('evidence', 'EVIDENCE_HASH_MISMATCH', `Hash mismatch: expected ${expected}, got ${actual}`, {
+        context: { expected, actual },
+        recoverable: false,
+    }),
+    // ─────────────────────────────────────────────────────────────────────────
+    // Codec Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    codecEncodeFailed: (reason) => createError('codec', 'CODEC_ENCODE_FAILED', `Encoding failed: ${reason}`, {
+        context: { reason },
+        recoverable: false,
+    }),
+    codecDecodeFailed: (reason) => createError('codec', 'CODEC_DECODE_FAILED', `Decoding failed: ${reason}`, {
+        context: { reason },
+        recoverable: false,
+    }),
+    codecIntegrityFailed: () => createError('codec', 'CODEC_INTEGRITY_FAILED', 'Integrity verification failed', {
+        recoverable: false,
+    }),
+    // ─────────────────────────────────────────────────────────────────────────
+    // Cold Storage Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    coldStorageWriteFailed: (id, reason) => createError('cold_storage', 'COLD_WRITE_FAILED', `Failed to write ${id}: ${reason}`, {
+        context: { id, reason },
+        recoverable: true,
+    }),
+    coldStorageReadFailed: (id, reason) => createError('cold_storage', 'COLD_READ_FAILED', `Failed to read ${id}: ${reason}`, {
+        context: { id, reason },
+        recoverable: true,
+    }),
+    coldStorageNotFound: (id) => createError('cold_storage', 'COLD_NOT_FOUND', `Evidence ${id} not found in cold storage`, {
+        context: { id },
+        recoverable: false,
+    }),
+    coldStorageUnavailable: () => createError('cold_storage', 'COLD_UNAVAILABLE', 'Cold storage is unavailable', {
+        recoverable: true,
+    }),
+    // ─────────────────────────────────────────────────────────────────────────
+    // Process Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    processSpawnFailed: (reason) => createError('process', 'PROCESS_SPAWN_FAILED', `Failed to spawn process: ${reason}`, {
+        context: { reason },
+        recoverable: true,
+    }),
+    processTimeout: (houndId, elapsed) => createError('process', 'PROCESS_TIMEOUT', `Process ${houndId} timed out after ${elapsed}ms`, {
+        context: { houndId, elapsed },
+        recoverable: false,
+    }),
+    processCrashed: (houndId, exitCode) => createError('process', 'PROCESS_CRASHED', `Process ${houndId} crashed with code ${exitCode}`, {
+        context: { houndId, exitCode },
+        recoverable: true,
+    }),
+    processPoolExhausted: (action) => createError('process', 'PROCESS_POOL_EXHAUSTED', `Process pool exhausted, action: ${action}`, {
+        context: { action },
+        recoverable: true,
+    }),
+    // ─────────────────────────────────────────────────────────────────────────
+    // Rate Limit Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    rateLimited: (source, retryAfter) => createError('ratelimit', 'RATE_LIMITED', `Source ${source} rate limited`, {
+        context: { source, retryAfter },
+        recoverable: true,
+    }),
+    rateSourceBlocked: (source, until) => createError('ratelimit', 'RATE_SOURCE_BLOCKED', `Source ${source} blocked until ${until}`, {
+        context: { source, until },
+        recoverable: true,
+    }),
+    // ─────────────────────────────────────────────────────────────────────────
+    // Runtime Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    runtimeFlagMissing: (flag) => createError('runtime', 'RUNTIME_FLAG_MISSING', `Required runtime flag missing: ${flag}`, {
+        context: { flag },
+        recoverable: false,
+    }),
+    runtimeIntrinsicsNotFrozen: () => createError('runtime', 'RUNTIME_INTRINSICS_NOT_FROZEN', 'Intrinsics are not frozen', {
+        recoverable: false,
+    }),
+    // ─────────────────────────────────────────────────────────────────────────
+    // Scheduler Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    schedulerTaskFailed: (taskId, reason) => createError('scheduler', 'SCHEDULER_TASK_FAILED', `Task ${taskId} failed: ${reason}`, {
+        context: { taskId, reason },
+        recoverable: true,
+    }),
+    schedulerAlreadyRunning: () => createError('scheduler', 'SCHEDULER_ALREADY_RUNNING', 'Scheduler is already running', {
+        recoverable: false,
+    }),
+    // ─────────────────────────────────────────────────────────────────────────
+    // Legacy aliases (for backward compatibility)
+    // ─────────────────────────────────────────────────────────────────────────
+    /** @deprecated Use processTimeout */
+    houndTimeout: (houndId, elapsed) => createError('process', 'PROCESS_TIMEOUT', `Hound ${houndId} timed out`, {
+        context: { houndId, elapsed },
+        recoverable: false,
+    }),
+    /** @deprecated Use evidenceHashMismatch */
+    hashMismatch: (expected, actual) => createError('evidence', 'EVIDENCE_HASH_MISMATCH', `Hash mismatch: expected ${expected}, got ${actual}`, {
+        context: { expected, actual },
+        recoverable: false,
+    }),
+    /** @deprecated Use evidenceInvalidBytes */
+    invalidBytesType: () => createError('evidence', 'EVIDENCE_INVALID_BYTES', 'Evidence bytes must be ArrayBuffer', {
+        recoverable: false,
+    }),
+    /** @deprecated Use evidenceEmpty */
+    emptyEvidence: () => createError('evidence', 'EVIDENCE_EMPTY', 'Evidence bytes cannot be empty', {
+        recoverable: false,
+    }),
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Error Code Constants (for programmatic matching)
+// ─────────────────────────────────────────────────────────────────────────────
+export const ErrorCodes = {
+    // Config
+    CONFIG_QUARANTINE_INVALID: 'CONFIG_QUARANTINE_INVALID',
+    CONFIG_RATELIMIT_INVALID: 'CONFIG_RATELIMIT_INVALID',
+    CONFIG_AGENT_INVALID: 'CONFIG_AGENT_INVALID',
+    CONFIG_SCHEDULER_INVALID: 'CONFIG_SCHEDULER_INVALID',
+    // Scent
+    SCENT_PAYLOAD_INVALID: 'SCENT_PAYLOAD_INVALID',
+    SCENT_SOURCE_MISSING: 'SCENT_SOURCE_MISSING',
+    SCENT_ID_INVALID: 'SCENT_ID_INVALID',
+    // Agent
+    AGENT_PAYLOAD_TOO_LARGE: 'AGENT_PAYLOAD_TOO_LARGE',
+    AGENT_SERIALIZATION_FAILED: 'AGENT_SERIALIZATION_FAILED',
+    AGENT_INTERCEPT_FAILED: 'AGENT_INTERCEPT_FAILED',
+    // Quarantine
+    QUARANTINE_FULL: 'QUARANTINE_FULL',
+    QUARANTINE_EVICT_FAILED: 'QUARANTINE_EVICT_FAILED',
+    // Evidence
+    EVIDENCE_DISPOSED: 'EVIDENCE_DISPOSED',
+    EVIDENCE_TRANSFER_FAILED: 'EVIDENCE_TRANSFER_FAILED',
+    EVIDENCE_EMPTY: 'EVIDENCE_EMPTY',
+    EVIDENCE_INVALID_BYTES: 'EVIDENCE_INVALID_BYTES',
+    EVIDENCE_HASH_MISMATCH: 'EVIDENCE_HASH_MISMATCH',
+    // Codec
+    CODEC_ENCODE_FAILED: 'CODEC_ENCODE_FAILED',
+    CODEC_DECODE_FAILED: 'CODEC_DECODE_FAILED',
+    CODEC_INTEGRITY_FAILED: 'CODEC_INTEGRITY_FAILED',
+    // Cold Storage
+    COLD_WRITE_FAILED: 'COLD_WRITE_FAILED',
+    COLD_READ_FAILED: 'COLD_READ_FAILED',
+    COLD_NOT_FOUND: 'COLD_NOT_FOUND',
+    COLD_UNAVAILABLE: 'COLD_UNAVAILABLE',
+    // Process
+    PROCESS_SPAWN_FAILED: 'PROCESS_SPAWN_FAILED',
+    PROCESS_TIMEOUT: 'PROCESS_TIMEOUT',
+    PROCESS_CRASHED: 'PROCESS_CRASHED',
+    PROCESS_POOL_EXHAUSTED: 'PROCESS_POOL_EXHAUSTED',
+    // Rate Limit
+    RATE_LIMITED: 'RATE_LIMITED',
+    RATE_SOURCE_BLOCKED: 'RATE_SOURCE_BLOCKED',
+    // Runtime
+    RUNTIME_FLAG_MISSING: 'RUNTIME_FLAG_MISSING',
+    RUNTIME_INTRINSICS_NOT_FROZEN: 'RUNTIME_INTRINSICS_NOT_FROZEN',
+    // Scheduler
+    SCHEDULER_TASK_FAILED: 'SCHEDULER_TASK_FAILED',
+    SCHEDULER_ALREADY_RUNNING: 'SCHEDULER_ALREADY_RUNNING',
+};
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

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

package/dist/types/evidence.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Evidence handling types and records.
+ */
+import type { Severity } from './common.js';
+/**
+ * Record of a neutralized evidence.
+ * Created when evidence is destroyed with atomic snapshot.
+ */
+export interface NeutralizationRecord {
+    /** Unique record ID */
+    id: string;
+    /** Threat signature */
+    signature: string;
+    /** Content hash */
+    hash: string;
+    /** Original size in bytes */
+    size: number;
+    /** Record status */
+    status: 'neutralized';
+    /** Timestamp of neutralization */
+    timestamp: number;
+    /** Previous record hash in audit chain */
+    previousHash: string;
+}
+/**
+ * Record of evacuated evidence.
+ * Created when evidence is moved to cold storage.
+ */
+export interface EvacuateRecord {
+    /** Unique record ID */
+    id: string;
+    /** Threat signature */
+    signature: string;
+    /** Cold storage destination URL */
+    destination: string;
+    /** Timestamp of evacuation */
+    timestamp: number;
+    /** Whether payload was compressed */
+    compressed: boolean;
+    /** Size in bytes (after compression if applicable) */
+    size: number;
+}
+/**
+ * Record of purged evidence.
+ * Created during controlled destruction (timeout, error, panic).
+ */
+export interface PurgeRecord {
+    /** Unique record ID */
+    id: string;
+    /** Reason for purge */
+    reason: 'timeout' | 'error' | 'abort' | 'panic';
+    /** Minimal scent snapshot (hash only, not full payload) */
+    scent: {
+        id: string;
+        source: string;
+        timestamp: number;
+        payloadHash: string;
+        payloadSize: number;
+    };
+    /** Timestamp of purge */
+    purgeTimestamp: number;
+}
+/**
+ * Handle to quarantined evidence.
+ * Provides ownership-based access to evidence data.
+ */
+export interface EvidenceHandle {
+    /** Encoded evidence bytes */
+    readonly bytes: ArrayBuffer;
+    /** Size in bytes */
+    readonly size: number;
+    /** Content hash (SHA-256) */
+    readonly hash: string;
+    /** Threat signature */
+    readonly signature: string;
+    /** Capture timestamp */
+    readonly captured: number;
+    /** Threat severity */
+    readonly severity: Severity;
+    /** Whether this handle has been disposed */
+    readonly disposed: boolean;
+    /**
+     * Transfer ownership of bytes.
+     * Handle becomes disposed after transfer.
+     */
+    transfer(): ArrayBuffer;
+    /**
+     * Atomically snapshot and destroy evidence.
+     * Returns neutralization record.
+     *
+     * @param previousHash - Last hash in audit chain
+     */
+    neutralize(previousHash: string): NeutralizationRecord;
+    /**
+     * Move evidence to cold storage.
+     * Returns evacuation record.
+     *
+     * @param destination - Cold storage URL
+     */
+    evacuate(destination: string): EvacuateRecord;
+}
+//# sourceMappingURL=evidence.d.ts.map

package/dist/types/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../src/types/evidence.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,oBAAoB;IACpB,MAAM,EAAE,aAAa,CAAA;IACrB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,qCAAqC;IACrC,UAAU,EAAE,OAAO,CAAA;IACnB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,uBAAuB;IACvB,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;IAC/C,2DAA2D;IAC3D,KAAK,EAAE;QACL,EAAE,EAAE,MAAM,CAAA;QACV,MAAM,EAAE,MAAM,CAAA;QACd,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,EAAE,MAAM,CAAA;QACnB,WAAW,EAAE,MAAM,CAAA;KACpB,CAAA;IACD,yBAAyB;IACzB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,uBAAuB;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,sBAAsB;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAE1B;;;OAGG;IACH,QAAQ,IAAI,WAAW,CAAA;IAEvB;;;;;OAKG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,oBAAoB,CAAA;IAEtD;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAAA;CAC9C"}

package/dist/types/evidence.js

@@ -0,0 +1,5 @@
+/**
+ * Evidence handling types and records.
+ */
+export {};
+//# sourceMappingURL=evidence.js.map

package/dist/types/evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.js","sourceRoot":"","sources":["../../src/types/evidence.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Type re-exports.
+ */
+export type { AuditRecord, IAuditChain } from './audit.js';
+export type { JsonPrimitive, JsonSerializable, Severity } from './common.js';
+export { DEFAULT_CONFIG, mergeWithDefaults } from './config.js';
+export type { AlertConfig, AuditConfig, ColdStorageConfig, HoundConfig, QuarantineConfig, RateLimitConfig, RuntimeConfig, SchedulerConfig, TracehoundConfig, } from './config.js';
+export { ErrorCodes, Errors, createError } from './errors.js';
+export type { ErrorCode, ErrorState, TracehoundError } from './errors.js';
+export type { EvacuateRecord, EvidenceHandle, NeutralizationRecord, PurgeRecord, } from './evidence.js';
+export { isClean, isError, isIgnored, isQuarantined, isRateLimited } from './result.js';
+export type { InterceptResult } from './result.js';
+export type { Scent, ThreatCategory, ThreatSignal } from './scent.js';
+export { compareSignatures, generateSignature, validateSignature } from './signature.js';
+export type { GenerateSignatureOptions } from './signature.js';
+export { createThreatInput } from './threat.js';
+export type { Threat, ThreatInput } from './threat.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC1D,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC5E,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/D,YAAY,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC7D,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AACzE,YAAY,EACV,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,WAAW,GACZ,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACvF,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACrE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACxF,YAAY,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA"}

package/dist/types/index.js

@@ -0,0 +1,9 @@
+/**
+ * Type re-exports.
+ */
+export { DEFAULT_CONFIG, mergeWithDefaults } from './config.js';
+export { ErrorCodes, Errors, createError } from './errors.js';
+export { isClean, isError, isIgnored, isQuarantined, isRateLimited } from './result.js';
+export { compareSignatures, generateSignature, validateSignature } from './signature.js';
+export { createThreatInput } from './threat.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAY/D,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAQ7D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAGvF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAExF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA"}

package/dist/types/result.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Intercept result types and type guards.
+ */
+import type { TracehoundError } from './errors.js';
+import type { EvidenceHandle } from './evidence.js';
+/**
+ * Result of an intercept operation.
+ * Discriminated union for exhaustive handling.
+ */
+export type InterceptResult = {
+    status: 'clean';
+} | {
+    status: 'rate_limited';
+    retryAfter: number;
+} | {
+    status: 'payload_too_large';
+    limit: number;
+} | {
+    status: 'ignored';
+    signature: string;
+} | {
+    status: 'quarantined';
+    handle: EvidenceHandle;
+} | {
+    status: 'error';
+    error: TracehoundError;
+};
+/**
+ * Type guard for quarantined result.
+ */
+export declare function isQuarantined(result: InterceptResult): result is {
+    status: 'quarantined';
+    handle: EvidenceHandle;
+};
+/**
+ * Type guard for error result.
+ */
+export declare function isError(result: InterceptResult): result is {
+    status: 'error';
+    error: TracehoundError;
+};
+/**
+ * Type guard for clean result.
+ */
+export declare function isClean(result: InterceptResult): result is {
+    status: 'clean';
+};
+/**
+ * Type guard for rate limited result.
+ */
+export declare function isRateLimited(result: InterceptResult): result is {
+    status: 'rate_limited';
+    retryAfter: number;
+};
+/**
+ * Type guard for ignored result (duplicate signature).
+ */
+export declare function isIgnored(result: InterceptResult): result is {
+    status: 'ignored';
+    signature: string;
+};
+//# sourceMappingURL=result.d.ts.map

package/dist/types/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/types/result.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GACjD;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAA;AAE/C;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,eAAe,GACtB,MAAM,IAAI;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAE7D;AAED;;GAEG;AACH,wBAAgB,OAAO,CACrB,MAAM,EAAE,eAAe,GACtB,MAAM,IAAI;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAEvD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,IAAI;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAE9E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,eAAe,GACtB,MAAM,IAAI;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAE1D;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,eAAe,GACtB,MAAM,IAAI;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAEpD"}

package/dist/types/result.js

@@ -0,0 +1,34 @@
+/**
+ * Intercept result types and type guards.
+ */
+/**
+ * Type guard for quarantined result.
+ */
+export function isQuarantined(result) {
+    return result.status === 'quarantined';
+}
+/**
+ * Type guard for error result.
+ */
+export function isError(result) {
+    return result.status === 'error';
+}
+/**
+ * Type guard for clean result.
+ */
+export function isClean(result) {
+    return result.status === 'clean';
+}
+/**
+ * Type guard for rate limited result.
+ */
+export function isRateLimited(result) {
+    return result.status === 'rate_limited';
+}
+/**
+ * Type guard for ignored result (duplicate signature).
+ */
+export function isIgnored(result) {
+    return result.status === 'ignored';
+}
+//# sourceMappingURL=result.js.map

package/dist/types/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/types/result.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAuB;IAEvB,OAAO,MAAM,CAAC,MAAM,KAAK,aAAa,CAAA;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CACrB,MAAuB;IAEvB,OAAO,MAAM,CAAC,MAAM,KAAK,OAAO,CAAA;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,MAAuB;IAC7C,OAAO,MAAM,CAAC,MAAM,KAAK,OAAO,CAAA;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAuB;IAEvB,OAAO,MAAM,CAAC,MAAM,KAAK,cAAc,CAAA;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,MAAuB;IAEvB,OAAO,MAAM,CAAC,MAAM,KAAK,SAAS,CAAA;AACpC,CAAC"}

package/dist/types/scent.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Scent - the input unit to Tracehound Agent.
+ */
+import type { Severity } from './common.js';
+/** Threat category types */
+export type ThreatCategory = 'injection' | 'ddos' | 'flood' | 'spam' | 'malware' | 'unknown';
+/**
+ * Threat signal from external detector.
+ * This is provided by WAF, custom rules, ML models, etc.
+ * Tracehound does NOT perform threat detection.
+ */
+export interface ThreatSignal {
+    /** Classification category */
+    category: ThreatCategory;
+    /** Severity level */
+    severity: Severity;
+}
+/**
+ * JSON primitive types for payload.
+ * Re-exported here for convenience.
+ */
+export type { JsonSerializable } from './common.js';
+/**
+ * A scent represents a captured request/event to be analyzed.
+ *
+ * RFC Contract:
+ * - If `threat` is present: External detector classified this as malicious → quarantine
+ * - If `threat` is absent: No threat signal → clean (no quarantine)
+ *
+ * Tracehound DOES NOT make threat detection decisions.
+ */
+export interface Scent {
+    /** Unique identifier for this scent */
+    readonly id: string;
+    /**
+     * Request/event payload.
+     * Must be JSON serializable for deterministic hashing.
+     * Size constrained by config.maxPayloadSize.
+     */
+    readonly payload: import('./common.js').JsonSerializable;
+    /**
+     * Origin identifier (IP, user agent, service name).
+     * Used for rate limiting.
+     */
+    readonly source: string;
+    /** Capture timestamp (milliseconds since epoch) */
+    readonly timestamp: number;
+    /**
+     * Optional threat signal from external detector.
+     * If present, scent will be quarantined.
+     * If absent, scent is considered clean.
+     */
+    readonly threat?: ThreatSignal;
+}
+//# sourceMappingURL=scent.d.ts.map

package/dist/types/scent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scent.d.ts","sourceRoot":"","sources":["../../src/types/scent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,4BAA4B;AAC5B,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;AAE5F;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,QAAQ,EAAE,cAAc,CAAA;IACxB,qBAAqB;IACrB,QAAQ,EAAE,QAAQ,CAAA;CACnB;AAED;;;GAGG;AACH,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD;;;;;;;;GAQG;AACH,MAAM,WAAW,KAAK;IACpB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,aAAa,EAAE,gBAAgB,CAAA;IAExD;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAEvB,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAE1B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAA;CAC/B"}

package/dist/types/scent.js

@@ -0,0 +1,5 @@
+/**
+ * Scent - the input unit to Tracehound Agent.
+ */
+export {};
+//# sourceMappingURL=scent.js.map

package/dist/types/scent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scent.js","sourceRoot":"","sources":["../../src/types/scent.ts"],"names":[],"mappings":"AAAA;;GAEG"}