@monoes/memory 1.0.0

package/dist/procedural/learned-skill.js

@@ -0,0 +1,73 @@
+/**
+ * LearnedSkillSerializer — Creates and serializes LearnedSkill objects.
+ *
+ * Part of Task 45 — Procedural Memory.
+ */
+import { randomUUID } from 'crypto';
+export class LearnedSkillSerializer {
+    /**
+     * Create a new LearnedSkill from extracted data.
+     */
+    static create(name, agentSlug, triggerPattern, actionSequence, successCount, avgQualityScore, sourceRunIds) {
+        const now = new Date().toISOString();
+        return {
+            skillId: randomUUID(),
+            name,
+            agentSlug,
+            trigger: {
+                pattern: triggerPattern,
+                mode: 'exact',
+                minConfidence: 0.8,
+            },
+            actionSequence,
+            successCount,
+            avgQualityScore,
+            sourceRunIds,
+            createdAt: now,
+            lastUpdatedAt: now,
+            version: 1,
+        };
+    }
+    /**
+     * Serialize a LearnedSkill to a markdown string with YAML frontmatter.
+     */
+    static toMarkdown(skill) {
+        const lines = [];
+        lines.push('---');
+        lines.push(`skill_id: ${skill.skillId}`);
+        lines.push(`name: ${skill.name}`);
+        lines.push(`agent_slug: ${skill.agentSlug}`);
+        lines.push(`success_count: ${skill.successCount}`);
+        lines.push(`avg_quality_score: ${skill.avgQualityScore}`);
+        lines.push(`version: ${skill.version}`);
+        lines.push(`created_at: ${skill.createdAt}`);
+        lines.push(`last_updated_at: ${skill.lastUpdatedAt}`);
+        lines.push(`source_run_ids: [${skill.sourceRunIds.join(', ')}]`);
+        lines.push('---');
+        lines.push('');
+        lines.push(`# ${skill.name}`);
+        lines.push('');
+        lines.push('## Trigger');
+        lines.push('');
+        lines.push(`- Pattern: \`${skill.trigger.pattern}\``);
+        lines.push(`- Mode: ${skill.trigger.mode}`);
+        lines.push(`- Min Confidence: ${skill.trigger.minConfidence}`);
+        lines.push('');
+        lines.push('## Action Sequence');
+        lines.push('');
+        for (let i = 0; i < skill.actionSequence.length; i++) {
+            const step = skill.actionSequence[i];
+            lines.push(`### Step ${i + 1}: ${step.toolName}`);
+            lines.push('');
+            lines.push(`- Tool: \`${step.toolName}\``);
+            lines.push(`- Outcome: ${step.outcome}`);
+            lines.push(`- Duration: ${step.durationMs}ms`);
+            if (step.qualityScore !== undefined) {
+                lines.push(`- Quality: ${step.qualityScore}`);
+            }
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=learned-skill.js.map

package/dist/procedural/learned-skill.js.map

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

package/dist/procedural/procedure-extractor-worker.d.ts

@@ -0,0 +1,27 @@
+/**
+ * ProcedureExtractorWorker — Background worker that extracts action
+ * sequences from successful agent runs and stores them as learned
+ * skills in procedural memory (Task 45).
+ *
+ * Delegates to ActionSequenceExtractor for grouping and fingerprinting.
+ *
+ * @module v1/memory/procedural/procedure-extractor-worker
+ */
+import type { ActionRecord } from './types.js';
+export interface ProcedureExtractionContext {
+    records: ActionRecord[];
+    minOccurrences?: number;
+    minSuccessRate?: number;
+}
+export interface ProcedureExtractionResult {
+    extracted: boolean;
+    skillsFound: number;
+    skillsStored: number;
+    durationMs: number;
+}
+export declare class ProcedureExtractorWorker {
+    readonly name: "procedure-extractor";
+    readonly priority: "low";
+    execute(context: ProcedureExtractionContext): Promise<ProcedureExtractionResult>;
+}
+//# sourceMappingURL=procedure-extractor-worker.d.ts.map

package/dist/procedural/procedure-extractor-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedure-extractor-worker.d.ts","sourceRoot":"","sources":["../../src/procedural/procedure-extractor-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,wBAAwB;IACnC,QAAQ,CAAC,IAAI,EAAG,qBAAqB,CAAU;IAC/C,QAAQ,CAAC,QAAQ,EAAG,KAAK,CAAU;IAE7B,OAAO,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,yBAAyB,CAAC;CA4BvF"}

package/dist/procedural/procedure-extractor-worker.js

@@ -0,0 +1,39 @@
+/**
+ * ProcedureExtractorWorker — Background worker that extracts action
+ * sequences from successful agent runs and stores them as learned
+ * skills in procedural memory (Task 45).
+ *
+ * Delegates to ActionSequenceExtractor for grouping and fingerprinting.
+ *
+ * @module v1/memory/procedural/procedure-extractor-worker
+ */
+export class ProcedureExtractorWorker {
+    name = 'procedure-extractor';
+    priority = 'low';
+    async execute(context) {
+        const start = Date.now();
+        try {
+            const { ActionSequenceExtractor } = await import('./action-sequence-extractor.js');
+            const extractor = new ActionSequenceExtractor({
+                minSuccessCount: context.minOccurrences,
+                minAvgQualityScore: context.minSuccessRate,
+            });
+            const groups = extractor.extract(context.records);
+            return {
+                extracted: true,
+                skillsFound: groups.length,
+                skillsStored: groups.length,
+                durationMs: Date.now() - start,
+            };
+        }
+        catch {
+            return {
+                extracted: false,
+                skillsFound: 0,
+                skillsStored: 0,
+                durationMs: Date.now() - start,
+            };
+        }
+    }
+}
+//# sourceMappingURL=procedure-extractor-worker.js.map

package/dist/procedural/procedure-extractor-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedure-extractor-worker.js","sourceRoot":"","sources":["../../src/procedural/procedure-extractor-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiBH,MAAM,OAAO,wBAAwB;IAC1B,IAAI,GAAG,qBAA8B,CAAC;IACtC,QAAQ,GAAG,KAAc,CAAC;IAEnC,KAAK,CAAC,OAAO,CAAC,OAAmC;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEzB,IAAI,CAAC;YACH,MAAM,EAAE,uBAAuB,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;YAEnF,MAAM,SAAS,GAAG,IAAI,uBAAuB,CAAC;gBAC5C,eAAe,EAAE,OAAO,CAAC,cAAc;gBACvC,kBAAkB,EAAE,OAAO,CAAC,cAAc;aAC3C,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAElD,OAAO;gBACL,SAAS,EAAE,IAAI;gBACf,WAAW,EAAE,MAAM,CAAC,MAAM;gBAC1B,YAAY,EAAE,MAAM,CAAC,MAAM;gBAC3B,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,SAAS,EAAE,KAAK;gBAChB,WAAW,EAAE,CAAC;gBACd,YAAY,EAAE,CAAC;gBACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/procedural/skill-registry.d.ts

@@ -0,0 +1,25 @@
+/**
+ * SkillRegistry — JSONL-backed registry for learned skills.
+ *
+ * Part of Task 45 — Procedural Memory.
+ */
+import type { LearnedSkill } from './types.js';
+export declare class SkillRegistry {
+    private filePath;
+    constructor(filePath: string);
+    /** Register a new learned skill */
+    register(skill: LearnedSkill): void;
+    /** List all registered skills */
+    list(): LearnedSkill[];
+    /** Get a skill by ID */
+    get(skillId: string): LearnedSkill | undefined;
+    /**
+     * Find a skill that matches the same fingerprint (agentSlug + tool sequence).
+     * Fingerprint = agentSlug + sorted tool names joined by " -> ".
+     */
+    findByFingerprint(skill: LearnedSkill): LearnedSkill | undefined;
+    /** Update a skill by ID (rewrites the entire file) */
+    update(skillId: string, updated: LearnedSkill): void;
+    private buildFingerprint;
+}
+//# sourceMappingURL=skill-registry.d.ts.map

package/dist/procedural/skill-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-registry.d.ts","sourceRoot":"","sources":["../../src/procedural/skill-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAQ5B,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAInC,iCAAiC;IACjC,IAAI,IAAI,YAAY,EAAE;IAOtB,wBAAwB;IACxB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI9C;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,GAAG,SAAS;IAKhE,sDAAsD;IACtD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAQpD,OAAO,CAAC,gBAAgB;CAIzB"}

package/dist/procedural/skill-registry.js

@@ -0,0 +1,56 @@
+/**
+ * SkillRegistry — JSONL-backed registry for learned skills.
+ *
+ * Part of Task 45 — Procedural Memory.
+ */
+import { appendFileSync, readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { dirname } from 'path';
+export class SkillRegistry {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+        const dir = dirname(filePath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+    /** Register a new learned skill */
+    register(skill) {
+        appendFileSync(this.filePath, JSON.stringify(skill) + '\n', 'utf-8');
+    }
+    /** List all registered skills */
+    list() {
+        if (!existsSync(this.filePath))
+            return [];
+        const content = readFileSync(this.filePath, 'utf-8').trim();
+        if (!content)
+            return [];
+        return content.split('\n').filter(Boolean).map((line) => JSON.parse(line));
+    }
+    /** Get a skill by ID */
+    get(skillId) {
+        return this.list().find((s) => s.skillId === skillId);
+    }
+    /**
+     * Find a skill that matches the same fingerprint (agentSlug + tool sequence).
+     * Fingerprint = agentSlug + sorted tool names joined by " -> ".
+     */
+    findByFingerprint(skill) {
+        const fp = this.buildFingerprint(skill);
+        return this.list().find((s) => this.buildFingerprint(s) === fp);
+    }
+    /** Update a skill by ID (rewrites the entire file) */
+    update(skillId, updated) {
+        const all = this.list();
+        const idx = all.findIndex((s) => s.skillId === skillId);
+        if (idx === -1)
+            return;
+        all[idx] = updated;
+        writeFileSync(this.filePath, all.map((s) => JSON.stringify(s)).join('\n') + '\n', 'utf-8');
+    }
+    buildFingerprint(skill) {
+        const toolChain = skill.actionSequence.map((a) => a.toolName).join(' -> ');
+        return `${skill.agentSlug}::${toolChain}`;
+    }
+}
+//# sourceMappingURL=skill-registry.js.map

package/dist/procedural/skill-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-registry.js","sourceRoot":"","sources":["../../src/procedural/skill-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAG/B,MAAM,OAAO,aAAa;IAChB,QAAQ,CAAS;IAEzB,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,QAAQ,CAAC,KAAmB;QAC1B,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAED,iCAAiC;IACjC,IAAI;QACF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5D,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiB,CAAC,CAAC;IAC7F,CAAC;IAED,wBAAwB;IACxB,GAAG,CAAC,OAAe;QACjB,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IACxD,CAAC;IAED;;;OAGG;IACH,iBAAiB,CAAC,KAAmB;QACnC,MAAM,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,sDAAsD;IACtD,MAAM,CAAC,OAAe,EAAE,OAAqB;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;QACxD,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO;QACvB,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;QACnB,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7F,CAAC;IAEO,gBAAgB,CAAC,KAAmB;QAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3E,OAAO,GAAG,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;IAC5C,CAAC;CACF"}

package/dist/procedural/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Procedural Memory Types
+ *
+ * Types for learning from successful agent executions.
+ * Part of Task 45 — Procedural Memory.
+ */
+/** Outcome of a single tool action */
+export type ActionOutcome = 'success' | 'failure' | 'partial';
+/** A single recorded action within an agent run */
+export interface ActionRecord {
+    recordId: string;
+    runId: string;
+    agentId: string;
+    agentSlug: string;
+    toolName: string;
+    toolInput: Record<string, unknown>;
+    toolOutput?: string;
+    outcome: ActionOutcome;
+    durationMs: number;
+    qualityScore?: number;
+    timestamp: string;
+}
+/** Configuration for extracting learned skills from action records */
+export interface ExtractionConfig {
+    /** Minimum number of successful occurrences before extraction (default 3) */
+    minSuccessCount: number;
+    /** Minimum average quality score threshold (default 0.75) */
+    minAvgQualityScore: number;
+    /** Maximum actions in a sequence (default 12) */
+    maxSequenceLength: number;
+    /** How far back to look in days (default 30) */
+    lookbackDays: number;
+    /** Minimum similarity for grouping sequences (default 0.85) */
+    minSimilarityForGrouping: number;
+}
+/** Default extraction configuration */
+export declare const DEFAULT_EXTRACTION_CONFIG: ExtractionConfig;
+/** Trigger condition for a learned skill */
+export interface SkillTrigger {
+    pattern: string;
+    mode: 'exact' | 'semantic';
+    minConfidence: number;
+}
+/** A learned skill extracted from repeated successful executions */
+export interface LearnedSkill {
+    skillId: string;
+    name: string;
+    agentSlug: string;
+    trigger: SkillTrigger;
+    actionSequence: ActionRecord[];
+    successCount: number;
+    avgQualityScore: number;
+    sourceRunIds: string[];
+    createdAt: string;
+    lastUpdatedAt: string;
+    version: number;
+}
+/** A group of similar action sequences discovered by the extractor */
+export interface ActionSequenceGroup {
+    agentSlug: string;
+    fingerprint: string;
+    sequences: ActionRecord[][];
+    successCount: number;
+    avgQualityScore: number;
+    runIds: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/procedural/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sCAAsC;AACtC,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE9D,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,eAAe,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED,uCAAuC;AACvC,eAAO,MAAM,yBAAyB,EAAE,gBAMvC,CAAC;AAEF,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,YAAY,CAAC;IACtB,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,YAAY,EAAE,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/procedural/types.js

@@ -0,0 +1,15 @@
+/**
+ * Procedural Memory Types
+ *
+ * Types for learning from successful agent executions.
+ * Part of Task 45 — Procedural Memory.
+ */
+/** Default extraction configuration */
+export const DEFAULT_EXTRACTION_CONFIG = {
+    minSuccessCount: 3,
+    minAvgQualityScore: 0.75,
+    maxSequenceLength: 12,
+    lookbackDays: 30,
+    minSimilarityForGrouping: 0.85,
+};
+//# sourceMappingURL=types.js.map

package/dist/procedural/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/procedural/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkCH,uCAAuC;AACvC,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,eAAe,EAAE,CAAC;IAClB,kBAAkB,EAAE,IAAI;IACxB,iBAAiB,EAAE,EAAE;IACrB,YAAY,EAAE,EAAE;IAChB,wBAAwB,EAAE,IAAI;CAC/B,CAAC"}

package/dist/prompt-version-store.d.ts

@@ -0,0 +1,59 @@
+/**
+ * PromptVersionStore - JSONL-based prompt version management
+ *
+ * Stores prompt versions and experiments as append-only JSONL files.
+ * Supports versioning, A/B experiments, quality scoring, and line-level diffs.
+ *
+ * File layout:
+ *   {dirPath}/versions.jsonl  - one PromptVersion JSON per line
+ *   {dirPath}/experiments.jsonl - one PromptExperiment JSON per line
+ *
+ * @module @monomind/memory/prompt-version-store
+ */
+export interface PromptVersion {
+    agentSlug: string;
+    version: string;
+    prompt: string;
+    changelog: string;
+    activeFrom: Date;
+    activeTo?: Date;
+    qualityScore?: number;
+    traceCount: number;
+    publishedBy: string;
+    createdAt: Date;
+}
+export interface PromptExperiment {
+    agentSlug: string;
+    control: string;
+    candidate: string;
+    trafficPct: number;
+    startedAt: Date;
+    endsAt?: Date;
+    winnerId?: string;
+}
+export interface DiffResult {
+    agentSlug: string;
+    versionA: string;
+    versionB: string;
+    additions: number;
+    deletions: number;
+}
+export declare class PromptVersionStore {
+    private readonly versionsPath;
+    private readonly experimentsPath;
+    constructor(dirPath: string);
+    save(version: PromptVersion): void;
+    getActive(agentSlug: string): PromptVersion | null;
+    listVersions(agentSlug: string): PromptVersion[];
+    setActive(agentSlug: string, version: string): void;
+    diff(agentSlug: string, vA: string, vB: string): DiffResult;
+    updateQualityScore(agentSlug: string, version: string, score: number): void;
+    saveExperiment(exp: PromptExperiment): void;
+    getExperiment(agentSlug: string): PromptExperiment | null;
+    concludeExperiment(agentSlug: string, winnerId: string): void;
+    private readVersions;
+    private writeVersions;
+    private readExperiments;
+    private writeExperiments;
+}
+//# sourceMappingURL=prompt-version-store.d.ts.map

package/dist/prompt-version-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-version-store.d.ts","sourceRoot":"","sources":["../src/prompt-version-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAmFD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAE7B,OAAO,EAAE,MAAM;IAQ3B,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAKlC,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAKlD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE;IAMhD,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAenD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU;IAsB3D,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAY3E,cAAc,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI;IAK3C,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAKzD,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAY7D,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,gBAAgB;CAIzB"}

package/dist/prompt-version-store.js

@@ -0,0 +1,175 @@
+/**
+ * PromptVersionStore - JSONL-based prompt version management
+ *
+ * Stores prompt versions and experiments as append-only JSONL files.
+ * Supports versioning, A/B experiments, quality scoring, and line-level diffs.
+ *
+ * File layout:
+ *   {dirPath}/versions.jsonl  - one PromptVersion JSON per line
+ *   {dirPath}/experiments.jsonl - one PromptExperiment JSON per line
+ *
+ * @module @monomind/memory/prompt-version-store
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+function versionToRecord(v) {
+    return {
+        agentSlug: v.agentSlug,
+        version: v.version,
+        prompt: v.prompt,
+        changelog: v.changelog,
+        activeFrom: v.activeFrom.toISOString(),
+        activeTo: v.activeTo ? v.activeTo.toISOString() : null,
+        qualityScore: v.qualityScore ?? null,
+        traceCount: v.traceCount,
+        publishedBy: v.publishedBy,
+        createdAt: v.createdAt.toISOString(),
+    };
+}
+function recordToVersion(r) {
+    return {
+        agentSlug: r.agentSlug,
+        version: r.version,
+        prompt: r.prompt,
+        changelog: r.changelog,
+        activeFrom: new Date(r.activeFrom),
+        activeTo: r.activeTo ? new Date(r.activeTo) : undefined,
+        qualityScore: r.qualityScore ?? undefined,
+        traceCount: r.traceCount,
+        publishedBy: r.publishedBy,
+        createdAt: new Date(r.createdAt),
+    };
+}
+function experimentToRecord(e) {
+    return {
+        agentSlug: e.agentSlug,
+        control: e.control,
+        candidate: e.candidate,
+        trafficPct: e.trafficPct,
+        startedAt: e.startedAt.toISOString(),
+        endsAt: e.endsAt ? e.endsAt.toISOString() : null,
+        winnerId: e.winnerId ?? null,
+    };
+}
+function recordToExperiment(r) {
+    return {
+        agentSlug: r.agentSlug,
+        control: r.control,
+        candidate: r.candidate,
+        trafficPct: r.trafficPct,
+        startedAt: new Date(r.startedAt),
+        endsAt: r.endsAt ? new Date(r.endsAt) : undefined,
+        winnerId: r.winnerId ?? undefined,
+    };
+}
+// ===== Store =====
+export class PromptVersionStore {
+    versionsPath;
+    experimentsPath;
+    constructor(dirPath) {
+        fs.mkdirSync(dirPath, { recursive: true });
+        this.versionsPath = path.join(dirPath, 'versions.jsonl');
+        this.experimentsPath = path.join(dirPath, 'experiments.jsonl');
+    }
+    // ---- versions ----
+    save(version) {
+        const line = JSON.stringify(versionToRecord(version)) + '\n';
+        fs.appendFileSync(this.versionsPath, line, 'utf-8');
+    }
+    getActive(agentSlug) {
+        const all = this.readVersions();
+        return all.find((v) => v.agentSlug === agentSlug && v.activeTo === undefined) ?? null;
+    }
+    listVersions(agentSlug) {
+        return this.readVersions()
+            .filter((v) => v.agentSlug === agentSlug)
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    }
+    setActive(agentSlug, version) {
+        const all = this.readVersions();
+        const now = new Date();
+        for (const v of all) {
+            if (v.agentSlug === agentSlug && v.activeTo === undefined) {
+                v.activeTo = now;
+            }
+            if (v.agentSlug === agentSlug && v.version === version) {
+                v.activeTo = undefined;
+                v.activeFrom = now;
+            }
+        }
+        this.writeVersions(all);
+    }
+    diff(agentSlug, vA, vB) {
+        const all = this.readVersions();
+        const a = all.find((v) => v.agentSlug === agentSlug && v.version === vA);
+        const b = all.find((v) => v.agentSlug === agentSlug && v.version === vB);
+        const linesA = a ? a.prompt.split('\n') : [];
+        const linesB = b ? b.prompt.split('\n') : [];
+        const setA = new Set(linesA);
+        const setB = new Set(linesB);
+        let additions = 0;
+        let deletions = 0;
+        for (const line of linesB) {
+            if (!setA.has(line))
+                additions++;
+        }
+        for (const line of linesA) {
+            if (!setB.has(line))
+                deletions++;
+        }
+        return { agentSlug, versionA: vA, versionB: vB, additions, deletions };
+    }
+    updateQualityScore(agentSlug, version, score) {
+        const all = this.readVersions();
+        for (const v of all) {
+            if (v.agentSlug === agentSlug && v.version === version) {
+                v.qualityScore = score;
+            }
+        }
+        this.writeVersions(all);
+    }
+    // ---- experiments ----
+    saveExperiment(exp) {
+        const line = JSON.stringify(experimentToRecord(exp)) + '\n';
+        fs.appendFileSync(this.experimentsPath, line, 'utf-8');
+    }
+    getExperiment(agentSlug) {
+        const all = this.readExperiments();
+        return all.find((e) => e.agentSlug === agentSlug && e.winnerId === undefined) ?? null;
+    }
+    concludeExperiment(agentSlug, winnerId) {
+        const all = this.readExperiments();
+        for (const e of all) {
+            if (e.agentSlug === agentSlug && e.winnerId === undefined) {
+                e.winnerId = winnerId;
+            }
+        }
+        this.writeExperiments(all);
+    }
+    // ---- private I/O ----
+    readVersions() {
+        if (!fs.existsSync(this.versionsPath))
+            return [];
+        const content = fs.readFileSync(this.versionsPath, 'utf-8').trim();
+        if (!content)
+            return [];
+        return content.split('\n').filter(Boolean).map((line) => recordToVersion(JSON.parse(line)));
+    }
+    writeVersions(versions) {
+        const data = versions.map((v) => JSON.stringify(versionToRecord(v))).join('\n') + '\n';
+        fs.writeFileSync(this.versionsPath, data, 'utf-8');
+    }
+    readExperiments() {
+        if (!fs.existsSync(this.experimentsPath))
+            return [];
+        const content = fs.readFileSync(this.experimentsPath, 'utf-8').trim();
+        if (!content)
+            return [];
+        return content.split('\n').filter(Boolean).map((line) => recordToExperiment(JSON.parse(line)));
+    }
+    writeExperiments(experiments) {
+        const data = experiments.map((e) => JSON.stringify(experimentToRecord(e))).join('\n') + '\n';
+        fs.writeFileSync(this.experimentsPath, data, 'utf-8');
+    }
+}
+//# sourceMappingURL=prompt-version-store.js.map

package/dist/prompt-version-store.js.map

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

package/dist/query-builder.d.ts

@@ -0,0 +1,52 @@
+import type { MemoryQuery } from './types.js';
+export type SortField = NonNullable<MemoryQuery['sortField']>;
+export type SortDirection = NonNullable<MemoryQuery['sortDirection']>;
+/**
+ * Fluent builder for MemoryQuery objects.
+ *
+ * @example
+ * const q = query()
+ *   .semantic('authentication patterns')
+ *   .inNamespace('security')
+ *   .withTags(['critical'])
+ *   .threshold(0.8)
+ *   .limit(10)
+ *   .build();
+ */
+export declare class QueryBuilder {
+    private _type;
+    private _content?;
+    private _namespace?;
+    private _tags?;
+    private _limit;
+    private _offset?;
+    private _threshold?;
+    private _sortField?;
+    private _sortDirection?;
+    semantic(content: string): this;
+    exact(key: string): this;
+    hybrid(content: string): this;
+    inNamespace(namespace: string): this;
+    withTags(tags: string[]): this;
+    limit(n: number): this;
+    offset(n: number): this;
+    threshold(t: number): this;
+    sortBy(field: SortField, direction?: SortDirection): this;
+    newestFirst(): this;
+    oldestFirst(): this;
+    recentlyAccessed(): this;
+    mostAccessed(): this;
+    reset(): this;
+    clone(): QueryBuilder;
+    build(): MemoryQuery;
+}
+/** Factory shorthand: `query().semantic('...').build()` */
+export declare function query(): QueryBuilder;
+/** Pre-built common query patterns */
+export declare const QueryTemplates: {
+    recentInNamespace(namespace: string, limit?: number): MemoryQuery;
+    byTags(tags: string[], limit?: number): MemoryQuery;
+    semanticSearch(content: string, limit?: number, threshold?: number): MemoryQuery;
+    exactKey(namespace: string, key: string): MemoryQuery;
+};
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/query-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../src/query-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,YAAY,CAAC;AAEzD,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAC,CAAW;IACzB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAC,CAAY;IAC/B,OAAO,CAAC,cAAc,CAAC,CAAgB;IAEvC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM/B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMxB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM7B,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKpC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAK9B,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKtB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKvB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAK1B,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,GAAE,aAAsB,GAAG,IAAI;IAOjE,WAAW,IAAI,IAAI;IACnB,WAAW,IAAI,IAAI;IACnB,gBAAgB,IAAI,IAAI;IACxB,YAAY,IAAI,IAAI;IAEpB,KAAK,IAAI,IAAI;IAab,KAAK,IAAI,YAAY;IAcrB,KAAK,IAAI,WAAW;CAcrB;AAED,2DAA2D;AAC3D,wBAAgB,KAAK,IAAI,YAAY,CAEpC;AAED,sCAAsC;AACtC,eAAO,MAAM,cAAc;iCACI,MAAM,mBAAe,WAAW;iBAIhD,MAAM,EAAE,mBAAe,WAAW;4BAIvB,MAAM,uCAAgC,WAAW;wBAIrD,MAAM,OAAO,MAAM,GAAG,WAAW;CAGtD,CAAC"}