audrey 0.17.0 → 0.21.0

package/dist/src/tool-trace.js

@@ -0,0 +1,142 @@
+/**
+ * High-level API for capturing agent tool traces.
+ *
+ * Contract: raw tool input / output / error text NEVER leaves this module
+ * without going through redact(). The default behavior is to keep only
+ * metadata (content hash, redacted error summary, file fingerprints) —
+ * opting into retainDetails pulls in the actual payload, still redacted.
+ */
+import { createHash } from 'node:crypto';
+import { statSync, readFileSync, existsSync } from 'node:fs';
+import { insertEvent, } from './events.js';
+import { redact, redactJson, summarizeRedactions } from './redact.js';
+const MAX_ERROR_SUMMARY_CHARS = 2000;
+function sha256(value) {
+    return createHash('sha256').update(value).digest('hex');
+}
+function hashOf(value) {
+    if (value == null)
+        return null;
+    const text = typeof value === 'string' ? value : JSON.stringify(value);
+    if (!text)
+        return null;
+    return sha256(text);
+}
+function fingerprintFile(path) {
+    try {
+        if (!existsSync(path))
+            return null;
+        const stat = statSync(path);
+        if (!stat.isFile())
+            return null;
+        if (stat.size === 0)
+            return `${path}|0|${stat.mtimeMs.toFixed(0)}|empty`;
+        if (stat.size > 16 * 1024 * 1024) {
+            // Files over 16 MB get a size/mtime-only fingerprint. Avoids blowing
+            // out memory on huge binaries while still giving us a change signal.
+            return `${path}|${stat.size}|${stat.mtimeMs.toFixed(0)}|skip`;
+        }
+        const contentHash = sha256(readFileSync(path).toString('hex'));
+        return `${path}|${stat.size}|${stat.mtimeMs.toFixed(0)}|${contentHash.slice(0, 16)}`;
+    }
+    catch {
+        return null;
+    }
+}
+function safeErrorSummary(input) {
+    if (!input)
+        return { text: null, hits: [] };
+    const trimmed = input.length > MAX_ERROR_SUMMARY_CHARS
+        ? input.slice(0, MAX_ERROR_SUMMARY_CHARS) + '…[truncated]'
+        : input;
+    const result = redact(trimmed);
+    return { text: result.text, hits: result.redactions };
+}
+/**
+ * Extract a one-line text summary from a tool result. Used when caller
+ * provides raw output text; we never store the raw content, only the summary.
+ */
+export function summarizeOutput(output, maxChars = 240) {
+    if (output == null)
+        return null;
+    const text = typeof output === 'string' ? output : safeStringify(output);
+    if (!text)
+        return null;
+    const firstLine = text.split(/\r?\n/).find(line => line.trim().length > 0) ?? text;
+    const trimmed = firstLine.trim();
+    if (trimmed.length <= maxChars)
+        return trimmed;
+    return trimmed.slice(0, maxChars - 1) + '…';
+}
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+function mergeHits(...sets) {
+    const counts = new Map();
+    for (const set of sets) {
+        for (const hit of set) {
+            counts.set(hit.class, (counts.get(hit.class) ?? 0) + hit.count);
+        }
+    }
+    return [...counts.entries()].map(([cls, count]) => ({ class: cls, count }));
+}
+export function observeTool(db, input) {
+    const errorSummary = safeErrorSummary(input.errorSummary);
+    const metadataRaw = {
+        ...(input.metadata ?? {}),
+    };
+    if (input.retainDetails) {
+        if (input.input !== undefined)
+            metadataRaw.redacted_input = input.input;
+        if (input.output !== undefined)
+            metadataRaw.redacted_output = input.output;
+    }
+    else {
+        const summary = summarizeOutput(input.output);
+        if (summary)
+            metadataRaw.output_summary = summary;
+    }
+    const { value: redactedMetadata, redactions: metadataHits } = redactJson(metadataRaw);
+    const fileFingerprints = (input.files ?? [])
+        .map(fingerprintFile)
+        .filter((fp) => fp != null);
+    const allHits = mergeHits(errorSummary.hits, metadataHits);
+    let redactionState;
+    if (allHits.length > 0) {
+        redactionState = 'redacted';
+    }
+    else if (input.retainDetails) {
+        redactionState = 'clean';
+    }
+    else {
+        redactionState = 'unreviewed';
+    }
+    const finalMetadata = redactedMetadata && Object.keys(redactedMetadata).length > 0
+        ? {
+            ...redactedMetadata,
+            ...(allHits.length > 0 ? { redactions: summarizeRedactions(allHits) } : {}),
+        }
+        : (allHits.length > 0 ? { redactions: summarizeRedactions(allHits) } : null);
+    const event = insertEvent(db, {
+        sessionId: input.sessionId ?? null,
+        eventType: input.event,
+        source: input.source ?? 'tool-trace',
+        actorAgent: input.actorAgent ?? null,
+        toolName: input.tool,
+        inputHash: hashOf(input.input),
+        outputHash: hashOf(input.output),
+        outcome: input.outcome ?? (input.event === 'PostToolUseFailure' ? 'failed' : null),
+        errorSummary: errorSummary.text,
+        cwd: input.cwd ?? null,
+        fileFingerprints,
+        redactionState,
+        metadata: finalMetadata,
+    });
+    return { event, redactions: allHits };
+}
+//# sourceMappingURL=tool-trace.js.map

package/dist/src/tool-trace.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,446 @@
+/**
+ * src/types.ts — Shared type definitions for the Audrey memory system.
+ * All types are derived from the actual JS source — no behavioral changes.
+ */
+export type { Database } from 'better-sqlite3';
+export type SourceType = 'direct-observation' | 'told-by-user' | 'tool-result' | 'inference' | 'model-generated';
+export type MemoryType = 'episodic' | 'semantic' | 'procedural';
+export type MemoryState = 'active' | 'disputed' | 'superseded' | 'context_dependent' | 'dormant' | 'rolled_back';
+export type ContradictionState = 'open' | 'resolved' | 'context_dependent' | 'reopened';
+export type ConsolidationStatus = 'running' | 'completed' | 'failed' | 'rolled_back';
+export type CausalLinkType = 'causal' | 'correlational' | 'temporal';
+export interface Affect {
+    valence?: number;
+    arousal?: number;
+    label?: string;
+}
+export interface CausalParams {
+    trigger?: string;
+    consequence?: string;
+}
+export interface EncodeParams {
+    content: string;
+    source: SourceType;
+    salience?: number;
+    causal?: CausalParams;
+    tags?: string[];
+    supersedes?: string;
+    context?: Record<string, string>;
+    affect?: Affect;
+    arousalWeight?: number;
+    private?: boolean;
+}
+export type RetrievalMode = 'vector' | 'keyword' | 'hybrid';
+export interface RecallOptions {
+    minConfidence?: number;
+    types?: MemoryType[];
+    limit?: number;
+    includeProvenance?: boolean;
+    includeDormant?: boolean;
+    tags?: string[];
+    sources?: string[];
+    after?: string;
+    before?: string;
+    context?: Record<string, string>;
+    mood?: Pick<Affect, 'valence' | 'arousal'>;
+    confidenceConfig?: ConfidenceConfig;
+    includePrivate?: boolean;
+    retrieval?: RetrievalMode;
+}
+export interface EpisodicProvenance {
+    source: string;
+    sourceReliability: number;
+    createdAt: string;
+    supersedes: string | null;
+}
+export interface SemanticProvenance {
+    evidenceEpisodeIds: string[];
+    evidenceCount: number;
+    supportingCount: number;
+    contradictingCount: number;
+    consolidationCheckpoint: string | null;
+}
+export interface ProceduralProvenance {
+    evidenceEpisodeIds: string[];
+    successCount: number;
+    failureCount: number;
+    triggerConditions: string | null;
+}
+export interface RecallResult {
+    id: string;
+    content: string;
+    type: MemoryType;
+    confidence: number;
+    score: number;
+    source: string;
+    createdAt: string;
+    state?: MemoryState;
+    contextMatch?: number;
+    moodCongruence?: number;
+    lexicalCoverage?: number;
+    provenance?: EpisodicProvenance | SemanticProvenance | ProceduralProvenance;
+}
+export interface ConfidenceWeights {
+    source: number;
+    evidence: number;
+    recency: number;
+    retrieval: number;
+}
+export interface HalfLives {
+    episodic: number;
+    semantic: number;
+    procedural: number;
+}
+export type SourceReliabilityMap = Record<string, number>;
+export interface ConfidenceConfig {
+    weights?: ConfidenceWeights;
+    halfLives?: HalfLives;
+    sourceReliability?: SourceReliabilityMap;
+    interferenceWeight?: number;
+    contextWeight?: number;
+    affectWeight?: number;
+    retrievalContext?: Record<string, string>;
+    retrievalMood?: Pick<Affect, 'valence' | 'arousal'>;
+}
+export interface ComputeConfidenceParams {
+    sourceType: string;
+    supportingCount: number;
+    contradictingCount: number;
+    ageDays: number;
+    halfLifeDays: number;
+    retrievalCount: number;
+    daysSinceRetrieval: number;
+    weights?: ConfidenceWeights;
+    customSourceReliability?: SourceReliabilityMap;
+}
+export interface ExtractedPrinciple {
+    content: string;
+    type: 'semantic' | 'procedural';
+    conditions?: Record<string, unknown>;
+}
+export interface ConsolidationResult {
+    runId: string;
+    episodesEvaluated: number;
+    clustersFound: number;
+    principlesExtracted: number;
+    semanticsCreated?: number;
+    proceduresCreated?: number;
+    status?: string;
+}
+export interface ConsolidationOptions {
+    similarityThreshold?: number;
+    minClusterSize?: number;
+    extractPrinciple?: (episodes: EpisodeRow[]) => Promise<ExtractedPrinciple> | ExtractedPrinciple;
+    llmProvider?: LLMProvider;
+}
+export interface ContradictionCounts {
+    open: number;
+    resolved: number;
+    context_dependent: number;
+    reopened: number;
+}
+export interface IntrospectResult {
+    episodic: number;
+    semantic: number;
+    procedural: number;
+    causalLinks: number;
+    dormant: number;
+    contradictions: ContradictionCounts;
+    lastConsolidation: string | null;
+    totalConsolidationRuns: number;
+}
+export interface TruthResolution {
+    resolution: 'a_wins' | 'b_wins' | 'context_dependent';
+    conditions?: Record<string, unknown>;
+    explanation: string;
+}
+export interface DreamResult {
+    consolidation: ConsolidationResult;
+    decay: DecayResult;
+    stats: IntrospectResult;
+}
+export interface DecayResult {
+    totalEvaluated: number;
+    transitionedToDormant: number;
+    timestamp: string;
+}
+export interface GreetingOptions {
+    context?: string;
+    recentLimit?: number;
+    principleLimit?: number;
+    identityLimit?: number;
+}
+export interface GreetingResult {
+    recent: Array<{
+        id: string;
+        content: string;
+        source: string;
+        tags: string | null;
+        salience: number;
+        created_at: string;
+    }>;
+    principles: Array<{
+        id: string;
+        content: string;
+        salience: number;
+        created_at: string;
+    }>;
+    mood: {
+        valence: number;
+        arousal: number;
+        samples: number;
+    };
+    unresolved: Array<{
+        id: string;
+        content: string;
+        tags: string | null;
+        salience: number;
+        created_at: string;
+    }>;
+    identity: Array<{
+        id: string;
+        content: string;
+        tags: string | null;
+        salience: number;
+        created_at: string;
+    }>;
+    contextual?: RecallResult[];
+}
+export interface ReflectMemory {
+    content: string;
+    source: SourceType;
+    salience?: number;
+    tags?: string[];
+    private?: boolean;
+    affect?: Affect;
+}
+export interface ReflectResult {
+    encoded: number;
+    memories: ReflectMemory[];
+    skipped?: string;
+}
+export interface EmbeddingConfig {
+    provider: 'mock' | 'openai' | 'local' | 'gemini';
+    dimensions?: number;
+    apiKey?: string;
+    model?: string;
+    device?: string;
+    batchSize?: number;
+    timeout?: number;
+    pipelineFactory?: ((task: string, model: string, options?: Record<string, unknown>) => Promise<unknown>) | null;
+}
+export interface LLMConfig {
+    provider: 'mock' | 'anthropic' | 'openai';
+    apiKey?: string;
+    model?: string;
+    maxTokens?: number;
+    timeout?: number;
+    responses?: Record<string, unknown>;
+}
+export interface InterferenceConfig {
+    enabled?: boolean;
+    k?: number;
+    threshold?: number;
+    weight?: number;
+}
+export interface ContextConfig {
+    enabled?: boolean;
+    weight?: number;
+}
+export interface ResonanceConfig {
+    enabled?: boolean;
+    k?: number;
+    threshold?: number;
+    affectThreshold?: number;
+}
+export interface AffectConfig {
+    enabled?: boolean;
+    weight?: number;
+    arousalWeight?: number;
+    resonance?: ResonanceConfig;
+}
+export interface AudreyConfig {
+    dataDir?: string;
+    agent?: string;
+    embedding?: EmbeddingConfig;
+    llm?: LLMConfig;
+    confidence?: Partial<ConfidenceConfig>;
+    consolidation?: {
+        minEpisodes?: number;
+        similarityThreshold?: number;
+    };
+    decay?: {
+        dormantThreshold?: number;
+        halfLives?: Partial<HalfLives>;
+    };
+    interference?: InterferenceConfig;
+    context?: ContextConfig;
+    affect?: AffectConfig;
+    autoReflect?: boolean;
+}
+export interface EmbeddingProvider {
+    dimensions: number;
+    modelName: string;
+    modelVersion: string;
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+    vectorToBuffer(vector: number[]): Buffer;
+    bufferToVector(buffer: Buffer): number[];
+    ready?(): Promise<void>;
+    _actualDevice?: string | null;
+    device?: string;
+}
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface LLMCompletionResult {
+    content: string;
+}
+export interface LLMCompletionOptions {
+    maxTokens?: number;
+}
+export interface LLMProvider {
+    modelName: string;
+    modelVersion: string;
+    complete(messages: ChatMessage[], options?: LLMCompletionOptions): Promise<LLMCompletionResult>;
+    json(messages: ChatMessage[], options?: LLMCompletionOptions): Promise<unknown>;
+    chat?(prompt: string): Promise<string>;
+}
+export interface EpisodeRow {
+    id: string;
+    content: string;
+    embedding: Buffer | null;
+    source: string;
+    source_reliability: number;
+    salience: number;
+    context: string;
+    affect: string;
+    tags: string | null;
+    causal_trigger: string | null;
+    causal_consequence: string | null;
+    created_at: string;
+    embedding_model: string | null;
+    embedding_version: string | null;
+    supersedes: string | null;
+    superseded_by: string | null;
+    consolidated: number;
+    private: number;
+}
+export interface SemanticRow {
+    id: string;
+    content: string;
+    embedding: Buffer | null;
+    state: MemoryState;
+    conditions: string | null;
+    evidence_episode_ids: string | null;
+    evidence_count: number;
+    supporting_count: number;
+    contradicting_count: number;
+    source_type_diversity: number;
+    consolidation_checkpoint: string | null;
+    embedding_model: string | null;
+    embedding_version: string | null;
+    consolidation_model: string | null;
+    consolidation_prompt_hash: string | null;
+    created_at: string;
+    last_reinforced_at: string | null;
+    retrieval_count: number;
+    challenge_count: number;
+    interference_count: number;
+    salience: number;
+}
+export interface ProceduralRow {
+    id: string;
+    content: string;
+    embedding: Buffer | null;
+    state: MemoryState;
+    trigger_conditions: string | null;
+    evidence_episode_ids: string | null;
+    success_count: number;
+    failure_count: number;
+    embedding_model: string | null;
+    embedding_version: string | null;
+    created_at: string;
+    last_reinforced_at: string | null;
+    retrieval_count: number;
+    interference_count: number;
+    salience: number;
+}
+export interface CausalLinkRow {
+    id: string;
+    cause_id: string;
+    effect_id: string;
+    link_type: CausalLinkType;
+    mechanism: string | null;
+    confidence: number | null;
+    evidence_count: number;
+    created_at: string;
+}
+export interface ContradictionRow {
+    id: string;
+    claim_a_id: string;
+    claim_b_id: string;
+    claim_a_type: string;
+    claim_b_type: string;
+    state: ContradictionState;
+    resolution: string | null;
+    resolved_at: string | null;
+    reopened_at: string | null;
+    reopen_evidence_id: string | null;
+    created_at: string;
+}
+export interface ConsolidationRunRow {
+    id: string;
+    checkpoint_cursor: string | null;
+    input_episode_ids: string;
+    output_memory_ids: string;
+    confidence_deltas: string | null;
+    consolidation_model: string | null;
+    consolidation_prompt_hash: string | null;
+    started_at: string;
+    completed_at: string | null;
+    status: ConsolidationStatus;
+}
+export interface ConsolidationMetricRow {
+    id: string;
+    run_id: string;
+    min_cluster_size: number;
+    similarity_threshold: number;
+    episodes_evaluated: number;
+    clusters_found: number;
+    principles_extracted: number;
+    created_at: string;
+}
+export interface MemoryStatusResult {
+    episodes: number;
+    vec_episodes: number;
+    semantics: number;
+    vec_semantics: number;
+    procedures: number;
+    vec_procedures: number;
+    searchable_episodes: number;
+    searchable_semantics: number;
+    searchable_procedures: number;
+    dimensions: number | null;
+    schema_version: number;
+    device: string | null;
+    healthy: boolean;
+    reembed_recommended: boolean;
+}
+export interface ForgetResult {
+    id: string;
+    type: MemoryType;
+    purged: boolean;
+}
+export interface PurgeResult {
+    episodes: number;
+    semantics: number;
+    procedures: number;
+}
+export interface ReembedCounts {
+    episodes: number;
+    semantics: number;
+    procedures: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/types.js

@@ -0,0 +1,6 @@
+/**
+ * src/types.ts — Shared type definitions for the Audrey memory system.
+ * All types are derived from the actual JS source — no behavioral changes.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

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

package/dist/src/ulid.d.ts

@@ -0,0 +1,3 @@
+export declare function generateId(): string;
+export declare function generateDeterministicId(...parts: unknown[]): string;
+//# sourceMappingURL=ulid.d.ts.map

package/dist/src/ulid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ulid.d.ts","sourceRoot":"","sources":["../../src/ulid.ts"],"names":[],"mappings":"AAKA,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,uBAAuB,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAGnE"}

package/dist/src/ulid.js

@@ -0,0 +1,11 @@
+import { monotonicFactory } from 'ulid';
+import { createHash } from 'node:crypto';
+const monotonic = monotonicFactory();
+export function generateId() {
+    return monotonic();
+}
+export function generateDeterministicId(...parts) {
+    const input = JSON.stringify(parts);
+    return createHash('sha256').update(input).digest('hex').slice(0, 26);
+}
+//# sourceMappingURL=ulid.js.map

package/dist/src/ulid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ulid.js","sourceRoot":"","sources":["../../src/ulid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;AAErC,MAAM,UAAU,UAAU;IACxB,OAAO,SAAS,EAAE,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,GAAG,KAAgB;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACvE,CAAC"}

package/dist/src/utils.d.ts

@@ -0,0 +1,10 @@
+import type { EmbeddingProvider } from './types.js';
+export declare function cosineSimilarity(bufA: Buffer, bufB: Buffer, provider: EmbeddingProvider): number;
+export declare function daysBetween(dateStr: string, now: Date): number;
+export declare function safeJsonParse<T>(str: string | null | undefined, fallback: T): T;
+export declare function requireApiKey(apiKey: string | undefined | null, operation: string, envVar: string): asserts apiKey is string;
+export declare function describeHttpError(response: {
+    status: number;
+    text: () => Promise<string>;
+}): Promise<string>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAahG;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAE9D;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAI/E;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAI5H;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAOlH"}